durable-actors 0.2.4

package/LICENSE.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Terse
+
+Permission 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:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE 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.

package/README.md

@@ -0,0 +1,206 @@
+# Durable Actors
+
+Named actors with serial method calls and saved state. Requires Node.js 20.19+ or 22.12+ (matching Vite's runtime requirement). The CLI uses Node.js; actor execution requires Bun 1.4.2+.
+
+## Local development
+
+Install the CLI once with pnpm:
+
+```sh
+pnpm add --global durable-actors
+```
+
+Create a standalone actor project and start its server:
+
+```sh
+durable-actors init my-actors
+cd my-actors
+pnpm install
+durable-actors dev
+```
+
+The project contains a persisted counter in `src/durable-objects.ts`, TypeScript configuration, and scripts to check and build your actors. Keep the actor server running.
+
+In your separate application project's directory, install the SDK:
+
+```sh
+pnpm add durable-actors
+```
+
+Copy the settings printed under **Connect your application** into that application's `.env` file:
+
+```dotenv
+DURABLE_ACTORS_PROJECT_ID=local
+DURABLE_ACTORS_CONTROL_PLANE_URL=http://127.0.0.1:7100
+DURABLE_ACTORS_SECRET='<paste the secret printed by dev>'
+```
+
+Generate the client from your application directory:
+
+```sh
+durable-actors generate
+```
+
+The CLI loads `.env` automatically and fetches the contract from your actor server. Use the generated client in your backend:
+
+```ts
+import { actors } from "./generated/index.js"
+
+const counter = actors.Counter.get("example")
+console.log(await counter.increment())
+```
+
+Start your backend with that `.env` loaded, using your usual development command. Generated clients contain public types without importing actor source or its private dependencies.
+
+Edit actors in the actor project's `src/durable-objects.ts`. Annotate every instance field with `@Persisted` or `@Ephemeral`, imported from `durable-actors`. Rerun `durable-actors generate` in your application when actor method signatures change. `dev` mints a fresh shared secret on restart unless one is configured, so update your application's `.env` and restart its backend too.
+
+For complete application templates, use `durable-actors init <directory> --template chat`, `--template ai-chat`, or `--template documents`. See the [chat](https://github.com/TerseAI/durable-actors/tree/main/examples/chat), [AI chat](https://github.com/TerseAI/durable-actors/tree/main/examples/ai-chat), and [documents](https://github.com/TerseAI/durable-actors/tree/main/examples/documents) examples.
+
+## Generate clients programmatically
+
+Build tools can generate the same files in memory through the public compiler and codegen APIs:
+
+```ts
+import { generateTypeScript } from "durable-actors/codegen"
+import { ActorCompiler } from "durable-actors/compiler"
+
+const contract = new ActorCompiler().compileContract("src/durable-objects.ts")
+const files = await generateTypeScript(contract)
+// files is a ReadonlyMap<string, string> of relative filenames to TypeScript source.
+```
+
+The caller chooses where to write the files. Generation does not execute actor code. The CLI writes only generated TypeScript clients.
+
+## Deploy and generate remote clients
+
+For a hosted deployment, configure the [remote connection](#hosted-backends), then supply your published customer build image. The control plane compiles the code and public contract, publishes the snapshot, and registers the deployment in one request:
+
+```sh
+durable-actors deploy --image im-customer-build
+```
+
+Then generate clients in another repository using the same environment settings:
+
+```sh
+durable-actors generate
+```
+
+Deploy assigns a revision automatically, and generation uses the latest deployment. The server stores only its active contract. See the [CLI reference](../docs/reference/cli.md#generate-from-the-control-plane) for deployment and credentials.
+
+The npm package installs the `durable-actors` CLI. On first use, `dev` downloads and caches the matching native runtime automatically. It watches TypeScript files across the actor project and publishes valid source changes to the local control plane; rerun `durable-actors generate` when the public contract changes. Start your frontend and application backend with their usual tooling. Restart the application backend after restarting the actor runtime to reload cached settings. State survives restarts in `.durable-actors/`.
+
+`durable-actors dev --help` lists options. There is no CLI client runner; browser applications use native WebSockets as shown below.
+
+## Test runners
+
+Start a local server programmatically and pass its connection settings to your test runner:
+
+```ts
+import { startLocalActors } from "durable-actors/dev"
+
+const runtime = await startLocalActors({ entrypoint: "src/actors.ts" })
+try {
+    await runTests(runtime.connection)
+} finally {
+    await runtime.stop()
+}
+```
+
+The launcher downloads the matching runtime and waits for readiness. It defaults to a free loopback port and `.durable-actors/`; set `project`, `dataDir`, or `port` to override them. `stop()` preserves state and waits for shutdown. `connection` exposes the server settings; `closed` rejects on process failure.
+
+## Hosted backends
+
+Configure the [remote connection](https://github.com/TerseAI/durable-actors/blob/main/docs/reference/configuration.md) once for your CLI and backend. Local development uses the connection settings printed by `dev`.
+
+Keep the shared secret on your backend, where you check user permissions. The SDK connects to the named actor and calls its methods. Mobile and browser apps use [WebSockets authorized by your backend](https://github.com/TerseAI/durable-actors/blob/main/docs/guides/self-hosting.md#browser-connections).
+
+See [self-hosting](https://github.com/TerseAI/durable-actors/blob/main/docs/guides/self-hosting.md) for deployment and credentials. Runtime distributions bundle the Go provider.
+
+## WebSocket API
+
+The gateway keeps connections while actors hibernate. Actors use `onConnect`, `onMessage`, and `onDisconnect` to manage application messages. Browser connections receive explicit actor messages plus automatic snapshots and committed updates of public `@Persisted @Emittable` fields. Private, protected, and non-emittable fields are excluded.
+
+For long-running async methods, import the experimental `Reentrant` decorator and apply `@Reentrant` to allow other calls and socket hooks to run while the method awaits. The method retains actor state access, but state can change across awaits. Undecorated calls block all new invocations until completion and persistence; already-running reentrant continuations may still resume during their awaits. Direct `this.method()` calls inherit the current invocation's mode.
+
+Declaring any reentrant method disables application-error rollback for the whole actor class. Failed-call mutations remain in memory and may be saved by another successful call. Persistence still occurs on successful completion, so this does not make streamed progress immediately durable. See the [scheduling and persistence contract](https://github.com/TerseAI/durable-actors/blob/main/docs/reference/api.md#reentrant-methods-experimental) before opting in.
+
+Inside actor hooks and backend SDK connections, send JSON values with `socket.send({ type: "chat", text: "Hello" })`. The backend SDK encodes and parses these values. Native browser sockets use `JSON.stringify` and `JSON.parse`.
+
+`Actor<Metadata, Incoming, Outgoing = Incoming, Tag extends string = string>` types metadata, both message directions, and tags. Use `ActorSocketOf<ChatRoom>` and `ActorMessageOf<ChatRoom>` in hooks to reuse those types. Generated JSON schemas are checked at deployment and are not enforced with AJV during execution. Optional static Zod schemas validate metadata, incoming and outgoing messages, and tags at runtime; see [generics and wire validation](https://github.com/TerseAI/durable-actors/blob/main/docs/reference/api.md#generics-and-wire-validation).
+
+| API                                  | Behavior                                             |
+| ------------------------------------ | ---------------------------------------------------- |
+| `Actor.get(id).connect(metadata)`    | Opens a connection with JSON-serializable metadata.  |
+| `onMessage(socket, message)`         | Handles incoming messages on the actor.              |
+| `onDisconnect(socket)`               | Handles a closed connection.                         |
+| `this.broadcast(message)`            | Sends to connected clients.                          |
+| `socket.send(message)`               | Sends to one client.                                 |
+| `socket.setTags(...tags)`            | Tags a connection for filtered broadcasts.           |
+| `socket.close()` / `socket.reject()` | Closes a connection / rejects it during `onConnect`. |
+
+`await this.getConnections()` fetches connections on demand and caches the result for that invocation. Ordinary methods that do not enumerate connections skip the gateway lookup. From application code, `Actor.get(id).broadcast(message)` sends transient output without invoking the actor or saving state.
+
+For a separate WebSocket gateway, see [gateway configuration](https://github.com/TerseAI/durable-actors/blob/main/docs/reference/configuration.md).
+
+## Browser clients
+
+Generate backend helpers from your actor entrypoint:
+
+```sh
+npx durable-actors generate
+```
+
+The generated `index.ts` exposes typed backend RPC stubs and WebSocket grants under `actors`. Your frontend uses the browser's native `WebSocket`; it needs no generated client or SDK import.
+
+Your backend authenticates the user and checks actor access before issuing a grant:
+
+```ts
+import { actors } from "./generated/index.js"
+
+export async function POST(request: Request) {
+    const user = await requireUser(request)
+    const roomId = "lobby"
+    await requireRoomAccess(user, roomId)
+    const grant = await actors.ChatRoom.prepareWebsocket({
+        actorId: roomId,
+        metadata: { userId: user.id }
+    })
+    return Response.json(grant, { headers: { "cache-control": "no-store" } })
+}
+```
+
+`prepareWebsocket` returns `{ websocketUrl, key }`. The URL already includes the signed key and can be passed directly to `new WebSocket()`. The key grants socket access to one actor; it cannot invoke backend RPC methods or issue other keys. Metadata comes from your backend and is validated by the actor host.
+
+The helper reads connection settings from environment variables. For overrides or an injected transport, use `actors.ChatRoom.prepareWebsocket(authorization, options, { fetch })`. `ActorProxy.handle({ actorName, actorId, metadata })` remains available for dynamic actor selection.
+
+The frontend fetches your application endpoint and opens the returned URL:
+
+```js
+const response = await fetch("/api/socket/ChatRoom/lobby", { method: "POST" })
+if (!response.ok) throw new Error("Connection denied")
+const { websocketUrl } = await response.json()
+const socket = new WebSocket(websocketUrl)
+
+socket.onopen = () => socket.send(JSON.stringify({ type: "post", text: "Hello" }))
+socket.onmessage = event => renderMessage(JSON.parse(event.data))
+socket.onclose = event => showDisconnected(event.code)
+socket.onerror = () => showConnectionError()
+```
+
+Messages are application JSON in text frames, with no SDK envelopes, initialization frames, or special subprotocol. Actors send initial application data explicitly from `onConnect` and use `socket.send()` or `this.broadcast()` for updates. Public `@Persisted @Emittable` fields also send automatic `state` snapshots and committed `state_update` messages. Actors without emittable fields send only application messages. Reconnection, message replay, and ticket renewal remain application responsibilities.
+
+Open a grant within 60 seconds. Connection authorization defaults to 15 minutes; set `authorizationLifetimeMs` in `prepareWebsocket` to change it, subject to the server's maximum. The server closes expired connections with code `4408`, including while idle or running a handler. Your application decides whether to request a fresh grant and open another socket.
+
+Treat both the URL and key as credentials. Keep the backend shared secret on the server and omit signed URL query strings from logs. Call `socket.close()` when the view is finished.
+
+## Reference
+
+- [Configuration](https://github.com/TerseAI/durable-actors/blob/main/docs/reference/configuration.md): local defaults, environment variables, credentials, and server settings.
+- [CLI reference](https://github.com/TerseAI/durable-actors/blob/main/docs/reference/cli.md): commands and options.
+- [TypeScript API reference](https://github.com/TerseAI/durable-actors/blob/main/docs/reference/api.md): actors, methods, connections, types, and errors.
+- [HTTP and WebSocket reference](https://github.com/TerseAI/durable-actors/blob/main/docs/reference/http.md): deployments, backend access, connections, and callbacks.
+- [Local development](https://github.com/TerseAI/durable-actors/blob/main/docs/guides/local-development.md): install from npm and run actors locally.
+
+## License
+
+MIT © 2026 Terse

package/dist/actor/actor.d.ts

@@ -0,0 +1,66 @@
+import type { JsonObject, JsonValue } from "../json.js";
+import type { ActorSchema } from "./schema.js";
+import type { ActorBroadcastOptions, ActorConnection, ActorSocket } from "./socket.js";
+import type { ActorSchemas } from "./socketValidation.js";
+declare const actorTypes: unique symbol;
+interface Actor<Metadata = JsonValue, Incoming = JsonValue, Outgoing = Incoming, Tag extends string = string> {
+    onConnect?(socket: ActorSocket<Metadata, Outgoing, Tag>): Promise<void>;
+    onMessage?(socket: ActorSocket<Metadata, Outgoing, Tag>, message: Incoming): Promise<void>;
+    onDisconnect?(socket: ActorSocket<Metadata, Outgoing, Tag>, code: number, reason: string, wasClean: boolean): Promise<void>;
+}
+declare abstract class Actor<Metadata = JsonValue, Incoming = JsonValue, Outgoing = Incoming, Tag extends string = string> {
+    readonly [actorTypes]: {
+        metadata: Metadata;
+        incoming: Incoming;
+        outgoing: Outgoing;
+        tag: Tag;
+    };
+    protected constructor();
+    static get<TActorClass extends ActorClass>(this: ValidActorClass<TActorClass>, actorId: string): ActorReference<TActorClass["prototype"]>;
+    protected get id(): string;
+    protected getConnections(): Promise<readonly ActorSocket<Metadata, Outgoing, Tag>[]>;
+    protected broadcast(message: Outgoing, options?: ActorBroadcastOptions<Tag>): void;
+}
+declare function registerActorClass<Instance extends AnyActor>(actorClass: ActorClass<Instance>, state: ActorSchema): ActorDefinition;
+declare function findActorDefinition(actorName: string): ActorDefinition | undefined;
+declare function bindActorIdentity(instance: AnyActor, actorId: string): void;
+interface ActorDefinition extends ActorClassDescription {
+    state: ActorSchema;
+}
+interface ActorClassDescription {
+    readonly actorName: string;
+    readonly actorClass: ActorClass;
+    readonly schemas: ActorSchemas;
+    readonly methods: ReadonlySet<string>;
+}
+type AnyActor = Actor<unknown, unknown, unknown>;
+type ActorClass<Instance extends AnyActor = AnyActor> = Function & {
+    readonly prototype: Instance;
+    readonly schemas?: ActorSchemas;
+};
+type AsyncMethod = (...args: never[]) => Promise<unknown>;
+type PubliclyConstructibleActorClass = abstract new (...args: never[]) => AnyActor;
+type InvalidActorMethod<Instance extends AnyActor> = {
+    [Key in keyof Instance]-?: NonNullable<Instance[Key]> extends (...args: never[]) => unknown ? NonNullable<Instance[Key]> extends AsyncMethod ? never : Key : never;
+}[keyof Instance];
+type ValidActorClass<TActorClass extends ActorClass> = TActorClass extends PubliclyConstructibleActorClass ? never : InvalidActorMethod<TActorClass["prototype"]> extends never ? TActorClass extends {
+    readonly schemas: ActorSchemas<SocketMetadata<TActorClass["prototype"]>, SocketIncoming<TActorClass["prototype"]>, SocketOutgoing<TActorClass["prototype"]>, SocketTag<TActorClass["prototype"]>>;
+} ? TActorClass : TActorClass extends {
+    readonly schemas: unknown;
+} ? never : TActorClass : never;
+type ActorReference<Instance extends AnyActor> = {
+    [Key in keyof Instance as Instance[Key] extends AsyncMethod ? Key extends SocketLifecycleMethod ? never : Key : never]: Instance[Key];
+} & {
+    connect(metadata: SocketMetadata<Instance>): Promise<ActorConnection<SocketIncoming<Instance>, SocketOutgoing<Instance>, JsonObject>>;
+    broadcast(message: SocketOutgoing<Instance>): Promise<void>;
+};
+type SocketLifecycleMethod = "onConnect" | "onMessage" | "onDisconnect";
+type SocketMetadata<Instance extends AnyActor> = Instance[typeof actorTypes]["metadata"];
+type SocketIncoming<Instance extends AnyActor> = Instance[typeof actorTypes]["incoming"];
+type SocketOutgoing<Instance extends AnyActor> = Instance[typeof actorTypes]["outgoing"];
+type SocketTag<Instance extends AnyActor> = Instance[typeof actorTypes]["tag"];
+type ActorSocketOf<Instance extends AnyActor> = ActorSocket<SocketMetadata<Instance>, SocketOutgoing<Instance>, SocketTag<Instance>>;
+type ActorMessageOf<Instance extends AnyActor> = SocketIncoming<Instance>;
+export { Actor, bindActorIdentity, findActorDefinition, registerActorClass };
+export type { ActorClass, ActorDefinition, ActorMessageOf, ActorReference, ActorSocketOf, AnyActor };
+//# sourceMappingURL=actor.d.ts.map

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

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

package/dist/actor/actor.js

@@ -0,0 +1,144 @@
+import { actorClient } from "../client/client.js";
+import { ActorDefinitionError } from "../errors.js";
+import { validateActorComponent } from "./identity.js";
+import { actorConnections, broadcastActor } from "./socket.js";
+import { outgoingMessage, socketMetadata } from "./socketValidation.js";
+const actorMetadata = new WeakMap();
+const actorDefinitions = new Map();
+const asyncFunction = Object.getPrototypeOf(async () => { }).constructor;
+const referenceClasses = new WeakMap();
+class Actor {
+    constructor() { }
+    static get(actorId) {
+        return getActorReference(this, validateActorComponent("actor ID", actorId));
+    }
+    get id() {
+        return metadataFor(this).actorId;
+    }
+    getConnections() {
+        return actorConnections(this);
+    }
+    broadcast(message, options) {
+        broadcastActor(this, message, options);
+    }
+}
+function registerActorClass(actorClass, state) {
+    const actorName = actorClassName(actorClass);
+    const existing = actorDefinitions.get(actorName);
+    if (existing !== undefined) {
+        if (existing.actorClass !== actorClass)
+            throw new ActorDefinitionError(`duplicate actor name ${actorName}`);
+        existing.state = state;
+        return existing;
+    }
+    const definition = { ...describeActorClass(actorClass), state };
+    actorDefinitions.set(actorName, definition);
+    return definition;
+}
+function findActorDefinition(actorName) {
+    return actorDefinitions.get(actorName);
+}
+function getActorReference(actorClass, actorId) {
+    const Reference = referenceClass(actorClass);
+    return new Reference(actorId);
+}
+function bindActorIdentity(instance, actorId) {
+    actorMetadata.set(instance, { actorId: validateActorComponent("actor ID", actorId) });
+}
+function referenceClass(actorClass) {
+    const existing = referenceClasses.get(actorClass);
+    if (existing !== undefined)
+        return existing;
+    const definition = describeActorClass(actorClass);
+    class ActorReference extends Actor {
+        constructor(actorId) {
+            super();
+            bindActorIdentity(this, actorId);
+        }
+    }
+    Object.defineProperty(ActorReference.prototype, "connect", {
+        configurable: false,
+        enumerable: false,
+        writable: false,
+        value: function connectActor(metadata) {
+            const actor = metadataFor(this);
+            const attachment = socketMetadata(metadata, definition.schemas);
+            return actorClient().then(client => client.connect(definition.actorName, actor.actorId, attachment, definition.schemas));
+        }
+    });
+    Object.defineProperty(ActorReference.prototype, "broadcast", {
+        configurable: false,
+        enumerable: false,
+        writable: false,
+        value: function broadcastActorMessage(message) {
+            const actor = metadataFor(this);
+            const outgoing = outgoingMessage(message, definition.schemas);
+            return actorClient().then(client => client.broadcast(definition.actorName, actor.actorId, outgoing));
+        }
+    });
+    definition.methods.forEach(method => {
+        Object.defineProperty(ActorReference.prototype, method, {
+            configurable: false,
+            enumerable: false,
+            writable: false,
+            value: function forwardActorMethod(...args) {
+                const metadata = metadataFor(this);
+                return actorClient().then(client => client.invoke(definition.actorName, metadata.actorId, method, args));
+            }
+        });
+    });
+    referenceClasses.set(definition.actorClass, ActorReference);
+    return ActorReference;
+}
+function metadataFor(instance) {
+    const metadata = actorMetadata.get(instance);
+    if (metadata === undefined)
+        throw new ActorDefinitionError("actor identity is unavailable outside an actor invocation");
+    return metadata;
+}
+function describeActorClass(actorClass) {
+    const actorName = actorClassName(actorClass);
+    validateActorClass(actorClass, actorName);
+    return {
+        actorName: validateActorComponent("actor name", actorName),
+        actorClass,
+        schemas: actorClass.schemas ?? {},
+        methods: new Set(discoverMethods(actorClass, actorName))
+    };
+}
+function discoverMethods(actorClass, actorName) {
+    if (Object.getOwnPropertySymbols(actorClass.prototype).length > 0)
+        throw new ActorDefinitionError(`actor class ${actorName} cannot define symbol methods`);
+    return Object.entries(Object.getOwnPropertyDescriptors(actorClass.prototype)).flatMap(([name, descriptor]) => {
+        if (name === "constructor")
+            return [];
+        if (descriptor.get !== undefined || descriptor.set !== undefined)
+            throw new ActorDefinitionError(`actor class ${actorName} cannot define accessor ${name}`);
+        if (typeof descriptor.value !== "function")
+            return [];
+        validateActorComponent("actor method", name);
+        if (name === "then")
+            throw new ActorDefinitionError(`actor class ${actorName} cannot define method then`);
+        if (name === "connect" || name === "broadcast")
+            throw new ActorDefinitionError(`actor class ${actorName} cannot define reserved method ${name}`);
+        if (!(descriptor.value instanceof asyncFunction))
+            throw new ActorDefinitionError(`actor method ${actorName}.${name} must be async`);
+        if (lifecycleMethods.has(name))
+            return [];
+        return [name];
+    });
+}
+const lifecycleMethods = new Set(["onConnect", "onMessage", "onDisconnect"]);
+function validateActorClass(actorClass, actorName) {
+    if (Object.getPrototypeOf(actorClass.prototype) !== Actor.prototype)
+        throw new ActorDefinitionError(`actor class ${actorName} must extend Actor directly`);
+    if (actorClass.length !== 0)
+        throw new ActorDefinitionError(`actor class ${actorName} cannot require constructor arguments`);
+}
+function actorClassName(actorClass) {
+    if (actorClass.name.length === 0)
+        throw new ActorDefinitionError("actor classes must be named");
+    return actorClass.name;
+}
+export { Actor, bindActorIdentity, findActorDefinition, registerActorClass };
+//# sourceMappingURL=actor.js.map

package/dist/actor/actor.js.map

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

package/dist/actor/decorators.d.ts

@@ -0,0 +1,6 @@
+declare function Reentrant(_value: Function, context: ClassMethodDecoratorContext): void;
+declare function Persisted(_value: undefined, context: ClassFieldDecoratorContext): void;
+declare function Ephemeral(_value: undefined, context: ClassFieldDecoratorContext): void;
+declare function Emittable(_value: undefined, context: ClassFieldDecoratorContext): void;
+export { Emittable, Ephemeral, Persisted, Reentrant };
+//# sourceMappingURL=decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/actor/decorators.ts"],"names":[],"mappings":"AAEA,iBAAS,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAG/E;AAED,iBAAS,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAG/E;AAED,iBAAS,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAE/E;AAED,iBAAS,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAG/E;AAOD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAA"}

package/dist/actor/decorators.js

@@ -0,0 +1,24 @@
+import { ActorDefinitionError } from "../errors.js";
+function Reentrant(_value, context) {
+    if (context.kind !== "method" || context.static || context.private || typeof context.name !== "string")
+        throw new ActorDefinitionError("@Reentrant requires a public instance async method");
+}
+function Persisted(_value, context) {
+    validateField("Persisted", context);
+    if (context.private)
+        throw new ActorDefinitionError("@Persisted cannot decorate a JavaScript private field");
+}
+function Ephemeral(_value, context) {
+    validateField("Ephemeral", context);
+}
+function Emittable(_value, context) {
+    validateField("Emittable", context);
+    if (context.private)
+        throw new ActorDefinitionError("@Emittable requires a public field");
+}
+function validateField(name, context) {
+    if (context.kind !== "field" || context.static || typeof context.name !== "string")
+        throw new ActorDefinitionError(`@${name} requires an instance field with a string name`);
+}
+export { Emittable, Ephemeral, Persisted, Reentrant };
+//# sourceMappingURL=decorators.js.map

package/dist/actor/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/actor/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnD,SAAS,SAAS,CAAC,MAAgB,EAAE,OAAoC;IACrE,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAClG,MAAM,IAAI,oBAAoB,CAAC,oDAAoD,CAAC,CAAA;AAC5F,CAAC;AAED,SAAS,SAAS,CAAC,MAAiB,EAAE,OAAmC;IACrE,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IACnC,IAAI,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,oBAAoB,CAAC,uDAAuD,CAAC,CAAA;AAChH,CAAC;AAED,SAAS,SAAS,CAAC,MAAiB,EAAE,OAAmC;IACrE,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;AACvC,CAAC;AAED,SAAS,SAAS,CAAC,MAAiB,EAAE,OAAmC;IACrE,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IACnC,IAAI,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,oBAAoB,CAAC,oCAAoC,CAAC,CAAA;AAC7F,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,OAAmC;IACpE,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAC9E,MAAM,IAAI,oBAAoB,CAAC,IAAI,IAAI,gDAAgD,CAAC,CAAA;AAChG,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAA"}

package/dist/actor/identity.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+declare function validateActorComponent(name: string, value: string): string;
+declare function actorKey(actor: ActorIdentity): string;
+declare const actorComponentSchema: z.ZodString;
+export declare const projectIdSchema: z.ZodString;
+export declare function validateProjectId(value: unknown): string;
+declare const actorIdentitySchema: z.ZodObject<{
+    project_id: z.ZodString;
+    actor_name: z.ZodString;
+    actor_id: z.ZodString;
+}, z.core.$strict>;
+type ActorIdentity = z.infer<typeof actorIdentitySchema>;
+export { actorComponentSchema, actorIdentitySchema, actorKey, validateActorComponent };
+export type { ActorIdentity };
+export declare function projectActorPath(projectId: string, actorName: string, actorId: string): string;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/actor/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,iBAAS,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED,iBAAS,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAE9C;AAED,QAAA,MAAM,oBAAoB,aAAyC,CAAA;AACnE,eAAO,MAAM,eAAe,aAAgF,CAAA;AAC5G,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIxD;AACD,QAAA,MAAM,mBAAmB;;;;kBAIvB,CAAA;AAEF,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAExD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,CAAA;AACtF,YAAY,EAAE,aAAa,EAAE,CAAA;AAE7B,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9F"}

package/dist/actor/identity.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { ActorValidationError } from "../errors.js";
+function validateActorComponent(name, value) {
+    const result = actorComponentSchema.safeParse(value);
+    if (!result.success)
+        throw new ActorValidationError(`${name} may contain only ASCII letters, digits, '.', '-', and '_'`);
+    return result.data;
+}
+function actorKey(actor) {
+    return `${actor.project_id}\u001f${actor.actor_name}\u001f${actor.actor_id}`;
+}
+const actorComponentSchema = z.string().regex(/^[A-Za-z0-9._-]+$/u);
+export const projectIdSchema = actorComponentSchema.max(64).refine(value => value !== "." && value !== "..");
+export function validateProjectId(value) {
+    const result = projectIdSchema.safeParse(value);
+    if (!result.success)
+        throw new ActorValidationError("A valid actor project ID is required");
+    return result.data;
+}
+const actorIdentitySchema = z.strictObject({
+    project_id: projectIdSchema,
+    actor_name: actorComponentSchema,
+    actor_id: actorComponentSchema
+});
+export { actorComponentSchema, actorIdentitySchema, actorKey, validateActorComponent };
+export function projectActorPath(projectId, actorName, actorId) {
+    return `/v1/projects/${encodeURIComponent(validateProjectId(projectId))}/actors/${encodeURIComponent(actorName)}/${encodeURIComponent(actorId)}`;
+}
+//# sourceMappingURL=identity.js.map

package/dist/actor/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/actor/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnD,SAAS,sBAAsB,CAAC,IAAY,EAAE,KAAa;IACvD,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO;QACf,MAAM,IAAI,oBAAoB,CAAC,GAAG,IAAI,4DAA4D,CAAC,CAAA;IACvG,OAAO,MAAM,CAAC,IAAI,CAAA;AACtB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAoB;IAClC,OAAO,GAAG,KAAK,CAAC,UAAU,SAAS,KAAK,CAAC,UAAU,SAAS,KAAK,CAAC,QAAQ,EAAE,CAAA;AAChF,CAAC;AAED,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAA;AACnE,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI,CAAC,CAAA;AAC5G,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC/C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,oBAAoB,CAAC,sCAAsC,CAAC,CAAA;IAC3F,OAAO,MAAM,CAAC,IAAI,CAAA;AACtB,CAAC;AACD,MAAM,mBAAmB,GAAG,CAAC,CAAC,YAAY,CAAC;IACvC,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE,oBAAoB;IAChC,QAAQ,EAAE,oBAAoB;CACjC,CAAC,CAAA;AAIF,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,CAAA;AAGtF,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,SAAiB,EAAE,OAAe;IAClF,OAAO,gBAAgB,kBAAkB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,WAAW,kBAAkB,CAAC,SAAS,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAA;AACpJ,CAAC"}

package/dist/actor/invocationContext.d.ts

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

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

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

package/dist/actor/invocationContext.js

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

package/dist/actor/invocationContext.js.map

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

package/dist/actor/schema.d.ts

@@ -0,0 +1,22 @@
+import type { SocketContract } from "../wire/contract.js";
+declare const ACTOR_ARTIFACT_VERSION = 1;
+declare enum Persistence {
+    Persisted = "persisted",
+    Ephemeral = "ephemeral"
+}
+interface ActorFieldSchema {
+    readonly name: string;
+    readonly persistence: Persistence;
+    readonly private?: boolean;
+    readonly visibility?: "private" | "protected";
+    readonly emittable?: boolean;
+}
+interface ActorSchema {
+    readonly actorName: string;
+    readonly fields: readonly ActorFieldSchema[];
+    readonly reentrantMethods?: readonly string[];
+    readonly contract?: SocketContract;
+}
+export { ACTOR_ARTIFACT_VERSION, Persistence };
+export type { ActorFieldSchema, ActorSchema };
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/actor/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,QAAA,MAAM,sBAAsB,IAAI,CAAA;AAEhC,aAAK,WAAW;IACZ,SAAS,cAAc;IACvB,SAAS,cAAc;CAC1B;AAED,UAAU,gBAAgB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,WAAW,CAAA;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,UAAU,WAAW;IACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC5C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;CACrC;AAED,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,CAAA;AAC9C,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAA"}

package/dist/actor/schema.js

@@ -0,0 +1,8 @@
+const ACTOR_ARTIFACT_VERSION = 1;
+var Persistence;
+(function (Persistence) {
+    Persistence["Persisted"] = "persisted";
+    Persistence["Ephemeral"] = "ephemeral";
+})(Persistence || (Persistence = {}));
+export { ACTOR_ARTIFACT_VERSION, Persistence };
+//# sourceMappingURL=schema.js.map

package/dist/actor/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/actor/schema.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG,CAAC,CAAA;AAEhC,IAAK,WAGJ;AAHD,WAAK,WAAW;IACZ,sCAAuB,CAAA;IACvB,sCAAuB,CAAA;AAC3B,CAAC,EAHI,WAAW,KAAX,WAAW,QAGf;AAiBD,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,CAAA"}