ab-ecosystem-cpass 1.0.0 → 1.0.6

package/README.md

@@ -122,9 +122,9 @@ await crm.billing.list('all', {
 
 ### The contact filter
 
-One condition DSL is shared by four places: `contacts.list({ filter })`, a saved
-`Segment`, a CRM trigger's `filters`, and an export's `config.filter`. It has
-its own page: **[contact filter](docs/contact-filter.md)**.
+One condition DSL is shared by five places: `contacts.list({ filter })`, a saved
+`Segment`, a CRM trigger's `filters`, an export's `config.filter`, and a
+scheduled message's `conditions`. It has its own page: **[contact filter](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/contact-filter.md)**.
 
 ### Scoping
 
@@ -161,30 +161,130 @@ the paths), `404 not_found`, `409 conflict` for a name or slug already taken.
 
 ## Modules
 
+One page per resource, every action with its payload, query and response. The
+same pages ship inside the package, so they are readable offline at
+`node_modules/ab-ecosystem-cpass/docs/`.
+
 ### Audience — `/v1/audience`
 
 | Resource | Page | Actions |
 | --- | --- | --- |
-| `crm.contacts` | [contacts](docs/audience/contacts.md) | `list` `get` `create` `update` `delete` `iterate` |
-| `crm.contactTags` | [contact tags](docs/audience/contact-tags.md) | `list` `get` `create` `update` `delete` |
-| `crm.contactNotes` | [contact notes](docs/audience/contact-notes.md) | `list` `get` `create` `update` `delete` |
-| `crm.customFields` | [custom fields](docs/audience/custom-fields.md) | `list` `get` `create` `update` `delete` |
-| `crm.segments` | [segments](docs/audience/segments.md) | `list` `get` `create` `update` `delete` |
-| `crm.crmTriggers` | [CRM triggers](docs/audience/crm-triggers.md) | `list` `get` `create` `update` `delete` `logs` |
-| `crm.imports` | [import history](docs/audience/imports.md) | `list` `get` `create` `delete` |
-| `crm.exports` | [export history](docs/audience/exports.md) | `list` `get` `create` `delete` |
-| `crm.webhooks` | [audience webhooks](docs/audience/webhooks.md) | `list` `get` `create` `update` `delete` |
+| `crm.contacts` | [contacts](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/audience/contacts.md) | `list` `get` `create` `update` `delete` `iterate` |
+| `crm.contactTags` | [contact tags](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/audience/contact-tags.md) | `list` `get` `create` `update` `delete` |
+| `crm.contactNotes` | [contact notes](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/audience/contact-notes.md) | `list` `get` `create` `update` `delete` |
+| `crm.customFields` | [custom fields](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/audience/custom-fields.md) | `list` `get` `create` `update` `delete` |
+| `crm.segments` | [segments](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/audience/segments.md) | `list` `get` `create` `update` `delete` |
+| `crm.crmTriggers` | [CRM triggers](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/audience/crm-triggers.md) | `list` `get` `create` `update` `delete` `logs` |
+| `crm.imports` | [import history](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/audience/imports.md) | `list` `get` `create` `delete` |
+| `crm.exports` | [export history](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/audience/exports.md) | `list` `get` `create` `delete` |
+| `crm.webhooks` | [audience webhooks](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/audience/webhooks.md) | `list` `get` `create` `update` `delete` |
+| `crm.scheduledMessages` | [scheduled messages](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/audience/scheduled-messages.md) | `list` `get` `create` `createSeries` `createRepeating` `reschedule` `cancel` `cancelSeries` `sendNow` |
+| `crm.notifications` | [push notifications](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/audience/notifications.md) | `subscribe` `unsubscribe` `devices` — the devices a user wants notified |
 
 ### Channels — `/v1/channels`
 
 | Resource | Page | Actions |
 | --- | --- | --- |
-| `crm.channels` | [channels](docs/channels/channels.md) | `list` `get` `updateDetails` `disable` `rotateToken` `getProp` `setProp` |
-| — | [channel properties](docs/channels/channel-props.md) | every `prop` `getProp`/`setProp` accepts |
-| `crm.templates` | [templates](docs/channels/templates.md) | `list` `get` `create` `update` `delete` `sync` |
-| `crm.channelWebhooks` | [channel webhooks](docs/channels/webhooks.md) | `list` `get` `create` `update` `delete` |
-| `crm.billing` | [conversation billing](docs/channels/billing.md) | `list` `stats` |
-| `crm.wallet` | [wallet ledger](docs/channels/wallet.md) | `list` |
-| `crm.activity` | [activity log](docs/channels/activity.md) | `list` |
-
-The campaign module is not in this release.
+| `crm.channels` | [channels](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/channels.md) | `list` `get` `updateDetails` `disable` `rotateToken` `getProp` `setProp` |
+| — | [channel properties](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/channel-props.md) | every `prop` `getProp`/`setProp` accepts |
+| `crm.templates` | [templates](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/templates.md) | `list` `get` `create` `update` `delete` `sync` |
+| `crm.channelWebhooks` | [channel webhooks](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/webhooks.md) | `list` `get` `create` `update` `delete` |
+| `crm.billing` | [conversation billing](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/billing.md) | `list` `stats` |
+| `crm.wallet` | [wallet ledger](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/wallet.md) | `list` |
+| `crm.activity` | [activity log](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/channels/activity.md) | `list` |
+
+### Live chat inbox — Socket.IO
+
+A separate transport, not the REST gateway: the inbox is a socket connection with
+its own origin. Install `socket.io-client` alongside the SDK and import the
+`/realtime` subpath — nothing resolves it if you only use the REST client.
+
+```ts
+import { Inbox } from 'ab-ecosystem-cpass/realtime';
+
+const inbox = new Inbox({ url: 'https://inbox.example.com', clientId, token: () => accessToken });
+await inbox.ready();
+
+const { contacts } = await inbox.chats.list({ filter: { assignment: 'me', unread: 'unread' } });
+inbox.on('message.received', (message) => append(message));
+
+// Media: upload straight to storage, then send the link.
+const link = await crm.inboxMedia.upload(file, { kind: 'image' });
+await inbox.messages.sendMedia({ channel, contact, kind: 'image', link, caption: 'Your order' });
+```
+
+| Resource | Page | Actions |
+| --- | --- | --- |
+| — | [connecting](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/inbox/connection.md) | handshake, requests vs pushes, rooms, errors, permissions |
+| `inbox.chats` | [chats](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/inbox/chats.md) | `list` `get` `delete` `transfer` `bulkTransfer` `archive` `unarchive` `block` `markAsRead` `markAsUnread` `pauseAutomation` `resumeAutomation` `close` `done` `pauseTimer` `updateTags` `update` `assignBot` |
+| `inbox.messages` | [messages](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/inbox/messages.md) | `list` `get` `send` `sendMedia` `delete` `retryDownload` |
+| `crm.inboxMedia` | [media](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/inbox/media.md) | `upload` `createUpload` — presigned uploads straight to storage |
+| `inbox.referrals` | [referrals](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/inbox/referrals.md) | click-to-WhatsApp ad payloads |
+| `inbox.sessions` | [chat sessions](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/inbox/sessions.md) | per-channel reply windows |
+
+Requests are promises; pushes are what other agents and contacts did. The same
+event name can be both — an archive you performed and one another agent performed
+arrive identically, so one handler per kind of change is enough.
+
+## Campaigns
+
+One message sent to many people. The audience is a single `filters` field with
+five modes, chosen by the **shape** of the array: `[]` for every contact, a list
+of filter conditions for a segment, `[{numbers, hash}]` for a bulk list,
+`[{type: 'channel'|'template', ...}]` for a group campaign split into buckets, or
+`[{type: 'status'|'selection', ...}]` to re-target an earlier campaign.
+
+`createBulk` is the one worth knowing about. Hand it numbers or a CSV and it does
+the whole bulk path — the recipient list does not travel inside the campaign,
+because a million numbers is not a request body:
+
+```ts
+const { campaign, receivers, skipped, duplicates } = await crm.campaigns.createBulk({
+  name: 'Diwali offer',
+  audience: { csv: await file.text(), recipientColumn: 'phone' },
+  messages: [{ channel: { id: channelId }, message: template }],
+});
+```
+
+It parses the input, encrypts the list under a per-file secret, uploads it
+through a presigned URL, and creates the campaign pointing at the file. Every
+CSV column becomes a per-recipient template variable. Rows with no usable number
+and repeated numbers are dropped and **counted** — `skipped` and `duplicates` —
+rather than passed over silently.
+
+`createGroup` is the bucketed form: it splits recipients across channels or
+templates, uploading one file per bucket.
+
+```ts
+await crm.campaigns.createGroup({
+  name: 'Diwali offer',
+  distributeBy: 'channel',
+  buckets: [
+    { channel: channelA, audience: { rows: north, recipientColumn: 'phone' } },
+    { channel: channelB, audience: { rows: south, recipientColumn: 'phone' } },
+  ],
+  messages: [{ channel: { id: channelA }, message: template }],
+});
+```
+
+Note that `campaign.receivers` is `0` on a campaign you just created: the
+audience is resolved when the campaign sends, not when it is built. The
+`receivers` on the result is the count written into the file, and it is the one
+to show a user.
+
+| Resource | Page | Actions |
+| --- | --- | --- |
+| `crm.campaigns` | [campaigns](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/campaign/campaigns.md) | `list` `get` `create` `createBulk` `createGroup` `uploadReceivers` `update` `schedule` `cancel` `delete` |
+| `crm.campaignReports` | [campaigns](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/campaign/campaigns.md#campaign-reports) | `list` `getByCampaign` |
+| `crm.campaignReportExports` | [campaigns](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/campaign/campaigns.md#campaign-reports) | `list` `get` `create` |
+
+The audience helpers are exported too, so a UI can show "12,480 recipients, 3
+duplicates dropped" before anything is uploaded:
+
+```ts
+import { parseDelimited, resolveAudience } from 'ab-ecosystem-cpass';
+
+const { headers } = parseDelimited(text);
+const { receivers, skipped, duplicates } = resolveAudience({ csv: text, recipientColumn });
+```
+

package/dist/client.d.ts

@@ -8,12 +8,18 @@ import { CrmTriggers } from './resources/audience/crm-triggers';
 import { Imports } from './resources/audience/import-history';
 import { Exports } from './resources/audience/export-history';
 import { Webhooks } from './resources/audience/webhooks';
+import { ScheduledMessages } from './resources/audience/scheduled-messages';
+import { InboxMedia } from './resources/audience/inbox-media';
+import { Notifications } from './resources/audience/notifications';
 import { Channels } from './resources/channels/channels';
 import { Templates } from './resources/channels/templates';
 import { ChannelWebhooks } from './resources/channels/webhooks';
 import { Billing } from './resources/channels/billing';
 import { Wallet } from './resources/channels/wallet';
 import { Activity } from './resources/channels/activity';
+import { Campaigns } from './resources/campaigns';
+import { CampaignReports } from './resources/campaign-reports';
+import { CampaignReportExports } from './resources/campaign-report-exports';
 /**
  * One client for the whole gateway. Construct it once and share it: it holds no
  * per-request state, and every resource below runs over the same HTTP client,
@@ -45,6 +51,25 @@ export declare class CrmClient {
     readonly exports: Exports;
     /** Audience webhooks: subscriptions to contact events. */
     readonly webhooks: Webhooks;
+    /**
+     * Scheduled messages: a send with a time, and a condition checked just before
+     * it goes out -- which is what lets a drip stop itself when a lead converts.
+     */
+    readonly scheduledMessages: ScheduledMessages;
+    /**
+     * Chat media: presigned uploads straight to object storage.
+     *
+     * The only part of the inbox that is HTTP rather than socket, because an
+     * upload is a request with an answer. `upload()` returns the permanent link to
+     * pass to `inbox.messages.sendMedia()`.
+     */
+    readonly inboxMedia: InboxMedia;
+    /**
+     * Push notification subscriptions: the browsers and apps a user wants
+     * notified. `subscribe()` after the browser hands you a Firebase registration
+     * token, `unsubscribe()` on logout.
+     */
+    readonly notifications: Notifications;
     /** Channels, and the provider properties that hang off them. */
     readonly channels: Channels;
     /** WhatsApp message templates, per channel. */
@@ -57,5 +82,18 @@ export declare class CrmClient {
     readonly wallet: Wallet;
     /** Channel activity feed. */
     readonly activity: Activity;
+    /**
+     * Campaigns: a message sent to many people at once.
+     *
+     * `createBulk()` is the one to reach for when you hold the recipients
+     * yourself -- numbers or a CSV. It encrypts the list, uploads it, and creates
+     * the campaign pointing at the file, which is otherwise several steps a caller
+     * has to get exactly right.
+     */
+    readonly campaigns: Campaigns;
+    /** Per-campaign delivery metrics. */
+    readonly campaignReports: CampaignReports;
+    /** Report extracts as CSV or XLSX, generated asynchronously. */
+    readonly campaignReportExports: CampaignReportExports;
     constructor(options: ClientOptions);
 }

package/dist/client.js

@@ -12,6 +12,9 @@ const crm_triggers_1 = require("./resources/audience/crm-triggers");
 const import_history_1 = require("./resources/audience/import-history");
 const export_history_1 = require("./resources/audience/export-history");
 const webhooks_1 = require("./resources/audience/webhooks");
+const scheduled_messages_1 = require("./resources/audience/scheduled-messages");
+const inbox_media_1 = require("./resources/audience/inbox-media");
+const notifications_1 = require("./resources/audience/notifications");
 // Channels
 const channels_1 = require("./resources/channels/channels");
 const templates_1 = require("./resources/channels/templates");
@@ -19,11 +22,10 @@ const webhooks_2 = require("./resources/channels/webhooks");
 const billing_1 = require("./resources/channels/billing");
 const wallet_1 = require("./resources/channels/wallet");
 const activity_1 = require("./resources/channels/activity");
-// The campaign module is not wired up yet; its resources are still excluded
-// from the build.
-// import { Campaigns } from './resources/campaigns';
-// import { CampaignReports } from './resources/campaign-reports';
-// import { CampaignReportExports } from './resources/campaign-report-exports';
+// Campaign
+const campaigns_1 = require("./resources/campaigns");
+const campaign_reports_1 = require("./resources/campaign-reports");
+const campaign_report_exports_1 = require("./resources/campaign-report-exports");
 /**
  * One client for the whole gateway. Construct it once and share it: it holds no
  * per-request state, and every resource below runs over the same HTTP client,
@@ -56,6 +58,25 @@ class CrmClient {
     exports;
     /** Audience webhooks: subscriptions to contact events. */
     webhooks;
+    /**
+     * Scheduled messages: a send with a time, and a condition checked just before
+     * it goes out -- which is what lets a drip stop itself when a lead converts.
+     */
+    scheduledMessages;
+    /**
+     * Chat media: presigned uploads straight to object storage.
+     *
+     * The only part of the inbox that is HTTP rather than socket, because an
+     * upload is a request with an answer. `upload()` returns the permanent link to
+     * pass to `inbox.messages.sendMedia()`.
+     */
+    inboxMedia;
+    /**
+     * Push notification subscriptions: the browsers and apps a user wants
+     * notified. `subscribe()` after the browser hands you a Firebase registration
+     * token, `unsubscribe()` on logout.
+     */
+    notifications;
     // -- Channels -------------------------------------------------------------
     /** Channels, and the provider properties that hang off them. */
     channels;
@@ -69,6 +90,20 @@ class CrmClient {
     wallet;
     /** Channel activity feed. */
     activity;
+    // -- Campaign -------------------------------------------------------------
+    /**
+     * Campaigns: a message sent to many people at once.
+     *
+     * `createBulk()` is the one to reach for when you hold the recipients
+     * yourself -- numbers or a CSV. It encrypts the list, uploads it, and creates
+     * the campaign pointing at the file, which is otherwise several steps a caller
+     * has to get exactly right.
+     */
+    campaigns;
+    /** Per-campaign delivery metrics. */
+    campaignReports;
+    /** Report extracts as CSV or XLSX, generated asynchronously. */
+    campaignReportExports;
     constructor(options) {
         const http = new http_1.HttpClient(options);
         this.contacts = new contacts_1.Contacts(http);
@@ -80,12 +115,21 @@ class CrmClient {
         this.imports = new import_history_1.Imports(http);
         this.exports = new export_history_1.Exports(http);
         this.webhooks = new webhooks_1.Webhooks(http);
+        this.scheduledMessages = new scheduled_messages_1.ScheduledMessages(http);
+        this.inboxMedia = new inbox_media_1.InboxMedia(http);
+        this.notifications = new notifications_1.Notifications(http);
         this.channels = new channels_1.Channels(http);
         this.templates = new templates_1.Templates(http);
         this.channelWebhooks = new webhooks_2.ChannelWebhooks(http);
         this.billing = new billing_1.Billing(http);
         this.wallet = new wallet_1.Wallet(http);
         this.activity = new activity_1.Activity(http);
+        // Campaigns build their own uploader over the same HTTP client: a bulk
+        // audience is uploaded through the media endpoint before the campaign is
+        // created.
+        this.campaigns = new campaigns_1.Campaigns(http);
+        this.campaignReports = new campaign_reports_1.CampaignReports(http);
+        this.campaignReportExports = new campaign_report_exports_1.CampaignReportExports(http);
     }
 }
 exports.CrmClient = CrmClient;

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,iCAAwD;AAExD,WAAW;AACX,4DAAyD;AACzD,oEAAgE;AAChE,sEAAkE;AAClE,sEAAkE;AAClE,4DAAyD;AACzD,oEAAgE;AAChE,wEAA8D;AAC9D,wEAA8D;AAC9D,4DAAyD;AAEzD,WAAW;AACX,4DAAyD;AACzD,8DAA2D;AAC3D,4DAAgE;AAChE,0DAAuD;AACvD,wDAAqD;AACrD,4DAAyD;AAEzD,4EAA4E;AAC5E,kBAAkB;AAClB,qDAAqD;AACrD,kEAAkE;AAClE,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAa,SAAS;IACpB,4EAA4E;IAE5E,gDAAgD;IACvC,QAAQ,CAAW;IAC5B,oDAAoD;IAC3C,WAAW,CAAc;IAClC,kEAAkE;IACzD,YAAY,CAAe;IACpC,qDAAqD;IAC5C,YAAY,CAAe;IACpC,uCAAuC;IAC9B,QAAQ,CAAW;IAC5B,qFAAqF;IAC5E,WAAW,CAAc;IAClC,kEAAkE;IACzD,OAAO,CAAU;IAC1B,yDAAyD;IAChD,OAAO,CAAU;IAC1B,0DAA0D;IACjD,QAAQ,CAAW;IAE5B,4EAA4E;IAE5E,gEAAgE;IACvD,QAAQ,CAAW;IAC5B,+CAA+C;IACtC,SAAS,CAAY;IAC9B,wEAAwE;IAC/D,eAAe,CAAkB;IAC1C,yDAAyD;IAChD,OAAO,CAAU;IAC1B,6BAA6B;IACpB,MAAM,CAAS;IACxB,6BAA6B;IACpB,QAAQ,CAAW;IAE5B,YAAY,OAAsB;QAChC,MAAM,IAAI,GAAG,IAAI,iBAAU,CAAC,OAAO,CAAC,CAAC;QAErC,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,IAAI,0BAAW,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,IAAI,4BAAY,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY,GAAG,IAAI,4BAAY,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,IAAI,0BAAW,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,IAAI,wBAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,IAAI,wBAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,CAAC;QAEnC,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,IAAI,qBAAS,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,IAAI,0BAAe,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,eAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF;AAzDD,8BAyDC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/http.d.ts

@@ -32,6 +32,21 @@ export declare class HttpClient {
     private readonly options;
     private readonly gatewayUrl;
     constructor(options: ClientOptions);
+    /**
+     * The fetch this client was built with, bound to the global object.
+     *
+     * Exposed for the one call that must not go through `request`: a presigned
+     * upload goes straight to object storage, and sending our bearer token or an
+     * extra header with it would both leak the credential to a third party and
+     * break a signature that covers exactly the headers it was issued for.
+     *
+     * Bound, and that is not tidiness. A browser's `fetch` is a method of `Window`
+     * and refuses any other receiver -- so reading it off this getter and calling it
+     * as `client.fetchImpl(url)` invokes it with the `HttpClient` as `this` and
+     * fails with `Illegal invocation`. Binding here makes the property safe to call
+     * however it is reached, rather than leaving every call site to remember.
+     */
+    get fetchImpl(): typeof fetch;
     /** Resolves the bearer token, failing here rather than sending an unauthenticated call. */
     private token;
     request<T>(method: string, path: string, init?: RequestInitOptions): Promise<T>;

package/dist/http.js

@@ -30,6 +30,24 @@ class HttpClient {
         }
         this.gatewayUrl = options.gatewayUrl.trim().replace(/\/+$/, '');
     }
+    /**
+     * The fetch this client was built with, bound to the global object.
+     *
+     * Exposed for the one call that must not go through `request`: a presigned
+     * upload goes straight to object storage, and sending our bearer token or an
+     * extra header with it would both leak the credential to a third party and
+     * break a signature that covers exactly the headers it was issued for.
+     *
+     * Bound, and that is not tidiness. A browser's `fetch` is a method of `Window`
+     * and refuses any other receiver -- so reading it off this getter and calling it
+     * as `client.fetchImpl(url)` invokes it with the `HttpClient` as `this` and
+     * fails with `Illegal invocation`. Binding here makes the property safe to call
+     * however it is reached, rather than leaving every call site to remember.
+     */
+    get fetchImpl() {
+        const impl = this.options.fetch;
+        return impl ? impl.bind(globalThis) : fetch.bind(globalThis);
+    }
     /** Resolves the bearer token, failing here rather than sending an unauthenticated call. */
     async token() {
         const token = typeof this.options.authToken === 'function'
@@ -48,7 +66,9 @@ class HttpClient {
                 url.searchParams.set(key, queryValue(value));
         }
         const origin = this.options.origin ?? browserOrigin();
-        const send = this.options.fetch ?? fetch;
+        // Bound for the same reason as `fetchImpl`: a detached `fetch` must still be
+        // called with the global as its receiver.
+        const send = this.fetchImpl;
         const response = await send(url.toString(), {
             method,
             headers: {

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -12,6 +12,17 @@ export { CrmTriggers } from './resources/audience/crm-triggers';
 export { Imports } from './resources/audience/import-history';
 export { Exports } from './resources/audience/export-history';
 export { Webhooks } from './resources/audience/webhooks';
+export { Notifications } from './resources/audience/notifications';
+export { InboxMedia, type UploadMediaOptions, type UploadMediaSource, } from './resources/audience/inbox-media';
+export { Campaigns, type CreateBulkCampaignInput, type BulkCampaignResult, type CreateGroupCampaignInput, type GroupBucket, type GroupBucketResult, type GroupCampaignResult, type ReceiverUploader, } from './resources/campaigns';
+export { CampaignReports } from './resources/campaign-reports';
+export { CampaignReportExports } from './resources/campaign-report-exports';
+/**
+ * The audience helpers, exported because they are useful before a campaign
+ * exists: a UI can parse a CSV, show "12,480 recipients, 3 duplicates dropped",
+ * and let someone confirm before anything is uploaded.
+ */
+export { MAX_BULK_RECEIVERS, buildReceivers, normaliseColumn, normaliseNumbers, parseDelimited, resolveAudience, type BulkAudienceInput, type CampaignReceiver, type ResolvedAudience, } from './resources/campaign-audience';
 export { Channels, type SetPropOptions } from './resources/channels/channels';
 export { Templates } from './resources/channels/templates';
 export { ChannelWebhooks } from './resources/channels/webhooks';

package/dist/index.js

@@ -14,7 +14,7 @@ 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.Activity = exports.Wallet = exports.Billing = exports.ChannelWebhooks = exports.Templates = exports.Channels = exports.Webhooks = exports.Exports = exports.Imports = exports.CrmTriggers = exports.Segments = exports.CustomFields = exports.ContactNotes = exports.ContactTags = exports.Contacts = exports.CHANNELS = exports.AUDIENCE = void 0;
+exports.Activity = exports.Wallet = exports.Billing = exports.ChannelWebhooks = exports.Templates = exports.Channels = exports.resolveAudience = exports.parseDelimited = exports.normaliseNumbers = exports.normaliseColumn = exports.buildReceivers = exports.MAX_BULK_RECEIVERS = exports.CampaignReportExports = exports.CampaignReports = exports.Campaigns = exports.InboxMedia = exports.Notifications = exports.Webhooks = exports.Exports = exports.Imports = exports.CrmTriggers = exports.Segments = exports.CustomFields = exports.ContactNotes = exports.ContactTags = exports.Contacts = exports.CHANNELS = exports.AUDIENCE = void 0;
 __exportStar(require("./client"), exports);
 __exportStar(require("./http"), exports);
 __exportStar(require("./errors"), exports);
@@ -41,6 +41,29 @@ var export_history_1 = require("./resources/audience/export-history");
 Object.defineProperty(exports, "Exports", { enumerable: true, get: function () { return export_history_1.Exports; } });
 var webhooks_1 = require("./resources/audience/webhooks");
 Object.defineProperty(exports, "Webhooks", { enumerable: true, get: function () { return webhooks_1.Webhooks; } });
+var notifications_1 = require("./resources/audience/notifications");
+Object.defineProperty(exports, "Notifications", { enumerable: true, get: function () { return notifications_1.Notifications; } });
+var inbox_media_1 = require("./resources/audience/inbox-media");
+Object.defineProperty(exports, "InboxMedia", { enumerable: true, get: function () { return inbox_media_1.InboxMedia; } });
+// Campaign
+var campaigns_1 = require("./resources/campaigns");
+Object.defineProperty(exports, "Campaigns", { enumerable: true, get: function () { return campaigns_1.Campaigns; } });
+var campaign_reports_1 = require("./resources/campaign-reports");
+Object.defineProperty(exports, "CampaignReports", { enumerable: true, get: function () { return campaign_reports_1.CampaignReports; } });
+var campaign_report_exports_1 = require("./resources/campaign-report-exports");
+Object.defineProperty(exports, "CampaignReportExports", { enumerable: true, get: function () { return campaign_report_exports_1.CampaignReportExports; } });
+/**
+ * The audience helpers, exported because they are useful before a campaign
+ * exists: a UI can parse a CSV, show "12,480 recipients, 3 duplicates dropped",
+ * and let someone confirm before anything is uploaded.
+ */
+var campaign_audience_1 = require("./resources/campaign-audience");
+Object.defineProperty(exports, "MAX_BULK_RECEIVERS", { enumerable: true, get: function () { return campaign_audience_1.MAX_BULK_RECEIVERS; } });
+Object.defineProperty(exports, "buildReceivers", { enumerable: true, get: function () { return campaign_audience_1.buildReceivers; } });
+Object.defineProperty(exports, "normaliseColumn", { enumerable: true, get: function () { return campaign_audience_1.normaliseColumn; } });
+Object.defineProperty(exports, "normaliseNumbers", { enumerable: true, get: function () { return campaign_audience_1.normaliseNumbers; } });
+Object.defineProperty(exports, "parseDelimited", { enumerable: true, get: function () { return campaign_audience_1.parseDelimited; } });
+Object.defineProperty(exports, "resolveAudience", { enumerable: true, get: function () { return campaign_audience_1.resolveAudience; } });
 // Channels
 var channels_1 = require("./resources/channels/channels");
 Object.defineProperty(exports, "Channels", { enumerable: true, get: function () { return channels_1.Channels; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB;AACzB,0CAAwB;AAExB,2CAAuD;AAA9C,iGAAA,QAAQ,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAE3B,WAAW;AACX,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA;AACjB,kEAAgE;AAAvD,2GAAA,WAAW,OAAA;AACpB,oEAAkE;AAAzD,6GAAA,YAAY,OAAA;AACrB,oEAAkE;AAAzD,6GAAA,YAAY,OAAA;AACrB,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA;AACjB,kEAAgE;AAAvD,2GAAA,WAAW,OAAA;AACpB,sEAA8D;AAArD,yGAAA,OAAO,OAAA;AAChB,sEAA8D;AAArD,yGAAA,OAAO,OAAA;AAChB,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA;AAEjB,WAAW;AACX,0DAA8E;AAArE,oGAAA,QAAQ,OAAA;AACjB,4DAA2D;AAAlD,sGAAA,SAAS,OAAA;AAClB,0DAAgE;AAAvD,2GAAA,eAAe,OAAA;AACxB,wDAAuD;AAA9C,kGAAA,OAAO,OAAA;AAChB,sDAAqD;AAA5C,gGAAA,MAAM,OAAA;AACf,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB;AACzB,0CAAwB;AAExB,2CAAuD;AAA9C,iGAAA,QAAQ,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAE3B,WAAW;AACX,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA;AACjB,kEAAgE;AAAvD,2GAAA,WAAW,OAAA;AACpB,oEAAkE;AAAzD,6GAAA,YAAY,OAAA;AACrB,oEAAkE;AAAzD,6GAAA,YAAY,OAAA;AACrB,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA;AACjB,kEAAgE;AAAvD,2GAAA,WAAW,OAAA;AACpB,sEAA8D;AAArD,yGAAA,OAAO,OAAA;AAChB,sEAA8D;AAArD,yGAAA,OAAO,OAAA;AAChB,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA;AACjB,oEAAmE;AAA1D,8GAAA,aAAa,OAAA;AACtB,gEAI0C;AAHxC,yGAAA,UAAU,OAAA;AAKZ,WAAW;AACX,mDAS+B;AAR7B,sGAAA,SAAS,OAAA;AASX,iEAA+D;AAAtD,mHAAA,eAAe,OAAA;AACxB,+EAA4E;AAAnE,gIAAA,qBAAqB,OAAA;AAC9B;;;;GAIG;AACH,mEAUuC;AATrC,uHAAA,kBAAkB,OAAA;AAClB,mHAAA,cAAc,OAAA;AACd,oHAAA,eAAe,OAAA;AACf,qHAAA,gBAAgB,OAAA;AAChB,mHAAA,cAAc,OAAA;AACd,oHAAA,eAAe,OAAA;AAMjB,WAAW;AACX,0DAA8E;AAArE,oGAAA,QAAQ,OAAA;AACjB,4DAA2D;AAAlD,sGAAA,SAAS,OAAA;AAClB,0DAAgE;AAAvD,2GAAA,eAAe,OAAA;AACxB,wDAAuD;AAA9C,kGAAA,OAAO,OAAA;AAChB,sDAAqD;AAA5C,gGAAA,MAAM,OAAA;AACf,0DAAyD;AAAhD,oGAAA,QAAQ,OAAA"}

package/dist/internal/bytes.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Byte and text conversions, written out rather than taken from a platform.
+ *
+ * This SDK runs in a browser and in Node, and the obvious helpers differ between
+ * them: `btoa` is browser-first and deprecated in Node, `Buffer` does not exist
+ * in a browser, and feature-detecting between the two puts an environment branch
+ * in the middle of something that has to produce identical bytes everywhere.
+ * These are a few lines each and have no such branch.
+ */
+/** UTF-8 bytes of a string. `TextEncoder` is global in Node 18+ and every browser. */
+export declare const utf8: (value: string) => Uint8Array;
+/**
+ * A standalone `ArrayBuffer` holding a copy of these bytes.
+ *
+ * Web Crypto takes `BufferSource`, and a `Uint8Array` is not always one as far as
+ * the type system is concerned: since TypeScript 5.7 the array is generic in its
+ * backing buffer, and the `ArrayBufferLike` that `TextEncoder` hands back could
+ * in principle be a `SharedArrayBuffer`, which `BufferSource` excludes. Copying
+ * into a buffer of known provenance settles it without an assertion, and without
+ * putting a generic type parameter into the emitted declarations -- which would
+ * make this package fail to typecheck for anyone on an older compiler.
+ */
+export declare const toArrayBuffer: (bytes: Uint8Array) => ArrayBuffer;
+/** Standard base64, with padding -- the form `CryptoJS`'s default formatter emits. */
+export declare const toBase64: (bytes: Uint8Array) => string;
+/** Lower-case hex, two characters per byte. */
+export declare const toHex: (bytes: Uint8Array) => string;
+/**
+ * Cryptographically random bytes.
+ *
+ * `crypto.getRandomValues` is the one API that is present and seeded properly in
+ * both environments -- global in Node 18+ and in browsers. `Math.random` is not
+ * an acceptable substitute here: the value it would produce is the key under
+ * which a customer's phone numbers are encrypted.
+ */
+export declare const randomBytes: (length: number) => Uint8Array;
+/** Web Crypto, or a clear error naming what is missing rather than a `TypeError`. */
+export declare const subtle: () => SubtleCrypto;

package/dist/internal/bytes.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Byte and text conversions, written out rather than taken from a platform.
+ *
+ * This SDK runs in a browser and in Node, and the obvious helpers differ between
+ * them: `btoa` is browser-first and deprecated in Node, `Buffer` does not exist
+ * in a browser, and feature-detecting between the two puts an environment branch
+ * in the middle of something that has to produce identical bytes everywhere.
+ * These are a few lines each and have no such branch.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subtle = exports.randomBytes = exports.toHex = exports.toBase64 = exports.toArrayBuffer = exports.utf8 = void 0;
+/** UTF-8 bytes of a string. `TextEncoder` is global in Node 18+ and every browser. */
+const utf8 = (value) => new TextEncoder().encode(value);
+exports.utf8 = utf8;
+/**
+ * A standalone `ArrayBuffer` holding a copy of these bytes.
+ *
+ * Web Crypto takes `BufferSource`, and a `Uint8Array` is not always one as far as
+ * the type system is concerned: since TypeScript 5.7 the array is generic in its
+ * backing buffer, and the `ArrayBufferLike` that `TextEncoder` hands back could
+ * in principle be a `SharedArrayBuffer`, which `BufferSource` excludes. Copying
+ * into a buffer of known provenance settles it without an assertion, and without
+ * putting a generic type parameter into the emitted declarations -- which would
+ * make this package fail to typecheck for anyone on an older compiler.
+ */
+const toArrayBuffer = (bytes) => {
+    const buffer = new ArrayBuffer(bytes.length);
+    new Uint8Array(buffer).set(bytes);
+    return buffer;
+};
+exports.toArrayBuffer = toArrayBuffer;
+const BASE64_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+/** Standard base64, with padding -- the form `CryptoJS`'s default formatter emits. */
+const toBase64 = (bytes) => {
+    let out = '';
+    for (let i = 0; i < bytes.length; i += 3) {
+        const a = bytes[i];
+        const b = bytes[i + 1];
+        const c = bytes[i + 2];
+        out += BASE64_ALPHABET[a >> 2];
+        out += BASE64_ALPHABET[((a & 0x03) << 4) | ((b ?? 0) >> 4)];
+        out += b === undefined ? '=' : BASE64_ALPHABET[((b & 0x0f) << 2) | ((c ?? 0) >> 6)];
+        out += c === undefined ? '=' : BASE64_ALPHABET[c & 0x3f];
+    }
+    return out;
+};
+exports.toBase64 = toBase64;
+/** Lower-case hex, two characters per byte. */
+const toHex = (bytes) => {
+    let out = '';
+    for (const byte of bytes)
+        out += byte.toString(16).padStart(2, '0');
+    return out;
+};
+exports.toHex = toHex;
+/**
+ * Cryptographically random bytes.
+ *
+ * `crypto.getRandomValues` is the one API that is present and seeded properly in
+ * both environments -- global in Node 18+ and in browsers. `Math.random` is not
+ * an acceptable substitute here: the value it would produce is the key under
+ * which a customer's phone numbers are encrypted.
+ */
+const randomBytes = (length) => {
+    const source = globalThis.crypto;
+    if (!source?.getRandomValues) {
+        throw new Error('No cryptographic random source: globalThis.crypto.getRandomValues is unavailable. ' +
+            'This SDK needs Node 18+ or a browser with Web Crypto.');
+    }
+    return source.getRandomValues(new Uint8Array(length));
+};
+exports.randomBytes = randomBytes;
+/** Web Crypto, or a clear error naming what is missing rather than a `TypeError`. */
+const subtle = () => {
+    const source = globalThis.crypto;
+    if (!source?.subtle) {
+        throw new Error('Web Crypto is unavailable: globalThis.crypto.subtle is missing. ' +
+            'Encrypting campaign receivers needs Node 18+ or a secure browser context (https or localhost).');
+    }
+    return source.subtle;
+};
+exports.subtle = subtle;
+//# sourceMappingURL=bytes.js.map

package/dist/internal/bytes.js.map

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