@oddington/sdk 0.1.1 → 0.1.3

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

@@ -2,13 +2,55 @@ import type { AskInput, CapturedRecords, DigestInput, InboxFile, PublicationRequ
 import type { FileAddOptions } from '../../../shared/inbox-files.js';
 import type { RecordReadInput } from '../../../shared/record-capture.js';
 import type { RecordDeleteRequest, RecordUpdateRequest, RecordWriteRequest } from '../../../shared/record-write.js';
-export { InboxContractError, asksBlock, continueAsk, defineHandler, fileBlock, oddington, question, recordBlock, recordsBlock, resolveAsk, respond, richTextBlock, selection, } from '../../../shared/inbox-contract.js';
-export type { AskInput, AuthoredSource, CapturedRecords, CsvDetails, DigestInput, Handler, HandlerReference, HandlerRuntime, HandlerTransition, InboxBlock, InboxFile, JsonObject, JsonValue, OddingtonAssignment, PresentedField, PresentedRecord, PresentedRecordSummary, PublishedAsk, PublishedDigest, PublishedView, PublicationRequest, Question, QuestionInput, QuestionResponse, RecordCreate, RecordDelete, RecordReference, RecordSource, RecordUpdate, RepositoryCapabilities, RepositoryReceipt, Resolution, ResolutionInput, ResponseDefinition, } from '../../../shared/inbox-contract.js';
+export { InboxContractError, asksBlock, continueAsk, defineHandler, fileBlock, question, recordBlock, recordsBlock, resolveAsk, respond, richTextBlock, selection, } from '../../../shared/inbox-contract.js';
+export type { AskInput, AuthoredSource, CapturedRecords, CsvDetails, DigestInput, Handler, HandlerReference, HandlerRuntime, HandlerTransition, InboxBlock, InboxFile, JsonObject, JsonValue, PresentedField, PresentedRecord, PresentedRecordSummary, PublishedAsk, PublishedDigest, PublishedView, PublicationRequest, Question, QuestionInput, QuestionResponse, RecordCreate, RecordDelete, RecordReference, RecordSource, RecordUpdate, RepositoryCapabilities, RepositoryReceipt, Resolution, ResolutionInput, ResponseDefinition, } from '../../../shared/inbox-contract.js';
 export type { CapturedRecordTableInput, RecordField, RecordTableInput, RecordValue, RecordViewInput, TableColumn, ViewRecord, } from '../../../shared/inbox-views.js';
 export type { FileAddOptions } from '../../../shared/inbox-files.js';
 export type { RecordReadInput } from '../../../shared/record-capture.js';
 export type { RecordDeleteRequest, RecordUpdateRequest, RecordWriteRequest } from '../../../shared/record-write.js';
 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/airtable-contract.d.ts

@@ -0,0 +1,82 @@
+import type { JsonObject, JsonValue } from './inbox-contract.js';
+export type AirtableField = {
+    id: string;
+    name: string;
+    type: string;
+    options?: JsonValue;
+};
+export type AirtableTable = {
+    id: string;
+    name: string;
+    primaryFieldId: string;
+    fields: AirtableField[];
+};
+export type AirtableRecord = {
+    id: string;
+    createdTime?: string;
+    fields: JsonObject;
+};
+export type AirtableListInput = {
+    table: string;
+    fields?: string[];
+};
+export type AirtableGetInput = {
+    table: string;
+    id: string;
+};
+export type AirtableCreateInput = {
+    table: string;
+    records: Array<{
+        fields: JsonObject;
+    }>;
+};
+export type AirtableUpdateInput = {
+    table: string;
+    records: Array<{
+        id: string;
+        expected: JsonObject;
+        set: JsonObject;
+    }>;
+};
+export type AirtableDeleteInput = {
+    table: string;
+    records: Array<{
+        id: string;
+        expected: JsonObject;
+    }>;
+};
+export type AirtableReceipt = {
+    provider: 'airtable';
+    connection: `airtable/${string}`;
+    baseId: string;
+    table: string;
+    operation: 'create' | 'update' | 'delete';
+    records: Array<{
+        id: string;
+    }>;
+};
+export type AirtableWriteResult = {
+    receipt: AirtableReceipt;
+    records?: AirtableRecord[];
+};
+export interface AirtableClient {
+    tables: {
+        list(): Promise<AirtableTable[]>;
+    };
+    records: {
+        list(input: AirtableListInput): Promise<AirtableRecord[]>;
+        get(input: AirtableGetInput): Promise<AirtableRecord>;
+        create(input: AirtableCreateInput): Promise<AirtableWriteResult>;
+        update(input: AirtableUpdateInput): Promise<AirtableWriteResult>;
+        delete(input: AirtableDeleteInput): Promise<AirtableWriteResult>;
+    };
+}
+export interface Connections {
+    airtable(name: string): AirtableClient;
+}
+/** Safe provider failure. An uncertain or partial mutation must never be retried blindly. */
+export declare class AirtableOperationError extends Error {
+    readonly effect: 'unapplied' | 'partial' | 'uncertain';
+    readonly receipts: AirtableReceipt[];
+    constructor(message: string, effect?: 'unapplied' | 'partial' | 'uncertain', receipts?: AirtableReceipt[]);
+}

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/dist/types/shared/inbox-contract.d.ts

@@ -188,17 +188,12 @@ export type QuestionInstance = {
 export type ResponseSubmission = QuestionInstance & {
     response: QuestionResponse;
 };
-export type OddingtonAssignment = {
-    type: 'oddington';
-    reason: string;
-};
 export type Resolution = {
     outcome: string;
     evidence?: JsonValue[];
 };
 export type HandlerTransition = {
     type: 'continue';
-    assignTo?: OddingtonAssignment;
 } | ({
     type: 'resolve';
 } & Resolution);
@@ -268,6 +263,7 @@ export type HandlerRuntime<Input extends JsonValue = JsonValue> = {
     responseDefinition: ResponseDefinition;
     questionId: string;
     repository: RepositoryCapabilities;
+    connections: import('./airtable-contract.js').Connections;
 };
 export type Handler<Input extends JsonValue = JsonValue> = {
     id: string;
@@ -322,12 +318,7 @@ export declare function validatePublication(value: unknown): Publication;
 /** Structural projection only. The read boundary must check current recipient,
  * workspace and repository/file access before returning this content. */
 export declare function recipientPresentation(value: unknown): RecipientPublication;
-export declare function oddington(value: {
-    reason: string;
-}): OddingtonAssignment;
-export declare function continueAsk(value: {
-    assignTo?: OddingtonAssignment;
-}): HandlerTransition;
+export declare function continueAsk(value: Record<string, never>): HandlerTransition;
 export declare function resolveAsk(value: Resolution): HandlerTransition;
 /** Call at the durable transition boundary with server-derived remaining work,
  * excluding the execution being completed. Lifecycle/effect guards also apply. */

package/package.json

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