telnyx 6.8.2 → 6.9.0

package/resources/voice-clones.d.ts

@@ -0,0 +1,382 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { DefaultFlatPagination, type DefaultFlatPaginationParams, PagePromise } from "../core/pagination.js";
+import { type Uploadable } from "../core/uploads.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Capture and manage voice identities as clones for use in text-to-speech synthesis.
+ */
+export declare class VoiceClones extends APIResource {
+    /**
+     * Creates a new voice clone by capturing the voice identity of an existing voice
+     * design. The clone can then be used for text-to-speech synthesis.
+     *
+     * @example
+     * ```ts
+     * const voiceClone = await client.voiceClones.create({
+     *   gender: 'male',
+     *   language: 'en',
+     *   name: 'clone-narrator',
+     *   voice_design_id: '550e8400-e29b-41d4-a716-446655440000',
+     * });
+     * ```
+     */
+    create(body: VoiceCloneCreateParams, options?: RequestOptions): APIPromise<VoiceCloneCreateResponse>;
+    /**
+     * Updates the name, language, or gender of a voice clone.
+     *
+     * @example
+     * ```ts
+     * const voiceClone = await client.voiceClones.update(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { name: 'updated-clone' },
+     * );
+     * ```
+     */
+    update(id: string, body: VoiceCloneUpdateParams, options?: RequestOptions): APIPromise<VoiceCloneUpdateResponse>;
+    /**
+     * Returns a paginated list of voice clones belonging to the authenticated account.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const voiceCloneListResponse of client.voiceClones.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: VoiceCloneListParams | null | undefined, options?: RequestOptions): PagePromise<VoiceCloneListResponsesDefaultFlatPagination, VoiceCloneListResponse>;
+    /**
+     * Permanently deletes a voice clone. This action cannot be undone.
+     *
+     * @example
+     * ```ts
+     * await client.voiceClones.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    delete(id: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Creates a new voice clone by uploading an audio file directly. Supported
+     * formats: WAV, MP3, FLAC, OGG, M4A. For best results, provide 5–10 seconds of
+     * clear speech. Maximum file size: 2MB.
+     *
+     * @example
+     * ```ts
+     * const response = await client.voiceClones.createFromUpload({
+     *   audio_file: fs.createReadStream('path/to/file'),
+     *   language: 'lkf-Lz1vLbBu-9uDh-9AHaOS2D-Cbf',
+     *   name: 'name',
+     * });
+     * ```
+     */
+    createFromUpload(body: VoiceCloneCreateFromUploadParams, options?: RequestOptions): APIPromise<VoiceCloneCreateFromUploadResponse>;
+    /**
+     * Downloads the WAV audio sample that was used to create the voice clone.
+     *
+     * @example
+     * ```ts
+     * const response = await client.voiceClones.downloadSample(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
+     */
+    downloadSample(id: string, options?: RequestOptions): APIPromise<Response>;
+}
+export type VoiceCloneListResponsesDefaultFlatPagination = DefaultFlatPagination<VoiceCloneListResponse>;
+/**
+ * Response envelope for a single voice clone.
+ */
+export interface VoiceCloneCreateResponse {
+    /**
+     * A voice clone object.
+     */
+    data?: VoiceCloneCreateResponse.Data;
+}
+export declare namespace VoiceCloneCreateResponse {
+    /**
+     * A voice clone object.
+     */
+    interface Data {
+        /**
+         * Unique identifier for the voice clone.
+         */
+        id?: string;
+        /**
+         * Timestamp when the voice clone was created.
+         */
+        created_at?: string;
+        /**
+         * Gender of the voice clone.
+         */
+        gender?: 'male' | 'female' | 'neutral' | null;
+        /**
+         * Voice style description. If not explicitly set on upload, falls back to the
+         * source design's prompt text.
+         */
+        label?: string | null;
+        /**
+         * ISO 639-1 language code of the voice clone.
+         */
+        language?: string | null;
+        /**
+         * Name of the voice clone.
+         */
+        name?: string;
+        /**
+         * Identifies the resource type.
+         */
+        record_type?: 'voice_clone';
+        /**
+         * UUID of the source voice design. `null` for upload-based clones.
+         */
+        source_voice_design_id?: string | null;
+        /**
+         * Version of the source voice design used. `null` for upload-based clones.
+         */
+        source_voice_design_version?: number | null;
+        /**
+         * Timestamp when the voice clone was last updated.
+         */
+        updated_at?: string;
+    }
+}
+/**
+ * Response envelope for a single voice clone.
+ */
+export interface VoiceCloneUpdateResponse {
+    /**
+     * A voice clone object.
+     */
+    data?: VoiceCloneUpdateResponse.Data;
+}
+export declare namespace VoiceCloneUpdateResponse {
+    /**
+     * A voice clone object.
+     */
+    interface Data {
+        /**
+         * Unique identifier for the voice clone.
+         */
+        id?: string;
+        /**
+         * Timestamp when the voice clone was created.
+         */
+        created_at?: string;
+        /**
+         * Gender of the voice clone.
+         */
+        gender?: 'male' | 'female' | 'neutral' | null;
+        /**
+         * Voice style description. If not explicitly set on upload, falls back to the
+         * source design's prompt text.
+         */
+        label?: string | null;
+        /**
+         * ISO 639-1 language code of the voice clone.
+         */
+        language?: string | null;
+        /**
+         * Name of the voice clone.
+         */
+        name?: string;
+        /**
+         * Identifies the resource type.
+         */
+        record_type?: 'voice_clone';
+        /**
+         * UUID of the source voice design. `null` for upload-based clones.
+         */
+        source_voice_design_id?: string | null;
+        /**
+         * Version of the source voice design used. `null` for upload-based clones.
+         */
+        source_voice_design_version?: number | null;
+        /**
+         * Timestamp when the voice clone was last updated.
+         */
+        updated_at?: string;
+    }
+}
+/**
+ * A voice clone object.
+ */
+export interface VoiceCloneListResponse {
+    /**
+     * Unique identifier for the voice clone.
+     */
+    id?: string;
+    /**
+     * Timestamp when the voice clone was created.
+     */
+    created_at?: string;
+    /**
+     * Gender of the voice clone.
+     */
+    gender?: 'male' | 'female' | 'neutral' | null;
+    /**
+     * Voice style description. If not explicitly set on upload, falls back to the
+     * source design's prompt text.
+     */
+    label?: string | null;
+    /**
+     * ISO 639-1 language code of the voice clone.
+     */
+    language?: string | null;
+    /**
+     * Name of the voice clone.
+     */
+    name?: string;
+    /**
+     * Identifies the resource type.
+     */
+    record_type?: 'voice_clone';
+    /**
+     * UUID of the source voice design. `null` for upload-based clones.
+     */
+    source_voice_design_id?: string | null;
+    /**
+     * Version of the source voice design used. `null` for upload-based clones.
+     */
+    source_voice_design_version?: number | null;
+    /**
+     * Timestamp when the voice clone was last updated.
+     */
+    updated_at?: string;
+}
+/**
+ * Response envelope for a single voice clone.
+ */
+export interface VoiceCloneCreateFromUploadResponse {
+    /**
+     * A voice clone object.
+     */
+    data?: VoiceCloneCreateFromUploadResponse.Data;
+}
+export declare namespace VoiceCloneCreateFromUploadResponse {
+    /**
+     * A voice clone object.
+     */
+    interface Data {
+        /**
+         * Unique identifier for the voice clone.
+         */
+        id?: string;
+        /**
+         * Timestamp when the voice clone was created.
+         */
+        created_at?: string;
+        /**
+         * Gender of the voice clone.
+         */
+        gender?: 'male' | 'female' | 'neutral' | null;
+        /**
+         * Voice style description. If not explicitly set on upload, falls back to the
+         * source design's prompt text.
+         */
+        label?: string | null;
+        /**
+         * ISO 639-1 language code of the voice clone.
+         */
+        language?: string | null;
+        /**
+         * Name of the voice clone.
+         */
+        name?: string;
+        /**
+         * Identifies the resource type.
+         */
+        record_type?: 'voice_clone';
+        /**
+         * UUID of the source voice design. `null` for upload-based clones.
+         */
+        source_voice_design_id?: string | null;
+        /**
+         * Version of the source voice design used. `null` for upload-based clones.
+         */
+        source_voice_design_version?: number | null;
+        /**
+         * Timestamp when the voice clone was last updated.
+         */
+        updated_at?: string;
+    }
+}
+export interface VoiceCloneCreateParams {
+    /**
+     * Gender of the voice clone.
+     */
+    gender: 'male' | 'female' | 'neutral';
+    /**
+     * ISO 639-1 language code for the clone (e.g. `en`, `fr`, `de`).
+     */
+    language: string;
+    /**
+     * Name for the voice clone.
+     */
+    name: string;
+    /**
+     * UUID of the source voice design to clone.
+     */
+    voice_design_id: string;
+}
+export interface VoiceCloneUpdateParams {
+    /**
+     * New name for the voice clone.
+     */
+    name: string;
+    /**
+     * Updated gender for the voice clone.
+     */
+    gender?: 'male' | 'female' | 'neutral';
+    /**
+     * Updated ISO 639-1 language code or `auto`.
+     */
+    language?: string;
+}
+export interface VoiceCloneListParams extends DefaultFlatPaginationParams {
+    /**
+     * Case-insensitive substring filter on the name field.
+     */
+    'filter[name]'?: string;
+    /**
+     * Sort order. Prefix with `-` for descending. Defaults to `-created_at`.
+     */
+    sort?: 'name' | '-name' | 'created_at' | '-created_at';
+}
+export interface VoiceCloneCreateFromUploadParams {
+    /**
+     * Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A.
+     * For best quality, provide 5–10 seconds of clear, uninterrupted speech. Maximum
+     * size: 2MB.
+     */
+    audio_file: Uploadable;
+    /**
+     * ISO 639-1 language code (e.g. `en`, `fr`) or `auto` for automatic detection.
+     */
+    language: string;
+    /**
+     * Name for the voice clone.
+     */
+    name: string;
+    /**
+     * Gender of the voice clone.
+     */
+    gender?: 'male' | 'female' | 'neutral';
+    /**
+     * Optional custom label describing the voice style. If omitted, falls back to the
+     * source design's prompt text.
+     */
+    label?: string;
+    /**
+     * Optional transcript of the audio file. Providing this improves clone quality.
+     */
+    ref_text?: string;
+}
+export declare namespace VoiceClones {
+    export { type VoiceCloneCreateResponse as VoiceCloneCreateResponse, type VoiceCloneUpdateResponse as VoiceCloneUpdateResponse, type VoiceCloneListResponse as VoiceCloneListResponse, type VoiceCloneCreateFromUploadResponse as VoiceCloneCreateFromUploadResponse, type VoiceCloneListResponsesDefaultFlatPagination as VoiceCloneListResponsesDefaultFlatPagination, type VoiceCloneCreateParams as VoiceCloneCreateParams, type VoiceCloneUpdateParams as VoiceCloneUpdateParams, type VoiceCloneListParams as VoiceCloneListParams, type VoiceCloneCreateFromUploadParams as VoiceCloneCreateFromUploadParams, };
+}
+//# sourceMappingURL=voice-clones.d.ts.map

package/resources/voice-clones.d.ts.map

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

package/resources/voice-clones.js

@@ -0,0 +1,117 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoiceClones = void 0;
+const resource_1 = require("../core/resource.js");
+const pagination_1 = require("../core/pagination.js");
+const headers_1 = require("../internal/headers.js");
+const uploads_1 = require("../internal/uploads.js");
+const path_1 = require("../internal/utils/path.js");
+/**
+ * Capture and manage voice identities as clones for use in text-to-speech synthesis.
+ */
+class VoiceClones extends resource_1.APIResource {
+    /**
+     * Creates a new voice clone by capturing the voice identity of an existing voice
+     * design. The clone can then be used for text-to-speech synthesis.
+     *
+     * @example
+     * ```ts
+     * const voiceClone = await client.voiceClones.create({
+     *   gender: 'male',
+     *   language: 'en',
+     *   name: 'clone-narrator',
+     *   voice_design_id: '550e8400-e29b-41d4-a716-446655440000',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/voice_clones', { body, ...options });
+    }
+    /**
+     * Updates the name, language, or gender of a voice clone.
+     *
+     * @example
+     * ```ts
+     * const voiceClone = await client.voiceClones.update(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { name: 'updated-clone' },
+     * );
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch((0, path_1.path) `/voice_clones/${id}`, { body, ...options });
+    }
+    /**
+     * Returns a paginated list of voice clones belonging to the authenticated account.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const voiceCloneListResponse of client.voiceClones.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/voice_clones', (pagination_1.DefaultFlatPagination), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Permanently deletes a voice clone. This action cannot be undone.
+     *
+     * @example
+     * ```ts
+     * await client.voiceClones.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/voice_clones/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Creates a new voice clone by uploading an audio file directly. Supported
+     * formats: WAV, MP3, FLAC, OGG, M4A. For best results, provide 5–10 seconds of
+     * clear speech. Maximum file size: 2MB.
+     *
+     * @example
+     * ```ts
+     * const response = await client.voiceClones.createFromUpload({
+     *   audio_file: fs.createReadStream('path/to/file'),
+     *   language: 'lkf-Lz1vLbBu-9uDh-9AHaOS2D-Cbf',
+     *   name: 'name',
+     * });
+     * ```
+     */
+    createFromUpload(body, options) {
+        return this._client.post('/voice_clones/from_upload', (0, uploads_1.multipartFormRequestOptions)({ body, ...options }, this._client));
+    }
+    /**
+     * Downloads the WAV audio sample that was used to create the voice clone.
+     *
+     * @example
+     * ```ts
+     * const response = await client.voiceClones.downloadSample(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
+     */
+    downloadSample(id, options) {
+        return this._client.get((0, path_1.path) `/voice_clones/${id}/sample`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: 'audio/wav' }, options?.headers]),
+            __binaryResponse: true,
+        });
+    }
+}
+exports.VoiceClones = VoiceClones;
+//# sourceMappingURL=voice-clones.js.map

package/resources/voice-clones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-clones.js","sourceRoot":"","sources":["../src/resources/voice-clones.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,sDAA0G;AAE1G,oDAAmD;AAEnD,oDAAkE;AAClE,oDAA8C;AAE9C;;GAEG;AACH,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,EAAU,EACV,IAA4B,EAC5B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,iBAAiB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAA,kCAA6C,CAAA,EAAE;YAC7F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,iBAAiB,EAAE,EAAE,EAAE;YACpD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CACd,IAAsC,EACtC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,2BAA2B,EAC3B,IAAA,qCAA2B,EAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAChE,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,iBAAiB,EAAE,SAAS,EAAE;YACxD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAClE,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;CACF;AAxHD,kCAwHC"}

package/resources/voice-clones.mjs

@@ -0,0 +1,113 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { DefaultFlatPagination } from "../core/pagination.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+import { multipartFormRequestOptions } from "../internal/uploads.mjs";
+import { path } from "../internal/utils/path.mjs";
+/**
+ * Capture and manage voice identities as clones for use in text-to-speech synthesis.
+ */
+export class VoiceClones extends APIResource {
+    /**
+     * Creates a new voice clone by capturing the voice identity of an existing voice
+     * design. The clone can then be used for text-to-speech synthesis.
+     *
+     * @example
+     * ```ts
+     * const voiceClone = await client.voiceClones.create({
+     *   gender: 'male',
+     *   language: 'en',
+     *   name: 'clone-narrator',
+     *   voice_design_id: '550e8400-e29b-41d4-a716-446655440000',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/voice_clones', { body, ...options });
+    }
+    /**
+     * Updates the name, language, or gender of a voice clone.
+     *
+     * @example
+     * ```ts
+     * const voiceClone = await client.voiceClones.update(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { name: 'updated-clone' },
+     * );
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch(path `/voice_clones/${id}`, { body, ...options });
+    }
+    /**
+     * Returns a paginated list of voice clones belonging to the authenticated account.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const voiceCloneListResponse of client.voiceClones.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/voice_clones', (DefaultFlatPagination), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Permanently deletes a voice clone. This action cannot be undone.
+     *
+     * @example
+     * ```ts
+     * await client.voiceClones.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete(path `/voice_clones/${id}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Creates a new voice clone by uploading an audio file directly. Supported
+     * formats: WAV, MP3, FLAC, OGG, M4A. For best results, provide 5–10 seconds of
+     * clear speech. Maximum file size: 2MB.
+     *
+     * @example
+     * ```ts
+     * const response = await client.voiceClones.createFromUpload({
+     *   audio_file: fs.createReadStream('path/to/file'),
+     *   language: 'lkf-Lz1vLbBu-9uDh-9AHaOS2D-Cbf',
+     *   name: 'name',
+     * });
+     * ```
+     */
+    createFromUpload(body, options) {
+        return this._client.post('/voice_clones/from_upload', multipartFormRequestOptions({ body, ...options }, this._client));
+    }
+    /**
+     * Downloads the WAV audio sample that was used to create the voice clone.
+     *
+     * @example
+     * ```ts
+     * const response = await client.voiceClones.downloadSample(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
+     */
+    downloadSample(id, options) {
+        return this._client.get(path `/voice_clones/${id}/sample`, {
+            ...options,
+            headers: buildHeaders([{ Accept: 'audio/wav' }, options?.headers]),
+            __binaryResponse: true,
+        });
+    }
+}
+//# sourceMappingURL=voice-clones.mjs.map

package/resources/voice-clones.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-clones.mjs","sourceRoot":"","sources":["../src/resources/voice-clones.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,qBAAqB,EAAiD;OAExE,EAAE,YAAY,EAAE;OAEhB,EAAE,2BAA2B,EAAE;OAC/B,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,EAAU,EACV,IAA4B,EAC5B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,iBAAiB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAA,qBAA6C,CAAA,EAAE;YAC7F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,iBAAiB,EAAE,EAAE,EAAE;YACpD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CACd,IAAsC,EACtC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,2BAA2B,EAC3B,2BAA2B,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAChE,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,iBAAiB,EAAE,SAAS,EAAE;YACxD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAClE,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;CACF"}