@figliolia/galena 2.3.3 → 2.3.4

package/dist/cjs/Galena/Galena.js

@@ -208,10 +208,11 @@ class Galena extends Guards_1.Guards {
      * subscriptions
      */
     reIndexSubscriptions(name) {
+        var _a;
         for (const [ID, unitSubscriptions] of this.subscriptions) {
-            const [state, listenerID] = unitSubscriptions[0];
-            const subscriptions = this.state[state]["emitter"].get(state);
-            const listener = subscriptions === null || subscriptions === void 0 ? void 0 : subscriptions.get(listenerID);
+            const [stateName, listenerID] = unitSubscriptions[0];
+            const subscriptions = this.state[stateName]["emitter"].storage.get(stateName);
+            const listener = (_a = subscriptions === null || subscriptions === void 0 ? void 0 : subscriptions.storage) === null || _a === void 0 ? void 0 : _a.get(listenerID);
             if (listener) {
                 unitSubscriptions.push([name, this.state[name].subscribe(listener)]);
                 this.subscriptions.set(ID, unitSubscriptions);

package/dist/cjs/Galena/State.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.State = void 0;
-const types_1 = require("../Middleware/types");
 const event_emitter_1 = require("@figliolia/event-emitter");
+const types_1 = require("../Middleware/types");
 const Scheduler_1 = require("./Scheduler");
 const types_2 = require("./types");
 /**
@@ -199,7 +199,7 @@ class State extends Scheduler_1.Scheduler {
             this.lifeCycleEvent(types_1.MiddlewareEvents.onBeforeUpdate);
             const returnValue = func(...args);
             if (returnValue instanceof Promise) {
-                return returnValue.then((v) => {
+                return returnValue.then(v => {
                     this.scheduleUpdate(priority);
                     return v;
                 });
@@ -252,7 +252,7 @@ class State extends Scheduler_1.Scheduler {
      * Removes all open subscriptions to the `State` instance
      */
     clearAllSubscriptions() {
-        return this.emitter.clear();
+        return this.emitter.storage.clear();
     }
     /**
      * Life Cycle Event
@@ -276,19 +276,39 @@ class State extends Scheduler_1.Scheduler {
      * initial value
      */
     static clone(state) {
-        if (Array.isArray(state)) {
-            return [...state];
-        }
-        if (state instanceof Set) {
-            return new Set(state);
-        }
-        if (state instanceof Map) {
-            return new Map(state);
-        }
-        if (state && typeof state === "object") {
-            return Object.assign({}, state);
+        switch (typeof state) {
+            case "string":
+                return String(state);
+            case "bigint":
+                return BigInt(state);
+            case "boolean":
+                return Boolean(state);
+            case "number":
+                return Number(state);
+            case "symbol":
+            case "function":
+                return state;
+            case "undefined":
+                return undefined;
+            case "object":
+            default:
+                if (!state) {
+                    return null;
+                }
+                if (Array.isArray(state)) {
+                    return [...state];
+                }
+                if (state instanceof Set) {
+                    return new Set(state);
+                }
+                if (state instanceof Map) {
+                    return new Map(state);
+                }
+                if (state && typeof state === "object") {
+                    return Object.assign({}, state);
+                }
+                return state;
         }
-        return state;
     }
 }
 exports.State = State;

package/dist/cjs/Galena/types.js

@@ -6,4 +6,4 @@ var Priority;
     Priority[Priority["IMMEDIATE"] = 1] = "IMMEDIATE";
     Priority[Priority["MICROTASK"] = 2] = "MICROTASK";
     Priority[Priority["BATCHED"] = 3] = "BATCHED";
-})(Priority = exports.Priority || (exports.Priority = {}));
+})(Priority || (exports.Priority = Priority = {}));

package/dist/cjs/Middleware/Middleware.js

@@ -35,12 +35,12 @@ class Middleware {
      *
      * An event emitted each time a `State` mutation is enqueued
      */
-    onBeforeUpdate(state) { }
+    onBeforeUpdate(_state) { }
     /**
      * On Update
      *
      * An event emitted each time a `State` instance is mutated
      */
-    onUpdate(state) { }
+    onUpdate(_state) { }
 }
 exports.Middleware = Middleware;

package/dist/cjs/Middleware/types.js

@@ -5,4 +5,4 @@ var MiddlewareEvents;
 (function (MiddlewareEvents) {
     MiddlewareEvents["onUpdate"] = "onUpdate";
     MiddlewareEvents["onBeforeUpdate"] = "onBeforeUpdate";
-})(MiddlewareEvents = exports.MiddlewareEvents || (exports.MiddlewareEvents = {}));
+})(MiddlewareEvents || (exports.MiddlewareEvents = MiddlewareEvents = {}));

package/dist/mjs/Galena/Galena.js

@@ -206,9 +206,9 @@ export class Galena extends Guards {
      */
     reIndexSubscriptions(name) {
         for (const [ID, unitSubscriptions] of this.subscriptions) {
-            const [state, listenerID] = unitSubscriptions[0];
-            const subscriptions = this.state[state]["emitter"].get(state);
-            const listener = subscriptions?.get(listenerID);
+            const [stateName, listenerID] = unitSubscriptions[0];
+            const subscriptions = this.state[stateName]["emitter"].storage.get(stateName);
+            const listener = subscriptions?.storage?.get(listenerID);
             if (listener) {
                 unitSubscriptions.push([name, this.state[name].subscribe(listener)]);
                 this.subscriptions.set(ID, unitSubscriptions);

package/dist/mjs/Galena/State.js

@@ -1,5 +1,5 @@
-import { MiddlewareEvents } from "../Middleware/types.js";
 import { EventEmitter } from "@figliolia/event-emitter";
+import { MiddlewareEvents } from "../Middleware/types.js";
 import { Scheduler } from "./Scheduler.js";
 import { Priority } from "./types.js";
 /**
@@ -199,7 +199,7 @@ export class State extends Scheduler {
             this.lifeCycleEvent(MiddlewareEvents.onBeforeUpdate);
             const returnValue = func(...args);
             if (returnValue instanceof Promise) {
-                return returnValue.then((v) => {
+                return returnValue.then(v => {
                     this.scheduleUpdate(priority);
                     return v;
                 });
@@ -252,7 +252,7 @@ export class State extends Scheduler {
      * Removes all open subscriptions to the `State` instance
      */
     clearAllSubscriptions() {
-        return this.emitter.clear();
+        return this.emitter.storage.clear();
     }
     /**
      * Life Cycle Event
@@ -276,18 +276,38 @@ export class State extends Scheduler {
      * initial value
      */
     static clone(state) {
-        if (Array.isArray(state)) {
-            return [...state];
-        }
-        if (state instanceof Set) {
-            return new Set(state);
-        }
-        if (state instanceof Map) {
-            return new Map(state);
-        }
-        if (state && typeof state === "object") {
-            return { ...state };
+        switch (typeof state) {
+            case "string":
+                return String(state);
+            case "bigint":
+                return BigInt(state);
+            case "boolean":
+                return Boolean(state);
+            case "number":
+                return Number(state);
+            case "symbol":
+            case "function":
+                return state;
+            case "undefined":
+                return undefined;
+            case "object":
+            default:
+                if (!state) {
+                    return null;
+                }
+                if (Array.isArray(state)) {
+                    return [...state];
+                }
+                if (state instanceof Set) {
+                    return new Set(state);
+                }
+                if (state instanceof Map) {
+                    return new Map(state);
+                }
+                if (state && typeof state === "object") {
+                    return { ...state };
+                }
+                return state;
         }
-        return state;
     }
 }

package/dist/mjs/Middleware/Middleware.js

@@ -32,11 +32,11 @@ export class Middleware {
      *
      * An event emitted each time a `State` mutation is enqueued
      */
-    onBeforeUpdate(state) { }
+    onBeforeUpdate(_state) { }
     /**
      * On Update
      *
      * An event emitted each time a `State` instance is mutated
      */
-    onUpdate(state) { }
+    onUpdate(_state) { }
 }

package/dist/types/Galena/Galena.d.ts

@@ -1,5 +1,5 @@
-import type { Middleware } from "../Middleware/Middleware";
 import { State } from "./State";
+import type { Middleware } from "../Middleware/Middleware";
 import { Guards } from "./Guards";
 import type { Subscription } from "./types";
 /**

package/dist/types/Galena/types.d.ts

@@ -1,3 +1,4 @@
+import type { Callback } from "@figliolia/event-emitter";
 import type { State } from "./State";
 export type MutationEvent<T extends any> = {
     [key: State<T>["name"]]: T;
@@ -9,4 +10,4 @@ export declare enum Priority {
 }
 export type Task = () => void;
 export type SubscriptionTuple = [state: string, ID: string];
-export type Subscription<T> = (nextState: T) => void | Promise<void>;
+export type Subscription<T> = Callback<[nextState: T]>;

package/dist/types/Middleware/Middleware.d.ts

@@ -33,11 +33,11 @@ export declare class Middleware<T extends any = any> {
      *
      * An event emitted each time a `State` mutation is enqueued
      */
-    onBeforeUpdate(state: State<T>): void;
+    onBeforeUpdate(_state: State<T>): void;
     /**
      * On Update
      *
      * An event emitted each time a `State` instance is mutated
      */
-    onUpdate(state: State<T>): void;
+    onUpdate(_state: State<T>): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@figliolia/galena",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "description": "A performant state management library supporting mutable state, batched updates, middleware and a rich development API",
   "main": "dist/cjs/index.js",
   "module": "dist/mjs/index.js",
@@ -36,34 +36,36 @@
     "performance"
   ],
   "scripts": {
-    "test": "jest",
-    "coverage": "jest --env=jsdom --coverage --testResultsProcessor ./node_modules/jest-junit",
-    "build": "npx ts-packager -e src",
-    "lint": "tsc --noemit && eslint ./ --fix"
+    "build": "ts-packager -e src",
+    "lint": "tsx ci/commands/Lint.ts",
+    "test": "tsx ci/commands/Test.ts"
   },
   "dependencies": {
-    "@figliolia/event-emitter": "^1.1.4"
+    "@figliolia/event-emitter": "^1.1.5"
   },
   "peerDependencies": {
-    "@figliolia/event-emitter": "^1.1.4"
+    "@figliolia/event-emitter": "^1.1.5"
   },
   "devDependencies": {
-    "@figliolia/ts-packager": "^1.0.3",
-    "@types/node": "^16.7.13",
+    "@figliolia/child-process": "^1.0.1",
+    "@figliolia/ts-packager": "^1.1.0",
+    "@types/node": "^20.11.19",
     "@typescript-eslint/eslint-plugin": "^5.59.1",
     "@typescript-eslint/parser": "^5.59.1",
     "eslint": "^8.39.0",
     "eslint-config-airbnb": "^19.0.4",
     "eslint-config-airbnb-typescript": "^17.0.0",
     "eslint-config-prettier": "^8.8.0",
-    "eslint-import-resolver-typescript": "^3.5.5",
+    "eslint-import-resolver-typescript": "^3.6.1",
     "eslint-plugin-import": "^2.27.5",
-    "eslint-plugin-prettier": "^4.2.1",
+    "eslint-plugin-json-format": "^2.0.1",
+    "eslint-plugin-prettier": "^5.1.3",
     "eslint-plugin-simple-import-sort": "^10.0.0",
-    "prettier": "^2.8.8",
-    "ts-node": "^10.9.1",
-    "tsc-alias": "^1.8.6",
-    "typescript": "^4.4.2"
+    "eslint-plugin-unused-imports": "3",
+    "prettier": "^3.2.4",
+    "tsc-alias": "^1.8.8",
+    "tsx": "^4.7.1",
+    "typescript": "^5.3.3"
   },
   "publishConfig": {
     "access": "public"

package/src/Galena/Galena.ts

@@ -1,6 +1,6 @@
 import { AutoIncrementingID } from "@figliolia/event-emitter";
-import type { Middleware } from "Middleware/Middleware";
 import { State } from "Galena/State";
+import type { Middleware } from "Middleware/Middleware";
 import { Guards } from "./Guards";
 import type { Subscription, SubscriptionTuple } from "./types";
 
@@ -60,7 +60,7 @@ import type { Subscription, SubscriptionTuple } from "./types";
  * ```
  */
 export class Galena<
-  T extends Record<string, State<any>> = Record<string, State<any>>
+  T extends Record<string, State<any>> = Record<string, State<any>>,
 > extends Guards {
   public readonly state = {} as T;
   private readonly middleware: Middleware[] = [];
@@ -83,7 +83,7 @@ export class Galena<
   public composeState<S extends Record<string, any>, M extends typeof State<S>>(
     name: string,
     initialState: S,
-    Model?: M
+    Model?: M,
   ) {
     this.guardDuplicateStates(name, this.state);
     const StateModel = Model || State<S>;
@@ -129,7 +129,7 @@ export class Galena<
    */
   public update<K extends Extract<keyof T, string>>(
     name: K,
-    mutation: Parameters<T[K]["update"]>["0"]
+    mutation: Parameters<T[K]["update"]>["0"],
   ) {
     return this.get(name).update(mutation);
   }
@@ -142,7 +142,7 @@ export class Galena<
    */
   public backgroundUpdate<K extends Extract<keyof T, string>>(
     name: K,
-    mutation: Parameters<T[K]["backgroundUpdate"]>["0"]
+    mutation: Parameters<T[K]["backgroundUpdate"]>["0"],
   ) {
     return this.get(name).backgroundUpdate(mutation);
   }
@@ -155,7 +155,7 @@ export class Galena<
    */
   public priorityUpdate<K extends Extract<keyof T, string>>(
     name: K,
-    mutation: Parameters<T[K]["priorityUpdate"]>["0"]
+    mutation: Parameters<T[K]["priorityUpdate"]>["0"],
   ) {
     return this.get(name).priorityUpdate(mutation);
   }
@@ -172,7 +172,7 @@ export class Galena<
    */
   public subscribe<K extends Extract<keyof T, string>>(
     name: K,
-    callback: Parameters<T[K]["subscribe"]>["0"]
+    callback: Parameters<T[K]["subscribe"]>["0"],
   ) {
     return this.get(name).subscribe(callback);
   }
@@ -239,9 +239,10 @@ export class Galena<
    */
   private reIndexSubscriptions(name: string) {
     for (const [ID, unitSubscriptions] of this.subscriptions) {
-      const [state, listenerID] = unitSubscriptions[0];
-      const subscriptions = this.state[state]["emitter"].get(state);
-      const listener = subscriptions?.get(listenerID);
+      const [stateName, listenerID] = unitSubscriptions[0];
+      const subscriptions =
+        this.state[stateName]["emitter"].storage.get(stateName);
+      const listener = subscriptions?.storage?.get(listenerID);
       if (listener) {
         unitSubscriptions.push([name, this.state[name].subscribe(listener)]);
         this.subscriptions.set(ID, unitSubscriptions);

package/src/Galena/Guards.ts

@@ -20,11 +20,11 @@ export class Guards {
    */
   protected warnForUndefinedStates<T extends Record<string, State<any>>>(
     name: string,
-    state: T
+    state: T,
   ) {
     if (!(name in state)) {
       console.warn(
-        `A unit of state with the name "${name}" does not yet exist on this Galena instance. If this is expected, you can ignore this warning`
+        `A unit of state with the name "${name}" does not yet exist on this Galena instance. If this is expected, you can ignore this warning`,
       );
     }
   }
@@ -38,11 +38,11 @@ export class Guards {
    */
   protected guardDuplicateStates<T extends Record<string, State<any>>>(
     name: string,
-    state: T
+    state: T,
   ) {
     if (name in state) {
       console.warn(
-        `A unit of state with the name "${name}" already exists on this Galena instance. Please re-name this new unit of state to something unique`
+        `A unit of state with the name "${name}" already exists on this Galena instance. Please re-name this new unit of state to something unique`,
       );
     }
   }

package/src/Galena/State.ts

@@ -1,9 +1,9 @@
-import { MiddlewareEvents } from "Middleware/types";
-import type { Middleware } from "Middleware/Middleware";
 import { EventEmitter } from "@figliolia/event-emitter";
+import type { Middleware } from "Middleware/Middleware";
+import { MiddlewareEvents } from "Middleware/types";
 import { Scheduler } from "./Scheduler";
-import type { Subscription } from "./types";
-import { Priority, type MutationEvent } from "./types";
+import type { MutationEvent, Subscription } from "./types";
+import { Priority } from "./types";
 
 /**
  * ### State
@@ -109,7 +109,7 @@ export class State<T extends any = any> extends Scheduler {
     (func: (state: T, initialState: T) => void | Promise<void>) => {
       return func(this.state, this.initialState);
     },
-    Priority.BATCHED
+    Priority.BATCHED,
   );
 
   /**
@@ -139,7 +139,7 @@ export class State<T extends any = any> extends Scheduler {
     (func: (state: T, initialState: T) => void | Promise<void>) => {
       return func(this.state, this.initialState);
     },
-    Priority.MICROTASK
+    Priority.MICROTASK,
   );
 
   /**
@@ -171,7 +171,7 @@ export class State<T extends any = any> extends Scheduler {
     (func: (state: T, initialState: T) => void | Promise<void>) => {
       return func(this.state, this.initialState);
     },
-    Priority.IMMEDIATE
+    Priority.IMMEDIATE,
   );
 
   /**
@@ -214,13 +214,13 @@ export class State<T extends any = any> extends Scheduler {
    */
   protected mutation<F extends (...args: any[]) => any>(
     func: F,
-    priority: Priority = Priority.BATCHED
+    priority: Priority = Priority.BATCHED,
   ) {
     return (...args: Parameters<F>) => {
       this.lifeCycleEvent(MiddlewareEvents.onBeforeUpdate);
       const returnValue = func(...args);
       if (returnValue instanceof Promise) {
-        return returnValue.then((v) => {
+        return returnValue.then(v => {
           this.scheduleUpdate(priority);
           return v;
         });
@@ -240,7 +240,7 @@ export class State<T extends any = any> extends Scheduler {
     this.lifeCycleEvent(MiddlewareEvents.onUpdate);
     void this.scheduleTask(
       () => this.emitter.emit(this.name, this.state),
-      priority
+      priority,
     );
   }
 
@@ -281,7 +281,7 @@ export class State<T extends any = any> extends Scheduler {
    * Removes all open subscriptions to the `State` instance
    */
   public clearAllSubscriptions() {
-    return this.emitter.clear();
+    return this.emitter.storage.clear();
   }
 
   /**
@@ -307,18 +307,38 @@ export class State<T extends any = any> extends Scheduler {
    * initial value
    */
   public static clone<T>(state: T): T {
-    if (Array.isArray(state)) {
-      return [...state] as T;
-    }
-    if (state instanceof Set) {
-      return new Set(state) as T;
-    }
-    if (state instanceof Map) {
-      return new Map(state) as T;
-    }
-    if (state && typeof state === "object") {
-      return { ...state } as T;
+    switch (typeof state) {
+      case "string":
+        return String(state) as T;
+      case "bigint":
+        return BigInt(state) as T;
+      case "boolean":
+        return Boolean(state) as T;
+      case "number":
+        return Number(state) as T;
+      case "symbol":
+      case "function":
+        return state;
+      case "undefined":
+        return undefined as T;
+      case "object":
+      default:
+        if (!state) {
+          return null as T;
+        }
+        if (Array.isArray(state)) {
+          return [...state] as T;
+        }
+        if (state instanceof Set) {
+          return new Set(state) as T;
+        }
+        if (state instanceof Map) {
+          return new Map(state) as T;
+        }
+        if (state && typeof state === "object") {
+          return { ...state } as T;
+        }
+        return state;
     }
-    return state;
   }
 }

package/src/Galena/types.ts

@@ -1,3 +1,4 @@
+import type { Callback } from "@figliolia/event-emitter";
 import type { State } from "./State";
 
 export type MutationEvent<T extends any> = {
@@ -14,4 +15,4 @@ export type Task = () => void;
 
 export type SubscriptionTuple = [state: string, ID: string];
 
-export type Subscription<T> = (nextState: T) => void | Promise<void>;
+export type Subscription<T> = Callback<[nextState: T]>;

package/src/Middleware/Middleware.ts

@@ -34,12 +34,12 @@ export class Middleware<T extends any = any> {
    *
    * An event emitted each time a `State` mutation is enqueued
    */
-  public onBeforeUpdate(state: State<T>) {}
+  public onBeforeUpdate(_state: State<T>) {}
 
   /**
    * On Update
    *
    * An event emitted each time a `State` instance is mutated
    */
-  public onUpdate(state: State<T>) {}
+  public onUpdate(_state: State<T>) {}
 }

package/src/Middlewares/Logger.ts

@@ -28,17 +28,17 @@ export class Logger extends Middleware {
       "color: rgb(187, 186, 186); font-weight: bold",
       state.name,
       "@",
-      this.time
+      this.time,
     );
     console.log(
       "   %cPrevious State",
       "color: #26ad65; font-weight: bold",
-      this.previousState
+      this.previousState,
     );
     console.log(
       "   %cNext State    ",
       "color: rgb(17, 118, 249); font-weight: bold",
-      state.getState()
+      state.getState(),
     );
     this.previousState = null;
   }

package/src/Middlewares/Profiler.ts

@@ -32,7 +32,7 @@ export class Profiler extends Middleware {
       if (diff > this.threshold) {
         console.warn(
           `A slow state transition was detected on ${nextState.name}`,
-          nextState.getState()
+          nextState.getState(),
         );
         console.warn(`The last transition took ${diff}ms`);
       }