@futdevpro/nts-dynamo 1.15.465 → 1.15.466

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

@@ -8,4 +8,13 @@ export * from './_services/msg-events.service';
 export * from './_services/msg-main.control-service';
 export * from './_services/msg-message.data-service';
 export * from './_services/msg.controller';
+export * from './input-draft/msg-input-draft.data-model';
+export * from './input-draft/msg-input-draft-settings.interface';
+export * from './input-draft/msg-input-draft-default-settings.const';
+export * from './input-draft/msg-input-draft-save-result.interface';
+export * from './input-draft/msg-input-draft.util';
+export * from './input-draft/msg-input-draft.data-service';
+export * from './input-draft/msg-input-draft.controller';
+export * from './input-draft/msg-input-draft-routing.util';
+export * from './input-draft/msg-input-draft-call.interface';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/messaging/index.ts"],"names":[],"mappings":"AASA,cAAc,iCAAiC,CAAC;AAGhD,cAAc,yCAAyC,CAAC;AAGxD,cAAc,kDAAkD,CAAC;AACjE,cAAc,0CAA0C,CAAC;AACzD,cAAc,yBAAyB,CAAC;AAMxC,cAAc,2CAA2C,CAAC;AAC1D,cAAc,gCAAgC,CAAC;AAE/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/messaging/index.ts"],"names":[],"mappings":"AASA,cAAc,iCAAiC,CAAC;AAGhD,cAAc,yCAAyC,CAAC;AAGxD,cAAc,kDAAkD,CAAC;AACjE,cAAc,0CAA0C,CAAC;AACzD,cAAc,yBAAyB,CAAC;AAMxC,cAAc,2CAA2C,CAAC;AAC1D,cAAc,gCAAgC,CAAC;AAE/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAG3C,cAAc,0CAA0C,CAAC;AACzD,cAAc,kDAAkD,CAAC;AACjE,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,0CAA0C,CAAC;AACzD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,8CAA8C,CAAC"}

package/build/_modules/messaging/index.js

@@ -25,4 +25,14 @@ tslib_1.__exportStar(require("./_services/msg-events.service"), exports);
 tslib_1.__exportStar(require("./_services/msg-main.control-service"), exports);
 tslib_1.__exportStar(require("./_services/msg-message.data-service"), exports);
 tslib_1.__exportStar(require("./_services/msg.controller"), exports);
+// INPUT DRAFT (BFR-CCAPREVISIONED-030 part 2)
+tslib_1.__exportStar(require("./input-draft/msg-input-draft.data-model"), exports);
+tslib_1.__exportStar(require("./input-draft/msg-input-draft-settings.interface"), exports);
+tslib_1.__exportStar(require("./input-draft/msg-input-draft-default-settings.const"), exports);
+tslib_1.__exportStar(require("./input-draft/msg-input-draft-save-result.interface"), exports);
+tslib_1.__exportStar(require("./input-draft/msg-input-draft.util"), exports);
+tslib_1.__exportStar(require("./input-draft/msg-input-draft.data-service"), exports);
+tslib_1.__exportStar(require("./input-draft/msg-input-draft.controller"), exports);
+tslib_1.__exportStar(require("./input-draft/msg-input-draft-routing.util"), exports);
+tslib_1.__exportStar(require("./input-draft/msg-input-draft-call.interface"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/messaging/index.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,mBAAmB;AACnB,EAAE;AACF,mEAAmE;AACnE,4CAA4C;AAC5C,wCAAwC;AACxC,EAAE;;;AAEF,uBAAuB;AACvB,0EAAgD;AAEhD,SAAS;AACT,kFAAwD;AAExD,cAAc;AACd,2FAAiE;AACjE,mFAAyD;AACzD,kEAAwC;AAExC,QAAQ;AACR,2DAA2D;AAE3D,WAAW;AACX,oFAA0D;AAC1D,yEAA+C;AAC/C,kEAAkE;AAClE,+EAAqD;AACrD,+EAAqD;AACrD,qEAA2C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/messaging/index.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,mBAAmB;AACnB,EAAE;AACF,mEAAmE;AACnE,4CAA4C;AAC5C,wCAAwC;AACxC,EAAE;;;AAEF,uBAAuB;AACvB,0EAAgD;AAEhD,SAAS;AACT,kFAAwD;AAExD,cAAc;AACd,2FAAiE;AACjE,mFAAyD;AACzD,kEAAwC;AAExC,QAAQ;AACR,2DAA2D;AAE3D,WAAW;AACX,oFAA0D;AAC1D,yEAA+C;AAC/C,kEAAkE;AAClE,+EAAqD;AACrD,+EAAqD;AACrD,qEAA2C;AAE3C,8CAA8C;AAC9C,mFAAyD;AACzD,2FAAiE;AACjE,+FAAqE;AACrE,8FAAoE;AACpE,6EAAmD;AACnD,qFAA2D;AAC3D,mFAAyD;AACzD,qFAA2D;AAC3D,uFAA6D"}

package/build/_modules/messaging/input-draft/msg-input-draft-call.interface.d.ts

@@ -0,0 +1,13 @@
+import { Request, Response } from 'express';
+/**
+ * BFR-CCAPREVISIONED-030 part 2 - one endpoint call, as the input-draft handlers get it.
+ */
+export interface DyNTS_Msg_InputDraft_Call_Interface {
+    /** The incoming request. */
+    req: Request;
+    /** The answer. */
+    res: Response;
+    /** The issuer the endpoint resolved (for the logs; the OWNER comes from the auth service). */
+    issuer: string;
+}
+//# sourceMappingURL=msg-input-draft-call.interface.d.ts.map

package/build/_modules/messaging/input-draft/msg-input-draft-call.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft-call.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft-call.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,4BAA4B;IAC5B,GAAG,EAAE,OAAO,CAAC;IACb,kBAAkB;IAClB,GAAG,EAAE,QAAQ,CAAC;IACd,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/build/_modules/messaging/input-draft/msg-input-draft-call.interface.js

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

package/build/_modules/messaging/input-draft/msg-input-draft-call.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft-call.interface.js","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft-call.interface.ts"],"names":[],"mappings":""}

package/build/_modules/messaging/input-draft/msg-input-draft-default-settings.const.d.ts

@@ -0,0 +1,6 @@
+import { DyNTS_Msg_InputDraft_Settings_Interface } from './msg-input-draft-settings.interface';
+/**
+ * BFR-CCAPREVISIONED-030 part 2 - the input-draft defaults: a draft lives 30 days after its last save.
+ */
+export declare const DyNTS_msgInputDraft_defaultSettings: Required<DyNTS_Msg_InputDraft_Settings_Interface>;
+//# sourceMappingURL=msg-input-draft-default-settings.const.d.ts.map

package/build/_modules/messaging/input-draft/msg-input-draft-default-settings.const.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft-default-settings.const.d.ts","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft-default-settings.const.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uCAAuC,EAAE,MAAM,sCAAsC,CAAC;AAE/F;;GAEG;AACH,eAAO,MAAM,mCAAmC,EAAE,QAAQ,CAAC,uCAAuC,CAOjG,CAAC"}

package/build/_modules/messaging/input-draft/msg-input-draft-default-settings.const.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_msgInputDraft_defaultSettings = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * BFR-CCAPREVISIONED-030 part 2 - the input-draft defaults: a draft lives 30 days after its last save.
+ */
+exports.DyNTS_msgInputDraft_defaultSettings = {
+    route: '/input-draft',
+    preProcesses: [],
+    maxAgeMs: 30 * fsm_dynamo_1.day,
+    maxContentLength: 100000,
+    maxFieldKeyLength: 200,
+    maxListCount: 500,
+};
+//# sourceMappingURL=msg-input-draft-default-settings.const.js.map

package/build/_modules/messaging/input-draft/msg-input-draft-default-settings.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft-default-settings.const.js","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft-default-settings.const.ts"],"names":[],"mappings":";;;AAAA,sDAA4C;AAI5C;;GAEG;AACU,QAAA,mCAAmC,GAAsD;IACpG,KAAK,EAAE,cAAc;IACrB,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,EAAE,GAAG,gBAAG;IAClB,gBAAgB,EAAE,MAAM;IACxB,iBAAiB,EAAE,GAAG;IACtB,YAAY,EAAE,GAAG;CAClB,CAAC"}

package/build/_modules/messaging/input-draft/msg-input-draft-routing.util.d.ts

@@ -0,0 +1,22 @@
+import { DyNTS_RoutingModule } from '../../../_services/route/routing-module.service';
+import { DyNTS_Msg_InputDraft_Settings_Interface } from './msg-input-draft-settings.interface';
+/**
+ * BFR-CCAPREVISIONED-030 part 2 - the input-draft routing module (`/input-draft/save | get | list | clear`): the
+ * unsent text of an input field, per account and field key, so it comes back in another browser too.
+ *
+ * Needs the app's auth service on `DyNTS_GlobalService` (the owner is the authenticated issuer) and the
+ * `DyNTS_msgInputDraft_dataParams` collection among the app's db models.
+ *
+ * @example
+ * ```ts
+ * DyNTS_Msg_InputDraftRouting_Util.getRoutingModule({
+ *   preProcesses: [ authService.authenticate_tokenSelf ],
+ *   maxAgeMs: 14 * day,
+ * })
+ * ```
+ */
+export declare class DyNTS_Msg_InputDraftRouting_Util {
+    /** The routing module with the given settings (the defaults for the missing ones). */
+    static getRoutingModule(settings?: DyNTS_Msg_InputDraft_Settings_Interface): DyNTS_RoutingModule;
+}
+//# sourceMappingURL=msg-input-draft-routing.util.d.ts.map

package/build/_modules/messaging/input-draft/msg-input-draft-routing.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft-routing.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft-routing.util.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAEtF,OAAO,EAAE,uCAAuC,EAAE,MAAM,sCAAsC,CAAC;AAG/F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gCAAgC;IAC3C,sFAAsF;IACtF,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,uCAAuC,GAAG,mBAAmB;CAUjG"}

package/build/_modules/messaging/input-draft/msg-input-draft-routing.util.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Msg_InputDraftRouting_Util = void 0;
+const routing_module_service_1 = require("../../../_services/route/routing-module.service");
+const msg_input_draft_controller_1 = require("./msg-input-draft.controller");
+const msg_input_draft_util_1 = require("./msg-input-draft.util");
+/**
+ * BFR-CCAPREVISIONED-030 part 2 - the input-draft routing module (`/input-draft/save | get | list | clear`): the
+ * unsent text of an input field, per account and field key, so it comes back in another browser too.
+ *
+ * Needs the app's auth service on `DyNTS_GlobalService` (the owner is the authenticated issuer) and the
+ * `DyNTS_msgInputDraft_dataParams` collection among the app's db models.
+ *
+ * @example
+ * ```ts
+ * DyNTS_Msg_InputDraftRouting_Util.getRoutingModule({
+ *   preProcesses: [ authService.authenticate_tokenSelf ],
+ *   maxAgeMs: 14 * day,
+ * })
+ * ```
+ */
+class DyNTS_Msg_InputDraftRouting_Util {
+    /** The routing module with the given settings (the defaults for the missing ones). */
+    static getRoutingModule(settings) {
+        msg_input_draft_controller_1.DyNTS_Msg_InputDraft_Controller.configure(settings);
+        const set = {
+            route: msg_input_draft_util_1.DyNTS_Msg_InputDraft_Util.resolve(settings).route,
+            controllers: [msg_input_draft_controller_1.DyNTS_Msg_InputDraft_Controller.getInstance()],
+        };
+        return new routing_module_service_1.DyNTS_RoutingModule(set);
+    }
+}
+exports.DyNTS_Msg_InputDraftRouting_Util = DyNTS_Msg_InputDraftRouting_Util;
+//# sourceMappingURL=msg-input-draft-routing.util.js.map

package/build/_modules/messaging/input-draft/msg-input-draft-routing.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft-routing.util.js","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft-routing.util.ts"],"names":[],"mappings":";;;AACA,4FAAsF;AACtF,6EAA+E;AAE/E,iEAAmE;AAEnE;;;;;;;;;;;;;;GAcG;AACH,MAAa,gCAAgC;IAC3C,sFAAsF;IACtF,MAAM,CAAC,gBAAgB,CAAC,QAAkD;QACxE,4DAA+B,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEpD,MAAM,GAAG,GAAiC;YACxC,KAAK,EAAE,gDAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK;YACxD,WAAW,EAAE,CAAE,4DAA+B,CAAC,WAAW,EAAE,CAAE;SAC/D,CAAC;QAEF,OAAO,IAAI,4CAAmB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;CACF;AAZD,4EAYC"}

package/build/_modules/messaging/input-draft/msg-input-draft-save-result.interface.d.ts

@@ -0,0 +1,15 @@
+/**
+ * BFR-CCAPREVISIONED-030 part 2 - the answer of a draft save. A failed STORE answers `saved: false` with 200 (the save
+ * is best-effort: it must never stop the typing or the sending), and says why in `error`.
+ */
+export interface DyNTS_Msg_InputDraft_SaveResult_Interface {
+    /** Whether the server copy was written. */
+    saved: boolean;
+    /** The stored revision (when saved). */
+    revision?: number;
+    /** The stored save time (when saved). */
+    savedAt?: Date;
+    /** Why it was not saved (the user-facing text, no technical detail). */
+    error?: string;
+}
+//# sourceMappingURL=msg-input-draft-save-result.interface.d.ts.map

package/build/_modules/messaging/input-draft/msg-input-draft-save-result.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft-save-result.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft-save-result.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,yCAAyC;IACxD,2CAA2C;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/build/_modules/messaging/input-draft/msg-input-draft-save-result.interface.js

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

package/build/_modules/messaging/input-draft/msg-input-draft-save-result.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft-save-result.interface.js","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft-save-result.interface.ts"],"names":[],"mappings":""}

package/build/_modules/messaging/input-draft/msg-input-draft-settings.interface.d.ts

@@ -0,0 +1,20 @@
+import { Request, Response } from 'express';
+/**
+ * BFR-CCAPREVISIONED-030 part 2 - the input-draft endpoints' settings (every field optional, the defaults are
+ * `DyNTS_msgInputDraft_defaultSettings`).
+ */
+export interface DyNTS_Msg_InputDraft_Settings_Interface {
+    /** The routing module's route (default `/input-draft`). */
+    route?: string;
+    /** Run before every endpoint (e.g. the app's token check); the owner is then the authenticated issuer. */
+    preProcesses?: ((req: Request, res: Response) => Promise<void>)[];
+    /** A draft older than this is not given back any more (default 30 days); the next save reuses its record. */
+    maxAgeMs?: number;
+    /** The longest accepted text (default 100 000 characters); a longer one is refused with 400, not cut. */
+    maxContentLength?: number;
+    /** The longest accepted field key (default 200 characters). */
+    maxFieldKeyLength?: number;
+    /** How many drafts the list gives back at most, newest first (default 500). */
+    maxListCount?: number;
+}
+//# sourceMappingURL=msg-input-draft-settings.interface.d.ts.map

package/build/_modules/messaging/input-draft/msg-input-draft-settings.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft-settings.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft-settings.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,uCAAuC;IACtD,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0GAA0G;IAC1G,YAAY,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;IAClE,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yGAAyG;IACzG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/build/_modules/messaging/input-draft/msg-input-draft-settings.interface.js

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

package/build/_modules/messaging/input-draft/msg-input-draft-settings.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft-settings.interface.js","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft-settings.interface.ts"],"names":[],"mappings":""}

package/build/_modules/messaging/input-draft/msg-input-draft.controller.d.ts

@@ -0,0 +1,46 @@
+import { DyNTS_Controller } from '../../../_services/route/controller.service';
+import { DyNTS_Msg_InputDraft_Settings_Interface } from './msg-input-draft-settings.interface';
+/**
+ * BFR-CCAPREVISIONED-030 part 2 - the input-draft endpoints (mounted by `DyNTS_Msg_InputDraftRouting_Util`):
+ *
+ * | method | path | body / query | answer |
+ * |---|---|---|---|
+ * | PUT | `/save` | `{ fieldKey, content, savedByBrowserId? }` | `{ saved, revision?, savedAt?, error? }` |
+ * | GET | `/get` | `?fieldKey=` | `{ draft }` (`null` when none / expired) |
+ * | GET | `/list` | - | `{ drafts, count }` (newest first) |
+ * | DELETE | `/clear` | `?fieldKey=` | `{ cleared }` |
+ *
+ * - the owner is ALWAYS the authenticated issuer (`requireIssuerFromRequest`: none ⇒ 401), never a request field, so
+ *   one account cannot read or overwrite another's drafts;
+ * - a failed store answers `saved: false` with 200 (best-effort, it must not stop the typing), a wrong request 400.
+ */
+export declare class DyNTS_Msg_InputDraft_Controller extends DyNTS_Controller {
+    /** The settings given to the routing module. */
+    private static settings;
+    /** Sets the endpoints' settings (before the routing module is built: it builds the endpoints). */
+    static configure(settings?: DyNTS_Msg_InputDraft_Settings_Interface): void;
+    /** The controller singleton. */
+    static getInstance(): DyNTS_Msg_InputDraft_Controller;
+    /** Builds the four endpoints. */
+    setupEndpoints(): void;
+    /** One endpoint behind the configured pre-processes, its task calling the handler on this controller. */
+    private endpoint;
+    /** PUT /save - stores the draft; a store failure is answered (200, `saved: false`), not thrown. */
+    private save;
+    /** GET /get - the field's draft (`null` when none or expired). */
+    private load;
+    /** GET /list - the owner's drafts, newest first. */
+    private list;
+    /** DELETE /clear - removes the field's draft after a send. */
+    private clear;
+    /**
+     * The authenticated account (none ⇒ 401, thrown). ⚠️ No fallback to the shipped default auth service: that one trusts
+     * an `x-user-id` header, so any caller could read anyone's drafts. Without the app's auth service ⇒ 503.
+     */
+    private owner;
+    /** A data service for this request. */
+    private dataService;
+    /** A body / query as a plain record (anything else ⇒ empty). */
+    private record;
+}
+//# sourceMappingURL=msg-input-draft.controller.d.ts.map

package/build/_modules/messaging/input-draft/msg-input-draft.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft.controller.d.ts","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft.controller.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAK/E,OAAO,EAAE,uCAAuC,EAAE,MAAM,sCAAsC,CAAC;AAG/F;;;;;;;;;;;;;GAaG;AACH,qBAAa,+BAAgC,SAAQ,gBAAgB;IACnE,gDAAgD;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0F;IAEjH,kGAAkG;IAClG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,uCAAuC,GAAG,IAAI;IAI1E,gCAAgC;IAChC,MAAM,CAAC,WAAW,IAAI,+BAA+B;IAIrD,iCAAiC;IACjC,cAAc,IAAI,IAAI;IAStB,yGAAyG;IACzG,OAAO,CAAC,QAAQ;IAkBhB,mGAAmG;YACrF,IAAI;IAwBlB,kEAAkE;YACpD,IAAI;IASlB,oDAAoD;YACtC,IAAI;IAOlB,8DAA8D;YAChD,KAAK;IASnB;;;OAGG;IACH,OAAO,CAAC,KAAK;IAyBb,uCAAuC;IACvC,OAAO,CAAC,WAAW;IAInB,gEAAgE;IAChE,OAAO,CAAC,MAAM;CAWf"}

package/build/_modules/messaging/input-draft/msg-input-draft.controller.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Msg_InputDraft_Controller = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const endpoint_params_control_model_1 = require("../../../_models/control-models/endpoint-params.control-model");
+const global_service_1 = require("../../../_services/core/global.service");
+const controller_service_1 = require("../../../_services/route/controller.service");
+const msg_input_draft_data_service_1 = require("./msg-input-draft.data-service");
+const msg_input_draft_util_1 = require("./msg-input-draft.util");
+/**
+ * BFR-CCAPREVISIONED-030 part 2 - the input-draft endpoints (mounted by `DyNTS_Msg_InputDraftRouting_Util`):
+ *
+ * | method | path | body / query | answer |
+ * |---|---|---|---|
+ * | PUT | `/save` | `{ fieldKey, content, savedByBrowserId? }` | `{ saved, revision?, savedAt?, error? }` |
+ * | GET | `/get` | `?fieldKey=` | `{ draft }` (`null` when none / expired) |
+ * | GET | `/list` | - | `{ drafts, count }` (newest first) |
+ * | DELETE | `/clear` | `?fieldKey=` | `{ cleared }` |
+ *
+ * - the owner is ALWAYS the authenticated issuer (`requireIssuerFromRequest`: none ⇒ 401), never a request field, so
+ *   one account cannot read or overwrite another's drafts;
+ * - a failed store answers `saved: false` with 200 (best-effort, it must not stop the typing), a wrong request 400.
+ */
+class DyNTS_Msg_InputDraft_Controller extends controller_service_1.DyNTS_Controller {
+    /** The settings given to the routing module. */
+    static settings = msg_input_draft_util_1.DyNTS_Msg_InputDraft_Util.resolve();
+    /** Sets the endpoints' settings (before the routing module is built: it builds the endpoints). */
+    static configure(settings) {
+        DyNTS_Msg_InputDraft_Controller.settings = msg_input_draft_util_1.DyNTS_Msg_InputDraft_Util.resolve(settings);
+    }
+    /** The controller singleton. */
+    static getInstance() {
+        return DyNTS_Msg_InputDraft_Controller.getSingletonInstance();
+    }
+    /** Builds the four endpoints. */
+    setupEndpoints() {
+        this.endpoints = [
+            this.endpoint({ name: 'saveInputDraft', type: fsm_dynamo_1.DyFM_HttpCallType.put, path: '/save', handler: this.save }),
+            this.endpoint({ name: 'getInputDraft', type: fsm_dynamo_1.DyFM_HttpCallType.get, path: '/get', handler: this.load }),
+            this.endpoint({ name: 'listInputDrafts', type: fsm_dynamo_1.DyFM_HttpCallType.get, path: '/list', handler: this.list }),
+            this.endpoint({ name: 'clearInputDraft', type: fsm_dynamo_1.DyFM_HttpCallType.delete, path: '/clear', handler: this.clear }),
+        ];
+    }
+    /** One endpoint behind the configured pre-processes, its task calling the handler on this controller. */
+    endpoint(set) {
+        return new endpoint_params_control_model_1.DyNTS_Endpoint_Params({
+            name: set.name,
+            type: set.type,
+            endpoint: set.path,
+            preProcesses: DyNTS_Msg_InputDraft_Controller.settings.preProcesses,
+            tasks: [
+                (req, res, issuer) => set.handler.call(this, { req: req, res: res, issuer: issuer }),
+            ],
+        });
+    }
+    /** PUT /save - stores the draft; a store failure is answered (200, `saved: false`), not thrown. */
+    async save(call) {
+        const settings = DyNTS_Msg_InputDraft_Controller.settings;
+        const ownerId = this.owner(call.req);
+        const body = this.record(call.req.body);
+        const fieldKey = msg_input_draft_util_1.DyNTS_Msg_InputDraft_Util.fieldKey(body.fieldKey, settings);
+        const content = msg_input_draft_util_1.DyNTS_Msg_InputDraft_Util.content(body.content, settings);
+        let result;
+        try {
+            const saved = await this.dataService(call.issuer).save({
+                ownerId: ownerId,
+                fieldKey: fieldKey,
+                content: content,
+                savedByBrowserId: msg_input_draft_util_1.DyNTS_Msg_InputDraft_Util.optionalId(body.savedByBrowserId),
+            });
+            result = { saved: true, revision: saved.revision, savedAt: saved.savedAt };
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.warn(`[DyNTS_Msg_InputDraft] save failed (answered with saved: false): '${fieldKey}'`, error);
+            result = { saved: false, error: fsm_dynamo_1.DyFM_Error.getUserMessage(error) || 'The draft could not be saved.' };
+        }
+        call.res.send(result);
+    }
+    /** GET /get - the field's draft (`null` when none or expired). */
+    async load(call) {
+        const ownerId = this.owner(call.req);
+        const fieldKey = msg_input_draft_util_1.DyNTS_Msg_InputDraft_Util.fieldKey(this.record(call.req.query).fieldKey, DyNTS_Msg_InputDraft_Controller.settings);
+        call.res.send({ draft: await this.dataService(call.issuer).load({ ownerId: ownerId, fieldKey: fieldKey }) });
+    }
+    /** GET /list - the owner's drafts, newest first. */
+    async list(call) {
+        const drafts = await this.dataService(call.issuer).list({ ownerId: this.owner(call.req) });
+        call.res.send({ drafts: drafts, count: drafts.length });
+    }
+    /** DELETE /clear - removes the field's draft after a send. */
+    async clear(call) {
+        const ownerId = this.owner(call.req);
+        const fieldKey = msg_input_draft_util_1.DyNTS_Msg_InputDraft_Util.fieldKey(this.record(call.req.query).fieldKey, DyNTS_Msg_InputDraft_Controller.settings);
+        call.res.send({ cleared: await this.dataService(call.issuer).clear({ ownerId: ownerId, fieldKey: fieldKey }) });
+    }
+    /**
+     * The authenticated account (none ⇒ 401, thrown). ⚠️ No fallback to the shipped default auth service: that one trusts
+     * an `x-user-id` header, so any caller could read anyone's drafts. Without the app's auth service ⇒ 503.
+     */
+    owner(req) {
+        let auth;
+        let cause;
+        try {
+            // an app marked auth-optional gets `undefined` here instead of a throw: both mean "no owner can be known"
+            auth = global_service_1.DyNTS_GlobalService.getAuthService();
+        }
+        catch (error) {
+            cause = error;
+        }
+        if (!auth) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                status: 503,
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MSG-ID-AU0`,
+                message: 'The input drafts need an auth service on DyNTS_GlobalService; none is set.',
+                userMessage: 'The drafts are not available on this server.',
+                issuerService: 'DyNTS_Msg_InputDraft_Controller',
+                error: cause ?? new Error('no auth service'),
+            });
+        }
+        return auth.requireIssuerFromRequest(req);
+    }
+    /** A data service for this request. */
+    dataService(issuer) {
+        return new msg_input_draft_data_service_1.DyNTS_Msg_InputDraft_DataService({ issuer: issuer, settings: DyNTS_Msg_InputDraft_Controller.settings });
+    }
+    /** A body / query as a plain record (anything else ⇒ empty). */
+    record(value) {
+        const result = {};
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            Object.entries(value).forEach(([key, item]) => {
+                result[key] = item;
+            });
+        }
+        return result;
+    }
+}
+exports.DyNTS_Msg_InputDraft_Controller = DyNTS_Msg_InputDraft_Controller;
+//# sourceMappingURL=msg-input-draft.controller.js.map

package/build/_modules/messaging/input-draft/msg-input-draft.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft.controller.js","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft.controller.ts"],"names":[],"mappings":"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"}

package/build/_modules/messaging/input-draft/msg-input-draft.data-model.d.ts

@@ -0,0 +1,38 @@
+import { DyFM_DataModel_Params, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
+/**
+ * BFR-CCAPREVISIONED-030 part 2 (the CCAP's `MSG_InputDraft_*`, generalized) - the SERVER copy of an unsent input text,
+ * so a half-written message comes back in another browser or on another device too.
+ *
+ * - ONE record per (owner, field key): an upsert overwrites it (the collection grows with the fields, not the typing);
+ * - the owner is the authenticated account (the issuer), never a request field;
+ * - the field key is the app's own (e.g. `chat:<conversationId>`, `reply:<ticketId>`);
+ * - `content` is the user's own raw text: it is stored as it came, never trimmed or reformatted;
+ * - an EMPTY save over a non-empty text keeps that text in `lastWipedContent` (a wiped draft is not lost for good).
+ */
+export declare class DyNTS_Msg_InputDraft_DataModel extends DyFM_Metadata {
+    /** The account the draft belongs to (the authenticated issuer). */
+    ownerId: string;
+    /** The app's key of the input field (one draft per owner and key). */
+    fieldKey: string;
+    /** The unsent text, exactly as the user typed it (an empty string is a valid value). */
+    content: string;
+    /** When this version was saved (server time); the expiry and the "newest" order use it. */
+    savedAt: Date;
+    /** The save count on this field (from 1, grows by one on every save). */
+    revision: number;
+    /** Which browser saved it (the client's own id): "is the server copy my own unflushed tail?". */
+    savedByBrowserId?: string;
+    /** The non-empty text the last EMPTY save overwrote. */
+    lastWipedContent?: string;
+    /** The `savedAt` of the overwritten version. */
+    lastWipedAt?: Date;
+    /** The revision of the overwritten version. */
+    lastWipedRevision?: number;
+    /** A draft from the given fields. */
+    constructor(set?: Partial<DyNTS_Msg_InputDraft_DataModel>);
+}
+/**
+ * The `dynts_msg_input_draft` collection: the lookup is always (ownerId, fieldKey), both indexed; the text is not.
+ */
+export declare const DyNTS_msgInputDraft_dataParams: DyFM_DataModel_Params<DyNTS_Msg_InputDraft_DataModel>;
+//# sourceMappingURL=msg-input-draft.data-model.d.ts.map

package/build/_modules/messaging/input-draft/msg-input-draft.data-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft.data-model.d.ts","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft.data-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAe,MAAM,uBAAuB,CAAC;AAE1F;;;;;;;;;GASG;AACH,qBAAa,8BAA+B,SAAQ,aAAa;IAC/D,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAM;IACrB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAM;IACtB,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAM;IACrB,2FAA2F;IAC3F,OAAO,EAAE,IAAI,CAAe;IAC5B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAK;IACrB,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,qCAAqC;gBACzB,GAAG,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC;CAO1D;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,qBAAqB,CAAC,8BAA8B,CAc7F,CAAC"}

package/build/_modules/messaging/input-draft/msg-input-draft.data-model.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_msgInputDraft_dataParams = exports.DyNTS_Msg_InputDraft_DataModel = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * BFR-CCAPREVISIONED-030 part 2 (the CCAP's `MSG_InputDraft_*`, generalized) - the SERVER copy of an unsent input text,
+ * so a half-written message comes back in another browser or on another device too.
+ *
+ * - ONE record per (owner, field key): an upsert overwrites it (the collection grows with the fields, not the typing);
+ * - the owner is the authenticated account (the issuer), never a request field;
+ * - the field key is the app's own (e.g. `chat:<conversationId>`, `reply:<ticketId>`);
+ * - `content` is the user's own raw text: it is stored as it came, never trimmed or reformatted;
+ * - an EMPTY save over a non-empty text keeps that text in `lastWipedContent` (a wiped draft is not lost for good).
+ */
+class DyNTS_Msg_InputDraft_DataModel extends fsm_dynamo_1.DyFM_Metadata {
+    /** The account the draft belongs to (the authenticated issuer). */
+    ownerId = '';
+    /** The app's key of the input field (one draft per owner and key). */
+    fieldKey = '';
+    /** The unsent text, exactly as the user typed it (an empty string is a valid value). */
+    content = '';
+    /** When this version was saved (server time); the expiry and the "newest" order use it. */
+    savedAt = new Date(0);
+    /** The save count on this field (from 1, grows by one on every save). */
+    revision = 0;
+    /** Which browser saved it (the client's own id): "is the server copy my own unflushed tail?". */
+    savedByBrowserId;
+    /** The non-empty text the last EMPTY save overwrote. */
+    lastWipedContent;
+    /** The `savedAt` of the overwritten version. */
+    lastWipedAt;
+    /** The revision of the overwritten version. */
+    lastWipedRevision;
+    /** A draft from the given fields. */
+    constructor(set) {
+        super(set);
+        if (set) {
+            fsm_dynamo_1.DyFM_Object.cleanAssign(this, set);
+        }
+    }
+}
+exports.DyNTS_Msg_InputDraft_DataModel = DyNTS_Msg_InputDraft_DataModel;
+/**
+ * The `dynts_msg_input_draft` collection: the lookup is always (ownerId, fieldKey), both indexed; the text is not.
+ */
+exports.DyNTS_msgInputDraft_dataParams = new fsm_dynamo_1.DyFM_DataModel_Params({
+    dataName: 'dynts_msg_input_draft',
+    properties: {
+        ownerId: { type: 'string', required: true, index: true },
+        fieldKey: { type: 'string', required: true, index: true },
+        content: { type: 'string' },
+        savedAt: { type: 'date', required: true },
+        revision: { type: 'number', required: true },
+        savedByBrowserId: { type: 'string' },
+        lastWipedContent: { type: 'string' },
+        lastWipedAt: { type: 'date' },
+        lastWipedRevision: { type: 'number' },
+    },
+});
+//# sourceMappingURL=msg-input-draft.data-model.js.map

package/build/_modules/messaging/input-draft/msg-input-draft.data-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft.data-model.js","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft.data-model.ts"],"names":[],"mappings":";;;AAAA,sDAA0F;AAE1F;;;;;;;;;GASG;AACH,MAAa,8BAA+B,SAAQ,0BAAa;IAC/D,mEAAmE;IACnE,OAAO,GAAW,EAAE,CAAC;IACrB,sEAAsE;IACtE,QAAQ,GAAW,EAAE,CAAC;IACtB,wFAAwF;IACxF,OAAO,GAAW,EAAE,CAAC;IACrB,2FAA2F;IAC3F,OAAO,GAAS,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,GAAW,CAAC,CAAC;IACrB,iGAAiG;IACjG,gBAAgB,CAAU;IAC1B,wDAAwD;IACxD,gBAAgB,CAAU;IAC1B,gDAAgD;IAChD,WAAW,CAAQ;IACnB,+CAA+C;IAC/C,iBAAiB,CAAU;IAE3B,qCAAqC;IACrC,YAAY,GAA6C;QACvD,KAAK,CAAC,GAAG,CAAC,CAAC;QAEX,IAAI,GAAG,EAAE,CAAC;YACR,wBAAW,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF;AA5BD,wEA4BC;AAED;;GAEG;AACU,QAAA,8BAA8B,GACzC,IAAI,kCAAqB,CAAiC;IACxD,QAAQ,EAAE,uBAAuB;IACjC,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;QACxD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;QACzD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5C,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACpC,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACpC,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QAC7B,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACtC;CACF,CAAC,CAAC"}

package/build/_modules/messaging/input-draft/msg-input-draft.data-service.d.ts

@@ -0,0 +1,55 @@
+import { DyNTS_DataService } from '../../../_services/base/data.service';
+import { DyNTS_Msg_InputDraft_DataModel } from './msg-input-draft.data-model';
+import { DyNTS_Msg_InputDraft_Settings_Interface } from './msg-input-draft-settings.interface';
+/**
+ * BFR-CCAPREVISIONED-030 part 2 (the CCAP's `MSG_InputDraft_DataService`, generalized) - the server copy of the
+ * unsent input texts, per owner and field key.
+ *
+ * - `save`: an UPSERT (the revision grows by one); an empty save over a text keeps that text in `lastWipedContent`;
+ * - `load` / `list`: only the owner's live drafts, younger than `maxAgeMs`; these reads NEVER throw (a database error
+ *   gives none: opening a page must not break on it, and it is logged);
+ * - `clear`: after a successful send (a soft delete: the text stays recoverable in the database).
+ *
+ * ⚠️ The save looks up the current record with a THROWING read: a swallowed read error would look like "no draft yet"
+ * and create a second record for the same field (revision 1 again).
+ */
+export declare class DyNTS_Msg_InputDraft_DataService extends DyNTS_DataService<DyNTS_Msg_InputDraft_DataModel> {
+    /** The resolved settings (expiry, list size). */
+    private readonly settings;
+    /** A service for one request (the issuer for the record metadata). */
+    constructor(set: {
+        issuer: string;
+        settings?: DyNTS_Msg_InputDraft_Settings_Interface;
+    });
+    /** Stores the field's draft (create or overwrite); a database error throws (the caller reports `saved: false`). */
+    save(set: {
+        ownerId: string;
+        fieldKey: string;
+        content: string;
+        savedByBrowserId?: string;
+        now?: Date;
+    }): Promise<DyNTS_Msg_InputDraft_DataModel>;
+    /** The field's live, not expired draft, or `null` (also on a database error, logged). */
+    load(set: {
+        ownerId: string;
+        fieldKey: string;
+        now?: Date;
+    }): Promise<DyNTS_Msg_InputDraft_DataModel | null>;
+    /** The owner's live, not expired drafts, newest first (at most `maxListCount`; `[]` on a database error, logged). */
+    list(set: {
+        ownerId: string;
+        now?: Date;
+    }): Promise<DyNTS_Msg_InputDraft_DataModel[]>;
+    /** Removes the field's draft after a send (soft delete); `false` when there was none (or on an error, logged). */
+    clear(set: {
+        ownerId: string;
+        fieldKey: string;
+    }): Promise<boolean>;
+    /** The field's live record, expired or not (THROWS on a database error). */
+    private findCurrent;
+    /** Whether the draft is older than `maxAgeMs`. */
+    private isExpired;
+    /** The oldest save time still given back. */
+    private cutoff;
+}
+//# sourceMappingURL=msg-input-draft.data-service.d.ts.map

package/build/_modules/messaging/input-draft/msg-input-draft.data-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft.data-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft.data-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAkC,MAAM,8BAA8B,CAAC;AAC9G,OAAO,EAAE,uCAAuC,EAAE,MAAM,sCAAsC,CAAC;AAG/F;;;;;;;;;;;GAWG;AACH,qBAAa,gCAAiC,SAAQ,iBAAiB,CAAC,8BAA8B,CAAC;IACrG,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoD;IAE7E,sEAAsE;gBAC1D,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,uCAAuC,CAAA;KAAE;IAKvF,mHAAmH;IAC7G,IAAI,CAAC,GAAG,EAAE;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,GAAG,CAAC,EAAE,IAAI,CAAC;KACZ,GAAG,OAAO,CAAC,8BAA8B,CAAC;IAkC3C,yFAAyF;IACnF,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC;IAYlH,qHAAqH;IAC/G,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,8BAA8B,EAAE,CAAC;IAmB3F,kHAAkH;IAC5G,KAAK,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBzE,4EAA4E;YAC9D,WAAW;IAUzB,kDAAkD;IAClD,OAAO,CAAC,SAAS;IAIjB,6CAA6C;IAC7C,OAAO,CAAC,MAAM;CAGf"}

package/build/_modules/messaging/input-draft/msg-input-draft.data-service.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Msg_InputDraft_DataService = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const data_service_1 = require("../../../_services/base/data.service");
+const msg_input_draft_data_model_1 = require("./msg-input-draft.data-model");
+const msg_input_draft_util_1 = require("./msg-input-draft.util");
+/**
+ * BFR-CCAPREVISIONED-030 part 2 (the CCAP's `MSG_InputDraft_DataService`, generalized) - the server copy of the
+ * unsent input texts, per owner and field key.
+ *
+ * - `save`: an UPSERT (the revision grows by one); an empty save over a text keeps that text in `lastWipedContent`;
+ * - `load` / `list`: only the owner's live drafts, younger than `maxAgeMs`; these reads NEVER throw (a database error
+ *   gives none: opening a page must not break on it, and it is logged);
+ * - `clear`: after a successful send (a soft delete: the text stays recoverable in the database).
+ *
+ * ⚠️ The save looks up the current record with a THROWING read: a swallowed read error would look like "no draft yet"
+ * and create a second record for the same field (revision 1 again).
+ */
+class DyNTS_Msg_InputDraft_DataService extends data_service_1.DyNTS_DataService {
+    /** The resolved settings (expiry, list size). */
+    settings;
+    /** A service for one request (the issuer for the record metadata). */
+    constructor(set) {
+        super(new msg_input_draft_data_model_1.DyNTS_Msg_InputDraft_DataModel(), msg_input_draft_data_model_1.DyNTS_msgInputDraft_dataParams, set.issuer);
+        this.settings = msg_input_draft_util_1.DyNTS_Msg_InputDraft_Util.resolve(set.settings);
+    }
+    /** Stores the field's draft (create or overwrite); a database error throws (the caller reports `saved: false`). */
+    async save(set) {
+        try {
+            const existing = await this.findCurrent(set);
+            const draft = new msg_input_draft_data_model_1.DyNTS_Msg_InputDraft_DataModel(existing ?? {
+                ownerId: set.ownerId, fieldKey: set.fieldKey,
+            });
+            // an empty save over a text: the text is kept (the user's raw input is never lost by one wipe)
+            if (!set.content && existing?.content) {
+                draft.lastWipedContent = existing.content;
+                draft.lastWipedAt = existing.savedAt;
+                draft.lastWipedRevision = existing.revision;
+            }
+            draft.content = set.content;
+            draft.savedAt = set.now ?? new Date();
+            draft.revision = (existing?.revision ?? 0) + 1;
+            draft.savedByBrowserId = set.savedByBrowserId;
+            this.data = existing
+                ? await this.dataDBService.modifyData(draft, this.issuer)
+                : await this.dataDBService.createData(draft, this.issuer);
+            return new msg_input_draft_data_model_1.DyNTS_Msg_InputDraft_DataModel(this.data);
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('save', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MSG-ID-S0`,
+                message: 'The input draft could not be stored.',
+                userMessage: 'The draft could not be saved on the server.',
+                additionalContent: { fieldKey: set.fieldKey, contentLength: set.content.length },
+            });
+        }
+    }
+    /** The field's live, not expired draft, or `null` (also on a database error, logged). */
+    async load(set) {
+        try {
+            const current = await this.findCurrent(set);
+            return current && !this.isExpired({ draft: current, now: set.now }) ? current : null;
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.warn(`[DyNTS_Msg_InputDraft] load failed (no draft given): '${set.fieldKey}'`, error);
+            return null;
+        }
+    }
+    /** The owner's live, not expired drafts, newest first (at most `maxListCount`; `[]` on a database error, logged). */
+    async list(set) {
+        try {
+            const filter = {
+                ownerId: set.ownerId,
+                savedAt: { $gte: this.cutoff(set.now) },
+            };
+            const found = await this.dataDBService.find(filter, false, {
+                sort: { savedAt: -1 }, limit: this.settings.maxListCount,
+            });
+            return found.map((draft) => new msg_input_draft_data_model_1.DyNTS_Msg_InputDraft_DataModel(draft));
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.warn(`[DyNTS_Msg_InputDraft] list failed (an empty list given)`, error);
+            return [];
+        }
+    }
+    /** Removes the field's draft after a send (soft delete); `false` when there was none (or on an error, logged). */
+    async clear(set) {
+        try {
+            // EVERY live record of the field: two first saves racing can create two, and clearing only the newest would
+            // bring the older (already sent) text back
+            const live = await this.dataDBService.find({ ownerId: set.ownerId, fieldKey: set.fieldKey }, false, { limit: 20 });
+            const ids = live
+                .map((draft) => draft._id)
+                .filter((id) => !!id);
+            for (const id of ids) {
+                await this.dataDBService.markDeletedById(id, this.issuer);
+            }
+            return ids.length > 0;
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.warn(`[DyNTS_Msg_InputDraft] clear failed: '${set.fieldKey}'`, error);
+            return false;
+        }
+    }
+    /** The field's live record, expired or not (THROWS on a database error). */
+    async findCurrent(set) {
+        const found = await this.dataDBService.find({ ownerId: set.ownerId, fieldKey: set.fieldKey }, false, { sort: { savedAt: -1 }, limit: 1 });
+        return found[0] ? new msg_input_draft_data_model_1.DyNTS_Msg_InputDraft_DataModel(found[0]) : null;
+    }
+    /** Whether the draft is older than `maxAgeMs`. */
+    isExpired(set) {
+        return new Date(set.draft.savedAt).getTime() < this.cutoff(set.now).getTime();
+    }
+    /** The oldest save time still given back. */
+    cutoff(now) {
+        return new Date((now ?? new Date()).getTime() - this.settings.maxAgeMs);
+    }
+}
+exports.DyNTS_Msg_InputDraft_DataService = DyNTS_Msg_InputDraft_DataService;
+//# sourceMappingURL=msg-input-draft.data-service.js.map

package/build/_modules/messaging/input-draft/msg-input-draft.data-service.js.map

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

package/build/_modules/messaging/input-draft/msg-input-draft.util.d.ts

@@ -0,0 +1,20 @@
+import { DyNTS_Msg_InputDraft_Settings_Interface } from './msg-input-draft-settings.interface';
+/**
+ * BFR-CCAPREVISIONED-030 part 2 - the input-draft request checks (a wrong request is the caller's bug: 400, with a
+ * code; the stored text itself is never changed).
+ */
+export declare class DyNTS_Msg_InputDraft_Util {
+    /** The settings with every missing field taken from the defaults. */
+    static resolve(settings?: DyNTS_Msg_InputDraft_Settings_Interface): Required<DyNTS_Msg_InputDraft_Settings_Interface>;
+    /** The field key from a body / query value: a non-empty string, at most `maxFieldKeyLength` long (trimmed). */
+    static fieldKey(raw: unknown, settings: Required<DyNTS_Msg_InputDraft_Settings_Interface>): string;
+    /** The text from a body value, UNCHANGED: missing ⇒ empty; not a string or too long ⇒ 400 (never cut). */
+    static content(raw: unknown, settings: Required<DyNTS_Msg_InputDraft_Settings_Interface>): string;
+    /** An optional short id (the browser id): a non-empty string up to 200 characters, otherwise none. */
+    static optionalId(raw: unknown): string | undefined;
+    /** A 400 with the module's code. */
+    private static badRequest;
+    /** The given settings without their `undefined` fields (so they do not hide a default). */
+    private static defined;
+}
+//# sourceMappingURL=msg-input-draft.util.d.ts.map

package/build/_modules/messaging/input-draft/msg-input-draft.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft.util.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uCAAuC,EAAE,MAAM,sCAAsC,CAAC;AAE/F;;;GAGG;AACH,qBAAa,yBAAyB;IACpC,qEAAqE;IACrE,MAAM,CAAC,OAAO,CACZ,QAAQ,CAAC,EAAE,uCAAuC,GACjD,QAAQ,CAAC,uCAAuC,CAAC;IAIpD,+GAA+G;IAC/G,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,uCAAuC,CAAC,GAAG,MAAM;IAgBlG,0GAA0G;IAC1G,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,uCAAuC,CAAC,GAAG,MAAM;IAkBjG,sGAAsG;IACtG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS;IAMnD,oCAAoC;IACpC,OAAO,CAAC,MAAM,CAAC,UAAU;IAUzB,2FAA2F;IAC3F,OAAO,CAAC,MAAM,CAAC,OAAO;CAavB"}

package/build/_modules/messaging/input-draft/msg-input-draft.util.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Msg_InputDraft_Util = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const msg_input_draft_default_settings_const_1 = require("./msg-input-draft-default-settings.const");
+/**
+ * BFR-CCAPREVISIONED-030 part 2 - the input-draft request checks (a wrong request is the caller's bug: 400, with a
+ * code; the stored text itself is never changed).
+ */
+class DyNTS_Msg_InputDraft_Util {
+    /** The settings with every missing field taken from the defaults. */
+    static resolve(settings) {
+        return { ...msg_input_draft_default_settings_const_1.DyNTS_msgInputDraft_defaultSettings, ...DyNTS_Msg_InputDraft_Util.defined(settings) };
+    }
+    /** The field key from a body / query value: a non-empty string, at most `maxFieldKeyLength` long (trimmed). */
+    static fieldKey(raw, settings) {
+        const fieldKey = typeof raw === 'string' ? raw.trim() : '';
+        if (!fieldKey) {
+            throw DyNTS_Msg_InputDraft_Util.badRequest({ code: 'FK1', message: 'The fieldKey is missing.' });
+        }
+        if (fieldKey.length > settings.maxFieldKeyLength) {
+            throw DyNTS_Msg_InputDraft_Util.badRequest({
+                code: 'FK2', message: `The fieldKey is longer than ${settings.maxFieldKeyLength} characters.`,
+            });
+        }
+        return fieldKey;
+    }
+    /** The text from a body value, UNCHANGED: missing ⇒ empty; not a string or too long ⇒ 400 (never cut). */
+    static content(raw, settings) {
+        if (raw === undefined || raw === null) {
+            return '';
+        }
+        if (typeof raw !== 'string') {
+            throw DyNTS_Msg_InputDraft_Util.badRequest({ code: 'CT1', message: 'The content must be a text.' });
+        }
+        if (raw.length > settings.maxContentLength) {
+            throw DyNTS_Msg_InputDraft_Util.badRequest({
+                code: 'CT2', message: `The draft is longer than ${settings.maxContentLength} characters.`,
+            });
+        }
+        return raw;
+    }
+    /** An optional short id (the browser id): a non-empty string up to 200 characters, otherwise none. */
+    static optionalId(raw) {
+        const id = typeof raw === 'string' ? raw.trim() : '';
+        return id && id.length <= 200 ? id : undefined;
+    }
+    /** A 400 with the module's code. */
+    static badRequest(set) {
+        return new fsm_dynamo_1.DyFM_Error({
+            status: 400,
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MSG-ID-${set.code}`,
+            message: set.message,
+            userMessage: set.message,
+            issuerService: 'DyNTS_Msg_InputDraft_Util',
+        });
+    }
+    /** The given settings without their `undefined` fields (so they do not hide a default). */
+    static defined(settings) {
+        const result = {};
+        Object.entries(settings ?? {}).forEach(([key, value]) => {
+            if (value !== undefined) {
+                Reflect.set(result, key, value);
+            }
+        });
+        return result;
+    }
+}
+exports.DyNTS_Msg_InputDraft_Util = DyNTS_Msg_InputDraft_Util;
+//# sourceMappingURL=msg-input-draft.util.js.map

package/build/_modules/messaging/input-draft/msg-input-draft.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-input-draft.util.js","sourceRoot":"","sources":["../../../../src/_modules/messaging/input-draft/msg-input-draft.util.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.465",
+  "version": "01.15.466",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",