@nimbus-sh/loom 0.1.0 → 0.1.2

package/README.md

@@ -4,21 +4,42 @@
 > cloud OS. This README is edited and maintained with Claude (AI) and
 > presented as-is.
 
-An actor framework for Cloudflare Durable Objects. On top it is
+An actor framework for Cloudflare Durable Objects.
+
+`Actor extends Server`, so it keeps
 [partyserver](https://github.com/cloudflare/partykit/tree/main/packages/partyserver)'s
-surface, unchanged: `Actor extends Server`, so routing, connections, tags,
-broadcast, and hibernation work exactly as partyserver documents them.
-Underneath it is [`@nimbus-sh/fabric`](https://www.npmjs.com/package/@nimbus-sh/fabric),
-the Durable Object machinery Nimbus runs in production, pre-wired so an
-embedder writes one class instead of the wiring.
+surface unchanged. Routing, connections, tags, broadcast, and hibernation
+work as partyserver documents them. The machinery under that surface is
+[`@nimbus-sh/fabric`](https://www.npmjs.com/package/@nimbus-sh/fabric), the
+Durable Object code Nimbus runs in production. It arrives pre-wired, so you
+write one class instead of the wiring.
 
-Cloudflare's own Agents SDK takes the same shape (`Agent extends Server`).
-Where the two overlap, loom keeps the SDK's API and wire protocol so its
-clients are not surprised, and swaps the machinery for fabric's where
-fabric's is measurably stronger. Every such claim below was verified against
-the shipped `agents` 0.20.1 dist, not its docs. partyserver is pinned to an
-exact version (0.5.10); loom extends its prototype surface, and a floating
-prototype dependency is a drift channel.
+Use it for anything that lives in a Durable Object and holds state between
+requests. An agent, a room, a job runner, a session.
+
+## Install
+
+```bash
+npm install @nimbus-sh/loom
+```
+
+## Requirements
+
+Set `compatibility_flags: ["nodejs_compat"]` in your Worker. Loom dispatches
+timers through fabric, and fabric's dispatcher imports `AsyncLocalStorage`
+from `node:async_hooks`. Without the flag the module fails to load at deploy
+time.
+
+Actor classes must be SQLite-backed Durable Objects. State and schedules
+live in the actor's own SQLite.
+
+The root export pulls `partyserver`, which imports `cloudflare:workers`, so
+`import ... from '@nimbus-sh/loom'` resolves only inside a Worker. Outside
+workerd (unit tests, browsers), import the subpaths.
+`@nimbus-sh/loom/client.js` and `@nimbus-sh/loom/protocol.js` need no
+workerd. `@nimbus-sh/loom/schedules.js` is structurally typed for
+plain-process tests, like fabric's. partyserver is pinned to an exact
+version (0.5.10), because loom extends its prototype surface.
 
 ## One class
 
@@ -57,107 +78,133 @@ export default {
 } satisfies ExportedHandler<Env>;
 ```
 
-`routeActorRequest` and `getActorByName` are partyserver's router
-re-exported, URL convention included (`/parties/<binding>/<name>`); a
-parallel implementation would drift. Actor classes must be SQLite-backed
-Durable Objects (`new_sqlite_classes`, the default for new classes); state
-and schedules live in the actor's own SQLite.
+Bind the class, and give it a SQLite migration:
+
+```jsonc
+// wrangler.jsonc
+{
+  "compatibility_flags": ["nodejs_compat"],
+  "durable_objects": {
+    "bindings": [{ "name": "Counter", "class_name": "Counter" }]
+  },
+  "migrations": [{ "tag": "v1", "new_sqlite_classes": ["Counter"] }]
+}
+```
+
+`POST /parties/counter/room-1` now reaches `onRequest` on the actor named
+`room-1`. `routeActorRequest` and `getActorByName` are partyserver's router,
+re-exported with its URL convention: the path segment is the binding name in
+kebab case.
 
-## The floor you inherit
+Define hooks (`onMessage`, `onConnect`, ...) as methods, not instance
+fields. Loom wraps them at construction to do the floor work and consume
+protocol frames. An instance field assigns over that wiring.
+
+## Cold start and the init gate
+
+Nothing async belongs on the init gate. The constructor is synchronous, and
+partyserver's gate runs your `onStart`. A gate callback still pending at
+~30 s is cancelled, and that resets the object, so keep `onStart` short.
 
-**Nothing async on the init gate.** The constructor is synchronous.
-partyserver's gate runs exactly your `onStart`, and a gate callback still
-pending at ~30 s is cancelled and resets the object, so `onStart` must stay
-short. Work that belongs to a fresh incarnation goes through
+Work that belongs to a fresh incarnation goes through
 `this.deferToColdStart(task)` and runs on the first turn the actor owns.
 Generation adoption (`this.generation`, fabric's incarnation counter) and
-fenced-work recovery ride the same turn.
-
-**One alarm, many reasons.** A Durable Object has one alarm, and a second
-`setAlarm()` silently overwrites the first. `alarm()` therefore dispatches
-fabric's reason map: register a reason with `registerTimerReason` in the
-constructor, arm it with `this.timers.schedule(reason, whenMs)`, re-arm by
-returning `{ rearmAt }` from the handler. The schedule API and every outbox
-are reasons in the same map, so nothing clobbers anything.
-
-**Scheduling.** `schedule(when, callback, payload?)` takes a delay in
-seconds, a `Date`, or a cron expression; `scheduleEvery(intervalSeconds,
-...)` is a fixed interval. `getScheduleById`, `listSchedules`,
-`cancelSchedule` read and cancel. The callback receives
-`(payload, invocation)` where the invocation carries the schedule, the
-attempt number, and the platform's `alarmInfo` (`isRetry`, `retryCount`),
-which the Agents SDK drops. Retries are durable: a failed attempt writes its
-backed-off deadline into the row, so the budget survives an instance reset
-instead of sleeping inside the alarm turn. Times are epoch milliseconds.
-
-**State sync.** Declare `initialState`, read `this.state`, write
-`setState(next)`. State persists to SQLite and broadcasts to every
-connection as a `cf_agent_state` frame (the Agents wire protocol, so its
-clients work as-is). A client can send the same frame back;
-`validateStateChange(next, source)` vetoes synchronously before anything
+fenced-work recovery run on that same turn.
+
+## Timers
+
+A Durable Object has one alarm, and a second `setAlarm()` silently
+overwrites the first. `alarm()` therefore dispatches fabric's reason map.
+Register a reason with `registerTimerReason` in the constructor. Arm it with
+`this.timers.schedule(reason, whenMs)`. Re-arm it by returning
+`{ rearmAt }` from the handler. The schedule API and every outbox are
+reasons in the same map, so they do not overwrite each other.
+
+## Scheduling
+
+`schedule(when, callback, payload?)` takes a delay in seconds, a `Date`, or
+a cron expression. `scheduleEvery(intervalSeconds, ...)` is a fixed
+interval. `getScheduleById`, `listSchedules`, `cancelSchedule` read and
+cancel. The callback receives `(payload, invocation)`. The invocation
+carries the schedule, the attempt number, and the platform's `alarmInfo`
+(`isRetry`, `retryCount`), which the Agents SDK drops.
+
+Retries are durable. A failed attempt writes its backed-off deadline into
+the row, so the budget survives an instance reset. Nothing sleeps inside the
+alarm turn. Times are epoch milliseconds.
+
+## State sync
+
+Declare `initialState`, read `this.state`, write `setState(next)`. State
+persists to SQLite and broadcasts to every connection as a `cf_agent_state`
+frame (the Agents wire protocol, so its clients work as-is).
+
+A client can send the same frame back.
+`validateStateChange(next, source)` vetoes it synchronously before anything
 persists, and `onStateChanged(state, source)` runs after. A refused client
-update earns a `cf_agent_state_error` frame.
-
-**Callable RPC.** Mark a method `@callable()` and any connection can invoke
-it by name; everything unmarked is refused. `@callable({ streaming: true })`
-prepends a `StreamingResponse` to the arguments for chunked replies. The
-caller side is `actorClient(socket)` from `@nimbus-sh/loom/client.js` —
-dependency-free and workerd-free, with `call(method, args)` and a typed
-`stub<T>()` proxy.
-
-**Per-connection state.** `this.connections(schema)` is fabric's typed,
-validated, hibernation-durable attachment state over partyserver's
-`Connection` surface: `read` validates instead of casting (an attachment
-written by a previous deploy is untrusted input), `write` validates on the
-way in, tags address connections. partyserver owns the accept; tag
-connections in `getConnectionTags`. Hibernating actors only — the state
-rides the hibernatable socket attachment, and a non-hibernating actor is
-refused with an error rather than corrupted later.
-
-**Durable messaging.** `this.outbox(name, policy)` is a write-ahead retry
-outbox (dispositions, per-key ordering, dead letters), its drain registered
-as a timer reason the moment you create it. Create outboxes in the
-constructor: a queued row survives an instance reset, but the alarm
-dispatcher drops a fired reason no handler answers, so an outbox first
-created inside a request path is unregistered until that path runs again.
-`this.journal(name)` is an append-only event log with dedupe and
-self-expiring delivery leases.
-
-**Processes and facets.** `this.facets` leases DO facets so reclaiming
-storage is the default and leaking it takes an explicit `detach()`.
-`this.processes` is fabric's process fabric over a substrate you declare by
-overriding `processHost()`. `this.derived` / `this.derivedAsync` are the
-watermark memos.
-
-**Hibernation, configured.** `static options = { hibernate: true }` opts
-into partyserver's hibernation and also applies fabric's config: `ping`/
-`pong` auto-response (a matched frame no longer wakes the actor) and the 5 s
-hibernatable-event timeout. `this.hibernation` reports what the runtime
-supported. State your fabric composition once, on the class:
-`static options = { fabric: { supervisorEntrypoint: '...' } }`.
+update gets a `cf_agent_state_error` frame.
 
-Define hooks (`onMessage`, `onConnect`, ...) as methods, not instance
-fields. Loom wraps them at construction to pay the floor work and consume
-protocol frames; an instance field assigns over the wiring.
+## Callable RPC
 
-## What this is not
+Mark a method `@callable()` and any connection can invoke it by name;
+everything unmarked is refused. `@callable({ streaming: true })` prepends a
+`StreamingResponse` to the arguments for chunked replies.
 
-There is no chat surface, no MCP, no email routing, no React hooks, and no
-Workflows integration. That is the Agents SDK's product surface; loom stops
-at the framework layer. If you need those today, use `agents` — its `Agent`
-and loom's `Actor` are siblings on the same partyserver base, and they do
-not share a Durable Object.
+The caller side is `actorClient(socket)` from `@nimbus-sh/loom/client.js`.
+It has no dependencies, needs no workerd, and gives you `call(method, args)`
+and a typed `stub<T>()` proxy.
 
-## Importing it
+## Per-connection state
 
-Your Worker must set `compatibility_flags: ["nodejs_compat"]`. Loom dispatches
-timers through fabric, and fabric's dispatcher imports `AsyncLocalStorage`
-from `node:async_hooks`. Without the flag the module fails to load at deploy
-time.
+`this.connections(schema)` is fabric's attachment state over partyserver's
+`Connection` surface: typed, validated, and durable across hibernation.
+`read` validates rather than casts, because an attachment written by a
+previous deploy is untrusted input. `write` validates on the way in, and
+tags address connections. partyserver owns the accept; tag connections in
+`getConnectionTags`.
 
-The root export pulls `partyserver`, which imports `cloudflare:workers`, so
-`import ... from '@nimbus-sh/loom'` resolves only inside a Worker. Outside
-workerd (unit tests, browsers) import subpaths: `@nimbus-sh/loom/client.js`
-and `@nimbus-sh/loom/protocol.js` are workerd-free by design, and
-`@nimbus-sh/loom/schedules.js` is structurally typed for plain-process
-tests, the same discipline as fabric.
+The state rides the hibernatable socket attachment, so a non-hibernating
+actor is refused with an error.
+
+## Durable messaging
+
+`this.outbox(name, policy)` is a write-ahead retry outbox with
+dispositions, per-key ordering, and dead letters. `this.journal(name)` is an
+append-only event log with dedupe and self-expiring delivery leases.
+
+Create outboxes in the constructor. An outbox registers its drain as a timer
+reason the moment you create it. The alarm dispatcher drops a fired reason
+that no handler answers. An outbox first created inside a request path stays
+unregistered until that path runs again. A queued row survives an instance
+reset.
+
+## Processes and facets
+
+`this.facets` leases DO facets, so the lease reclaims their storage by
+default. An explicit `detach()` leaves the storage behind. `this.processes`
+is fabric's process fabric over a substrate you declare by overriding
+`processHost()`. `this.derived` / `this.derivedAsync` are the watermark
+memos.
+
+Declare the fabric composition on the class:
+`static options = { fabric: { supervisorEntrypoint: '...' } }`.
+
+## Hibernation
+
+`static options = { hibernate: true }` opts into partyserver's hibernation.
+It also applies fabric's config: `ping`/`pong` auto-response (a matched
+frame no longer wakes the actor) and the 5 s hibernatable-event timeout.
+`this.hibernation` reports what the runtime supported.
+
+## Compared to the Agents SDK
+
+Cloudflare's own Agents SDK takes the same shape (`Agent extends Server`).
+Where the two overlap, loom keeps the SDK's API and wire protocol, so its
+clients keep working. Underneath it swaps the machinery for fabric's. The
+comparison here holds against the shipped `agents` 0.20.1 dist.
+
+Loom has no chat surface, no MCP, no email routing, no React hooks, and no
+Workflows integration. Those belong to the Agents SDK's product surface, and
+loom stops at the framework layer. If you need them today, use `agents`. Its
+`Agent` and loom's `Actor` are siblings on the same partyserver base, and
+they do not share a Durable Object.

package/dist/actor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../src/actor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../src/actor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAA0C,MAAM,aAAa,CAAC;AAQ9F,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,kBAAkB,EAEvB,KAAK,MAAM,EACZ,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAA0B,KAAK,MAAM,EAAsB,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACzH,OAAO,EAA4B,KAAK,OAAO,EAAuB,MAAM,8BAA8B,CAAC;AAC3G,OAAO,EAAa,KAAK,SAAS,EAAyB,MAAM,iCAAiC,CAAC;AACnG,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,8BAA8B,CAAC;AAMtC,OAAO,EACL,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAEtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAEL,KAAK,QAAQ,EAEb,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAIxB,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAErD,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,kDAAkD;IAClD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACpC,yDAAyD;IACzD,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IACjC,+EAA+E;IAC/E,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CAAC;IACvC;;;OAGG;IACH,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC;IACvC,uDAAuD;IACvD,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC;CACpD;AAcD,qBAAa,KAAK,CAChB,GAAG,SAAS,UAAU,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,EAC3C,KAAK,GAAG,OAAO,EACf,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC/D,SAAQ,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC;;IAC1B,OAAe,OAAO,EAAE,YAAY,CAAC;IAErC,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,yBAAyB,GAAG,IAAI,CAAQ;IAE9D;;;OAGG;IACK,YAAY,EAAE,KAAK,CAAC;gBAahB,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,GAAG;IAuE7C;;;;OAIG;IACY,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE;;;;;;;;OAQG;IACY,KAAK,CAAC,SAAS,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/D,wFAAwF;IAC/E,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAExC;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,KAAK,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,GAChG,IAAI;IASP;;;;;;OAMG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxB,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAC5B,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,EAC7B,OAAO,CAAC,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAOvB,wFAAwF;IAClF,aAAa,CAAC,CAAC,GAAG,OAAO,EAC7B,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,EAC7B,OAAO,CAAC,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAOjB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAI1E,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAI1F,qDAAqD;IAC/C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IA0BzD;;;OAGG;IACH,IAAI,KAAK,IAAI,KAAK,CAQjB;IAED,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI5B;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI;IAEvE,gEAAgE;IAChE,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA2FnF,2DAA2D;IAC3D,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,2EAA2E;IAC3E,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAS3D,kEAAkE;IAClE,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAQpC,4EAA4E;IAC5E,IAAI,MAAM,IAAI,SAAS,CAGtB;IAED;;;;OAIG;IACH,IAAI,SAAS,IAAI,aAAa,CAG7B;IAED,wEAAwE;IACxE,SAAS,CAAC,WAAW,IAAI,WAAW;IAMpC,6EAA6E;IAC7E,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EACjB,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,EAC1C,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,CAAC,EAC9C,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAIhB,+EAA+E;IAC/E,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EACtB,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,EACnD,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACvD,KAAK,CAAC,EAAE,iBAAiB,GACxB,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAIrB;;;;;;;;;;OAUG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;IA0BzD;;;;OAIG;IACH,SAAS,CAAC,SAAS,CAAC,CAAC,SAAS,gBAAgB,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAMvF;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;CAO/D"}

package/dist/actor.js

@@ -396,7 +396,8 @@ export class Actor extends Server {
     }
     /** Leased facets: disposal retires (storage wiped), `detach()` keeps it. */
     get facets() {
-        return (this.#facets ??= facetPool(this.ctx));
+        this.#facets ??= facetPool(this.ctx);
+        return this.#facets;
     }
     /**
      * The process fabric over this actor's substrate. Declare the substrate
@@ -404,7 +405,8 @@ export class Actor extends Server {
      * use.
      */
     get processes() {
-        return (this.#processes ??= new ProcessFabric(this.processHost()));
+        this.#processes ??= new ProcessFabric(this.processHost());
+        return this.#processes;
     }
     /** The substrate {@link processes} runs on. Override to declare one. */
     processHost() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbus-sh/loom",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "The actor framework of Nimbus: partyserver's surface on top, the @nimbus-sh/fabric Durable Object floor pre-wired underneath.",
   "keywords": [
     "cloudflare",
@@ -47,11 +47,11 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json --noCheck --noEmit false --declaration true --declarationMap true --outDir dist --rootDir src",
-    "prepack": "npm run build",
+    "prepack": "bun run build",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@nimbus-sh/fabric": "^0.2.0",
+    "@nimbus-sh/fabric": "^0.6.0",
     "cron-schedule": "^6.0.0",
     "partyserver": "0.5.10",
     "zod": "^4.4.3"

package/src/actor.ts

@@ -538,7 +538,8 @@ export class Actor<
 
   /** Leased facets: disposal retires (storage wiped), `detach()` keeps it. */
   get facets(): FacetPool {
-    return (this.#facets ??= facetPool(this.ctx as unknown as FacetPoolContext));
+    this.#facets ??= facetPool(this.ctx as unknown as FacetPoolContext);
+    return this.#facets;
   }
 
   /**
@@ -547,7 +548,8 @@ export class Actor<
    * use.
    */
   get processes(): ProcessFabric {
-    return (this.#processes ??= new ProcessFabric(this.processHost()));
+    this.#processes ??= new ProcessFabric(this.processHost());
+    return this.#processes;
   }
 
   /** The substrate {@link processes} runs on. Override to declare one. */