ObjectStackDatasource
Datasource protocol schemas
Driver Identifier
Can be a built-in driver or a plugin-contributed driver (e.g., "com.vendor.snowflake").
Source: packages/spec/src/data/datasource.zod.ts
TypeScript Usage
import { Datasource, DatasourceCapabilities, DriverDefinition, DriverType } from '@objectstack/spec/data';
import type { Datasource, DatasourceCapabilities, DriverDefinition, DriverType } from '@objectstack/spec/data';
// Validate data
const result = Datasource.parse(data);Datasource
Properties
| Property | Type | Required | Description |
|---|---|---|---|
| name | string | ✅ | Unique datasource identifier |
| label | string | optional | Display label |
| driver | string | ✅ | Underlying driver type |
| config | Record<string, any> | ✅ | Driver specific configuration |
| pool | Object | optional | Connection pool settings |
| readReplicas | Record<string, any>[] | optional | Read-only replica configurations |
| capabilities | Object | optional | Capability overrides |
| healthCheck | Object | optional | Datasource health check configuration |
| ssl | Object | optional | SSL/TLS configuration for secure database connections |
| retryPolicy | Object | optional | Connection retry policy for transient failures |
| description | string | optional | Internal description |
| active | boolean | ✅ | Is datasource enabled |
DatasourceCapabilities
Properties
| Property | Type | Required | Description |
|---|---|---|---|
| transactions | boolean | ✅ | |
| queryFilters | boolean | ✅ | |
| queryAggregations | boolean | ✅ | |
| querySorting | boolean | ✅ | |
| queryPagination | boolean | ✅ | |
| queryWindowFunctions | boolean | ✅ | |
| querySubqueries | boolean | ✅ | |
| joins | boolean | ✅ | |
| fullTextSearch | boolean | ✅ | |
| readOnly | boolean | ✅ | |
| dynamicSchema | boolean | ✅ |
DriverDefinition
Properties
| Property | Type | Required | Description |
|---|---|---|---|
| id | string | ✅ | Unique driver identifier (e.g. "postgres") |
| label | string | ✅ | Display label (e.g. "PostgreSQL") |
| description | string | optional | |
| icon | string | optional | |
| configSchema | Record<string, any> | ✅ | JSON Schema for connection configuration |
| capabilities | Object | optional |