@hardlydifficult/state-tracker 1.0.0 → 2.0.1

package/README.md

@@ -1,6 +1,6 @@
 # @hardlydifficult/state-tracker
 
-File-based state persistence for recovery across restarts.
+Atomic JSON state persistence with sync and async APIs, auto-save, and graceful degradation.
 
 ## Installation
 
@@ -8,30 +8,84 @@ File-based state persistence for recovery across restarts.
 npm install @hardlydifficult/state-tracker
 ```
 
-## Quick Start
+## Usage
+
+### Server context (async with auto-save)
+
+For long-running servers, use `loadAsync()` + `autoSaveMs` + `update()`. State degrades gracefully to in-memory if disk is unavailable.
 
 ```typescript
-import { StateTracker } from '@hardlydifficult/state-tracker';
+import { StateTracker } from "@hardlydifficult/state-tracker";
 
-const tracker = new StateTracker({ key: 'last-sync', default: 0 });
+interface AppState {
+  requestCount: number;
+  lastActiveAt: string;
+}
 
-// Load persisted value (or default on first run)
-const lastSync = tracker.load();
+const store = new StateTracker<AppState>({
+  key: "my-service",
+  default: { requestCount: 0, lastActiveAt: "" },
+  stateDirectory: "/var/data",
+  autoSaveMs: 5000,
+  onEvent: ({ level, message }) => console.log(`[${level}] ${message}`),
+});
 
-// Save updated value (atomic write)
-tracker.save(Date.now());
+await store.loadAsync();
+
+store.state.requestCount; // read current state
+store.update({ requestCount: store.state.requestCount + 1 }); // partial update
+store.set({ requestCount: 0, lastActiveAt: new Date().toISOString() }); // full replace
+await store.saveAsync(); // force immediate save
+```
+
+### Simple context (sync)
+
+For tools and scripts, use the sync `load()`/`save()` API.
+
+```typescript
+const store = new StateTracker<number>({
+  key: "counter",
+  default: 0,
+});
+
+const count = store.load();
+store.save(count + 1);
 ```
 
 ## Options
 
-| Option | Description |
+| Option | Type | Description |
+|--------|------|-------------|
+| `key` | `string` | Unique identifier for the state file (required) |
+| `default` | `T` | Default value when no state file exists (required) |
+| `stateDirectory` | `string` | Directory for state files (default: `$STATE_TRACKER_DIR` or `~/.app-state`) |
+| `autoSaveMs` | `number` | Auto-save interval after `update()`/`set()`/`reset()` (default: 0 = disabled) |
+| `onEvent` | `function` | Event callback for logging (`{ level, message, context }`) |
+
+## Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `state` | `Readonly<T>` | Current in-memory state |
+| `isPersistent` | `boolean` | Whether disk storage is available |
+
+## Methods
+
+| Method | Description |
 |--------|-------------|
-| `key` | Unique identifier for the state file (alphanumeric, hyphens, underscores) |
-| `default` | Default value returned when no state exists (also sets the type) |
-| `stateDirectory?` | Custom directory for state files (default: `~/.app-state` or `STATE_TRACKER_DIR` env) |
+| `loadAsync()` | Async load with graceful degradation (safe to call multiple times) |
+| `saveAsync()` | Async atomic save (temp file + rename) |
+| `load()` | Sync load |
+| `save(value)` | Sync save |
+| `update(changes)` | Shallow merge for object state, triggers auto-save |
+| `set(newState)` | Replace entire state, triggers auto-save |
+| `reset()` | Restore to defaults, triggers auto-save |
 
 ## Features
 
 - **Type inference** from the default value
 - **Atomic writes** via temp file + rename to prevent corruption
 - **Key sanitization** to prevent path traversal
+- **Graceful degradation** — runs in-memory when disk is unavailable
+- **Auto-save** — debounced saves after state mutations
+- **Legacy format support** — reads both v1 envelope and raw formats

package/dist/StateTracker.d.ts

@@ -1,16 +1,66 @@
+export type StateTrackerEventLevel = "debug" | "info" | "warn" | "error";
+export interface StateTrackerEvent {
+    level: StateTrackerEventLevel;
+    message: string;
+    context?: Record<string, unknown>;
+}
 export interface StateTrackerOptions<T> {
     key: string;
     default: T;
     stateDirectory?: string;
+    autoSaveMs?: number;
+    onEvent?: (event: StateTrackerEvent) => void;
 }
+/** Atomic JSON state persistence with file-based storage, auto-save, and graceful degradation to in-memory mode. */
 export declare class StateTracker<T> {
     private readonly filePath;
     private readonly defaultValue;
+    private readonly autoSaveMs;
+    private readonly onEvent?;
+    private _state;
+    private _loaded;
+    private _storageAvailable;
+    private saveTimer;
     private static sanitizeKey;
     private static getDefaultStateDirectory;
     constructor(options: StateTrackerOptions<T>);
+    /** Read-only getter for cached in-memory state */
+    get state(): Readonly<T>;
+    /** Whether storage is working */
+    get isPersistent(): boolean;
+    private emit;
+    /**
+     * Extract value from parsed JSON content.
+     * Handles v1 envelope format ({value, lastUpdated}) and legacy
+     * PersistentStore format (raw T without envelope, merged with defaults).
+     */
+    private extractValue;
+    /** Sync load — v1 compatible. Also updates internal state cache. */
     load(): T;
+    /** Sync save — v1 compatible. Also updates internal state cache. */
     save(value: T): void;
+    /**
+     * Async load with graceful degradation.
+     * Sets _storageAvailable false on failure instead of throwing.
+     * Safe to call multiple times (subsequent calls are no-ops).
+     */
+    loadAsync(): Promise<void>;
+    /**
+     * Async atomic save (temp file + rename).
+     * Cancels any pending auto-save before writing.
+     */
+    saveAsync(): Promise<void>;
+    /** Replace entire state, schedules auto-save. */
+    set(newState: T): void;
+    /**
+     * Shallow merge for object types, schedules auto-save.
+     * Throws at runtime if T is not an object.
+     */
+    update(changes: Partial<T>): void;
+    /** Restore to defaults, schedules auto-save. */
+    reset(): void;
     getFilePath(): string;
+    private scheduleSave;
+    private cancelPendingSave;
 }
 //# sourceMappingURL=StateTracker.d.ts.map

package/dist/StateTracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StateTracker.d.ts","sourceRoot":"","sources":["../src/StateTracker.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,CAAC,CAAC;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAI;IAEjC,OAAO,CAAC,MAAM,CAAC,WAAW;IAa1B,OAAO,CAAC,MAAM,CAAC,wBAAwB;gBAQ3B,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAY3C,IAAI,IAAI,CAAC;IAiBT,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAUpB,WAAW,IAAI,MAAM;CAGtB"}
+{"version":3,"file":"StateTracker.d.ts","sourceRoot":"","sources":["../src/StateTracker.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,CAAC,CAAC;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC9C;AAED,oHAAoH;AACpH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAI;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAqC;IAE9D,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,SAAS,CAA8C;IAE/D,OAAO,CAAC,MAAM,CAAC,WAAW;IAa1B,OAAO,CAAC,MAAM,CAAC,wBAAwB;gBAQ3B,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAe3C,kDAAkD;IAClD,IAAI,KAAK,IAAI,QAAQ,CAAC,CAAC,CAAC,CAEvB;IAED,iCAAiC;IACjC,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,OAAO,CAAC,IAAI;IAUZ;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAkCpB,oEAAoE;IACpE,IAAI,IAAI,CAAC;IA6BT,oEAAoE;IACpE,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAYpB;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAoChC;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BhC,iDAAiD;IACjD,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI;IAKtB;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAcjC,gDAAgD;IAChD,KAAK,IAAI,IAAI;IAKb,WAAW,IAAI,MAAM;IAIrB,OAAO,CAAC,YAAY;IA8BpB,OAAO,CAAC,iBAAiB;CAM1B"}

package/dist/StateTracker.js

@@ -35,11 +35,19 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StateTracker = void 0;
 const fs = __importStar(require("fs"));
+const fsPromises = __importStar(require("fs/promises"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
+/** Atomic JSON state persistence with file-based storage, auto-save, and graceful degradation to in-memory mode. */
 class StateTracker {
     filePath;
     defaultValue;
+    autoSaveMs;
+    onEvent;
+    _state;
+    _loaded = false;
+    _storageAvailable = false;
+    saveTimer = null;
     static sanitizeKey(key) {
         const trimmed = key.trim();
         if (trimmed === "") {
@@ -59,31 +67,95 @@ class StateTracker {
     }
     constructor(options) {
         const sanitizedKey = StateTracker.sanitizeKey(options.key);
-        this.defaultValue = options.default;
+        this.defaultValue = structuredClone(options.default);
+        this._state = structuredClone(options.default);
+        this.autoSaveMs = options.autoSaveMs ?? 0;
+        this.onEvent = options.onEvent;
         const stateDirectory = options.stateDirectory ?? StateTracker.getDefaultStateDirectory();
         if (!fs.existsSync(stateDirectory)) {
             fs.mkdirSync(stateDirectory, { recursive: true });
         }
         this.filePath = path.join(stateDirectory, `${sanitizedKey}.json`);
     }
+    /** Read-only getter for cached in-memory state */
+    get state() {
+        return this._state;
+    }
+    /** Whether storage is working */
+    get isPersistent() {
+        return this._storageAvailable;
+    }
+    emit(level, message, context) {
+        if (this.onEvent) {
+            this.onEvent({ level, message, context });
+        }
+    }
+    /**
+     * Extract value from parsed JSON content.
+     * Handles v1 envelope format ({value, lastUpdated}) and legacy
+     * PersistentStore format (raw T without envelope, merged with defaults).
+     */
+    extractValue(parsed) {
+        if (parsed !== null &&
+            typeof parsed === "object" &&
+            !Array.isArray(parsed) &&
+            "value" in parsed) {
+            // v1 envelope format: { value, lastUpdated }
+            const envelope = parsed;
+            if (envelope.value === undefined) {
+                return structuredClone(this.defaultValue);
+            }
+            return envelope.value;
+        }
+        // Legacy PersistentStore format: raw T without envelope
+        // Only merge if T is an object type
+        if (parsed !== null &&
+            typeof parsed === "object" &&
+            typeof this.defaultValue === "object" &&
+            this.defaultValue !== null &&
+            !Array.isArray(parsed)) {
+            return {
+                ...structuredClone(this.defaultValue),
+                ...parsed,
+            };
+        }
+        // Fallback to defaults
+        return structuredClone(this.defaultValue);
+    }
+    /** Sync load — v1 compatible. Also updates internal state cache. */
     load() {
         if (!fs.existsSync(this.filePath)) {
-            return this.defaultValue;
+            this._state = structuredClone(this.defaultValue);
+            this._loaded = true;
+            this._storageAvailable = true;
+            return this._state;
         }
         try {
             const data = fs.readFileSync(this.filePath, "utf-8");
             const state = JSON.parse(data);
             const { value } = state;
             if (value === undefined) {
+                this._state = structuredClone(this.defaultValue);
+                this._loaded = true;
+                this._storageAvailable = true;
                 return this.defaultValue;
             }
+            this._state = structuredClone(value);
+            this._loaded = true;
+            this._storageAvailable = true;
             return value;
         }
         catch {
+            this._state = structuredClone(this.defaultValue);
+            this._loaded = true;
+            this._storageAvailable = true;
             return this.defaultValue;
         }
     }
+    /** Sync save — v1 compatible. Also updates internal state cache. */
     save(value) {
+        this.cancelPendingSave();
+        this._state = structuredClone(value);
         const state = {
             value,
             lastUpdated: new Date().toISOString(),
@@ -92,9 +164,131 @@ class StateTracker {
         fs.writeFileSync(tempFilePath, JSON.stringify(state, null, 2), "utf-8");
         fs.renameSync(tempFilePath, this.filePath);
     }
+    /**
+     * Async load with graceful degradation.
+     * Sets _storageAvailable false on failure instead of throwing.
+     * Safe to call multiple times (subsequent calls are no-ops).
+     */
+    async loadAsync() {
+        if (this._loaded) {
+            return;
+        }
+        this._loaded = true;
+        try {
+            const dir = path.dirname(this.filePath);
+            if (!fs.existsSync(dir)) {
+                this.emit("info", "Creating storage directory", { dir });
+                await fsPromises.mkdir(dir, { recursive: true });
+            }
+            if (fs.existsSync(this.filePath)) {
+                const data = await fsPromises.readFile(this.filePath, "utf-8");
+                const parsed = JSON.parse(data);
+                this._state = this.extractValue(parsed);
+                this._storageAvailable = true;
+                this.emit("info", "Loaded state from disk", { path: this.filePath });
+            }
+            else {
+                this._storageAvailable = true;
+                this.emit("info", "No existing state file, using defaults", {
+                    path: this.filePath,
+                });
+            }
+        }
+        catch (err) {
+            this._storageAvailable = false;
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            this.emit("warn", "Storage unavailable, running in-memory", {
+                error: errorMessage,
+                path: this.filePath,
+            });
+        }
+    }
+    /**
+     * Async atomic save (temp file + rename).
+     * Cancels any pending auto-save before writing.
+     */
+    async saveAsync() {
+        this.cancelPendingSave();
+        if (!this._storageAvailable) {
+            return;
+        }
+        try {
+            const state = {
+                value: this._state,
+                lastUpdated: new Date().toISOString(),
+            };
+            const tempFilePath = `${this.filePath}.tmp`;
+            await fsPromises.writeFile(tempFilePath, JSON.stringify(state, null, 2), "utf-8");
+            await fsPromises.rename(tempFilePath, this.filePath);
+            this.emit("debug", "Saved state to disk", { path: this.filePath });
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            this.emit("error", "Failed to save state", {
+                error: errorMessage,
+            });
+        }
+    }
+    /** Replace entire state, schedules auto-save. */
+    set(newState) {
+        this._state = structuredClone(newState);
+        this.scheduleSave();
+    }
+    /**
+     * Shallow merge for object types, schedules auto-save.
+     * Throws at runtime if T is not an object.
+     */
+    update(changes) {
+        if (this._state === null ||
+            typeof this._state !== "object" ||
+            Array.isArray(this._state)) {
+            throw new Error("update() can only be used when state is a non-array object");
+        }
+        this._state = { ...this._state, ...changes };
+        this.scheduleSave();
+    }
+    /** Restore to defaults, schedules auto-save. */
+    reset() {
+        this._state = structuredClone(this.defaultValue);
+        this.scheduleSave();
+    }
     getFilePath() {
         return this.filePath;
     }
+    scheduleSave() {
+        if (this.autoSaveMs <= 0 || !this._storageAvailable) {
+            return;
+        }
+        this.cancelPendingSave();
+        this.saveTimer = setTimeout(() => {
+            this.saveTimer = null;
+            // Use sync save to avoid issues with untracked promises
+            try {
+                const state = {
+                    value: this._state,
+                    lastUpdated: new Date().toISOString(),
+                };
+                const tempFilePath = `${this.filePath}.tmp`;
+                fs.writeFileSync(tempFilePath, JSON.stringify(state, null, 2), "utf-8");
+                fs.renameSync(tempFilePath, this.filePath);
+                this.emit("debug", "Auto-saved state to disk", {
+                    path: this.filePath,
+                });
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                this.emit("error", "Failed to auto-save state", {
+                    error: errorMessage,
+                });
+            }
+        }, this.autoSaveMs);
+    }
+    cancelPendingSave() {
+        if (this.saveTimer) {
+            clearTimeout(this.saveTimer);
+            this.saveTimer = null;
+        }
+    }
 }
 exports.StateTracker = StateTracker;
 //# sourceMappingURL=StateTracker.js.map

package/dist/StateTracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"StateTracker.js","sourceRoot":"","sources":["../src/StateTracker.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAQ7B,MAAa,YAAY;IACN,QAAQ,CAAS;IACjB,YAAY,CAAI;IAEzB,MAAM,CAAC,WAAW,CAAC,GAAW;QACpC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,MAAM,CAAC,wBAAwB;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC7C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YAC1C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;IAC/C,CAAC;IAED,YAAY,OAA+B;QACzC,MAAM,YAAY,GAAG,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3D,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;QACpC,MAAM,cAAc,GAClB,OAAO,CAAC,cAAc,IAAI,YAAY,CAAC,wBAAwB,EAAE,CAAC;QAEpE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACnC,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,YAAY,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,IAAI;QACF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;YAC1D,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;YACxB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,IAAI,CAAC,YAAY,CAAC;YAC3B,CAAC;YACD,OAAO,KAAU,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAQ;QACX,MAAM,KAAK,GAA4B;YACrC,KAAK;YACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QACF,MAAM,YAAY,GAAG,GAAG,IAAI,CAAC,QAAQ,MAAM,CAAC;QAC5C,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACxE,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAnED,oCAmEC"}
+{"version":3,"file":"StateTracker.js","sourceRoot":"","sources":["../src/StateTracker.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { StateTracker, type StateTrackerOptions } from "./StateTracker";
+export { StateTracker, type StateTrackerOptions, type StateTrackerEvent, type StateTrackerEventLevel, } from "./StateTracker";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+CAAwE;AAA/D,4GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+CAKwB;AAJtB,4GAAA,YAAY,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/state-tracker",
-  "version": "1.0.0",
+  "version": "2.0.1",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [