@stackshift-cloud/sdk 0.1.4 → 1.0.0

package/README.md

@@ -44,16 +44,16 @@ const message = await stackshift.mail.send({
 console.log(message.id, message.status, message.idempotencyStatus)
 ```
 
-Inspect sent messages:
+Inspect MTA-accepted messages:
 
 ```ts
-const messages = await stackshift.mail.messages.list({ status: 'sent', limit: 20 })
+const messages = await stackshift.mail.messages.list({ status: 'mta_accepted', limit: 20 })
 const detail = await stackshift.mail.messages.get(messages.data[0].id)
 const attempts = await stackshift.mail.messages.attempts(detail.id)
 const logs = await stackshift.mail.messages.logs(detail.id)
 ```
 
-In this MVP, `sent` means the message was accepted by StackShift's outbound MTA. It does not mean inbox delivery, opens, clicks, or spam placement. A `sent` message can later become `bounced` if StackShift receives a delivery-status notification.
+`mta_accepted` means StackShift's outbound MTA accepted the message. `delivered` means the recipient MX accepted a recipient; it does not claim inbox placement or human receipt. Recipient records remain authoritative for mixed outcomes.
 
 ## Send a template
 

package/dist/index.d.ts

@@ -4,12 +4,17 @@ export { createResponsiveImage, namedResponsiveSource, uploadBrowserFile } from
 export type { ArtDirectionSource, ResponsiveImageDescriptor, ResponsiveImageOptions } from './assets-framework.js';
 export { assetContractOperations } from './generated/assets-contract.js';
 export type { AssetAPIScope, AssetContractOperation, AssetOperationId } from './generated/assets-contract.js';
-export { MailBouncesClient, MailClient, MailDomainsClient, MailEventsClient, MailLimitsClient, MailMessagesClient, MailScheduledClient, MailBatchClient, MailInboundClient, MailAnalyticsClient, MailOtpChallengesClient, MailOtpClient, MailReputationClient, MailReputationEventsClient, MailSuppressionsClient, MailTemplatesClient, MailWebhooksClient, } from './mail.js';
+export { MailBouncesClient, MailClient, MailDomainsClient, MailEventsClient, MailLimitsClient, MailMessagesClient, MailScheduledClient, MailBatchClient, MailInboundClient, MailAnalyticsClient, MailOtpChallengesClient, MailOtpClient, MailReputationClient, MailReputationEventsClient, MailSuppressionsClient, MailTemplatesClient, MailWebhooksClient, MailStreamsClient, MailAudiencesClient, MailCampaignsClient, } from './mail.js';
+export type { MailAudience, MailAudienceMember, MailAudienceMemberImport, MailCampaign } from './mail-campaigns.js';
+export { MailExportsClient } from './mail-exports.js';
+export type { MailExport, MailExportCreateInput } from './mail-exports.js';
+export type { MailDiagnosticFinding, MailTemplateDiagnosticInput, MailTemplateDiagnosticResult } from './mail-diagnostics.js';
 export { ProjectsClient } from './projects.js';
-export type { Asset, AssetAIAnnotation, AssetAIInfo, AssetCollection, AssetListOptions, AssetListResult, AssetModerationResult, AssetSavedSearch, AssetSignedUploadUrl, AssetSignedUploadUrlOptions, AssetSignedUrl, AssetSignedUrlOptions, AssetTranscript, AssetTransformOptions, AssetTransformPreset, AssetTransformPresetCategory, AssetUploadOptions, AssetVisibility, AssetVersion, JsonValue, MailAddress, MailAddressInput, MailDnsRecord, MailDomain, MailDomainListResult, MailDomainStatus, MailIdempotencyStatus, MailLog, MailMessage, MailMessageListOptions, MailMessageListResult, MailMessageSummary, MailRecordStatus, MailSendAttempt, MailSendInput, MailSendResponse, MailStatus, Project, ProjectListOptions, StackShiftOptions, } from './types.js';
-export type { MailBounce, MailBounceListOptions, MailBounceListResult, MailBounceType, MailSuppression, MailSuppressionCreateInput, MailSuppressionListOptions, MailSuppressionListResult, MailSuppressionReason, MailSuppressionSource, } from './mail-phase4-types.js';
+export type { Asset, AssetAIAnnotation, AssetAIInfo, AssetCollection, AssetListOptions, AssetListResult, AssetModerationResult, AssetSavedSearch, AssetSignedUploadUrl, AssetSignedUploadUrlOptions, AssetSignedUrl, AssetSignedUrlOptions, AssetTranscript, AssetTransformOptions, AssetTransformPreset, AssetTransformPresetCategory, AssetUploadOptions, AssetVisibility, AssetVersion, JsonValue, MailAddress, MailAddressInput, MailDnsRecord, MailDomain, MailDomainListResult, MailDomainStatus, MailIdempotencyStatus, MailLog, MailMessage, MailMessageListOptions, MailMessageListResult, MailMessageSummary, MailRecordStatus, MailSendAttempt, MailSendInput, MailSendResponse, MailStatus, MailRecipient, MailRecipientStatus, MailRecipientSummary, Project, ProjectListOptions, StackShiftOptions, } from './types.js';
+export type { MailBounce, MailBounceListOptions, MailBounceListResult, MailBounceType, MailSuppression, MailSuppressionCreateInput, MailSuppressionListOptions, MailSuppressionListResult, MailSuppressionReason, MailSuppressionSource, } from './mail-delivery-types.js';
 export type { MailOtpChallenge, MailOtpChallengeListOptions, MailOtpChallengeListResult, MailOtpSendInput, MailOtpSendResponse, MailOtpStatus, MailOtpVerifyInput, MailOtpVerifyResponse, } from './mail-otp-types.js';
 export type { MailSendTemplateInput, MailSendTemplateResponse, MailTemplate, MailTemplateCreateInput, MailTemplateDetail, MailTemplateListOptions, MailTemplateListResult, MailTemplatePreview, MailTemplatePreviewInput, MailTemplateStatus, MailTemplateTestSendInput, MailTemplateTestSendResponse, MailTemplateUpdateInput, MailTemplateVersion, } from './mail-template-types.js';
-export type { MailEvent, MailEventListOptions, MailEventListResult, MailEventType, MailTimelineItem, MailWebhook, MailWebhookCreateInput, MailWebhookCreateResponse, MailWebhookDelivery, MailWebhookDeliveryAttempt, MailWebhookDeliveryDetail, MailWebhookDeliveryListOptions, MailWebhookListOptions, MailWebhookListResult, MailWebhookUpdateInput, } from './mail-webhook-types.js';
+export type { MailEvent, MailEventListOptions, MailEventListResult, MailEventType, MailTimelineItem, MailWebhook, MailWebhookCreateInput, MailWebhookCreateResponse, MailWebhookDelivery, MailWebhookDeliveryAttempt, MailWebhookDeliveryDetail, MailWebhookDeliveryListOptions, MailWebhookListOptions, MailWebhookListResult, MailWebhookUpdateInput, MailWebhookReplay, MailWebhookReplayInput, } from './mail-webhook-types.js';
+export type { MailMessageStream, MailMessageStreamCreateInput, MailMessageStreamListResult } from './mail-streams.js';
 export type { MailDomainReputation, MailLimits, MailManualReviewStatus, MailReputation, MailReputationEvent, MailReputationEventListOptions, MailReputationEventListResult, MailReputationEventSeverity, MailReputationStatus, MailReputationTier, MailReputationWorkspace, } from './mail-reputation-types.js';
-export type { MailAnalytics, MailAnalyticsInput, MailAttachmentInput, MailBatch, MailBatchSendInput, MailBatchTemplateInput, MailInboundDomain, MailInboundMessage, MailScheduledCreateInput, MailScheduledMessage, } from './mail-advanced-types.js';
+export type { MailAnalytics, MailAnalyticsInput, MailAttachmentInput, MailBatch, MailBatchItem, MailBatchSendInput, MailBatchTemplateInput, MailInboundDomain, MailInboundMessage, MailScheduledCreateInput, MailScheduledMessage, } from './mail-advanced-types.js';

package/dist/index.js

@@ -2,5 +2,6 @@ export { StackShift, StackShiftAPIError } from './client.js';
 export { AssetsClient, assetTransformOptions, assetTransformPresets, assetTransformSpec, getAssetTransformPreset } from './assets.js';
 export { createResponsiveImage, namedResponsiveSource, uploadBrowserFile } from './assets-framework.js';
 export { assetContractOperations } from './generated/assets-contract.js';
-export { MailBouncesClient, MailClient, MailDomainsClient, MailEventsClient, MailLimitsClient, MailMessagesClient, MailScheduledClient, MailBatchClient, MailInboundClient, MailAnalyticsClient, MailOtpChallengesClient, MailOtpClient, MailReputationClient, MailReputationEventsClient, MailSuppressionsClient, MailTemplatesClient, MailWebhooksClient, } from './mail.js';
+export { MailBouncesClient, MailClient, MailDomainsClient, MailEventsClient, MailLimitsClient, MailMessagesClient, MailScheduledClient, MailBatchClient, MailInboundClient, MailAnalyticsClient, MailOtpChallengesClient, MailOtpClient, MailReputationClient, MailReputationEventsClient, MailSuppressionsClient, MailTemplatesClient, MailWebhooksClient, MailStreamsClient, MailAudiencesClient, MailCampaignsClient, } from './mail.js';
+export { MailExportsClient } from './mail-exports.js';
 export { ProjectsClient } from './projects.js';

package/dist/mail-advanced-types.d.ts

@@ -1,10 +1,12 @@
-import type { JsonValue, MailAddress, MailAddressInput, MailSendInput, MailSendResponse } from './types.js';
+import type { JsonValue, MailAddress, MailAddressInput, MailRecipient, MailSendInput, MailSendResponse } from './types.js';
 import type { MailSendTemplateInput } from './mail-template-types.js';
 export interface MailAttachmentInput {
     assetId?: string;
     uploadId?: string;
     filename: string;
     contentType?: string;
+    disposition?: 'attachment' | 'inline';
+    contentId?: string;
 }
 export interface MailScheduledCreateInput {
     sendAt: string;
@@ -16,15 +18,18 @@ export interface MailScheduledCreateInput {
     data?: Record<string, JsonValue>;
     idempotencyKey?: string;
     attachments?: MailAttachmentInput[];
+    headers?: Record<string, string>;
+    tags?: Record<string, string>;
+    stream?: string;
 }
 export interface MailScheduledMessage {
     id: string;
-    status: 'scheduled' | 'queued' | 'sent' | 'canceled' | 'failed';
+    status: 'scheduled' | 'queued' | 'dispatched' | 'canceled' | 'failed';
     sendAt: string;
     messageId?: string | null;
     createdAt?: string;
     canceledAt?: string | null;
-    sentAt?: string | null;
+    dispatchedAt?: string | null;
 }
 export interface MailBatchSendInput {
     from: string | MailAddress;
@@ -39,11 +44,28 @@ export interface MailBatchTemplateInput {
         data?: Record<string, JsonValue>;
         idempotencyKey?: string;
     }>;
+    headers?: Record<string, string>;
+    tags?: Record<string, string>;
+    stream?: string;
 }
 export interface MailBatch {
     id: string;
     status: 'queued' | 'processing' | 'completed' | 'failed';
     messageCount: number;
+    queuedCount: number;
+    acceptedCount: number;
+    failedCount: number;
+    suppressedCount: number;
+}
+export interface MailBatchItem {
+    id: string;
+    batchId: string;
+    messageId?: string | null;
+    recipientEmail: string;
+    status: 'queued' | 'sending' | 'accepted' | 'failed' | 'suppressed';
+    errorCode?: string | null;
+    errorMessage?: string | null;
+    recipients: MailRecipient[];
 }
 export interface MailInboundDomain {
     id: string;

package/dist/mail-advanced.d.ts

@@ -1,5 +1,5 @@
 import type { StackShift } from './client.js';
-import type { MailAnalytics, MailAnalyticsInput, MailBatch, MailBatchSendInput, MailBatchTemplateInput, MailInboundDomain, MailInboundMessage, MailScheduledCreateInput, MailScheduledMessage } from './mail-advanced-types.js';
+import type { MailAnalytics, MailAnalyticsInput, MailBatch, MailBatchItem, MailBatchSendInput, MailBatchTemplateInput, MailInboundDomain, MailInboundMessage, MailScheduledCreateInput, MailScheduledMessage } from './mail-advanced-types.js';
 export declare class MailScheduledClient {
     private readonly client;
     constructor(client: StackShift);
@@ -15,6 +15,13 @@ export declare class MailBatchClient {
     constructor(client: StackShift);
     send(input: MailBatchSendInput): Promise<MailBatch>;
     sendTemplate(input: MailBatchTemplateInput): Promise<MailBatch>;
+    list(): Promise<{
+        data: MailBatch[];
+    }>;
+    get(id: string): Promise<MailBatch>;
+    items(id: string): Promise<{
+        data: MailBatchItem[];
+    }>;
 }
 export declare class MailInboundClient {
     readonly domains: MailInboundDomainsClient;

package/dist/mail-advanced.js

@@ -27,6 +27,15 @@ export class MailBatchClient {
     sendTemplate(input) {
         return this.client.mailRequest('/mail/batch-template', { method: 'POST', body: input });
     }
+    list() {
+        return this.client.mailRequest('/mail/batches');
+    }
+    get(id) {
+        return this.client.mailRequest(`/mail/batches/${encodeURIComponent(id)}`);
+    }
+    items(id) {
+        return this.client.mailRequest(`/mail/batches/${encodeURIComponent(id)}/items`);
+    }
 }
 export class MailInboundClient {
     domains;

package/dist/mail-campaigns.d.ts

@@ -0,0 +1,76 @@
+import type { StackShift } from './client.js';
+export interface MailAudience {
+    id: string;
+    workspaceId: string;
+    name: string;
+    description?: string;
+    status: 'active' | 'archived';
+    memberCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface MailAudienceMember {
+    id: string;
+    audienceId: string;
+    email: string;
+    name?: string;
+    status: 'subscribed' | 'unsubscribed' | 'complained' | 'hard_bounced';
+    consentSource: string;
+    consentAt: string;
+    consentIp?: string;
+}
+export interface MailAudienceMemberImport {
+    email: string;
+    name?: string;
+    consentSource: string;
+    consentAt: string;
+    consentIp?: string;
+}
+export interface MailCampaign {
+    id: string;
+    audienceId: string;
+    batchId?: string;
+    name: string;
+    template: string;
+    versionId?: string;
+    from: string;
+    status: 'draft' | 'processing' | 'queued' | 'completed' | 'failed';
+    createdAt: string;
+    updatedAt: string;
+    queuedAt?: string;
+}
+export declare class MailAudiencesClient {
+    private readonly client;
+    constructor(client: StackShift);
+    create(input: {
+        name: string;
+        description?: string;
+    }): Promise<MailAudience>;
+    list(): Promise<{
+        data: MailAudience[];
+    }>;
+    get(id: string): Promise<MailAudience>;
+    members(id: string): Promise<{
+        data: MailAudienceMember[];
+    }>;
+    import(id: string, members: MailAudienceMemberImport[]): Promise<{
+        imported: number;
+        skipped: number;
+    }>;
+}
+export declare class MailCampaignsClient {
+    private readonly client;
+    constructor(client: StackShift);
+    create(input: {
+        name: string;
+        audienceId: string;
+        template: string;
+        versionId?: string;
+        from: string;
+    }): Promise<MailCampaign>;
+    list(): Promise<{
+        data: MailCampaign[];
+    }>;
+    get(id: string): Promise<MailCampaign>;
+    send(id: string): Promise<MailCampaign>;
+}

package/dist/mail-campaigns.js

@@ -0,0 +1,42 @@
+export class MailAudiencesClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    create(input) {
+        return this.client.mailRequest('/mail/audiences', { method: 'POST', body: input });
+    }
+    list() {
+        return this.client.mailRequest('/mail/audiences');
+    }
+    get(id) {
+        return this.client.mailRequest(`/mail/audiences/${encodeURIComponent(id)}`);
+    }
+    members(id) {
+        return this.client.mailRequest(`/mail/audiences/${encodeURIComponent(id)}/members`);
+    }
+    import(id, members) {
+        return this.client.mailRequest(`/mail/audiences/${encodeURIComponent(id)}/imports`, {
+            method: 'POST',
+            body: { members },
+        });
+    }
+}
+export class MailCampaignsClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    create(input) {
+        return this.client.mailRequest('/mail/campaigns', { method: 'POST', body: input });
+    }
+    list() {
+        return this.client.mailRequest('/mail/campaigns');
+    }
+    get(id) {
+        return this.client.mailRequest(`/mail/campaigns/${encodeURIComponent(id)}`);
+    }
+    send(id) {
+        return this.client.mailRequest(`/mail/campaigns/${encodeURIComponent(id)}/send`, { method: 'POST' });
+    }
+}

package/dist/mail-diagnostics.d.ts

@@ -0,0 +1,23 @@
+export interface MailTemplateDiagnosticInput {
+    versionId?: string;
+    data?: Record<string, unknown>;
+    stream?: 'transactional' | 'broadcast';
+}
+export interface MailDiagnosticFinding {
+    code: string;
+    severity: 'info' | 'warning' | 'error';
+    field: string;
+    message: string;
+    recommendation: string;
+}
+export interface MailTemplateDiagnosticResult {
+    status: 'pass' | 'warning' | 'error';
+    stream: 'transactional' | 'broadcast';
+    subjectLength: number;
+    htmlBytes: number;
+    textBytes: number;
+    linkCount: number;
+    remoteImageCount: number;
+    missingAltCount: number;
+    findings: MailDiagnosticFinding[];
+}

package/dist/mail-diagnostics.js

@@ -0,0 +1 @@
+export {};

package/dist/mail-events-webhooks.d.ts

@@ -1,5 +1,5 @@
 import type { StackShift } from './client.js';
-import type { MailEvent, MailEventListOptions, MailEventListResult, MailTimelineItem, MailWebhook, MailWebhookCreateInput, MailWebhookCreateResponse, MailWebhookDelivery, MailWebhookDeliveryDetail, MailWebhookDeliveryListOptions, MailWebhookListOptions, MailWebhookListResult, MailWebhookUpdateInput } from './mail-webhook-types.js';
+import type { MailEvent, MailEventListOptions, MailEventListResult, MailTimelineItem, MailWebhook, MailWebhookCreateInput, MailWebhookCreateResponse, MailWebhookDelivery, MailWebhookDeliveryDetail, MailWebhookDeliveryListOptions, MailWebhookListOptions, MailWebhookListResult, MailWebhookReplay, MailWebhookReplayInput, MailWebhookUpdateInput } from './mail-webhook-types.js';
 export declare class MailEventsClient {
     private readonly client;
     constructor(client: StackShift);
@@ -23,6 +23,7 @@ export declare class MailWebhooksClient {
     }>;
     getDelivery(deliveryId: string): Promise<MailWebhookDeliveryDetail>;
     retryDelivery(deliveryId: string): Promise<MailWebhookDelivery>;
+    replay(webhookId: string, input: MailWebhookReplayInput): Promise<MailWebhookReplay>;
     verifySignature(input: {
         rawBody: string | Uint8Array;
         signatureHeader?: string | null;
@@ -38,6 +39,6 @@ export declare function verifyWebhookSignature(input: {
     secret: string;
     toleranceSeconds?: number;
 }): boolean;
-export declare function timeline(client: StackShift, messageId: string): Promise<{
+export declare function timeline(client: StackShift, messageId: string, recipient?: string): Promise<{
     data: MailTimelineItem[];
 }>;

package/dist/mail-events-webhooks.js

@@ -55,6 +55,13 @@ export class MailWebhooksClient {
             method: 'POST',
         });
     }
+    replay(webhookId, input) {
+        return this.client.mailRequest(`/mail/webhooks/${encodeURIComponent(webhookId)}/replay`, {
+            method: 'POST',
+            headers: { 'Idempotency-Key': input.idempotencyKey },
+            body: { eventIds: input.eventIds },
+        });
+    }
     verifySignature(input) {
         return verifyWebhookSignature(input);
     }
@@ -72,8 +79,9 @@ export function verifyWebhookSignature(input) {
         return false;
     return constantTimeEqual(actual, expected);
 }
-export function timeline(client, messageId) {
-    return client.mailRequest(`/mail/messages/${encodeURIComponent(messageId)}/timeline`);
+export function timeline(client, messageId, recipient) {
+    const query = recipient ? `?recipient=${encodeURIComponent(recipient)}` : '';
+    return client.mailRequest(`/mail/messages/${encodeURIComponent(messageId)}/timeline${query}`);
 }
 function queryString(options) {
     const query = new URLSearchParams();

package/dist/mail-exports.d.ts

@@ -0,0 +1,32 @@
+import type { StackShift } from './client.js';
+export interface MailExport {
+    id: string;
+    kind: 'recipient_delivery';
+    format: 'jsonl';
+    status: 'queued' | 'processing' | 'ready' | 'failed' | 'expired';
+    from: string;
+    to: string;
+    recordCount: number;
+    sizeBytes: number;
+    checksum?: string;
+    error?: string;
+    createdAt: string;
+    completedAt?: string;
+    expiresAt: string;
+}
+export interface MailExportCreateInput {
+    kind?: 'recipient_delivery';
+    format?: 'jsonl';
+    from?: string;
+    to?: string;
+}
+export declare class MailExportsClient {
+    private readonly client;
+    constructor(client: StackShift);
+    create(input?: MailExportCreateInput): Promise<MailExport>;
+    list(): Promise<{
+        data: MailExport[];
+    }>;
+    get(id: string): Promise<MailExport>;
+    downloadPath(id: string): string;
+}

package/dist/mail-exports.js

@@ -0,0 +1,18 @@
+export class MailExportsClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    create(input = {}) {
+        return this.client.mailRequest('/mail/exports', { method: 'POST', body: input });
+    }
+    list() {
+        return this.client.mailRequest('/mail/exports');
+    }
+    get(id) {
+        return this.client.mailRequest(`/mail/exports/${encodeURIComponent(id)}`);
+    }
+    downloadPath(id) {
+        return `/mail/exports/${encodeURIComponent(id)}/download`;
+    }
+}

package/dist/mail-streams.d.ts

@@ -0,0 +1,27 @@
+import type { StackShift } from './client.js';
+export interface MailMessageStream {
+    id: string;
+    workspaceId: string;
+    name: string;
+    slug: string;
+    type: 'transactional' | 'broadcast';
+    status: 'active' | 'paused';
+    protected: boolean;
+    ipPoolId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface MailMessageStreamCreateInput {
+    name: string;
+    slug: string;
+    type: 'transactional' | 'broadcast';
+}
+export interface MailMessageStreamListResult {
+    data: MailMessageStream[];
+}
+export declare class MailStreamsClient {
+    private readonly client;
+    constructor(client: StackShift);
+    create(input: MailMessageStreamCreateInput): Promise<MailMessageStream>;
+    list(): Promise<MailMessageStreamListResult>;
+}

package/dist/mail-streams.js

@@ -0,0 +1,12 @@
+export class MailStreamsClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    create(input) {
+        return this.client.mailRequest('/mail/streams', { method: 'POST', body: input });
+    }
+    list() {
+        return this.client.mailRequest('/mail/streams');
+    }
+}

package/dist/mail-webhook-types.d.ts

@@ -1,5 +1,5 @@
 import type { JsonValue } from './types.js';
-export type MailEventType = 'mail.message.queued' | 'mail.message.sending' | 'mail.message.sent' | 'mail.message.deferred' | 'mail.message.failed' | 'mail.message.bounced' | 'mail.message.suppressed' | 'mail.suppression.created' | 'mail.suppression.deleted' | 'mail.otp.created' | 'mail.otp.sent' | 'mail.otp.verified' | 'mail.otp.failed_attempt' | 'mail.otp.failed' | 'mail.otp.expired' | 'mail.otp.canceled' | 'mail.template.created' | 'mail.template.updated' | 'mail.template.deleted' | 'mail.template.version.created' | 'mail.template.test_sent' | 'mail.domain.created' | 'mail.domain.verified' | 'mail.domain.failed' | 'mail.domain.deleted' | 'mail.webhook.created' | 'mail.webhook.updated' | 'mail.webhook.disabled' | 'mail.webhook.delivery.succeeded' | 'mail.webhook.delivery.failed';
+export type MailEventType = 'mail.message.accepted' | 'mail.message.queued' | 'mail.message.sending' | 'mail.message.mta_accepted' | 'mail.delivery.delayed' | 'mail.delivery.delivered' | 'mail.message.failed' | 'mail.message.bounced' | 'mail.message.suppressed' | 'mail.message.complained' | 'mail.suppression.created' | 'mail.suppression.deleted' | 'mail.otp.created' | 'mail.otp.sent' | 'mail.otp.verified' | 'mail.otp.failed_attempt' | 'mail.otp.failed' | 'mail.otp.expired' | 'mail.otp.canceled' | 'mail.template.created' | 'mail.template.updated' | 'mail.template.deleted' | 'mail.template.version.created' | 'mail.template.test_queued' | 'mail.domain.created' | 'mail.domain.verified' | 'mail.domain.failed' | 'mail.domain.deleted' | 'mail.webhook.created' | 'mail.webhook.updated' | 'mail.webhook.disabled' | 'mail.webhook.delivery.succeeded' | 'mail.webhook.delivery.failed' | 'mail.audience.created' | 'mail.audience.members.imported' | 'mail.campaign.created' | 'mail.campaign.queued';
 export interface MailEvent {
     id: string;
     type: MailEventType | string;
@@ -89,6 +89,17 @@ export interface MailWebhookDeliveryAttempt {
 export interface MailWebhookDeliveryDetail extends MailWebhookDelivery {
     attempts: MailWebhookDeliveryAttempt[];
 }
+export interface MailWebhookReplayInput {
+    eventIds: string[];
+    idempotencyKey: string;
+}
+export interface MailWebhookReplay {
+    id: string;
+    webhookId: string;
+    eventIds: string[];
+    deliveries: MailWebhookDelivery[];
+    createdAt: string;
+}
 export interface MailWebhookDeliveryListOptions {
     status?: string;
     limit?: number;

package/dist/mail.d.ts

@@ -1,6 +1,6 @@
 import type { StackShift } from './client.js';
 import type { MailLog, MailDomain, MailDomainListResult, MailMessage, MailMessageListOptions, MailMessageListResult, MailSendAttempt, MailSendInput, MailSendResponse } from './types.js';
-import type { MailBounce, MailBounceListOptions, MailBounceListResult, MailSuppression, MailSuppressionCreateInput, MailSuppressionListOptions, MailSuppressionListResult } from './mail-phase4-types.js';
+import type { MailBounce, MailBounceListOptions, MailBounceListResult, MailSuppression, MailSuppressionCreateInput, MailSuppressionListOptions, MailSuppressionListResult } from './mail-delivery-types.js';
 import type { MailOtpChallenge, MailOtpChallengeListOptions, MailOtpChallengeListResult, MailOtpSendInput, MailOtpSendResponse, MailOtpVerifyInput, MailOtpVerifyResponse } from './mail-otp-types.js';
 import type { MailSendTemplateInput, MailSendTemplateResponse, MailTemplate, MailTemplateCreateInput, MailTemplateDetail, MailTemplateListOptions, MailTemplateListResult, MailTemplatePreview, MailTemplatePreviewInput, MailTemplateTestSendInput, MailTemplateTestSendResponse, MailTemplateUpdateInput, MailTemplateVersion } from './mail-template-types.js';
 import { MailAnalyticsClient, MailBatchClient, MailInboundClient, MailScheduledClient } from './mail-advanced.js';
@@ -8,6 +8,13 @@ export { MailAnalyticsClient, MailBatchClient, MailInboundClient, MailScheduledC
 import type { MailLimits, MailReputation, MailReputationEventListOptions, MailReputationEventListResult } from './mail-reputation-types.js';
 export { MailEventsClient, MailWebhooksClient, verifyWebhookSignature } from './mail-events-webhooks.js';
 import { MailEventsClient, MailWebhooksClient } from './mail-events-webhooks.js';
+import { MailStreamsClient } from './mail-streams.js';
+export { MailStreamsClient } from './mail-streams.js';
+import { MailAudiencesClient, MailCampaignsClient } from './mail-campaigns.js';
+export { MailAudiencesClient, MailCampaignsClient } from './mail-campaigns.js';
+import { MailExportsClient } from './mail-exports.js';
+export { MailExportsClient } from './mail-exports.js';
+import type { MailTemplateDiagnosticInput, MailTemplateDiagnosticResult } from './mail-diagnostics.js';
 export declare class MailClient {
     private readonly client;
     readonly domains: MailDomainsClient;
@@ -18,6 +25,10 @@ export declare class MailClient {
     readonly templates: MailTemplatesClient;
     readonly events: MailEventsClient;
     readonly webhooks: MailWebhooksClient;
+    readonly streams: MailStreamsClient;
+    readonly audiences: MailAudiencesClient;
+    readonly campaigns: MailCampaignsClient;
+    readonly exports: MailExportsClient;
     readonly limits: MailLimitsClient;
     readonly reputation: MailReputationClient;
     readonly scheduled: MailScheduledClient;
@@ -58,6 +69,7 @@ export declare class MailTemplatesClient {
     getVersion(templateId: string, versionId: string): Promise<MailTemplateVersion>;
     activateVersion(templateId: string, versionId: string): Promise<MailTemplate>;
     preview(templateId: string, input: MailTemplatePreviewInput): Promise<MailTemplatePreview>;
+    diagnostics(templateId: string, input?: MailTemplateDiagnosticInput): Promise<MailTemplateDiagnosticResult>;
     testSend(templateId: string, input: MailTemplateTestSendInput): Promise<MailTemplateTestSendResponse>;
 }
 export declare class MailDomainsClient {
@@ -83,7 +95,7 @@ export declare class MailMessagesClient {
     bounces(messageId: string): Promise<{
         data: MailBounce[];
     }>;
-    timeline(messageId: string): Promise<{
+    timeline(messageId: string, recipient?: string): Promise<{
         data: import("./mail-webhook-types.js").MailTimelineItem[];
     }>;
 }

package/dist/mail.js

@@ -2,6 +2,12 @@ import { MailAnalyticsClient, MailBatchClient, MailInboundClient, MailScheduledC
 export { MailAnalyticsClient, MailBatchClient, MailInboundClient, MailScheduledClient } from './mail-advanced.js';
 export { MailEventsClient, MailWebhooksClient, verifyWebhookSignature } from './mail-events-webhooks.js';
 import { MailEventsClient, MailWebhooksClient, timeline } from './mail-events-webhooks.js';
+import { MailStreamsClient } from './mail-streams.js';
+export { MailStreamsClient } from './mail-streams.js';
+import { MailAudiencesClient, MailCampaignsClient } from './mail-campaigns.js';
+export { MailAudiencesClient, MailCampaignsClient } from './mail-campaigns.js';
+import { MailExportsClient } from './mail-exports.js';
+export { MailExportsClient } from './mail-exports.js';
 export class MailClient {
     client;
     domains;
@@ -12,6 +18,10 @@ export class MailClient {
     templates;
     events;
     webhooks;
+    streams;
+    audiences;
+    campaigns;
+    exports;
     limits;
     reputation;
     scheduled;
@@ -28,6 +38,10 @@ export class MailClient {
         this.templates = new MailTemplatesClient(client);
         this.events = new MailEventsClient(client);
         this.webhooks = new MailWebhooksClient(client);
+        this.streams = new MailStreamsClient(client);
+        this.audiences = new MailAudiencesClient(client);
+        this.campaigns = new MailCampaignsClient(client);
+        this.exports = new MailExportsClient(client);
         this.limits = new MailLimitsClient(client);
         this.reputation = new MailReputationClient(client);
         this.scheduled = new MailScheduledClient(client);
@@ -134,6 +148,12 @@ export class MailTemplatesClient {
             body: input,
         });
     }
+    diagnostics(templateId, input = {}) {
+        return this.client.mailRequest(`/mail/templates/${encodeURIComponent(templateId)}/diagnostics`, {
+            method: 'POST',
+            body: input,
+        });
+    }
     testSend(templateId, input) {
         return this.client.mailRequest(`/mail/templates/${encodeURIComponent(templateId)}/test-send`, {
             method: 'POST',
@@ -196,8 +216,8 @@ export class MailMessagesClient {
     bounces(messageId) {
         return this.client.mailRequest(`/mail/messages/${encodeURIComponent(messageId)}/bounces`);
     }
-    timeline(messageId) {
-        return timeline(this.client, messageId);
+    timeline(messageId, recipient) {
+        return timeline(this.client, messageId, recipient);
     }
 }
 export class MailSuppressionsClient {

package/dist/types.d.ts

@@ -9,7 +9,8 @@ export interface StackShiftOptions {
     cdnBaseUrl?: string;
     fetch?: typeof fetch;
 }
-export type MailStatus = 'queued' | 'sending' | 'sent' | 'deferred' | 'failed' | 'bounced' | 'suppressed';
+export type MailStatus = 'queued' | 'sending' | 'mta_accepted' | 'delayed' | 'delivered' | 'bounced' | 'failed' | 'suppressed' | 'complained' | 'partial';
+export type MailRecipientStatus = Exclude<MailStatus, 'partial'>;
 export type MailIdempotencyStatus = 'created' | 'reused';
 export type MailDomainStatus = 'pending' | 'verified' | 'failed' | 'disabled';
 export type MailRecordStatus = 'missing' | 'pending' | 'verified' | 'failed';
@@ -58,7 +59,12 @@ export interface MailSendInput {
         uploadId?: string;
         filename: string;
         contentType?: string;
+        disposition?: 'attachment' | 'inline';
+        contentId?: string;
     }>;
+    headers?: Record<string, string>;
+    tags?: Record<string, string>;
+    stream?: string;
 }
 export interface MailSendResponse {
     id: string;
@@ -81,7 +87,7 @@ export interface MailMessage {
     createdAt: string;
     queuedAt?: string | null;
     sendingAt?: string | null;
-    sentAt?: string | null;
+    mtaAcceptedAt?: string | null;
     failedAt?: string | null;
     bouncedAt?: string | null;
     suppressedAt?: string | null;
@@ -89,6 +95,47 @@ export interface MailMessage {
     bounceReason?: string | null;
     finalSmtpStatusCode?: string | null;
     finalSmtpResponse?: string | null;
+    recipients?: MailRecipient[];
+    recipientSummary?: MailRecipientSummary;
+    headers?: Record<string, string>;
+    tags?: Record<string, string>;
+    stream?: string;
+    streamType?: string;
+}
+export interface MailRecipient {
+    id: string;
+    messageId: string;
+    kind: 'to' | 'cc' | 'bcc';
+    email: string;
+    status: MailRecipientStatus;
+    rfcMessageId?: string | null;
+    postfixQueueId?: string | null;
+    remoteMx?: string | null;
+    provider?: string | null;
+    smtpStatus?: string | null;
+    enhancedStatus?: string | null;
+    smtpResponse?: string | null;
+    latencyMs?: number | null;
+    disposition?: string | null;
+    bounceCategory?: string | null;
+    suppressionAction?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    mtaAcceptedAt?: string | null;
+    deliveredAt?: string | null;
+    bouncedAt?: string | null;
+    complainedAt?: string | null;
+}
+export interface MailRecipientSummary {
+    queued: number;
+    sending: number;
+    mtaAccepted: number;
+    delayed: number;
+    delivered: number;
+    bounced: number;
+    failed: number;
+    suppressed: number;
+    complained: number;
 }
 export interface MailMessageSummary {
     id: string;
@@ -98,7 +145,7 @@ export interface MailMessageSummary {
     status: MailStatus;
     createdAt: string;
     queuedAt?: string | null;
-    sentAt?: string | null;
+    mtaAcceptedAt?: string | null;
 }
 export interface MailMessageListOptions {
     status?: MailStatus;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackshift-cloud/sdk",
-  "version": "0.1.4",
+  "version": "1.0.0",
   "description": "Official JavaScript and TypeScript SDK for StackShift.",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test": "npm run build && node test/mail.test.mjs && node test/mail-webhooks.test.mjs && node test/mail-advanced.test.mjs && node test/assets.test.mjs"
+    "test": "npm run build && node test/mail.test.mjs && node test/mail-webhooks.test.mjs && node test/mail-advanced.test.mjs && node test/mail-exports.test.mjs && node test/mail-diagnostics.test.mjs && node test/assets.test.mjs"
   },
   "devDependencies": {
     "typescript": "^5.4.0"