durable-actors 0.4.2 → 0.4.3

package/dist/generated/client-runtime.js

@@ -1,2 +1,2 @@
-export const runtimeFiles = { "runtime/client.ts": "import { ActorInvocationError, ActorProtocolError } from \"./errors.js\"\nimport { HttpActorHostTransport, isRecord, responseDocument } from \"./http.js\"\nimport type { ActorHostTarget, ActorHostTransport, DirectActorInvocation } from \"./http.js\"\nimport { cloneJson } from \"./json.js\"\nimport type { JsonValue } from \"./json.js\"\nimport {\n    authorizationHeaders,\n    configuredSettings,\n    environmentSettings,\n    projectActorPath,\n    runtimeEnvironment,\n    validateActorComponent,\n    validateOrigin\n} from \"./settings.js\"\nimport type { DurableActorsClientOptions, Environment } from \"./settings.js\"\nimport { LatencyTimeline } from \"./telemetry.js\"\nimport type { TelemetrySink } from \"./telemetry.js\"\n\nconst TARGET_EXPIRATION_SAFETY_MS = 5_000\n\nexport class HttpActorClient {\n    private readonly beforeInvoke: (requestId: string) => void\n    private settingsValue: RemoteActorSettings | undefined\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 = new Map<string, TargetResolution>()\n\n    constructor(options?: DurableActorsClientOptions, dependencies: HttpActorClientDependencies = {}) {\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\n    async invoke(actorName: string, actorId: string, method: string, args: readonly unknown[]): Promise<unknown> {\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        } 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\n    private async direct(\n        target: ActorHostTarget,\n        invocation: DirectActorInvocation,\n        retryAvailable: boolean,\n        timeline: LatencyTimeline\n    ): Promise<unknown> {\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\") throw new ActorInvocationError(reply.code, invocation.requestId, reply.message)\n            this.invalidateTarget(invocation, target)\n            if (reply.type === \"unauthenticated\" && !retryAvailable) {\n                throw new ActorInvocationError(\n                    \"unauthenticated\",\n                    invocation.requestId,\n                    \"actor host rejected the refreshed invocation ticket\"\n                )\n            }\n            if (!retryAvailable)\n                throw new ActorInvocationError(\n                    \"unavailable\",\n                    invocation.requestId,\n                    reply.type === \"not_dispatched\"\n                        ? \"actor host could not be reached before execution\"\n                        : \"actor ownership changed repeatedly before execution\"\n                )\n            const rerouted = await this.target(invocation, timeline)\n            return this.direct(rerouted, invocation, false, timeline)\n        } catch (error) {\n            if (error instanceof ActorInvocationError || error instanceof ActorProtocolError) throw error\n            this.invalidateTarget(invocation, target)\n            const message = error instanceof Error ? error.message : String(error)\n            throw new ActorInvocationError(\n                \"outcome_unknown\",\n                invocation.requestId,\n                `actor-host HTTP request failed after dispatch: ${message}`\n            )\n        }\n    }\n\n    private invalidateTarget(invocation: ActorAddress, target: ActorHostTarget): void {\n        const key = actorKey(invocation.actorName, invocation.actorId)\n        const current = this.targets.get(key)\n        if (current?.target === target) this.targets.delete(key)\n    }\n\n    protected async target(invocation: ActorAddress, timeline: LatencyTimeline): Promise<ActorHostTarget> {\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) return this.target(invocation, timeline)\n            if (target.expiresAtMs > this.now() + TARGET_EXPIRATION_SAFETY_MS) return target\n            this.targets.delete(key)\n        }\n        const resolving: TargetResolution = {\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) this.targets.delete(key)\n                    throw error\n                })\n        }\n        this.targets.set(key, resolving)\n        return resolving.promise\n    }\n\n    private async resolveTarget(invocation: ActorAddress): Promise<ActorHostTarget> {\n        let response: 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        } catch (error) {\n            const message = error instanceof Error ? error.message : String(error)\n            throw new ActorInvocationError(\n                \"unavailable\",\n                invocation.requestId,\n                `control-plane HTTP request failed before dispatch: ${message}`\n            )\n        }\n        const document = await responseDocument(response)\n        if (!response.ok) this.throwResponseFailure(response, document, invocation.requestId)\n        if (\n            !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        )\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\n    private throwResponseFailure(response: Response, document: unknown, requestId: string): never {\n        if (response.status === 401 || response.status === 403)\n            throw new ActorInvocationError(\n                \"unauthenticated\",\n                requestId,\n                \"the durable-actors application credential was rejected\"\n            )\n        const failure = isRecord(document) ? document.error : undefined\n        if (\n            !isRecord(failure) ||\n            typeof failure.code !== \"string\" ||\n            !failure.code ||\n            typeof failure.message !== \"string\"\n        )\n            throw new ActorProtocolError(`control-plane HTTP ${response.status} response did not contain a valid error`)\n        throw new ActorInvocationError(\n            failure.code,\n            typeof failure.requestId === \"string\" ? failure.requestId : requestId,\n            failure.message\n        )\n    }\n\n    private invocation(\n        requestId: string,\n        actorName: string,\n        actorId: string,\n        method: string,\n        args: readonly unknown[]\n    ): DirectActorInvocation {\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\n    protected get settings(): RemoteActorSettings {\n        if (this.settingsValue !== undefined) return this.settingsValue\n        this.settingsValue = configuredSettings(environmentSettings(this.environment))\n        return this.settingsValue\n    }\n\n    private jsonArguments(args: readonly unknown[]): readonly JsonValue[] {\n        const value = cloneJson(args, \"actor arguments\")\n        if (!Array.isArray(value)) throw new ActorProtocolError(\"actor arguments must be a JSON array\")\n        return value\n    }\n}\n\nfunction targetUrl(settings: RemoteActorSettings, actorName: string, actorId: string): string {\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}\n\nfunction actorKey(actorName: string, actorId: string): string {\n    return `${actorName}\\u001f${actorId}`\n}\nfunction positiveInteger(value: unknown): value is number {\n    return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0\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/errors.ts": "class ActorConfigurationError extends Error {\n    constructor(message: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"ActorConfigurationError\"\n    }\n}\n\nclass ActorDefinitionError extends Error {\n    constructor(message: string) {\n        super(message)\n        this.name = \"ActorDefinitionError\"\n    }\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    readonly code: string\n    /** Identifies this caller attempt; it is not an application idempotency key. */\n    readonly requestId: string\n\n    constructor(code: string, requestId: string, message: string) {\n        super(message)\n        this.name = \"ActorInvocationError\"\n        this.code = code\n        this.requestId = requestId\n    }\n}\n\nclass ActorSessionError extends Error {\n    constructor(message: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"ActorSessionError\"\n    }\n}\n\nclass ActorProtocolError extends Error {\n    constructor(message: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"ActorProtocolError\"\n    }\n}\n\nclass ActorSerializationError extends Error {\n    constructor(message: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"ActorSerializationError\"\n    }\n}\n\nclass ActorValidationError extends Error {\n    constructor(message: string) {\n        super(message)\n        this.name = \"ActorValidationError\"\n    }\n}\n\nexport {\n    ActorConfigurationError,\n    ActorDefinitionError,\n    ActorInvocationError,\n    ActorProtocolError,\n    ActorSerializationError,\n    ActorSessionError,\n    ActorValidationError\n}\n\nfunction errorMessage(error: unknown): string {\n    return error instanceof Error ? error.message : String(error)\n}\n\nexport { errorMessage }\n", "runtime/http.ts": "import { ActorProtocolError } from \"./errors.js\"\nimport type { JsonValue } from \"./json.js\"\nimport { projectActorPath, validateOrigin } from \"./settings.js\"\n\nexport class HttpActorHostTransport implements ActorHostTransport {\n    constructor(private readonly fetchRequest: typeof globalThis.fetch = globalThis.fetch) {}\n\n    async invoke(target: ActorHostTarget, invocation: DirectActorInvocation): Promise<ActorHostReply> {\n        let response: 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        } catch (error) {\n            if (connectionRefused(error)) 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) return { type: \"unauthenticated\" }\n        if (!response.ok) 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 (\n                reply.type === \"failed\" &&\n                typeof reply.code === \"string\" &&\n                reply.code.length > 0 &&\n                typeof reply.message === \"string\"\n            )\n                return { type: \"failed\", code: reply.code, message: reply.message }\n            if (reply.type === \"reroute\") return { type: \"reroute\" }\n        }\n        throw new ActorProtocolError(\"actor host response did not contain a valid outcome\")\n    }\n\n    async publish(target: ActorHostTarget, actor: ActorAddress, effects: readonly unknown[]): Promise<void> {\n        const response = await this.post(target, actor, \"socket-effects\", { ownerEpoch: target.ownerEpoch, effects })\n        if (!response.ok) throw new Error(`socket effects returned HTTP ${response.status}`)\n    }\n\n    private post(target: ActorHostTarget, actor: ActorAddress, endpoint: string, body: unknown): Promise<Response> {\n        return this.fetchRequest(\n            `${validateOrigin(target.route)}${projectActorPath(actor.projectId, actor.actorName, actor.actorId)}/${endpoint}`,\n            {\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    }\n}\n\nfunction connectionRefused(error: unknown, ancestors = new Set<unknown>()): boolean {\n    if (!isRecord(error) || ancestors.has(error)) return false\n    const visited = new Set(ancestors).add(error)\n    if (error.code !== undefined && error.code !== \"ECONNREFUSED\") return false\n    if (error.errors !== undefined)\n        return (\n            Array.isArray(error.errors) &&\n            error.errors.length > 0 &&\n            error.errors.every(cause => connectionRefused(cause, visited))\n        )\n    if (error.code === \"ECONNREFUSED\") return error.syscall === \"connect\"\n    return connectionRefused(error.cause, visited)\n}\n\nexport async function responseDocument(response: Response): Promise<unknown> {\n    try {\n        return await response.json()\n    } catch (error) {\n        throw new ActorProtocolError(`HTTP ${response.status} response was not valid JSON`, { cause: error })\n    }\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value)\n}\n\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\"; readonly result: unknown }\n    | { readonly type: \"failed\"; readonly code: string; readonly message: string }\n    | { readonly type: \"reroute\" }\n    | { readonly type: \"unauthenticated\" }\n    | { readonly type: \"not_dispatched\" }\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/index.browser.ts": "import type { SocketProxy as ServerProxy } from \"./proxy.js\"\nimport type { createActorStub as ServerStub, createActorTransport as ServerTransport } from \"./stub.js\"\n\nconst createActorStub: typeof ServerStub = () => {\n    throw new Error(\"actors must be used on the server\")\n}\n\nconst createActorTransport: typeof ServerTransport = () => {\n    throw new Error(\"actors must be used on the server\")\n}\n\nconst SocketProxy = class {\n    constructor() {\n        throw new Error(\"ActorProxy must be used on the server\")\n    }\n} as unknown as typeof ServerProxy\n\nexport { createActorStub, createActorTransport, SocketProxy }\nexport { ActorInvocationError } from \"./errors.js\"\n", "runtime/index.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/json.ts": "import { ActorSerializationError } from \"./errors.js\"\n\ntype JsonPrimitive = string | number | boolean | null\ntype JsonObject = { readonly [key: string]: JsonValue }\ntype JsonValue = JsonPrimitive | JsonObject | readonly JsonValue[]\n\nfunction cloneJson(value: unknown, label: string): JsonValue {\n    try {\n        const encoded = JSON.stringify(value)\n        if (encoded === undefined) throw new ActorSerializationError(`${label} must be JSON serializable`)\n        return JSON.parse(encoded) as JsonValue\n    } catch (error) {\n        if (error instanceof ActorSerializationError) throw error\n        throw new ActorSerializationError(`${label} must be JSON serializable`, { cause: error })\n    }\n}\n\nexport { cloneJson }\nexport type { JsonValue }\n", "runtime/proxy.ts": "import { ActorProtocolError, ActorSerializationError, ActorValidationError } from \"./errors.js\"\nimport { isRecord } from \"./http.js\"\nimport {\n    authorizationHeaders,\n    configuredSettings,\n    environmentSettings,\n    projectActorPath,\n    validateActorComponent\n} from \"./settings.js\"\n\n/** 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}\n\ninterface SocketProxyDependencies {\n    readonly fetch?: typeof globalThis.fetch\n}\n\ninterface ProxyActor<Metadata = unknown> {\n    readonly types?: Metadata\n}\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\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\n/** Issues browser connection URLs from your backend. */\nclass SocketProxy<Actors extends Record<string, ProxyActor>> {\n    private readonly projectId: string\n    private readonly origin: string\n    private readonly apiKey: string | undefined\n    private readonly setupTimeoutMs: number\n    private readonly fetchRequest: typeof globalThis.fetch\n\n    constructor(\n        private readonly actors: Actors,\n        options: SocketProxyOptions = {},\n        dependencies: SocketProxyDependencies = {}\n    ) {\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    /**\n     * Call after authenticating the user and checking actor access.\n     * Pass `websocketUrl` to the browser's `new WebSocket()`.\n     */\n    async handle(authorization: SocketAuthorization<Actors>): Promise<SocketGrant> {\n        const actorName = validateActorComponent(\"actor name\", authorization.actorName)\n        const actorId = validateActorComponent(\"actor ID\", authorization.actorId)\n        if (!Object.hasOwn(this.actors, actorName)) throw new Error(`Unknown actor name: ${actorName}`)\n        const metadata = socketMetadata(authorization.metadata)\n        const authorizationLifetimeMs = authorization.authorizationLifetimeMs ?? 900000\n        if (\n            !Number.isSafeInteger(authorizationLifetimeMs) ||\n            authorizationLifetimeMs < 1000 ||\n            authorizationLifetimeMs > 86400000\n        )\n            throw new Error(\"Socket authorization lifetime must be between one second and one day\")\n        const homeRegion =\n            authorization.homeRegion === undefined\n                ? undefined\n                : validateActorComponent(\"home region\", authorization.homeRegion)\n        const response = await this.fetchRequest(\n            `${this.origin}${projectActorPath(this.projectId, actorName, actorId)}/find-websocket`,\n            {\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        )\n        if (!response.ok) throw new Error(`WebSocket authorization could not be issued (HTTP ${response.status})`)\n        return socketGrant(await response.json())\n    }\n}\n\nfunction proxySettings(options: SocketProxyOptions) {\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}\n\nexport { SocketProxy }\nexport type { ProxyActor, SocketAuthorization, SocketGrant, SocketProxyDependencies, SocketProxyOptions }\n\nfunction socketGrant(value: unknown): SocketGrant {\n    if (\n        !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    )\n        throw new ActorProtocolError(\"invalid WebSocket authorization response\")\n    return {\n        websocketUrl: value.websocketUrl,\n        homeRegion: value.homeRegion,\n        connectByMs: value.connectByMs as number,\n        authorizedUntilMs: value.authorizedUntilMs as number\n    }\n}\n\nfunction socketMetadata(value: unknown): unknown {\n    let encoded: string\n    try {\n        encoded = JSON.stringify(value)\n        if (!isJsonValue(value)) throw new Error(\"invalid JSON value\")\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}\n\nfunction isJsonValue(value: unknown): boolean {\n    if (value === null || typeof value === \"string\" || typeof value === \"boolean\") return true\n    if (typeof value === \"number\") return Number.isFinite(value)\n    if (Array.isArray(value)) return Array.from(value).every(isJsonValue)\n    return (\n        isRecord(value) &&\n        [Object.prototype, null].includes(Object.getPrototypeOf(value)) &&\n        Object.values(value).every(isJsonValue)\n    )\n}\n", "runtime/settings.ts": "import { ActorConfigurationError, ActorValidationError } from \"./errors.js\"\n\nexport interface DurableActorsClientOptions {\n    readonly projectId?: string\n    readonly apiKey?: string\n    readonly homeRegion?: string\n    readonly controlPlaneUrl: string\n}\n\nexport type Environment = Record<string, string | undefined>\n\nexport function configuredSettings(value: unknown) {\n    if (\n        typeof value !== \"object\" ||\n        value === null ||\n        Array.isArray(value) ||\n        Object.keys(value).some(key => ![\"projectId\", \"apiKey\", \"homeRegion\", \"controlPlaneUrl\"].includes(key))\n    )\n        throw new ActorConfigurationError(\"durable-actors client settings are invalid\")\n    const options = value as DurableActorsClientOptions\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(\n            \"durable-actors client settings are invalid: a valid projectId is required for remote connections\"\n        )\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) validateActorComponent(\"home region\", options.homeRegion)\n    return { projectId, credential: options.apiKey?.trim(), homeRegion: options.homeRegion, controlPlaneUrl }\n}\n\nexport function environmentSettings(environment: Environment = runtimeEnvironment()): DurableActorsClientOptions {\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}\n\nexport function runtimeEnvironment(): Environment {\n    return (globalThis as typeof globalThis & { process?: { env?: Environment } }).process?.env ?? {}\n}\n\nexport function validateOrigin(origin: string): string {\n    let url: URL\n    try {\n        url = new URL(origin)\n    } catch (error) {\n        throw new ActorConfigurationError(`actor HTTP origin is invalid: ${origin}`, { cause: error })\n    }\n    if (\n        !/^https?:$/u.test(url.protocol) ||\n        !url.hostname ||\n        url.username ||\n        url.password ||\n        url.pathname !== \"/\" ||\n        url.search ||\n        url.hash\n    )\n        throw new ActorConfigurationError(`actor URL must be an HTTP or HTTPS origin: ${origin}`)\n    return url.origin\n}\n\nexport function validateActorComponent(name: string, value: string): string {\n    if (typeof value !== \"string\" || !/^[A-Za-z0-9._-]+$/u.test(value) || value === \".\" || value === \"..\")\n        throw new ActorValidationError(\n            `${name} may contain only ASCII letters, digits, '.', '-', and '_' and must not be a path segment`\n        )\n    return value\n}\n\nexport function projectActorPath(projectId: string, actorName: string, actorId: string): string {\n    return `/v1/projects/${encodeURIComponent(validateActorComponent(\"project ID\", projectId))}/actors/${encodeURIComponent(validateActorComponent(\"actor name\", actorName))}/${encodeURIComponent(validateActorComponent(\"actor ID\", actorId))}`\n}\n\nexport function authorizationHeaders(credential: string | undefined): Record<string, string> {\n    return credential === undefined ? {} : { authorization: `Bearer ${credential}` }\n}\n", "runtime/stub.ts": "import { HttpActorClient } from \"./client.js\"\nimport { ActorDefinitionError, ActorSerializationError } from \"./errors.js\"\nimport { validateActorComponent } from \"./settings.js\"\nimport type { DurableActorsClientOptions } from \"./settings.js\"\n\ninterface ActorRpcTransport {\n    invoke(actorName: string, actorId: string, method: string, args: readonly unknown[]): Promise<unknown>\n}\n\ninterface ActorRpcMethod {\n    readonly name: string\n    readonly result: \"void\" | \"value\"\n}\n\n/** Creates a backend client from generated method definitions. */\nfunction createActorStub<Stub extends object>(\n    actorName: string,\n    actorId: string,\n    methods: readonly ActorRpcMethod[],\n    transport?: ActorRpcTransport\n): Stub {\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: unknown[]) => {\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 as Stub\n}\n\nexport { createActorStub }\nexport type { ActorRpcMethod, ActorRpcTransport }\n\nlet shared: ActorRpcTransport | undefined\nexport function createActorTransport(options: DurableActorsClientOptions): ActorRpcTransport {\n    return new HttpActorClient(options)\n}\n\nfunction defaultTransport(): ActorRpcTransport {\n    return (shared ??= new HttpActorClient())\n}\nexport type { DurableActorsClientOptions }\n\nfunction invocationArguments(args: readonly unknown[]): readonly unknown[] {\n    let end = args.length\n    while (end > 0 && args[end - 1] === undefined) 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/telemetry.ts": "type TelemetryEvent = Record<string, boolean | number | string | undefined>\ntype TelemetrySink = (event: TelemetryEvent) => void\n\nclass LatencyTimeline {\n    private readonly origin: number\n    private readonly milestones: Record<string, number> = { started_at_ms: 0 }\n\n    constructor(private readonly now: () => number = () => performance.now()) {\n        this.origin = this.now()\n    }\n\n    mark(name: string): void {\n        this.milestones[`${name}_at_ms`] = Math.max(0, Math.round(this.now() - this.origin))\n    }\n\n    finish(): Record<string, number> {\n        this.mark(\"completed\")\n        return { ...this.milestones }\n    }\n}\n\nexport { LatencyTimeline }\nexport type { TelemetryEvent, TelemetrySink }\n", "runtime/package.json": "{\n  \"private\": true,\n  \"type\": \"module\",\n  \"sideEffects\": false,\n  \"browser\": {\n    \"./index.ts\": \"./index.browser.ts\",\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}\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        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    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 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" };
 //# 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,ozXAAozX,EAAC,mBAAmB,EAAC,w/DAAw/D,EAAC,iBAAiB,EAAC,u5JAAu5J,EAAC,0BAA0B,EAAC,2rBAA2rB,EAAC,kBAAkB,EAAC,qWAAqW,EAAC,iBAAiB,EAAC,owBAAowB,EAAC,kBAAkB,EAAC,mjNAAmjN,EAAC,qBAAqB,EAAC,+yHAA+yH,EAAC,iBAAiB,EAAC,mmFAAmmF,EAAC,sBAAsB,EAAC,kuBAAkuB,EAAC,sBAAsB,EAAC,kMAAkM,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,8xDAA8xD,EAAC,qBAAqB,EAAC,wzCAAwzC,EAAC,iBAAiB,EAAC,4iBAA4iB,EAAC,mBAAmB,EAAC,0TAA0T,EAAC,qBAAqB,EAAC,suGAAsuG,EAAC,uBAAuB,EAAC,08BAA08B,EAAC,iBAAiB,EAAC,gjHAAgjH,EAAC,mBAAmB,EAAC,2nDAA2nD,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"}

package/dist/localRuntime.d.ts

@@ -1,5 +1,8 @@
 import { z } from "zod";
+export { runDev, type DevOptions } from "./cli/dev.js";
 export interface LocalActorOptions {
+    /** Module URL from which to resolve the SDK dependency when embedded in a wrapper. */
+    sdkResolveFrom?: string;
     projectId?: string;
     /** Enables local authentication when set; omitted by default. */
     apiKey?: string;
@@ -31,5 +34,4 @@ export interface LocalActorRuntime {
 }
 /** Starts a local server and waits until ready. */
 export declare function startLocalActors(options: LocalActorOptions): Promise<LocalActorRuntime>;
-export {};
 //# sourceMappingURL=localRuntime.d.ts.map

package/dist/localRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localRuntime.d.ts","sourceRoot":"","sources":["../src/localRuntime.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,MAAM,WAAW,iBAAiB;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,QAAA,MAAM,gBAAgB;;;;;;iBAUpB,CAAA;AAEF,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;IAC5C,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,8CAA8C;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED,mDAAmD;AACnD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkB7F"}
+{"version":3,"file":"localRuntime.d.ts","sourceRoot":"","sources":["../src/localRuntime.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAEtD,MAAM,WAAW,iBAAiB;IAC9B,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,QAAA,MAAM,gBAAgB;;;;;;iBAUpB,CAAA;AAEF,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;IAC5C,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,8CAA8C;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED,mDAAmD;AACnD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkB7F"}

package/dist/localRuntime.js

@@ -7,6 +7,7 @@ import { validateProjectId } from "./actor/identity.js";
 import { actorEnvironment } from "./environment.js";
 import { projectSdkModule } from "./projectSdk.js";
 import { fetchRuntimeExecutablePath } from "./runtimeInstaller.js";
+export { runDev } from "./cli/dev.js";
 const connectionSchema = z.object({
     projectId: z.string().min(1),
     controlPlaneUrl: z.string().url(),
@@ -23,7 +24,7 @@ export async function startLocalActors(options) {
     if (options.projectId !== undefined)
         validateProjectId(options.projectId);
     const project = path.resolve(options.project ?? ".");
-    const local = await projectSdkModule(project, "./localRuntime.js", import.meta.url);
+    const local = await projectSdkModule(project, "./localRuntime.js", import.meta.url, options.sdkResolveFrom);
     if (local !== undefined)
         return (await import(local)).startLocalActors({ ...options, project });
     const child = launch(await fetchRuntimeExecutablePath(), options);

package/dist/localRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"localRuntime.js","sourceRoot":"","sources":["../src/localRuntime.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAqB,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AAkBlE,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACjC,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,EAAE;SACT,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,SAAS,CAAC;IAC3C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAA;AAWF,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA0B;IAC7D,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACzE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC,CAAA;IACpD,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACnF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IAC/F,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,0BAA0B,EAAE,EAAE,OAAO,CAAC,CAAA;IACjE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;IACzC,IAAI,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,iBAAiB,CACtC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAa,EAC1B,MAAM,EACN,OAAO,CAAC,gBAAgB,IAAI,OAAO,CACtC,CAAA;QACD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC5B,MAAM,KAAK,CAAA;IACf,CAAC;AACL,CAAC;AAED,SAAS,MAAM,CAAC,UAAkB,EAAE,OAA0B;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC,CAAA;IACpD,OAAO,KAAK,CACR,UAAU,EACV;QACI,KAAK;QACL,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/E,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACtE,WAAW;QACX,OAAO;QACP,cAAc;QACd,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC;QACzC,YAAY;QACZ,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,iBAAiB,CAAC;QAC3D,QAAQ;QACR,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;QACzB,YAAY;QACZ,GAAG;QACH,YAAY;QACZ,aAAa,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;KACvD,EACD;QACI,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE;YACD,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC;YAChC,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE;YAC/H,2BAA2B,EAAE,eAAe;YAC5C,oCAAoC,EAAE,GAAG;SAC5C;QACD,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC;KACtG,CACJ,CAAA;AACL,CAAC;AAED,SAAS,SAAS,CAAC,KAAmB;IAClC,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACjD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC3B,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAChC,IAAI,IAAI,KAAK,CAAC,IAAI,QAAQ;gBAAE,OAAO,EAAE,CAAA;;gBAChC,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,MAAM,IAAI,IAAI,GAAG,CAAC,CAAC,CAAA;QACrE,CAAC,CAAC,CAAA;IACN,CAAC,CAAC,CAAA;IACF,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAC3B,IAAI,OAAkC,CAAA;IACtC,MAAM,IAAI,GAAG,GAAG,EAAE,CACd,CAAC,OAAO,KAAK,CAAC,KAAK,IAAI,EAAE;QACrB,QAAQ,GAAG,IAAI,CAAA;QACf,KAAK,CAAC,KAAM,CAAC,GAAG,EAAE,CAAA;QAClB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAA;QAC7D,IAAI,CAAC;YACD,MAAM,MAAM,CAAA;QAChB,CAAC;gBAAS,CAAC;YACP,YAAY,CAAC,KAAK,CAAC,CAAA;QACvB,CAAC;IACL,CAAC,CAAC,EAAE,CAAC,CAAA;IACT,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;AAC3B,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,SAAmB,EAAE,MAAqB,EAAE,SAAiB;IAC1F,IAAI,KAAgD,CAAA;IACpD,IAAI,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAClC,cAAc,CAAC,SAAS,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;gBACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;YAC3D,CAAC,CAAC;YACF,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAC7B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;YAC5F,CAAC,CAAC;SACL,CAAC,CAAA;QACF,OAAO,UAAU,CAAA;IACrB,CAAC;YAAS,CAAC;QACP,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,SAAS,CAAC,OAAO,EAAE,CAAA;IACvB,CAAC;AACL,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,MAAgB;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IACjE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IAC7F,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;AACrF,CAAC"}
+{"version":3,"file":"localRuntime.js","sourceRoot":"","sources":["../src/localRuntime.ts"],"names":[],"mappings":"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"}

package/dist/projectSdk.d.ts

@@ -1,2 +1,2 @@
-export declare function projectSdkModule(project: string, entrypoint: string, caller: string): Promise<string | undefined>;
+export declare function projectSdkModule(project: string, entrypoint: string, caller: string, sdkResolveFrom?: string): Promise<string | undefined>;
 //# sourceMappingURL=projectSdk.d.ts.map

package/dist/projectSdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projectSdk.d.ts","sourceRoot":"","sources":["../src/projectSdk.ts"],"names":[],"mappings":"AAKA,wBAAsB,gBAAgB,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B"}
+{"version":3,"file":"projectSdk.d.ts","sourceRoot":"","sources":["../src/projectSdk.ts"],"names":[],"mappings":"AAKA,wBAAsB,gBAAgB,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B"}

package/dist/projectSdk.js

@@ -2,10 +2,10 @@ import { resolve } from "import-meta-resolve";
 import { realpath } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-export async function projectSdkModule(project, entrypoint, caller) {
+export async function projectSdkModule(project, entrypoint, caller, sdkResolveFrom) {
     let target;
     try {
-        const parent = pathToFileURL(path.resolve(project, "package.json")).href;
+        const parent = sdkResolveFrom ?? pathToFileURL(path.resolve(project, "package.json")).href;
         const host = resolve("durable-actors/host", parent);
         target = await realpath(fileURLToPath(new URL(entrypoint, host)));
     }

package/dist/projectSdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"projectSdk.js","sourceRoot":"","sources":["../src/projectSdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAEvD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,OAAe,EACf,UAAkB,EAClB,MAAc;IAEd,IAAI,MAAc,CAAA;IAClB,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAA;QACxE,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;QACnD,MAAM,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,0CAA0C,EAAE;YACxG,KAAK;SACR,CAAC,CAAA;IACN,CAAC;IACD,OAAO,MAAM,KAAK,CAAC,MAAM,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAA;AACtG,CAAC"}
+{"version":3,"file":"projectSdk.js","sourceRoot":"","sources":["../src/projectSdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAEvD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,OAAe,EACf,UAAkB,EAClB,MAAc,EACd,cAAuB;IAEvB,IAAI,MAAc,CAAA;IAClB,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,cAAc,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAA;QAC1F,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;QACnD,MAAM,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,0CAA0C,EAAE;YACxG,KAAK;SACR,CAAC,CAAA;IACN,CAAC;IACD,OAAO,MAAM,KAAK,CAAC,MAAM,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAA;AACtG,CAAC"}

package/dist/templates/actor/package.json

@@ -10,7 +10,7 @@
         "check": "tsc --noEmit"
     },
     "dependencies": {
-        "durable-actors": "0.4.2"
+        "durable-actors": "0.4.3"
     },
     "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.2",
+        "durable-actors": "0.4.3",
         "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.2",
+        "durable-actors": "0.4.3",
         "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.2",
+        "durable-actors": "0.4.3",
         "react": "^19.3.0",
         "react-dom": "^19.3.0",
         "yjs": "^13.6.32"

package/dist/wire/public-contract.d.ts

@@ -3,6 +3,11 @@ import type { SocketContract } from "./contract.js";
 interface PublicActorContract {
     readonly version: 1;
     readonly actors: readonly ActorApi[];
+    readonly typescript: TypeScriptContract;
+}
+interface TypeScriptContract {
+    readonly declarations: string;
+    readonly dependencies: Readonly<Record<string, string>>;
 }
 interface ActorApi {
     readonly actorName: string;
@@ -32,5 +37,5 @@ interface RpcParameter {
 interface TypeReference {
     readonly $ref: string;
 }
-export type { ActorApi, TypeReference, PublicActorContract, RpcContract, RpcMethod, RpcParameter };
+export type { ActorApi, TypeReference, PublicActorContract, RpcContract, RpcMethod, RpcParameter, TypeScriptContract };
 //# sourceMappingURL=public-contract.d.ts.map

package/dist/wire/public-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-contract.d.ts","sourceRoot":"","sources":["../../src/wire/public-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,UAAU,mBAAmB;IACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAA;CACvC;AAED,UAAU,QAAQ;IACd,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;CAC5B;AAED,UAAU,WAAW;IACjB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAA;CACzC;AAED,UAAU,SAAS;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAA;IAC5C,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;KAAE,CAAA;CACxG;AAED,UAAU,YAAY;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAC/B;AAED,UAAU,aAAa;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACxB;AAED,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"public-contract.d.ts","sourceRoot":"","sources":["../../src/wire/public-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,UAAU,mBAAmB;IACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;CAC1C;AAED,UAAU,kBAAkB;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAC1D;AAED,UAAU,QAAQ;IACd,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;CAC5B;AAED,UAAU,WAAW;IACjB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAA;CACzC;AAED,UAAU,SAAS;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAA;IAC5C,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;KAAE,CAAA;CACxG;AAED,UAAU,YAAY;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAC/B;AAED,UAAU,aAAa;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACxB;AAED,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "durable-actors",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Provider-neutral actors for sandbox compute",
   "type": "module",
   "license": "MIT",
@@ -64,9 +64,9 @@
       "default": "./dist/compiler/actor-compiler.js"
     },
     "./codegen": {
-      "types": "./dist/compiler/generators/typescript-generator.d.ts",
-      "import": "./dist/compiler/generators/typescript-generator.js",
-      "default": "./dist/compiler/generators/typescript-generator.js"
+      "types": "./dist/compiler/generators/client-artifacts.d.ts",
+      "import": "./dist/compiler/generators/client-artifacts.js",
+      "default": "./dist/compiler/generators/client-artifacts.js"
     }
   },
   "files": [
@@ -81,9 +81,9 @@
     "chokidar": "^4.0.3",
     "commander": "^14.0.3",
     "dotenv": "^18.0.0",
+    "dts-bundle-generator": "9.5.1",
     "esbuild": "^0.28.2",
     "import-meta-resolve": "^4.2.0",
-    "json-schema-to-typescript": "^16.0.0",
     "open": "^10.2.0",
     "prettier": "^3.9.6",
     "tar": "^7.5.22",
@@ -93,7 +93,7 @@
     "vite": "^8.3.0",
     "ws": "^8.18.3",
     "zod": "^4.3.6",
-    "durable-actors-observer": "0.4.2"
+    "durable-actors-observer": "0.4.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/dist/compiler/generators/typescript-generator.d.ts

@@ -1,8 +0,0 @@
-import type { SocketContract } from "../../wire/contract.js";
-import type { PublicActorContract } from "../../wire/public-contract.js";
-/** Returns the typed client and its standalone runtime without writing files or executing actor code. */
-declare function generateTypeScript(input: readonly SocketContract[] | PublicActorContract): Promise<ReadonlyMap<string, string>>;
-export { generateTypeScript };
-export type { SocketContract };
-export type { PublicActorContract };
-//# sourceMappingURL=typescript-generator.d.ts.map

package/dist/compiler/generators/typescript-generator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"typescript-generator.d.ts","sourceRoot":"","sources":["../../../src/compiler/generators/typescript-generator.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAMxE,yGAAyG;AACzG,iBAAe,kBAAkB,CAC7B,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,mBAAmB,GACvD,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqCtC;AA6ID,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAC7B,YAAY,EAAE,cAAc,EAAE,CAAA;AAC9B,YAAY,EAAE,mBAAmB,EAAE,CAAA"}

package/dist/compiler/generators/typescript-generator.js

@@ -1,157 +0,0 @@
-import { compile } from "json-schema-to-typescript";
-import { format } from "prettier";
-import ts from "typescript";
-import { runtimeFiles } from "../../generated/client-runtime.js";
-import { parsePublicContract } from "../validate-public-contract.js";
-import { backendSource } from "./backend-generator.js";
-import { usageComment } from "./usage-comment.js";
-/** Returns the typed client and its standalone runtime without writing files or executing actor code. */
-async function generateTypeScript(input) {
-    const document = "actors" in input ? input : undefined;
-    if (document && document.version !== 1)
-        throw new Error(`unsupported public actor contract version ${document.version}`);
-    if (document)
-        parsePublicContract(document);
-    const contracts = "actors" in input ? input.actors.map(actor => actor.socket) : input;
-    const declarations = [];
-    const wireNames = new Map();
-    for (const contract of contracts) {
-        if (!/^[A-Za-z_$][\w$]*$/u.test(contract.actorName))
-            throw new Error(`actor name ${contract.actorName} cannot be emitted as a TypeScript identifier`);
-        const wire = await wireDeclarations(contract);
-        wireNames.set(contract.actorName, [...wire.names, "Authorization"]);
-        declarations.push(actorDeclarations(contract, wire.code));
-    }
-    const exampleActor = contracts[0]?.actorName;
-    const source = `// Generated by durable-actors; regenerate instead of editing.
-${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"
-export { createActorTransport, ActorInvocationError } 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`)}
-export declare namespace actors {
-${declarations.join("\n")}
-}
-
-${await backendSource(document?.actors ?? [], contracts, wireNames)}
-${proxySource(contracts)}`;
-    const formatted = await format(source, {
-        parser: "typescript",
-        tabWidth: 4,
-        printWidth: 120,
-        semi: false,
-        trailingComma: "none"
-    });
-    return new Map([["index.ts", formatted], ...Object.entries(runtimeFiles)]);
-}
-function actorDeclarations(contract, declarations) {
-    return `export namespace ${contract.actorName} {
-${declarations}
-export interface Authorization {
-    actorName: ${JSON.stringify(contract.actorName)}
-    actorId: string
-    metadata: Metadata
-    clientLocation?: { latitude: number; longitude: number }
-    authorizationLifetimeMs?: number
-}
-}`;
-}
-async function wireDeclarations(contract) {
-    const kinds = ["Metadata", "Incoming", "Outgoing", "State"];
-    const properties = Object.fromEntries(kinds.map(kind => [
-        kind.toLowerCase(),
-        typeof contract.schema.definitions?.[kind] === "boolean"
-            ? contract.schema.definitions[kind]
-            : { $ref: `#/definitions/${kind}` }
-    ]));
-    const code = await compile(inlineAnonymousReferences({
-        ...contract.schema,
-        type: "object",
-        additionalProperties: false,
-        properties,
-        required: Object.keys(properties)
-    }, contract.schema.definitions ?? {}), "ActorTypes", {
-        $refOptions: { resolve: { file: false, http: false } },
-        bannerComment: "",
-        unknownAny: true,
-        additionalProperties: false,
-        customName: (schema, key) => {
-            const name = schema.title || schema.$id || key;
-            return (schema.title && kinds.includes(name)) ||
-                ["Connection", "Authorization", "Methods", "Parameters", "ReturnType", "Awaited"].includes(name)
-                ? `${name}Data`
-                : undefined;
-        }
-    });
-    const source = ts.createSourceFile("types.ts", code, ts.ScriptTarget.Latest, true);
-    const root = source.statements.find(statement => ts.isInterfaceDeclaration(statement) && statement.name.text === "ActorTypes");
-    const declarations = source.statements.filter(statement => statement !== root);
-    const named = new Map(declarations
-        .filter((statement) => ts.isInterfaceDeclaration(statement) || ts.isTypeAliasDeclaration(statement))
-        .map(statement => [statement.name.text, statement]));
-    const main = kinds.map(kind => {
-        const declaration = named.get(kind);
-        if (declaration)
-            return declaration.getText(source);
-        const property = root.members.find(member => ts.isPropertySignature(member) && member.name.getText(source) === kind.toLowerCase());
-        return `export type ${kind} = ${property.type.getText(source)}`;
-    });
-    const helpers = declarations.filter(statement => !kinds.some(kind => named.get(kind) === statement));
-    return {
-        code: [...main, ...helpers.map(statement => statement.getText(source))].join("\n\n") + "\n",
-        names: [...new Set([...kinds, ...named.keys()])]
-    };
-}
-function inlineAnonymousReferences(value, definitions, visiting = new Set()) {
-    if (Array.isArray(value))
-        return value.map(item => inlineAnonymousReferences(item, definitions, visiting));
-    if (!value || typeof value !== "object")
-        return value;
-    const node = value;
-    const key = typeof node.$ref === "string" && node.$ref.startsWith("#/definitions/")
-        ? decodeURIComponent(node.$ref.slice("#/definitions/".length)).replaceAll("~1", "/").replaceAll("~0", "~")
-        : undefined;
-    const definition = key === undefined ? undefined : definitions[key];
-    if (key !== undefined &&
-        definition &&
-        typeof definition === "object" &&
-        !definition.title &&
-        !visiting.has(key) &&
-        (/^(Type\d+|Field_.*)$/.test(key) ||
-            (typeof definition.type === "string" &&
-                ["string", "number", "integer", "boolean", "null"].includes(definition.type)))) {
-        const { $ref, ...rest } = node;
-        return inlineAnonymousReferences({ ...definition, ...rest }, definitions, new Set([...visiting, key]));
-    }
-    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, inlineAnonymousReferences(child, definitions, visiting)]));
-}
-function proxySource(contracts) {
-    const actors = contracts
-        .map(({ actorName }) => `[${JSON.stringify(actorName)}]: {} as import("./runtime/index.js").ProxyActor<actors.${actorName}.Metadata>`)
-        .join(", ");
-    const authorization = contracts.map(({ actorName }) => `actors.${actorName}.Authorization`).join(" | ") || "never";
-    const exampleActor = contracts[0]?.actorName;
-    return `${usageComment("The actor and connection details approved by your backend.", exampleActor && `const authorization: ActorAuthorization = { actorName: ${JSON.stringify(exampleActor)}, actorId: "actor-id", metadata }`)}
-export type ActorAuthorization = ${authorization}
-
-${usageComment("Allow a frontend connection after your backend checks the user's access.", exampleActor && `const grant = await ActorProxy.handle({ actorName: ${JSON.stringify(exampleActor)}, actorId: "actor-id", metadata })`)}
-export class ActorProxy extends $SocketProxy<{
-${contracts.map(({ actorName }) => `[${JSON.stringify(actorName)}]: import("./runtime/index.js").ProxyActor<actors.${actorName}.Metadata>`).join("\n")}
-}> {
-    constructor(options: import("./runtime/index.js").SocketProxyOptions = {}, dependencies: import("./runtime/index.js").SocketProxyDependencies = {}) {
-        super({ ${actors} }, options, dependencies)
-    }
-
-    handle(authorization: ActorAuthorization): Promise<import("./runtime/index.js").SocketGrant> {
-        return super.handle(authorization)
-    }
-
-    static handle(authorization: ActorAuthorization, options: import("./runtime/index.js").SocketProxyOptions = {}): Promise<import("./runtime/index.js").SocketGrant> {
-        return new ActorProxy(options).handle(authorization)
-    }
-}
-`;
-}
-export { generateTypeScript };
-//# sourceMappingURL=typescript-generator.js.map

package/dist/compiler/generators/typescript-generator.js.map

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