@stackshift-cloud/sdk 0.1.0 → 0.1.2

package/dist/types.d.ts

@@ -5,8 +5,129 @@ export type AssetVisibility = 'public' | 'private';
 export interface StackShiftOptions {
     apiKey?: string;
     baseUrl?: string;
+    mailBaseUrl?: string;
+    cdnBaseUrl?: string;
     fetch?: typeof fetch;
 }
+export type MailStatus = 'queued' | 'sending' | 'sent' | 'deferred' | 'failed' | 'bounced' | 'suppressed';
+export type MailIdempotencyStatus = 'created' | 'reused';
+export type MailDomainStatus = 'pending' | 'verified' | 'failed' | 'disabled';
+export type MailRecordStatus = 'missing' | 'pending' | 'verified' | 'failed';
+export interface MailDnsRecord {
+    type: 'TXT' | 'CNAME' | 'MX' | string;
+    name: string;
+    value: string;
+    status: MailRecordStatus;
+    required: boolean;
+    explanation?: string;
+}
+export interface MailDomain {
+    id: string;
+    domain: string;
+    status: MailDomainStatus;
+    spfStatus: MailRecordStatus;
+    dkimStatus: MailRecordStatus;
+    dmarcStatus: MailRecordStatus;
+    returnPathStatus: MailRecordStatus;
+    records?: MailDnsRecord[];
+    createdAt: string;
+    verifiedAt?: string | null;
+    lastCheckedAt?: string | null;
+}
+export interface MailDomainListResult {
+    data: MailDomain[];
+    nextCursor?: string | null;
+}
+export interface MailAddress {
+    email: string;
+    name?: string;
+}
+export type MailAddressInput = string | MailAddress | Array<string | MailAddress>;
+export interface MailSendInput {
+    from: string | MailAddress;
+    to: MailAddressInput;
+    cc?: MailAddressInput;
+    bcc?: MailAddressInput;
+    replyTo?: string | MailAddress;
+    subject: string;
+    html?: string;
+    text?: string;
+    idempotencyKey?: string;
+    attachments?: Array<{
+        assetId?: string;
+        uploadId?: string;
+        filename: string;
+        contentType?: string;
+    }>;
+}
+export interface MailSendResponse {
+    id: string;
+    status: MailStatus;
+    idempotencyStatus: MailIdempotencyStatus;
+}
+export interface MailMessage {
+    id: string;
+    from: MailAddress;
+    to: string[];
+    cc: string[];
+    bcc: string[];
+    replyTo?: string | null;
+    subject: string;
+    html?: string | null;
+    text?: string | null;
+    status: MailStatus;
+    errorCode?: string | null;
+    errorMessage?: string | null;
+    createdAt: string;
+    queuedAt?: string | null;
+    sendingAt?: string | null;
+    sentAt?: string | null;
+    failedAt?: string | null;
+    bouncedAt?: string | null;
+    suppressedAt?: string | null;
+    bounceType?: 'hard' | 'soft' | null;
+    bounceReason?: string | null;
+    finalSmtpStatusCode?: string | null;
+    finalSmtpResponse?: string | null;
+}
+export interface MailMessageSummary {
+    id: string;
+    from: string;
+    to: string[];
+    subject: string;
+    status: MailStatus;
+    createdAt: string;
+    queuedAt?: string | null;
+    sentAt?: string | null;
+}
+export interface MailMessageListOptions {
+    status?: MailStatus;
+    limit?: number;
+    cursor?: string;
+    to?: string;
+    from?: string;
+}
+export interface MailMessageListResult {
+    data: MailMessageSummary[];
+    nextCursor?: string | null;
+}
+export interface MailSendAttempt {
+    id: string;
+    attemptNumber: number;
+    status: 'started' | 'accepted_by_mta' | 'deferred' | 'failed';
+    mtaQueueId?: string | null;
+    smtpStatusCode?: string | null;
+    smtpResponse?: string | null;
+    startedAt: string;
+    completedAt?: string | null;
+}
+export interface MailLog {
+    level: 'info' | 'warn' | 'error' | string;
+    event: string;
+    message: string;
+    metadata?: JsonValue;
+    createdAt: string;
+}
 export interface Project {
     id: string;
     name: string;
@@ -30,12 +151,94 @@ export interface Asset {
     visibility: AssetVisibility;
     status: 'uploading' | 'available' | 'deleted' | 'failed';
     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';
+    ai_status?: 'pending' | 'processing' | 'ready' | 'failed' | 'skipped';
+    moderation_status?: 'pending' | 'processing' | 'clean' | 'flagged' | 'quarantined' | 'failed';
+    moderation_reason?: string;
+    current_version_id?: string;
+    default_branch?: string;
     metadata?: Record<string, JsonValue>;
     cache_control?: string;
+    tags?: string[];
+    video?: AssetVideoInfo;
+    ai?: AssetAIInfo;
     url?: string;
     created_at: string;
     updated_at: string;
 }
+export interface AssetAIInfo {
+    annotation?: AssetAIAnnotation;
+    moderation?: AssetModerationResult;
+    transcript?: AssetTranscript;
+}
+export interface AssetAIAnnotation {
+    provider: string;
+    model: string;
+    status: string;
+    caption?: string;
+    alt_text?: string;
+    tags: string[];
+    objects: string[];
+    colors: string[];
+    raw?: JsonValue;
+}
+export interface AssetModerationResult {
+    id: string;
+    provider: string;
+    model: string;
+    status: string;
+    flagged: boolean;
+    categories: Record<string, boolean>;
+    category_scores: Record<string, number>;
+    reason?: string;
+    created_at: string;
+}
+export interface AssetTranscript {
+    provider: string;
+    model: string;
+    status: string;
+    language?: string;
+    text?: string;
+    segments?: JsonValue[];
+}
+export interface AssetVersion {
+    id: string;
+    asset_id: string;
+    branch: string;
+    version_number: number;
+    parent_version_id?: string;
+    original_name: string;
+    mime_type: string;
+    size: number;
+    checksum_sha256: string;
+    metadata?: Record<string, JsonValue>;
+    cache_control?: string;
+    created_at: string;
+}
+export interface AssetCollection {
+    id: string;
+    name: string;
+    description?: string;
+    asset_ids?: string[];
+    created_at: string;
+    updated_at: string;
+}
+export interface AssetSavedSearch {
+    id: string;
+    name: string;
+    filters: Record<string, JsonValue>;
+    created_at: string;
+    updated_at: string;
+}
+export interface AssetVideoInfo {
+    metadata?: Record<string, JsonValue>;
+    outputs?: Array<Record<string, JsonValue>>;
+    hls_url?: string;
+    poster_url?: string;
+}
 export interface AssetUploadOptions {
     bucket?: string;
     key?: string;
@@ -48,6 +251,12 @@ export interface AssetListOptions {
     bucket?: string;
     prefix?: string;
     visibility?: AssetVisibility;
+    query?: string;
+    tag?: string;
+    mimeType?: string;
+    type?: string;
+    folder?: string;
+    checksum?: string;
     limit?: number;
     cursor?: string;
 }
@@ -65,13 +274,83 @@ export interface AssetSignedUrl {
     expires_at: string;
 }
 export interface AssetSignedUploadUrlOptions extends AssetUploadOptions {
+    mode?: 'single' | 'chunked';
+    fileName?: string;
+    fileSize?: number;
+    mimeType?: string;
+    checksumSHA256?: string;
+    partSize?: number;
     expiresIn?: string;
     maxBytes?: number;
 }
 export interface AssetSignedUploadUrl {
     upload_session_id: string;
+    session_id?: string;
+    mode?: 'single' | 'chunked';
     url: string;
     method: 'PUT';
     expires_at: string;
     max_bytes: number;
+    part_size?: number;
+    parts?: AssetChunkUploadPart[];
+}
+export interface AssetChunkUploadPart {
+    part_number: number;
+    size: number;
+    checksum_sha256: string;
+    created_at: string;
+}
+export interface AssetUploadProgressCallbacks {
+    onProgress?: (progress: {
+        loaded: number;
+        total: number;
+        percent: number;
+    }) => void;
+    onPartProgress?: (part: number, progress: {
+        loaded: number;
+        total: number;
+        percent: number;
+    }) => void;
+}
+export interface AssetUsageSummary {
+    total_assets: number;
+    total_bytes: number;
+    by_bucket: Record<string, number>;
+    by_mime_family: Record<string, number>;
+    by_visibility: Record<string, number>;
+    duplicate_groups: Array<{
+        checksum_sha256: string;
+        asset_count: number;
+        total_bytes: number;
+    }>;
+}
+export interface AssetContentPolicy {
+    allowed_mime_types: string[];
+    max_image_bytes: number;
+    max_video_bytes: number;
+    max_other_bytes: number;
+    require_scan: boolean;
+}
+export type AssetTransformCrop = 'fit' | 'fill';
+export type AssetTransformFormat = 'auto' | 'webp' | 'avif' | 'jpeg' | 'jpg' | 'png';
+export type AssetTransformQuality = 'auto' | number;
+export interface AssetTransformOptions {
+    width?: number;
+    height?: number;
+    crop?: AssetTransformCrop;
+    format?: AssetTransformFormat;
+    quality?: AssetTransformQuality;
+}
+export interface AssetNamedTransformInput extends AssetTransformOptions {
+    name: string;
+}
+export interface AssetSignedTransformOptions extends AssetTransformOptions {
+    expiresIn?: string;
+}
+export type AssetTransformPresetCategory = 'responsive-web' | 'social' | 'product' | 'avatar-profile' | 'performance' | 'email-docs';
+export interface AssetTransformPreset extends AssetTransformOptions {
+    id: string;
+    name: string;
+    category: AssetTransformPresetCategory;
+    description: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackshift-cloud/sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Official JavaScript and TypeScript SDK for StackShift.",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,7 +16,8 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json"
+    "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"
   },
   "devDependencies": {
     "typescript": "^5.4.0"