@oddington/sdk 0.1.2 → 0.1.3

package/dist/types/packages/sdk/src/public.d.ts

@@ -12,6 +12,45 @@ export { RoutineRecordWriteError } from '../../../shared/record-write.js';
 export { AirtableOperationError } from '../../../shared/airtable-contract.js';
 export type { AirtableField, AirtableTable, AirtableRecord, AirtableListInput, AirtableGetInput, AirtableCreateInput, AirtableUpdateInput, AirtableDeleteInput, AirtableReceipt, AirtableWriteResult, AirtableClient, Connections } from '../../../shared/airtable-contract.js';
 export declare const connections: import('../../../shared/airtable-contract.js').Connections;
+export { DataOperationError } from '../../../shared/data-contract.js';
+export type { DataRepository, DataErrorCode, PublicValueDefinition, PublicField, CollectionSummary, CollectionSchema, QueryScalar, SelectionOptions, RecordSelection, RecordsQuery, DataValue, SelectedRecord, SelectionMetadata, RecordsResult } from '../../../shared/data-contract.js';
+export declare const data: {
+    repository(name: string): import('../../../shared/data-contract.js').DataRepository;
+};
+/** The host's existing refreshing session source; supplies identity, never membership. */
+export type HostedSessionSource = {
+    getSession(): Promise<{
+        data: {
+            session: {
+                access_token: string;
+                expires_at?: number;
+                user: {
+                    id: string;
+                };
+            } | null;
+        };
+        error: unknown;
+    }>;
+    onAuthStateChange(callback: (event: string, session: {
+        access_token: string;
+        expires_at?: number;
+        user: {
+            id: string;
+        };
+    } | null) => void): {
+        data: {
+            subscription: {
+                unsubscribe(): void;
+            };
+        };
+    };
+};
+/** OS-owned HTTPS browser bootstrap. Reinitialization replaces the previous context. */
+export declare const os: {
+    init(options: {
+        auth: HostedSessionSource;
+    }): void;
+};
 export type InboxRequester = (path: string, init?: RequestInit) => Promise<Response>;
 export type RoutinePublicationClientOptions = {
     workspace?: string;

package/dist/types/shared/data-contract.d.ts

@@ -0,0 +1,95 @@
+/** Canonical value vocabulary shared by schema normalization and public reads. */
+export type DataValueDefinition<Extra extends object = object> = {
+    nullable: boolean;
+    many: boolean;
+    description?: string;
+    term?: string;
+} & Extra & ({
+    kind: 'string' | 'integer' | 'boolean';
+} | {
+    kind: 'number';
+    precision?: number;
+} | {
+    kind: 'date';
+    format?: 'month';
+} | {
+    kind: 'const';
+    value: string | number | boolean;
+} | {
+    kind: 'enum';
+    values: string[];
+} | {
+    kind: 'link';
+    to: string[];
+} | {
+    kind: 'object';
+    fields: Array<DataValueDefinition<Extra> & {
+        name: string;
+    }>;
+} | {
+    kind: 'map';
+    key: DataValueDefinition<Extra>;
+    value: DataValueDefinition<Extra>;
+});
+export type PublicValueDefinition = DataValueDefinition;
+export type PublicField = PublicValueDefinition & {
+    name: string;
+};
+export type CollectionSummary = {
+    name: string;
+    type: string;
+    description?: string;
+};
+export type CollectionSchema = CollectionSummary & {
+    fields: PublicField[];
+};
+export type QueryScalar = string | number | boolean | null;
+export type SelectionOptions = {
+    where?: Record<string, QueryScalar | {
+        $in: QueryScalar[];
+    }>;
+    fields?: string[];
+    order?: Record<string, 'asc' | 'desc'>;
+    limit?: number;
+    count?: boolean;
+    after?: string;
+};
+export type RecordSelection = {
+    $?: SelectionOptions;
+    [link: string]: RecordSelection | SelectionOptions | undefined;
+};
+export type RecordsQuery = Record<string, RecordSelection>;
+export type DataValue = QueryScalar | DataValue[] | {
+    [field: string]: DataValue;
+};
+export type SelectedRecord = {
+    $ref: string;
+    $version: string;
+    [field: string]: DataValue;
+};
+export type SelectionMetadata = {
+    version: string;
+    collections: Record<string, {
+        count?: number;
+        next?: string;
+    }>;
+};
+export type RecordsResult = {
+    $meta: SelectionMetadata;
+    [collection: string]: SelectedRecord[] | SelectionMetadata;
+};
+export interface DataRepository {
+    collections: {
+        list(): Promise<CollectionSummary[]>;
+        schema(name: string): Promise<CollectionSchema>;
+    };
+    records: {
+        select(query: RecordsQuery): Promise<RecordsResult>;
+    };
+}
+export type DataErrorCode = 'context_unavailable' | 'unauthenticated' | 'access_denied' | 'invalid_query' | 'request_too_large' | 'capacity' | 'unavailable';
+export declare class DataOperationError extends Error {
+    readonly code: DataErrorCode;
+    readonly retryable: boolean;
+    constructor(code: DataErrorCode, retryable?: boolean);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oddington/sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Oddington routine and response-handler SDK",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",