@futdevpro/nts-dynamo 1.15.356 → 1.15.357

package/build/_modules/rate-limit/_models/rate-limit-mongo-collection.interface.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The minimal MongoDB collection surface `DyNTS_RateLimit_MongoStore` needs — structurally satisfied by a native
+ * driver `Collection` and by `mongoose.connection.collection(name)`, so the store has no hard driver dependency.
+ */
+export interface DyNTS_RateLimit_MongoCollection_Interface {
+    findOneAndUpdate(filter: object, update: object[], options: object): Promise<unknown>;
+    createIndex(spec: object, options: object): Promise<unknown>;
+}
+//# sourceMappingURL=rate-limit-mongo-collection.interface.d.ts.map

package/build/_modules/rate-limit/_models/rate-limit-mongo-collection.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-mongo-collection.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/rate-limit/_models/rate-limit-mongo-collection.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,yCAAyC;IACxD,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtF,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D"}

package/build/_modules/rate-limit/_models/rate-limit-mongo-collection.interface.js

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

package/build/_modules/rate-limit/_models/rate-limit-mongo-collection.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-mongo-collection.interface.js","sourceRoot":"","sources":["../../../../src/_modules/rate-limit/_models/rate-limit-mongo-collection.interface.ts"],"names":[],"mappings":""}

package/build/_modules/rate-limit/index.d.ts

@@ -1,5 +1,8 @@
 export { DyNTS_RateLimit_Middleware } from './rate-limit.middleware';
 export { DyNTS_RateLimit_InMemoryStore } from './rate-limit-in-memory.store';
+export { DyNTS_RateLimit_MongoStore } from './rate-limit-mongo.store';
+export { DyNTS_RateLimit_Request_Util } from './rate-limit-request.util';
+export { DyNTS_RateLimit_MongoCollection_Interface } from './_models/rate-limit-mongo-collection.interface';
 export { DyNTS_RateLimit_Config } from './_models/rate-limit-config.interface';
 export { DyNTS_RateLimit_ConsumeRequest_Interface } from './_models/rate-limit-consume-request.interface';
 export { DyNTS_RateLimit_ConsumeResult_Interface } from './_models/rate-limit-consume-result.interface';

package/build/_modules/rate-limit/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/rate-limit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,wCAAwC,EAAE,MAAM,gDAAgD,CAAC;AAC1G,OAAO,EAAE,uCAAuC,EAAE,MAAM,+CAA+C,CAAC;AACxG,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/rate-limit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,yCAAyC,EAAE,MAAM,iDAAiD,CAAC;AAC5G,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,wCAAwC,EAAE,MAAM,gDAAgD,CAAC;AAC1G,OAAO,EAAE,uCAAuC,EAAE,MAAM,+CAA+C,CAAC;AACxG,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC"}

package/build/_modules/rate-limit/index.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_RateLimitStoreKind_Type = exports.DyNTS_RateLimit_InMemoryStore = exports.DyNTS_RateLimit_Middleware = void 0;
+exports.DyNTS_RateLimitStoreKind_Type = exports.DyNTS_RateLimit_Request_Util = exports.DyNTS_RateLimit_MongoStore = exports.DyNTS_RateLimit_InMemoryStore = exports.DyNTS_RateLimit_Middleware = void 0;
 var rate_limit_middleware_1 = require("./rate-limit.middleware");
 Object.defineProperty(exports, "DyNTS_RateLimit_Middleware", { enumerable: true, get: function () { return rate_limit_middleware_1.DyNTS_RateLimit_Middleware; } });
 var rate_limit_in_memory_store_1 = require("./rate-limit-in-memory.store");
 Object.defineProperty(exports, "DyNTS_RateLimit_InMemoryStore", { enumerable: true, get: function () { return rate_limit_in_memory_store_1.DyNTS_RateLimit_InMemoryStore; } });
+var rate_limit_mongo_store_1 = require("./rate-limit-mongo.store");
+Object.defineProperty(exports, "DyNTS_RateLimit_MongoStore", { enumerable: true, get: function () { return rate_limit_mongo_store_1.DyNTS_RateLimit_MongoStore; } });
+var rate_limit_request_util_1 = require("./rate-limit-request.util");
+Object.defineProperty(exports, "DyNTS_RateLimit_Request_Util", { enumerable: true, get: function () { return rate_limit_request_util_1.DyNTS_RateLimit_Request_Util; } });
 var rate_limit_store_kind_type_enum_1 = require("./_enums/rate-limit-store-kind.type-enum");
 Object.defineProperty(exports, "DyNTS_RateLimitStoreKind_Type", { enumerable: true, get: function () { return rate_limit_store_kind_type_enum_1.DyNTS_RateLimitStoreKind_Type; } });
 //# sourceMappingURL=index.js.map

package/build/_modules/rate-limit/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/rate-limit/index.ts"],"names":[],"mappings":";;;AAAA,iEAAqE;AAA5D,mIAAA,0BAA0B,OAAA;AACnC,2EAA6E;AAApE,2IAAA,6BAA6B,OAAA;AAMtC,4FAAyF;AAAhF,gJAAA,6BAA6B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/rate-limit/index.ts"],"names":[],"mappings":";;;AAAA,iEAAqE;AAA5D,mIAAA,0BAA0B,OAAA;AACnC,2EAA6E;AAApE,2IAAA,6BAA6B,OAAA;AACtC,mEAAsE;AAA7D,oIAAA,0BAA0B,OAAA;AACnC,qEAAyE;AAAhE,uIAAA,4BAA4B,OAAA;AAOrC,4FAAyF;AAAhF,gJAAA,6BAA6B,OAAA"}

package/build/_modules/rate-limit/rate-limit-in-memory.store.d.ts

@@ -14,6 +14,5 @@ export declare class DyNTS_RateLimit_InMemoryStore implements DyNTS_RateLimit_St
     reset(): void;
     /** Returns only the aggregate local bucket count for diagnostics. */
     getTrackedBucketCount(): number;
-    private assertRequest;
 }
 //# sourceMappingURL=rate-limit-in-memory.store.d.ts.map

package/build/_modules/rate-limit/rate-limit-in-memory.store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit-in-memory.store.d.ts","sourceRoot":"","sources":["../../../src/_modules/rate-limit/rate-limit-in-memory.store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AACzF,OAAO,EAAE,wCAAwC,EAAE,MAAM,gDAAgD,CAAC;AAC1G,OAAO,EAAE,uCAAuC,EAAE,MAAM,+CAA+C,CAAC;AACxG,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAOvF,+FAA+F;AAC/F,qBAAa,6BAA8B,YAAW,+BAA+B;IACnF,SAAgB,SAAS,EAAE,6BAA6B,CAA0C;IAClG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoE;IAE5F,gGAAgG;IACnF,OAAO,CAClB,OAAO,EAAE,wCAAwC,GAChD,OAAO,CAAC,uCAAuC,CAAC;IA4BnD,2FAA2F;IACpF,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAgBjC,sDAAsD;IAC/C,KAAK,IAAI,IAAI;IAIpB,qEAAqE;IAC9D,qBAAqB,IAAI,MAAM;IAItC,OAAO,CAAC,aAAa;CAiBtB"}
+{"version":3,"file":"rate-limit-in-memory.store.d.ts","sourceRoot":"","sources":["../../../src/_modules/rate-limit/rate-limit-in-memory.store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AACzF,OAAO,EAAE,wCAAwC,EAAE,MAAM,gDAAgD,CAAC;AAC1G,OAAO,EAAE,uCAAuC,EAAE,MAAM,+CAA+C,CAAC;AACxG,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAQvF,+FAA+F;AAC/F,qBAAa,6BAA8B,YAAW,+BAA+B;IACnF,SAAgB,SAAS,EAAE,6BAA6B,CAA0C;IAClG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoE;IAE5F,gGAAgG;IACnF,OAAO,CAClB,OAAO,EAAE,wCAAwC,GAChD,OAAO,CAAC,uCAAuC,CAAC;IA4BnD,2FAA2F;IACpF,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAgBjC,sDAAsD;IAC/C,KAAK,IAAI,IAAI;IAIpB,qEAAqE;IAC9D,qBAAqB,IAAI,MAAM;CAGvC"}

package/build/_modules/rate-limit/rate-limit-in-memory.store.js

@@ -2,13 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DyNTS_RateLimit_InMemoryStore = void 0;
 const rate_limit_store_kind_type_enum_1 = require("./_enums/rate-limit-store-kind.type-enum");
+const rate_limit_request_util_1 = require("./rate-limit-request.util");
 /** Deterministic single-process store for tests and explicitly single-instance development. */
 class DyNTS_RateLimit_InMemoryStore {
     storeKind = rate_limit_store_kind_type_enum_1.DyNTS_RateLimitStoreKind_Type.inMemory;
     records = new Map();
     /** Consumes permit units with exact sliding-window semantics and no background cleanup task. */
     async consume(request) {
-        this.assertRequest(request);
+        rate_limit_request_util_1.DyNTS_RateLimit_Request_Util.assertValid(request);
         const windowStart = request.now - request.policy.windowMs;
         const existing = this.records.get(request.bucketKey);
         const recent = (existing?.timestamps ?? []).filter((timestamp) => timestamp > windowStart);
@@ -50,22 +51,6 @@ class DyNTS_RateLimit_InMemoryStore {
     getTrackedBucketCount() {
         return this.records.size;
     }
-    assertRequest(request) {
-        const isValid = Boolean(request.bucketKey.trim())
-            && request.bucketKey.length <= 512
-            && Number.isSafeInteger(request.now)
-            && request.now >= 0
-            && Number.isSafeInteger(request.cost)
-            && request.cost > 0
-            && Number.isSafeInteger(request.policy.limit)
-            && request.policy.limit > 0
-            && Number.isSafeInteger(request.policy.windowMs)
-            && request.policy.windowMs > 0
-            && request.cost <= request.policy.limit;
-        if (!isValid) {
-            throw new Error('DYNTS_RATE_LIMIT_STORE_REQUEST_INVALID');
-        }
-    }
 }
 exports.DyNTS_RateLimit_InMemoryStore = DyNTS_RateLimit_InMemoryStore;
 //# sourceMappingURL=rate-limit-in-memory.store.js.map

package/build/_modules/rate-limit/rate-limit-in-memory.store.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit-in-memory.store.js","sourceRoot":"","sources":["../../../src/_modules/rate-limit/rate-limit-in-memory.store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rate-limit-in-memory.store.js","sourceRoot":"","sources":["../../../src/_modules/rate-limit/rate-limit-in-memory.store.ts"],"names":[],"mappings":";;;AAAA,8FAAyF;AAIzF,uEAAyE;AAOzE,+FAA+F;AAC/F,MAAa,6BAA6B;IACxB,SAAS,GAAkC,+DAA6B,CAAC,QAAQ,CAAC;IACjF,OAAO,GAA0D,IAAI,GAAG,EAAE,CAAC;IAE5F,gGAAgG;IACzF,KAAK,CAAC,OAAO,CAClB,OAAiD;QAEjD,sDAA4B,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAElD,MAAM,WAAW,GAAW,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;QAClE,MAAM,QAAQ,GAAyD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC3G,MAAM,MAAM,GAAa,CAAC,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAC1D,CAAC,SAAiB,EAAW,EAAE,CAAC,SAAS,GAAG,WAAW,CACxD,CAAC;QACF,MAAM,OAAO,GAAY,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAE9E,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,IAAI,KAAK,GAAW,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;gBAC7D,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE;YAClC,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;SAClC,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;YAC5D,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ;SAC9D,CAAC;IACJ,CAAC;IAED,2FAA2F;IACpF,OAAO,CAAC,GAAW;QACxB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3C,MAAM,GAAG,GAAW,KAAK,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,MAAM,GAA6C,KAAK,CAAC,CAAC,CAAC,CAAC;YAClE,MAAM,MAAM,GAAa,MAAM,CAAC,UAAU,CAAC,MAAM,CAC/C,CAAC,SAAiB,EAAW,EAAE,CAAC,SAAS,GAAG,GAAG,GAAG,MAAM,CAAC,QAAQ,CAClE,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IAED,sDAAsD;IAC/C,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,qEAAqE;IAC9D,qBAAqB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF;AA7DD,sEA6DC"}

package/build/_modules/rate-limit/rate-limit-mongo.store.d.ts

@@ -0,0 +1,34 @@
+import { DyNTS_RateLimitStoreKind_Type } from './_enums/rate-limit-store-kind.type-enum';
+import { DyNTS_RateLimit_ConsumeRequest_Interface } from './_models/rate-limit-consume-request.interface';
+import { DyNTS_RateLimit_ConsumeResult_Interface } from './_models/rate-limit-consume-result.interface';
+import { DyNTS_RateLimit_MongoCollection_Interface } from './_models/rate-limit-mongo-collection.interface';
+import { DyNTS_RateLimit_Store_Interface } from './_models/rate-limit-store.interface';
+/**
+ * BFR-OLDLIGHTSITE-009 — the SHARED (multi-process, multi-replica) rate-limit store, on MongoDB.
+ *
+ * Every permit request is ONE atomic `findOneAndUpdate` with an aggregation-pipeline update on the bucket document:
+ * drop the timestamps outside the sliding window → decide `allowed` from the remaining count + cost → append `cost`
+ * copies of `now` only when allowed. MongoDB applies a single-document update atomically, so concurrent requests from
+ * any number of processes / replicas serialize on the bucket — no read-modify-write race, no lock.
+ * Semantics are identical to `DyNTS_RateLimit_InMemoryStore` (exact sliding window, same result fields).
+ *
+ * Cleanup: `ensureIndexes()` creates a TTL index on `expiresAt` (set to `now + windowMs` on every request), so idle
+ * buckets expire without a background task. MongoDB ≥ 4.2 (pipeline updates).
+ *
+ * Usage: `new DyNTS_RateLimit_MongoStore({ collection: mongoose.connection.collection('dynts_rate_limits') })`.
+ */
+export declare class DyNTS_RateLimit_MongoStore implements DyNTS_RateLimit_Store_Interface {
+    readonly storeKind: DyNTS_RateLimitStoreKind_Type;
+    private readonly collection;
+    /** Creates the store on the shared bucket collection — every replica must point at the SAME collection. */
+    constructor(set: {
+        collection: DyNTS_RateLimit_MongoCollection_Interface;
+    });
+    /** Creates the TTL index that expires idle buckets. Idempotent — call once at boot. */
+    ensureIndexes(): Promise<void>;
+    /** Consumes permit units atomically across every process that shares the collection. */
+    consume(request: DyNTS_RateLimit_ConsumeRequest_Interface): Promise<DyNTS_RateLimit_ConsumeResult_Interface>;
+    /** Driver ≥ 6 returns the document; older drivers / `includeResultMetadata` wrap it in `{ value }`. */
+    private static unwrap;
+}
+//# sourceMappingURL=rate-limit-mongo.store.d.ts.map

package/build/_modules/rate-limit/rate-limit-mongo.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-mongo.store.d.ts","sourceRoot":"","sources":["../../../src/_modules/rate-limit/rate-limit-mongo.store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AACzF,OAAO,EAAE,wCAAwC,EAAE,MAAM,gDAAgD,CAAC;AAC1G,OAAO,EAAE,uCAAuC,EAAE,MAAM,+CAA+C,CAAC;AACxG,OAAO,EAAE,yCAAyC,EAAE,MAAM,iDAAiD,CAAC;AAC5G,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAWvF;;;;;;;;;;;;;GAaG;AACH,qBAAa,0BAA2B,YAAW,+BAA+B;IAChF,SAAgB,SAAS,EAAE,6BAA6B,CAAwC;IAChG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4C;IAEvE,2GAA2G;gBAC/F,GAAG,EAAE;QAAE,UAAU,EAAE,yCAAyC,CAAA;KAAE;IAO1E,uFAAuF;IAC1E,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C,wFAAwF;IAC3E,OAAO,CAClB,OAAO,EAAE,wCAAwC,GAChD,OAAO,CAAC,uCAAuC,CAAC;IAwCnD,uGAAuG;IACvG,OAAO,CAAC,MAAM,CAAC,MAAM;CAWtB"}

package/build/_modules/rate-limit/rate-limit-mongo.store.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_RateLimit_MongoStore = void 0;
+const rate_limit_store_kind_type_enum_1 = require("./_enums/rate-limit-store-kind.type-enum");
+const rate_limit_request_util_1 = require("./rate-limit-request.util");
+/**
+ * BFR-OLDLIGHTSITE-009 — the SHARED (multi-process, multi-replica) rate-limit store, on MongoDB.
+ *
+ * Every permit request is ONE atomic `findOneAndUpdate` with an aggregation-pipeline update on the bucket document:
+ * drop the timestamps outside the sliding window → decide `allowed` from the remaining count + cost → append `cost`
+ * copies of `now` only when allowed. MongoDB applies a single-document update atomically, so concurrent requests from
+ * any number of processes / replicas serialize on the bucket — no read-modify-write race, no lock.
+ * Semantics are identical to `DyNTS_RateLimit_InMemoryStore` (exact sliding window, same result fields).
+ *
+ * Cleanup: `ensureIndexes()` creates a TTL index on `expiresAt` (set to `now + windowMs` on every request), so idle
+ * buckets expire without a background task. MongoDB ≥ 4.2 (pipeline updates).
+ *
+ * Usage: `new DyNTS_RateLimit_MongoStore({ collection: mongoose.connection.collection('dynts_rate_limits') })`.
+ */
+class DyNTS_RateLimit_MongoStore {
+    storeKind = rate_limit_store_kind_type_enum_1.DyNTS_RateLimitStoreKind_Type.shared;
+    collection;
+    /** Creates the store on the shared bucket collection — every replica must point at the SAME collection. */
+    constructor(set) {
+        if (!set?.collection) {
+            throw new Error('DYNTS_RATE_LIMIT_MONGO_STORE_COLLECTION_MISSING');
+        }
+        this.collection = set.collection;
+    }
+    /** Creates the TTL index that expires idle buckets. Idempotent — call once at boot. */
+    async ensureIndexes() {
+        await this.collection.createIndex({ expiresAt: 1 }, { expireAfterSeconds: 0, name: 'dynts_rate_limit_ttl' });
+    }
+    /** Consumes permit units atomically across every process that shares the collection. */
+    async consume(request) {
+        rate_limit_request_util_1.DyNTS_RateLimit_Request_Util.assertValid(request);
+        const windowStart = request.now - request.policy.windowMs;
+        const permits = new Array(request.cost).fill(request.now);
+        const raw = await this.collection.findOneAndUpdate({ _id: request.bucketKey }, [
+            {
+                $set: {
+                    ts: {
+                        $filter: { input: { $ifNull: ['$ts', []] }, as: 't', cond: { $gt: ['$$t', windowStart] } },
+                    },
+                },
+            },
+            { $set: { allowed: { $lte: [{ $add: [{ $size: '$ts' }, request.cost] }, request.policy.limit] } } },
+            {
+                $set: {
+                    ts: { $cond: ['$allowed', { $concatArrays: ['$ts', { $literal: permits }] }, '$ts'] },
+                    expiresAt: { $literal: new Date(request.now + request.policy.windowMs) },
+                },
+            },
+        ], { upsert: true, returnDocument: 'after' });
+        const bucket = DyNTS_RateLimit_MongoStore.unwrap(raw);
+        if (!bucket || !Array.isArray(bucket.ts) || typeof bucket.allowed !== 'boolean') {
+            // fail CLOSED: an unreadable store answer must never let a request through as "allowed"
+            throw new Error('DYNTS_RATE_LIMIT_MONGO_STORE_RESULT_INVALID');
+        }
+        return {
+            allowed: bucket.allowed,
+            remaining: Math.max(0, request.policy.limit - bucket.ts.length),
+            resetAt: (bucket.ts[0] ?? request.now) + request.policy.windowMs,
+        };
+    }
+    /** Driver ≥ 6 returns the document; older drivers / `includeResultMetadata` wrap it in `{ value }`. */
+    static unwrap(raw) {
+        if (raw === null || typeof raw !== 'object') {
+            return null;
+        }
+        if ('value' in raw && !('_id' in raw)) {
+            return raw.value;
+        }
+        return raw;
+    }
+}
+exports.DyNTS_RateLimit_MongoStore = DyNTS_RateLimit_MongoStore;
+//# sourceMappingURL=rate-limit-mongo.store.js.map

package/build/_modules/rate-limit/rate-limit-mongo.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-mongo.store.js","sourceRoot":"","sources":["../../../src/_modules/rate-limit/rate-limit-mongo.store.ts"],"names":[],"mappings":"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"}

package/build/_modules/rate-limit/rate-limit-request.util.d.ts

@@ -0,0 +1,7 @@
+import { DyNTS_RateLimit_ConsumeRequest_Interface } from './_models/rate-limit-consume-request.interface';
+/** Shared validation of a permit request — every rate-limit store rejects the same malformed input the same way. */
+export declare class DyNTS_RateLimit_Request_Util {
+    /** Throws `DYNTS_RATE_LIMIT_STORE_REQUEST_INVALID` for an empty/oversized key, a bad clock, cost or policy. */
+    static assertValid(request: DyNTS_RateLimit_ConsumeRequest_Interface): void;
+}
+//# sourceMappingURL=rate-limit-request.util.d.ts.map

package/build/_modules/rate-limit/rate-limit-request.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-request.util.d.ts","sourceRoot":"","sources":["../../../src/_modules/rate-limit/rate-limit-request.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wCAAwC,EAAE,MAAM,gDAAgD,CAAC;AAE1G,oHAAoH;AACpH,qBAAa,4BAA4B;IAEvC,+GAA+G;IAC/G,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,wCAAwC,GAAG,IAAI;CAiB5E"}

package/build/_modules/rate-limit/rate-limit-request.util.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_RateLimit_Request_Util = void 0;
+/** Shared validation of a permit request — every rate-limit store rejects the same malformed input the same way. */
+class DyNTS_RateLimit_Request_Util {
+    /** Throws `DYNTS_RATE_LIMIT_STORE_REQUEST_INVALID` for an empty/oversized key, a bad clock, cost or policy. */
+    static assertValid(request) {
+        const isValid = Boolean(request.bucketKey.trim())
+            && request.bucketKey.length <= 512
+            && Number.isSafeInteger(request.now)
+            && request.now >= 0
+            && Number.isSafeInteger(request.cost)
+            && request.cost > 0
+            && Number.isSafeInteger(request.policy.limit)
+            && request.policy.limit > 0
+            && Number.isSafeInteger(request.policy.windowMs)
+            && request.policy.windowMs > 0
+            && request.cost <= request.policy.limit;
+        if (!isValid) {
+            throw new Error('DYNTS_RATE_LIMIT_STORE_REQUEST_INVALID');
+        }
+    }
+}
+exports.DyNTS_RateLimit_Request_Util = DyNTS_RateLimit_Request_Util;
+//# sourceMappingURL=rate-limit-request.util.js.map

package/build/_modules/rate-limit/rate-limit-request.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-request.util.js","sourceRoot":"","sources":["../../../src/_modules/rate-limit/rate-limit-request.util.ts"],"names":[],"mappings":";;;AAEA,oHAAoH;AACpH,MAAa,4BAA4B;IAEvC,+GAA+G;IAC/G,MAAM,CAAC,WAAW,CAAC,OAAiD;QAClE,MAAM,OAAO,GAAY,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;eACrD,OAAO,CAAC,SAAS,CAAC,MAAM,IAAI,GAAG;eAC/B,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC;eACjC,OAAO,CAAC,GAAG,IAAI,CAAC;eAChB,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;eAClC,OAAO,CAAC,IAAI,GAAG,CAAC;eAChB,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;eAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC;eACxB,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;eAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC;eAC3B,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF;AApBD,oEAoBC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.356",
+  "version": "01.15.357",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",
@@ -512,7 +512,7 @@
     }
   },
   "devDependencies": {
-    "@futdevpro/fsm-dynamo": "1.20.94",
+    "@futdevpro/fsm-dynamo": "1.20.95",
     "@futdevpro/dynamo-eslint": "1.20.55",
     "@discordjs/opus": "^0.10.0",
     "@discordjs/voice": "^0.18.0",