@whooshbang/contracts 3.2.0 → 3.3.0

package/dist/generated/whooshbang-v1.d.ts

@@ -4163,11 +4163,16 @@ export interface MessageCategory {
     level: "low" | "normal" | "high" | "critical";
     can_turn_off: boolean;
     is_default: boolean;
-}
-export interface MessageCategoryCollection {
     /**
-     * @maxItems 100
+     * Number of subscribers in this project who currently have this category switched off. Returned when listing a project's categories.
      */
+    opted_out_subscriber_count?: number;
+    /**
+     * An RFC 3339 timestamp with a UTC offset. The server is authoritative.
+     */
+    archived_at?: string;
+}
+export interface MessageCategoryCollection {
     items: MessageCategory[];
     total: ListTotal;
 }
@@ -5808,7 +5813,7 @@ export interface CustomerApplicationManifest {
     diagnostic_id: DiagnosticId;
 }
 /**
- * The project-owned recipient identity, fallback locale, and email answer behavior. Email answers use one click when no setting has been saved.
+ * The project-owned recipient identity, fallback locale, email answer behavior, and category switch visibility. Email answers use one click when no setting has been saved.
  */
 export interface ProjectRecipientExperience {
     project_id: OpaqueIdentifier;
@@ -5818,6 +5823,14 @@ export interface ProjectRecipientExperience {
      * How an email confirm or select button records its bound answer. Defaults to one_click for existing and new projects; free-text answers always use a form.
      */
     email_answer_confirmation?: "one_click" | "confirm";
+    /**
+     * Whether subscriber settings show service category switches. A subscriber who already turned a category off still sees its switch. Defaults to true.
+     */
+    show_service_category_switches: boolean;
+    /**
+     * Whether subscriber settings show marketing category switches. A subscriber who already turned a category off still sees its switch. Defaults to true.
+     */
+    show_marketing_category_switches: boolean;
     row_version: number;
     updated_at: Timestamp;
     diagnostic_id: DiagnosticId;
@@ -5835,15 +5848,23 @@ export interface RecipientBrand {
     color_scheme: "light" | "dark" | "system";
 }
 /**
- * Replaces the project-owned recipient brand and fallback locale under the last observed row version. Omission of email_answer_confirmation preserves its current value, or one_click for an unwritten project.
+ * Updates supplied project recipient settings under the last observed row version. Omitted fields keep their current values or project defaults.
  */
 export interface UpdateProjectRecipientExperienceRequest {
-    default_locale: RecipientLanguage;
-    brand: RecipientBrand;
+    default_locale?: RecipientLanguage;
+    brand?: RecipientBrand;
     /**
      * Optional project-wide email answer behavior. Omission preserves the current value.
      */
     email_answer_confirmation?: "one_click" | "confirm";
+    /**
+     * Show service category switches in subscriber settings. A subscriber who already turned a category off still sees its switch. Omit to keep the current value.
+     */
+    show_service_category_switches?: boolean;
+    /**
+     * Show marketing category switches in subscriber settings. A subscriber who already turned a category off still sees its switch. Omit to keep the current value.
+     */
+    show_marketing_category_switches?: boolean;
     row_version: number;
 }
 /**

package/fixtures/core-v1/fixture-index.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "fixtures": [
     {
       "id": "create-project.request",

package/fixtures/core-v1/scenarios/api-credential-invalid-indistinguishable.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "api-credential-invalid-indistinguishable",
   "category": "credential_lifecycle",
   "given": {

package/fixtures/core-v1/scenarios/api-credential-one-time-reveal.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "api-credential-one-time-reveal",
   "category": "credential_lifecycle",
   "given": {

package/fixtures/core-v1/scenarios/api-credential-revocation-replay.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "api-credential-revocation-replay",
   "category": "credential_lifecycle",
   "given": {

package/fixtures/core-v1/scenarios/api-credential-rotation-overlap.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "api-credential-rotation-overlap",
   "category": "credential_lifecycle",
   "given": {

package/fixtures/core-v1/scenarios/cancellation-too-late.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "cancellation-too-late",
   "category": "cancellation",
   "given": {

package/fixtures/core-v1/scenarios/cross-organization-project.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "cross-organization-project",
   "category": "isolation",
   "given": {

package/fixtures/core-v1/scenarios/cross-project-resource.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "cross-project-resource",
   "category": "isolation",
   "given": {

package/fixtures/core-v1/scenarios/environment-mismatch.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "environment-mismatch",
   "category": "isolation",
   "given": {

package/fixtures/core-v1/scenarios/idempotency-conflict.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "idempotency-conflict",
   "category": "idempotency",
   "given": {

package/fixtures/core-v1/scenarios/idempotency-equivalent-replay.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "idempotency-equivalent-replay",
   "category": "idempotency",
   "given": {

package/fixtures/core-v1/scenarios/malformed-bearer.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "malformed-bearer",
   "category": "isolation",
   "given": {

package/fixtures/core-v1/scenarios/metadata-overrun.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "metadata-overrun",
   "category": "message_outcome",
   "given": {

package/fixtures/core-v1/scenarios/missing-scope.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "missing-scope",
   "category": "isolation",
   "given": {

package/fixtures/core-v1/scenarios/project-create-equivalent-replay.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "project-create-equivalent-replay",
   "category": "idempotency",
   "given": {

package/fixtures/core-v1/scenarios/project-slug-conflict.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "project-slug-conflict",
   "category": "idempotency",
   "given": {

package/fixtures/core-v1/scenarios/provider-outcome-unknown.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "provider-outcome-unknown",
   "category": "message_outcome",
   "given": {

package/fixtures/core-v1/scenarios/subscription-activation-replay.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "subscription-activation-replay",
   "category": "subscription_replay",
   "given": {

package/fixtures/core-v1/scenarios/subscription-authorization-capability-opacity.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "subscription-authorization-capability-opacity",
   "category": "isolation",
   "given": {

package/fixtures/core-v1/scenarios/subscription-cross-connection-callback-rejected.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "subscription-cross-connection-callback-rejected",
   "category": "isolation",
   "given": {

package/fixtures/core-v1/scenarios/subscription-expired-replay.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "subscription-expired-replay",
   "category": "subscription_replay",
   "given": {

package/fixtures/core-v1/scenarios/subscription-selected-connection-replay.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "subscription-selected-connection-replay",
   "category": "subscription_replay",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/ack-conflict.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "ack-conflict",
   "category": "machine_ack",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/ack-cross-machine.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "ack-cross-machine",
   "category": "machine_authorization",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/ack-out-of-order.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "ack-out-of-order",
   "category": "machine_ack",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/ack-replay.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "ack-replay",
   "category": "machine_ack",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/ambiguous-free-text.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "ambiguous-free-text",
   "category": "interaction_resolution",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/callback-token-opacity.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "callback-token-opacity",
   "category": "callback_token",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/credential-registration-conflict.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "credential-registration-conflict",
   "category": "machine_credential",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/credential-registration-replay.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "credential-registration-replay",
   "category": "machine_credential",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/credential-revocation-replay.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "credential-revocation-replay",
   "category": "machine_credential",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/credential-rotation.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "credential-rotation",
   "category": "machine_credential",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/first-credential-activates.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "first-credential-activates",
   "category": "machine_credential",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/interaction-duplicate.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "interaction-duplicate",
   "category": "interaction_resolution",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/interaction-expired.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "interaction-expired",
   "category": "interaction_resolution",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/interaction-mismatch.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "interaction-mismatch",
   "category": "interaction_resolution",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/interaction-retired.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "interaction-retired",
   "category": "interaction_resolution",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/interaction-stale.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "interaction-stale",
   "category": "interaction_resolution",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/machine-admin-denied.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "machine-admin-denied",
   "category": "machine_authorization",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/machine-bound-message-create.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "machine-bound-message-create",
   "category": "machine_authorization",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/machine-cancel-denied.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "machine-cancel-denied",
   "category": "machine_authorization",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/machine-crash-before-ack.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "machine-crash-before-ack",
   "category": "machine_poll",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/machine-notifier-mismatch.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "machine-notifier-mismatch",
   "category": "machine_authorization",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/machine-other-message-read.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "machine-other-message-read",
   "category": "machine_authorization",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/machine-owned-message-read.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "machine-owned-message-read",
   "category": "machine_authorization",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/machine-subscriber-mismatch.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "machine-subscriber-mismatch",
   "category": "machine_authorization",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/poll-uncommitted-cursor-rejected.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "poll-uncommitted-cursor-rejected",
   "category": "machine_poll",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/project-credential-machine-endpoint-denied.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "project-credential-machine-endpoint-denied",
   "category": "machine_authorization",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/quarantine-integrity-rejected.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "quarantine-integrity-rejected",
   "category": "quarantine",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/quarantine-signature-rejected.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "quarantine-signature-rejected",
   "category": "quarantine",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/quarantine-valid.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "quarantine-valid",
   "category": "quarantine",
   "given": {

package/fixtures/interaction-machine-v1/scenarios/revoked-machine-credential.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "revoked-machine-credential",
   "category": "machine_authorization",
   "given": {

package/fixtures/recipient-experience-v1/scenarios/membership-broadcast-snapshot.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "membership-broadcast-snapshot",
   "category": "membership_broadcast",
   "given": {

package/fixtures/recipient-experience-v1/scenarios/preferred-binding-resolution.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "preferred-binding-resolution",
   "category": "preference_resolution",
   "given": {

package/fixtures/recipient-experience-v1/scenarios/recipient-session-security.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "recipient-session-security",
   "category": "recipient_security",
   "given": {

package/fixtures/recipient-experience-v1/scenarios/subscriber-initial-groups-transaction.json

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.2.0",
+  "contract_version": "3.3.0",
   "id": "subscriber-initial-groups-transaction",
   "category": "subscriber_groups",
   "given": {

package/fixtures/recipient-experience-v1/success/project-recipient-experience.json

@@ -7,6 +7,8 @@
     "accent_color": "#4F46E5",
     "color_scheme": "system"
   },
+  "show_service_category_switches": true,
+  "show_marketing_category_switches": true,
   "row_version": 2,
   "updated_at": "2026-08-22T18:00:00Z",
   "diagnostic_id": "diag_n17_project_experience"