@statewalker/fsm 0.25.0 → 0.27.0

package/dist/index.d.ts

@@ -117,4 +117,10 @@ declare function setStateTracer(state: FsmState, print?: Printer): void;
 declare function isStateTransitionEnabled(process: FsmProcess, event: string): boolean;
 declare function getStateTransitions(state?: FsmState): [from: string, event: string, to: string][];
 
-export { EVENT_ANY, EVENT_EMPTY, type FsmEventKey, FsmProcess, type FsmProcessDump, type FsmProcessDumpHandler, type FsmProcessHandler, FsmState, type FsmStateConfig, FsmStateDescriptor, type FsmStateDump, type FsmStateDumpHandler, type FsmStateErrorHandler, type FsmStateHandler, type FsmStateKey, KEY_PRINTER, type Printer, type PrinterConfig, STATE_ANY, STATE_FINAL, STATE_INITIAL, STATUS_ENTER, STATUS_EXIT, STATUS_FINISHED, STATUS_FIRST, STATUS_LAST, STATUS_LEAF, STATUS_NEXT, STATUS_NONE, getPrinter, getProcessPrinter, getStateTransitions, isStateTransitionEnabled, newProcess, preparePrinter, setPrinter, setProcessPrinter, setProcessTracer, setStateTracer };
+type Module<C = unknown> = (context: C) => void | (() => void | Promise<void>) | Promise<void | (() => void | Promise<void>)>;
+declare function newFsmProcess<C>(context: C, config: FsmStateConfig, load: (state: string, event: undefined | string) => undefined | Module<C> | Module<C>[] | Promise<undefined | Module<C> | Module<C>[]>): [
+    dispatch: (event: string) => Promise<boolean>,
+    shutdown: () => Promise<void>
+];
+
+export { EVENT_ANY, EVENT_EMPTY, type FsmEventKey, FsmProcess, type FsmProcessDump, type FsmProcessDumpHandler, type FsmProcessHandler, FsmState, type FsmStateConfig, FsmStateDescriptor, type FsmStateDump, type FsmStateDumpHandler, type FsmStateErrorHandler, type FsmStateHandler, type FsmStateKey, KEY_PRINTER, type Module, type Printer, type PrinterConfig, STATE_ANY, STATE_FINAL, STATE_INITIAL, STATUS_ENTER, STATUS_EXIT, STATUS_FINISHED, STATUS_FIRST, STATUS_LAST, STATUS_LEAF, STATUS_NEXT, STATUS_NONE, getPrinter, getProcessPrinter, getStateTransitions, isStateTransitionEnabled, newFsmProcess, newProcess, preparePrinter, setPrinter, setProcessPrinter, setProcessTracer, setStateTracer };

package/dist/index.js

@@ -408,6 +408,33 @@ function getTransitionsFromDescriptor(descriptor, prevStateKey, index = {}) {
   }
   return result;
 }
+
+// src/newFsmProcess.ts
+function newFsmProcess(context, config, load) {
+  let started = false;
+  let terminated = false;
+  const process = new FsmProcess(config);
+  process.onStateCreate((state) => {
+    started = true;
+    state.onEnter(async () => {
+      const modules = await load(state.key, process.event) ?? [];
+      for (const module of Array.isArray(modules) ? modules : [modules]) {
+        const handler = await module(context);
+        if (typeof handler === "function") {
+          state.onExit(handler);
+        }
+      }
+    });
+  });
+  async function dispatch(event) {
+    return terminated || event !== void 0 && (!started || isStateTransitionEnabled(process, event)) ? process.dispatch(event) : false;
+  }
+  async function shutdown() {
+    await process.shutdown();
+    terminated = true;
+  }
+  return [dispatch, shutdown];
+}
 export {
   EVENT_ANY,
   EVENT_EMPTY,
@@ -430,6 +457,7 @@ export {
   getProcessPrinter,
   getStateTransitions,
   isStateTransitionEnabled,
+  newFsmProcess,
   newProcess,
   preparePrinter,
   setPrinter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statewalker/fsm",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "HFSM Implementation",
   "keywords": [],
   "homepage": "https://github.com/statewalker/statewalker-fsm",

package/src/index.ts

@@ -3,3 +3,4 @@ export * from "./FsmState.ts";
 export * from "./FsmStateConfig.ts";
 export * from "./FsmStateDescriptor.ts";
 export * from "./utils/index.ts";
+export * from "./newFsmProcess.js";

package/src/newFsmProcess.ts

@@ -0,0 +1,54 @@
+import { FsmProcess } from "./FsmProcess.js";
+import type { FsmStateConfig } from "./FsmStateConfig.js";
+import { isStateTransitionEnabled } from "./utils/transitions.js";
+
+export type Module<C = unknown> = (
+  context: C,
+) =>
+  | void
+  | (() => void | Promise<void>)
+  | Promise<void | (() => void | Promise<void>)>;
+
+export function newFsmProcess<C>(
+  context: C,
+  config: FsmStateConfig,
+  load: (
+    state: string,
+    event: undefined | string,
+  ) =>
+    | undefined
+    | Module<C>
+    | Module<C>[]
+    | Promise<undefined | Module<C> | Module<C>[]>,
+): [
+  dispatch: (event: string) => Promise<boolean>,
+  shutdown: () => Promise<void>,
+] {
+  let started = false;
+  let terminated = false;
+  const process = new FsmProcess(config);
+  process.onStateCreate((state) => {
+    started = true;
+    state.onEnter(async () => {
+      const modules = (await load(state.key, process.event)) ?? [];
+      for (const module of Array.isArray(modules) ? modules : [modules]) {
+        const handler = await module(context);
+        if (typeof handler === "function") {
+          state.onExit(handler);
+        }
+      }
+    });
+  });
+  async function dispatch(event: string): Promise<boolean> {
+    return terminated ||
+      (event !== undefined &&
+        (!started || isStateTransitionEnabled(process, event)))
+      ? process.dispatch(event)
+      : false;
+  }
+  async function shutdown(): Promise<void> {
+    await process.shutdown();
+    terminated = true;
+  }
+  return [dispatch, shutdown] as const;
+}