@zavudev/sdk 0.31.0 → 0.43.0

package/resources/contacts/contacts.d.mts

@@ -0,0 +1,276 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as ChannelsAPI from "./channels.mjs";
+import { ChannelAddParams, ChannelAddResponse, ChannelRemoveParams, ChannelSetPrimaryParams, ChannelSetPrimaryResponse, ChannelUpdateParams, ChannelUpdateResponse, Channels } from "./channels.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { Cursor, type CursorParams, PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Contacts extends APIResource {
+    channels: ChannelsAPI.Channels;
+    /**
+     * Create a new contact with one or more communication channels.
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.create({
+     *   channels: [
+     *     {
+     *       channel: 'sms',
+     *       identifier: '+14155551234',
+     *       isPrimary: true,
+     *     },
+     *   ],
+     *   displayName: 'John Doe',
+     * });
+     * ```
+     */
+    create(body: ContactCreateParams, options?: RequestOptions): APIPromise<Contact>;
+    /**
+     * Get contact
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.retrieve('contactId');
+     * ```
+     */
+    retrieve(contactID: string, options?: RequestOptions): APIPromise<Contact>;
+    /**
+     * Update contact
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.update('contactId');
+     * ```
+     */
+    update(contactID: string, body: ContactUpdateParams, options?: RequestOptions): APIPromise<Contact>;
+    /**
+     * List contacts with their communication channels.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const contact of client.contacts.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: ContactListParams | null | undefined, options?: RequestOptions): PagePromise<ContactsCursor, Contact>;
+    /**
+     * Permanently delete a contact and its communication channels. Implements
+     * right-to-erasure obligations under GDPR Art. 17, Ley 19.628 (Chile) Art. 12,
+     * CCPA § 1798.105, and LGPD Art. 18.VI. The contact, its channels, and any
+     * associated agent flow sessions and conversation threads are removed. Past
+     * message records and broadcast delivery logs are retained for billing/audit but
+     * no longer reference the deleted contact.
+     *
+     * @example
+     * ```ts
+     * await client.contacts.delete('contactId');
+     * ```
+     */
+    delete(contactID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Dismiss the merge suggestion for a contact.
+     *
+     * @example
+     * ```ts
+     * await client.contacts.dismissMergeSuggestion('contactId');
+     * ```
+     */
+    dismissMergeSuggestion(contactID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Merge a source contact into this contact. All channels from the source contact
+     * will be moved to the target contact, and the source contact will be marked as
+     * merged.
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.merge('contactId', {
+     *   sourceContactId: 'jx7xyz789',
+     * });
+     * ```
+     */
+    merge(contactID: string, body: ContactMergeParams, options?: RequestOptions): APIPromise<Contact>;
+    /**
+     * Get contact by phone number
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.retrieveByPhone(
+     *   'phoneNumber',
+     * );
+     * ```
+     */
+    retrieveByPhone(phoneNumber: string, options?: RequestOptions): APIPromise<Contact>;
+}
+export type ContactsCursor = Cursor<Contact>;
+export interface Contact {
+    id: string;
+    /**
+     * List of available messaging channels for this contact.
+     */
+    availableChannels: Array<string>;
+    createdAt: string;
+    metadata: {
+        [key: string]: string;
+    };
+    /**
+     * Whether this contact has been verified.
+     */
+    verified: boolean;
+    /**
+     * All communication channels for this contact.
+     */
+    channels?: Array<ContactChannel>;
+    countryCode?: string;
+    /**
+     * Preferred channel for this contact.
+     */
+    defaultChannel?: 'sms' | 'whatsapp' | 'telegram' | 'email' | 'instagram' | 'voice';
+    /**
+     * Display name for the contact.
+     */
+    displayName?: string;
+    /**
+     * DEPRECATED: Use primaryPhone instead. Primary phone number in E.164 format.
+     */
+    phoneNumber?: string;
+    /**
+     * Primary email address.
+     */
+    primaryEmail?: string;
+    /**
+     * Primary phone number in E.164 format.
+     */
+    primaryPhone?: string;
+    /**
+     * Contact's WhatsApp profile name. Only available for WhatsApp contacts.
+     */
+    profileName?: string | null;
+    /**
+     * ID of a contact suggested for merging.
+     */
+    suggestedMergeWith?: string;
+    updatedAt?: string;
+}
+/**
+ * A communication channel for a contact.
+ */
+export interface ContactChannel {
+    id: string;
+    /**
+     * Channel type.
+     */
+    channel: 'sms' | 'whatsapp' | 'email' | 'telegram' | 'voice';
+    createdAt: string;
+    /**
+     * Channel identifier (phone number or email address).
+     */
+    identifier: string;
+    /**
+     * Whether this is the primary channel for its type.
+     */
+    isPrimary: boolean;
+    /**
+     * Whether this channel has been verified.
+     */
+    verified: boolean;
+    /**
+     * ISO country code for phone numbers.
+     */
+    countryCode?: string;
+    /**
+     * Optional label for the channel.
+     */
+    label?: string;
+    /**
+     * Last time a message was received on this channel.
+     */
+    lastInboundAt?: string;
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Delivery metrics for this channel.
+     */
+    metrics?: ContactChannel.Metrics;
+    updatedAt?: string;
+}
+export declare namespace ContactChannel {
+    /**
+     * Delivery metrics for this channel.
+     */
+    interface Metrics {
+        avgDeliveryTimeMs?: number;
+        failureCount?: number;
+        lastSuccessAt?: string;
+        successCount?: number;
+        totalAttempts?: number;
+    }
+}
+export interface ContactCreateParams {
+    /**
+     * Communication channels for the contact.
+     */
+    channels: Array<ContactCreateParams.Channel>;
+    /**
+     * Display name for the contact.
+     */
+    displayName?: string;
+    /**
+     * Arbitrary metadata to associate with the contact.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+}
+export declare namespace ContactCreateParams {
+    /**
+     * Input for creating a contact channel.
+     */
+    interface Channel {
+        /**
+         * Channel type.
+         */
+        channel: 'sms' | 'whatsapp' | 'email' | 'telegram' | 'voice';
+        /**
+         * Channel identifier (phone number in E.164 format or email address).
+         */
+        identifier: string;
+        /**
+         * ISO country code for phone numbers.
+         */
+        countryCode?: string;
+        /**
+         * Whether this should be the primary channel for its type.
+         */
+        isPrimary?: boolean;
+        /**
+         * Optional label for the channel.
+         */
+        label?: string;
+    }
+}
+export interface ContactUpdateParams {
+    /**
+     * Preferred channel for this contact. Set to null to clear.
+     */
+    defaultChannel?: 'sms' | 'whatsapp' | 'telegram' | 'email' | 'instagram' | 'voice' | null;
+    metadata?: {
+        [key: string]: string;
+    };
+}
+export interface ContactListParams extends CursorParams {
+    phoneNumber?: string;
+}
+export interface ContactMergeParams {
+    /**
+     * ID of the contact to merge into the target contact. The source contact will be
+     * marked as merged.
+     */
+    sourceContactId: string;
+}
+export declare namespace Contacts {
+    export { type Contact as Contact, type ContactChannel as ContactChannel, type ContactsCursor as ContactsCursor, type ContactCreateParams as ContactCreateParams, type ContactUpdateParams as ContactUpdateParams, type ContactListParams as ContactListParams, type ContactMergeParams as ContactMergeParams, };
+    export { Channels as Channels, type ChannelUpdateResponse as ChannelUpdateResponse, type ChannelAddResponse as ChannelAddResponse, type ChannelSetPrimaryResponse as ChannelSetPrimaryResponse, type ChannelUpdateParams as ChannelUpdateParams, type ChannelAddParams as ChannelAddParams, type ChannelRemoveParams as ChannelRemoveParams, type ChannelSetPrimaryParams as ChannelSetPrimaryParams, };
+}
+//# sourceMappingURL=contacts.d.mts.map

package/resources/contacts/contacts.d.mts.map

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

package/resources/contacts/contacts.d.ts

@@ -0,0 +1,276 @@
+import { APIResource } from "../../core/resource.js";
+import * as ChannelsAPI from "./channels.js";
+import { ChannelAddParams, ChannelAddResponse, ChannelRemoveParams, ChannelSetPrimaryParams, ChannelSetPrimaryResponse, ChannelUpdateParams, ChannelUpdateResponse, Channels } from "./channels.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { Cursor, type CursorParams, PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Contacts extends APIResource {
+    channels: ChannelsAPI.Channels;
+    /**
+     * Create a new contact with one or more communication channels.
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.create({
+     *   channels: [
+     *     {
+     *       channel: 'sms',
+     *       identifier: '+14155551234',
+     *       isPrimary: true,
+     *     },
+     *   ],
+     *   displayName: 'John Doe',
+     * });
+     * ```
+     */
+    create(body: ContactCreateParams, options?: RequestOptions): APIPromise<Contact>;
+    /**
+     * Get contact
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.retrieve('contactId');
+     * ```
+     */
+    retrieve(contactID: string, options?: RequestOptions): APIPromise<Contact>;
+    /**
+     * Update contact
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.update('contactId');
+     * ```
+     */
+    update(contactID: string, body: ContactUpdateParams, options?: RequestOptions): APIPromise<Contact>;
+    /**
+     * List contacts with their communication channels.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const contact of client.contacts.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: ContactListParams | null | undefined, options?: RequestOptions): PagePromise<ContactsCursor, Contact>;
+    /**
+     * Permanently delete a contact and its communication channels. Implements
+     * right-to-erasure obligations under GDPR Art. 17, Ley 19.628 (Chile) Art. 12,
+     * CCPA § 1798.105, and LGPD Art. 18.VI. The contact, its channels, and any
+     * associated agent flow sessions and conversation threads are removed. Past
+     * message records and broadcast delivery logs are retained for billing/audit but
+     * no longer reference the deleted contact.
+     *
+     * @example
+     * ```ts
+     * await client.contacts.delete('contactId');
+     * ```
+     */
+    delete(contactID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Dismiss the merge suggestion for a contact.
+     *
+     * @example
+     * ```ts
+     * await client.contacts.dismissMergeSuggestion('contactId');
+     * ```
+     */
+    dismissMergeSuggestion(contactID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Merge a source contact into this contact. All channels from the source contact
+     * will be moved to the target contact, and the source contact will be marked as
+     * merged.
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.merge('contactId', {
+     *   sourceContactId: 'jx7xyz789',
+     * });
+     * ```
+     */
+    merge(contactID: string, body: ContactMergeParams, options?: RequestOptions): APIPromise<Contact>;
+    /**
+     * Get contact by phone number
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.retrieveByPhone(
+     *   'phoneNumber',
+     * );
+     * ```
+     */
+    retrieveByPhone(phoneNumber: string, options?: RequestOptions): APIPromise<Contact>;
+}
+export type ContactsCursor = Cursor<Contact>;
+export interface Contact {
+    id: string;
+    /**
+     * List of available messaging channels for this contact.
+     */
+    availableChannels: Array<string>;
+    createdAt: string;
+    metadata: {
+        [key: string]: string;
+    };
+    /**
+     * Whether this contact has been verified.
+     */
+    verified: boolean;
+    /**
+     * All communication channels for this contact.
+     */
+    channels?: Array<ContactChannel>;
+    countryCode?: string;
+    /**
+     * Preferred channel for this contact.
+     */
+    defaultChannel?: 'sms' | 'whatsapp' | 'telegram' | 'email' | 'instagram' | 'voice';
+    /**
+     * Display name for the contact.
+     */
+    displayName?: string;
+    /**
+     * DEPRECATED: Use primaryPhone instead. Primary phone number in E.164 format.
+     */
+    phoneNumber?: string;
+    /**
+     * Primary email address.
+     */
+    primaryEmail?: string;
+    /**
+     * Primary phone number in E.164 format.
+     */
+    primaryPhone?: string;
+    /**
+     * Contact's WhatsApp profile name. Only available for WhatsApp contacts.
+     */
+    profileName?: string | null;
+    /**
+     * ID of a contact suggested for merging.
+     */
+    suggestedMergeWith?: string;
+    updatedAt?: string;
+}
+/**
+ * A communication channel for a contact.
+ */
+export interface ContactChannel {
+    id: string;
+    /**
+     * Channel type.
+     */
+    channel: 'sms' | 'whatsapp' | 'email' | 'telegram' | 'voice';
+    createdAt: string;
+    /**
+     * Channel identifier (phone number or email address).
+     */
+    identifier: string;
+    /**
+     * Whether this is the primary channel for its type.
+     */
+    isPrimary: boolean;
+    /**
+     * Whether this channel has been verified.
+     */
+    verified: boolean;
+    /**
+     * ISO country code for phone numbers.
+     */
+    countryCode?: string;
+    /**
+     * Optional label for the channel.
+     */
+    label?: string;
+    /**
+     * Last time a message was received on this channel.
+     */
+    lastInboundAt?: string;
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Delivery metrics for this channel.
+     */
+    metrics?: ContactChannel.Metrics;
+    updatedAt?: string;
+}
+export declare namespace ContactChannel {
+    /**
+     * Delivery metrics for this channel.
+     */
+    interface Metrics {
+        avgDeliveryTimeMs?: number;
+        failureCount?: number;
+        lastSuccessAt?: string;
+        successCount?: number;
+        totalAttempts?: number;
+    }
+}
+export interface ContactCreateParams {
+    /**
+     * Communication channels for the contact.
+     */
+    channels: Array<ContactCreateParams.Channel>;
+    /**
+     * Display name for the contact.
+     */
+    displayName?: string;
+    /**
+     * Arbitrary metadata to associate with the contact.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+}
+export declare namespace ContactCreateParams {
+    /**
+     * Input for creating a contact channel.
+     */
+    interface Channel {
+        /**
+         * Channel type.
+         */
+        channel: 'sms' | 'whatsapp' | 'email' | 'telegram' | 'voice';
+        /**
+         * Channel identifier (phone number in E.164 format or email address).
+         */
+        identifier: string;
+        /**
+         * ISO country code for phone numbers.
+         */
+        countryCode?: string;
+        /**
+         * Whether this should be the primary channel for its type.
+         */
+        isPrimary?: boolean;
+        /**
+         * Optional label for the channel.
+         */
+        label?: string;
+    }
+}
+export interface ContactUpdateParams {
+    /**
+     * Preferred channel for this contact. Set to null to clear.
+     */
+    defaultChannel?: 'sms' | 'whatsapp' | 'telegram' | 'email' | 'instagram' | 'voice' | null;
+    metadata?: {
+        [key: string]: string;
+    };
+}
+export interface ContactListParams extends CursorParams {
+    phoneNumber?: string;
+}
+export interface ContactMergeParams {
+    /**
+     * ID of the contact to merge into the target contact. The source contact will be
+     * marked as merged.
+     */
+    sourceContactId: string;
+}
+export declare namespace Contacts {
+    export { type Contact as Contact, type ContactChannel as ContactChannel, type ContactsCursor as ContactsCursor, type ContactCreateParams as ContactCreateParams, type ContactUpdateParams as ContactUpdateParams, type ContactListParams as ContactListParams, type ContactMergeParams as ContactMergeParams, };
+    export { Channels as Channels, type ChannelUpdateResponse as ChannelUpdateResponse, type ChannelAddResponse as ChannelAddResponse, type ChannelSetPrimaryResponse as ChannelSetPrimaryResponse, type ChannelUpdateParams as ChannelUpdateParams, type ChannelAddParams as ChannelAddParams, type ChannelRemoveParams as ChannelRemoveParams, type ChannelSetPrimaryParams as ChannelSetPrimaryParams, };
+}
+//# sourceMappingURL=contacts.d.ts.map

package/resources/contacts/contacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/resources/contacts/contacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,WAAW,sBAAmB;AAC1C,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,QAAQ,EACT,sBAAmB;AACpB,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,WAAW,EAAE,iCAA8B;AAE/E,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE,qBAAa,QAAS,SAAQ,WAAW;IACvC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;IAExE;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAIhF;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAI1E;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAInG;;;;;;;;;;OAUG;IACH,IAAI,CACF,KAAK,GAAE,iBAAiB,GAAG,IAAI,GAAG,SAAc,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC;IAIvC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOrE;;;;;;;OAOG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOrF;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAIjG;;;;;;;;;OASG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;CAGpF;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAE7C,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEjC,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAEpC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAEjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;IAEnF;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IAE7D,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAErC;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC;IAEjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,yBAAiB,cAAc,CAAC;IAC9B;;OAEG;IACH,UAAiB,OAAO;QACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAE3B,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,aAAa,CAAC,EAAE,MAAM,CAAC;QAEvB,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE7C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,yBAAiB,mBAAmB,CAAC;IACnC;;OAEG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,OAAO,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;QAE7D;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,SAAS,CAAC,EAAE,OAAO,CAAC;QAEpB;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,IAAI,CAAC;IAE1F,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,OAAO,IAAI,OAAO,EACvB,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;IAEF,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}