ab-ecosystem-cpass 1.0.0 → 1.0.6

package/dist/realtime/inbox.js

@@ -0,0 +1,263 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Inbox = exports.InboxMessages = exports.InboxChats = void 0;
+const client_1 = require("./client");
+const errors_1 = require("../errors");
+/** The chat list and the thirteen actions that change one. */
+class InboxChats {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * One page of the inbox, ordered by last activity.
+     *
+     * `contact.list` · scope `contacts:read`
+     *
+     * The reply's `filter` is the filter that was *applied* -- a team member
+     * without the unassigned permission asking for `all` is narrowed to `me` -- and
+     * `nextPage` is the cursor for the page after this one, or `null` at the end.
+     */
+    list(payload = {}) {
+        return this.client.request('contact.list', payload);
+    }
+    /**
+     * One chat, and a subscription to it: messages and state changes for this
+     * thread reach the socket from here on without asking again.
+     *
+     * `contact.fetch` · scope `contacts:read`
+     */
+    get(id) {
+        return this.client.request('contact.fetch', { id });
+    }
+    /** Any action, for callers holding a payload they built elsewhere. */
+    act(payload) {
+        return this.client.request('chat.action', payload);
+    }
+    /** Trashes the chat. It leaves every inbox view; the contact row stays. */
+    delete(chat) {
+        return this.single({ action: 'delete', chat });
+    }
+    /** Assigns the chat to one member and flags it unread for them. */
+    transfer(chat, member) {
+        return this.single({ action: 'transfer', chat, member });
+    }
+    archive(chat) {
+        return this.single({ action: 'archive', chat });
+    }
+    unarchive(chat) {
+        return this.single({ action: 'unarchive', chat });
+    }
+    /** Flips one or more block flags. Flags left out keep their current value. */
+    block(chat, update) {
+        return this.single({ action: 'block', chat, update });
+    }
+    /** Clears the unread counter and the by-hand unread flag. */
+    markAsRead(chat) {
+        return this.single({ action: 'mark_as_read', chat });
+    }
+    markAsUnread(chat) {
+        return this.single({ action: 'mark_as_unread', chat });
+    }
+    /** Detaches the flow and holds automation for `chat_metadata.pause_duration`. */
+    pauseAutomation(chat) {
+        return this.single({ action: 'pause_automation', chat });
+    }
+    resumeAutomation(chat) {
+        return this.single({ action: 'resume_automation', chat });
+    }
+    /** Closes the chat and detaches the flow, leaving the assignment alone. */
+    close(chat) {
+        return this.single({ action: 'close', chat });
+    }
+    /** Marks the chat done, unassigns it and detaches the flow. */
+    done(chat, isEnded) {
+        return this.single({ action: 'done', chat, isEnded });
+    }
+    /** Re-arms the automation pause with a new duration, in seconds. */
+    pauseTimer(chat, duration) {
+        return this.single({ action: 'pause_timer', chat, duration });
+    }
+    /** Replaces the chat's tags outright. */
+    updateTags(chat, tags) {
+        return this.single({ action: 'update_tags', chat, tags });
+    }
+    /**
+     * Moves every chat held by one member -- or the unassigned queue -- to another
+     * member or a team. Capped at 500 chats per call; each moved chat is broadcast
+     * individually as a `transfer`.
+     */
+    bulkTransfer(payload) {
+        return this.client.request('chat.action', {
+            action: 'bulk_transfer',
+            ...payload,
+        });
+    }
+    /** The narrower action set, answering with the metadata alone. */
+    update(payload) {
+        return this.client.request('contact.update', payload);
+    }
+    /**
+     * Attaches a flow to the chat, or hands the chat to the bot server to place.
+     *
+     * `contact.bot_assign` · scope `contacts:write`
+     */
+    assignBot(payload) {
+        return this.client.request('contact.bot_assign', payload);
+    }
+    single(payload) {
+        return this.client.request('chat.action', payload);
+    }
+}
+exports.InboxChats = InboxChats;
+/** Reading, sending and removing messages in one thread. */
+class InboxMessages {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * One page of a thread, oldest-first, and a subscription to it.
+     *
+     * `message.list` · scope `messages:read`
+     *
+     * Pass the `id` of the oldest message you hold as `last_message_id` to walk
+     * backwards through the history.
+     */
+    list(id, options = {}) {
+        return this.client.request('message.list', { id, ...options });
+    }
+    /** One message by its provider id -- a `wamid`, not the document id. */
+    get(messageId) {
+        return this.client.request('message.fetch', { message_id: messageId });
+    }
+    /**
+     * Sends a message and gets the bubble to draw back immediately.
+     *
+     * `message.send` · scope `messages:write`
+     *
+     * The returned message carries a queue id in `message_id`, not a provider id:
+     * nothing has been written yet. The stored row arrives moments later as a
+     * `message.received` push, with the provider's id in its place -- correlate on
+     * the queue id you got back here, not on the final `message_id`.
+     *
+     * Sending by hand also takes the conversation off its bot, which arrives as a
+     * `chat.action` with `action: 'pause_automation'`.
+     */
+    send(payload) {
+        return this.client.request('message.send', payload);
+    }
+    /**
+     * Sends media, uploading it first if you hand over a file.
+     *
+     * `message.send` · scope `messages:write`
+     *
+     * Two ways in. With a `link` -- from `crm.inboxMedia.upload()`, or any publicly
+     * fetchable URL -- this is `send()` with the content assembled for you:
+     *
+     * ```ts
+     * const link = await crm.inboxMedia.upload(file, { kind: 'image' });
+     * await inbox.messages.sendMedia({ channel, contact, kind: 'image', link, caption: 'Your order' });
+     * ```
+     *
+     * With a `file`, it uploads and sends in one call -- which needs an uploader,
+     * because a socket cannot presign. Pass `uploadMedia` when constructing the
+     * `Inbox`:
+     *
+     * ```ts
+     * const inbox = new Inbox({ url, clientId, token, uploadMedia: crm.inboxMedia.upload.bind(crm.inboxMedia) });
+     * await inbox.messages.sendMedia({ channel, contact, kind: 'image', file, caption: 'Your order' });
+     * ```
+     *
+     * The link is what gets stored on the message, and it does not expire, so the
+     * thread still renders the media months later.
+     *
+     * `filename` is worth setting on a `document`: it is what the recipient sees in
+     * their chat, where a bare key would otherwise appear.
+     */
+    async sendMedia(payload) {
+        const { kind, caption, filename, file, link: given, ...target } = payload;
+        const link = given ?? (await this.resolve(kind, file, filename));
+        // The provider reads `type` and then the key matching it -- the one structural
+        // promise the open content shape makes. A caption belongs on the media object
+        // rather than beside it, and a sticker takes neither a caption nor a name.
+        const media = { link };
+        if (caption && kind !== 'sticker')
+            media.caption = caption;
+        if (filename && kind === 'document')
+            media.filename = filename;
+        return this.send({ ...target, content: { type: kind, [kind]: media } });
+    }
+    /** Uploads a file through the hook the client was given, or explains its absence. */
+    async resolve(kind, file, filename) {
+        if (!file) {
+            throw new errors_1.CrmConfigError('sendMedia needs either a `link` or a `file`');
+        }
+        const upload = this.client.uploadMedia;
+        if (!upload) {
+            throw new errors_1.CrmConfigError('sendMedia was given a file but no uploader. Pass `uploadMedia` to the Inbox constructor ' +
+                '(for example `crm.inboxMedia.upload.bind(crm.inboxMedia)`), or upload first and pass `link`.');
+        }
+        return upload(file, { kind, filename });
+    }
+    /** Removes one message from a thread, for everyone with it open. */
+    delete(contactId, messageId) {
+        return this.client.request('message.delete', { id: contactId, message_id: messageId });
+    }
+    /**
+     * Re-fetches media whose first download failed. Inbound media only -- an
+     * outbound attachment was ours to begin with.
+     *
+     * `message.retry_download` · scope `messages:write`
+     */
+    retryDownload(messageId) {
+        return this.client.request('message.retry_download', {
+            message_id: messageId,
+        });
+    }
+}
+exports.InboxMessages = InboxMessages;
+/**
+ * The live-chat inbox.
+ *
+ * ```ts
+ * const inbox = new Inbox({ url: 'https://inbox.example.com', clientId, token });
+ * await inbox.ready();
+ *
+ * const { contacts } = await inbox.chats.list({ filter: { assignment: 'me', unread: 'unread' } });
+ * inbox.on('message.received', (message) => append(message));
+ * ```
+ */
+class Inbox extends client_1.InboxClient {
+    chats;
+    messages;
+    constructor(options) {
+        super(options);
+        this.chats = new InboxChats(this);
+        this.messages = new InboxMessages(this);
+    }
+    /**
+     * Where a lead came from: the click-to-WhatsApp ad payloads on one contact.
+     *
+     * `ctwa.list` · scope `contacts:read`
+     */
+    referrals(contactId, limit) {
+        return this.request('ctwa.list', { id: contactId, limit });
+    }
+    /**
+     * A contact's reply windows, one per channel they have written from. Read these
+     * to tell whether a free-form reply is still allowed on a channel or whether
+     * the agent has to start from a template.
+     *
+     * `chat_session.list` · scope `contacts:read`
+     */
+    sessions(contactId, channel) {
+        return this.request('chat_session.list', { id: contactId, channel });
+    }
+    /** Round-trips the payload. Useful for checking the connection is live. */
+    ping(payload) {
+        return this.request('ping', payload);
+    }
+}
+exports.Inbox = Inbox;
+//# sourceMappingURL=inbox.js.map

package/dist/realtime/inbox.js.map

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

package/dist/realtime/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The live-chat inbox, over a socket.
+ *
+ * Published as a subpath so the core SDK stays dependency-free:
+ *
+ * ```ts
+ * import { Inbox } from 'ab-ecosystem-cpass/realtime';
+ * ```
+ *
+ * `socket.io-client` is an optional peer dependency -- install it alongside the
+ * SDK to use this, and nothing resolves it if you only use the REST client.
+ */
+export { Inbox, InboxChats, InboxMessages } from './inbox';
+export { InboxClient, type InboxClientOptions } from './client';
+export type { InboxAck, InboxError, InboxPushName, InboxPushes, InboxRequestName, InboxRequests, } from './events';
+export * from '../types/inbox';

package/dist/realtime/index.js

@@ -0,0 +1,37 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InboxClient = exports.InboxMessages = exports.InboxChats = exports.Inbox = void 0;
+/**
+ * The live-chat inbox, over a socket.
+ *
+ * Published as a subpath so the core SDK stays dependency-free:
+ *
+ * ```ts
+ * import { Inbox } from 'ab-ecosystem-cpass/realtime';
+ * ```
+ *
+ * `socket.io-client` is an optional peer dependency -- install it alongside the
+ * SDK to use this, and nothing resolves it if you only use the REST client.
+ */
+var inbox_1 = require("./inbox");
+Object.defineProperty(exports, "Inbox", { enumerable: true, get: function () { return inbox_1.Inbox; } });
+Object.defineProperty(exports, "InboxChats", { enumerable: true, get: function () { return inbox_1.InboxChats; } });
+Object.defineProperty(exports, "InboxMessages", { enumerable: true, get: function () { return inbox_1.InboxMessages; } });
+var client_1 = require("./client");
+Object.defineProperty(exports, "InboxClient", { enumerable: true, get: function () { return client_1.InboxClient; } });
+__exportStar(require("../types/inbox"), exports);
+//# sourceMappingURL=index.js.map

package/dist/realtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;GAWG;AACH,iCAA2D;AAAlD,8FAAA,KAAK,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,sGAAA,aAAa,OAAA;AACzC,mCAAgE;AAAvD,qGAAA,WAAW,OAAA;AASpB,iDAA+B"}

package/dist/resources/audience/contacts.d.ts

@@ -36,9 +36,21 @@ export declare class Contacts {
     /**
      * `POST /v1/audience/contacts` -- 201 with the created contact.
      *
-     * Every field is optional: an empty body creates a blank contact. Channel
-     * identities are not settable here; they are written when a conversation
-     * starts on a channel.
+     * Every field is optional: an empty body creates a blank contact. Such a
+     * contact has no channel identity, which means nothing can message it and an
+     * inbound message will not be matched to it -- so pass `whatsapp` unless the
+     * contact is genuinely a placeholder.
+     *
+     * `whatsapp` takes a number in any shape and is stored as digits only, which
+     * is the form an inbound message carries. It creates the contact's WhatsApp
+     * identity and is reflected back under `profile.whatsapp` on the response.
+     * Other channels' identities are still written by the conversation that starts
+     * on them.
+     *
+     * 409 `conflict` if the account already holds that WhatsApp number, on another
+     * contact or on this one -- a number identifies one contact per account, so
+     * nothing is created and the existing contact is left alone. 422 if the value
+     * contains no digits at all.
      *
      * Scope: `contacts:write`.
      */
@@ -48,6 +60,10 @@ export declare class Contacts {
      * untouched. `tags` and `custom_field_hash` replace their stored value rather
      * than merging into it.
      *
+     * `whatsapp` is not accepted: a channel identity lives in its own collection,
+     * and changing one is a different write from patching the contact. It is
+     * create-only for now.
+     *
      * Scope: `contacts:write`.
      */
     update(id: string, input: UpdateContactInput): Promise<Contact>;

package/dist/resources/audience/contacts.js

@@ -45,9 +45,21 @@ class Contacts {
     /**
      * `POST /v1/audience/contacts` -- 201 with the created contact.
      *
-     * Every field is optional: an empty body creates a blank contact. Channel
-     * identities are not settable here; they are written when a conversation
-     * starts on a channel.
+     * Every field is optional: an empty body creates a blank contact. Such a
+     * contact has no channel identity, which means nothing can message it and an
+     * inbound message will not be matched to it -- so pass `whatsapp` unless the
+     * contact is genuinely a placeholder.
+     *
+     * `whatsapp` takes a number in any shape and is stored as digits only, which
+     * is the form an inbound message carries. It creates the contact's WhatsApp
+     * identity and is reflected back under `profile.whatsapp` on the response.
+     * Other channels' identities are still written by the conversation that starts
+     * on them.
+     *
+     * 409 `conflict` if the account already holds that WhatsApp number, on another
+     * contact or on this one -- a number identifies one contact per account, so
+     * nothing is created and the existing contact is left alone. 422 if the value
+     * contains no digits at all.
      *
      * Scope: `contacts:write`.
      */
@@ -59,6 +71,10 @@ class Contacts {
      * untouched. `tags` and `custom_field_hash` replace their stored value rather
      * than merging into it.
      *
+     * `whatsapp` is not accepted: a channel identity lives in its own collection,
+     * and changing one is a different write from patching the contact. It is
+     * create-only for now.
+     *
      * Scope: `contacts:write`.
      */
     update(id, input) {

package/dist/resources/audience/contacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contacts.js","sourceRoot":"","sources":["../../../src/resources/audience/contacts.ts"],"names":[],"mappings":";;;AASA,oCAAyC;AAEzC,MAAM,IAAI,GAAG,GAAG,gBAAQ,WAAW,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAa,QAAQ;IACU;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,QAAoC,EAAE;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqB,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAU,KAAK,EAAE,GAAG,IAAI,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,QAA4B,EAAE;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAU,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,EAAU,EAAE,KAAyB;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAU,OAAO,EAAE,GAAG,IAAI,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAsB,QAAQ,EAAE,GAAG,IAAI,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,CAAC,OAAO,CAAC,QAAoC,EAAE;QACnD,IAAI,IAAI,GAAG,CAAC,CAAC;QAEb,SAAS,CAAC;YACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI;gBAAE,MAAM,OAAO,CAAC;YACjD,IAAI,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YACxE,IAAI,IAAI,CAAC,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AAzFD,4BAyFC"}
+{"version":3,"file":"contacts.js","sourceRoot":"","sources":["../../../src/resources/audience/contacts.ts"],"names":[],"mappings":";;;AASA,oCAAyC;AAEzC,MAAM,IAAI,GAAG,GAAG,gBAAQ,WAAW,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAa,QAAQ;IACU;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,QAAoC,EAAE;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqB,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAU,KAAK,EAAE,GAAG,IAAI,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,QAA4B,EAAE;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAU,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAU,EAAE,KAAyB;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAU,OAAO,EAAE,GAAG,IAAI,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAsB,QAAQ,EAAE,GAAG,IAAI,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,CAAC,OAAO,CAAC,QAAoC,EAAE;QACnD,IAAI,IAAI,GAAG,CAAC,CAAC;QAEb,SAAS,CAAC;YACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI;gBAAE,MAAM,OAAO,CAAC;YACjD,IAAI,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YACxE,IAAI,IAAI,CAAC,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AAzGD,4BAyGC"}

package/dist/resources/audience/inbox-media.d.ts

@@ -0,0 +1,92 @@
+import type { HttpClient } from '../../http';
+import type { CreateMediaUploadPayload, MediaKind, MediaUpload } from '../../types/inbox';
+/** What `uploadMedia` needs about a file, when it is not a `File` or `Blob`. */
+export interface UploadMediaSource {
+    /** The bytes. A browser `File` or `Blob`, or anything `fetch` accepts as a body. */
+    body: BodyInit;
+    filename: string;
+    contentType: string;
+    /** Exact byte length. Must match the bytes, because the signature covers it. */
+    size: number;
+}
+export interface UploadMediaOptions {
+    /** Which kind of message this will become. Decides the size and type limits. */
+    kind: MediaKind;
+    /** Overrides the name taken from a `File`; required for a bare `Blob` or buffer. */
+    filename?: string;
+    /** Overrides the type taken from a `File`. */
+    contentType?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Chat media.
+ *
+ * Uploads do not pass through the API. A client describes the file, gets a
+ * presigned URL, and sends the bytes straight to object storage -- so a 90 MB
+ * document costs the gateway a signature rather than 90 MB of transfer, and a
+ * stalled upload holds the browser's connection rather than one of ours.
+ */
+export declare class InboxMedia {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * `POST /v1/audience/inbox/media/upload-url` -- one presigned upload.
+     *
+     * Metadata only; no bytes. Prefer `upload()`, which does this and the transfer
+     * together. Reach for this directly when you need the `key`, or when something
+     * other than this SDK will perform the upload.
+     *
+     * `size` and `content_type` are signed into the URL, so the upload that follows
+     * has to match them exactly. They are also checked against the kind's limits
+     * here rather than at send time -- a file rejected now is one the agent can
+     * swap, where one rejected by the provider has already been uploaded and drawn
+     * on screen.
+     *
+     * | Kind | Limit | Accepts |
+     * |---|---|---|
+     * | `image` | 5 MB | jpeg, png, webp |
+     * | `video` | 16 MB | mp4, 3gpp, quicktime |
+     * | `audio` / `voice` | 16 MB | aac, mp4, mpeg, amr, ogg |
+     * | `sticker` | 100 KB | webp |
+     * | `document` | 100 MB | anything a browser will not execute |
+     *
+     * 422 `validation_failed` if the file is too large or the type is not allowed
+     * for the kind. 503 `media_unavailable` if the deployment has no storage
+     * configured.
+     *
+     * Scope: `messages:write`.
+     */
+    createUpload(payload: CreateMediaUploadPayload): Promise<MediaUpload>;
+    /**
+     * Uploads a file and answers with its permanent public link.
+     *
+     * Three steps, one call: ask for a ticket, `PUT` the bytes to storage, return
+     * the link. Pass the link straight to `inbox.messages.sendMedia()`, or as the
+     * `link` on media content you build yourself.
+     *
+     * ```ts
+     * const link = await crm.inboxMedia.upload(file, { kind: 'image' });
+     * await inbox.messages.sendMedia({ channel, contact, kind: 'image', link, caption: 'Your order' });
+     * ```
+     *
+     * In Node, where there is no `File`, describe the bytes instead:
+     *
+     * ```ts
+     * const bytes = await readFile('invoice.pdf');
+     * const link = await crm.inboxMedia.upload(
+     *   { body: bytes, filename: 'invoice.pdf', contentType: 'application/pdf', size: bytes.byteLength },
+     *   { kind: 'document' },
+     * );
+     * ```
+     *
+     * The returned link does not expire -- only the upload URL does, and only
+     * before it is used. So the link can be stored against the message and will
+     * still render in the thread months later.
+     *
+     * The `PUT` deliberately does not go through this SDK's request pipeline: it
+     * carries no bearer token, because that would hand our credential to the
+     * storage provider, and it sends exactly the headers the ticket named, because
+     * the signature covers them and one extra header fails the upload.
+     */
+    upload(file: Blob | UploadMediaSource, options: UploadMediaOptions): Promise<string>;
+}

package/dist/resources/audience/inbox-media.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InboxMedia = void 0;
+const errors_1 = require("../../errors");
+const paths_1 = require("../paths");
+const BASE = `${paths_1.AUDIENCE}/inbox/media`;
+const hasFileShape = (value) => typeof Blob !== 'undefined' && value instanceof Blob;
+/**
+ * Chat media.
+ *
+ * Uploads do not pass through the API. A client describes the file, gets a
+ * presigned URL, and sends the bytes straight to object storage -- so a 90 MB
+ * document costs the gateway a signature rather than 90 MB of transfer, and a
+ * stalled upload holds the browser's connection rather than one of ours.
+ */
+class InboxMedia {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * `POST /v1/audience/inbox/media/upload-url` -- one presigned upload.
+     *
+     * Metadata only; no bytes. Prefer `upload()`, which does this and the transfer
+     * together. Reach for this directly when you need the `key`, or when something
+     * other than this SDK will perform the upload.
+     *
+     * `size` and `content_type` are signed into the URL, so the upload that follows
+     * has to match them exactly. They are also checked against the kind's limits
+     * here rather than at send time -- a file rejected now is one the agent can
+     * swap, where one rejected by the provider has already been uploaded and drawn
+     * on screen.
+     *
+     * | Kind | Limit | Accepts |
+     * |---|---|---|
+     * | `image` | 5 MB | jpeg, png, webp |
+     * | `video` | 16 MB | mp4, 3gpp, quicktime |
+     * | `audio` / `voice` | 16 MB | aac, mp4, mpeg, amr, ogg |
+     * | `sticker` | 100 KB | webp |
+     * | `document` | 100 MB | anything a browser will not execute |
+     *
+     * 422 `validation_failed` if the file is too large or the type is not allowed
+     * for the kind. 503 `media_unavailable` if the deployment has no storage
+     * configured.
+     *
+     * Scope: `messages:write`.
+     */
+    createUpload(payload) {
+        return this.http.request('POST', `${BASE}/upload-url`, { body: payload });
+    }
+    /**
+     * Uploads a file and answers with its permanent public link.
+     *
+     * Three steps, one call: ask for a ticket, `PUT` the bytes to storage, return
+     * the link. Pass the link straight to `inbox.messages.sendMedia()`, or as the
+     * `link` on media content you build yourself.
+     *
+     * ```ts
+     * const link = await crm.inboxMedia.upload(file, { kind: 'image' });
+     * await inbox.messages.sendMedia({ channel, contact, kind: 'image', link, caption: 'Your order' });
+     * ```
+     *
+     * In Node, where there is no `File`, describe the bytes instead:
+     *
+     * ```ts
+     * const bytes = await readFile('invoice.pdf');
+     * const link = await crm.inboxMedia.upload(
+     *   { body: bytes, filename: 'invoice.pdf', contentType: 'application/pdf', size: bytes.byteLength },
+     *   { kind: 'document' },
+     * );
+     * ```
+     *
+     * The returned link does not expire -- only the upload URL does, and only
+     * before it is used. So the link can be stored against the message and will
+     * still render in the thread months later.
+     *
+     * The `PUT` deliberately does not go through this SDK's request pipeline: it
+     * carries no bearer token, because that would hand our credential to the
+     * storage provider, and it sends exactly the headers the ticket named, because
+     * the signature covers them and one extra header fails the upload.
+     */
+    async upload(file, options) {
+        const source = describe(file, options);
+        const ticket = await this.createUpload({
+            kind: options.kind,
+            filename: source.filename,
+            content_type: source.contentType,
+            size: source.size,
+        });
+        const response = await this.http.fetchImpl(ticket.upload_url, {
+            method: 'PUT',
+            headers: ticket.headers,
+            body: source.body,
+            signal: options.signal,
+        });
+        if (!response.ok) {
+            // Storage answers XML, not our error envelope, so there is nothing to parse
+            // into a CrmApiError's shape -- the status and the body are the whole of
+            // what went wrong. A 403 here is almost always a mismatch between the
+            // declared size or type and the bytes actually sent.
+            throw new errors_1.CrmApiError(response.status, 'media_upload_failed', `Upload to storage failed with ${response.status}. ` +
+                'Check that the bytes match the declared size and content type.', await response.text().catch(() => undefined));
+        }
+        return ticket.link;
+    }
+}
+exports.InboxMedia = InboxMedia;
+/** Fills in what a `File` already knows, and insists on it otherwise. */
+const describe = (file, options) => {
+    if (!hasFileShape(file)) {
+        const source = file;
+        return {
+            body: source.body,
+            filename: options.filename ?? source.filename,
+            contentType: options.contentType ?? source.contentType,
+            size: source.size,
+        };
+    }
+    const filename = options.filename ?? file.name;
+    const contentType = options.contentType ?? file.type;
+    if (!filename)
+        throw new errors_1.CrmApiError(400, 'validation_failed', 'filename is required for a Blob without a name');
+    if (!contentType)
+        throw new errors_1.CrmApiError(400, 'validation_failed', 'contentType is required for a Blob without a type');
+    return { body: file, filename, contentType, size: file.size };
+};
+//# sourceMappingURL=inbox-media.js.map

package/dist/resources/audience/inbox-media.js.map

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