@whooshbang/sdk 4.1.0 → 4.3.0

package/README.md

@@ -371,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
@@ -465,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.
@@ -82,11 +82,17 @@ export interface ListPageOptions extends RequestOptions {
 }
 export type ListProjectsOptions = ListPageOptions;
 export interface ListMessagesOptions extends ListPageOptions {
+    readonly q?: string;
     readonly connectionId?: string;
     readonly acceptedAfter?: string;
     readonly acceptedBefore?: string;
     readonly states?: readonly MessageState[];
     readonly subscriberId?: string;
+    readonly categoryKey?: string;
+    readonly noCategory?: boolean;
+}
+export interface ListMessageCategoriesOptions extends RequestOptions {
+    readonly includeArchived?: boolean;
 }
 export interface RecipientCopyCatalogueOptions extends RequestOptions {
     readonly language?: RecipientLanguage;
@@ -312,6 +318,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?: ListMessageCategoriesOptions): 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>;
@@ -499,8 +511,8 @@ export declare class WhooshBangClient {
     disableCustomerEndpoint(projectId: string, environmentId: string, endpointId: string, options?: RequestOptions): Promise<CustomerEndpoint>;
     listCustomerEndpointAttempts(projectId: string, environmentId: string, endpointId: string, options?: ListPageOptions): Promise<CustomerEndpointAttemptCollection>;
     /**
-     * An environment's content-free message history, with connection, subscriber,
-     * state and acceptance-time filters and bounded cursor or numbered pages.
+     * An environment's message history, with retained-text or exact-ID search,
+     * connection, subscriber, state and acceptance-time filters and bounded pages.
      */
     listMessagesInEnvironment(projectId: string, environmentId: string, options?: ListMessagesOptions): Promise<MessageListPage>;
     getMessageDeliveryHistory(projectId: string, environmentId: string, messageId: string, options?: RequestOptions): Promise<MessageDeliveryHistory>;
@@ -715,6 +727,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";
@@ -1359,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${options.includeArchived === undefined ? "" : `?include_archived=${options.includeArchived}`}`,
+            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({
@@ -2259,22 +2332,26 @@ export class WhooshBangClient {
         });
     }
     /**
-     * An environment's content-free message history, with connection, subscriber,
-     * state and acceptance-time filters and bounded cursor or numbered pages.
+     * An environment's message history, with retained-text or exact-ID search,
+     * connection, subscriber, state and acceptance-time filters and bounded pages.
      */
     async listMessagesInEnvironment(projectId, environmentId, options = {}) {
         const operation = "listMessagesInEnvironment";
         const search = new URLSearchParams(listPageQuery(operation, options, "message").slice(1));
         for (const [name, value] of [
+            ["q", options.q],
             ["connection_id", options.connectionId],
             ["accepted_after", options.acceptedAfter],
             ["accepted_before", options.acceptedBefore],
             ["subscriber_id", options.subscriberId],
+            ["category_key", options.categoryKey],
         ])
             if (value !== undefined)
                 search.set(name, value);
         if (options.states !== undefined)
             search.set("state", options.states.join(","));
+        if (options.noCategory !== undefined)
+            search.set("no_category", String(options.noCategory));
         return this.#request({
             method: "GET",
             operation,
@@ -3405,6 +3482,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)) {