@futdevpro/nts-dynamo 1.15.154 → 1.15.156

package/build/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.d.ts

@@ -1,6 +1,6 @@
-/** Persistence scope advertised by a rate-limit store implementation. */
-export declare enum DyNTS_RateLimitStoreKind_Type {
-    inMemory = "in-memory",
-    shared = "shared"
-}
+/** Persistence scope advertised by a rate-limit store implementation. */
+export declare enum DyNTS_RateLimitStoreKind_Type {
+    inMemory = "in-memory",
+    shared = "shared"
+}
 //# sourceMappingURL=rate-limit-store-kind.type-enum.d.ts.map

package/build/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.js

@@ -1,10 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_RateLimitStoreKind_Type = void 0;
-/** Persistence scope advertised by a rate-limit store implementation. */
-var DyNTS_RateLimitStoreKind_Type;
-(function (DyNTS_RateLimitStoreKind_Type) {
-    DyNTS_RateLimitStoreKind_Type["inMemory"] = "in-memory";
-    DyNTS_RateLimitStoreKind_Type["shared"] = "shared";
-})(DyNTS_RateLimitStoreKind_Type || (exports.DyNTS_RateLimitStoreKind_Type = DyNTS_RateLimitStoreKind_Type = {}));
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_RateLimitStoreKind_Type = void 0;
+/** Persistence scope advertised by a rate-limit store implementation. */
+var DyNTS_RateLimitStoreKind_Type;
+(function (DyNTS_RateLimitStoreKind_Type) {
+    DyNTS_RateLimitStoreKind_Type["inMemory"] = "in-memory";
+    DyNTS_RateLimitStoreKind_Type["shared"] = "shared";
+})(DyNTS_RateLimitStoreKind_Type || (exports.DyNTS_RateLimitStoreKind_Type = DyNTS_RateLimitStoreKind_Type = {}));
 //# sourceMappingURL=rate-limit-store-kind.type-enum.js.map

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

@@ -1,71 +1,71 @@
-import { Request } from 'express';
-import { DyNTS_RateLimit_Policy } from './rate-limit-policy.interface';
-import { DyNTS_RateLimit_Store_Interface } from './rate-limit-store.interface';
-/**
- * Config a `DyNTS_RateLimit_Middleware.configure(...)`-hoz.
- *
- * Minden mezo opcionalis — a default-ok megfelelnek a tipikus API
- * rate-limit-elvarasoknak (100 req/min, sliding window, IP-alapu kulcs,
- * path-alapu endpoint-csoportositas, X-RateLimit-* response header-ek).
- */
-export interface DyNTS_RateLimit_Config {
-    /**
-     * Default request-limit `windowMs` alatt, ha az adott kulcsra nincs
-     * `setPolicyForKey()`-szel beallitott egyedi policy. Default: `100`.
-     */
-    defaultLimit?: number;
-    /**
-     * Default sliding-window hossza milliszekundumban. Default: `60000` (1 perc).
-     */
-    defaultWindowMs?: number;
-    /**
-     * Rate-limit subject-extractor. Visszater a karakterlanccal, ami azonositja
-     * a rate-limit alanyat (pl. IP-cim, API-kulcs ID, account ID).
-     *
-     * Default: az Express altal mar megbizhatonak minositett `req.ip`, vagy ha
-     * hianyzik akkor `'unknown'`. A middleware szandekosan nem olvassa kozvetlenul
-     * az ugyfel altal hamisithato `x-forwarded-for` headert. Production uzemben a
-     * shared-store gate explicit, opaque extractort kovetel.
-     */
-    keyExtractor?: (req: Request) => string;
-    /**
-     * Endpoint-csoportosito. Visszater a karakterlanccal, ami azonositja az
-     * adott endpoint-csoportot. A storage-key egyertelmuen hossz-prefixelt
-     * subject + endpoint kompozicio lesz.
-     *
-     * Default: `req.path` — minden uri-path kulon vodorbe kerul. Csoportositas
-     * mas szempontok szerint (pl. "datasets" csoport = `/api/datasets/*`)
-     * a hostnal felulirhato.
-     */
-    endpointGrouper?: (req: Request) => string;
-    /** Optional permit cost per request. Default: one. */
-    costExtractor?: (req: Request) => number;
-    /** Atomic store. The default in-memory implementation is for tests and single-instance development only. */
-    store?: DyNTS_RateLimit_Store_Interface;
-    /** Fail configuration unless a shared store plus explicit opaque key/group extractors are supplied. */
-    requireSharedStore?: boolean;
-    /** Deterministic clock seam. Production callers normally omit it. */
-    clock?: () => number;
-    /**
-     * Beallitja-e a `X-RateLimit-Limit`, `X-RateLimit-Remaining`,
-     * `X-RateLimit-Reset` (es a 429-re `Retry-After`) response header-eket.
-     * Default: `true`.
-     *
-     * Test/dev kornyezetben opcionalisan kikapcsolhato.
-     */
-    responseHeaders?: boolean;
-    /**
-     * Per-policy override-ok az induloskor. A `setPolicyForKey()` runtime-ban is
-     * felulhatja ezeket.
-     */
-    initialKeyPolicies?: Record<string, DyNTS_RateLimit_Policy>;
-    /**
-     * Per-endpoint(-csoport) policy override-ok az induloskor. A `setPolicyForEndpoint()`
-     * runtime-ban is felulhatja ezeket. A kulcs annak felel meg, amit az `endpointGrouper`
-     * visszaad (default: `req.path`). Akkor hasznos, ha kulonbozo endpointoknak kulonbozo
-     * limit kell (pl. egy webhook nagy burst-toleranciat igenyel a legit forgalomhoz, mig
-     * egy admin-endpoint szuk limitet). Precedencia: per-kulcs policy > per-endpoint policy > default.
-     */
-    initialEndpointPolicies?: Record<string, DyNTS_RateLimit_Policy>;
-}
+import { Request } from 'express';
+import { DyNTS_RateLimit_Policy } from './rate-limit-policy.interface';
+import { DyNTS_RateLimit_Store_Interface } from './rate-limit-store.interface';
+/**
+ * Config a `DyNTS_RateLimit_Middleware.configure(...)`-hoz.
+ *
+ * Minden mezo opcionalis — a default-ok megfelelnek a tipikus API
+ * rate-limit-elvarasoknak (100 req/min, sliding window, IP-alapu kulcs,
+ * path-alapu endpoint-csoportositas, X-RateLimit-* response header-ek).
+ */
+export interface DyNTS_RateLimit_Config {
+    /**
+     * Default request-limit `windowMs` alatt, ha az adott kulcsra nincs
+     * `setPolicyForKey()`-szel beallitott egyedi policy. Default: `100`.
+     */
+    defaultLimit?: number;
+    /**
+     * Default sliding-window hossza milliszekundumban. Default: `60000` (1 perc).
+     */
+    defaultWindowMs?: number;
+    /**
+     * Rate-limit subject-extractor. Visszater a karakterlanccal, ami azonositja
+     * a rate-limit alanyat (pl. IP-cim, API-kulcs ID, account ID).
+     *
+     * Default: az Express altal mar megbizhatonak minositett `req.ip`, vagy ha
+     * hianyzik akkor `'unknown'`. A middleware szandekosan nem olvassa kozvetlenul
+     * az ugyfel altal hamisithato `x-forwarded-for` headert. Production uzemben a
+     * shared-store gate explicit, opaque extractort kovetel.
+     */
+    keyExtractor?: (req: Request) => string;
+    /**
+     * Endpoint-csoportosito. Visszater a karakterlanccal, ami azonositja az
+     * adott endpoint-csoportot. A storage-key egyertelmuen hossz-prefixelt
+     * subject + endpoint kompozicio lesz.
+     *
+     * Default: `req.path` — minden uri-path kulon vodorbe kerul. Csoportositas
+     * mas szempontok szerint (pl. "datasets" csoport = `/api/datasets/*`)
+     * a hostnal felulirhato.
+     */
+    endpointGrouper?: (req: Request) => string;
+    /** Optional permit cost per request. Default: one. */
+    costExtractor?: (req: Request) => number;
+    /** Atomic store. The default in-memory implementation is for tests and single-instance development only. */
+    store?: DyNTS_RateLimit_Store_Interface;
+    /** Fail configuration unless a shared store plus explicit opaque key/group extractors are supplied. */
+    requireSharedStore?: boolean;
+    /** Deterministic clock seam. Production callers normally omit it. */
+    clock?: () => number;
+    /**
+     * Beallitja-e a `X-RateLimit-Limit`, `X-RateLimit-Remaining`,
+     * `X-RateLimit-Reset` (es a 429-re `Retry-After`) response header-eket.
+     * Default: `true`.
+     *
+     * Test/dev kornyezetben opcionalisan kikapcsolhato.
+     */
+    responseHeaders?: boolean;
+    /**
+     * Per-policy override-ok az induloskor. A `setPolicyForKey()` runtime-ban is
+     * felulhatja ezeket.
+     */
+    initialKeyPolicies?: Record<string, DyNTS_RateLimit_Policy>;
+    /**
+     * Per-endpoint(-csoport) policy override-ok az induloskor. A `setPolicyForEndpoint()`
+     * runtime-ban is felulhatja ezeket. A kulcs annak felel meg, amit az `endpointGrouper`
+     * visszaad (default: `req.path`). Akkor hasznos, ha kulonbozo endpointoknak kulonbozo
+     * limit kell (pl. egy webhook nagy burst-toleranciat igenyel a legit forgalomhoz, mig
+     * egy admin-endpoint szuk limitet). Precedencia: per-kulcs policy > per-endpoint policy > default.
+     */
+    initialEndpointPolicies?: Record<string, DyNTS_RateLimit_Policy>;
+}
 //# sourceMappingURL=rate-limit-config.interface.d.ts.map

package/build/_modules/rate-limit/_models/rate-limit-config.interface.js

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

package/build/_modules/rate-limit/_models/rate-limit-consume-request.interface.d.ts

@@ -1,9 +1,9 @@
-import { DyNTS_RateLimit_Policy } from './rate-limit-policy.interface';
-/** Atomic permit request passed to a rate-limit store. */
-export interface DyNTS_RateLimit_ConsumeRequest_Interface {
-    bucketKey: string;
-    policy: DyNTS_RateLimit_Policy;
-    cost: number;
-    now: number;
-}
+import { DyNTS_RateLimit_Policy } from './rate-limit-policy.interface';
+/** Atomic permit request passed to a rate-limit store. */
+export interface DyNTS_RateLimit_ConsumeRequest_Interface {
+    bucketKey: string;
+    policy: DyNTS_RateLimit_Policy;
+    cost: number;
+    now: number;
+}
 //# sourceMappingURL=rate-limit-consume-request.interface.d.ts.map

package/build/_modules/rate-limit/_models/rate-limit-consume-request.interface.js

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

package/build/_modules/rate-limit/_models/rate-limit-consume-result.interface.d.ts

@@ -1,7 +1,7 @@
-/** Content-free result of one atomically committed permit request. */
-export interface DyNTS_RateLimit_ConsumeResult_Interface {
-    allowed: boolean;
-    remaining: number;
-    resetAt: number;
-}
+/** Content-free result of one atomically committed permit request. */
+export interface DyNTS_RateLimit_ConsumeResult_Interface {
+    allowed: boolean;
+    remaining: number;
+    resetAt: number;
+}
 //# sourceMappingURL=rate-limit-consume-result.interface.d.ts.map

package/build/_modules/rate-limit/_models/rate-limit-consume-result.interface.js

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

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

@@ -1,16 +1,16 @@
-/**
- * Per-kulcs rate-limit policy.
- *
- * A `DyNTS_RateLimit_Middleware.setPolicyForKey(key, policy)` allitja be,
- * vagy a `DyNTS_RateLimit_Config.initialKeyPolicies` map-en at.
- *
- * Tipikus use-case: subscription-tier-up — egy belepett user API-kulcsa
- * magasabb `limit`-et kap, mint a default (anonim/IP-alapu) limit.
- */
-export interface DyNTS_RateLimit_Policy {
-    /** Hany request engedelyezett a `windowMs` alatt. */
-    limit: number;
-    /** A sliding-window hossza milliszekundumban. */
-    windowMs: number;
-}
+/**
+ * Per-kulcs rate-limit policy.
+ *
+ * A `DyNTS_RateLimit_Middleware.setPolicyForKey(key, policy)` allitja be,
+ * vagy a `DyNTS_RateLimit_Config.initialKeyPolicies` map-en at.
+ *
+ * Tipikus use-case: subscription-tier-up — egy belepett user API-kulcsa
+ * magasabb `limit`-et kap, mint a default (anonim/IP-alapu) limit.
+ */
+export interface DyNTS_RateLimit_Policy {
+    /** Hany request engedelyezett a `windowMs` alatt. */
+    limit: number;
+    /** A sliding-window hossza milliszekundumban. */
+    windowMs: number;
+}
 //# sourceMappingURL=rate-limit-policy.interface.d.ts.map

package/build/_modules/rate-limit/_models/rate-limit-policy.interface.js

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

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

@@ -1,9 +1,9 @@
-import { DyNTS_RateLimitStoreKind_Type } from '../_enums/rate-limit-store-kind.type-enum';
-import { DyNTS_RateLimit_ConsumeRequest_Interface } from './rate-limit-consume-request.interface';
-import { DyNTS_RateLimit_ConsumeResult_Interface } from './rate-limit-consume-result.interface';
-/** Atomic persistence seam. Production hosts can require `shared` scope at configuration time. */
-export interface DyNTS_RateLimit_Store_Interface {
-    readonly storeKind: DyNTS_RateLimitStoreKind_Type;
-    consume(request: DyNTS_RateLimit_ConsumeRequest_Interface): Promise<DyNTS_RateLimit_ConsumeResult_Interface>;
-}
+import { DyNTS_RateLimitStoreKind_Type } from '../_enums/rate-limit-store-kind.type-enum';
+import { DyNTS_RateLimit_ConsumeRequest_Interface } from './rate-limit-consume-request.interface';
+import { DyNTS_RateLimit_ConsumeResult_Interface } from './rate-limit-consume-result.interface';
+/** Atomic persistence seam. Production hosts can require `shared` scope at configuration time. */
+export interface DyNTS_RateLimit_Store_Interface {
+    readonly storeKind: DyNTS_RateLimitStoreKind_Type;
+    consume(request: DyNTS_RateLimit_ConsumeRequest_Interface): Promise<DyNTS_RateLimit_ConsumeResult_Interface>;
+}
 //# sourceMappingURL=rate-limit-store.interface.d.ts.map

package/build/_modules/rate-limit/_models/rate-limit-store.interface.js

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

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

@@ -1,9 +1,9 @@
-export { DyNTS_RateLimit_Middleware } from './rate-limit.middleware';
-export { DyNTS_RateLimit_InMemoryStore } from './rate-limit-in-memory.store';
-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';
-export { DyNTS_RateLimit_Policy } from './_models/rate-limit-policy.interface';
-export { DyNTS_RateLimit_Store_Interface } from './_models/rate-limit-store.interface';
-export { DyNTS_RateLimitStoreKind_Type } from './_enums/rate-limit-store-kind.type-enum';
+export { DyNTS_RateLimit_Middleware } from './rate-limit.middleware';
+export { DyNTS_RateLimit_InMemoryStore } from './rate-limit-in-memory.store';
+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';
+export { DyNTS_RateLimit_Policy } from './_models/rate-limit-policy.interface';
+export { DyNTS_RateLimit_Store_Interface } from './_models/rate-limit-store.interface';
+export { DyNTS_RateLimitStoreKind_Type } from './_enums/rate-limit-store-kind.type-enum';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,10 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_RateLimitStoreKind_Type = 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_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; } });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_RateLimitStoreKind_Type = 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_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/rate-limit-in-memory.store.d.ts

@@ -1,19 +1,19 @@
-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_Store_Interface } from './_models/rate-limit-store.interface';
-/** Deterministic single-process store for tests and explicitly single-instance development. */
-export declare class DyNTS_RateLimit_InMemoryStore implements DyNTS_RateLimit_Store_Interface {
-    readonly storeKind: DyNTS_RateLimitStoreKind_Type;
-    private readonly records;
-    /** Consumes permit units with exact sliding-window semantics and no background cleanup task. */
-    consume(request: DyNTS_RateLimit_ConsumeRequest_Interface): Promise<DyNTS_RateLimit_ConsumeResult_Interface>;
-    /** Opportunistically removes expired local records when explicitly invoked by the host. */
-    cleanup(now: number): void;
-    /** Clears all local state for deterministic tests. */
-    reset(): void;
-    /** Returns only the aggregate local bucket count for diagnostics. */
-    getTrackedBucketCount(): number;
-    private assertRequest;
-}
+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_Store_Interface } from './_models/rate-limit-store.interface';
+/** Deterministic single-process store for tests and explicitly single-instance development. */
+export declare class DyNTS_RateLimit_InMemoryStore implements DyNTS_RateLimit_Store_Interface {
+    readonly storeKind: DyNTS_RateLimitStoreKind_Type;
+    private readonly records;
+    /** Consumes permit units with exact sliding-window semantics and no background cleanup task. */
+    consume(request: DyNTS_RateLimit_ConsumeRequest_Interface): Promise<DyNTS_RateLimit_ConsumeResult_Interface>;
+    /** Opportunistically removes expired local records when explicitly invoked by the host. */
+    cleanup(now: number): void;
+    /** Clears all local state for deterministic tests. */
+    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.js

@@ -1,71 +1,71 @@
-"use strict";
-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");
-/** 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);
-        const windowStart = request.now - request.policy.windowMs;
-        const existing = this.records.get(request.bucketKey);
-        const recent = (existing?.timestamps ?? []).filter((timestamp) => timestamp > windowStart);
-        const allowed = recent.length + request.cost <= request.policy.limit;
-        if (allowed) {
-            for (let index = 0; index < request.cost; index += 1) {
-                recent.push(request.now);
-            }
-        }
-        this.records.set(request.bucketKey, {
-            timestamps: recent,
-            windowMs: request.policy.windowMs,
-        });
-        return {
-            allowed: allowed,
-            remaining: Math.max(0, request.policy.limit - recent.length),
-            resetAt: (recent[0] ?? request.now) + request.policy.windowMs,
-        };
-    }
-    /** Opportunistically removes expired local records when explicitly invoked by the host. */
-    cleanup(now) {
-        for (const entry of this.records.entries()) {
-            const key = entry[0];
-            const record = entry[1];
-            const recent = record.timestamps.filter((timestamp) => timestamp > now - record.windowMs);
-            if (!recent.length) {
-                this.records.delete(key);
-            }
-            else {
-                this.records.set(key, { ...record, timestamps: recent });
-            }
-        }
-    }
-    /** Clears all local state for deterministic tests. */
-    reset() {
-        this.records.clear();
-    }
-    /** Returns only the aggregate local bucket count for diagnostics. */
-    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;
+"use strict";
+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");
+/** 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);
+        const windowStart = request.now - request.policy.windowMs;
+        const existing = this.records.get(request.bucketKey);
+        const recent = (existing?.timestamps ?? []).filter((timestamp) => timestamp > windowStart);
+        const allowed = recent.length + request.cost <= request.policy.limit;
+        if (allowed) {
+            for (let index = 0; index < request.cost; index += 1) {
+                recent.push(request.now);
+            }
+        }
+        this.records.set(request.bucketKey, {
+            timestamps: recent,
+            windowMs: request.policy.windowMs,
+        });
+        return {
+            allowed: allowed,
+            remaining: Math.max(0, request.policy.limit - recent.length),
+            resetAt: (recent[0] ?? request.now) + request.policy.windowMs,
+        };
+    }
+    /** Opportunistically removes expired local records when explicitly invoked by the host. */
+    cleanup(now) {
+        for (const entry of this.records.entries()) {
+            const key = entry[0];
+            const record = entry[1];
+            const recent = record.timestamps.filter((timestamp) => timestamp > now - record.windowMs);
+            if (!recent.length) {
+                this.records.delete(key);
+            }
+            else {
+                this.records.set(key, { ...record, timestamps: recent });
+            }
+        }
+    }
+    /** Clears all local state for deterministic tests. */
+    reset() {
+        this.records.clear();
+    }
+    /** Returns only the aggregate local bucket count for diagnostics. */
+    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