@futdevpro/nts-dynamo 1.15.168 → 1.15.173

package/README.md

@@ -344,11 +344,21 @@ The `@futdevpro/nts-dynamo/rate-limit` entry point provides an atomic rate-limit
 - trusted `req.ip` as the safe local default instead of reading caller-controlled forwarding headers directly;
 - explicit opportunistic local cleanup with no timer, polling loop or hidden background task.
 
-Production consumers must implement the shared store with one atomic permit decision across every application
-instance. They must derive non-sensitive, purpose-scoped bucket identifiers and must not persist or log raw IP
-addresses, credentials, email addresses or other request content as rate-limit keys.
-
-### Privacy lifecycle
+Production consumers must implement the shared store with one atomic permit decision across every application
+instance. They must derive non-sensitive, purpose-scoped bucket identifiers and must not persist or log raw IP
+addresses, credentials, email addresses or other request content as rate-limit keys.
+
+### Namespace-bound keyset pagination
+
+The optional `@futdevpro/nts-dynamo/pagination` entry point provides a strict keyset cursor codec for bounded
+API listings. A codec instance binds every cursor to one declared namespace and an exact tuple dimension count,
+uses canonical unpadded base64url, rejects expanded or reordered payloads, and returns defensive tuple copies.
+
+The cursor is an integrity and routing boundary, not encryption. Consumers must put only non-sensitive ordering
+values such as canonical timestamps and opaque resource identifiers into the tuple. Tenant, account, email,
+authorization or business-content fields must remain server-derived and outside the cursor payload.
+
+### Privacy lifecycle
 
 The optional `@futdevpro/nts-dynamo/privacy-lifecycle` entry point provides the shared machinery for standalone
 GDPR-capable products:

package/build/_modules/pagination/_models/keyset-cursor.interface.d.ts

@@ -0,0 +1,16 @@
+/** Construction policy for one route- or capability-bound keyset cursor codec. */
+export interface DyNTS_KeysetCursorSettings_Interface {
+    namespace: string;
+    dimensionCount: number;
+    maxValueLength?: number;
+}
+/** Canonical content-free ordering tuple carried by a keyset cursor. */
+export interface DyNTS_KeysetCursorValue_Interface {
+    values: string[];
+}
+/** Internal versioned cursor payload. It deliberately carries no tenant or subject authority. */
+export interface DyNTS_KeysetCursorPayload_Interface extends DyNTS_KeysetCursorValue_Interface {
+    contractVersion: 'dynts-keyset-cursor/1';
+    namespace: string;
+}
+//# sourceMappingURL=keyset-cursor.interface.d.ts.map

package/build/_modules/pagination/_models/keyset-cursor.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyset-cursor.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/pagination/_models/keyset-cursor.interface.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,WAAW,oCAAoC;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wEAAwE;AACxE,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,iGAAiG;AACjG,MAAM,WAAW,mCAAoC,SAAQ,iCAAiC;IAC5F,eAAe,EAAE,uBAAuB,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/build/_modules/pagination/_models/keyset-cursor.interface.js

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

package/build/_modules/pagination/_models/keyset-cursor.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyset-cursor.interface.js","sourceRoot":"","sources":["../../../../src/_modules/pagination/_models/keyset-cursor.interface.ts"],"names":[],"mappings":""}

package/build/_modules/pagination/index.d.ts

@@ -0,0 +1,3 @@
+export { DyNTS_KeysetCursor_ControlService } from './keyset-cursor.control-service';
+export type { DyNTS_KeysetCursorPayload_Interface, DyNTS_KeysetCursorSettings_Interface, DyNTS_KeysetCursorValue_Interface } from './_models/keyset-cursor.interface';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/pagination/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/pagination/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AACpF,YAAY,EACV,mCAAmC,EACnC,oCAAoC,EACpC,iCAAiC,EAClC,MAAM,mCAAmC,CAAC"}

package/build/_modules/pagination/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_KeysetCursor_ControlService = void 0;
+var keyset_cursor_control_service_1 = require("./keyset-cursor.control-service");
+Object.defineProperty(exports, "DyNTS_KeysetCursor_ControlService", { enumerable: true, get: function () { return keyset_cursor_control_service_1.DyNTS_KeysetCursor_ControlService; } });
+//# sourceMappingURL=index.js.map

package/build/_modules/pagination/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/pagination/index.ts"],"names":[],"mappings":";;;AAAA,iFAAoF;AAA3E,kJAAA,iCAAiC,OAAA"}

package/build/_modules/pagination/keyset-cursor.control-service.d.ts

@@ -0,0 +1,21 @@
+import { DyNTS_KeysetCursorSettings_Interface, DyNTS_KeysetCursorValue_Interface } from './_models/keyset-cursor.interface';
+/** Encodes deterministic, namespace-bound keyset positions without carrying caller authority. */
+export declare class DyNTS_KeysetCursor_ControlService {
+    static readonly contractVersion: 'dynts-keyset-cursor/1';
+    private static readonly absoluteMaxDimensions;
+    private static readonly absoluteMaxValueLength;
+    private static readonly maxCursorLength;
+    private readonly namespace;
+    private readonly dimensionCount;
+    private readonly maxValueLength;
+    /** Creates one codec whose cursors cannot be replayed in another declared namespace. */
+    constructor(set: DyNTS_KeysetCursorSettings_Interface);
+    /** Encodes an exact non-sensitive sort tuple as canonical unpadded base64url. */
+    encode(value: DyNTS_KeysetCursorValue_Interface): string;
+    /** Decodes only an exact canonical payload created for this codec namespace and tuple shape. */
+    decode(cursor: string): DyNTS_KeysetCursorValue_Interface;
+    private isValidPayload;
+    private isValidValue;
+    private error;
+}
+//# sourceMappingURL=keyset-cursor.control-service.d.ts.map

package/build/_modules/pagination/keyset-cursor.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyset-cursor.control-service.d.ts","sourceRoot":"","sources":["../../../src/_modules/pagination/keyset-cursor.control-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,oCAAoC,EACpC,iCAAiC,EAClC,MAAM,mCAAmC,CAAC;AAM3C,iGAAiG;AACjG,qBAAa,iCAAiC;IAC5C,gBAAuB,eAAe,EAAE,uBAAuB,CAA2B;IAC1F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAa;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAe;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAgB;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,wFAAwF;gBAC5E,GAAG,EAAE,oCAAoC;IAuBrD,iFAAiF;IAC1E,MAAM,CAAC,KAAK,EAAE,iCAAiC,GAAG,MAAM;IAmB/D,gGAAgG;IACzF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,iCAAiC;IAuChE,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,KAAK;CASd"}

package/build/_modules/pagination/keyset-cursor.control-service.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_KeysetCursor_ControlService = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+const DYNTS_KEYSET_CURSOR_PATTERN = /^[A-Za-z0-9_-]+$/u;
+const DYNTS_KEYSET_CURSOR_NAMESPACE_PATTERN = /^[a-z0-9][a-z0-9._:/-]{0,127}$/u;
+const DYNTS_KEYSET_CURSOR_VALUE_PATTERN = /^[A-Za-z0-9._:-]+$/u;
+/** Encodes deterministic, namespace-bound keyset positions without carrying caller authority. */
+class DyNTS_KeysetCursor_ControlService {
+    static contractVersion = 'dynts-keyset-cursor/1';
+    static absoluteMaxDimensions = 8;
+    static absoluteMaxValueLength = 256;
+    static maxCursorLength = 2048;
+    namespace;
+    dimensionCount;
+    maxValueLength;
+    /** Creates one codec whose cursors cannot be replayed in another declared namespace. */
+    constructor(set) {
+        const maxValueLength = set?.maxValueLength
+            ?? DyNTS_KeysetCursor_ControlService.absoluteMaxValueLength;
+        if (!set
+            || typeof set.namespace !== 'string'
+            || !DYNTS_KEYSET_CURSOR_NAMESPACE_PATTERN.test(set.namespace)
+            || !Number.isSafeInteger(set.dimensionCount)
+            || set.dimensionCount < 1
+            || set.dimensionCount > DyNTS_KeysetCursor_ControlService.absoluteMaxDimensions
+            || !Number.isSafeInteger(maxValueLength)
+            || maxValueLength < 1
+            || maxValueLength > DyNTS_KeysetCursor_ControlService.absoluteMaxValueLength) {
+            throw this.error(500, 'SETTINGS_INVALID', 'The keyset cursor settings are invalid.');
+        }
+        this.namespace = set.namespace;
+        this.dimensionCount = set.dimensionCount;
+        this.maxValueLength = maxValueLength;
+    }
+    /** Encodes an exact non-sensitive sort tuple as canonical unpadded base64url. */
+    encode(value) {
+        if (!this.isValidValue(value)) {
+            throw this.error(500, 'VALUE_INVALID', 'The keyset cursor value is invalid.');
+        }
+        const payload = {
+            contractVersion: DyNTS_KeysetCursor_ControlService.contractVersion,
+            namespace: this.namespace,
+            values: [...value.values],
+        };
+        const cursor = Buffer.from(JSON.stringify(payload), 'utf8').toString('base64url');
+        if (cursor.length > DyNTS_KeysetCursor_ControlService.maxCursorLength) {
+            throw this.error(500, 'VALUE_INVALID', 'The keyset cursor value is invalid.');
+        }
+        return cursor;
+    }
+    /** Decodes only an exact canonical payload created for this codec namespace and tuple shape. */
+    decode(cursor) {
+        try {
+            if (typeof cursor !== 'string'
+                || cursor.length < 1
+                || cursor.length > DyNTS_KeysetCursor_ControlService.maxCursorLength
+                || !DYNTS_KEYSET_CURSOR_PATTERN.test(cursor)) {
+                throw new Error('Cursor syntax is invalid.');
+            }
+            const decoded = Buffer.from(cursor, 'base64url');
+            if (decoded.toString('base64url') !== cursor) {
+                throw new Error('Cursor encoding is not canonical.');
+            }
+            const payload = JSON.parse(decoded.toString('utf8'));
+            if (!this.isValidPayload(payload)) {
+                throw new Error('Cursor payload is invalid.');
+            }
+            const canonicalPayload = {
+                contractVersion: DyNTS_KeysetCursor_ControlService.contractVersion,
+                namespace: this.namespace,
+                values: [...payload.values],
+            };
+            if (Buffer.from(JSON.stringify(canonicalPayload), 'utf8').toString('base64url') !== cursor) {
+                throw new Error('Cursor payload is not canonical.');
+            }
+            return { values: [...payload.values] };
+        }
+        catch {
+            throw this.error(400, 'CURSOR_INVALID', 'The keyset cursor is invalid.');
+        }
+    }
+    isValidPayload(value) {
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            return false;
+        }
+        const keys = Object.keys(value).sort();
+        const values = Reflect.get(value, 'values');
+        return keys.join(',') === 'contractVersion,namespace,values'
+            && Reflect.get(value, 'contractVersion') === DyNTS_KeysetCursor_ControlService.contractVersion
+            && Reflect.get(value, 'namespace') === this.namespace
+            && this.isValidValue({ values: Array.isArray(values) ? values : [] });
+    }
+    isValidValue(value) {
+        return typeof value === 'object'
+            && value !== null
+            && Array.isArray(value.values)
+            && value.values.length === this.dimensionCount
+            && value.values.every((item) => (typeof item === 'string'
+                && item.length >= 1
+                && item.length <= this.maxValueLength
+                && DYNTS_KEYSET_CURSOR_VALUE_PATTERN.test(item)));
+    }
+    error(status, suffix, message) {
+        return new fsm_dynamo_1.DyFM_Error({
+            status: status,
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|KEYSET_CURSOR|${suffix}`,
+            message: message,
+            userMessage: status < 500 ? message : 'The keyset cursor could not be created safely.',
+            issuerService: this.constructor.name,
+        });
+    }
+}
+exports.DyNTS_KeysetCursor_ControlService = DyNTS_KeysetCursor_ControlService;
+//# sourceMappingURL=keyset-cursor.control-service.js.map

package/build/_modules/pagination/keyset-cursor.control-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyset-cursor.control-service.js","sourceRoot":"","sources":["../../../src/_modules/pagination/keyset-cursor.control-service.ts"],"names":[],"mappings":"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"}

package/build/_modules/privacy-lifecycle/_models/privacy-request-cursor-value.interface.d.ts

@@ -0,0 +1,6 @@
+/** Content-free storage ordering tuple carried by the versioned opaque request-list cursor. */
+export interface DyNTS_PrivacyRequestCursorValue_Interface {
+    createdAt: string;
+    requestId: string;
+}
+//# sourceMappingURL=privacy-request-cursor-value.interface.d.ts.map

package/build/_modules/privacy-lifecycle/_models/privacy-request-cursor-value.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-request-cursor-value.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/privacy-lifecycle/_models/privacy-request-cursor-value.interface.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,MAAM,WAAW,yCAAyC;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/build/_modules/privacy-lifecycle/_models/privacy-request-cursor-value.interface.js

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

package/build/_modules/privacy-lifecycle/_models/privacy-request-cursor-value.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-request-cursor-value.interface.js","sourceRoot":"","sources":["../../../../src/_modules/privacy-lifecycle/_models/privacy-request-cursor-value.interface.ts"],"names":[],"mappings":""}

package/build/_modules/privacy-lifecycle/index.d.ts

@@ -1,4 +1,5 @@
 export { DyNTS_PrivacyLifecycle_ControlService } from './privacy-lifecycle.control-service';
+export { DyNTS_PrivacyRequestCursor_ControlService } from './privacy-request-cursor.control-service';
 export { DyNTS_PrivacyLedger_ControlService } from './privacy-ledger.control-service';
 export { DyNTS_PrivacyExportArtifact_ControlService } from './privacy-export-artifact.control-service';
 export { DyNTS_PrivacyExportArtifact_MongoStore } from './privacy-export-artifact.mongo-store';
@@ -30,6 +31,7 @@ export { DyNTS_PrivacyRequestCreateResult_Interface } from './_models/privacy-re
 export { DyNTS_PrivacyRequestOpen_Interface } from './_models/privacy-request-open.interface';
 export { DyNTS_PrivacyRequestPersistenceCreateResult_Interface } from './_models/privacy-request-persistence-create-result.interface';
 export { DyNTS_PrivacyRequestRecord_Interface } from './_models/privacy-request-record.interface';
+export { DyNTS_PrivacyRequestCursorValue_Interface } from './_models/privacy-request-cursor-value.interface';
 export { DyNTS_PrivacyRequestList_Interface, DyNTS_PrivacyRequestListQuery_Interface } from './_models/privacy-request-list.interface';
 export { DyNTS_PrivacyRequestListResult_Interface, DyNTS_PrivacyRequestPersistenceListResult_Interface } from './_models/privacy-request-list-result.interface';
 export { DyNTS_PrivacyRequestResult_Interface } from './_models/privacy-request-result.interface';

package/build/_modules/privacy-lifecycle/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/privacy-lifecycle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,qCAAqC,CAAC;AAC5F,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AACvG,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAAE,iCAAiC,EAAE,MAAM,6CAA6C,CAAC;AAChG,OAAO,EAAE,mCAAmC,EAAE,MAAM,+CAA+C,CAAC;AACpG,OAAO,EAAE,oCAAoC,EAAE,MAAM,gDAAgD,CAAC;AACtG,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,yCAAyC,EAAE,MAAM,iDAAiD,CAAC;AAC5G,OAAO,EAAE,yCAAyC,EAAE,MAAM,iDAAiD,CAAC;AAC5G,OAAO,EAAE,sCAAsC,EAAE,MAAM,8CAA8C,CAAC;AACtG,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EAAE,uCAAuC,EAAE,MAAM,+CAA+C,CAAC;AACxG,OAAO,EAAE,wCAAwC,EAAE,MAAM,gDAAgD,CAAC;AAC1G,OAAO,EAAE,mCAAmC,EAAE,MAAM,2CAA2C,CAAC;AAChG,OAAO,EACL,+CAA+C,EAChD,MAAM,wDAAwD,CAAC;AAChE,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAC9F,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EAAE,mCAAmC,EAAE,MAAM,2CAA2C,CAAC;AAChG,OAAO,EAAE,qCAAqC,EAAE,MAAM,6CAA6C,CAAC;AACpG,OAAO,EAAE,2CAA2C,EAAE,MAAM,oDAAoD,CAAC;AACjH,OAAO,EACL,uDAAuD,EACxD,MAAM,iEAAiE,CAAC;AACzE,OAAO,EAAE,4CAA4C,EAAE,MAAM,qDAAqD,CAAC;AACnH,OAAO,EACL,0CAA0C,EAC3C,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,sCAAsC,EAAE,MAAM,8CAA8C,CAAC;AACtG,OAAO,EAAE,0CAA0C,EAAE,MAAM,mDAAmD,CAAC;AAC/G,OAAO,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAC9F,OAAO,EACL,qDAAqD,EACtD,MAAM,+DAA+D,CAAC;AACvE,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EACL,kCAAkC,EAClC,uCAAuC,EACxC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,wCAAwC,EACxC,mDAAmD,EACpD,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAC9F,OAAO,EACL,8CAA8C,EAC9C,2CAA2C,EAC3C,4CAA4C,EAC5C,iDAAiD,EACjD,2CAA2C,EAC3C,+CAA+C,EAC/C,2CAA2C,EAC3C,2CAA2C,EAC3C,0CAA0C,EAC1C,yCAAyC,EACzC,0CAA0C,EAC3C,MAAM,6CAA6C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/privacy-lifecycle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,qCAAqC,CAAC;AAC5F,OAAO,EAAE,yCAAyC,EAAE,MAAM,0CAA0C,CAAC;AACrG,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AACvG,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAAE,iCAAiC,EAAE,MAAM,6CAA6C,CAAC;AAChG,OAAO,EAAE,mCAAmC,EAAE,MAAM,+CAA+C,CAAC;AACpG,OAAO,EAAE,oCAAoC,EAAE,MAAM,gDAAgD,CAAC;AACtG,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,yCAAyC,EAAE,MAAM,iDAAiD,CAAC;AAC5G,OAAO,EAAE,yCAAyC,EAAE,MAAM,iDAAiD,CAAC;AAC5G,OAAO,EAAE,sCAAsC,EAAE,MAAM,8CAA8C,CAAC;AACtG,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EAAE,uCAAuC,EAAE,MAAM,+CAA+C,CAAC;AACxG,OAAO,EAAE,wCAAwC,EAAE,MAAM,gDAAgD,CAAC;AAC1G,OAAO,EAAE,mCAAmC,EAAE,MAAM,2CAA2C,CAAC;AAChG,OAAO,EACL,+CAA+C,EAChD,MAAM,wDAAwD,CAAC;AAChE,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAC9F,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EAAE,mCAAmC,EAAE,MAAM,2CAA2C,CAAC;AAChG,OAAO,EAAE,qCAAqC,EAAE,MAAM,6CAA6C,CAAC;AACpG,OAAO,EAAE,2CAA2C,EAAE,MAAM,oDAAoD,CAAC;AACjH,OAAO,EACL,uDAAuD,EACxD,MAAM,iEAAiE,CAAC;AACzE,OAAO,EAAE,4CAA4C,EAAE,MAAM,qDAAqD,CAAC;AACnH,OAAO,EACL,0CAA0C,EAC3C,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,sCAAsC,EAAE,MAAM,8CAA8C,CAAC;AACtG,OAAO,EAAE,0CAA0C,EAAE,MAAM,mDAAmD,CAAC;AAC/G,OAAO,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAC9F,OAAO,EACL,qDAAqD,EACtD,MAAM,+DAA+D,CAAC;AACvE,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EACL,yCAAyC,EAC1C,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,kCAAkC,EAClC,uCAAuC,EACxC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,wCAAwC,EACxC,mDAAmD,EACpD,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAC9F,OAAO,EACL,8CAA8C,EAC9C,2CAA2C,EAC3C,4CAA4C,EAC5C,iDAAiD,EACjD,2CAA2C,EAC3C,+CAA+C,EAC/C,2CAA2C,EAC3C,2CAA2C,EAC3C,0CAA0C,EAC1C,yCAAyC,EACzC,0CAA0C,EAC3C,MAAM,6CAA6C,CAAC"}

package/build/_modules/privacy-lifecycle/index.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_PrivacyRequest_Type = exports.DyNTS_PrivacyRequestState_Type = exports.DyNTS_PrivacyContributorOutcome_Type = exports.DyNTS_PrivacyContributorAction_Type = exports.DyNTS_PrivacyConsentDecision_Type = exports.DyNTS_PrivacyExportArtifact_MongoStore = exports.DyNTS_PrivacyExportArtifact_ControlService = exports.DyNTS_PrivacyLedger_ControlService = exports.DyNTS_PrivacyLifecycle_ControlService = void 0;
+exports.DyNTS_PrivacyRequest_Type = exports.DyNTS_PrivacyRequestState_Type = exports.DyNTS_PrivacyContributorOutcome_Type = exports.DyNTS_PrivacyContributorAction_Type = exports.DyNTS_PrivacyConsentDecision_Type = exports.DyNTS_PrivacyExportArtifact_MongoStore = exports.DyNTS_PrivacyExportArtifact_ControlService = exports.DyNTS_PrivacyLedger_ControlService = exports.DyNTS_PrivacyRequestCursor_ControlService = exports.DyNTS_PrivacyLifecycle_ControlService = void 0;
 var privacy_lifecycle_control_service_1 = require("./privacy-lifecycle.control-service");
 Object.defineProperty(exports, "DyNTS_PrivacyLifecycle_ControlService", { enumerable: true, get: function () { return privacy_lifecycle_control_service_1.DyNTS_PrivacyLifecycle_ControlService; } });
+var privacy_request_cursor_control_service_1 = require("./privacy-request-cursor.control-service");
+Object.defineProperty(exports, "DyNTS_PrivacyRequestCursor_ControlService", { enumerable: true, get: function () { return privacy_request_cursor_control_service_1.DyNTS_PrivacyRequestCursor_ControlService; } });
 var privacy_ledger_control_service_1 = require("./privacy-ledger.control-service");
 Object.defineProperty(exports, "DyNTS_PrivacyLedger_ControlService", { enumerable: true, get: function () { return privacy_ledger_control_service_1.DyNTS_PrivacyLedger_ControlService; } });
 var privacy_export_artifact_control_service_1 = require("./privacy-export-artifact.control-service");

package/build/_modules/privacy-lifecycle/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/privacy-lifecycle/index.ts"],"names":[],"mappings":";;;AAAA,yFAA4F;AAAnF,0JAAA,qCAAqC,OAAA;AAC9C,mFAAsF;AAA7E,oJAAA,kCAAkC,OAAA;AAC3C,qGAAuG;AAA9F,qKAAA,0CAA0C,OAAA;AACnD,6FAA+F;AAAtF,6JAAA,sCAAsC,OAAA;AAC/C,kGAAgG;AAAvF,uJAAA,iCAAiC,OAAA;AAC1C,sGAAoG;AAA3F,2JAAA,mCAAmC,OAAA;AAC5C,wGAAsG;AAA7F,6JAAA,oCAAoC,OAAA;AAC7C,4FAA0F;AAAjF,iJAAA,8BAA8B,OAAA;AACvC,gFAA+E;AAAtE,sIAAA,yBAAyB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/privacy-lifecycle/index.ts"],"names":[],"mappings":";;;AAAA,yFAA4F;AAAnF,0JAAA,qCAAqC,OAAA;AAC9C,mGAAqG;AAA5F,mKAAA,yCAAyC,OAAA;AAClD,mFAAsF;AAA7E,oJAAA,kCAAkC,OAAA;AAC3C,qGAAuG;AAA9F,qKAAA,0CAA0C,OAAA;AACnD,6FAA+F;AAAtF,6JAAA,sCAAsC,OAAA;AAC/C,kGAAgG;AAAvF,uJAAA,iCAAiC,OAAA;AAC1C,sGAAoG;AAA3F,2JAAA,mCAAmC,OAAA;AAC5C,wGAAsG;AAA7F,6JAAA,oCAAoC,OAAA;AAC7C,4FAA0F;AAAjF,iJAAA,8BAA8B,OAAA;AACvC,gFAA+E;AAAtE,sIAAA,yBAAyB,OAAA"}

package/build/_modules/privacy-lifecycle/privacy-request-cursor.control-service.d.ts

@@ -0,0 +1,13 @@
+import { DyNTS_PrivacyRequestCursorValue_Interface } from './_models/privacy-request-cursor-value.interface';
+/** Encodes and strictly decodes content-free privacy request storage cursors. */
+export declare class DyNTS_PrivacyRequestCursor_ControlService {
+    /** Encodes one canonical UTC ordering tuple as an unpadded base64url cursor. */
+    encode(value: DyNTS_PrivacyRequestCursorValue_Interface): string;
+    /** Decodes one canonical cursor and rejects malformed, expanded or non-content-free payloads. */
+    decode(cursor: string): DyNTS_PrivacyRequestCursorValue_Interface;
+    private isValidPayload;
+    private isValidValue;
+    private isCanonicalDate;
+    private error;
+}
+//# sourceMappingURL=privacy-request-cursor.control-service.d.ts.map

package/build/_modules/privacy-lifecycle/privacy-request-cursor.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-request-cursor.control-service.d.ts","sourceRoot":"","sources":["../../../src/_modules/privacy-lifecycle/privacy-request-cursor.control-service.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,yCAAyC,EAC1C,MAAM,kDAAkD,CAAC;AAW1D,iFAAiF;AACjF,qBAAa,yCAAyC;IACpD,gFAAgF;IACzE,MAAM,CAAC,KAAK,EAAE,yCAAyC,GAAG,MAAM;IAcvE,iGAAiG;IAC1F,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,yCAAyC;IAgCxE,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,KAAK;CASd"}

package/build/_modules/privacy-lifecycle/privacy-request-cursor.control-service.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_PrivacyRequestCursor_ControlService = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+const DYNTS_PRIVACY_CURSOR_CONTRACT = 'dynts-privacy-request-cursor/1';
+const DYNTS_PRIVACY_CURSOR_PATTERN = /^[A-Za-z0-9_-]+$/u;
+const DYNTS_PRIVACY_REQUEST_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u;
+/** Encodes and strictly decodes content-free privacy request storage cursors. */
+class DyNTS_PrivacyRequestCursor_ControlService {
+    /** Encodes one canonical UTC ordering tuple as an unpadded base64url cursor. */
+    encode(value) {
+        if (!this.isValidValue(value)) {
+            throw this.error(500, 'CURSOR_VALUE_INVALID', 'The privacy request cursor value is invalid.');
+        }
+        const payload = {
+            contractVersion: DYNTS_PRIVACY_CURSOR_CONTRACT,
+            createdAt: value.createdAt,
+            requestId: value.requestId,
+        };
+        return Buffer.from(JSON.stringify(payload), 'utf8').toString('base64url');
+    }
+    /** Decodes one canonical cursor and rejects malformed, expanded or non-content-free payloads. */
+    decode(cursor) {
+        try {
+            if (typeof cursor !== 'string'
+                || cursor.length < 1
+                || cursor.length > 2048
+                || !DYNTS_PRIVACY_CURSOR_PATTERN.test(cursor)) {
+                throw new Error('Cursor syntax is invalid.');
+            }
+            const decoded = Buffer.from(cursor, 'base64url');
+            if (decoded.toString('base64url') !== cursor) {
+                throw new Error('Cursor encoding is not canonical.');
+            }
+            const payload = JSON.parse(decoded.toString('utf8'));
+            if (!this.isValidPayload(payload)) {
+                throw new Error('Cursor payload is invalid.');
+            }
+            return {
+                createdAt: Reflect.get(payload, 'createdAt'),
+                requestId: Reflect.get(payload, 'requestId'),
+            };
+        }
+        catch {
+            throw this.error(400, 'CURSOR_INVALID', 'The privacy request cursor is invalid.');
+        }
+    }
+    isValidPayload(value) {
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            return false;
+        }
+        const keys = Object.keys(value).sort();
+        const cursorValue = {
+            createdAt: Reflect.get(value, 'createdAt'),
+            requestId: Reflect.get(value, 'requestId'),
+        };
+        return keys.join(',') === 'contractVersion,createdAt,requestId'
+            && Reflect.get(value, 'contractVersion') === DYNTS_PRIVACY_CURSOR_CONTRACT
+            && this.isValidValue(cursorValue);
+    }
+    isValidValue(value) {
+        return typeof value?.createdAt === 'string'
+            && this.isCanonicalDate(value.createdAt)
+            && typeof value.requestId === 'string'
+            && DYNTS_PRIVACY_REQUEST_ID_PATTERN.test(value.requestId);
+    }
+    isCanonicalDate(value) {
+        const timestamp = Date.parse(value);
+        return Number.isFinite(timestamp) && new Date(timestamp).toISOString() === value;
+    }
+    error(status, suffix, message) {
+        return new fsm_dynamo_1.DyFM_Error({
+            status: status,
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|PRIVACY_CURSOR|${suffix}`,
+            message: message,
+            userMessage: status < 500 ? message : 'The privacy request cursor could not be created safely.',
+            issuerService: this.constructor.name,
+        });
+    }
+}
+exports.DyNTS_PrivacyRequestCursor_ControlService = DyNTS_PrivacyRequestCursor_ControlService;
+//# sourceMappingURL=privacy-request-cursor.control-service.js.map

package/build/_modules/privacy-lifecycle/privacy-request-cursor.control-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-request-cursor.control-service.js","sourceRoot":"","sources":["../../../src/_modules/privacy-lifecycle/privacy-request-cursor.control-service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.168",
+  "version": "01.15.173",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",
@@ -231,6 +231,12 @@
       "types": "./build/_modules/privacy-lifecycle/index.d.ts",
       "typings": "./build/_modules/privacy-lifecycle/index.d.ts"
     },
+    "./pagination": {
+      "default": "./build/_modules/pagination/index.js",
+      "module": "./build/_modules/pagination/index.js",
+      "types": "./build/_modules/pagination/index.d.ts",
+      "typings": "./build/_modules/pagination/index.d.ts"
+    },
     "./artifact-compiler": {
       "default": "./build/_modules/artifact-compiler/index.js",
       "module": "./build/_modules/artifact-compiler/index.js",
@@ -369,6 +375,9 @@
       "privacy-lifecycle": [
         "build/_modules/privacy-lifecycle/index.d.ts"
       ],
+      "pagination": [
+        "build/_modules/pagination/index.d.ts"
+      ],
       "artifact-compiler": [
         "build/_modules/artifact-compiler/index.d.ts"
       ],