ab-ecosystem-cpass 1.0.8 → 1.0.10

package/README.md

@@ -159,6 +159,44 @@ try {
 Common codes: `422` for a body or query that fails validation (`details` lists
 the paths), `404 not_found`, `409 conflict` for a name or slug already taken.
 
+### Plan limits
+
+Every call needs an active subscription, and the metered resources are capped at
+what the plan includes. Both refusals are `402`, told apart by `code`:
+
+| Code | When | `details` |
+| --- | --- | --- |
+| `subscription_required` | The account has no subscription, or it has lapsed. Any call. | — |
+| `not_included` | The plan includes none of that resource. | `{ resource }` |
+| `quota_exceeded` | The plan's allowance is used up. | `{ resource, limit, used }` |
+
+What counts, and against which inclusion:
+
+| `resource` | Counted as | Inclusion |
+| --- | --- | --- |
+| `contact` | one contact | `contact_18472` — **1 unit = 1000 contacts** |
+| `canned_reply` | one reply | `canned_reply_14172` |
+| `scheduled_series` | one series, whatever its length — a one-off `schedule` is free | `series_91922` |
+| `data_store` | one registered store | `data_store_52360` |
+| `campaign` | one campaign | `campaign_73018` |
+| `super_field` | one custom field | `super_field_29689` |
+| `whatsapp_channel` | one live WhatsApp channel | `whatsapp_channels_28335` |
+
+Counts are of what exists now, so deleting a row gives the allowance back.
+`limit` and `used` are returned on `quota_exceeded` so a panel can say how far
+over the account is without a second call.
+
+```ts
+try {
+  await crm.campaigns.create(input);
+} catch (err) {
+  if (err instanceof CrmApiError && err.status === 402) {
+    // err.code: 'subscription_required' | 'not_included' | 'quota_exceeded'
+    console.error(err.message, err.details);
+  }
+}
+```
+
 ## Modules
 
 One page per resource, every action with its payload, query and response. The
@@ -271,6 +309,13 @@ await crm.campaigns.createGroup({
 });
 ```
 
+**Creating a campaign does not send it.** Every create returns a draft:
+`pending`, with no `scheduledAt`. `crm.campaigns.trigger(id)` sends it now (with
+about a minute in which `cancel` still works), and
+`crm.campaigns.trigger(id, { scheduledAt })` sends it then. A send time is
+refused on `create` and `update`, because arming a campaign is also what records
+who authorised it.
+
 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
@@ -278,7 +323,7 @@ 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.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` **`trigger`** `schedule` `cancel` `delete` — creating does not send; `trigger` is what does |
 | `crm.campaignMessages` | [campaign reporting](https://github.com/udghatan-dev/crm-sdk/blob/main/packages/sdk-js/docs/campaign/campaign-messages.md) | `stats` `list` `iterate` `replies` — `/v1/campaigns/:id/report`, counted off the per-recipient rows |
 
 The audience helpers are exported too, so a UI can show "12,480 recipients, 3

package/dist/resources/campaigns.d.ts

@@ -2,7 +2,7 @@ import type { HttpClient } from '../http';
 import { InboxMedia } from './audience/inbox-media';
 import { type CampaignReceiver, type ReceiverEncoding } from '../internal/receiver-file';
 import { type BulkAudienceInput, type ResolvedAudience } from './campaign-audience';
-import type { Campaign, CampaignNumbersFilter, CreateCampaignInput, ListCampaignsQuery, UpdateCampaignInput } from '../types/campaign';
+import type { Campaign, CampaignNumbersFilter, CreateCampaignInput, ListCampaignsQuery, TriggerCampaignInput, UpdateCampaignInput } from '../types/campaign';
 import type { Page } from '../types/common';
 /** Everything `createBulk` needs: a normal campaign, with an audience instead of `filters`. */
 export interface CreateBulkCampaignInput extends Omit<CreateCampaignInput, 'filters' | 'type'> {
@@ -102,6 +102,17 @@ export declare class Campaigns {
     /**
      * Creates a campaign from a payload you have already assembled.
      *
+     * **Creating does not send.** The campaign comes back `pending` with no
+     * `scheduledAt`: a draft you can keep editing, invisible to the sender until
+     * {@link trigger} arms it.
+     *
+     * ```ts
+     * const campaign = await crm.campaigns.create({ name: 'Diwali offer', messages });
+     * // ...show it for review...
+     * await crm.campaigns.trigger(campaign.id);              // send now
+     * await crm.campaigns.trigger(campaign.id, { scheduledAt }); // or then
+     * ```
+     *
      * For a bulk recipient list, prefer {@link createBulk} -- it does the
      * encrypting and uploading that a file-backed audience requires, which is not
      * something a caller should have to reproduce.
@@ -129,9 +140,10 @@ export declare class Campaigns {
      *   name: 'Renewal reminder',
      *   audience: { csv: await file.text(), recipientColumn: 'phone' },
      *   messages: [{ channel: { id: channelId }, message: template }],
-     *   trigger: 'schedule',
-     *   scheduledAt: '2026-11-01T04:30:00.000Z',
      * });
+     *
+     * // Neither of the above has been sent yet. Arm it when you are ready:
+     * await crm.campaigns.trigger(campaign.id, { scheduledAt: '2026-11-01T04:30:00.000Z' });
      * ```
      *
      * ## What it does, in order
@@ -233,6 +245,24 @@ export declare class Campaigns {
      */
     encoding?: ReceiverEncoding): Promise<CampaignNumbersFilter>;
     update(id: string, input: UpdateCampaignInput): Promise<Campaign>;
+    /**
+     * Arms a campaign -- the only call that makes one actually go out.
+     *
+     * ```ts
+     * await crm.campaigns.trigger(id);                                   // now
+     * await crm.campaigns.trigger(id, { scheduledAt: isoInstant });      // then
+     * ```
+     *
+     * "Now" means a minute from now by default, which is the window `cancel()`
+     * works in. The server stamps `triggerInfo` -- the caller, their address, the
+     * moment -- as part of this call, so every send has one authorising act behind
+     * it; nothing you pass can set it.
+     *
+     * Only a `pending` campaign can be armed; anything else answers `409`.
+     * Triggering one that is armed but not yet picked up simply re-arms it.
+     */
+    trigger(id: string, input?: TriggerCampaignInput): Promise<Campaign>;
+    /** {@link trigger} with a required time, under the name the panel uses. */
     schedule(id: string, scheduledAt: string): Promise<Campaign>;
     cancel(id: string): Promise<Campaign>;
     delete(id: string): Promise<void>;

package/dist/resources/campaigns.js

@@ -35,6 +35,17 @@ class Campaigns {
     /**
      * Creates a campaign from a payload you have already assembled.
      *
+     * **Creating does not send.** The campaign comes back `pending` with no
+     * `scheduledAt`: a draft you can keep editing, invisible to the sender until
+     * {@link trigger} arms it.
+     *
+     * ```ts
+     * const campaign = await crm.campaigns.create({ name: 'Diwali offer', messages });
+     * // ...show it for review...
+     * await crm.campaigns.trigger(campaign.id);              // send now
+     * await crm.campaigns.trigger(campaign.id, { scheduledAt }); // or then
+     * ```
+     *
      * For a bulk recipient list, prefer {@link createBulk} -- it does the
      * encrypting and uploading that a file-backed audience requires, which is not
      * something a caller should have to reproduce.
@@ -64,9 +75,10 @@ class Campaigns {
      *   name: 'Renewal reminder',
      *   audience: { csv: await file.text(), recipientColumn: 'phone' },
      *   messages: [{ channel: { id: channelId }, message: template }],
-     *   trigger: 'schedule',
-     *   scheduledAt: '2026-11-01T04:30:00.000Z',
      * });
+     *
+     * // Neither of the above has been sent yet. Arm it when you are ready:
+     * await crm.campaigns.trigger(campaign.id, { scheduledAt: '2026-11-01T04:30:00.000Z' });
      * ```
      *
      * ## What it does, in order
@@ -260,6 +272,28 @@ class Campaigns {
     update(id, input) {
         return this.http.request('PATCH', `/v1/campaigns/${encodeURIComponent(id)}`, { body: input });
     }
+    /**
+     * Arms a campaign -- the only call that makes one actually go out.
+     *
+     * ```ts
+     * await crm.campaigns.trigger(id);                                   // now
+     * await crm.campaigns.trigger(id, { scheduledAt: isoInstant });      // then
+     * ```
+     *
+     * "Now" means a minute from now by default, which is the window `cancel()`
+     * works in. The server stamps `triggerInfo` -- the caller, their address, the
+     * moment -- as part of this call, so every send has one authorising act behind
+     * it; nothing you pass can set it.
+     *
+     * Only a `pending` campaign can be armed; anything else answers `409`.
+     * Triggering one that is armed but not yet picked up simply re-arms it.
+     */
+    trigger(id, input = {}) {
+        return this.http.request('POST', `/v1/campaigns/${encodeURIComponent(id)}/trigger`, {
+            body: input,
+        });
+    }
+    /** {@link trigger} with a required time, under the name the panel uses. */
     schedule(id, scheduledAt) {
         return this.http.request('POST', `/v1/campaigns/${encodeURIComponent(id)}/schedule`, {
             body: { scheduledAt },

package/dist/resources/campaigns.js.map

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

package/dist/resources/data-stores.d.ts

@@ -1,9 +1,10 @@
-import type { BulkDeleteDataStoreRecordsInput, BulkUpdateDataStoreRecordsInput, CreateDataStoreCollectionInput, CreateDataStoreInput, DataStore, DataStoreCollection, DataStoreDeleteResult, DataStoreRecord, DataStoreTestResult, DataStoreUpdateResult, DataStoreWriteResult, InsertDataStoreRecordsInput, ListDataStoreRecordsQuery, ListQuery, Paginated, SearchDataStoreRecordsInput, UpdateDataStoreCollectionInput, UpdateDataStoreInput, UpdateDataStoreRecordInput } from '../types';
+import type { BulkDeleteDataStoreRecordsInput, CloudDataStoreRegion, BulkUpdateDataStoreRecordsInput, CreateDataStoreCollectionInput, CreateDataStoreInput, DataStore, DataStoreCollection, DataStoreDeleteResult, DataStoreRecord, DataStoreTestResult, DataStoreUpdateResult, DataStoreWriteResult, InsertDataStoreRecordsInput, ListDataStoreRecordsQuery, ListQuery, Paginated, SearchDataStoreRecordsInput, UpdateDataStoreCollectionInput, UpdateDataStoreInput, UpdateDataStoreRecordInput } from '../types';
 import type { HttpClient } from '../http';
 /**
- * Data stores: a MongoDB **you** own, registered with the platform.
+ * Data stores: a MongoDB you own, or one the platform runs for you.
  *
  * ```ts
+ * // your own cluster, registered with a credential
  * const store = await crm.dataStores.create({
  *   title: 'Orders DB',
  *   credentials: {
@@ -15,6 +16,9 @@ import type { HttpClient } from '../http';
  *   },
  * });
  *
+ * // or one of the platform's -- no credential, no cluster to run
+ * const hosted = await crm.dataStores.create({ title: 'Leads', type: 'cloud' });
+ *
  * const orders = await crm.dataStoreCollections.create(store.id, {
  *   title: 'Orders',
  *   fields: [
@@ -29,12 +33,30 @@ import type { HttpClient } from '../http';
  * });
  * ```
  *
+ * ## Which kind to pick
+ *
+ * A **cloud** store (`type: 'cloud'`) is a database the platform provisions on
+ * one of its clusters, in a location you choose from `regions()` -- Germany for
+ * now. There is no credential to manage, nothing to expose to the internet, and
+ * no IP access list to maintain. Use it for data that does not already live
+ * somewhere.
+ *
+ * A **self** store is your own cluster, and the default. Use it when the data is
+ * already there, or has to stay there.
+ *
+ * The difference that matters beyond setup is **who the system of record is**,
+ * and it shows up on delete -- see below.
+ *
  * ## What the platform holds, and what it does not
  *
- * It holds the credential -- encrypted -- and the schemas you declare. It holds
- * **none of your data**: records are read from and written to your cluster on
- * every call, so nothing here is a copy that can go stale, and nothing here
- * survives you revoking the credential.
+ * For a `self` store it holds the credential -- encrypted -- and the schemas you
+ * declare. It holds **none of your data**: records are read from and written to
+ * your cluster on every call, so nothing here is a copy that can go stale, and
+ * nothing here survives you revoking the credential.
+ *
+ * For a `cloud` store it holds the database itself. Nothing about that cluster
+ * is returned -- no host, no user, no connection string -- because there is no
+ * second way in: the API is the only door to those records.
  *
  * Which also means every record call costs a round trip to your database. The
  * platform keeps the connection open between calls, so that is one query's
@@ -42,14 +64,17 @@ import type { HttpClient } from '../http';
  * single inserts is a thousand round trips: send them as one `insert` with
  * `records` instead.
  *
- * ## Deleting never deletes your data
+ * ## Deleting a `self` store never deletes your data. Deleting a `cloud` store does
+ *
+ * On a **self** store, `remove()` forgets the credential and the schemas, and
+ * `remove()` on a collection forgets the declaration. **Neither touches your
+ * database** -- the collections and every document in them are exactly as they
+ * were, and re-registering the same credential with the same collection name
+ * reads it all straight back.
  *
- * `remove()` on a store forgets the credential and the schemas. `remove()` on a
- * collection forgets the declaration. **Neither touches your database** -- the
- * collections and every document in them are exactly as they were, and
- * re-registering the same credential with the same collection name reads it all
- * straight back. Deleting *records* is the only thing here that deletes
- * anything of yours.
+ * On a **cloud** store, `remove()` **destroys the database**. Every record in it
+ * is gone, there is no undo, and re-creating the store gets a fresh empty one.
+ * Ask before you call it.
  *
  * ## The host must be reachable from the internet
  *
@@ -62,6 +87,21 @@ import type { HttpClient } from '../http';
 export declare class DataStores {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * `GET /v1/datastores/cloud-regions` -- `{ data: [{ code, location }] }`.
+     *
+     * The clusters a cloud store can be provisioned on. Read it to render the
+     * location choice rather than hardcoding one: locations are added over time,
+     * and the `code` is what a create takes.
+     *
+     * An **empty list** means this deployment provisions none -- an on-premise
+     * install, typically -- and a `type: 'cloud'` create would be refused.
+     *
+     * Scope: `datastores:read`.
+     */
+    regions(): Promise<{
+        data: CloudDataStoreRegion[];
+    }>;
     /**
      * `POST /v1/datastores` -- 201 with the store.
      *
@@ -70,7 +110,25 @@ export declare class DataStores {
      * | Field | Type | Required | Notes |
      * | --- | --- | --- | --- |
      * | `title` | string | yes | What you call it. 1-120 characters. |
-     * | `credentials` | object | yes | Either form below. |
+     * | `type` | `'self' \| 'cloud'` | no | Default `self`: your own database. |
+     * | `credentials` | object | for `self` | Either form below. Refused for `cloud`. |
+     * | `code` | string | no | `cloud` only: a cluster from `regions()`. Defaults to the platform's. |
+     *
+     * ### A cloud store
+     *
+     * ```ts
+     * await crm.dataStores.create({ title: 'Leads', type: 'cloud' });
+     * ```
+     *
+     * That is the whole payload: the platform provisions a database of its own,
+     * in the default location, and the response carries the `code` and `location`
+     * it ended up in. Nothing below about credentials, hosts or IP access lists
+     * applies -- and neither does the 502 pair, because there is no cluster of
+     * yours to be unreachable.
+     *
+     * | Status | Code | Meaning |
+     * | --- | --- | --- |
+     * | 422 | `validation_failed` | Credentials sent with `type: 'cloud'`, or a `code` that is not on offer -- including when this deployment offers none. |
      *
      * **`credentials.type: 'field'`**
      *
@@ -128,7 +186,13 @@ export declare class DataStores {
      * | Field | Type | Notes |
      * | --- | --- | --- |
      * | `title` | string | |
-     * | `credentials` | object | Replaced whole, and tested before it is stored. |
+     * | `credentials` | object | Replaced whole, and tested before it is stored. `self` stores only. |
+     *
+     * `type` and `code` are not editable: they say where the records are, not how
+     * the store is configured. Sending `credentials` for a **cloud** store is a
+     * `422` -- there is nothing to replace, and re-pointing it would leave its
+     * records in a database nothing addresses. Register your own database as a
+     * second store instead.
      *
      * A partial credential is not accepted: send all four fields, or the whole
      * URI. New credentials go through the same checks as `create`, and the old
@@ -141,10 +205,19 @@ export declare class DataStores {
     /**
      * `DELETE /v1/datastores/:store` -- 204.
      *
-     * Forgets the credential and every schema declared on it. **Your database is
-     * not touched**: the collections and all their documents remain, and
-     * registering the same credential again with the same collection names reads
-     * them straight back.
+     * **A `self` store:** forgets the credential and every schema declared on it.
+     * Your database is not touched -- the collections and all their documents
+     * remain, and registering the same credential again with the same collection
+     * names reads them straight back.
+     *
+     * **A `cloud` store:** drops every collection in its database, which destroys
+     * the database with them. Every record is gone, there is no undo, and a new
+     * store of the same name is a new empty database. Confirm with the user before
+     * calling this on one.
+     *
+     * | Status | Code | Meaning |
+     * | --- | --- | --- |
+     * | 502 | `datastore_purge_failed` | A collection could not be deleted, named in `details`. Nothing was removed -- the store is intact and the call can be retried. |
      *
      * Scope: `datastores:write`.
      */

package/dist/resources/data-stores.js

@@ -8,9 +8,10 @@ const collectionsPath = (store) => `${storePath(store)}/collections`;
 const collectionPath = (store, collection) => `${collectionsPath(store)}/${(0, paths_1.seg)(collection)}`;
 const recordsPath = (store, collection) => `${collectionPath(store, collection)}/records`;
 /**
- * Data stores: a MongoDB **you** own, registered with the platform.
+ * Data stores: a MongoDB you own, or one the platform runs for you.
  *
  * ```ts
+ * // your own cluster, registered with a credential
  * const store = await crm.dataStores.create({
  *   title: 'Orders DB',
  *   credentials: {
@@ -22,6 +23,9 @@ const recordsPath = (store, collection) => `${collectionPath(store, collection)}
  *   },
  * });
  *
+ * // or one of the platform's -- no credential, no cluster to run
+ * const hosted = await crm.dataStores.create({ title: 'Leads', type: 'cloud' });
+ *
  * const orders = await crm.dataStoreCollections.create(store.id, {
  *   title: 'Orders',
  *   fields: [
@@ -36,12 +40,30 @@ const recordsPath = (store, collection) => `${collectionPath(store, collection)}
  * });
  * ```
  *
+ * ## Which kind to pick
+ *
+ * A **cloud** store (`type: 'cloud'`) is a database the platform provisions on
+ * one of its clusters, in a location you choose from `regions()` -- Germany for
+ * now. There is no credential to manage, nothing to expose to the internet, and
+ * no IP access list to maintain. Use it for data that does not already live
+ * somewhere.
+ *
+ * A **self** store is your own cluster, and the default. Use it when the data is
+ * already there, or has to stay there.
+ *
+ * The difference that matters beyond setup is **who the system of record is**,
+ * and it shows up on delete -- see below.
+ *
  * ## What the platform holds, and what it does not
  *
- * It holds the credential -- encrypted -- and the schemas you declare. It holds
- * **none of your data**: records are read from and written to your cluster on
- * every call, so nothing here is a copy that can go stale, and nothing here
- * survives you revoking the credential.
+ * For a `self` store it holds the credential -- encrypted -- and the schemas you
+ * declare. It holds **none of your data**: records are read from and written to
+ * your cluster on every call, so nothing here is a copy that can go stale, and
+ * nothing here survives you revoking the credential.
+ *
+ * For a `cloud` store it holds the database itself. Nothing about that cluster
+ * is returned -- no host, no user, no connection string -- because there is no
+ * second way in: the API is the only door to those records.
  *
  * Which also means every record call costs a round trip to your database. The
  * platform keeps the connection open between calls, so that is one query's
@@ -49,14 +71,17 @@ const recordsPath = (store, collection) => `${collectionPath(store, collection)}
  * single inserts is a thousand round trips: send them as one `insert` with
  * `records` instead.
  *
- * ## Deleting never deletes your data
+ * ## Deleting a `self` store never deletes your data. Deleting a `cloud` store does
+ *
+ * On a **self** store, `remove()` forgets the credential and the schemas, and
+ * `remove()` on a collection forgets the declaration. **Neither touches your
+ * database** -- the collections and every document in them are exactly as they
+ * were, and re-registering the same credential with the same collection name
+ * reads it all straight back.
  *
- * `remove()` on a store forgets the credential and the schemas. `remove()` on a
- * collection forgets the declaration. **Neither touches your database** -- the
- * collections and every document in them are exactly as they were, and
- * re-registering the same credential with the same collection name reads it all
- * straight back. Deleting *records* is the only thing here that deletes
- * anything of yours.
+ * On a **cloud** store, `remove()` **destroys the database**. Every record in it
+ * is gone, there is no undo, and re-creating the store gets a fresh empty one.
+ * Ask before you call it.
  *
  * ## The host must be reachable from the internet
  *
@@ -71,6 +96,21 @@ class DataStores {
     constructor(http) {
         this.http = http;
     }
+    /**
+     * `GET /v1/datastores/cloud-regions` -- `{ data: [{ code, location }] }`.
+     *
+     * The clusters a cloud store can be provisioned on. Read it to render the
+     * location choice rather than hardcoding one: locations are added over time,
+     * and the `code` is what a create takes.
+     *
+     * An **empty list** means this deployment provisions none -- an on-premise
+     * install, typically -- and a `type: 'cloud'` create would be refused.
+     *
+     * Scope: `datastores:read`.
+     */
+    regions() {
+        return this.http.request('GET', `${BASE}/cloud-regions`);
+    }
     /**
      * `POST /v1/datastores` -- 201 with the store.
      *
@@ -79,7 +119,25 @@ class DataStores {
      * | Field | Type | Required | Notes |
      * | --- | --- | --- | --- |
      * | `title` | string | yes | What you call it. 1-120 characters. |
-     * | `credentials` | object | yes | Either form below. |
+     * | `type` | `'self' \| 'cloud'` | no | Default `self`: your own database. |
+     * | `credentials` | object | for `self` | Either form below. Refused for `cloud`. |
+     * | `code` | string | no | `cloud` only: a cluster from `regions()`. Defaults to the platform's. |
+     *
+     * ### A cloud store
+     *
+     * ```ts
+     * await crm.dataStores.create({ title: 'Leads', type: 'cloud' });
+     * ```
+     *
+     * That is the whole payload: the platform provisions a database of its own,
+     * in the default location, and the response carries the `code` and `location`
+     * it ended up in. Nothing below about credentials, hosts or IP access lists
+     * applies -- and neither does the 502 pair, because there is no cluster of
+     * yours to be unreachable.
+     *
+     * | Status | Code | Meaning |
+     * | --- | --- | --- |
+     * | 422 | `validation_failed` | Credentials sent with `type: 'cloud'`, or a `code` that is not on offer -- including when this deployment offers none. |
      *
      * **`credentials.type: 'field'`**
      *
@@ -143,7 +201,13 @@ class DataStores {
      * | Field | Type | Notes |
      * | --- | --- | --- |
      * | `title` | string | |
-     * | `credentials` | object | Replaced whole, and tested before it is stored. |
+     * | `credentials` | object | Replaced whole, and tested before it is stored. `self` stores only. |
+     *
+     * `type` and `code` are not editable: they say where the records are, not how
+     * the store is configured. Sending `credentials` for a **cloud** store is a
+     * `422` -- there is nothing to replace, and re-pointing it would leave its
+     * records in a database nothing addresses. Register your own database as a
+     * second store instead.
      *
      * A partial credential is not accepted: send all four fields, or the whole
      * URI. New credentials go through the same checks as `create`, and the old
@@ -158,10 +222,19 @@ class DataStores {
     /**
      * `DELETE /v1/datastores/:store` -- 204.
      *
-     * Forgets the credential and every schema declared on it. **Your database is
-     * not touched**: the collections and all their documents remain, and
-     * registering the same credential again with the same collection names reads
-     * them straight back.
+     * **A `self` store:** forgets the credential and every schema declared on it.
+     * Your database is not touched -- the collections and all their documents
+     * remain, and registering the same credential again with the same collection
+     * names reads them straight back.
+     *
+     * **A `cloud` store:** drops every collection in its database, which destroys
+     * the database with them. Every record is gone, there is no undo, and a new
+     * store of the same name is a new empty database. Confirm with the user before
+     * calling this on one.
+     *
+     * | Status | Code | Meaning |
+     * | --- | --- | --- |
+     * | 502 | `datastore_purge_failed` | A collection could not be deleted, named in `details`. Nothing was removed -- the store is intact and the call can be retried. |
      *
      * Scope: `datastores:write`.
      */

package/dist/resources/data-stores.js.map

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

package/dist/types/campaign.d.ts

@@ -130,6 +130,13 @@ export interface Campaign {
     parentBroadcastId?: string;
     scheduleId?: string;
     hidden: boolean;
+    /**
+     * When the campaign is armed to go out -- and whether it is armed at all.
+     *
+     * Absent on a campaign nobody has triggered yet, which is the state every
+     * campaign starts in. Set by `trigger()` or `schedule()`, never by `create()`
+     * or `update()`.
+     */
     scheduledAt?: IsoDate;
     processedAt?: IsoDate;
     completedAt?: IsoDate;
@@ -147,11 +154,22 @@ export interface Campaign {
     createdAt: IsoDate;
     updatedAt: IsoDate;
 }
+/**
+ * A campaign to write. Writing one does not send it: see `campaigns.trigger()`.
+ *
+ * There is no `scheduledAt` here on purpose, and the API rejects one rather than
+ * ignoring it -- a send time belongs to the act of arming the campaign, which is
+ * also what records who armed it.
+ */
 export interface CreateCampaignInput {
     name: string;
     /** Defaults to `general`. `createBulk()` sets `bulk_campaign` itself. */
     type?: string;
     campaignType?: CampaignType;
+    /**
+     * How you expect it to go out. Advisory: `trigger()` rewrites it from what it
+     * is actually given, so this only matters to your own reading of the record.
+     */
     trigger?: CampaignTrigger;
     channelType?: string;
     messagingPattern?: string;
@@ -163,10 +181,18 @@ export interface CreateCampaignInput {
     repeat?: CampaignRepeat;
     parentBroadcastId?: string;
     hidden?: boolean;
-    /** Required when `trigger` is `schedule`. */
-    scheduledAt?: IsoDate;
 }
 export type UpdateCampaignInput = Partial<CreateCampaignInput>;
+/**
+ * When to send. An empty object -- or no argument at all -- means now.
+ *
+ * "Now" is not instant: the campaign is armed a short way out (a minute by
+ * default) so there is a window in which `cancel()` still stops it.
+ */
+export interface TriggerCampaignInput {
+    /** ISO-8601 with an offset, e.g. `2026-11-01T04:30:00.000Z`. */
+    scheduledAt?: IsoDate;
+}
 /**
  * Declared as a type alias rather than an interface, and that is load-bearing:
  * only an alias of an object literal gets TypeScript's implicit index signature,

package/dist/types/datastore.d.ts

@@ -1,10 +1,25 @@
 /**
  * Data Store: a customer's own MongoDB, registered with the platform.
  *
+ * A store is one of two things, and `type` says which:
+ *
+ * - **`self`** -- a database **you** own, registered with a credential. The
+ *   platform holds that credential and nothing else: no copy, no mirror, and
+ *   deleting the store never touches your data.
+ * - **`cloud`** -- a database the **platform** provisions for you, on one of its
+ *   clusters, in a location you pick. No credential to manage, nothing to open
+ *   to the internet -- and the platform is then the system of record, so
+ *   deleting the store deletes the records with it.
+ *
+ * Everything else is identical: the same collections, the same records, the same
+ * calls. Pick `cloud` to store data you do not already have somewhere, and
+ * `self` to work with a database you do.
+ *
  * Three nested things:
  *
- * 1. **A data store** -- a connection to a database *you* own. The platform
- *    holds the credential and nothing else: no copy of the data, no mirror.
+ * 1. **A data store** -- the database, yours or ours. For a `self` store the
+ *    platform holds the credential and nothing else: no copy of the data, no
+ *    mirror.
  * 2. **A collection** -- a schema you declare, naming a collection inside that
  *    database and the fields in it.
  * 3. **Records** -- the documents. They live in your database, and every record
@@ -16,6 +31,21 @@
  * guarantee -- a document may carry fields the schema never mentioned, or lack
  * ones it does.
  */
+/** Whose database the records are in. */
+export type DataStoreType = 'self' | 'cloud';
+/**
+ * One cluster the platform can provision a cloud store on.
+ *
+ * `code` identifies the cluster and is what you send on a create; `location` is
+ * the country it is in, which is the half worth showing a user. New locations
+ * appear in this list rather than in a release note -- read it, do not hardcode
+ * it -- and an existing store never moves when one is added, which is why its
+ * `code` is returned on the store itself.
+ */
+export interface CloudDataStoreRegion {
+    code: string;
+    location: string;
+}
 /** The five storage types a field can declare. */
 export type DataStoreFieldType = 'String' | 'Number' | 'Boolean' | 'Date' | 'Array';
 /**
@@ -55,9 +85,32 @@ export type DataStoreCredentials = {
      */
     uri: string;
 };
+/**
+ * Register your own database, or ask for one of the platform's.
+ *
+ * ```ts
+ * // yours
+ * await crm.dataStores.create({ title: 'Orders DB', credentials: { … } });
+ *
+ * // theirs, in Germany
+ * await crm.dataStores.create({ title: 'Leads', type: 'cloud' });
+ * ```
+ *
+ * `type` defaults to `self`, so existing code is unaffected. The two halves do
+ * not mix: a `self` store needs `credentials` and takes no `code`, a `cloud`
+ * store takes a `code` and no credentials, and anything else is a `422`.
+ */
 export interface CreateDataStoreInput {
     title: string;
-    credentials: DataStoreCredentials;
+    /** `self` -- your database. `cloud` -- one of the platform's. Default `self`. */
+    type?: DataStoreType;
+    /** Required for `self`, and refused for `cloud`. */
+    credentials?: DataStoreCredentials;
+    /**
+     * `cloud` only: which cluster to put it on, from
+     * {@link DataStores.regions}. Omitted, the platform picks its default.
+     */
+    code?: string;
 }
 /**
  * Rename, re-point, or both.
@@ -81,12 +134,25 @@ export interface UpdateDataStoreInput {
 export interface DataStore {
     id: string;
     title: string;
-    credentialType: 'field' | 'string';
+    /** Whose database it is. Stores created before cloud stores existed are `self`. */
+    type: DataStoreType;
+    /** `cloud` only: the cluster it is on. Quote it in a support request. */
+    code?: string;
+    /** `cloud` only: where that cluster is -- `Germany`. */
+    location?: string;
+    /** How the credential was given. Absent on a `cloud` store, which has none. */
+    credentialType?: 'field' | 'string';
     engine: 'mongodb';
+    /** Your host. Empty on a `cloud` store: the platform's own is not disclosed. */
     host: string;
     database: string;
+    /** Your database user. Empty on a `cloud` store. */
     username: string;
-    /** The connection string with the password removed, for display. */
+    /**
+     * For display. The connection string with the password removed for a `self`
+     * store, and `cloud://<location>/<database>` for a cloud one -- a label, not
+     * something to connect with.
+     */
     summary: string;
     /** When the connection was last proven to work: a create, an update, or a test. */
     verifiedAt?: string;

package/dist/types/datastore.js

@@ -2,10 +2,25 @@
 /**
  * Data Store: a customer's own MongoDB, registered with the platform.
  *
+ * A store is one of two things, and `type` says which:
+ *
+ * - **`self`** -- a database **you** own, registered with a credential. The
+ *   platform holds that credential and nothing else: no copy, no mirror, and
+ *   deleting the store never touches your data.
+ * - **`cloud`** -- a database the **platform** provisions for you, on one of its
+ *   clusters, in a location you pick. No credential to manage, nothing to open
+ *   to the internet -- and the platform is then the system of record, so
+ *   deleting the store deletes the records with it.
+ *
+ * Everything else is identical: the same collections, the same records, the same
+ * calls. Pick `cloud` to store data you do not already have somewhere, and
+ * `self` to work with a database you do.
+ *
  * Three nested things:
  *
- * 1. **A data store** -- a connection to a database *you* own. The platform
- *    holds the credential and nothing else: no copy of the data, no mirror.
+ * 1. **A data store** -- the database, yours or ours. For a `self` store the
+ *    platform holds the credential and nothing else: no copy of the data, no
+ *    mirror.
  * 2. **A collection** -- a schema you declare, naming a collection inside that
  *    database and the fields in it.
  * 3. **Records** -- the documents. They live in your database, and every record

package/dist/types/datastore.js.map

@@ -1 +1 @@
-{"version":3,"file":"datastore.js","sourceRoot":"","sources":["../../src/types/datastore.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG"}
+{"version":3,"file":"datastore.js","sourceRoot":"","sources":["../../src/types/datastore.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG"}

package/docs/audience/notifications.md

@@ -331,6 +331,17 @@ There is no presence check: an agent with the conversation open on screen still
 gets the push on their phone. That is the behaviour the panel has always had, and
 changing it is a product decision rather than a detail of delivery.
 
+A person is matched under **either of their two ids**. A request carries the
+ecosystem's `psuid`, which is what `subscribe()` files a device under; the inbox
+trigger reads its recipient off a chat row the legacy stack wrote, so the id it
+holds is a legacy one. Registration records both, and the lookup matches the one
+id it is given against either field — so it resolves one person under two
+names, and never returns a colleague's devices.
+
+The practical consequence: a device registered before this existed is still
+reachable by `psuid` exactly as before, and the next `subscribe()` call — which
+the frontend makes on every app load — fills in the second id.
+
 ### Rendering it in a browser
 
 If the payload carries a `notification` block, FCM displays it and opens

package/docs/campaign/campaigns.md

@@ -13,12 +13,50 @@ One message sent to many people.
 | [`createGroup`](#creategroup) | uploads + `POST /v1/campaigns` | **one bucket per channel or template** |
 | [`uploadReceivers`](#uploadreceivers) | upload only | the file half of `createBulk` |
 | [`update`](#update) | `PATCH /v1/campaigns/:id` | before it runs |
-| [`schedule`](#schedule) | `POST /v1/campaigns/:id/schedule` | |
+| [`trigger`](#trigger) | `POST /v1/campaigns/:id/trigger` | **the only call that sends** |
+| [`schedule`](#schedule) | `POST /v1/campaigns/:id/schedule` | `trigger` with a required time |
 | [`cancel`](#cancel) | `POST /v1/campaigns/:id/cancel` | |
 | [`delete`](#delete) | `DELETE /v1/campaigns/:id` | |
 
 ---
 
+## Creating a campaign does not send it
+
+Two steps, always:
+
+```ts
+const campaign = await crm.campaigns.create({ name: 'Diwali offer', messages });
+// nothing has gone out; `campaign.scheduledAt` is undefined
+
+await crm.campaigns.trigger(campaign.id);                              // send now
+await crm.campaigns.trigger(campaign.id, { scheduledAt: isoInstant }); // or at a time
+```
+
+A created campaign is a **draft**: `pending`, with no `scheduledAt` and an empty
+`triggerInfo`. You can `update` it, show it for review, and nothing will send it.
+The sender cannot even see it — a campaign with no `scheduledAt` is not a
+campaign with a moment.
+
+`trigger` is what arms it, and is also what records *who* armed it: the server
+stamps `triggerInfo` (the caller, their ip, the moment) as part of that call.
+That is why a send time is **rejected** on `create` and `update` rather than
+accepted — a campaign that could be armed by a write could go out with nobody
+named against it.
+
+| | `create` / `update` | `trigger` / `schedule` |
+| --- | --- | --- |
+| `scheduledAt` in the body | **`422`** | that is the point |
+| writes `triggerInfo` | no | yes |
+| campaign becomes sendable | no | yes |
+
+**"Now" is not instant.** `trigger` with no time arms the campaign about a minute
+out (`CAMPAIGN_IMMEDIATE_DELAY_SECONDS`), and [`cancel`](#cancel) still stops it
+in that window. A second `trigger` on a campaign that is armed but not yet picked
+up just re-arms it, so a double-click costs a fresh window rather than a second
+send.
+
+---
+
 ## The audience is one field with five modes
 
 A campaign's recipients live in `filters`, and **the mode is decided by the shape
@@ -182,16 +220,18 @@ calls, so what you preview is what gets sent.
 ### Scheduling one
 
 ```ts
-await crm.campaigns.createBulk({
+const { campaign } = await crm.campaigns.createBulk({
   name: 'Renewal reminder',
   audience: { csv, recipientColumn: 'phone' },
   messages: [{ channel: { id: channelId }, message: template }],
-  trigger: 'schedule',
-  scheduledAt: '2026-11-01T04:30:00.000Z',
 });
+
+await crm.campaigns.trigger(campaign.id, { scheduledAt: '2026-11-01T04:30:00.000Z' });
 ```
 
-The file is uploaded immediately; only the send waits.
+The file is uploaded during `createBulk`; the campaign itself does not go out
+until you trigger it. Passing `scheduledAt` to `createBulk` is refused — see
+[creating does not send](#creating-a-campaign-does-not-send-it).
 
 ### Two things to be careful about
 
@@ -385,19 +425,33 @@ const { data, nextCursor } = await crm.campaigns.list({ limit: 50, status: 'comp
 const campaign = await crm.campaigns.get(id);
 ```
 
+### What a campaign's `id` is
+
+The `id` on a campaign is its own identity and the only one this API accepts —
+the same value the campaign manager is handed as `broadcast.id` and stamps on
+every report row as `cid`. So it is what you pass to `get`, `trigger`, `report`,
+and what a re-target filter's `cid` must name.
+
+It is a 24-character ObjectId string, but it is not the document's `_id`: that
+is Mongo's key and never appears in a request or a response. The `nextCursor`
+from [`list`](#list) is a paging position rather than an id — pass it back as a
+cursor, never as a campaign id.
+
 ## `create`
 
 For an audience you have already expressed as `filters` — every contact,
 a segment, or a re-target. For a bulk list use [`createBulk`](#createbulk).
 
+Returns a draft. Call [`trigger`](#trigger) to send it.
+
 | Field | Type | Default |
 | --- | --- | --- |
 | `name` | `string` | required, 1–160 |
 | `messages` | `CampaignMessage[]` | required, at least one |
-| `type` | `string` | `general` |
+| `type` | `string` | `general` — also decides the dispatch pacing, see [below](#trigger) |
 | `campaignType` | `general` `payment` | `general` |
-| `trigger` | `immediate` `schedule` | `immediate` |
-| `scheduledAt` | ISO datetime | required when `trigger` is `schedule` |
+| `trigger` | `immediate` `schedule` | `immediate` — advisory; `trigger()` rewrites it |
+| `scheduledAt` | — | **not accepted**; `422`. Pass it to [`trigger`](#trigger) |
 | `channelType` | `string` | `whatsapp` |
 | `messagingPattern` | `string` | `A2O` |
 | `filters` | `CampaignFilter[]` | `[]` — every contact |
@@ -412,7 +466,49 @@ a segment, or a re-target. For a bulk list use [`createBulk`](#createbulk).
 await crm.campaigns.update(id, { name: 'Diwali offer (revised)' });
 ```
 
-Every `create` field, all optional. Only meaningful before the campaign runs.
+Every `create` field, all optional — `scheduledAt` included, which means it is
+refused here too. Only meaningful while the campaign is `pending`.
+
+## `trigger`
+
+```ts
+await crm.campaigns.trigger(id);                                   // now
+await crm.campaigns.trigger(id, { scheduledAt: '2026-11-01T04:30:00.000Z' });
+```
+
+| | |
+| --- | --- |
+| Route | `POST /v1/campaigns/:id/trigger` |
+| Body | `{}` or `{ scheduledAt }` — ISO-8601 with an offset |
+| Scope | `campaigns:write` |
+| `404` | no such campaign, or not this account's |
+| `409` | the campaign is not `pending` — already sending, sent, failed or cancelled |
+| `409` | `channel_webhook_unset`: a channel cannot report delivery back (see below) |
+
+Writes `trigger`, `scheduledAt` and `triggerInfo`, and nothing else. A past
+`scheduledAt` is accepted and means "now".
+
+**The webhook preflight runs here.** Before the campaign is armed, each v2
+WhatsApp channel's Meta subscription is checked and repaired if it has drifted. A
+channel that still cannot deliver webhooks fails the call with `409
+channel_webhook_unset` and the campaign stays a draft — because that failure is
+otherwise invisible: an unsubscribed channel *sends perfectly* and reports
+nothing, leaving every recipient stuck at `sent` forever.
+
+### How the campaign reaches the sender
+
+Once armed, a poller picks the campaign up when its moment arrives and hands it
+to the sending service. Which route it takes depends on `type`:
+
+| `type` | route |
+| --- | --- |
+| `general` | straight to the sender |
+| anything else (`bulk_campaign`, `group_campaign`, `retarget`, …) | through the account's pacing lane — `<user_id>_user_campaign`, shared with the legacy middleware — which releases one campaign per minute per account |
+
+So an account that arms five bulk campaigns at once has them delivered to the
+sender a minute apart, in the order they were armed, while a general campaign
+goes immediately. This is invisible in the API — the only trace is when the
+report starts filling.
 
 ## `schedule`
 
@@ -420,6 +516,9 @@ Every `create` field, all optional. Only meaningful before the campaign runs.
 await crm.campaigns.schedule(id, '2026-11-01T04:30:00.000Z');
 ```
 
+The same call as `trigger` with a required time. Kept because it is the name the
+panel uses; new code can use either.
+
 ## `cancel`
 
 ```ts

package/docs/data-store.md

@@ -2,9 +2,18 @@
 
 `crm.dataStores`, `crm.dataStoreCollections`, `crm.dataStoreRecords` — `/v1/datastores`
 
-A MongoDB **you** own, registered with the platform. You give it a connection,
-declare the collections and fields you want, and read and write records through
-the API — from a chatbot flow, an automation, or your own code.
+A MongoDB — **yours**, registered with a credential, or **ours**, provisioned
+for you in a location you pick. Either way you declare the collections and
+fields you want and read and write records through the API: from a chatbot flow,
+an automation, or your own code.
+
+```ts
+// your own cluster
+await crm.dataStores.create({ title: 'Orders DB', credentials: { … } });
+
+// or one of ours, no credential to manage
+await crm.dataStores.create({ title: 'Leads', type: 'cloud' });
+```
 
 This runs as **its own service**, with its own database and its own deployment.
 Nothing else in the platform depends on it, and it depends on nothing else: a
@@ -22,12 +31,84 @@ connections it holds to customer clusters cannot crowd out anything but itself.
 Three things, nested:
 
 ```
-data store            a connection to a database you own
+data store            a database — yours by credential, or ours by request
 └── collection        a schema: one collection name, and its fields
-    └── records       the documents, in your database
+    └── records       the documents, in that database
 ```
 
-The platform holds **the credential and the schemas, and nothing else**. There
+## Two kinds of store
+
+`type` on a store says whose database the records are actually in, and it is the
+one decision here with consequences:
+
+| | `self` *(default)* | `cloud` |
+| --- | --- | --- |
+| The database | Yours | Ours, provisioned per store |
+| To create one | A credential, tested before anything is stored | Nothing. Optionally a `code` for the location |
+| Reachability | Your cluster must be reachable from the internet, and usually needs our egress in its IP access list | Nothing to open, nothing to allow |
+| System of record | You. Anything else with the credential writes the same documents | Us. The API is the only door |
+| `remove()` on the store | Forgets the credential. **Your data stays** | **Drops the database.** The records are gone |
+
+Pick `cloud` for data that does not already live somewhere — a form's
+submissions, a chatbot's answers, a lookup table someone maintains in the panel.
+Pick `self` when the data is already in your cluster, or has to stay there.
+
+Everything past this point — collections, records, filters, paging — is
+identical for both.
+
+### Where a cloud store lives
+
+```ts
+const { data: regions } = await crm.dataStores.regions();
+// [{ code: '6869Z798672Z296Z152Z286Z307', location: 'Germany' }]
+
+const store = await crm.dataStores.create({
+  title: 'Leads',
+  type: 'cloud',
+  code: regions[0].code,   // omit it and the platform picks its default
+});
+
+store.location; // 'Germany'
+store.code;     // the cluster it is on — quote it in a support request
+```
+
+Read `regions()` rather than hardcoding a code: locations are added over time,
+and an existing store **never moves** when one is added. That is why the code
+comes back on the store itself, and it is the answer to a data-residency
+question in writing.
+
+An empty `regions()` means this deployment provisions none — an on-premise
+install, typically — and a `type: 'cloud'` create is then a `422`.
+
+Nothing about our cluster is returned on a cloud store: `host` and `username`
+are empty, there is no `credentialType`, and `summary` is a label
+(`cloud://Germany/ds_…`) rather than a connection string. There is no second way
+into those records, by design.
+
+## What `remove()` deletes
+
+Worth stating before anything else, because the opposite assumption is the
+expensive one in both directions:
+
+| Call | What it removes |
+| --- | --- |
+| `dataStores.remove()` on a **`self`** store | The stored credential, and every schema on it. **Your database is untouched.** |
+| `dataStores.remove()` on a **`cloud`** store | The schemas, and **every collection in its database — which destroys the database, irreversibly.** |
+| `dataStoreCollections.remove()` | The schema. The collection and its documents remain, in either kind of store. |
+| `dataStoreRecords.remove()` / `bulkRemove()` | Documents, irreversibly. |
+
+For a `self` store: register the same credential again, declare the same
+collection name, and all of it reads straight back. For a `cloud` store there is
+nothing to re-register — the database was named after that store and a new one
+is empty — so confirm with the user before calling it.
+
+If a collection cannot be deleted, the call is a `502 datastore_purge_failed`
+naming it, and **nothing** has been removed: the store and its schemas are
+intact and the call can be retried once the cause is fixed.
+
+## What the platform holds
+
+For a `self` store, **the credential and the schemas, and nothing else**. There
 is no copy of your data here, no mirror and no sync: a record read is a live
 query against your cluster, and a record write lands in it before the response
 comes back.
@@ -43,19 +124,9 @@ Two consequences worth holding on to:
   TLS handshake each time — but a loop of a thousand single inserts is a
   thousand round trips. Send one `insert` with `records`.
 
-## Deleting never deletes your data
-
-Worth stating before anything else, because the opposite assumption is the
-expensive one:
-
-| Call | What it removes |
-| --- | --- |
-| `dataStores.remove()` | The stored credential, and every schema on it. **Your database is untouched.** |
-| `dataStoreCollections.remove()` | The schema. **Your collection and its documents remain.** |
-| `dataStoreRecords.remove()` / `bulkRemove()` | Documents, from your database, irreversibly. |
-
-Register the same credential again, declare the same collection name, and all of
-it reads straight back. Only the record calls delete anything of yours.
+For a `cloud` store the platform holds the database too, and the first
+consequence does not apply: nothing else can write those documents. The second
+still does — it is a different cluster, not a local one.
 
 ---
 
@@ -140,6 +211,15 @@ order to show which database it is looking at. Host, user and database come back
 in the clear because an edit form has to render them, and none of them opens a
 connection on its own.
 
+A cloud store takes no credentials at all:
+
+```ts
+await crm.dataStores.create({ title: 'Leads', type: 'cloud' });
+```
+
+Sending both is a `422`, as is a `code` on a `self` store: the two halves of the
+body do not mix.
+
 ### Re-pointing one
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ab-ecosystem-cpass",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "JavaScript/TypeScript SDK for the CPaaS CRM gateway: audience and channels",
   "license": "MIT",
   "main": "dist/index.js",