durable-actors 0.4.6 → 0.5.0

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

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

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

@@ -1 +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"}
+{"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,2BAA2B,IAAI,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACzF,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;AACD,QAAA,MAAM,2BAA2B,EAAE,OAAO,sBAEzC,CAAA;AAED,QAAA,MAAM,WAAW,EAID,OAAO,WAAW,CAAA;AAElC,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,WAAW,EAAE,CAAA;AAC1F,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAC7E,YAAY,EAAE,YAAY,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA"}

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

@@ -4,11 +4,14 @@ const createActorStub = () => {
 const createActorTransport = () => {
     throw new Error("actors must be used on the server");
 };
+const createActorSessionTransport = () => {
+    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";
+export { createActorStub, createActorTransport, createActorSessionTransport, SocketProxy };
+export { ActorInvocationError, ActorSessionRejectedError } from "./errors.js";
 //# sourceMappingURL=index.browser.js.map

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

@@ -1 +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"}
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../../src/client-runtime/index.browser.ts"],"names":[],"mappings":"AAIA,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;AACD,MAAM,2BAA2B,GAAkC,GAAG,EAAE;IACpE,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,2BAA2B,EAAE,WAAW,EAAE,CAAA;AAC1F,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA"}

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

@@ -1,4 +1,6 @@
 export { createActorStub, createActorTransport } from "./stub.js";
+export { createActorSessionTransport, ActorSessionRejectedError } from "./session.js";
+export type { ActorSession, ActorSessionTransportOptions, ActorSessionTransport } from "./session.js";
 export type { ActorRpcTransport, DurableActorsClientOptions } from "./stub.js";
 export { ActorInvocationError } from "./errors.js";
 export { SocketProxy } from "./proxy.js";

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

@@ -1 +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"}
+{"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,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACrF,YAAY,EAAE,YAAY,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACrG,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

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

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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client-runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACjE,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AAGrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

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

@@ -0,0 +1,45 @@
+import type { DurableActorsClientOptions } from "./settings.js";
+import type { ActorRpcTransport } from "./stub.js";
+export interface ActorSession {
+    readonly projectId: string;
+    readonly controlPlaneUrl: string;
+    readonly token: string;
+    readonly expiresAtMs: number;
+}
+export interface ActorSessionTransportOptions {
+    readonly projectId: string;
+    /** Reauthenticate with your application backend. Throw ActorSessionRejectedError on an explicit denial. */
+    readonly getSession: () => Promise<ActorSession>;
+}
+export interface ActorSessionTransportDependencies {
+    readonly now?: () => number;
+    readonly createTransport?: (options: DurableActorsClientOptions) => ActorRpcTransport;
+    readonly schedule?: (callback: () => void, delayMs: number) => () => void;
+}
+export { ActorSessionRejectedError } from "./errors.js";
+/**
+ * Reuses actor targets and renews runtime-issued sessions through a trusted backend.
+ * Sessions require an HTTPS origin (except localhost) and at most 60 seconds of validity.
+ * Renewal stops after a minute without invocations; dispose cancels it immediately.
+ */
+export declare class ActorSessionTransport implements ActorRpcTransport {
+    private readonly options;
+    private transport;
+    private expiresAtMs;
+    private lastUsedAt;
+    private pending;
+    private cancel;
+    private closed;
+    private readonly now;
+    private readonly createTransport;
+    private readonly schedule;
+    constructor(options: ActorSessionTransportOptions, dependencies?: ActorSessionTransportDependencies);
+    invoke(actorName: string, actorId: string, method: string, args: readonly unknown[]): Promise<unknown>;
+    dispose(): void;
+    private refresh;
+    private exchange;
+    private validateSession;
+    private scheduleRenewal;
+}
+export declare function createActorSessionTransport(options: ActorSessionTransportOptions): ActorSessionTransport;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/client-runtime/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAA;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAElD,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,4BAA4B;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,2GAA2G;IAC3G,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,iCAAiC;IAC9C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,iBAAiB,CAAA;IACrF,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,IAAI,CAAA;CAC5E;AAED,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAEvD;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB;IAYvD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX5B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4D;IAC5F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuD;gBAG3D,OAAO,EAAE,4BAA4B,EACtD,YAAY,GAAE,iCAAsC;IAQlD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ5G,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,OAAO;YASD,QAAQ;IAwBtB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,eAAe;CAQ1B;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,qBAAqB,CAExG"}

package/dist/client-runtime/session.js

@@ -0,0 +1,108 @@
+import { HttpActorClient } from "./client.js";
+import { ActorSessionRejectedError } from "./errors.js";
+import { validateActorComponent, validateOrigin } from "./settings.js";
+export { ActorSessionRejectedError } from "./errors.js";
+/**
+ * Reuses actor targets and renews runtime-issued sessions through a trusted backend.
+ * Sessions require an HTTPS origin (except localhost) and at most 60 seconds of validity.
+ * Renewal stops after a minute without invocations; dispose cancels it immediately.
+ */
+export class ActorSessionTransport {
+    options;
+    transport;
+    expiresAtMs = 0;
+    lastUsedAt = 0;
+    pending;
+    cancel;
+    closed = false;
+    now;
+    createTransport;
+    schedule;
+    constructor(options, dependencies = {}) {
+        this.options = options;
+        validateActorComponent("project ID", options.projectId);
+        this.now = dependencies.now ?? (() => performance.timeOrigin + performance.now());
+        this.createTransport = dependencies.createTransport ?? (settings => new HttpActorClient(settings));
+        this.schedule = dependencies.schedule ?? scheduleRefresh;
+    }
+    async invoke(actorName, actorId, method, args) {
+        if (this.closed)
+            throw new Error("Actor session transport is disposed");
+        this.lastUsedAt = this.now();
+        const transport = this.transport && this.expiresAtMs > this.now() + 5_000 ? this.transport : await this.refresh();
+        return transport.invoke(actorName, actorId, method, args);
+    }
+    dispose() {
+        this.closed = true;
+        this.cancel?.();
+        this.transport = undefined;
+    }
+    refresh() {
+        if (this.pending)
+            return this.pending;
+        this.cancel?.();
+        this.pending = this.exchange().finally(() => {
+            this.pending = undefined;
+        });
+        return this.pending;
+    }
+    async exchange() {
+        let session;
+        try {
+            session = await this.options.getSession();
+        }
+        catch (error) {
+            if (error instanceof ActorSessionRejectedError) {
+                this.transport = undefined;
+                this.expiresAtMs = 0;
+            }
+            throw error;
+        }
+        const remaining = this.validateSession(session);
+        if (this.closed)
+            throw new Error("Actor session transport is disposed");
+        const transport = this.createTransport({
+            projectId: session.projectId,
+            controlPlaneUrl: session.controlPlaneUrl,
+            apiKey: session.token
+        });
+        this.transport = transport;
+        this.expiresAtMs = session.expiresAtMs;
+        this.scheduleRenewal(remaining * (0.75 + Math.random() * 0.05));
+        return transport;
+    }
+    validateSession(session) {
+        if (!session ||
+            session.projectId !== this.options.projectId ||
+            typeof session.token !== "string" ||
+            !session.token.trim() ||
+            !Number.isSafeInteger(session.expiresAtMs))
+            throw new Error("Invalid actor session");
+        const origin = new URL(validateOrigin(session.controlPlaneUrl));
+        if (origin.protocol !== "https:" && !["localhost", "127.0.0.1", "[::1]"].includes(origin.hostname))
+            throw new Error("Actor sessions require HTTPS outside localhost");
+        const remaining = session.expiresAtMs - this.now();
+        if (remaining <= 5_000 || remaining > 65_000)
+            throw new Error("Actor session is expired or invalid");
+        return remaining;
+    }
+    scheduleRenewal(delayMs) {
+        this.cancel = this.schedule(() => {
+            if (this.closed || this.now() - this.lastUsedAt >= 60_000)
+                return;
+            void this.refresh().catch(() => {
+                if (!this.closed && this.expiresAtMs > this.now() + 5_000)
+                    this.scheduleRenewal(5_000);
+            });
+        }, delayMs);
+    }
+}
+export function createActorSessionTransport(options) {
+    return new ActorSessionTransport(options);
+}
+function scheduleRefresh(callback, delayMs) {
+    const timer = setTimeout(callback, delayMs);
+    timer.unref?.();
+    return () => clearTimeout(timer);
+}
+//# sourceMappingURL=session.js.map

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

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

package/dist/compiler/generators/client-artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-artifacts.d.ts","sourceRoot":"","sources":["../../../src/compiler/generators/client-artifacts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAMxE,+HAA+H;AAC/H,iBAAe,uBAAuB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAmBvG;AA+ED,OAAO,EAAE,uBAAuB,EAAE,CAAA;AAClC,YAAY,EAAE,mBAAmB,EAAE,CAAA"}
+{"version":3,"file":"client-artifacts.d.ts","sourceRoot":"","sources":["../../../src/compiler/generators/client-artifacts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAMxE,+HAA+H;AAC/H,iBAAe,uBAAuB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAoBvG;AA+ED,OAAO,EAAE,uBAAuB,EAAE,CAAA;AAClC,YAAY,EAAE,mBAAmB,EAAE,CAAA"}

package/dist/compiler/generators/client-artifacts.js

@@ -13,7 +13,8 @@ async function generateClientArtifacts(input) {
     const source = `${usageComment("Use this file to call actors and prepare WebSocket access from your backend.", 'import { actors, ActorProxy, type ActorAuthorization } from "./generated/index.js"')}
 import { createActorStub as $createActorStub, SocketProxy as $SocketProxy } from "./runtime/index.js"
 import type { ActorTypes as $ActorTypes } from "./types.js"
-export { createActorTransport, ActorInvocationError } from "./runtime/index.js"
+export { createActorTransport, createActorSessionTransport, ActorSessionRejectedError, ActorInvocationError } from "./runtime/index.js"
+export type { ActorSession, ActorSessionTransportOptions, ActorSessionTransport } from "./runtime/index.js"
 export type { ActorRpcTransport, DurableActorsClientOptions, SocketGrant, SocketProxyDependencies, SocketProxyOptions } from "./runtime/index.js"
 
 ${usageComment("Types for actor state and socket messages.", exampleActor && `type State = actors.${exampleActor}.State`)}

package/dist/compiler/generators/client-artifacts.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"client-runtime.d.ts","sourceRoot":"","sources":["../../src/generated/client-runtime.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAsouC,CAAA"}
+{"version":3,"file":"client-runtime.d.ts","sourceRoot":"","sources":["../../src/generated/client-runtime.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAw3gD,CAAA"}

package/dist/generated/client-runtime.js

@@ -1,2 +1,2 @@
-export const runtimeFiles = { "runtime/errors.js": "class ActorConfigurationError extends Error {\n    constructor(message, options) {\n        super(message, options);\n        this.name = \"ActorConfigurationError\";\n    }\n}\nclass ActorDefinitionError extends Error {\n    constructor(message) {\n        super(message);\n        this.name = \"ActorDefinitionError\";\n    }\n}\n/** Remote failure. Retrying an `outcome_unknown` operation may run it twice. */\nclass ActorInvocationError extends Error {\n    /** Error category, such as `actor_error` or `outcome_unknown`. New codes may be added. */\n    code;\n    /** Identifies this caller attempt; it is not an application idempotency key. */\n    requestId;\n    constructor(code, requestId, message) {\n        super(message);\n        this.name = \"ActorInvocationError\";\n        this.code = code;\n        this.requestId = requestId;\n    }\n}\nclass ActorSessionError extends Error {\n    constructor(message, options) {\n        super(message, options);\n        this.name = \"ActorSessionError\";\n    }\n}\nclass ActorProtocolError extends Error {\n    constructor(message, options) {\n        super(message, options);\n        this.name = \"ActorProtocolError\";\n    }\n}\nclass ActorSerializationError extends Error {\n    constructor(message, options) {\n        super(message, options);\n        this.name = \"ActorSerializationError\";\n    }\n}\nclass ActorValidationError extends Error {\n    constructor(message) {\n        super(message);\n        this.name = \"ActorValidationError\";\n    }\n}\nexport { ActorConfigurationError, ActorDefinitionError, ActorInvocationError, ActorProtocolError, ActorSerializationError, ActorSessionError, ActorValidationError };\nfunction errorMessage(error) {\n    return error instanceof Error ? error.message : String(error);\n}\nexport { errorMessage };\n", "runtime/errors.d.ts": "declare class ActorConfigurationError extends Error {\n    constructor(message: string, options?: ErrorOptions);\n}\ndeclare class ActorDefinitionError extends Error {\n    constructor(message: string);\n}\n/** Remote failure. Retrying an `outcome_unknown` operation may run it twice. */\ndeclare class ActorInvocationError extends Error {\n    /** Error category, such as `actor_error` or `outcome_unknown`. New codes may be added. */\n    readonly code: string;\n    /** Identifies this caller attempt; it is not an application idempotency key. */\n    readonly requestId: string;\n    constructor(code: string, requestId: string, message: string);\n}\ndeclare class ActorSessionError extends Error {\n    constructor(message: string, options?: ErrorOptions);\n}\ndeclare class ActorProtocolError extends Error {\n    constructor(message: string, options?: ErrorOptions);\n}\ndeclare class ActorSerializationError extends Error {\n    constructor(message: string, options?: ErrorOptions);\n}\ndeclare class ActorValidationError extends Error {\n    constructor(message: string);\n}\nexport { ActorConfigurationError, ActorDefinitionError, ActorInvocationError, ActorProtocolError, ActorSerializationError, ActorSessionError, ActorValidationError };\ndeclare function errorMessage(error: unknown): string;\nexport { errorMessage };\n", "runtime/json.js": "import { ActorSerializationError } from \"./errors.js\";\nfunction cloneJson(value, label) {\n    try {\n        const encoded = JSON.stringify(value);\n        if (encoded === undefined)\n            throw new ActorSerializationError(`${label} must be JSON serializable`);\n        return JSON.parse(encoded);\n    }\n    catch (error) {\n        if (error instanceof ActorSerializationError)\n            throw error;\n        throw new ActorSerializationError(`${label} must be JSON serializable`, { cause: error });\n    }\n}\nexport { cloneJson };\n", "runtime/json.d.ts": "type JsonPrimitive = string | number | boolean | null;\ntype JsonObject = {\n    readonly [key: string]: JsonValue;\n};\ntype JsonValue = JsonPrimitive | JsonObject | readonly JsonValue[];\ndeclare function cloneJson(value: unknown, label: string): JsonValue;\nexport { cloneJson };\nexport type { JsonValue };\n", "runtime/settings.js": "import { ActorConfigurationError, ActorValidationError } from \"./errors.js\";\nexport function configuredSettings(value) {\n    if (typeof value !== \"object\" ||\n        value === null ||\n        Array.isArray(value) ||\n        Object.keys(value).some(key => ![\"projectId\", \"apiKey\", \"homeRegion\", \"controlPlaneUrl\"].includes(key)))\n        throw new ActorConfigurationError(\"durable-actors client settings are invalid\");\n    const options = value;\n    const controlPlaneUrl = validateOrigin(options.controlPlaneUrl);\n    const local = [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(new URL(controlPlaneUrl).hostname);\n    const projectId = options.projectId ?? (local ? \"local\" : undefined);\n    if (typeof projectId !== \"string\" || !/^[A-Za-z0-9._-]{1,64}$/u.test(projectId) || [\".\", \"..\"].includes(projectId))\n        throw new ActorConfigurationError(\"durable-actors client settings are invalid: a valid projectId is required for remote connections\");\n    if (options.apiKey !== undefined && (typeof options.apiKey !== \"string\" || !options.apiKey.trim()))\n        throw new ActorConfigurationError(\"durable-actors client settings are invalid: apiKey must not be empty\");\n    if (options.homeRegion !== undefined)\n        validateActorComponent(\"home region\", options.homeRegion);\n    return { projectId, credential: options.apiKey?.trim(), homeRegion: options.homeRegion, controlPlaneUrl };\n}\nexport function environmentSettings(environment = runtimeEnvironment()) {\n    return {\n        projectId: environment.DURABLE_ACTORS_PROJECT_ID,\n        apiKey: environment.DURABLE_ACTORS_SECRET ?? environment.DURABLE_ACTORS_API_KEY,\n        homeRegion: environment.DURABLE_ACTORS_HOME_REGION,\n        controlPlaneUrl: environment.DURABLE_ACTORS_CONTROL_PLANE_URL ?? \"http://127.0.0.1:7100\"\n    };\n}\nexport function runtimeEnvironment() {\n    return globalThis.process?.env ?? {};\n}\nexport function validateOrigin(origin) {\n    let url;\n    try {\n        url = new URL(origin);\n    }\n    catch (error) {\n        throw new ActorConfigurationError(`actor HTTP origin is invalid: ${origin}`, { cause: error });\n    }\n    if (!/^https?:$/u.test(url.protocol) ||\n        !url.hostname ||\n        url.username ||\n        url.password ||\n        url.pathname !== \"/\" ||\n        url.search ||\n        url.hash)\n        throw new ActorConfigurationError(`actor URL must be an HTTP or HTTPS origin: ${origin}`);\n    return url.origin;\n}\nexport function validateActorComponent(name, value) {\n    if (typeof value !== \"string\" || !/^[A-Za-z0-9._-]+$/u.test(value) || value === \".\" || value === \"..\")\n        throw new ActorValidationError(`${name} may contain only ASCII letters, digits, '.', '-', and '_' and must not be a path segment`);\n    return value;\n}\nexport function projectActorPath(projectId, actorName, actorId) {\n    return `/v1/projects/${encodeURIComponent(validateActorComponent(\"project ID\", projectId))}/actors/${encodeURIComponent(validateActorComponent(\"actor name\", actorName))}/${encodeURIComponent(validateActorComponent(\"actor ID\", actorId))}`;\n}\nexport function authorizationHeaders(credential) {\n    return credential === undefined ? {} : { authorization: `Bearer ${credential}` };\n}\n", "runtime/settings.d.ts": "export interface DurableActorsClientOptions {\n    readonly projectId?: string;\n    readonly apiKey?: string;\n    readonly homeRegion?: string;\n    readonly controlPlaneUrl: string;\n}\nexport type Environment = Record<string, string | undefined>;\nexport declare function configuredSettings(value: unknown): {\n    projectId: string;\n    credential: string | undefined;\n    homeRegion: string | undefined;\n    controlPlaneUrl: string;\n};\nexport declare function environmentSettings(environment?: Environment): DurableActorsClientOptions;\nexport declare function runtimeEnvironment(): Environment;\nexport declare function validateOrigin(origin: string): string;\nexport declare function validateActorComponent(name: string, value: string): string;\nexport declare function projectActorPath(projectId: string, actorName: string, actorId: string): string;\nexport declare function authorizationHeaders(credential: string | undefined): Record<string, string>;\n", "runtime/http.js": "import { ActorProtocolError } from \"./errors.js\";\nimport { projectActorPath, validateOrigin } from \"./settings.js\";\nexport class HttpActorHostTransport {\n    fetchRequest;\n    constructor(fetchRequest = globalThis.fetch) {\n        this.fetchRequest = fetchRequest;\n    }\n    async invoke(target, invocation) {\n        // TODO: Replace this extra round trip with durable idempotency keys for safe invocation retries.\n        const readiness = await this.ping(target, invocation);\n        if (readiness !== \"ready\")\n            return { type: readiness };\n        let response;\n        try {\n            response = await this.post(target, invocation, \"invoke\", {\n                requestId: invocation.requestId,\n                ownerEpoch: target.ownerEpoch,\n                method: invocation.method,\n                args: invocation.args\n            });\n        }\n        catch (error) {\n            if (connectionRefused(error))\n                return { type: \"not_dispatched\" };\n            throw error;\n        }\n        // A 401 is issued before dispatch, so refreshing this ticket cannot repeat actor code.\n        if (response.status === 401)\n            return { type: \"unauthenticated\" };\n        if (!response.ok)\n            throw new Error(`actor host returned HTTP ${response.status}`);\n        const reply = await responseDocument(response);\n        if (isRecord(reply)) {\n            if (reply.type === \"completed\" && Object.hasOwn(reply, \"result\"))\n                return { type: \"completed\", result: reply.result };\n            if (reply.type === \"failed\" &&\n                typeof reply.code === \"string\" &&\n                reply.code.length > 0 &&\n                typeof reply.message === \"string\")\n                return { type: \"failed\", code: reply.code, message: reply.message };\n            if (reply.type === \"reroute\")\n                return { type: \"reroute\" };\n        }\n        throw new ActorProtocolError(\"actor host response did not contain a valid outcome\");\n    }\n    async publish(target, actor, effects) {\n        const response = await this.post(target, actor, \"socket-effects\", { ownerEpoch: target.ownerEpoch, effects });\n        if (!response.ok)\n            throw new Error(`socket effects returned HTTP ${response.status}`);\n    }\n    async ping(target, actor) {\n        try {\n            const response = await this.fetchRequest(`${validateOrigin(target.route)}${projectActorPath(actor.projectId, actor.actorName, actor.actorId)}/invoke`, {\n                method: \"HEAD\",\n                redirect: \"error\",\n                headers: { authorization: `Bearer ${target.token}` },\n                signal: AbortSignal.timeout(5_000)\n            });\n            if (response.status === 401)\n                return \"unauthenticated\";\n            return response.status === 204 ? \"ready\" : \"not_dispatched\";\n        }\n        catch {\n            return \"not_dispatched\";\n        }\n    }\n    post(target, actor, endpoint, body) {\n        return this.fetchRequest(`${validateOrigin(target.route)}${projectActorPath(actor.projectId, actor.actorName, actor.actorId)}/${endpoint}`, {\n            method: \"POST\",\n            redirect: \"error\",\n            headers: {\n                authorization: `Bearer ${target.token}`,\n                \"content-type\": \"application/json\",\n                accept: \"application/json\"\n            },\n            body: JSON.stringify(body)\n        });\n    }\n}\nfunction connectionRefused(error, ancestors = new Set()) {\n    if (!isRecord(error) || ancestors.has(error))\n        return false;\n    const visited = new Set(ancestors).add(error);\n    if (error.code !== undefined && error.code !== \"ECONNREFUSED\")\n        return false;\n    if (error.errors !== undefined)\n        return (Array.isArray(error.errors) &&\n            error.errors.length > 0 &&\n            error.errors.every(cause => connectionRefused(cause, visited)));\n    if (error.code === \"ECONNREFUSED\")\n        return error.syscall === \"connect\";\n    return connectionRefused(error.cause, visited);\n}\nexport async function responseDocument(response) {\n    try {\n        return await response.json();\n    }\n    catch (error) {\n        throw new ActorProtocolError(`HTTP ${response.status} response was not valid JSON`, { cause: error });\n    }\n}\nexport function isRecord(value) {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n", "runtime/http.d.ts": "import type { JsonValue } from \"./json.js\";\nexport declare class HttpActorHostTransport implements ActorHostTransport {\n    private readonly fetchRequest;\n    constructor(fetchRequest?: typeof globalThis.fetch);\n    invoke(target: ActorHostTarget, invocation: DirectActorInvocation): Promise<ActorHostReply>;\n    publish(target: ActorHostTarget, actor: ActorAddress, effects: readonly unknown[]): Promise<void>;\n    private ping;\n    private post;\n}\nexport declare function responseDocument(response: Response): Promise<unknown>;\nexport declare function isRecord(value: unknown): value is Record<string, unknown>;\nexport interface ActorAddress {\n    readonly projectId: string;\n    readonly actorName: string;\n    readonly actorId: string;\n}\nexport interface ActorHostTarget {\n    readonly route: string;\n    readonly token: string;\n    readonly ownerEpoch: number;\n    readonly expiresAtMs: number;\n}\nexport interface DirectActorInvocation extends ActorAddress {\n    readonly requestId: string;\n    readonly method: string;\n    readonly args: readonly JsonValue[];\n}\nexport type ActorHostReply = {\n    readonly type: \"completed\";\n    readonly result: unknown;\n} | {\n    readonly type: \"failed\";\n    readonly code: string;\n    readonly message: string;\n} | {\n    readonly type: \"reroute\";\n} | {\n    readonly type: \"unauthenticated\";\n} | {\n    readonly type: \"not_dispatched\";\n};\nexport interface ActorHostTransport {\n    invoke(target: ActorHostTarget, invocation: DirectActorInvocation): Promise<ActorHostReply>;\n    publish(target: ActorHostTarget, actor: ActorAddress, effects: readonly unknown[]): Promise<void>;\n}\n", "runtime/telemetry.js": "class LatencyTimeline {\n    now;\n    origin;\n    milestones = { started_at_ms: 0 };\n    constructor(now = () => performance.now()) {\n        this.now = now;\n        this.origin = this.now();\n    }\n    mark(name) {\n        this.milestones[`${name}_at_ms`] = Math.max(0, Math.round(this.now() - this.origin));\n    }\n    finish() {\n        this.mark(\"completed\");\n        return { ...this.milestones };\n    }\n}\nexport { LatencyTimeline };\n", "runtime/telemetry.d.ts": "type TelemetryEvent = Record<string, boolean | number | string | undefined>;\ntype TelemetrySink = (event: TelemetryEvent) => void;\ndeclare class LatencyTimeline {\n    private readonly now;\n    private readonly origin;\n    private readonly milestones;\n    constructor(now?: () => number);\n    mark(name: string): void;\n    finish(): Record<string, number>;\n}\nexport { LatencyTimeline };\nexport type { TelemetryEvent, TelemetrySink };\n", "runtime/client.js": "import { ActorInvocationError, ActorProtocolError } from \"./errors.js\";\nimport { HttpActorHostTransport, isRecord, responseDocument } from \"./http.js\";\nimport { cloneJson } from \"./json.js\";\nimport { authorizationHeaders, configuredSettings, environmentSettings, projectActorPath, runtimeEnvironment, validateActorComponent, validateOrigin } from \"./settings.js\";\nimport { LatencyTimeline } from \"./telemetry.js\";\nconst TARGET_EXPIRATION_SAFETY_MS = 5_000;\nexport class HttpActorClient {\n    beforeInvoke;\n    settingsValue;\n    environment;\n    fetchRequest;\n    requestId;\n    actorHost;\n    now;\n    monotonicNow;\n    telemetry;\n    targets = new Map();\n    constructor(options, dependencies = {}) {\n        this.beforeInvoke = dependencies.beforeInvoke ?? (() => { });\n        this.environment = dependencies.environment ?? runtimeEnvironment();\n        this.fetchRequest = dependencies.fetch ?? globalThis.fetch;\n        this.requestId = dependencies.requestId ?? (() => globalThis.crypto.randomUUID());\n        this.actorHost = dependencies.actorHost ?? new HttpActorHostTransport(this.fetchRequest);\n        // Workflow runtimes can replace Date.now with replayable logical time.\n        this.now = dependencies.now ?? (() => performance.timeOrigin + performance.now());\n        this.monotonicNow = dependencies.monotonicNow ?? (() => performance.now());\n        this.telemetry = dependencies.telemetry ?? (() => { });\n        this.settingsValue = options === undefined ? undefined : configuredSettings(options);\n    }\n    async invoke(actorName, actorId, method, args) {\n        const requestId = validateActorComponent(\"request ID\", this.requestId());\n        const timeline = new LatencyTimeline(this.monotonicNow);\n        let outcome = \"failed\";\n        try {\n            this.beforeInvoke(requestId);\n            const invocation = this.invocation(requestId, actorName, actorId, method, args);\n            timeline.mark(\"invocation_built\");\n            const target = await this.target(invocation, timeline);\n            timeline.mark(\"target_resolved\");\n            const result = await this.direct(target, invocation, true, timeline);\n            outcome = \"completed\";\n            return result;\n        }\n        finally {\n            this.telemetry({\n                event: \"actor_client_invocation\",\n                request_id: requestId,\n                actor_name: actorName,\n                actor_id: actorId,\n                method,\n                ...timeline.finish(),\n                outcome\n            });\n        }\n    }\n    async direct(target, invocation, retryAvailable, timeline) {\n        try {\n            const reply = await this.actorHost.invoke(target, invocation);\n            timeline.mark(\"host_rpc_completed\");\n            if (reply.type === \"completed\") {\n                timeline.mark(\"socket_effects_completed\");\n                return reply.result;\n            }\n            if (reply.type === \"failed\")\n                throw new ActorInvocationError(reply.code, invocation.requestId, reply.message);\n            this.invalidateTarget(invocation, target);\n            if (reply.type === \"unauthenticated\" && !retryAvailable) {\n                throw new ActorInvocationError(\"unauthenticated\", invocation.requestId, \"actor host rejected the refreshed invocation ticket\");\n            }\n            if (!retryAvailable)\n                throw new ActorInvocationError(\"unavailable\", invocation.requestId, reply.type === \"not_dispatched\"\n                    ? \"actor host could not be reached before execution\"\n                    : \"actor ownership changed repeatedly before execution\");\n            const rerouted = await this.target(invocation, timeline);\n            return this.direct(rerouted, invocation, false, timeline);\n        }\n        catch (error) {\n            if (error instanceof ActorInvocationError || error instanceof ActorProtocolError)\n                throw error;\n            this.invalidateTarget(invocation, target);\n            const message = error instanceof Error ? error.message : String(error);\n            throw new ActorInvocationError(\"outcome_unknown\", invocation.requestId, `actor-host HTTP request failed after dispatch: ${message}`);\n        }\n    }\n    invalidateTarget(invocation, target) {\n        const key = actorKey(invocation.actorName, invocation.actorId);\n        const current = this.targets.get(key);\n        if (current?.target === target)\n            this.targets.delete(key);\n    }\n    async target(invocation, timeline) {\n        const key = actorKey(invocation.actorName, invocation.actorId);\n        const current = this.targets.get(key);\n        timeline.mark(\"target_cache_checked\");\n        if (current) {\n            const target = await current.promise;\n            if (this.targets.get(key) !== current)\n                return this.target(invocation, timeline);\n            if (target.expiresAtMs > this.now() + TARGET_EXPIRATION_SAFETY_MS)\n                return target;\n            this.targets.delete(key);\n        }\n        const resolving = {\n            promise: this.resolveTarget(invocation)\n                .then(target => {\n                resolving.target = target;\n                return target;\n            })\n                .catch(error => {\n                if (this.targets.get(key) === resolving)\n                    this.targets.delete(key);\n                throw error;\n            })\n        };\n        this.targets.set(key, resolving);\n        return resolving.promise;\n    }\n    async resolveTarget(invocation) {\n        let response;\n        try {\n            response = await this.fetchRequest(targetUrl(this.settings, invocation.actorName, invocation.actorId), {\n                method: \"POST\",\n                redirect: \"error\",\n                headers: {\n                    accept: \"application/json\",\n                    ...authorizationHeaders(this.settings.credential),\n                    \"x-request-id\": invocation.requestId,\n                    \"content-type\": \"application/json\"\n                },\n                body: JSON.stringify({ homeRegion: this.settings.homeRegion })\n            });\n        }\n        catch (error) {\n            const message = error instanceof Error ? error.message : String(error);\n            throw new ActorInvocationError(\"unavailable\", invocation.requestId, `control-plane HTTP request failed before dispatch: ${message}`);\n        }\n        const document = await responseDocument(response);\n        if (!response.ok)\n            this.throwResponseFailure(response, document, invocation.requestId);\n        if (!isRecord(document) ||\n            typeof document.route !== \"string\" ||\n            typeof document.token !== \"string\" ||\n            !document.token.trim() ||\n            !positiveInteger(document.ownerEpoch) ||\n            !positiveInteger(document.expiresAtMs))\n            throw new ActorProtocolError(\"control-plane response did not contain a valid actor host target\");\n        validateOrigin(document.route);\n        return {\n            route: document.route,\n            token: document.token,\n            ownerEpoch: document.ownerEpoch,\n            expiresAtMs: document.expiresAtMs\n        };\n    }\n    throwResponseFailure(response, document, requestId) {\n        if (response.status === 401 || response.status === 403)\n            throw new ActorInvocationError(\"unauthenticated\", requestId, \"the durable-actors application credential was rejected\");\n        const failure = isRecord(document) ? document.error : undefined;\n        if (!isRecord(failure) ||\n            typeof failure.code !== \"string\" ||\n            !failure.code ||\n            typeof failure.message !== \"string\")\n            throw new ActorProtocolError(`control-plane HTTP ${response.status} response did not contain a valid error`);\n        throw new ActorInvocationError(failure.code, typeof failure.requestId === \"string\" ? failure.requestId : requestId, failure.message);\n    }\n    invocation(requestId, actorName, actorId, method, args) {\n        return {\n            requestId,\n            projectId: this.settings.projectId,\n            actorName: validateActorComponent(\"actor name\", actorName),\n            actorId: validateActorComponent(\"actor ID\", actorId),\n            method: validateActorComponent(\"actor method\", method),\n            args: this.jsonArguments(args)\n        };\n    }\n    get settings() {\n        if (this.settingsValue !== undefined)\n            return this.settingsValue;\n        this.settingsValue = configuredSettings(environmentSettings(this.environment));\n        return this.settingsValue;\n    }\n    jsonArguments(args) {\n        const value = cloneJson(args, \"actor arguments\");\n        if (!Array.isArray(value))\n            throw new ActorProtocolError(\"actor arguments must be a JSON array\");\n        return value;\n    }\n}\nfunction targetUrl(settings, actorName, actorId) {\n    const actor = validateActorComponent(\"actor name\", actorName);\n    const id = validateActorComponent(\"actor ID\", actorId);\n    return `${settings.controlPlaneUrl}${projectActorPath(settings.projectId, actor, id)}/find-actor`;\n}\nfunction actorKey(actorName, actorId) {\n    return `${actorName}\\u001f${actorId}`;\n}\nfunction positiveInteger(value) {\n    return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n", "runtime/client.d.ts": "import type { ActorHostTarget, ActorHostTransport, DirectActorInvocation } from \"./http.js\";\nimport { configuredSettings } from \"./settings.js\";\nimport type { DurableActorsClientOptions, Environment } from \"./settings.js\";\nimport { LatencyTimeline } from \"./telemetry.js\";\nimport type { TelemetrySink } from \"./telemetry.js\";\nexport declare class HttpActorClient {\n    private readonly beforeInvoke;\n    private settingsValue;\n    protected readonly environment: Environment;\n    protected readonly fetchRequest: typeof globalThis.fetch;\n    protected readonly requestId: () => string;\n    protected readonly actorHost: ActorHostTransport;\n    protected readonly now: () => number;\n    protected readonly monotonicNow: () => number;\n    protected readonly telemetry: TelemetrySink;\n    protected readonly targets: Map<string, TargetResolution>;\n    constructor(options?: DurableActorsClientOptions, dependencies?: HttpActorClientDependencies);\n    invoke(actorName: string, actorId: string, method: string, args: readonly unknown[]): Promise<unknown>;\n    private direct;\n    private invalidateTarget;\n    protected target(invocation: ActorAddress, timeline: LatencyTimeline): Promise<ActorHostTarget>;\n    private resolveTarget;\n    private throwResponseFailure;\n    private invocation;\n    protected get settings(): RemoteActorSettings;\n    private jsonArguments;\n}\ntype ActorAddress = Pick<DirectActorInvocation, \"requestId\" | \"projectId\" | \"actorName\" | \"actorId\">;\ninterface TargetResolution {\n    readonly promise: Promise<ActorHostTarget>;\n    target?: ActorHostTarget;\n}\ntype RemoteActorSettings = ReturnType<typeof configuredSettings>;\nexport interface HttpActorClientDependencies {\n    readonly environment?: Environment;\n    readonly fetch?: typeof globalThis.fetch;\n    readonly requestId?: () => string;\n    readonly actorHost?: ActorHostTransport;\n    readonly now?: () => number;\n    readonly monotonicNow?: () => number;\n    readonly telemetry?: TelemetrySink;\n    readonly beforeInvoke?: (requestId: string) => void;\n}\nexport type { DurableActorsClientOptions };\n", "runtime/proxy.js": "import { ActorProtocolError, ActorSerializationError, ActorValidationError } from \"./errors.js\";\nimport { isRecord } from \"./http.js\";\nimport { authorizationHeaders, configuredSettings, environmentSettings, projectActorPath, validateActorComponent } from \"./settings.js\";\n/** Issues browser connection URLs from your backend. */\nclass SocketProxy {\n    actors;\n    projectId;\n    origin;\n    apiKey;\n    setupTimeoutMs;\n    fetchRequest;\n    constructor(actors, options = {}, dependencies = {}) {\n        this.actors = actors;\n        this.setupTimeoutMs = options.setupTimeoutMs ?? 180000;\n        if (!Number.isSafeInteger(this.setupTimeoutMs) || this.setupTimeoutMs < 1000 || this.setupTimeoutMs > 600000)\n            throw new Error(\"Socket setup timeout must be between one second and ten minutes\");\n        const settings = configuredSettings(proxySettings(options));\n        this.origin = settings.controlPlaneUrl;\n        this.apiKey = settings.credential;\n        this.projectId = settings.projectId;\n        this.fetchRequest = dependencies.fetch ?? globalThis.fetch;\n    }\n    /**\n     * Call after authenticating the user and checking actor access.\n     * Pass `websocketUrl` to the browser's `new WebSocket()`.\n     */\n    async handle(authorization) {\n        const actorName = validateActorComponent(\"actor name\", authorization.actorName);\n        const actorId = validateActorComponent(\"actor ID\", authorization.actorId);\n        if (!Object.hasOwn(this.actors, actorName))\n            throw new Error(`Unknown actor name: ${actorName}`);\n        const metadata = socketMetadata(authorization.metadata);\n        const authorizationLifetimeMs = authorization.authorizationLifetimeMs ?? 900000;\n        if (!Number.isSafeInteger(authorizationLifetimeMs) ||\n            authorizationLifetimeMs < 1000 ||\n            authorizationLifetimeMs > 86400000)\n            throw new Error(\"Socket authorization lifetime must be between one second and one day\");\n        const homeRegion = authorization.homeRegion === undefined\n            ? undefined\n            : validateActorComponent(\"home region\", authorization.homeRegion);\n        const response = await this.fetchRequest(`${this.origin}${projectActorPath(this.projectId, actorName, actorId)}/find-websocket`, {\n            method: \"POST\",\n            redirect: \"error\",\n            headers: { ...authorizationHeaders(this.apiKey), \"content-type\": \"application/json\" },\n            body: JSON.stringify({ metadata, authorizationLifetimeMs, homeRegion }),\n            signal: AbortSignal.timeout(this.setupTimeoutMs)\n        });\n        if (!response.ok)\n            throw new Error(`WebSocket authorization could not be issued (HTTP ${response.status})`);\n        return socketGrant(await response.json());\n    }\n}\nfunction proxySettings(options) {\n    const environment = environmentSettings();\n    const controlPlaneUrl = options.controlPlaneUrl ?? environment.controlPlaneUrl;\n    const apiKey = options.apiKey ?? environment.apiKey;\n    return {\n        projectId: options.projectId ?? environment.projectId,\n        controlPlaneUrl: controlPlaneUrl ?? \"http://127.0.0.1:7100\",\n        apiKey\n    };\n}\nexport { SocketProxy };\nfunction socketGrant(value) {\n    if (!isRecord(value) ||\n        typeof value.websocketUrl !== \"string\" ||\n        !URL.canParse(value.websocketUrl) ||\n        !/^wss?:$/u.test(new URL(value.websocketUrl).protocol) ||\n        typeof value.homeRegion !== \"string\" ||\n        !value.homeRegion ||\n        !Number.isSafeInteger(value.connectByMs) ||\n        !Number.isSafeInteger(value.authorizedUntilMs))\n        throw new ActorProtocolError(\"invalid WebSocket authorization response\");\n    return {\n        websocketUrl: value.websocketUrl,\n        homeRegion: value.homeRegion,\n        connectByMs: value.connectByMs,\n        authorizedUntilMs: value.authorizedUntilMs\n    };\n}\nfunction socketMetadata(value) {\n    let encoded;\n    try {\n        encoded = JSON.stringify(value);\n        if (!isJsonValue(value))\n            throw new Error(\"invalid JSON value\");\n    }\n    catch (error) {\n        throw new ActorSerializationError(\"socket metadata must be a JSON value\", { cause: error });\n    }\n    if (new TextEncoder().encode(encoded).length > 64 * 1024)\n        throw new ActorValidationError(\"socket metadata exceeds 65536 bytes\");\n    return value;\n}\nfunction isJsonValue(value) {\n    if (value === null || typeof value === \"string\" || typeof value === \"boolean\")\n        return true;\n    if (typeof value === \"number\")\n        return Number.isFinite(value);\n    if (Array.isArray(value))\n        return Array.from(value).every(isJsonValue);\n    return (isRecord(value) &&\n        [Object.prototype, null].includes(Object.getPrototypeOf(value)) &&\n        Object.values(value).every(isJsonValue));\n}\n", "runtime/proxy.d.ts": "/** Overrides for the backend's DURABLE_ACTORS environment settings. */\ninterface SocketProxyOptions {\n    readonly projectId?: string;\n    readonly controlPlaneUrl?: string;\n    readonly apiKey?: string;\n    /** Defaults to 180000 ms; accepts 1000–600000 ms. */\n    readonly setupTimeoutMs?: number;\n}\ninterface SocketProxyDependencies {\n    readonly fetch?: typeof globalThis.fetch;\n}\ninterface ProxyActor<Metadata = unknown> {\n    readonly types?: Metadata;\n}\n/** Actor access your backend has already authorized. */\ntype SocketAuthorization<Actors extends Record<string, ProxyActor>> = {\n    [Name in keyof Actors & string]: {\n        readonly actorName: Name;\n        readonly actorId: string;\n        readonly metadata: Actors[Name] extends ProxyActor<infer Metadata> ? Metadata : never;\n        readonly homeRegion?: string;\n        readonly authorizationLifetimeMs?: number;\n    };\n}[keyof Actors & string];\n/** Browser connection URL and deadlines in Unix milliseconds. Treat the URL as a credential. */\ninterface SocketGrant {\n    websocketUrl: string;\n    homeRegion: string;\n    connectByMs: number;\n    authorizedUntilMs: number;\n}\n/** Issues browser connection URLs from your backend. */\ndeclare class SocketProxy<Actors extends Record<string, ProxyActor>> {\n    private readonly actors;\n    private readonly projectId;\n    private readonly origin;\n    private readonly apiKey;\n    private readonly setupTimeoutMs;\n    private readonly fetchRequest;\n    constructor(actors: Actors, options?: SocketProxyOptions, dependencies?: SocketProxyDependencies);\n    /**\n     * Call after authenticating the user and checking actor access.\n     * Pass `websocketUrl` to the browser's `new WebSocket()`.\n     */\n    handle(authorization: SocketAuthorization<Actors>): Promise<SocketGrant>;\n}\nexport { SocketProxy };\nexport type { ProxyActor, SocketAuthorization, SocketGrant, SocketProxyDependencies, SocketProxyOptions };\n", "runtime/stub.js": "import { HttpActorClient } from \"./client.js\";\nimport { ActorDefinitionError, ActorSerializationError } from \"./errors.js\";\nimport { validateActorComponent } from \"./settings.js\";\n/** Creates a backend client from generated method definitions. */\nfunction createActorStub(actorName, actorId, methods, transport) {\n    validateActorComponent(\"actor name\", actorName);\n    validateActorComponent(\"actor ID\", actorId);\n    const stub = Object.create(null);\n    for (const method of methods) {\n        validateActorComponent(\"actor method\", method.name);\n        if ([\"then\", \"connect\", \"broadcast\", \"onConnect\", \"onMessage\", \"onDisconnect\"].includes(method.name))\n            throw new ActorDefinitionError(`actor method ${actorName}.${method.name} is reserved`);\n        if (Object.hasOwn(stub, method.name))\n            throw new ActorDefinitionError(`duplicate actor method ${actorName}.${method.name}`);\n        Object.defineProperty(stub, method.name, {\n            enumerable: true,\n            value: async (...args) => {\n                const parameters = invocationArguments(args);\n                const client = transport ?? defaultTransport();\n                const result = await client.invoke(actorName, actorId, method.name, parameters);\n                return method.result === \"void\" ? undefined : result;\n            }\n        });\n    }\n    return stub;\n}\nexport { createActorStub };\nlet shared;\nexport function createActorTransport(options) {\n    return new HttpActorClient(options);\n}\nfunction defaultTransport() {\n    return (shared ??= new HttpActorClient());\n}\nfunction invocationArguments(args) {\n    let end = args.length;\n    while (end > 0 && args[end - 1] === undefined)\n        end--;\n    const parameters = args.slice(0, end);\n    if (parameters.includes(undefined))\n        throw new ActorSerializationError(\"undefined cannot precede a supplied RPC argument in JSON transport\");\n    return parameters;\n}\n", "runtime/stub.d.ts": "import type { DurableActorsClientOptions } from \"./settings.js\";\ninterface ActorRpcTransport {\n    invoke(actorName: string, actorId: string, method: string, args: readonly unknown[]): Promise<unknown>;\n}\ninterface ActorRpcMethod {\n    readonly name: string;\n    readonly result: \"void\" | \"value\";\n}\n/** Creates a backend client from generated method definitions. */\ndeclare function createActorStub<Stub extends object>(actorName: string, actorId: string, methods: readonly ActorRpcMethod[], transport?: ActorRpcTransport): Stub;\nexport { createActorStub };\nexport type { ActorRpcMethod, ActorRpcTransport };\nexport declare function createActorTransport(options: DurableActorsClientOptions): ActorRpcTransport;\nexport type { DurableActorsClientOptions };\n", "runtime/index.browser.js": "const createActorStub = () => {\n    throw new Error(\"actors must be used on the server\");\n};\nconst createActorTransport = () => {\n    throw new Error(\"actors must be used on the server\");\n};\nconst SocketProxy = class {\n    constructor() {\n        throw new Error(\"ActorProxy must be used on the server\");\n    }\n};\nexport { createActorStub, createActorTransport, SocketProxy };\nexport { ActorInvocationError } from \"./errors.js\";\n", "runtime/index.browser.d.ts": "import type { SocketProxy as ServerProxy } from \"./proxy.js\";\nimport type { createActorStub as ServerStub, createActorTransport as ServerTransport } from \"./stub.js\";\ndeclare const createActorStub: typeof ServerStub;\ndeclare const createActorTransport: typeof ServerTransport;\ndeclare const SocketProxy: typeof ServerProxy;\nexport { createActorStub, createActorTransport, SocketProxy };\nexport { ActorInvocationError } from \"./errors.js\";\n", "runtime/index.js": "export { createActorStub, createActorTransport } from \"./stub.js\";\nexport { ActorInvocationError } from \"./errors.js\";\nexport { SocketProxy } from \"./proxy.js\";\n", "runtime/index.d.ts": "export { createActorStub, createActorTransport } from \"./stub.js\";\nexport type { ActorRpcTransport, DurableActorsClientOptions } from \"./stub.js\";\nexport { ActorInvocationError } from \"./errors.js\";\nexport { SocketProxy } from \"./proxy.js\";\nexport type { ProxyActor, SocketGrant, SocketProxyDependencies, SocketProxyOptions } from \"./proxy.js\";\n", "runtime/package.json": "{\n  \"private\": true,\n  \"type\": \"module\",\n  \"sideEffects\": false,\n  \"browser\": {\n    \"./index.js\": \"./index.browser.js\"\n  }\n}\n", "runtime/LICENSE.md": "MIT License\n\nCopyright (c) 2026 Terse\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n" };
+export const runtimeFiles = { "runtime/errors.js": "class ActorConfigurationError extends Error {\n    constructor(message, options) {\n        super(message, options);\n        this.name = \"ActorConfigurationError\";\n    }\n}\nclass ActorDefinitionError extends Error {\n    constructor(message) {\n        super(message);\n        this.name = \"ActorDefinitionError\";\n    }\n}\n/** Remote failure. Retrying an `outcome_unknown` operation may run it twice. */\nclass ActorInvocationError extends Error {\n    /** Error category, such as `actor_error` or `outcome_unknown`. New codes may be added. */\n    code;\n    /** Identifies this caller attempt; it is not an application idempotency key. */\n    requestId;\n    constructor(code, requestId, message) {\n        super(message);\n        this.name = \"ActorInvocationError\";\n        this.code = code;\n        this.requestId = requestId;\n    }\n}\n/** Signals that the authorization service explicitly revoked or denied access. */\nclass ActorSessionRejectedError extends Error {\n    name = \"ActorSessionRejectedError\";\n}\nclass ActorSessionError extends Error {\n    constructor(message, options) {\n        super(message, options);\n        this.name = \"ActorSessionError\";\n    }\n}\nclass ActorProtocolError extends Error {\n    constructor(message, options) {\n        super(message, options);\n        this.name = \"ActorProtocolError\";\n    }\n}\nclass ActorSerializationError extends Error {\n    constructor(message, options) {\n        super(message, options);\n        this.name = \"ActorSerializationError\";\n    }\n}\nclass ActorValidationError extends Error {\n    constructor(message) {\n        super(message);\n        this.name = \"ActorValidationError\";\n    }\n}\nexport { ActorConfigurationError, ActorDefinitionError, ActorInvocationError, ActorProtocolError, ActorSerializationError, ActorSessionError, ActorSessionRejectedError, ActorValidationError };\nfunction errorMessage(error) {\n    return error instanceof Error ? error.message : String(error);\n}\nexport { errorMessage };\n", "runtime/errors.d.ts": "declare class ActorConfigurationError extends Error {\n    constructor(message: string, options?: ErrorOptions);\n}\ndeclare class ActorDefinitionError extends Error {\n    constructor(message: string);\n}\n/** Remote failure. Retrying an `outcome_unknown` operation may run it twice. */\ndeclare class ActorInvocationError extends Error {\n    /** Error category, such as `actor_error` or `outcome_unknown`. New codes may be added. */\n    readonly code: string;\n    /** Identifies this caller attempt; it is not an application idempotency key. */\n    readonly requestId: string;\n    constructor(code: string, requestId: string, message: string);\n}\n/** Signals that the authorization service explicitly revoked or denied access. */\ndeclare class ActorSessionRejectedError extends Error {\n    readonly name = \"ActorSessionRejectedError\";\n}\ndeclare class ActorSessionError extends Error {\n    constructor(message: string, options?: ErrorOptions);\n}\ndeclare class ActorProtocolError extends Error {\n    constructor(message: string, options?: ErrorOptions);\n}\ndeclare class ActorSerializationError extends Error {\n    constructor(message: string, options?: ErrorOptions);\n}\ndeclare class ActorValidationError extends Error {\n    constructor(message: string);\n}\nexport { ActorConfigurationError, ActorDefinitionError, ActorInvocationError, ActorProtocolError, ActorSerializationError, ActorSessionError, ActorSessionRejectedError, ActorValidationError };\ndeclare function errorMessage(error: unknown): string;\nexport { errorMessage };\n", "runtime/json.js": "import { ActorSerializationError } from \"./errors.js\";\nfunction cloneJson(value, label) {\n    try {\n        const encoded = JSON.stringify(value);\n        if (encoded === undefined)\n            throw new ActorSerializationError(`${label} must be JSON serializable`);\n        return JSON.parse(encoded);\n    }\n    catch (error) {\n        if (error instanceof ActorSerializationError)\n            throw error;\n        throw new ActorSerializationError(`${label} must be JSON serializable`, { cause: error });\n    }\n}\nexport { cloneJson };\n", "runtime/json.d.ts": "type JsonPrimitive = string | number | boolean | null;\ntype JsonObject = {\n    readonly [key: string]: JsonValue;\n};\ntype JsonValue = JsonPrimitive | JsonObject | readonly JsonValue[];\ndeclare function cloneJson(value: unknown, label: string): JsonValue;\nexport { cloneJson };\nexport type { JsonValue };\n", "runtime/settings.js": "import { ActorConfigurationError, ActorValidationError } from \"./errors.js\";\nexport function configuredSettings(value) {\n    if (typeof value !== \"object\" ||\n        value === null ||\n        Array.isArray(value) ||\n        Object.keys(value).some(key => ![\"projectId\", \"apiKey\", \"homeRegion\", \"controlPlaneUrl\"].includes(key)))\n        throw new ActorConfigurationError(\"durable-actors client settings are invalid\");\n    const options = value;\n    const controlPlaneUrl = validateOrigin(options.controlPlaneUrl);\n    const local = [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(new URL(controlPlaneUrl).hostname);\n    const projectId = options.projectId ?? (local ? \"local\" : undefined);\n    if (typeof projectId !== \"string\" || !/^[A-Za-z0-9._-]{1,64}$/u.test(projectId) || [\".\", \"..\"].includes(projectId))\n        throw new ActorConfigurationError(\"durable-actors client settings are invalid: a valid projectId is required for remote connections\");\n    if (options.apiKey !== undefined && (typeof options.apiKey !== \"string\" || !options.apiKey.trim()))\n        throw new ActorConfigurationError(\"durable-actors client settings are invalid: apiKey must not be empty\");\n    if (options.homeRegion !== undefined)\n        validateActorComponent(\"home region\", options.homeRegion);\n    return { projectId, credential: options.apiKey?.trim(), homeRegion: options.homeRegion, controlPlaneUrl };\n}\nexport function environmentSettings(environment = runtimeEnvironment()) {\n    return {\n        projectId: environment.DURABLE_ACTORS_PROJECT_ID,\n        apiKey: environment.DURABLE_ACTORS_SECRET ?? environment.DURABLE_ACTORS_API_KEY,\n        homeRegion: environment.DURABLE_ACTORS_HOME_REGION,\n        controlPlaneUrl: environment.DURABLE_ACTORS_CONTROL_PLANE_URL ?? \"http://127.0.0.1:7100\"\n    };\n}\nexport function runtimeEnvironment() {\n    return globalThis.process?.env ?? {};\n}\nexport function validateOrigin(origin) {\n    let url;\n    try {\n        url = new URL(origin);\n    }\n    catch (error) {\n        throw new ActorConfigurationError(`actor HTTP origin is invalid: ${origin}`, { cause: error });\n    }\n    if (!/^https?:$/u.test(url.protocol) ||\n        !url.hostname ||\n        url.username ||\n        url.password ||\n        url.pathname !== \"/\" ||\n        url.search ||\n        url.hash)\n        throw new ActorConfigurationError(`actor URL must be an HTTP or HTTPS origin: ${origin}`);\n    return url.origin;\n}\nexport function validateActorComponent(name, value) {\n    if (typeof value !== \"string\" || !/^[A-Za-z0-9._-]+$/u.test(value) || value === \".\" || value === \"..\")\n        throw new ActorValidationError(`${name} may contain only ASCII letters, digits, '.', '-', and '_' and must not be a path segment`);\n    return value;\n}\nexport function projectActorPath(projectId, actorName, actorId) {\n    return `/v1/projects/${encodeURIComponent(validateActorComponent(\"project ID\", projectId))}/actors/${encodeURIComponent(validateActorComponent(\"actor name\", actorName))}/${encodeURIComponent(validateActorComponent(\"actor ID\", actorId))}`;\n}\nexport function authorizationHeaders(credential) {\n    return credential === undefined ? {} : { authorization: `Bearer ${credential}` };\n}\n", "runtime/settings.d.ts": "export interface DurableActorsClientOptions {\n    readonly projectId?: string;\n    readonly apiKey?: string;\n    readonly homeRegion?: string;\n    readonly controlPlaneUrl: string;\n}\nexport type Environment = Record<string, string | undefined>;\nexport declare function configuredSettings(value: unknown): {\n    projectId: string;\n    credential: string | undefined;\n    homeRegion: string | undefined;\n    controlPlaneUrl: string;\n};\nexport declare function environmentSettings(environment?: Environment): DurableActorsClientOptions;\nexport declare function runtimeEnvironment(): Environment;\nexport declare function validateOrigin(origin: string): string;\nexport declare function validateActorComponent(name: string, value: string): string;\nexport declare function projectActorPath(projectId: string, actorName: string, actorId: string): string;\nexport declare function authorizationHeaders(credential: string | undefined): Record<string, string>;\n", "runtime/http.js": "import { ActorProtocolError } from \"./errors.js\";\nimport { projectActorPath, validateOrigin } from \"./settings.js\";\nexport class HttpActorHostTransport {\n    fetchRequest;\n    constructor(fetchRequest = globalThis.fetch) {\n        this.fetchRequest = fetchRequest;\n    }\n    async invoke(target, invocation) {\n        let response;\n        try {\n            response = await this.post(target, invocation, \"invoke\", {\n                requestId: invocation.requestId,\n                ownerEpoch: target.ownerEpoch,\n                method: invocation.method,\n                args: invocation.args\n            });\n        }\n        catch (error) {\n            if (connectionRefused(error))\n                return { type: \"not_executed\", reason: \"upstream_not_reached\" };\n            throw error;\n        }\n        // A 401 is issued before dispatch, so refreshing this ticket cannot repeat actor code.\n        if (response.status === 401)\n            return { type: \"unauthenticated\" };\n        if (!response.ok)\n            throw new Error(`actor host returned HTTP ${response.status}`);\n        return parseActorHostReply(await responseDocument(response));\n    }\n    async publish(target, actor, effects) {\n        const response = await this.post(target, actor, \"socket-effects\", { ownerEpoch: target.ownerEpoch, effects });\n        if (!response.ok)\n            throw new Error(`socket effects returned HTTP ${response.status}`);\n    }\n    post(target, actor, endpoint, body) {\n        return this.fetchRequest(`${validateOrigin(target.route)}${projectActorPath(actor.projectId, actor.actorName, actor.actorId)}/${endpoint}`, {\n            method: \"POST\",\n            redirect: \"error\",\n            headers: {\n                authorization: `Bearer ${target.token}`,\n                \"content-type\": \"application/json\",\n                accept: \"application/json\"\n            },\n            body: JSON.stringify(body)\n        });\n    }\n}\nexport function parseActorHostReply(reply) {\n    if (isRecord(reply)) {\n        if (reply.type === \"completed\" && Object.hasOwn(reply, \"result\"))\n            return { type: \"completed\", result: reply.result };\n        if (reply.type === \"failed\" &&\n            typeof reply.code === \"string\" &&\n            reply.code.length > 0 &&\n            typeof reply.message === \"string\")\n            return { type: \"failed\", code: reply.code, message: reply.message };\n        if (reply.type === \"not_executed\" && rejectionReason(reply.reason))\n            return { type: \"not_executed\", reason: reply.reason };\n    }\n    throw new ActorProtocolError(\"actor host response did not contain a valid outcome\");\n}\nfunction rejectionReason(value) {\n    return value === \"stale_owner\" || value === \"host_unavailable\" || value === \"upstream_not_reached\";\n}\nfunction connectionRefused(error, ancestors = new Set()) {\n    if (!isRecord(error) || ancestors.has(error))\n        return false;\n    const visited = new Set(ancestors).add(error);\n    if (error.code !== undefined && error.code !== \"ECONNREFUSED\")\n        return false;\n    if (error.errors !== undefined)\n        return (Array.isArray(error.errors) &&\n            error.errors.length > 0 &&\n            error.errors.every(cause => connectionRefused(cause, visited)));\n    if (error.code === \"ECONNREFUSED\")\n        return error.syscall === \"connect\";\n    return connectionRefused(error.cause, visited);\n}\nexport async function responseDocument(response) {\n    try {\n        return await response.json();\n    }\n    catch (error) {\n        throw new ActorProtocolError(`HTTP ${response.status} response was not valid JSON`, { cause: error });\n    }\n}\nexport function isRecord(value) {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n", "runtime/http.d.ts": "import type { JsonValue } from \"./json.js\";\nexport declare class HttpActorHostTransport implements ActorHostTransport {\n    private readonly fetchRequest;\n    constructor(fetchRequest?: typeof globalThis.fetch);\n    invoke(target: ActorHostTarget, invocation: ActorInvocation): Promise<ActorHostReply>;\n    publish(target: ActorHostTarget, actor: ActorAddress, effects: readonly unknown[]): Promise<void>;\n    private post;\n}\nexport declare function parseActorHostReply(reply: unknown): ActorHostReply;\nexport declare function responseDocument(response: Response): Promise<unknown>;\nexport declare function isRecord(value: unknown): value is Record<string, unknown>;\nexport interface ActorAddress {\n    readonly projectId: string;\n    readonly actorName: string;\n    readonly actorId: string;\n}\nexport interface ActorHostTarget {\n    readonly route: string;\n    readonly token: string;\n    readonly ownerEpoch: number;\n    readonly expiresAtMs: number;\n}\nexport interface ActorInvocation extends ActorAddress {\n    readonly requestId: string;\n    readonly method: string;\n    readonly args: readonly JsonValue[];\n}\ntype ActorRejectionReason = \"stale_owner\" | \"host_unavailable\" | \"upstream_not_reached\";\nexport type ActorHostReply = {\n    readonly type: \"completed\";\n    readonly result: unknown;\n} | {\n    readonly type: \"failed\";\n    readonly code: string;\n    readonly message: string;\n} | {\n    readonly type: \"unauthenticated\";\n} | {\n    readonly type: \"not_executed\";\n    readonly reason: ActorRejectionReason;\n};\nexport interface ActorHostTransport {\n    invoke(target: ActorHostTarget, invocation: ActorInvocation): Promise<ActorHostReply>;\n    publish(target: ActorHostTarget, actor: ActorAddress, effects: readonly unknown[]): Promise<void>;\n}\nexport {};\n", "runtime/telemetry.js": "class LatencyTimeline {\n    now;\n    origin;\n    milestones = { started_at_ms: 0 };\n    constructor(now = () => performance.now()) {\n        this.now = now;\n        this.origin = this.now();\n    }\n    mark(name) {\n        this.milestones[`${name}_at_ms`] = Math.max(0, Math.round(this.now() - this.origin));\n    }\n    finish() {\n        this.mark(\"completed\");\n        return { ...this.milestones };\n    }\n}\nexport { LatencyTimeline };\n", "runtime/telemetry.d.ts": "type TelemetryEvent = Record<string, boolean | number | string | undefined>;\ntype TelemetrySink = (event: TelemetryEvent) => void;\ndeclare class LatencyTimeline {\n    private readonly now;\n    private readonly origin;\n    private readonly milestones;\n    constructor(now?: () => number);\n    mark(name: string): void;\n    finish(): Record<string, number>;\n}\nexport { LatencyTimeline };\nexport type { TelemetryEvent, TelemetrySink };\n", "runtime/client.js": "import { ActorInvocationError, ActorProtocolError } from \"./errors.js\";\nimport { HttpActorHostTransport, isRecord, parseActorHostReply, responseDocument } from \"./http.js\";\nimport { cloneJson } from \"./json.js\";\nimport { authorizationHeaders, configuredSettings, environmentSettings, projectActorPath, runtimeEnvironment, validateActorComponent, validateOrigin } from \"./settings.js\";\nimport { LatencyTimeline } from \"./telemetry.js\";\nconst TARGET_EXPIRATION_SAFETY_MS = 5_000;\nexport class HttpActorClient {\n    beforeInvoke;\n    settingsValue;\n    environment;\n    fetchRequest;\n    requestId;\n    actorHost;\n    now;\n    monotonicNow;\n    telemetry;\n    targets = new Map();\n    constructor(options, dependencies = {}) {\n        this.beforeInvoke = dependencies.beforeInvoke ?? (() => { });\n        this.environment = dependencies.environment ?? runtimeEnvironment();\n        this.fetchRequest = dependencies.fetch ?? globalThis.fetch;\n        this.requestId = dependencies.requestId ?? (() => globalThis.crypto.randomUUID());\n        this.actorHost = dependencies.actorHost ?? new HttpActorHostTransport(this.fetchRequest);\n        // Workflow runtimes can replace Date.now with replayable logical time.\n        this.now = dependencies.now ?? (() => performance.timeOrigin + performance.now());\n        this.monotonicNow = dependencies.monotonicNow ?? (() => performance.now());\n        this.telemetry = dependencies.telemetry ?? (() => { });\n        this.settingsValue = options === undefined ? undefined : configuredSettings(options);\n    }\n    async invoke(actorName, actorId, method, args) {\n        const requestId = validateActorComponent(\"request ID\", this.requestId());\n        const timeline = new LatencyTimeline(this.monotonicNow);\n        let outcome = \"failed\";\n        try {\n            this.beforeInvoke(requestId);\n            const invocation = this.invocation(requestId, actorName, actorId, method, args);\n            timeline.mark(\"invocation_built\");\n            const result = await this.invokeAttempt(invocation, true, timeline);\n            outcome = \"completed\";\n            return result;\n        }\n        finally {\n            this.telemetry({\n                event: \"actor_client_invocation\",\n                request_id: requestId,\n                actor_name: actorName,\n                actor_id: actorId,\n                method,\n                ...timeline.finish(),\n                outcome\n            });\n        }\n    }\n    async invokeAttempt(invocation, retryAvailable, timeline) {\n        let target = await this.cachedTarget(invocation, timeline);\n        let reply;\n        if (target) {\n            reply = await this.direct(target, invocation);\n            timeline.mark(\"host_rpc_completed\");\n        }\n        else {\n            const key = actorKey(invocation.actorName, invocation.actorId);\n            const current = this.targets.get(key);\n            const resolved = await this.resolveAndInvoke(invocation);\n            target = resolved.target;\n            reply = resolved.reply;\n            if ((reply.type === \"completed\" || reply.type === \"failed\") && this.targets.get(key) === current) {\n                this.targets.set(key, { promise: Promise.resolve(target), target });\n            }\n            timeline.mark(\"control_plane_invocation_completed\");\n        }\n        if (reply.type === \"completed\")\n            return reply.result;\n        if (reply.type === \"failed\")\n            throw new ActorInvocationError(reply.code, invocation.requestId, reply.message);\n        this.invalidateTarget(invocation, target);\n        if (!retryAvailable)\n            throw new ActorInvocationError(reply.type === \"unauthenticated\" ? \"unauthenticated\" : \"unavailable\", invocation.requestId, \"actor host rejected the invocation before execution after recovery\");\n        return this.invokeAttempt(invocation, false, timeline);\n    }\n    async direct(target, invocation) {\n        try {\n            return await this.actorHost.invoke(target, invocation);\n        }\n        catch (error) {\n            this.invalidateTarget(invocation, target);\n            if (error instanceof ActorInvocationError || error instanceof ActorProtocolError)\n                throw error;\n            const message = error instanceof Error ? error.message : String(error);\n            throw new ActorInvocationError(\"outcome_unknown\", invocation.requestId, `actor-host HTTP request failed after dispatch: ${message}`);\n        }\n    }\n    async resolveAndInvoke(invocation) {\n        let response;\n        try {\n            response = await this.fetchRequest(`${this.settings.controlPlaneUrl}${projectActorPath(this.settings.projectId, invocation.actorName, invocation.actorId)}/invoke`, {\n                method: \"POST\",\n                redirect: \"error\",\n                headers: {\n                    accept: \"application/json\",\n                    ...authorizationHeaders(this.settings.credential),\n                    \"x-request-id\": invocation.requestId,\n                    \"content-type\": \"application/json\"\n                },\n                body: JSON.stringify({\n                    requestId: invocation.requestId,\n                    method: invocation.method,\n                    args: invocation.args,\n                    homeRegion: this.settings.homeRegion\n                })\n            });\n        }\n        catch (error) {\n            const message = error instanceof Error ? error.message : String(error);\n            throw new ActorInvocationError(\"outcome_unknown\", invocation.requestId, `control-plane invocation failed after it may have been dispatched: ${message}`);\n        }\n        const document = await responseDocument(response);\n        if (!response.ok)\n            this.throwResponseFailure(response, document, invocation.requestId);\n        if (!isRecord(document))\n            throw new ActorProtocolError(\"control-plane response did not contain an invocation outcome and target\");\n        const target = parseTarget(document.target);\n        const reply = isRecord(document.outcome) && document.outcome.type === \"unauthenticated\"\n            ? { type: \"unauthenticated\" }\n            : parseActorHostReply(document.outcome);\n        return { target, reply };\n    }\n    invalidateTarget(invocation, target) {\n        const key = actorKey(invocation.actorName, invocation.actorId);\n        if (this.targets.get(key)?.target === target)\n            this.targets.delete(key);\n    }\n    async cachedTarget(invocation, timeline) {\n        const key = actorKey(invocation.actorName, invocation.actorId);\n        const current = this.targets.get(key);\n        timeline.mark(\"target_cache_checked\");\n        if (!current)\n            return undefined;\n        const target = await current.promise;\n        if (this.targets.get(key) !== current)\n            return this.cachedTarget(invocation, timeline);\n        if (target.expiresAtMs > this.now() + TARGET_EXPIRATION_SAFETY_MS)\n            return target;\n        this.targets.delete(key);\n        return undefined;\n    }\n    async target(invocation, timeline) {\n        const cached = await this.cachedTarget(invocation, timeline);\n        if (cached)\n            return cached;\n        const key = actorKey(invocation.actorName, invocation.actorId);\n        if (this.targets.has(key))\n            return this.target(invocation, timeline);\n        const resolving = {\n            promise: this.resolveTarget(invocation)\n                .then(target => {\n                resolving.target = target;\n                return target;\n            })\n                .catch(error => {\n                if (this.targets.get(key) === resolving)\n                    this.targets.delete(key);\n                throw error;\n            })\n        };\n        this.targets.set(key, resolving);\n        return resolving.promise;\n    }\n    async resolveTarget(invocation) {\n        let response;\n        try {\n            response = await this.fetchRequest(targetUrl(this.settings, invocation.actorName, invocation.actorId), {\n                method: \"POST\",\n                redirect: \"error\",\n                headers: {\n                    accept: \"application/json\",\n                    ...authorizationHeaders(this.settings.credential),\n                    \"x-request-id\": invocation.requestId,\n                    \"content-type\": \"application/json\"\n                },\n                body: JSON.stringify({ homeRegion: this.settings.homeRegion })\n            });\n        }\n        catch (error) {\n            const message = error instanceof Error ? error.message : String(error);\n            throw new ActorInvocationError(\"unavailable\", invocation.requestId, `control-plane HTTP request failed before dispatch: ${message}`);\n        }\n        const document = await responseDocument(response);\n        if (!response.ok)\n            this.throwResponseFailure(response, document, invocation.requestId);\n        return parseTarget(document);\n    }\n    throwResponseFailure(response, document, requestId) {\n        if (response.status === 401 || response.status === 403)\n            throw new ActorInvocationError(\"unauthenticated\", requestId, \"the durable-actors application credential was rejected\");\n        const failure = isRecord(document) ? document.error : undefined;\n        if (!isRecord(failure) ||\n            typeof failure.code !== \"string\" ||\n            !failure.code ||\n            typeof failure.message !== \"string\")\n            throw new ActorProtocolError(`control-plane HTTP ${response.status} response did not contain a valid error`);\n        throw new ActorInvocationError(failure.code, typeof failure.requestId === \"string\" ? failure.requestId : requestId, failure.message);\n    }\n    invocation(requestId, actorName, actorId, method, args) {\n        return {\n            requestId,\n            projectId: this.settings.projectId,\n            actorName: validateActorComponent(\"actor name\", actorName),\n            actorId: validateActorComponent(\"actor ID\", actorId),\n            method: validateActorComponent(\"actor method\", method),\n            args: this.jsonArguments(args)\n        };\n    }\n    get settings() {\n        if (this.settingsValue !== undefined)\n            return this.settingsValue;\n        this.settingsValue = configuredSettings(environmentSettings(this.environment));\n        return this.settingsValue;\n    }\n    jsonArguments(args) {\n        const value = cloneJson(args, \"actor arguments\");\n        if (!Array.isArray(value))\n            throw new ActorProtocolError(\"actor arguments must be a JSON array\");\n        return value;\n    }\n}\nfunction parseTarget(document) {\n    if (!isRecord(document) ||\n        typeof document.route !== \"string\" ||\n        typeof document.token !== \"string\" ||\n        !document.token.trim() ||\n        !positiveInteger(document.ownerEpoch) ||\n        !positiveInteger(document.expiresAtMs))\n        throw new ActorProtocolError(\"control-plane response did not contain a valid actor host target\");\n    validateOrigin(document.route);\n    return {\n        route: document.route,\n        token: document.token,\n        ownerEpoch: document.ownerEpoch,\n        expiresAtMs: document.expiresAtMs\n    };\n}\nfunction targetUrl(settings, actorName, actorId) {\n    const actor = validateActorComponent(\"actor name\", actorName);\n    const id = validateActorComponent(\"actor ID\", actorId);\n    return `${settings.controlPlaneUrl}${projectActorPath(settings.projectId, actor, id)}/find-actor`;\n}\nfunction actorKey(actorName, actorId) {\n    return `${actorName}\\u001f${actorId}`;\n}\nfunction positiveInteger(value) {\n    return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n", "runtime/client.d.ts": "import type { ActorHostTarget, ActorHostTransport, ActorInvocation } from \"./http.js\";\nimport { configuredSettings } from \"./settings.js\";\nimport type { DurableActorsClientOptions, Environment } from \"./settings.js\";\nimport { LatencyTimeline } from \"./telemetry.js\";\nimport type { TelemetrySink } from \"./telemetry.js\";\nexport declare class HttpActorClient {\n    private readonly beforeInvoke;\n    private settingsValue;\n    protected readonly environment: Environment;\n    protected readonly fetchRequest: typeof globalThis.fetch;\n    protected readonly requestId: () => string;\n    protected readonly actorHost: ActorHostTransport;\n    protected readonly now: () => number;\n    protected readonly monotonicNow: () => number;\n    protected readonly telemetry: TelemetrySink;\n    protected readonly targets: Map<string, TargetResolution>;\n    constructor(options?: DurableActorsClientOptions, dependencies?: HttpActorClientDependencies);\n    invoke(actorName: string, actorId: string, method: string, args: readonly unknown[]): Promise<unknown>;\n    private invokeAttempt;\n    private direct;\n    private resolveAndInvoke;\n    private invalidateTarget;\n    private cachedTarget;\n    protected target(invocation: ActorAddress, timeline: LatencyTimeline): Promise<ActorHostTarget>;\n    private resolveTarget;\n    private throwResponseFailure;\n    private invocation;\n    protected get settings(): RemoteActorSettings;\n    private jsonArguments;\n}\ntype ActorAddress = Pick<ActorInvocation, \"requestId\" | \"projectId\" | \"actorName\" | \"actorId\">;\ninterface TargetResolution {\n    readonly promise: Promise<ActorHostTarget>;\n    target?: ActorHostTarget;\n}\ntype RemoteActorSettings = ReturnType<typeof configuredSettings>;\nexport interface HttpActorClientDependencies {\n    readonly environment?: Environment;\n    readonly fetch?: typeof globalThis.fetch;\n    readonly requestId?: () => string;\n    readonly actorHost?: ActorHostTransport;\n    readonly now?: () => number;\n    readonly monotonicNow?: () => number;\n    readonly telemetry?: TelemetrySink;\n    readonly beforeInvoke?: (requestId: string) => void;\n}\nexport type { DurableActorsClientOptions };\n", "runtime/proxy.js": "import { ActorProtocolError, ActorSerializationError, ActorValidationError } from \"./errors.js\";\nimport { isRecord } from \"./http.js\";\nimport { authorizationHeaders, configuredSettings, environmentSettings, projectActorPath, validateActorComponent } from \"./settings.js\";\n/** Issues browser connection URLs from your backend. */\nclass SocketProxy {\n    actors;\n    projectId;\n    origin;\n    apiKey;\n    setupTimeoutMs;\n    fetchRequest;\n    constructor(actors, options = {}, dependencies = {}) {\n        this.actors = actors;\n        this.setupTimeoutMs = options.setupTimeoutMs ?? 180000;\n        if (!Number.isSafeInteger(this.setupTimeoutMs) || this.setupTimeoutMs < 1000 || this.setupTimeoutMs > 600000)\n            throw new Error(\"Socket setup timeout must be between one second and ten minutes\");\n        const settings = configuredSettings(proxySettings(options));\n        this.origin = settings.controlPlaneUrl;\n        this.apiKey = settings.credential;\n        this.projectId = settings.projectId;\n        this.fetchRequest = dependencies.fetch ?? globalThis.fetch;\n    }\n    /**\n     * Call after authenticating the user and checking actor access.\n     * Pass `websocketUrl` to the browser's `new WebSocket()`.\n     */\n    async handle(authorization) {\n        const actorName = validateActorComponent(\"actor name\", authorization.actorName);\n        const actorId = validateActorComponent(\"actor ID\", authorization.actorId);\n        if (!Object.hasOwn(this.actors, actorName))\n            throw new Error(`Unknown actor name: ${actorName}`);\n        const metadata = socketMetadata(authorization.metadata);\n        const authorizationLifetimeMs = authorization.authorizationLifetimeMs ?? 900000;\n        if (!Number.isSafeInteger(authorizationLifetimeMs) ||\n            authorizationLifetimeMs < 1000 ||\n            authorizationLifetimeMs > 86400000)\n            throw new Error(\"Socket authorization lifetime must be between one second and one day\");\n        const homeRegion = authorization.homeRegion === undefined\n            ? undefined\n            : validateActorComponent(\"home region\", authorization.homeRegion);\n        const response = await this.fetchRequest(`${this.origin}${projectActorPath(this.projectId, actorName, actorId)}/find-websocket`, {\n            method: \"POST\",\n            redirect: \"error\",\n            headers: { ...authorizationHeaders(this.apiKey), \"content-type\": \"application/json\" },\n            body: JSON.stringify({ metadata, authorizationLifetimeMs, homeRegion }),\n            signal: AbortSignal.timeout(this.setupTimeoutMs)\n        });\n        if (!response.ok)\n            throw new Error(`WebSocket authorization could not be issued (HTTP ${response.status})`);\n        return socketGrant(await response.json());\n    }\n}\nfunction proxySettings(options) {\n    const environment = environmentSettings();\n    const controlPlaneUrl = options.controlPlaneUrl ?? environment.controlPlaneUrl;\n    const apiKey = options.apiKey ?? environment.apiKey;\n    return {\n        projectId: options.projectId ?? environment.projectId,\n        controlPlaneUrl: controlPlaneUrl ?? \"http://127.0.0.1:7100\",\n        apiKey\n    };\n}\nexport { SocketProxy };\nfunction socketGrant(value) {\n    if (!isRecord(value) ||\n        typeof value.websocketUrl !== \"string\" ||\n        !URL.canParse(value.websocketUrl) ||\n        !/^wss?:$/u.test(new URL(value.websocketUrl).protocol) ||\n        typeof value.homeRegion !== \"string\" ||\n        !value.homeRegion ||\n        !Number.isSafeInteger(value.connectByMs) ||\n        !Number.isSafeInteger(value.authorizedUntilMs))\n        throw new ActorProtocolError(\"invalid WebSocket authorization response\");\n    return {\n        websocketUrl: value.websocketUrl,\n        homeRegion: value.homeRegion,\n        connectByMs: value.connectByMs,\n        authorizedUntilMs: value.authorizedUntilMs\n    };\n}\nfunction socketMetadata(value) {\n    let encoded;\n    try {\n        encoded = JSON.stringify(value);\n        if (!isJsonValue(value))\n            throw new Error(\"invalid JSON value\");\n    }\n    catch (error) {\n        throw new ActorSerializationError(\"socket metadata must be a JSON value\", { cause: error });\n    }\n    if (new TextEncoder().encode(encoded).length > 64 * 1024)\n        throw new ActorValidationError(\"socket metadata exceeds 65536 bytes\");\n    return value;\n}\nfunction isJsonValue(value) {\n    if (value === null || typeof value === \"string\" || typeof value === \"boolean\")\n        return true;\n    if (typeof value === \"number\")\n        return Number.isFinite(value);\n    if (Array.isArray(value))\n        return Array.from(value).every(isJsonValue);\n    return (isRecord(value) &&\n        [Object.prototype, null].includes(Object.getPrototypeOf(value)) &&\n        Object.values(value).every(isJsonValue));\n}\n", "runtime/proxy.d.ts": "/** Overrides for the backend's DURABLE_ACTORS environment settings. */\ninterface SocketProxyOptions {\n    readonly projectId?: string;\n    readonly controlPlaneUrl?: string;\n    readonly apiKey?: string;\n    /** Defaults to 180000 ms; accepts 1000–600000 ms. */\n    readonly setupTimeoutMs?: number;\n}\ninterface SocketProxyDependencies {\n    readonly fetch?: typeof globalThis.fetch;\n}\ninterface ProxyActor<Metadata = unknown> {\n    readonly types?: Metadata;\n}\n/** Actor access your backend has already authorized. */\ntype SocketAuthorization<Actors extends Record<string, ProxyActor>> = {\n    [Name in keyof Actors & string]: {\n        readonly actorName: Name;\n        readonly actorId: string;\n        readonly metadata: Actors[Name] extends ProxyActor<infer Metadata> ? Metadata : never;\n        readonly homeRegion?: string;\n        readonly authorizationLifetimeMs?: number;\n    };\n}[keyof Actors & string];\n/** Browser connection URL and deadlines in Unix milliseconds. Treat the URL as a credential. */\ninterface SocketGrant {\n    websocketUrl: string;\n    homeRegion: string;\n    connectByMs: number;\n    authorizedUntilMs: number;\n}\n/** Issues browser connection URLs from your backend. */\ndeclare class SocketProxy<Actors extends Record<string, ProxyActor>> {\n    private readonly actors;\n    private readonly projectId;\n    private readonly origin;\n    private readonly apiKey;\n    private readonly setupTimeoutMs;\n    private readonly fetchRequest;\n    constructor(actors: Actors, options?: SocketProxyOptions, dependencies?: SocketProxyDependencies);\n    /**\n     * Call after authenticating the user and checking actor access.\n     * Pass `websocketUrl` to the browser's `new WebSocket()`.\n     */\n    handle(authorization: SocketAuthorization<Actors>): Promise<SocketGrant>;\n}\nexport { SocketProxy };\nexport type { ProxyActor, SocketAuthorization, SocketGrant, SocketProxyDependencies, SocketProxyOptions };\n", "runtime/stub.js": "import { HttpActorClient } from \"./client.js\";\nimport { ActorDefinitionError, ActorSerializationError } from \"./errors.js\";\nimport { validateActorComponent } from \"./settings.js\";\n/** Creates a backend client from generated method definitions. */\nfunction createActorStub(actorName, actorId, methods, transport) {\n    validateActorComponent(\"actor name\", actorName);\n    validateActorComponent(\"actor ID\", actorId);\n    const stub = Object.create(null);\n    for (const method of methods) {\n        validateActorComponent(\"actor method\", method.name);\n        if ([\"then\", \"connect\", \"broadcast\", \"onConnect\", \"onMessage\", \"onDisconnect\"].includes(method.name))\n            throw new ActorDefinitionError(`actor method ${actorName}.${method.name} is reserved`);\n        if (Object.hasOwn(stub, method.name))\n            throw new ActorDefinitionError(`duplicate actor method ${actorName}.${method.name}`);\n        Object.defineProperty(stub, method.name, {\n            enumerable: true,\n            value: async (...args) => {\n                const parameters = invocationArguments(args);\n                const client = transport ?? defaultTransport();\n                const result = await client.invoke(actorName, actorId, method.name, parameters);\n                return method.result === \"void\" ? undefined : result;\n            }\n        });\n    }\n    return stub;\n}\nexport { createActorStub };\nlet shared;\nexport function createActorTransport(options) {\n    return new HttpActorClient(options);\n}\nfunction defaultTransport() {\n    return (shared ??= new HttpActorClient());\n}\nfunction invocationArguments(args) {\n    let end = args.length;\n    while (end > 0 && args[end - 1] === undefined)\n        end--;\n    const parameters = args.slice(0, end);\n    if (parameters.includes(undefined))\n        throw new ActorSerializationError(\"undefined cannot precede a supplied RPC argument in JSON transport\");\n    return parameters;\n}\n", "runtime/stub.d.ts": "import type { DurableActorsClientOptions } from \"./settings.js\";\ninterface ActorRpcTransport {\n    invoke(actorName: string, actorId: string, method: string, args: readonly unknown[]): Promise<unknown>;\n}\ninterface ActorRpcMethod {\n    readonly name: string;\n    readonly result: \"void\" | \"value\";\n}\n/** Creates a backend client from generated method definitions. */\ndeclare function createActorStub<Stub extends object>(actorName: string, actorId: string, methods: readonly ActorRpcMethod[], transport?: ActorRpcTransport): Stub;\nexport { createActorStub };\nexport type { ActorRpcMethod, ActorRpcTransport };\nexport declare function createActorTransport(options: DurableActorsClientOptions): ActorRpcTransport;\nexport type { DurableActorsClientOptions };\n", "runtime/session.js": "import { HttpActorClient } from \"./client.js\";\nimport { ActorSessionRejectedError } from \"./errors.js\";\nimport { validateActorComponent, validateOrigin } from \"./settings.js\";\nexport { ActorSessionRejectedError } from \"./errors.js\";\n/**\n * Reuses actor targets and renews runtime-issued sessions through a trusted backend.\n * Sessions require an HTTPS origin (except localhost) and at most 60 seconds of validity.\n * Renewal stops after a minute without invocations; dispose cancels it immediately.\n */\nexport class ActorSessionTransport {\n    options;\n    transport;\n    expiresAtMs = 0;\n    lastUsedAt = 0;\n    pending;\n    cancel;\n    closed = false;\n    now;\n    createTransport;\n    schedule;\n    constructor(options, dependencies = {}) {\n        this.options = options;\n        validateActorComponent(\"project ID\", options.projectId);\n        this.now = dependencies.now ?? (() => performance.timeOrigin + performance.now());\n        this.createTransport = dependencies.createTransport ?? (settings => new HttpActorClient(settings));\n        this.schedule = dependencies.schedule ?? scheduleRefresh;\n    }\n    async invoke(actorName, actorId, method, args) {\n        if (this.closed)\n            throw new Error(\"Actor session transport is disposed\");\n        this.lastUsedAt = this.now();\n        const transport = this.transport && this.expiresAtMs > this.now() + 5_000 ? this.transport : await this.refresh();\n        return transport.invoke(actorName, actorId, method, args);\n    }\n    dispose() {\n        this.closed = true;\n        this.cancel?.();\n        this.transport = undefined;\n    }\n    refresh() {\n        if (this.pending)\n            return this.pending;\n        this.cancel?.();\n        this.pending = this.exchange().finally(() => {\n            this.pending = undefined;\n        });\n        return this.pending;\n    }\n    async exchange() {\n        let session;\n        try {\n            session = await this.options.getSession();\n        }\n        catch (error) {\n            if (error instanceof ActorSessionRejectedError) {\n                this.transport = undefined;\n                this.expiresAtMs = 0;\n            }\n            throw error;\n        }\n        const remaining = this.validateSession(session);\n        if (this.closed)\n            throw new Error(\"Actor session transport is disposed\");\n        const transport = this.createTransport({\n            projectId: session.projectId,\n            controlPlaneUrl: session.controlPlaneUrl,\n            apiKey: session.token\n        });\n        this.transport = transport;\n        this.expiresAtMs = session.expiresAtMs;\n        this.scheduleRenewal(remaining * (0.75 + Math.random() * 0.05));\n        return transport;\n    }\n    validateSession(session) {\n        if (!session ||\n            session.projectId !== this.options.projectId ||\n            typeof session.token !== \"string\" ||\n            !session.token.trim() ||\n            !Number.isSafeInteger(session.expiresAtMs))\n            throw new Error(\"Invalid actor session\");\n        const origin = new URL(validateOrigin(session.controlPlaneUrl));\n        if (origin.protocol !== \"https:\" && ![\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(origin.hostname))\n            throw new Error(\"Actor sessions require HTTPS outside localhost\");\n        const remaining = session.expiresAtMs - this.now();\n        if (remaining <= 5_000 || remaining > 65_000)\n            throw new Error(\"Actor session is expired or invalid\");\n        return remaining;\n    }\n    scheduleRenewal(delayMs) {\n        this.cancel = this.schedule(() => {\n            if (this.closed || this.now() - this.lastUsedAt >= 60_000)\n                return;\n            void this.refresh().catch(() => {\n                if (!this.closed && this.expiresAtMs > this.now() + 5_000)\n                    this.scheduleRenewal(5_000);\n            });\n        }, delayMs);\n    }\n}\nexport function createActorSessionTransport(options) {\n    return new ActorSessionTransport(options);\n}\nfunction scheduleRefresh(callback, delayMs) {\n    const timer = setTimeout(callback, delayMs);\n    timer.unref?.();\n    return () => clearTimeout(timer);\n}\n", "runtime/session.d.ts": "import type { DurableActorsClientOptions } from \"./settings.js\";\nimport type { ActorRpcTransport } from \"./stub.js\";\nexport interface ActorSession {\n    readonly projectId: string;\n    readonly controlPlaneUrl: string;\n    readonly token: string;\n    readonly expiresAtMs: number;\n}\nexport interface ActorSessionTransportOptions {\n    readonly projectId: string;\n    /** Reauthenticate with your application backend. Throw ActorSessionRejectedError on an explicit denial. */\n    readonly getSession: () => Promise<ActorSession>;\n}\nexport interface ActorSessionTransportDependencies {\n    readonly now?: () => number;\n    readonly createTransport?: (options: DurableActorsClientOptions) => ActorRpcTransport;\n    readonly schedule?: (callback: () => void, delayMs: number) => () => void;\n}\nexport { ActorSessionRejectedError } from \"./errors.js\";\n/**\n * Reuses actor targets and renews runtime-issued sessions through a trusted backend.\n * Sessions require an HTTPS origin (except localhost) and at most 60 seconds of validity.\n * Renewal stops after a minute without invocations; dispose cancels it immediately.\n */\nexport declare class ActorSessionTransport implements ActorRpcTransport {\n    private readonly options;\n    private transport;\n    private expiresAtMs;\n    private lastUsedAt;\n    private pending;\n    private cancel;\n    private closed;\n    private readonly now;\n    private readonly createTransport;\n    private readonly schedule;\n    constructor(options: ActorSessionTransportOptions, dependencies?: ActorSessionTransportDependencies);\n    invoke(actorName: string, actorId: string, method: string, args: readonly unknown[]): Promise<unknown>;\n    dispose(): void;\n    private refresh;\n    private exchange;\n    private validateSession;\n    private scheduleRenewal;\n}\nexport declare function createActorSessionTransport(options: ActorSessionTransportOptions): ActorSessionTransport;\n", "runtime/index.browser.js": "const createActorStub = () => {\n    throw new Error(\"actors must be used on the server\");\n};\nconst createActorTransport = () => {\n    throw new Error(\"actors must be used on the server\");\n};\nconst createActorSessionTransport = () => {\n    throw new Error(\"actors must be used on the server\");\n};\nconst SocketProxy = class {\n    constructor() {\n        throw new Error(\"ActorProxy must be used on the server\");\n    }\n};\nexport { createActorStub, createActorTransport, createActorSessionTransport, SocketProxy };\nexport { ActorInvocationError, ActorSessionRejectedError } from \"./errors.js\";\n", "runtime/index.browser.d.ts": "import type { SocketProxy as ServerProxy } from \"./proxy.js\";\nimport type { createActorSessionTransport as ServerSessionTransport } from \"./session.js\";\nimport type { createActorStub as ServerStub, createActorTransport as ServerTransport } from \"./stub.js\";\ndeclare const createActorStub: typeof ServerStub;\ndeclare const createActorTransport: typeof ServerTransport;\ndeclare const createActorSessionTransport: typeof ServerSessionTransport;\ndeclare const SocketProxy: typeof ServerProxy;\nexport { createActorStub, createActorTransport, createActorSessionTransport, SocketProxy };\nexport { ActorInvocationError, ActorSessionRejectedError } from \"./errors.js\";\nexport type { ActorSession, ActorSessionTransportOptions, ActorSessionTransport } from \"./session.js\";\n", "runtime/index.js": "export { createActorStub, createActorTransport } from \"./stub.js\";\nexport { createActorSessionTransport, ActorSessionRejectedError } from \"./session.js\";\nexport { ActorInvocationError } from \"./errors.js\";\nexport { SocketProxy } from \"./proxy.js\";\n", "runtime/index.d.ts": "export { createActorStub, createActorTransport } from \"./stub.js\";\nexport { createActorSessionTransport, ActorSessionRejectedError } from \"./session.js\";\nexport type { ActorSession, ActorSessionTransportOptions, ActorSessionTransport } from \"./session.js\";\nexport type { ActorRpcTransport, DurableActorsClientOptions } from \"./stub.js\";\nexport { ActorInvocationError } from \"./errors.js\";\nexport { SocketProxy } from \"./proxy.js\";\nexport type { ProxyActor, SocketGrant, SocketProxyDependencies, SocketProxyOptions } from \"./proxy.js\";\n", "runtime/package.json": "{\n  \"private\": true,\n  \"type\": \"module\",\n  \"sideEffects\": false,\n  \"browser\": {\n    \"./index.js\": \"./index.browser.js\"\n  }\n}\n", "runtime/LICENSE.md": "MIT License\n\nCopyright (c) 2026 Terse\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n" };
 //# sourceMappingURL=client-runtime.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"client-runtime.js","sourceRoot":"","sources":["../../src/generated/client-runtime.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAA2B,EAAC,mBAAmB,EAAC,8xDAA8xD,EAAC,qBAAqB,EAAC,wzCAAwzC,EAAC,iBAAiB,EAAC,4iBAA4iB,EAAC,mBAAmB,EAAC,0TAA0T,EAAC,qBAAqB,EAAC,suGAAsuG,EAAC,uBAAuB,EAAC,08BAA08B,EAAC,iBAAiB,EAAC,g9IAAg9I,EAAC,mBAAmB,EAAC,8oDAA8oD,EAAC,sBAAsB,EAAC,ycAAyc,EAAC,wBAAwB,EAAC,+bAA+b,EAAC,mBAAmB,EAAC,+4SAA+4S,EAAC,qBAAqB,EAAC,gmEAAgmE,EAAC,kBAAkB,EAAC,s1JAAs1J,EAAC,oBAAoB,EAAC,w7DAAw7D,EAAC,iBAAiB,EAAC,o9DAAo9D,EAAC,mBAAmB,EAAC,0wBAA0wB,EAAC,0BAA0B,EAAC,ocAAoc,EAAC,4BAA4B,EAAC,scAAsc,EAAC,kBAAkB,EAAC,4KAA4K,EAAC,oBAAoB,EAAC,0WAA0W,EAAC,sBAAsB,EAAC,qJAAqJ,EAAC,oBAAoB,EAAC,ijCAAijC,EAAC,CAAA"}
+{"version":3,"file":"client-runtime.js","sourceRoot":"","sources":["../../src/generated/client-runtime.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAA2B,EAAC,mBAAmB,EAAC,4+DAA4+D,EAAC,qBAAqB,EAAC,uhDAAuhD,EAAC,iBAAiB,EAAC,4iBAA4iB,EAAC,mBAAmB,EAAC,0TAA0T,EAAC,qBAAqB,EAAC,suGAAsuG,EAAC,uBAAuB,EAAC,08BAA08B,EAAC,iBAAiB,EAAC,qzHAAqzH,EAAC,mBAAmB,EAAC,qyDAAqyD,EAAC,sBAAsB,EAAC,ycAAyc,EAAC,wBAAwB,EAAC,+bAA+b,EAAC,mBAAmB,EAAC,svXAAsvX,EAAC,qBAAqB,EAAC,0qEAA0qE,EAAC,kBAAkB,EAAC,s1JAAs1J,EAAC,oBAAoB,EAAC,w7DAAw7D,EAAC,iBAAiB,EAAC,o9DAAo9D,EAAC,mBAAmB,EAAC,0wBAA0wB,EAAC,oBAAoB,EAAC,0rIAA0rI,EAAC,sBAAsB,EAAC,i6DAAi6D,EAAC,0BAA0B,EAAC,0mBAA0mB,EAAC,4BAA4B,EAAC,ixBAAixB,EAAC,kBAAkB,EAAC,sQAAsQ,EAAC,oBAAoB,EAAC,8iBAA8iB,EAAC,sBAAsB,EAAC,qJAAqJ,EAAC,oBAAoB,EAAC,ijCAAijC,EAAC,CAAA"}

package/dist/templates/actor/package.json

@@ -10,7 +10,7 @@
         "check": "tsc --noEmit"
     },
     "dependencies": {
-        "durable-actors": "0.4.6"
+        "durable-actors": "0.5.0"
     },
     "devDependencies": {
         "@types/node": "^22.0.0",

package/dist/templates/ai-chat/package.json

@@ -15,7 +15,7 @@
         "@ai-sdk/react": "^4.0.100",
         "ai": "^7.0.97",
         "express": "^5.2.1",
-        "durable-actors": "0.4.6",
+        "durable-actors": "0.5.0",
         "react": "^19.3.0",
         "react-dom": "^19.3.0"
     },

package/dist/templates/chat/package.json

@@ -12,7 +12,7 @@
     },
     "dependencies": {
         "express": "^5.2.1",
-        "durable-actors": "0.4.6",
+        "durable-actors": "0.5.0",
         "react": "^19.3.0",
         "react-dom": "^19.3.0"
     },

package/dist/templates/documents/package.json

@@ -19,7 +19,7 @@
         "@tiptap/y-tiptap": "^3.0.7",
         "express": "^5.2.1",
         "lib0": "^0.2.117",
-        "durable-actors": "0.4.6",
+        "durable-actors": "0.5.0",
         "react": "^19.3.0",
         "react-dom": "^19.3.0",
         "yjs": "^13.6.32"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "durable-actors",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "description": "Provider-neutral actors for sandbox compute",
   "type": "module",
   "license": "MIT",
@@ -93,7 +93,7 @@
     "vite": "^8.3.0",
     "ws": "^8.18.3",
     "zod": "^4.3.6",
-    "durable-actors-observer": "0.4.6"
+    "durable-actors-observer": "0.5.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",