ab-ecosystem-cpass 0.1.0 → 1.0.0

package/dist/resources/channels/billing.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Billing = void 0;
+const paths_1 = require("../paths");
+const base = (channelId) => `${paths_1.CHANNELS}/${(0, paths_1.seg)(channelId)}/conversations`;
+/**
+ * Conversation billing: what each conversation on a channel cost.
+ *
+ * The endpoint answers in two shapes off one route. Without `stat` it pages
+ * through individual charges; with `stat` it returns aggregates instead, which
+ * is why `list` and `stats` are separate methods here.
+ *
+ * Pass `'all'` as the channel id to read across every channel the caller owns.
+ * `summary` then totals by currency; on a single channel it totals by message
+ * category.
+ */
+class Billing {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * `GET /v1/channels/:channelId/conversations` -- offset paginated, one row
+     * per billed conversation.
+     *
+     * `search` matches the recipient identifier and the provider detail in
+     * `meta`: recipient, category, country and message id. `range` restricts to
+     * a window in unix seconds, where `0` on either end means no bound.
+     * `template`, `country` and `campaign` take arrays and are serialised to
+     * JSON by the SDK.
+     *
+     * `channelId` may be `'all'`.
+     *
+     * Scope: `channels:read`.
+     */
+    list(channelId, query = {}) {
+        return this.http.request('GET', base(channelId), { query });
+    }
+    /**
+     * `GET /v1/channels/:channelId/conversations?stat=...` -- the same filters,
+     * aggregated instead of paged. Returns `{ data, stat }`, where each row is
+     * `{ group, totalRecords, totalDeductionAmount }`.
+     *
+     * `group` is what the totals are cut by: currency for `summary` across all
+     * channels, message category for `summary` on one channel, and the calendar
+     * date for `day_wise`.
+     *
+     * Pagination does not apply -- every group is returned.
+     *
+     * Scope: `channels:read`.
+     */
+    stats(channelId, stat = 'summary', query = {}) {
+        return this.http.request('GET', base(channelId), {
+            query: { ...query, stat },
+        });
+    }
+}
+exports.Billing = Billing;
+//# sourceMappingURL=billing.js.map

package/dist/resources/channels/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../../src/resources/channels/billing.ts"],"names":[],"mappings":";;;AAOA,oCAAyC;AAEzC,MAAM,IAAI,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,GAAG,gBAAQ,IAAI,IAAA,WAAG,EAAC,SAAS,CAAC,gBAAgB,CAAC;AAElF;;;;;;;;;;GAUG;AACH,MAAa,OAAO;IACW;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,SAAiB,EAAE,QAAqD,EAAE;QAC7E,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAwB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CACH,SAAiB,EACjB,OAAkD,SAAS,EAC3D,QAAqD,EAAE;QAEvD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAe,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE;YAC7D,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;CACF;AA3CD,0BA2CC"}

package/dist/resources/channels/channels.d.ts

@@ -0,0 +1,115 @@
+import type { Channel, ChannelActionResult, ChannelGetProp, ChannelPropResponse, ChannelResponse, ChannelSetProp, ListChannelsQuery, Paginated, UpdateChannelDetailsInput } from '../../types';
+import type { HttpClient } from '../../http';
+/** Options for a property write; `raw` switches the body to file bytes. */
+export interface SetPropOptions {
+    /** JSON body. Ignored when `raw` is given. */
+    body?: Record<string, unknown>;
+    /** Query string parameters for the property. */
+    query?: Record<string, unknown>;
+    /** File bytes, for `profile_pic`, `resumable_upload` and `upload_media`. */
+    raw?: BodyInit;
+    /** Media type of `raw`, e.g. `image/jpeg`. Required whenever `raw` is set. */
+    contentType?: string;
+}
+/**
+ * Channels: the connections an account sends and receives on -- a WhatsApp
+ * number, an RCS agent, a webchat widget.
+ *
+ * A channel is provisioned by onboarding, not by this API: there is no create
+ * and no delete. `disable` retires one for good, keeping the row its billing,
+ * wallet and activity history hang off.
+ *
+ * Anything that lives with the provider rather than on the channel document --
+ * the business profile, the QR code, media uploads, number registration --
+ * moves through `getProp` and `setProp`.
+ */
+export declare class Channels {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * `GET /v1/channels` -- offset paginated, newest first. `search` matches the
+     * channel name and its identity (number, handle, address). `type`, `active`
+     * and `status` are quick filters.
+     *
+     * Credentials and the private auth block are stripped from every row.
+     *
+     * Scope: `channels:read`.
+     */
+    list(query?: Partial<ListChannelsQuery>): Promise<Paginated<Channel>>;
+    /**
+     * `GET /v1/channels/:id` -- wrapped as `{ data }`, and **`{ data: {} }`
+     * rather than a 404** when nothing matches. Check for `id` on the payload
+     * before using it.
+     *
+     * Scope: `channels:read`.
+     */
+    get(id: string): Promise<ChannelResponse>;
+    /**
+     * `PUT /v1/channels/:id` -- renames or recolours a channel, and moves its
+     * billing currency. Returns `{ data }` with the updated channel.
+     *
+     * At least one of `name`, `color` or `currency` is required. Currency is the
+     * one field with consequences: it only moves on a WhatsApp channel whose
+     * wallet is empty, because a balance carried across a switch would be worth a
+     * different amount on the other side. Otherwise 409 `wallet_not_empty`.
+     * Asking for the currency the channel already bills in changes nothing.
+     *
+     * Scope: `channels:write`.
+     */
+    updateDetails(id: string, input: UpdateChannelDetailsInput): Promise<ChannelResponse>;
+    /**
+     * `POST /v1/channels/:id/disable` -- retires a channel for good. It stops
+     * delivering, drops out of every listing, and cannot be brought back.
+     *
+     * A negative wallet balance blocks it with 409 `negative_wallet_balance`:
+     * that is money owed that nothing would collect afterwards. A webchat
+     * channel has its widget subscription removed first.
+     *
+     * Scope: `channels:write`.
+     */
+    disable(id: string): Promise<ChannelActionResult>;
+    /**
+     * `DELETE /v1/channels/:id/token` -- issues a new inbound API token and
+     * discards the old one, which stops working immediately.
+     *
+     * The new value is not in the response; read it back with
+     * `getProp(id, 'token')`.
+     *
+     * Scope: `channels:write`.
+     */
+    rotateToken(id: string): Promise<ChannelActionResult>;
+    /**
+     * `GET /v1/channels/:id/:prop` -- reads one provider-side property. Answers
+     * `{ data, prop, channel }`, where `data` follows the property and is
+     * therefore untyped; pass a type argument when you know the shape.
+     *
+     * WhatsApp supports every property. RCS reads only `fetch_channel_queue`,
+     * `recharge_url` and `token`; anything else is 400
+     * `unsupported_channel_prop`, with the supported list in `details`.
+     *
+     * Scope: `channels:read`.
+     */
+    getProp<T = unknown>(id: string, prop: ChannelGetProp, query?: Record<string, unknown>): Promise<ChannelPropResponse<T>>;
+    /**
+     * `POST /v1/channels/:id/:prop` -- writes one provider-side property, or runs
+     * the action it names. Answers the same `{ data, prop, channel }` envelope.
+     *
+     * `profile_pic`, `resumable_upload` and `upload_media` take the file bytes as
+     * the request body: pass them as `raw` with a `contentType`. Every other
+     * property takes JSON in `body`.
+     *
+     * ```ts
+     * await crm.channels.setProp(id, 'business_profile', {
+     *   body: { about: 'We reply in minutes' },
+     * });
+     *
+     * await crm.channels.setProp(id, 'profile_pic', {
+     *   raw: fileBytes,
+     *   contentType: 'image/jpeg',
+     * });
+     * ```
+     *
+     * Scope: `channels:write`.
+     */
+    setProp<T = unknown>(id: string, prop: ChannelSetProp, options?: SetPropOptions): Promise<ChannelPropResponse<T>>;
+}

package/dist/resources/channels/channels.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Channels = void 0;
+const paths_1 = require("../paths");
+/**
+ * Channels: the connections an account sends and receives on -- a WhatsApp
+ * number, an RCS agent, a webchat widget.
+ *
+ * A channel is provisioned by onboarding, not by this API: there is no create
+ * and no delete. `disable` retires one for good, keeping the row its billing,
+ * wallet and activity history hang off.
+ *
+ * Anything that lives with the provider rather than on the channel document --
+ * the business profile, the QR code, media uploads, number registration --
+ * moves through `getProp` and `setProp`.
+ */
+class Channels {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * `GET /v1/channels` -- offset paginated, newest first. `search` matches the
+     * channel name and its identity (number, handle, address). `type`, `active`
+     * and `status` are quick filters.
+     *
+     * Credentials and the private auth block are stripped from every row.
+     *
+     * Scope: `channels:read`.
+     */
+    list(query = {}) {
+        return this.http.request('GET', paths_1.CHANNELS, { query });
+    }
+    /**
+     * `GET /v1/channels/:id` -- wrapped as `{ data }`, and **`{ data: {} }`
+     * rather than a 404** when nothing matches. Check for `id` on the payload
+     * before using it.
+     *
+     * Scope: `channels:read`.
+     */
+    get(id) {
+        return this.http.request('GET', `${paths_1.CHANNELS}/${(0, paths_1.seg)(id)}`);
+    }
+    /**
+     * `PUT /v1/channels/:id` -- renames or recolours a channel, and moves its
+     * billing currency. Returns `{ data }` with the updated channel.
+     *
+     * At least one of `name`, `color` or `currency` is required. Currency is the
+     * one field with consequences: it only moves on a WhatsApp channel whose
+     * wallet is empty, because a balance carried across a switch would be worth a
+     * different amount on the other side. Otherwise 409 `wallet_not_empty`.
+     * Asking for the currency the channel already bills in changes nothing.
+     *
+     * Scope: `channels:write`.
+     */
+    updateDetails(id, input) {
+        return this.http.request('PUT', `${paths_1.CHANNELS}/${(0, paths_1.seg)(id)}`, { body: input });
+    }
+    /**
+     * `POST /v1/channels/:id/disable` -- retires a channel for good. It stops
+     * delivering, drops out of every listing, and cannot be brought back.
+     *
+     * A negative wallet balance blocks it with 409 `negative_wallet_balance`:
+     * that is money owed that nothing would collect afterwards. A webchat
+     * channel has its widget subscription removed first.
+     *
+     * Scope: `channels:write`.
+     */
+    disable(id) {
+        return this.http.request('POST', `${paths_1.CHANNELS}/${(0, paths_1.seg)(id)}/disable`);
+    }
+    /**
+     * `DELETE /v1/channels/:id/token` -- issues a new inbound API token and
+     * discards the old one, which stops working immediately.
+     *
+     * The new value is not in the response; read it back with
+     * `getProp(id, 'token')`.
+     *
+     * Scope: `channels:write`.
+     */
+    rotateToken(id) {
+        return this.http.request('DELETE', `${paths_1.CHANNELS}/${(0, paths_1.seg)(id)}/token`);
+    }
+    /**
+     * `GET /v1/channels/:id/:prop` -- reads one provider-side property. Answers
+     * `{ data, prop, channel }`, where `data` follows the property and is
+     * therefore untyped; pass a type argument when you know the shape.
+     *
+     * WhatsApp supports every property. RCS reads only `fetch_channel_queue`,
+     * `recharge_url` and `token`; anything else is 400
+     * `unsupported_channel_prop`, with the supported list in `details`.
+     *
+     * Scope: `channels:read`.
+     */
+    getProp(id, prop, query = {}) {
+        return this.http.request('GET', `${paths_1.CHANNELS}/${(0, paths_1.seg)(id)}/${(0, paths_1.seg)(prop)}`, { query });
+    }
+    /**
+     * `POST /v1/channels/:id/:prop` -- writes one provider-side property, or runs
+     * the action it names. Answers the same `{ data, prop, channel }` envelope.
+     *
+     * `profile_pic`, `resumable_upload` and `upload_media` take the file bytes as
+     * the request body: pass them as `raw` with a `contentType`. Every other
+     * property takes JSON in `body`.
+     *
+     * ```ts
+     * await crm.channels.setProp(id, 'business_profile', {
+     *   body: { about: 'We reply in minutes' },
+     * });
+     *
+     * await crm.channels.setProp(id, 'profile_pic', {
+     *   raw: fileBytes,
+     *   contentType: 'image/jpeg',
+     * });
+     * ```
+     *
+     * Scope: `channels:write`.
+     */
+    setProp(id, prop, options = {}) {
+        return this.http.request('POST', `${paths_1.CHANNELS}/${(0, paths_1.seg)(id)}/${(0, paths_1.seg)(prop)}`, {
+            body: options.raw ? undefined : (options.body ?? {}),
+            query: options.query,
+            raw: options.raw,
+            contentType: options.contentType,
+        });
+    }
+}
+exports.Channels = Channels;
+//# sourceMappingURL=channels.js.map

package/dist/resources/channels/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../../src/resources/channels/channels.ts"],"names":[],"mappings":";;;AAYA,oCAAyC;AAczC;;;;;;;;;;;GAWG;AACH,MAAa,QAAQ;IACU;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;;;OAQG;IACH,IAAI,CAAC,QAAoC,EAAE;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqB,KAAK,EAAE,gBAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkB,KAAK,EAAE,GAAG,gBAAQ,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAU,EAAE,KAAgC;QACxD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkB,KAAK,EAAE,GAAG,gBAAQ,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAsB,MAAM,EAAE,GAAG,gBAAQ,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAsB,QAAQ,EAAE,GAAG,gBAAQ,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAc,EAAU,EAAE,IAAoB,EAAE,QAAiC,EAAE;QACxF,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACtB,KAAK,EACL,GAAG,gBAAQ,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,IAAI,IAAA,WAAG,EAAC,IAAI,CAAC,EAAE,EACrC,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAc,EAAU,EAAE,IAAoB,EAAE,UAA0B,EAAE;QACjF,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACtB,MAAM,EACN,GAAG,gBAAQ,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,IAAI,IAAA,WAAG,EAAC,IAAI,CAAC,EAAE,EACrC;YACE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;YACpD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CACF,CAAC;IACJ,CAAC;CACF;AA1HD,4BA0HC"}

package/dist/resources/channels/templates.d.ts

@@ -0,0 +1,90 @@
+import type { CreateTemplateInput, ListTemplatesQuery, Paginated, Template, TemplateSyncResult, UpdateTemplateInput } from '../../types';
+import type { HttpClient } from '../../http';
+/**
+ * WhatsApp message templates, per channel.
+ *
+ * A template is local until it is submitted to Meta: create it as a `draft`,
+ * or pass `applyForApproval: true` to send it straight on, at which point it
+ * becomes `pending` and Meta decides. `sync` pulls Meta's current view back
+ * over ours, which is how approvals and rejections arrive without waiting on a
+ * webhook.
+ *
+ * Every method takes the channel id first; a template id belonging to another
+ * channel is a 404 rather than a match.
+ */
+export declare class Templates {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * `GET /v1/channels/:channelId/templates` -- offset paginated. `search`
+     * matches the template name and sub-category; `status`, `category`,
+     * `parameterFormat` and `language` are quick filters.
+     *
+     * Scope: `channels:read`.
+     */
+    list(channelId: string, query?: Partial<ListTemplatesQuery>): Promise<Paginated<Template>>;
+    /**
+     * `GET /v1/channels/:channelId/templates/:id`.
+     *
+     * Scope: `channels:read`.
+     */
+    get(channelId: string, id: string): Promise<Template>;
+    /**
+     * `POST /v1/channels/:channelId/templates` -- 201 with the created template.
+     *
+     * `name` must be lowercase letters, digits and underscores -- Meta's own
+     * rule. A template is identified within a channel by name plus language, so
+     * the same name in two languages is two templates, and re-using a pair that
+     * already exists is 409 `conflict`.
+     *
+     * With `applyForApproval: false` (the default) nothing leaves the platform
+     * and the row is a `draft`. With `true`, the template goes to Meta first and
+     * the row is only written if Meta accepts it, at `status: 'pending'`; a
+     * rejection surfaces as 400 with Meta's reason and leaves nothing behind.
+     *
+     * Scope: `channels:write`.
+     */
+    create(channelId: string, input: CreateTemplateInput): Promise<Template>;
+    /**
+     * `PATCH /v1/channels/:channelId/templates/:id` -- a partial update; at least
+     * one field is required.
+     *
+     * What may change depends on where the template is. A `draft` is fully
+     * editable. Once it is with Meta its identity is fixed, and `name`,
+     * `language`, `category`, `subCategory`, `parameterFormat`, `source` and
+     * `adDetails` are ignored -- only `components`, `payload` and `extra` still
+     * move.
+     *
+     * Nothing is sent to Meta unless you ask for it: pass `applyForApproval:
+     * true`, or a `status` other than `'draft'`. A draft is then submitted, and
+     * a template already at Meta is updated in place; either way the row comes
+     * back `pending`. A non-draft with no Meta id is 409
+     * `template_not_submitted`.
+     *
+     * Scope: `channels:write`.
+     */
+    update(channelId: string, id: string, input: UpdateTemplateInput): Promise<Template>;
+    /**
+     * `DELETE /v1/channels/:channelId/templates/:id` -- 204, no body.
+     *
+     * A `draft` only exists here and is simply removed. Anything submitted is
+     * deleted at Meta first, so no row is kept for a template the WABA no longer
+     * has; if Meta refuses, the call fails with 400 `template_deletion_failed`
+     * and the row stays.
+     *
+     * Scope: `channels:write`.
+     */
+    delete(channelId: string, id: string): Promise<void>;
+    /**
+     * `POST /v1/channels/:channelId/templates/sync` -- pulls the channel's
+     * templates from Meta and writes their current state over ours. Returns
+     * counts: `{ fetched, created, updated, skipped }`.
+     *
+     * `skipped` is templates Meta returned that are not storable here, such as
+     * one in a category this platform does not model. Note the path: `sync` is a
+     * sibling of `:id`, not a child of it.
+     *
+     * Scope: `channels:write`.
+     */
+    sync(channelId: string): Promise<TemplateSyncResult>;
+}

package/dist/resources/channels/templates.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Templates = void 0;
+const paths_1 = require("../paths");
+const base = (channelId) => `${paths_1.CHANNELS}/${(0, paths_1.seg)(channelId)}/templates`;
+/**
+ * WhatsApp message templates, per channel.
+ *
+ * A template is local until it is submitted to Meta: create it as a `draft`,
+ * or pass `applyForApproval: true` to send it straight on, at which point it
+ * becomes `pending` and Meta decides. `sync` pulls Meta's current view back
+ * over ours, which is how approvals and rejections arrive without waiting on a
+ * webhook.
+ *
+ * Every method takes the channel id first; a template id belonging to another
+ * channel is a 404 rather than a match.
+ */
+class Templates {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * `GET /v1/channels/:channelId/templates` -- offset paginated. `search`
+     * matches the template name and sub-category; `status`, `category`,
+     * `parameterFormat` and `language` are quick filters.
+     *
+     * Scope: `channels:read`.
+     */
+    list(channelId, query = {}) {
+        return this.http.request('GET', base(channelId), { query });
+    }
+    /**
+     * `GET /v1/channels/:channelId/templates/:id`.
+     *
+     * Scope: `channels:read`.
+     */
+    get(channelId, id) {
+        return this.http.request('GET', `${base(channelId)}/${(0, paths_1.seg)(id)}`);
+    }
+    /**
+     * `POST /v1/channels/:channelId/templates` -- 201 with the created template.
+     *
+     * `name` must be lowercase letters, digits and underscores -- Meta's own
+     * rule. A template is identified within a channel by name plus language, so
+     * the same name in two languages is two templates, and re-using a pair that
+     * already exists is 409 `conflict`.
+     *
+     * With `applyForApproval: false` (the default) nothing leaves the platform
+     * and the row is a `draft`. With `true`, the template goes to Meta first and
+     * the row is only written if Meta accepts it, at `status: 'pending'`; a
+     * rejection surfaces as 400 with Meta's reason and leaves nothing behind.
+     *
+     * Scope: `channels:write`.
+     */
+    create(channelId, input) {
+        return this.http.request('POST', base(channelId), { body: input });
+    }
+    /**
+     * `PATCH /v1/channels/:channelId/templates/:id` -- a partial update; at least
+     * one field is required.
+     *
+     * What may change depends on where the template is. A `draft` is fully
+     * editable. Once it is with Meta its identity is fixed, and `name`,
+     * `language`, `category`, `subCategory`, `parameterFormat`, `source` and
+     * `adDetails` are ignored -- only `components`, `payload` and `extra` still
+     * move.
+     *
+     * Nothing is sent to Meta unless you ask for it: pass `applyForApproval:
+     * true`, or a `status` other than `'draft'`. A draft is then submitted, and
+     * a template already at Meta is updated in place; either way the row comes
+     * back `pending`. A non-draft with no Meta id is 409
+     * `template_not_submitted`.
+     *
+     * Scope: `channels:write`.
+     */
+    update(channelId, id, input) {
+        return this.http.request('PATCH', `${base(channelId)}/${(0, paths_1.seg)(id)}`, { body: input });
+    }
+    /**
+     * `DELETE /v1/channels/:channelId/templates/:id` -- 204, no body.
+     *
+     * A `draft` only exists here and is simply removed. Anything submitted is
+     * deleted at Meta first, so no row is kept for a template the WABA no longer
+     * has; if Meta refuses, the call fails with 400 `template_deletion_failed`
+     * and the row stays.
+     *
+     * Scope: `channels:write`.
+     */
+    delete(channelId, id) {
+        return this.http.request('DELETE', `${base(channelId)}/${(0, paths_1.seg)(id)}`);
+    }
+    /**
+     * `POST /v1/channels/:channelId/templates/sync` -- pulls the channel's
+     * templates from Meta and writes their current state over ours. Returns
+     * counts: `{ fetched, created, updated, skipped }`.
+     *
+     * `skipped` is templates Meta returned that are not storable here, such as
+     * one in a category this platform does not model. Note the path: `sync` is a
+     * sibling of `:id`, not a child of it.
+     *
+     * Scope: `channels:write`.
+     */
+    sync(channelId) {
+        return this.http.request('POST', `${base(channelId)}/sync`);
+    }
+}
+exports.Templates = Templates;
+//# sourceMappingURL=templates.js.map

package/dist/resources/channels/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/resources/channels/templates.ts"],"names":[],"mappings":";;;AASA,oCAAyC;AAEzC,MAAM,IAAI,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,GAAG,gBAAQ,IAAI,IAAA,WAAG,EAAC,SAAS,CAAC,YAAY,CAAC;AAE9E;;;;;;;;;;;GAWG;AACH,MAAa,SAAS;IACS;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;OAMG;IACH,IAAI,CAAC,SAAiB,EAAE,QAAqC,EAAE;QAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAsB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,SAAiB,EAAE,EAAU;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAW,KAAK,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,SAAiB,EAAE,KAA0B;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAW,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,SAAiB,EAAE,EAAU,EAAE,KAA0B;QAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAW,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAiB,EAAE,EAAU;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAO,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,IAAA,WAAG,EAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CAAC,SAAiB;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAClF,CAAC;CACF;AA5FD,8BA4FC"}

package/dist/resources/channels/wallet.d.ts

@@ -0,0 +1,25 @@
+import type { ListWalletLogsQuery, Paginated, WalletLog } from '../../types';
+import type { HttpClient } from '../../http';
+/**
+ * Channel wallet ledger: every credit and debit against a channel's balance,
+ * with the balance before and after each movement.
+ *
+ * Read-only. Money moves through top-ups and through conversation billing, not
+ * through this API. Amounts here are the raw stored values -- ten-thousandths
+ * of a currency unit -- unlike `channel.wallet.balance`, which is already
+ * divided down for display.
+ */
+export declare class Wallet {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * `GET /v1/channels/:channelId/wallet` -- offset paginated, newest first.
+     *
+     * `search` matches the note, the category and the status. `type` narrows to
+     * credits or debits; `range` restricts to a window in unix seconds, where
+     * `0` on either end means no bound.
+     *
+     * Scope: `channels:read`.
+     */
+    list(channelId: string, query?: Partial<ListWalletLogsQuery>): Promise<Paginated<WalletLog>>;
+}

package/dist/resources/channels/wallet.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Wallet = void 0;
+const paths_1 = require("../paths");
+const base = (channelId) => `${paths_1.CHANNELS}/${(0, paths_1.seg)(channelId)}/wallet`;
+/**
+ * Channel wallet ledger: every credit and debit against a channel's balance,
+ * with the balance before and after each movement.
+ *
+ * Read-only. Money moves through top-ups and through conversation billing, not
+ * through this API. Amounts here are the raw stored values -- ten-thousandths
+ * of a currency unit -- unlike `channel.wallet.balance`, which is already
+ * divided down for display.
+ */
+class Wallet {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * `GET /v1/channels/:channelId/wallet` -- offset paginated, newest first.
+     *
+     * `search` matches the note, the category and the status. `type` narrows to
+     * credits or debits; `range` restricts to a window in unix seconds, where
+     * `0` on either end means no bound.
+     *
+     * Scope: `channels:read`.
+     */
+    list(channelId, query = {}) {
+        return this.http.request('GET', base(channelId), { query });
+    }
+}
+exports.Wallet = Wallet;
+//# sourceMappingURL=wallet.js.map

package/dist/resources/channels/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../../src/resources/channels/wallet.ts"],"names":[],"mappings":";;;AAEA,oCAAyC;AAEzC,MAAM,IAAI,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,GAAG,gBAAQ,IAAI,IAAA,WAAG,EAAC,SAAS,CAAC,SAAS,CAAC;AAE3E;;;;;;;;GAQG;AACH,MAAa,MAAM;IACY;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;;;OAQG;IACH,IAAI,CAAC,SAAiB,EAAE,QAAsC,EAAE;QAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACpF,CAAC;CACF;AAfD,wBAeC"}

package/dist/resources/channels/webhooks.d.ts

@@ -0,0 +1,60 @@
+import type { ChannelWebhook, CreateChannelWebhookInput, ListChannelWebhooksQuery, Paginated, UpdateChannelWebhookInput } from '../../types';
+import type { HttpClient } from '../../http';
+/**
+ * Channel webhooks: where a channel's message traffic is delivered.
+ *
+ * These carry conversation events -- `incoming`, `sent`, `delivered`, `read`,
+ * `failed` -- plus the account-level notices Meta sends about templates, the
+ * phone number and the WABA. Distinct from `crm.webhooks`, which carries
+ * contact changes from the audience module.
+ *
+ * Each webhook subscribes to a set of events; several webhooks may watch the
+ * same channel, and each gets its own copy.
+ *
+ * `meta` on a stored webhook is an audit trail -- who created or last changed
+ * it and from where -- filled in by the service from the caller's identity and
+ * IP. It is never accepted on a write.
+ */
+export declare class ChannelWebhooks {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * `GET /v1/channels/:channelId/webhooks` -- offset paginated. `search`
+     * matches the title and the URL; `active` and `event` are quick filters,
+     * where `event` finds the webhooks subscribed to that one event.
+     *
+     * Scope: `channels:read`.
+     */
+    list(channelId: string, query?: Partial<ListChannelWebhooksQuery>): Promise<Paginated<ChannelWebhook>>;
+    /**
+     * `GET /v1/channels/:channelId/webhooks/:id`.
+     *
+     * Scope: `channels:read`.
+     */
+    get(channelId: string, id: string): Promise<ChannelWebhook>;
+    /**
+     * `POST /v1/channels/:channelId/webhooks` -- 201 with the created webhook.
+     *
+     * Only `url` and `events` are required; the title defaults to
+     * `'CRM Channel Webhook'` and the webhook starts active. Webhooks created
+     * through the API are recorded with `meta.source: 'API'`.
+     *
+     * Scope: `channels:write`.
+     */
+    create(channelId: string, input: CreateChannelWebhookInput): Promise<ChannelWebhook>;
+    /**
+     * `PATCH /v1/channels/:channelId/webhooks/:id` -- a partial update; at least
+     * one field is required. `events` replaces the subscription list rather than
+     * adding to it. Pause delivery with `{ active: false }`.
+     *
+     * Scope: `channels:write`.
+     */
+    update(channelId: string, id: string, input: UpdateChannelWebhookInput): Promise<ChannelWebhook>;
+    /**
+     * `DELETE /v1/channels/:channelId/webhooks/:id` -- 204. Delivery stops
+     * immediately.
+     *
+     * Scope: `channels:write`.
+     */
+    delete(channelId: string, id: string): Promise<void>;
+}