@futdevpro/nts-dynamo 1.15.258 → 1.15.262

package/build/_modules/media-gen/_collections/media-gen-prompt.util.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Placeholder handling for media-generation prompt templates.
+ *
+ * A template marks an input as `Đ{key}` - the marker the master-prompter flow runner already uses
+ * (`PromptKeys_Util`), so its templates work unchanged. A key may contain any character except `}`.
+ */
+export declare class DyNTS_MediaGen_Prompt_Util {
+    /** `Đ{` + one or more non-`}` characters + `}`. Only used via `matchAll` / `replace`, which share no state. */
+    private static readonly placeholderPattern;
+    /**
+     * The distinct keys a template references, in first-appearance order.
+     */
+    static getKeys(template: string): string[];
+    /**
+     * Fills every placeholder of `template` from `values`, and returns the exact prompt.
+     *
+     * Refuses - naming EVERY offending key at once - when a referenced key has no own value (absent, `undefined`,
+     * `null` or an empty string) or holds an object or function. A prompt with a hole in it still costs a paid call
+     * and produces a wrong asset; and an object would silently render as `[object Object]`, which the
+     * master-prompter donor measured happening in a real prompt.
+     */
+    static fill(template: string, values: Record<string, unknown>): string;
+}
+//# sourceMappingURL=media-gen-prompt.util.d.ts.map

package/build/_modules/media-gen/_collections/media-gen-prompt.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen-prompt.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_collections/media-gen-prompt.util.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,0BAA0B;IAErC,+GAA+G;IAC/G,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAErE;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAY1C;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CA8BvE"}

package/build/_modules/media-gen/_collections/media-gen-prompt.util.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_MediaGen_Prompt_Util = void 0;
+/**
+ * Placeholder handling for media-generation prompt templates.
+ *
+ * A template marks an input as `Đ{key}` - the marker the master-prompter flow runner already uses
+ * (`PromptKeys_Util`), so its templates work unchanged. A key may contain any character except `}`.
+ */
+class DyNTS_MediaGen_Prompt_Util {
+    /** `Đ{` + one or more non-`}` characters + `}`. Only used via `matchAll` / `replace`, which share no state. */
+    static placeholderPattern = /Đ\{([^}]+)\}/g;
+    /**
+     * The distinct keys a template references, in first-appearance order.
+     */
+    static getKeys(template) {
+        const keys = [];
+        for (const match of template.matchAll(DyNTS_MediaGen_Prompt_Util.placeholderPattern)) {
+            if (!keys.includes(match[1])) {
+                keys.push(match[1]);
+            }
+        }
+        return keys;
+    }
+    /**
+     * Fills every placeholder of `template` from `values`, and returns the exact prompt.
+     *
+     * Refuses - naming EVERY offending key at once - when a referenced key has no own value (absent, `undefined`,
+     * `null` or an empty string) or holds an object or function. A prompt with a hole in it still costs a paid call
+     * and produces a wrong asset; and an object would silently render as `[object Object]`, which the
+     * master-prompter donor measured happening in a real prompt.
+     */
+    static fill(template, values) {
+        if (!template) {
+            throw new Error('DyNTS_MediaGen_Prompt_Util: the prompt template is empty.');
+        }
+        const keys = DyNTS_MediaGen_Prompt_Util.getKeys(template);
+        const missing = keys.filter((key) => {
+            const value = Object.prototype.hasOwnProperty.call(values, key) ? values[key] : undefined;
+            return value === undefined || value === null || value === '';
+        });
+        const notText = keys.filter((key) => {
+            const value = Object.prototype.hasOwnProperty.call(values, key) ? values[key] : undefined;
+            return value !== null && (typeof value === 'object' || typeof value === 'function');
+        });
+        if (missing.length || notText.length) {
+            throw new Error('DyNTS_MediaGen_Prompt_Util: the prompt template cannot be filled.'
+                + (missing.length ? ` No value for: ${missing.join(', ')}.` : '')
+                + (notText.length ? ` Not a text value (object or function): ${notText.join(', ')}.` : ''));
+        }
+        return template.replace(DyNTS_MediaGen_Prompt_Util.placeholderPattern, (placeholder, key) => String(values[key]));
+    }
+}
+exports.DyNTS_MediaGen_Prompt_Util = DyNTS_MediaGen_Prompt_Util;
+//# sourceMappingURL=media-gen-prompt.util.js.map

package/build/_modules/media-gen/_collections/media-gen-prompt.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen-prompt.util.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_collections/media-gen-prompt.util.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,0BAA0B;IAErC,+GAA+G;IACvG,MAAM,CAAU,kBAAkB,GAAW,eAAe,CAAC;IAErE;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,QAAgB;QAC7B,MAAM,IAAI,GAAa,EAAE,CAAC;QAE1B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,0BAA0B,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACrF,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CAAC,QAAgB,EAAE,MAA+B;QAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,IAAI,GAAa,0BAA0B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpE,MAAM,OAAO,GAAa,IAAI,CAAC,MAAM,CAAC,CAAC,GAAW,EAAW,EAAE;YAC7D,MAAM,KAAK,GAAY,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAEnG,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAa,IAAI,CAAC,MAAM,CAAC,CAAC,GAAW,EAAW,EAAE;YAC7D,MAAM,KAAK,GAAY,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAEnG,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,mEAAmE;kBACjE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;kBAC/D,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,2CAA2C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC3F,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,OAAO,CACrB,0BAA0B,CAAC,kBAAkB,EAC7C,CAAC,WAAmB,EAAE,GAAW,EAAU,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAClE,CAAC;IACJ,CAAC;;AAzDH,gEA0DC"}

package/build/_modules/media-gen/_models/media-gen-operation.type.d.ts

@@ -0,0 +1,9 @@
+/**
+ * What a media-generation adapter can be asked to do - the registry's second key.
+ *
+ * A string union, not an enum, like `DyNTS_AI_EmbeddingProviderKey`: adapters and callers pass plain ids.
+ * The set covers the master-prompter provider table (`textToImage`, `imageTo3D`, `textTo3D`, `textToSpeech`)
+ * plus the two operations the `dc media-*` commands already serve (`image-edit`, `speech-to-text`).
+ */
+export type DyNTS_MediaGen_Operation = 'text-to-image' | 'image-edit' | 'text-to-speech' | 'speech-to-text' | 'image-to-3d' | 'text-to-3d';
+//# sourceMappingURL=media-gen-operation.type.d.ts.map

package/build/_modules/media-gen/_models/media-gen-operation.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen-operation.type.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_models/media-gen-operation.type.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAChC,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,YAAY,CAAC"}

package/build/_modules/media-gen/_models/media-gen-operation.type.js

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

package/build/_modules/media-gen/_models/media-gen-operation.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen-operation.type.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_models/media-gen-operation.type.ts"],"names":[],"mappings":""}

package/build/_modules/media-gen/_services/media-gen.registry.d.ts

@@ -0,0 +1,35 @@
+import { DyNTS_MediaGen_Operation } from '../_models/media-gen-operation.type';
+import { DyNTS_MediaGen_ServiceBase } from './media-gen.service-base';
+/** One registered pair, as `entries()` lists it. */
+export interface DyNTS_MediaGen_RegistryEntry {
+    provider: string;
+    operation: DyNTS_MediaGen_Operation;
+}
+/**
+ * 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.
+ */
+export declare class DyNTS_MediaGen_Registry {
+    private readonly services;
+    /**
+     * 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: DyNTS_MediaGen_ServiceBase<unknown, unknown>): void;
+    /**
+     * 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: string, operation: DyNTS_MediaGen_Operation): DyNTS_MediaGen_ServiceBase<unknown, unknown>;
+    /**
+     * Every registered provider × operation pair, in registration order.
+     */
+    entries(): DyNTS_MediaGen_RegistryEntry[];
+}
+//# sourceMappingURL=media-gen.registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-gen.registry.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/media-gen.registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,oDAAoD;AACpD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,wBAAwB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,qBAAa,uBAAuB;IAElC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CACb;IAEZ;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI;IA2BrE;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,wBAAwB,GAAG,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC;IA2B5G;;OAEG;IACH,OAAO,IAAI,4BAA4B,EAAE;CAW1C"}

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.258",
+  "version": "01.15.262",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",
@@ -294,6 +294,12 @@
       "module": "./build/_modules/test-email-sink/index.js",
       "types": "./build/_modules/test-email-sink/index.d.ts",
       "typings": "./build/_modules/test-email-sink/index.d.ts"
+    },
+    "./media-gen": {
+      "default": "./build/_modules/media-gen/index.js",
+      "module": "./build/_modules/media-gen/index.js",
+      "types": "./build/_modules/media-gen/index.d.ts",
+      "typings": "./build/_modules/media-gen/index.d.ts"
     }
   },
   "typesVersions": {
@@ -399,6 +405,9 @@
       ],
       "test-email-sink": [
         "build/_modules/test-email-sink/index.d.ts"
+      ],
+      "media-gen": [
+        "build/_modules/media-gen/index.d.ts"
       ]
     }
   },
@@ -415,7 +424,7 @@
     "@anthropic-ai/sdk": "~0.39.0",
     "@modelcontextprotocol/sdk": "~1.29.0",
     "better-sqlite3": "~12.4.1",
-    "@futdevpro/fsm-dynamo": "1.20.38",
+    "@futdevpro/fsm-dynamo": "1.20.42",
     "@types/express": "4.17.21",
     "@types/geoip-lite": "~1.4.4",
     "@types/node": "~24.1.0",
@@ -454,7 +463,7 @@
     }
   },
   "devDependencies": {
-    "@futdevpro/fsm-dynamo": "1.20.38",
+    "@futdevpro/fsm-dynamo": "1.20.42",
     "@futdevpro/dynamo-eslint": "1.20.18",
     "@discordjs/opus": "^0.10.0",
     "@discordjs/voice": "^0.18.0",