samva 0.4.0 → 0.5.0

package/dist/client/types.gen.d.ts

@@ -1,5 +1,5 @@
 export type ClientOptions = {
-    baseUrl: `${string}://${string}` | (string & {});
+    baseUrl: "https://api.samva.dev" | (string & {});
 };
 export type ConversationId = string;
 export type ContactId = string;
@@ -64,6 +64,11 @@ export type Message = {
         contact: MessageContact | null;
     }>;
     deliveries: Array<{
+        scheduling: {
+            dueAt: string;
+            expiresAt: string;
+            waitReason: "rate" | "daily-quota" | "domain-health" | "tenant-health" | "provider-unavailable" | "retry" | "campaign-paused" | "domain-warming" | "onboarding-review" | null;
+        } | null;
         id: string;
         messageId: string;
         recipientId: string | null;
@@ -270,6 +275,15 @@ export type ValidationError = {
         [key: string]: Array<string>;
     } | null | undefined;
 };
+export type OnboardingReviewRequiredError = {
+    _tag: "OnboardingReviewRequiredError";
+    operation: string;
+    code: "review_required" | "review_in_progress" | "information_required" | "review_rejected" | "identity_review_required" | "identity_review_rejected" | "identity_changed";
+    decision: "undecided" | "approved" | "rejected" | "exempt";
+    stage: "collecting" | "automated_review" | "manual_review" | "information_requested" | "complete";
+    nextAction: "wait_for_review" | "provide_information" | "verify_sending_identity" | "reapply" | "contact_support";
+    identityId?: string | null | undefined;
+};
 export type FlagDisabledError = {
     _tag: "FlagDisabledError";
     operation: string;
@@ -281,6 +295,20 @@ export type WebhookEnqueueError = {
     reason: string;
     details?: string | null | undefined;
 };
+export type ValidateEmailResponse = {
+    valid: true;
+    from: {
+        email: string;
+        name: string | null;
+    };
+    recipientCount: number;
+    content: {
+        source: "inline" | "template";
+        subject: string;
+        hasHtml: boolean;
+        hasText: boolean;
+    };
+};
 export type MessageEventId = string;
 export type OperationId = string;
 export type OperationResource = {
@@ -345,10 +373,11 @@ export type EmailDispatchSendMessagePayload = {
     email: EmailDispatchContent;
 };
 export type DispatchSendMessagePayload = EmailDispatchSendMessagePayload;
+export type IanaTimezone = string;
 export type ScheduledMessageId = string;
 export type ScheduledMessage = {
     id: ScheduledMessageId;
-    status: "pending" | "dispatching" | "dispatched" | "cancelled" | "failed";
+    status: "pending" | "dispatching" | "paused" | "dispatched" | "cancelled" | "failed";
     scheduledFor: string;
     timezone: string;
     send: SendMessagePayload;
@@ -423,6 +452,7 @@ export type Campaign = {
     createdAt: string;
     updatedAt: string;
 };
+export type EmailDomainId = string;
 export type CampaignRun = {
     id: CampaignRunId;
     campaignId: CampaignId;
@@ -439,6 +469,8 @@ export type CampaignRun = {
     failedCount: number;
     skippedCount: number;
     failureReason: string | null;
+    holdReason: string | null;
+    holdDomainId: EmailDomainId | null;
     lastContactId: string | null;
     createdBy: string | null;
     actorEmail: string;
@@ -451,6 +483,39 @@ export type CampaignRunAction = {
     item: CampaignRun;
 };
 export type CampaignRecipientId = string;
+export type IdentityClearanceStatus = {
+    identityId: string;
+    decision: "undecided" | "approved" | "rejected";
+    generation: number;
+    code: "review_required" | "review_in_progress" | "information_required" | "review_rejected" | "identity_review_required" | "identity_review_rejected" | "identity_changed" | null;
+    nextAction: "wait_for_review" | "provide_information" | "verify_sending_identity" | "reapply" | "contact_support" | null;
+    updatedAt: string;
+};
+export type OnboardingReviewStatus = {
+    decision: "undecided" | "approved" | "rejected" | "exempt";
+    stage: "collecting" | "automated_review" | "manual_review" | "information_requested" | "complete";
+    generation: number;
+    canSend: boolean;
+    code: "review_required" | "review_in_progress" | "information_required" | "review_rejected" | "identity_review_required" | "identity_review_rejected" | "identity_changed" | null;
+    nextAction: "wait_for_review" | "provide_information" | "verify_sending_identity" | "reapply" | "contact_support" | null;
+    canReapply: boolean;
+    informationRequest: {
+        id: string;
+        requestedFields: Array<string>;
+        requestedAt: string;
+        canRespond: boolean;
+    } | null;
+    identities: Array<IdentityClearanceStatus>;
+    updatedAt: string | null;
+};
+export type ReapplyOnboardingReviewInput = {
+    expectedGeneration: number;
+};
+export type RespondToOnboardingInformationRequestInput = {
+    expectedGeneration: number;
+    responseText: string;
+    evidenceMediaIds: Array<MediaId>;
+};
 export type EmailTrackingDefaults = {
     opens: boolean;
     clicks: boolean;
@@ -463,7 +528,6 @@ export type EmailRecipientTrackingPreference = {
     createdAt: string | null;
     updatedAt: string | null;
 };
-export type EmailDomainId = string;
 export type EmailSenderId = string;
 export type DeliverabilityFacts = {
     bounceRate: number;
@@ -498,6 +562,27 @@ export type EmailChannelError = {
     message: string;
     statusCode?: number | null | undefined;
 };
+export type EmailDkimRotation = {
+    id: string;
+    domainId: EmailDomainId;
+    phase: "staged" | "cutover" | "complete";
+    selector: string;
+    record: {
+        name: string;
+        type: "TXT";
+        value: string;
+        ttl: string;
+    };
+    formerRecord: {
+        name: string;
+        type: "TXT";
+        value: string;
+    };
+    /**
+     * Earliest minimum retention horizon only. The former public key remains published indefinitely until a separately approved retirement verifies at least two actual former-record TTLs have elapsed.
+     */
+    minimumRetainUntil: string | null;
+};
 export type EmailDomainVerification = {
     domainId: EmailDomainId;
     domain: string;
@@ -532,6 +617,40 @@ export type EmailDomainVerification = {
         message: string;
         failedAt: string;
     } | null;
+    health: {
+        actionOwner: "customer" | "samva" | "provider" | "none";
+        action: string;
+        freshness: "current" | "stale" | "unknown";
+        observedAt: string | null;
+        staleAt: string | null;
+        nextRetryAt: string | null;
+        reason: "ready" | "dns-action-required" | "dns-unavailable" | "provider-pending" | "provider-failed" | "samva-repair" | "signing-custody-action-required" | "provider-ownership-action-required" | "inactive" | "observation-stale" | "observation-unknown";
+    };
+    /**
+     * Stored domain, tenant and workspace health. Ready does not guarantee send acceptance or report configuration-set/account pauses.
+     */
+    sending: {
+        actionOwner: "customer" | "samva" | "provider" | "none";
+        action: string;
+        freshness: "current" | "stale" | "unknown";
+        observedAt: string | null;
+        staleAt: string | null;
+        nextRetryAt: string | null;
+        status: "ready" | "blocked" | "unknown";
+        reason: "domain-not-ready" | "domain-observation-stale" | "operator-paused" | "provider-paused" | "tenant-health-stale" | "tenant-health-unknown" | "ready";
+    };
+    dmarc: {
+        status: "valid" | "missing" | "invalid" | "multiple" | "unknown";
+        source: "direct" | "organizational" | "none";
+        policyDomain: string | null;
+        policy: "none" | "quarantine" | "reject" | null;
+        subdomainPolicy: "none" | "quarantine" | "reject" | null;
+        effectivePolicy: "none" | "quarantine" | "reject" | null;
+        observedAt: string | null;
+        staleAt: string | null;
+        guidance: string;
+    };
+    rotation: EmailDkimRotation | null;
 };
 export type DomainConnectEligibility = {
     eligible: false;
@@ -597,11 +716,99 @@ export type ForwardingConditions = {
     hasAttachments?: boolean | null | undefined;
 };
 export type EmailForwardingRuleId = string;
+export type DomainWarmingDomainRef = {
+    id: EmailDomainId;
+    domain: string;
+};
+export type EmailDomainWarmingPlanId = string;
+export type DomainWarmingPlan = {
+    id: EmailDomainWarmingPlanId;
+    status: "active" | "paused" | "completed";
+    identity: "new" | "migrating" | "returning";
+    initialDailyRecipients: number;
+    dailyGrowthPercent: number;
+    targetDailyRecipients: number;
+    holdReason: string | null;
+    heldAt: string | null;
+    pausedAt: string | null;
+    completedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type EmailDomainWarmingBatchId = string;
+export type DomainWarmingBatch = {
+    id: EmailDomainWarmingBatchId;
+    sequence: number;
+    state: "scheduled" | "open" | "closed" | "cancelled";
+    startsAt: string;
+    endsAt: string;
+    allowanceRecipients: number;
+    dailyGrowthPercent: number;
+    targetDailyRecipients: number;
+    reservedRecipients: number;
+    acceptedRecipients: number;
+    cancelledAt: string | null;
+    createdAt: string;
+};
+export type EmailDomainWarmingDecisionId = string;
+export type DomainWarmingDecision = {
+    id: EmailDomainWarmingDecisionId;
+    kind: "plan-created" | "policy-updated" | "window-opened" | "window-cancelled" | "paused" | "resumed" | "held" | "completed";
+    batchId: EmailDomainWarmingBatchId | null;
+    actor: string;
+    note: string | null;
+    createdAt: string;
+};
+export type DomainWarmingWindowHour = {
+    sent: number;
+    bounced: number;
+    complained: number;
+};
+export type DomainWarmingEvidence = {
+    observedAt: string;
+    windowHours: number;
+    minimumSends: number;
+    sent: number;
+    bounced: number;
+    complained: number;
+    hourly: Array<DomainWarmingWindowHour>;
+    bounceThreshold: number;
+    complaintThreshold: number;
+    verdict: "insufficient-evidence" | "healthy" | "over-threshold";
+    thresholdReason: string | null;
+};
+export type DomainWarmingHolds = {
+    workspacePausedAt: string | null;
+    workspacePauseReason: string | null;
+    sendingStatus: "enabled" | "disabled" | "reinstated" | "unknown";
+};
+export type DomainWarming = {
+    domain: DomainWarmingDomainRef;
+    plan: DomainWarmingPlan | null;
+    batches: Array<DomainWarmingBatch>;
+    decisions: Array<DomainWarmingDecision>;
+    evidence: DomainWarmingEvidence;
+    holds: DomainWarmingHolds;
+};
+export type CreateDomainWarmingPlanPayload = {
+    identity: "new" | "migrating" | "returning";
+    initialDailyRecipients: number;
+    dailyGrowthPercent: number;
+    targetDailyRecipients: number;
+};
+export type UpdateDomainWarmingPolicyPayload = {
+    dailyGrowthPercent: number;
+    targetDailyRecipients: number;
+    note?: string | null | undefined;
+};
+export type DomainWarmingNotePayload = {
+    note?: string | null | undefined;
+};
 export type CreateMediaPayload = {
     filename: string;
     contentType: string;
     sizeBytes: number;
-    purpose: "attachment" | "avatar";
+    purpose: "attachment" | "avatar" | "review_evidence";
     checksumSha256?: string | null | undefined;
 };
 export type OrganizationId = string;
@@ -623,7 +830,7 @@ export type CreatedMedia = {
     width: number | null;
     height: number | null;
     durationMs: number | null;
-    purpose: "attachment" | "avatar";
+    purpose: "attachment" | "avatar" | "review_evidence";
     checksumSha256: string | null;
     expiresAt: string | null;
     createdAt: string;
@@ -640,7 +847,7 @@ export type Media = {
     width: number | null;
     height: number | null;
     durationMs: number | null;
-    purpose: "attachment" | "avatar";
+    purpose: "attachment" | "avatar" | "review_evidence";
     checksumSha256: string | null;
     expiresAt: string | null;
     createdAt: string;
@@ -973,6 +1180,8 @@ export type TemplateSummary = {
     status: "draft" | "pending" | "approved" | "published" | "rejected" | "archived";
     usageCount: number;
     lastUsedAt: string | null;
+    workspaceRevision: string | null;
+    previewFixture: string | null;
     createdAt: string;
     updatedAt: string;
 };
@@ -1091,7 +1300,7 @@ export type DesignSettings = {
 export type CreateWebhookPayload = {
     name: string;
     url: string;
-    eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "contact.created" | "contact.updated" | "contact.deleted" | "conversation.started" | "conversation.ended" | "conversation.created" | "conversation.updated" | "conversation.archived" | "template.created" | "template.updated" | "template.deleted" | "template.approved" | "template.rejected" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated">;
+    eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "contact.created" | "contact.updated" | "contact.deleted" | "conversation.started" | "conversation.ended" | "conversation.created" | "conversation.updated" | "conversation.archived" | "template.created" | "template.updated" | "template.deleted" | "template.approved" | "template.rejected" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated">;
     channels?: Array<"email"> | null | undefined;
     headers?: {
         [key: string]: string;
@@ -1102,7 +1311,27 @@ export type WebhookEndpoint = {
     id: WebhookEndpointId;
     name: string;
     url: string;
-    eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "contact.created" | "contact.updated" | "contact.deleted" | "conversation.started" | "conversation.ended" | "conversation.created" | "conversation.updated" | "conversation.archived" | "template.created" | "template.updated" | "template.deleted" | "template.approved" | "template.rejected" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated">;
+    eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "contact.created" | "contact.updated" | "contact.deleted" | "conversation.started" | "conversation.ended" | "conversation.created" | "conversation.updated" | "conversation.archived" | "template.created" | "template.updated" | "template.deleted" | "template.approved" | "template.rejected" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated">;
+    channels: Array<"email"> | null;
+    status: "active" | "disabled";
+    hasCustomHeaders: boolean;
+    failureStartedAt: string | null;
+    lastSucceededAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type WebhookDeliveryCounts = {
+    total: number;
+    pending: number;
+    delivered: number;
+    exhausted: number;
+    cancelled: number;
+};
+export type WebhookEndpointListItem = {
+    id: WebhookEndpointId;
+    name: string;
+    url: string;
+    eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "contact.created" | "contact.updated" | "contact.deleted" | "conversation.started" | "conversation.ended" | "conversation.created" | "conversation.updated" | "conversation.archived" | "template.created" | "template.updated" | "template.deleted" | "template.approved" | "template.rejected" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated">;
     channels: Array<"email"> | null;
     status: "active" | "disabled";
     hasCustomHeaders: boolean;
@@ -1110,11 +1339,12 @@ export type WebhookEndpoint = {
     lastSucceededAt: string | null;
     createdAt: string;
     updatedAt: string;
+    deliveries: WebhookDeliveryCounts;
 };
 export type UpdateWebhookPayload = {
     name?: string | null | undefined;
     url?: string | null | undefined;
-    eventTypes?: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "contact.created" | "contact.updated" | "contact.deleted" | "conversation.started" | "conversation.ended" | "conversation.created" | "conversation.updated" | "conversation.archived" | "template.created" | "template.updated" | "template.deleted" | "template.approved" | "template.rejected" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated"> | null | undefined;
+    eventTypes?: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "contact.created" | "contact.updated" | "contact.deleted" | "conversation.started" | "conversation.ended" | "conversation.created" | "conversation.updated" | "conversation.archived" | "template.created" | "template.updated" | "template.deleted" | "template.approved" | "template.rejected" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated"> | null | undefined;
     channels?: Array<"email"> | null | null | undefined;
     headers?: {
         [key: string]: string;
@@ -1129,6 +1359,21 @@ export type TestWebhookPayload = {
 export type WebhookEventId = string;
 export type WebhookDeliveryId = string;
 export type WebhookAttemptId = string;
+export type WebhookDailyDeliveries = {
+    date: string;
+    pending: number;
+    delivered: number;
+    exhausted: number;
+    cancelled: number;
+};
+export type WebhookStatsResponse = {
+    total: number;
+    pending: number;
+    delivered: number;
+    exhausted: number;
+    cancelled: number;
+    daily: Array<WebhookDailyDeliveries>;
+};
 export type Organization = {
     id: string;
     billingAccountId: string;
@@ -1251,9 +1496,9 @@ export type MessagesSendErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * ForbiddenError | FlagDisabledError
+     * ForbiddenError | OnboardingReviewRequiredError | FlagDisabledError
      */
-    403: FlagDisabledError | ForbiddenError;
+    403: OnboardingReviewRequiredError | FlagDisabledError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -1393,6 +1638,38 @@ export type MessagesGetEmailResponses = {
      * Success
      */
     200: {
+        deliveries: Array<{
+            scheduling: {
+                dueAt: string;
+                expiresAt: string;
+                waitReason: "rate" | "daily-quota" | "domain-health" | "tenant-health" | "provider-unavailable" | "retry" | "campaign-paused" | "domain-warming" | "onboarding-review" | null;
+            } | null;
+            id: string;
+            messageId: string;
+            recipientId: string | null;
+            channel: "email";
+            status: "pending" | "scheduled" | "queued" | "processing" | "sent" | "delivered" | "read" | "failed" | "bounced" | "complained";
+            attemptCount: number;
+            maxAttempts: number;
+            queuedAt: string | null;
+            claimedAt: string | null;
+            lastAttemptAt: string | null;
+            nextRetryAt: string | null;
+            sentAt: string | null;
+            deliveredAt: string | null;
+            readAt: string | null;
+            failedAt: string | null;
+            terminalAt: string | null;
+            errorCode: string | null;
+            errorMessage: string | null;
+            errorDetails: JsonValue | null;
+            cost: string;
+            currency: string;
+            idempotencyKey: string | null;
+            metadata: JsonValue | null;
+            createdAt: string;
+            updatedAt: string;
+        }>;
         id: MessageId;
         organizationId: string;
         conversationId: ConversationId | null;
@@ -1445,6 +1722,51 @@ export type MessagesGetEmailResponses = {
     };
 };
 export type MessagesGetEmailResponse = MessagesGetEmailResponses[keyof MessagesGetEmailResponses];
+export type MessagesValidateEmailData = {
+    body: {
+        conversationId?: ConversationId | null | null | undefined;
+        metadata?: MessageMetadata | undefined;
+        channel: "email";
+        to: EmailRecipients;
+        cc?: EmailCcRecipients | undefined;
+        bcc?: EmailBccRecipients | undefined;
+        from?: EmailSender | undefined;
+        email: EmailContent;
+    };
+    path?: never;
+    query?: never;
+    url: "/v1/messages/validate/email";
+};
+export type MessagesValidateEmailErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ValidationError
+     */
+    422: ValidationError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+};
+export type MessagesValidateEmailError = MessagesValidateEmailErrors[keyof MessagesValidateEmailErrors];
+export type MessagesValidateEmailResponses = {
+    /**
+     * ValidateEmailResponse
+     */
+    200: ValidateEmailResponse;
+};
+export type MessagesValidateEmailResponse = MessagesValidateEmailResponses[keyof MessagesValidateEmailResponses];
 export type MessagesGetStatusData = {
     body?: never;
     path: {
@@ -1642,7 +1964,7 @@ export type ScheduledMessagesListData = {
     body?: never;
     path?: never;
     query?: {
-        status?: "pending" | "dispatching" | "dispatched" | "cancelled" | "failed" | null | undefined;
+        status?: "pending" | "dispatching" | "paused" | "dispatched" | "cancelled" | "failed" | null | undefined;
         page?: string | null | undefined;
         limit?: string | null | undefined;
     };
@@ -1677,7 +1999,7 @@ export type ScheduledMessagesCreateData = {
     body: {
         send: DispatchSendMessagePayload;
         scheduledFor: string;
-        timezone?: string | null | undefined;
+        timezone?: IanaTimezone | null | undefined;
         idempotencyKey?: string | null | undefined;
         referenceId?: string | null | undefined;
     };
@@ -1794,6 +2116,57 @@ export type ScheduledMessagesCancelResponses = {
     };
 };
 export type ScheduledMessagesCancelResponse = ScheduledMessagesCancelResponses[keyof ScheduledMessagesCancelResponses];
+export type ScheduledMessagesResumeData = {
+    body: {
+        choice: "send_now";
+    } | {
+        choice: "new_time";
+        scheduledFor: string;
+    };
+    path: {
+        id: ScheduledMessageId;
+    };
+    query?: never;
+    url: "/v1/messages/scheduled/{id}/resume";
+};
+export type ScheduledMessagesResumeErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ConflictError
+     */
+    409: ConflictError;
+    /**
+     * ValidationError
+     */
+    422: ValidationError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+    /**
+     * ExternalServiceError
+     */
+    502: ExternalServiceError;
+};
+export type ScheduledMessagesResumeError = ScheduledMessagesResumeErrors[keyof ScheduledMessagesResumeErrors];
+export type ScheduledMessagesResumeResponses = {
+    /**
+     * ScheduledMessage
+     */
+    200: ScheduledMessage;
+};
+export type ScheduledMessagesResumeResponse = ScheduledMessagesResumeResponses[keyof ScheduledMessagesResumeResponses];
 export type CampaignsListData = {
     body?: never;
     path?: never;
@@ -2292,6 +2665,104 @@ export type CampaignsListRecipientsResponses = {
     };
 };
 export type CampaignsListRecipientsResponse = CampaignsListRecipientsResponses[keyof CampaignsListRecipientsResponses];
+export type EmailGetOnboardingReviewData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: "/v1/email/onboarding-review";
+};
+export type EmailGetOnboardingReviewErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+};
+export type EmailGetOnboardingReviewError = EmailGetOnboardingReviewErrors[keyof EmailGetOnboardingReviewErrors];
+export type EmailGetOnboardingReviewResponses = {
+    /**
+     * OnboardingReviewStatus
+     */
+    200: OnboardingReviewStatus;
+};
+export type EmailGetOnboardingReviewResponse = EmailGetOnboardingReviewResponses[keyof EmailGetOnboardingReviewResponses];
+export type EmailReapplyOnboardingReviewData = {
+    body: {
+        expectedGeneration: number;
+    };
+    path?: never;
+    query?: never;
+    url: "/v1/email/onboarding-review/reapply";
+};
+export type EmailReapplyOnboardingReviewErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ConflictError
+     */
+    409: ConflictError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+};
+export type EmailReapplyOnboardingReviewError = EmailReapplyOnboardingReviewErrors[keyof EmailReapplyOnboardingReviewErrors];
+export type EmailReapplyOnboardingReviewResponses = {
+    /**
+     * OnboardingReviewStatus
+     */
+    200: OnboardingReviewStatus;
+};
+export type EmailReapplyOnboardingReviewResponse = EmailReapplyOnboardingReviewResponses[keyof EmailReapplyOnboardingReviewResponses];
+export type EmailRespondToOnboardingInformationRequestData = {
+    body: {
+        expectedGeneration: number;
+        responseText: string;
+        evidenceMediaIds: Array<MediaId>;
+    };
+    path?: never;
+    query?: never;
+    url: "/v1/email/onboarding-review/respond";
+};
+export type EmailRespondToOnboardingInformationRequestErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ConflictError
+     */
+    409: ConflictError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+};
+export type EmailRespondToOnboardingInformationRequestError = EmailRespondToOnboardingInformationRequestErrors[keyof EmailRespondToOnboardingInformationRequestErrors];
+export type EmailRespondToOnboardingInformationRequestResponses = {
+    /**
+     * OnboardingReviewStatus
+     */
+    200: OnboardingReviewStatus;
+};
+export type EmailRespondToOnboardingInformationRequestResponse = EmailRespondToOnboardingInformationRequestResponses[keyof EmailRespondToOnboardingInformationRequestResponses];
 export type EmailGetTrackingDefaultsData = {
     body?: never;
     path?: never;
@@ -2610,6 +3081,51 @@ export type EmailAdvanceDomainVerificationResponses = {
     200: EmailDomainVerification;
 };
 export type EmailAdvanceDomainVerificationResponse = EmailAdvanceDomainVerificationResponses[keyof EmailAdvanceDomainVerificationResponses];
+export type EmailRotateDomainDkimData = {
+    body?: never;
+    headers: {
+        "idempotency-key": string;
+    };
+    path: {
+        id: EmailDomainId;
+    };
+    query?: never;
+    url: "/v1/email/domains/{id}/dkim-rotation";
+};
+export type EmailRotateDomainDkimErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ConflictError
+     */
+    409: ConflictError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+    /**
+     * EmailChannelError
+     */
+    502: EmailChannelError;
+};
+export type EmailRotateDomainDkimError = EmailRotateDomainDkimErrors[keyof EmailRotateDomainDkimErrors];
+export type EmailRotateDomainDkimResponses = {
+    /**
+     * EmailDkimRotation
+     */
+    200: EmailDkimRotation;
+};
+export type EmailRotateDomainDkimResponse = EmailRotateDomainDkimResponses[keyof EmailRotateDomainDkimResponses];
 export type EmailRemoveDomainData = {
     body?: never;
     path: {
@@ -3423,7 +3939,45 @@ export type EmailRemoveSenderData = {
     query?: never;
     url: "/v1/email/senders/{id}";
 };
-export type EmailRemoveSenderErrors = {
+export type EmailRemoveSenderErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ValidationError
+     */
+    422: ValidationError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+};
+export type EmailRemoveSenderError = EmailRemoveSenderErrors[keyof EmailRemoveSenderErrors];
+export type EmailRemoveSenderResponses = {
+    /**
+     * SuccessResult
+     */
+    200: SuccessResult;
+};
+export type EmailRemoveSenderResponse = EmailRemoveSenderResponses[keyof EmailRemoveSenderResponses];
+export type EmailGetSenderData = {
+    body?: never;
+    path: {
+        id: EmailSenderId;
+    };
+    query?: never;
+    url: "/v1/email/senders/{id}";
+};
+export type EmailGetSenderErrors = {
     /**
      * UnauthorizedError
      */
@@ -3436,23 +3990,36 @@ export type EmailRemoveSenderErrors = {
      * ResourceNotFoundError
      */
     404: ResourceNotFoundError;
-    /**
-     * ValidationError
-     */
-    422: ValidationError;
     /**
      * InternalError
      */
     500: InternalError;
 };
-export type EmailRemoveSenderError = EmailRemoveSenderErrors[keyof EmailRemoveSenderErrors];
-export type EmailRemoveSenderResponses = {
+export type EmailGetSenderError = EmailGetSenderErrors[keyof EmailGetSenderErrors];
+export type EmailGetSenderResponses = {
     /**
-     * SuccessResult
+     * Success
      */
-    200: SuccessResult;
+    200: {
+        id: EmailSenderId;
+        organizationId: string;
+        email: string;
+        name: string | null;
+        domainId: EmailDomainId | null;
+        verificationStatus: "pending" | "verified" | "failed";
+        verifiedAt: string | null;
+        verificationToken: string | null;
+        providerLifecycle: "provisioning" | "active" | "deleting" | "failed";
+        providerFailureCode: string | null;
+        isDefault: boolean;
+        replyToEmails: Array<string> | null;
+        deliverability: DeliverabilityFacts;
+        isActive: boolean;
+        createdAt: string;
+        updatedAt: string;
+    };
 };
-export type EmailRemoveSenderResponse = EmailRemoveSenderResponses[keyof EmailRemoveSenderResponses];
+export type EmailGetSenderResponse = EmailGetSenderResponses[keyof EmailGetSenderResponses];
 export type EmailSetDefaultSenderData = {
     body?: never;
     path: {
@@ -4164,6 +4731,10 @@ export type EmailCreateForwardingRuleErrors = {
      * ForbiddenError
      */
     403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
     /**
      * ValidationError
      */
@@ -4332,12 +4903,298 @@ export type EmailGetForwardingLogResponses = {
     };
 };
 export type EmailGetForwardingLogResponse = EmailGetForwardingLogResponses[keyof EmailGetForwardingLogResponses];
+export type EmailGetDomainWarmingData = {
+    body?: never;
+    path: {
+        id: EmailDomainId;
+    };
+    query?: never;
+    url: "/v1/email/domains/{id}/warming";
+};
+export type EmailGetDomainWarmingErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+};
+export type EmailGetDomainWarmingError = EmailGetDomainWarmingErrors[keyof EmailGetDomainWarmingErrors];
+export type EmailGetDomainWarmingResponses = {
+    /**
+     * DomainWarming
+     */
+    200: DomainWarming;
+};
+export type EmailGetDomainWarmingResponse = EmailGetDomainWarmingResponses[keyof EmailGetDomainWarmingResponses];
+export type EmailCreateDomainWarmingPlanData = {
+    body: {
+        identity: "new" | "migrating" | "returning";
+        initialDailyRecipients: number;
+        dailyGrowthPercent: number;
+        targetDailyRecipients: number;
+    };
+    path: {
+        id: EmailDomainId;
+    };
+    query?: never;
+    url: "/v1/email/domains/{id}/warming";
+};
+export type EmailCreateDomainWarmingPlanErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ConflictError
+     */
+    409: ConflictError;
+    /**
+     * ValidationError
+     */
+    422: ValidationError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+};
+export type EmailCreateDomainWarmingPlanError = EmailCreateDomainWarmingPlanErrors[keyof EmailCreateDomainWarmingPlanErrors];
+export type EmailCreateDomainWarmingPlanResponses = {
+    /**
+     * Success
+     */
+    201: DomainWarming;
+};
+export type EmailCreateDomainWarmingPlanResponse = EmailCreateDomainWarmingPlanResponses[keyof EmailCreateDomainWarmingPlanResponses];
+export type EmailUpdateDomainWarmingPolicyData = {
+    body: {
+        dailyGrowthPercent: number;
+        targetDailyRecipients: number;
+        note?: string | null | undefined;
+    };
+    path: {
+        id: EmailDomainId;
+    };
+    query?: never;
+    url: "/v1/email/domains/{id}/warming/policy";
+};
+export type EmailUpdateDomainWarmingPolicyErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ConflictError
+     */
+    409: ConflictError;
+    /**
+     * ValidationError
+     */
+    422: ValidationError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+};
+export type EmailUpdateDomainWarmingPolicyError = EmailUpdateDomainWarmingPolicyErrors[keyof EmailUpdateDomainWarmingPolicyErrors];
+export type EmailUpdateDomainWarmingPolicyResponses = {
+    /**
+     * DomainWarming
+     */
+    200: DomainWarming;
+};
+export type EmailUpdateDomainWarmingPolicyResponse = EmailUpdateDomainWarmingPolicyResponses[keyof EmailUpdateDomainWarmingPolicyResponses];
+export type EmailCancelDomainWarmingBatchData = {
+    body?: never;
+    path: {
+        id: EmailDomainId;
+        batchId: EmailDomainWarmingBatchId;
+    };
+    query?: never;
+    url: "/v1/email/domains/{id}/warming/batches/{batchId}";
+};
+export type EmailCancelDomainWarmingBatchErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ConflictError
+     */
+    409: ConflictError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+};
+export type EmailCancelDomainWarmingBatchError = EmailCancelDomainWarmingBatchErrors[keyof EmailCancelDomainWarmingBatchErrors];
+export type EmailCancelDomainWarmingBatchResponses = {
+    /**
+     * DomainWarming
+     */
+    200: DomainWarming;
+};
+export type EmailCancelDomainWarmingBatchResponse = EmailCancelDomainWarmingBatchResponses[keyof EmailCancelDomainWarmingBatchResponses];
+export type EmailPauseDomainWarmingData = {
+    body: {
+        note?: string | null | undefined;
+    };
+    path: {
+        id: EmailDomainId;
+    };
+    query?: never;
+    url: "/v1/email/domains/{id}/warming/pause";
+};
+export type EmailPauseDomainWarmingErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ConflictError
+     */
+    409: ConflictError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+};
+export type EmailPauseDomainWarmingError = EmailPauseDomainWarmingErrors[keyof EmailPauseDomainWarmingErrors];
+export type EmailPauseDomainWarmingResponses = {
+    /**
+     * DomainWarming
+     */
+    200: DomainWarming;
+};
+export type EmailPauseDomainWarmingResponse = EmailPauseDomainWarmingResponses[keyof EmailPauseDomainWarmingResponses];
+export type EmailResumeDomainWarmingData = {
+    body: {
+        note?: string | null | undefined;
+    };
+    path: {
+        id: EmailDomainId;
+    };
+    query?: never;
+    url: "/v1/email/domains/{id}/warming/resume";
+};
+export type EmailResumeDomainWarmingErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ConflictError
+     */
+    409: ConflictError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+};
+export type EmailResumeDomainWarmingError = EmailResumeDomainWarmingErrors[keyof EmailResumeDomainWarmingErrors];
+export type EmailResumeDomainWarmingResponses = {
+    /**
+     * DomainWarming
+     */
+    200: DomainWarming;
+};
+export type EmailResumeDomainWarmingResponse = EmailResumeDomainWarmingResponses[keyof EmailResumeDomainWarmingResponses];
+export type EmailCompleteDomainWarmingData = {
+    body: {
+        note?: string | null | undefined;
+    };
+    path: {
+        id: EmailDomainId;
+    };
+    query?: never;
+    url: "/v1/email/domains/{id}/warming/complete";
+};
+export type EmailCompleteDomainWarmingErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ConflictError
+     */
+    409: ConflictError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+};
+export type EmailCompleteDomainWarmingError = EmailCompleteDomainWarmingErrors[keyof EmailCompleteDomainWarmingErrors];
+export type EmailCompleteDomainWarmingResponses = {
+    /**
+     * DomainWarming
+     */
+    200: DomainWarming;
+};
+export type EmailCompleteDomainWarmingResponse = EmailCompleteDomainWarmingResponses[keyof EmailCompleteDomainWarmingResponses];
 export type MediaCreateData = {
     body: {
         filename: string;
         contentType: string;
         sizeBytes: number;
-        purpose: "attachment" | "avatar";
+        purpose: "attachment" | "avatar" | "review_evidence";
         checksumSha256?: string | null | undefined;
     };
     path?: never;
@@ -7908,6 +8765,7 @@ export type WebhooksListData = {
         page?: string | null | undefined;
         limit?: string | null | undefined;
         search?: string | null | undefined;
+        status?: "active" | "disabled" | null | undefined;
     };
     url: "/v1/webhooks";
 };
@@ -7931,7 +8789,7 @@ export type WebhooksListResponses = {
      * Success
      */
     200: {
-        items: Array<WebhookEndpoint>;
+        items: Array<WebhookEndpointListItem>;
         pagination: PaginationMeta;
     };
 };
@@ -7940,7 +8798,7 @@ export type WebhooksCreateData = {
     body: {
         name: string;
         url: string;
-        eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "contact.created" | "contact.updated" | "contact.deleted" | "conversation.started" | "conversation.ended" | "conversation.created" | "conversation.updated" | "conversation.archived" | "template.created" | "template.updated" | "template.deleted" | "template.approved" | "template.rejected" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated">;
+        eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "contact.created" | "contact.updated" | "contact.deleted" | "conversation.started" | "conversation.ended" | "conversation.created" | "conversation.updated" | "conversation.archived" | "template.created" | "template.updated" | "template.deleted" | "template.approved" | "template.rejected" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated">;
         channels?: Array<"email"> | null | undefined;
         headers?: {
             [key: string]: string;
@@ -8068,7 +8926,7 @@ export type WebhooksUpdateData = {
     body: {
         name?: string | null | undefined;
         url?: string | null | undefined;
-        eventTypes?: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "contact.created" | "contact.updated" | "contact.deleted" | "conversation.started" | "conversation.ended" | "conversation.created" | "conversation.updated" | "conversation.archived" | "template.created" | "template.updated" | "template.deleted" | "template.approved" | "template.rejected" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated"> | null | undefined;
+        eventTypes?: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "contact.created" | "contact.updated" | "contact.deleted" | "conversation.started" | "conversation.ended" | "conversation.created" | "conversation.updated" | "conversation.archived" | "template.created" | "template.updated" | "template.deleted" | "template.approved" | "template.rejected" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated"> | null | undefined;
         channels?: Array<"email"> | null | null | undefined;
         headers?: {
             [key: string]: string;
@@ -8194,6 +9052,8 @@ export type WebhooksGetLogsResponses = {
         data: Array<{
             id: WebhookDeliveryId;
             eventId: WebhookEventId;
+            eventType: string;
+            occurredAt: string;
             endpointId: WebhookEndpointId;
             status: "pending" | "delivered" | "exhausted" | "cancelled";
             automaticAttempts: number;
@@ -8227,7 +9087,9 @@ export type WebhooksGetStatsData = {
     path: {
         webhookId: WebhookEndpointId;
     };
-    query?: never;
+    query?: {
+        period?: "7d" | "30d" | "90d" | null | undefined;
+    };
     url: "/v1/webhooks/{webhookId}/stats";
 };
 export type WebhooksGetStatsErrors = {
@@ -8251,15 +9113,9 @@ export type WebhooksGetStatsErrors = {
 export type WebhooksGetStatsError = WebhooksGetStatsErrors[keyof WebhooksGetStatsErrors];
 export type WebhooksGetStatsResponses = {
     /**
-     * Success
+     * WebhookStatsResponse
      */
-    200: {
-        total: number;
-        pending: number;
-        delivered: number;
-        exhausted: number;
-        cancelled: number;
-    };
+    200: WebhookStatsResponse;
 };
 export type WebhooksGetStatsResponse = WebhooksGetStatsResponses[keyof WebhooksGetStatsResponses];
 export type WebhooksRetryDeliveryData = {
@@ -8427,7 +9283,7 @@ export type OrganizationsUpdateData = {
         billingEmail?: string | null | undefined;
         countryCode?: string | null | undefined;
         currency?: string | null | undefined;
-        timezone?: string | null | undefined;
+        timezone?: IanaTimezone | null | undefined;
         isActive?: boolean | null | undefined;
         metadata?: {
             [key: string]: JsonValue;