@rulvar/store-sqlite 1.35.0 → 1.37.0

package/dist/index.d.ts

@@ -6,7 +6,14 @@ declare const DEFAULT_LEASE_TTL_MS = 6e4;
 interface SqliteStoreOptions {
   /** Database file path, or ':memory:' for an in-process store. */
   path: string;
-  /** Lease ttl; default the Appendix A interim reference (60000 ms). */
+  /**
+  * Lease ttl; default the Appendix A interim reference (60000 ms). An
+  * integer between 1 and 2147483647 ms (workers renew on Node timers at
+  * ttl/3), refused as a ConfigError BEFORE the database opens: zero or
+  * a negative made every lease born expired (a second owner could take
+  * over immediately), NaN failed the first acquire with a raw sqlite
+  * NOT NULL error, and Infinity never expired (v1.35.0 review P2-4).
+  */
   ttlMs?: number;
   /** Injectable clock for lease-expiry tests. */
   now?: () => number;
@@ -26,6 +33,12 @@ declare class SqliteStore implements MetaLookupStore, LeasableStore {
   getMeta(runId: string): Promise<RunMeta | undefined>;
   listRuns(f?: RunFilter): Promise<RunMeta[]>;
   delete(runId: string): Promise<void>;
+  /**
+  * TTL introspection (the LeasableStore optional capability): lets
+  * createWorker verify at construction that its renew cadence matches
+  * this store's expiry instead of trusting two config sources to agree.
+  */
+  get leaseTtlMs(): number;
   acquire(runId: string, owner: string): Promise<Lease>;
   renew(l: Lease): Promise<void>;
   release(l: Lease): Promise<void>;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { DatabaseSync } from "node:sqlite";
-import { JournalOrderViolation, LeaseHeldError, metaMatchesFilter } from "@rulvar/core";
+import { ConfigError, JournalOrderViolation, LeaseHeldError, metaMatchesFilter } from "@rulvar/core";
 //#region src/store.ts
 /**
 * SqliteStore (M5-T02): JournalStore plus LeasableStore with fencing
@@ -29,8 +29,10 @@ var SqliteStore = class {
 	ttlMs;
 	now;
 	constructor(options) {
+		const ttlMs = options.ttlMs ?? 6e4;
+		if (!Number.isInteger(ttlMs) || ttlMs < 1 || ttlMs > 2147483647) throw new ConfigError(`SqliteStoreOptions.ttlMs must be an integer between 1 and 2147483647 ms (workers renew on Node timers at ttl/3); got ${String(ttlMs)}`);
 		this.db = new DatabaseSync(options.path);
-		this.ttlMs = options.ttlMs ?? 6e4;
+		this.ttlMs = ttlMs;
 		this.now = options.now ?? wallClock;
 		this.db.exec(`
       PRAGMA journal_mode = WAL;
@@ -124,6 +126,14 @@ var SqliteStore = class {
 			throw thrown;
 		}
 	}
+	/**
+	* TTL introspection (the LeasableStore optional capability): lets
+	* createWorker verify at construction that its renew cadence matches
+	* this store's expiry instead of trusting two config sources to agree.
+	*/
+	get leaseTtlMs() {
+		return this.ttlMs;
+	}
 	async acquire(runId, owner) {
 		this.db.exec("BEGIN IMMEDIATE");
 		try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/store-sqlite",
-  "version": "1.35.0",
+  "version": "1.37.0",
   "description": "Rulvar SQLite store implementing JournalStore and LeasableStore with a fencing epoch.",
   "type": "module",
   "license": "Apache-2.0",
@@ -22,13 +22,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@rulvar/core": "1.35.0"
+    "@rulvar/core": "1.37.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.0",
     "tsdown": "^0.22.3",
     "typescript": "~6.0.3",
-    "@rulvar/store-conformance": "1.35.0"
+    "@rulvar/store-conformance": "1.37.0"
   },
   "repository": {
     "type": "git",