@ankhorage/contracts 1.8.0 → 1.9.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ankhorage/contracts
 
+## 1.9.0
+
+### Minor Changes
+
+- d1e08cc: Add provider-neutral data-source, endpoint, operation, schema, credential, adapter, and diagnostic contracts.
+
 ## 1.8.0
 
 ### Minor Changes

package/dist/data/diagnostics.d.ts

@@ -0,0 +1,22 @@
+import type { DataSourceId, EndpointId, OperationId } from './ids';
+export type DataDiagnosticSeverity = 'error' | 'info' | 'warning';
+export type DataDiagnosticCode = 'ambiguous-server' | 'duplicate-operation-id' | 'invalid-config' | 'missing-adapter' | 'missing-credential' | 'missing-data-source' | 'missing-endpoint' | 'missing-operation' | 'missing-schema' | 'network-error' | 'parse-error' | 'unsupported-auth-scheme' | 'unsupported-schema' | (string & {});
+export interface DataSourceDiagnostic {
+    readonly code: DataDiagnosticCode;
+    readonly message: string;
+    readonly severity: DataDiagnosticSeverity;
+    readonly dataSourceId?: DataSourceId;
+    readonly endpointId?: EndpointId;
+    readonly operationId?: OperationId;
+    readonly path?: string;
+    readonly hint?: string;
+}
+export type DataSourceDiagnosticResult<TData> = {
+    readonly ok: true;
+    readonly data: TData;
+    readonly diagnostics?: readonly DataSourceDiagnostic[];
+} | {
+    readonly ok: false;
+    readonly diagnostics: readonly DataSourceDiagnostic[];
+};
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/data/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/data/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEnE,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,wBAAwB,GACxB,gBAAgB,GAChB,iBAAiB,GACjB,oBAAoB,GACpB,qBAAqB,GACrB,kBAAkB,GAClB,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,yBAAyB,GACzB,oBAAoB,GACpB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,0BAA0B,CAAC,KAAK,IACxC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACxD,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACvD,CAAC"}

package/dist/data/diagnostics.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diagnostics.js.map

package/dist/data/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/data/diagnostics.ts"],"names":[],"mappings":"","sourcesContent":["import type { DataSourceId, EndpointId, OperationId } from './ids';\n\nexport type DataDiagnosticSeverity = 'error' | 'info' | 'warning';\n\nexport type DataDiagnosticCode =\n  | 'ambiguous-server'\n  | 'duplicate-operation-id'\n  | 'invalid-config'\n  | 'missing-adapter'\n  | 'missing-credential'\n  | 'missing-data-source'\n  | 'missing-endpoint'\n  | 'missing-operation'\n  | 'missing-schema'\n  | 'network-error'\n  | 'parse-error'\n  | 'unsupported-auth-scheme'\n  | 'unsupported-schema'\n  | (string & {});\n\nexport interface DataSourceDiagnostic {\n  readonly code: DataDiagnosticCode;\n  readonly message: string;\n  readonly severity: DataDiagnosticSeverity;\n  readonly dataSourceId?: DataSourceId;\n  readonly endpointId?: EndpointId;\n  readonly operationId?: OperationId;\n  readonly path?: string;\n  readonly hint?: string;\n}\n\nexport type DataSourceDiagnosticResult<TData> =\n  | {\n      readonly ok: true;\n      readonly data: TData;\n      readonly diagnostics?: readonly DataSourceDiagnostic[];\n    }\n  | {\n      readonly ok: false;\n      readonly diagnostics: readonly DataSourceDiagnostic[];\n    };\n"]}

package/dist/data/endpoints.d.ts

@@ -0,0 +1,18 @@
+import type { EndpointId, OperationId } from './ids';
+import type { DataOperationConfig } from './operations';
+import type { CredentialRef } from './refs';
+import type { DataContractValue } from './values';
+export type DataEndpointKind = 'database' | 'graphql' | 'http' | (string & {});
+export interface DataEndpointConfig {
+    readonly id: EndpointId;
+    readonly kind: DataEndpointKind;
+    readonly name?: string;
+    readonly description?: string;
+    readonly baseUrl?: string;
+    readonly path?: string;
+    readonly credential?: CredentialRef;
+    readonly operations: Readonly<Record<OperationId, DataOperationConfig>>;
+    readonly metadata?: DataContractValue;
+}
+export type DataEndpointRegistry = Readonly<Record<EndpointId, DataEndpointConfig>>;
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/data/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../src/data/endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE/E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC"}

package/dist/data/endpoints.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=endpoints.js.map

package/dist/data/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../src/data/endpoints.ts"],"names":[],"mappings":"","sourcesContent":["import type { EndpointId, OperationId } from './ids';\nimport type { DataOperationConfig } from './operations';\nimport type { CredentialRef } from './refs';\nimport type { DataContractValue } from './values';\n\nexport type DataEndpointKind = 'database' | 'graphql' | 'http' | (string & {});\n\nexport interface DataEndpointConfig {\n  readonly id: EndpointId;\n  readonly kind: DataEndpointKind;\n  readonly name?: string;\n  readonly description?: string;\n  readonly baseUrl?: string;\n  readonly path?: string;\n  readonly credential?: CredentialRef;\n  readonly operations: Readonly<Record<OperationId, DataOperationConfig>>;\n  readonly metadata?: DataContractValue;\n}\n\nexport type DataEndpointRegistry = Readonly<Record<EndpointId, DataEndpointConfig>>;\n"]}

package/dist/data/ids.d.ts

@@ -0,0 +1,7 @@
+export type DataSourceId = string;
+export type EndpointId = string;
+export type OperationId = string;
+export type SchemaId = string;
+export type CredentialId = string;
+export type AdapterId = string;
+//# sourceMappingURL=ids.d.ts.map

package/dist/data/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/data/ids.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAChC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AACjC,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAC9B,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC"}

package/dist/data/ids.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ids.js.map

package/dist/data/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/data/ids.ts"],"names":[],"mappings":"","sourcesContent":["export type DataSourceId = string;\nexport type EndpointId = string;\nexport type OperationId = string;\nexport type SchemaId = string;\nexport type CredentialId = string;\nexport type AdapterId = string;\n"]}

package/dist/data/index.d.ts

@@ -0,0 +1,9 @@
+export * from './diagnostics';
+export * from './endpoints';
+export * from './ids';
+export * from './operations';
+export * from './refs';
+export * from './schemas';
+export * from './sources';
+export * from './values';
+//# sourceMappingURL=index.d.ts.map

package/dist/data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/data/index.js

@@ -0,0 +1,9 @@
+export * from './diagnostics';
+export * from './endpoints';
+export * from './ids';
+export * from './operations';
+export * from './refs';
+export * from './schemas';
+export * from './sources';
+export * from './values';
+//# sourceMappingURL=index.js.map

package/dist/data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC","sourcesContent":["export * from './diagnostics';\nexport * from './endpoints';\nexport * from './ids';\nexport * from './operations';\nexport * from './refs';\nexport * from './schemas';\nexport * from './sources';\nexport * from './values';\n"]}

package/dist/data/operations.d.ts

@@ -0,0 +1,49 @@
+import type { EndpointId, OperationId } from './ids';
+import type { CredentialRef } from './refs';
+import type { DataSchemaSlot } from './schemas';
+import type { DataContractValue } from './values';
+export type DataOperationIntent = 'action' | 'create' | 'delete' | 'read' | 'update';
+export type DataOperationMethod = 'DELETE' | 'GET' | 'HEAD' | 'OPTIONS' | 'PATCH' | 'POST' | 'PUT' | (string & {});
+export type DataOperationProtocol = 'database' | 'graphql' | 'http' | (string & {});
+export type DataOperationParameterLocation = 'body' | 'cookie' | 'header' | 'path' | 'query';
+export interface DataOperationParameter extends DataSchemaSlot {
+    readonly name: string;
+    readonly location: DataOperationParameterLocation;
+    readonly required?: boolean;
+    readonly description?: string;
+    readonly default?: DataContractValue;
+}
+export interface DataOperationRequest extends DataSchemaSlot {
+    readonly parameters?: readonly DataOperationParameter[];
+    readonly contentType?: string;
+}
+export interface DataOperationResponse extends DataSchemaSlot {
+    readonly status?: number | string;
+    readonly contentType?: string;
+    readonly description?: string;
+}
+export interface DataOperationPagination {
+    readonly kind: 'cursor' | 'limit-offset' | 'page' | 'unknown' | (string & {});
+    readonly cursorPath?: string;
+    readonly limitParameter?: string;
+    readonly offsetParameter?: string;
+    readonly pageParameter?: string;
+    readonly pageSizeParameter?: string;
+}
+export interface DataOperationConfig {
+    readonly id: OperationId;
+    readonly endpointId?: EndpointId;
+    readonly name?: string;
+    readonly description?: string;
+    readonly protocol: DataOperationProtocol;
+    readonly intent: DataOperationIntent;
+    readonly method?: DataOperationMethod;
+    readonly path?: string;
+    readonly request?: DataOperationRequest;
+    readonly response?: DataOperationResponse;
+    readonly pagination?: DataOperationPagination;
+    readonly credential?: CredentialRef;
+    readonly metadata?: DataContractValue;
+}
+export type DataOperationRegistry = Readonly<Record<OperationId, DataOperationConfig>>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/data/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/data/operations.ts"],"names":[],"mappings":"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"}

package/dist/data/operations.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=operations.js.map

package/dist/data/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/data/operations.ts"],"names":[],"mappings":"","sourcesContent":["import type { EndpointId, OperationId } from './ids';\nimport type { CredentialRef } from './refs';\nimport type { DataSchemaSlot } from './schemas';\nimport type { DataContractValue } from './values';\n\nexport type DataOperationIntent = 'action' | 'create' | 'delete' | 'read' | 'update';\n\nexport type DataOperationMethod =\n  | 'DELETE'\n  | 'GET'\n  | 'HEAD'\n  | 'OPTIONS'\n  | 'PATCH'\n  | 'POST'\n  | 'PUT'\n  | (string & {});\n\nexport type DataOperationProtocol = 'database' | 'graphql' | 'http' | (string & {});\n\nexport type DataOperationParameterLocation = 'body' | 'cookie' | 'header' | 'path' | 'query';\n\nexport interface DataOperationParameter extends DataSchemaSlot {\n  readonly name: string;\n  readonly location: DataOperationParameterLocation;\n  readonly required?: boolean;\n  readonly description?: string;\n  readonly default?: DataContractValue;\n}\n\nexport interface DataOperationRequest extends DataSchemaSlot {\n  readonly parameters?: readonly DataOperationParameter[];\n  readonly contentType?: string;\n}\n\nexport interface DataOperationResponse extends DataSchemaSlot {\n  readonly status?: number | string;\n  readonly contentType?: string;\n  readonly description?: string;\n}\n\nexport interface DataOperationPagination {\n  readonly kind: 'cursor' | 'limit-offset' | 'page' | 'unknown' | (string & {});\n  readonly cursorPath?: string;\n  readonly limitParameter?: string;\n  readonly offsetParameter?: string;\n  readonly pageParameter?: string;\n  readonly pageSizeParameter?: string;\n}\n\nexport interface DataOperationConfig {\n  readonly id: OperationId;\n  readonly endpointId?: EndpointId;\n  readonly name?: string;\n  readonly description?: string;\n  readonly protocol: DataOperationProtocol;\n  readonly intent: DataOperationIntent;\n  readonly method?: DataOperationMethod;\n  readonly path?: string;\n  readonly request?: DataOperationRequest;\n  readonly response?: DataOperationResponse;\n  readonly pagination?: DataOperationPagination;\n  readonly credential?: CredentialRef;\n  readonly metadata?: DataContractValue;\n}\n\nexport type DataOperationRegistry = Readonly<Record<OperationId, DataOperationConfig>>;\n"]}

package/dist/data/refs.d.ts

@@ -0,0 +1,18 @@
+import type { AdapterId, CredentialId } from './ids';
+import type { DataContractValue } from './values';
+export type CredentialKind = 'apiKey' | 'basic' | 'bearer' | 'custom' | 'oauth2';
+export interface CredentialRef {
+    readonly id: CredentialId;
+    readonly kind: CredentialKind | (string & {});
+    readonly label?: string;
+    readonly scope?: string;
+}
+export type AdapterKind = 'auth' | 'database' | 'storage' | 'transport' | (string & {});
+export interface AdapterRef {
+    readonly id: AdapterId;
+    readonly kind: AdapterKind;
+    readonly packageName?: string;
+    readonly exportName?: string;
+    readonly config?: DataContractValue;
+}
+//# sourceMappingURL=refs.d.ts.map

package/dist/data/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/data/refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAExF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACrC"}

package/dist/data/refs.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=refs.js.map

package/dist/data/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../src/data/refs.ts"],"names":[],"mappings":"","sourcesContent":["import type { AdapterId, CredentialId } from './ids';\nimport type { DataContractValue } from './values';\n\nexport type CredentialKind = 'apiKey' | 'basic' | 'bearer' | 'custom' | 'oauth2';\n\nexport interface CredentialRef {\n  readonly id: CredentialId;\n  readonly kind: CredentialKind | (string & {});\n  readonly label?: string;\n  readonly scope?: string;\n}\n\nexport type AdapterKind = 'auth' | 'database' | 'storage' | 'transport' | (string & {});\n\nexport interface AdapterRef {\n  readonly id: AdapterId;\n  readonly kind: AdapterKind;\n  readonly packageName?: string;\n  readonly exportName?: string;\n  readonly config?: DataContractValue;\n}\n"]}

package/dist/data/schemas.d.ts

@@ -0,0 +1,34 @@
+import type { SchemaId } from './ids';
+import type { DataContractValue } from './values';
+export type DataSchemaPrimitiveType = 'array' | 'boolean' | 'integer' | 'null' | 'number' | 'object' | 'string';
+export interface DataSchemaRef {
+    readonly id: SchemaId;
+}
+export interface DataSchemaProperty {
+    readonly description?: string;
+    readonly schema: DataSchema;
+}
+export interface DataSchema {
+    readonly type?: DataSchemaPrimitiveType | readonly DataSchemaPrimitiveType[];
+    readonly title?: string;
+    readonly description?: string;
+    readonly enum?: readonly DataContractValue[];
+    readonly const?: DataContractValue;
+    readonly default?: DataContractValue;
+    readonly format?: string;
+    readonly nullable?: boolean;
+    readonly required?: readonly string[];
+    readonly properties?: Readonly<Record<string, DataSchema>>;
+    readonly additionalProperties?: boolean | DataSchema;
+    readonly items?: DataSchema;
+    readonly allOf?: readonly DataSchema[];
+    readonly anyOf?: readonly DataSchema[];
+    readonly oneOf?: readonly DataSchema[];
+    readonly ref?: DataSchemaRef;
+}
+export type DataSchemaRegistry = Readonly<Record<SchemaId, DataSchema>>;
+export interface DataSchemaSlot {
+    readonly schema?: DataSchema;
+    readonly schemaRef?: DataSchemaRef;
+}
+//# sourceMappingURL=schemas.d.ts.map

package/dist/data/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/data/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,MAAM,uBAAuB,GAC/B,OAAO,GACP,SAAS,GACT,SAAS,GACT,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,uBAAuB,GAAG,SAAS,uBAAuB,EAAE,CAAC;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;CACpC"}

package/dist/data/schemas.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schemas.js.map

package/dist/data/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/data/schemas.ts"],"names":[],"mappings":"","sourcesContent":["import type { SchemaId } from './ids';\nimport type { DataContractValue } from './values';\n\nexport type DataSchemaPrimitiveType =\n  | 'array'\n  | 'boolean'\n  | 'integer'\n  | 'null'\n  | 'number'\n  | 'object'\n  | 'string';\n\nexport interface DataSchemaRef {\n  readonly id: SchemaId;\n}\n\nexport interface DataSchemaProperty {\n  readonly description?: string;\n  readonly schema: DataSchema;\n}\n\nexport interface DataSchema {\n  readonly type?: DataSchemaPrimitiveType | readonly DataSchemaPrimitiveType[];\n  readonly title?: string;\n  readonly description?: string;\n  readonly enum?: readonly DataContractValue[];\n  readonly const?: DataContractValue;\n  readonly default?: DataContractValue;\n  readonly format?: string;\n  readonly nullable?: boolean;\n  readonly required?: readonly string[];\n  readonly properties?: Readonly<Record<string, DataSchema>>;\n  readonly additionalProperties?: boolean | DataSchema;\n  readonly items?: DataSchema;\n  readonly allOf?: readonly DataSchema[];\n  readonly anyOf?: readonly DataSchema[];\n  readonly oneOf?: readonly DataSchema[];\n  readonly ref?: DataSchemaRef;\n}\n\nexport type DataSchemaRegistry = Readonly<Record<SchemaId, DataSchema>>;\n\nexport interface DataSchemaSlot {\n  readonly schema?: DataSchema;\n  readonly schemaRef?: DataSchemaRef;\n}\n"]}

package/dist/data/sources.d.ts

@@ -0,0 +1,57 @@
+import type { DbCollectionDefinition } from '../db';
+import type { DataEndpointRegistry } from './endpoints';
+import type { DataSourceId } from './ids';
+import type { AdapterRef, CredentialRef } from './refs';
+import type { DataSchemaRegistry } from './schemas';
+import type { DataContractValue } from './values';
+export type DataSourceKind = 'database' | 'graphql' | 'managed-api' | 'openapi' | 'rest';
+export interface DataSourceBaseConfig {
+    readonly id: DataSourceId;
+    readonly kind: DataSourceKind;
+    readonly name?: string;
+    readonly description?: string;
+    readonly credential?: CredentialRef;
+    readonly endpoints: DataEndpointRegistry;
+    readonly schemas?: DataSchemaRegistry;
+    readonly metadata?: DataContractValue;
+}
+export interface RestDataSourceConfig extends DataSourceBaseConfig {
+    readonly kind: 'rest';
+    readonly baseUrl: string;
+}
+export interface OpenApiImportRef {
+    readonly url?: string;
+    readonly documentId?: string;
+    readonly version?: string;
+}
+export interface OpenApiDataSourceConfig extends DataSourceBaseConfig {
+    readonly kind: 'openapi';
+    readonly baseUrl?: string;
+    readonly import?: OpenApiImportRef;
+}
+export interface GraphQlDataSourceConfig extends DataSourceBaseConfig {
+    readonly kind: 'graphql';
+    readonly endpointUrl: string;
+    readonly introspection?: {
+        readonly enabled: boolean;
+        readonly schemaVersion?: string;
+    };
+}
+export interface DatabaseDataSourceConfig extends DataSourceBaseConfig {
+    readonly kind: 'database';
+    readonly adapter: AdapterRef;
+}
+export interface ManagedApiResourceConfig {
+    readonly name: string;
+    readonly collection: DbCollectionDefinition;
+    readonly operations?: readonly ('create' | 'delete' | 'list' | 'read' | 'update')[];
+    readonly metadata?: DataContractValue;
+}
+export interface ManagedApiDataSourceConfig extends DataSourceBaseConfig {
+    readonly kind: 'managed-api';
+    readonly adapter: AdapterRef;
+    readonly resources: readonly ManagedApiResourceConfig[];
+}
+export type DataSourceConfig = DatabaseDataSourceConfig | GraphQlDataSourceConfig | ManagedApiDataSourceConfig | OpenApiDataSourceConfig | RestDataSourceConfig;
+export type DataSourceRegistry = Readonly<Record<DataSourceId, DataSourceConfig>>;
+//# sourceMappingURL=sources.d.ts.map

package/dist/data/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/data/sources.ts"],"names":[],"mappings":"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"}

package/dist/data/sources.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sources.js.map

package/dist/data/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../src/data/sources.ts"],"names":[],"mappings":"","sourcesContent":["import type { DbCollectionDefinition } from '../db';\nimport type { DataEndpointRegistry } from './endpoints';\nimport type { DataSourceId } from './ids';\nimport type { AdapterRef, CredentialRef } from './refs';\nimport type { DataSchemaRegistry } from './schemas';\nimport type { DataContractValue } from './values';\n\nexport type DataSourceKind = 'database' | 'graphql' | 'managed-api' | 'openapi' | 'rest';\n\nexport interface DataSourceBaseConfig {\n  readonly id: DataSourceId;\n  readonly kind: DataSourceKind;\n  readonly name?: string;\n  readonly description?: string;\n  readonly credential?: CredentialRef;\n  readonly endpoints: DataEndpointRegistry;\n  readonly schemas?: DataSchemaRegistry;\n  readonly metadata?: DataContractValue;\n}\n\nexport interface RestDataSourceConfig extends DataSourceBaseConfig {\n  readonly kind: 'rest';\n  readonly baseUrl: string;\n}\n\nexport interface OpenApiImportRef {\n  readonly url?: string;\n  readonly documentId?: string;\n  readonly version?: string;\n}\n\nexport interface OpenApiDataSourceConfig extends DataSourceBaseConfig {\n  readonly kind: 'openapi';\n  readonly baseUrl?: string;\n  readonly import?: OpenApiImportRef;\n}\n\nexport interface GraphQlDataSourceConfig extends DataSourceBaseConfig {\n  readonly kind: 'graphql';\n  readonly endpointUrl: string;\n  readonly introspection?: {\n    readonly enabled: boolean;\n    readonly schemaVersion?: string;\n  };\n}\n\nexport interface DatabaseDataSourceConfig extends DataSourceBaseConfig {\n  readonly kind: 'database';\n  readonly adapter: AdapterRef;\n}\n\nexport interface ManagedApiResourceConfig {\n  readonly name: string;\n  readonly collection: DbCollectionDefinition;\n  readonly operations?: readonly ('create' | 'delete' | 'list' | 'read' | 'update')[];\n  readonly metadata?: DataContractValue;\n}\n\nexport interface ManagedApiDataSourceConfig extends DataSourceBaseConfig {\n  readonly kind: 'managed-api';\n  readonly adapter: AdapterRef;\n  readonly resources: readonly ManagedApiResourceConfig[];\n}\n\nexport type DataSourceConfig =\n  | DatabaseDataSourceConfig\n  | GraphQlDataSourceConfig\n  | ManagedApiDataSourceConfig\n  | OpenApiDataSourceConfig\n  | RestDataSourceConfig;\n\nexport type DataSourceRegistry = Readonly<Record<DataSourceId, DataSourceConfig>>;\n"]}

package/dist/data/values.d.ts

@@ -0,0 +1,5 @@
+export type DataContractValue = string | number | boolean | null | readonly DataContractValue[] | {
+    readonly [key: string]: DataContractValue;
+};
+export type DataPath = string;
+//# sourceMappingURL=values.d.ts.map

package/dist/data/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/data/values.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,iBAAiB,EAAE,GAC5B;IACE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAC;CAC3C,CAAC;AAEN,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC"}

package/dist/data/values.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=values.js.map

package/dist/data/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/data/values.ts"],"names":[],"mappings":"","sourcesContent":["export type DataContractValue =\n  | string\n  | number\n  | boolean\n  | null\n  | readonly DataContractValue[]\n  | {\n      readonly [key: string]: DataContractValue;\n    };\n\nexport type DataPath = string;\n"]}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './auth';
 export * from './bindings';
+export * from './data';
 export * from './db';
 export * from './state';
 export * from './storage';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,MAAM,CAAC;AACrB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export * from './auth';
 export * from './bindings';
+export * from './data';
 export * from './db';
 export * from './state';
 export * from './storage';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,MAAM,CAAC;AACrB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC","sourcesContent":["export * from './auth';\nexport * from './bindings';\nexport * from './db';\nexport * from './state';\nexport * from './storage';\nexport * from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC","sourcesContent":["export * from './auth';\nexport * from './bindings';\nexport * from './data';\nexport * from './db';\nexport * from './state';\nexport * from './storage';\nexport * from './types';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/contracts",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "main": "./dist/index.js",
   "dependencies": {
     "@ankhorage/color-theory": "^0.0.7"
@@ -25,6 +25,10 @@
       "types": "./dist/bindings.d.ts",
       "default": "./dist/bindings.js"
     },
+    "./data": {
+      "types": "./dist/data/index.d.ts",
+      "default": "./dist/data/index.js"
+    },
     "./db": {
       "types": "./dist/db.d.ts",
       "default": "./dist/db.js"

package/src/data/data.test.ts

@@ -0,0 +1,305 @@
+import { describe, expect, it } from 'bun:test';
+
+import type {
+  DataSourceConfig,
+  DataSourceDiagnostic,
+  GraphQlDataSourceConfig,
+  ManagedApiDataSourceConfig,
+  OpenApiDataSourceConfig,
+  RestDataSourceConfig,
+} from './index';
+
+function assertSerializable<TValue>(value: TValue): void {
+  expect(JSON.parse(JSON.stringify(value))).toEqual(value);
+}
+
+describe('data source contracts', () => {
+  it('serializes a manual REST data source with read and create operations', () => {
+    const source: RestDataSourceConfig = {
+      id: 'cms-rest',
+      kind: 'rest',
+      name: 'CMS REST API',
+      baseUrl: 'https://cms.example.com',
+      credential: {
+        id: 'cms-api-key',
+        kind: 'apiKey',
+        label: 'CMS API key',
+      },
+      schemas: {
+        post: {
+          type: 'object',
+          required: ['id', 'title'],
+          properties: {
+            id: { type: 'string' },
+            title: { type: 'string' },
+            published: { type: 'boolean', default: false },
+          },
+        },
+      },
+      endpoints: {
+        posts: {
+          id: 'posts',
+          kind: 'http',
+          path: '/posts',
+          operations: {
+            'posts.list': {
+              id: 'posts.list',
+              endpointId: 'posts',
+              protocol: 'http',
+              intent: 'read',
+              method: 'GET',
+              path: '/posts',
+              request: {
+                parameters: [
+                  {
+                    name: 'limit',
+                    location: 'query',
+                    schema: { type: 'integer', default: 20 },
+                  },
+                ],
+              },
+              response: {
+                status: 200,
+                schema: {
+                  type: 'array',
+                  items: { ref: { id: 'post' } },
+                },
+              },
+              pagination: {
+                kind: 'limit-offset',
+                limitParameter: 'limit',
+                offsetParameter: 'offset',
+              },
+            },
+            'posts.create': {
+              id: 'posts.create',
+              endpointId: 'posts',
+              protocol: 'http',
+              intent: 'create',
+              method: 'POST',
+              path: '/posts',
+              request: {
+                contentType: 'application/json',
+                schema: { ref: { id: 'post' } },
+              },
+              response: {
+                status: 201,
+                schemaRef: { id: 'post' },
+              },
+            },
+          },
+        },
+      },
+    };
+
+    assertSerializable(source);
+    expect(source.endpoints.posts?.operations['posts.list']?.intent).toBe('read');
+    expect(source.endpoints.posts?.operations['posts.create']?.intent).toBe('create');
+  });
+
+  it('serializes an imported OpenAPI data source', () => {
+    const source: OpenApiDataSourceConfig = {
+      id: 'shop-openapi',
+      kind: 'openapi',
+      name: 'Shop OpenAPI',
+      baseUrl: 'https://shop.example.com/api',
+      import: {
+        url: 'https://shop.example.com/openapi.json',
+        version: '2026-05-19',
+      },
+      endpoints: {
+        products: {
+          id: 'products',
+          kind: 'http',
+          path: '/products/{productId}',
+          operations: {
+            getProduct: {
+              id: 'getProduct',
+              endpointId: 'products',
+              protocol: 'http',
+              intent: 'read',
+              method: 'GET',
+              path: '/products/{productId}',
+              request: {
+                parameters: [
+                  {
+                    name: 'productId',
+                    location: 'path',
+                    required: true,
+                    schema: { type: 'string' },
+                  },
+                ],
+              },
+              response: {
+                status: 200,
+                schema: {
+                  type: 'object',
+                  properties: {
+                    id: { type: 'string' },
+                    name: { type: 'string' },
+                    price: { type: 'number' },
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    };
+
+    assertSerializable(source);
+    expect(source.import?.url).toContain('openapi.json');
+    expect(
+      source.endpoints.products?.operations.getProduct?.request?.parameters?.[0]?.location,
+    ).toBe('path');
+  });
+
+  it('serializes a GraphQL data source with query and mutation operations', () => {
+    const source: GraphQlDataSourceConfig = {
+      id: 'content-graphql',
+      kind: 'graphql',
+      endpointUrl: 'https://content.example.com/graphql',
+      introspection: {
+        enabled: true,
+        schemaVersion: '2026-05-19',
+      },
+      endpoints: {
+        graphql: {
+          id: 'graphql',
+          kind: 'graphql',
+          operations: {
+            PostsQuery: {
+              id: 'PostsQuery',
+              endpointId: 'graphql',
+              protocol: 'graphql',
+              intent: 'read',
+              request: {
+                schema: {
+                  type: 'object',
+                  properties: {
+                    search: { type: 'string' },
+                  },
+                },
+              },
+              response: {
+                schema: {
+                  type: 'object',
+                  properties: {
+                    posts: {
+                      type: 'array',
+                      items: { type: 'object' },
+                    },
+                  },
+                },
+              },
+            },
+            CreatePost: {
+              id: 'CreatePost',
+              endpointId: 'graphql',
+              protocol: 'graphql',
+              intent: 'create',
+              request: {
+                schema: {
+                  type: 'object',
+                  required: ['title'],
+                  properties: {
+                    title: { type: 'string' },
+                  },
+                },
+              },
+              response: {
+                schema: {
+                  type: 'object',
+                  properties: {
+                    createPost: { type: 'object' },
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    };
+
+    assertSerializable(source);
+    expect(source.endpoints.graphql?.operations.PostsQuery?.protocol).toBe('graphql');
+    expect(source.endpoints.graphql?.operations.CreatePost?.intent).toBe('create');
+  });
+
+  it('serializes a managed API backed by a database adapter reference', () => {
+    const source: ManagedApiDataSourceConfig = {
+      id: 'app-managed-api',
+      kind: 'managed-api',
+      name: 'App managed API',
+      adapter: {
+        id: 'primary-db',
+        kind: 'database',
+        packageName: '@ankhorage/supabase-db',
+      },
+      resources: [
+        {
+          name: 'posts',
+          collection: {
+            name: 'posts',
+            schema: 'public',
+            primaryKey: 'id',
+            fields: [
+              { name: 'id', type: 'uuid', required: true, unique: true },
+              { name: 'title', type: 'text', required: true },
+              { name: 'published', type: 'boolean', defaultValue: false },
+            ],
+          },
+          operations: ['list', 'read', 'create', 'update', 'delete'],
+        },
+      ],
+      endpoints: {
+        posts: {
+          id: 'posts',
+          kind: 'database',
+          operations: {
+            'posts.list': {
+              id: 'posts.list',
+              endpointId: 'posts',
+              protocol: 'database',
+              intent: 'read',
+            },
+            'posts.delete': {
+              id: 'posts.delete',
+              endpointId: 'posts',
+              protocol: 'database',
+              intent: 'delete',
+            },
+          },
+        },
+      },
+    };
+
+    assertSerializable(source);
+    expect(source.adapter.kind).toBe('database');
+    expect(source.resources[0]?.collection.fields.map((field) => field.name)).toEqual([
+      'id',
+      'title',
+      'published',
+    ]);
+  });
+
+  it('accepts a provider-neutral data source registry and diagnostics', () => {
+    const source: DataSourceConfig = {
+      id: 'public-rest',
+      kind: 'rest',
+      baseUrl: 'https://public.example.com',
+      endpoints: {},
+    };
+    const diagnostic: DataSourceDiagnostic = {
+      code: 'missing-operation',
+      severity: 'error',
+      message: 'Operation not found.',
+      dataSourceId: 'public-rest',
+      endpointId: 'posts',
+      operationId: 'posts.list',
+    };
+
+    assertSerializable({ source, diagnostic });
+    expect(diagnostic.code).toBe('missing-operation');
+  });
+});

package/src/data/diagnostics.ts

@@ -0,0 +1,41 @@
+import type { DataSourceId, EndpointId, OperationId } from './ids';
+
+export type DataDiagnosticSeverity = 'error' | 'info' | 'warning';
+
+export type DataDiagnosticCode =
+  | 'ambiguous-server'
+  | 'duplicate-operation-id'
+  | 'invalid-config'
+  | 'missing-adapter'
+  | 'missing-credential'
+  | 'missing-data-source'
+  | 'missing-endpoint'
+  | 'missing-operation'
+  | 'missing-schema'
+  | 'network-error'
+  | 'parse-error'
+  | 'unsupported-auth-scheme'
+  | 'unsupported-schema'
+  | (string & {});
+
+export interface DataSourceDiagnostic {
+  readonly code: DataDiagnosticCode;
+  readonly message: string;
+  readonly severity: DataDiagnosticSeverity;
+  readonly dataSourceId?: DataSourceId;
+  readonly endpointId?: EndpointId;
+  readonly operationId?: OperationId;
+  readonly path?: string;
+  readonly hint?: string;
+}
+
+export type DataSourceDiagnosticResult<TData> =
+  | {
+      readonly ok: true;
+      readonly data: TData;
+      readonly diagnostics?: readonly DataSourceDiagnostic[];
+    }
+  | {
+      readonly ok: false;
+      readonly diagnostics: readonly DataSourceDiagnostic[];
+    };

package/src/data/endpoints.ts

@@ -0,0 +1,20 @@
+import type { EndpointId, OperationId } from './ids';
+import type { DataOperationConfig } from './operations';
+import type { CredentialRef } from './refs';
+import type { DataContractValue } from './values';
+
+export type DataEndpointKind = 'database' | 'graphql' | 'http' | (string & {});
+
+export interface DataEndpointConfig {
+  readonly id: EndpointId;
+  readonly kind: DataEndpointKind;
+  readonly name?: string;
+  readonly description?: string;
+  readonly baseUrl?: string;
+  readonly path?: string;
+  readonly credential?: CredentialRef;
+  readonly operations: Readonly<Record<OperationId, DataOperationConfig>>;
+  readonly metadata?: DataContractValue;
+}
+
+export type DataEndpointRegistry = Readonly<Record<EndpointId, DataEndpointConfig>>;

package/src/data/ids.ts

@@ -0,0 +1,6 @@
+export type DataSourceId = string;
+export type EndpointId = string;
+export type OperationId = string;
+export type SchemaId = string;
+export type CredentialId = string;
+export type AdapterId = string;

package/src/data/index.ts

@@ -0,0 +1,8 @@
+export * from './diagnostics';
+export * from './endpoints';
+export * from './ids';
+export * from './operations';
+export * from './refs';
+export * from './schemas';
+export * from './sources';
+export * from './values';

package/src/data/operations.ts

@@ -0,0 +1,66 @@
+import type { EndpointId, OperationId } from './ids';
+import type { CredentialRef } from './refs';
+import type { DataSchemaSlot } from './schemas';
+import type { DataContractValue } from './values';
+
+export type DataOperationIntent = 'action' | 'create' | 'delete' | 'read' | 'update';
+
+export type DataOperationMethod =
+  | 'DELETE'
+  | 'GET'
+  | 'HEAD'
+  | 'OPTIONS'
+  | 'PATCH'
+  | 'POST'
+  | 'PUT'
+  | (string & {});
+
+export type DataOperationProtocol = 'database' | 'graphql' | 'http' | (string & {});
+
+export type DataOperationParameterLocation = 'body' | 'cookie' | 'header' | 'path' | 'query';
+
+export interface DataOperationParameter extends DataSchemaSlot {
+  readonly name: string;
+  readonly location: DataOperationParameterLocation;
+  readonly required?: boolean;
+  readonly description?: string;
+  readonly default?: DataContractValue;
+}
+
+export interface DataOperationRequest extends DataSchemaSlot {
+  readonly parameters?: readonly DataOperationParameter[];
+  readonly contentType?: string;
+}
+
+export interface DataOperationResponse extends DataSchemaSlot {
+  readonly status?: number | string;
+  readonly contentType?: string;
+  readonly description?: string;
+}
+
+export interface DataOperationPagination {
+  readonly kind: 'cursor' | 'limit-offset' | 'page' | 'unknown' | (string & {});
+  readonly cursorPath?: string;
+  readonly limitParameter?: string;
+  readonly offsetParameter?: string;
+  readonly pageParameter?: string;
+  readonly pageSizeParameter?: string;
+}
+
+export interface DataOperationConfig {
+  readonly id: OperationId;
+  readonly endpointId?: EndpointId;
+  readonly name?: string;
+  readonly description?: string;
+  readonly protocol: DataOperationProtocol;
+  readonly intent: DataOperationIntent;
+  readonly method?: DataOperationMethod;
+  readonly path?: string;
+  readonly request?: DataOperationRequest;
+  readonly response?: DataOperationResponse;
+  readonly pagination?: DataOperationPagination;
+  readonly credential?: CredentialRef;
+  readonly metadata?: DataContractValue;
+}
+
+export type DataOperationRegistry = Readonly<Record<OperationId, DataOperationConfig>>;

package/src/data/refs.ts

@@ -0,0 +1,21 @@
+import type { AdapterId, CredentialId } from './ids';
+import type { DataContractValue } from './values';
+
+export type CredentialKind = 'apiKey' | 'basic' | 'bearer' | 'custom' | 'oauth2';
+
+export interface CredentialRef {
+  readonly id: CredentialId;
+  readonly kind: CredentialKind | (string & {});
+  readonly label?: string;
+  readonly scope?: string;
+}
+
+export type AdapterKind = 'auth' | 'database' | 'storage' | 'transport' | (string & {});
+
+export interface AdapterRef {
+  readonly id: AdapterId;
+  readonly kind: AdapterKind;
+  readonly packageName?: string;
+  readonly exportName?: string;
+  readonly config?: DataContractValue;
+}

package/src/data/schemas.ts

@@ -0,0 +1,46 @@
+import type { SchemaId } from './ids';
+import type { DataContractValue } from './values';
+
+export type DataSchemaPrimitiveType =
+  | 'array'
+  | 'boolean'
+  | 'integer'
+  | 'null'
+  | 'number'
+  | 'object'
+  | 'string';
+
+export interface DataSchemaRef {
+  readonly id: SchemaId;
+}
+
+export interface DataSchemaProperty {
+  readonly description?: string;
+  readonly schema: DataSchema;
+}
+
+export interface DataSchema {
+  readonly type?: DataSchemaPrimitiveType | readonly DataSchemaPrimitiveType[];
+  readonly title?: string;
+  readonly description?: string;
+  readonly enum?: readonly DataContractValue[];
+  readonly const?: DataContractValue;
+  readonly default?: DataContractValue;
+  readonly format?: string;
+  readonly nullable?: boolean;
+  readonly required?: readonly string[];
+  readonly properties?: Readonly<Record<string, DataSchema>>;
+  readonly additionalProperties?: boolean | DataSchema;
+  readonly items?: DataSchema;
+  readonly allOf?: readonly DataSchema[];
+  readonly anyOf?: readonly DataSchema[];
+  readonly oneOf?: readonly DataSchema[];
+  readonly ref?: DataSchemaRef;
+}
+
+export type DataSchemaRegistry = Readonly<Record<SchemaId, DataSchema>>;
+
+export interface DataSchemaSlot {
+  readonly schema?: DataSchema;
+  readonly schemaRef?: DataSchemaRef;
+}

package/src/data/sources.ts

@@ -0,0 +1,72 @@
+import type { DbCollectionDefinition } from '../db';
+import type { DataEndpointRegistry } from './endpoints';
+import type { DataSourceId } from './ids';
+import type { AdapterRef, CredentialRef } from './refs';
+import type { DataSchemaRegistry } from './schemas';
+import type { DataContractValue } from './values';
+
+export type DataSourceKind = 'database' | 'graphql' | 'managed-api' | 'openapi' | 'rest';
+
+export interface DataSourceBaseConfig {
+  readonly id: DataSourceId;
+  readonly kind: DataSourceKind;
+  readonly name?: string;
+  readonly description?: string;
+  readonly credential?: CredentialRef;
+  readonly endpoints: DataEndpointRegistry;
+  readonly schemas?: DataSchemaRegistry;
+  readonly metadata?: DataContractValue;
+}
+
+export interface RestDataSourceConfig extends DataSourceBaseConfig {
+  readonly kind: 'rest';
+  readonly baseUrl: string;
+}
+
+export interface OpenApiImportRef {
+  readonly url?: string;
+  readonly documentId?: string;
+  readonly version?: string;
+}
+
+export interface OpenApiDataSourceConfig extends DataSourceBaseConfig {
+  readonly kind: 'openapi';
+  readonly baseUrl?: string;
+  readonly import?: OpenApiImportRef;
+}
+
+export interface GraphQlDataSourceConfig extends DataSourceBaseConfig {
+  readonly kind: 'graphql';
+  readonly endpointUrl: string;
+  readonly introspection?: {
+    readonly enabled: boolean;
+    readonly schemaVersion?: string;
+  };
+}
+
+export interface DatabaseDataSourceConfig extends DataSourceBaseConfig {
+  readonly kind: 'database';
+  readonly adapter: AdapterRef;
+}
+
+export interface ManagedApiResourceConfig {
+  readonly name: string;
+  readonly collection: DbCollectionDefinition;
+  readonly operations?: readonly ('create' | 'delete' | 'list' | 'read' | 'update')[];
+  readonly metadata?: DataContractValue;
+}
+
+export interface ManagedApiDataSourceConfig extends DataSourceBaseConfig {
+  readonly kind: 'managed-api';
+  readonly adapter: AdapterRef;
+  readonly resources: readonly ManagedApiResourceConfig[];
+}
+
+export type DataSourceConfig =
+  | DatabaseDataSourceConfig
+  | GraphQlDataSourceConfig
+  | ManagedApiDataSourceConfig
+  | OpenApiDataSourceConfig
+  | RestDataSourceConfig;
+
+export type DataSourceRegistry = Readonly<Record<DataSourceId, DataSourceConfig>>;

package/src/data/values.ts

@@ -0,0 +1,11 @@
+export type DataContractValue =
+  | string
+  | number
+  | boolean
+  | null
+  | readonly DataContractValue[]
+  | {
+      readonly [key: string]: DataContractValue;
+    };
+
+export type DataPath = string;

package/src/index.ts

@@ -1,5 +1,6 @@
 export * from './auth';
 export * from './bindings';
+export * from './data';
 export * from './db';
 export * from './state';
 export * from './storage';