@methodacting/actor-kit 0.47.0

package/dist/src/types.d.ts

@@ -0,0 +1,181 @@
+import { DurableObject } from "cloudflare:workers";
+import { Operation } from "fast-json-patch";
+import type { AnyEventObject, AnyStateMachine, SnapshotFrom, StateMachine, StateValueFrom } from "xstate";
+import type { z } from "zod";
+import type { AnyEventSchema, CallerSchema, RequestInfoSchema, SystemEventSchema } from "./schemas";
+import type { AlarmManager } from "./alarms";
+import type { ActorKitStorage } from "./storage";
+export type EnvWithDurableObjects = {
+    ACTOR_KIT_SECRET: string;
+    [key: string]: DurableObjectNamespace<ActorServer<any>> | unknown;
+};
+export type AnyEvent = z.infer<typeof AnyEventSchema>;
+export interface ActorServerMethods<TMachine extends BaseActorKitStateMachine> {
+    fetch(request: Request): Promise<Response>;
+    spawn(props: {
+        actorType: string;
+        actorId: string;
+        caller: Caller;
+        input: Record<string, unknown>;
+    }): void;
+    send(event: ClientEventFrom<TMachine> | ServiceEventFrom<TMachine>): void;
+    getSnapshot(caller: Caller, options?: {
+        waitForEvent?: ClientEventFrom<TMachine>;
+        waitForState?: StateValueFrom<TMachine>;
+        timeout?: number;
+        errorOnWaitTimeout?: boolean;
+    }): Promise<{
+        checksum: string;
+        snapshot: CallerSnapshotFrom<TMachine>;
+    }>;
+}
+export type ActorServer<TMachine extends AnyActorKitStateMachine> = DurableObject & ActorServerMethods<TMachine>;
+export type AnyActorServer = ActorServer<any>;
+export type Caller = z.infer<typeof CallerSchema>;
+export type RequestInfo = z.infer<typeof RequestInfoSchema>;
+export type ActorKitInputProps = {
+    id: string;
+    caller: Caller;
+    storage: DurableObjectStorage;
+    [key: string]: unknown;
+};
+export type CallerType = "client" | "system" | "service";
+type EventObject = {
+    type: string;
+};
+type EventSchemaUnion = z.ZodDiscriminatedUnion<"type", [
+    z.ZodObject<z.ZodRawShape & {
+        type: z.ZodString;
+    }>,
+    ...z.ZodObject<z.ZodRawShape & {
+        type: z.ZodString;
+    }>[]
+]>;
+export type EventSchemas = {
+    client: EventSchemaUnion;
+    service: EventSchemaUnion;
+};
+export type BaseActorKitContext<TPublicProps extends {
+    [key: string]: unknown;
+}, TPrivateProps extends {
+    [key: string]: unknown;
+}> = {
+    public: TPublicProps;
+    private: Record<string, TPrivateProps>;
+};
+export type ActorKitStateMachine<TEvent extends BaseActorKitEvent<EnvWithDurableObjects>, TInput extends {
+    id: string;
+    caller: Caller;
+    storage: DurableObjectStorage;
+}, TContext extends BaseActorKitContext<any, any> & {
+    [key: string]: unknown;
+}> = StateMachine<TContext, TEvent & EventObject, any, any, any, any, any, any, any, TInput, any, any, any, any>;
+export type BaseActorKitInput<TEnv = EnvWithDurableObjects> = {
+    id: string;
+    caller: Caller;
+    env: TEnv;
+    storage: DurableObjectStorage;
+};
+export type WithActorKitInput<TInputProps extends {
+    [key: string]: unknown;
+}, TEnv extends EnvWithDurableObjects> = TInputProps & BaseActorKitInput<TEnv>;
+export type AnyActorKitStateMachine = ActorKitStateMachine<any, any, any>;
+type AnyActorKitEvent = (WithActorKitEvent<AnyEventObject, "client"> | WithActorKitEvent<AnyEventObject, "service"> | ActorKitSystemEvent) & BaseActorKitEvent<EnvWithDurableObjects>;
+type AnyActorKitInput = WithActorKitInput<{
+    [key: string]: unknown;
+}, EnvWithDurableObjects> & {
+    storage: DurableObjectStorage;
+};
+type AnyActorKitContext = {
+    public: {
+        [key: string]: unknown;
+    };
+    private: Record<string, {
+        [key: string]: unknown;
+    }>;
+};
+export type BaseActorKitStateMachine = ActorKitStateMachine<AnyActorKitEvent, AnyActorKitInput, AnyActorKitContext>;
+export type ExtraContext = {
+    requestId: string;
+};
+export interface BaseActorKitEvent<TEnv extends EnvWithDurableObjects> {
+    caller: Caller;
+    storage: DurableObjectStorage;
+    requestInfo?: RequestInfo;
+    env: TEnv;
+}
+export type ActorKitSystemEvent = z.infer<typeof SystemEventSchema>;
+export type WithActorKitEvent<T extends {
+    type: string;
+}, C extends CallerType> = T & BaseActorKitEvent<EnvWithDurableObjects> & {
+    caller: {
+        type: C;
+    };
+};
+export type WithActorKitContext<TExtraProps extends {
+    [key: string]: unknown;
+}, TPrivateProps extends {
+    [key: string]: unknown;
+}, TPublicProps extends {
+    [key: string]: unknown;
+}> = TExtraProps & {
+    public: TPublicProps;
+    private: Record<string, TPrivateProps>;
+};
+export type CallerSnapshotFrom<TMachine extends AnyStateMachine> = {
+    public: SnapshotFrom<TMachine> extends {
+        context: {
+            public: infer P;
+        };
+    } ? P : unknown;
+    private: SnapshotFrom<TMachine> extends {
+        context: {
+            private: Partial<Record<string, infer PR>>;
+        };
+    } ? PR : unknown;
+    value: SnapshotFrom<TMachine> extends {
+        value: infer V;
+    } ? V : unknown;
+};
+export type ClientEventFrom<T extends AnyActorKitStateMachine> = T extends StateMachine<any, infer TEvent, any, any, any, any, any, any, any, any, any, any, any, any> ? TEvent extends WithActorKitEvent<infer E, "client"> ? Omit<E, keyof BaseActorKitEvent<EnvWithDurableObjects>> : never : never;
+export type ServiceEventFrom<T extends AnyActorKitStateMachine> = T extends StateMachine<any, infer TEvent, any, any, any, any, any, any, any, any, any, any, any, any> ? TEvent extends WithActorKitEvent<infer E, "service"> ? Omit<E, keyof BaseActorKitEvent<EnvWithDurableObjects>> : never : never;
+export type ScreamingSnakeToKebab<S extends string> = S extends `${infer T}_${infer U}` ? `${Lowercase<T>}-${ScreamingSnakeToKebab<U>}` : Lowercase<S>;
+export type DurableObjectActor<TMachine extends AnyActorKitStateMachine> = ActorServer<TMachine>;
+type CamelToSnakeCase<S extends string> = S extends `${infer T}${infer U}` ? U extends Uncapitalize<U> ? `${Lowercase<T>}${CamelToSnakeCase<U>}` : `${Lowercase<T>}_${CamelToSnakeCase<U>}` : S;
+type KebabToCamelCase<S extends string> = S extends `${infer T}-${infer U}` ? `${T}${Capitalize<KebabToCamelCase<U>>}` : S;
+export type KebabToScreamingSnake<S extends string> = Uppercase<CamelToSnakeCase<KebabToCamelCase<S>>>;
+export interface MatchesProps<TMachine extends AnyActorKitStateMachine> {
+    state: StateValueFrom<TMachine>;
+    and?: StateValueFrom<TMachine>;
+    or?: StateValueFrom<TMachine>;
+    not?: boolean;
+    initialValueOverride?: boolean;
+}
+export type MachineFromServer<T> = T extends ActorServer<infer M> ? M : never;
+export type ActorKitEmittedEvent = {
+    operations: Operation[];
+    checksum: string;
+};
+export type ActorKitClient<TMachine extends AnyActorKitStateMachine> = {
+    connect: () => Promise<void>;
+    disconnect: () => void;
+    send: (event: ClientEventFrom<TMachine>) => void;
+    getState: () => CallerSnapshotFrom<TMachine>;
+    subscribe: (listener: (state: CallerSnapshotFrom<TMachine>) => void) => () => void;
+    waitFor: (predicateFn: (state: CallerSnapshotFrom<TMachine>) => boolean, timeoutMs?: number) => Promise<void>;
+};
+type ExtractEventType<TMachine> = TMachine extends ActorKitStateMachine<infer TEvent, any, any> ? TEvent : never;
+type ExtractEnvType<TEvent> = TEvent extends {
+    env: infer TEnv;
+} ? TEnv : never;
+export type EnvFromMachine<TMachine extends AnyActorKitStateMachine> = ExtractEnvType<ExtractEventType<TMachine>> extends never ? EnvWithDurableObjects : ExtractEnvType<ExtractEventType<TMachine>> & EnvWithDurableObjects;
+export interface MachineServerOptions {
+    persisted?: boolean;
+    enableAlarms?: boolean;
+}
+export interface MachineServerServices {
+    storage: ActorKitStorage;
+    alarmManager: AlarmManager | null;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/utils.d.ts

@@ -0,0 +1,30 @@
+import { Caller } from "./types";
+export declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
+declare global {
+    var DEBUG_LEVEL: LogLevel | undefined;
+}
+export declare function debug(message: string, level?: LogLevel, data?: any): void;
+export declare const logError: (message: string, data?: any) => void;
+export declare const logWarn: (message: string, data?: any) => void;
+export declare const logInfo: (message: string, data?: any) => void;
+export declare const json: <T>(data: T, status?: number) => Response;
+export declare const ok: () => Response;
+export declare const error: (err: string | {
+    message: string;
+}, status?: number) => Response;
+export declare const notFound: () => Response;
+export declare const parseQueryParams: (url: string) => URLSearchParams;
+export declare function assert<T>(expression: T, errorMessage: string): asserts expression;
+export declare function getCallerFromRequest(request: Request, actorType: string, actorId: string, secret: string): Promise<Caller>;
+export declare function parseAccessTokenForCaller({ accessToken, type, id, secret, }: {
+    accessToken: string;
+    type: string;
+    id: string;
+    secret: string;
+}): Promise<Caller>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,WAAW,EAAE,QAAQ,GAAG,SAAS,CAAC;CACvC;AAgBD,wBAAgB,KAAK,CACnB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,QAAyB,EAChC,IAAI,CAAC,EAAE,GAAG,QAsBX;AAGD,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,EAAE,OAAO,GAAG,SACd,CAAC;AACvC,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,EAAE,OAAO,GAAG,SACd,CAAC;AACtC,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,EAAE,OAAO,GAAG,SACd,CAAC;AAEtC,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,MAAM,CAAC,EAAE,eAAY,aACZ,CAAC;AAElC,eAAO,MAAM,EAAE,gBAA2B,CAAC;AAE3C,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,eAAY,aASpE,CAAC;AAEF,eAAO,MAAM,QAAQ,gBAAgC,CAAC;AAOtD,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,oBAI3C,CAAC;AAEF,wBAAgB,MAAM,CAAC,CAAC,EACtB,UAAU,EAAE,CAAC,EACb,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,CAYpB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,wBAAsB,yBAAyB,CAAC,EAC9C,WAAW,EACX,IAAI,EACJ,EAAE,EACF,MAAM,GACP,EAAE;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBlB"}

package/dist/src/withActorKit.d.ts

@@ -0,0 +1,9 @@
+import type { StoryContext, StoryFn } from "@storybook/react";
+import React from "react";
+import { createActorKitContext } from "./createActorKitContext";
+import type { AnyActorKitStateMachine } from "./types";
+export declare const withActorKit: <TMachine extends AnyActorKitStateMachine>({ actorType, context, }: {
+    actorType: string;
+    context: ReturnType<typeof createActorKitContext<TMachine>>;
+}) => (Story: StoryFn, storyContext: StoryContext) => React.ReactElement;
+//# sourceMappingURL=withActorKit.d.ts.map

package/dist/src/withActorKit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withActorKit.d.ts","sourceRoot":"","sources":["../../src/withActorKit.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,uBAAuB,EAAsB,MAAM,SAAS,CAAC;AAqD3E,eAAO,MAAM,YAAY,GAAI,QAAQ,SAAS,uBAAuB,EAAE,yBAGpE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC7D,MACS,OAAO,OAAO,EAAE,cAAc,YAAY,KAAG,KAAK,CAAC,YAsC5D,CAAC"}

package/dist/src/worker.d.ts

@@ -0,0 +1,3 @@
+export { createActorKitRouter } from "./createActorKitRouter";
+export { createMachineServer } from "./createMachineServer";
+//# sourceMappingURL=worker.d.ts.map

package/dist/src/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@methodacting/actor-kit",
+  "version": "0.47.0",
+  "main": "./src/index.ts",
+  "module": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js"
+    },
+    "./server": {
+      "types": "./src/server.ts",
+      "import": "./src/server.ts"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./storybook": {
+      "types": "./src/storybook.ts",
+      "import": "./src/storybook.ts"
+    },
+    "./test": {
+      "types": "./src/test.ts",
+      "import": "./src/test.ts"
+    },
+    "./worker": {
+      "types": "./src/worker.ts",
+      "import": "./src/worker.ts"
+    }
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c --bundleConfigAsCjs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "xstate",
+    "partykit",
+    "actor",
+    "state-machine"
+  ],
+  "author": "jonmumm",
+  "license": "ISC",
+  "peerDependencies": {
+    "@cloudflare/workers-types": "^4.20240925.0",
+    "react": "^17.0.0 || ^18.0.0",
+    "xstate": "^5.18.0",
+    "zod": "^3.23.0"
+  },
+  "dependencies": {
+    "cloudflare": "^3.5.0",
+    "fast-json-patch": "^3.1.1",
+    "immer": "^10.1.1",
+    "jose": "^5.8.0",
+    "xstate-migrate": "^0.0.5"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20260116.0",
+    "@rollup/plugin-alias": "^5.1.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@storybook/react": "^8.4.2",
+    "@types/node": "^22.7.4",
+    "@types/react": "^18.3.9",
+    "@types/use-sync-external-store": "^0.0.6",
+    "react": "^18.3.1",
+    "rollup": "^4.24.0",
+    "rollup-plugin-dts": "^6.1.1",
+    "rollup-plugin-preserve-directives": "^0.4.0",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "typescript": "^5.6.2",
+    "xstate": "^5.18.2",
+    "zod": "^3.23.8"
+  },
+  "type": "module",
+  "imports": {
+    "cloudflare:workers": "@cloudflare/workers-types"
+  }
+}

package/src/alarms.ts

@@ -0,0 +1,237 @@
+import type {
+  ActorKitStorage,
+  AlarmRecord,
+  AlarmScheduleOptions,
+} from "./storage";
+
+/**
+ * Supported alarm types
+ */
+export type AlarmType = "xstate-delay" | "cache-cleanup" | "custom";
+
+/**
+ * Alarm data from the database with parsed payload
+ */
+export interface Alarm {
+  id: string;
+  type: AlarmType;
+  scheduledAt: number;
+  repeatInterval?: number;
+  payload: Record<string, unknown>;
+  createdAt: number;
+}
+
+/**
+ * Options for scheduling a new alarm
+ */
+export interface ScheduleAlarmOptions {
+  id: string;
+  type: AlarmType;
+  scheduledAt: number;
+  repeatInterval?: number;
+  payload: Record<string, unknown>;
+}
+
+/**
+ * Result from handling an alarm
+ */
+export interface AlarmHandleResult {
+  id: string;
+  type: AlarmType;
+  rescheduled?: boolean;
+  deleted: boolean;
+}
+
+/**
+ * Manages alarms for a Durable Object using SQLite storage
+ * and the Durable Object alarm API
+ */
+export class AlarmManager {
+  private storage: ActorKitStorage;
+  private state: DurableObjectState;
+  private currentAlarmId: string | null = null;
+  private currentAlarmTime: number | null = null;
+
+  constructor(storage: ActorKitStorage, state: DurableObjectState) {
+    this.storage = storage;
+    this.state = state;
+  }
+
+  /**
+   * Schedule a new alarm
+   */
+  async schedule(options: ScheduleAlarmOptions): Promise<void> {
+    await this.storage.insertAlarm(options);
+    await this.rescheduleNextAlarm();
+  }
+
+  /**
+   * Cancel an alarm by ID
+   */
+  async cancel(id: string): Promise<void> {
+    await this.storage.deleteAlarm(id);
+    // If we canceled the current alarm, reschedule
+    if (this.currentAlarmId === id) {
+      await this.rescheduleNextAlarm();
+    }
+  }
+
+  /**
+   * Cancel all alarms of a specific type
+   */
+  async cancelByType(type: AlarmType): Promise<void> {
+    await this.storage.deleteAlarmsByType(type);
+    await this.rescheduleNextAlarm();
+  }
+
+  /**
+   * Get all pending alarms
+   */
+  async getPendingAlarms(): Promise<Alarm[]> {
+    const records = await this.storage.getAlarms();
+    return records.map(this.parseAlarmRecord);
+  }
+
+  /**
+   * Get alarms that are due now or before a given time
+   */
+  async getDueAlarms(before: number = Date.now()): Promise<Alarm[]> {
+    const records = await this.storage.getDueAlarms(before);
+    return records.map(this.parseAlarmRecord);
+  }
+
+  /**
+   * Delete an alarm after it has been handled
+   */
+  async deleteAlarm(id: string): Promise<void> {
+    await this.storage.deleteAlarm(id);
+  }
+
+  /**
+   * Update an alarm (for rescheduling recurring alarms)
+   */
+  async updateAlarm(options: ScheduleAlarmOptions): Promise<void> {
+    await this.storage.updateAlarm(options);
+  }
+
+  /**
+   * Reschedule the next DO alarm based on the earliest alarm in storage
+   * This sets the actual Durable Object alarm that will trigger the alarm() handler
+   */
+  async rescheduleNextAlarm(): Promise<void> {
+    const earliest = await this.storage.getEarliestAlarm();
+
+    if (!earliest) {
+      // No alarms pending, clear the DO alarm
+      this.currentAlarmId = null;
+      this.currentAlarmTime = null;
+      // Note: There's no way to "clear" a DO alarm, but we can set one far in the future
+      // or just let it expire naturally
+      return;
+    }
+
+    // Only set a new alarm if the earliest one is different from current
+    if (this.currentAlarmId !== earliest.id || this.currentAlarmTime !== earliest.scheduled_at) {
+      this.currentAlarmId = earliest.id;
+      this.currentAlarmTime = earliest.scheduled_at;
+      await this.state.storage.setAlarm(earliest.scheduled_at);
+    }
+  }
+
+  /**
+   * Handle due alarms and return results
+   * This should be called from the Durable Object's alarm() handler
+   */
+  async handleDueAlarms(handler: (alarm: Alarm) => Promise<boolean>): Promise<AlarmHandleResult[]> {
+    const now = Date.now();
+    const dueAlarms = await this.getDueAlarms(now);
+    const results: AlarmHandleResult[] = [];
+
+    for (const alarm of dueAlarms) {
+      let rescheduled = false;
+      let deleted = true;
+
+      if (alarm.repeatInterval) {
+        // Recurring alarm - reschedule it
+        const nextScheduledAt = now + alarm.repeatInterval;
+        await this.updateAlarm({
+          id: alarm.id,
+          type: alarm.type,
+          scheduledAt: nextScheduledAt,
+          repeatInterval: alarm.repeatInterval,
+          payload: alarm.payload,
+        });
+        rescheduled = true;
+        deleted = false;
+      } else {
+        // One-time alarm - delete it
+        await this.deleteAlarm(alarm.id);
+      }
+
+      // Call the handler and let it perform the alarm-specific action
+      try {
+        await handler(alarm);
+      } catch (error) {
+        console.error(`Error handling alarm ${alarm.id}:`, error);
+      }
+
+      results.push({
+        id: alarm.id,
+        type: alarm.type,
+        rescheduled,
+        deleted,
+      });
+    }
+
+    // Reschedule the next DO alarm
+    await this.rescheduleNextAlarm();
+
+    return results;
+  }
+
+  /**
+   * Get the current scheduled DO alarm info
+   */
+  getCurrentAlarm(): { id: string | null; time: number | null } {
+    return {
+      id: this.currentAlarmId,
+      time: this.currentAlarmTime,
+    };
+  }
+
+  /**
+   * Parse an alarm record from the database into an Alarm object
+   */
+  private parseAlarmRecord(record: AlarmRecord): Alarm {
+    return {
+      id: record.id,
+      type: record.type as AlarmType,
+      scheduledAt: record.scheduled_at,
+      repeatInterval: record.repeat_interval ?? undefined,
+      payload: record.payload ? JSON.parse(record.payload) : {},
+      createdAt: record.created_at,
+    };
+  }
+}
+
+/**
+ * Generate a unique alarm ID
+ */
+export function generateAlarmId(): string {
+  return `alarm-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}
+
+/**
+ * Calculate the next scheduled time for a recurring alarm
+ */
+export function calculateNextRecurringAlarm(
+  baseTime: number,
+  interval: number,
+  now: number = Date.now()
+): number {
+  let next = baseTime;
+  while (next < now) {
+    next += interval;
+  }
+  return next;
+}

package/src/browser.ts

@@ -0,0 +1 @@
+export { createActorKitClient } from "./createActorKitClient";

package/src/constants.ts

@@ -0,0 +1,31 @@
+import { CallerType } from "./types";
+import type { AlarmType } from "./alarms";
+
+export const HEADERS = {
+  X_CALLER_ID: "X-Caller-ID",
+  X_CALLER_TYPE: "X-Caller-Type",
+  X_ACTOR_ID: "X-Actor-ID",
+  X_ACTOR_TYPE: "X-Actor-Type",
+};
+
+/**
+ * Defines the types of callers that can interact with the actor system.
+ * Each type represents a different source of events with varying levels of trust and permissions.
+ * Note: SYSTEM events are handled internally by Actor Kit and are not defined by the user.
+ */
+export const CallerTypes: Record<CallerType, CallerType> = {
+  client: "client",
+  system: "system", // Handled internally by Actor Kit
+  service: "service",
+};
+
+/**
+ * Alarm types supported by the alarm system
+ */
+export const AlarmTypes: Record<AlarmType, AlarmType> = {
+  "xstate-delay": "xstate-delay",
+  "cache-cleanup": "cache-cleanup",
+  custom: "custom",
+};
+
+export const PERSISTED_SNAPSHOT_KEY = "persistedSnapshot";

package/src/createAccessToken.ts

@@ -0,0 +1,29 @@
+import { SignJWT } from "jose";
+import { CallerStringSchema } from "./schemas";
+import { CallerType } from "./types";
+
+// Export utility functions
+export const createAccessToken = async ({
+  signingKey,
+  actorId,
+  actorType,
+  callerId,
+  callerType,
+}: {
+  signingKey: string;
+  actorId: string;
+  actorType: string;
+  callerId: string;
+  callerType: CallerType;
+}) => {
+  const subject = `${callerType}-${callerId}`;
+  CallerStringSchema.parse(subject);
+  const token = await new SignJWT({})
+    .setProtectedHeader({ alg: "HS256" })
+    .setJti(actorId)
+    .setSubject(subject)
+    .setAudience(actorType)
+    .setExpirationTime("30d")
+    .sign(new TextEncoder().encode(signingKey));
+  return token;
+};