@statewalker/fsm 0.25.0 → 0.26.0

package/dist/index.d.ts

@@ -117,4 +117,9 @@ 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 };
+declare function newFsmProcess(config: FsmStateConfig, handler: (state: string, event: undefined | string) => void | Promise<void> | ((event: undefined | string) => void | Promise<void>) | Promise<(event: undefined | string) => void | Promise<void>>): [
+    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 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,31 @@ function getTransitionsFromDescriptor(descriptor, prevStateKey, index = {}) {
   }
   return result;
 }
+
+// src/newFsmProcess.ts
+function newFsmProcess(config, handler) {
+  let started = false;
+  let terminated = false;
+  const process = new FsmProcess(config);
+  process.onStateCreate((state) => {
+    started = true;
+    let cleanup;
+    state.onEnter(async () => {
+      cleanup = await handler(state.key, process.event);
+    });
+    state.onExit(async () => {
+      cleanup?.(process.event);
+    });
+  });
+  async function dispatch(event) {
+    return terminated || event !== void 0 ? process.dispatch(event) : false;
+  }
+  async function shutdown() {
+    await process.shutdown();
+    terminated = true;
+  }
+  return [dispatch, shutdown];
+}
 export {
   EVENT_ANY,
   EVENT_EMPTY,
@@ -430,6 +455,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.26.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,45 @@
+import { FsmProcess } from "./FsmProcess.js";
+import type { FsmStateConfig } from "./FsmStateConfig.js";
+import { isStateTransitionEnabled } from "./utils/transitions.js";
+
+export function newFsmProcess(
+  config: FsmStateConfig,
+  handler: (
+    state: string,
+    event: undefined | string,
+  ) =>
+    | void
+    | Promise<void>
+    | ((event: undefined | string) => void | Promise<void>)
+    | Promise<(event: undefined | string) => void | Promise<void>>,
+): [
+  dispatch: (event: string) => Promise<boolean>,
+  shutdown: () => Promise<void>,
+] {
+  let started = false;
+  let terminated = false;
+  const process = new FsmProcess(config);
+  process.onStateCreate((state) => {
+    started = true;
+    let cleanup: Awaited<ReturnType<typeof handler>> | undefined;
+    state.onEnter(async () => {
+      cleanup = await handler(state.key, process.event);
+    });
+    state.onExit(async () => {
+      cleanup?.(process.event);
+    });
+  });
+  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;
+}