durable-actors 0.7.16 → 0.8.1

package/README.md

@@ -6,15 +6,15 @@ Durable actors and typed clients, backed by the Rust runtime.
 
 ## Quickstart
 
-Requires Node.js 22.19+, pnpm, and Bun 1.3.9+.
+Requires Bun 1.4.2+.
 
 ```sh
-npx durable-actors init my-actors
+bunx durable-actors init my-actors
 cd my-actors
-pnpm install
+bun install
 ```
 
-Define `src/actors.ts`. Fields marked `@Persisted` survive restarts. They share one SQLite database and transaction with `this.db` SQL. Litestream is installed and managed automatically with the runtime; local development persists to the filesystem.
+Define `src/actors.ts`. Fields marked `@Persisted` survive restarts. They share one SQLite database and transaction with `this.db` SQL. The Rust runtime owns the database and replicates it with Litestream; local development persists to the filesystem.
 
 ```ts
 import { Actor, Persisted } from "durable-actors"
@@ -29,7 +29,7 @@ export class Counter extends Actor {
 ```
 
 ```sh
-pnpm exec durable-actors dev
+bunx durable-actors dev
 ```
 
 ## Call an actor
@@ -37,7 +37,7 @@ pnpm exec durable-actors dev
 In another terminal in the same directory, generate the client:
 
 ```sh
-pnpm exec durable-actors generate
+bunx durable-actors generate
 ```
 
 Save as `client.ts` and run `bun client.ts`:

package/bin/durable-actors.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+import "../dist/cli.js"

package/dist/actor/actor.d.ts

@@ -1,9 +1,13 @@
 import type { JsonObject, JsonValue } from "../json.js";
+import type { ActorAlarm } from "./alarm.js";
+import type { ActorContext } from "./context.js";
+import { RuntimeActorContext } from "./context.js";
 import type { ActorDatabase } from "./database.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;
+declare let actorContext: (value: object) => RuntimeActorContext | undefined;
 interface Actor<Metadata = JsonValue, Incoming = JsonValue, Outgoing = Incoming, Tag extends string = string> {
     /** Accepts a joining connection on success. Call `socket.reject(4003, reason)` to deny it. */
     onConnect?(socket: ActorSocket<Metadata, Outgoing, Tag>): Promise<void>;
@@ -11,16 +15,20 @@ interface Actor<Metadata = JsonValue, Incoming = JsonValue, Outgoing = Incoming,
     onMessage?(socket: ActorSocket<Metadata, Outgoing, Tag>, message: Incoming): Promise<void>;
     /** Runs after disconnection; may be skipped on server failure. */
     onDisconnect?(socket: ActorSocket<Metadata, Outgoing, Tag>, code: number, reason: string, wasClean: boolean): Promise<void>;
+    /** Runs when the actor's scheduled alarm becomes due. The alarm is cleared afterward unless this callback sets a new one. */
+    onAlarm?(): Promise<void>;
 }
 /**
- * Base class for durable actors. Extend directly, with no required constructor arguments.
+ * Base class for durable actors. Extend directly; explicit constructors must pass their `ActorContext` to `super`.
  * Application methods must be async; instance fields require `@Persisted` or `@Ephemeral`.
+ * Initialized private `ActorResource` fields are implicitly ephemeral.
  * @typeParam Metadata - Connection metadata supplied by the backend.
  * @typeParam Incoming - Application messages received by the actor.
  * @typeParam Outgoing - Application messages sent by the actor.
  * @typeParam Tag - Allowed connection tags.
  */
 declare abstract class Actor<Metadata = JsonValue, Incoming = JsonValue, Outgoing = Incoming, Tag extends string = string> {
+    #private;
     /** @internal */
     readonly [actorTypes]: {
         metadata: Metadata;
@@ -28,15 +36,17 @@ declare abstract class Actor<Metadata = JsonValue, Incoming = JsonValue, Outgoin
         outgoing: Outgoing;
         tag: Tag;
     };
-    protected constructor();
-    /** Actor-local SQLite. Changes commit with persisted fields after a successful invocation. */
-    protected get db(): ActorDatabase;
+    protected constructor(context: ActorContext);
+    /** Actor-local SQLite, available from field initializers. Changes commit after a successful invocation. */
+    get db(): ActorDatabase;
+    /** The actor's single durable alarm slot. */
+    get alarm(): ActorAlarm;
     /**
      * Returns a backend reference. The first call starts the actor if needed.
      * @param actorId - 1–128 ASCII letters, digits, dots, underscores, or hyphens.
      */
     static get<TActorClass extends ActorClass>(this: ValidActorClass<TActorClass>, actorId: string): ActorReference<TActorClass["prototype"]>;
-    /** The bound actor ID; unavailable during construction. */
+    /** The bound actor ID, available from field initializers. */
     protected get id(): string;
     /**
      * Lists connections during an actor call. Includes a joining socket; excludes a disconnected one.
@@ -53,7 +63,6 @@ declare abstract class Actor<Metadata = JsonValue, Incoming = JsonValue, Outgoin
 }
 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;
 }
@@ -69,24 +78,23 @@ type ActorClass<Instance extends AnyActor = AnyActor> = Function & {
     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 {
+type ValidActorClass<TActorClass extends ActorClass> = 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];
+    [Key in keyof Instance as Instance[Key] extends AsyncMethod ? Key extends ActorLifecycleMethod ? never : Key : never]: Instance[Key];
 } & {
     /** Opens a backend socket. Attach listeners immediately; acceptance may still be pending. */
     connect(metadata: SocketMetadata<Instance>): Promise<ActorConnection<SocketIncoming<Instance>, SocketOutgoing<Instance>, JsonObject>>;
     /** Sends to all connections without running actor code. Messages are not saved. */
     broadcast(message: SocketOutgoing<Instance>): Promise<void>;
 };
-type SocketLifecycleMethod = "onConnect" | "onMessage" | "onDisconnect";
+type ActorLifecycleMethod = "onConnect" | "onMessage" | "onDisconnect" | "onAlarm";
 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"];
@@ -95,6 +103,6 @@ type SocketTag<Instance extends AnyActor> = Instance[typeof actorTypes]["tag"];
 type ActorSocketOf<Instance extends AnyActor> = ActorSocket<SocketMetadata<Instance>, SocketOutgoing<Instance>, SocketTag<Instance>>;
 /** Incoming message type for an actor instance type. */
 type ActorMessageOf<Instance extends AnyActor> = SocketIncoming<Instance>;
-export { Actor, bindActorIdentity, findActorDefinition, registerActorClass };
-export type { ActorClass, ActorDefinition, ActorMessageOf, ActorReference, ActorSocketOf, AnyActor };
+export { Actor, actorContext, findActorDefinition, registerActorClass };
+export type { ActorClass, ActorContext, ActorDefinition, ActorMessageOf, ActorReference, ActorSocketOf, AnyActor };
 //# sourceMappingURL=actor.d.ts.map

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

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

package/dist/actor/actor.js

@@ -1,26 +1,37 @@
 import { actorClient } from "../client/client.js";
 import { ActorDefinitionError } from "../errors.js";
-import { actorDatabase } from "./database.js";
+import { RuntimeActorContext } from "./context.js";
 import { validateActorComponent } from "./identity.js";
 import { actorConnectionCount, actorConnections, broadcastActor, setActorAutoResponse } 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();
+const referenceClassKey = Symbol("actor reference class");
+let actorContext;
 /**
- * Base class for durable actors. Extend directly, with no required constructor arguments.
+ * Base class for durable actors. Extend directly; explicit constructors must pass their `ActorContext` to `super`.
  * Application methods must be async; instance fields require `@Persisted` or `@Ephemeral`.
+ * Initialized private `ActorResource` fields are implicitly ephemeral.
  * @typeParam Metadata - Connection metadata supplied by the backend.
  * @typeParam Incoming - Application messages received by the actor.
  * @typeParam Outgoing - Application messages sent by the actor.
  * @typeParam Tag - Allowed connection tags.
  */
 class Actor {
-    constructor() { }
-    /** Actor-local SQLite. Changes commit with persisted fields after a successful invocation. */
+    #context;
+    static {
+        actorContext = value => (#context in value ? value.#context : undefined);
+    }
+    constructor(context) {
+        this.#context = RuntimeActorContext.bind(context, this);
+    }
+    /** Actor-local SQLite, available from field initializers. Changes commit after a successful invocation. */
     get db() {
-        return actorDatabase(this);
+        return this.#context.database;
+    }
+    /** The actor's single durable alarm slot. */
+    get alarm() {
+        return this.#context.alarm;
     }
     /**
      * Returns a backend reference. The first call starts the actor if needed.
@@ -29,9 +40,9 @@ class Actor {
     static get(actorId) {
         return getActorReference(this, validateActorComponent("actor ID", actorId));
     }
-    /** The bound actor ID; unavailable during construction. */
+    /** The bound actor ID, available from field initializers. */
     get id() {
-        return metadataFor(this).actorId;
+        return this.#context.actorId;
     }
     /**
      * Lists connections during an actor call. Includes a joining socket; excludes a disconnected one.
@@ -53,8 +64,9 @@ class Actor {
 }
 function registerActorClass(actorClass, state) {
     const actorName = actorClassName(actorClass);
-    if (state.fields.some(field => field.name === "db"))
-        throw new ActorDefinitionError("actor field db is reserved for SQLite");
+    const reserved = state.fields.find(field => field.name === "db" || field.name === "alarm");
+    if (reserved !== undefined)
+        throw new ActorDefinitionError(`actor field ${reserved.name} is reserved for the actor runtime`);
     const existing = actorDefinitions.get(actorName);
     if (existing !== undefined) {
         if (existing.actorClass !== actorClass)
@@ -73,18 +85,13 @@ 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;
+    if (Object.hasOwn(actorClass, referenceClassKey))
+        return Reflect.get(actorClass, referenceClassKey);
     const definition = describeActorClass(actorClass);
     class ActorReference extends Actor {
         constructor(actorId) {
-            super();
-            bindActorIdentity(this, actorId);
+            super(RuntimeActorContext.reference(actorId));
         }
     }
     Object.defineProperty(ActorReference.prototype, "connect", {
@@ -92,9 +99,9 @@ function referenceClass(actorClass) {
         enumerable: false,
         writable: false,
         value: function connectActor(metadata) {
-            const actor = metadataFor(this);
+            const actorId = actorIdOf(this);
             const attachment = socketMetadata(metadata, definition.schemas);
-            return actorClient().then(client => client.connect(definition.actorName, actor.actorId, attachment, definition.schemas));
+            return actorClient().then(client => client.connect(definition.actorName, actorId, attachment, definition.schemas));
         }
     });
     Object.defineProperty(ActorReference.prototype, "broadcast", {
@@ -102,9 +109,9 @@ function referenceClass(actorClass) {
         enumerable: false,
         writable: false,
         value: function broadcastActorMessage(message) {
-            const actor = metadataFor(this);
+            const actorId = actorIdOf(this);
             const outgoing = outgoingMessage(message, definition.schemas);
-            return actorClient().then(client => client.broadcast(definition.actorName, actor.actorId, outgoing));
+            return actorClient().then(client => client.broadcast(definition.actorName, actorId, outgoing));
         }
     });
     definition.methods.forEach(method => {
@@ -113,19 +120,19 @@ function referenceClass(actorClass) {
             enumerable: false,
             writable: false,
             value: function forwardActorMethod(...args) {
-                const metadata = metadataFor(this);
-                return actorClient().then(client => client.invoke(definition.actorName, metadata.actorId, method, args));
+                const actorId = actorIdOf(this);
+                return actorClient().then(client => client.invoke(definition.actorName, actorId, method, args));
             }
         });
     });
-    referenceClasses.set(definition.actorClass, ActorReference);
+    Object.defineProperty(actorClass, referenceClassKey, { value: ActorReference });
     return ActorReference;
 }
-function metadataFor(instance) {
-    const metadata = actorMetadata.get(instance);
-    if (metadata === undefined)
+function actorIdOf(instance) {
+    const context = actorContext(instance);
+    if (context === undefined)
         throw new ActorDefinitionError("actor identity is unavailable outside an actor invocation");
-    return metadata;
+    return context.actorId;
 }
 function describeActorClass(actorClass) {
     const actorName = actorClassName(actorClass);
@@ -150,26 +157,26 @@ function discoverMethods(actorClass, actorName) {
         validateActorComponent("actor method", name);
         if (name === "then")
             throw new ActorDefinitionError(`actor class ${actorName} cannot define method then`);
-        if (name === "connect" || name === "broadcast" || name === "db")
+        if (name === "connect" || name === "broadcast" || name === "db" || name === "alarm")
             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 (name === "onAlarm" && descriptor.value.length !== 0)
+            throw new ActorDefinitionError(`actor lifecycle hook ${actorName}.onAlarm must take no arguments`);
         if (lifecycleMethods.has(name))
             return [];
         return [name];
     });
 }
-const lifecycleMethods = new Set(["onConnect", "onMessage", "onDisconnect"]);
+const lifecycleMethods = new Set(["onConnect", "onMessage", "onDisconnect", "onAlarm"]);
 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 };
+export { Actor, actorContext, findActorDefinition, registerActorClass };
 //# sourceMappingURL=actor.js.map

package/dist/actor/actor.js.map

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

package/dist/actor/alarm.d.ts

@@ -0,0 +1,19 @@
+/** One durable scheduled callback for an actor. */
+interface ActorAlarm {
+    /** Returns the scheduled Unix timestamp in milliseconds, or `null` when unset. */
+    get(): number | null;
+    /** Replaces the alarm with a Unix timestamp in milliseconds. Past timestamps are immediately due. */
+    set(timestampMs: number): void;
+    /** Clears the scheduled alarm. */
+    delete(): void;
+}
+interface ActorAlarmState {
+    readonly timestampMs: number | null;
+}
+interface ActorAlarmStorage {
+    getAlarmState(): ActorAlarmState;
+    setAlarm(timestampMs: number): void;
+    deleteAlarm(): void;
+}
+export type { ActorAlarm, ActorAlarmState, ActorAlarmStorage };
+//# sourceMappingURL=alarm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alarm.d.ts","sourceRoot":"","sources":["../../src/actor/alarm.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,UAAU,UAAU;IAChB,kFAAkF;IAClF,GAAG,IAAI,MAAM,GAAG,IAAI,CAAA;IACpB,qGAAqG;IACrG,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,kCAAkC;IAClC,MAAM,IAAI,IAAI,CAAA;CACjB;AAED,UAAU,eAAe;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CACtC;AAED,UAAU,iBAAiB;IACvB,aAAa,IAAI,eAAe,CAAA;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,WAAW,IAAI,IAAI,CAAA;CACtB;AAED,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/actor/alarm.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=alarm.js.map

package/dist/actor/alarm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alarm.js","sourceRoot":"","sources":["../../src/actor/alarm.ts"],"names":[],"mappings":""}

package/dist/actor/context.d.ts

@@ -0,0 +1,25 @@
+import type { ActorAlarm, ActorAlarmStorage } from "./alarm.js";
+import type { ActorDatabase } from "./database.js";
+declare const actorContextBrand: unique symbol;
+interface ActorContext {
+    readonly [actorContextBrand]: never;
+}
+declare class RuntimeActorContext implements ActorContext {
+    #private;
+    readonly [actorContextBrand]: never;
+    readonly actorId: string;
+    readonly persistedFields: Map<string, PropertyDescriptor>;
+    private constructor();
+    static runtime(actorId: string, database: ActorDatabase & ActorAlarmStorage): RuntimeActorContext;
+    static reference(actorId: string): RuntimeActorContext;
+    static bind(context: unknown, actor: object): RuntimeActorContext;
+    construct(actorClass: Function): object;
+    get database(): ActorDatabase;
+    get alarm(): ActorAlarm;
+    assertAccess(): void;
+    private guard;
+    private guardAlarm;
+}
+export { RuntimeActorContext };
+export type { ActorContext };
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/actor/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,eAAe,CAAA;AAI/D,OAAO,CAAC,MAAM,iBAAiB,EAAE,OAAO,MAAM,CAAA;AAE9C,UAAU,YAAY;IAClB,QAAQ,CAAC,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAA;CACtC;AAED,cAAM,mBAAoB,YAAW,YAAY;;IAC7C,SAAiB,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAA;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,eAAe,kCAAwC;IAMhE,OAAO;IAMP,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,iBAAiB,GAAG,mBAAmB;IAIjG,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB;IAItD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB;IAOjE,SAAS,CAAC,UAAU,EAAE,QAAQ,GAAG,MAAM;IAYvC,IAAI,QAAQ,IAAI,aAAa,CAI5B;IAED,IAAI,KAAK,IAAI,UAAU,CAItB;IAED,YAAY,IAAI,IAAI;IAKpB,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,UAAU;CAkBrB;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAC9B,YAAY,EAAE,YAAY,EAAE,CAAA"}

package/dist/actor/context.js

@@ -0,0 +1,83 @@
+import { ActorDefinitionError, ActorValidationError } from "../errors.js";
+import { isActorInvocation } from "./database.js";
+import { validateActorComponent } from "./identity.js";
+class RuntimeActorContext {
+    actorId;
+    persistedFields = new Map();
+    #database;
+    #alarm;
+    #actor;
+    #constructing = false;
+    constructor(actorId, database) {
+        this.actorId = validateActorComponent("actor ID", actorId);
+        this.#database = database && this.guard(database);
+        this.#alarm = database && this.guardAlarm(database);
+    }
+    static runtime(actorId, database) {
+        return new RuntimeActorContext(actorId, database);
+    }
+    static reference(actorId) {
+        return new RuntimeActorContext(actorId);
+    }
+    static bind(context, actor) {
+        if (typeof context !== "object" || context === null || !(#actor in context) || context.#actor !== undefined)
+            throw new ActorDefinitionError("actors are constructed by the actor runtime");
+        context.#actor = actor;
+        return context;
+    }
+    construct(actorClass) {
+        this.#constructing = true;
+        try {
+            const actor = Reflect.construct(actorClass, [this]);
+            if (this.#actor !== actor)
+                throw new ActorDefinitionError("actor constructors must call super with their ActorContext");
+            return actor;
+        }
+        finally {
+            this.#constructing = false;
+        }
+    }
+    get database() {
+        if (this.#database === undefined)
+            throw new ActorDefinitionError("actor database is unavailable outside the actor runtime");
+        return this.#database;
+    }
+    get alarm() {
+        if (this.#alarm === undefined)
+            throw new ActorDefinitionError("actor alarm is unavailable outside the actor runtime");
+        return this.#alarm;
+    }
+    assertAccess() {
+        if (this.#constructing || (this.#actor !== undefined && isActorInvocation(this.#actor)))
+            return;
+        throw new ActorDefinitionError("actor database is unavailable outside its invocation");
+    }
+    guard(database) {
+        return {
+            exec: (sql, ...bindings) => {
+                this.assertAccess();
+                return database.exec(sql, ...bindings);
+            }
+        };
+    }
+    guardAlarm(alarm) {
+        return {
+            get: () => {
+                this.assertAccess();
+                return alarm.getAlarmState().timestampMs;
+            },
+            set: timestampMs => {
+                this.assertAccess();
+                if (!Number.isSafeInteger(timestampMs))
+                    throw new ActorValidationError("actor alarm timestamp must be a safe integer");
+                alarm.setAlarm(timestampMs);
+            },
+            delete: () => {
+                this.assertAccess();
+                alarm.deleteAlarm();
+            }
+        };
+    }
+}
+export { RuntimeActorContext };
+//# sourceMappingURL=context.js.map

package/dist/actor/context.js.map

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

package/dist/actor/database.d.ts

@@ -3,9 +3,10 @@ interface ActorDatabase {
     /** Executes one SQL statement with positional bindings and returns its rows. */
     exec<Row extends object = Record<string, SqliteValue>>(sql: string, ...bindings: SqliteValue[]): Row[];
 }
-declare function actorDatabase(actor: object): ActorDatabase;
-declare function bindActorDatabase(actor: object, database: ActorDatabase): void;
-declare function runWithActorDatabase<T>(actor: object, operation: () => Promise<T>): Promise<T>;
-export { actorDatabase, bindActorDatabase, runWithActorDatabase };
+type PersistenceMode = "atomic" | "immediate";
+declare function isActorInvocation(actor: object): boolean;
+declare function actorDatabaseMode(): PersistenceMode | undefined;
+declare function runWithActorDatabase<T>(actor: object, mode: PersistenceMode, operation: () => Promise<T>): Promise<T>;
+export { actorDatabaseMode, isActorInvocation, runWithActorDatabase };
 export type { ActorDatabase, SqliteValue };
 //# sourceMappingURL=database.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/actor/database.ts"],"names":[],"mappings":"AAIA,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAA;AAE/D,UAAU,aAAa;IACnB,gFAAgF;IAChF,IAAI,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,EAAE,CAAA;CACzG;AAKD,iBAAS,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAInD;AAED,iBAAS,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CASvE;AAED,iBAAe,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAO7F;AAED,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAA;AACjE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/actor/database.ts"],"names":[],"mappings":"AAEA,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAA;AAE/D,UAAU,aAAa;IACnB,gFAAgF;IAChF,IAAI,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,EAAE,CAAA;CACzG;AAED,KAAK,eAAe,GAAG,QAAQ,GAAG,WAAW,CAAA;AAU7C,iBAAS,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED,iBAAS,iBAAiB,IAAI,eAAe,GAAG,SAAS,CAGxD;AAED,iBAAe,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOpH;AAED,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAA;AACrE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA"}

package/dist/actor/database.js

@@ -1,25 +1,15 @@
 import { AsyncLocalStorage } from "node:async_hooks";
-import { ActorDefinitionError } from "../errors.js";
-const databases = new WeakMap();
 const invocation = new AsyncLocalStorage();
-function actorDatabase(actor) {
-    const database = databases.get(actor);
-    if (database === undefined)
-        throw new ActorDefinitionError("actor database is unavailable during construction");
-    return database;
+function isActorInvocation(actor) {
+    const context = invocation.getStore();
+    return context?.actor === actor && context.active;
 }
-function bindActorDatabase(actor, database) {
-    databases.set(actor, {
-        exec(sql, ...bindings) {
-            const context = invocation.getStore();
-            if (context?.actor !== actor || !context.active)
-                throw new ActorDefinitionError("actor database is unavailable outside its invocation");
-            return database.exec(sql, ...bindings);
-        }
-    });
+function actorDatabaseMode() {
+    const context = invocation.getStore();
+    return context?.active ? context.mode : undefined;
 }
-async function runWithActorDatabase(actor, operation) {
-    const context = { actor, active: true };
+async function runWithActorDatabase(actor, mode, operation) {
+    const context = { actor, active: true, mode };
     try {
         return await invocation.run(context, operation);
     }
@@ -27,5 +17,5 @@ async function runWithActorDatabase(actor, operation) {
         context.active = false;
     }
 }
-export { actorDatabase, bindActorDatabase, runWithActorDatabase };
+export { actorDatabaseMode, isActorInvocation, runWithActorDatabase };
 //# sourceMappingURL=database.js.map

package/dist/actor/database.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/actor/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AASnD,MAAM,SAAS,GAAG,IAAI,OAAO,EAAyB,CAAA;AACtD,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAAsC,CAAA;AAE9E,SAAS,aAAa,CAAC,KAAa;IAChC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,QAAQ,KAAK,SAAS;QAAE,MAAM,IAAI,oBAAoB,CAAC,mDAAmD,CAAC,CAAA;IAC/G,OAAO,QAAQ,CAAA;AACnB,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa,EAAE,QAAuB;IAC7D,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE;QACjB,IAAI,CAAqB,GAAW,EAAE,GAAG,QAAuB;YAC5D,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAA;YACrC,IAAI,OAAO,EAAE,KAAK,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM;gBAC3C,MAAM,IAAI,oBAAoB,CAAC,sDAAsD,CAAC,CAAA;YAC1F,OAAO,QAAQ,CAAC,IAAI,CAAM,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAA;QAC/C,CAAC;KACJ,CAAC,CAAA;AACN,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAI,KAAa,EAAE,SAA2B;IAC7E,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IACvC,IAAI,CAAC;QACD,OAAO,MAAM,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACnD,CAAC;YAAS,CAAC;QACP,OAAO,CAAC,MAAM,GAAG,KAAK,CAAA;IAC1B,CAAC;AACL,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/actor/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAiBpD,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAA0B,CAAA;AAElE,SAAS,iBAAiB,CAAC,KAAa;IACpC,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAA;IACrC,OAAO,OAAO,EAAE,KAAK,KAAK,KAAK,IAAI,OAAO,CAAC,MAAM,CAAA;AACrD,CAAC;AAED,SAAS,iBAAiB;IACtB,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAA;IACrC,OAAO,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;AACrD,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAI,KAAa,EAAE,IAAqB,EAAE,SAA2B;IACpG,MAAM,OAAO,GAA2B,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACrE,IAAI,CAAC;QACD,OAAO,MAAM,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACnD,CAAC;YAAS,CAAC;QACP,OAAO,CAAC,MAAM,GAAG,KAAK,CAAA;IAC1B,CAAC;AACL,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAA"}