@futdevpro/nts-dynamo 1.15.256 → 1.15.262

package/build/_modules/media-gen/_services/media-gen.registry.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_MediaGen_Registry = void 0;
+/**
+ * The two-key registry: provider × operation → adapter.
+ *
+ * Generalised from the master-prompter `generationProviders` table (`ProviderType × AiModelType`). An instance
+ * rather than a module-level constant: a product registers the adapters it ships, and a test builds its own
+ * registry without touching global state.
+ */
+class DyNTS_MediaGen_Registry {
+    services = new Map();
+    /**
+     * Registers an adapter under every operation it declares.
+     *
+     * Refuses an adapter that declares no operation (it could never be resolved), and a second, different adapter
+     * for a pair that is already taken - a silent replacement would hide which adapter actually serves the call.
+     * Registering the same instance again is a no-op.
+     */
+    register(service) {
+        if (!service.operations.length) {
+            throw new Error(`DyNTS_MediaGen_Registry: ${service.constructor.name} (provider '${service.provider}') declares no operations.`);
+        }
+        const byOperation = this.services.get(service.provider) ?? new Map();
+        for (const operation of service.operations) {
+            const existing = byOperation.get(operation);
+            if (existing && existing !== service) {
+                throw new Error(`DyNTS_MediaGen_Registry: '${operation}' of provider '${service.provider}' is already served by `
+                    + `${existing.constructor.name}; registering ${service.constructor.name} would silently replace it.`);
+            }
+        }
+        for (const operation of service.operations) {
+            byOperation.set(operation, service);
+        }
+        this.services.set(service.provider, byOperation);
+    }
+    /**
+     * The adapter serving `operation` for `provider`. When there is none, the error says what IS available:
+     * the provider's operations if the provider is known, otherwise the providers serving the operation.
+     */
+    resolve(provider, operation) {
+        const service = this.services.get(provider)?.get(operation);
+        if (service) {
+            return service;
+        }
+        const providerOperations = [...(this.services.get(provider)?.keys() ?? [])];
+        if (providerOperations.length) {
+            throw new Error(`DyNTS_MediaGen_Registry: provider '${provider}' does not serve '${operation}'. `
+                + `It serves: ${providerOperations.join(', ')}.`);
+        }
+        const operationProviders = this.entries()
+            .filter((entry) => entry.operation === operation)
+            .map((entry) => entry.provider);
+        throw new Error(`DyNTS_MediaGen_Registry: no provider '${provider}' is registered. `
+            + `'${operation}' is served by: ${operationProviders.length ? operationProviders.join(', ') : 'no provider'}.`);
+    }
+    /**
+     * Every registered provider × operation pair, in registration order.
+     */
+    entries() {
+        const entries = [];
+        for (const [provider, byOperation] of this.services) {
+            for (const operation of byOperation.keys()) {
+                entries.push({ provider: provider, operation: operation });
+            }
+        }
+        return entries;
+    }
+}
+exports.DyNTS_MediaGen_Registry = DyNTS_MediaGen_Registry;
+//# sourceMappingURL=media-gen.registry.js.map

package/build/_modules/media-gen/_services/media-gen.registry.js.map

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

package/build/_modules/media-gen/_services/media-gen.service-base.d.ts

@@ -0,0 +1,30 @@
+import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
+import { DyNTS_MediaGen_Operation } from '../_models/media-gen-operation.type';
+/**
+ * Base of one media-generation provider adapter (OpenAI Images, ElevenLabs, Leonardo, Meshy, Synexa, ...).
+ *
+ * Generalised from the master-prompter `Generation_ServiceBase`. Two things are left out on purpose:
+ * - the flow-run coupling (step connectors, flow nodes) - a request object replaces it;
+ * - the token-cost methods - cost accounting stays in the product that sells the credits (K-9).
+ *
+ * What remains is what every adapter needs: who it is, which operations it serves, the call itself, and
+ * prompt assembly from a `Đ{key}` template. Capability is data: `operations` is what the registry indexes,
+ * so an adapter that cannot edit simply does not list `image-edit`, and a caller asking for it is told what
+ * the adapter CAN do.
+ */
+export declare abstract class DyNTS_MediaGen_ServiceBase<T_Request, T_Response> extends DyNTS_SingletonService {
+    /** Stable provider id (e.g. `openai`, `elevenlabs`) - the registry's first key. */
+    abstract readonly provider: string;
+    /** The operations this adapter serves - the registry's second key. Must match what `generate` handles. */
+    abstract readonly operations: readonly DyNTS_MediaGen_Operation[];
+    /**
+     * Performs one generation.
+     */
+    abstract generate(operation: DyNTS_MediaGen_Operation, request: T_Request, issuer: string): Promise<T_Response>;
+    /**
+     * Assembles the exact prompt from a `Đ{key}` template (see `DyNTS_MediaGen_Prompt_Util.fill`), and reports
+     * a failure with this adapter's error settings.
+     */
+    protected assemblePrompt(template: string, values: Record<string, unknown>, issuer: string): string;
+}
+//# sourceMappingURL=media-gen.service-base.d.ts.map

package/build/_modules/media-gen/_services/media-gen.service-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen.service-base.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/media-gen.service-base.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAEnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAE/E;;;;;;;;;;;GAWG;AACH,8BAAsB,0BAA0B,CAAC,SAAS,EAAE,UAAU,CAAE,SAAQ,sBAAsB;IAEpG,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAEnC,0GAA0G;IAC1G,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAElE;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,wBAAwB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAE/G;;;OAGG;IACH,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;CAepG"}

package/build/_modules/media-gen/_services/media-gen.service-base.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_MediaGen_ServiceBase = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const singleton_service_1 = require("../../../_services/base/singleton.service");
+const media_gen_prompt_util_1 = require("../_collections/media-gen-prompt.util");
+/**
+ * Base of one media-generation provider adapter (OpenAI Images, ElevenLabs, Leonardo, Meshy, Synexa, ...).
+ *
+ * Generalised from the master-prompter `Generation_ServiceBase`. Two things are left out on purpose:
+ * - the flow-run coupling (step connectors, flow nodes) - a request object replaces it;
+ * - the token-cost methods - cost accounting stays in the product that sells the credits (K-9).
+ *
+ * What remains is what every adapter needs: who it is, which operations it serves, the call itself, and
+ * prompt assembly from a `Đ{key}` template. Capability is data: `operations` is what the registry indexes,
+ * so an adapter that cannot edit simply does not list `image-edit`, and a caller asking for it is told what
+ * the adapter CAN do.
+ */
+class DyNTS_MediaGen_ServiceBase extends singleton_service_1.DyNTS_SingletonService {
+    /**
+     * Assembles the exact prompt from a `Đ{key}` template (see `DyNTS_MediaGen_Prompt_Util.fill`), and reports
+     * a failure with this adapter's error settings.
+     */
+    assemblePrompt(template, values, issuer) {
+        try {
+            return media_gen_prompt_util_1.DyNTS_MediaGen_Prompt_Util.fill(template, values);
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('assemblePrompt', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MG-AP0`,
+                additionalContent: {
+                    provider: this.provider,
+                    keys: media_gen_prompt_util_1.DyNTS_MediaGen_Prompt_Util.getKeys(template ?? ''),
+                    providedKeys: Object.keys(values ?? {}),
+                },
+            });
+        }
+    }
+}
+exports.DyNTS_MediaGen_ServiceBase = DyNTS_MediaGen_ServiceBase;
+//# sourceMappingURL=media-gen.service-base.js.map

package/build/_modules/media-gen/_services/media-gen.service-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen.service-base.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/media-gen.service-base.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAEnD,uFAAoF;AACpF,iFAAmF;AACnF,iFAAmF;AAGnF;;;;;;;;;;;GAWG;AACH,MAAsB,0BAAkD,SAAQ,0CAAsB;IAapG;;;OAGG;IACO,cAAc,CAAC,QAAgB,EAAE,MAA+B,EAAE,MAAc;QACxF,IAAI,CAAC;YACH,OAAO,kDAA0B,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uBAAU,CAAC;gBACnB,GAAG,IAAI,CAAC,uBAAuB,CAAC,gBAAgB,EAAE,KAAK,EAAE,MAAM,CAAC;gBAChE,SAAS,EAAE,GAAG,6CAAqB,CAAC,mBAAmB,eAAe;gBACtE,iBAAiB,EAAE;oBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,IAAI,EAAE,kDAA0B,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;oBACxD,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;iBACxC;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAhCD,gEAgCC"}

package/build/_modules/media-gen/index.d.ts

@@ -0,0 +1,5 @@
+export * from './_models/media-gen-operation.type';
+export * from './_collections/media-gen-prompt.util';
+export * from './_services/media-gen.service-base';
+export * from './_services/media-gen.registry';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/media-gen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/media-gen/index.ts"],"names":[],"mappings":"AAUA,cAAc,oCAAoC,CAAC;AAGnD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC"}

package/build/_modules/media-gen/index.js

@@ -0,0 +1,17 @@
+"use strict";
+//
+// Media generation module (media-generation hyperplan, MP-5)
+//
+// The provider-independent generation engine: an adapter base class and the provider × operation registry.
+// Cost accounting is deliberately NOT here - it stays in the product that sells the credits.
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// MODELS
+tslib_1.__exportStar(require("./_models/media-gen-operation.type"), exports);
+// COLLECTIONS
+tslib_1.__exportStar(require("./_collections/media-gen-prompt.util"), exports);
+// SERVICES
+tslib_1.__exportStar(require("./_services/media-gen.service-base"), exports);
+tslib_1.__exportStar(require("./_services/media-gen.registry"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/media-gen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/media-gen/index.ts"],"names":[],"mappings":";AACA,EAAE;AACF,6DAA6D;AAC7D,EAAE;AACF,2GAA2G;AAC3G,6FAA6F;AAC7F,EAAE;;;AAGF,SAAS;AACT,6EAAmD;AAEnD,cAAc;AACd,+EAAqD;AAErD,WAAW;AACX,6EAAmD;AACnD,yEAA+C"}

package/build/_services/server/app.server.d.ts

@@ -216,6 +216,50 @@ export interface DyNTS_TtlIndexCollection {
  *   maintenance, not silently at every startup.
  */
 export type DyNTS_TtlIndexAction = 'created' | 'differs' | 'noop';
+/**
+ * FR-BFR-041 / SR-3 — one declared COMPOUND / PARTIAL index, as the startup installer READS it.
+ *
+ * Declared STRUCTURALLY on purpose — mirrors `DyFM_DeclaredIndex` (`@futdevpro/fsm-dynamo` >= 1.20.38),
+ * which is the source of truth for the declaration shape. It is NOT imported, because this package pins
+ * `@futdevpro/fsm-dynamo` as an EXACT peer (1.20.37): importing the new symbol would force every consumer
+ * onto a new exact peer in the same wave (an unsatisfiable peer set for anyone still on 1.20.37). Reading
+ * the field structurally keeps this change strictly additive.
+ */
+export interface DyNTS_DeclaredIndexInfo {
+    name: string;
+    keys: Record<string, 1 | -1>;
+    unique?: boolean;
+    partialFilterExpression?: Record<string, unknown>;
+}
+/** FR-BFR-041 / SR-3 — one live index entry from `collection.indexes()` (only the fields the installer compares). */
+export interface DyNTS_DeclaredIndexLiveInfo {
+    name?: string;
+    key?: Record<string, number>;
+    unique?: boolean;
+    partialFilterExpression?: Record<string, unknown>;
+}
+/** FR-BFR-041 / SR-3 — the options the installer passes to `createIndex`. */
+export interface DyNTS_DeclaredIndexCreateOptions {
+    name: string;
+    unique?: boolean;
+    partialFilterExpression?: Record<string, unknown>;
+}
+/**
+ * FR-BFR-041 / SR-3 — the minimal native-driver collection surface the declared-index installer needs.
+ * Structural (no mongodb type import) so it stays dependency-light and trivially mockable.
+ */
+export interface DyNTS_DeclaredIndexCollection {
+    indexes?: () => Promise<DyNTS_DeclaredIndexLiveInfo[]>;
+    createIndex: (keys: Record<string, number>, options: DyNTS_DeclaredIndexCreateOptions) => Promise<unknown>;
+}
+/**
+ * FR-BFR-041 / SR-3 — outcome of {@link DyNTS_App.ensureDeclaredIndex}.
+ * - `created`: no index with this name existed -> it was created.
+ * - `noop`:    an index with this name and the SAME keys / uniqueness / partial filter already exists.
+ * - `differs`: an index with this name exists but DIFFERS -> left UNTOUCHED, only reported (same boot-safety
+ *   rule as the retention TTL index: never drop + rebuild a live index inside the startup path).
+ */
+export type DyNTS_DeclaredIndexAction = 'created' | 'differs' | 'noop';
 export declare abstract class DyNTS_App extends DyNTS_SingletonService {
     protected systemControls: DyNTS_AppSystemControls;
     get started(): boolean;
@@ -338,6 +382,35 @@ export declare abstract class DyNTS_App extends DyNTS_SingletonService {
      * CHANGE on an already-indexed collection is a maintenance action, not a silent every-boot rebuild.
      */
     static ensureRetentionTtlIndex(collection: DyNTS_TtlIndexCollection, ttlSeconds: number): Promise<DyNTS_TtlIndexAction>;
+    /**
+     * FR-BFR-041 / SR-3 — install the declared COMPOUND / PARTIAL indexes of every registered DB service.
+     *
+     * Runs in the SAME deferred, fire-and-forget window as the retention TTL installer, with the same guarantees:
+     * - **Non-fatal** — every error is reported as a safe diagnostic and NEVER blocks or crashes startup. A
+     *   unique index build over data that already holds duplicates is rejected by MongoDB — that rejection is
+     *   caught per index and reported, it does not stop the other indexes.
+     * - **Idempotent + boot-safe** — an identical index is a no-op; a DIFFERING index is reported, never rebuilt.
+     * - **Archive-aware** — the auto-created `_archived` siblings copy the parent's params (spread), so they
+     *   would inherit the declaration. A UNIQUE index is SKIPPED on them: an archive may legitimately hold the
+     *   same key more than once, and a unique index there could make archiving itself fail.
+     */
+    private installDeclaredIndexes;
+    /**
+     * FR-BFR-041 / SR-3 — read and validate the `indexes` declaration of a data-model STRUCTURALLY.
+     *
+     * Returns only the installable entries (a non-empty `name`, at least one key, every key direction `1` or
+     * `-1`, optional `unique` boolean, optional `partialFilterExpression` object). On an archive sibling a
+     * `unique` entry is dropped (see {@link DyNTS_App.installDeclaredIndexes}). Pure + side-effect-free.
+     */
+    static resolveDeclaredIndexes(dataParams: unknown, isArchive: boolean): DyNTS_DeclaredIndexInfo[];
+    /**
+     * FR-BFR-041 / SR-3 — ensure ONE declared index. Matching is by NAME (the stable reconciliation key):
+     * - no live index with that name                          -> create it -> `'created'`
+     * - same name, same keys (ORDER matters), same uniqueness
+     *   and same partial filter                               -> nothing   -> `'noop'`
+     * - same name, anything else different                    -> untouched -> `'differs'` (reported, never rebuilt)
+     */
+    static ensureDeclaredIndex(collection: DyNTS_DeclaredIndexCollection, declared: DyNTS_DeclaredIndexInfo): Promise<DyNTS_DeclaredIndexAction>;
     /**
      *
      */

package/build/_services/server/app.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.server.d.ts","sourceRoot":"","sources":["../../../src/_services/server/app.server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app.server.d.ts","sourceRoot":"","sources":["../../../src/_services/server/app.server.ts"],"names":[],"mappings":"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"}

package/build/_services/server/app.server.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DyNTS_App = void 0;
 const tslib_1 = require("tslib");
 const Mongoose = require("mongoose");
+const archive_util_1 = require("../../_collections/archive.util");
 const Express = require("express");
 /* import Mongoose from 'mongoose';
 import Express from 'express'; */
@@ -605,8 +606,12 @@ class DyNTS_App extends singleton_service_1.DyNTS_SingletonService {
                     // cold boot is never slowed by it, then run it detached. `.unref()` keeps it from holding
                     // the event loop open. Any failure is logged but never crashes the app. (`'differs'` never
                     // rebuilds a live index — see ensureRetentionTtlIndex.)
+                    // FR-BFR-041 / SR-3 — the declared COMPOUND / PARTIAL indexes ride in the SAME deferred,
+                    // detached, non-fatal window (a unique index build is heavier than a TTL probe, so it must
+                    // never compete with boot-readiness either).
                     const ttlInstallTimer = setTimeout(() => {
                         void this.installRetentionTtlIndexes();
+                        void this.installDeclaredIndexes();
                     }, 30000);
                     if (typeof ttlInstallTimer.unref === 'function') {
                         ttlInstallTimer.unref();
@@ -761,6 +766,148 @@ class DyNTS_App extends singleton_service_1.DyNTS_SingletonService {
         // boot — only report it. Avoids a heavy drop+recreate competing with boot-readiness on a large collection.
         return 'differs';
     }
+    /**
+     * FR-BFR-041 / SR-3 — install the declared COMPOUND / PARTIAL indexes of every registered DB service.
+     *
+     * Runs in the SAME deferred, fire-and-forget window as the retention TTL installer, with the same guarantees:
+     * - **Non-fatal** — every error is reported as a safe diagnostic and NEVER blocks or crashes startup. A
+     *   unique index build over data that already holds duplicates is rejected by MongoDB — that rejection is
+     *   caught per index and reported, it does not stop the other indexes.
+     * - **Idempotent + boot-safe** — an identical index is a no-op; a DIFFERING index is reported, never rebuilt.
+     * - **Archive-aware** — the auto-created `_archived` siblings copy the parent's params (spread), so they
+     *   would inherit the declaration. A UNIQUE index is SKIPPED on them: an archive may legitimately hold the
+     *   same key more than once, and a unique index there could make archiving itself fail.
+     */
+    async installDeclaredIndexes() {
+        try {
+            const services = global_service_1.DyNTS_GlobalService.getAllDBServices();
+            let ensured = 0;
+            for (const service of services) {
+                const dataName = `${service?.dataParams?.dataName ?? ''}`;
+                const declared = DyNTS_App.resolveDeclaredIndexes(service?.dataParams, dataName.includes(archive_util_1.DyNTS_archiveSuffix));
+                if (!declared.length) {
+                    continue;
+                }
+                // The mongoose Model exposes the native driver collection (.indexes / .createIndex).
+                const collection = service?.dataModel?.collection;
+                if (!collection || typeof collection.createIndex !== 'function') {
+                    continue;
+                }
+                for (const index of declared) {
+                    try {
+                        const action = await DyNTS_App.ensureDeclaredIndex(collection, index);
+                        if (action === 'created') {
+                            ensured++;
+                            if (this.logSetup) {
+                                fsm_dynamo_1.DyFM_Log.success(`[FR-BFR-041 indexes] declared index "${index.name}" created on "${dataName}"`);
+                            }
+                        }
+                        else if (action === 'differs') {
+                            this.reportSafeDiagnostic('DYNTS-AS0-DECLARED-INDEX-DIFFERS', safe_diagnostic_stage_type_enum_1.DyNTS_SafeDiagnosticStage_Type.databaseRuntime, new Error(`declared-index-differs: ${dataName}.${index.name}`));
+                        }
+                    }
+                    catch (idxErr) {
+                        this.reportSafeDiagnostic('DYNTS-AS0-DECLARED-INDEX-FAILED', safe_diagnostic_stage_type_enum_1.DyNTS_SafeDiagnosticStage_Type.databaseRuntime, idxErr);
+                    }
+                }
+            }
+            if (ensured > 0) {
+                fsm_dynamo_1.DyFM_Log.success(`[FR-BFR-041 indexes] ${ensured} declared index(es) ensured.`);
+            }
+        }
+        catch (err) {
+            this.reportSafeDiagnostic('DYNTS-AS0-DECLARED-INDEX-INSTALLER-FAILED', safe_diagnostic_stage_type_enum_1.DyNTS_SafeDiagnosticStage_Type.databaseRuntime, err);
+        }
+    }
+    /**
+     * FR-BFR-041 / SR-3 — read and validate the `indexes` declaration of a data-model STRUCTURALLY.
+     *
+     * Returns only the installable entries (a non-empty `name`, at least one key, every key direction `1` or
+     * `-1`, optional `unique` boolean, optional `partialFilterExpression` object). On an archive sibling a
+     * `unique` entry is dropped (see {@link DyNTS_App.installDeclaredIndexes}). Pure + side-effect-free.
+     */
+    static resolveDeclaredIndexes(dataParams, isArchive) {
+        if (!dataParams || typeof dataParams !== 'object') {
+            return [];
+        }
+        const raw = Reflect.get(dataParams, 'indexes');
+        if (!Array.isArray(raw)) {
+            return [];
+        }
+        const valid = [];
+        for (const entry of raw) {
+            if (!entry || typeof entry !== 'object') {
+                continue;
+            }
+            const name = Reflect.get(entry, 'name');
+            const keys = Reflect.get(entry, 'keys');
+            const unique = Reflect.get(entry, 'unique');
+            const partial = Reflect.get(entry, 'partialFilterExpression');
+            if (typeof name !== 'string' || !name.trim()) {
+                continue;
+            }
+            if (!keys || typeof keys !== 'object' || Array.isArray(keys)) {
+                continue;
+            }
+            const keyEntries = Object.entries(keys);
+            if (!keyEntries.length || keyEntries.some(([, dir]) => dir !== 1 && dir !== -1)) {
+                continue;
+            }
+            if (unique !== undefined && typeof unique !== 'boolean') {
+                continue;
+            }
+            if (partial !== undefined && (!partial || typeof partial !== 'object' || Array.isArray(partial))) {
+                continue;
+            }
+            if (isArchive && unique === true) {
+                continue;
+            }
+            const normalizedKeys = {};
+            for (const [field, dir] of keyEntries) {
+                normalizedKeys[field] = dir === -1 ? -1 : 1;
+            }
+            const index = { name: name, keys: normalizedKeys };
+            // Narrowed here explicitly: the earlier combined guard already rejected non-boolean values, but the
+            // compiler does not carry that negative narrowing forward to this assignment.
+            if (typeof unique === 'boolean') {
+                index.unique = unique;
+            }
+            if (partial !== undefined) {
+                index.partialFilterExpression = Object.fromEntries(Object.entries(partial));
+            }
+            valid.push(index);
+        }
+        return valid;
+    }
+    /**
+     * FR-BFR-041 / SR-3 — ensure ONE declared index. Matching is by NAME (the stable reconciliation key):
+     * - no live index with that name                          -> create it -> `'created'`
+     * - same name, same keys (ORDER matters), same uniqueness
+     *   and same partial filter                               -> nothing   -> `'noop'`
+     * - same name, anything else different                    -> untouched -> `'differs'` (reported, never rebuilt)
+     */
+    static async ensureDeclaredIndex(collection, declared) {
+        const liveList = typeof collection.indexes === 'function'
+            ? await collection.indexes().catch(() => [])
+            : [];
+        const live = liveList.find((ix) => ix?.name === declared.name);
+        if (!live) {
+            const options = { name: declared.name };
+            if (declared.unique !== undefined) {
+                options.unique = declared.unique;
+            }
+            if (declared.partialFilterExpression !== undefined) {
+                options.partialFilterExpression = declared.partialFilterExpression;
+            }
+            await collection.createIndex(declared.keys, options);
+            return 'created';
+        }
+        // Key ORDER is part of a MongoDB index definition, so the entries are compared in order.
+        const sameKeys = JSON.stringify(Object.entries(live.key ?? {})) === JSON.stringify(Object.entries(declared.keys));
+        const sameUnique = !!live.unique === !!declared.unique;
+        const samePartial = JSON.stringify(live.partialFilterExpression ?? null) === JSON.stringify(declared.partialFilterExpression ?? null);
+        return sameKeys && sameUnique && samePartial ? 'noop' : 'differs';
+    }
     /**
      *
      */