durable-actors 0.3.1 → 0.4.2

package/dist/client-runtime/client.js

@@ -0,0 +1,200 @@
+import { ActorInvocationError, ActorProtocolError } from "./errors.js";
+import { HttpActorHostTransport, isRecord, responseDocument } from "./http.js";
+import { cloneJson } from "./json.js";
+import { authorizationHeaders, configuredSettings, environmentSettings, projectActorPath, runtimeEnvironment, validateActorComponent, validateOrigin } from "./settings.js";
+import { LatencyTimeline } from "./telemetry.js";
+const TARGET_EXPIRATION_SAFETY_MS = 5_000;
+export class HttpActorClient {
+    beforeInvoke;
+    settingsValue;
+    environment;
+    fetchRequest;
+    requestId;
+    actorHost;
+    now;
+    monotonicNow;
+    telemetry;
+    targets = new Map();
+    constructor(options, dependencies = {}) {
+        this.beforeInvoke = dependencies.beforeInvoke ?? (() => { });
+        this.environment = dependencies.environment ?? runtimeEnvironment();
+        this.fetchRequest = dependencies.fetch ?? globalThis.fetch;
+        this.requestId = dependencies.requestId ?? (() => globalThis.crypto.randomUUID());
+        this.actorHost = dependencies.actorHost ?? new HttpActorHostTransport(this.fetchRequest);
+        // Workflow runtimes can replace Date.now with replayable logical time.
+        this.now = dependencies.now ?? (() => performance.timeOrigin + performance.now());
+        this.monotonicNow = dependencies.monotonicNow ?? (() => performance.now());
+        this.telemetry = dependencies.telemetry ?? (() => { });
+        this.settingsValue = options === undefined ? undefined : configuredSettings(options);
+    }
+    async invoke(actorName, actorId, method, args) {
+        const requestId = validateActorComponent("request ID", this.requestId());
+        const timeline = new LatencyTimeline(this.monotonicNow);
+        let outcome = "failed";
+        try {
+            this.beforeInvoke(requestId);
+            const invocation = this.invocation(requestId, actorName, actorId, method, args);
+            timeline.mark("invocation_built");
+            const target = await this.target(invocation, timeline);
+            timeline.mark("target_resolved");
+            const result = await this.direct(target, invocation, true, timeline);
+            outcome = "completed";
+            return result;
+        }
+        finally {
+            this.telemetry({
+                event: "actor_client_invocation",
+                request_id: requestId,
+                actor_name: actorName,
+                actor_id: actorId,
+                method,
+                ...timeline.finish(),
+                outcome
+            });
+        }
+    }
+    async direct(target, invocation, retryAvailable, timeline) {
+        try {
+            const reply = await this.actorHost.invoke(target, invocation);
+            timeline.mark("host_rpc_completed");
+            if (reply.type === "completed") {
+                timeline.mark("socket_effects_completed");
+                return reply.result;
+            }
+            if (reply.type === "failed")
+                throw new ActorInvocationError(reply.code, invocation.requestId, reply.message);
+            this.invalidateTarget(invocation, target);
+            if (reply.type === "unauthenticated" && !retryAvailable) {
+                throw new ActorInvocationError("unauthenticated", invocation.requestId, "actor host rejected the refreshed invocation ticket");
+            }
+            if (!retryAvailable)
+                throw new ActorInvocationError("unavailable", invocation.requestId, reply.type === "not_dispatched"
+                    ? "actor host could not be reached before execution"
+                    : "actor ownership changed repeatedly before execution");
+            const rerouted = await this.target(invocation, timeline);
+            return this.direct(rerouted, invocation, false, timeline);
+        }
+        catch (error) {
+            if (error instanceof ActorInvocationError || error instanceof ActorProtocolError)
+                throw error;
+            this.invalidateTarget(invocation, target);
+            const message = error instanceof Error ? error.message : String(error);
+            throw new ActorInvocationError("outcome_unknown", invocation.requestId, `actor-host HTTP request failed after dispatch: ${message}`);
+        }
+    }
+    invalidateTarget(invocation, target) {
+        const key = actorKey(invocation.actorName, invocation.actorId);
+        const current = this.targets.get(key);
+        if (current?.target === target)
+            this.targets.delete(key);
+    }
+    async target(invocation, timeline) {
+        const key = actorKey(invocation.actorName, invocation.actorId);
+        const current = this.targets.get(key);
+        timeline.mark("target_cache_checked");
+        if (current) {
+            const target = await current.promise;
+            if (this.targets.get(key) !== current)
+                return this.target(invocation, timeline);
+            if (target.expiresAtMs > this.now() + TARGET_EXPIRATION_SAFETY_MS)
+                return target;
+            this.targets.delete(key);
+        }
+        const resolving = {
+            promise: this.resolveTarget(invocation)
+                .then(target => {
+                resolving.target = target;
+                return target;
+            })
+                .catch(error => {
+                if (this.targets.get(key) === resolving)
+                    this.targets.delete(key);
+                throw error;
+            })
+        };
+        this.targets.set(key, resolving);
+        return resolving.promise;
+    }
+    async resolveTarget(invocation) {
+        let response;
+        try {
+            response = await this.fetchRequest(targetUrl(this.settings, invocation.actorName, invocation.actorId), {
+                method: "POST",
+                redirect: "error",
+                headers: {
+                    accept: "application/json",
+                    ...authorizationHeaders(this.settings.credential),
+                    "x-request-id": invocation.requestId,
+                    "content-type": "application/json"
+                },
+                body: JSON.stringify({ homeRegion: this.settings.homeRegion })
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new ActorInvocationError("unavailable", invocation.requestId, `control-plane HTTP request failed before dispatch: ${message}`);
+        }
+        const document = await responseDocument(response);
+        if (!response.ok)
+            this.throwResponseFailure(response, document, invocation.requestId);
+        if (!isRecord(document) ||
+            typeof document.route !== "string" ||
+            typeof document.token !== "string" ||
+            !document.token.trim() ||
+            !positiveInteger(document.ownerEpoch) ||
+            !positiveInteger(document.expiresAtMs))
+            throw new ActorProtocolError("control-plane response did not contain a valid actor host target");
+        validateOrigin(document.route);
+        return {
+            route: document.route,
+            token: document.token,
+            ownerEpoch: document.ownerEpoch,
+            expiresAtMs: document.expiresAtMs
+        };
+    }
+    throwResponseFailure(response, document, requestId) {
+        if (response.status === 401 || response.status === 403)
+            throw new ActorInvocationError("unauthenticated", requestId, "the durable-actors application credential was rejected");
+        const failure = isRecord(document) ? document.error : undefined;
+        if (!isRecord(failure) ||
+            typeof failure.code !== "string" ||
+            !failure.code ||
+            typeof failure.message !== "string")
+            throw new ActorProtocolError(`control-plane HTTP ${response.status} response did not contain a valid error`);
+        throw new ActorInvocationError(failure.code, typeof failure.requestId === "string" ? failure.requestId : requestId, failure.message);
+    }
+    invocation(requestId, actorName, actorId, method, args) {
+        return {
+            requestId,
+            projectId: this.settings.projectId,
+            actorName: validateActorComponent("actor name", actorName),
+            actorId: validateActorComponent("actor ID", actorId),
+            method: validateActorComponent("actor method", method),
+            args: this.jsonArguments(args)
+        };
+    }
+    get settings() {
+        if (this.settingsValue !== undefined)
+            return this.settingsValue;
+        this.settingsValue = configuredSettings(environmentSettings(this.environment));
+        return this.settingsValue;
+    }
+    jsonArguments(args) {
+        const value = cloneJson(args, "actor arguments");
+        if (!Array.isArray(value))
+            throw new ActorProtocolError("actor arguments must be a JSON array");
+        return value;
+    }
+}
+function targetUrl(settings, actorName, actorId) {
+    const actor = validateActorComponent("actor name", actorName);
+    const id = validateActorComponent("actor ID", actorId);
+    return `${settings.controlPlaneUrl}${projectActorPath(settings.projectId, actor, id)}/find-actor`;
+}
+function actorKey(actorName, actorId) {
+    return `${actorName}\u001f${actorId}`;
+}
+function positiveInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+//# sourceMappingURL=client.js.map

package/dist/client-runtime/client.js.map

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

package/dist/client-runtime/errors.d.ts

@@ -0,0 +1,30 @@
+declare class ActorConfigurationError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+declare class ActorDefinitionError extends Error {
+    constructor(message: string);
+}
+/** Remote failure. Retrying an `outcome_unknown` operation may run it twice. */
+declare class ActorInvocationError extends Error {
+    /** Error category, such as `actor_error` or `outcome_unknown`. New codes may be added. */
+    readonly code: string;
+    /** Identifies this caller attempt; it is not an application idempotency key. */
+    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 };
+declare function errorMessage(error: unknown): string;
+export { errorMessage };
+//# sourceMappingURL=errors.d.ts.map

package/dist/client-runtime/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client-runtime/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,gFAAgF;AAChF,cAAM,oBAAqB,SAAQ,KAAK;IACpC,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gFAAgF;IAChF,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,EACH,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACvB,CAAA;AAED,iBAAS,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/client-runtime/errors.js

@@ -0,0 +1,55 @@
+class ActorConfigurationError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ActorConfigurationError";
+    }
+}
+class ActorDefinitionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ActorDefinitionError";
+    }
+}
+/** Remote failure. Retrying an `outcome_unknown` operation may run it twice. */
+class ActorInvocationError extends Error {
+    /** Error category, such as `actor_error` or `outcome_unknown`. New codes may be added. */
+    code;
+    /** Identifies this caller attempt; it is not an application idempotency key. */
+    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 };
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export { errorMessage };
+//# sourceMappingURL=errors.js.map

package/dist/client-runtime/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/client-runtime/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,gFAAgF;AAChF,MAAM,oBAAqB,SAAQ,KAAK;IACpC,0FAA0F;IACjF,IAAI,CAAQ;IACrB,gFAAgF;IACvE,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,EACH,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACvB,CAAA;AAED,SAAS,YAAY,CAAC,KAAc;IAChC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACjE,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/client-runtime/http.d.ts

@@ -0,0 +1,45 @@
+import type { JsonValue } from "./json.js";
+export declare class HttpActorHostTransport implements ActorHostTransport {
+    private readonly fetchRequest;
+    constructor(fetchRequest?: typeof globalThis.fetch);
+    invoke(target: ActorHostTarget, invocation: DirectActorInvocation): Promise<ActorHostReply>;
+    publish(target: ActorHostTarget, actor: ActorAddress, effects: readonly unknown[]): Promise<void>;
+    private post;
+}
+export declare function responseDocument(response: Response): Promise<unknown>;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export interface ActorAddress {
+    readonly projectId: string;
+    readonly actorName: string;
+    readonly actorId: string;
+}
+export interface ActorHostTarget {
+    readonly route: string;
+    readonly token: string;
+    readonly ownerEpoch: number;
+    readonly expiresAtMs: number;
+}
+export interface DirectActorInvocation extends ActorAddress {
+    readonly requestId: string;
+    readonly method: string;
+    readonly args: readonly JsonValue[];
+}
+export type ActorHostReply = {
+    readonly type: "completed";
+    readonly result: unknown;
+} | {
+    readonly type: "failed";
+    readonly code: string;
+    readonly message: string;
+} | {
+    readonly type: "reroute";
+} | {
+    readonly type: "unauthenticated";
+} | {
+    readonly type: "not_dispatched";
+};
+export interface ActorHostTransport {
+    invoke(target: ActorHostTarget, invocation: DirectActorInvocation): Promise<ActorHostReply>;
+    publish(target: ActorHostTarget, actor: ActorAddress, effects: readonly unknown[]): Promise<void>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/client-runtime/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/client-runtime/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAG1C,qBAAa,sBAAuB,YAAW,kBAAkB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,GAAE,OAAO,UAAU,CAAC,KAAwB;IAE/E,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IAgC3F,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvG,OAAO,CAAC,IAAI;CAef;AAgBD,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAM3E;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAC3B;AACD,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC/B;AACD,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAA;CACtC;AACD,MAAM,MAAM,cAAc,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACpC;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAA;AACzC,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC3F,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpG"}

package/dist/client-runtime/http.js

@@ -0,0 +1,85 @@
+import { ActorProtocolError } from "./errors.js";
+import { projectActorPath, validateOrigin } from "./settings.js";
+export class HttpActorHostTransport {
+    fetchRequest;
+    constructor(fetchRequest = globalThis.fetch) {
+        this.fetchRequest = fetchRequest;
+    }
+    async invoke(target, invocation) {
+        let response;
+        try {
+            response = await this.post(target, invocation, "invoke", {
+                requestId: invocation.requestId,
+                ownerEpoch: target.ownerEpoch,
+                method: invocation.method,
+                args: invocation.args
+            });
+        }
+        catch (error) {
+            if (connectionRefused(error))
+                return { type: "not_dispatched" };
+            throw error;
+        }
+        // A 401 is issued before dispatch, so refreshing this ticket cannot repeat actor code.
+        if (response.status === 401)
+            return { type: "unauthenticated" };
+        if (!response.ok)
+            throw new Error(`actor host returned HTTP ${response.status}`);
+        const reply = await responseDocument(response);
+        if (isRecord(reply)) {
+            if (reply.type === "completed" && Object.hasOwn(reply, "result"))
+                return { type: "completed", result: reply.result };
+            if (reply.type === "failed" &&
+                typeof reply.code === "string" &&
+                reply.code.length > 0 &&
+                typeof reply.message === "string")
+                return { type: "failed", code: reply.code, message: reply.message };
+            if (reply.type === "reroute")
+                return { type: "reroute" };
+        }
+        throw new ActorProtocolError("actor host response did not contain a valid outcome");
+    }
+    async publish(target, actor, effects) {
+        const response = await this.post(target, actor, "socket-effects", { ownerEpoch: target.ownerEpoch, effects });
+        if (!response.ok)
+            throw new Error(`socket effects returned HTTP ${response.status}`);
+    }
+    post(target, actor, endpoint, body) {
+        return this.fetchRequest(`${validateOrigin(target.route)}${projectActorPath(actor.projectId, actor.actorName, actor.actorId)}/${endpoint}`, {
+            method: "POST",
+            redirect: "error",
+            headers: {
+                authorization: `Bearer ${target.token}`,
+                "content-type": "application/json",
+                accept: "application/json"
+            },
+            body: JSON.stringify(body)
+        });
+    }
+}
+function connectionRefused(error, ancestors = new Set()) {
+    if (!isRecord(error) || ancestors.has(error))
+        return false;
+    const visited = new Set(ancestors).add(error);
+    if (error.code !== undefined && error.code !== "ECONNREFUSED")
+        return false;
+    if (error.errors !== undefined)
+        return (Array.isArray(error.errors) &&
+            error.errors.length > 0 &&
+            error.errors.every(cause => connectionRefused(cause, visited)));
+    if (error.code === "ECONNREFUSED")
+        return error.syscall === "connect";
+    return connectionRefused(error.cause, visited);
+}
+export async function responseDocument(response) {
+    try {
+        return await response.json();
+    }
+    catch (error) {
+        throw new ActorProtocolError(`HTTP ${response.status} response was not valid JSON`, { cause: error });
+    }
+}
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=http.js.map

package/dist/client-runtime/http.js.map

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

package/dist/client-runtime/index.browser.d.ts

@@ -0,0 +1,8 @@
+import type { SocketProxy as ServerProxy } from "./proxy.js";
+import type { createActorStub as ServerStub, createActorTransport as ServerTransport } from "./stub.js";
+declare const createActorStub: typeof ServerStub;
+declare const createActorTransport: typeof ServerTransport;
+declare const SocketProxy: typeof ServerProxy;
+export { createActorStub, createActorTransport, SocketProxy };
+export { ActorInvocationError } from "./errors.js";
+//# sourceMappingURL=index.browser.d.ts.map

package/dist/client-runtime/index.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../../src/client-runtime/index.browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,IAAI,WAAW,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,KAAK,EAAE,eAAe,IAAI,UAAU,EAAE,oBAAoB,IAAI,eAAe,EAAE,MAAM,WAAW,CAAA;AAEvG,QAAA,MAAM,eAAe,EAAE,OAAO,UAE7B,CAAA;AAED,QAAA,MAAM,oBAAoB,EAAE,OAAO,eAElC,CAAA;AAED,QAAA,MAAM,WAAW,EAID,OAAO,WAAW,CAAA;AAElC,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,WAAW,EAAE,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA"}

package/dist/client-runtime/index.browser.js

@@ -0,0 +1,14 @@
+const createActorStub = () => {
+    throw new Error("actors must be used on the server");
+};
+const createActorTransport = () => {
+    throw new Error("actors must be used on the server");
+};
+const SocketProxy = class {
+    constructor() {
+        throw new Error("ActorProxy must be used on the server");
+    }
+};
+export { createActorStub, createActorTransport, SocketProxy };
+export { ActorInvocationError } from "./errors.js";
+//# sourceMappingURL=index.browser.js.map

package/dist/client-runtime/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../../src/client-runtime/index.browser.ts"],"names":[],"mappings":"AAGA,MAAM,eAAe,GAAsB,GAAG,EAAE;IAC5C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;AACxD,CAAC,CAAA;AAED,MAAM,oBAAoB,GAA2B,GAAG,EAAE;IACtD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;AACxD,CAAC,CAAA;AAED,MAAM,WAAW,GAAG;IAChB;QACI,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;IAC5D,CAAC;CAC6B,CAAA;AAElC,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,WAAW,EAAE,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA"}

package/dist/client-runtime/index.d.ts

@@ -0,0 +1,6 @@
+export { createActorStub, createActorTransport } from "./stub.js";
+export type { ActorRpcTransport, DurableActorsClientOptions } from "./stub.js";
+export { ActorInvocationError } from "./errors.js";
+export { SocketProxy } from "./proxy.js";
+export type { ProxyActor, SocketGrant, SocketProxyDependencies, SocketProxyOptions } from "./proxy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client-runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client-runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACjE,YAAY,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAA;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA"}

package/dist/client-runtime/index.js

@@ -0,0 +1,4 @@
+export { createActorStub, createActorTransport } from "./stub.js";
+export { ActorInvocationError } from "./errors.js";
+export { SocketProxy } from "./proxy.js";
+//# sourceMappingURL=index.js.map

package/dist/client-runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client-runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

package/dist/client-runtime/json.d.ts

@@ -0,0 +1,9 @@
+type JsonPrimitive = string | number | boolean | null;
+type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+type JsonValue = JsonPrimitive | JsonObject | readonly JsonValue[];
+declare function cloneJson(value: unknown, label: string): JsonValue;
+export { cloneJson };
+export type { JsonValue };
+//# sourceMappingURL=json.d.ts.map

package/dist/client-runtime/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/client-runtime/json.ts"],"names":[],"mappings":"AAEA,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;AACrD,KAAK,UAAU,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AACvD,KAAK,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,SAAS,EAAE,CAAA;AAElE,iBAAS,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAS3D;AAED,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,YAAY,EAAE,SAAS,EAAE,CAAA"}

package/dist/client-runtime/json.js

@@ -0,0 +1,16 @@
+import { ActorSerializationError } from "./errors.js";
+function cloneJson(value, label) {
+    try {
+        const encoded = JSON.stringify(value);
+        if (encoded === undefined)
+            throw new ActorSerializationError(`${label} must be JSON serializable`);
+        return JSON.parse(encoded);
+    }
+    catch (error) {
+        if (error instanceof ActorSerializationError)
+            throw error;
+        throw new ActorSerializationError(`${label} must be JSON serializable`, { cause: error });
+    }
+}
+export { cloneJson };
+//# sourceMappingURL=json.js.map

package/dist/client-runtime/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/client-runtime/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAMrD,SAAS,SAAS,CAAC,KAAc,EAAE,KAAa;IAC5C,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACrC,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,uBAAuB,CAAC,GAAG,KAAK,4BAA4B,CAAC,CAAA;QAClG,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAA;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,YAAY,uBAAuB;YAAE,MAAM,KAAK,CAAA;QACzD,MAAM,IAAI,uBAAuB,CAAC,GAAG,KAAK,4BAA4B,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IAC7F,CAAC;AACL,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,CAAA"}

package/dist/client-runtime/proxy.d.ts

@@ -0,0 +1,49 @@
+/** Overrides for the backend's DURABLE_ACTORS environment settings. */
+interface SocketProxyOptions {
+    readonly projectId?: string;
+    readonly controlPlaneUrl?: string;
+    readonly apiKey?: string;
+    /** Defaults to 180000 ms; accepts 1000–600000 ms. */
+    readonly setupTimeoutMs?: number;
+}
+interface SocketProxyDependencies {
+    readonly fetch?: typeof globalThis.fetch;
+}
+interface ProxyActor<Metadata = unknown> {
+    readonly types?: Metadata;
+}
+/** Actor access your backend has already authorized. */
+type SocketAuthorization<Actors extends Record<string, ProxyActor>> = {
+    [Name in keyof Actors & string]: {
+        readonly actorName: Name;
+        readonly actorId: string;
+        readonly metadata: Actors[Name] extends ProxyActor<infer Metadata> ? Metadata : never;
+        readonly homeRegion?: string;
+        readonly authorizationLifetimeMs?: number;
+    };
+}[keyof Actors & string];
+/** Browser connection URL and deadlines in Unix milliseconds. Treat the URL as a credential. */
+interface SocketGrant {
+    websocketUrl: string;
+    homeRegion: string;
+    connectByMs: number;
+    authorizedUntilMs: number;
+}
+/** Issues browser connection URLs from your backend. */
+declare class SocketProxy<Actors extends Record<string, ProxyActor>> {
+    private readonly actors;
+    private readonly projectId;
+    private readonly origin;
+    private readonly apiKey;
+    private readonly setupTimeoutMs;
+    private readonly fetchRequest;
+    constructor(actors: Actors, options?: SocketProxyOptions, dependencies?: SocketProxyDependencies);
+    /**
+     * Call after authenticating the user and checking actor access.
+     * Pass `websocketUrl` to the browser's `new WebSocket()`.
+     */
+    handle(authorization: SocketAuthorization<Actors>): Promise<SocketGrant>;
+}
+export { SocketProxy };
+export type { ProxyActor, SocketAuthorization, SocketGrant, SocketProxyDependencies, SocketProxyOptions };
+//# sourceMappingURL=proxy.d.ts.map

package/dist/client-runtime/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/client-runtime/proxy.ts"],"names":[],"mappings":"AAUA,uEAAuE;AACvE,UAAU,kBAAkB;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,qDAAqD;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACnC;AAED,UAAU,uBAAuB;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAC3C;AAED,UAAU,UAAU,CAAC,QAAQ,GAAG,OAAO;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;CAC5B;AAED,wDAAwD;AACxD,KAAK,mBAAmB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI;KACjE,IAAI,IAAI,MAAM,MAAM,GAAG,MAAM,GAAG;QAC7B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,QAAQ,CAAC,GAAG,QAAQ,GAAG,KAAK,CAAA;QACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;KAC5C;CACJ,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAA;AAExB,gGAAgG;AAChG,UAAU,WAAW;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;CAC5B;AAED,wDAAwD;AACxD,cAAM,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAQnD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAP3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAGjC,MAAM,EAAE,MAAM,EAC/B,OAAO,GAAE,kBAAuB,EAChC,YAAY,GAAE,uBAA4B;IAY9C;;;OAGG;IACG,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;CA6BjF;AAaD,OAAO,EAAE,WAAW,EAAE,CAAA;AACtB,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,WAAW,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,CAAA"}