@onereach/state-machine-store 1.0.0-framework.2

package/README.md

@@ -0,0 +1,3 @@
+# @onereach/state-machine-store
+
+This package defines the State Machine store for loading state templates using drivers

package/dist/index.d.mts

@@ -0,0 +1,321 @@
+import { CompiledStateTemplateValidators, JsonSchemaValidatorCompiler, StateMachineInstance, StateTemplateDefinition, StateTemplateValidatorCompiler } from "@onereach/state-machine-core";
+//#region src/types/driver-contract.d.ts
+interface DriverLoadOptions {
+  signal?: AbortSignal;
+}
+interface DriverSaveOptions extends DriverLoadOptions {
+  /**
+   * - `undefined`: unconditional write
+   * - `null`: create only; resource must not exist
+   * - `string`: current revision must match
+   */
+  expectedRevision?: string | null;
+}
+interface DriverDeleteOptions extends DriverLoadOptions {
+  expectedRevision?: string | null;
+}
+interface DriverWatchOptions {
+  signal?: AbortSignal;
+}
+interface DriverLoadResult<TState = unknown> {
+  value: TState;
+  /**
+   * Opaque revision understood by the driver.
+   *
+   * Examples:
+   *
+   * - SHA256
+   * - S3 VersionId
+   * - database row version
+   * - Git hash
+   */
+  revision: string;
+  metadata?: Readonly<Record<string, unknown>>;
+}
+interface DriverSaveResult {
+  revision: string;
+  metadata?: Readonly<Record<string, unknown>>;
+}
+type DriverChangeType = 'created' | 'updated' | 'deleted';
+interface DriverChange<TReference> {
+  type: DriverChangeType;
+  ref: TReference;
+  revision?: string;
+}
+type DriverConcurrency =
+/**
+ * `expectedRevision` may be checked, but the check and write are not
+ * protected from concurrent writers.
+ */
+'none' |
+/**
+ * Revision check + write/delete are serialized using a shared lock.
+ *
+ * Correct as long as all writers participate in the same locking protocol.
+ */
+'cooperative-lock' |
+/**
+ * Backend natively performs compare-and-set atomically.
+ *
+ * Examples:
+ * - PostgreSQL UPDATE ... WHERE revision = ...
+ * - DynamoDB ConditionExpression
+ * - Redis Lua transaction
+ */
+'atomic-cas';
+type DriverWatch = false | 'polling' | 'push';
+interface DriverCapabilities {
+  /**
+   * Concurrency guarantee provided for conditional writes using
+   * expectedRevision.
+   */
+  concurrency: DriverConcurrency;
+  /**
+   * Change notification implementation.
+   */
+  watch: DriverWatch;
+}
+interface DocumentDriver<TReference> {
+  readonly capabilities: DriverCapabilities;
+  load<TState = unknown>(reference: TReference, options?: DriverLoadOptions): Promise<DriverLoadResult<TState> | undefined>;
+  save<TState = unknown>(reference: TReference, value: TState, options?: DriverSaveOptions): Promise<DriverSaveResult>;
+  delete(reference: TReference, options?: DriverDeleteOptions): Promise<boolean>;
+  /**
+   * Optional because not every backend can efficiently
+   * push changes.
+   *
+   * An S3 driver might implement this with SQS/EventBridge,
+   * for example.
+   */
+  watch?(this: void, reference: TReference, options?: DriverWatchOptions): AsyncIterable<DriverChange<TReference>>;
+}
+//#endregion
+//#region src/errors.d.ts
+declare class RevisionConflictError extends Error {
+  readonly expected: string | null | undefined;
+  readonly actual: string | undefined;
+  constructor(expected: string | null | undefined, actual: string | undefined);
+}
+declare class NotFoundError extends Error {
+  readonly resource: string;
+  constructor(resource: string);
+}
+declare class DriverCapabilityError extends Error {
+  readonly capability: string;
+  constructor(capability: string);
+}
+declare class TemplateRevisionMismatchError extends Error {
+  readonly expected: string;
+  readonly actual: string;
+  constructor(expected: string, actual: string);
+}
+declare class UnsafeConcurrencyError extends Error {
+  readonly concurrency: DriverConcurrency;
+  constructor(concurrency: DriverConcurrency);
+}
+//#endregion
+//#region src/helpers.d.ts
+declare function hasSafeConditionalWrites(capabilities: DriverCapabilities): boolean;
+//#endregion
+//#region src/template-store/types.d.ts
+interface StateTemplateReference {
+  id: string;
+  version?: string;
+}
+interface LoadedStateTemplate {
+  definition: StateTemplateDefinition;
+  revision: string;
+  validators: CompiledStateTemplateValidators;
+  metadata?: Readonly<Record<string, unknown>>;
+}
+type StateTemplateDriver = DocumentDriver<StateTemplateReference>;
+//#endregion
+//#region src/template-store/template-store.d.ts
+declare class StateTemplateStore {
+  private readonly driver;
+  private readonly compiler;
+  /**
+   * Cache fully prepared loaded templates.
+   *
+   * This avoids:
+   *
+   * - repeated Zod parsing
+   * - repeated compiler lookup
+   * - repeatedly rebuilding wrapper objects
+   */
+  private readonly cache;
+  constructor(driver: StateTemplateDriver, compiler: JsonSchemaValidatorCompiler | StateTemplateValidatorCompiler);
+  /**
+   * Load a state template from the driver.
+   * @param reference - The reference to the state template.
+   * @param options - The options for the load operation.
+   * @returns The loaded state template.
+   */
+  load(reference: StateTemplateReference, options?: DriverLoadOptions): Promise<LoadedStateTemplate | undefined>;
+  /**
+   * Load a state template from the driver and throw an error if it is not found.
+   * @param reference - The reference to the state template.
+   * @param options - The options for the load operation.
+   * @returns The loaded state template.
+   */
+  require(reference: StateTemplateReference, options?: DriverLoadOptions): Promise<LoadedStateTemplate>;
+  /**
+   * Save a state template to the driver.
+   * @param raw - The state template definition to save.
+   * @param options - The options for the save operation.
+   * @returns The saved state template.
+   */
+  save(raw: StateTemplateDefinition, options?: DriverSaveOptions): Promise<LoadedStateTemplate>;
+  delete(reference: StateTemplateReference, options?: DriverDeleteOptions): Promise<boolean>;
+  watch(reference: StateTemplateReference, options?: DriverWatchOptions): AsyncIterable<{
+    type: 'created' | 'updated';
+    template: LoadedStateTemplate;
+  } | {
+    type: 'deleted';
+    ref: StateTemplateReference;
+  }>;
+  get capabilities(): DriverCapabilities;
+}
+//#endregion
+//#region src/instance-store/types.d.ts
+interface StateMachineInstanceReference {
+  id: string;
+}
+type StateMachineInstanceDriver = DocumentDriver<StateMachineInstanceReference>;
+interface LoadedStateMachineInstance {
+  /**
+   * The loaded instance.
+   */
+  instance: StateMachineInstance;
+  /**
+   * Revision of the persisted instance itself.
+   */
+  revision: string;
+  /**
+   * The loaded template that was used to create the instance.
+   */
+  template: LoadedStateTemplate;
+  /**
+   * Additional metadata about the instance.
+   */
+  metadata?: Readonly<Record<string, unknown>>;
+}
+interface CreateStateMachineInstance {
+  /**
+   * The unique identifier of the instance.
+   */
+  id: string;
+  /**
+   * Reference to the template that was used to create the instance.
+   */
+  template: StateTemplateReference;
+  /**
+   * Defaults to {@link template.initialState}.
+   */
+  state?: Record<string, unknown>;
+  /**
+   * Additional metadata about the instance.
+   */
+  metadata?: Record<string, unknown>;
+}
+interface UpdateStateMachineInstance {
+  state?: Record<string, unknown>;
+  metadata?: Record<string, unknown>;
+}
+type StateMachineInstanceChange = {
+  type: 'current' | 'created' | 'updated';
+  instance: LoadedStateMachineInstance;
+} | {
+  type: 'deleted';
+  ref: StateMachineInstanceReference;
+};
+interface InstanceWatchOptions extends DriverWatchOptions {
+  /**
+   * Emit the current instance before listening for
+   * subsequent changes.
+   */
+  emitCurrent?: boolean;
+}
+//#endregion
+//#region src/instance-store/instance-store.d.ts
+declare class StateMachineInstanceStore {
+  private readonly driver;
+  private readonly templates;
+  constructor(driver: StateMachineInstanceDriver, templates: StateTemplateStore);
+  /**
+   * Creates a new state machine instance.
+   * @param options - The options for the create operation.
+   * @returns The created state machine instance.
+   */
+  create(options: CreateStateMachineInstance): Promise<LoadedStateMachineInstance>;
+  /**
+   * Loads a state machine instance from the driver.
+   * @param reference - The reference to the state machine instance.
+   * @param options - The options for the load operation.
+   * @returns The loaded state machine instance.
+   */
+  load(reference: StateMachineInstanceReference, options?: DriverLoadOptions): Promise<LoadedStateMachineInstance | undefined>;
+  /**
+   * Loads a state machine instance from the driver and throws an error if it is not found.
+   * @param reference - The reference to the state machine instance.
+   * @param options - The options for the load operation.
+   * @returns The loaded state machine instance.
+   */
+  require(reference: StateMachineInstanceReference, options?: DriverLoadOptions): Promise<LoadedStateMachineInstance>;
+  /**
+   * Saves a new instance revision.
+   *
+   * The caller cannot accidentally change:
+   *
+   * - id
+   * - template binding
+   * - createdAt
+   * - sequence manually
+   */
+  save(loaded: LoadedStateMachineInstance, update: UpdateStateMachineInstance): Promise<LoadedStateMachineInstance>;
+  /**
+   * Saves a new state for a state machine instance.
+   * @param loaded - The loaded state machine instance.
+   * @param state - The state to save.
+   * @returns The saved state machine instance.
+   */
+  saveState(loaded: LoadedStateMachineInstance, state: Record<string, unknown>): Promise<LoadedStateMachineInstance>;
+  /**
+   * Saves metadata for a state machine instance.
+   * @param loaded - The loaded state machine instance.
+   * @param metadata - The metadata to save.
+   * @returns The saved state machine instance.
+   */
+  saveMetadata(loaded: LoadedStateMachineInstance, metadata: Record<string, unknown>): Promise<LoadedStateMachineInstance>;
+  /**
+   * Deletes a state machine instance.
+   * @param loaded - The loaded state machine instance.
+   * @returns True if the instance was deleted, false otherwise.
+   */
+  delete(loaded: LoadedStateMachineInstance): Promise<boolean>;
+  /**
+   * Watches a state machine instance for changes.
+   * @param reference - The reference to the state machine instance.
+   * @param options - The options for the watch operation.
+   * @returns An iterable of state machine instance changes.
+   */
+  watch(reference: StateMachineInstanceReference, options?: InstanceWatchOptions): AsyncIterable<StateMachineInstanceChange>;
+  /**
+   * Convenience callback interface over watch().
+   * @param reference - The reference to the state machine instance.
+   * @param listener - The listener to call when a change occurs.
+   * @param options - The options for the watch operation.
+   * @returns A function to unsubscribe from the watch.
+   */
+  subscribe(reference: StateMachineInstanceReference, listener: (change: StateMachineInstanceChange) => void | Promise<void>, options?: InstanceWatchOptions & {
+    onError?: (error: unknown) => void;
+  }): () => void;
+  /**
+   * Returns the capabilities of the state machine instance driver.
+   * @returns The capabilities of the state machine instance driver.
+   */
+  get capabilities(): DriverCapabilities;
+}
+//#endregion
+export { type CreateStateMachineInstance, type DocumentDriver, type DriverCapabilities, DriverCapabilityError, type DriverChange, type DriverChangeType, type DriverConcurrency, type DriverDeleteOptions, type DriverLoadOptions, type DriverLoadResult, type DriverSaveOptions, type DriverSaveResult, type DriverWatch, type DriverWatchOptions, type InstanceWatchOptions, type LoadedStateMachineInstance, type LoadedStateTemplate, NotFoundError, RevisionConflictError, type StateMachineInstanceChange, type StateMachineInstanceDriver, type StateMachineInstanceReference, StateMachineInstanceStore, type StateTemplateDriver, type StateTemplateReference, StateTemplateStore, TemplateRevisionMismatchError, UnsafeConcurrencyError, type UpdateStateMachineInstance, hasSafeConditionalWrites };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/driver-contract.ts","../src/errors.ts","../src/helpers.ts","../src/template-store/types.ts","../src/template-store/template-store.ts","../src/instance-store/types.ts","../src/instance-store/instance-store.ts"],"mappings":";;UAAiB;EACf,SAAS;;UAGM,0BAA0B;;;;;;EAMzC;;UAGe,4BAA4B;EAC3C;;UAGe;EACf,SAAS;;UAGM,iBAAiB;EAChC,OAAO;;;;;;;;;;;EAYP;EAEA,WAAW,SAAS;;UAGL;EACf;EAEA,WAAW,SAAS;;KAGV;UAEK,aAAa;EAC5B,MAAM;EAEN,KAAK;EAEL;;KAGU;;;;;;;;;;;;;;;;;;;;;KAwBA;UAEK;;;;;EAKf,aAAa;;;;EAKb,OAAO;;UAGQ,eAAe;WACrB,cAAc;EAEvB,KAAK,kBACH,WAAW,YACX,UAAU,oBACT,QAAQ,iBAAiB;EAE5B,KAAK,kBAAkB,WAAW,YAAY,OAAO,QAAQ,UAAU,oBAAoB,QAAQ;EAEnG,OAAO,WAAW,YAAY,UAAU,sBAAsB;;;;;;;;EAS9D,OAAO,YAAY,WAAW,YAAY,UAAU,qBAAqB,cAAc,aAAa;;;;cC/GzF,8BAA8B;WACzB;WACA;EAEJ,YAAA,qCAAqC;;cAStC,sBAAsB;WACjB;EAEJ,YAAA;;cAQD,8BAA8B;WACzB;EAEJ,YAAA;;cAQD,sCAAsC;WACjC;WACA;EAEJ,YAAA,kBAAkB;;cAWnB,+BAA+B;WAC1B,aAAa;EAEjB,YAAA,aAAa;;;;iBCrDX,yBAAyB,cAAc;;;UCEtC;EACf;EACA;;UAGe;EACf,YAAY;EACZ;EACA,YAAY;EACZ,WAAW,SAAS;;KAGV,sBAAsB,eAAe;;;cCFpC;mBACM;mBACA;;;;;;;;;;mBAUA;EAEL,YAAA,QAAQ,qBAAqB,UAAU,8BAA8B;;;;;;;EAYpE,KACX,WAAW,wBACX,UAAU,oBACT,QAAQ;;;;;;;EAkCE,QAAQ,WAAW,wBAAwB,UAAU,oBAAoB,QAAQ;;;;;;;EAgBjF,KAAK,KAAK,yBAAyB,UAAU,oBAAoB,QAAQ;EA8BzE,OAAO,WAAW,wBAAwB,UAAU,sBAAsB;EASzE,MACZ,WAAW,wBACX,UAAU,qBACT;IAEG;IACA,UAAU;;IAGV;IACA,KAAK;;MAmCA,gBAAgB;;;;UC5KZ;EACf;;KAGU,6BAA6B,eAAe;UAEvC;;;;EAIf,UAAU;;;;EAKV;;;;EAKA,UAAU;;;;EAKV,WAAW,SAAS;;UAGL;;;;EAIf;;;;EAKA,UAAU;;;;EAKV,QAAQ;;;;EAKR,WAAW;;UAGI;EACf,QAAQ;EACR,WAAW;;KAGD;EAEN;EAEA,UAAU;;EAGV;EAEA,KAAK;;UAGM,6BAA6B;;;;;EAK5C;;;;cC7DW;mBACM;mBACA;EAEL,YAAA,QAAQ,4BAA4B,WAAW;;;;;;EAU9C,OAAO,SAAS,6BAA6B,QAAQ;;;;;;;EAkDrD,KACX,WAAW,+BACX,UAAU,oBACT,QAAQ;;;;;;;EAkCE,QACX,WAAW,+BACX,UAAU,oBACT,QAAQ;;;;;;;;;;;EAoBE,KACX,QAAQ,4BACR,QAAQ,6BACP,QAAQ;;;;;;;EAiDE,UACX,QAAQ,4BACR,OAAO,0BACN,QAAQ;;;;;;;EAUE,aACX,QAAQ,4BACR,UAAU,0BACT,QAAQ;;;;;;EASE,OAAO,QAAQ,6BAA6B;;;;;;;EAUlD,MACL,WAAW,+BACX,UAAS,uBACR,cAAc;;;;;;;;EAwDV,UACL,WAAW,+BACX,WAAW,QAAQ,sCAAsC,eACzD,UAAS;IACP,WAAW;;;;;;MAwCJ,gBAAgB"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import{StateMachineInstanceSchema as e,StateTemplateSchema as t,StateTemplateValidatorCompiler as n,assertSchema as r}from"@onereach/state-machine-core";var i=class extends Error{expected;actual;constructor(e,t){super(`Revision conflict: expected ${e??`<not-exists>`}, actual ${t??`<not-exists>`}`),this.name=`RevisionConflictError`,this.expected=e,this.actual=t}},a=class extends Error{resource;constructor(e){super(`Not found: ${e}`),this.name=`NotFoundError`,this.resource=e}},o=class extends Error{capability;constructor(e){super(`Driver does not support ${e}`),this.name=`DriverCapabilityError`,this.capability=e}},s=class extends Error{expected;actual;constructor(e,t){super(`State-machine instance expects template revision "${e}", but current template revision is "${t}"`),this.name=`TemplateRevisionMismatchError`,this.expected=e,this.actual=t}},c=class extends Error{concurrency;constructor(e){super(`State-machine mutations require safe conditional writes, but the instance driver provides concurrency="${e}"`),this.name=`UnsafeConcurrencyError`,this.concurrency=e}};function l(e){return e.concurrency===`cooperative-lock`||e.concurrency===`atomic-cas`}var u=class{driver;templates;constructor(e,t){this.driver=e,this.templates=t}async create(t){let n=await this.templates.require(t.template),i=structuredClone(t.state??n.definition.initialState);r(n.validators.state,i,`state-before`);let a=new Date().toISOString(),o=e.parse({schemaVersion:1,id:t.id,template:{id:n.definition.id,version:n.definition.version??t.template.version,revision:n.revision},state:i,sequence:0,createdAt:a,updatedAt:a,metadata:t.metadata}),s=await this.driver.save({id:o.id},o,{expectedRevision:null});return{instance:o,revision:s.revision,template:n,metadata:s.metadata}}async load(t,n){let i=await this.driver.load(t,n);if(!i)return;let a=e.parse(i.value),o=await this.templates.require({id:a.template.id,version:a.template.version},n);if(o.revision!==a.template.revision)throw new s(a.template.revision,o.revision);return r(o.validators.state,a.state,`state-before`),{instance:a,revision:i.revision,template:o,metadata:i.metadata}}async require(e,t){let n=await this.load(e,t);if(!n)throw new a(`StateMachineInstance:${e.id}`);return n}async save(t,n){let i=await this.templates.require({id:t.instance.template.id,version:t.instance.template.version});if(i.revision!==t.instance.template.revision)throw new s(t.instance.template.revision,i.revision);let a=structuredClone(n.state??t.instance.state);r(i.validators.state,a,`state-after`);let o=new Date().toISOString(),c=e.parse({...t.instance,state:a,metadata:n.metadata??t.instance.metadata,sequence:t.instance.sequence+1,updatedAt:o}),l=await this.driver.save({id:c.id},c,{expectedRevision:t.revision});return{instance:c,revision:l.revision,template:i,metadata:l.metadata}}async saveState(e,t){return this.save(e,{state:t})}async saveMetadata(e,t){return this.save(e,{metadata:t})}async delete(e){return this.driver.delete({id:e.instance.id},{expectedRevision:e.revision})}async*watch(e,t={}){if(!this.driver.watch)throw new o(`watch`);let n;if(t.emitCurrent){let r=await this.load(e,t);r&&(n=r.revision,yield{type:`current`,instance:r})}for await(let r of this.driver.watch(e,t)){if(r.type===`deleted`){n=void 0,yield{type:`deleted`,ref:e};continue}let i=await this.load(e,t);i&&i.revision!==n&&(n=i.revision,yield{type:r.type,instance:i})}}subscribe(e,t,n={}){let r=new AbortController,i=n.signal,a=()=>r.abort();return i?.aborted?r.abort():i?.addEventListener(`abort`,a,{once:!0}),(async()=>{try{let i=this.watch(e,{...n,signal:r.signal});for await(let e of i)await t(e)}catch(e){r.signal.aborted||n.onError?.(e)}finally{i?.removeEventListener(`abort`,a)}})(),()=>{r.abort()}}get capabilities(){return this.driver.capabilities}},d=class{driver;compiler;cache=new Map;constructor(e,t){this.driver=e,this.compiler=t instanceof n?t:new n(t)}async load(e,n){let r=await this.driver.load(e,n);if(!r)return;let i=f(e,r.revision),a=this.cache.get(i);if(a)return a;let o=t.parse(r.value),s=this.compiler.compile(o,i),c={definition:o,revision:r.revision,validators:s,metadata:r.metadata};return this.cache.set(i,c),c}async require(e,t){let n=await this.load(e,t);if(!n)throw new a(`StateTemplate:${e.id}`);return n}async save(e,n){let r=t.parse(e),i=this.compiler.compile(r),a={id:r.id,version:r.version},o=await this.driver.save(a,r,n),s=f(a,o.revision);this.compiler.bind(s,i);let c={definition:r,revision:o.revision,validators:i,metadata:o.metadata};return this.cache.set(s,c),c}async delete(e,t){return this.driver.delete(e,t)}async*watch(e,t){if(!this.driver.watch)throw new o(`watch`);let n;for await(let r of this.driver.watch(e,t)){if(r.type===`deleted`){n=void 0,yield{type:`deleted`,ref:e};continue}let i=await this.load(e,t);i&&i.revision!==n&&(n=i.revision,yield{type:r.type,template:i})}}get capabilities(){return this.driver.capabilities}};function f(e,t){return JSON.stringify([e.id,e.version??`latest`,t])}export{o as DriverCapabilityError,a as NotFoundError,i as RevisionConflictError,u as StateMachineInstanceStore,d as StateTemplateStore,s as TemplateRevisionMismatchError,c as UnsafeConcurrencyError,l as hasSafeConditionalWrites};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts","../src/helpers.ts","../src/instance-store/instance-store.ts","../src/template-store/template-store.ts"],"sourcesContent":["import { DriverConcurrency } from './types/driver-contract.ts';\n\nexport class RevisionConflictError extends Error {\n  public readonly expected: string | null | undefined;\n  public readonly actual: string | undefined;\n\n  constructor(expected: string | null | undefined, actual: string | undefined) {\n    super(`Revision conflict: expected ${expected ?? '<not-exists>'}, actual ${actual ?? '<not-exists>'}`);\n\n    this.name = 'RevisionConflictError';\n    this.expected = expected;\n    this.actual = actual;\n  }\n}\n\nexport class NotFoundError extends Error {\n  public readonly resource: string;\n\n  constructor(resource: string) {\n    super(`Not found: ${resource}`);\n\n    this.name = 'NotFoundError';\n    this.resource = resource;\n  }\n}\n\nexport class DriverCapabilityError extends Error {\n  public readonly capability: string;\n\n  constructor(capability: string) {\n    super(`Driver does not support ${capability}`);\n\n    this.name = 'DriverCapabilityError';\n    this.capability = capability;\n  }\n}\n\nexport class TemplateRevisionMismatchError extends Error {\n  public readonly expected: string;\n  public readonly actual: string;\n\n  constructor(expected: string, actual: string) {\n    super(\n      `State-machine instance expects template revision \"${expected}\", but current template revision is \"${actual}\"`,\n    );\n\n    this.name = 'TemplateRevisionMismatchError';\n    this.expected = expected;\n    this.actual = actual;\n  }\n}\n\nexport class UnsafeConcurrencyError extends Error {\n  public readonly concurrency: DriverConcurrency;\n\n  constructor(concurrency: DriverConcurrency) {\n    super(\n      `State-machine mutations require safe conditional writes, ` +\n        `but the instance driver provides concurrency=\"${concurrency}\"`,\n    );\n\n    this.name = 'UnsafeConcurrencyError';\n    this.concurrency = concurrency;\n  }\n}\n","import { DriverCapabilities } from './types/driver-contract.ts';\n\nexport function hasSafeConditionalWrites(capabilities: DriverCapabilities): boolean {\n  return capabilities.concurrency === 'cooperative-lock' || capabilities.concurrency === 'atomic-cas';\n}\n","import { assertSchema, StateMachineInstanceSchema } from '@onereach/state-machine-core';\n\nimport { DriverCapabilityError, NotFoundError, TemplateRevisionMismatchError } from '../errors.ts';\nimport { StateTemplateStore } from '../template-store/template-store.ts';\nimport { DriverCapabilities, DriverLoadOptions } from '../types/driver-contract.ts';\n\nimport type {\n  CreateStateMachineInstance,\n  InstanceWatchOptions,\n  LoadedStateMachineInstance,\n  StateMachineInstanceChange,\n  StateMachineInstanceDriver,\n  StateMachineInstanceReference,\n  UpdateStateMachineInstance,\n} from './types.ts';\n\nexport class StateMachineInstanceStore {\n  private readonly driver: StateMachineInstanceDriver;\n  private readonly templates: StateTemplateStore;\n\n  constructor(driver: StateMachineInstanceDriver, templates: StateTemplateStore) {\n    this.driver = driver;\n    this.templates = templates;\n  }\n\n  /**\n   * Creates a new state machine instance.\n   * @param options - The options for the create operation.\n   * @returns The created state machine instance.\n   */\n  public async create(options: CreateStateMachineInstance): Promise<LoadedStateMachineInstance> {\n    const template = await this.templates.require(options.template);\n    const state = structuredClone(options.state ?? template.definition.initialState);\n\n    assertSchema(template.validators.state, state, 'state-before');\n\n    const now = new Date();\n    const datetime = now.toISOString();\n\n    const instance = StateMachineInstanceSchema.parse({\n      schemaVersion: 1,\n      id: options.id,\n\n      template: {\n        id: template.definition.id,\n        version: template.definition.version ?? options.template.version,\n        revision: template.revision,\n      },\n\n      state,\n      sequence: 0,\n\n      createdAt: datetime,\n      updatedAt: datetime,\n\n      metadata: options.metadata,\n    });\n\n    const result = await this.driver.save({ id: instance.id }, instance, {\n      /**\n       * null = create only.\n       */\n      // eslint-disable-next-line unicorn/no-null\n      expectedRevision: null,\n    });\n\n    return {\n      instance,\n      revision: result.revision,\n      template,\n      metadata: result.metadata,\n    };\n  }\n\n  /**\n   * Loads a state machine instance from the driver.\n   * @param reference - The reference to the state machine instance.\n   * @param options - The options for the load operation.\n   * @returns The loaded state machine instance.\n   */\n  public async load(\n    reference: StateMachineInstanceReference,\n    options?: DriverLoadOptions,\n  ): Promise<LoadedStateMachineInstance | undefined> {\n    const loaded = await this.driver.load(reference, options);\n\n    if (!loaded) return undefined;\n\n    const instance = StateMachineInstanceSchema.parse(loaded.value);\n    const template = await this.templates.require(\n      {\n        id: instance.template.id,\n        version: instance.template.version,\n      },\n      options,\n    );\n\n    if (template.revision !== instance.template.revision) {\n      throw new TemplateRevisionMismatchError(instance.template.revision, template.revision);\n    }\n\n    assertSchema(template.validators.state, instance.state, 'state-before');\n\n    return {\n      instance,\n      revision: loaded.revision,\n      template,\n      metadata: loaded.metadata,\n    };\n  }\n\n  /**\n   * Loads a state machine instance from the driver and throws an error if it is not found.\n   * @param reference - The reference to the state machine instance.\n   * @param options - The options for the load operation.\n   * @returns The loaded state machine instance.\n   */\n  public async require(\n    reference: StateMachineInstanceReference,\n    options?: DriverLoadOptions,\n  ): Promise<LoadedStateMachineInstance> {\n    const instance = await this.load(reference, options);\n\n    if (!instance) {\n      throw new NotFoundError(`StateMachineInstance:${reference.id}`);\n    }\n\n    return instance;\n  }\n\n  /**\n   * Saves a new instance revision.\n   *\n   * The caller cannot accidentally change:\n   *\n   * - id\n   * - template binding\n   * - createdAt\n   * - sequence manually\n   */\n  public async save(\n    loaded: LoadedStateMachineInstance,\n    update: UpdateStateMachineInstance,\n  ): Promise<LoadedStateMachineInstance> {\n    /**\n     * Ensure the bound template still exists and hasn't\n     * changed underneath this instance.\n     */\n    const template = await this.templates.require({\n      id: loaded.instance.template.id,\n      version: loaded.instance.template.version,\n    });\n\n    // TODO: Add logic to load specific revision from template store\n    if (template.revision !== loaded.instance.template.revision) {\n      throw new TemplateRevisionMismatchError(loaded.instance.template.revision, template.revision);\n    }\n\n    const state = structuredClone(update.state ?? loaded.instance.state);\n\n    // TODO: do not validate if state was not provided\n    assertSchema(template.validators.state, state, 'state-after');\n\n    const now = new Date();\n    const datetime = now.toISOString();\n\n    const next = StateMachineInstanceSchema.parse({\n      ...loaded.instance,\n      state,\n      metadata: update.metadata ?? loaded.instance.metadata,\n      sequence: loaded.instance.sequence + 1,\n      updatedAt: datetime,\n    });\n\n    const result = await this.driver.save({ id: next.id }, next, {\n      expectedRevision: loaded.revision,\n    });\n\n    return {\n      instance: next,\n      revision: result.revision,\n      template,\n      metadata: result.metadata,\n    };\n  }\n\n  /**\n   * Saves a new state for a state machine instance.\n   * @param loaded - The loaded state machine instance.\n   * @param state - The state to save.\n   * @returns The saved state machine instance.\n   */\n  public async saveState(\n    loaded: LoadedStateMachineInstance,\n    state: Record<string, unknown>,\n  ): Promise<LoadedStateMachineInstance> {\n    return this.save(loaded, { state });\n  }\n\n  /**\n   * Saves metadata for a state machine instance.\n   * @param loaded - The loaded state machine instance.\n   * @param metadata - The metadata to save.\n   * @returns The saved state machine instance.\n   */\n  public async saveMetadata(\n    loaded: LoadedStateMachineInstance,\n    metadata: Record<string, unknown>,\n  ): Promise<LoadedStateMachineInstance> {\n    return this.save(loaded, { metadata });\n  }\n\n  /**\n   * Deletes a state machine instance.\n   * @param loaded - The loaded state machine instance.\n   * @returns True if the instance was deleted, false otherwise.\n   */\n  public async delete(loaded: LoadedStateMachineInstance): Promise<boolean> {\n    return this.driver.delete({ id: loaded.instance.id }, { expectedRevision: loaded.revision });\n  }\n\n  /**\n   * Watches a state machine instance for changes.\n   * @param reference - The reference to the state machine instance.\n   * @param options - The options for the watch operation.\n   * @returns An iterable of state machine instance changes.\n   */\n  async *watch(\n    reference: StateMachineInstanceReference,\n    options: InstanceWatchOptions = {},\n  ): AsyncIterable<StateMachineInstanceChange> {\n    if (!this.driver.watch) throw new DriverCapabilityError('watch');\n\n    let lastRevision: string | undefined;\n\n    if (options.emitCurrent) {\n      const current = await this.load(reference, options);\n\n      if (current) {\n        lastRevision = current.revision;\n\n        yield {\n          type: 'current',\n          instance: current,\n        };\n      }\n    }\n\n    for await (const change of this.driver.watch(reference, options)) {\n      if (change.type === 'deleted') {\n        lastRevision = undefined;\n\n        yield {\n          type: 'deleted',\n          ref: reference,\n        };\n\n        continue;\n      }\n\n      const current = await this.load(reference, options);\n\n      if (!current) continue;\n\n      /**\n       * fs.watch and many other backends can produce\n       * duplicate notifications.\n       */\n      if (current.revision === lastRevision) continue;\n\n      lastRevision = current.revision;\n\n      yield {\n        type: change.type,\n        instance: current,\n      };\n    }\n  }\n\n  /**\n   * Convenience callback interface over watch().\n   * @param reference - The reference to the state machine instance.\n   * @param listener - The listener to call when a change occurs.\n   * @param options - The options for the watch operation.\n   * @returns A function to unsubscribe from the watch.\n   */\n  public subscribe(\n    reference: StateMachineInstanceReference,\n    listener: (change: StateMachineInstanceChange) => void | Promise<void>,\n    options: InstanceWatchOptions & {\n      onError?: (error: unknown) => void;\n    } = {},\n  ): () => void {\n    const controller = new AbortController();\n    const externalSignal = options.signal;\n    const abort = () => controller.abort();\n\n    if (externalSignal?.aborted) {\n      controller.abort();\n    } else {\n      externalSignal?.addEventListener('abort', abort, { once: true });\n    }\n\n    void (async () => {\n      try {\n        const changesIterable = this.watch(reference, {\n          ...options,\n          signal: controller.signal,\n        });\n        for await (const change of changesIterable) {\n          await listener(change);\n        }\n      } catch (error) {\n        if (!controller.signal.aborted) {\n          options.onError?.(error);\n        }\n      } finally {\n        externalSignal?.removeEventListener('abort', abort);\n      }\n    })();\n\n    return () => {\n      controller.abort();\n    };\n  }\n\n  /**\n   * Returns the capabilities of the state machine instance driver.\n   * @returns The capabilities of the state machine instance driver.\n   */\n  public get capabilities(): DriverCapabilities {\n    return this.driver.capabilities;\n  }\n}\n","import { StateTemplateSchema, StateTemplateValidatorCompiler } from '@onereach/state-machine-core';\nimport type { JsonSchemaValidatorCompiler, StateTemplateDefinition } from '@onereach/state-machine-core';\n\nimport { DriverCapabilityError, NotFoundError } from '../errors.ts';\nimport type {\n  DriverCapabilities,\n  DriverDeleteOptions,\n  DriverLoadOptions,\n  DriverSaveOptions,\n  DriverWatchOptions,\n} from '../types/driver-contract.ts';\n\nimport type { LoadedStateTemplate, StateTemplateDriver, StateTemplateReference } from './types.ts';\n\nexport class StateTemplateStore {\n  private readonly driver: StateTemplateDriver;\n  private readonly compiler: StateTemplateValidatorCompiler;\n  /**\n   * Cache fully prepared loaded templates.\n   *\n   * This avoids:\n   *\n   * - repeated Zod parsing\n   * - repeated compiler lookup\n   * - repeatedly rebuilding wrapper objects\n   */\n  private readonly cache = new Map<string, LoadedStateTemplate>();\n\n  constructor(driver: StateTemplateDriver, compiler: JsonSchemaValidatorCompiler | StateTemplateValidatorCompiler) {\n    this.driver = driver;\n    this.compiler =\n      compiler instanceof StateTemplateValidatorCompiler ? compiler : new StateTemplateValidatorCompiler(compiler);\n  }\n\n  /**\n   * Load a state template from the driver.\n   * @param reference - The reference to the state template.\n   * @param options - The options for the load operation.\n   * @returns The loaded state template.\n   */\n  public async load(\n    reference: StateTemplateReference,\n    options?: DriverLoadOptions,\n  ): Promise<LoadedStateTemplate | undefined> {\n    const loaded = await this.driver.load(reference, options);\n\n    if (!loaded) return undefined;\n\n    /*\n     * We can construct this before parsing because ref already\n     * identifies the logical template.\n     */\n    const cacheKey = templateCacheKey(reference, loaded.revision);\n    const cached = this.cache.get(cacheKey);\n    if (cached) return cached;\n\n    const definition = StateTemplateSchema.parse(loaded.value);\n    const validators = this.compiler.compile(definition, cacheKey);\n\n    const result: LoadedStateTemplate = {\n      definition,\n      revision: loaded.revision,\n      validators,\n      metadata: loaded.metadata,\n    };\n\n    this.cache.set(cacheKey, result);\n\n    return result;\n  }\n\n  /**\n   * Load a state template from the driver and throw an error if it is not found.\n   * @param reference - The reference to the state template.\n   * @param options - The options for the load operation.\n   * @returns The loaded state template.\n   */\n  public async require(reference: StateTemplateReference, options?: DriverLoadOptions): Promise<LoadedStateTemplate> {\n    const template = await this.load(reference, options);\n\n    if (!template) {\n      throw new NotFoundError(`StateTemplate:${reference.id}`);\n    }\n\n    return template;\n  }\n\n  /**\n   * Save a state template to the driver.\n   * @param raw - The state template definition to save.\n   * @param options - The options for the save operation.\n   * @returns The saved state template.\n   */\n  public async save(raw: StateTemplateDefinition, options?: DriverSaveOptions): Promise<LoadedStateTemplate> {\n    const definition = StateTemplateSchema.parse(raw);\n    /*\n     * Compile/validate schemas BEFORE writing bad data\n     * to persistence.\n     *\n     * This compilation is cached by object identity.\n     */\n    const validators = this.compiler.compile(definition);\n    const reference: StateTemplateReference = {\n      id: definition.id,\n      version: definition.version,\n    };\n    const saved = await this.driver.save(reference, definition, options);\n    const cacheKey = templateCacheKey(reference, saved.revision);\n\n    this.compiler.bind(cacheKey, validators);\n\n    const result: LoadedStateTemplate = {\n      definition,\n      revision: saved.revision,\n      validators,\n      metadata: saved.metadata,\n    };\n\n    this.cache.set(cacheKey, result);\n\n    return result;\n  }\n\n  public async delete(reference: StateTemplateReference, options?: DriverDeleteOptions): Promise<boolean> {\n    /*\n     * You can invalidate cache if you know the revision,\n     * but leaving immutable revision entries cached is\n     * harmless.\n     */\n    return this.driver.delete(reference, options);\n  }\n\n  public async *watch(\n    reference: StateTemplateReference,\n    options?: DriverWatchOptions,\n  ): AsyncIterable<\n    | {\n        type: 'created' | 'updated';\n        template: LoadedStateTemplate;\n      }\n    | {\n        type: 'deleted';\n        ref: StateTemplateReference;\n      }\n  > {\n    if (!this.driver.watch) {\n      throw new DriverCapabilityError('watch');\n    }\n\n    let lastRevision: string | undefined;\n\n    for await (const change of this.driver.watch(reference, options)) {\n      if (change.type === 'deleted') {\n        lastRevision = undefined;\n\n        yield {\n          type: 'deleted',\n          ref: reference,\n        };\n\n        continue;\n      }\n\n      const template = await this.load(reference, options);\n\n      if (!template) continue;\n      if (template.revision === lastRevision) continue;\n\n      lastRevision = template.revision;\n\n      yield {\n        type: change.type,\n        template,\n      };\n    }\n  }\n\n  public get capabilities(): DriverCapabilities {\n    return this.driver.capabilities;\n  }\n}\n\nfunction templateCacheKey(reference: StateTemplateReference, revision: string): string {\n  return JSON.stringify([reference.id, reference.version ?? 'latest', revision]);\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@onereach/state-machine-store",
+  "version": "1.0.0-framework.2",
+  "description": "State Machine persistence abstraction",
+  "keywords": [
+    "onereach",
+    "toolkit",
+    "state-machine"
+  ],
+  "author": "OneReach Development Team <dev.team@onereach.ai>",
+  "license": "Apache-2.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "!dist/metafile*.json"
+  ],
+  "devDependencies": {
+    "@arethetypeswrong/core": "^0.18.5",
+    "@types/source-map-support": "^0.5.10",
+    "publint": "^0.3.24",
+    "rollup-plugin-visualizer": "^7.1.1",
+    "tsdown": "^0.22.14",
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "@onereach/state-machine-core": "1.0.0-framework.2"
+  },
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsdown --config tsdown.config.mts",
+    "build:visualize": "VISUALIZE=1 pnpm build",
+    "typecheck": "tsc --noEmit",
+    "preversion_": "pnpm build && pnpm test",
+    "publish:rc": "pnpm version prerelease --preid rc && pnpm publish --tag rc",
+    "test": "pnpm run unit",
+    "unit": "vitest run",
+    "preversion": "pnpm build"
+  }
+}