@hardlydifficult/usage-tracker 1.0.0

package/README.md

@@ -0,0 +1,84 @@
+# @hardlydifficult/usage-tracker
+
+Accumulate numeric metrics over time with automatic session vs. cumulative dual-tracking, backed by persistent storage.
+
+## Installation
+
+```bash
+npm install @hardlydifficult/usage-tracker @hardlydifficult/state-tracker
+```
+
+## Quick Start
+
+```typescript
+import { UsageTracker } from "@hardlydifficult/usage-tracker";
+
+// Type is inferred from defaults — no interface needed
+const tracker = await UsageTracker.create({
+  key: "my-usage",
+  default: {
+    api: { requests: 0, tokens: 0, costUsd: 0 },
+    audio: { requests: 0, durationSeconds: 0 },
+  },
+});
+
+// Record metrics — deeply adds to both session and cumulative
+tracker.record({ api: { requests: 1, tokens: 500, costUsd: 0.01 } });
+
+// Read state
+tracker.session;          // { api: { requests: 1, ... }, audio: { ... } }
+tracker.cumulative;       // all-time totals (persists across restarts)
+tracker.sessionStartedAt; // ISO string
+tracker.trackingSince;    // ISO string
+tracker.isPersistent;     // true if persisted to disk
+```
+
+## API Reference
+
+### `UsageTracker.create(options)`
+
+Static async factory — the only way to create an instance. Loads persisted state and starts a new session.
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `key` | `string` | Yes | Unique persistence key |
+| `default` | `T` | Yes | Default metrics shape (all leaves must be 0) |
+| `stateDirectory` | `string` | No | Directory for state files |
+| `autoSaveMs` | `number` | No | Auto-save interval in ms |
+| `onEvent` | `(event) => void` | No | Logging callback |
+
+### `tracker.record(values)`
+
+Deeply adds numeric values to both session and cumulative counters. Only provide the fields you are incrementing.
+
+```typescript
+// Only increments the specified fields
+tracker.record({ api: { requests: 1, tokens: 500 } });
+// audio fields are unchanged
+```
+
+### `tracker.save()`
+
+Force-save current state to disk immediately. Returns a promise.
+
+### Getters
+
+| Getter | Type | Description |
+|--------|------|-------------|
+| `session` | `Readonly<T>` | Current session metrics |
+| `cumulative` | `Readonly<T>` | All-time metrics |
+| `sessionStartedAt` | `string` | ISO timestamp of session start |
+| `trackingSince` | `string` | ISO timestamp of first tracking |
+| `isPersistent` | `boolean` | Whether data persists to disk |
+
+## `deepAdd(target, source)`
+
+Exported utility that recursively adds numeric values from source into target. Mutates target in place. Useful for merging metrics snapshots outside of UsageTracker.
+
+```typescript
+import { deepAdd } from "@hardlydifficult/usage-tracker";
+
+const totals = { requests: 5, tokens: 1000 };
+deepAdd(totals, { requests: 1, tokens: 500 });
+// totals is now { requests: 6, tokens: 1500 }
+```

package/dist/UsageTracker.d.ts

@@ -0,0 +1,33 @@
+import type { DeepPartial, NumericRecord, UsageTrackerOptions } from "./types.js";
+/**
+ * Accumulates numeric metrics over time with automatic session vs. cumulative
+ * dual-tracking, backed by persistent storage via StateTracker.
+ *
+ * Type is inferred from the `default` value — no explicit interface needed.
+ * Use the static `create()` factory to construct and load in one step.
+ */
+export declare class UsageTracker<T extends NumericRecord> {
+    private readonly tracker;
+    private readonly defaultMetrics;
+    private constructor();
+    /** Create a UsageTracker, load persisted state, and start a new session. */
+    static create<T extends NumericRecord>(options: UsageTrackerOptions<T>): Promise<UsageTracker<T>>;
+    /** Current session metrics (since last create() call). */
+    get session(): Readonly<T>;
+    /** All-time cumulative metrics. */
+    get cumulative(): Readonly<T>;
+    /** ISO string of when the current session started. */
+    get sessionStartedAt(): string;
+    /** ISO string of when cumulative tracking first started. */
+    get trackingSince(): string;
+    /** Whether state is being persisted to disk. */
+    get isPersistent(): boolean;
+    /**
+     * Record metrics by deeply adding numeric values to both session and cumulative.
+     * Only provide the fields you are incrementing — unspecified fields are unchanged.
+     */
+    record(values: DeepPartial<T>): void;
+    /** Force-save current state to disk immediately. */
+    save(): Promise<void>;
+}
+//# sourceMappingURL=UsageTracker.d.ts.map

package/dist/UsageTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageTracker.d.ts","sourceRoot":"","sources":["../src/UsageTracker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EAEb,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,aAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAI;IAEnC,OAAO;IAQP,4EAA4E;WAC/D,MAAM,CAAC,CAAC,SAAS,aAAa,EACzC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IA4B3B,0DAA0D;IAC1D,IAAI,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,CAEzB;IAED,mCAAmC;IACnC,IAAI,UAAU,IAAI,QAAQ,CAAC,CAAC,CAAC,CAE5B;IAED,sDAAsD;IACtD,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,4DAA4D;IAC5D,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,gDAAgD;IAChD,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAcpC,oDAAoD;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/UsageTracker.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageTracker = void 0;
+const state_tracker_1 = require("@hardlydifficult/state-tracker");
+const deepAdd_js_1 = require("./deepAdd.js");
+/**
+ * Accumulates numeric metrics over time with automatic session vs. cumulative
+ * dual-tracking, backed by persistent storage via StateTracker.
+ *
+ * Type is inferred from the `default` value — no explicit interface needed.
+ * Use the static `create()` factory to construct and load in one step.
+ */
+class UsageTracker {
+    tracker;
+    defaultMetrics;
+    constructor(options, tracker) {
+        this.defaultMetrics = structuredClone(options.default);
+        this.tracker = tracker;
+    }
+    /** Create a UsageTracker, load persisted state, and start a new session. */
+    static async create(options) {
+        const now = new Date().toISOString();
+        const tracker = new state_tracker_1.StateTracker({
+            key: options.key,
+            default: {
+                cumulative: structuredClone(options.default),
+                session: structuredClone(options.default),
+                trackingSince: now,
+                sessionStartedAt: now,
+            },
+            stateDirectory: options.stateDirectory,
+            autoSaveMs: options.autoSaveMs,
+            onEvent: options.onEvent,
+        });
+        await tracker.loadAsync();
+        const instance = new UsageTracker(options, tracker);
+        // Reset session counters for the new session, preserving cumulative
+        tracker.update({
+            session: structuredClone(options.default),
+            sessionStartedAt: new Date().toISOString(),
+        });
+        return instance;
+    }
+    /** Current session metrics (since last create() call). */
+    get session() {
+        return this.tracker.state.session;
+    }
+    /** All-time cumulative metrics. */
+    get cumulative() {
+        return this.tracker.state.cumulative;
+    }
+    /** ISO string of when the current session started. */
+    get sessionStartedAt() {
+        return this.tracker.state.sessionStartedAt;
+    }
+    /** ISO string of when cumulative tracking first started. */
+    get trackingSince() {
+        return this.tracker.state.trackingSince;
+    }
+    /** Whether state is being persisted to disk. */
+    get isPersistent() {
+        return this.tracker.isPersistent;
+    }
+    /**
+     * Record metrics by deeply adding numeric values to both session and cumulative.
+     * Only provide the fields you are incrementing — unspecified fields are unchanged.
+     */
+    record(values) {
+        const { state } = this.tracker;
+        const newSession = structuredClone(state.session);
+        const newCumulative = structuredClone(state.cumulative);
+        (0, deepAdd_js_1.deepAdd)(newSession, values);
+        (0, deepAdd_js_1.deepAdd)(newCumulative, values);
+        this.tracker.update({
+            session: newSession,
+            cumulative: newCumulative,
+        });
+    }
+    /** Force-save current state to disk immediately. */
+    async save() {
+        await this.tracker.saveAsync();
+    }
+}
+exports.UsageTracker = UsageTracker;
+//# sourceMappingURL=UsageTracker.js.map

package/dist/UsageTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageTracker.js","sourceRoot":"","sources":["../src/UsageTracker.ts"],"names":[],"mappings":";;;AAAA,kEAA8D;AAE9D,6CAAuC;AAQvC;;;;;;GAMG;AACH,MAAa,YAAY;IACN,OAAO,CAAuC;IAC9C,cAAc,CAAI;IAEnC,YACE,OAA+B,EAC/B,OAA6C;QAE7C,IAAI,CAAC,cAAc,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,OAA+B;QAE/B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,4BAAY,CAAyB;YACvD,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE;gBACP,UAAU,EAAE,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC5C,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC;gBACzC,aAAa,EAAE,GAAG;gBAClB,gBAAgB,EAAE,GAAG;aACtB;YACD,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;QAE1B,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEpD,oEAAoE;QACpE,OAAO,CAAC,MAAM,CAAC;YACb,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC;YACzC,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACR,CAAC,CAAC;QAEtC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0DAA0D;IAC1D,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;IACpC,CAAC;IAED,mCAAmC;IACnC,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;IACvC,CAAC;IAED,sDAAsD;IACtD,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAC7C,CAAC;IAED,4DAA4D;IAC5D,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;IAC1C,CAAC;IAED,gDAAgD;IAChD,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAsB;QAC3B,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC/B,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAExD,IAAA,oBAAO,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC5B,IAAA,oBAAO,EAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAE/B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YAClB,OAAO,EAAE,UAAU;YACnB,UAAU,EAAE,aAAa;SACS,CAAC,CAAC;IACxC,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;CACF;AA1FD,oCA0FC"}

package/dist/deepAdd.d.ts

@@ -0,0 +1,7 @@
+import type { DeepPartial, NumericRecord } from "./types.js";
+/**
+ * Recursively adds numeric values from source into target. Mutates target in place.
+ * Keys in source that are not present in target are ignored.
+ */
+export declare function deepAdd<T extends NumericRecord>(target: T, source: DeepPartial<T>): void;
+//# sourceMappingURL=deepAdd.d.ts.map

package/dist/deepAdd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepAdd.d.ts","sourceRoot":"","sources":["../src/deepAdd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,aAAa,EAC7C,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,IAAI,CA6BN"}

package/dist/deepAdd.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepAdd = deepAdd;
+/**
+ * Recursively adds numeric values from source into target. Mutates target in place.
+ * Keys in source that are not present in target are ignored.
+ */
+function deepAdd(target, source) {
+    const src = source;
+    const tgt = target;
+    for (const key in src) {
+        if (!Object.prototype.hasOwnProperty.call(src, key)) {
+            continue;
+        }
+        if (!(key in tgt)) {
+            continue;
+        }
+        const sourceValue = src[key];
+        const targetValue = tgt[key];
+        if (typeof sourceValue === "number" && typeof targetValue === "number") {
+            tgt[key] = targetValue + sourceValue;
+        }
+        else if (typeof sourceValue === "object" &&
+            sourceValue !== null &&
+            typeof targetValue === "object" &&
+            targetValue !== null) {
+            deepAdd(targetValue, sourceValue);
+        }
+    }
+}
+//# sourceMappingURL=deepAdd.js.map

package/dist/deepAdd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepAdd.js","sourceRoot":"","sources":["../src/deepAdd.ts"],"names":[],"mappings":";;AAMA,0BAgCC;AApCD;;;GAGG;AACH,SAAgB,OAAO,CACrB,MAAS,EACT,MAAsB;IAEtB,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,MAAM,GAAG,GAAG,MAAiC,CAAC;IAE9C,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACvE,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,GAAG,WAAW,CAAC;QACvC,CAAC;aAAM,IACL,OAAO,WAAW,KAAK,QAAQ;YAC/B,WAAW,KAAK,IAAI;YACpB,OAAO,WAAW,KAAK,QAAQ;YAC/B,WAAW,KAAK,IAAI,EACpB,CAAC;YACD,OAAO,CACL,WAA4B,EAC5B,WAAyC,CAC1C,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { UsageTracker } from "./UsageTracker.js";
+export { deepAdd } from "./deepAdd.js";
+export type { NumericRecord, DeepPartial, UsageTrackerOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,aAAa,EACb,WAAW,EACX,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepAdd = exports.UsageTracker = void 0;
+var UsageTracker_js_1 = require("./UsageTracker.js");
+Object.defineProperty(exports, "UsageTracker", { enumerable: true, get: function () { return UsageTracker_js_1.UsageTracker; } });
+var deepAdd_js_1 = require("./deepAdd.js");
+Object.defineProperty(exports, "deepAdd", { enumerable: true, get: function () { return deepAdd_js_1.deepAdd; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AACrB,2CAAuC;AAA9B,qGAAA,OAAO,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+import type { StateTrackerEvent } from "@hardlydifficult/state-tracker";
+/** Constrains T to a nested object where every leaf is a number. */
+export interface NumericRecord {
+    [key: string]: number | NumericRecord;
+}
+/** Recursive partial — only provide the fields you are incrementing. */
+export type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends number ? number : T[K] extends NumericRecord ? DeepPartial<T[K]> : never;
+};
+/** Internal persisted state wrapping consumer metrics T. */
+export interface PersistedUsageState<T extends NumericRecord> {
+    cumulative: T;
+    session: T;
+    trackingSince: string;
+    sessionStartedAt: string;
+}
+/** Configuration for UsageTracker.create(). */
+export interface UsageTrackerOptions<T extends NumericRecord> {
+    /** Unique persistence key (alphanumeric, hyphens, underscores). */
+    key: string;
+    /** Default metrics shape — all leaves must be 0. */
+    default: T;
+    /** Directory for state persistence. */
+    stateDirectory?: string;
+    /** Auto-save interval in ms (passed through to StateTracker). */
+    autoSaveMs?: number;
+    /** Event callback for logging (same shape as StateTracker). */
+    onEvent?: (event: StateTrackerEvent) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;CACvC;AAED,wEAAwE;AACxE,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAChC,MAAM,GACN,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,GACxB,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACjB,KAAK;CACZ,CAAC;AAEF,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,aAAa;IAC1D,UAAU,EAAE,CAAC,CAAC;IACd,OAAO,EAAE,CAAC,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,aAAa;IAC1D,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,OAAO,EAAE,CAAC,CAAC;IACX,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC9C"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@hardlydifficult/usage-tracker",
+  "version": "1.0.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@hardlydifficult/state-tracker": "file:../state-tracker"
+  },
+  "devDependencies": {
+    "@types/node": "20.19.31",
+    "typescript": "5.8.3",
+    "vitest": "1.6.1"
+  },
+  "peerDependencies": {
+    "@hardlydifficult/state-tracker": ">=2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}