@oddington/sdk 0.1.14 → 0.1.16

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

@@ -2,7 +2,7 @@ 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 type { RoutineSchema, RoutineSchemaValue, RoutineDefinition, RoutineInput, RoutineRuntime } from './routine-definition-types.js';
+export type { RoutineSchema, RoutineSchemaValue, RoutineDefinition, RoutineInput, RoutineRuntime, RoutineArtifactInput, RoutineArtifact } from './routine-definition-types.js';
 export declare const defineRoutine: import('./routine-definition-types.js').DefineRoutine;
 export declare const schema: import('./routine-definition-types.js').RoutineSchemaBuilders;
 export declare const file: import('./routine-definition-types.js').RoutineFileSchema;
@@ -84,7 +84,7 @@ export declare const auth: {
 /** Customer-owned module augmentation supplies types, never runtime authority. */
 export interface AppRoutineTypes {
 }
-export type AppRoutineErrorReason = 'authority_unavailable' | 'execution_unavailable' | 'invalid_input';
+export type AppRoutineErrorReason = 'not_enabled' | 'authority_unavailable' | 'execution_unavailable' | 'invalid_input';
 export declare class AppRoutineError extends Error {
     readonly reason: AppRoutineErrorReason;
     constructor(reason: AppRoutineErrorReason);
@@ -125,7 +125,7 @@ export type AppRoutineBinding<Input, Result, Steps> = {
         steps: Extract<keyof Steps, string>[];
     } | {
         available: false;
-        reason: 'authority_unavailable' | 'execution_unavailable';
+        reason: 'not_enabled' | 'authority_unavailable' | 'execution_unavailable';
     }>;
     run(input: Input): Promise<AppRoutineHandle<Result, Steps>>;
     recover(): Promise<AppRoutineHandle<Result, Steps>[]>;

package/dist/types/packages/sdk/src/routine-definition-types.d.ts

@@ -13,6 +13,22 @@ export type RoutineSteps = Record<string, RoutineSchema<unknown> | null>;
 export type RoutineInput<Value> = Value extends object ? {
     readonly [Key in keyof Value]: RoutineInput<Value[Key]>;
 } : Value;
+export type RoutineArtifactInput = Readonly<{
+    requestKey: string;
+    name: string;
+    mediaType: string;
+    size: number;
+    sha256: string;
+    content: Uint8Array | Blob | ReadableStream<Uint8Array>;
+}>;
+export type RoutineArtifact = Readonly<{
+    id: string;
+    attempt: string;
+    name: string;
+    mediaType: string;
+    size: number;
+    sha256: string;
+}>;
 export type RoutineRuntime<Steps extends RoutineSteps> = {
     readonly run: {
         readonly id: string;
@@ -23,6 +39,7 @@ export type RoutineRuntime<Steps extends RoutineSteps> = {
     readonly files: typeof files;
     readonly connections: Connections;
     readonly inbox: RoutinePublicationClient;
+    artifact(input: RoutineArtifactInput): Promise<RoutineArtifact>;
     step<Key extends Extract<keyof Steps, string>>(id: Key, ...summary: Steps[Key] extends null ? [] : [summary: RoutineSchemaValue<Steps[Key]>]): Promise<void>;
 };
 export type RoutineDefinition<Input extends RoutineSchema<unknown> | undefined, Steps extends RoutineSteps, Result extends RoutineSchema<unknown> | undefined> = {

package/dist/types/shared/app-routine-contract.d.ts

@@ -1,3 +1,14 @@
+/** Safe member-scoped service facts; local runtime readiness is checked by the host. */
+export type AppRoutineAvailability = {
+    available: true;
+} | {
+    available: false;
+    reason: 'not_enabled' | 'authority_unavailable';
+};
+export declare class AppRoutineNotEnabled extends Error {
+    constructor();
+}
+export declare function parseAppRoutineAvailability(value: unknown): AppRoutineAvailability;
 export type AppValueSchema = {
     type: 'object';
     properties: Record<string, AppValueSchema>;

package/package.json

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