durable-actors 0.2.4 → 0.2.7

package/dist/proxy.d.ts

@@ -1,8 +1,11 @@
+/** @module durable-actors/proxy */
 import { z } from "zod";
+/** Overrides for the backend's DURABLE_ACTORS environment settings. */
 interface SocketProxyOptions {
     readonly projectId?: string;
     readonly controlPlaneUrl?: string;
     readonly apiKey?: string;
+    /** Defaults to 180000 ms; accepts 1000–600000 ms. */
     readonly setupTimeoutMs?: number;
 }
 interface SocketProxyDependencies {
@@ -11,6 +14,7 @@ interface SocketProxyDependencies {
 interface ProxyActor<Metadata = unknown> {
     readonly types?: Metadata;
 }
+/** Actor access your backend has already authorized. */
 type SocketAuthorization<Actors extends Record<string, ProxyActor>> = {
     [Name in keyof Actors & string]: {
         readonly actorName: Name;
@@ -22,12 +26,13 @@ type SocketAuthorization<Actors extends Record<string, ProxyActor>> = {
 }[keyof Actors & string];
 declare const socketGrantSchema: z.ZodObject<{
     websocketUrl: z.ZodURL;
-    transport: z.ZodLiteral<"websocket">;
     homeRegion: z.ZodString;
     connectByMs: z.ZodNumber;
     authorizedUntilMs: z.ZodNumber;
 }, z.core.$strip>;
+/** Browser connection URL and deadlines in Unix milliseconds. Treat the URL as a credential. */
 type SocketGrant = z.infer<typeof socketGrantSchema>;
+/** Issues browser connection URLs from your backend. */
 declare class SocketProxy<Actors extends Record<string, ProxyActor>> {
     private readonly actors;
     private readonly projectId;
@@ -36,6 +41,10 @@ declare class SocketProxy<Actors extends Record<string, ProxyActor>> {
     private readonly setupTimeoutMs;
     private readonly fetchRequest;
     constructor(actors: Actors, options?: SocketProxyOptions, dependencies?: SocketProxyDependencies);
+    /**
+     * Call after authenticating the user and checking actor access.
+     * Pass `websocketUrl` to the browser's `new WebSocket()`.
+     */
     handle(authorization: SocketAuthorization<Actors>): Promise<SocketGrant>;
 }
 export { SocketProxy };

package/dist/proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,UAAU,kBAAkB;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACnC;AAED,UAAU,uBAAuB;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAC3C;AAED,UAAU,UAAU,CAAC,QAAQ,GAAG,OAAO;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;CAC5B;AAED,KAAK,mBAAmB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI;KACjE,IAAI,IAAI,MAAM,MAAM,GAAG,MAAM,GAAG;QAC7B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,QAAQ,CAAC,GAAG,QAAQ,GAAG,KAAK,CAAA;QACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;KAC5C;CACJ,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAA;AAExB,QAAA,MAAM,iBAAiB;;;;;;iBAMrB,CAAA;AAEF,KAAK,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEpD,cAAM,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAQnD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAP3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAGjC,MAAM,EAAE,MAAM,EAC/B,OAAO,GAAE,kBAAuB,EAChC,YAAY,GAAE,uBAA4B;IAwBxC,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;CA4BjF;AAaD,OAAO,EAAE,WAAW,EAAE,CAAA;AACtB,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,WAAW,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,uEAAuE;AACvE,UAAU,kBAAkB;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,qDAAqD;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACnC;AAED,UAAU,uBAAuB;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAC3C;AAED,UAAU,UAAU,CAAC,QAAQ,GAAG,OAAO;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;CAC5B;AAED,wDAAwD;AACxD,KAAK,mBAAmB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI;KACjE,IAAI,IAAI,MAAM,MAAM,GAAG,MAAM,GAAG;QAC7B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,QAAQ,CAAC,GAAG,QAAQ,GAAG,KAAK,CAAA;QACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;KAC5C;CACJ,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAA;AAExB,QAAA,MAAM,iBAAiB;;;;;iBAKrB,CAAA;AAEF,gGAAgG;AAChG,KAAK,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEpD,wDAAwD;AACxD,cAAM,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAQnD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAP3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAGjC,MAAM,EAAE,MAAM,EAC/B,OAAO,GAAE,kBAAuB,EAChC,YAAY,GAAE,uBAA4B;IAwB9C;;;OAGG;IACG,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;CA4BjF;AAaD,OAAO,EAAE,WAAW,EAAE,CAAA;AACtB,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,WAAW,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/proxy.js

@@ -1,14 +1,15 @@
+/** @module durable-actors/proxy */
 import { z } from "zod";
 import { projectActorPath, validateActorComponent, validateProjectId } from "./actor/identity.js";
 import { socketMetadata } from "./actor/socketValidation.js";
 import { actorEnvironment } from "./environment.js";
 const socketGrantSchema = z.object({
     websocketUrl: z.url().refine(url => ["ws:", "wss:"].includes(new URL(url).protocol)),
-    transport: z.literal("websocket"),
     homeRegion: z.string().min(1),
     connectByMs: z.number().int(),
     authorizedUntilMs: z.number().int()
 });
+/** Issues browser connection URLs from your backend. */
 class SocketProxy {
     actors;
     projectId;
@@ -37,6 +38,10 @@ class SocketProxy {
         this.projectId = validateProjectId(settings.projectId);
         this.fetchRequest = dependencies.fetch ?? globalThis.fetch;
     }
+    /**
+     * Call after authenticating the user and checking actor access.
+     * Pass `websocketUrl` to the browser's `new WebSocket()`.
+     */
     async handle(authorization) {
         const actorName = validateActorComponent("actor name", authorization.actorName);
         const actorId = validateActorComponent("actor ID", authorization.actorId);
@@ -51,10 +56,10 @@ class SocketProxy {
         const homeRegion = authorization.homeRegion === undefined
             ? undefined
             : validateActorComponent("home region", authorization.homeRegion);
-        const response = await this.fetchRequest(`${this.origin}${projectActorPath(this.projectId, actorName, actorId)}/connect`, {
+        const response = await this.fetchRequest(`${this.origin}${projectActorPath(this.projectId, actorName, actorId)}/find-websocket`, {
             method: "POST",
             headers: { authorization: `Bearer ${this.apiKey}`, "content-type": "application/json" },
-            body: JSON.stringify({ transport: "websocket", metadata, authorizationLifetimeMs, homeRegion }),
+            body: JSON.stringify({ metadata, authorizationLifetimeMs, homeRegion }),
             signal: AbortSignal.timeout(this.setupTimeoutMs)
         });
         if (!response.ok)

package/dist/proxy.js.map

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

package/dist/templates/actor/README.md

@@ -7,9 +7,9 @@ pnpm install
 pnpm exec durable-actors dev
 ```
 
-Define your actors in `src/durable-objects.ts`. The starter contains a counter with persisted state and `read()` and `increment()` methods. Each counter ID has its own saved value.
+Define your actors in `src/actors.ts`. The starter contains a counter with persisted state and `read()` and `increment()` methods. Each counter ID has its own saved value.
 
-`durable-actors dev` watches your actor source and stores local state in `.durable-actors/`. It defaults to project ID `local`; choose another with `pnpm exec durable-actors dev --project-id my-project`. If the CLI is installed globally, you can run `durable-actors dev` directly.
+`durable-actors dev` watches your actor source and stores local state in `.durable-actors/`. It defaults to project ID `local`; choose another with `DURABLE_ACTORS_PROJECT_ID=my-project pnpm exec durable-actors dev`. If the CLI is installed globally, you can run `durable-actors dev` directly.
 
 ## Connect your application
 
@@ -17,7 +17,7 @@ In your separate application project's directory:
 
 1. Run `pnpm add durable-actors`.
 2. Copy the project ID, URL, and shared secret printed by the actor server into your application’s `.env` file.
-3. Run `durable-actors generate`; the CLI loads `.env` automatically.
+3. Run `pnpm exec durable-actors generate --remote`; the CLI loads `.env` automatically.
 
 Your application backend can then use the generated client:
 
@@ -30,4 +30,4 @@ console.log(await counter.increment())
 
 Start your backend with that `.env` file loaded. Update its secret after restarting the actor server. If you change the actor server's URL or port, also set `DURABLE_ACTORS_CONTROL_PLANE_URL` in the backend environment. After changing actor method signatures, rerun the printed generate command in your application.
 
-Use `pnpm check` to check types and `pnpm build` to create `dist/actors.mjs` for deployment.
+Use `pnpm check` to check types. Production deployment integrations register actor images through `PUT /v1/projects/{project_id}/deployment`; see the [HTTP API](https://github.com/TerseAI/durable-actors/blob/main/docs/reference/openapi.yaml).

package/dist/templates/actor/package.json

@@ -7,11 +7,10 @@
     },
     "scripts": {
         "dev": "durable-actors dev",
-        "build": "durable-actors build",
         "check": "tsc --noEmit"
     },
     "dependencies": {
-        "durable-actors": "0.2.4"
+        "durable-actors": "0.2.7"
     },
     "devDependencies": {
         "@types/node": "^22.0.0",

package/dist/templates/ai-chat/.env.example

@@ -1 +1,7 @@
+DURABLE_ACTORS_PROJECT_ID=ai-chat-example
+DURABLE_ACTORS_SECRET=local-ai-chat-example
+DURABLE_ACTORS_CONTROL_PLANE_URL=http://127.0.0.1:7100
+DURABLE_ACTORS_PORT=7100
+DURABLE_ACTORS_BINARY=
+PORT=3000
 OPENAI_API_KEY=

package/dist/templates/ai-chat/README.md

@@ -1,41 +1,69 @@
-# AI chat with durable history
+# AI chat
 
-Requires Node.js 20+ and Bun 1.4.2+ on your PATH; Bun executes the actors.
+An Express + React app that streams replies with the Vercel AI SDK and saves conversations in durable actors.
 
-Vercel AI SDK streams replies; a durable actor stores the conversation.
+## Run locally
 
-## Run it
+Requires Node.js 22.19+, Bun 1.4.2+, and an OpenAI API key.
 
 ```sh
 npx durable-actors init ai-chat-example --template ai-chat
 cd ai-chat-example
 npm install
+cp .env.example .env
 ```
 
-Copy `.env.example` to `.env` and add your `OPENAI_API_KEY`, then start the actors:
+Already in the example directory? Start at `npm install`. Add `OPENAI_API_KEY` to `.env`, then start the actors:
 
 ```sh
-npx durable-actors dev
+npm run dev:actors
 ```
 
-Wait for `Local actors ready`. In another terminal, run the printed export command, then:
+Wait for `Ready`. In another terminal in the same directory:
 
 ```sh
 npm run dev
 ```
 
-Open [the chat](http://127.0.0.1:3000), send a message, and reload after the reply finishes. Your history is restored from the actor, including after restarting the servers.
+Open [localhost:3000](http://127.0.0.1:3000), send a message, and reload after the reply finishes. The conversation survives server restarts.
 
-If you already have this directory, start at `npm install`. No client generation is needed for this example.
+## Save the conversation
 
-## The code
+[ChatHistory](src/actors.ts) keeps one conversation per actor ID:
 
-- [src/durable-objects.ts](src/durable-objects.ts) stores AI SDK messages in a private `@Persisted` field. Each chat ID gets its own actor.
-- [src/backend.ts](src/backend.ts) loads saved history, appends the new user message, streams a reply, and saves the completed assistant message.
-- [src/Chat.tsx](src/Chat.tsx) loads the lobby history and uses `useChat` to send messages and render streaming replies.
+```ts
+import { Actor, Persisted } from "durable-actors"
 
-For a remote actor server, use the [connection overrides](../../docs/reference/configuration.md) on the backend.
+export class ChatHistory extends Actor {
+    @Persisted private messages: ChatMessage[] = []
 
-This sample has one shared lobby and no authentication. Authenticate both routes and check chat ownership before using it for private conversations. Reloads restore saved messages; in-progress streams are not resumed.
+    async load() {
+        return this.messages
+    }
 
-See Vercel’s [message persistence guide](https://ai-sdk.dev/docs/ai-sdk-ui/chatbot-message-persistence) for the AI SDK flow.
+    async append(message: ChatMessage) {
+        this.messages.push(message)
+        return this.messages
+    }
+}
+
+export type ChatMessage = {
+    id: string
+    role: "system" | "user" | "assistant"
+    parts: { type: "text"; text: string }[]
+}
+```
+
+## Stream the reply
+
+The [Express backend](src/backend.ts) appends the user message, sends the saved conversation to the model, and streams the reply. It saves the assistant message when the reply completes.
+
+The [React client](src/Chat.tsx) loads saved messages and uses `useChat` to display the stream. This demo saves text only; in-progress streams are not resumed after a reload.
+
+The lobby is shared and has no authentication. Add authentication and chat ownership checks before using it for private conversations.
+
+## Development
+
+Both processes read `.env`; actor state lives in `.durable-actors/`. Actor code reloads automatically; restart `npm run dev` after editing the actor class imported by the backend. For multiple examples, set distinct `PORT`, `DURABLE_ACTORS_PORT`, and matching control-plane URLs; see [Run the examples together](../README.md).
+
+`npm run build` checks TypeScript and builds the frontend.

package/dist/templates/ai-chat/gitignore

@@ -2,7 +2,6 @@ node_modules/
 dist/
 generated/
 .durable-actors/
-.little-actors/
 .env
 .env.*
 !.env.example

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

@@ -7,6 +7,7 @@
     },
     "scripts": {
         "dev": "tsx --env-file=.env src/backend.ts",
+        "dev:actors": "durable-actors dev",
         "build": "tsc --noEmit && vite build"
     },
     "dependencies": {
@@ -14,7 +15,7 @@
         "@ai-sdk/react": "^4.0.100",
         "ai": "^7.0.97",
         "express": "^5.2.1",
-        "durable-actors": "0.2.4",
+        "durable-actors": "0.2.7",
         "react": "^19.3.0",
         "react-dom": "^19.3.0"
     },

package/dist/templates/ai-chat/src/actors.ts

@@ -0,0 +1,20 @@
+import { Actor, Persisted } from "durable-actors"
+
+export class ChatHistory extends Actor {
+    @Persisted private messages: ChatMessage[] = []
+
+    async load() {
+        return this.messages
+    }
+
+    async append(message: ChatMessage) {
+        this.messages.push(message)
+        return this.messages
+    }
+}
+
+export type ChatMessage = {
+    id: string
+    role: "system" | "user" | "assistant"
+    parts: { type: "text"; text: string }[]
+}

package/dist/templates/ai-chat/src/backend.ts

@@ -1,11 +1,16 @@
 import { openai } from "@ai-sdk/openai"
 import { convertToModelMessages, generateId, pipeUIMessageStreamToResponse, streamText, toUIMessageStream, validateUIMessages } from "ai"
+import type { UIMessage } from "ai"
 import express from "express"
+import { createServer as createHttpServer } from "node:http"
 import { createServer } from "vite"
 
-import { ChatHistory } from "./durable-objects.js"
+import { ChatHistory } from "./actors.js"
+import type { ChatMessage } from "./actors.js"
 
 const app = express()
+const server = createHttpServer(app)
+const port = Number(process.env.PORT ?? 3000)
 app.use(express.json())
 
 app.get("/api/chat/:id", async (request, response) => {
@@ -16,7 +21,7 @@ app.post("/api/chat", async (request, response) => {
     const [message] = await validateUIMessages({ messages: [request.body.messages.at(-1)] })
     if (message.role !== "user") return response.sendStatus(400)
     const chat = ChatHistory.get(request.body.id)
-    const messages = await chat.append(message)
+    const messages = await chat.append(historyMessage(message))
     const result = streamText({
         model: openai("gpt-5-mini"),
         messages: await convertToModelMessages(messages)
@@ -28,14 +33,22 @@ app.post("/api/chat", async (request, response) => {
             originalMessages: messages,
             generateMessageId: generateId,
             onEnd: async ({ responseMessage, outcome }) => {
-                if (outcome.status === "completed") await chat.append(responseMessage)
+                if (outcome.status === "completed") await chat.append(historyMessage(responseMessage))
             }
         })
     })
 })
 
 const vite = await createServer({
-    server: { middlewareMode: true, fs: { deny: [".env", ".env.*", "**/.durable-actors/**", "**/.little-actors/**", "**/.git/**"] } }
+    server: { middlewareMode: true, hmr: { server }, fs: { deny: [".env", ".env.*", "**/.durable-actors/**", "**/.git/**"] } }
 })
 app.use(vite.middlewares)
-app.listen(3000, "127.0.0.1", () => console.log("AI chat: http://127.0.0.1:3000"))
+server.listen(port, "127.0.0.1", () => console.log(`AI chat: http://127.0.0.1:${port}`))
+
+function historyMessage(message: UIMessage): ChatMessage {
+    return {
+        id: message.id,
+        role: message.role,
+        parts: message.parts.filter(part => part.type === "text").map(part => ({ type: "text", text: part.text }))
+    }
+}

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

@@ -9,5 +9,5 @@
         "noEmit": true,
         "types": ["node"]
     },
-    "include": ["src", "generated"]
+    "include": ["src"]
 }

package/dist/templates/chat/.env.example

@@ -0,0 +1,6 @@
+DURABLE_ACTORS_PROJECT_ID=chat-example
+DURABLE_ACTORS_SECRET=local-chat-example
+DURABLE_ACTORS_CONTROL_PLANE_URL=http://127.0.0.1:7100
+DURABLE_ACTORS_PORT=7100
+DURABLE_ACTORS_BINARY=
+PORT=3000

package/dist/templates/chat/README.md

@@ -1,29 +1,74 @@
-# Express + React chat
+# Chatroom
 
-Requires Node.js 20+ and Bun 1.4.2+ on your PATH; Bun executes the actors.
+An Express + React chatroom backed by a durable actor. Messages appear in every connected tab, and history survives server restarts.
 
-Create this sample with `npx durable-actors init chat-example --template chat`.
+## Run locally
 
-## Run it
+Requires Node.js 22.19+ and Bun 1.4.2+.
 
 ```sh
+npx durable-actors init chat-example --template chat
+cd chat-example
 npm install
-npx durable-actors generate
-npx durable-actors dev
+cp .env.example .env
+npm run dev:actors
 ```
 
-Wait for `Local actors ready`. In another terminal, run the printed export command, then:
+Already in the example directory? Start at `npm install`.
+
+Wait for `Ready`. In another terminal in the same directory:
 
 ```sh
 npm run dev
 ```
 
-Open [the chat](http://127.0.0.1:3000) in two tabs. Send a message, then reload to see the saved history.
+Open [localhost:3000](http://127.0.0.1:3000) in two tabs. Send a message, then restart the actor server and reload to see the saved history.
+
+## Define the actor
+
+[ChatRoom](src/actors.ts) saves messages and sends the updated history to everyone in the room:
+
+```ts
+import { Actor, Persisted } from "durable-actors"
+import type { ActorSocket } from "durable-actors"
+
+export class ChatRoom extends Actor<Member, string, ChatMessage[]> {
+    @Persisted history: ChatMessage[] = []
+
+    async onConnect(socket: ActorSocket<Member, ChatMessage[]>) {
+        socket.send(this.history)
+    }
+
+    async onMessage(socket: ActorSocket<Member, ChatMessage[]>, text: string) {
+        this.history.push({ name: socket.metadata.name, text })
+        this.broadcast(this.history)
+    }
+}
+
+type Member = { name: string }
+type ChatMessage = { name: string; text: string }
+```
+
+Each room ID has its own history.
+
+## Connect the app
+
+The [Express backend](src/backend.ts) issues a WebSocket URL with `actors.ChatRoom.prepareWebsocket`. The [React client](src/Chat.tsx) connects and sends JSON messages:
+
+```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("Hello"))
+socket.onmessage = event => console.log(JSON.parse(event.data))
+```
 
-## How it works
+Everyone joins as a guest. Add authentication and room access checks before issuing URLs in your app. Reload to reconnect after a disconnect.
 
-Everyone is a guest in this demo. In your app, authenticate the request before `actors.ChatRoom.prepareWebsocket` and derive metadata from the signed-in user.
+## Development
 
-The frontend fetches a signed URL from the backend and passes it to `new WebSocket()`. The actor sends history explicitly on connection and after each message. Reload to reconnect if the socket closes.
+Both processes read `.env`; saved state lives in `.durable-actors/`. Actor code reloads automatically. After changing public actor types, restart `npm run dev` to regenerate the client. For multiple examples, set distinct `PORT`, `DURABLE_ACTORS_PORT`, and matching control-plane URLs; see [Run the examples together](../README.md).
 
-After changing the actor's types, rerun `npx durable-actors generate` and restart the actor server.
+`npm run build` generates clients, checks TypeScript, and builds the frontend.

package/dist/templates/chat/gitignore

@@ -2,7 +2,6 @@ node_modules/
 dist/
 generated/
 .durable-actors/
-.little-actors/
 .env
 .env.*
 !.env.example

package/dist/templates/chat/package.json

@@ -6,12 +6,13 @@
         "node": ">=22.19.0"
     },
     "scripts": {
-        "dev": "tsx src/backend.ts",
-        "build": "tsc --noEmit && vite build"
+        "dev": "durable-actors generate && tsx --env-file=.env src/backend.ts",
+        "dev:actors": "durable-actors dev",
+        "build": "durable-actors generate && tsc --noEmit && vite build"
     },
     "dependencies": {
         "express": "^5.2.1",
-        "durable-actors": "0.2.4",
+        "durable-actors": "0.2.7",
         "react": "^19.3.0",
         "react-dom": "^19.3.0"
     },

package/dist/templates/chat/src/backend.ts

@@ -1,9 +1,12 @@
 import express from "express"
+import { createServer as createHttpServer } from "node:http"
 import { createServer } from "vite"
 
 import { actors } from "../generated/index.js"
 
 const app = express()
+const server = createHttpServer(app)
+const port = Number(process.env.PORT ?? 3000)
 
 app.post("/api/socket/ChatRoom/:actorId", async (request, response) => {
     const grant = await actors.ChatRoom.prepareWebsocket({
@@ -14,7 +17,7 @@ app.post("/api/socket/ChatRoom/:actorId", async (request, response) => {
 })
 
 const vite = await createServer({
-    server: { middlewareMode: true, fs: { deny: [".env", ".env.*", "**/.durable-actors/**", "**/.little-actors/**", "**/.git/**"] } }
+    server: { middlewareMode: true, hmr: { server }, fs: { deny: [".env", ".env.*", "**/.durable-actors/**", "**/.git/**"] } }
 })
 app.use(vite.middlewares)
-app.listen(3000, "127.0.0.1", () => console.log("Chat: http://127.0.0.1:3000"))
+server.listen(port, "127.0.0.1", () => console.log(`Chat: http://127.0.0.1:${port}`))

package/dist/templates/documents/.env.example

@@ -0,0 +1,6 @@
+DURABLE_ACTORS_PROJECT_ID=documents-example
+DURABLE_ACTORS_SECRET=local-documents-example
+DURABLE_ACTORS_CONTROL_PLANE_URL=http://127.0.0.1:7100
+DURABLE_ACTORS_PORT=7100
+DURABLE_ACTORS_BINARY=
+PORT=3000

package/dist/templates/documents/README.md

@@ -1,38 +1,53 @@
-# Shared documents
+# Collaborative documents
 
-Requires Node.js 20+ and Bun 1.4.2+ on your PATH; Bun executes the actors.
+A Tiptap editor with Yjs for concurrent edits and durable actors for saved documents. Edit together in multiple tabs, then reload to pick up where you left off.
 
-A small Tiptap editor with Yjs for concurrent edits and durable actors for saved documents.
+## Run locally
 
-## Run it
+Requires Node.js 22.19+ and Bun 1.4.2+.
 
 ```sh
 npx durable-actors init documents-example --template documents
 cd documents-example
 npm install
-npx durable-actors generate
-npx durable-actors dev
+cp .env.example .env
+npm run dev:actors
 ```
 
-Wait for `Local actors ready`. In another terminal, run the printed export command, then:
+Already in the example directory? Start at `npm install`.
+
+Wait for `Ready`. In another terminal in the same directory:
 
 ```sh
 npm run dev
 ```
 
-Open [the editor](http://127.0.0.1:3000) in two tabs. Type in Welcome, format some text, and edit from both tabs. Add another document and switch between them. Reload after changes arrive in the other tab to see the saved content.
+Open [localhost:3000](http://127.0.0.1:3000) in two tabs. Edit **Welcome** from both, add another document, and switch between them. Restart the servers and reload to restore saved documents.
+
+## Save and share documents
+
+[src/actors.ts](src/actors.ts) defines two actors:
+
+- `Workspace` saves the document list.
+- `Document` merges Yjs updates, saves the merged content, and broadcasts it to connected editors. Each document ID has its own actor.
 
-If you already have this directory, start at `npm install`. No external service is needed.
+A document joins through the [Express backend](src/backend.ts):
+
+```ts
+import { actors } from "../generated/index.js"
+
+const grant = await actors.Document.prepareWebsocket({
+    actorId: "welcome",
+    metadata: null
+})
+```
 
-## The code
+The [collaboration client](src/collaboration.ts) opens the returned `websocketUrl` and exchanges Yjs updates. [App.tsx](src/App.tsx) handles document navigation; [Editor.tsx](src/Editor.tsx) connects Tiptap to the shared document.
 
-- [src/durable-objects.ts](src/durable-objects.ts): a workspace actor stores the document list; one document actor per ID merges and saves Yjs state. The actors send initial data in `onConnect` and broadcast updates explicitly.
-- [src/backend.ts](src/backend.ts): issues WebSocket credentials using the generated `prepareWebsocket` helpers and local defaults.
-- [src/collaboration.ts](src/collaboration.ts): connects Yjs to a native WebSocket. It sends local updates and applies remote state without echoing it.
-- [src/App.tsx](src/App.tsx) and [src/Editor.tsx](src/Editor.tsx): document navigation and Tiptap’s editor, formatting controls, and collaborative undo/redo.
+Editing pauses while disconnected. Reload to reconnect; unsaved edits are not stored in the browser. This demo shares one workspace without authentication. Add user authentication and document access checks before issuing WebSocket URLs in your app.
 
-Yjs updates are encoded as base64 strings to fit the SDK’s JSON protocol. The actor saves the Yjs state, preserving the information needed to merge concurrent edits. Clients receive the complete merged document after each edit; this keeps the sample small rather than optimizing for large documents.
+## Development
 
-Editing pauses while disconnected. Reload to request a fresh connection. There is no automatic reconnect or browser storage for unsaved edits. Keep `.durable-actors/` and restart both servers to restore saved documents.
+Both processes read `.env`; saved state lives in `.durable-actors/`. Actor code reloads automatically. After changing public actor types, restart `npm run dev` to regenerate the client. For multiple examples, set distinct `PORT`, `DURABLE_ACTORS_PORT`, and matching control-plane URLs; see [Run the examples together](../README.md).
 
-This demo has one shared workspace and no authentication. In an application, authenticate the proxy route and authorize access to the requested workspace or document. Presence cursors, document deletion, and permissions UI are left out.
+`npm run build` generates clients, checks TypeScript, and builds the frontend.

package/dist/templates/documents/gitignore

@@ -2,7 +2,6 @@ node_modules/
 dist/
 generated/
 .durable-actors/
-.little-actors/
 .env
 .env.*
 !.env.example

package/dist/templates/documents/package.json

@@ -6,8 +6,9 @@
         "node": ">=22.19.0"
     },
     "scripts": {
-        "dev": "tsx src/backend.ts",
-        "build": "tsc --noEmit && vite build"
+        "dev": "durable-actors generate && tsx --env-file=.env src/backend.ts",
+        "dev:actors": "durable-actors dev",
+        "build": "durable-actors generate && tsc --noEmit && vite build"
     },
     "dependencies": {
         "@tiptap/core": "^3.31.3",
@@ -18,7 +19,7 @@
         "@tiptap/y-tiptap": "^3.0.7",
         "express": "^5.2.1",
         "lib0": "^0.2.117",
-        "durable-actors": "0.2.4",
+        "durable-actors": "0.2.7",
         "react": "^19.3.0",
         "react-dom": "^19.3.0",
         "yjs": "^13.6.32"