@mbc-cqrs-serverless/core 1.1.6 → 1.2.1

package/dist/commands/repository.js

@@ -0,0 +1,280 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var Repository_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Repository = void 0;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("../constants");
+const user_1 = require("../context/user");
+const session_service_1 = require("../data-store/session.service");
+const key_1 = require("../helpers/key");
+const transform_1 = require("../helpers/transform");
+const interfaces_1 = require("../interfaces");
+const command_module_definition_1 = require("./command.module-definition");
+const command_service_1 = require("./command.service");
+const data_service_1 = require("./data.service");
+let Repository = Repository_1 = class Repository {
+    constructor(options, dataService, commandService, sessionService) {
+        this.options = options;
+        this.dataService = dataService;
+        this.commandService = commandService;
+        this.sessionService = sessionService;
+        this.logger = new common_1.Logger(Repository_1.name);
+        this.moduleTableName = this.options.tableName;
+    }
+    /**
+     * Get a single data item, merging a pending async command when a session exists.
+     */
+    async getItem(key, options) {
+        const userContext = (0, user_1.getUserContext)(options.invokeContext);
+        const userId = userContext?.userId;
+        const tenantCode = (0, key_1.getTenantCode)(key.pk);
+        if (userId && tenantCode) {
+            const itemId = (0, key_1.generateId)(key.pk, key.sk);
+            const session = await this.sessionService.get(userId, tenantCode, this.moduleTableName, itemId);
+            if (session) {
+                this.logger.debug(`getItem session merge — version ${session.version}`, key);
+                const cmd = await this.commandService.getItem({
+                    pk: key.pk,
+                    sk: (0, key_1.addSortKeyVersion)(key.sk, session.version),
+                });
+                if (cmd) {
+                    const existing = await this.dataService.getItem(key);
+                    return (0, transform_1.transformCommandToData)(cmd, existing);
+                }
+            }
+        }
+        return this.dataService.getItem(key);
+    }
+    /**
+     * List items from the DynamoDB data table with an optional merge of pending async commands.
+     *
+     * When `mergeOptions.latestFlg` is true, the result is augmented with any
+     * pending writes the current user has not yet seen reflected in the data table:
+     *
+     * - **update** — the existing item is replaced in-place, preserving its
+     *   position in the list.
+     * - **delete** — the item is removed from the result.
+     * - **create-new** — the item is prepended to the top of the list, sorted by
+     *   `updatedAt` descending when there are multiple pending creates.
+     *
+     * > **Sort-order note**: Prepended create-new items are not integrated into
+     * > the caller's sort order (e.g. by `name` or `code`). They will appear
+     * > at the top of the result until the async DynamoDB Stream sync completes and
+     * > the next read returns fully sorted data. This is intentional — the
+     * > guarantee is visibility, not sort position.
+     */
+    async listItemsByPk(pk, opts, mergeOptions, options) {
+        const baseResult = await this.dataService.listItemsByPk(pk, opts);
+        if (!mergeOptions?.latestFlg || !options) {
+            return baseResult;
+        }
+        const userContext = (0, user_1.getUserContext)(options.invokeContext);
+        const userId = userContext?.userId;
+        if (!userId)
+            return baseResult;
+        const tenantCode = (0, key_1.getTenantCode)(pk);
+        if (!tenantCode) {
+            return baseResult;
+        }
+        const sessions = await this.sessionService.listByUser(userId, tenantCode, this.moduleTableName);
+        if (!sessions.length)
+            return baseResult;
+        this.logger.debug(`listItemsByPk merge — ${sessions.length} sessions`, {
+            pk,
+        });
+        // Map preserves insertion order for existing items
+        const itemMap = new Map(baseResult.items.map((item) => [item.id, item]));
+        // Separate array to collect newly created items so they can be prepended
+        const newItems = [];
+        const skPrefix = `${this.moduleTableName}${constants_1.KEY_SEPARATOR}`;
+        for (const session of sessions) {
+            if (!session.sk.startsWith(skPrefix)) {
+                continue;
+            }
+            const itemId = session.sk.slice(skPrefix.length);
+            const existing = itemMap.get(itemId);
+            const cmdPk = pk;
+            let skBase;
+            if (existing?.sk) {
+                skBase = (0, key_1.removeSortKeyVersion)(existing.sk);
+            }
+            else {
+                // Since we already know the exact PK from the method parameter,
+                // we can safely extract the skBase without strict 2-segment assumptions.
+                skBase = (0, key_1.sortKeyBaseFromId)(pk, itemId);
+                if (!skBase) {
+                    continue;
+                }
+            }
+            const cmd = await this.commandService.getItem({
+                pk: cmdPk,
+                sk: (0, key_1.addSortKeyVersion)(skBase, session.version),
+            });
+            if (!cmd)
+                continue;
+            const transformed = (0, transform_1.transformCommandToData)(cmd, existing);
+            if (cmd.isDeleted) {
+                // Delete the item from the map
+                itemMap.delete(itemId);
+            }
+            else if (itemMap.has(itemId)) {
+                // Update: preserves the original sort order in the Map
+                itemMap.set(itemId, new interfaces_1.DataEntity(transformed));
+            }
+            else {
+                // Create-new: push to the newItems array
+                newItems.push(new interfaces_1.DataEntity(transformed));
+            }
+        }
+        // Sort newly created items by createdAt descending
+        if (newItems.length > 1) {
+            newItems.sort((a, b) => {
+                const timeA = a.updatedAt ? new Date(a.updatedAt).getTime() : 0;
+                const timeB = b.updatedAt ? new Date(b.updatedAt).getTime() : 0;
+                return timeB - timeA;
+            });
+        }
+        return new interfaces_1.DataListEntity({
+            lastSk: baseResult.lastSk,
+            // Prepend newly created items to the top of the list
+            items: [...newItems, ...itemMap.values()],
+        });
+    }
+    /**
+     * List items from an external source (e.g., RDS/Elasticsearch) with an
+     * optional merge of pending async commands.
+     *
+     * When `mergeOptions.latestFlg` is true, the result is augmented with any
+     * pending writes the current user has not yet seen reflected in the query
+     * source:
+     *
+     * - **update** — the existing item is replaced in-place via `transformCommand`,
+     *   preserving its position. `existing` is passed to the transformer so join
+     *   data (e.g. related RDS rows) can be carried over.
+     * - **delete** — the item is removed and `total` is decremented.
+     * - **create-new** — the item is transformed, optionally filtered by
+     *   `matchesFilter`, and prepended to the top of the result sorted by
+     *   `updatedAt` descending. `total` is incremented.
+     *
+     * > **Sort-order note**: Prepended create-new items are not integrated into
+     * > the caller's sort order (e.g. by `name` or `code`). They will appear
+     * > at the top of the result until the async Stream → RDS sync completes and
+     * > the next read returns fully sorted data. This is intentional — the
+     * > guarantee is visibility, not sort position.
+     *
+     * > **Pagination note**: `total` reflects the adjusted count after merge.
+     * > However, prepended items sit outside the RDS `LIMIT`/`OFFSET` window, so
+     * > on page 2+ the caller may see a one-item overlap or gap until sync
+     * > completes. For most UX patterns (redirect-after-write, optimistic UI)
+     * > this is not noticeable.
+     */
+    async listItems(query, mergeOptions, options) {
+        const baseResult = await query();
+        if (!mergeOptions?.latestFlg || !options) {
+            return baseResult;
+        }
+        const userContext = (0, user_1.getUserContext)(options.invokeContext);
+        const userId = userContext?.userId;
+        if (!userId)
+            return baseResult;
+        const tenantCode = userContext.tenantCode;
+        if (!tenantCode)
+            return baseResult;
+        const sessions = await this.sessionService.listByUser(userId, tenantCode, this.moduleTableName);
+        if (!sessions.length)
+            return baseResult;
+        this.logger.debug(`listItems merge — ${sessions.length} sessions`, {
+            tenantCode,
+        });
+        const itemMap = new Map(baseResult.items.map((item) => [item.id, item]));
+        const newItems = [];
+        let adjustedTotal = baseResult.total;
+        const skPrefix = `${this.moduleTableName}${constants_1.KEY_SEPARATOR}`;
+        for (const session of sessions) {
+            if (!session.sk.startsWith(skPrefix)) {
+                continue;
+            }
+            const itemId = session.sk.slice(skPrefix.length);
+            const existing = itemMap.get(itemId);
+            let cmdPk;
+            let skBase;
+            const existingSk = existing?.sk;
+            const existingPk = existing?.pk;
+            if (existing && existingSk && existingPk) {
+                cmdPk = existingPk;
+                skBase = (0, key_1.removeSortKeyVersion)(existingSk);
+            }
+            else {
+                // Fallback: Strictly parse the ID assuming a 2-segment PK format ({type}#{tenantCode})
+                const parsed = (0, key_1.parseTwoSegmentPkSkFromId)(itemId);
+                if (!parsed) {
+                    continue;
+                }
+                cmdPk = parsed.pk;
+                skBase = parsed.skBase;
+            }
+            if (!cmdPk || !skBase) {
+                continue;
+            }
+            const cmd = await this.commandService.getItem({
+                pk: cmdPk,
+                sk: (0, key_1.addSortKeyVersion)(skBase, session.version),
+            });
+            if (!cmd)
+                continue;
+            const transformed = mergeOptions.transformCommand(cmd, existing);
+            if (cmd.isDeleted) {
+                // Delete the item from the map
+                if (itemMap.has(itemId)) {
+                    itemMap.delete(itemId);
+                    adjustedTotal--;
+                }
+            }
+            else if (itemMap.has(itemId)) {
+                // Update: preserves original position
+                itemMap.set(itemId, transformed);
+            }
+            else {
+                // Create-new: check if it satisfies the current query filters
+                if (!mergeOptions.matchesFilter ||
+                    mergeOptions.matchesFilter(transformed)) {
+                    newItems.push(transformed);
+                    adjustedTotal++;
+                }
+            }
+        }
+        // Sort newly created items by createdAt descending (safely fallback to 0 if field is missing)
+        if (newItems.length > 1) {
+            newItems.sort((a, b) => {
+                const timeA = a.updatedAt ? new Date(a.updatedAt).getTime() : 0;
+                const timeB = b.updatedAt ? new Date(b.updatedAt).getTime() : 0;
+                return timeB - timeA;
+            });
+        }
+        return {
+            total: adjustedTotal,
+            items: [...newItems, ...itemMap.values()],
+        };
+    }
+};
+exports.Repository = Repository;
+exports.Repository = Repository = Repository_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(command_module_definition_1.MODULE_OPTIONS_TOKEN)),
+    __metadata("design:paramtypes", [Object, data_service_1.DataService,
+        command_service_1.CommandService,
+        session_service_1.SessionService])
+], Repository);
+//# sourceMappingURL=repository.js.map

package/dist/commands/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../src/commands/repository.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAA2D;AAE3D,4CAA4C;AAC5C,0CAAgD;AAChD,mEAA8D;AAC9D,wCAOuB;AACvB,oDAA6D;AAC7D,8CAQsB;AACtB,2EAAkE;AAClE,uDAAkD;AAClD,iDAA4C;AAsBrC,IAAM,UAAU,kBAAhB,MAAM,UAAU;IAIrB,YAEE,OAA8C,EAC7B,WAAwB,EACxB,cAA8B,EAC9B,cAA8B;QAH9B,YAAO,GAAP,OAAO,CAAsB;QAC7B,gBAAW,GAAX,WAAW,CAAa;QACxB,mBAAc,GAAd,cAAc,CAAgB;QAC9B,mBAAc,GAAd,cAAc,CAAgB;QARhC,WAAM,GAAG,IAAI,eAAM,CAAC,YAAU,CAAC,IAAI,CAAC,CAAA;QAUnD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAA;IAC/C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,GAAc,EAAE,OAAwB;QACpD,MAAM,WAAW,GAAG,IAAA,qBAAc,EAAC,OAAO,CAAC,aAAa,CAAC,CAAA;QACzD,MAAM,MAAM,GAAG,WAAW,EAAE,MAAM,CAAA;QAClC,MAAM,UAAU,GAAG,IAAA,mBAAa,EAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAExC,IAAI,MAAM,IAAI,UAAU,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,IAAA,gBAAU,EAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;YAEzC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAC3C,MAAM,EACN,UAAU,EACV,IAAI,CAAC,eAAe,EACpB,MAAM,CACP,CAAA;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,mCAAmC,OAAO,CAAC,OAAO,EAAE,EACpD,GAAG,CACJ,CAAA;gBACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;oBAC5C,EAAE,EAAE,GAAG,CAAC,EAAE;oBACV,EAAE,EAAE,IAAA,uBAAiB,EAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC;iBAC/C,CAAC,CAAA;gBAEF,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;oBACpD,OAAO,IAAA,kCAAsB,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;gBAC9C,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACtC,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,aAAa,CACjB,EAAU,EACV,IASC,EACD,YAAsC,EACtC,OAAyB;QAEzB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QAEjE,IAAI,CAAC,YAAY,EAAE,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,OAAO,UAAU,CAAA;QACnB,CAAC;QAED,MAAM,WAAW,GAAG,IAAA,qBAAc,EAAC,OAAO,CAAC,aAAa,CAAC,CAAA;QACzD,MAAM,MAAM,GAAG,WAAW,EAAE,MAAM,CAAA;QAClC,IAAI,CAAC,MAAM;YAAE,OAAO,UAAU,CAAA;QAE9B,MAAM,UAAU,GAAG,IAAA,mBAAa,EAAC,EAAE,CAAC,CAAA;QACpC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,UAAU,CAAA;QACnB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CACnD,MAAM,EACN,UAAU,EACV,IAAI,CAAC,eAAe,CACrB,CAAA;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO,UAAU,CAAA;QAEvC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,QAAQ,CAAC,MAAM,WAAW,EAAE;YACrE,EAAE;SACH,CAAC,CAAA;QAEF,mDAAmD;QACnD,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAChD,CAAA;QAED,yEAAyE;QACzE,MAAM,QAAQ,GAAiB,EAAE,CAAA;QACjC,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,eAAe,GAAG,yBAAa,EAAE,CAAA;QAE1D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrC,SAAQ;YACV,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAEhD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAA0B,CAAA;YAC7D,MAAM,KAAK,GAAG,EAAE,CAAA;YAChB,IAAI,MAA0B,CAAA;YAE9B,IAAI,QAAQ,EAAE,EAAE,EAAE,CAAC;gBACjB,MAAM,GAAG,IAAA,0BAAoB,EAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;YAC5C,CAAC;iBAAM,CAAC;gBACN,gEAAgE;gBAChE,yEAAyE;gBACzE,MAAM,GAAG,IAAA,uBAAiB,EAAC,EAAE,EAAE,MAAM,CAAC,CAAA;gBACtC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,SAAQ;gBACV,CAAC;YACH,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;gBAC5C,EAAE,EAAE,KAAK;gBACT,EAAE,EAAE,IAAA,uBAAiB,EAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;aAC/C,CAAC,CAAA;YACF,IAAI,CAAC,GAAG;gBAAE,SAAQ;YAElB,MAAM,WAAW,GAAG,IAAA,kCAAsB,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YAEzD,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBAClB,+BAA+B;gBAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACxB,CAAC;iBAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,uDAAuD;gBACvD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,uBAAU,CAAC,WAAW,CAAC,CAAC,CAAA;YAClD,CAAC;iBAAM,CAAC;gBACN,yCAAyC;gBACzC,QAAQ,CAAC,IAAI,CAAC,IAAI,uBAAU,CAAC,WAAW,CAAC,CAAC,CAAA;YAC5C,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACrB,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC/D,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC/D,OAAO,KAAK,GAAG,KAAK,CAAA;YACtB,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,IAAI,2BAAc,CAAC;YACxB,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,qDAAqD;YACrD,KAAK,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;SAC1C,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,SAAS,CACb,KAAuD,EACvD,YAAmC,EACnC,OAAyB;QAEzB,MAAM,UAAU,GAAG,MAAM,KAAK,EAAE,CAAA;QAEhC,IAAI,CAAC,YAAY,EAAE,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,OAAO,UAAU,CAAA;QACnB,CAAC;QAED,MAAM,WAAW,GAAG,IAAA,qBAAc,EAAC,OAAO,CAAC,aAAa,CAAC,CAAA;QACzD,MAAM,MAAM,GAAG,WAAW,EAAE,MAAM,CAAA;QAClC,IAAI,CAAC,MAAM;YAAE,OAAO,UAAU,CAAA;QAE9B,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAA;QACzC,IAAI,CAAC,UAAU;YAAE,OAAO,UAAU,CAAA;QAElC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CACnD,MAAM,EACN,UAAU,EACV,IAAI,CAAC,eAAe,CACrB,CAAA;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO,UAAU,CAAA;QAEvC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,WAAW,EAAE;YACjE,UAAU;SACX,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAChD,CAAA;QACD,MAAM,QAAQ,GAAY,EAAE,CAAA;QAC5B,IAAI,aAAa,GAAG,UAAU,CAAC,KAAK,CAAA;QACpC,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,eAAe,GAAG,yBAAa,EAAE,CAAA;QAE1D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrC,SAAQ;YACV,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAEhD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAEpC,IAAI,KAAyB,CAAA;YAC7B,IAAI,MAA0B,CAAA;YAE9B,MAAM,UAAU,GAAI,QAAuC,EAAE,EAAE,CAAA;YAC/D,MAAM,UAAU,GAAI,QAAuC,EAAE,EAAE,CAAA;YAE/D,IAAI,QAAQ,IAAI,UAAU,IAAI,UAAU,EAAE,CAAC;gBACzC,KAAK,GAAG,UAAU,CAAA;gBAClB,MAAM,GAAG,IAAA,0BAAoB,EAAC,UAAU,CAAC,CAAA;YAC3C,CAAC;iBAAM,CAAC;gBACN,uFAAuF;gBACvF,MAAM,MAAM,GAAG,IAAA,+BAAyB,EAAC,MAAM,CAAC,CAAA;gBAChD,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,SAAQ;gBACV,CAAC;gBACD,KAAK,GAAG,MAAM,CAAC,EAAE,CAAA;gBACjB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;YACxB,CAAC;YAED,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;gBACtB,SAAQ;YACV,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;gBAC5C,EAAE,EAAE,KAAK;gBACT,EAAE,EAAE,IAAA,uBAAiB,EAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;aAC/C,CAAC,CAAA;YACF,IAAI,CAAC,GAAG;gBAAE,SAAQ;YAElB,MAAM,WAAW,GAAG,YAAY,CAAC,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YAEhE,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBAClB,+BAA+B;gBAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBACxB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;oBACtB,aAAa,EAAE,CAAA;gBACjB,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,sCAAsC;gBACtC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;YAClC,CAAC;iBAAM,CAAC;gBACN,8DAA8D;gBAC9D,IACE,CAAC,YAAY,CAAC,aAAa;oBAC3B,YAAY,CAAC,aAAa,CAAC,WAAW,CAAC,EACvC,CAAC;oBACD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;oBAC1B,aAAa,EAAE,CAAA;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;QAED,8FAA8F;QAC9F,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,CAAM,EAAE,EAAE;gBAC/B,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC/D,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC/D,OAAO,KAAK,GAAG,KAAK,CAAA;YACtB,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,KAAK,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;SAC1C,CAAA;IACH,CAAC;CACF,CAAA;AA3TY,gCAAU;qBAAV,UAAU;IADtB,IAAA,mBAAU,GAAE;IAMR,WAAA,IAAA,eAAM,EAAC,gDAAoB,CAAC,CAAA;6CAEC,0BAAW;QACR,gCAAc;QACd,gCAAc;GATtC,UAAU,CA2TtB"}

package/dist/data-store/data-store.module.js

@@ -10,14 +10,15 @@ exports.DataStoreModule = void 0;
 const common_1 = require("@nestjs/common");
 const dynamodb_service_1 = require("./dynamodb.service");
 const s3_service_1 = require("./s3.service");
+const session_service_1 = require("./session.service");
 let DataStoreModule = class DataStoreModule {
 };
 exports.DataStoreModule = DataStoreModule;
 exports.DataStoreModule = DataStoreModule = __decorate([
     (0, common_1.Global)(),
     (0, common_1.Module)({
-        providers: [dynamodb_service_1.DynamoDbService, s3_service_1.S3Service],
-        exports: [dynamodb_service_1.DynamoDbService, s3_service_1.S3Service],
+        providers: [dynamodb_service_1.DynamoDbService, s3_service_1.S3Service, session_service_1.SessionService],
+        exports: [dynamodb_service_1.DynamoDbService, s3_service_1.S3Service, session_service_1.SessionService],
     })
 ], DataStoreModule);
 //# sourceMappingURL=data-store.module.js.map

package/dist/data-store/data-store.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-store.module.js","sourceRoot":"","sources":["../../src/data-store/data-store.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA+C;AAE/C,yDAAoD;AACpD,6CAAwC;AAOjC,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IAL3B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,kCAAe,EAAE,sBAAS,CAAC;QACvC,OAAO,EAAE,CAAC,kCAAe,EAAE,sBAAS,CAAC;KACtC,CAAC;GACW,eAAe,CAAG"}
+{"version":3,"file":"data-store.module.js","sourceRoot":"","sources":["../../src/data-store/data-store.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA+C;AAE/C,yDAAoD;AACpD,6CAAwC;AACxC,uDAAkD;AAO3C,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IAL3B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,kCAAe,EAAE,sBAAS,EAAE,gCAAc,CAAC;QACvD,OAAO,EAAE,CAAC,kCAAe,EAAE,sBAAS,EAAE,gCAAc,CAAC;KACtD,CAAC;GACW,eAAe,CAAG"}

package/dist/data-store/index.d.ts

@@ -1,3 +1,5 @@
 export * from './data-store.module';
 export * from './dynamodb.service';
 export * from './s3.service';
+export * from './session.interface';
+export * from './session.service';

package/dist/data-store/index.js

@@ -17,4 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./data-store.module"), exports);
 __exportStar(require("./dynamodb.service"), exports);
 __exportStar(require("./s3.service"), exports);
+__exportStar(require("./session.interface"), exports);
+__exportStar(require("./session.service"), exports);
 //# sourceMappingURL=index.js.map

package/dist/data-store/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data-store/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAmC;AACnC,qDAAkC;AAClC,+CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data-store/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAmC;AACnC,qDAAkC;AAClC,+CAA4B;AAC5B,sDAAmC;AACnC,oDAAiC"}

package/dist/data-store/session.interface.d.ts

@@ -0,0 +1,10 @@
+export interface SessionItem {
+    /** pk: {userId}#{tenantCode} */
+    pk: string;
+    /** sk: {moduleTableName}#{itemId} — module `tableName` from CommandModule */
+    sk: string;
+    /** Version of the command — used to fetch exact command record */
+    version: number;
+    /** Unix timestamp TTL — auto-expired by DynamoDB */
+    ttl: number;
+}

package/dist/data-store/session.interface.js

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

package/dist/data-store/session.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.interface.js","sourceRoot":"","sources":["../../src/data-store/session.interface.ts"],"names":[],"mappings":""}

package/dist/data-store/session.service.d.ts

@@ -0,0 +1,52 @@
+import { ConfigService } from '@nestjs/config';
+import { DynamoDbService } from './dynamodb.service';
+import { SessionItem } from './session.interface';
+export declare class SessionService {
+    private readonly dynamoDbService;
+    private readonly config;
+    private readonly logger;
+    private readonly sessionTableName;
+    private readonly ttlSeconds;
+    /** When unset or invalid, session rows are not written (RYW read path still works on empty). */
+    private readonly sessionWritesEnabled;
+    constructor(dynamoDbService: DynamoDbService, config: ConfigService);
+    /**
+     * Build session pk: {userId}#{tenantCode}
+     */
+    private buildPk;
+    /**
+     * Build session sk: {moduleTableName}#{itemId}
+     */
+    private buildSk;
+    private calculateTtl;
+    /**
+     * Write a session entry after a successful async command publish.
+     * Called by CommandService after publishAsync only.
+     * No-ops when RYW session TTL is not configured (`sessionWritesEnabled` is false).
+     */
+    put(userId: string, tenantCode: string, moduleTableName: string, itemId: string, version: number): Promise<void>;
+    /**
+     * Get a single session entry for a specific item.
+     * Returns `null` without querying DynamoDB when session writes are disabled.
+     */
+    get(userId: string, tenantCode: string, moduleTableName: string, itemId: string): Promise<SessionItem | null>;
+    /**
+     * List session entries for a user scoped to a command module.
+     *
+     * Queries the session table by `{userId}#{tenantCode}` and filters to entries
+     * whose sort key begins with `{moduleTableName}#`, returning only sessions
+     * that belong to the given module.
+     *
+     * @param userId - The ID of the requesting user (from JWT `sub` claim).
+     * @param tenantCode - The tenant the user is operating under.
+     * @param moduleTableName - The `tableName` from `CommandModuleOptions` — used
+     *   as the sort key prefix to scope results to a single command module.
+     * @param limit - Maximum number of session entries to fetch. Defaults to
+     *   `MAX_SESSION_ENTRIES` to prevent silent truncation from the underlying
+     *   DynamoDB query's default limit of 10. Callers should rarely need to
+     *   override this.
+     * @returns The matching session entries, or an empty array if none exist or
+     *   session writes are disabled.
+     */
+    listByUser(userId: string, tenantCode: string, moduleTableName: string, limit?: number): Promise<SessionItem[]>;
+}

package/dist/data-store/session.service.js

@@ -0,0 +1,128 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var SessionService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionService = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const constants_1 = require("../constants");
+const dynamodb_service_1 = require("./dynamodb.service");
+/**
+ * Upper-bound for session entries fetched per user/module in a single query.
+ * Sessions are short-lived (RYW_SESSION_TTL_MINUTES) so this stays cheap.
+ * Prevents silent truncation from DynamoDbService's default limit of 10.
+ */
+const MAX_SESSION_ENTRIES = 1000;
+const SESSION_TABLE_SUFFIX = 'session';
+let SessionService = SessionService_1 = class SessionService {
+    constructor(dynamoDbService, config) {
+        this.dynamoDbService = dynamoDbService;
+        this.config = config;
+        this.logger = new common_1.Logger(SessionService_1.name);
+        const nodeEnv = this.config.get('NODE_ENV');
+        const appName = this.config.get('APP_NAME');
+        this.sessionTableName = `${nodeEnv}-${appName}-${SESSION_TABLE_SUFFIX}`;
+        const ttlMinutes = Number(this.config.get('RYW_SESSION_TTL_MINUTES'));
+        this.sessionWritesEnabled = !Number.isNaN(ttlMinutes) && ttlMinutes > 0;
+        this.ttlSeconds = this.sessionWritesEnabled ? ttlMinutes * 60 : 0;
+        if (this.sessionWritesEnabled) {
+            this.logger.log(`Session table: ${this.sessionTableName}, RYW TTL: ${ttlMinutes}m`);
+        }
+        else {
+            this.logger.log(`Session table: ${this.sessionTableName}, RYW session writes disabled (set RYW_SESSION_TTL_MINUTES to a positive number to enable)`);
+        }
+    }
+    /**
+     * Build session pk: {userId}#{tenantCode}
+     */
+    buildPk(userId, tenantCode) {
+        return `${userId}${constants_1.KEY_SEPARATOR}${tenantCode}`;
+    }
+    /**
+     * Build session sk: {moduleTableName}#{itemId}
+     */
+    buildSk(moduleTableName, itemId) {
+        return `${moduleTableName}${constants_1.KEY_SEPARATOR}${itemId}`;
+    }
+    calculateTtl() {
+        return Math.floor(Date.now() / 1000) + this.ttlSeconds;
+    }
+    /**
+     * Write a session entry after a successful async command publish.
+     * Called by CommandService after publishAsync only.
+     * No-ops when RYW session TTL is not configured (`sessionWritesEnabled` is false).
+     */
+    async put(userId, tenantCode, moduleTableName, itemId, version) {
+        if (!this.sessionWritesEnabled) {
+            this.logger.debug('session put skipped: RYW_SESSION_TTL_MINUTES not enabled');
+            return;
+        }
+        const item = {
+            pk: this.buildPk(userId, tenantCode),
+            sk: this.buildSk(moduleTableName, itemId),
+            version,
+            ttl: this.calculateTtl(),
+        };
+        this.logger.debug('session put::', item);
+        await this.dynamoDbService.putItem(this.sessionTableName, item);
+    }
+    /**
+     * Get a single session entry for a specific item.
+     * Returns `null` without querying DynamoDB when session writes are disabled.
+     */
+    async get(userId, tenantCode, moduleTableName, itemId) {
+        if (!this.sessionWritesEnabled) {
+            return null;
+        }
+        const result = await this.dynamoDbService.getItem(this.sessionTableName, {
+            pk: this.buildPk(userId, tenantCode),
+            sk: this.buildSk(moduleTableName, itemId),
+        });
+        return result ?? null;
+    }
+    /**
+     * List session entries for a user scoped to a command module.
+     *
+     * Queries the session table by `{userId}#{tenantCode}` and filters to entries
+     * whose sort key begins with `{moduleTableName}#`, returning only sessions
+     * that belong to the given module.
+     *
+     * @param userId - The ID of the requesting user (from JWT `sub` claim).
+     * @param tenantCode - The tenant the user is operating under.
+     * @param moduleTableName - The `tableName` from `CommandModuleOptions` — used
+     *   as the sort key prefix to scope results to a single command module.
+     * @param limit - Maximum number of session entries to fetch. Defaults to
+     *   `MAX_SESSION_ENTRIES` to prevent silent truncation from the underlying
+     *   DynamoDB query's default limit of 10. Callers should rarely need to
+     *   override this.
+     * @returns The matching session entries, or an empty array if none exist or
+     *   session writes are disabled.
+     */
+    async listByUser(userId, tenantCode, moduleTableName, limit = MAX_SESSION_ENTRIES) {
+        if (!this.sessionWritesEnabled) {
+            return [];
+        }
+        const pk = this.buildPk(userId, tenantCode);
+        const skPrefix = `${moduleTableName}${constants_1.KEY_SEPARATOR}`;
+        const result = await this.dynamoDbService.listItemsByPk(this.sessionTableName, pk, {
+            skExpression: 'begins_with(sk, :skPrefix)',
+            skAttributeValues: { ':skPrefix': skPrefix },
+        }, undefined, limit);
+        return result?.items ?? [];
+    }
+};
+exports.SessionService = SessionService;
+exports.SessionService = SessionService = SessionService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [dynamodb_service_1.DynamoDbService,
+        config_1.ConfigService])
+], SessionService);
+//# sourceMappingURL=session.service.js.map

package/dist/data-store/session.service.js.map

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

package/dist/env.validation.d.ts

@@ -27,5 +27,6 @@ export declare class EnvironmentVariables {
     SES_REGION: string;
     SES_FROM_EMAIL: string;
     REQUEST_BODY_SIZE_LIMIT: string;
+    RYW_SESSION_TTL_MINUTES: number;
 }
 export declare function getValidateConfig<T extends EnvironmentVariables>(cls?: ClassConstructor<T>): (config: Record<string, unknown>) => EnvironmentVariables;

package/dist/env.validation.js

@@ -120,6 +120,11 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", String)
 ], EnvironmentVariables.prototype, "REQUEST_BODY_SIZE_LIMIT", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Number)
+], EnvironmentVariables.prototype, "RYW_SESSION_TTL_MINUTES", void 0);
 function getValidateConfig(cls) {
     return function validate(config) {
         const validatedConfig = (0, class_transformer_1.plainToInstance)(cls || EnvironmentVariables, config, {

package/dist/env.validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.validation.js","sourceRoot":"","sources":["../src/env.validation.ts"],"names":[],"mappings":";;;;;;;;;;;;AAqFA,8CAoBC;AAzGD,yDAAqE;AACrE,qDAQwB;AAExB,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;AACjB,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB;AAED,MAAa,oBAAoB;CAiEhC;AAjED,oDAiEC;AA/DC;IADC,IAAA,wBAAM,EAAC,WAAW,CAAC;;sDACC;AAErB;IADC,IAAA,0BAAQ,GAAE;;sDACK;AAIhB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;sDACG;AAGhB;IADC,IAAA,2BAAS,GAAE;;mEACkB;AAG9B;IADC,IAAA,0BAAQ,GAAE;;uDACM;AAIjB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;+DACY;AAGzB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;6DACY;AAEvB;IADC,IAAA,4BAAU,GAAE;;kEACe;AAG5B;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;yDACM;AAGnB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;uDACI;AAEjB;IADC,IAAA,0BAAQ,GAAE;;4DACW;AAItB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;0DACO;AAGpB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;wDACK;AAElB;IADC,IAAA,0BAAQ,GAAE;;6DACY;AAIvB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;0DACO;AAGpB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;wDACK;AAIlB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;8DACW;AAIxB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;0DACO;AAGpB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;wDACK;AAElB;IADC,IAAA,0BAAQ,GAAE;;4DACW;AAItB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;qEACkB;AAGjC,SAAgB,iBAAiB,CAC/B,GAAyB;IAEzB,OAAO,SAAS,QAAQ,CAAC,MAA+B;QACtD,MAAM,eAAe,GAAG,IAAA,mCAAe,EACrC,GAAG,IAAI,oBAAoB,EAC3B,MAAM,EACN;YACE,wBAAwB,EAAE,IAAI;SAC/B,CACF,CAAA;QACD,MAAM,MAAM,GAAG,IAAA,8BAAY,EAAC,eAAe,EAAE;YAC3C,qBAAqB,EAAE,KAAK;SAC7B,CAAC,CAAA;QAEF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;QACpC,CAAC;QACD,OAAO,eAAe,CAAA;IACxB,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"env.validation.js","sourceRoot":"","sources":["../src/env.validation.ts"],"names":[],"mappings":";;;;;;;;;;;;AAyFA,8CAoBC;AA7GD,yDAAqE;AACrE,qDAQwB;AAExB,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;AACjB,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB;AAED,MAAa,oBAAoB;CAqEhC;AArED,oDAqEC;AAnEC;IADC,IAAA,wBAAM,EAAC,WAAW,CAAC;;sDACC;AAErB;IADC,IAAA,0BAAQ,GAAE;;sDACK;AAIhB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;sDACG;AAGhB;IADC,IAAA,2BAAS,GAAE;;mEACkB;AAG9B;IADC,IAAA,0BAAQ,GAAE;;uDACM;AAIjB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;+DACY;AAGzB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;6DACY;AAEvB;IADC,IAAA,4BAAU,GAAE;;kEACe;AAG5B;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;yDACM;AAGnB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;uDACI;AAEjB;IADC,IAAA,0BAAQ,GAAE;;4DACW;AAItB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;0DACO;AAGpB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;wDACK;AAElB;IADC,IAAA,0BAAQ,GAAE;;6DACY;AAIvB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;0DACO;AAGpB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;wDACK;AAIlB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;8DACW;AAIxB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;0DACO;AAGpB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;wDACK;AAElB;IADC,IAAA,0BAAQ,GAAE;;4DACW;AAItB;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;qEACkB;AAI/B;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;qEACkB;AAGjC,SAAgB,iBAAiB,CAC/B,GAAyB;IAEzB,OAAO,SAAS,QAAQ,CAAC,MAA+B;QACtD,MAAM,eAAe,GAAG,IAAA,mCAAe,EACrC,GAAG,IAAI,oBAAoB,EAC3B,MAAM,EACN;YACE,wBAAwB,EAAE,IAAI;SAC/B,CACF,CAAA;QACD,MAAM,MAAM,GAAG,IAAA,8BAAY,EAAC,eAAe,EAAE;YAC3C,qBAAqB,EAAE,KAAK;SAC7B,CAAC,CAAA;QAEF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;QACpC,CAAC;QACD,OAAO,eAAe,CAAA;IACxB,CAAC,CAAA;AACH,CAAC"}

package/dist/helpers/index.d.ts

@@ -4,5 +4,6 @@ export * from './key';
 export * from './object';
 export * from './serializer';
 export * from './source';
+export * from './transform';
 export { deserializeToInternal, serializeToExternal } from './serializer';
 export declare const IS_LAMBDA_RUNNING: boolean;

package/dist/helpers/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./key"), exports);
 __exportStar(require("./object"), exports);
 __exportStar(require("./serializer"), exports);
 __exportStar(require("./source"), exports);
+__exportStar(require("./transform"), exports);
 // Re-export serialization helpers for convenience
 var serializer_1 = require("./serializer");
 Object.defineProperty(exports, "deserializeToInternal", { enumerable: true, get: function () { return serializer_1.deserializeToInternal; } });

package/dist/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAA0B;AAC1B,+CAA4B;AAC5B,wCAAqB;AACrB,2CAAwB;AACxB,+CAA4B;AAC5B,2CAAwB;AAExB,kDAAkD;AAClD,2CAAyE;AAAhE,mHAAA,qBAAqB,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAEtC,QAAA,iBAAiB,GAC5B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB;IACtC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B;IACzC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAA0B;AAC1B,+CAA4B;AAC5B,wCAAqB;AACrB,2CAAwB;AACxB,+CAA4B;AAC5B,2CAAwB;AACxB,8CAA2B;AAE3B,kDAAkD;AAClD,2CAAyE;AAAhE,mHAAA,qBAAqB,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAEtC,QAAA,iBAAiB,GAC5B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB;IACtC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B;IACzC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAA"}

package/dist/helpers/key.d.ts

@@ -2,6 +2,19 @@ export declare function addSortKeyVersion(sk: string, version: number): string;
 export declare function getSortKeyVersion(sk: string): number;
 export declare function removeSortKeyVersion(sk: string): string;
 export declare function generateId(pk: string, sk: string): string;
+/**
+ * Inverse of {@link generateId}: extracts the base sort key from a composite id (`pk#skBase`).
+ */
+export declare function sortKeyBaseFromId(pk: string, itemId: string): string | undefined;
+/**
+ * Parses a composite {@link generateId} when partition key is always
+ * `{type}#{tenantCode}` (exactly two `#`-separated segments). The remainder of
+ * `itemId` after that prefix is `skBase` (may contain `#`).
+ */
+export declare function parseTwoSegmentPkSkFromId(itemId: string): {
+    pk: string;
+    skBase: string;
+} | undefined;
 export declare function getTenantCode(pk: string): string;
 export declare function isS3AttributeKey(attributes: any): boolean;
 export declare function toS3AttributeKey(bucket: string, key: string): string;