@stackshift-cloud/sdk 0.1.3 → 1.0.0

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;
@@ -149,12 +196,13 @@ export interface Asset {
     size: number;
     checksum_sha256: string;
     visibility: AssetVisibility;
-    status: 'uploading' | 'available' | 'deleted' | 'failed';
+    status: 'processing' | 'ready' | 'quarantined' | 'failed' | 'deleting' | 'deleted';
     replication_status: 'pending' | 'replicated' | 'degraded' | 'failed';
     scan_status?: 'pending' | 'clean' | 'infected' | 'failed' | 'skipped';
     scan_result?: string;
     quarantine_status?: 'none' | 'infected' | 'policy';
     video_status?: 'none' | 'pending' | 'processing' | 'ready' | 'failed' | 'skipped';
+    video_progress_percent?: number;
     ai_status?: 'pending' | 'processing' | 'ready' | 'failed' | 'skipped';
     moderation_status?: 'pending' | 'processing' | 'clean' | 'flagged' | 'quarantined' | 'failed';
     moderation_reason?: string;
@@ -166,6 +214,8 @@ export interface Asset {
     video?: AssetVideoInfo;
     ai?: AssetAIInfo;
     url?: string;
+    generation: number;
+    revision: number;
     created_at: string;
     updated_at: string;
 }
@@ -257,6 +307,13 @@ export interface AssetListOptions {
     type?: string;
     folder?: string;
     checksum?: string;
+    status?: Asset['status'];
+    scanStatus?: string;
+    replicationStatus?: string;
+    moderationStatus?: string;
+    quarantineStatus?: string;
+    sort?: 'created_at' | 'updated_at' | 'size' | 'key' | 'original_name' | 'mime_type';
+    direction?: 'asc' | 'desc';
     limit?: number;
     cursor?: string;
 }
@@ -282,6 +339,55 @@ export interface AssetSignedUploadUrlOptions extends AssetUploadOptions {
     partSize?: number;
     expiresIn?: string;
     maxBytes?: number;
+    idempotencyKey?: string;
+    /** Resume an existing multipart upload instead of creating another session. */
+    uploadSessionId?: string;
+    /** Multipart worker count. Defaults to 4 and is capped at 8. */
+    concurrency?: number;
+    /** Attempts per multipart request. Defaults to 4 and is capped at 8. */
+    retryAttempts?: number;
+}
+export interface AssetBucket {
+    id: string;
+    name: string;
+    default_visibility: AssetVisibility;
+    cache_control?: string;
+    versioning: boolean;
+    retention_days: number;
+    max_object_bytes?: number;
+    allowed_mime_types: string[];
+    home_region: string;
+    replication_policy: 'global-3';
+    cors_origins: string[];
+    allowed_origins: string[];
+    lifecycle_policy: Record<string, unknown>;
+    custom_domain_id?: string;
+    revision: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface AssetBucketInput {
+    name?: string;
+    default_visibility?: AssetVisibility;
+    cache_control?: string;
+    versioning?: boolean;
+    retention_days?: number;
+    max_object_bytes?: number;
+    allowed_mime_types?: string[];
+    home_region?: string;
+    replication_policy?: 'global-3';
+    cors_origins?: string[];
+    allowed_origins?: string[];
+    lifecycle_policy?: Record<string, unknown>;
+    custom_domain_id?: string;
+}
+export interface AssetPatchInput {
+    bucket?: string;
+    key?: string;
+    original_name?: string;
+    cache_control?: string;
+    clear_cache_control?: boolean;
+    visibility?: AssetVisibility;
 }
 export interface AssetSignedUploadUrl {
     upload_session_id: string;
@@ -311,10 +417,24 @@ export interface AssetUploadProgressCallbacks {
         total: number;
         percent: number;
     }) => void;
+    /** Cancels in-flight browser requests and the server-side upload session. */
+    signal?: AbortSignal;
 }
 export interface AssetUsageSummary {
     total_assets: number;
     total_bytes: number;
+    period_ingress_bytes: number;
+    period_egress_bytes: number;
+    period_origin_bytes: number;
+    period_verification_bytes: number;
+    period_transform_count: number;
+    period_ai_requests: number;
+    period_logical_storage_byte_hours: number;
+    period_physical_storage_byte_hours: number;
+    period_derived_storage_byte_hours: number;
+    period_transform_compute_ms: number;
+    period_video_input_seconds: number;
+    period_ai_cost_micros: number;
     by_bucket: Record<string, number>;
     by_mime_family: Record<string, number>;
     by_visibility: Record<string, number>;
@@ -324,6 +444,97 @@ export interface AssetUsageSummary {
         total_bytes: number;
     }>;
 }
+export interface AssetJobSubmission {
+    job_id: string;
+    status: string;
+    status_url: string;
+}
+export interface AssetJob {
+    id: string;
+    job_name: string;
+    status: string;
+    progress_percent: number;
+    phase: 'queued' | 'processing' | 'waiting' | 'ready' | 'failed' | 'cancelled' | string;
+    attempt: number;
+    max_attempts: number;
+    created_at: string;
+    started_at?: string;
+    completed_at?: string;
+    error?: string;
+}
+export interface AssetAIPolicy {
+    enabled_actions: Array<'analyze' | 'transcribe' | 'smart_crop' | 'background_remove'>;
+    monthly_spend_cap_micros: number;
+    revision: number;
+}
+export interface AssetAIAccountConfig {
+    provider: string;
+    configured: boolean;
+    actions: string[];
+    policy: AssetAIPolicy;
+    monthly_spend_used_micros: number;
+}
+export interface AssetLifecycleRule {
+    id: string;
+    name: string;
+    prefix?: string;
+    action: 'delete' | 'expire_versions';
+    age_days: number;
+    enabled: boolean;
+    created_at: string;
+    updated_at: string;
+    last_run_at?: string;
+    last_error?: string;
+}
+export interface AssetCustomDomain {
+    id: string;
+    domain: string;
+    status: string;
+    verification_name: string;
+    verification_value: string;
+    last_error?: string;
+    provider_domain_id?: string;
+    certificate_id?: string;
+    created_at: string;
+    updated_at: string;
+    verified_at?: string;
+}
+export interface AssetEvent {
+    id: string;
+    asset_id?: string;
+    type: string;
+    data: Record<string, unknown>;
+    created_at: string;
+}
+export interface AssetWebhook {
+    id: string;
+    url: string;
+    event_types: string[];
+    status: 'active' | 'disabled';
+    failure_count: number;
+    last_success_at?: string;
+    last_failure_at?: string;
+    disabled_at?: string;
+    created_by: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface AssetWebhookDelivery {
+    id: string;
+    webhook_id: string;
+    event_id: string;
+    event_type: string;
+    payload: Record<string, unknown>;
+    status: 'pending' | 'delivering' | 'succeeded' | 'failed';
+    attempt_count: number;
+    next_attempt_at: string;
+    status_code?: number;
+    response_snippet?: string;
+    error_message?: string;
+    created_at: string;
+    updated_at: string;
+    delivered_at?: string;
+}
 export interface AssetContentPolicy {
     allowed_mime_types: string[];
     max_image_bytes: number;
@@ -340,6 +551,8 @@ export interface AssetTransformOptions {
     crop?: AssetTransformCrop;
     format?: AssetTransformFormat;
     quality?: AssetTransformQuality;
+    gravity?: 'centre' | 'attention' | 'entropy';
+    animation?: 'first' | 'reject';
 }
 export interface AssetNamedTransformInput extends AssetTransformOptions {
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackshift-cloud/sdk",
-  "version": "0.1.3",
+  "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"