@futdevpro/nts-dynamo 1.15.262 → 1.15.263

package/build/_collections/get-environment-settings.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-environment-settings.util.d.ts","sourceRoot":"","sources":["../../src/_collections/get-environment-settings.util.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AAElG,wBAAgB,6BAA6B,IAAI,0BAA0B,CA6C1E"}
+{"version":3,"file":"get-environment-settings.util.d.ts","sourceRoot":"","sources":["../../src/_collections/get-environment-settings.util.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AAElG,wBAAgB,6BAA6B,IAAI,0BAA0B,CA8C1E"}

package/build/_collections/get-environment-settings.util.js

@@ -29,11 +29,11 @@ function DyNTS_getEnvironment_settings() {
             project: process.env.OPENAI_PROJECT,
             ttsApiKey: process.env.OPENAI_TTS_API_KEY,
         },
-        /* elevenLabs: {
-          apiKey: process.env.ELEVENLABS_API_KEY,
+        elevenLabs: {
+            apiKey: process.env.ELEVENLABS_API_KEY,
+            environment: process.env.ELEVENLABS_ENVIRONMENT,
         },
-    
-        clickup: {
+        /* clickup: {
           apiKey: process.env.CLICKUP_API_KEY,
           workspaceId: process.env.CLICKUP_WORKSPACE_ID,
           spaceId: process.env.CLICKUP_SPACE_ID,

package/build/_collections/get-environment-settings.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-environment-settings.util.js","sourceRoot":"","sources":["../../src/_collections/get-environment-settings.util.ts"],"names":[],"mappings":";;AAMA,sEA6CC;;AAnDD,uDAAiC;AAEjC,sDAAiG;AAIjG,SAAgB,6BAA6B;IAC3C,MAAM,CAAC,MAAM,EAAE,CAAC;IAEhB,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,iCAAoB,CAAC,KAAK,CAAC;IAE3G,GAAG,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;IAE9B,IAAI,CAAC,qCAAwB,CAAC,QAAQ,CAAC,GAA2B,CAAC,EAAE,CAAC;QACpE,qBAAQ,CAAC,KAAK,CAAC,yBAAyB,GAAG,8BAA8B,CAAC,CAAC;QAC3E,GAAG,GAAG,iCAAoB,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,OAAO;QACL,WAAW,EAAE,qCAAwB,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAA2B,CAAC,CAAC,CAAC;YACvF,OAAO,CAAC,GAAG,CAAC,GAA2B,CAAC,CAAC;YACzC,iCAAoB,CAAC,KAAK;QAG5B,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;YACrC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;YACpC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB;YAC3C,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;SAC9C;QAED,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS;QAExD,MAAM,EAAE;YACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YAClC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;YAC7C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YACnC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;SAC1C;QAED;;;;;;;;;aASK;KACN,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-environment-settings.util.js","sourceRoot":"","sources":["../../src/_collections/get-environment-settings.util.ts"],"names":[],"mappings":";;AAMA,sEA8CC;;AApDD,uDAAiC;AAEjC,sDAAiG;AAIjG,SAAgB,6BAA6B;IAC3C,MAAM,CAAC,MAAM,EAAE,CAAC;IAEhB,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,iCAAoB,CAAC,KAAK,CAAC;IAE3G,GAAG,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;IAE9B,IAAI,CAAC,qCAAwB,CAAC,QAAQ,CAAC,GAA2B,CAAC,EAAE,CAAC;QACpE,qBAAQ,CAAC,KAAK,CAAC,yBAAyB,GAAG,8BAA8B,CAAC,CAAC;QAC3E,GAAG,GAAG,iCAAoB,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,OAAO;QACL,WAAW,EAAE,qCAAwB,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAA2B,CAAC,CAAC,CAAC;YACvF,OAAO,CAAC,GAAG,CAAC,GAA2B,CAAC,CAAC;YACzC,iCAAoB,CAAC,KAAK;QAG5B,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;YACrC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;YACpC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB;YAC3C,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;SAC9C;QAED,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS;QAExD,MAAM,EAAE;YACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YAClC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;YAC7C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YACnC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;SAC1C;QAED,UAAU,EAAE;YACV,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;YACtC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;SAChD;QAED;;;;;aAKK;KACN,CAAC;AACJ,CAAC"}

package/build/_models/interfaces/environment-settings.interface.d.ts

@@ -31,5 +31,14 @@ export interface DyNTS_Environment_Settings {
         project: string;
         ttsApiKey: string;
     };
+    /**
+     * this is the elevenlabs settings of the system
+     */
+    elevenLabs?: {
+        /** `ELEVENLABS_API_KEY` */
+        apiKey: string;
+        /** `ELEVENLABS_ENVIRONMENT`: global (default) | us | eu-residency | india-residency | singapore-residency */
+        environment?: string;
+    };
 }
 //# sourceMappingURL=environment-settings.interface.d.ts.map

package/build/_models/interfaces/environment-settings.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environment-settings.interface.d.ts","sourceRoot":"","sources":["../../../src/_models/interfaces/environment-settings.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI7D,MAAM,WAAW,0BAA0B;IACzC;;;;;;;OAOG;IACH,WAAW,EAAE,oBAAoB,CAAC;IAElC;;OAEG;IACH,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CAmBH"}
+{"version":3,"file":"environment-settings.interface.d.ts","sourceRoot":"","sources":["../../../src/_models/interfaces/environment-settings.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI7D,MAAM,WAAW,0BAA0B;IACzC;;;;;;;OAOG;IACH,WAAW,EAAE,oBAAoB,CAAC;IAElC;;OAEG;IACH,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF;;OAEG;IACH,UAAU,CAAC,EAAE;QACX,2BAA2B;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,6GAA6G;QAC7G,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CAYH"}

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

@@ -0,0 +1,22 @@
+/** The ElevenLabs environments the provider documents. Anything else is refused rather than guessed at. */
+export type DyNTS_ElevenLabs_Environment = 'global' | 'us' | 'eu-residency' | 'india-residency' | 'singapore-residency';
+/**
+ * ElevenLabs region resolution: the environment name → the API host.
+ *
+ * The host table is the one `dynamo-cli` already runs in production (`DyCLI_MAP_ElevenLabsRegion_Util`),
+ * carried here unchanged, because the engine layer needs it too. A residency environment exists so the audio
+ * never leaves the region - so an unknown environment is an ERROR, never a silent fall back to the global host.
+ */
+export declare class DyNTS_ElevenLabsRegion_Util {
+    /** Host per environment. */
+    private static readonly baseUrls;
+    /**
+     * Accepts only the documented environments; `undefined` means `global`.
+     *
+     * @param value The raw value, typically `process.env.ELEVENLABS_ENVIRONMENT`.
+     */
+    static resolveEnvironment(value: string | undefined): DyNTS_ElevenLabs_Environment;
+    /** The API host of one environment. */
+    static getBaseUrl(environment: DyNTS_ElevenLabs_Environment): string;
+}
+//# sourceMappingURL=elevenlabs-region.util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-region.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_collections/elevenlabs-region.util.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,MAAM,MAAM,4BAA4B,GACpC,QAAQ,GACR,IAAI,GACJ,cAAc,GACd,iBAAiB,GACjB,qBAAqB,CAAC;AAE1B;;;;;;GAMG;AACH,qBAAa,2BAA2B;IAEtC,4BAA4B;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAM9B;IAEF;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,4BAA4B;IAqBlF,uCAAuC;IACvC,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,4BAA4B,GAAG,MAAM;CAGrE"}

package/build/_modules/media-gen/_collections/elevenlabs-region.util.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ElevenLabsRegion_Util = void 0;
+/**
+ * ElevenLabs region resolution: the environment name → the API host.
+ *
+ * The host table is the one `dynamo-cli` already runs in production (`DyCLI_MAP_ElevenLabsRegion_Util`),
+ * carried here unchanged, because the engine layer needs it too. A residency environment exists so the audio
+ * never leaves the region - so an unknown environment is an ERROR, never a silent fall back to the global host.
+ */
+class DyNTS_ElevenLabsRegion_Util {
+    /** Host per environment. */
+    static baseUrls = {
+        global: 'https://api.elevenlabs.io',
+        us: 'https://api.us.elevenlabs.io',
+        'eu-residency': 'https://api.eu.residency.elevenlabs.io',
+        'india-residency': 'https://api.in.residency.elevenlabs.io',
+        'singapore-residency': 'https://api.sg.residency.elevenlabs.io',
+    };
+    /**
+     * Accepts only the documented environments; `undefined` means `global`.
+     *
+     * @param value The raw value, typically `process.env.ELEVENLABS_ENVIRONMENT`.
+     */
+    static resolveEnvironment(value) {
+        switch (value) {
+            case undefined:
+            case 'global':
+                return 'global';
+            case 'us':
+                return 'us';
+            case 'eu-residency':
+                return 'eu-residency';
+            case 'india-residency':
+                return 'india-residency';
+            case 'singapore-residency':
+                return 'singapore-residency';
+            default:
+                throw new Error(`DyNTS_ElevenLabsRegion_Util: unsupported ElevenLabs environment '${value}'. `
+                    + `Supported: ${Object.keys(DyNTS_ElevenLabsRegion_Util.baseUrls).join(', ')}.`);
+        }
+    }
+    /** The API host of one environment. */
+    static getBaseUrl(environment) {
+        return DyNTS_ElevenLabsRegion_Util.baseUrls[environment];
+    }
+}
+exports.DyNTS_ElevenLabsRegion_Util = DyNTS_ElevenLabsRegion_Util;
+//# sourceMappingURL=elevenlabs-region.util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-region.util.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_collections/elevenlabs-region.util.ts"],"names":[],"mappings":";;;AAQA;;;;;;GAMG;AACH,MAAa,2BAA2B;IAEtC,4BAA4B;IACpB,MAAM,CAAU,QAAQ,GAAiD;QAC/E,MAAM,EAAE,2BAA2B;QACnC,EAAE,EAAE,8BAA8B;QAClC,cAAc,EAAE,wCAAwC;QACxD,iBAAiB,EAAE,wCAAwC;QAC3D,qBAAqB,EAAE,wCAAwC;KAChE,CAAC;IAEF;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAyB;QACjD,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,SAAS,CAAC;YACf,KAAK,QAAQ;gBACX,OAAO,QAAQ,CAAC;YAClB,KAAK,IAAI;gBACP,OAAO,IAAI,CAAC;YACd,KAAK,cAAc;gBACjB,OAAO,cAAc,CAAC;YACxB,KAAK,iBAAiB;gBACpB,OAAO,iBAAiB,CAAC;YAC3B,KAAK,qBAAqB;gBACxB,OAAO,qBAAqB,CAAC;YAC/B;gBACE,MAAM,IAAI,KAAK,CACb,oEAAoE,KAAK,KAAK;sBAC5E,cAAc,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAChF,CAAC;QACN,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,MAAM,CAAC,UAAU,CAAC,WAAyC;QACzD,OAAO,2BAA2B,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC;;AAxCH,kEAyCC"}

package/build/_modules/media-gen/_models/elevenlabs-settings.interface.d.ts

@@ -0,0 +1,18 @@
+/** The HTTP call an ElevenLabs adapter makes - injectable, so specs assert the request without a network or a key. */
+export type DyNTS_ElevenLabs_Fetch = (url: string, init: RequestInit) => Promise<Response>;
+/**
+ * Settings of the ElevenLabs adapters. Every field is optional; what is left out is read from the environment
+ * AT CALL TIME, so a rotated key or a changed region takes effect without rebuilding the adapter.
+ */
+export interface DyNTS_ElevenLabs_Settings {
+    /** API key. Falls back to `ELEVENLABS_API_KEY`. */
+    apiKey?: string;
+    /**
+     * Environment: `global` (default), `us`, `eu-residency`, `india-residency`, `singapore-residency`.
+     * Falls back to `ELEVENLABS_ENVIRONMENT`. An unknown value is refused, never mapped to the global host.
+     */
+    environment?: string;
+    /** HTTP implementation. Defaults to the global `fetch`. */
+    fetchImpl?: DyNTS_ElevenLabs_Fetch;
+}
+//# sourceMappingURL=elevenlabs-settings.interface.d.ts.map

package/build/_modules/media-gen/_models/elevenlabs-settings.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-settings.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_models/elevenlabs-settings.interface.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,MAAM,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE3F;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC"}

package/build/_modules/media-gen/_models/elevenlabs-settings.interface.js

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

package/build/_modules/media-gen/_models/elevenlabs-settings.interface.js.map

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

package/build/_modules/media-gen/_services/elevenlabs-speak.control-service.d.ts

@@ -0,0 +1,23 @@
+import { DyFM_AI_Speech_Request, DyFM_AI_Speech_Response } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_ElevenLabs_ServiceBase } from './elevenlabs.service-base';
+import { DyNTS_MediaGen_Operation } from '../_models/media-gen-operation.type';
+/**
+ * ElevenLabs text-to-speech adapter.
+ *
+ * Request shape verified against the provider's API reference (2026-09-14): `POST /v1/text-to-speech/{voice_id}`,
+ * `xi-api-key` header, `output_format` query parameter, JSON body `{ text, model_id }`, binary audio response.
+ * The same shape `dc media-speech` already sends.
+ */
+export declare class DyNTS_ElevenLabs_Speak_ControlService extends DyNTS_ElevenLabs_ServiceBase<DyFM_AI_Speech_Request, DyFM_AI_Speech_Response> {
+    /** The provider's documented default output format (API reference, 2026-09-14). */
+    static readonly defaultFormat: string;
+    readonly operations: readonly DyNTS_MediaGen_Operation[];
+    static getInstance(): DyNTS_ElevenLabs_Speak_ControlService;
+    /**
+     * Speaks `request.text` with `request.voice`, and returns the audio as base64 with the media type the provider
+     * reported. A voice is REQUIRED: the provider has no meaningful default, and a silently picked one would be a
+     * choice the caller never made.
+     */
+    generate(operation: DyNTS_MediaGen_Operation, request: DyFM_AI_Speech_Request, issuer: string): Promise<DyFM_AI_Speech_Response>;
+}
+//# sourceMappingURL=elevenlabs-speak.control-service.d.ts.map

package/build/_modules/media-gen/_services/elevenlabs-speak.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-speak.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/elevenlabs-speak.control-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAE3F,OAAO,EAA+B,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAE/E;;;;;;GAMG;AACH,qBAAa,qCACX,SAAQ,4BAA4B,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;IAErF,mFAAmF;IACnF,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAmB;IAExD,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAwB;IAEhF,MAAM,CAAC,WAAW,IAAI,qCAAqC;IAI3D;;;;OAIG;IACG,QAAQ,CACZ,SAAS,EAAE,wBAAwB,EACnC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,CAAC;CAuCpC"}

package/build/_modules/media-gen/_services/elevenlabs-speak.control-service.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ElevenLabs_Speak_ControlService = void 0;
+const elevenlabs_service_base_1 = require("./elevenlabs.service-base");
+/**
+ * ElevenLabs text-to-speech adapter.
+ *
+ * Request shape verified against the provider's API reference (2026-09-14): `POST /v1/text-to-speech/{voice_id}`,
+ * `xi-api-key` header, `output_format` query parameter, JSON body `{ text, model_id }`, binary audio response.
+ * The same shape `dc media-speech` already sends.
+ */
+class DyNTS_ElevenLabs_Speak_ControlService extends elevenlabs_service_base_1.DyNTS_ElevenLabs_ServiceBase {
+    /** The provider's documented default output format (API reference, 2026-09-14). */
+    static defaultFormat = 'mp3_44100_128';
+    operations = ['text-to-speech'];
+    static getInstance() {
+        return DyNTS_ElevenLabs_Speak_ControlService.getSingletonInstance();
+    }
+    /**
+     * Speaks `request.text` with `request.voice`, and returns the audio as base64 with the media type the provider
+     * reported. A voice is REQUIRED: the provider has no meaningful default, and a silently picked one would be a
+     * choice the caller never made.
+     */
+    async generate(operation, request, issuer) {
+        this.assertOperation(operation, issuer);
+        if (!request.text) {
+            throw this.invalidRequest('The text to speak is empty.', issuer);
+        }
+        if (!request.voice) {
+            throw this.invalidRequest('A voice id is required: the provider has no default voice.', issuer);
+        }
+        const connection = this.connection(issuer);
+        const format = request.format ?? DyNTS_ElevenLabs_Speak_ControlService.defaultFormat;
+        const url = `${connection.baseUrl}/v1/text-to-speech/${encodeURIComponent(request.voice)}`
+            + `?output_format=${encodeURIComponent(format)}`;
+        const response = await connection.doFetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'xi-api-key': connection.apiKey },
+            body: JSON.stringify({ text: request.text, model_id: request.model }),
+        });
+        await this.failOnHttpError(response, url, issuer);
+        const audio = Buffer.from(await response.arrayBuffer());
+        if (!audio.length) {
+            throw this.invalidRequest(`ElevenLabs returned an empty audio body (${url}).`, issuer);
+        }
+        return {
+            provider: this.provider,
+            model: request.model,
+            audio: {
+                mimeType: response.headers.get('content-type') ?? 'application/octet-stream',
+                base64: audio.toString('base64'),
+            },
+            format: format,
+        };
+    }
+}
+exports.DyNTS_ElevenLabs_Speak_ControlService = DyNTS_ElevenLabs_Speak_ControlService;
+//# sourceMappingURL=elevenlabs-speak.control-service.js.map

package/build/_modules/media-gen/_services/elevenlabs-speak.control-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-speak.control-service.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/elevenlabs-speak.control-service.ts"],"names":[],"mappings":";;;AAEA,uEAAsG;AAGtG;;;;;;GAMG;AACH,MAAa,qCACX,SAAQ,sDAA6E;IAErF,mFAAmF;IACnF,MAAM,CAAU,aAAa,GAAW,eAAe,CAAC;IAE/C,UAAU,GAAwC,CAAE,gBAAgB,CAAE,CAAC;IAEhF,MAAM,CAAC,WAAW;QAChB,OAAO,qCAAqC,CAAC,oBAAoB,EAAE,CAAC;IACtE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CACZ,SAAmC,EACnC,OAA+B,EAC/B,MAAc;QAEd,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAExC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,cAAc,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,cAAc,CAAC,4DAA4D,EAAE,MAAM,CAAC,CAAC;QAClG,CAAC;QAED,MAAM,UAAU,GAAgC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxE,MAAM,MAAM,GAAW,OAAO,CAAC,MAAM,IAAI,qCAAqC,CAAC,aAAa,CAAC;QAC7F,MAAM,GAAG,GAAW,GAAG,UAAU,CAAC,OAAO,sBAAsB,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;cAC9F,kBAAkB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAa,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,CAAC,MAAM,EAAE;YAChF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;SACtE,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAElD,MAAM,KAAK,GAAW,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAEhE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,cAAc,CAAC,4CAA4C,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QACzF,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE;gBACL,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,0BAA0B;gBAC5E,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;aACjC;YACD,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;;AA3DH,sFA4DC"}

package/build/_modules/media-gen/_services/elevenlabs-transcribe.control-service.d.ts

@@ -0,0 +1,23 @@
+import { DyFM_AI_Transcription_Request, DyFM_AI_Transcription_Response } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_ElevenLabs_ServiceBase } from './elevenlabs.service-base';
+import { DyNTS_MediaGen_Operation } from '../_models/media-gen-operation.type';
+/**
+ * ElevenLabs speech-to-text adapter.
+ *
+ * Request shape verified against the provider's API reference (2026-09-14): `POST /v1/speech-to-text`,
+ * `xi-api-key` header, `multipart/form-data` with the required `model_id`, the audio as `file`, and an optional
+ * `language_code`; the JSON response carries `text` and `language_code`.
+ * ⚠️ `dc media-speech` deliberately did not build this path, because no working call existed to copy - this
+ * adapter is built from the reference and exercised by specs; no live call has been made yet.
+ */
+export declare class DyNTS_ElevenLabs_Transcribe_ControlService extends DyNTS_ElevenLabs_ServiceBase<DyFM_AI_Transcription_Request, DyFM_AI_Transcription_Response> {
+    readonly operations: readonly DyNTS_MediaGen_Operation[];
+    static getInstance(): DyNTS_ElevenLabs_Transcribe_ControlService;
+    /** Reads a field of an unknown JSON value without assuming its shape. */
+    private static readField;
+    /**
+     * Transcribes `request.audio`, and returns the transcript with the language the provider reported.
+     */
+    generate(operation: DyNTS_MediaGen_Operation, request: DyFM_AI_Transcription_Request, issuer: string): Promise<DyFM_AI_Transcription_Response>;
+}
+//# sourceMappingURL=elevenlabs-transcribe.control-service.d.ts.map

package/build/_modules/media-gen/_services/elevenlabs-transcribe.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-transcribe.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/elevenlabs-transcribe.control-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAEzG,OAAO,EAA+B,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAE/E;;;;;;;;GAQG;AACH,qBAAa,0CACX,SAAQ,4BAA4B,CAAC,6BAA6B,EAAE,8BAA8B,CAAC;IAEnG,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAwB;IAEhF,MAAM,CAAC,WAAW,IAAI,0CAA0C;IAIhE,yEAAyE;IACzE,OAAO,CAAC,MAAM,CAAC,SAAS;IAIxB;;OAEG;IACG,QAAQ,CACZ,SAAS,EAAE,wBAAwB,EACnC,OAAO,EAAE,6BAA6B,EACtC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,8BAA8B,CAAC;CA8C3C"}

package/build/_modules/media-gen/_services/elevenlabs-transcribe.control-service.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ElevenLabs_Transcribe_ControlService = void 0;
+const elevenlabs_service_base_1 = require("./elevenlabs.service-base");
+/**
+ * ElevenLabs speech-to-text adapter.
+ *
+ * Request shape verified against the provider's API reference (2026-09-14): `POST /v1/speech-to-text`,
+ * `xi-api-key` header, `multipart/form-data` with the required `model_id`, the audio as `file`, and an optional
+ * `language_code`; the JSON response carries `text` and `language_code`.
+ * ⚠️ `dc media-speech` deliberately did not build this path, because no working call existed to copy - this
+ * adapter is built from the reference and exercised by specs; no live call has been made yet.
+ */
+class DyNTS_ElevenLabs_Transcribe_ControlService extends elevenlabs_service_base_1.DyNTS_ElevenLabs_ServiceBase {
+    operations = ['speech-to-text'];
+    static getInstance() {
+        return DyNTS_ElevenLabs_Transcribe_ControlService.getSingletonInstance();
+    }
+    /** Reads a field of an unknown JSON value without assuming its shape. */
+    static readField(json, key) {
+        return json !== null && typeof json === 'object' ? Reflect.get(json, key) : undefined;
+    }
+    /**
+     * Transcribes `request.audio`, and returns the transcript with the language the provider reported.
+     */
+    async generate(operation, request, issuer) {
+        this.assertOperation(operation, issuer);
+        if (!request.audio?.base64) {
+            throw this.invalidRequest('The audio to transcribe is empty.', issuer);
+        }
+        const connection = this.connection(issuer);
+        const url = `${connection.baseUrl}/v1/speech-to-text`;
+        const form = new FormData();
+        form.append('model_id', request.model);
+        form.append('file', new Blob([new Uint8Array(Buffer.from(request.audio.base64, 'base64'))], { type: request.audio.mimeType }), request.audio.name ?? 'audio');
+        if (request.language) {
+            form.append('language_code', request.language);
+        }
+        const response = await connection.doFetch(url, {
+            method: 'POST',
+            headers: { 'xi-api-key': connection.apiKey },
+            body: form,
+        });
+        await this.failOnHttpError(response, url, issuer);
+        const json = await response.json();
+        const text = DyNTS_ElevenLabs_Transcribe_ControlService.readField(json, 'text');
+        const language = DyNTS_ElevenLabs_Transcribe_ControlService.readField(json, 'language_code');
+        if (typeof text !== 'string') {
+            throw this.invalidRequest(`ElevenLabs returned no transcript text (${url}).`, issuer);
+        }
+        return {
+            provider: this.provider,
+            model: request.model,
+            text: text,
+            ...(typeof language === 'string' ? { language: language } : {}),
+            rawResponse: json,
+        };
+    }
+}
+exports.DyNTS_ElevenLabs_Transcribe_ControlService = DyNTS_ElevenLabs_Transcribe_ControlService;
+//# sourceMappingURL=elevenlabs-transcribe.control-service.js.map

package/build/_modules/media-gen/_services/elevenlabs-transcribe.control-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-transcribe.control-service.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/elevenlabs-transcribe.control-service.ts"],"names":[],"mappings":";;;AAEA,uEAAsG;AAGtG;;;;;;;;GAQG;AACH,MAAa,0CACX,SAAQ,sDAA2F;IAE1F,UAAU,GAAwC,CAAE,gBAAgB,CAAE,CAAC;IAEhF,MAAM,CAAC,WAAW;QAChB,OAAO,0CAA0C,CAAC,oBAAoB,EAAE,CAAC;IAC3E,CAAC;IAED,yEAAyE;IACjE,MAAM,CAAC,SAAS,CAAC,IAAa,EAAE,GAAW;QACjD,OAAO,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,SAAmC,EACnC,OAAsC,EACtC,MAAc;QAEd,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAExC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,cAAc,CAAC,mCAAmC,EAAE,MAAM,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,UAAU,GAAgC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxE,MAAM,GAAG,GAAW,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC;QAC9D,MAAM,IAAI,GAAa,IAAI,QAAQ,EAAE,CAAC;QAEtC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CACT,MAAM,EACN,IAAI,IAAI,CAAC,CAAE,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAC3G,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAC9B,CAAC;QAEF,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,QAAQ,GAAa,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,MAAM,EAAE;YAC5C,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAElD,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAY,0CAA0C,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzF,MAAM,QAAQ,GAAY,0CAA0C,CAAC,SAAS,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAEtG,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,cAAc,CAAC,2CAA2C,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QACxF,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,IAAI;YACV,GAAG,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;CACF;AAnED,gGAmEC"}

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

@@ -0,0 +1,33 @@
+import { DyFM_Error } from '@futdevpro/fsm-dynamo';
+import { DyNTS_ElevenLabs_Fetch, DyNTS_ElevenLabs_Settings } from '../_models/elevenlabs-settings.interface';
+import { DyNTS_MediaGen_Operation } from '../_models/media-gen-operation.type';
+import { DyNTS_MediaGen_ServiceBase } from './media-gen.service-base';
+/** What one ElevenLabs call needs, resolved at call time. */
+export interface DyNTS_ElevenLabs_Connection {
+    baseUrl: string;
+    apiKey: string;
+    doFetch: DyNTS_ElevenLabs_Fetch;
+}
+/**
+ * Shared part of the ElevenLabs adapters: connection resolution and HTTP error reporting.
+ *
+ * Every refusal happens BEFORE the paid call: an unknown environment, a missing key, an operation the adapter
+ * does not serve. The key travels only in the `xi-api-key` header, so the URLs recorded in errors carry no secret.
+ */
+export declare abstract class DyNTS_ElevenLabs_ServiceBase<T_Request, T_Response> extends DyNTS_MediaGen_ServiceBase<T_Request, T_Response> {
+    readonly provider: string;
+    protected readonly settings: DyNTS_ElevenLabs_Settings;
+    constructor(settings?: DyNTS_ElevenLabs_Settings);
+    /** Refuses an operation this adapter does not declare. */
+    protected assertOperation(operation: DyNTS_MediaGen_Operation, issuer: string): void;
+    /** Resolves the host, the key and the HTTP implementation for one call. */
+    protected connection(issuer: string): DyNTS_ElevenLabs_Connection;
+    /**
+     * Throws a detailed error for a non-2xx response. A 401 is named: its repeatedly hit cause is a key ID or
+     * a hint pasted instead of the full secret, which looks like a valid credential.
+     */
+    protected failOnHttpError(response: Response, url: string, issuer: string): Promise<void>;
+    /** A refusal of the caller's request, reported with this adapter's error settings. */
+    protected invalidRequest(message: string, issuer: string): DyFM_Error;
+}
+//# sourceMappingURL=elevenlabs.service-base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.service-base.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/elevenlabs.service-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAC7G,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,6DAA6D;AAC7D,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED;;;;;GAKG;AACH,8BAAsB,4BAA4B,CAAC,SAAS,EAAE,UAAU,CACtE,SAAQ,0BAA0B,CAAC,SAAS,EAAE,UAAU,CAAC;IAEzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAgB;IAEzC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;gBAE3C,QAAQ,GAAE,yBAA8B;IAKpD,0DAA0D;IAC1D,SAAS,CAAC,eAAe,CAAC,SAAS,EAAE,wBAAwB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAepF,2EAA2E;IAC3E,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,2BAA2B;IAkCjE;;;OAGG;cACa,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB/F,sFAAsF;IACtF,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU;CAMtE"}

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

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ElevenLabs_ServiceBase = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const elevenlabs_region_util_1 = require("../_collections/elevenlabs-region.util");
+const media_gen_service_base_1 = require("./media-gen.service-base");
+/**
+ * Shared part of the ElevenLabs adapters: connection resolution and HTTP error reporting.
+ *
+ * Every refusal happens BEFORE the paid call: an unknown environment, a missing key, an operation the adapter
+ * does not serve. The key travels only in the `xi-api-key` header, so the URLs recorded in errors carry no secret.
+ */
+class DyNTS_ElevenLabs_ServiceBase extends media_gen_service_base_1.DyNTS_MediaGen_ServiceBase {
+    provider = 'elevenlabs';
+    settings;
+    constructor(settings = {}) {
+        super();
+        this.settings = settings;
+    }
+    /** Refuses an operation this adapter does not declare. */
+    assertOperation(operation, issuer) {
+        if (!this.operations.includes(operation)) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('generate', new Error(`${this.constructor.name} does not serve '${operation}'. It serves: ${this.operations.join(', ')}.`), issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MG-EL-OP`,
+            });
+        }
+    }
+    /** Resolves the host, the key and the HTTP implementation for one call. */
+    connection(issuer) {
+        let environment;
+        try {
+            environment = elevenlabs_region_util_1.DyNTS_ElevenLabsRegion_Util.resolveEnvironment(this.settings.environment ?? process.env.ELEVENLABS_ENVIRONMENT);
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('connection', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MG-EL-ENV`,
+            });
+        }
+        const apiKey = this.settings.apiKey ?? process.env.ELEVENLABS_API_KEY;
+        if (!apiKey) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('connection', new Error('Missing ElevenLabs API key: pass settings.apiKey or set ELEVENLABS_API_KEY.'), issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MG-EL-KEY`,
+            });
+        }
+        return {
+            baseUrl: elevenlabs_region_util_1.DyNTS_ElevenLabsRegion_Util.getBaseUrl(environment),
+            apiKey: apiKey,
+            doFetch: this.settings.fetchImpl ?? ((url, init) => fetch(url, init)),
+        };
+    }
+    /**
+     * Throws a detailed error for a non-2xx response. A 401 is named: its repeatedly hit cause is a key ID or
+     * a hint pasted instead of the full secret, which looks like a valid credential.
+     */
+    async failOnHttpError(response, url, issuer) {
+        if (response.ok) {
+            return;
+        }
+        const detail = await response.text().catch(() => '');
+        const hint = response.status === 401
+            ? ' (invalid_api_key - use the full secret shown once at key creation, not a key ID or hint)'
+            : '';
+        throw new fsm_dynamo_1.DyFM_Error({
+            ...this.getDefaultErrorSettings('generate', new Error(`ElevenLabs HTTP ${response.status}${hint}: ${detail.slice(0, 500)}`), issuer),
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MG-EL-HTTP`,
+            additionalContent: {
+                status: response.status,
+                url: url,
+            },
+        });
+    }
+    /** A refusal of the caller's request, reported with this adapter's error settings. */
+    invalidRequest(message, issuer) {
+        return new fsm_dynamo_1.DyFM_Error({
+            ...this.getDefaultErrorSettings('generate', new Error(message), issuer),
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MG-EL-REQ`,
+        });
+    }
+}
+exports.DyNTS_ElevenLabs_ServiceBase = DyNTS_ElevenLabs_ServiceBase;
+//# sourceMappingURL=elevenlabs.service-base.js.map

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

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

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

@@ -1,5 +1,10 @@
+export * from './_models/elevenlabs-settings.interface';
 export * from './_models/media-gen-operation.type';
+export * from './_collections/elevenlabs-region.util';
 export * from './_collections/media-gen-prompt.util';
 export * from './_services/media-gen.service-base';
 export * from './_services/media-gen.registry';
+export * from './_services/elevenlabs.service-base';
+export * from './_services/elevenlabs-speak.control-service';
+export * from './_services/elevenlabs-transcribe.control-service';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/media-gen/index.ts"],"names":[],"mappings":"AAUA,cAAc,yCAAyC,CAAC;AACxD,cAAc,oCAAoC,CAAC;AAGnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,mDAAmD,CAAC"}

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

@@ -8,10 +8,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 // MODELS
+tslib_1.__exportStar(require("./_models/elevenlabs-settings.interface"), exports);
 tslib_1.__exportStar(require("./_models/media-gen-operation.type"), exports);
 // COLLECTIONS
+tslib_1.__exportStar(require("./_collections/elevenlabs-region.util"), exports);
 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);
+tslib_1.__exportStar(require("./_services/elevenlabs.service-base"), exports);
+tslib_1.__exportStar(require("./_services/elevenlabs-speak.control-service"), exports);
+tslib_1.__exportStar(require("./_services/elevenlabs-transcribe.control-service"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +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"}
+{"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,kFAAwD;AACxD,6EAAmD;AAEnD,cAAc;AACd,gFAAsD;AACtD,+EAAqD;AAErD,WAAW;AACX,6EAAmD;AACnD,yEAA+C;AAC/C,8EAAoD;AACpD,uFAA6D;AAC7D,4FAAkE"}

package/package.json

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