@imenam/unified-llm-client 1.2.0

package/dist/core/Models.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODELS = void 0;
+exports.MODELS = {
+    GEMINI_FLASH_2_5: {
+        provider: "gemini",
+        modelName: "gemini-2.5-flash",
+        costsPer1MTokens: {
+            prompt: 0.3,
+            prompt_cache: 0.075,
+            prompt_image: 0.0000774,
+            output: 2.5,
+        },
+        currency: "USD",
+    },
+    GEMINI_2_5_PRO: {
+        provider: "gemini",
+        modelName: "gemini-2.5-pro",
+        costsPer1MTokens: {
+            prompt: 1.25,
+            prompt_cache: 0.3125,
+            prompt_image: 0.0003225,
+            output: 10.0,
+        },
+        currency: "USD",
+    },
+    GPT_4O_MINI: {
+        provider: "openai",
+        modelName: "gpt-4o-mini",
+        costsPer1MTokens: {
+            prompt: 0.6,
+            prompt_cache: 0.15,
+            prompt_image: 0.0012,
+            output: 2.4,
+        },
+        currency: "USD",
+    },
+    GPT_5: {
+        provider: "openai",
+        modelName: "gpt-5.2-2025-12-11",
+        costsPer1MTokens: {
+            prompt: 1.75,
+            prompt_cache: 0.175,
+            output: 14,
+        },
+        currency: "USD",
+    },
+    QWEN_VL_3: {
+        provider: "qwen",
+        modelName: "qwen3-vl-235b-a22b-instruct",
+        costsPer1MTokens: {
+            prompt: 0.2,
+            prompt_cache: 0.04,
+            output: 1.6,
+        },
+        currency: "USD",
+    },
+    QWEN_VL_FLASH: {
+        provider: "qwen",
+        modelName: "qwen3-vl-flash",
+        costsPer1MTokens: {
+            prompt: 0.05,
+            prompt_cache: 0.01,
+            output: 0.4,
+        },
+        currency: "USD",
+    },
+    QWEN_VL_3_FLASH: {
+        provider: "qwen",
+        modelName: "qwen3-vl-flash",
+        costsPer1MTokens: {
+            prompt: 0.05,
+            prompt_cache: 0.01,
+            output: 0.4,
+        },
+        currency: "USD",
+    },
+    GEMINI_3_PRO: {
+        provider: "gemini",
+        modelName: "gemini-3-pro-preview",
+        costsPer1MTokens: {
+            prompt: 2,
+            prompt_cache: 0.2,
+            output: 12,
+        },
+        currency: "USD",
+    },
+    GEMINI_3_1_PRO: {
+        provider: "gemini",
+        modelName: "gemini-3.1-pro-preview",
+        costsPer1MTokens: {
+            prompt: 2,
+            prompt_cache: 0.2,
+            output: 12,
+        },
+        currency: "USD",
+    },
+    GEMINI_3_FLASH: {
+        provider: "gemini",
+        modelName: "gemini-3-flash-preview",
+        costsPer1MTokens: {
+            prompt: 0.5,
+            prompt_cache: 0.05,
+            prompt_audio: 1,
+            prompt_audio_cache: 0.1,
+            output: 3.0,
+        },
+        currency: "USD",
+    },
+    CLAUDE_SONNET_4_6: {
+        provider: "anthropic",
+        modelName: "claude-sonnet-4-6",
+    },
+    CLAUDE_OPUS_4_6: {
+        provider: "anthropic",
+        modelName: "claude-opus-4-6",
+    },
+};

package/dist/core/UnifiedLLMClient.d.ts

@@ -0,0 +1,68 @@
+import { ChatMessage, ChatResponse, ToolDefinition, AudioGenerationOptions, AudioGenerationResponse, UnifiedLog } from "../common/types";
+import { PromptAdapterOptions, StreamedChatChunk, ChatOptionalConfig } from "./LLMAdapter";
+import { Model } from "../common/types";
+export type UnifiedLLMClientOptions = {
+    provider: "openai" | "gemini" | "qwen" | "anthropic";
+    adapterOptions?: PromptAdapterOptions;
+    logger?: (log: UnifiedLog) => any | Promise<any>;
+};
+export type ChatOptions = {
+    message: string | ChatMessage | ChatMessage[];
+    tools?: ToolDefinition[];
+    toolChoice?: "auto" | "none" | string;
+    onChunk?: (chunk: StreamedChatChunk) => void;
+    onFinalResponse?: (finalResponse: ChatResponse) => void;
+    onLog?: (log: UnifiedLog) => void;
+    stream?: boolean;
+    config?: ChatOptionalConfig;
+};
+export declare class UnifiedLLMClient {
+    private promptAdapter;
+    private outputAdapter;
+    private toolAdapter;
+    private audioAdapter?;
+    private rawMessages;
+    private model;
+    private logger?;
+    static setDefaultLogger(logger: (log: UnifiedLog) => any | Promise<any>): void;
+    constructor(model: Model, options?: {
+        logger?: (log: UnifiedLog) => any | Promise<any>;
+    });
+    private checkNotImplementedFeatures;
+    chat({ message, tools, toolChoice, onChunk, onFinalResponse, onLog, stream, config }: ChatOptions): Promise<ChatResponse>;
+    private handleLogging;
+    /**
+     * Vérifie si la génération d'audio est supportée pour le provider actuel
+     */
+    isAudioSupported(): boolean;
+    /**
+     * Génère de l'audio à partir de texte
+     */
+    generateAudio(options: AudioGenerationOptions): Promise<AudioGenerationResponse>;
+    /**
+     * Génère de l'audio en streaming
+     */
+    generateAudioStream(options: AudioGenerationOptions): AsyncIterable<Buffer>;
+    /**
+     * Récupère la liste des voix supportées
+     */
+    getSupportedAudioVoices(): Promise<string[]>;
+    /**
+     * Génère de l'audio simple avec une voix
+     */
+    generateSingleVoiceAudio(text: string, voiceName: string, options?: {
+        outputPath?: string;
+        temperature?: number;
+    }): Promise<AudioGenerationResponse>;
+    /**
+     * Génère de l'audio multi-voix
+     */
+    generateMultiVoiceAudio(text: string, speakers: Array<{
+        speaker: string;
+        voiceName: string;
+    }>, options?: {
+        outputPath?: string;
+        temperature?: number;
+    }): Promise<AudioGenerationResponse>;
+}
+//# sourceMappingURL=UnifiedLLMClient.d.ts.map

package/dist/core/UnifiedLLMClient.d.ts.map

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

package/dist/core/UnifiedLLMClient.js

@@ -0,0 +1,185 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnifiedLLMClient = void 0;
+const LLMAdapter_1 = require("./LLMAdapter");
+class UnifiedLLMClient {
+    static setDefaultLogger(logger) {
+        global._unifiedLlmDefaultLogger = logger;
+    }
+    constructor(model, options) {
+        this.rawMessages = [];
+        this.model = model;
+        this.promptAdapter = LLMAdapter_1.PROVIDERS_CONFIG[model.provider].promptAdapter;
+        this.outputAdapter = LLMAdapter_1.PROVIDERS_CONFIG[model.provider].outputAdapter;
+        this.toolAdapter = LLMAdapter_1.PROVIDERS_CONFIG[model.provider].toolAdapter;
+        this.audioAdapter = LLMAdapter_1.PROVIDERS_CONFIG[model.provider].audioAdapter;
+        this.logger = (options === null || options === void 0 ? void 0 : options.logger) || global._unifiedLlmDefaultLogger;
+    }
+    checkNotImplementedFeatures(message) {
+        if (message.attachedFile && this.model.provider !== "gemini" && this.model.provider !== "qwen" && this.model.provider !== "anthropic" && this.model.provider !== "openai") {
+            throw new Error("Attached files are not supported for this provider");
+        }
+    }
+    chat(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ message, tools, toolChoice = "auto", onChunk, onFinalResponse, onLog, stream = false, config }) {
+            const startTime = Date.now();
+            const messageArray = Array.isArray(message)
+                ? message
+                : [typeof message === "string" ? { role: "user", content: message } : message];
+            for (const m of messageArray)
+                this.checkNotImplementedFeatures(m);
+            const messages = yield Promise.all(messageArray.map(m => this.promptAdapter.formatMessage(m)));
+            let finalResponse;
+            if (stream) {
+                if (!this.promptAdapter.streamFromProvider) {
+                    throw new Error("The current adapter does not support streaming.");
+                }
+                let aggregatedContent = "";
+                finalResponse = yield this.promptAdapter.streamFromProvider({
+                    messages,
+                    tools,
+                    toolChoice,
+                    model: this.model.modelName,
+                    onChunk: (chunk) => {
+                        aggregatedContent += chunk.contentChunk || "";
+                        if (onChunk) {
+                            onChunk(chunk);
+                        }
+                    },
+                    onFinalResponse: (resp) => {
+                        resp.content = aggregatedContent;
+                        if (onFinalResponse) {
+                            onFinalResponse(resp);
+                        }
+                    }
+                });
+                finalResponse.content = aggregatedContent;
+            }
+            else {
+                const providerResponse = yield this.promptAdapter.sendToProvider(messages, tools, toolChoice, undefined, this.model.modelName, config);
+                finalResponse = this.outputAdapter.parse(providerResponse);
+            }
+            const latencyMs = Date.now() - startTime;
+            yield this.handleLogging(messageArray, finalResponse, latencyMs, config === null || config === void 0 ? void 0 : config.metadata, onLog);
+            return finalResponse;
+        });
+    }
+    handleLogging(messages, response, latencyMs, metadata, onLog) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const logAdapter = LLMAdapter_1.PROVIDERS_CONFIG[this.model.provider].logAdapter;
+            if (logAdapter) {
+                try {
+                    const unifiedLog = logAdapter.toUnifiedLog({
+                        model: this.model.modelName,
+                        provider: this.model.provider,
+                        messages,
+                        response,
+                        latencyMs,
+                        metadata
+                    });
+                    response.requestId = unifiedLog.requestId;
+                    if (onLog) {
+                        onLog(unifiedLog);
+                    }
+                    if (this.logger) {
+                        try {
+                            const logResult = yield this.logger(unifiedLog);
+                            if (logResult && typeof logResult === 'object' && 'id' in logResult) {
+                                response.llmLogId = logResult.id;
+                            }
+                        }
+                        catch (err) {
+                            console.error("[Logger Error]:", err);
+                        }
+                    }
+                }
+                catch (err) {
+                    console.error("[LogAdapter Error]:", err);
+                }
+            }
+        });
+    }
+    // ===== AUDIO GENERATION METHODS =====
+    /**
+     * Vérifie si la génération d'audio est supportée pour le provider actuel
+     */
+    isAudioSupported() {
+        return this.audioAdapter !== undefined;
+    }
+    /**
+     * Génère de l'audio à partir de texte
+     */
+    generateAudio(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.audioAdapter) {
+                throw new Error(`La génération d'audio n'est pas supportée pour le provider ${this.model.provider}`);
+            }
+            return this.audioAdapter.generateAudio(options);
+        });
+    }
+    /**
+     * Génère de l'audio en streaming
+     */
+    generateAudioStream(options) {
+        if (!this.audioAdapter) {
+            throw new Error(`Le streaming audio n'est pas supporté pour le provider ${this.model.provider}`);
+        }
+        return this.audioAdapter.generateAudioStream(options);
+    }
+    /**
+     * Récupère la liste des voix supportées
+     */
+    getSupportedAudioVoices() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.audioAdapter) {
+                throw new Error(`La génération d'audio n'est pas supportée pour le provider ${this.model.provider}`);
+            }
+            return this.audioAdapter.getSupportedVoices();
+        });
+    }
+    /**
+     * Génère de l'audio simple avec une voix
+     */
+    generateSingleVoiceAudio(text, voiceName, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.generateAudio({
+                text,
+                outputPath: options === null || options === void 0 ? void 0 : options.outputPath,
+                voiceConfig: {
+                    voiceName,
+                    temperature: options === null || options === void 0 ? void 0 : options.temperature
+                },
+                multiSpeaker: false
+            });
+        });
+    }
+    /**
+     * Génère de l'audio multi-voix
+     */
+    generateMultiVoiceAudio(text, speakers, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.generateAudio({
+                text,
+                outputPath: options === null || options === void 0 ? void 0 : options.outputPath,
+                multiSpeaker: true,
+                speakers: speakers.map(s => ({
+                    speaker: s.speaker,
+                    voiceConfig: {
+                        voiceName: s.voiceName,
+                        temperature: options === null || options === void 0 ? void 0 : options.temperature
+                    }
+                }))
+            });
+        });
+    }
+}
+exports.UnifiedLLMClient = UnifiedLLMClient;

package/dist/examples/anthropic-example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=anthropic-example.d.ts.map

package/dist/examples/anthropic-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-example.d.ts","sourceRoot":"","sources":["../../src/examples/anthropic-example.ts"],"names":[],"mappings":""}

package/dist/examples/anthropic-example.js

@@ -0,0 +1,243 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const __1 = require("..");
+// ───────────────────────────────────────────────
+// 1. Chat simple
+// ───────────────────────────────────────────────
+function basicChat() {
+    return __awaiter(this, void 0, void 0, function* () {
+        console.log("=== 1. Chat simple ===");
+        const client = new __1.UnifiedLLMClient(__1.MODELS.CLAUDE_SONNET_4_6);
+        const response = yield client.chat({
+            message: "Présente-toi en une phrase.",
+        });
+        console.log("Réponse :", response.content);
+        console.log("Usage :", response.usage);
+        console.log();
+    });
+}
+// ───────────────────────────────────────────────
+// 2. Streaming
+// ───────────────────────────────────────────────
+function streamingChat() {
+    return __awaiter(this, void 0, void 0, function* () {
+        console.log("=== 2. Streaming ===");
+        const client = new __1.UnifiedLLMClient(__1.MODELS.CLAUDE_SONNET_4_6);
+        process.stdout.write("Réponse : ");
+        const response = yield client.chat({
+            message: "Explique-moi le principe de la relativité restreinte en 3 phrases.",
+            stream: true,
+            onChunk: (chunk) => {
+                if (chunk.contentChunk) {
+                    process.stdout.write(chunk.contentChunk);
+                }
+            },
+        });
+        console.log("\nUsage final :", response.usage);
+        console.log();
+    });
+}
+// ───────────────────────────────────────────────
+// 3. Tool calling
+// ───────────────────────────────────────────────
+function toolCallingChat() {
+    return __awaiter(this, void 0, void 0, function* () {
+        console.log("=== 3. Tool calling ===");
+        const tools = [
+            {
+                name: "get_weather",
+                description: "Retourne la météo actuelle pour une ville donnée.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        city: { type: "string", description: "Nom de la ville" },
+                    },
+                    required: ["city"],
+                },
+                executor: (_a) => __awaiter(this, [_a], void 0, function* ({ city }) {
+                    const temperature = Math.floor(10 + Math.random() * 20);
+                    return `Météo à ${city} : ${temperature}°C, ensoleillé.`;
+                }),
+            },
+        ];
+        const client = new __1.UnifiedLLMClient(__1.MODELS.CLAUDE_SONNET_4_6);
+        const response = yield client.chat({
+            message: "Quel temps fait-il à Paris en ce moment ?",
+            tools,
+            toolChoice: "auto",
+        });
+        if (response.toolCalls && response.toolCalls.length > 0) {
+            console.log("Tool call détecté :", response.toolCalls[0].name);
+            console.log("Arguments :", response.toolCalls[0].arguments);
+        }
+        else {
+            console.log("Réponse directe :", response.content);
+        }
+        console.log();
+    });
+}
+// ───────────────────────────────────────────────
+// 4. Logging
+// ───────────────────────────────────────────────
+function chatWithLogging() {
+    return __awaiter(this, void 0, void 0, function* () {
+        console.log("=== 4. Chat avec logging ===");
+        const client = new __1.UnifiedLLMClient(__1.MODELS.CLAUDE_SONNET_4_6, {
+            logger: (log) => {
+                console.log("[LOG]", {
+                    requestId: log.requestId,
+                    model: log.model,
+                    promptTokens: log.usage.promptTokens,
+                    completionTokens: log.usage.completionTokens,
+                    totalTokens: log.usage.totalTokens,
+                    latencyMs: log.latencyMs,
+                    finishReason: log.output.finishReason,
+                });
+            },
+        });
+        const response = yield client.chat({
+            message: "Quelle est la capitale de la France ?",
+        });
+        console.log("Réponse :", response.content);
+        console.log();
+    });
+}
+// ───────────────────────────────────────────────
+// 5. OCR — extraction de texte depuis une image
+// ───────────────────────────────────────────────
+function ocrFromImage() {
+    return __awaiter(this, void 0, void 0, function* () {
+        console.log("=== 5. OCR depuis une image ===");
+        const tools = [
+            {
+                name: "save_ocr_result",
+                description: "Sauvegarde le texte extrait d'une image.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        text: {
+                            type: "string",
+                            description: "Texte intégral extrait de l'image, dans l'ordre de lecture.",
+                        },
+                        language: {
+                            type: "string",
+                            description: "Langue détectée dans le document (ex: 'fr', 'en').",
+                        },
+                        confidence: {
+                            type: "string",
+                            enum: ["high", "medium", "low"],
+                            description: "Niveau de confiance global sur la transcription.",
+                        },
+                    },
+                    required: ["text", "language", "confidence"],
+                },
+                executor: (_a) => __awaiter(this, [_a], void 0, function* ({ text, language, confidence }) {
+                    return `OCR enregistré (${language}, confiance: ${confidence}) — ${String(text).length} caractères extraits.`;
+                }),
+            },
+        ];
+        const client = new __1.UnifiedLLMClient(__1.MODELS.CLAUDE_SONNET_4_6);
+        // Remplace "./media/document.png" par le chemin de ton image ou PDF
+        const response = yield client.chat({
+            message: {
+                role: "user",
+                content: "Extrais tout le texte visible dans ce document, mot pour mot, en respectant l'ordre de lecture.",
+                attachedFile: "./media/document.png",
+            },
+            tools,
+            toolChoice: "save_ocr_result",
+        });
+        if (response.toolCalls && response.toolCalls.length > 0) {
+            const args = response.toolCalls[0].arguments;
+            console.log("Langue détectée :", args.language);
+            console.log("Confiance       :", args.confidence);
+            console.log("Texte extrait   :\n", args.text);
+        }
+        else {
+            console.log("Réponse texte :", response.content);
+        }
+        console.log();
+    });
+}
+// ───────────────────────────────────────────────
+// 6. OCR — extraction structurée depuis un PDF
+// ───────────────────────────────────────────────
+function ocrFromPdf() {
+    return __awaiter(this, void 0, void 0, function* () {
+        console.log("=== 6. OCR structuré depuis un PDF ===");
+        const tools = [
+            {
+                name: "save_structured_document",
+                description: "Sauvegarde le contenu structuré extrait d'un document PDF.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        title: { type: "string", description: "Titre principal du document." },
+                        sections: {
+                            type: "array",
+                            description: "Sections du document dans l'ordre.",
+                            items: {
+                                type: "object",
+                                properties: {
+                                    heading: { type: "string", description: "Titre de la section." },
+                                    content: { type: "string", description: "Contenu textuel de la section." },
+                                },
+                                required: ["heading", "content"],
+                            },
+                        },
+                        page_count: { type: "number", description: "Nombre de pages du document." },
+                    },
+                    required: ["title", "sections", "page_count"],
+                },
+                executor: (_a) => __awaiter(this, [_a], void 0, function* ({ title, sections, page_count }) {
+                    return `Document "${title}" analysé — ${page_count} page(s), ${sections.length} section(s).`;
+                }),
+            },
+        ];
+        const client = new __1.UnifiedLLMClient(__1.MODELS.CLAUDE_SONNET_4_6);
+        // Remplace "./media/document.pdf" par le chemin de ton PDF
+        const response = yield client.chat({
+            message: {
+                role: "user",
+                content: "Analyse ce document PDF et extrais le contenu de la première page de manière structurée : titre, sections et leur contenu.",
+                attachedFile: "./media/document.pdf",
+            },
+            tools,
+            toolChoice: "save_structured_document",
+        });
+        if (response.toolCalls && response.toolCalls.length > 0) {
+            const args = response.toolCalls[0].arguments;
+            console.log("Titre        :", args.title);
+            console.log("Pages        :", args.page_count);
+            console.log("Sections     :", args.sections.length);
+            args.sections.forEach((s, i) => {
+                console.log(`\n  [${i + 1}] ${s.heading}`);
+                console.log(`      ${s.content.slice(0, 120)}...`);
+            });
+        }
+        else {
+            console.log("Réponse texte :", response.content);
+        }
+        console.log();
+    });
+}
+// ───────────────────────────────────────────────
+// Exécution
+// ───────────────────────────────────────────────
+(() => __awaiter(void 0, void 0, void 0, function* () {
+    yield basicChat();
+    yield streamingChat();
+    yield toolCallingChat();
+    yield chatWithLogging();
+    yield ocrFromImage();
+    yield ocrFromPdf();
+}))();

package/dist/examples/audio-example.d.ts

@@ -0,0 +1,14 @@
+import { UnifiedLLMClient } from "../core/UnifiedLLMClient";
+declare function listAvailableVoices(client: UnifiedLLMClient): Promise<string[]>;
+declare function generateSimpleAudio(client: UnifiedLLMClient): Promise<import("../index").AudioGenerationResponse>;
+declare function generateMultiVoiceAudio(client: UnifiedLLMClient): Promise<import("../index").AudioGenerationResponse>;
+declare function generateAdvancedAudio(client: UnifiedLLMClient): Promise<import("../index").AudioGenerationResponse>;
+declare function generateStreamingAudio(client: UnifiedLLMClient): Promise<{
+    totalChunks: number;
+    totalBytes: number;
+}>;
+declare function generateInMemoryAudio(client: UnifiedLLMClient): Promise<import("../index").AudioGenerationResponse>;
+declare function runAudioExamples(): Promise<void>;
+export declare function cleanupAudioExamples(): void;
+export { runAudioExamples, listAvailableVoices, generateSimpleAudio, generateMultiVoiceAudio, generateAdvancedAudio, generateStreamingAudio, generateInMemoryAudio };
+//# sourceMappingURL=audio-example.d.ts.map

package/dist/examples/audio-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-example.d.ts","sourceRoot":"","sources":["../../src/examples/audio-example.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAW5D,iBAAe,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,qBAG1D;AAED,iBAAe,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,uDAU1D;AAED,iBAAe,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,uDAgB9D;AAED,iBAAe,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,uDAe5D;AAED,iBAAe,sBAAsB,CAAC,MAAM,EAAE,gBAAgB;;;GAiB7D;AAED,iBAAe,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,uDAQ5D;AAED,iBAAe,gBAAgB,kBAwB9B;AAQD,wBAAgB,oBAAoB,SAkBnC;AAaD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACtB,CAAC"}