@onereach/step-initialize-state-manager 1.0.0-framework.11

package/README.md

@@ -0,0 +1,3 @@
+# Create LLM Chat Completion Step
+
+This npm packages represents logic for the step `Create LLM Chat Completion` step.

package/dist/index.d.mts

@@ -0,0 +1,189 @@
+import { LoadedStateMachineInstance } from "@onereach/state-machine-step-service";
+import { CONFIG, IActionEvent, ICacheFacade, IEvent, IStepId, IThread, IThreadId, LOCAL, RESULT } from "@onereach/flow-sdk/types/index.js";
+import * as z from "zod/mini";
+import { Step } from "@onereach/flow-sdk/step.js";
+//#region src/schemas/data-in.d.ts
+declare const dataInSchema: z.ZodMiniObject<{
+  stateTemplateId: z.ZodMiniString<string>;
+  handleMissingTemplate: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+  stateId: z.ZodMiniString<string>;
+  stateTtl: z.ZodMiniOptional<z.ZodMiniObject<{
+    input: z.ZodMiniString<string>;
+    outputMode: z.ZodMiniEnum<{
+      ms: "ms";
+      s: "s";
+      m: "m";
+      h: "h";
+      d: "d";
+    }>;
+  }, z.core.$strip>>;
+  customizeInitialValue: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+  useSharedState: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+  handleStateChange: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+  handleSharedStateChange: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
+    local: "local";
+    remote: "remote";
+  }>>>;
+  processError: z.ZodMiniBoolean<boolean>;
+  processTimeout: z.ZodMiniBoolean<boolean>;
+  timeoutDuration: z.ZodMiniString<string>;
+  _testSettings: z.ZodMiniOptional<z.ZodMiniObject<{
+    cache: z.ZodMiniOptional<z.ZodMiniCustom<ICacheFacade, ICacheFacade>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type DataIn = z.infer<typeof dataInSchema>;
+//#endregion
+//#region src/threads/base/types.d.ts
+interface BaseConfig extends CONFIG {
+  dataIn: DataIn;
+}
+//#endregion
+//#region src/threads/base/base.d.ts
+declare class BaseStep<T extends BaseConfig> extends Step<T> {
+  resolveDataIn(): Promise<{
+    stateTemplateId: string;
+    stateId: string;
+    processError: boolean;
+    processTimeout: boolean;
+    timeoutDuration: string;
+    handleMissingTemplate?: boolean | undefined;
+    stateTtl?: {
+      input: string;
+      outputMode: "ms" | "s" | "m" | "h" | "d";
+    } | undefined;
+    customizeInitialValue?: boolean | undefined;
+    useSharedState?: boolean | undefined;
+    handleStateChange?: boolean | undefined;
+    handleSharedStateChange?: ("local" | "remote")[] | undefined;
+    _testSettings?: {
+      cache?: import("@onereach/flow-sdk/types/cache.js").ICacheFacade | undefined;
+    } | undefined;
+  }>;
+}
+//#endregion
+//#region src/threads/main/types.d.ts
+type InitializeStateMachineState = {
+  cancelled: boolean;
+  contentReady: boolean;
+};
+type InitializeStateMachineOut = LoadedStateMachineInstance['instance'];
+interface InitializeStateMachineConfig extends BaseConfig {
+  dataOut: InitializeStateMachineOut;
+  state: InitializeStateMachineState;
+}
+//#endregion
+//#region src/utils/thread-utilities.d.ts
+type ManagedThreadLocal = {
+  active: boolean;
+  parent: IThreadId;
+};
+//#endregion
+//#region src/threads/base/child-types.d.ts
+type BaseChildResultCancel = {
+  status: 'cancel';
+};
+type BaseChildResult = BaseChildResultCancel | Error;
+type BaseChildLocal = ManagedThreadLocal;
+interface BaseChildConfig<TResult extends RESULT<CONFIG> = BaseChildResult, TLocal extends LOCAL<CONFIG> = BaseChildLocal> extends BaseConfig {
+  result: TResult;
+  local: TLocal;
+}
+//#endregion
+//#region src/threads/change-listener/listener/constants.d.ts
+declare const changeListenerClassId = "cng_lnr";
+declare const changeListenerEvents: {
+  readonly stateChanged: "st_cgd";
+};
+//#endregion
+//#region src/threads/change-listener/listener/types.d.ts
+type ChangeListenerChange = {
+  change: LoadedStateMachineInstance;
+  type: 'local' | 'remote';
+};
+type ChangeListenerState = {
+  class: typeof changeListenerClassId;
+  changes: ChangeListenerChange[];
+};
+type ChangeListenerEventName = typeof changeListenerEvents;
+type ChangeListenerLocalChangeEvent = IEvent<unknown, ChangeListenerEventName['stateChanged']>;
+type ChangeListenerRemoteChangeEventName = `sm/${string}/${string}`;
+type ChangeListenerRemoteChangeEvent = IEvent<unknown, ChangeListenerRemoteChangeEventName>;
+type ChangeListenerEvents = ChangeListenerLocalChangeEvent | ChangeListenerRemoteChangeEvent;
+interface ChangeListenerConfig extends BaseChildConfig {
+  events: ChangeListenerEvents;
+  state: ChangeListenerState;
+  dataOut: InitializeStateMachineOut;
+}
+//#endregion
+//#region src/threads/change-listener/worker/constants.d.ts
+declare const changeListenerWorkerClassId = "chg_wrk";
+declare const changeListenerWorkerExits: {
+  readonly local: "local change";
+  readonly remote: "remote change";
+};
+//#endregion
+//#region src/threads/change-listener/worker/types.d.ts
+type ChangeListenerWorkerOut = InitializeStateMachineOut;
+type ChangeListenerWorkerState = {
+  class: typeof changeListenerWorkerClassId;
+  change: ChangeListenerChange;
+};
+type ChangeListenerWorkerResult = undefined | RESULT<BaseChildConfig>;
+interface ChangeListenerWorkerConfig extends BaseChildConfig<ChangeListenerWorkerResult> {
+  dataOut: ChangeListenerWorkerOut;
+  state: ChangeListenerWorkerState;
+}
+//#endregion
+//#region src/threads/change-listener/listener/change-listener.d.ts
+declare class ChangeListener extends BaseStep<ChangeListenerConfig> {
+  static readonly class = "cng_lnr";
+  static start(thread: IThread<InitializeStateMachineConfig>): Promise<void>;
+  static stop<TConfig extends CONFIG>(thread: IThread<TConfig>): Promise<void>;
+  static getThreadId(stepId: IStepId): IThreadId;
+  private get stateMachine();
+  private get instanceTtl();
+  private get remoteChangeEventName();
+  private handleChange;
+  private shouldHandleStateChange;
+  /**
+   * Processes the next change in the listener thread's queue.
+   * If the worker thread is busy, it skips processing.
+   * If the event is the termination marker, it notifies the end of the controller thread.
+   * If the event is ready for processing, it starts the worker thread to handle it.
+   */
+  private tryRunWorker;
+  runStep(): void;
+  initialize(): void;
+  onLocalStateChange(event: ChangeListenerLocalChangeEvent): Promise<void>;
+  onRemoteStateChange(event: ChangeListenerRemoteChangeEvent): Promise<void>;
+  /**
+   * Handler of the worker thread end event.
+   */
+  onWorkerThreadEnd(event: IActionEvent<ChangeListenerWorkerConfig, 'end'>): void;
+}
+//#endregion
+//#region src/threads/change-listener/worker/change-listener-worker.d.ts
+declare class ChangeListenerWorker extends BaseStep<ChangeListenerWorkerConfig> {
+  static readonly class = "chg_wrk";
+  static start(thread: IThread<ChangeListenerConfig>, change: ChangeListenerChange): Promise<void>;
+  static isBusy(thread: IThread<ChangeListenerConfig>): boolean;
+  static getThreadId(stepId: IStepId): IThreadId;
+  runStep(): void;
+}
+//#endregion
+//#region src/threads/main/step.d.ts
+declare class InitializeStateMachineStep extends BaseStep<InitializeStateMachineConfig> {
+  private validateMergeFieldType;
+  private get stateMachine();
+  private get instanceTtl();
+  runStep(): Promise<void>;
+}
+//#endregion
+//#region src/index.d.ts
+declare const states: {
+  cng_lnr: typeof ChangeListener;
+  chg_wrk: typeof ChangeListenerWorker;
+};
+//#endregion
+export { type BaseConfig, ChangeListener, ChangeListenerWorker, type InitializeStateMachineConfig, type InitializeStateMachineOut, type InitializeStateMachineState, InitializeStateMachineStep, InitializeStateMachineStep as step, changeListenerClassId, changeListenerEvents, changeListenerWorkerClassId, changeListenerWorkerExits, states };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/schemas/data-in.ts","../src/threads/base/types.ts","../src/threads/base/base.ts","../src/threads/main/types.ts","../src/utils/thread-utilities.ts","../src/threads/base/child-types.ts","../src/threads/change-listener/listener/constants.ts","../src/threads/change-listener/listener/types.ts","../src/threads/change-listener/worker/constants.ts","../src/threads/change-listener/worker/types.ts","../src/threads/change-listener/listener/change-listener.ts","../src/threads/change-listener/worker/change-listener-worker.ts","../src/threads/main/step.ts","../src/index.ts"],"mappings":";;;;;cAea,cAAY,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BvB,EAAA,KAAA;KAEU,SAAS,EAAE,aAAa;;;UCxCnB,mBAAmB;EAClC,QAAQ;;;;cCGG,SAAS,UAAU,oBAAoB,KAAK;EAE1C,iBAAa;;;;;;;;;;;;;;;;;;;;;;KCNhB;EACV;EACA;;KAGU,4BAA4B;UAEvB,qCAAqC;EACpD,SAAS;EACT,OAAO;;;;KC4FG;EACV;EACA,QAAQ;;;;KCrGE;EACV;;KAEU,kBAAkB,wBAAwB;KAE1C,iBAAiB;UAEZ,gBACf,gBAAgB,OAAO,UAAU,iBACjC,eAAe,MAAM,UAAU,wBACvB;EACR,QAAQ;EACR,OAAO;;;;cClBI;cAEA;WAAA;;;;KCMD;EACV,QAAQ;EACR;;KAGU;EACV,cAAc;EAEd,SAAS;;KAGC,iCAAiC;KACjC,iCAAiC,gBAAgB;KACjD;KACA,kCAAkC,gBAAgB;KAClD,uBAAuB,iCAAiC;UAEnD,6BAA6B;EAC5C,QAAQ;EACR,OAAO;EAGP,SAAS;;;;cC9BE;cAEA;WAAA;WAAA;;;;KCMD,0BAA0B;KAE1B;EACV,cAAc;EAEd,QAAQ;;KAGE,yCAAyC,OAAO;UAE3C,mCAAmC,gBAAgB;EAClE,SAAS;EACT,OAAO;;;;cCSI,uBAAuB,SAAS;kBACpB;SAEH,MAAM,QAAQ,QAAQ,gCAAgC;SAiBtD,KAAK,gBAAgB,QAAQ,QAAQ,QAAQ,WAAW;SAI9D,YAAY,QAAQ,UAAU;cAMhC;cAQA;cAKA;UAME;UAqCN;;;;;;;UAcA;EAgBD;EAuBA;EAKM,mBAAmB,OAAO,iCAAiC;EAO3D,oBAAoB,OAAO,kCAAkC;;;;EAUnE,kBAAkB,OAAO,aAAa;;;;cClLlC,6BAA6B,SAAS;kBAC1B;SAEH,MAAM,QAAQ,QAAQ,uBAAuB,QAAQ,uBAAuB;SAYlF,OAAO,QAAQ,QAAQ;SAIvB,YAAY,QAAQ,UAAU;EAOrC;;;;cCxBI,mCAAmC,SAAS;UAC/C;cAQI;cAWA;EAMC,WAAW;;;;cC/Bb;kBAAA;kBAAA"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import{createRequire as e}from"node:module";import{install as t}from"source-map-support";import{NotFoundError as n,StateMachineThreadService as r}from"@onereach/state-machine-step-service";import{setImmediate as i}from"node:timers/promises";import a from"timestring";import{ACTION as o}from"@onereach/flow-sdk/types/index.js";import{TimeoutError as s}from"@onereach/flow-sdk/errors/timeout.js";import*as c from"zod/mini";import{BasicError as l}from"@onereach/flow-sdk/errors/base.js";import{Step as u}from"@onereach/flow-sdk/step.js";import{readFile as d}from"node:fs/promises";const f={UNKNOWN:`UNKNOWN`,STEP_LOGIC_ISSUE:`STEP_LOGIC_ISSUE`,TIMEOUT:`TIMEOUT`,VALIDATION:`VALIDATION`,SERVER_ERROR:`SERVER_ERROR`,UNSUPPORTED:`UNSUPPORTED`};var p=class extends l{};c.config(c.locales.en());const m=[p,s];function h(e,t={}){let{preserveErrors:n=m,unknownMessage:r=`Unknown error`,unknownCode:i=f.UNKNOWN}=t;if(n?.some(t=>e instanceof t))return e;if(e instanceof c.core.$ZodError)return new p(c.prettifyError(e),e,{code:f.VALIDATION});if(typeof e==`string`)return new p(e,{code:f.UNKNOWN});if(e instanceof Error){if(e.message.includes(`Request timed out`))return new s(`Timeout`,e,{code:f.TIMEOUT});let t=e?.response?.data?.error?.message;return t==null?new p(r,e,{code:i}):new p(t,e,{code:f.SERVER_ERROR})}return new p(r,{code:i,data:e})}function g(e,t){function n(t,n,r,i){let a=e(t,n,r,i);if(typeof a==`function`){let e=i.value,t=a;if(e?.name!=null)try{Object.defineProperty(t,"name",{value:e.name})}catch{}return i.value=t,i}return a??i}return function(e,r,i){if(e!==null&&i!==null&&typeof e==`object`&&typeof i==`object`&&(typeof r==`string`||typeof r==`symbol`))return n(t,e,r,i);let a=e??t;return(e,t,r)=>n(a,e,t,r)}}const _=g((e,t,n,r)=>{let i=r.value;if(!(!i||typeof i!=`function`))return function(...t){try{let r=i.apply(this,t);return r instanceof Promise?r.catch(t=>v.call(this,e,t,n)):r}catch(t){return v.call(this,e,t,n)}}},{allowHandleError:!1,useErrorFilter:!0});function v(e,t,n){let r=n.toString();this.log.DEBUG?.(`Error in method '${r}'`,t);let i=e.useErrorFilter?h(t):t;if(i instanceof Error){if(e.allowHandleError){this.thread.enqueue({name:o.error,error:i});return}this.end(i);return}throw i}async function y(e,{id:t,state:n,local:r,...i},{force:a}={}){let s=e.process.getThread(t);if(e.log.DEBUG?.(`runThread: thread with id '${t}'`,i),s==null)return await e.thread.runThread({...i,id:t,state:n,local:{...r,parent:e.thread.id,active:!0}});if(!a&&!s.ended&&s.local.active)throw Error(`Thread with id '${t}' has not ended yet, cannot start it again`);if(n==null)throw Error(`Thread with id '${t}' must have a state to run`);return s.local.active=!0,await s.enqueueAndRun({name:o.goto,state:{...n,active:!0}})}function b(e,t){let n=e.process.getThread(t);return n!=null&&n.local.active&&!n.ended}function x(e,t=e.id){let n=[];for(let r in e.process.threads){let i=e.process.threads[r];i?.local.parent===t&&n.push(i)}return n}async function S(e,t,{result:n,stopChildThreads:r}={}){let i=e.process.getThread(t);e.log.DEBUG?.(`stopThread: thread with id '${t}'`),i&&(r&&await C(i,n),i.local.active&&(i.local.active=!1,!i.ended&&await i.enqueueAndRun({name:o.ending,result:n})))}async function C(e,t,n={}){let r=x(e).map(async n=>await S(e,n.id,{stopChildThreads:!0,result:t})),i=await Promise.allSettled(r);if(n.throw??!0){let e=i.find(e=>e.status===`rejected`);if(e)throw e.reason}return i}const w=g((e,t,n,r)=>{let i=r.value;if(!(!i||typeof i!=`function`))return function(...e){try{let t=i.apply(this,e);return t instanceof Promise?t.catch(e=>{let t=n.toString();throw this.log.DEBUG?.(`Error in method '${t}'`,e),h(e)}):t}catch(e){let t=n.toString();throw this.log.DEBUG?.(`Error in method '${t}'`,e),h(e)}}},{});c.config(c.locales.en());const T=c.string().check(c.trim(),c.refine(e=>![`undefined`,`null`].includes(e),{error:`Unexpected undefined or null merge-field value`})),E=c.object({stateTemplateId:T.check(c.minLength(1),c.maxLength(64)),handleMissingTemplate:c.optional(c.boolean()),stateId:T.check(c.minLength(1),c.maxLength(64)),stateTtl:c.optional(c.object({input:T,outputMode:c.enum([`ms`,`s`,`m`,`h`,`d`])})),customizeInitialValue:c.optional(c.boolean()),useSharedState:c.optional(c.boolean()),handleStateChange:c.optional(c.boolean()),handleSharedStateChange:c.optional(c.array(c.enum([`local`,`remote`]))),processError:c.boolean(),processTimeout:c.boolean(),timeoutDuration:T.check(c.trim(),c.minLength(1)),_testSettings:c.optional(c.object({cache:c.optional(c.custom())}))});function D(e,t){if(typeof Reflect==`object`&&typeof Reflect.metadata==`function`)return Reflect.metadata(e,t)}function O(e,t,n,r){var i=arguments.length,a=i<3?t:r===null?r=Object.getOwnPropertyDescriptor(t,n):r,o;if(typeof Reflect==`object`&&typeof Reflect.decorate==`function`)a=Reflect.decorate(e,t,n,r);else for(var s=e.length-1;s>=0;s--)(o=e[s])&&(a=(i<3?o(a):i>3?o(t,n,a):o(t,n))||a);return i>3&&a&&Object.defineProperty(t,n,a),a}var k=class extends u{async resolveDataIn(){let e=await super.resolveDataIn();return E.parse(e)}};O([w,D(`design:type`,Function),D(`design:paramtypes`,[]),D(`design:returntype`,Promise)],k.prototype,`resolveDataIn`,null);const A=`sm_mgr`,j=`chg_wrk`,M={local:`local change`,remote:`remote change`};var N=class extends k{static class=j;static async start(e,t){await y(e,{id:this.getThreadId(e.step.id),state:{step:e.step.id,class:this.class,change:t}})}static isBusy(e){return b(e,this.getThreadId(e.step.id))}static getThreadId(e){return`${A}_${this.class}_${e}`}runStep(){if(this.state.change==null)throw new p(`Change listener worker thread state must contain an instance to process`,{code:f.STEP_LOGIC_ISSUE});let{change:e}=this.state;this.log.DEBUG?.(`Executing change listener worker thread`,e),this.exitStep(M[e.type],e.change.instance)}};O([w,D(`design:type`,Function),D(`design:paramtypes`,[]),D(`design:returntype`,void 0)],N.prototype,`runStep`,null);const P=`cng_lnr`,F={stateChanged:`st_cgd`};var I=class extends k{static class=P;static async start(e){await y(e,{id:this.getThreadId(e.step.id),state:{step:e.step.id,class:this.class,changes:[]},background:!0},{force:!0})}static async stop(e){await S(e,this.getThreadId(e.step.id))}static getThreadId(e){return`${A}_${this.class}_${e}`}get stateMachine(){return new r(this.thread,{cache:this.data._testSettings?.cache,instanceTtl:this.instanceTtl}).stateMachine}get instanceTtl(){let{stateTtl:e}=this.data;return e?.input?a(e.input,e.outputMode):void 0}get remoteChangeEventName(){let{stateTemplateId:e,stateId:t}=this.data;return`sm/${e}/${t}`}async handleChange(e){let{stateId:t}=this.data,n=await this.stateMachine.load({id:t});if(n==null)return;let r=await this.getDataOut();if(r==null)throw new p(`Data out is not set`,{code:f.STEP_LOGIC_ISSUE});if(n.instance.sequence===r.sequence){this.log.WARN?.(`Skip change processing. Sequence is the same`,{sequence:n.instance.sequence});return}if(await this.setDataOut(n?.instance),this.shouldHandleStateChange(e)){this.state.changes.push({change:n,type:e}),await i(),this.tryRunWorker();return}this.log.DEBUG?.(`Data out updated`,n?.instance)}shouldHandleStateChange(e){let{useSharedState:t,handleStateChange:n,handleSharedStateChange:r}=this.data;return e===`local`?!!(t?r?.includes(`local`):n):!!(t&&r?.includes(`remote`))}tryRunWorker(){if(N.isBusy(this.thread)){this.log.DEBUG?.(`Skip change processing. Worker thread is busy`);return}let e=this.state.changes.shift();e!=null&&(this.log.DEBUG?.(`Notify change listener worker thread about change to process`,e),N.start(this.thread,e))}runStep(){let{useSharedState:e}=this.data,t=this.shouldHandleStateChange(`local`),n=this.shouldHandleStateChange(`remote`),r=t||n;this.triggers.local({name:F.stateChanged},this.onLocalStateChange),e&&this.triggers.once({name:this.remoteChangeEventName,topic:this.thread.config.flowId},this.onRemoteStateChange),r&&this.triggers.hook({name:`end`,thread:N.getThreadId(this.thread.step.id)},this.onWorkerThreadEnd),this.triggers.otherwise(this.initialize)}initialize(){this.log.DEBUG?.(`Initializing ChangeListener thread...`)}async onLocalStateChange(e){this.log.DEBUG?.(`State has been changed in current flow`,e),await this.handleChange(`local`)}async onRemoteStateChange(e){this.log.DEBUG?.(`State has been changed in remote flow`,e),await this.handleChange(`remote`)}onWorkerThreadEnd(e){let{result:t}=e.params.thread;if(this.log.DEBUG?.(`ChangeListenerWorker thread finished processing change`,t),t instanceof Error)throw h(t,{unknownMessage:`ChangeListenerWorker thread ended with an error`});this.tryRunWorker()}};O([_,D(`design:type`,Function),D(`design:paramtypes`,[]),D(`design:returntype`,void 0)],I.prototype,`runStep`,null),O([_,D(`design:type`,Function),D(`design:paramtypes`,[]),D(`design:returntype`,void 0)],I.prototype,`initialize`,null),O([_,D(`design:type`,Function),D(`design:paramtypes`,[Object]),D(`design:returntype`,Promise)],I.prototype,`onLocalStateChange`,null),O([_,D(`design:type`,Function),D(`design:paramtypes`,[Object]),D(`design:returntype`,Promise)],I.prototype,`onRemoteStateChange`,null),O([_,D(`design:type`,Function),D(`design:paramtypes`,[Object]),D(`design:returntype`,void 0)],I.prototype,`onWorkerThreadEnd`,null);const L=e(import.meta.url);async function R(e){if(typeof e!=`string`||!/^\d+\.\d+\.\d+$/.test(e))throw Error(`Invalid minimum version format: ${e}`);let t=L.resolve(`@onereach/flow-sdk/package.json`);if(!t)throw Error(`Could not find package.json for @onereach/flow-sdk`);let n=await d(t,`utf8`),{version:r}=JSON.parse(n),{groups:i}=/^(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)/.exec(r)||{};if(!i)throw Error(`Invalid Flow SDK version format: ${r}`);let a=Math.trunc(Number(i.major??`0`)),o=Math.trunc(Number(i.minor??`0`)),s=Math.trunc(Number(i.patch??`0`));if(a==null||o==null||s==null||Number.isNaN(a)||Number.isNaN(o)||Number.isNaN(s))throw Error(`Invalid version format: ${r}`);let[c,l,u]=e.split(`.`).map(e=>Math.trunc(Number(e)));if(c==null||l==null||u==null||Number.isNaN(c)||Number.isNaN(l)||Number.isNaN(u))throw Error(`Invalid minimum version format: ${e}`);if(a<c||a===c&&o<l||a===c&&o===l&&s<u)throw Error(`Flow SDK version '${r}' is lower than required minimum version '${e}' for the step`)}var z=class extends k{validateMergeFieldType(){if(this.dataOut==null||this.getMergeField(this.dataOut).type===`thread`)throw new p(`Merge-field type can not be "Thread" for this step`,{code:f.VALIDATION})}get stateMachine(){return new r(this.thread,{cache:this.data._testSettings?.cache,instanceTtl:this.instanceTtl}).stateMachine}get instanceTtl(){let{stateTtl:e}=this.data;return e?.input?a(e.input,e.outputMode):void 0}async runStep(){await R(`8.0.72`),this.validateMergeFieldType(),this.step.dataOut&&await I.start(this.thread);let{stateId:e,stateTemplateId:t,handleMissingTemplate:r}=this.data,i=await this.stateMachine.load({id:e});if(i==null)try{i=await this.stateMachine.create({id:e,template:{id:t}})}catch(e){if(r&&e instanceof n){this.exitStep(`not found`);return}throw e}this.exitStep(`next`,i.instance)}};O([w,D(`design:type`,Function),D(`design:paramtypes`,[]),D(`design:returntype`,Promise)],z.prototype,`runStep`,null),t();const B={[I.class]:I,[N.class]:N};export{I as ChangeListener,N as ChangeListenerWorker,z as InitializeStateMachineStep,z as step,P as changeListenerClassId,F as changeListenerEvents,j as changeListenerWorkerClassId,M as changeListenerWorkerExits,B as states};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["defaultOptions"],"sources":["../src/errors/step-error.ts","../src/errors/error-filter.ts","../src/utils/create-method-decorator.ts","../src/decorators/background-thread-error-filter.ts","../src/utils/thread-utilities.ts","../src/decorators/error-filter.ts","../src/schemas/data-in.ts","../src/threads/base/base.ts","../src/threads/base/constants.ts","../src/threads/change-listener/worker/constants.ts","../src/threads/change-listener/worker/change-listener-worker.ts","../src/threads/change-listener/listener/constants.ts","../src/threads/change-listener/listener/change-listener.ts","../src/utils/validate-flow-sdk-version.ts","../src/threads/main/step.ts","../src/index.ts"],"sourcesContent":["import { BasicError } from '@onereach/flow-sdk/errors/base.js';\n\nexport const ErrorCode = {\n  UNKNOWN: 'UNKNOWN',\n  STEP_LOGIC_ISSUE: 'STEP_LOGIC_ISSUE',\n  TIMEOUT: 'TIMEOUT',\n  VALIDATION: 'VALIDATION',\n  SERVER_ERROR: 'SERVER_ERROR',\n  UNSUPPORTED: 'UNSUPPORTED',\n} as const;\n\nexport class InitializeStateMachineStepError extends BasicError<{\n  code: keyof typeof ErrorCode;\n  data?: unknown;\n}> {}\n\nexport class AbortRequestError extends BasicError {}\n","import { TimeoutError } from '@onereach/flow-sdk/errors/timeout.js';\nimport * as z from 'zod/mini';\n\nimport { InitializeStateMachineStepError, ErrorCode } from './step-error.ts';\n\n// eslint-disable-next-line unicorn/no-top-level-side-effects\nz.config(z.locales.en());\n\nconst defaultPreserveErrors = [InitializeStateMachineStepError, TimeoutError] as const;\nexport function errorFilter<P extends readonly AnyErrorClass[] = typeof defaultPreserveErrors>(\n  error: unknown,\n  options: ErrorFilterOptions<P> = {},\n): InstancesOf<P> | InitializeStateMachineStepError | TimeoutError {\n  const {\n    preserveErrors = defaultPreserveErrors,\n    unknownMessage = 'Unknown error',\n    unknownCode = ErrorCode.UNKNOWN,\n  } = options;\n\n  // if error is CreateChatCompletionStepError or TimeoutError, return it directly\n  if (preserveErrors?.some((ErrorClass) => error instanceof ErrorClass)) {\n    return error as InstancesOf<P>;\n  }\n\n  // validation errors\n  if (error instanceof z.core.$ZodError) {\n    return new InitializeStateMachineStepError(z.prettifyError(error), error, {\n      code: ErrorCode.VALIDATION,\n    });\n  }\n\n  // if error is a string assume it's an error message\n  if (typeof error === 'string') {\n    return new InitializeStateMachineStepError(error, {\n      code: ErrorCode.UNKNOWN,\n    });\n  }\n\n  if (error instanceof Error) {\n    // timeout errors\n    if (error.message.includes('Request timed out')) {\n      return new TimeoutError('Timeout', error, { code: ErrorCode.TIMEOUT });\n    }\n\n    // TODO: fix interpreting of this kind of errors\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n    const responseErrorMessage: string | undefined = (error as unknown as any)?.response?.data?.error?.message;\n    if (responseErrorMessage != undefined) {\n      return new InitializeStateMachineStepError(responseErrorMessage, error, {\n        code: ErrorCode.SERVER_ERROR,\n      });\n    }\n\n    return new InitializeStateMachineStepError(unknownMessage, error, {\n      code: unknownCode,\n    });\n  }\n\n  // catch all for unknown errors\n  return new InitializeStateMachineStepError(unknownMessage, {\n    code: unknownCode,\n    data: error,\n  });\n}\n\nexport type ErrorFilterOptions<P extends readonly AnyErrorClass[]> = {\n  /**\n  Array of error classes that should not be wrapped\n  */\n  preserveErrors?: P;\n  /**\n  Error message to use when message is unknown\n  */\n  unknownMessage?: string;\n  /**\n  Error code to use when message is unknown\n  */\n  unknownCode?: keyof typeof ErrorCode;\n};\n\n/**\nAny Error class\n*/\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyErrorClass<E extends Error = Error> = new (...arguments_: any[]) => E;\n\n/**\nTurn a tuple/array of constructors into a union of their instance types.\n*/\nexport type InstancesOf<Ctors extends readonly AnyErrorClass[]> =\n  Ctors[number] extends AnyErrorClass<infer I> ? I : never;\n","/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Creates a method decorator that can be used with or without options.\n * @param apply - Function that applies the decorator logic with given options.\n * @param defaultOptions - Default options to use if none are provided.\n */\nexport function createMethodDecoratorWithOptionalArguments<A, T extends AnyFunction = AnyFunction>(\n  apply: (\n    options: A,\n    target: object,\n    propertyKey: string | symbol,\n    descriptor: TypedPropertyDescriptor<T>,\n  ) => T | TypedPropertyDescriptor<T> | void,\n  defaultOptions: A,\n): MethodDecoratorWithOptionalArguments<A, T> {\n  function runApply(\n    options: A,\n    target: object,\n    propertyKey: string | symbol,\n    descriptor: TypedPropertyDescriptor<T>,\n  ): TypedPropertyDescriptor<T> | void {\n    const maybe = apply(options, target, propertyKey, descriptor);\n\n    // If the decorator factory returned a wrapped function, assign it to the descriptor here\n    if (typeof maybe === 'function') {\n      const originalMethod = descriptor.value;\n      const wrappedMethod = maybe as typeof originalMethod;\n\n      if (originalMethod?.name != undefined) {\n        try {\n          Object.defineProperty(wrappedMethod, 'name', { value: originalMethod.name });\n        } catch {\n          // ignore if name is non-configurable\n        }\n      }\n\n      descriptor.value = wrappedMethod;\n      return descriptor;\n    }\n\n    // If a descriptor was returned or decorator mutated descriptor in-place, use that\n    return maybe ?? descriptor;\n  }\n\n  return function decoratorOrFactory(\n    argument0?: object | A,\n    argument1?: string | symbol,\n    argument2?: TypedPropertyDescriptor<T>,\n  ): any {\n    if (\n      argument0 !== null &&\n      argument2 !== null &&\n      typeof argument0 === 'object' &&\n      typeof argument2 === 'object' &&\n      (typeof argument1 === 'string' || typeof argument1 === 'symbol')\n    ) {\n      // Called as plain decorator: @Decorator\n      return runApply(defaultOptions, argument0, argument1, argument2);\n    }\n\n    // Called as decorator factory: @Decorator(options)\n    const options = (argument0 as A) ?? defaultOptions;\n    return (target: object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<T>) => {\n      return runApply(options, target, propertyKey, descriptor);\n    };\n  };\n}\n\nexport type AnyFunction = (...arguments_: any[]) => any;\n\nexport type MethodDecoratorWithOptionalArguments<A, T extends AnyFunction = AnyFunction> =\n  // Plain method decorator (three arguments)\n  ((\n    target: object,\n    propertyKey: string | symbol,\n    descriptor: TypedPropertyDescriptor<T>,\n  ) => TypedPropertyDescriptor<T> | void) &\n    // Decorator factory (optional options argument)\n    ((options?: A) => MethodDecorator);\n","/* eslint-disable unicorn/prefer-await */\n\nimport type { Step } from '@onereach/flow-sdk/step.js';\nimport { ACTION } from '@onereach/flow-sdk/types/index.js';\n\nimport { errorFilter } from '../errors/error-filter.ts';\nimport { createMethodDecoratorWithOptionalArguments } from '../utils/create-method-decorator.ts';\n\nconst defaultOptions: BackgroundThreadErrorFilterOptions = { allowHandleError: false, useErrorFilter: true };\n\n/**\n * Since errors in hooks are fatal and can't be processed this decorator allows to wrap hook handler\n * and manage errors by ending a thread with the error (preventing sending error to `error` exit)\n * @param options.allowHandleError - Default `false`. If `false` in case of error will end thread with error as result, if `true` will allow to handle error via 'error' exit\n * @param options.useErrorFilter - Default `true`. If `true` every error wild be processed with `errorFilter` utility function\n */\nexport const BackgroundThreadErrorFilter = createMethodDecoratorWithOptionalArguments(\n  (options, _target, propertyKey, descriptor) => {\n    const originalMethod = descriptor.value;\n    if (!originalMethod || typeof originalMethod !== 'function') return;\n\n    return function (this: Step, ...arguments_: Parameters<typeof originalMethod>): ReturnType<typeof originalMethod> {\n      try {\n        const result: unknown = originalMethod.apply(this, arguments_);\n\n        if (result instanceof Promise) {\n          return result.catch((error) => errorHandler.call(this, options, error, propertyKey));\n        }\n\n        return result;\n      } catch (error) {\n        return errorHandler.call(this, options, error, propertyKey) as ReturnType<typeof originalMethod>;\n      }\n    } as typeof originalMethod;\n  },\n  defaultOptions,\n);\n\nfunction errorHandler(\n  this: Step,\n  options: BackgroundThreadErrorFilterOptions,\n  error: unknown,\n  propertyKey: string | symbol,\n): void {\n  const methodName = propertyKey.toString();\n  this.log.DEBUG?.(`Error in method '${methodName}'`, error);\n  const filteredError = options.useErrorFilter ? errorFilter(error) : error;\n\n  if (filteredError instanceof Error) {\n    if (options.allowHandleError) {\n      // Send it to the 'error' exit and stop here\n      this.thread.enqueue({ name: ACTION.error, error: filteredError });\n      return;\n    }\n    // End the thread with the error and stop here\n    this.end(filteredError);\n    return;\n  }\n\n  // Only throw if it's not an Error instance and you truly want to bubble it\n  throw filteredError;\n}\n\nexport type BackgroundThreadErrorFilterOptions = {\n  allowHandleError?: boolean;\n  useErrorFilter?: boolean;\n};\n","import { ACTION } from '@onereach/flow-sdk/types/index.js';\nimport type { CONFIG, IThread, IThreadId, IThreadOptions, RESULT } from '@onereach/flow-sdk/types/index.js';\n\n/**\n * Runs a new thread or reuses an existing one (if it ended).\n * @param thread The step to run the thread for.\n * @throws Error if the thread is not ended or if the state is not provided.\n */\nexport async function runChildThread<ThreadConfig extends CONFIG & ManagedThreadConfig, StepConfig extends CONFIG>(\n  thread: IThread<StepConfig>,\n  { id, state, local, ...options }: IThreadOptions<ThreadConfig>,\n  { force }: { force?: boolean } = {},\n): Promise<RESULT<ThreadConfig>> {\n  const threadToRun = thread.process.getThread<ThreadConfig>(id);\n  thread.log.DEBUG?.(`runThread: thread with id '${id}'`, options);\n\n  if (threadToRun == undefined) {\n    // create thread\n    return await thread.thread.runThread<ThreadConfig>({\n      ...options,\n      id,\n      state,\n      local: {\n        ...local,\n        parent: thread.thread.id,\n        active: true,\n      },\n    });\n  }\n\n  if (!force && !threadToRun.ended && threadToRun.local.active)\n    throw new Error(`Thread with id '${id}' has not ended yet, cannot start it again`);\n  if (state == undefined) throw new Error(`Thread with id '${id}' must have a state to run`);\n\n  // reuse existing thread\n  threadToRun.local.active = true;\n  return await threadToRun.enqueueAndRun({\n    name: ACTION.goto,\n    state: {\n      ...state,\n      active: true,\n    },\n  });\n}\n\nexport function isThreadBusy<StepConfig extends CONFIG, ThreadConfig extends CONFIG & ManagedThreadConfig>(\n  thread: IThread<StepConfig>,\n  threadId: IThreadId,\n): boolean {\n  const threadToCheck = thread.process.getThread<ThreadConfig>(threadId);\n  return threadToCheck != undefined && threadToCheck.local.active && !threadToCheck.ended;\n}\n\nexport function listChildThreads<StepConfig extends CONFIG, ChildThreadConfig extends CONFIG & ManagedThreadConfig>(\n  thread: IThread<StepConfig>,\n  parentThreadId: IThreadId = thread.id,\n): IThread<ChildThreadConfig>[] {\n  const childThreads = [];\n  for (const threadId in thread.process.threads) {\n    const item = thread.process.threads[threadId]! as unknown as IThread<ChildThreadConfig>;\n    if (item?.local.parent === parentThreadId) childThreads.push(item);\n  }\n  return childThreads;\n}\n\nexport async function stopThread<ThreadConfig extends CONFIG & ManagedThreadConfig, StepConfig extends CONFIG>(\n  thread: IThread<StepConfig>,\n  id: IThreadId,\n  { result, stopChildThreads }: { result?: RESULT<ThreadConfig>; stopChildThreads?: boolean } = {},\n): Promise<void> {\n  const threadToStop = thread.process.getThread<ThreadConfig>(id);\n  thread.log.DEBUG?.(`stopThread: thread with id '${id}'`);\n\n  if (!threadToStop) return;\n\n  if (stopChildThreads) await endChildThreads(threadToStop, result);\n\n  if (!threadToStop.local.active) return;\n\n  threadToStop.local.active = false;\n  if (threadToStop.ended) return;\n\n  await threadToStop.enqueueAndRun({ name: ACTION.ending, result });\n}\n\nexport async function endChildThreads<ThreadConfig extends CONFIG, StepConfig extends CONFIG>(\n  thread: IThread<StepConfig>,\n  result?: RESULT<ThreadConfig>,\n  options: { throw?: boolean } = {},\n): Promise<PromiseSettledResult<void>[]> {\n  const childThreads = listChildThreads(thread);\n  const stopTasks = childThreads.map(\n    async (child) => await stopThread(thread, child.id, { stopChildThreads: true, result }),\n  );\n  const stopResults = await Promise.allSettled(stopTasks);\n\n  const isThrowError = options.throw ?? true;\n  if (isThrowError) {\n    const failedTask = stopResults.find((task) => task.status === 'rejected');\n    if (failedTask) throw failedTask.reason;\n  }\n\n  return stopResults;\n}\n\nexport type ManagedThreadLocal = {\n  active: boolean;\n  parent: IThreadId;\n};\n\nexport type ManagedThreadConfig = {\n  local: ManagedThreadLocal;\n};\n","/* eslint-disable unicorn/prefer-await */\n\nimport type { Step } from '@onereach/flow-sdk/step.js';\n\nimport { errorFilter } from '../errors/error-filter.ts';\nimport { createMethodDecoratorWithOptionalArguments } from '../utils/create-method-decorator.ts';\n\nconst defaultOptions = {};\n\n/**\n * Will wrap method with `errorFilter` for every error.\n */\nexport const ErrorFilter = createMethodDecoratorWithOptionalArguments((_options, _target, propertyKey, descriptor) => {\n  const originalMethod = descriptor.value;\n\n  if (!originalMethod || typeof originalMethod !== 'function') return;\n\n  return function (this: Step, ...arguments_: Parameters<typeof originalMethod>): ReturnType<typeof originalMethod> {\n    try {\n      const result: unknown = originalMethod.apply(this, arguments_);\n\n      if (result instanceof Promise) {\n        return result.catch((error: unknown) => {\n          const methodName = propertyKey.toString();\n          this.log.DEBUG?.(`Error in method '${methodName}'`, error);\n          throw errorFilter(error);\n        }) as ReturnType<typeof originalMethod>;\n      }\n\n      return result;\n    } catch (error) {\n      const methodName = propertyKey.toString();\n      this.log.DEBUG?.(`Error in method '${methodName}'`, error);\n      throw errorFilter(error);\n    }\n  };\n}, defaultOptions);\n","/* eslint-disable unicorn/max-nested-calls */\nimport type { ICacheFacade } from '@onereach/flow-sdk/types/index.js';\nimport * as z from 'zod/mini';\n\n// eslint-disable-next-line unicorn/no-top-level-side-effects\nz.config(z.locales.en());\n\n// string that prevents\nconst stringNoUndefinedSchema = z.string().check(\n  z.trim(),\n  z.refine((value) => !['undefined', 'null'].includes(value), {\n    error: 'Unexpected undefined or null merge-field value',\n  }),\n);\n\nexport const dataInSchema = z.object({\n  stateTemplateId: stringNoUndefinedSchema.check(z.minLength(1), z.maxLength(64)),\n  handleMissingTemplate: z.optional(z.boolean()),\n\n  stateId: stringNoUndefinedSchema.check(z.minLength(1), z.maxLength(64)),\n  stateTtl: z.optional(\n    z.object({\n      input: stringNoUndefinedSchema,\n      outputMode: z.enum(['ms', 's', 'm', 'h', 'd']),\n    }),\n  ),\n  customizeInitialValue: z.optional(z.boolean()),\n\n  useSharedState: z.optional(z.boolean()),\n  handleStateChange: z.optional(z.boolean()),\n  handleSharedStateChange: z.optional(z.array(z.enum(['local', 'remote']))),\n\n  processError: z.boolean(),\n  processTimeout: z.boolean(),\n  timeoutDuration: stringNoUndefinedSchema.check(z.trim(), z.minLength(1)),\n\n  // for integration tests\n  _testSettings: z.optional(\n    z.object({\n      cache: z.optional(z.custom<ICacheFacade>()),\n    }),\n  ),\n});\n\nexport type DataIn = z.infer<typeof dataInSchema>;\n\n// /**\n//  * Convert empty string to undefined before running schema validation\n//  * @param schema schema to validate against\n//  * @param defaultValue optional default value\n//  */\n// function optionalStringValue<T extends z.core.SomeType>(schema: T) {\n//   return z.optional(\n//     z.pipe(\n//       z.union([z.undefined(), z.literal(''), schema]),\n//       z.transform((value) => (value === '' ? undefined : value)),\n//     ),\n//   );\n// }\n","import { Step } from '@onereach/flow-sdk/step.js';\n\nimport { ErrorFilter } from '../../decorators/error-filter.ts';\nimport { dataInSchema } from '../../schemas/data-in.ts';\n\nimport type { BaseConfig } from './types.ts';\n\n// TODO: convert it into class decorator\nexport class BaseStep<T extends BaseConfig> extends Step<T> {\n  @ErrorFilter\n  public async resolveDataIn() {\n    const dataIn = await super.resolveDataIn();\n    return dataInSchema.parse(dataIn);\n  }\n}\n","export const baseClassIdPrefix = 'sm_mgr';\n","export const changeListenerWorkerClassId = 'chg_wrk';\n\nexport const changeListenerWorkerExits = {\n  local: 'local change',\n  remote: 'remote change',\n} as const;\n","import type { IStepId, IThread, IThreadId } from '@onereach/flow-sdk/types/index.js';\n\nimport { ErrorFilter } from '../../../decorators/error-filter.ts';\nimport { InitializeStateMachineStepError, ErrorCode } from '../../../errors/step-error.ts';\nimport { isThreadBusy, runChildThread } from '../../../utils/thread-utilities.ts';\nimport { BaseStep } from '../../base/base.ts';\nimport { baseClassIdPrefix } from '../../base/constants.ts';\nimport type { ChangeListenerChange, ChangeListenerConfig } from '../listener/types.ts';\n\nimport { changeListenerWorkerClassId, changeListenerWorkerExits } from './constants.ts';\nimport type { ChangeListenerWorkerConfig } from './types.ts';\n\nexport class ChangeListenerWorker extends BaseStep<ChangeListenerWorkerConfig> {\n  public static readonly class = changeListenerWorkerClassId;\n\n  public static async start(thread: IThread<ChangeListenerConfig>, change: ChangeListenerChange): Promise<void> {\n    await runChildThread<ChangeListenerWorkerConfig, ChangeListenerConfig>(thread, {\n      id: this.getThreadId(thread.step.id),\n      state: {\n        step: thread.step.id,\n        class: this.class,\n\n        change,\n      },\n    });\n  }\n\n  public static isBusy(thread: IThread<ChangeListenerConfig>): boolean {\n    return isThreadBusy<ChangeListenerConfig, ChangeListenerWorkerConfig>(thread, this.getThreadId(thread.step.id));\n  }\n\n  public static getThreadId(stepId: IStepId): IThreadId {\n    return `${baseClassIdPrefix}_${this.class}_${stepId}`;\n  }\n\n  // ----------------------------------------------\n\n  @ErrorFilter\n  public runStep(): void {\n    if (this.state.change == undefined) {\n      throw new InitializeStateMachineStepError(\n        'Change listener worker thread state must contain an instance to process',\n        {\n          code: ErrorCode.STEP_LOGIC_ISSUE,\n        },\n      );\n    }\n\n    const { change } = this.state;\n    this.log.DEBUG?.('Executing change listener worker thread', change);\n    this.exitStep(changeListenerWorkerExits[change.type], change.change.instance);\n  }\n}\n","export const changeListenerClassId = 'cng_lnr';\n\nexport const changeListenerEvents = {\n  stateChanged: 'st_cgd',\n} as const;\n","/* eslint-disable @typescript-eslint/unbound-method */\n\nimport type { CONFIG, IActionEvent, IStepId, IThread, IThreadId } from '@onereach/flow-sdk/types/index.js';\nimport {\n  InitializeStateMachineContext,\n  StateMachineService,\n  StateMachineThreadService,\n} from '@onereach/state-machine-step-service';\nimport { setImmediate } from 'node:timers/promises';\nimport timestring from 'timestring';\n\nimport { BackgroundThreadErrorFilter } from '../../../decorators/background-thread-error-filter.ts';\nimport { errorFilter } from '../../../errors/error-filter.ts';\nimport { ErrorCode, InitializeStateMachineStepError } from '../../../errors/step-error.ts';\nimport { runChildThread, stopThread } from '../../../utils/thread-utilities.ts';\nimport { BaseStep } from '../../base/base.ts';\nimport { baseClassIdPrefix } from '../../base/constants.ts';\nimport { InitializeStateMachineConfig } from '../../main/types.ts';\nimport { ChangeListenerWorker } from '../worker/change-listener-worker.ts';\nimport { ChangeListenerWorkerConfig } from '../worker/types.ts';\n\nimport { changeListenerClassId, changeListenerEvents } from './constants.ts';\nimport type {\n  ChangeListenerConfig,\n  ChangeListenerLocalChangeEvent,\n  ChangeListenerRemoteChangeEvent,\n  ChangeListenerRemoteChangeEventName,\n} from './types.ts';\n\nexport class ChangeListener extends BaseStep<ChangeListenerConfig> {\n  public static readonly class = changeListenerClassId;\n\n  public static async start(thread: IThread<InitializeStateMachineConfig>): Promise<void> {\n    await runChildThread<ChangeListenerConfig, InitializeStateMachineConfig>(\n      thread,\n      {\n        id: this.getThreadId(thread.step.id),\n        state: {\n          step: thread.step.id,\n          class: this.class,\n\n          changes: [],\n        },\n        background: true,\n      },\n      { force: true },\n    );\n  }\n\n  public static async stop<TConfig extends CONFIG>(thread: IThread<TConfig>): Promise<void> {\n    await stopThread(thread, this.getThreadId(thread.step.id));\n  }\n\n  public static getThreadId(stepId: IStepId): IThreadId {\n    return `${baseClassIdPrefix}_${this.class}_${stepId}`;\n  }\n\n  // ---------------------------------------\n\n  private get stateMachine(): StateMachineService<InitializeStateMachineContext> {\n    const service = new StateMachineThreadService<ChangeListenerConfig, InitializeStateMachineContext>(this.thread, {\n      cache: this.data._testSettings?.cache,\n      instanceTtl: this.instanceTtl,\n    });\n    return service.stateMachine;\n  }\n\n  private get instanceTtl(): number | undefined {\n    const { stateTtl } = this.data;\n    return stateTtl?.input ? timestring(stateTtl.input, stateTtl.outputMode) : undefined;\n  }\n\n  private get remoteChangeEventName(): ChangeListenerRemoteChangeEventName {\n    const { stateTemplateId, stateId } = this.data;\n\n    return `sm/${stateTemplateId}/${stateId}`;\n  }\n\n  private async handleChange(changeType: 'local' | 'remote'): Promise<void> {\n    const { stateId } = this.data;\n    const updated = await this.stateMachine.load({ id: stateId });\n\n    // TODO: handle state deletion\n    if (updated == undefined) return;\n\n    // TODO: check if there was an actual change, only then update data out and run worker thread\n    const currentDataOut = await this.getDataOut();\n\n    if (currentDataOut == undefined)\n      throw new InitializeStateMachineStepError('Data out is not set', {\n        code: ErrorCode.STEP_LOGIC_ISSUE,\n      });\n\n    // skip data out update if the sequence is the same\n    if (updated.instance.sequence === currentDataOut.sequence) {\n      this.log.WARN?.('Skip change processing. Sequence is the same', { sequence: updated.instance.sequence });\n      return;\n    }\n\n    await this.setDataOut(updated?.instance);\n\n    if (this.shouldHandleStateChange(changeType)) {\n      this.state.changes.push({\n        change: updated,\n        type: changeType,\n      });\n      // release the event loop to unblock the thread\n      await setImmediate();\n      this.tryRunWorker();\n      return;\n    }\n\n    this.log.DEBUG?.('Data out updated', updated?.instance);\n  }\n\n  private shouldHandleStateChange(type: 'local' | 'remote'): boolean {\n    const { useSharedState, handleStateChange, handleSharedStateChange } = this.data;\n\n    return type === 'local'\n      ? Boolean(useSharedState ? handleSharedStateChange?.includes('local') : handleStateChange)\n      : Boolean(useSharedState && handleSharedStateChange?.includes('remote'));\n  }\n\n  /**\n   * Processes the next change in the listener thread's queue.\n   * If the worker thread is busy, it skips processing.\n   * If the event is the termination marker, it notifies the end of the controller thread.\n   * If the event is ready for processing, it starts the worker thread to handle it.\n   */\n  private tryRunWorker(): void {\n    // skip if worker thread is busy\n    if (ChangeListenerWorker.isBusy(this.thread)) {\n      this.log.DEBUG?.('Skip change processing. Worker thread is busy');\n      return;\n    }\n\n    const change = this.state.changes.shift();\n    if (change == undefined) return;\n\n    this.log.DEBUG?.('Notify change listener worker thread about change to process', change);\n\n    void ChangeListenerWorker.start(this.thread, change);\n  }\n\n  @BackgroundThreadErrorFilter\n  public runStep(): void {\n    const { useSharedState } = this.data;\n    const shouldHandleLocalChanges = this.shouldHandleStateChange('local');\n    const shouldHandleRemoteChanges = this.shouldHandleStateChange('remote');\n    const shouldHandleChanges = shouldHandleLocalChanges || shouldHandleRemoteChanges;\n\n    this.triggers.local({ name: changeListenerEvents.stateChanged }, this.onLocalStateChange);\n    if (useSharedState) {\n      this.triggers.once(\n        { name: this.remoteChangeEventName, topic: this.thread.config.flowId },\n        this.onRemoteStateChange,\n      );\n    }\n    if (shouldHandleChanges) {\n      this.triggers.hook<ChangeListenerWorkerConfig, 'end'>(\n        { name: 'end', thread: ChangeListenerWorker.getThreadId(this.thread.step.id) },\n        this.onWorkerThreadEnd,\n      );\n    }\n    this.triggers.otherwise(this.initialize);\n  }\n\n  @BackgroundThreadErrorFilter\n  public initialize(): void {\n    this.log.DEBUG?.('Initializing ChangeListener thread...');\n  }\n\n  @BackgroundThreadErrorFilter\n  public async onLocalStateChange(event: ChangeListenerLocalChangeEvent): Promise<void> {\n    this.log.DEBUG?.(`State has been changed in current flow`, event);\n\n    await this.handleChange('local');\n  }\n\n  @BackgroundThreadErrorFilter\n  public async onRemoteStateChange(event: ChangeListenerRemoteChangeEvent): Promise<void> {\n    this.log.DEBUG?.(`State has been changed in remote flow`, event);\n\n    await this.handleChange('remote');\n  }\n\n  /**\n   * Handler of the worker thread end event.\n   */\n  @BackgroundThreadErrorFilter\n  public onWorkerThreadEnd(event: IActionEvent<ChangeListenerWorkerConfig, 'end'>): void {\n    const { result } = event.params.thread;\n\n    this.log.DEBUG?.('ChangeListenerWorker thread finished processing change', result);\n\n    if (result instanceof Error) {\n      const resultError = errorFilter(result, {\n        unknownMessage: 'ChangeListenerWorker thread ended with an error',\n      });\n      throw resultError;\n    }\n\n    // check if there are more tool calls or content chunks to process\n    this.tryRunWorker();\n  }\n}\n","import { readFile } from 'node:fs/promises';\nimport { createRequire } from 'node:module';\n\nconst require = createRequire(import.meta.url);\n\nexport async function validateFlowSdkVersion(minVersion: string): Promise<void> {\n  if (typeof minVersion !== 'string' || !/^\\d+\\.\\d+\\.\\d+$/.test(minVersion)) {\n    throw new Error(`Invalid minimum version format: ${minVersion}`);\n  }\n\n  const packageJsonPath = require.resolve('@onereach/flow-sdk/package.json');\n  if (!packageJsonPath) {\n    throw new Error(`Could not find package.json for @onereach/flow-sdk`);\n  }\n  // Read the package.json file to get the version\n  const packageJsonContent = await readFile(packageJsonPath, 'utf8');\n\n  const { version } = JSON.parse(packageJsonContent) as { version: string };\n  const { groups } = /^(?<major>\\d+)\\.(?<minor>\\d+)\\.(?<patch>\\d+)/.exec(version) || {};\n\n  if (!groups) throw new Error(`Invalid Flow SDK version format: ${version}`);\n\n  const major = Math.trunc(Number(groups.major ?? '0'));\n  const minor = Math.trunc(Number(groups.minor ?? '0'));\n  const patch = Math.trunc(Number(groups.patch ?? '0'));\n\n  if (\n    major == undefined ||\n    minor == undefined ||\n    patch == undefined ||\n    Number.isNaN(major) ||\n    Number.isNaN(minor) ||\n    Number.isNaN(patch)\n  ) {\n    throw new Error(`Invalid version format: ${version}`);\n  }\n\n  const [minMajor, minMinor, minPatch] = minVersion.split('.').map((x) => Math.trunc(Number(x)));\n\n  if (\n    minMajor == undefined ||\n    minMinor == undefined ||\n    minPatch == undefined ||\n    Number.isNaN(minMajor) ||\n    Number.isNaN(minMinor) ||\n    Number.isNaN(minPatch)\n  ) {\n    throw new Error(`Invalid minimum version format: ${minVersion}`);\n  }\n\n  if (\n    major < minMajor ||\n    (major === minMajor && minor < minMinor) ||\n    (major === minMajor && minor === minMinor && patch < minPatch)\n  ) {\n    throw new Error(\n      `Flow SDK version '${version}' is lower than required minimum version '${minVersion}' for the step`,\n    );\n  }\n}\n","import { StateMachineThreadService, NotFoundError } from '@onereach/state-machine-step-service';\nimport type { InitializeStateMachineContext, StateMachineService } from '@onereach/state-machine-step-service';\nimport timestring from 'timestring';\n\nimport { ErrorFilter } from '../../decorators/error-filter.ts';\nimport { ErrorCode, InitializeStateMachineStepError } from '../../errors/step-error.ts';\nimport { validateFlowSdkVersion } from '../../utils/validate-flow-sdk-version.ts';\nimport { BaseStep } from '../base/base.ts';\nimport { ChangeListener } from '../change-listener/listener/change-listener.ts';\n\nimport type { InitializeStateMachineConfig } from './types.ts';\n\nconst MINIMAL_FLOW_SDK_VERSION = '8.0.72';\n\nexport class InitializeStateMachineStep extends BaseStep<InitializeStateMachineConfig> {\n  private validateMergeFieldType(): void {\n    if (this.dataOut == undefined || this.getMergeField(this.dataOut).type === 'thread') {\n      throw new InitializeStateMachineStepError('Merge-field type can not be \"Thread\" for this step', {\n        code: ErrorCode.VALIDATION,\n      });\n    }\n  }\n\n  private get stateMachine(): StateMachineService<InitializeStateMachineContext> {\n    const service = new StateMachineThreadService<InitializeStateMachineConfig, InitializeStateMachineContext>(\n      this.thread,\n      {\n        cache: this.data._testSettings?.cache,\n        instanceTtl: this.instanceTtl,\n      },\n    );\n    return service.stateMachine;\n  }\n\n  private get instanceTtl(): number | undefined {\n    const { stateTtl } = this.data;\n    return stateTtl?.input ? timestring(stateTtl.input, stateTtl.outputMode) : undefined;\n  }\n\n  @ErrorFilter\n  public async runStep(): Promise<void> {\n    await validateFlowSdkVersion(MINIMAL_FLOW_SDK_VERSION);\n    this.validateMergeFieldType();\n\n    if (this.step.dataOut) await ChangeListener.start(this.thread);\n\n    const { stateId, stateTemplateId, handleMissingTemplate } = this.data;\n    let snapshot = await this.stateMachine.load({ id: stateId });\n\n    if (snapshot == undefined) {\n      // TODO: run logic with overriding initial state value\n      try {\n        snapshot = await this.stateMachine.create({\n          id: stateId,\n          template: {\n            id: stateTemplateId,\n            // version: 'xxx' // TODO: add support for version of state machine template\n          },\n        });\n      } catch (error) {\n        if (handleMissingTemplate && error instanceof NotFoundError) {\n          this.exitStep('not found');\n          return;\n        }\n\n        throw error;\n      }\n    }\n\n    this.exitStep('next', snapshot.instance);\n  }\n}\n","import { install } from 'source-map-support';\n\nimport { ChangeListener } from './threads/change-listener/listener/change-listener.ts';\nimport { ChangeListenerWorker } from './threads/change-listener/worker/change-listener-worker.ts';\n\n// enable source map support for better error stack traces\n// eslint-disable-next-line unicorn/no-top-level-side-effects\ninstall();\n\nexport const states = {\n  [ChangeListener.class]: ChangeListener,\n  [ChangeListenerWorker.class]: ChangeListenerWorker,\n};\n\nexport { InitializeStateMachineStep as step, InitializeStateMachineStep } from './threads/main/step.ts';\n\nexport { ChangeListener } from './threads/change-listener/listener/change-listener.ts';\nexport { ChangeListenerWorker } from './threads/change-listener/worker/change-listener-worker.ts';\nexport * from './threads/change-listener/listener/constants.ts';\nexport * from './threads/change-listener/worker/constants.ts';\n\nexport type * from './types.ts';\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@onereach/step-initialize-state-manager",
+  "version": "1.0.0-framework.11",
+  "description": "Logic for Initializing State Manager step",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/metafile*.json"
+  ],
+  "keywords": [
+    "onereach",
+    "toolkit",
+    "step"
+  ],
+  "author": "OneReach Development Team <dev.team@onereach.ai>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/core": "^0.18.5",
+    "@onereach/flow-sdk": "v9.0.0-monosplit.5",
+    "@onereach/flow-sdk-mocks": "v9.0.0-monosplit.5",
+    "@onereach/orb-promises": "^8.1.3",
+    "@onereach/orb-storage": "^8.1.3",
+    "@onereach/step-execute-state-machine-function": "1.0.0-framework.11",
+    "@types/source-map-support": "^0.5.10",
+    "@types/timestring": "^7.0.0",
+    "publint": "^0.3.24",
+    "rollup-plugin-visualizer": "^7.1.1",
+    "tsdown": "^0.22.14",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.11"
+  },
+  "dependencies": {
+    "@onereach/state-machine-step-service": "1.0.0-framework.11",
+    "@onereach/ts-memoize": "^1.0.1",
+    "source-map-support": "^0.5.21",
+    "timestring": "^7.0.0",
+    "tslib": "2.8.1",
+    "zod": "^4.5.4"
+  },
+  "scripts": {
+    "build": "tsdown --config tsdown.config.mts",
+    "build:visualize": "VISUALIZE=1 pnpm build",
+    "preversion_": "pnpm build && pnpm test",
+    "publish:rc": "npm version prerelease --preid rc && npm publish --tag rc",
+    "test": "npm run unit",
+    "unit": "vitest run",
+    "preversion": "pnpm build"
+  }
+}