@agentuity/core 1.0.32 → 1.0.34

package/dist/services/webhook/util.d.ts

@@ -0,0 +1,202 @@
+/**
+ * General webhook operation error.
+ *
+ * Thrown when a webhook operation fails for reasons other than not-found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await createWebhook(client, { name: 'my-webhook' });
+ * } catch (error) {
+ *   if (error instanceof WebhookError) {
+ *     console.error(`Webhook operation failed: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+export declare const WebhookError: {
+    new (args?: ({
+        webhookId?: string;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "WebhookError";
+    } & Readonly<{
+        webhookId?: string;
+    }>;
+    readonly defaultMessage?: string;
+};
+/**
+ * Error thrown when a webhook is not found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await getWebhook(client, 'wh_nonexistent');
+ * } catch (error) {
+ *   if (error instanceof WebhookNotFoundError) {
+ *     console.error(`Webhook not found: ${error.webhookId}`);
+ *   }
+ * }
+ * ```
+ */
+export declare const WebhookNotFoundError: {
+    new (args?: ({
+        webhookId: string;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "WebhookNotFoundError";
+    } & Readonly<{
+        webhookId: string;
+    }>;
+    readonly defaultMessage?: string;
+};
+/**
+ * Error thrown when a webhook destination is not found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await deleteWebhookDestination(client, 'wh_abc', 'whds_nonexistent');
+ * } catch (error) {
+ *   if (error instanceof WebhookDestinationNotFoundError) {
+ *     console.error(`Destination ${error.destinationId} not found`);
+ *   }
+ * }
+ * ```
+ */
+export declare const WebhookDestinationNotFoundError: {
+    new (args?: ({
+        webhookId: string;
+        destinationId: string;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "WebhookDestinationNotFoundError";
+    } & Readonly<{
+        webhookId: string;
+        destinationId: string;
+    }>;
+    readonly defaultMessage?: string;
+};
+/**
+ * Error thrown when a webhook receipt is not found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await getWebhookReceipt(client, 'wh_abc', 'whrc_nonexistent');
+ * } catch (error) {
+ *   if (error instanceof WebhookReceiptNotFoundError) {
+ *     console.error(`Receipt ${error.receiptId} not found`);
+ *   }
+ * }
+ * ```
+ */
+export declare const WebhookReceiptNotFoundError: {
+    new (args?: ({
+        webhookId: string;
+        receiptId: string;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "WebhookReceiptNotFoundError";
+    } & Readonly<{
+        webhookId: string;
+        receiptId: string;
+    }>;
+    readonly defaultMessage?: string;
+};
+/**
+ * Error thrown when a webhook delivery is not found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await retryWebhookDelivery(client, 'wh_abc', 'whdv_nonexistent');
+ * } catch (error) {
+ *   if (error instanceof WebhookDeliveryNotFoundError) {
+ *     console.error(`Delivery ${error.deliveryId} not found`);
+ *   }
+ * }
+ * ```
+ */
+export declare const WebhookDeliveryNotFoundError: {
+    new (args?: ({
+        webhookId: string;
+        deliveryId: string;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "WebhookDeliveryNotFoundError";
+    } & Readonly<{
+        webhookId: string;
+        deliveryId: string;
+    }>;
+    readonly defaultMessage?: string;
+};
+/**
+ * Constructs a full API path for webhook operations.
+ *
+ * Pattern: `/webhook/${verb}/${segments.join('/')}`
+ * Each verb is unique to avoid route conflicts with the Go mux.
+ *
+ * @param verb - The action verb (e.g., 'create', 'list', 'get', 'destination-list')
+ * @param segments - Additional path segments (e.g., webhook ID, sub-resource ID)
+ * @returns The full API path with verb prefix
+ *
+ * @internal
+ */
+export declare function webhookApiPath(verb: string, ...segments: string[]): string;
+/**
+ * Constructs a full API path for webhook operations with query string.
+ *
+ * @param verb - The action verb
+ * @param queryString - Query string to append (without leading ?)
+ * @param segments - Additional path segments
+ * @returns The full API path with version, verb, and query string
+ *
+ * @internal
+ */
+export declare function webhookApiPathWithQuery(verb: string, queryString: string | undefined, ...segments: string[]): string;
+/**
+ * Constructs the public ingest URL for a webhook.
+ *
+ * Pattern: `/webhook/{orgId}-{webhookId}` (non-versioned, public)
+ *
+ * @param orgId - The organization ID
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @returns The public ingest URL
+ *
+ * @internal
+ */
+export declare function webhookIngestPath(orgId: string, webhookId: string): string;
+/**
+ * Builds headers for webhook API requests.
+ *
+ * @param orgId - Optional organization ID for CLI authentication
+ * @returns Headers object to pass to API client
+ *
+ * @internal
+ */
+export declare function buildWebhookHeaders(orgId?: string): Record<string, string> | undefined;
+/**
+ * Wraps an API call and translates APIError with HTTP status codes to domain-specific webhook errors.
+ *
+ * - 404 → WebhookNotFoundError / WebhookDestinationNotFoundError / WebhookReceiptNotFoundError / WebhookDeliveryNotFoundError
+ *
+ * @internal
+ */
+export declare function withWebhookErrorHandling<T>(apiCall: () => Promise<T>, context: {
+    webhookId?: string;
+    destinationId?: string;
+    receiptId?: string;
+    deliveryId?: string;
+}): Promise<T>;
+//# sourceMappingURL=util.d.ts.map

package/dist/services/webhook/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/services/webhook/util.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY;;oBAAiD,MAAM;;;;;;;oBAAN,MAAM;;;CAAK,CAAC;AAEtF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB;;mBACrB,MAAM;;;;;;;mBAAN,MAAM;;;CACd,CAAC;AAEL;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,+BAA+B;;mBAChC,MAAM;uBACF,MAAM;;;;;;;mBADV,MAAM;uBACF,MAAM;;;CAClB,CAAC;AAEL;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,2BAA2B;;mBAC5B,MAAM;mBACN,MAAM;;;;;;;mBADN,MAAM;mBACN,MAAM;;;CACd,CAAC;AAEL;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,4BAA4B;;mBAC7B,MAAM;oBACL,MAAM;;;;;;;mBADP,MAAM;oBACL,MAAM;;;CACf,CAAC;AAML;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAM1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,GAAG,QAAQ,EAAE,MAAM,EAAE,GACnB,MAAM,CAGR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1E;AAMD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAKtF;AAMD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC/C,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,GACC,OAAO,CAAC,CAAC,CAAC,CAqCZ"}

package/dist/services/webhook/util.js

@@ -0,0 +1,199 @@
+import { StructuredError } from "../../error.js";
+import { APIError } from "../api.js";
+// ============================================================================
+// Error Types
+// ============================================================================
+/**
+ * General webhook operation error.
+ *
+ * Thrown when a webhook operation fails for reasons other than not-found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await createWebhook(client, { name: 'my-webhook' });
+ * } catch (error) {
+ *   if (error instanceof WebhookError) {
+ *     console.error(`Webhook operation failed: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+export const WebhookError = StructuredError('WebhookError')();
+/**
+ * Error thrown when a webhook is not found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await getWebhook(client, 'wh_nonexistent');
+ * } catch (error) {
+ *   if (error instanceof WebhookNotFoundError) {
+ *     console.error(`Webhook not found: ${error.webhookId}`);
+ *   }
+ * }
+ * ```
+ */
+export const WebhookNotFoundError = StructuredError('WebhookNotFoundError')();
+/**
+ * Error thrown when a webhook destination is not found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await deleteWebhookDestination(client, 'wh_abc', 'whds_nonexistent');
+ * } catch (error) {
+ *   if (error instanceof WebhookDestinationNotFoundError) {
+ *     console.error(`Destination ${error.destinationId} not found`);
+ *   }
+ * }
+ * ```
+ */
+export const WebhookDestinationNotFoundError = StructuredError('WebhookDestinationNotFoundError')();
+/**
+ * Error thrown when a webhook receipt is not found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await getWebhookReceipt(client, 'wh_abc', 'whrc_nonexistent');
+ * } catch (error) {
+ *   if (error instanceof WebhookReceiptNotFoundError) {
+ *     console.error(`Receipt ${error.receiptId} not found`);
+ *   }
+ * }
+ * ```
+ */
+export const WebhookReceiptNotFoundError = StructuredError('WebhookReceiptNotFoundError')();
+/**
+ * Error thrown when a webhook delivery is not found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await retryWebhookDelivery(client, 'wh_abc', 'whdv_nonexistent');
+ * } catch (error) {
+ *   if (error instanceof WebhookDeliveryNotFoundError) {
+ *     console.error(`Delivery ${error.deliveryId} not found`);
+ *   }
+ * }
+ * ```
+ */
+export const WebhookDeliveryNotFoundError = StructuredError('WebhookDeliveryNotFoundError')();
+// ============================================================================
+// API Path Helpers
+// ============================================================================
+/**
+ * Constructs a full API path for webhook operations.
+ *
+ * Pattern: `/webhook/${verb}/${segments.join('/')}`
+ * Each verb is unique to avoid route conflicts with the Go mux.
+ *
+ * @param verb - The action verb (e.g., 'create', 'list', 'get', 'destination-list')
+ * @param segments - Additional path segments (e.g., webhook ID, sub-resource ID)
+ * @returns The full API path with verb prefix
+ *
+ * @internal
+ */
+export function webhookApiPath(verb, ...segments) {
+    const encoded = segments.map((s) => encodeURIComponent(s)).join('/');
+    if (encoded) {
+        return `/webhook/${verb}/${encoded}`;
+    }
+    return `/webhook/${verb}`;
+}
+/**
+ * Constructs a full API path for webhook operations with query string.
+ *
+ * @param verb - The action verb
+ * @param queryString - Query string to append (without leading ?)
+ * @param segments - Additional path segments
+ * @returns The full API path with version, verb, and query string
+ *
+ * @internal
+ */
+export function webhookApiPathWithQuery(verb, queryString, ...segments) {
+    const basePath = webhookApiPath(verb, ...segments);
+    return queryString ? `${basePath}?${queryString}` : basePath;
+}
+/**
+ * Constructs the public ingest URL for a webhook.
+ *
+ * Pattern: `/webhook/{orgId}-{webhookId}` (non-versioned, public)
+ *
+ * @param orgId - The organization ID
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @returns The public ingest URL
+ *
+ * @internal
+ */
+export function webhookIngestPath(orgId, webhookId) {
+    return `/webhook/${encodeURIComponent(orgId)}-${encodeURIComponent(webhookId)}`;
+}
+// ============================================================================
+// Header Builder
+// ============================================================================
+/**
+ * Builds headers for webhook API requests.
+ *
+ * @param orgId - Optional organization ID for CLI authentication
+ * @returns Headers object to pass to API client
+ *
+ * @internal
+ */
+export function buildWebhookHeaders(orgId) {
+    if (orgId) {
+        return { 'x-agentuity-orgid': orgId };
+    }
+    return undefined;
+}
+// ============================================================================
+// Error Handling
+// ============================================================================
+/**
+ * Wraps an API call and translates APIError with HTTP status codes to domain-specific webhook errors.
+ *
+ * - 404 → WebhookNotFoundError / WebhookDestinationNotFoundError / WebhookReceiptNotFoundError / WebhookDeliveryNotFoundError
+ *
+ * @internal
+ */
+export async function withWebhookErrorHandling(apiCall, context) {
+    try {
+        return await apiCall();
+    }
+    catch (error) {
+        if (error instanceof APIError) {
+            if (error.status === 404) {
+                if (context.deliveryId && context.webhookId) {
+                    throw new WebhookDeliveryNotFoundError({
+                        webhookId: context.webhookId,
+                        deliveryId: context.deliveryId,
+                        message: error.message,
+                    });
+                }
+                if (context.receiptId && context.webhookId) {
+                    throw new WebhookReceiptNotFoundError({
+                        webhookId: context.webhookId,
+                        receiptId: context.receiptId,
+                        message: error.message,
+                    });
+                }
+                if (context.destinationId && context.webhookId) {
+                    throw new WebhookDestinationNotFoundError({
+                        webhookId: context.webhookId,
+                        destinationId: context.destinationId,
+                        message: error.message,
+                    });
+                }
+                if (context.webhookId) {
+                    throw new WebhookNotFoundError({
+                        webhookId: context.webhookId,
+                        message: error.message,
+                    });
+                }
+            }
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=util.js.map

package/dist/services/webhook/util.js.map

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

package/dist/services/webhook/webhooks.d.ts

@@ -0,0 +1,146 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+import { type CreateWebhookRequest, type ListWebhooksRequest, type UpdateWebhookRequest, type Webhook, type WebhookApiOptions } from './types.ts';
+export declare const WebhookResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        id: z.ZodString;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+        created_by: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const WebhooksListResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+        created_by: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "success">;
+export declare const DeleteWebhookResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+}, z.core.$strip>], "success">;
+/**
+ * Create a new webhook.
+ *
+ * Creates a webhook with the specified name and optional description.
+ *
+ * @param client - The API client instance
+ * @param params - Webhook creation parameters
+ * @param options - Optional API options (e.g., orgId)
+ * @returns The created webhook
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const webhook = await createWebhook(client, {
+ *   name: 'github-events',
+ *   description: 'Receives GitHub webhook events',
+ * });
+ * console.log(`Created webhook: ${webhook.id}`);
+ * ```
+ */
+export declare function createWebhook(client: APIClient, params: CreateWebhookRequest, options?: WebhookApiOptions): Promise<Webhook>;
+/**
+ * Get a webhook by ID.
+ *
+ * Retrieves the webhook details.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param options - Optional API options (e.g., orgId)
+ * @returns The webhook details
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const webhook = await getWebhook(client, 'wh_abc123');
+ * console.log(`Webhook: ${webhook.name}`);
+ * ```
+ */
+export declare function getWebhook(client: APIClient, webhookId: string, options?: WebhookApiOptions): Promise<Webhook>;
+/**
+ * List all webhooks with optional pagination.
+ *
+ * @param client - The API client instance
+ * @param params - Optional pagination parameters
+ * @param options - Optional API options (e.g., orgId)
+ * @returns Object containing the list of webhooks
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // List first 10 webhooks
+ * const { webhooks } = await listWebhooks(client, { limit: 10 });
+ * console.log(`Found ${webhooks.length} webhooks`);
+ *
+ * // Paginate through all webhooks
+ * const { webhooks: page2 } = await listWebhooks(client, { limit: 10, offset: 10 });
+ * ```
+ */
+export declare function listWebhooks(client: APIClient, params?: ListWebhooksRequest, options?: WebhookApiOptions): Promise<{
+    webhooks: Webhook[];
+}>;
+/**
+ * Update an existing webhook.
+ *
+ * Updates the webhook name and/or description.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param params - Update parameters
+ * @param options - Optional API options (e.g., orgId)
+ * @returns The updated webhook
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const webhook = await updateWebhook(client, 'wh_abc123', {
+ *   name: 'github-events-v2',
+ *   description: 'Updated description',
+ * });
+ * ```
+ */
+export declare function updateWebhook(client: APIClient, webhookId: string, params: UpdateWebhookRequest, options?: WebhookApiOptions): Promise<Webhook>;
+/**
+ * Delete a webhook.
+ *
+ * Permanently deletes a webhook and all its destinations, receipts, and deliveries.
+ * This action cannot be undone.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param options - Optional API options (e.g., orgId)
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * await deleteWebhook(client, 'wh_abc123');
+ * console.log('Webhook deleted');
+ * ```
+ */
+export declare function deleteWebhook(client: APIClient, webhookId: string, options?: WebhookApiOptions): Promise<void>;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/services/webhook/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../../src/services/webhook/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAA8C,MAAM,WAAW,CAAC;AACvF,OAAO,EACN,KAAK,oBAAoB,EAEzB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAEzB,KAAK,OAAO,EACZ,KAAK,iBAAiB,EAEtB,MAAM,YAAY,CAAC;AASpB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;8BAAmC,CAAC;AACtE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;8BAA4C,CAAC;AACpF,eAAO,MAAM,2BAA2B;;;;;;8BAA4B,CAAC;AAErE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAelB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CA6BlC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAqBf"}