@stateforward/hsm.ts 0.1.0 → 0.1.3

package/dist/index.d.cts

@@ -81,12 +81,18 @@ type Config = {
         clearTimeout?: CancelFunction;
         now?: () => number;
     };
+    queue?: QueueShape;
 };
 type ClockConfig = {
     setTimeout: TimerFunction;
     clearTimeout: CancelFunction;
     now: () => number;
 };
+type QueueShape = {
+    push: (event: EventRecord) => void | unknown;
+    pop: () => EventRecord | undefined | unknown;
+    len: () => number | unknown;
+};
 type StripLeadingSlash<S extends string> = S extends `/${infer Rest}` ? Rest : S;
 type StripTrailingSlash<S extends string> = S extends `${infer Rest}/` ? Rest : S;
 type PathParts<S extends string> = S extends '' ? [] : S extends `${infer Head}/${infer Tail}` ? [Head, ...PathParts<Tail>] : [S];
@@ -767,9 +773,11 @@ declare class Queue {
     front: EventRecord[];
     back: Array<EventRecord | undefined>;
     backHead: number;
-    len(): number;
-    pop(): EventRecord | undefined;
-    push(...events: EventRecord[]): void;
+    private fifo?;
+    constructor(fifo?: QueueShape);
+    len(): number | unknown;
+    pop(): EventRecord | undefined | unknown;
+    push(event: EventRecord): void | unknown;
 }
 type InstanceConstructor = {
     new (): Instance;
@@ -823,6 +831,9 @@ declare class HSM {
     private followHistoryDefault;
     dispatch(event: EventRecord): void;
     private process;
+    private push;
+    private pop;
+    private len;
     private transition;
     private enter;
     private exit;

package/dist/index.d.ts

@@ -81,12 +81,18 @@ type Config = {
         clearTimeout?: CancelFunction;
         now?: () => number;
     };
+    queue?: QueueShape;
 };
 type ClockConfig = {
     setTimeout: TimerFunction;
     clearTimeout: CancelFunction;
     now: () => number;
 };
+type QueueShape = {
+    push: (event: EventRecord) => void | unknown;
+    pop: () => EventRecord | undefined | unknown;
+    len: () => number | unknown;
+};
 type StripLeadingSlash<S extends string> = S extends `/${infer Rest}` ? Rest : S;
 type StripTrailingSlash<S extends string> = S extends `${infer Rest}/` ? Rest : S;
 type PathParts<S extends string> = S extends '' ? [] : S extends `${infer Head}/${infer Tail}` ? [Head, ...PathParts<Tail>] : [S];
@@ -767,9 +773,11 @@ declare class Queue {
     front: EventRecord[];
     back: Array<EventRecord | undefined>;
     backHead: number;
-    len(): number;
-    pop(): EventRecord | undefined;
-    push(...events: EventRecord[]): void;
+    private fifo?;
+    constructor(fifo?: QueueShape);
+    len(): number | unknown;
+    pop(): EventRecord | undefined | unknown;
+    push(event: EventRecord): void | unknown;
 }
 type InstanceConstructor = {
     new (): Instance;
@@ -823,6 +831,9 @@ declare class HSM {
     private followHistoryDefault;
     dispatch(event: EventRecord): void;
     private process;
+    private push;
+    private pop;
+    private len;
     private transition;
     private enter;
     private exit;

package/dist/index.js

@@ -344,13 +344,23 @@ var Queue = class {
   front = [];
   back = [];
   backHead = 0;
+  fifo;
+  constructor(fifo) {
+    this.fifo = fifo;
+  }
   len() {
+    if (this.fifo) {
+      const lenOrError = this.fifo.len();
+      return typeof lenOrError === "number" ? this.front.length + lenOrError : lenOrError;
+    }
     return this.front.length + (this.back.length - this.backHead);
   }
   pop() {
     var event2;
     if (this.front.length > 0) {
       event2 = this.front.pop();
+    } else if (this.fifo) {
+      event2 = this.fifo.pop();
     } else if (this.backHead < this.back.length) {
       event2 = this.back[this.backHead];
       this.back[this.backHead] = void 0;
@@ -362,17 +372,25 @@ var Queue = class {
     }
     return event2;
   }
-  push(...events) {
-    for (var i = 0; i < events.length; i++) {
-      var event2 = events[i];
-      if (isKind(event2.kind, kinds.CompletionEvent)) {
-        this.front.push(event2);
-      } else {
-        this.back.push(event2);
-      }
+  push(event2) {
+    if (isKind(event2.kind, kinds.CompletionEvent)) {
+      this.front.push(event2);
+    } else if (this.fifo) {
+      return this.fifo.push(event2);
+    } else {
+      this.back.push(event2);
     }
   }
 };
+function isQueueError(value) {
+  if (value === void 0 || value === null) {
+    return false;
+  }
+  if (typeof value !== "object") {
+    return true;
+  }
+  return !("name" in value) || !("kind" in value);
+}
 function buildTransitionTable(model) {
   for (var stateName in model.members) {
     var state2 = model.members[stateName];
@@ -548,7 +566,7 @@ var HSM = class _HSM {
     this.ctx = ctxOrInstance;
     this.model = maybeModelOrConfig;
     this.currentState = this.model;
-    this.queue = new Queue();
+    this.queue = new Queue(maybeConfig?.queue);
     this.active = {};
     this.processing = false;
     this.id = id2;
@@ -744,7 +762,7 @@ var HSM = class _HSM {
       qualifiedName: this.model.qualifiedName,
       state: currentStateName,
       attributes: Object.assign({}, this.attributes),
-      queueLen: this.queue.len(),
+      queueLen: this.len(),
       events
     };
   }
@@ -788,7 +806,7 @@ var HSM = class _HSM {
     if (!event2.kind) {
       event2.kind = kinds.Event;
     }
-    this.queue.push(event2);
+    this.push(event2);
     this.notify("dispatched", event2.name);
     if (this.processing) {
       return;
@@ -800,9 +818,9 @@ var HSM = class _HSM {
     this.process();
   }
   process() {
-    var deferred = new Array(this.queue.len() + 1);
+    var deferred = new Array(this.len() + 1);
     var deferredCount = 0;
-    var event2 = this.queue.pop();
+    var event2 = this.pop();
     while (event2) {
       var currentStateName = this.currentState.qualifiedName;
       var eventName = event2.name;
@@ -810,7 +828,7 @@ var HSM = class _HSM {
       var isDeferred = deferredLookup && deferredLookup[eventName] === true;
       if (isDeferred) {
         deferred[deferredCount++] = event2;
-        event2 = this.queue.pop();
+        event2 = this.pop();
         continue;
       }
       var transitions = this.model.transitionMap[currentStateName][eventName];
@@ -843,7 +861,7 @@ var HSM = class _HSM {
           if (nextState.qualifiedName !== this.currentState.qualifiedName) {
             this.currentState = nextState;
             for (var j = 0; j < deferredCount; j++) {
-              this.queue.push(deferred[j]);
+              this.push(deferred[j]);
             }
             deferredCount = 0;
           }
@@ -851,14 +869,39 @@ var HSM = class _HSM {
         }
       }
       this.notify("processed", event2.name);
-      event2 = this.queue.pop();
+      event2 = this.pop();
     }
     for (var i = 0; i < deferredCount; i++) {
-      this.queue.push(deferred[i]);
+      this.push(deferred[i]);
     }
     this.processing = false;
     this.notify("processed", "__next__");
   }
+  push(event2) {
+    const error = this.queue.push(event2);
+    if (error && !isKind(event2.kind, kinds.ErrorEvent)) {
+      this.queue.push(Object.create(ErrorEvent, { data: { value: error } }));
+    }
+  }
+  pop() {
+    while (true) {
+      const eventOrError = this.queue.pop();
+      if (!isQueueError(eventOrError)) {
+        return eventOrError;
+      }
+      this.queue.push(Object.create(ErrorEvent, { data: { value: eventOrError } }));
+    }
+  }
+  len() {
+    const lenOrError = this.queue.len();
+    if (typeof lenOrError === "number") {
+      return lenOrError;
+    }
+    if (lenOrError) {
+      this.queue.push(Object.create(ErrorEvent, { data: { value: lenOrError } }));
+    }
+    return 0;
+  }
   transition(current, transition2, event2) {
     var path = transition2.paths[current.qualifiedName];
     if (!path) {