@marinoscar/platform-api 0.1.0-next.3 → 0.1.0-next.4

package/dist/jobs/retention/batched-purge.js

@@ -0,0 +1,150 @@
+"use strict";
+// =============================================================================
+// Batched retention purge — the shared loop behind the four retention jobs
+// (#681, platform-packages PP-1.10; moved into the jobs slice by #898)
+// =============================================================================
+//
+// `notifications.inbox.purge`, `notifications.deliveries.purge`,
+// `audit.events.purge` and `ai.runs.purge` all do the same thing to a different
+// table: delete the rows older than a cutoff, a bounded batch at a time. This
+// file is that loop, written once, with the semantics `AiUsagePurgeHandler`
+// established (`ai/usage/ai-usage-purge.handler.ts`):
+//
+//   - BATCHED, OLDEST FIRST. `selectIds` reads at most `batchSize` ids older
+//     than the cutoff, ordered by `created_at`, and `deleteIds` deletes EXACTLY
+//     those ids — never by re-running the `where`, which could reach rows the
+//     read never saw. No single statement holds locks on a large slice of a
+//     table the application inserts into on every user action.
+//   - A SHORT BATCH ENDS THE RUN. Fewer ids than asked for means nothing older
+//     than the cutoff is left.
+//   - A SAFETY STOP. The loop's exit depends on rows disappearing; a bounded
+//     loop stops having done real work if that ever stops being true. The stop
+//     logs a warning, and the next run continues from the same cutoff, so the
+//     purge is idempotent.
+//
+// ONE COPY, owned by the jobs slice and exported from it
+// (`@marinoscar/platform-api/jobs`). Until #898 the reference app and the ai
+// slice each carried a byte-for-byte copy; the ai slice's `ai.runs.purge` and
+// the notifications slice's two purges now import this one.
+//
+// `AiUsagePurgeHandler` and `JobHistoryPurgeHandler` are deliberately NOT moved
+// onto this helper (no unrelated refactors in #681); a later change may.
+//
+// `runRetentionPolicyPurge` wraps the loop in what every retention handler
+// also shares: re-read the policy, be a logged no-op while it is disabled, and
+// write one summary line per run.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RETENTION_PURGE_MAX_BATCHES = exports.RETENTION_PURGE_BATCH_SIZE = void 0;
+exports.purgeInBatches = purgeInBatches;
+exports.retentionCutoff = retentionCutoff;
+exports.runRetentionPolicyPurge = runRetentionPolicyPurge;
+/**
+ * Ids per batch — a lock-duration bound, as in `ai-usage-purge.handler.ts`.
+ *
+ * @stability experimental
+ */
+exports.RETENTION_PURGE_BATCH_SIZE = 5000;
+/**
+ * Safety stop on the batch loop (5 million rows a run); the next run continues from the same cutoff.
+ *
+ * @stability experimental
+ */
+exports.RETENTION_PURGE_MAX_BATCHES = 1000;
+const DAY_MS = 24 * 60 * 60 * 1000;
+/**
+ * Deletes in bounded batches until a batch comes back short or the safety stop
+ * is reached. Errors from `selectIds`/`deleteIds` propagate, so a queue job
+ * built on this fails and is retried.
+ *
+ * @param options - the reader, the deleter and the optional bounds.
+ * @returns what the loop deleted, in how many batches, and whether it stopped early.
+ * @throws RangeError when `batchSize` or `maxBatches` is not a positive integer.
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+async function purgeInBatches(options) {
+    const batchSize = options.batchSize ?? exports.RETENTION_PURGE_BATCH_SIZE;
+    const maxBatches = options.maxBatches ?? exports.RETENTION_PURGE_MAX_BATCHES;
+    if (!Number.isInteger(batchSize) || batchSize < 1) {
+        throw new RangeError(`batchSize must be a positive integer, got ${batchSize}`);
+    }
+    if (!Number.isInteger(maxBatches) || maxBatches < 1) {
+        throw new RangeError(`maxBatches must be a positive integer, got ${maxBatches}`);
+    }
+    let deleted = 0;
+    let batches = 0;
+    let exhausted = false;
+    while (batches < maxBatches) {
+        const ids = await options.selectIds(batchSize);
+        if (ids.length === 0) {
+            exhausted = true;
+            break;
+        }
+        // By the exact ids read, never by re-running the `where`.
+        deleted += await options.deleteIds(ids);
+        batches += 1;
+        if (ids.length < batchSize) {
+            exhausted = true;
+            break;
+        }
+    }
+    const hitSafetyStop = !exhausted;
+    if (hitSafetyStop) {
+        options.logger?.warn(`${capitalise(options.what ?? 'retention purge')} stopped at its ${maxBatches}-batch safety ` +
+            `limit after deleting ${deleted} row(s); the next run continues from the same cutoff.`);
+    }
+    return { deleted, batches, hitSafetyStop };
+}
+/**
+ * `now - days`, the instant before which a row is purged.
+ *
+ * @param days - the policy's retention in days.
+ * @param now - the clock, in epoch milliseconds (tests pin it).
+ * @returns the cutoff instant.
+ *
+ * @stability experimental
+ */
+function retentionCutoff(days, now = Date.now()) {
+    return new Date(now - days * DAY_MS);
+}
+/**
+ * The body of every retention handler: a logged no-op while the policy is
+ * disabled, otherwise `purgeInBatches` from `now - policy.days` and one summary
+ * line (deleted, cutoff, retention days, batches, job id).
+ *
+ * THE POLICY IS CHECKED HERE AS WELL AS IN THE SCHEDULING TASK, deliberately —
+ * the argument `job-history-purge.handler.ts` makes. The 01:00 task is not the
+ * only way a purge row appears: an admin rerun of a historical row, or a job
+ * queued just before the switch was flipped, would otherwise delete data an
+ * operator believes they stopped deleting.
+ *
+ * @param options - the job, logger, policy and the table's reader and deleter.
+ * @returns `null` for the disabled no-op, otherwise the loop's result.
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+async function runRetentionPolicyPurge(options) {
+    const { job, logger, policy, setting, what } = options;
+    if (!policy.enabled) {
+        logger.log(`${capitalise(what)} is disabled (${setting}.enabled); job ${job.id} is a no-op`);
+        return null;
+    }
+    const cutoff = retentionCutoff(policy.days);
+    const result = await purgeInBatches({
+        selectIds: (take) => options.selectIds(cutoff, take),
+        deleteIds: options.deleteIds,
+        logger,
+        what,
+    });
+    logger.log(`${capitalise(what)} removed ${result.deleted} ${options.rows} created before ` +
+        `${cutoff.toISOString()} (retention ${policy.days} day(s)) in ${result.batches} batch(es) ` +
+        `(job ${job.id})`);
+    return result;
+}
+function capitalise(phrase) {
+    return phrase.charAt(0).toUpperCase() + phrase.slice(1);
+}
+//# sourceMappingURL=batched-purge.js.map

package/dist/jobs/retention/batched-purge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batched-purge.js","sourceRoot":"","sources":["../../../src/jobs/retention/batched-purge.ts"],"names":[],"mappings":"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"}

package/dist/jobs/retention/retention-policy.registry.d.ts

@@ -0,0 +1,108 @@
+import { type RetentionPolicyKey } from '@marinoscar/platform-contract/jobs';
+/**
+ * The purge job that enforces one retention policy: what the scheduler
+ * enqueues. The handler itself is a normal `JobHandler` (the platform's
+ * `runRetentionPolicyPurge` does the batched delete), mounted by the module that
+ * owns the table.
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface RetentionPurgeHandler {
+    /**
+     * The purge's job type, the handler's own `type`. PERMANENT once rows of it
+     * exist. One policy per type.
+     */
+    type: string;
+    /** A human phrase for the scheduler's log lines ("import row purge"). */
+    what: string;
+}
+/**
+ * One retention policy: a table that joins the nightly retention.
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface RetentionPolicyDefinition {
+    /**
+     * The key in `system_settings.value.retention`. Matches
+     * `RETENTION_POLICY_KEY_PATTERN` (2 to 48 letters and digits, a lower-case
+     * letter first). PERMANENT: renaming it orphans the operator's setting.
+     */
+    key: string;
+    /** What an operator reads for this table ("Import rows"). */
+    label: string;
+    /** Days kept before the policy is changed. 1 to 3650, within the bounds below. */
+    defaultDays: number;
+    /**
+     * Whether the purge runs before an operator decides. Defaults to `false`:
+     * deleting rows is an explicit decision, and the platform ships three of its
+     * four on only because those tables had no retention at all.
+     */
+    defaultEnabled?: boolean | undefined;
+    /** Smallest `days` an operator may set. Defaults to 1. */
+    minDays?: number | undefined;
+    /** Largest `days` an operator may set. Defaults to 3650 (ten years). */
+    maxDays?: number | undefined;
+    /** The job that enforces it. */
+    purge: RetentionPurgeHandler;
+}
+/**
+ * The registered retention policies, in registration order (the four built-ins first).
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare const retentionPolicyRegistry: import("../../core/index").Registry<RetentionPolicyDefinition>;
+/**
+ * Registers a retention policy: the table joins the nightly retention, the
+ * `retention` settings namespace gains the key (schema, default and merge), and
+ * the scheduler enqueues the policy's purge when its handler is mounted. Call it
+ * at import time (an app's `app-registrations/`), before the application
+ * bootstraps and before anything reads the composed namespace.
+ *
+ * @param policy - the key, label, window, bounds and purge job.
+ * @throws RegistryError `INVALID_ID`, `INVALID_ENTRY`, `DUPLICATE_ID` or `FROZEN`; Error when the namespace was already composed.
+ *
+ * @example
+ * ```ts
+ * registerRetentionPolicy({
+ *   key: 'importRows',
+ *   label: 'Import rows',
+ *   defaultDays: 30,
+ *   minDays: 7,
+ *   purge: { type: 'app.import-rows.purge', what: 'import row purge' },
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerRetentionPolicy(policy: RetentionPolicyDefinition): void;
+/**
+ * Every registered policy, in registration order.
+ *
+ * @returns a fresh array.
+ *
+ * @stability experimental
+ */
+export declare function listRetentionPolicies(): RetentionPolicyDefinition[];
+/**
+ * Closes registration: the namespace is being composed from the policies
+ * registered so far. Called by the composition; not for app code.
+ *
+ * @param by - what composed it, for the error a late registration gets.
+ *
+ * @internal
+ */
+export declare function sealRetentionPolicies(by: string): void;
+/**
+ * Whether `key` is a registered retention policy.
+ *
+ * @param key - a candidate key.
+ * @returns true when registered.
+ *
+ * @stability experimental
+ */
+export declare function isRetentionPolicyKey(key: RetentionPolicyKey): boolean;
+//# sourceMappingURL=retention-policy.registry.d.ts.map

package/dist/jobs/retention/retention-policy.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-policy.registry.d.ts","sourceRoot":"","sources":["../../../src/jobs/retention/retention-policy.registry.ts"],"names":[],"mappings":"AA6BA,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,oCAAoC,CAAC;AAI5C;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,gCAAgC;IAChC,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,gEAsBlC,CAAC;AAIH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI,CAgB/E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,yBAAyB,EAAE,CAEnE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAErE"}

package/dist/jobs/retention/retention-policy.registry.js

@@ -0,0 +1,182 @@
+"use strict";
+// =============================================================================
+// The retention policy registry: which tables the nightly retention governs
+// =============================================================================
+//
+// The `retention` system-settings namespace used to be four fixed keys, so an
+// app table could not join the nightly purge. A POLICY is now a registry entry:
+// a key, the words an operator reads, the default window, the bounds an
+// operator may set, and the purge job that enforces it. The namespace's
+// schemas, defaults and PATCH merge are COMPOSED from this registry
+// (`retention.system-settings.ts`), and the platform's own four register here
+// through the same function an app uses.
+//
+// ORDER IS BEHAVIOUR. The built-ins register first (this file, at import), so
+// they keep their stored key order, and an app's policies follow in
+// registration order.
+//
+// IMPORT TIME, AND SEALED. A static registry: the app registers from
+// `app-registrations/` before the application bootstraps. The composed
+// namespace is built the first time anything reads it (the settings registry
+// validates it when it registers it) and a policy registered AFTER that would
+// be stored but never validated or returned, so `registerRetentionPolicy`
+// throws once the namespace is composed, naming the fix.
+//
+// WHICH JOB RUNS IT is a separate, per-process fact (`RetentionPurgeRegistry`):
+// the purge handler declares itself from `onModuleInit`, so the scheduler only
+// enqueues a purge whose handler is mounted. A policy with no mounted handler
+// is configurable and simply never queued.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retentionPolicyRegistry = void 0;
+exports.registerRetentionPolicy = registerRetentionPolicy;
+exports.listRetentionPolicies = listRetentionPolicies;
+exports.sealRetentionPolicies = sealRetentionPolicies;
+exports.isRetentionPolicyKey = isRetentionPolicyKey;
+const jobs_1 = require("@marinoscar/platform-contract/jobs");
+const index_1 = require("../../core/index");
+/**
+ * The registered retention policies, in registration order (the four built-ins first).
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.retentionPolicyRegistry = (0, index_1.defineRegistry)({
+    name: 'retention-policies',
+    idOf: (policy) => policy.key,
+    idPattern: jobs_1.RETENTION_POLICY_KEY_PATTERN,
+    validate: (policy, registry) => {
+        if (typeof policy.label !== 'string' || policy.label.trim() === '')
+            throw new Error('label must be a non-empty string');
+        const min = policy.minDays ?? jobs_1.RETENTION_MIN_DAYS;
+        const max = policy.maxDays ?? jobs_1.RETENTION_MAX_DAYS;
+        if (!Number.isInteger(min) || !Number.isInteger(max) || min < jobs_1.RETENTION_MIN_DAYS || max > jobs_1.RETENTION_MAX_DAYS || min > max) {
+            throw new Error(`minDays/maxDays must be whole days with ${jobs_1.RETENTION_MIN_DAYS} <= minDays <= maxDays <= ${jobs_1.RETENTION_MAX_DAYS}`);
+        }
+        if (!Number.isInteger(policy.defaultDays) || policy.defaultDays < min || policy.defaultDays > max) {
+            throw new Error(`defaultDays must be a whole number of days within ${min}..${max}`);
+        }
+        if (policy.defaultEnabled !== undefined && typeof policy.defaultEnabled !== 'boolean')
+            throw new Error('defaultEnabled must be a boolean');
+        const purge = policy.purge;
+        if (!purge?.type?.trim() || !purge.what?.trim())
+            throw new Error('purge needs a non-empty type and what');
+        const clash = registry.list().find((other) => other.purge.type === purge.type);
+        if (clash)
+            throw new Error(`purge job type "${purge.type}" already enforces retention policy "${clash.key}"; a job type enforces exactly one policy`);
+    },
+    describeDuplicate: (_existing, incoming) => `Retention policy "${incoming.key}" is already registered. A policy key is permanent and names the operator's setting; pick another key.`,
+});
+let sealedBy;
+/**
+ * Registers a retention policy: the table joins the nightly retention, the
+ * `retention` settings namespace gains the key (schema, default and merge), and
+ * the scheduler enqueues the policy's purge when its handler is mounted. Call it
+ * at import time (an app's `app-registrations/`), before the application
+ * bootstraps and before anything reads the composed namespace.
+ *
+ * @param policy - the key, label, window, bounds and purge job.
+ * @throws RegistryError `INVALID_ID`, `INVALID_ENTRY`, `DUPLICATE_ID` or `FROZEN`; Error when the namespace was already composed.
+ *
+ * @example
+ * ```ts
+ * registerRetentionPolicy({
+ *   key: 'importRows',
+ *   label: 'Import rows',
+ *   defaultDays: 30,
+ *   minDays: 7,
+ *   purge: { type: 'app.import-rows.purge', what: 'import row purge' },
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+function registerRetentionPolicy(policy) {
+    if (sealedBy !== undefined) {
+        throw new Error(`Retention policy "${String(policy?.key)}" was registered after ${sealedBy}: the retention namespace is composed once, ` +
+            'from the policies registered by then. Register it at import time, before the settings registry reads RETENTION_SYSTEM_SETTINGS.');
+    }
+    exports.retentionPolicyRegistry.register({
+        key: policy.key,
+        label: policy.label,
+        defaultDays: policy.defaultDays,
+        ...(policy.defaultEnabled !== undefined ? { defaultEnabled: policy.defaultEnabled } : {}),
+        ...(policy.minDays !== undefined ? { minDays: policy.minDays } : {}),
+        ...(policy.maxDays !== undefined ? { maxDays: policy.maxDays } : {}),
+        purge: { type: policy.purge.type, what: policy.purge.what },
+    });
+}
+/**
+ * Every registered policy, in registration order.
+ *
+ * @returns a fresh array.
+ *
+ * @stability experimental
+ */
+function listRetentionPolicies() {
+    return exports.retentionPolicyRegistry.list();
+}
+/**
+ * Closes registration: the namespace is being composed from the policies
+ * registered so far. Called by the composition; not for app code.
+ *
+ * @param by - what composed it, for the error a late registration gets.
+ *
+ * @internal
+ */
+function sealRetentionPolicies(by) {
+    sealedBy ??= by;
+}
+/**
+ * Whether `key` is a registered retention policy.
+ *
+ * @param key - a candidate key.
+ * @returns true when registered.
+ *
+ * @stability experimental
+ */
+function isRetentionPolicyKey(key) {
+    return exports.retentionPolicyRegistry.has(key);
+}
+// The platform's own four, through the same function an app uses. Their
+// defaults are the shipped ones, byte for byte: three tables on, the audit
+// trail (a compliance record) off.
+//
+// ⚠ ENABLED BY DEFAULT for three of the four, and that was a behaviour change
+// on upgrade: the first 01:00 run after deploying deletes every existing row
+// older than its window. That is the purpose; these tables had no retention at
+// all. `docs/runbooks/data-retention.md` says so. `auditEvents` ships OFF.
+const BUILTIN_POLICIES = {
+    notifications: {
+        key: 'notifications',
+        label: 'In-app inbox',
+        defaultEnabled: true,
+        defaultDays: 180,
+        purge: { type: 'notifications.inbox.purge', what: 'notification inbox purge' },
+    },
+    notificationDeliveries: {
+        key: 'notificationDeliveries',
+        label: 'Delivery log',
+        defaultEnabled: true,
+        defaultDays: 90,
+        purge: { type: 'notifications.deliveries.purge', what: 'delivery log purge' },
+    },
+    auditEvents: {
+        key: 'auditEvents',
+        label: 'Audit trail',
+        defaultEnabled: false,
+        defaultDays: 365,
+        purge: { type: 'audit.events.purge', what: 'audit log purge' },
+    },
+    aiRuns: {
+        key: 'aiRuns',
+        label: 'Background AI runs',
+        defaultEnabled: true,
+        defaultDays: 90,
+        purge: { type: 'ai.runs.purge', what: 'AI run purge' },
+    },
+};
+for (const key of jobs_1.BUILTIN_RETENTION_POLICY_KEYS)
+    registerRetentionPolicy(BUILTIN_POLICIES[key]);
+//# sourceMappingURL=retention-policy.registry.js.map

package/dist/jobs/retention/retention-policy.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-policy.registry.js","sourceRoot":"","sources":["../../../src/jobs/retention/retention-policy.registry.ts"],"names":[],"mappings":"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"}

package/dist/jobs/retention/retention-purge.registry.d.ts

@@ -0,0 +1,60 @@
+import type { RetentionPolicyKey } from '@marinoscar/platform-contract/jobs';
+/**
+ * One retention purge: which job type enforces which `retention.*` policy, and
+ * what to call it in a log line.
+ *
+ * @stability experimental
+ */
+export interface RetentionPurgeEntry {
+    /**
+     * The `retention` namespace key this purge enforces: a registered policy
+     * (`registerRetentionPolicy`), a built-in or an app's.
+     */
+    policy: RetentionPolicyKey;
+    /** The purge's job type. The handler's own `type`, never re-typed. */
+    type: string;
+    /** A human phrase for the scheduler's log lines ("notification inbox purge"). */
+    what: string;
+}
+/**
+ * The retention purges mounted in this process, in the namespace's key order.
+ * A purge handler calls {@link RetentionPurgeRegistry.register} from
+ * `onModuleInit`; the nightly {@link RetentionPurgeTask} enqueues one job per
+ * enabled policy it lists.
+ *
+ * @example
+ * ```ts
+ * onModuleInit(): void {
+ *   this.registry.register(this);
+ *   this.retention.register({ policy: 'aiRuns', type: this.type, what: 'AI run purge' });
+ * }
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare class RetentionPurgeRegistry {
+    private readonly entries;
+    /**
+     * Declares a purge. Registering a policy again replaces its entry (the last
+     * registration wins, like the handler registry).
+     *
+     * @param entry - the policy, the job type and the log phrase.
+     * @throws Error when the policy was not registered with `registerRetentionPolicy` or a field is empty.
+     */
+    register(entry: RetentionPurgeEntry): void;
+    /**
+     * The purge declared for `policy`, if its handler declared one.
+     *
+     * @param policy - the `retention` key.
+     * @returns a copy, or `undefined`.
+     */
+    get(policy: RetentionPolicyKey): RetentionPurgeEntry | undefined;
+    /**
+     * Every registered purge, in the namespace's key order (built-ins first, then the app's policies in registration order).
+     *
+     * @returns a fresh array of copies.
+     */
+    list(): RetentionPurgeEntry[];
+}
+//# sourceMappingURL=retention-purge.registry.d.ts.map

package/dist/jobs/retention/retention-purge.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-purge.registry.d.ts","sourceRoot":"","sources":["../../../src/jobs/retention/retention-purge.registry.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAI7E;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,EAAE,kBAAkB,CAAC;IAC3B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAe1C;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,SAAS;IAMhE;;;;OAIG;IACH,IAAI,IAAI,mBAAmB,EAAE;CAO9B"}

package/dist/jobs/retention/retention-purge.registry.js

@@ -0,0 +1,96 @@
+"use strict";
+// =============================================================================
+// The retention purge registry (issue #898)
+// =============================================================================
+//
+// The nightly scheduler (`retention-purge.task.ts`) has to know which job type
+// enforces which `retention.*` policy, and only for the purges whose handler is
+// loaded in this process: a deployment without the notifications slice never
+// queues a job no handler would claim. The purges belong to the slices that own
+// the tables (`ai.runs.purge` to ai, the two notification purges to
+// notifications, `audit.events.purge` to this slice), so each handler DECLARES
+// its own entry from `onModuleInit`, next to `JobHandlerRegistry.register(this)`.
+//
+// A policy registered with `registerRetentionPolicy` already names its
+// `purge.type`, so an app's handler may skip this registry entirely: the
+// scheduler also enqueues a policy whose `purge.type` has a mounted handler. An
+// entry declared here wins over the policy's own type and phrase.
+//
+// An instance registry rather than a process-wide map: the entry is true only
+// while the handler's module is mounted, which is Nest's lifecycle, not the
+// module graph's import time. Provided and exported by `JobsModule`.
+// =============================================================================
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetentionPurgeRegistry = void 0;
+const common_1 = require("@nestjs/common");
+const retention_policy_registry_1 = require("./retention-policy.registry");
+/**
+ * The retention purges mounted in this process, in the namespace's key order.
+ * A purge handler calls {@link RetentionPurgeRegistry.register} from
+ * `onModuleInit`; the nightly {@link RetentionPurgeTask} enqueues one job per
+ * enabled policy it lists.
+ *
+ * @example
+ * ```ts
+ * onModuleInit(): void {
+ *   this.registry.register(this);
+ *   this.retention.register({ policy: 'aiRuns', type: this.type, what: 'AI run purge' });
+ * }
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+let RetentionPurgeRegistry = class RetentionPurgeRegistry {
+    entries = new Map();
+    /**
+     * Declares a purge. Registering a policy again replaces its entry (the last
+     * registration wins, like the handler registry).
+     *
+     * @param entry - the policy, the job type and the log phrase.
+     * @throws Error when the policy was not registered with `registerRetentionPolicy` or a field is empty.
+     */
+    register(entry) {
+        const policy = retention_policy_registry_1.retentionPolicyRegistry.get(entry.policy);
+        if (policy === undefined) {
+            throw new Error(`RetentionPurgeRegistry.register: "${String(entry.policy)}" is not a registered retention policy ` +
+                `(${retention_policy_registry_1.retentionPolicyRegistry.ids().join(', ')}). Register it first with registerRetentionPolicy.`);
+        }
+        if (!entry.type?.trim() || !entry.what?.trim()) {
+            throw new Error('RetentionPurgeRegistry.register: type and what must be non-empty strings.');
+        }
+        this.entries.set(entry.policy, { ...entry });
+    }
+    /**
+     * The purge declared for `policy`, if its handler declared one.
+     *
+     * @param policy - the `retention` key.
+     * @returns a copy, or `undefined`.
+     */
+    get(policy) {
+        const entry = this.entries.get(policy);
+        return entry ? { ...entry } : undefined;
+    }
+    /**
+     * Every registered purge, in the namespace's key order (built-ins first, then the app's policies in registration order).
+     *
+     * @returns a fresh array of copies.
+     */
+    list() {
+        return retention_policy_registry_1.retentionPolicyRegistry.ids().flatMap((key) => {
+            const entry = this.entries.get(key);
+            return entry ? [{ ...entry }] : [];
+        });
+    }
+};
+exports.RetentionPurgeRegistry = RetentionPurgeRegistry;
+exports.RetentionPurgeRegistry = RetentionPurgeRegistry = __decorate([
+    (0, common_1.Injectable)()
+], RetentionPurgeRegistry);
+//# sourceMappingURL=retention-purge.registry.js.map

package/dist/jobs/retention/retention-purge.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-purge.registry.js","sourceRoot":"","sources":["../../../src/jobs/retention/retention-purge.registry.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,oEAAoE;AACpE,+EAA+E;AAC/E,kFAAkF;AAClF,EAAE;AACF,uEAAuE;AACvE,yEAAyE;AACzE,gFAAgF;AAChF,kEAAkE;AAClE,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,qEAAqE;AACrE,gFAAgF;;;;;;;;;AAEhF,2CAA4C;AAG5C,2EAAsE;AAoBtE;;;;;;;;;;;;;;;;GAgBG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAChB,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;IAElE;;;;;;OAMG;IACH,QAAQ,CAAC,KAA0B;QACjC,MAAM,MAAM,GAAG,mDAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,qCAAqC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,yCAAyC;gBAChG,IAAI,mDAAuB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,oDAAoD,CACnG,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;QAC/F,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,MAA0B;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEvC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,mDAAuB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACnD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAEpC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAjDY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;GACA,sBAAsB,CAiDlC"}

package/dist/jobs/retention/retention-purge.task.d.ts

@@ -0,0 +1,23 @@
+import { SystemSettingsService } from '../../settings/index';
+import type { JobsPrisma } from '../data/jobs-db';
+import { JobHandlerRegistry } from '../job-handler.registry';
+import { JobsService } from '../jobs.service';
+import { RetentionPurgeRegistry } from './retention-purge.registry';
+/**
+ * The nightly retention scheduler: for each ENABLED `retention.*` policy whose
+ * purge handler is mounted, enqueues one global purge job. It deletes nothing.
+ *
+ * @stability experimental
+ */
+export declare class RetentionPurgeTask {
+    private readonly jobs;
+    private readonly prisma;
+    private readonly systemSettings;
+    private readonly purges;
+    private readonly handlers?;
+    private readonly logger;
+    constructor(jobs: JobsService, prisma: JobsPrisma, systemSettings: SystemSettingsService, purges: RetentionPurgeRegistry, handlers?: JobHandlerRegistry | undefined);
+    /** The 01:00 tick: decide, then enqueue. Never throws. */
+    handleCron(): Promise<void>;
+}
+//# sourceMappingURL=retention-purge.task.d.ts.map

package/dist/jobs/retention/retention-purge.task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-purge.task.d.ts","sourceRoot":"","sources":["../../../src/jobs/retention/retention-purge.task.ts"],"names":[],"mappings":"AAgCA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAGpE;;;;;GAKG;AACH,qBACa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACI,OAAO,CAAC,QAAQ,CAAC,MAAM;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACX,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAPxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;gBAG3C,IAAI,EAAE,WAAW,EACQ,MAAM,EAAE,UAAU,EAC3C,cAAc,EAAE,qBAAqB,EACrC,MAAM,EAAE,sBAAsB,EAClB,QAAQ,CAAC,EAAE,kBAAkB,YAAA;IAG5D,0DAA0D;IAEpD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAuClC"}