@futdevpro/nts-dynamo 1.15.250 → 1.15.253

package/build/_collections/progress-handle.interface.d.ts

@@ -0,0 +1,20 @@
+/** Controller for a started progress line. */
+export interface DyNTS_Progress_Handle {
+    /** Whether the line updates in place (TTY). Callers may use this to decide about extra output. */
+    readonly isInteractive: boolean;
+    /** Reports progress. `current` may be omitted, in which case the counter advances by one. */
+    update(set?: {
+        current?: number;
+        total?: number;
+        note?: string;
+    }): void;
+    /** Closes the line as SUCCESSFUL, replacing it with a permanent line. Idempotent. */
+    done(set?: {
+        summary?: string;
+    }): void;
+    /** Closes the line as FAILED. Same as `done`, but the final line marks the failure. Idempotent. */
+    fail(set?: {
+        summary?: string;
+    }): void;
+}
+//# sourceMappingURL=progress-handle.interface.d.ts.map

package/build/_collections/progress-handle.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-handle.interface.d.ts","sourceRoot":"","sources":["../../src/_collections/progress-handle.interface.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,kGAAkG;IAClG,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,6FAA6F;IAC7F,MAAM,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,qFAAqF;IACrF,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvC,mGAAmG;IACnG,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACxC"}

package/build/_collections/progress-handle.interface.js

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

package/build/_collections/progress-handle.interface.js.map

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

package/build/_collections/progress-line.util.d.ts

@@ -0,0 +1,67 @@
+import { DyNTS_Progress_Handle } from './progress-handle.interface';
+import { DyNTS_Progress_Options } from './progress-options.interface';
+type ProgressStream = NonNullable<DyNTS_Progress_Options['stream']>;
+/**
+ * `DyNTS_Progress_Util` — the public surface of the progress line, plus the **pure** formatting
+ * helpers, so the behaviour can be unit-tested without a terminal.
+ */
+export declare class DyNTS_Progress_Util {
+    /**
+     * Starts a new progress line.
+     *
+     * **At most one progress line can be active at a time**, because there is only one physical
+     * "bottom line" in a terminal; two lines overwriting each other would only produce confusion.
+     * If one is already active when `start` is called, that one is closed (`done()`) and the new
+     * line takes its place.
+     */
+    static start(options: DyNTS_Progress_Options): DyNTS_Progress_Handle;
+    /**
+     * Decides whether an in-place line makes sense.
+     *
+     * Order of precedence: explicit `enabled`, then `DYNTS_NO_PROGRESS`, then the stream's TTY flag.
+     * `stdout` is never accepted, because machine-readable output goes there.
+     */
+    static isInteractive(set?: {
+        stream?: ProgressStream;
+        enabled?: boolean;
+    }): boolean;
+    /** Whether the next plain line is due in non-TTY mode. Pure, therefore testable. */
+    static shouldEmitPlain(set: {
+        nowMs: number;
+        lastEmitMs: number;
+        everyMs: number;
+    }): boolean;
+    /**
+     * Renders the bar. `current` is always clamped to `[0, total]`, so a caller that miscounts
+     * cannot produce a broken (negative or overflowing) bar.
+     */
+    static renderBar(set: {
+        current: number;
+        total: number;
+        width: number;
+    }): string;
+    /** Percentage, rounded to an integer and clamped to `[0, 100]`. */
+    static percent(set: {
+        current: number;
+        total: number;
+    }): number;
+    /** Elapsed time in a short, human-readable form; the line has to fit on one terminal row. */
+    static formatElapsed(ms: number): string;
+    /**
+     * Builds the full progress text.
+     *
+     * With a known `total`: bar, percentage and `current/total`. With an unknown `total`: spinner and
+     * counter only — a ratio is never invented for a number that was never provided.
+     */
+    static formatLine(set: {
+        label: string;
+        current: number;
+        total?: number;
+        note?: string;
+        barWidth: number;
+        spinner: string;
+        elapsedMs: number;
+    }): string;
+}
+export {};
+//# sourceMappingURL=progress-line.util.d.ts.map

package/build/_collections/progress-line.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-line.util.d.ts","sourceRoot":"","sources":["../../src/_collections/progress-line.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,KAAK,cAAc,GAAG,WAAW,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAqUpE;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B;;;;;;;OAOG;WACW,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB;IAa3E;;;;;OAKG;WACW,aAAa,CAAC,GAAG,CAAC,EAAE;QAChC,MAAM,CAAC,EAAE,cAAc,CAAC;QACxB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO;IAiBX,oFAAoF;WACtE,eAAe,CAAC,GAAG,EAAE;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO;IAIX;;;OAGG;WACW,SAAS,CAAC,GAAG,EAAE;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,MAAM;IAUV,mEAAmE;WACrD,OAAO,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAWtE,6FAA6F;WAC/E,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAU/C;;;;;OAKG;WACW,UAAU,CAAC,GAAG,EAAE;QAC5B,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,MAAM;CAWX"}

package/build/_collections/progress-line.util.js

@@ -0,0 +1,379 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Progress_Util = void 0;
+var ConsoleMethod;
+(function (ConsoleMethod) {
+    ConsoleMethod["log"] = "log";
+    ConsoleMethod["info"] = "info";
+    ConsoleMethod["warn"] = "warn";
+    ConsoleMethod["error"] = "error";
+    ConsoleMethod["debug"] = "debug";
+})(ConsoleMethod || (ConsoleMethod = {}));
+/**
+ * `DyNTS_Progress_Util` — a **single-line, in-place progress indicator** (progress line / bar) for
+ * long-running work: scans, imports, embeddings, migrations, batch processing.
+ *
+ * ---
+ * ## Why this exists — and why a `console.log` inside the loop is not enough
+ *
+ * A long run has only ever offered two bad options:
+ *
+ * 1. **Silence.** The operator cannot tell whether the process is alive or where it is. A run that
+ *    takes minutes is indistinguishable from a hang.
+ * 2. **A flood of lines.** One log line every N items drowns the output and pushes the messages that
+ *    actually matter (warnings, errors) off the screen.
+ *
+ * This util provides the third option: **one line that is rewritten in place**.
+ *
+ * ## The important part: it does NOT disturb other logging
+ *
+ * A naive `\r`-based progress line collides with every other write to the console: if anything else
+ * prints while the line is on screen, the half-drawn progress text is left stuck to the start or the
+ * end of that message and the output becomes unreadable.
+ *
+ * Therefore, while a progress line is **active**, this util **wraps
+ * `console.log` / `info` / `warn` / `error` / `debug`**: it **erases** the progress line before any
+ * foreign write and **redraws** it afterwards.
+ *
+ * The consequence is that calling code needs to know **nothing** about the progress line. Messages
+ * from the framework logger, from raw `console` calls, and from third-party libraries all appear
+ * intact, and the progress line stays pinned to the bottom of the output.
+ *
+ * ## Non-TTY output (redirected to a file or a pipe): `\r` would be harmful
+ *
+ * When the destination is not a terminal (a CI log, `2> app.log`, a nodemon pipe), `\r` and ANSI
+ * escapes produce **garbage**: the lines overwrite each other and the file stops being readable by
+ * humans or machines. In that case this util **never rewrites anything**. It emits **throttled,
+ * standalone lines** instead (every 5 seconds by default), so the log file stays readable while the
+ * progress is still visible.
+ *
+ * ## Where it writes — and where it never writes
+ *
+ * **Always to `stderr`, never to `stdout`.** Reason: for the CLI tools in this fleet the purity of
+ * `--json` output is an invariant (`… --json | jq`), so stdout may carry the result envelope only.
+ * Progress is diagnostics, which belongs on stderr.
+ *
+ * ## Turning it off
+ *
+ * `DYNTS_NO_PROGRESS=1` (disables it entirely) or `enabled: false` at the call site.
+ *
+ * @example
+ * const progress: DyNTS_Progress_Handle = DyNTS_Progress_Util.start({ label: 'scan', total: files.length });
+ * for (const file of files) {
+ *     progress.update({ note: file.name });   // no argument needed: it advances by one
+ * }
+ * progress.done({ summary: `${files.length} files` });
+ */
+/**
+ * Erase sequence: return to the start of the line, then clear the whole line (ANSI `EL 2`).
+ *
+ * The `\x1b` escape is written **explicitly** rather than as a raw ESC byte in the source: an
+ * invisible control character can be swallowed silently by an editor, an encoding change or a bulk
+ * search-and-replace, and the progress line would then print the literal text `[2K` instead of
+ * erasing anything.
+ */
+const CLEAR_LINE = '\r\x1b[2K';
+/** Spinner frames, used when `total` is unknown, to show that the process is alive. */
+const SPINNER_FRAMES = [
+    '⠋',
+    '⠙',
+    '⠹',
+    '⠸',
+    '⠼',
+    '⠴',
+    '⠦',
+    '⠧',
+    '⠇',
+    '⠏',
+];
+/** The currently active progress line; at most one at a time (see `start`). */
+let activeLine = undefined;
+/** Console methods that are wrapped while a progress line is active. */
+const CONSOLE_METHODS = Object.values(ConsoleMethod);
+let originalConsole = {};
+/** Our own wrappers; restoration only happens while these are still the installed functions. */
+let installedConsole = {};
+/** Internal state of a running progress line. Not exported: callers receive the handle interface. */
+class ProgressLine {
+    isInteractive;
+    stream;
+    label;
+    throttleMs;
+    plainEveryMs;
+    barWidth;
+    total;
+    current = 0;
+    note = '';
+    frame = 0;
+    lastDrawMs = 0;
+    lastPlainMs = 0;
+    isDrawn = false;
+    isFinished = false;
+    startedMs = Date.now();
+    /** Creates one progress line using already bounded caller options. */
+    constructor(options) {
+        this.stream = options.stream ?? process.stderr;
+        this.label = options.label;
+        this.total = options.total;
+        this.throttleMs = options.throttleMs ?? 80;
+        this.plainEveryMs = options.plainEveryMs ?? 5000;
+        this.barWidth = options.barWidth ?? 24;
+        this.isInteractive = DyNTS_Progress_Util.isInteractive({
+            stream: this.stream,
+            enabled: options.enabled,
+        });
+    }
+    /** Advances or replaces the current progress counters and optional note. */
+    update(set) {
+        if (this.isFinished) {
+            return;
+        }
+        this.current = set?.current ?? this.current + 1;
+        if (set?.total !== undefined) {
+            this.total = set.total;
+        }
+        if (set?.note !== undefined) {
+            this.note = set.note;
+        }
+        const now = Date.now();
+        if (this.isInteractive) {
+            if (now - this.lastDrawMs < this.throttleMs) {
+                return;
+            }
+            this.lastDrawMs = now;
+            this.frame += 1;
+            this.draw();
+            return;
+        }
+        // Non-TTY: never overwrite. Throttled standalone lines keep the log file readable.
+        if (DyNTS_Progress_Util.shouldEmitPlain({
+            nowMs: now,
+            lastEmitMs: this.lastPlainMs,
+            everyMs: this.plainEveryMs,
+        })) {
+            this.lastPlainMs = now;
+            this.stream.write(`${this.buildText()}\n`);
+        }
+    }
+    /** Finalizes the line once with a success marker. */
+    done(set) {
+        this.finish({ summary: set?.summary, ok: true });
+    }
+    /** Finalizes the line once with a failure marker. */
+    fail(set) {
+        this.finish({ summary: set?.summary, ok: false });
+    }
+    /** Erases the progress line; called by the console wrapper before every foreign write. */
+    clear() {
+        if (!this.isInteractive || !this.isDrawn) {
+            return;
+        }
+        this.stream.write(CLEAR_LINE);
+        this.isDrawn = false;
+    }
+    /** Redraws the line after a foreign write, so it stays pinned to the bottom of the output. */
+    redraw() {
+        if (!this.isInteractive || this.isFinished) {
+            return;
+        }
+        this.draw();
+    }
+    /** Current text of the progress line; the final line is built from the same text. */
+    buildText() {
+        return DyNTS_Progress_Util.formatLine({
+            label: this.label,
+            current: this.current,
+            total: this.total,
+            note: this.note,
+            barWidth: this.barWidth,
+            spinner: SPINNER_FRAMES[this.frame % SPINNER_FRAMES.length],
+            elapsedMs: Date.now() - this.startedMs,
+        });
+    }
+    /** Draws on a TTY: erase, then rewrite without a newline, which is what keeps it on one line. */
+    draw() {
+        this.stream.write(`${CLEAR_LINE}${this.buildText()}`);
+        this.isDrawn = true;
+    }
+    /** Shared close path. The final line is always emitted, on TTY and non-TTY alike, exactly once. */
+    finish(set) {
+        if (this.isFinished) {
+            return;
+        }
+        this.isFinished = true;
+        this.clear();
+        const mark = set.ok ? '✔' : '✖';
+        const tail = set.summary ? ` — ${set.summary}` : '';
+        this.stream.write(`${mark} ${this.buildText()}${tail}\n`);
+        if (activeLine === this) {
+            activeLine = undefined;
+            restoreConsole();
+        }
+    }
+}
+/** Installs the console wrappers; only while a progress line is active. */
+function installConsole() {
+    if (Object.keys(originalConsole).length > 0) {
+        return;
+    }
+    for (const method of CONSOLE_METHODS) {
+        // The ORIGINAL reference is stored, not a `.bind()` copy. A bound copy is functionally
+        // equivalent but has a different identity, so restoring it would not give the caller back
+        // the exact function it had, and repeated start/close cycles would stack bind layers.
+        const original = getConsoleMethod(method);
+        originalConsole[method] = original;
+        /** Preserves foreign console output by temporarily removing and then redrawing the progress line. */
+        const wrapper = (...args) => {
+            // The core behaviour: erase before the foreign message, redraw after it.
+            activeLine?.clear();
+            original.apply(console, args);
+            activeLine?.redraw();
+        };
+        installedConsole[method] = wrapper;
+        setConsoleMethod(method, wrapper);
+    }
+}
+/**
+ * Restores the console methods.
+ *
+ * Restoration happens only while **our** wrapper is still the installed function. If something else
+ * (a test harness, a file logger) installed its own wrapper on top of ours in the meantime, a blind
+ * restore would silently knock that wrapper out of place.
+ */
+function restoreConsole() {
+    for (const method of CONSOLE_METHODS) {
+        const current = getConsoleMethod(method);
+        const original = originalConsole[method];
+        if (original && current === installedConsole[method]) {
+            setConsoleMethod(method, original);
+        }
+    }
+    originalConsole = {};
+    installedConsole = {};
+}
+/** Returns a console method through an exhaustive, cast-free mapping. */
+function getConsoleMethod(method) {
+    switch (method) {
+        case ConsoleMethod.log:
+            return console.log;
+        case ConsoleMethod.info:
+            return console.info;
+        case ConsoleMethod.warn:
+            return console.warn;
+        case ConsoleMethod.error:
+            return console.error;
+        case ConsoleMethod.debug:
+            return console.debug;
+    }
+}
+/** Replaces exactly one known console method without an index-signature cast. */
+function setConsoleMethod(method, fn) {
+    switch (method) {
+        case ConsoleMethod.log:
+            console.log = fn;
+            break;
+        case ConsoleMethod.info:
+            console.info = fn;
+            break;
+        case ConsoleMethod.warn:
+            console.warn = fn;
+            break;
+        case ConsoleMethod.error:
+            console.error = fn;
+            break;
+        case ConsoleMethod.debug:
+            console.debug = fn;
+            break;
+    }
+}
+/**
+ * `DyNTS_Progress_Util` — the public surface of the progress line, plus the **pure** formatting
+ * helpers, so the behaviour can be unit-tested without a terminal.
+ */
+class DyNTS_Progress_Util {
+    /**
+     * Starts a new progress line.
+     *
+     * **At most one progress line can be active at a time**, because there is only one physical
+     * "bottom line" in a terminal; two lines overwriting each other would only produce confusion.
+     * If one is already active when `start` is called, that one is closed (`done()`) and the new
+     * line takes its place.
+     */
+    static start(options) {
+        activeLine?.done();
+        const line = new ProgressLine(options);
+        activeLine = line;
+        if (line.isInteractive) {
+            installConsole();
+        }
+        return line;
+    }
+    /**
+     * Decides whether an in-place line makes sense.
+     *
+     * Order of precedence: explicit `enabled`, then `DYNTS_NO_PROGRESS`, then the stream's TTY flag.
+     * `stdout` is never accepted, because machine-readable output goes there.
+     */
+    static isInteractive(set) {
+        if (set?.enabled !== undefined) {
+            return set.enabled;
+        }
+        if (process.env.DYNTS_NO_PROGRESS) {
+            return false;
+        }
+        const stream = set?.stream ?? process.stderr;
+        if (stream === process.stdout) {
+            return false;
+        }
+        return Boolean(stream.isTTY);
+    }
+    /** Whether the next plain line is due in non-TTY mode. Pure, therefore testable. */
+    static shouldEmitPlain(set) {
+        return set.nowMs - set.lastEmitMs >= set.everyMs;
+    }
+    /**
+     * Renders the bar. `current` is always clamped to `[0, total]`, so a caller that miscounts
+     * cannot produce a broken (negative or overflowing) bar.
+     */
+    static renderBar(set) {
+        if (set.total <= 0 || set.width <= 0) {
+            return '';
+        }
+        const ratio = Math.min(1, Math.max(0, set.current / set.total));
+        const filled = Math.round(ratio * set.width);
+        return `[${'█'.repeat(filled)}${'░'.repeat(set.width - filled)}]`;
+    }
+    /** Percentage, rounded to an integer and clamped to `[0, 100]`. */
+    static percent(set) {
+        if (set.total <= 0) {
+            return 0;
+        }
+        return Math.min(100, Math.max(0, Math.round((set.current / set.total) * 100)));
+    }
+    /** Elapsed time in a short, human-readable form; the line has to fit on one terminal row. */
+    static formatElapsed(ms) {
+        const totalSeconds = Math.max(0, Math.floor(ms / 1000));
+        const minutes = Math.floor(totalSeconds / 60);
+        const seconds = totalSeconds % 60;
+        return minutes > 0
+            ? `${minutes}m${String(seconds).padStart(2, '0')}s`
+            : `${seconds}s`;
+    }
+    /**
+     * Builds the full progress text.
+     *
+     * With a known `total`: bar, percentage and `current/total`. With an unknown `total`: spinner and
+     * counter only — a ratio is never invented for a number that was never provided.
+     */
+    static formatLine(set) {
+        const head = set.total !== undefined && set.total > 0
+            ? `${DyNTS_Progress_Util.renderBar({ current: set.current, total: set.total, width: set.barWidth })} ` +
+                `${String(DyNTS_Progress_Util.percent({ current: set.current, total: set.total })).padStart(3)}% ` +
+                `${set.current}/${set.total}`
+            : `${set.spinner} ${set.current}`;
+        const tail = set.note ? ` · ${set.note}` : '';
+        return `${set.label} ${head} · ${DyNTS_Progress_Util.formatElapsed(set.elapsedMs)}${tail}`;
+    }
+}
+exports.DyNTS_Progress_Util = DyNTS_Progress_Util;
+//# sourceMappingURL=progress-line.util.js.map

package/build/_collections/progress-line.util.js.map

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

package/build/_collections/progress-options.interface.d.ts

@@ -0,0 +1,21 @@
+/** Options for starting a progress line. */
+export interface DyNTS_Progress_Options {
+    /** Name of the operation; rendered at the start of the line (for example `'scan: agent-memory'`). */
+    label: string;
+    /** Total number of steps, when known up front. Without it a spinner and a counter are shown. */
+    total?: number;
+    /** Destination stream. Defaults to `process.stderr`; stdout is refused (pipe purity). */
+    stream?: {
+        readonly isTTY?: boolean;
+        write(chunk: string): boolean;
+    };
+    /** Minimum delay between two redraws on a TTY, in ms. Default 80 — without it drawing burns CPU. */
+    throttleMs?: number;
+    /** Minimum delay between two plain lines in non-TTY mode, in ms. Default 5000. */
+    plainEveryMs?: number;
+    /** Width of the bar in characters; only used when `total` is known. Default 24. */
+    barWidth?: number;
+    /** Explicit on/off. When omitted, the stream's TTY flag and `DYNTS_NO_PROGRESS` decide. */
+    enabled?: boolean;
+}
+//# sourceMappingURL=progress-options.interface.d.ts.map

package/build/_collections/progress-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-options.interface.d.ts","sourceRoot":"","sources":["../../src/_collections/progress-options.interface.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACrC,qGAAqG;IACrG,KAAK,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACrE,oGAAoG;IACpG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/build/_collections/progress-options.interface.js

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

package/build/_collections/progress-options.interface.js.map

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

package/build/_modules/privacy-lifecycle/_enums/privacy-rights-notification-state.type-enum.d.ts

@@ -0,0 +1,15 @@
+/** Durable notification states; ambiguous SMTP delivery is terminal until an operator resolves it. */
+export declare enum DyNTS_PrivacyRightsNotificationState_Type {
+    pending = "pending",
+    dispatching = "dispatching",
+    submitted = "submitted",
+    rejected = "rejected",
+    manualReview = "manual-review"
+}
+/** Persisted submission channel, including the explicit not-yet-submitted state. */
+export declare enum DyNTS_PrivacyRightsNotificationChannel_Type {
+    none = "none",
+    smtp = "smtp",
+    testSink = "test-sink"
+}
+//# sourceMappingURL=privacy-rights-notification-state.type-enum.d.ts.map

package/build/_modules/privacy-lifecycle/_enums/privacy-rights-notification-state.type-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-rights-notification-state.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/privacy-lifecycle/_enums/privacy-rights-notification-state.type-enum.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,oBAAY,yCAAyC;IACnD,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,YAAY,kBAAkB;CAC/B;AAED,oFAAoF;AACpF,oBAAY,2CAA2C;IACrD,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,cAAc;CACvB"}

package/build/_modules/privacy-lifecycle/_enums/privacy-rights-notification-state.type-enum.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_PrivacyRightsNotificationChannel_Type = exports.DyNTS_PrivacyRightsNotificationState_Type = void 0;
+/** Durable notification states; ambiguous SMTP delivery is terminal until an operator resolves it. */
+var DyNTS_PrivacyRightsNotificationState_Type;
+(function (DyNTS_PrivacyRightsNotificationState_Type) {
+    DyNTS_PrivacyRightsNotificationState_Type["pending"] = "pending";
+    DyNTS_PrivacyRightsNotificationState_Type["dispatching"] = "dispatching";
+    DyNTS_PrivacyRightsNotificationState_Type["submitted"] = "submitted";
+    DyNTS_PrivacyRightsNotificationState_Type["rejected"] = "rejected";
+    DyNTS_PrivacyRightsNotificationState_Type["manualReview"] = "manual-review";
+})(DyNTS_PrivacyRightsNotificationState_Type || (exports.DyNTS_PrivacyRightsNotificationState_Type = DyNTS_PrivacyRightsNotificationState_Type = {}));
+/** Persisted submission channel, including the explicit not-yet-submitted state. */
+var DyNTS_PrivacyRightsNotificationChannel_Type;
+(function (DyNTS_PrivacyRightsNotificationChannel_Type) {
+    DyNTS_PrivacyRightsNotificationChannel_Type["none"] = "none";
+    DyNTS_PrivacyRightsNotificationChannel_Type["smtp"] = "smtp";
+    DyNTS_PrivacyRightsNotificationChannel_Type["testSink"] = "test-sink";
+})(DyNTS_PrivacyRightsNotificationChannel_Type || (exports.DyNTS_PrivacyRightsNotificationChannel_Type = DyNTS_PrivacyRightsNotificationChannel_Type = {}));
+//# sourceMappingURL=privacy-rights-notification-state.type-enum.js.map

package/build/_modules/privacy-lifecycle/_enums/privacy-rights-notification-state.type-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-rights-notification-state.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/privacy-lifecycle/_enums/privacy-rights-notification-state.type-enum.ts"],"names":[],"mappings":";;;AAAA,sGAAsG;AACtG,IAAY,yCAMX;AAND,WAAY,yCAAyC;IACnD,gEAAmB,CAAA;IACnB,wEAA2B,CAAA;IAC3B,oEAAuB,CAAA;IACvB,kEAAqB,CAAA;IACrB,2EAA8B,CAAA;AAChC,CAAC,EANW,yCAAyC,yDAAzC,yCAAyC,QAMpD;AAED,oFAAoF;AACpF,IAAY,2CAIX;AAJD,WAAY,2CAA2C;IACrD,4DAAa,CAAA;IACb,4DAAa,CAAA;IACb,qEAAsB,CAAA;AACxB,CAAC,EAJW,2CAA2C,2DAA3C,2CAA2C,QAItD"}

package/build/_modules/privacy-lifecycle/_models/privacy-rights-notification.interface.d.ts

@@ -0,0 +1,63 @@
+import { ClientSession, Connection } from 'mongoose';
+import { DyNTS_EmailSubmissionOutcome_Enum } from '../../../_enums/email-submission-outcome.enum';
+import { DyNTS_EmailSubmissionReceipt_Interface } from '../../../_models/interfaces/email-submission-receipt.interface';
+import { DyNTS_PrivacyRightsNotificationChannel_Type, DyNTS_PrivacyRightsNotificationState_Type } from '../_enums/privacy-rights-notification-state.type-enum';
+import { DyNTS_PrivacyRightsAuthority_Interface } from './privacy-rights-custody.interface';
+import { DyNTS_PrivacyRightsExecutionReceipt_Interface } from './privacy-rights-execution.interface';
+/** Content-free durable notification projection. Recipient, subject and body are deliberately absent. */
+export interface DyNTS_PrivacyRightsNotificationView_Interface extends DyNTS_PrivacyRightsAuthority_Interface {
+    readonly contractVersion: 'dynts-privacy-rights-notification/1';
+    readonly executionReference: string;
+    readonly executionCompletedAt: string;
+    readonly templateCode: string;
+    readonly state: DyNTS_PrivacyRightsNotificationState_Type;
+    readonly attemptCount: number;
+    readonly channel: DyNTS_PrivacyRightsNotificationChannel_Type;
+    readonly outcome: '' | DyNTS_EmailSubmissionOutcome_Enum;
+    readonly submissionReference: string;
+    readonly acceptedCount: number;
+    readonly rejectedCount: number;
+    readonly pendingCount: number;
+    readonly completedAt: string;
+    readonly created: boolean;
+}
+/** Internal strict-schema record. The raw claim token and all message content are forbidden. */
+export interface DyNTS_PrivacyRightsNotificationRecord_Interface extends Omit<DyNTS_PrivacyRightsNotificationView_Interface, 'created'> {
+    _id: string;
+    readonly revision: number;
+    readonly claimTokenHash: string;
+    readonly claimedAt: string;
+    readonly claimExpiresAt: string;
+}
+/** A claim token is returned only to the worker that won the durable dispatch fence. */
+export interface DyNTS_PrivacyRightsNotificationClaimResult_Interface {
+    readonly contractVersion: 'dynts-privacy-rights-notification-claim/1';
+    readonly claimed: boolean;
+    readonly claimToken: string;
+    readonly notification: DyNTS_PrivacyRightsNotificationView_Interface;
+}
+/** Terminal completion input from the existing content-free email submission boundary. */
+export interface DyNTS_PrivacyRightsNotificationCompletion_Interface extends DyNTS_PrivacyRightsAuthority_Interface {
+    readonly contractVersion: 'dynts-privacy-rights-notification-completion/1';
+    readonly claimToken: string;
+    readonly submission: DyNTS_EmailSubmissionReceipt_Interface;
+}
+/** Marks an attempted submission as unknown without retaining the transport error. */
+export interface DyNTS_PrivacyRightsNotificationIndeterminate_Interface extends DyNTS_PrivacyRightsAuthority_Interface {
+    readonly contractVersion: 'dynts-privacy-rights-notification-indeterminate/1';
+    readonly claimToken: string;
+}
+/** Shared durable outbox settings. Product code chooses a closed set of server-owned template codes. */
+export interface DyNTS_PrivacyRightsNotificationSettings_Interface {
+    readonly connection: Connection;
+    readonly maxOperationTimeMs: number;
+    readonly claimTimeMs: number;
+    readonly templateCodes: readonly string[];
+}
+/** Transactional schedule input intentionally carries the already validated execution receipt. */
+export interface DyNTS_PrivacyRightsNotificationSchedule_Interface {
+    readonly execution: DyNTS_PrivacyRightsExecutionReceipt_Interface;
+    readonly templateCode: string;
+    readonly session: ClientSession;
+}
+//# sourceMappingURL=privacy-rights-notification.interface.d.ts.map

package/build/_modules/privacy-lifecycle/_models/privacy-rights-notification.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-rights-notification.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/privacy-lifecycle/_models/privacy-rights-notification.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAErD,OAAO,EAAE,iCAAiC,EAAE,MAAM,+CAA+C,CAAC;AAClG,OAAO,EAAE,sCAAsC,EAAE,MAAM,gEAAgE,CAAC;AACxH,OAAO,EACL,2CAA2C,EAC3C,yCAAyC,EAC1C,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EAAE,sCAAsC,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,6CAA6C,EAAE,MAAM,sCAAsC,CAAC;AAErG,yGAAyG;AACzG,MAAM,WAAW,6CAA8C,SAAQ,sCAAsC;IAC3G,QAAQ,CAAC,eAAe,EAAE,qCAAqC,CAAC;IAChE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,yCAAyC,CAAC;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,2CAA2C,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,EAAE,GAAG,iCAAiC,CAAC;IACzD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,gGAAgG;AAChG,MAAM,WAAW,+CACjB,SAAQ,IAAI,CAAC,6CAA6C,EAAE,SAAS,CAAC;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wFAAwF;AACxF,MAAM,WAAW,oDAAoD;IACnE,QAAQ,CAAC,eAAe,EAAE,2CAA2C,CAAC;IACtE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,6CAA6C,CAAC;CACtE;AAED,0FAA0F;AAC1F,MAAM,WAAW,mDACjB,SAAQ,sCAAsC;IAC5C,QAAQ,CAAC,eAAe,EAAE,gDAAgD,CAAC;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,sCAAsC,CAAC;CAC7D;AAED,sFAAsF;AACtF,MAAM,WAAW,sDACjB,SAAQ,sCAAsC;IAC5C,QAAQ,CAAC,eAAe,EAAE,mDAAmD,CAAC;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wGAAwG;AACxG,MAAM,WAAW,iDAAiD;IAChE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,kGAAkG;AAClG,MAAM,WAAW,iDAAiD;IAChE,QAAQ,CAAC,SAAS,EAAE,6CAA6C,CAAC;IAClE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC"}