@whooshbang/contracts 3.3.0 → 4.0.0

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

@@ -663,7 +663,7 @@ export type Message = {
  * The effective provider boundary selected for a message. Connection delivery uses the exact authorized environment connection; simulator delivery never calls a provider.
  */
 export type MessageDeliveryTarget = "connection" | "simulator";
-export type MessageState = "accepted" | "dispatch_pending" | "queued" | "sending" | "provider_accepted" | "retry_wait" | "terminal_failed" | "outcome_unknown" | "cancelled" | "expired";
+export type MessageState = "accepted" | "dispatch_pending" | "queued" | "sending" | "intake_pending" | "provider_accepted" | "retry_wait" | "terminal_failed" | "outcome_unknown" | "cancelled" | "expired";
 /**
  * A safe aggregate of delivery attempts. Protected provider responses are excluded.
  */
@@ -1374,7 +1374,7 @@ export type EmailDomainName = string;
 export type EmailDomainLifecycle = "requested" | "creating" | "dns_required" | "verifying" | "testing" | "active" | "provider_action_required" | "dns_failed" | "oauth_required" | "held" | "deleting" | "deleted";
 export type EmailDomainCapabilityState = "pending" | "verified" | "failed" | "unsupported";
 /**
- * One exact neutral DNS record. `name` is preserved exactly as the provider returns it and is relative to the registrable domain (for example `send.notify`, not `send.notify.example.com`).
+ * One exact neutral DNS record. `name` and `value` are preserved exactly as supplied; a record name may be relative to the registrable domain or a full hostname. DNS consoles differ in whether they append the zone automatically.
  */
 export type EmailDnsRecord = {
     type: "MX";
@@ -1398,6 +1398,18 @@ export type EmailDomainGuide = {
      */
     instructions_url?: string;
 };
+/**
+ * Creates or safely adopts an account-owned domain. Omit backend and installation_id for the default FlowXO Mail service. An existing legacy OAuth installation may still be selected by id.
+ */
+export type CreateEmailDomainRequest = {
+    installation_id: OpaqueIdentifier;
+    domain: EmailDomainName;
+    tls?: "opportunistic" | "enforced";
+} | {
+    backend?: "flowxo_mail";
+    domain: EmailDomainName;
+    tls?: "opportunistic" | "enforced";
+};
 /**
  * How consent for this exact subscriber, notifier and connection was established. A customer assertion never becomes recipient-observed verification. Complaint, unsubscribe and suppression override either arm.
  */
@@ -4340,6 +4352,10 @@ export interface ProviderInstallation {
     updated_at: Timestamp;
 }
 export interface EmailDomainCollection {
+    /**
+     * Whether this deployment is configured to offer service-managed custom-domain setup. False is a deployment capability, not a domain readiness verdict.
+     */
+    managed_domain_available?: boolean;
     /**
      * @maxItems 100
      */
@@ -4619,14 +4635,6 @@ export interface EmailSubjectPolicy {
     maximum_code_points: 200;
     normalize_whitespace: true;
 }
-/**
- * Creates or safely adopts one dedicated domain inside an authorized account-owned installation. No provider team id, API key or OAuth credential can be supplied.
- */
-export interface CreateEmailDomainRequest {
-    installation_id: OpaqueIdentifier;
-    domain: EmailDomainName;
-    tls?: "opportunistic" | "enforced";
-}
 /**
  * Creates one durable import scoped by the authenticated organization and the project/environment route. Every row delegates to the ordinary binding operation so imports cannot bypass consent, uniqueness, hold or tenant checks.
  */
@@ -7419,7 +7427,7 @@ export interface MessageDeliveryTimelineEntry {
     at: Timestamp;
     attempt?: number;
     classified_error_code?: ProblemCode;
-    kind: "accepted" | "queued" | "attempt_started" | "attempt_sent" | "attempt_retry_scheduled" | "attempt_could_not_send" | "attempt_outcome_unknown" | "could_not_send" | "outcome_unknown" | "cancelled" | "expired";
+    kind: "accepted" | "queued" | "attempt_started" | "attempt_intake_pending" | "attempt_sent" | "attempt_retry_scheduled" | "attempt_could_not_send" | "attempt_outcome_unknown" | "could_not_send" | "outcome_unknown" | "cancelled" | "expired";
     retry_at?: Timestamp;
 }
 /**

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

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

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

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.0",
   "id": "cancellation-too-late",
   "category": "cancellation",
   "given": {

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.0",
   "id": "project-slug-conflict",
   "category": "idempotency",
   "given": {

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

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.0",
   "id": "interaction-duplicate",
   "category": "interaction_resolution",
   "given": {

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

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

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

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

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

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

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

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.0",
   "id": "quarantine-signature-rejected",
   "category": "quarantine",
   "given": {

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

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

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

@@ -1,5 +1,5 @@
 {
-  "contract_version": "3.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.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.3.0",
+  "contract_version": "4.0.0",
   "id": "subscriber-initial-groups-transaction",
   "category": "subscriber_groups",
   "given": {