@rulvar/store-sqlite 1.56.0 → 1.57.0

package/dist/index.d.ts

@@ -129,6 +129,24 @@ interface SqliteQuotaLimiterOptions {
   /** Injectable clock for window tests. */
   now?: () => number;
 }
+/**
+* The cross-process reference implementation of the core QuotaLimiter
+* SPI: engine processes pointing instances at ONE database file (this
+* store's file or its own) enforce one global provider quota.
+* Admission consumes the window counters inside a single
+* `BEGIN IMMEDIATE` transaction, so two processes can never both take
+* the last slot; reservations are rows, so `reconcile` settles a
+* grant from any process; both tables are lazily pruned to the
+* current and previous accounting window. The rule model, the fixed
+* epoch-aligned one-minute windows, and the admission decision are
+* the core's own exported functions, so this limiter and
+* `memoryQuotaLimiter` agree on every verdict. The `rules` MUST be
+* identical across coordinating processes (buckets key on rule
+* content). Runtime contention queues briefly on the connection's
+* busy_timeout (a hot limiter is EXPECTED to serialize); a call still
+* busy past the bound throws, and the engine's `onLimiterError`
+* policy decides what that means. Call `close()` when done.
+*/
 declare class SqliteQuotaLimiter implements QuotaLimiter {
   private readonly db;
   private readonly rules;

package/dist/index.js

@@ -416,6 +416,24 @@ function ruleKey(rule) {
 		tokensPerMinute: rule.tokensPerMinute ?? null
 	});
 }
+/**
+* The cross-process reference implementation of the core QuotaLimiter
+* SPI: engine processes pointing instances at ONE database file (this
+* store's file or its own) enforce one global provider quota.
+* Admission consumes the window counters inside a single
+* `BEGIN IMMEDIATE` transaction, so two processes can never both take
+* the last slot; reservations are rows, so `reconcile` settles a
+* grant from any process; both tables are lazily pruned to the
+* current and previous accounting window. The rule model, the fixed
+* epoch-aligned one-minute windows, and the admission decision are
+* the core's own exported functions, so this limiter and
+* `memoryQuotaLimiter` agree on every verdict. The `rules` MUST be
+* identical across coordinating processes (buckets key on rule
+* content). Runtime contention queues briefly on the connection's
+* busy_timeout (a hot limiter is EXPECTED to serialize); a call still
+* busy past the bound throws, and the engine's `onLimiterError`
+* policy decides what that means. Call `close()` when done.
+*/
 var SqliteQuotaLimiter = class {
 	db;
 	rules;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/store-sqlite",
-  "version": "1.56.0",
+  "version": "1.57.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.56.0"
+    "@rulvar/core": "1.57.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.0",
     "tsdown": "^0.22.3",
     "typescript": "~6.0.3",
-    "@rulvar/store-conformance": "1.56.0"
+    "@rulvar/store-conformance": "1.57.0"
   },
   "repository": {
     "type": "git",