@linqapp/sdk 0.1.0-alpha.1

package/resources/webhooks/subscriptions.d.mts

@@ -0,0 +1,237 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Subscriptions extends APIResource {
+    /**
+     * Create a new webhook subscription to receive events at a target URL. Upon
+     * creation, a signing secret is generated for verifying webhook authenticity.
+     * **Store this secret securely — it cannot be retrieved later.**
+     *
+     * **Webhook Delivery:**
+     *
+     * - Events are sent via HTTP POST to the target URL
+     * - Each request includes `X-Webhook-Signature` and `X-Webhook-Timestamp` headers
+     * - Signature is HMAC-SHA256 over `{timestamp}.{payload}` — see
+     *   [Webhook Events](/docs/webhook-events) for verification details
+     * - Failed deliveries (5xx, 429, network errors) are retried up to 6 times with
+     *   exponential backoff: 2s, 4s, 8s, 16s, 30s
+     * - Client errors (4xx except 429) are not retried
+     *
+     * @example
+     * ```ts
+     * const subscription =
+     *   await client.webhooks.subscriptions.create({
+     *     subscribed_events: [
+     *       'message.sent',
+     *       'message.delivered',
+     *       'message.read',
+     *     ],
+     *     target_url: 'https://webhooks.example.com/linq/events',
+     *   });
+     * ```
+     */
+    create(body: SubscriptionCreateParams, options?: RequestOptions): APIPromise<SubscriptionCreateResponse>;
+    /**
+     * Retrieve details for a specific webhook subscription including its target URL,
+     * subscribed events, and current status.
+     *
+     * @example
+     * ```ts
+     * const subscription =
+     *   await client.webhooks.subscriptions.retrieve(
+     *     'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+     *   );
+     * ```
+     */
+    retrieve(subscriptionID: string, options?: RequestOptions): APIPromise<SubscriptionRetrieveResponse>;
+    /**
+     * Update an existing webhook subscription. You can modify the target URL,
+     * subscribed events, or activate/deactivate the subscription.
+     *
+     * **Note:** The signing secret cannot be changed via this endpoint.
+     *
+     * @example
+     * ```ts
+     * const subscription =
+     *   await client.webhooks.subscriptions.update(
+     *     'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+     *     {
+     *       target_url:
+     *         'https://webhooks.example.com/linq/events',
+     *     },
+     *   );
+     * ```
+     */
+    update(subscriptionID: string, body: SubscriptionUpdateParams, options?: RequestOptions): APIPromise<SubscriptionUpdateResponse>;
+    /**
+     * Retrieve all webhook subscriptions for the authenticated partner. Returns a list
+     * of active and inactive subscriptions with their configuration and status.
+     *
+     * @example
+     * ```ts
+     * const subscriptions =
+     *   await client.webhooks.subscriptions.list();
+     * ```
+     */
+    list(options?: RequestOptions): APIPromise<SubscriptionListResponse>;
+    /**
+     * Delete a webhook subscription.
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.subscriptions.delete(
+     *   'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+     * );
+     * ```
+     */
+    delete(subscriptionID: string, options?: RequestOptions): APIPromise<void>;
+}
+/**
+ * Response returned when creating a webhook subscription. Includes the signing
+ * secret which is only shown once.
+ */
+export interface SubscriptionCreateResponse {
+    /**
+     * Unique identifier for the webhook subscription
+     */
+    id: string;
+    /**
+     * When the subscription was created
+     */
+    created_at: string;
+    /**
+     * Whether this subscription is currently active
+     */
+    is_active: boolean;
+    /**
+     * Secret for verifying webhook signatures. Store this securely - it cannot be
+     * retrieved again.
+     */
+    signing_secret: string;
+    /**
+     * List of event types this subscription receives
+     */
+    subscribed_events: Array<'message.sent' | 'message.received' | 'message.read' | 'message.delivered' | 'message.failed' | 'reaction.added' | 'reaction.removed' | 'participant.added' | 'participant.removed' | 'chat.created' | 'chat.group_name_updated' | 'chat.group_icon_updated' | 'chat.group_name_update_failed' | 'chat.group_icon_update_failed' | 'chat.typing_indicator.started' | 'chat.typing_indicator.stopped' | 'phone_number.status_updated'>;
+    /**
+     * URL where webhook events will be sent
+     */
+    target_url: string;
+    /**
+     * When the subscription was last updated
+     */
+    updated_at: string;
+}
+export interface SubscriptionRetrieveResponse {
+    /**
+     * Unique identifier for the webhook subscription
+     */
+    id: string;
+    /**
+     * When the subscription was created
+     */
+    created_at: string;
+    /**
+     * Whether this subscription is currently active
+     */
+    is_active: boolean;
+    /**
+     * List of event types this subscription receives
+     */
+    subscribed_events: Array<'message.sent' | 'message.received' | 'message.read' | 'message.delivered' | 'message.failed' | 'reaction.added' | 'reaction.removed' | 'participant.added' | 'participant.removed' | 'chat.created' | 'chat.group_name_updated' | 'chat.group_icon_updated' | 'chat.group_name_update_failed' | 'chat.group_icon_update_failed' | 'chat.typing_indicator.started' | 'chat.typing_indicator.stopped' | 'phone_number.status_updated'>;
+    /**
+     * URL where webhook events will be sent
+     */
+    target_url: string;
+    /**
+     * When the subscription was last updated
+     */
+    updated_at: string;
+}
+export interface SubscriptionUpdateResponse {
+    /**
+     * Unique identifier for the webhook subscription
+     */
+    id: string;
+    /**
+     * When the subscription was created
+     */
+    created_at: string;
+    /**
+     * Whether this subscription is currently active
+     */
+    is_active: boolean;
+    /**
+     * List of event types this subscription receives
+     */
+    subscribed_events: Array<'message.sent' | 'message.received' | 'message.read' | 'message.delivered' | 'message.failed' | 'reaction.added' | 'reaction.removed' | 'participant.added' | 'participant.removed' | 'chat.created' | 'chat.group_name_updated' | 'chat.group_icon_updated' | 'chat.group_name_update_failed' | 'chat.group_icon_update_failed' | 'chat.typing_indicator.started' | 'chat.typing_indicator.stopped' | 'phone_number.status_updated'>;
+    /**
+     * URL where webhook events will be sent
+     */
+    target_url: string;
+    /**
+     * When the subscription was last updated
+     */
+    updated_at: string;
+}
+export interface SubscriptionListResponse {
+    /**
+     * List of webhook subscriptions
+     */
+    subscriptions: Array<SubscriptionListResponse.Subscription>;
+}
+export declare namespace SubscriptionListResponse {
+    interface Subscription {
+        /**
+         * Unique identifier for the webhook subscription
+         */
+        id: string;
+        /**
+         * When the subscription was created
+         */
+        created_at: string;
+        /**
+         * Whether this subscription is currently active
+         */
+        is_active: boolean;
+        /**
+         * List of event types this subscription receives
+         */
+        subscribed_events: Array<'message.sent' | 'message.received' | 'message.read' | 'message.delivered' | 'message.failed' | 'reaction.added' | 'reaction.removed' | 'participant.added' | 'participant.removed' | 'chat.created' | 'chat.group_name_updated' | 'chat.group_icon_updated' | 'chat.group_name_update_failed' | 'chat.group_icon_update_failed' | 'chat.typing_indicator.started' | 'chat.typing_indicator.stopped' | 'phone_number.status_updated'>;
+        /**
+         * URL where webhook events will be sent
+         */
+        target_url: string;
+        /**
+         * When the subscription was last updated
+         */
+        updated_at: string;
+    }
+}
+export interface SubscriptionCreateParams {
+    /**
+     * List of event types to subscribe to
+     */
+    subscribed_events: Array<'message.sent' | 'message.received' | 'message.read' | 'message.delivered' | 'message.failed' | 'reaction.added' | 'reaction.removed' | 'participant.added' | 'participant.removed' | 'chat.created' | 'chat.group_name_updated' | 'chat.group_icon_updated' | 'chat.group_name_update_failed' | 'chat.group_icon_update_failed' | 'chat.typing_indicator.started' | 'chat.typing_indicator.stopped' | 'phone_number.status_updated'>;
+    /**
+     * URL where webhook events will be sent. Must be HTTPS.
+     */
+    target_url: string;
+}
+export interface SubscriptionUpdateParams {
+    /**
+     * Activate or deactivate the subscription
+     */
+    is_active?: boolean;
+    /**
+     * Updated list of event types to subscribe to
+     */
+    subscribed_events?: Array<'message.sent' | 'message.received' | 'message.read' | 'message.delivered' | 'message.failed' | 'reaction.added' | 'reaction.removed' | 'participant.added' | 'participant.removed' | 'chat.created' | 'chat.group_name_updated' | 'chat.group_icon_updated' | 'chat.group_name_update_failed' | 'chat.group_icon_update_failed' | 'chat.typing_indicator.started' | 'chat.typing_indicator.stopped' | 'phone_number.status_updated'>;
+    /**
+     * New target URL for webhook events
+     */
+    target_url?: string;
+}
+export declare namespace Subscriptions {
+    export { type SubscriptionCreateResponse as SubscriptionCreateResponse, type SubscriptionRetrieveResponse as SubscriptionRetrieveResponse, type SubscriptionUpdateResponse as SubscriptionUpdateResponse, type SubscriptionListResponse as SubscriptionListResponse, type SubscriptionCreateParams as SubscriptionCreateParams, type SubscriptionUpdateParams as SubscriptionUpdateParams, };
+}
+//# sourceMappingURL=subscriptions.d.mts.map

package/resources/webhooks/subscriptions.d.mts.map

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

package/resources/webhooks/subscriptions.d.ts

@@ -0,0 +1,237 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Subscriptions extends APIResource {
+    /**
+     * Create a new webhook subscription to receive events at a target URL. Upon
+     * creation, a signing secret is generated for verifying webhook authenticity.
+     * **Store this secret securely — it cannot be retrieved later.**
+     *
+     * **Webhook Delivery:**
+     *
+     * - Events are sent via HTTP POST to the target URL
+     * - Each request includes `X-Webhook-Signature` and `X-Webhook-Timestamp` headers
+     * - Signature is HMAC-SHA256 over `{timestamp}.{payload}` — see
+     *   [Webhook Events](/docs/webhook-events) for verification details
+     * - Failed deliveries (5xx, 429, network errors) are retried up to 6 times with
+     *   exponential backoff: 2s, 4s, 8s, 16s, 30s
+     * - Client errors (4xx except 429) are not retried
+     *
+     * @example
+     * ```ts
+     * const subscription =
+     *   await client.webhooks.subscriptions.create({
+     *     subscribed_events: [
+     *       'message.sent',
+     *       'message.delivered',
+     *       'message.read',
+     *     ],
+     *     target_url: 'https://webhooks.example.com/linq/events',
+     *   });
+     * ```
+     */
+    create(body: SubscriptionCreateParams, options?: RequestOptions): APIPromise<SubscriptionCreateResponse>;
+    /**
+     * Retrieve details for a specific webhook subscription including its target URL,
+     * subscribed events, and current status.
+     *
+     * @example
+     * ```ts
+     * const subscription =
+     *   await client.webhooks.subscriptions.retrieve(
+     *     'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+     *   );
+     * ```
+     */
+    retrieve(subscriptionID: string, options?: RequestOptions): APIPromise<SubscriptionRetrieveResponse>;
+    /**
+     * Update an existing webhook subscription. You can modify the target URL,
+     * subscribed events, or activate/deactivate the subscription.
+     *
+     * **Note:** The signing secret cannot be changed via this endpoint.
+     *
+     * @example
+     * ```ts
+     * const subscription =
+     *   await client.webhooks.subscriptions.update(
+     *     'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+     *     {
+     *       target_url:
+     *         'https://webhooks.example.com/linq/events',
+     *     },
+     *   );
+     * ```
+     */
+    update(subscriptionID: string, body: SubscriptionUpdateParams, options?: RequestOptions): APIPromise<SubscriptionUpdateResponse>;
+    /**
+     * Retrieve all webhook subscriptions for the authenticated partner. Returns a list
+     * of active and inactive subscriptions with their configuration and status.
+     *
+     * @example
+     * ```ts
+     * const subscriptions =
+     *   await client.webhooks.subscriptions.list();
+     * ```
+     */
+    list(options?: RequestOptions): APIPromise<SubscriptionListResponse>;
+    /**
+     * Delete a webhook subscription.
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.subscriptions.delete(
+     *   'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+     * );
+     * ```
+     */
+    delete(subscriptionID: string, options?: RequestOptions): APIPromise<void>;
+}
+/**
+ * Response returned when creating a webhook subscription. Includes the signing
+ * secret which is only shown once.
+ */
+export interface SubscriptionCreateResponse {
+    /**
+     * Unique identifier for the webhook subscription
+     */
+    id: string;
+    /**
+     * When the subscription was created
+     */
+    created_at: string;
+    /**
+     * Whether this subscription is currently active
+     */
+    is_active: boolean;
+    /**
+     * Secret for verifying webhook signatures. Store this securely - it cannot be
+     * retrieved again.
+     */
+    signing_secret: string;
+    /**
+     * List of event types this subscription receives
+     */
+    subscribed_events: Array<'message.sent' | 'message.received' | 'message.read' | 'message.delivered' | 'message.failed' | 'reaction.added' | 'reaction.removed' | 'participant.added' | 'participant.removed' | 'chat.created' | 'chat.group_name_updated' | 'chat.group_icon_updated' | 'chat.group_name_update_failed' | 'chat.group_icon_update_failed' | 'chat.typing_indicator.started' | 'chat.typing_indicator.stopped' | 'phone_number.status_updated'>;
+    /**
+     * URL where webhook events will be sent
+     */
+    target_url: string;
+    /**
+     * When the subscription was last updated
+     */
+    updated_at: string;
+}
+export interface SubscriptionRetrieveResponse {
+    /**
+     * Unique identifier for the webhook subscription
+     */
+    id: string;
+    /**
+     * When the subscription was created
+     */
+    created_at: string;
+    /**
+     * Whether this subscription is currently active
+     */
+    is_active: boolean;
+    /**
+     * List of event types this subscription receives
+     */
+    subscribed_events: Array<'message.sent' | 'message.received' | 'message.read' | 'message.delivered' | 'message.failed' | 'reaction.added' | 'reaction.removed' | 'participant.added' | 'participant.removed' | 'chat.created' | 'chat.group_name_updated' | 'chat.group_icon_updated' | 'chat.group_name_update_failed' | 'chat.group_icon_update_failed' | 'chat.typing_indicator.started' | 'chat.typing_indicator.stopped' | 'phone_number.status_updated'>;
+    /**
+     * URL where webhook events will be sent
+     */
+    target_url: string;
+    /**
+     * When the subscription was last updated
+     */
+    updated_at: string;
+}
+export interface SubscriptionUpdateResponse {
+    /**
+     * Unique identifier for the webhook subscription
+     */
+    id: string;
+    /**
+     * When the subscription was created
+     */
+    created_at: string;
+    /**
+     * Whether this subscription is currently active
+     */
+    is_active: boolean;
+    /**
+     * List of event types this subscription receives
+     */
+    subscribed_events: Array<'message.sent' | 'message.received' | 'message.read' | 'message.delivered' | 'message.failed' | 'reaction.added' | 'reaction.removed' | 'participant.added' | 'participant.removed' | 'chat.created' | 'chat.group_name_updated' | 'chat.group_icon_updated' | 'chat.group_name_update_failed' | 'chat.group_icon_update_failed' | 'chat.typing_indicator.started' | 'chat.typing_indicator.stopped' | 'phone_number.status_updated'>;
+    /**
+     * URL where webhook events will be sent
+     */
+    target_url: string;
+    /**
+     * When the subscription was last updated
+     */
+    updated_at: string;
+}
+export interface SubscriptionListResponse {
+    /**
+     * List of webhook subscriptions
+     */
+    subscriptions: Array<SubscriptionListResponse.Subscription>;
+}
+export declare namespace SubscriptionListResponse {
+    interface Subscription {
+        /**
+         * Unique identifier for the webhook subscription
+         */
+        id: string;
+        /**
+         * When the subscription was created
+         */
+        created_at: string;
+        /**
+         * Whether this subscription is currently active
+         */
+        is_active: boolean;
+        /**
+         * List of event types this subscription receives
+         */
+        subscribed_events: Array<'message.sent' | 'message.received' | 'message.read' | 'message.delivered' | 'message.failed' | 'reaction.added' | 'reaction.removed' | 'participant.added' | 'participant.removed' | 'chat.created' | 'chat.group_name_updated' | 'chat.group_icon_updated' | 'chat.group_name_update_failed' | 'chat.group_icon_update_failed' | 'chat.typing_indicator.started' | 'chat.typing_indicator.stopped' | 'phone_number.status_updated'>;
+        /**
+         * URL where webhook events will be sent
+         */
+        target_url: string;
+        /**
+         * When the subscription was last updated
+         */
+        updated_at: string;
+    }
+}
+export interface SubscriptionCreateParams {
+    /**
+     * List of event types to subscribe to
+     */
+    subscribed_events: Array<'message.sent' | 'message.received' | 'message.read' | 'message.delivered' | 'message.failed' | 'reaction.added' | 'reaction.removed' | 'participant.added' | 'participant.removed' | 'chat.created' | 'chat.group_name_updated' | 'chat.group_icon_updated' | 'chat.group_name_update_failed' | 'chat.group_icon_update_failed' | 'chat.typing_indicator.started' | 'chat.typing_indicator.stopped' | 'phone_number.status_updated'>;
+    /**
+     * URL where webhook events will be sent. Must be HTTPS.
+     */
+    target_url: string;
+}
+export interface SubscriptionUpdateParams {
+    /**
+     * Activate or deactivate the subscription
+     */
+    is_active?: boolean;
+    /**
+     * Updated list of event types to subscribe to
+     */
+    subscribed_events?: Array<'message.sent' | 'message.received' | 'message.read' | 'message.delivered' | 'message.failed' | 'reaction.added' | 'reaction.removed' | 'participant.added' | 'participant.removed' | 'chat.created' | 'chat.group_name_updated' | 'chat.group_icon_updated' | 'chat.group_name_update_failed' | 'chat.group_icon_update_failed' | 'chat.typing_indicator.started' | 'chat.typing_indicator.stopped' | 'phone_number.status_updated'>;
+    /**
+     * New target URL for webhook events
+     */
+    target_url?: string;
+}
+export declare namespace Subscriptions {
+    export { type SubscriptionCreateResponse as SubscriptionCreateResponse, type SubscriptionRetrieveResponse as SubscriptionRetrieveResponse, type SubscriptionUpdateResponse as SubscriptionUpdateResponse, type SubscriptionListResponse as SubscriptionListResponse, type SubscriptionCreateParams as SubscriptionCreateParams, type SubscriptionUpdateParams as SubscriptionUpdateParams, };
+}
+//# sourceMappingURL=subscriptions.d.ts.map

package/resources/webhooks/subscriptions.d.ts.map

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

package/resources/webhooks/subscriptions.js

@@ -0,0 +1,107 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Subscriptions = void 0;
+const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+class Subscriptions extends resource_1.APIResource {
+    /**
+     * Create a new webhook subscription to receive events at a target URL. Upon
+     * creation, a signing secret is generated for verifying webhook authenticity.
+     * **Store this secret securely — it cannot be retrieved later.**
+     *
+     * **Webhook Delivery:**
+     *
+     * - Events are sent via HTTP POST to the target URL
+     * - Each request includes `X-Webhook-Signature` and `X-Webhook-Timestamp` headers
+     * - Signature is HMAC-SHA256 over `{timestamp}.{payload}` — see
+     *   [Webhook Events](/docs/webhook-events) for verification details
+     * - Failed deliveries (5xx, 429, network errors) are retried up to 6 times with
+     *   exponential backoff: 2s, 4s, 8s, 16s, 30s
+     * - Client errors (4xx except 429) are not retried
+     *
+     * @example
+     * ```ts
+     * const subscription =
+     *   await client.webhooks.subscriptions.create({
+     *     subscribed_events: [
+     *       'message.sent',
+     *       'message.delivered',
+     *       'message.read',
+     *     ],
+     *     target_url: 'https://webhooks.example.com/linq/events',
+     *   });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v3/webhook-subscriptions', { body, ...options });
+    }
+    /**
+     * Retrieve details for a specific webhook subscription including its target URL,
+     * subscribed events, and current status.
+     *
+     * @example
+     * ```ts
+     * const subscription =
+     *   await client.webhooks.subscriptions.retrieve(
+     *     'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+     *   );
+     * ```
+     */
+    retrieve(subscriptionID, options) {
+        return this._client.get((0, path_1.path) `/v3/webhook-subscriptions/${subscriptionID}`, options);
+    }
+    /**
+     * Update an existing webhook subscription. You can modify the target URL,
+     * subscribed events, or activate/deactivate the subscription.
+     *
+     * **Note:** The signing secret cannot be changed via this endpoint.
+     *
+     * @example
+     * ```ts
+     * const subscription =
+     *   await client.webhooks.subscriptions.update(
+     *     'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+     *     {
+     *       target_url:
+     *         'https://webhooks.example.com/linq/events',
+     *     },
+     *   );
+     * ```
+     */
+    update(subscriptionID, body, options) {
+        return this._client.put((0, path_1.path) `/v3/webhook-subscriptions/${subscriptionID}`, { body, ...options });
+    }
+    /**
+     * Retrieve all webhook subscriptions for the authenticated partner. Returns a list
+     * of active and inactive subscriptions with their configuration and status.
+     *
+     * @example
+     * ```ts
+     * const subscriptions =
+     *   await client.webhooks.subscriptions.list();
+     * ```
+     */
+    list(options) {
+        return this._client.get('/v3/webhook-subscriptions', options);
+    }
+    /**
+     * Delete a webhook subscription.
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.subscriptions.delete(
+     *   'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+     * );
+     * ```
+     */
+    delete(subscriptionID, options) {
+        return this._client.delete((0, path_1.path) `/v3/webhook-subscriptions/${subscriptionID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Subscriptions = Subscriptions;
+//# sourceMappingURL=subscriptions.js.map

package/resources/webhooks/subscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../src/resources/webhooks/subscriptions.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,aAAc,SAAQ,sBAAW;IAC5C;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,IAA8B,EAAE,OAAwB;QAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,cAAsB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,6BAA6B,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IACtF,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CACJ,cAAsB,EACtB,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,6BAA6B,cAAc,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;;;;;;;;OASG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,cAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,6BAA6B,cAAc,EAAE,EAAE;YAC5E,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;CACF;AAzGD,sCAyGC"}