@classytic/repo-core 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to `@classytic/repo-core` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.11.0] - 2026-07-15
+
+### Added — `./usage` subpath (period-bucketed counter contract)
+
+- **`UsageStore`** — driver-agnostic interface for atomic period-bucketed counters: `increment(bucket, amount)` + `summary(actor, period)`. The storage seam under platform accounting (quotas, plan enforcement, usage-based billing). One cell = `(actor, period, kind)`; one write = atomic upsert; one read = all counters for an actor-period pair. Kits ship adapters (`@classytic/mongokit/usage`, `@classytic/sqlitekit/usage`, …) without depending on arc; `@classytic/arc/usage` consumes this contract structurally.
+- **`UsageBucket`** — `{ actor, period, kind }` tuple. `kind` is dot-namespaced: `api.requests`, `ai.tokens.input`, `storage.egress.bytes`.
+- **`usagePeriod(date?)`** — canonical UTC calendar-month key (`"2026-07"`). Monthly is the billing-native granularity.
+- **`createMemoryUsageStore()`** — in-process reference implementation for tests and single-instance apps. Returns `UsageStore & { clear() }`. Multi-replica deployments need a shared adapter.
+
+### Added — `runUsageStoreContract` in `./testing`
+
+- **`runUsageStoreContract(harness)`** — cross-kit conformance suite. Kits import once and pass their adapter; all canonical scenarios run automatically. Same pattern as `runLockAdapterConformance`. `UsageConformanceHarness` is exported from `./testing` for harness typing.
+
 ## [0.10.0] - 2026-07-13
 
 ### Added — `ValidationErrorMeta.path` + `.meta` (field-scoped validation errors)

package/dist/testing/index.d.mts

@@ -2,4 +2,5 @@ import { AggregateOpsSupport } from "../repository/capabilities.mjs";
 import { ConformanceContext, ConformanceDoc, ConformanceFeatures, ConformanceHarness } from "./types.mjs";
 import { runStandardRepoConformance } from "./conformance.mjs";
 import { LockConformanceHarness, runLockAdapterConformance } from "./lock-conformance.mjs";
-export { type AggregateOpsSupport, type ConformanceContext, type ConformanceDoc, type ConformanceFeatures, type ConformanceHarness, type LockConformanceHarness, runLockAdapterConformance, runStandardRepoConformance };
+import { UsageConformanceHarness, runUsageStoreContract } from "./usage-conformance.mjs";
+export { type AggregateOpsSupport, type ConformanceContext, type ConformanceDoc, type ConformanceFeatures, type ConformanceHarness, type LockConformanceHarness, type UsageConformanceHarness, runLockAdapterConformance, runStandardRepoConformance, runUsageStoreContract };

package/dist/testing/index.mjs

@@ -1,3 +1,4 @@
 import { runStandardRepoConformance } from "./conformance.mjs";
 import { runLockAdapterConformance } from "./lock-conformance.mjs";
-export { runLockAdapterConformance, runStandardRepoConformance };
+import { runUsageStoreContract } from "./usage-conformance.mjs";
+export { runLockAdapterConformance, runStandardRepoConformance, runUsageStoreContract };

package/dist/testing/usage-conformance.d.mts

@@ -0,0 +1,18 @@
+import { UsageStore } from "../usage/index.mjs";
+//#region src/testing/usage-conformance.d.ts
+interface UsageConformanceHarness {
+  /**
+   * Construct the store under test. May be async (SQL migrations,
+   * index creation). The same instance is shared by every test —
+   * `beforeEach` clears residual counters.
+   */
+  createStore(): UsageStore | Promise<UsageStore>;
+  /**
+   * Wipe every counter between tests. Mongo: `deleteMany({})`.
+   * SQL: `DELETE FROM kit_usage`. Memory: `clear()`.
+   */
+  beforeEach?(store: UsageStore): void | Promise<void>;
+}
+declare function runUsageStoreContract(harness: UsageConformanceHarness): void;
+//#endregion
+export { UsageConformanceHarness, runUsageStoreContract };

package/dist/testing/usage-conformance.mjs

@@ -0,0 +1,101 @@
+import { beforeEach, describe, expect, it } from "vitest";
+//#region src/testing/usage-conformance.ts
+/**
+* `runUsageStoreContract` — cross-kit usage-store contract suite.
+*
+* Wires a kit-specific harness to the canonical scenarios every
+* `UsageStore` implementation must pass — so "swap mongokit/usage for
+* sqlitekit/usage" is a provable claim and drift shows up here before
+* it ships. Written ONCE here; kits import it instead of hand-writing
+* conformance (same shape as `runLockAdapterConformance`).
+*
+* ## Usage from a kit
+*
+*     import { runUsageStoreContract } from '@classytic/repo-core/testing';
+*     import { createMongoUsageStore } from '../../src/usage/index.js';
+*
+*     describe('mongokit/usage conformance', () => {
+*       runUsageStoreContract({
+*         createStore: () => createMongoUsageStore({ connection }),
+*         async beforeEach() { await clearCounters(); },
+*       });
+*     });
+*/
+function runUsageStoreContract(harness) {
+	describe("UsageStore contract", () => {
+		let store;
+		beforeEach(async () => {
+			store = await harness.createStore();
+			await harness.beforeEach?.(store);
+		});
+		it("accumulates increments per (actor, period, kind)", async () => {
+			const bucket = {
+				actor: "org-1",
+				period: "2026-07",
+				kind: "api.requests"
+			};
+			await store.increment(bucket, 1);
+			await store.increment(bucket, 2);
+			await store.increment({
+				...bucket,
+				kind: "ai.tokens.input"
+			}, 500);
+			expect(await store.summary("org-1", "2026-07")).toEqual({
+				"api.requests": 3,
+				"ai.tokens.input": 500
+			});
+		});
+		it("treats a missing bucket as 0 (first increment creates it)", async () => {
+			await store.increment({
+				actor: "a",
+				period: "2026-07",
+				kind: "k"
+			}, 7);
+			expect(await store.summary("a", "2026-07")).toEqual({ k: 7 });
+		});
+		it("isolates actors and periods", async () => {
+			await store.increment({
+				actor: "org-1",
+				period: "2026-06",
+				kind: "k"
+			}, 5);
+			await store.increment({
+				actor: "org-1",
+				period: "2026-07",
+				kind: "k"
+			}, 7);
+			await store.increment({
+				actor: "org-2",
+				period: "2026-07",
+				kind: "k"
+			}, 11);
+			expect(await store.summary("org-1", "2026-06")).toEqual({ k: 5 });
+			expect(await store.summary("org-1", "2026-07")).toEqual({ k: 7 });
+			expect(await store.summary("org-2", "2026-07")).toEqual({ k: 11 });
+		});
+		it("dotted kind names round-trip exactly (no path nesting)", async () => {
+			await store.increment({
+				actor: "a",
+				period: "2026-07",
+				kind: "storage.egress.bytes"
+			}, 42);
+			const summary = await store.summary("a", "2026-07");
+			expect(summary["storage.egress.bytes"]).toBe(42);
+			expect(Object.keys(summary)).toEqual(["storage.egress.bytes"]);
+		});
+		it("returns {} for unknown actors/periods (never throws)", async () => {
+			expect(await store.summary("nobody", "2099-01")).toEqual({});
+		});
+		it("increment is atomic per bucket under concurrency", async () => {
+			const bucket = {
+				actor: "org-c",
+				period: "2026-07",
+				kind: "api.requests"
+			};
+			await Promise.all(Array.from({ length: 50 }, () => store.increment(bucket, 1)));
+			expect((await store.summary("org-c", "2026-07"))["api.requests"]).toBe(50);
+		});
+	});
+}
+//#endregion
+export { runUsageStoreContract };

package/dist/usage/index.d.mts

@@ -0,0 +1,77 @@
+//#region src/usage/index.d.ts
+/**
+ * Usage-counter contract for the @classytic ecosystem.
+ *
+ * Period-bucketed counters per actor — the storage seam under
+ * platform accounting (quotas, plan enforcement, usage-based
+ * billing). One cell = `(actor, period, kind)`; one write op =
+ * atomic increment; one read op = all counters for an actor-period.
+ *
+ * ## Why this lives in repo-core
+ *
+ * Same reasoning as `./lock`: the contract is driver-free — any
+ * store with an atomic increment-upsert implements it (Mongo `$inc`
+ * upsert, SQL `ON CONFLICT ... DO UPDATE SET n = n + ?`, Redis
+ * `HINCRBY`). Kits ship their adapters (`@classytic/mongokit/usage`,
+ * `@classytic/sqlitekit/usage`, ...) WITHOUT depending on arc;
+ * `@classytic/arc/usage`'s `usagePlugin` consumes the contract
+ * structurally (its local `UsageStore` mirrors this shape the same
+ * way its `ScheduleLockLike` mirrors `LockAdapter`) so arc's
+ * repo-core peer floor never bumps for it.
+ *
+ * Distinct from itemized event/usage RECORD stores (e.g.
+ * `@classytic/arc-ai/usage`'s per-run records): this contract holds
+ * AGGREGATES only. Itemized layers sink into it; they don't replace it.
+ *
+ * ## Semantics
+ *
+ * - `increment` MUST be atomic per bucket (concurrent writers never
+ *   lose counts) and MUST treat a missing bucket as `0`.
+ * - `summary` returns `{}` (never throws) for unknown actors/periods.
+ * - `period` keys are opaque strings to the store; `usagePeriod()`
+ *   is the ecosystem's canonical key (UTC calendar month, `2026-07`).
+ *   Stores wanting finer windows shard internally without changing
+ *   the contract.
+ * - Sync-or-async: memory adapter is sync; DB adapters async;
+ *   consumers `await` either way.
+ *
+ * ## Why one file, not a barrel
+ *
+ * Contract + reference memory adapter + the period helper are under
+ * 100 LOC with no internal seams — same single-file rule as `./lock`.
+ */
+/** One counter cell: (actor, period, kind). */
+interface UsageBucket {
+  /** Who consumed — org / user / client id, or a host-chosen fallback key. */
+  actor: string;
+  /** Aggregation period key — canonically `usagePeriod()`'s `YYYY-MM`. */
+  period: string;
+  /** Namespaced counter, dot-separated: `api.requests`, `ai.tokens.input`, `storage.egress.bytes`. */
+  kind: string;
+}
+/** Period-bucketed usage counters. See module header for semantics. */
+interface UsageStore {
+  /** Store name for diagnostics (e.g. 'memory', 'mongo', 'redis'). */
+  readonly name: string;
+  /** Atomically add `amount` to the bucket's counter, creating it at 0. */
+  increment(bucket: UsageBucket, amount: number): Promise<void> | void;
+  /** Every counter for an actor in a period: `{ 'api.requests': 40231, ... }`. */
+  summary(actor: string, period: string): Promise<Record<string, number>>;
+  /** Optional cleanup hook (connections, timers). */
+  close?(): Promise<void>;
+}
+/**
+ * Canonical period key for a date — calendar month, UTC: `2026-07`.
+ * Monthly is the billing-native granularity.
+ */
+declare function usagePeriod(date?: Date): string;
+/**
+ * In-memory reference implementation — tests and single-instance
+ * apps. Counters are per-process; multi-replica deployments need a
+ * shared adapter (kit- or Redis-backed).
+ */
+declare function createMemoryUsageStore(): UsageStore & {
+  clear(): void;
+};
+//#endregion
+export { UsageBucket, UsageStore, createMemoryUsageStore, usagePeriod };

package/dist/usage/index.mjs

@@ -0,0 +1,36 @@
+//#region src/usage/index.ts
+/**
+* Canonical period key for a date — calendar month, UTC: `2026-07`.
+* Monthly is the billing-native granularity.
+*/
+function usagePeriod(date = /* @__PURE__ */ new Date()) {
+	return `${date.getUTCFullYear()}-${String(date.getUTCMonth() + 1).padStart(2, "0")}`;
+}
+/**
+* In-memory reference implementation — tests and single-instance
+* apps. Counters are per-process; multi-replica deployments need a
+* shared adapter (kit- or Redis-backed).
+*/
+function createMemoryUsageStore() {
+	/** actor → period → kind → count */
+	const counters = /* @__PURE__ */ new Map();
+	return {
+		name: "memory",
+		increment(bucket, amount) {
+			const periods = counters.get(bucket.actor) ?? /* @__PURE__ */ new Map();
+			const kinds = periods.get(bucket.period) ?? /* @__PURE__ */ new Map();
+			kinds.set(bucket.kind, (kinds.get(bucket.kind) ?? 0) + amount);
+			periods.set(bucket.period, kinds);
+			counters.set(bucket.actor, periods);
+		},
+		async summary(actor, period) {
+			const kinds = counters.get(actor)?.get(period);
+			return kinds ? Object.fromEntries(kinds) : {};
+		},
+		clear() {
+			counters.clear();
+		}
+	};
+}
+//#endregion
+export { createMemoryUsageStore, usagePeriod };

package/package.json

@@ -1,172 +1,176 @@
-{
-  "name": "@classytic/repo-core",
-  "version": "0.10.0",
-  "description": "Driver-agnostic repository primitives: hooks, Filter IR, operations, pagination, cache contract. Foundation for mongokit, sqlitekit, pgkit, and prismakit. Lean by design — no plugins ship here; each kit owns its own.",
-  "type": "module",
-  "sideEffects": false,
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
-  ],
-  "engines": {
-    "node": ">=22"
-  },
-  "exports": {
-    "./hooks": {
-      "types": "./dist/hooks/index.d.mts",
-      "default": "./dist/hooks/index.mjs"
-    },
-    "./operations": {
-      "types": "./dist/operations/index.d.mts",
-      "default": "./dist/operations/index.mjs"
-    },
-    "./errors": {
-      "types": "./dist/errors/index.d.mts",
-      "default": "./dist/errors/index.mjs"
-    },
-    "./pagination": {
-      "types": "./dist/pagination/index.d.mts",
-      "default": "./dist/pagination/index.mjs"
-    },
-    "./repository": {
-      "types": "./dist/repository/index.d.mts",
-      "default": "./dist/repository/index.mjs"
-    },
-    "./filter": {
-      "types": "./dist/filter/index.d.mts",
-      "default": "./dist/filter/index.mjs"
-    },
-    "./update": {
-      "types": "./dist/update/index.d.mts",
-      "default": "./dist/update/index.mjs"
-    },
-    "./query-parser": {
-      "types": "./dist/query-parser/index.d.mts",
-      "default": "./dist/query-parser/index.mjs"
-    },
-    "./context": {
-      "types": "./dist/context/index.d.mts",
-      "default": "./dist/context/index.mjs"
-    },
-    "./cache": {
-      "types": "./dist/cache/index.d.mts",
-      "default": "./dist/cache/index.mjs"
-    },
-    "./events": {
-      "types": "./dist/events/index.d.mts",
-      "default": "./dist/events/index.mjs"
-    },
-    "./schema": {
-      "types": "./dist/schema/index.d.mts",
-      "default": "./dist/schema/index.mjs"
-    },
-    "./testing": {
-      "types": "./dist/testing/index.d.mts",
-      "default": "./dist/testing/index.mjs"
-    },
-    "./tenant": {
-      "types": "./dist/tenant/index.d.mts",
-      "default": "./dist/tenant/index.mjs"
-    },
-    "./lookup": {
-      "types": "./dist/lookup/index.d.mts",
-      "default": "./dist/lookup/index.mjs"
-    },
-    "./adapter": {
-      "types": "./dist/adapter/index.d.mts",
-      "default": "./dist/adapter/index.mjs"
-    },
-    "./better-auth": {
-      "types": "./dist/better-auth/index.d.mts",
-      "default": "./dist/better-auth/index.mjs"
-    },
-    "./aggregate": {
-      "types": "./dist/aggregate/index.d.mts",
-      "default": "./dist/aggregate/index.mjs"
-    },
-    "./plugins": {
-      "types": "./dist/plugins/index.d.mts",
-      "default": "./dist/plugins/index.mjs"
-    },
-    "./lock": {
-      "types": "./dist/lock/index.d.mts",
-      "default": "./dist/lock/index.mjs"
-    },
-    "./package.json": "./package.json",
-    "./sync": {
-      "types": "./dist/sync/index.d.mts",
-      "default": "./dist/sync/index.mjs"
-    }
-  },
-  "keywords": [
-    "repository",
-    "repository-pattern",
-    "data-access",
-    "hooks",
-    "filter-ir",
-    "pagination",
-    "cursor-pagination",
-    "keyset-pagination",
-    "plugin-based",
-    "driver-agnostic",
-    "typescript",
-    "esm"
-  ],
-  "author": "Classytic <classytic.dev@gmail.com> (https://github.com/classytic)",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/classytic/repo-core.git"
-  },
-  "bugs": {
-    "url": "https://github.com/classytic/repo-core/issues"
-  },
-  "homepage": "https://github.com/classytic/repo-core#readme",
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "test": "vitest run --project unit --project integration",
-    "test:unit": "vitest run --project unit",
-    "test:integration": "vitest run --project integration",
-    "test:e2e": "vitest run --project e2e",
-    "test:all": "vitest run",
-    "test:watch": "vitest --project unit --project integration",
-    "bench": "vitest bench --run --project bench",
-    "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
-    "lint": "biome check src tests",
-    "lint:fix": "biome check src tests --write",
-    "format": "biome format src tests --write",
-    "check": "biome ci src tests --diagnostic-level=error",
-    "knip": "knip",
-    "push": "classytic-push",
-    "prepublishOnly": "npm run check && npm run build && npm run typecheck && npm test",
-    "release:tag": "node -e \"require('child_process').execSync('npm run push -- v'+require('./package.json').version,{stdio:'inherit'})\"",
-    "release": "npm run push -- main && npm run release:tag && npm publish",
-    "publish:dry": "npm publish --dry-run --access public",
-    "publish:npm": "npm publish --access public"
-  },
-  "devDependencies": {
-    "@arethetypeswrong/cli": "^0.18.2",
-    "@biomejs/biome": "^2.4.12",
-    "@classytic/dev-tools": "^0.2.0",
-    "@types/node": "^22.0.0",
-    "@vitest/coverage-v8": "^4.1.4",
-    "fast-check": "^4.7.0",
-    "knip": "^6.3.0",
-    "publint": "^0.3.18",
-    "tsdown": "^0.22.5",
-    "typescript": "^7.0.2",
-    "vitest": "^4.1.4"
-  },
-  "peerDependencies": {
-    "vitest": "^3.0.0 || ^4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "vitest": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "@classytic/repo-core",
+  "version": "0.11.0",
+  "description": "Driver-agnostic repository primitives: hooks, Filter IR, operations, pagination, cache contract. Foundation for mongokit, sqlitekit, pgkit, and prismakit. Lean by design \u00e2\u20ac\u201d no plugins ship here; each kit owns its own.",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    "./hooks": {
+      "types": "./dist/hooks/index.d.mts",
+      "default": "./dist/hooks/index.mjs"
+    },
+    "./operations": {
+      "types": "./dist/operations/index.d.mts",
+      "default": "./dist/operations/index.mjs"
+    },
+    "./errors": {
+      "types": "./dist/errors/index.d.mts",
+      "default": "./dist/errors/index.mjs"
+    },
+    "./pagination": {
+      "types": "./dist/pagination/index.d.mts",
+      "default": "./dist/pagination/index.mjs"
+    },
+    "./repository": {
+      "types": "./dist/repository/index.d.mts",
+      "default": "./dist/repository/index.mjs"
+    },
+    "./filter": {
+      "types": "./dist/filter/index.d.mts",
+      "default": "./dist/filter/index.mjs"
+    },
+    "./update": {
+      "types": "./dist/update/index.d.mts",
+      "default": "./dist/update/index.mjs"
+    },
+    "./query-parser": {
+      "types": "./dist/query-parser/index.d.mts",
+      "default": "./dist/query-parser/index.mjs"
+    },
+    "./context": {
+      "types": "./dist/context/index.d.mts",
+      "default": "./dist/context/index.mjs"
+    },
+    "./cache": {
+      "types": "./dist/cache/index.d.mts",
+      "default": "./dist/cache/index.mjs"
+    },
+    "./events": {
+      "types": "./dist/events/index.d.mts",
+      "default": "./dist/events/index.mjs"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.mts",
+      "default": "./dist/schema/index.mjs"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.mts",
+      "default": "./dist/testing/index.mjs"
+    },
+    "./tenant": {
+      "types": "./dist/tenant/index.d.mts",
+      "default": "./dist/tenant/index.mjs"
+    },
+    "./lookup": {
+      "types": "./dist/lookup/index.d.mts",
+      "default": "./dist/lookup/index.mjs"
+    },
+    "./adapter": {
+      "types": "./dist/adapter/index.d.mts",
+      "default": "./dist/adapter/index.mjs"
+    },
+    "./better-auth": {
+      "types": "./dist/better-auth/index.d.mts",
+      "default": "./dist/better-auth/index.mjs"
+    },
+    "./aggregate": {
+      "types": "./dist/aggregate/index.d.mts",
+      "default": "./dist/aggregate/index.mjs"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/index.d.mts",
+      "default": "./dist/plugins/index.mjs"
+    },
+    "./lock": {
+      "types": "./dist/lock/index.d.mts",
+      "default": "./dist/lock/index.mjs"
+    },
+    "./usage": {
+      "types": "./dist/usage/index.d.mts",
+      "default": "./dist/usage/index.mjs"
+    },
+    "./package.json": "./package.json",
+    "./sync": {
+      "types": "./dist/sync/index.d.mts",
+      "default": "./dist/sync/index.mjs"
+    }
+  },
+  "keywords": [
+    "repository",
+    "repository-pattern",
+    "data-access",
+    "hooks",
+    "filter-ir",
+    "pagination",
+    "cursor-pagination",
+    "keyset-pagination",
+    "plugin-based",
+    "driver-agnostic",
+    "typescript",
+    "esm"
+  ],
+  "author": "Classytic <classytic.dev@gmail.com> (https://github.com/classytic)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/classytic/repo-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/classytic/repo-core/issues"
+  },
+  "homepage": "https://github.com/classytic/repo-core#readme",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run --project unit --project integration",
+    "test:unit": "vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "test:e2e": "vitest run --project e2e",
+    "test:all": "vitest run",
+    "test:watch": "vitest --project unit --project integration",
+    "bench": "vitest bench --run --project bench",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
+    "lint": "biome check src tests",
+    "lint:fix": "biome check src tests --write",
+    "format": "biome format src tests --write",
+    "check": "biome ci src tests --diagnostic-level=error",
+    "knip": "knip",
+    "push": "classytic-push",
+    "prepublishOnly": "npm run check && npm run build && npm run typecheck && npm test",
+    "release:tag": "node -e \"require('child_process').execSync('npm run push -- v'+require('./package.json').version,{stdio:'inherit'})\"",
+    "release": "npm run push -- main && npm run release:tag && npm publish",
+    "publish:dry": "npm publish --dry-run --access public",
+    "publish:npm": "npm publish --access public"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "@biomejs/biome": "^2.4.12",
+    "@classytic/dev-tools": "^0.2.0",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^4.1.4",
+    "fast-check": "^4.7.0",
+    "knip": "^6.3.0",
+    "publint": "^0.3.18",
+    "tsdown": "^0.22.5",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.4"
+  },
+  "peerDependencies": {
+    "vitest": "^3.0.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  }
+}