little-durable-objects 0.1.0

package/dist/regions.js

@@ -0,0 +1,46 @@
+const canonicalRegionPattern = /^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$/u;
+const recommendedRegionCatalog = {
+    "north-america-east": {
+        modal: { regions: ["us-east"], cloud: "gcp", observedPlacements: ["gcp:us-east*"] }
+    },
+    "north-america-central": {
+        modal: { regions: ["us-central"], cloud: "gcp", observedPlacements: ["gcp:us-central*"] }
+    },
+    "north-america-south": {
+        modal: { regions: ["us-south"], cloud: "gcp", observedPlacements: ["gcp:us-south*"] }
+    },
+    "north-america-west": {
+        modal: { regions: ["us-west"], cloud: "gcp", observedPlacements: ["gcp:us-west*"] }
+    },
+    "europe-west": {
+        modal: { regions: ["eu-west"], cloud: "gcp", observedPlacements: ["gcp:europe-west*"] }
+    },
+    "asia-southeast": {
+        modal: { regions: ["ap-southeast"], cloud: "gcp", observedPlacements: ["gcp:asia-southeast*"] }
+    }
+};
+function modalPlacement(region, catalog = recommendedRegionCatalog) {
+    const placement = catalog[validateCanonicalRegion(region)]?.modal;
+    if (!placement)
+        throw new Error(`canonical region ${JSON.stringify(region)} has no Modal placement`);
+    return placement;
+}
+function canonicalRegionForModal(cloud, region, catalog = recommendedRegionCatalog) {
+    if (!region)
+        return undefined;
+    const normalizedRegion = region.toLowerCase();
+    const normalizedCloud = cloud?.toLowerCase().replace(/^cloud_provider_/u, "");
+    const candidates = [normalizedCloud ? `${normalizedCloud}:${normalizedRegion}` : undefined, normalizedRegion].filter((candidate) => candidate !== undefined);
+    return Object.entries(catalog).find(([, definition]) => definition.modal.observedPlacements.some(pattern => candidates.some(candidate => matchesPlacement(pattern, candidate))))?.[0];
+}
+function validateCanonicalRegion(value) {
+    if (!canonicalRegionPattern.test(value))
+        throw new Error(`invalid canonical region ${JSON.stringify(value)}`);
+    return value;
+}
+function matchesPlacement(pattern, candidate) {
+    const normalized = pattern.toLowerCase();
+    return normalized.endsWith("*") ? candidate.startsWith(normalized.slice(0, -1)) : candidate === normalized;
+}
+export { canonicalRegionForModal, modalPlacement, recommendedRegionCatalog, validateCanonicalRegion };
+//# sourceMappingURL=regions.js.map

package/dist/regions.js.map

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

package/dist/shared/actor.d.ts

@@ -0,0 +1,28 @@
+declare abstract class Actor {
+    protected constructor();
+    static get<TActorClass extends ActorClass>(this: ValidActorClass<TActorClass>, actorId: string): ActorReference<TActorClass["prototype"]>;
+    protected get id(): string;
+}
+declare function registerActorClass<Instance extends Actor>(actorClass: ActorClass<Instance>): ActorDefinition;
+declare function findActorDefinition(actorType: string): ActorDefinition | undefined;
+declare function bindActorIdentity(instance: Actor, actorId: string): void;
+interface ActorDefinition {
+    readonly actorType: string;
+    readonly actorClass: ActorClass;
+    readonly methods: ReadonlySet<string>;
+}
+type ActorClass<Instance extends Actor = Actor> = Function & {
+    readonly prototype: Instance;
+};
+type AsyncMethod = (...args: never[]) => Promise<unknown>;
+type PubliclyConstructibleActorClass = abstract new (...args: never[]) => Actor;
+type InvalidActorMethod<Instance extends Actor> = {
+    [Key in keyof Instance]: Instance[Key] extends (...args: never[]) => unknown ? (Instance[Key] extends AsyncMethod ? never : Key) : never;
+}[keyof Instance];
+type ValidActorClass<TActorClass extends ActorClass> = TActorClass extends PubliclyConstructibleActorClass ? never : InvalidActorMethod<TActorClass["prototype"]> extends never ? TActorClass : never;
+type ActorReference<Instance extends Actor> = {
+    [Key in keyof Instance as Instance[Key] extends AsyncMethod ? Key : never]: Instance[Key];
+};
+export { Actor, bindActorIdentity, findActorDefinition, registerActorClass };
+export type { ActorClass, ActorDefinition, ActorReference };
+//# sourceMappingURL=actor.d.ts.map

package/dist/shared/actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../../shared/actor.ts"],"names":[],"mappings":"AAUA,uBAAe,KAAK;IAChB,SAAS;IAET,MAAM,CAAC,GAAG,CAAC,WAAW,SAAS,UAAU,EAAE,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAIzI,SAAS,KAAK,EAAE,IAAI,MAAM,CAEzB;CACJ;AAED,iBAAS,kBAAkB,CAAC,QAAQ,SAAS,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,eAAe,CAgBrG;AAED,iBAAS,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE3E;AAQD,iBAAS,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjE;AA0DD,UAAU,eAAe;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACxC;AAMD,KAAK,UAAU,CAAC,QAAQ,SAAS,KAAK,GAAG,KAAK,IAAI,QAAQ,GAAG;IACzD,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAA;CAC/B,CAAA;AAED,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AACzD,KAAK,+BAA+B,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,CAAA;AAC/E,KAAK,kBAAkB,CAAC,QAAQ,SAAS,KAAK,IAAI;KAC7C,GAAG,IAAI,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,WAAW,GAAG,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK;CAC3I,CAAC,MAAM,QAAQ,CAAC,CAAA;AACjB,KAAK,eAAe,CAAC,WAAW,SAAS,UAAU,IAAI,WAAW,SAAS,+BAA+B,GAAG,KAAK,GAAG,kBAAkB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,SAAS,KAAK,GAAG,WAAW,GAAG,KAAK,CAAA;AACrM,KAAK,cAAc,CAAC,QAAQ,SAAS,KAAK,IAAI;KACzC,GAAG,IAAI,MAAM,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,WAAW,GAAG,GAAG,GAAG,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC;CAC5F,CAAA;AAED,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,CAAA;AAC5E,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,CAAA"}

package/dist/shared/actor.js

@@ -0,0 +1,105 @@
+import { actorClient } from "../workflow/client.js";
+import { ActorDefinitionError } from "./errors.js";
+import { validateActorComponent } from "./types.js";
+const actorMetadata = new WeakMap();
+const actorDefinitions = new Map();
+const asyncFunction = Object.getPrototypeOf(async () => { }).constructor;
+const referenceClasses = new WeakMap();
+class Actor {
+    constructor() { }
+    static get(actorId) {
+        return getActorReference(this, validateActorComponent("actor ID", actorId));
+    }
+    get id() {
+        return metadataFor(this).actorId;
+    }
+}
+function registerActorClass(actorClass) {
+    const actorType = actorName(actorClass);
+    const existing = actorDefinitions.get(actorType);
+    if (existing !== undefined) {
+        if (existing.actorClass !== actorClass)
+            throw new ActorDefinitionError(`duplicate actor type ${actorType}`);
+        return existing;
+    }
+    validateActorClass(actorClass, actorType);
+    const definition = {
+        actorType: validateActorComponent("actor type", actorType),
+        actorClass,
+        methods: new Set(discoverMethods(actorClass, actorType))
+    };
+    actorDefinitions.set(actorType, definition);
+    return definition;
+}
+function findActorDefinition(actorType) {
+    return actorDefinitions.get(actorType);
+}
+function getActorReference(actorClass, actorId) {
+    const definition = registerActorClass(actorClass);
+    const Reference = referenceClass(definition);
+    return new Reference(actorId);
+}
+function bindActorIdentity(instance, actorId) {
+    actorMetadata.set(instance, { actorId: validateActorComponent("actor ID", actorId) });
+}
+function referenceClass(definition) {
+    const existing = referenceClasses.get(definition.actorClass);
+    if (existing !== undefined)
+        return existing;
+    class ActorReference extends Actor {
+        constructor(actorId) {
+            super();
+            bindActorIdentity(this, actorId);
+        }
+    }
+    definition.methods.forEach(method => {
+        Object.defineProperty(ActorReference.prototype, method, {
+            configurable: false,
+            enumerable: false,
+            writable: false,
+            value: function forwardActorMethod(...args) {
+                const metadata = metadataFor(this);
+                return actorClient().invoke(definition.actorType, metadata.actorId, method, args);
+            }
+        });
+    });
+    referenceClasses.set(definition.actorClass, ActorReference);
+    return ActorReference;
+}
+function metadataFor(instance) {
+    const metadata = actorMetadata.get(instance);
+    if (metadata === undefined)
+        throw new ActorDefinitionError("actor identity is unavailable outside an actor invocation");
+    return metadata;
+}
+function discoverMethods(actorClass, actorType) {
+    if (Object.getOwnPropertySymbols(actorClass.prototype).length > 0)
+        throw new ActorDefinitionError(`actor class ${actorType} cannot define symbol methods`);
+    return Object.entries(Object.getOwnPropertyDescriptors(actorClass.prototype)).flatMap(([name, descriptor]) => {
+        if (name === "constructor")
+            return [];
+        if (descriptor.get !== undefined || descriptor.set !== undefined)
+            throw new ActorDefinitionError(`actor class ${actorType} cannot define accessor ${name}`);
+        if (typeof descriptor.value !== "function")
+            return [];
+        validateActorComponent("actor method", name);
+        if (name === "then")
+            throw new ActorDefinitionError(`actor class ${actorType} cannot define method then`);
+        if (!(descriptor.value instanceof asyncFunction))
+            throw new ActorDefinitionError(`actor method ${actorType}.${name} must be async`);
+        return [name];
+    });
+}
+function validateActorClass(actorClass, actorType) {
+    if (Object.getPrototypeOf(actorClass.prototype) !== Actor.prototype)
+        throw new ActorDefinitionError(`actor class ${actorType} must extend Actor directly`);
+    if (actorClass.length !== 0)
+        throw new ActorDefinitionError(`actor class ${actorType} cannot require constructor arguments`);
+}
+function actorName(actorClass) {
+    if (actorClass.name.length === 0)
+        throw new ActorDefinitionError("actor classes must be named");
+    return actorClass.name;
+}
+export { Actor, bindActorIdentity, findActorDefinition, registerActorClass };
+//# sourceMappingURL=actor.js.map

package/dist/shared/actor.js.map

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

package/dist/shared/errors.d.ts

@@ -0,0 +1,25 @@
+declare class ActorConfigurationError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+declare class ActorDefinitionError extends Error {
+    constructor(message: string);
+}
+declare class ActorInvocationError extends Error {
+    readonly code: string;
+    readonly requestId: string;
+    constructor(code: string, requestId: string, message: string);
+}
+declare class ActorSessionError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+declare class ActorProtocolError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+declare class ActorSerializationError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+declare class ActorValidationError extends Error {
+    constructor(message: string);
+}
+export { ActorConfigurationError, ActorDefinitionError, ActorInvocationError, ActorProtocolError, ActorSerializationError, ActorSessionError, ActorValidationError };
+//# sourceMappingURL=errors.d.ts.map

package/dist/shared/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../shared/errors.ts"],"names":[],"mappings":"AAAA,cAAM,uBAAwB,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAItD;AAED,cAAM,oBAAqB,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI9B;AAED,cAAM,oBAAqB,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;gBAEd,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM/D;AAED,cAAM,iBAAkB,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAItD;AAED,cAAM,kBAAmB,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAItD;AAED,cAAM,uBAAwB,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAItD;AAED,cAAM,oBAAqB,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI9B;AAED,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAA"}

package/dist/shared/errors.js

@@ -0,0 +1,48 @@
+class ActorConfigurationError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ActorConfigurationError";
+    }
+}
+class ActorDefinitionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ActorDefinitionError";
+    }
+}
+class ActorInvocationError extends Error {
+    code;
+    requestId;
+    constructor(code, requestId, message) {
+        super(message);
+        this.name = "ActorInvocationError";
+        this.code = code;
+        this.requestId = requestId;
+    }
+}
+class ActorSessionError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ActorSessionError";
+    }
+}
+class ActorProtocolError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ActorProtocolError";
+    }
+}
+class ActorSerializationError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ActorSerializationError";
+    }
+}
+class ActorValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ActorValidationError";
+    }
+}
+export { ActorConfigurationError, ActorDefinitionError, ActorInvocationError, ActorProtocolError, ActorSerializationError, ActorSessionError, ActorValidationError };
+//# sourceMappingURL=errors.js.map

package/dist/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../shared/errors.ts"],"names":[],"mappings":"AAAA,MAAM,uBAAwB,SAAQ,KAAK;IACvC,YAAY,OAAe,EAAE,OAAsB;QAC/C,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACzC,CAAC;CACJ;AAED,MAAM,oBAAqB,SAAQ,KAAK;IACpC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACtC,CAAC;CACJ;AAED,MAAM,oBAAqB,SAAQ,KAAK;IAC3B,IAAI,CAAQ;IACZ,SAAS,CAAQ;IAE1B,YAAY,IAAY,EAAE,SAAiB,EAAE,OAAe;QACxD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC9B,CAAC;CACJ;AAED,MAAM,iBAAkB,SAAQ,KAAK;IACjC,YAAY,OAAe,EAAE,OAAsB;QAC/C,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACnC,CAAC;CACJ;AAED,MAAM,kBAAmB,SAAQ,KAAK;IAClC,YAAY,OAAe,EAAE,OAAsB;QAC/C,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IACpC,CAAC;CACJ;AAED,MAAM,uBAAwB,SAAQ,KAAK;IACvC,YAAY,OAAe,EAAE,OAAsB;QAC/C,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACzC,CAAC;CACJ;AAED,MAAM,oBAAqB,SAAQ,KAAK;IACpC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACtC,CAAC;CACJ;AAED,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAA"}

package/dist/shared/invocationContext.d.ts

@@ -0,0 +1,4 @@
+declare function runInActorInvocation<T>(operation: () => T): T;
+declare function currentActorInvocation(): true | undefined;
+export { currentActorInvocation, runInActorInvocation };
+//# sourceMappingURL=invocationContext.d.ts.map

package/dist/shared/invocationContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocationContext.d.ts","sourceRoot":"","sources":["../../shared/invocationContext.ts"],"names":[],"mappings":"AAIA,iBAAS,oBAAoB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAEtD;AAED,iBAAS,sBAAsB,IAAI,IAAI,GAAG,SAAS,CAElD;AAED,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAA"}

package/dist/shared/invocationContext.js

@@ -0,0 +1,10 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const invocationStorage = new AsyncLocalStorage();
+function runInActorInvocation(operation) {
+    return invocationStorage.run(true, operation);
+}
+function currentActorInvocation() {
+    return invocationStorage.getStore();
+}
+export { currentActorInvocation, runInActorInvocation };
+//# sourceMappingURL=invocationContext.js.map

package/dist/shared/invocationContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocationContext.js","sourceRoot":"","sources":["../../shared/invocationContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAQ,CAAA;AAEvD,SAAS,oBAAoB,CAAI,SAAkB;IAC/C,OAAO,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;AACjD,CAAC;AAED,SAAS,sBAAsB;IAC3B,OAAO,iBAAiB,CAAC,QAAQ,EAAE,CAAA;AACvC,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAA"}

package/dist/shared/types.d.ts

@@ -0,0 +1,123 @@
+import { z } from "zod";
+type JsonPrimitive = string | number | boolean | null;
+type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+type JsonValue = JsonPrimitive | JsonObject | readonly JsonValue[];
+declare const invokeCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"invoke">;
+    request_id: z.ZodString;
+    actor: z.ZodObject<{
+        namespace_id: z.ZodString;
+        actor_type: z.ZodString;
+        actor_id: z.ZodString;
+    }, z.core.$strip>;
+    method: z.ZodString;
+    args: z.ZodArray<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    state: z.ZodNullable<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+}, z.core.$strip>;
+declare const evictCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"evict">;
+    actor: z.ZodObject<{
+        namespace_id: z.ZodString;
+        actor_type: z.ZodString;
+        actor_id: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const executorCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"invoke">;
+    request_id: z.ZodString;
+    actor: z.ZodObject<{
+        namespace_id: z.ZodString;
+        actor_type: z.ZodString;
+        actor_id: z.ZodString;
+    }, z.core.$strip>;
+    method: z.ZodString;
+    args: z.ZodArray<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    state: z.ZodNullable<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"evict">;
+    actor: z.ZodObject<{
+        namespace_id: z.ZodString;
+        actor_type: z.ZodString;
+        actor_id: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>], "type">;
+declare const actorSessionServerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"attached">;
+    protocol: z.ZodLiteral<11>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"command">;
+    message_id: z.ZodNumber;
+    command: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"invoke">;
+        request_id: z.ZodString;
+        actor: z.ZodObject<{
+            namespace_id: z.ZodString;
+            actor_type: z.ZodString;
+            actor_id: z.ZodString;
+        }, z.core.$strip>;
+        method: z.ZodString;
+        args: z.ZodArray<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        state: z.ZodNullable<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"evict">;
+        actor: z.ZodObject<{
+            namespace_id: z.ZodString;
+            actor_type: z.ZodString;
+            actor_id: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "type">;
+}, z.core.$strip>], "type">;
+declare class JsonActorStateSerializer {
+    clone(value: unknown, label: string): JsonValue;
+    snapshot(instance: object): JsonObject;
+    hydrate(instance: object, state: JsonObject): void;
+    private cloneObject;
+    private cloneValue;
+    private encode;
+}
+declare function validateActorComponent(name: string, value: string): string;
+declare function parseActorSessionServerMessage(document: string): ActorSessionServerMessage;
+declare function failedReply(code: string, message: string): FailedReply;
+declare function errorMessage(error: unknown): string;
+type InvokeCommand = z.infer<typeof invokeCommandSchema>;
+type EvictCommand = z.infer<typeof evictCommandSchema>;
+type ActorExecutorCommand = z.infer<typeof executorCommandSchema>;
+type ActorSessionServerMessage = z.infer<typeof actorSessionServerMessageSchema>;
+type ActorExecutorReply = InvokedReply | FailedReply | EvictedReply;
+type ActorSessionClientMessage = AttachMessage | ReplyMessage;
+interface AttachMessage {
+    readonly type: "attach";
+    readonly protocol: 11;
+    readonly actor_types: readonly string[];
+}
+interface ReplyMessage {
+    readonly type: "reply";
+    readonly message_id: number;
+    readonly reply: ActorExecutorReply;
+}
+interface InvokedReply {
+    readonly type: "invoked";
+    readonly result: JsonValue;
+    readonly state: JsonObject;
+}
+interface FailedReply {
+    readonly type: "failed";
+    readonly code: string;
+    readonly message: string;
+}
+interface EvictedReply {
+    readonly type: "evicted";
+}
+interface ActorWorkerData {
+    readonly actorType: string;
+    readonly moduleUrl: string;
+}
+type ActorWorkerRequest = {
+    readonly type: "invoke";
+    readonly command: InvokeCommand;
+};
+export { JsonActorStateSerializer, errorMessage, failedReply, parseActorSessionServerMessage, validateActorComponent };
+export type { ActorExecutorCommand, ActorExecutorReply, ActorSessionClientMessage, ActorSessionServerMessage, ActorWorkerData, ActorWorkerRequest, EvictCommand, InvokeCommand, JsonObject, JsonPrimitive, JsonValue };
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

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

package/dist/shared/types.js

@@ -0,0 +1,111 @@
+import { z } from "zod";
+import { ActorProtocolError, ActorSerializationError, ActorValidationError } from "./errors.js";
+const actorComponentSchema = z.string().regex(/^[A-Za-z0-9._-]+$/u);
+const jsonValueSchema = z.lazy(() => z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(jsonValueSchema), z.record(z.string(), jsonValueSchema)]));
+const actorIdentitySchema = z.object({
+    namespace_id: actorComponentSchema,
+    actor_type: actorComponentSchema,
+    actor_id: actorComponentSchema
+});
+const invokeCommandSchema = z.object({
+    type: z.literal("invoke"),
+    request_id: actorComponentSchema,
+    actor: actorIdentitySchema,
+    method: actorComponentSchema,
+    args: z.array(jsonValueSchema),
+    state: jsonValueSchema.nullable()
+});
+const evictCommandSchema = z.object({
+    type: z.literal("evict"),
+    actor: actorIdentitySchema
+});
+const executorCommandSchema = z.discriminatedUnion("type", [invokeCommandSchema, evictCommandSchema]);
+const actorSessionServerMessageSchema = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("attached"), protocol: z.literal(11) }),
+    z.object({
+        type: z.literal("command"),
+        message_id: z.number().int().nonnegative(),
+        command: executorCommandSchema
+    })
+]);
+class JsonActorStateSerializer {
+    clone(value, label) {
+        return this.cloneValue(value, label);
+    }
+    snapshot(instance) {
+        const state = Object.fromEntries(Object.keys(instance).map(key => [key, Reflect.get(instance, key)]));
+        return this.cloneObject(state, "actor state");
+    }
+    hydrate(instance, state) {
+        const restored = this.cloneObject(state, "actor state");
+        Object.keys(instance).forEach(key => {
+            if (!Reflect.deleteProperty(instance, key))
+                throw new ActorSerializationError(`actor field ${key} cannot be restored`);
+        });
+        Object.entries(restored).forEach(([key, value]) => {
+            Object.defineProperty(instance, key, {
+                configurable: true,
+                enumerable: true,
+                writable: true,
+                value
+            });
+        });
+    }
+    cloneObject(value, label) {
+        const cloned = this.cloneValue(value, label);
+        if (!isJsonObject(cloned))
+            throw new ActorSerializationError(`${label} must be a JSON object`);
+        return cloned;
+    }
+    cloneValue(value, label) {
+        const encoded = this.encode(value, label);
+        const decoded = JSON.parse(encoded);
+        const result = jsonValueSchema.safeParse(decoded);
+        if (!result.success)
+            throw new ActorSerializationError(`${label} must be JSON serializable`);
+        return result.data;
+    }
+    encode(value, label) {
+        try {
+            const encoded = JSON.stringify(value);
+            if (encoded === undefined)
+                throw new ActorSerializationError(`${label} must be JSON serializable`);
+            return encoded;
+        }
+        catch (error) {
+            if (error instanceof ActorSerializationError)
+                throw error;
+            throw new ActorSerializationError(`${label} must be JSON serializable`, { cause: error });
+        }
+    }
+}
+function validateActorComponent(name, value) {
+    const result = actorComponentSchema.safeParse(value);
+    if (!result.success)
+        throw new ActorValidationError(`${name} may contain only ASCII letters, digits, '.', '-', and '_'`);
+    return result.data;
+}
+function parseActorSessionServerMessage(document) {
+    let value;
+    try {
+        value = JSON.parse(document);
+    }
+    catch (error) {
+        throw new ActorProtocolError("actor session message is not valid JSON", { cause: error });
+    }
+    const result = actorSessionServerMessageSchema.safeParse(value);
+    if (!result.success)
+        throw new ActorProtocolError(`actor session message is invalid: ${result.error.message}`);
+    return result.data;
+}
+function failedReply(code, message) {
+    return { type: "failed", code, message };
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export { JsonActorStateSerializer, errorMessage, failedReply, parseActorSessionServerMessage, validateActorComponent };
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

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

package/dist/workflow/client.d.ts

@@ -0,0 +1,23 @@
+import type { JsonValue } from "../shared/types.js";
+import type { DurableObjectsClientOptions } from "./remoteClient.js";
+interface ActorClientTransport {
+    invoke(actorType: string, actorId: string, method: string, args: readonly unknown[]): Promise<unknown>;
+}
+declare function actorClient(): ActorClientTransport;
+declare function configureDurableObjects(options: DurableObjectsClientOptions): void;
+declare function runWithActorClientForTests<T>(options: ActorTestClientOptions, operation: () => T): T;
+interface ActorInvocationRequest {
+    readonly requestId: string;
+    readonly actorType: string;
+    readonly actorId: string;
+    readonly method: string;
+    readonly args: readonly JsonValue[];
+}
+interface ActorTestClientOptions {
+    readonly requestId?: () => string;
+    readonly invoke: ActorTestInvoker;
+}
+type ActorTestInvoker = (request: ActorInvocationRequest) => Promise<unknown>;
+export { actorClient, configureDurableObjects, runWithActorClientForTests };
+export type { ActorInvocationRequest, ActorTestClientOptions, DurableObjectsClientOptions };
+//# sourceMappingURL=client.d.ts.map

package/dist/workflow/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../workflow/client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAGnD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAA;AAEpE,UAAU,oBAAoB;IAC1B,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACzG;AAID,iBAAS,WAAW,IAAI,oBAAoB,CAE3C;AAED,iBAAS,uBAAuB,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAE3E;AAED,iBAAS,0BAA0B,CAAC,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAE7F;AAyCD,UAAU,sBAAsB;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAA;CACtC;AAED,UAAU,sBAAsB;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,MAAM,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CACpC;AAED,KAAK,gBAAgB,GAAG,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAE7E,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,CAAA;AAC3E,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,CAAA"}

package/dist/workflow/client.js

@@ -0,0 +1,49 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { ActorProtocolError } from "../shared/errors.js";
+import { JsonActorStateSerializer, validateActorComponent } from "../shared/types.js";
+import { RemoteActorClient } from "./remoteClient.js";
+const scopedClients = new AsyncLocalStorage();
+function actorClient() {
+    return scopedClients.getStore() ?? defaultClients.get();
+}
+function configureDurableObjects(options) {
+    defaultClients.configure(options);
+}
+function runWithActorClientForTests(options, operation) {
+    return scopedClients.run(new TestActorClient(options), operation);
+}
+class DefaultActorClientProvider {
+    client = new RemoteActorClient();
+    get() {
+        return this.client;
+    }
+    configure(options) {
+        this.client = new RemoteActorClient(options);
+    }
+}
+const defaultClients = new DefaultActorClientProvider();
+class TestActorClient {
+    serializer = new JsonActorStateSerializer();
+    requestId;
+    invokeTest;
+    constructor(options) {
+        this.requestId = options.requestId ?? (() => globalThis.crypto.randomUUID());
+        this.invokeTest = options.invoke;
+    }
+    async invoke(actorType, actorId, method, args) {
+        const requestId = validateActorComponent("request ID", this.requestId());
+        const serializedArgs = this.serializer.clone(args, "actor arguments");
+        if (!Array.isArray(serializedArgs))
+            throw new ActorProtocolError("actor arguments must be a JSON array");
+        const request = {
+            requestId,
+            actorType: validateActorComponent("actor type", actorType),
+            actorId: validateActorComponent("actor ID", actorId),
+            method: validateActorComponent("actor method", method),
+            args: serializedArgs
+        };
+        return this.invokeTest(request);
+    }
+}
+export { actorClient, configureDurableObjects, runWithActorClientForTests };
+//# sourceMappingURL=client.js.map