@whooshbang/sdk 4.0.1 → 4.2.0

package/README.md

@@ -144,8 +144,11 @@ state, or the link's Problem Details, and never claims provider-side deletion.
 
 ## Awaiting an answer
 
-`awaitInteraction` repeats the polling until the person answers or the
-question ends. Set `patienceMs` to stop waiting sooner:
+Use your configured customer-events webhook to receive answers without keeping
+your app waiting. For a short interactive wait, testing, or a client without a
+webhook receiver, `awaitInteraction` repeats polls until the person answers or
+the question ends. Each poll waits up to 30 seconds, which is also the default.
+Set `patienceMs` to stop the overall wait sooner:
 
 ```ts
 const read = await whooshBang.awaitInteraction(interactionId, {
@@ -202,6 +205,12 @@ same outcomes `createMessage` returns, carrying `problem` and nothing else,
 because no message exists. A request without an interaction is refused locally
 before anything is sent.
 
+While a request waits, it holds one of 1,000 slots shared by all customers.
+If none is available, the API returns `429` with the detail "No long-poll slot
+is available for this request." `awaitInteraction` waits until `retry_at`, then
+retries. For an immediate read, use `getInteraction(id, { wait: 0 })`. It doesn't
+hold a slot.
+
 **The wait retries its reads; the send is never retried.** A read has no side
 effect, so a failed read is re-issued: a transport failure, a `5xx` or `429`
 that arrived without a Problem body (the edge in front of the service during a
@@ -362,6 +371,34 @@ authorize now. Read and write project recipient configuration using
 `projects:read` and `projects:write`; a project credential can configure only
 its own project.
 
+To open the same settings on WhooshBang's hosted page, first create a recipient
+session on your backend and return its `CreateRecipientSessionResponse` to your
+app. The hosted page asks the opener for that response. Send it only after
+checking the ready message's window and origin:
+
+```js
+const hostedOrigin = new URL(session.hosted_url).origin;
+let popup = null;
+function onReady(event) {
+  if (
+    event.source !== popup ||
+    event.origin !== hostedOrigin ||
+    event.data?.type !== "whooshbang.recipient-settings.ready"
+  ) return;
+  window.removeEventListener("message", onReady);
+  popup.postMessage(
+    { type: "whooshbang.recipient-settings.session", session },
+    hostedOrigin,
+  );
+}
+window.addEventListener("message", onReady);
+popup = window.open(session.hosted_url, "_blank");
+if (!popup) window.removeEventListener("message", onReady);
+```
+
+The capability stays in the message, not the address or page markup. The hosted
+page uses the same category switches and channel controls as the embedded panel.
+
 ## Machine clients
 
 `createMachineCredential` generates the C0-03 secret with Web Crypto and
@@ -456,6 +493,10 @@ credit. These ceilings do not schedule an automatic SDK retry.
 | `subscriber_unbound`               | Outcome   | On a send, the person's channel state: they revoked their channel or never finished subscribing, so the branch is to invite them again. It is also the answer when a send names a `connection_id` and the subscriber has no connected channel at all. `createMessage` and `createMessageInEnvironment` return it. `createMachineClient` still throws it: a machine client for an unbound subscriber is setup that is wrong. |
 | `subscriber_not_connected`         | Exception | A send or a connection test named a connection the subscriber has not connected through, while they are connected through another. `problem.subscriber_id` and `problem.channel` say who and where; nothing was sent. Naming the connection was the caller's choice: omit `connection_id` to let the service choose one of their channels, pick a connection they connected through, or invite them through this one.       |
 | `not_consented_for_marketing`      | Exception | A `marketing` send or broadcast reached an email recipient enrolled only on a service basis. Nothing was sent to that recipient and nothing was charged. Send it as `service`, or obtain marketing consent first.                                                                                                                                                                                                           |
+| `category_not_found`               | Exception | The named category is not active in this project. Check its key before sending. |
+| `category_purpose_mismatch`        | Exception | The stated purpose disagrees with the category's purpose. Nothing was sent or charged. |
+| `category_turned_off`              | Exception | The subscriber switched this category off. Nothing was sent or charged. |
+| `category_conflict`                | Exception | A category key is taken, the category is in use, or its settings prevent the requested change. |
 | `recipient_configuration_invalid`  | Exception | The owner's recipient-experience configuration is not usable as submitted or as stored.                                                                                                                                                                                                                                                                                                                                     |
 | `recipient_origin_forbidden`       | Exception | The presenting browser origin is not registered for the session.                                                                                                                                                                                                                                                                                                                                                            |
 | `return_destination_not_found`     | Exception | The return-destination key is not configured.                                                                                                                                                                                                                                                                                                                                                                               |

package/dist/client.d.ts

@@ -2,7 +2,7 @@ import { type WhoAmI, type OperatorCollection, type OperatorResolution, type Cre
 import type { BillingProjectSlots, BillingPromotions, BillingPromotion, RedeemBillingPromotionRequest, AssignBillingProjectSlotsRequest, SubscriptionChange, ConfirmSubscriptionChangeRequest, BillingEntitlements, SubscriptionSelection, ProjectAttribution, UpdateProjectAttributionRequest, AutoTopUpSettings, UpdateAutoTopUpSettingsRequest, BillingAccount, CardSetup, CreateCreditPurchaseRequest, CreditPurchase, BillingInvoiceCollection, UpdateBillingReceiptEmailRequest } from "@whooshbang/contracts";
 import { type AssertEmailConsentRequest, type BindingSummary } from "@whooshbang/contracts";
 import type { InteractionOutcome } from "./interactions.js";
-import type { OrganizationProjection, ApiCredential, OrganizationCredential, OrganizationCredentialCollection, OrganizationCredentialRotation, OrganizationCredentialSecretReveal, ApiCredentialCollection, ApiCredentialRotation, ApiCredentialSecretReveal, AttachNotifierConnectionRequest, ChannelConnection, ChannelConnectionCollection, ConnectionProviderCollection, UsageGrouping, UsageReport, MessageState, MessageListPage, MessageDeliveryHistory, MessageNotificationImage, InteractionTimeline, UpdateEmailSenderRequest, CustomerEventDeliveryHistory, CustomerEventDeliveryAttempt, DeliveryHolds, MachineClientOperationsList, RecipientCopyCatalogue, NotifierConnectionCollection, ProjectRecipientExperience, RecipientBrandLogoUpload, NotificationImageAsset, UpdateProjectRecipientExperienceRequest, EnvironmentRecipientExperience, UpdateEnvironmentRecipientExperienceRequest, SubscriberChannelSettings, AcknowledgeEmailRemediationRequest, CreateRecipientSessionRequest, CreateRecipientSessionResponse, RecipientSession, RecipientSessionCapability, CreateProviderHandoffRequest, ProviderHandoff, SetPreferredBindingRequest, PreferredBinding, CreateSubscriberRequest, Subscriber, SubscriberDataExport, UpdateSubscriberRequest, SubscriberCollection, CloseOrganizationRequest, InviteTeammateRequest, Teammate, TeammateAccessRequest, TeammateCollection, OrganizationClosureResult, CreateSubscriberGroupRequest, UpdateSubscriberGroupRequest, SubscriberGroup, SubscriberGroupCollection, SubscriberGroupMembership, SubscriberGroupMembershipCollection, CreateGroupBroadcastRequest, GroupBroadcast, CreateOrganizationCredentialRequest, CreateApiCredentialRequest, CreateChannelConnectionRequest, CreateCustomerEndpointRequest, CreateMachineClientRequest, CreateMessageRequest, CreateProjectRequest, UpdateProjectRequest, CreateSubscriptionLinkRequest, CustomerEndpoint, CustomerEndpointAttemptCollection, CustomerEndpointCollection, CustomerEndpointMutationResult, InteractionSummary, MachineClient, MachineCredential, MachineEventAckRequest, MachineEventAckResponse, MachineEventPollResponse, Message, Problem, Project, ProjectCollection, RecipientCopyKey, RecipientCopyOverride, RecipientCopyOverrideCollection, RecipientLanguage, ProviderCapabilitiesCollection, ProviderInstallation, ProviderInstallationCollection, EmailDomain, EmailDomainCollection, CreateEmailDomainRequest, RegisterMachineCredentialRequest, RotateOrganizationCredentialRequest, RotateApiCredentialRequest, ConnectionTest, ConnectionTestCollection, CreateConnectionTestRequest, CustomerApplicationManifest, RotateChannelConnectionCredentialRequest, RotateCustomerEndpointRequest, SubscriptionLink, UpdateChannelConnectionRequest, UpdateRecipientCopyOverrideRequest } from "@whooshbang/contracts";
+import type { OrganizationProjection, ApiCredential, OrganizationCredential, OrganizationCredentialCollection, OrganizationCredentialRotation, OrganizationCredentialSecretReveal, ApiCredentialCollection, ApiCredentialRotation, ApiCredentialSecretReveal, AttachNotifierConnectionRequest, ChannelConnection, ChannelConnectionCollection, ConnectionProviderCollection, UsageGrouping, UsageReport, MessageState, MessageListPage, MessageDeliveryHistory, MessageNotificationImage, InteractionTimeline, UpdateEmailSenderRequest, CustomerEventDeliveryHistory, CustomerEventDeliveryAttempt, DeliveryHolds, MachineClientOperationsList, RecipientCopyCatalogue, NotifierConnectionCollection, ProjectRecipientExperience, RecipientBrandLogoUpload, NotificationImageAsset, UpdateProjectRecipientExperienceRequest, EnvironmentRecipientExperience, UpdateEnvironmentRecipientExperienceRequest, SubscriberChannelSettings, AcknowledgeEmailRemediationRequest, CreateRecipientSessionRequest, CreateRecipientSessionResponse, RecipientSession, RecipientSessionCapability, CreateProviderHandoffRequest, ProviderHandoff, SetPreferredBindingRequest, PreferredBinding, CreateSubscriberRequest, Subscriber, SubscriberDataExport, UpdateSubscriberRequest, SubscriberCollection, CloseOrganizationRequest, InviteTeammateRequest, Teammate, TeammateAccessRequest, TeammateCollection, OrganizationClosureResult, CreateSubscriberGroupRequest, UpdateSubscriberGroupRequest, SubscriberGroup, SubscriberGroupCollection, SubscriberGroupMembership, SubscriberGroupMembershipCollection, CreateGroupBroadcastRequest, GroupBroadcast, CreateOrganizationCredentialRequest, CreateApiCredentialRequest, CreateChannelConnectionRequest, CreateCustomerEndpointRequest, CreateMachineClientRequest, CreateMessageRequest, MessageCategory, MessageCategoryCollection, CreateMessageCategoryRequest, UpdateMessageCategoryRequest, SubscriberCategoryPreference, SubscriberCategoryPreferenceCollection, CreateProjectRequest, UpdateProjectRequest, CreateSubscriptionLinkRequest, CustomerEndpoint, CustomerEndpointAttemptCollection, CustomerEndpointCollection, CustomerEndpointMutationResult, InteractionSummary, MachineClient, MachineCredential, MachineEventAckRequest, MachineEventAckResponse, MachineEventPollResponse, Message, Problem, Project, ProjectCollection, RecipientCopyKey, RecipientCopyOverride, RecipientCopyOverrideCollection, RecipientLanguage, ProviderCapabilitiesCollection, ProviderInstallation, ProviderInstallationCollection, EmailDomain, EmailDomainCollection, CreateEmailDomainRequest, RegisterMachineCredentialRequest, RotateOrganizationCredentialRequest, RotateApiCredentialRequest, ConnectionTest, ConnectionTestCollection, CreateConnectionTestRequest, CustomerApplicationManifest, RotateChannelConnectionCredentialRequest, RotateCustomerEndpointRequest, SubscriptionLink, UpdateChannelConnectionRequest, UpdateRecipientCopyOverrideRequest } from "@whooshbang/contracts";
 export type WhooshBangFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
 /**
  * The outcome of one SDK invocation, as reported to an optional logging hook.
@@ -48,7 +48,8 @@ export interface SideEffectRequestOptions extends RequestOptions {
     readonly idempotencyKey?: string | undefined;
 }
 /**
- * Options for the bounded response-inspection reads.
+ * Options for reading a message or interaction, with an optional short wait.
+ * Use your configured customer-events webhook to receive answers without polling.
  *
  * `wait` is the server-held long poll in whole seconds, 0 through 30. Omitting
  * it uses the documented server default of 30. A wait that expires is a
@@ -186,7 +187,9 @@ export type MessageCreation = {
     readonly problem: Problem;
 };
 /**
- * Options for the composed wait, `awaitInteraction`.
+ * Options for `awaitInteraction`, for interactive waits, testing, or clients
+ * without a webhook receiver. Use your configured customer-events webhook
+ * for answers that can take longer.
  *
  * `wait` is one server hold in whole seconds, 0 through 30, defaulting to the
  * documented 30. `patienceMs` bounds the whole wait, 0 through 86400000: when
@@ -194,8 +197,8 @@ export type MessageCreation = {
  * interaction can be awaited again. It is deliberately not `timeoutMs`, which
  * bounds one HTTP call and cannot express a fifteen-minute wait; each read
  * here derives its own `timeoutMs` from `wait`. Without a patience bound the
- * wait ends when the interaction does — one expires server-side within 24
- * hours, and `expired` is terminal.
+ * wait ends when the interaction does. The answer deadline defaults to 24
+ * hours and can be longer.
  */
 export interface AwaitInteractionOptions {
     readonly patienceMs?: number;
@@ -244,6 +247,8 @@ export declare class WhooshBangClient {
     getOperatorBroadcast(projectId: string, environmentId: string, broadcastId: string, options?: RequestOptions): Promise<OperatorBroadcast>;
     getOperatorPreferences(projectId: string, environmentId: string, options?: RequestOptions): Promise<OperatorPreferences>;
     setOperatorPreferredBinding(projectId: string, environmentId: string, request: SetPreferredBindingRequest, options?: RequestOptions): Promise<OperatorPreferences>;
+    /** Resumes one of the signed-in person's own paused channels. */
+    resumeOperatorBinding(projectId: string, environmentId: string, bindingId: string, options?: RequestOptions): Promise<OperatorPreferences>;
     connectOperatorChannel(projectId: string, environmentId: string, request: OperatorConnectRequest, options?: SideEffectRequestOptions): Promise<SubscriptionLink>;
     constructor(options: WhooshBangClientOptions);
     getOrganization(options?: RequestOptions): Promise<OrganizationProjection>;
@@ -307,6 +312,12 @@ export declare class WhooshBangClient {
     uploadRecipientBrandLogo(projectId: string, logo: Blob | Uint8Array, rowVersion: number, options?: RequestOptions): Promise<RecipientBrandLogoUpload>;
     uploadNotificationImageAsset(projectId: string, environmentId: string, image: Blob | Uint8Array, options?: SideEffectRequestOptions): Promise<NotificationImageAsset>;
     deleteNotificationImageAsset(projectId: string, environmentId: string, assetId: string, options?: RequestOptions): Promise<void>;
+    listMessageCategories(projectId: string, options?: RequestOptions): Promise<MessageCategoryCollection>;
+    createMessageCategory(projectId: string, request: CreateMessageCategoryRequest, options?: RequestOptions): Promise<MessageCategory>;
+    updateMessageCategory(projectId: string, key: string, request: UpdateMessageCategoryRequest, options?: RequestOptions): Promise<MessageCategory>;
+    deleteMessageCategory(projectId: string, key: string, options?: RequestOptions): Promise<void>;
+    getOwnCategoryPreferences(projectId: string, environmentId: string, options?: RequestOptions): Promise<SubscriberCategoryPreferenceCollection>;
+    setOwnCategoryPreference(projectId: string, environmentId: string, key: string, enabled: boolean, options?: RequestOptions): Promise<SubscriberCategoryPreference>;
     getEnvironmentRecipientExperience(projectId: string, environmentId: string, options?: RequestOptions): Promise<EnvironmentRecipientExperience>;
     updateEnvironmentRecipientExperience(projectId: string, environmentId: string, request: UpdateEnvironmentRecipientExperienceRequest, options?: RequestOptions): Promise<EnvironmentRecipientExperience>;
     getSubscriberChannelSettings(projectId: string, environmentId: string, subscriberId: string, options?: RequestOptions): Promise<SubscriberChannelSettings>;
@@ -710,6 +721,8 @@ export declare class WhooshBangRecipientSessionClient {
     #private;
     constructor(options: WhooshBangRecipientSessionClientOptions);
     getSession(options?: RequestOptions): Promise<RecipientSession>;
+    getCategoryPreferences(options?: RequestOptions): Promise<SubscriberCategoryPreferenceCollection>;
+    setCategoryPreference(key: string, enabled: boolean, options?: RequestOptions): Promise<SubscriberCategoryPreference>;
     getRecipientBrandLogo(assetId: string, options?: RequestOptions): Promise<Blob>;
     createProviderHandoff(request: CreateProviderHandoffRequest, options?: RequestOptions): Promise<ProviderHandoff>;
     setPreferredBinding(request: SetPreferredBindingRequest, options?: RequestOptions): Promise<PreferredBinding>;

package/dist/client.js

@@ -1,6 +1,6 @@
 import { validateWhoAmI, validateOperatorCollection, validateOperatorResolution, validateCreateOperatorMessageRequest, validateOperatorMessageResult, validateOperatorBroadcast, validateOperatorPreferences, validateOperatorConnectRequest, } from "@whooshbang/contracts";
 import { validateAssertEmailConsentRequest, validateBindingSummary, } from "@whooshbang/contracts";
-import { contractValidationErrors, validateOrganizationCredential, validateOrganizationCredentialCollection, validateOrganizationCredentialRotation, validateOrganizationCredentialSecretReveal, validateBillingProjectSlots, validateBillingPromotions, validateBillingPromotion, validateRedeemBillingPromotionRequest, validateAssignBillingProjectSlotsRequest, validateSubscriptionChange, validateConfirmSubscriptionChangeRequest, validateBillingEntitlements, validateSubscriptionSelection, validateProjectAttribution, validateUpdateProjectAttributionRequest, validateAutoTopUpSettings, validateUpdateAutoTopUpSettingsRequest, validateBillingAccount, validateCardSetup, validateCreateCreditPurchaseRequest, validateCreditPurchase, validateBillingInvoiceCollection, validateUpdateBillingReceiptEmailRequest, validateOrganizationProjection, validateApiCredential, validateApiCredentialCollection, validateApiCredentialRotation, validateApiCredentialSecretReveal, validateAttachNotifierConnectionRequest, validateChannelConnection, validateChannelConnectionCollection, validateConnectionProviderCollection, validateUsageReport, validateMessageListPage, validateMessageDeliveryHistory, validateMessageNotificationImage, validateInteractionTimeline, validateUpdateEmailSenderRequest, validateCustomerEventDeliveryHistory, validateCustomerEventDeliveryAttempt, validateDeliveryHolds, validateMachineClientOperationsList, validateRecipientCopyCatalogue, validateNotifierConnectionCollection, validateProjectRecipientExperience, validateRecipientBrandLogoUpload, validateNotificationImageAsset, validateUpdateProjectRecipientExperienceRequest, validateEnvironmentRecipientExperience, validateUpdateEnvironmentRecipientExperienceRequest, validateSubscriberChannelSettings, validateAcknowledgeEmailRemediationRequest, validateCreateRecipientSessionRequest, validateCreateRecipientSessionResponse, validateRecipientSession, validateCreateProviderHandoffRequest, validateProviderHandoff, validateSetPreferredBindingRequest, validatePreferredBinding, validateCreateSubscriberRequest, validateSubscriber, validateSubscriberDataExport, validateUpdateSubscriberRequest, validateSubscriberCollection, validateCloseOrganizationRequest, validateInviteTeammateRequest, validateTeammate, validateTeammateAccessRequest, validateTeammateCollection, validateOrganizationClosureResult, validateCreateSubscriberGroupRequest, validateUpdateSubscriberGroupRequest, validateSubscriberGroup, validateSubscriberGroupCollection, validateSubscriberGroupMembership, validateSubscriberGroupMembershipCollection, validateCreateGroupBroadcastRequest, validateGroupBroadcast, validateCreateOrganizationCredentialRequest, validateCreateApiCredentialRequest, validateCreateChannelConnectionRequest, validateCreateCustomerEndpointRequest, validateCreateMachineClientRequest, validateCreateMessageRequest, validateCreateProjectRequest, validateUpdateProjectRequest, validateCreateSubscriptionLinkRequest, validateCustomerEndpoint, validateCustomerEndpointAttemptCollection, validateCustomerEndpointCollection, validateCustomerEndpointMutationResult, validateInteractionSummary, validateMachineClient, validateMachineCredential, validateMachineEventAckRequest, validateMachineEventAckResponse, validateMachineEventPollResponse, validateMessage, validateProblem, validateProject, validateProjectCollection, validateRecipientCopyOverride, validateRecipientCopyOverrideCollection, validateProviderCapabilitiesCollection, validateProviderInstallationCollection, validateEmailDomainCollection, validateCreateEmailDomainRequest, validateRegisterMachineCredentialRequest, validateRotateOrganizationCredentialRequest, validateRotateApiCredentialRequest, validateConnectionTest, validateConnectionTestCollection, validateCreateConnectionTestRequest, validateCustomerApplicationManifest, validateRotateChannelConnectionCredentialRequest, validateRotateCustomerEndpointRequest, validateSubscriptionLink, validateUpdateChannelConnectionRequest, validateUpdateRecipientCopyOverrideRequest, } from "@whooshbang/contracts";
+import { contractValidationErrors, validateOrganizationCredential, validateOrganizationCredentialCollection, validateOrganizationCredentialRotation, validateOrganizationCredentialSecretReveal, validateBillingProjectSlots, validateBillingPromotions, validateBillingPromotion, validateRedeemBillingPromotionRequest, validateAssignBillingProjectSlotsRequest, validateSubscriptionChange, validateConfirmSubscriptionChangeRequest, validateBillingEntitlements, validateSubscriptionSelection, validateProjectAttribution, validateUpdateProjectAttributionRequest, validateAutoTopUpSettings, validateUpdateAutoTopUpSettingsRequest, validateBillingAccount, validateCardSetup, validateCreateCreditPurchaseRequest, validateCreditPurchase, validateBillingInvoiceCollection, validateUpdateBillingReceiptEmailRequest, validateOrganizationProjection, validateApiCredential, validateApiCredentialCollection, validateApiCredentialRotation, validateApiCredentialSecretReveal, validateAttachNotifierConnectionRequest, validateChannelConnection, validateChannelConnectionCollection, validateConnectionProviderCollection, validateUsageReport, validateMessageListPage, validateMessageDeliveryHistory, validateMessageNotificationImage, validateInteractionTimeline, validateUpdateEmailSenderRequest, validateCustomerEventDeliveryHistory, validateCustomerEventDeliveryAttempt, validateDeliveryHolds, validateMachineClientOperationsList, validateRecipientCopyCatalogue, validateNotifierConnectionCollection, validateProjectRecipientExperience, validateRecipientBrandLogoUpload, validateNotificationImageAsset, validateUpdateProjectRecipientExperienceRequest, validateEnvironmentRecipientExperience, validateUpdateEnvironmentRecipientExperienceRequest, validateSubscriberChannelSettings, validateAcknowledgeEmailRemediationRequest, validateCreateRecipientSessionRequest, validateCreateRecipientSessionResponse, validateRecipientSession, validateCreateProviderHandoffRequest, validateProviderHandoff, validateSetPreferredBindingRequest, validatePreferredBinding, validateCreateSubscriberRequest, validateSubscriber, validateSubscriberDataExport, validateUpdateSubscriberRequest, validateSubscriberCollection, validateCloseOrganizationRequest, validateInviteTeammateRequest, validateTeammate, validateTeammateAccessRequest, validateTeammateCollection, validateOrganizationClosureResult, validateCreateSubscriberGroupRequest, validateUpdateSubscriberGroupRequest, validateSubscriberGroup, validateSubscriberGroupCollection, validateSubscriberGroupMembership, validateSubscriberGroupMembershipCollection, validateCreateGroupBroadcastRequest, validateGroupBroadcast, validateCreateOrganizationCredentialRequest, validateCreateApiCredentialRequest, validateCreateChannelConnectionRequest, validateCreateCustomerEndpointRequest, validateCreateMachineClientRequest, validateCreateMessageRequest, validateMessageCategory, validateMessageCategoryCollection, validateCreateMessageCategoryRequest, validateUpdateMessageCategoryRequest, validateSubscriberCategoryPreference, validateSubscriberCategoryPreferenceCollection, validateSetSubscriberCategoryPreferenceRequest, validateCreateProjectRequest, validateUpdateProjectRequest, validateCreateSubscriptionLinkRequest, validateCustomerEndpoint, validateCustomerEndpointAttemptCollection, validateCustomerEndpointCollection, validateCustomerEndpointMutationResult, validateInteractionSummary, validateMachineClient, validateMachineCredential, validateMachineEventAckRequest, validateMachineEventAckResponse, validateMachineEventPollResponse, validateMessage, validateProblem, validateProject, validateProjectCollection, validateRecipientCopyOverride, validateRecipientCopyOverrideCollection, validateProviderCapabilitiesCollection, validateProviderInstallationCollection, validateEmailDomainCollection, validateCreateEmailDomainRequest, validateRegisterMachineCredentialRequest, validateRotateOrganizationCredentialRequest, validateRotateApiCredentialRequest, validateConnectionTest, validateConnectionTestCollection, validateCreateConnectionTestRequest, validateCustomerApplicationManifest, validateRotateChannelConnectionCredentialRequest, validateRotateCustomerEndpointRequest, validateSubscriptionLink, validateUpdateChannelConnectionRequest, validateUpdateRecipientCopyOverrideRequest, } from "@whooshbang/contracts";
 import { validateAdditiveCompatible } from "./additive-compatibility.js";
 import { WhooshBangContractError, WhooshBangOutcomeUnknownError, WhooshBangProblemError, WhooshBangProtocolError, WhooshBangTransportError, validationError, } from "./errors.js";
 import { interactionAnswer } from "./interactions.js";
@@ -640,6 +640,19 @@ export class WhooshBangClient {
             body: request,
         });
     }
+    /** Resumes one of the signed-in person's own paused channels. */
+    async resumeOperatorBinding(projectId, environmentId, bindingId, options = {}) {
+        const operation = "resumeOperatorBinding";
+        return this.#request({
+            method: "POST",
+            operation,
+            options,
+            sideEffect: true,
+            path: `${environmentRoot(operation, projectId, environmentId)}/notification-preferences/bindings/${pathSegment(operation, bindingId, "bindingId")}/resume`,
+            validator: validateOperatorPreferences,
+            strictResponse: true,
+        });
+    }
     async connectOperatorChannel(projectId, environmentId, request, options = {}) {
         const operation = "connectOperatorChannel";
         assertInput(operation, request, validateOperatorConnectRequest);
@@ -1346,6 +1359,79 @@ export class WhooshBangClient {
             sideEffect: true,
         });
     }
+    async listMessageCategories(projectId, options = {}) {
+        const operation = "listMessageCategories";
+        return this.#request({
+            method: "GET",
+            operation,
+            options,
+            path: `v1/projects/${pathSegment(operation, projectId, "projectId")}/message-categories`,
+            sideEffect: false,
+            validator: validateMessageCategoryCollection,
+        });
+    }
+    async createMessageCategory(projectId, request, options = {}) {
+        const operation = "createMessageCategory";
+        assertInput(operation, request, validateCreateMessageCategoryRequest);
+        return this.#request({
+            body: request,
+            method: "POST",
+            operation,
+            options,
+            path: `v1/projects/${pathSegment(operation, projectId, "projectId")}/message-categories`,
+            sideEffect: true,
+            validator: validateMessageCategory,
+        });
+    }
+    async updateMessageCategory(projectId, key, request, options = {}) {
+        const operation = "updateMessageCategory";
+        assertInput(operation, request, validateUpdateMessageCategoryRequest);
+        return this.#request({
+            body: request,
+            method: "PUT",
+            operation,
+            options,
+            path: `v1/projects/${pathSegment(operation, projectId, "projectId")}/message-categories/${pathSegment(operation, key, "key")}`,
+            sideEffect: true,
+            validator: validateMessageCategory,
+        });
+    }
+    async deleteMessageCategory(projectId, key, options = {}) {
+        const operation = "deleteMessageCategory";
+        return this.#request({
+            method: "DELETE",
+            operation,
+            options,
+            path: `v1/projects/${pathSegment(operation, projectId, "projectId")}/message-categories/${pathSegment(operation, key, "key")}`,
+            sideEffect: true,
+            noContent: true,
+        });
+    }
+    async getOwnCategoryPreferences(projectId, environmentId, options = {}) {
+        const operation = "getOwnCategoryPreferences";
+        return this.#request({
+            method: "GET",
+            operation,
+            options,
+            path: `${environmentRoot(operation, projectId, environmentId)}/notification-preferences/categories`,
+            sideEffect: false,
+            validator: validateSubscriberCategoryPreferenceCollection,
+        });
+    }
+    async setOwnCategoryPreference(projectId, environmentId, key, enabled, options = {}) {
+        const operation = "setOwnCategoryPreference";
+        const request = { enabled };
+        assertInput(operation, request, validateSetSubscriberCategoryPreferenceRequest);
+        return this.#request({
+            body: request,
+            method: "PUT",
+            operation,
+            options,
+            path: `${environmentRoot(operation, projectId, environmentId)}/notification-preferences/categories/${pathSegment(operation, key, "key")}`,
+            sideEffect: true,
+            validator: validateSubscriberCategoryPreference,
+        });
+    }
     async getEnvironmentRecipientExperience(projectId, environmentId, options = {}) {
         const operation = "getEnvironmentRecipientExperience";
         return this.#request({
@@ -3392,6 +3478,30 @@ export class WhooshBangRecipientSessionClient {
             validator: validateRecipientSession,
         });
     }
+    async getCategoryPreferences(options = {}) {
+        return this.#request({
+            method: "GET",
+            operation: "getCategoryPreferences",
+            options,
+            path: "v1/recipient-session/category-preferences",
+            sideEffect: false,
+            validator: validateSubscriberCategoryPreferenceCollection,
+        });
+    }
+    async setCategoryPreference(key, enabled, options = {}) {
+        const operation = "setCategoryPreference";
+        const request = { enabled };
+        assertInput(operation, request, validateSetSubscriberCategoryPreferenceRequest);
+        return this.#request({
+            body: request,
+            method: "PUT",
+            operation,
+            options,
+            path: `v1/recipient-session/category-preferences/${pathSegment(operation, key, "key")}`,
+            sideEffect: true,
+            validator: validateSubscriberCategoryPreference,
+        });
+    }
     async getRecipientBrandLogo(assetId, options = {}) {
         const operation = "getRecipientBrandLogo";
         if (!/^asset_[0-9a-f]{32}$/u.test(assetId)) {