@polymorfa/sdk 0.1.0-dev.20260922093854

package/dist/messaging/identities.js

@@ -0,0 +1,21 @@
+import { HttpTransport } from "../transport/http.js";
+export class IdentitiesResource {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    resolve(session, params, options = {}) {
+        return this.transport.request({
+            method: "GET",
+            path: `/messaging/${encodeURIComponent(session)}/identities/resolve`,
+            query: {
+                phoneNumber: params.phoneNumber,
+                id: params.id,
+                username: params.username,
+                usernameKey: params.usernameKey,
+            },
+            ...options,
+        });
+    }
+}
+//# sourceMappingURL=identities.js.map

package/dist/messaging/identities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identities.js","sourceRoot":"","sources":["../../src/messaging/identities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAOrD,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,SAAwB;QAAxB,cAAS,GAAT,SAAS,CAAe;IAAG,CAAC;IAEzD,OAAO,CACL,OAAe,EACf,MAA6B,EAC7B,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,qBAAqB;YACpE,KAAK,EAAE;gBACL,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC;YACD,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/messaging/labels.d.ts

@@ -0,0 +1,16 @@
+import { HttpTransport } from "../transport/http.js";
+import type { ApiResponse, RequestOptions } from "../transport/types.js";
+import type { CreateLabelRequest, CreateLabelResponse, GetChatLabelsResponse, ListLabelsParams, ListLabelsResponse, ReplaceChatLabelsRequest, SuccessResponse, UpdateLabelRequest } from "./types.js";
+export declare class LabelsResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    list(session: string, params?: ListLabelsParams, options?: RequestOptions): Promise<ApiResponse<ListLabelsResponse>>;
+    create(session: string, body: CreateLabelRequest, options?: RequestOptions): Promise<ApiResponse<CreateLabelResponse>>;
+    update(session: string, labelId: string, body: UpdateLabelRequest, options?: RequestOptions): Promise<ApiResponse<SuccessResponse>>;
+    delete(session: string, labelId: string, options?: RequestOptions): Promise<ApiResponse<SuccessResponse>>;
+    listForChat(session: string, chatId: string, params?: ListLabelsParams, options?: RequestOptions): Promise<ApiResponse<GetChatLabelsResponse>>;
+    /** Replaces the chat's complete label set. Pass an empty array to detach all labels. */
+    replaceForChat(session: string, chatId: string, body: ReplaceChatLabelsRequest, options?: RequestOptions): Promise<ApiResponse<SuccessResponse>>;
+    private read;
+}
+//# sourceMappingURL=labels.d.ts.map

package/dist/messaging/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/messaging/labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAErD,IAAI,CACF,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,gBAAqB,EAC7B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAI3C,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAS5C,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IASxC,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAQxC,WAAW,CACT,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,gBAAqB,EAC7B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAI9C,wFAAwF;IACxF,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,wBAAwB,EAC9B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IASxC,OAAO,CAAC,IAAI;CAcb"}

package/dist/messaging/labels.js

@@ -0,0 +1,65 @@
+import { HttpTransport } from "../transport/http.js";
+export class LabelsResource {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    list(session, params = {}, options = {}) {
+        return this.read(labelsPath(session), params, options);
+    }
+    create(session, body, options = {}) {
+        return this.transport.request({
+            method: "POST",
+            path: labelsPath(session),
+            body,
+            ...options,
+        });
+    }
+    update(session, labelId, body, options = {}) {
+        return this.transport.request({
+            method: "PUT",
+            path: labelPath(session, labelId),
+            body,
+            ...options,
+        });
+    }
+    delete(session, labelId, options = {}) {
+        return this.transport.request({
+            method: "DELETE",
+            path: labelPath(session, labelId),
+            ...options,
+        });
+    }
+    listForChat(session, chatId, params = {}, options = {}) {
+        return this.read(chatLabelsPath(session, chatId), params, options);
+    }
+    /** Replaces the chat's complete label set. Pass an empty array to detach all labels. */
+    replaceForChat(session, chatId, body, options = {}) {
+        return this.transport.request({
+            method: "PUT",
+            path: chatLabelsPath(session, chatId),
+            body,
+            ...options,
+        });
+    }
+    read(path, params, options) {
+        return this.transport.request({
+            method: "GET",
+            path,
+            ...(params.includeObservation === undefined
+                ? {}
+                : { query: { includeObservation: params.includeObservation } }),
+            ...options,
+        });
+    }
+}
+function labelsPath(session) {
+    return `/messaging/${encodeURIComponent(session)}/labels`;
+}
+function labelPath(session, labelId) {
+    return `${labelsPath(session)}/${encodeURIComponent(labelId)}`;
+}
+function chatLabelsPath(session, chatId) {
+    return `${labelsPath(session)}/chats/${encodeURIComponent(chatId)}`;
+}
+//# sourceMappingURL=labels.js.map

package/dist/messaging/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../src/messaging/labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAarD,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,SAAwB;QAAxB,cAAS,GAAT,SAAS,CAAe;IAAG,CAAC;IAEzD,IAAI,CACF,OAAe,EACf,SAA2B,EAAE,EAC7B,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,CACJ,OAAe,EACf,IAAwB,EACxB,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC;YACzB,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CACJ,OAAe,EACf,OAAe,EACf,IAAwB,EACxB,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;YACjC,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CACJ,OAAe,EACf,OAAe,EACf,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;YACjC,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CACT,OAAe,EACf,MAAc,EACd,SAA2B,EAAE,EAC7B,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,wFAAwF;IACxF,cAAc,CACZ,OAAe,EACf,MAAc,EACd,IAA8B,EAC9B,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC;YACrC,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAEO,IAAI,CACV,IAAY,EACZ,MAAwB,EACxB,OAAuB;QAEvB,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,IAAI;YACJ,GAAG,CAAC,MAAM,CAAC,kBAAkB,KAAK,SAAS;gBACzC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,EAAE,EAAE,CAAC;YACjE,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,OAAO,cAAc,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC;AAC5D,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,EAAE,OAAe;IACjD,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,MAAc;IACrD,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;AACtE,CAAC"}

package/dist/messaging/media.d.ts

@@ -0,0 +1,72 @@
+import { type WhatsAppMediaDownload, type WhatsAppMediaDownloadOptions, type WhatsAppMediaInput } from "../media/whatsapp.js";
+import { HttpTransport } from "../transport/http.js";
+import type { ApiResponse, RequestOptions, ResponseMetadata } from "../transport/types.js";
+import type { GetMessagingMediaInfoResponse, SuccessResponse } from "./types.js";
+export interface MediaDownloadStream {
+    /** Unbuffered body. Read it once or cancel it. */
+    readonly body: ReadableStream<Uint8Array>;
+    readonly contentType?: string;
+    readonly contentLength?: number;
+    readonly filename?: string;
+    readonly requestId?: string;
+    /** True when the API redirected to object storage and the SDK followed it. */
+    readonly redirected: boolean;
+    /** Metadata of the Polymorfa API response (the redirect, when followed). */
+    readonly metadata: ResponseMetadata;
+}
+export interface MediaDownloadBlob {
+    readonly blob: Blob;
+    readonly filename?: string;
+    readonly requestId?: string;
+}
+/**
+ * The API answered with a short-lived signed storage URL. The URL is a
+ * bearer secret: do not log or store it, and hand it out only to a caller
+ * already authorized for this media.
+ */
+export interface MediaDownloadRedirectUrl {
+    readonly streamed: false;
+    readonly url: string;
+    /** Derived from the signed URL's query parameters when present. */
+    readonly expiresAt?: Date;
+    readonly requestId?: string;
+}
+/** The API streams this media itself; there is no direct URL. */
+export interface MediaDownloadStreamedUrl {
+    readonly streamed: true;
+    readonly url: undefined;
+    readonly requestId?: string;
+}
+export type MediaDownloadUrl = MediaDownloadRedirectUrl | MediaDownloadStreamedUrl;
+export declare class MessagingMediaResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    /** Buffers the whole file. Prefer `downloadStream` for large media. */
+    download(mediaId: string, options?: RequestOptions): Promise<ApiResponse<ArrayBuffer>>;
+    /**
+     * Streams media without buffering. A storage redirect is followed without
+     * sending the Polymorfa credential to the storage host. `timeoutMs` covers
+     * the wait for response headers; `signal` also cancels the body.
+     */
+    downloadStream(mediaId: string, options?: RequestOptions): Promise<MediaDownloadStream>;
+    /** Downloads media into a `Blob` typed with the response content type. */
+    downloadBlob(mediaId: string, options?: RequestOptions): Promise<MediaDownloadBlob>;
+    /**
+     * Returns the signed storage URL the API redirects to, without following
+     * it. When the API streams the media instead, returns `{ streamed: true }`
+     * and discards the body. The signed URL is short-lived; never log or store
+     * it.
+     */
+    downloadUrl(mediaId: string, options?: RequestOptions): Promise<MediaDownloadUrl>;
+    /**
+     * Downloads an attachment directly from the WhatsApp CDN using the
+     * encrypted descriptor in a message webhook (`media`), and decrypts it
+     * locally. No Polymorfa API call is made.
+     */
+    downloadFromWhatsApp(eventOrMedia: WhatsAppMediaInput, options?: WhatsAppMediaDownloadOptions): Promise<WhatsAppMediaDownload>;
+    retrieve(mediaId: string, options?: RequestOptions): Promise<ApiResponse<GetMessagingMediaInfoResponse>>;
+    persist(mediaId: string, options?: RequestOptions): Promise<ApiResponse<SuccessResponse>>;
+}
+/** Reads SigV4 (`X-Amz-Date` + `X-Amz-Expires`) or epoch `Expires` parameters. */
+export declare function signedUrlExpiry(value: string): Date | undefined;
+//# sourceMappingURL=media.d.ts.map

package/dist/messaging/media.d.ts.map

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

package/dist/messaging/media.js

@@ -0,0 +1,142 @@
+import { downloadWhatsAppMedia, } from "../media/whatsapp.js";
+import { HttpTransport } from "../transport/http.js";
+export class MessagingMediaResource {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    /** Buffers the whole file. Prefer `downloadStream` for large media. */
+    download(mediaId, options = {}) {
+        return this.transport.requestBinary({
+            method: "GET",
+            path: mediaPath(mediaId),
+            ...options,
+        });
+    }
+    /**
+     * Streams media without buffering. A storage redirect is followed without
+     * sending the Polymorfa credential to the storage host. `timeoutMs` covers
+     * the wait for response headers; `signal` also cancels the body.
+     */
+    async downloadStream(mediaId, options = {}) {
+        const response = await this.transport.requestStream({
+            method: "GET",
+            path: mediaPath(mediaId),
+            ...options,
+        });
+        return Object.freeze({
+            body: response.body,
+            ...(response.contentType === undefined
+                ? {}
+                : { contentType: response.contentType }),
+            ...(response.contentLength === undefined
+                ? {}
+                : { contentLength: response.contentLength }),
+            ...(response.filename === undefined
+                ? {}
+                : { filename: response.filename }),
+            ...(response.metadata.requestId === undefined
+                ? {}
+                : { requestId: response.metadata.requestId }),
+            redirected: response.redirected,
+            metadata: response.metadata,
+        });
+    }
+    /** Downloads media into a `Blob` typed with the response content type. */
+    async downloadBlob(mediaId, options = {}) {
+        const download = await this.downloadStream(mediaId, options);
+        const bytes = await new Response(download.body).arrayBuffer();
+        return Object.freeze({
+            blob: new Blob([bytes], {
+                type: download.contentType ?? "application/octet-stream",
+            }),
+            ...(download.filename === undefined
+                ? {}
+                : { filename: download.filename }),
+            ...(download.requestId === undefined
+                ? {}
+                : { requestId: download.requestId }),
+        });
+    }
+    /**
+     * Returns the signed storage URL the API redirects to, without following
+     * it. When the API streams the media instead, returns `{ streamed: true }`
+     * and discards the body. The signed URL is short-lived; never log or store
+     * it.
+     */
+    async downloadUrl(mediaId, options = {}) {
+        const result = await this.transport.requestStreamOrRedirect({
+            method: "GET",
+            path: mediaPath(mediaId),
+            ...options,
+        });
+        const requestId = result.metadata.requestId;
+        if ("body" in result) {
+            await result.body.cancel().catch(() => undefined);
+            return Object.freeze({
+                streamed: true,
+                url: undefined,
+                ...(requestId === undefined ? {} : { requestId }),
+            });
+        }
+        const expiresAt = signedUrlExpiry(result.location);
+        return Object.freeze({
+            streamed: false,
+            url: result.location,
+            ...(expiresAt === undefined ? {} : { expiresAt }),
+            ...(requestId === undefined ? {} : { requestId }),
+        });
+    }
+    /**
+     * Downloads an attachment directly from the WhatsApp CDN using the
+     * encrypted descriptor in a message webhook (`media`), and decrypts it
+     * locally. No Polymorfa API call is made.
+     */
+    downloadFromWhatsApp(eventOrMedia, options = {}) {
+        return downloadWhatsAppMedia(eventOrMedia, options);
+    }
+    retrieve(mediaId, options = {}) {
+        return this.transport.request({
+            method: "GET",
+            path: `${mediaPath(mediaId)}/info`,
+            ...options,
+        });
+    }
+    persist(mediaId, options = {}) {
+        return this.transport.request({
+            method: "POST",
+            path: `${mediaPath(mediaId)}/download-and-save`,
+            ...options,
+        });
+    }
+}
+function mediaPath(mediaId) {
+    return `/messaging/media/${encodeURIComponent(mediaId)}`;
+}
+/** Reads SigV4 (`X-Amz-Date` + `X-Amz-Expires`) or epoch `Expires` parameters. */
+export function signedUrlExpiry(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return undefined;
+    }
+    const params = url.searchParams;
+    const amzDate = params.get("X-Amz-Date");
+    const amzExpires = params.get("X-Amz-Expires");
+    if (amzDate !== null && amzExpires !== null && /^\d+$/.test(amzExpires)) {
+        const match = /^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})Z$/.exec(amzDate);
+        if (match !== null) {
+            const [, y, mo, d, h, mi, s] = match.map(Number);
+            const start = Date.UTC(y, mo - 1, d, h, mi, s);
+            return new Date(start + Number(amzExpires) * 1000);
+        }
+    }
+    const expires = params.get("Expires");
+    if (expires !== null && /^\d{9,11}$/.test(expires)) {
+        return new Date(Number(expires) * 1000);
+    }
+    return undefined;
+}
+//# sourceMappingURL=media.js.map

package/dist/messaging/media.js.map

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

package/dist/messaging/messages.d.ts

@@ -0,0 +1,18 @@
+import { HttpTransport } from "../transport/http.js";
+import type { ApiResponse, RequestOptions } from "../transport/types.js";
+import type { ReactRequest, SeenRequest, SendMessageRequest, SendMessageResponse, SendReactionResponse, StarMessageResponse, StarRequest, SuccessEnvelope, TypingRequest } from "./types.js";
+export declare class MessagesResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    send(session: string, body: SendMessageRequest, options?: RequestOptions): Promise<ApiResponse<SendMessageResponse>>;
+    markSeen(session: string, body: SeenRequest, options?: RequestOptions): Promise<ApiResponse<SuccessEnvelope<{
+        readonly status: string;
+    }>>>;
+    setTyping(session: string, body: TypingRequest, options?: RequestOptions): Promise<ApiResponse<SuccessEnvelope<{
+        readonly status: string;
+    }>>>;
+    react(session: string, body: ReactRequest, options?: RequestOptions): Promise<ApiResponse<SendReactionResponse>>;
+    star(session: string, body: StarRequest, options?: RequestOptions): Promise<ApiResponse<StarMessageResponse>>;
+    private post;
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/messaging/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/messaging/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAErD,IAAI,CACF,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAI5C,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAIrE,SAAS,CACP,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAIrE,KAAK,CACH,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAI7C,IAAI,CACF,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAI5C,OAAO,CAAC,IAAI;CAab"}

package/dist/messaging/messages.js

@@ -0,0 +1,32 @@
+import { HttpTransport } from "../transport/http.js";
+import { withIdempotencyKey } from "../transport/idempotency.js";
+export class MessagesResource {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    send(session, body, options = {}) {
+        return this.post(session, "send", body, withIdempotencyKey(options));
+    }
+    markSeen(session, body, options = {}) {
+        return this.post(session, "seen", body, options);
+    }
+    setTyping(session, body, options = {}) {
+        return this.post(session, "typing", body, options);
+    }
+    react(session, body, options = {}) {
+        return this.post(session, "react", body, withIdempotencyKey(options));
+    }
+    star(session, body, options = {}) {
+        return this.post(session, "star", body, options);
+    }
+    post(session, action, body, options) {
+        return this.transport.request({
+            method: "POST",
+            path: `/messaging/${encodeURIComponent(session)}/messages/${action}`,
+            body,
+            ...options,
+        });
+    }
+}
+//# sourceMappingURL=messages.js.map

package/dist/messaging/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/messaging/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAcjE,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,SAAwB;QAAxB,cAAS,GAAT,SAAS,CAAe;IAAG,CAAC;IAEzD,IAAI,CACF,OAAe,EACf,IAAwB,EACxB,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,QAAQ,CACN,OAAe,EACf,IAAiB,EACjB,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,SAAS,CACP,OAAe,EACf,IAAmB,EACnB,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CACH,OAAe,EACf,IAAkB,EAClB,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,CACF,OAAe,EACf,IAAiB,EACjB,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAEO,IAAI,CACV,OAAe,EACf,MAAqD,EACrD,IAAa,EACb,OAAuB;QAEvB,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,aAAa,MAAM,EAAE;YACpE,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/messaging/observation-policies.d.ts

@@ -0,0 +1,10 @@
+import { HttpTransport } from "../transport/http.js";
+import type { ApiResponse, RequestOptions } from "../transport/types.js";
+import type { UpdateProjectObservationPolicyResponse, UpdateSessionObservationPolicyResponse } from "./types.js";
+export declare class ObservationPoliciesResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    retrieveForProject(projectId: string, options?: RequestOptions): Promise<ApiResponse<UpdateProjectObservationPolicyResponse>>;
+    retrieveForSession(session: string, options?: RequestOptions): Promise<ApiResponse<UpdateSessionObservationPolicyResponse>>;
+}
+//# sourceMappingURL=observation-policies.d.ts.map

package/dist/messaging/observation-policies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-policies.d.ts","sourceRoot":"","sources":["../../src/messaging/observation-policies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EACV,sCAAsC,EACtC,sCAAsC,EACvC,MAAM,YAAY,CAAC;AAEpB,qBAAa,2BAA2B;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAErD,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,sCAAsC,CAAC,CAAC;IAQ/D,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,sCAAsC,CAAC,CAAC;CAOhE"}

package/dist/messaging/observation-policies.js

@@ -0,0 +1,28 @@
+import { HttpTransport } from "../transport/http.js";
+export class ObservationPoliciesResource {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    retrieveForProject(projectId, options = {}) {
+        return this.transport.request({
+            method: "GET",
+            path: projectPolicyPath(projectId),
+            ...options,
+        });
+    }
+    retrieveForSession(session, options = {}) {
+        return this.transport.request({
+            method: "GET",
+            path: sessionPolicyPath(session),
+            ...options,
+        });
+    }
+}
+function projectPolicyPath(projectId) {
+    return `/messaging/projects/${encodeURIComponent(projectId)}/observation-policy`;
+}
+function sessionPolicyPath(session) {
+    return `/messaging/${encodeURIComponent(session)}/observation-policy`;
+}
+//# sourceMappingURL=observation-policies.js.map

package/dist/messaging/observation-policies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-policies.js","sourceRoot":"","sources":["../../src/messaging/observation-policies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAOrD,MAAM,OAAO,2BAA2B;IACT;IAA7B,YAA6B,SAAwB;QAAxB,cAAS,GAAT,SAAS,CAAe;IAAG,CAAC;IAEzD,kBAAkB,CAChB,SAAiB,EACjB,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC;YAClC,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB,CAChB,OAAe,EACf,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC;YAChC,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,OAAO,uBAAuB,kBAAkB,CAAC,SAAS,CAAC,qBAAqB,CAAC;AACnF,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACxC,OAAO,cAAc,kBAAkB,CAAC,OAAO,CAAC,qBAAqB,CAAC;AACxE,CAAC"}

package/dist/messaging/onboarding.d.ts

@@ -0,0 +1,53 @@
+import type { MessagingCredential } from "../credentials.js";
+import { HttpTransport } from "../transport/http.js";
+import type { ApiResponse, RequestOptions } from "../transport/types.js";
+import type { TestEventFixtureInfo, TestingHistoryMessage, TriggerTestEventRequest, TriggerTestEventResponse } from "./testing-configuration.js";
+export interface EmbeddedSignupRequest {
+    quicklinkId: string;
+    projectId?: string;
+    result?: {
+        code: string;
+        wabaId: string;
+        phoneNumberId: string;
+        coexistence?: boolean;
+        historySync?: boolean;
+    };
+}
+export interface EmbeddedSignupResponse {
+    success: true;
+    data: {
+        stage: string;
+    };
+}
+/** Trusted-server continuation of an issued QuickLink; never direct session creation. */
+export declare class CloudOnboardingResource {
+    private readonly transport;
+    private readonly credentialType;
+    constructor(transport: HttpTransport, credentialType: MessagingCredential["type"]);
+    advance(input: EmbeddedSignupRequest, options?: RequestOptions): Promise<ApiResponse<EmbeddedSignupResponse>>;
+}
+export declare class TestingResource {
+    private readonly transport;
+    private readonly credentialType;
+    constructor(transport: HttpTransport, credentialType: MessagingCredential["type"]);
+    createHistoryFixture(projectId: string, input: {
+        messages: readonly TestingHistoryMessage[];
+    }, options?: RequestOptions): Promise<ApiResponse<{
+        fixtureId: string;
+    }>>;
+    /**
+     * Fire a named, signed test event for a Test number. Generated events reach
+     * webhooks and event history with `source: "test"`. With `fromSession`, a
+     * `message.received` request sends a simulated message from another Test
+     * number instead. Real numbers are refused with a 400 error. Pass
+     * `options.idempotencyKey` to make retries safe: repeating the request with
+     * the same key and body reuses the same event ID, and the SDK then retries
+     * network and 5xx failures.
+     */
+    triggerEvent(projectId: string, input: TriggerTestEventRequest, options?: RequestOptions): Promise<ApiResponse<TriggerTestEventResponse>>;
+    /** List test-event fixtures and the overrides each accepts. */
+    listEventFixtures(projectId: string, options?: RequestOptions): Promise<ApiResponse<{
+        fixtures: TestEventFixtureInfo[];
+    }>>;
+}
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/messaging/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/messaging/onboarding.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;CACH;AACD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACzB;AAED,yFAAyF;AACzF,qBAAa,uBAAuB;IAEhC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADd,SAAS,EAAE,aAAa,EACxB,cAAc,EAAE,mBAAmB,CAAC,MAAM,CAAC;IAE9D,OAAO,CACL,KAAK,EAAE,qBAAqB,EAC5B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;CAShD;AAED,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADd,SAAS,EAAE,aAAa,EACxB,cAAc,EAAE,mBAAmB,CAAC,MAAM,CAAC;IAE9D,oBAAoB,CAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;QAAE,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAA;KAAE,EACrD,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAU9C;;;;;;;;OAQG;IACH,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,uBAAuB,EAC9B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC;IAUjD,+DAA+D;IAC/D,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC;QAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC,CAAC;CAQ9D"}

package/dist/messaging/onboarding.js

@@ -0,0 +1,69 @@
+import { PolymorfaConfigurationError } from "../errors.js";
+import { HttpTransport } from "../transport/http.js";
+/** Trusted-server continuation of an issued QuickLink; never direct session creation. */
+export class CloudOnboardingResource {
+    transport;
+    credentialType;
+    constructor(transport, credentialType) {
+        this.transport = transport;
+        this.credentialType = credentialType;
+    }
+    advance(input, options = {}) {
+        assertServerCredential(this.credentialType);
+        return this.transport.request({
+            method: "POST",
+            path: "/messaging/cloud-api/embedded-signup",
+            body: input,
+            ...options,
+        });
+    }
+}
+export class TestingResource {
+    transport;
+    credentialType;
+    constructor(transport, credentialType) {
+        this.transport = transport;
+        this.credentialType = credentialType;
+    }
+    createHistoryFixture(projectId, input, options = {}) {
+        assertServerCredential(this.credentialType);
+        return this.transport.request({
+            method: "POST",
+            path: `/messaging/testing/${encodeURIComponent(projectId)}/history-fixtures`,
+            body: input,
+            ...options,
+        });
+    }
+    /**
+     * Fire a named, signed test event for a Test number. Generated events reach
+     * webhooks and event history with `source: "test"`. With `fromSession`, a
+     * `message.received` request sends a simulated message from another Test
+     * number instead. Real numbers are refused with a 400 error. Pass
+     * `options.idempotencyKey` to make retries safe: repeating the request with
+     * the same key and body reuses the same event ID, and the SDK then retries
+     * network and 5xx failures.
+     */
+    triggerEvent(projectId, input, options = {}) {
+        assertServerCredential(this.credentialType);
+        return this.transport.request({
+            method: "POST",
+            path: `/messaging/testing/${encodeURIComponent(projectId)}/events`,
+            body: input,
+            ...options,
+        });
+    }
+    /** List test-event fixtures and the overrides each accepts. */
+    listEventFixtures(projectId, options = {}) {
+        assertServerCredential(this.credentialType);
+        return this.transport.request({
+            method: "GET",
+            path: `/messaging/testing/${encodeURIComponent(projectId)}/events/fixtures`,
+            ...options,
+        });
+    }
+}
+function assertServerCredential(type) {
+    if (type === "clientToken")
+        throw new PolymorfaConfigurationError("Onboarding management requires an organization API key or project token.", "credential");
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/messaging/onboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../src/messaging/onboarding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAyBrD,yFAAyF;AACzF,MAAM,OAAO,uBAAuB;IAEf;IACA;IAFnB,YACmB,SAAwB,EACxB,cAA2C;QAD3C,cAAS,GAAT,SAAS,CAAe;QACxB,mBAAc,GAAd,cAAc,CAA6B;IAC3D,CAAC;IACJ,OAAO,CACL,KAA4B,EAC5B,UAA0B,EAAE;QAE5B,sBAAsB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,sCAAsC;YAC5C,IAAI,EAAE,KAAK;YACX,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,OAAO,eAAe;IAEP;IACA;IAFnB,YACmB,SAAwB,EACxB,cAA2C;QAD3C,cAAS,GAAT,SAAS,CAAe;QACxB,mBAAc,GAAd,cAAc,CAA6B;IAC3D,CAAC;IACJ,oBAAoB,CAClB,SAAiB,EACjB,KAAqD,EACrD,UAA0B,EAAE;QAE5B,sBAAsB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,sBAAsB,kBAAkB,CAAC,SAAS,CAAC,mBAAmB;YAC5E,IAAI,EAAE,KAAK;YACX,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CACV,SAAiB,EACjB,KAA8B,EAC9B,UAA0B,EAAE;QAE5B,sBAAsB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,sBAAsB,kBAAkB,CAAC,SAAS,CAAC,SAAS;YAClE,IAAI,EAAE,KAAK;YACX,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED,+DAA+D;IAC/D,iBAAiB,CACf,SAAiB,EACjB,UAA0B,EAAE;QAE5B,sBAAsB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,sBAAsB,kBAAkB,CAAC,SAAS,CAAC,kBAAkB;YAC3E,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF;AACD,SAAS,sBAAsB,CAAC,IAAiC;IAC/D,IAAI,IAAI,KAAK,aAAa;QACxB,MAAM,IAAI,2BAA2B,CACnC,0EAA0E,EAC1E,YAAY,CACb,CAAC;AACN,CAAC"}

package/dist/messaging/presence.d.ts

@@ -0,0 +1,12 @@
+import { HttpTransport } from "../transport/http.js";
+import type { ApiResponse, RequestOptions } from "../transport/types.js";
+import type { GetChatPresenceResponse, GetPresenceResponse, SetPresenceRequest, SetPresenceResponse, SubscribePresenceResponse } from "./types.js";
+export declare class PresenceResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    set(session: string, body: SetPresenceRequest, options?: RequestOptions): Promise<ApiResponse<SetPresenceResponse>>;
+    get(session: string, options?: RequestOptions): Promise<ApiResponse<GetPresenceResponse>>;
+    getForChat(session: string, chatId: string, options?: RequestOptions): Promise<ApiResponse<GetChatPresenceResponse>>;
+    subscribe(session: string, chatId: string, options?: RequestOptions): Promise<ApiResponse<SubscribePresenceResponse>>;
+}
+//# sourceMappingURL=presence.d.ts.map

package/dist/messaging/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/messaging/presence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAErD,GAAG,CACD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAS5C,GAAG,CACD,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAQ5C,UAAU,CACR,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;IAQhD,SAAS,CACP,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;CAOnD"}