@stackshift-cloud/sdk 1.2.0 → 1.3.1

package/README.md

@@ -34,6 +34,27 @@ Set your API key:
 STACKSHIFT_API_KEY=sk_live_xxx
 ```
 
+## AI credits
+
+AI credits are account-scoped. Inspect the balance and usage, create a top-up checkout, or choose managed billing versus your own provider key:
+
+```ts
+import { StackShift } from '@stackshift-cloud/sdk'
+
+const stackshift = new StackShift()
+const balance = await stackshift.aiCredits.balance()
+const usage = await stackshift.aiCredits.usage({ product: 'assets', limit: 25 })
+const quote = await stackshift.aiCredits.quote(1_000, 'USD')
+const checkout = await stackshift.aiCredits.checkout({
+  quote_id: quote.id,
+  idempotency_key: crypto.randomUUID(),
+  provider: 'paystack',
+})
+await stackshift.aiCredits.setFunding('assets', 'managed')
+```
+
+Keep account API keys and checkout creation on your server. An Assets space ID does not change which billing account these methods use.
+
 ## Send email
 
 ```ts

package/dist/ai-credits.d.ts

@@ -0,0 +1,78 @@
+import type { StackShift } from './client.js';
+export interface AICreditGrant {
+    id: string;
+    kind: string;
+    source: string;
+    policy_revision: number;
+    amount_microcredits: number;
+    remaining_microcredits: number;
+    available_at: string;
+    expires_at: string | null;
+}
+export interface AICreditBalance {
+    available_microcredits: number;
+    monthly_microcredits: number;
+    purchased_microcredits: number;
+    reserved_microcredits: number;
+    shortfall_microcredits: number;
+    next_reset: string;
+    grants: AICreditGrant[];
+}
+export interface AICreditUsage {
+    id: string;
+    operation_key: string;
+    product: string;
+    feature: string;
+    user_id: string;
+    project_id?: string;
+    space_id?: string;
+    parent_task_id?: string;
+    funding_mode: string;
+    state: string;
+    created_at: string;
+    reserved_microcredits: number;
+    used_microcredits: number;
+    returned_microcredits: number;
+}
+export interface AICreditUsagePage {
+    items: AICreditUsage[];
+    totals_microcredits: Record<string, number>;
+}
+export interface AICreditQuote {
+    id: string;
+    catalog_revision: number;
+    credit_microcredits: number;
+    amount_minor: number;
+    currency: string;
+    expires_at: string;
+}
+export interface AICreditCheckout {
+    reference: string;
+    status: string;
+    authorization_url?: string;
+}
+export type AIFundingPreferences = Record<'assets' | 'agents' | 'workflows', 'managed' | 'byok'>;
+export declare class AICreditsClient {
+    private readonly client;
+    constructor(client: StackShift);
+    balance(): Promise<AICreditBalance>;
+    usage(filters?: {
+        product?: string;
+        user?: string;
+        project?: string;
+        space?: string;
+        from?: string;
+        until?: string;
+        before_time?: string;
+        before_id?: string;
+        limit?: number;
+    }): Promise<AICreditUsagePage>;
+    quote(credits: number, currency: 'USD' | 'NGN'): Promise<AICreditQuote>;
+    checkout(input: {
+        quote_id: string;
+        idempotency_key: string;
+        provider: string;
+    }): Promise<AICreditCheckout>;
+    funding(): Promise<AIFundingPreferences>;
+    setFunding(product: 'assets' | 'agents' | 'workflows', mode: 'managed' | 'byok'): Promise<AIFundingPreferences>;
+}

package/dist/ai-credits.js

@@ -0,0 +1,15 @@
+export class AICreditsClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    balance() { return this.client.request('/billing/ai-credits', { method: 'GET' }); }
+    usage(filters = {}) {
+        const query = new URLSearchParams(Object.entries(filters).filter(([, v]) => v !== undefined).map(([k, v]) => [k, String(v)]));
+        return this.client.request(`/billing/ai-credits/usage?${query}`, { method: 'GET' });
+    }
+    quote(credits, currency) { return this.client.request('/billing/ai-credits/top-ups/quote', { method: 'POST', body: { credits, currency } }); }
+    checkout(input) { return this.client.request('/billing/ai-credits/top-ups/checkout', { method: 'POST', body: input }); }
+    funding() { return this.client.request('/billing/ai-credits/funding', { method: 'GET' }); }
+    setFunding(product, mode) { return this.client.request('/billing/ai-credits/funding', { method: 'PUT', body: { product, mode } }); }
+}

package/dist/assets-dam-types.d.ts

@@ -129,6 +129,36 @@ export interface AssetModelPackage {
     report: Record<string, unknown>;
     updated_at: string;
 }
+export interface AssetModelTextureOverride {
+    texture_index: number;
+    asset_id: string;
+    version_id: string;
+    checksum_sha256: string;
+}
+export interface AssetModelVariant {
+    id: string;
+    asset_id: string;
+    source_version_id: string;
+    source_checksum_sha256: string;
+    name: string;
+    swatch: {
+        label: string;
+        color: string;
+    };
+    texture_overrides: AssetModelTextureOverride[];
+    revision: number;
+}
+export interface AssetModelVariantInput {
+    name: string;
+    source_version_id: string;
+    source_checksum_sha256: string;
+    swatch: {
+        label: string;
+        color: string;
+    };
+    texture_overrides: AssetModelTextureOverride[];
+    expected_revision?: number;
+}
 export interface AssetGalleryEntryInput {
     publication_id: string;
     fallback_publication_id?: string;
@@ -170,12 +200,14 @@ export interface AssetRenderRecipe {
     background: string;
     size: 512 | 1024;
 }
-export type AssetRenderOutput = 'proof' | 'poster' | 'spin' | 'turntable';
+export type AssetRenderOutput = 'proof' | 'poster' | 'spin' | 'turntable' | 'model' | 'usdz';
 export interface AssetRenderInput {
     version_id: string;
     source_checksum: string;
     recipe: AssetRenderRecipe;
     outputs: AssetRenderOutput[];
+    variant_id?: string;
+    variant_revision?: number;
 }
 export interface AssetRenderEstimate {
     units: number;
@@ -197,6 +229,8 @@ export interface AssetRenderSet {
     source_checksum: string;
     recipe: AssetRenderRecipe;
     requested: AssetRenderOutput[];
+    variant_id?: string;
+    variant_revision?: number;
     status: 'queued' | 'processing' | 'ready' | 'failed';
     can_retry: boolean;
     units: number;

package/dist/assets-dam.d.ts

@@ -1,7 +1,7 @@
 import type { StackShift } from './client.js';
 import type { AssetJobSubmission } from './types.js';
 import type { AssetRenderInput, AssetRenderEstimate, AssetRenderSubmission, AssetRenderingInfo } from './assets-dam-types.js';
-import type { AssetAction, AssetSpaceAccess, AssetCollaborator, AssetMetadataSchema, AssetMetadataField, AssetBucketGovernance, AssetPublication, AssetPublicationInput, AssetPublicationStatus, AssetPublicationDelivery, AssetMediaReference, AssetPickerCapability, AssetPickerCapabilityInput, AssetModelPackage, AssetGallery, AssetGalleryEntryInput, AssetGalleryDelivery } from './assets-dam-types.js';
+import type { AssetAction, AssetSpaceAccess, AssetCollaborator, AssetMetadataSchema, AssetMetadataField, AssetBucketGovernance, AssetPublication, AssetPublicationInput, AssetPublicationStatus, AssetPublicationDelivery, AssetMediaReference, AssetPickerCapability, AssetPickerCapabilityInput, AssetModelPackage, AssetModelVariant, AssetModelVariantInput, AssetGallery, AssetGalleryEntryInput, AssetGalleryDelivery } from './assets-dam-types.js';
 export declare class AssetDAMClient {
     private readonly client;
     constructor(client: StackShift);
@@ -62,6 +62,10 @@ export declare class AssetDAMClient {
     transitionPublication(id: string, revision: number, action: 'submit' | 'approve' | 'request-changes' | 'publish' | 'withdraw', note?: string): Promise<AssetPublication>;
     resolvePublication(id: string, preview?: boolean): Promise<AssetPublicationDelivery>;
     resolvePublicationAR(id: string): Promise<AssetPublicationDelivery>;
+    createPublicationARHandoff(id: string): Promise<{
+        handoff_url: string;
+        expires_at: string;
+    }>;
     createPickerCapability(input: AssetPickerCapabilityInput): Promise<{
         token: string;
         capability: AssetPickerCapability;
@@ -78,6 +82,12 @@ export declare class AssetDAMClient {
     estimateRender(assetId: string, revision: number, input: AssetRenderInput): Promise<AssetRenderEstimate>;
     renderProduct(assetId: string, revision: number, idempotencyKey: string, input: AssetRenderInput, maximumUnits: number): Promise<AssetRenderSubmission>;
     processModel(assetId: string, revision: number, idempotencyKey: string): Promise<AssetJobSubmission>;
+    modelVariants(assetId: string): Promise<AssetModelVariant[]>;
+    createModelVariant(assetId: string, revision: number, input: AssetModelVariantInput): Promise<AssetModelVariant>;
+    updateModelVariant(assetId: string, variantId: string, revision: number, input: AssetModelVariantInput): Promise<AssetModelVariant>;
+    deleteModelVariant(assetId: string, variantId: string, assetRevision: number, variantRevision: number): Promise<{
+        deleted: boolean;
+    }>;
     galleries(cursor?: string): Promise<{
         galleries: AssetGallery[];
         next_cursor: string;

package/dist/assets-dam.js

@@ -32,12 +32,17 @@ export class AssetDAMClient {
     transitionPublication(id, revision, action, note = '') { return this.client.request(`${path('publications', id)}/${action}`, { method: 'POST', headers: revisionHeaders(revision), body: { note } }); }
     resolvePublication(id, preview = false) { return this.client.request(`${path('publications', id)}/${preview ? 'preview' : 'resolve'}`); }
     resolvePublicationAR(id) { return this.client.request(`${path('publications', id)}/ar`, { method: 'POST' }); }
+    createPublicationARHandoff(id) { return this.client.request(`${path('publications', id)}/ar-handoff`, { method: 'POST' }); }
     createPickerCapability(input) { return this.client.request('/assets/picker-capabilities', { method: 'POST', body: input }); }
     revokePickerCapability(id) { return this.client.request(path('picker-capabilities', id), { method: 'DELETE' }); }
     models(assetId) { return this.client.request(`/assets/${encodeURIComponent(assetId)}/models`); }
     estimateRender(assetId, revision, input) { return this.client.request(`/assets/${encodeURIComponent(assetId)}/models`, { method: 'POST', headers: revisionHeaders(revision), body: { ...input, operation: 'estimate' } }); }
     renderProduct(assetId, revision, idempotencyKey, input, maximumUnits) { return this.client.request(`/assets/${encodeURIComponent(assetId)}/models`, { method: 'POST', headers: { ...revisionHeaders(revision), 'Idempotency-Key': idempotencyKey }, body: { ...input, operation: 'render', maximum_units: maximumUnits } }); }
     processModel(assetId, revision, idempotencyKey) { return this.client.request(`/assets/${encodeURIComponent(assetId)}/models`, { method: 'POST', headers: { ...revisionHeaders(revision), 'Idempotency-Key': idempotencyKey } }); }
+    modelVariants(assetId) { return this.client.request(`/assets/${encodeURIComponent(assetId)}/model-variants`); }
+    createModelVariant(assetId, revision, input) { return this.client.request(`/assets/${encodeURIComponent(assetId)}/model-variants`, { method: 'POST', headers: revisionHeaders(revision), body: input }); }
+    updateModelVariant(assetId, variantId, revision, input) { return this.client.request(`/assets/${encodeURIComponent(assetId)}/model-variants/${encodeURIComponent(variantId)}`, { method: 'PUT', headers: revisionHeaders(revision), body: input }); }
+    deleteModelVariant(assetId, variantId, assetRevision, variantRevision) { return this.client.request(`/assets/${encodeURIComponent(assetId)}/model-variants/${encodeURIComponent(variantId)}?revision=${variantRevision}`, { method: 'DELETE', headers: revisionHeaders(assetRevision) }); }
     galleries(cursor) { return this.client.request(`/assets/galleries${cursor ? '?cursor=' + encodeURIComponent(cursor) : ''}`); }
     createGallery(input) { return this.client.request('/assets/galleries', { method: 'POST', body: input }); }
     updateGallery(id, revision, input) { return this.client.request(path('galleries', id), { method: 'PUT', headers: revisionHeaders(revision), body: input }); }

package/dist/assets-platform-types.d.ts

@@ -209,10 +209,27 @@ export interface AssetTextExtractionInput {
     language?: string;
     options?: Record<string, JsonValue>;
 }
-export type AssetMigrationReport = {
+export interface AssetMigrationReconciliation {
+    discovered: number;
+    imported: number;
+    skipped: number;
+    failed: number;
+    canceled: number;
+    unresolved: number;
+    mapped: number;
+    verified_checksums: number;
+    missing_checksums: number;
+    warnings: Record<string, number>;
+    inventory_reconciled: boolean;
+    delivery_verified: boolean;
+    cutover_ready: boolean;
+    next_actions: string[];
+}
+export interface AssetMigrationReport {
     migration: AssetMigration;
     items: AssetMigrationItem[];
-} | Record<string, JsonValue>;
+    reconciliation?: AssetMigrationReconciliation;
+}
 export type AssetCapabilityUploadResult = Asset;
 export type AssetStorageBucket = AssetBucket;
 export {};

package/dist/client.d.ts

@@ -1,9 +1,11 @@
+import { AICreditsClient } from './ai-credits.js';
 import { AssetsClient } from './assets.js';
 import { MailClient } from './mail.js';
 import { ProjectsClient } from './projects.js';
 import { WorkloadSecurityClient } from './workload-security.js';
 import type { StackShiftOptions } from './types.js';
 export declare class StackShift {
+    readonly aiCredits: AICreditsClient;
     readonly assetSpaceId?: string;
     readonly apiKey: string;
     readonly baseUrl: string;

package/dist/client.js

@@ -1,3 +1,4 @@
+import { AICreditsClient } from './ai-credits.js';
 import { AssetsClient } from './assets.js';
 import { MailClient } from './mail.js';
 import { ProjectsClient } from './projects.js';
@@ -6,6 +7,7 @@ const defaultBaseUrl = 'https://api.stackshift.cloud/api/v1';
 const defaultMailBaseUrl = 'https://api.stackshift.cloud/v1';
 const defaultCdnBaseUrl = 'https://cdn.stackshift.cloud';
 export class StackShift {
+    aiCredits;
     assetSpaceId;
     apiKey;
     baseUrl;
@@ -27,6 +29,7 @@ export class StackShift {
         this.mailBaseUrl = (options.mailBaseUrl ?? defaultMailBaseUrl).replace(/\/$/, '');
         this.cdnBaseUrl = (options.cdnBaseUrl ?? defaultCdnBaseUrl).replace(/\/$/, '');
         this.fetcher = options.fetch ?? fetch;
+        this.aiCredits = new AICreditsClient(this);
         this.projects = new ProjectsClient(this);
         this.assets = new AssetsClient(this);
         this.mail = new MailClient(this);

package/dist/generated/assets-contract.d.ts

@@ -1,4 +1,4 @@
-export type AssetOperationId = 'putAssetAICredential' | 'deleteAssetAICredential' | 'openAssetAIOutput' | 'getVideoWorkspace' | 'processVideoVersion' | 'createVideoPlaybackSession' | 'revokeVideoPlaybackSession' | 'reviewVideoVersion' | 'listVideoCaptions' | 'addVideoCaption' | 'removeVideoCaption' | 'getVideoAnalytics' | 'createPublicVideoPlaybackSession' | 'renewVideoPlaybackSession' | 'recordVideoPlaybackEvents' | 'uploadAsset' | 'createUploadSession' | 'getUploadSession' | 'completeUploadSession' | 'cancelUploadSession' | 'createSignedUploadUrl' | 'createBucket' | 'listBuckets' | 'updateBucket' | 'deleteBucket' | 'configureBucketStorage' | 'startBucketRelocation' | 'createAssetConnection' | 'listAssetConnections' | 'getAssetConnection' | 'updateAssetConnection' | 'verifyAssetConnection' | 'deleteAssetConnection' | 'listOwnedS2Buckets' | 'createOwnedS2Bucket' | 'startAssetMigration' | 'listAssetMigrations' | 'getAssetMigration' | 'cancelAssetMigration' | 'retryAssetMigrationItem' | 'downloadAssetMigrationReport' | 'createAssetUploadCapability' | 'getContentPolicy' | 'updateContentPolicy' | 'upsertTransformation' | 'listTransformations' | 'materializeAssetTransform' | 'listAssetDerivatives' | 'generateAsset' | 'getAssetAutomation' | 'assetMCP' | 'getAssetWorkflowCatalog' | 'listAssetWorkflows' | 'createAssetWorkflow' | 'getAssetWorkflow' | 'updateAssetWorkflowDraft' | 'validateAssetWorkflow' | 'publishAssetWorkflow' | 'activateAssetWorkflow' | 'startAssetWorkflowRun' | 'listAssetWorkflowVersions' | 'listAssetWorkflowRuns' | 'getAssetWorkflowRun' | 'cancelAssetWorkflowRun' | 'retryAssetWorkflowRun' | 'listAssetWorkflowApprovals' | 'approveAssetWorkflow' | 'rejectAssetWorkflow' | 'listAssetWorkflowConnections' | 'createAssetWorkflowConnection' | 'rotateAssetWorkflowConnectionCredential' | 'rotateAssetWorkflowInboundHook' | 'receiveAssetWorkflowInboundHook' | 'deleteTransformation' | 'createLifecycleRule' | 'listLifecycleRules' | 'deleteLifecycleRule' | 'createDomain' | 'listDomains' | 'verifyDomain' | 'deleteDomain' | 'getAnalytics' | 'getUsageSummary' | 'listEvents' | 'createWebhook' | 'listWebhooks' | 'deleteWebhook' | 'listWebhookDeliveries' | 'retryWebhookDelivery' | 'bulkAssets' | 'listCollections' | 'createCollection' | 'updateCollection' | 'deleteCollection' | 'listSavedSearches' | 'createSavedSearch' | 'updateSavedSearch' | 'deleteSavedSearch' | 'getAIConfig' | 'updateAIConfig' | 'getJob' | 'cancelJob' | 'listAssets' | 'getAsset' | 'startAssetTextExtraction' | 'getAssetTextExtraction' | 'retryAssetTextExtraction' | 'patchAsset' | 'getAssetAI' | 'analyzeAsset' | 'moderateAsset' | 'getTranscript' | 'transcribeAsset' | 'smartCropAsset' | 'removeAssetBackground' | 'listAssetVersions' | 'createAssetBranch' | 'restoreAssetVersion' | 'promoteAssetBranch' | 'deleteAsset' | 'replaceAsset' | 'createSignedAssetUrl' | 'createSignedTransformUrl' | 'setAssetTags' | 'patchAssetMetadata' | 'purgeAsset' | 'widgetCreateUploadSession' | 'widgetGetUploadSession' | 'widgetUploadPart' | 'widgetCompleteUploadSession' | 'widgetCancelUploadSession' | 'widgetIngestRemoteUrl' | 'listAssetSpaces' | 'listAssetCollaborators' | 'inviteAssetCollaborator' | 'updateAssetCollaborator' | 'revokeAssetCollaborator' | 'acceptAssetInvitation' | 'listAssetMetadataSchemas' | 'createAssetMetadataSchema' | 'updateAssetMetadataSchema' | 'publishAssetMetadataSchema' | 'getAssetBucketGovernance' | 'updateAssetBucketGovernance' | 'getAssetMetadataEditor' | 'listAssetPublications' | 'createAssetPublication' | 'updateAssetPublication' | 'transitionAssetPublication' | 'resolveAssetPublication' | 'listAssetPublicationRenditions' | 'previewAssetPublication' | 'migrateAssetBucketGovernance' | 'createAssetPickerCapability' | 'revokeAssetPickerCapability' | 'listAssetModels' | 'processAssetModel' | 'resolveAssetPublicationAR' | 'listAssetGalleries' | 'createAssetGallery' | 'updateAssetGallery' | 'transitionAssetGallery' | 'resolveAssetGallery' | 'resolveAssetGalleryAR' | 'searchAssetPicker' | 'selectAssetPicker';
+export type AssetOperationId = 'putAssetAICredential' | 'deleteAssetAICredential' | 'openAssetAIOutput' | 'getVideoWorkspace' | 'processVideoVersion' | 'createVideoPlaybackSession' | 'revokeVideoPlaybackSession' | 'reviewVideoVersion' | 'listVideoCaptions' | 'addVideoCaption' | 'removeVideoCaption' | 'getVideoAnalytics' | 'createPublicVideoPlaybackSession' | 'openPublicPlayerMedia' | 'renewVideoPlaybackSession' | 'recordVideoPlaybackEvents' | 'uploadAsset' | 'createUploadSession' | 'getUploadSession' | 'completeUploadSession' | 'cancelUploadSession' | 'createSignedUploadUrl' | 'createBucket' | 'listBuckets' | 'updateBucket' | 'deleteBucket' | 'configureBucketStorage' | 'startBucketRelocation' | 'createAssetConnection' | 'listAssetConnections' | 'getAssetConnection' | 'updateAssetConnection' | 'verifyAssetConnection' | 'deleteAssetConnection' | 'listOwnedS2Buckets' | 'createOwnedS2Bucket' | 'startAssetMigration' | 'listAssetMigrations' | 'getAssetMigration' | 'cancelAssetMigration' | 'retryAssetMigrationItem' | 'downloadAssetMigrationReport' | 'createAssetUploadCapability' | 'getContentPolicy' | 'updateContentPolicy' | 'upsertTransformation' | 'listTransformations' | 'materializeAssetTransform' | 'listAssetDerivatives' | 'generateAsset' | 'getAssetAutomation' | 'assetMCP' | 'getAssetWorkflowCatalog' | 'listAssetWorkflows' | 'createAssetWorkflow' | 'getAssetWorkflow' | 'updateAssetWorkflowDraft' | 'validateAssetWorkflow' | 'publishAssetWorkflow' | 'activateAssetWorkflow' | 'startAssetWorkflowRun' | 'listAssetWorkflowVersions' | 'listAssetWorkflowRuns' | 'getAssetWorkflowRun' | 'cancelAssetWorkflowRun' | 'retryAssetWorkflowRun' | 'listAssetWorkflowApprovals' | 'approveAssetWorkflow' | 'rejectAssetWorkflow' | 'listAssetWorkflowConnections' | 'createAssetWorkflowConnection' | 'rotateAssetWorkflowConnectionCredential' | 'rotateAssetWorkflowInboundHook' | 'receiveAssetWorkflowInboundHook' | 'deleteTransformation' | 'createLifecycleRule' | 'listLifecycleRules' | 'deleteLifecycleRule' | 'createDomain' | 'listDomains' | 'verifyDomain' | 'deleteDomain' | 'getAnalytics' | 'getUsageSummary' | 'listEvents' | 'createWebhook' | 'listWebhooks' | 'deleteWebhook' | 'listWebhookDeliveries' | 'retryWebhookDelivery' | 'bulkAssets' | 'listCollections' | 'createCollection' | 'updateCollection' | 'deleteCollection' | 'listSavedSearches' | 'createSavedSearch' | 'updateSavedSearch' | 'deleteSavedSearch' | 'getAIConfig' | 'updateAIConfig' | 'getJob' | 'cancelJob' | 'listAssets' | 'getAsset' | 'startAssetTextExtraction' | 'getAssetTextExtraction' | 'retryAssetTextExtraction' | 'patchAsset' | 'getAssetAI' | 'analyzeAsset' | 'moderateAsset' | 'getTranscript' | 'transcribeAsset' | 'smartCropAsset' | 'removeAssetBackground' | 'listAssetVersions' | 'createAssetBranch' | 'restoreAssetVersion' | 'promoteAssetBranch' | 'deleteAsset' | 'replaceAsset' | 'createSignedAssetUrl' | 'createSignedTransformUrl' | 'setAssetTags' | 'patchAssetMetadata' | 'purgeAsset' | 'widgetCreateUploadSession' | 'widgetGetUploadSession' | 'widgetUploadPart' | 'widgetCompleteUploadSession' | 'widgetCancelUploadSession' | 'widgetIngestRemoteUrl' | 'listAssetSpaces' | 'listAssetCollaborators' | 'inviteAssetCollaborator' | 'updateAssetCollaborator' | 'revokeAssetCollaborator' | 'acceptAssetInvitation' | 'listAssetMetadataSchemas' | 'createAssetMetadataSchema' | 'updateAssetMetadataSchema' | 'publishAssetMetadataSchema' | 'getAssetBucketGovernance' | 'updateAssetBucketGovernance' | 'getAssetMetadataEditor' | 'listAssetPublications' | 'createAssetPublication' | 'updateAssetPublication' | 'transitionAssetPublication' | 'resolveAssetPublication' | 'listAssetPublicationRenditions' | 'previewAssetPublication' | 'migrateAssetBucketGovernance' | 'createAssetPickerCapability' | 'revokeAssetPickerCapability' | 'listAssetModels' | 'processAssetModel' | 'listAssetModelVariants' | 'createAssetModelVariant' | 'updateAssetModelVariant' | 'deleteAssetModelVariant' | 'resolveAssetPublicationAR' | 'createAssetPublicationARHandoff' | 'resolveAssetPublicationARHandoff' | 'listAssetGalleries' | 'createAssetGallery' | 'updateAssetGallery' | 'transitionAssetGallery' | 'resolveAssetGallery' | 'resolveAssetGalleryAR' | 'searchAssetPicker' | 'selectAssetPicker' | 'listAssetPortals' | 'createAssetPortal' | 'updateAssetPortal' | 'actOnAssetPortal' | 'listAssetProofs' | 'createAssetProof' | 'getAssetProof' | 'updateAssetProof' | 'decideAssetProof' | 'commentOnAssetProof' | 'inviteAssetProofGuest' | 'listAssetGuestGrants' | 'revokeAssetGuestGrant' | 'getAssetInsights' | 'setAssetInsightsTimezone' | 'listAssetPlayerProfiles' | 'createAssetPlayerProfile' | 'getAssetPlayerProfile' | 'updateAssetPlayerProfile' | 'archiveAssetPlayerProfile' | 'getAssetPlayerAssociation' | 'setAssetPlayerAssociation' | 'moveAssetFolder' | 'listAssetFolders' | 'createAssetFolder' | 'deleteAssetFolder' | 'listAssetSamples' | 'previewAssetSample' | 'copyAssetSample' | 'getAssetCapabilities' | 'listAssetModerationReviews' | 'submitAssetModerationReviews' | 'getAssetModerationReviews' | 'listAssetIntegrations' | 'createAssetIntegration' | 'deleteAssetIntegration' | 'getCurrentAssetIntegration' | 'connectCurrentAssetIntegration' | 'disconnectCurrentAssetIntegration' | 'testAssetWebhook' | 'estimateAssetGeneration' | 'listAssetGenerations' | 'retryAssetGeneration' | 'cancelAssetGeneration' | 'previewAsset' | 'previewAssetStudio' | 'saveAssetStudioOutput' | 'signAssetStudioOutput' | 'getAssetStudioOutput' | 'publishAssetTransformation';
 export type AssetAPIScope = 'assets:read' | 'assets:write' | 'assets:process' | 'assets:generate' | 'assets:publish' | 'assets:admin' | 'assets:any';
 export interface AssetContractOperation {
     readonly id: AssetOperationId;
@@ -71,6 +71,11 @@ export declare const assetContractOperations: readonly [{
     readonly method: "POST";
     readonly path: "/playback/assets/{assetID}/sessions";
     readonly scope: "assets:read";
+}, {
+    readonly id: "openPublicPlayerMedia";
+    readonly method: "GET";
+    readonly path: "/playback/media/{kind}";
+    readonly scope: "assets:read";
 }, {
     readonly id: "renewVideoPlaybackSession";
     readonly method: "POST";
@@ -791,11 +796,41 @@ export declare const assetContractOperations: readonly [{
     readonly method: "POST";
     readonly path: "/api/v1/assets/{assetID}/models";
     readonly scope: "assets:process";
+}, {
+    readonly id: "listAssetModelVariants";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/{assetID}/model-variants";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "createAssetModelVariant";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/{assetID}/model-variants";
+    readonly scope: "assets:process";
+}, {
+    readonly id: "updateAssetModelVariant";
+    readonly method: "PUT";
+    readonly path: "/api/v1/assets/{assetID}/model-variants/{variantID}";
+    readonly scope: "assets:process";
+}, {
+    readonly id: "deleteAssetModelVariant";
+    readonly method: "DELETE";
+    readonly path: "/api/v1/assets/{assetID}/model-variants/{variantID}";
+    readonly scope: "assets:process";
 }, {
     readonly id: "resolveAssetPublicationAR";
     readonly method: "POST";
     readonly path: "/api/v1/assets/publications/{publicationID}/ar";
     readonly scope: "assets:read";
+}, {
+    readonly id: "createAssetPublicationARHandoff";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/publications/{publicationID}/ar-handoff";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "resolveAssetPublicationARHandoff";
+    readonly method: "GET";
+    readonly path: "/assets/ar-handoff/{token}";
+    readonly scope: "assets:read";
 }, {
     readonly id: "listAssetGalleries";
     readonly method: "GET";
@@ -836,4 +871,254 @@ export declare const assetContractOperations: readonly [{
     readonly method: "POST";
     readonly path: "/assets/picker/select";
     readonly scope: "assets:read";
+}, {
+    readonly id: "listAssetPortals";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/portals";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "createAssetPortal";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/portals";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "updateAssetPortal";
+    readonly method: "PUT";
+    readonly path: "/api/v1/assets/portals/{portalID}";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "actOnAssetPortal";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/portals/{portalID}/{action}";
+    readonly scope: "assets:publish";
+}, {
+    readonly id: "listAssetProofs";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/proofs";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "createAssetProof";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/proofs";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "getAssetProof";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/proofs/{proofID}";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "updateAssetProof";
+    readonly method: "PUT";
+    readonly path: "/api/v1/assets/proofs/{proofID}";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "decideAssetProof";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/proofs/{proofID}/decisions";
+    readonly scope: "assets:admin";
+}, {
+    readonly id: "commentOnAssetProof";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/proofs/{proofID}/comments";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "inviteAssetProofGuest";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/proofs/{proofID}/invitations";
+    readonly scope: "assets:admin";
+}, {
+    readonly id: "listAssetGuestGrants";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/guest-grants";
+    readonly scope: "assets:admin";
+}, {
+    readonly id: "revokeAssetGuestGrant";
+    readonly method: "DELETE";
+    readonly path: "/api/v1/assets/guest-grants/{grantID}";
+    readonly scope: "assets:admin";
+}, {
+    readonly id: "getAssetInsights";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/insights";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "setAssetInsightsTimezone";
+    readonly method: "PUT";
+    readonly path: "/api/v1/assets/insights";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "listAssetPlayerProfiles";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/player-profiles";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "createAssetPlayerProfile";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/player-profiles";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "getAssetPlayerProfile";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/player-profiles/{profileID}";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "updateAssetPlayerProfile";
+    readonly method: "PUT";
+    readonly path: "/api/v1/assets/player-profiles/{profileID}";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "archiveAssetPlayerProfile";
+    readonly method: "DELETE";
+    readonly path: "/api/v1/assets/player-profiles/{profileID}";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "getAssetPlayerAssociation";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/{assetID}/player-profile";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "setAssetPlayerAssociation";
+    readonly method: "PUT";
+    readonly path: "/api/v1/assets/{assetID}/player-profile";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "moveAssetFolder";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/folders/move";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "listAssetFolders";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/folders";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "createAssetFolder";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/folders";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "deleteAssetFolder";
+    readonly method: "DELETE";
+    readonly path: "/api/v1/assets/folders";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "listAssetSamples";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/samples";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "previewAssetSample";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/samples/{sampleID}/preview";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "copyAssetSample";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/samples/{sampleID}/copy";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "getAssetCapabilities";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/capabilities";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "listAssetModerationReviews";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/moderation-reviews";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "submitAssetModerationReviews";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/moderation-reviews";
+    readonly scope: "assets:admin";
+}, {
+    readonly id: "getAssetModerationReviews";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/moderation-reviews/{assetID}";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "listAssetIntegrations";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/integrations";
+    readonly scope: "assets:admin";
+}, {
+    readonly id: "createAssetIntegration";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/integrations";
+    readonly scope: "assets:admin";
+}, {
+    readonly id: "deleteAssetIntegration";
+    readonly method: "DELETE";
+    readonly path: "/api/v1/assets/integrations/{integrationID}";
+    readonly scope: "assets:admin";
+}, {
+    readonly id: "getCurrentAssetIntegration";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/integrations/current";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "connectCurrentAssetIntegration";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/integrations/current";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "disconnectCurrentAssetIntegration";
+    readonly method: "DELETE";
+    readonly path: "/api/v1/assets/integrations/current";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "testAssetWebhook";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/webhooks/{webhookID}/test";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "estimateAssetGeneration";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/generations/estimate";
+    readonly scope: "assets:generate";
+}, {
+    readonly id: "listAssetGenerations";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/generations";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "retryAssetGeneration";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/generations/{requestID}/retry";
+    readonly scope: "assets:generate";
+}, {
+    readonly id: "cancelAssetGeneration";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/generations/{requestID}/cancel";
+    readonly scope: "assets:generate";
+}, {
+    readonly id: "previewAsset";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/{assetID}/preview";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "previewAssetStudio";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/{assetID}/studio/preview";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "saveAssetStudioOutput";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/{assetID}/derivatives/{outputID}/save";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "signAssetStudioOutput";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/{assetID}/derivatives/{outputID}/signed-url";
+    readonly scope: "assets:write";
+}, {
+    readonly id: "getAssetStudioOutput";
+    readonly method: "GET";
+    readonly path: "/api/v1/assets/{assetID}/derivatives/{outputID}";
+    readonly scope: "assets:read";
+}, {
+    readonly id: "publishAssetTransformation";
+    readonly method: "POST";
+    readonly path: "/api/v1/assets/transformations/{name}/publish";
+    readonly scope: "assets:write";
 }];

package/dist/generated/assets-contract.js

@@ -12,6 +12,7 @@ export const assetContractOperations = [
     { id: 'removeVideoCaption', method: 'DELETE', path: '/api/v1/assets/{assetID}/versions/{versionID}/video/captions/{captionID}', scope: 'assets:write' },
     { id: 'getVideoAnalytics', method: 'GET', path: '/api/v1/assets/{assetID}/video/analytics', scope: 'assets:read' },
     { id: 'createPublicVideoPlaybackSession', method: 'POST', path: '/playback/assets/{assetID}/sessions', scope: 'assets:read' },
+    { id: 'openPublicPlayerMedia', method: 'GET', path: '/playback/media/{kind}', scope: 'assets:read' },
     { id: 'renewVideoPlaybackSession', method: 'POST', path: '/playback/sessions/renew', scope: 'assets:read' },
     { id: 'recordVideoPlaybackEvents', method: 'POST', path: '/playback/events', scope: 'assets:read' },
     { id: 'uploadAsset', method: 'POST', path: '/api/v1/assets/upload', scope: 'assets:write' },
@@ -156,7 +157,13 @@ export const assetContractOperations = [
     { id: 'revokeAssetPickerCapability', method: 'DELETE', path: '/api/v1/assets/picker-capabilities/{capabilityID}', scope: 'assets:read' },
     { id: 'listAssetModels', method: 'GET', path: '/api/v1/assets/{assetID}/models', scope: 'assets:read' },
     { id: 'processAssetModel', method: 'POST', path: '/api/v1/assets/{assetID}/models', scope: 'assets:process' },
+    { id: 'listAssetModelVariants', method: 'GET', path: '/api/v1/assets/{assetID}/model-variants', scope: 'assets:read' },
+    { id: 'createAssetModelVariant', method: 'POST', path: '/api/v1/assets/{assetID}/model-variants', scope: 'assets:process' },
+    { id: 'updateAssetModelVariant', method: 'PUT', path: '/api/v1/assets/{assetID}/model-variants/{variantID}', scope: 'assets:process' },
+    { id: 'deleteAssetModelVariant', method: 'DELETE', path: '/api/v1/assets/{assetID}/model-variants/{variantID}', scope: 'assets:process' },
     { id: 'resolveAssetPublicationAR', method: 'POST', path: '/api/v1/assets/publications/{publicationID}/ar', scope: 'assets:read' },
+    { id: 'createAssetPublicationARHandoff', method: 'POST', path: '/api/v1/assets/publications/{publicationID}/ar-handoff', scope: 'assets:read' },
+    { id: 'resolveAssetPublicationARHandoff', method: 'GET', path: '/assets/ar-handoff/{token}', scope: 'assets:read' },
     { id: 'listAssetGalleries', method: 'GET', path: '/api/v1/assets/galleries', scope: 'assets:read' },
     { id: 'createAssetGallery', method: 'POST', path: '/api/v1/assets/galleries', scope: 'assets:write' },
     { id: 'updateAssetGallery', method: 'PUT', path: '/api/v1/assets/galleries/{galleryID}', scope: 'assets:write' },
@@ -165,4 +172,54 @@ export const assetContractOperations = [
     { id: 'resolveAssetGalleryAR', method: 'POST', path: '/api/v1/assets/galleries/{galleryID}/ar', scope: 'assets:read' },
     { id: 'searchAssetPicker', method: 'POST', path: '/assets/picker/search', scope: 'assets:read' },
     { id: 'selectAssetPicker', method: 'POST', path: '/assets/picker/select', scope: 'assets:read' },
+    { id: 'listAssetPortals', method: 'GET', path: '/api/v1/assets/portals', scope: 'assets:read' },
+    { id: 'createAssetPortal', method: 'POST', path: '/api/v1/assets/portals', scope: 'assets:write' },
+    { id: 'updateAssetPortal', method: 'PUT', path: '/api/v1/assets/portals/{portalID}', scope: 'assets:write' },
+    { id: 'actOnAssetPortal', method: 'POST', path: '/api/v1/assets/portals/{portalID}/{action}', scope: 'assets:publish' },
+    { id: 'listAssetProofs', method: 'GET', path: '/api/v1/assets/proofs', scope: 'assets:read' },
+    { id: 'createAssetProof', method: 'POST', path: '/api/v1/assets/proofs', scope: 'assets:write' },
+    { id: 'getAssetProof', method: 'GET', path: '/api/v1/assets/proofs/{proofID}', scope: 'assets:read' },
+    { id: 'updateAssetProof', method: 'PUT', path: '/api/v1/assets/proofs/{proofID}', scope: 'assets:write' },
+    { id: 'decideAssetProof', method: 'POST', path: '/api/v1/assets/proofs/{proofID}/decisions', scope: 'assets:admin' },
+    { id: 'commentOnAssetProof', method: 'POST', path: '/api/v1/assets/proofs/{proofID}/comments', scope: 'assets:write' },
+    { id: 'inviteAssetProofGuest', method: 'POST', path: '/api/v1/assets/proofs/{proofID}/invitations', scope: 'assets:admin' },
+    { id: 'listAssetGuestGrants', method: 'GET', path: '/api/v1/assets/guest-grants', scope: 'assets:admin' },
+    { id: 'revokeAssetGuestGrant', method: 'DELETE', path: '/api/v1/assets/guest-grants/{grantID}', scope: 'assets:admin' },
+    { id: 'getAssetInsights', method: 'GET', path: '/api/v1/assets/insights', scope: 'assets:read' },
+    { id: 'setAssetInsightsTimezone', method: 'PUT', path: '/api/v1/assets/insights', scope: 'assets:write' },
+    { id: 'listAssetPlayerProfiles', method: 'GET', path: '/api/v1/assets/player-profiles', scope: 'assets:read' },
+    { id: 'createAssetPlayerProfile', method: 'POST', path: '/api/v1/assets/player-profiles', scope: 'assets:write' },
+    { id: 'getAssetPlayerProfile', method: 'GET', path: '/api/v1/assets/player-profiles/{profileID}', scope: 'assets:read' },
+    { id: 'updateAssetPlayerProfile', method: 'PUT', path: '/api/v1/assets/player-profiles/{profileID}', scope: 'assets:write' },
+    { id: 'archiveAssetPlayerProfile', method: 'DELETE', path: '/api/v1/assets/player-profiles/{profileID}', scope: 'assets:write' },
+    { id: 'getAssetPlayerAssociation', method: 'GET', path: '/api/v1/assets/{assetID}/player-profile', scope: 'assets:read' },
+    { id: 'setAssetPlayerAssociation', method: 'PUT', path: '/api/v1/assets/{assetID}/player-profile', scope: 'assets:write' },
+    { id: 'moveAssetFolder', method: 'POST', path: '/api/v1/assets/folders/move', scope: 'assets:write' },
+    { id: 'listAssetFolders', method: 'GET', path: '/api/v1/assets/folders', scope: 'assets:read' },
+    { id: 'createAssetFolder', method: 'POST', path: '/api/v1/assets/folders', scope: 'assets:write' },
+    { id: 'deleteAssetFolder', method: 'DELETE', path: '/api/v1/assets/folders', scope: 'assets:write' },
+    { id: 'listAssetSamples', method: 'GET', path: '/api/v1/assets/samples', scope: 'assets:read' },
+    { id: 'previewAssetSample', method: 'GET', path: '/api/v1/assets/samples/{sampleID}/preview', scope: 'assets:read' },
+    { id: 'copyAssetSample', method: 'POST', path: '/api/v1/assets/samples/{sampleID}/copy', scope: 'assets:write' },
+    { id: 'getAssetCapabilities', method: 'GET', path: '/api/v1/assets/capabilities', scope: 'assets:read' },
+    { id: 'listAssetModerationReviews', method: 'GET', path: '/api/v1/assets/moderation-reviews', scope: 'assets:read' },
+    { id: 'submitAssetModerationReviews', method: 'POST', path: '/api/v1/assets/moderation-reviews', scope: 'assets:admin' },
+    { id: 'getAssetModerationReviews', method: 'GET', path: '/api/v1/assets/moderation-reviews/{assetID}', scope: 'assets:read' },
+    { id: 'listAssetIntegrations', method: 'GET', path: '/api/v1/assets/integrations', scope: 'assets:admin' },
+    { id: 'createAssetIntegration', method: 'POST', path: '/api/v1/assets/integrations', scope: 'assets:admin' },
+    { id: 'deleteAssetIntegration', method: 'DELETE', path: '/api/v1/assets/integrations/{integrationID}', scope: 'assets:admin' },
+    { id: 'getCurrentAssetIntegration', method: 'GET', path: '/api/v1/assets/integrations/current', scope: 'assets:read' },
+    { id: 'connectCurrentAssetIntegration', method: 'POST', path: '/api/v1/assets/integrations/current', scope: 'assets:read' },
+    { id: 'disconnectCurrentAssetIntegration', method: 'DELETE', path: '/api/v1/assets/integrations/current', scope: 'assets:read' },
+    { id: 'testAssetWebhook', method: 'POST', path: '/api/v1/assets/webhooks/{webhookID}/test', scope: 'assets:write' },
+    { id: 'estimateAssetGeneration', method: 'POST', path: '/api/v1/assets/generations/estimate', scope: 'assets:generate' },
+    { id: 'listAssetGenerations', method: 'GET', path: '/api/v1/assets/generations', scope: 'assets:read' },
+    { id: 'retryAssetGeneration', method: 'POST', path: '/api/v1/assets/generations/{requestID}/retry', scope: 'assets:generate' },
+    { id: 'cancelAssetGeneration', method: 'POST', path: '/api/v1/assets/generations/{requestID}/cancel', scope: 'assets:generate' },
+    { id: 'previewAsset', method: 'GET', path: '/api/v1/assets/{assetID}/preview', scope: 'assets:read' },
+    { id: 'previewAssetStudio', method: 'POST', path: '/api/v1/assets/{assetID}/studio/preview', scope: 'assets:write' },
+    { id: 'saveAssetStudioOutput', method: 'POST', path: '/api/v1/assets/{assetID}/derivatives/{outputID}/save', scope: 'assets:write' },
+    { id: 'signAssetStudioOutput', method: 'POST', path: '/api/v1/assets/{assetID}/derivatives/{outputID}/signed-url', scope: 'assets:write' },
+    { id: 'getAssetStudioOutput', method: 'GET', path: '/api/v1/assets/{assetID}/derivatives/{outputID}', scope: 'assets:read' },
+    { id: 'publishAssetTransformation', method: 'POST', path: '/api/v1/assets/transformations/{name}/publish', scope: 'assets:write' },
 ];

package/dist/index.d.ts

@@ -6,6 +6,10 @@ export type * from './asset-media-v2.js';
 export { AssetConnectionsClient, AssetMigrationsClient, AssetStorageClient, AssetTextClient, AssetUploadCapabilitiesClient } from './assets-platform.js';
 export type * from './assets-platform-types.js';
 export { ChunkedUploadController, UploadResumeInvalidError, putBlob, sha256Blob } from './upload-controller.js';
+export { S2UploadsClient } from './s2.js';
+export type { S2Object } from './s2.js';
+export { S2Uploader, createS2ResumeStore } from './s2-upload.js';
+export type { S2UploadBackend } from './s2-upload.js';
 export type { ChunkUploadCallbacks, ChunkUploadRequest, ChunkUploadSession, ChunkUploadTransport, ChunkedUploadOptions, UploadProgress, UploadResumeRecord, UploadResumeStore, UploadedPart } from './upload-controller.js';
 export { createResponsiveImage, namedResponsiveSource, uploadBrowserFile } from './assets-framework.js';
 export type { ArtDirectionSource, ResponsiveImageDescriptor, ResponsiveImageOptions } from './assets-framework.js';
@@ -26,7 +30,7 @@ export type { MailSendTemplateInput, MailSendTemplateResponse, MailTemplate, Mai
 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, MailBatchItem, MailBatchSendInput, MailBatchTemplateInput, MailInboundDomain, MailInboundMessage, MailScheduledCreateInput, MailScheduledMessage, } from './mail-advanced-types.js';
+export type { MailAnalytics, MailAnalyticsRateCohort, MailAnalyticsInput, MailAttachmentInput, MailBatch, MailBatchItem, MailBatchSendInput, MailBatchTemplateInput, MailInboundDomain, MailInboundMessage, MailScheduledCreateInput, MailScheduledMessage, } from './mail-advanced-types.js';
 export { AssetVideoClient } from './assets-video.js';
 export type * from './assets-video-types.js';
 export * from './mail-tracking.js';
@@ -39,3 +43,5 @@ export * from './mail-brands.js';
 export * from './mail-billing.js';
 export * from './mail-migration.js';
 export * from './mail-marketing.js';
+export { AICreditsClient } from './ai-credits.js';
+export type * from './ai-credits.js';

package/dist/index.js

@@ -3,6 +3,8 @@ export { AssetsClient, assetTransformOptions, assetTransformPresets, assetTransf
 export { AssetWorkflowsClient } from './asset-workflows.js';
 export { AssetConnectionsClient, AssetMigrationsClient, AssetStorageClient, AssetTextClient, AssetUploadCapabilitiesClient } from './assets-platform.js';
 export { ChunkedUploadController, UploadResumeInvalidError, putBlob, sha256Blob } from './upload-controller.js';
+export { S2UploadsClient } from './s2.js';
+export { S2Uploader, createS2ResumeStore } from './s2-upload.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, MailStreamsClient, MailAudiencesClient, MailCampaignsClient, } from './mail.js';
@@ -16,3 +18,4 @@ export * from './mail-brands.js';
 export * from './mail-billing.js';
 export * from './mail-migration.js';
 export * from './mail-marketing.js';
+export { AICreditsClient } from './ai-credits.js';

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

@@ -107,7 +107,18 @@ export interface MailAnalyticsInput {
     template?: string;
     event?: string;
 }
+export interface MailAnalyticsRateCohort {
+    basis: 'recipient_created_at';
+    asOf: string;
+    queued: number;
+    mtaAccepted: number;
+    delivered: number;
+    bounced: number;
+    failed: number;
+}
 export interface MailAnalytics {
+    rateCohort?: MailAnalyticsRateCohort;
+    previousRateCohort?: MailAnalyticsRateCohort;
     summary: Record<string, number>;
     series: Array<Record<string, number | string>>;
 }

package/dist/mail-billing.d.ts

@@ -1,6 +1,10 @@
 import type { StackShift } from './client.js';
 import type { MailMode } from './mail-simulation.js';
 export interface MailBillingSummary {
+    catalogId?: string;
+    planSlug?: string;
+    monthlyPriceKobo?: number;
+    overageAllowed?: boolean;
     reconciliationRequired: boolean;
     active: boolean;
     mode: MailMode;

package/dist/mail-marketing.d.ts

@@ -56,12 +56,19 @@ export declare class MailFormsClient {
         data: MailSignupForm[];
     }>;
 }
+export interface MailSegmentCondition {
+    field: string;
+    operator: 'equals' | 'not_equals' | 'contains' | 'exists';
+    value?: string;
+}
 export interface MailSegmentInput {
+    match?: 'all' | 'any';
+    conditions?: MailSegmentCondition[];
     audienceId: string;
     name: string;
     description?: string;
-    field: string;
-    operator: string;
+    field?: string;
+    operator?: string;
     value?: string;
 }
 export interface MailSegment extends MailSegmentInput {

package/dist/s2-upload.d.ts

@@ -0,0 +1,22 @@
+import type { ChunkUploadRequest, ChunkUploadSession, ChunkedUploadOptions, UploadedPart, UploadResumeStore } from './upload-controller.js';
+export interface S2UploadBackend<TResult> {
+    create(input: ChunkUploadRequest & {
+        size: number;
+    }): Promise<ChunkUploadSession>;
+    resume(context: string): Promise<ChunkUploadSession>;
+    signPart(session: ChunkUploadSession, part: UploadedPart): Promise<{
+        url: string;
+        headers?: Record<string, string>;
+    }>;
+    complete(session: ChunkUploadSession): Promise<TResult>;
+    cancel(session: ChunkUploadSession): Promise<void>;
+}
+/** Bind these callbacks to authenticated application-server routes. Never put permanent S3 credentials in a browser. */
+export declare class S2Uploader<TResult> {
+    private readonly controller;
+    constructor(backend: S2UploadBackend<TResult>, store?: UploadResumeStore);
+    upload(file: Blob, request: ChunkUploadRequest, options?: ChunkedUploadOptions): Promise<TResult>;
+    cancel(resumeKey: string): Promise<void>;
+}
+/** Use an account-specific namespace, and clear it on logout. Stored sessions contain temporary upload capabilities. */
+export declare function createS2ResumeStore(storage: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>, namespace: string): UploadResumeStore;

package/dist/s2-upload.js

@@ -0,0 +1,49 @@
+import { ChunkedUploadController, putBlob } from './upload-controller.js';
+/** Bind these callbacks to authenticated application-server routes. Never put permanent S3 credentials in a browser. */
+export class S2Uploader {
+    controller;
+    constructor(backend, store) {
+        this.controller = new ChunkedUploadController({
+            create: (file, request) => backend.create({ ...request, size: file.size }),
+            resume: (context) => backend.resume(context),
+            uploadPart: async (session, partNumber, chunk, checksumSHA256, callbacks) => {
+                const signed = await backend.signPart(session, { partNumber, size: chunk.size, checksumSHA256 });
+                await putBlob(signed.url, chunk, callbacks, signed.headers);
+            },
+            complete: (session) => backend.complete(session),
+            cancel: (session) => backend.cancel(session),
+        }, store);
+    }
+    upload(file, request, options = {}) {
+        if (file.size === 0)
+            return Promise.reject(new Error('Use a single presigned PUT for an empty object'));
+        return this.controller.upload(file, request, { ...options, requireMatchingFile: true });
+    }
+    cancel(resumeKey) { return this.controller.cancel(resumeKey); }
+}
+/** Use an account-specific namespace, and clear it on logout. Stored sessions contain temporary upload capabilities. */
+export function createS2ResumeStore(storage, namespace) {
+    if (!namespace.trim())
+        throw new Error('An account-specific upload namespace is required');
+    const key = (value) => `stackshift:s2:${encodeURIComponent(namespace)}:${encodeURIComponent(value)}`;
+    return {
+        async get(value) {
+            const raw = storage.getItem(key(value));
+            if (raw === null)
+                return undefined;
+            let record;
+            try {
+                record = JSON.parse(raw);
+            }
+            catch {
+                throw new Error('Saved upload state is unreadable; clear it before starting again');
+            }
+            if (!record || record.key !== value || typeof record.fingerprint !== 'string' || !record.session?.id) {
+                throw new Error('Saved upload state is invalid; clear it before starting again');
+            }
+            return record;
+        },
+        async set(record) { storage.setItem(key(record.key), JSON.stringify(record)); },
+        async delete(value) { storage.removeItem(key(value)); },
+    };
+}

package/dist/s2.d.ts

@@ -0,0 +1,34 @@
+import type { StackShift } from './client.js';
+import type { S2UploadBackend } from './s2-upload.js';
+import type { ChunkUploadSession, UploadedPart } from './upload-controller.js';
+export interface S2Object {
+    id: string;
+    version_id: string;
+    bucket_id: string;
+    key: string;
+    size: number;
+    etag: string;
+    checksum_sha256: string;
+    content_type: string;
+}
+/** Server-side adapter. Authorize the application's user and destination before forwarding browser requests. */
+export declare class S2UploadsClient implements S2UploadBackend<S2Object> {
+    private readonly client;
+    private readonly path;
+    constructor(client: StackShift, bucketID: string);
+    create(input: {
+        key: string;
+        size: number;
+        mimeType: string;
+    }): Promise<ChunkUploadSession>;
+    resume(context: string): Promise<ChunkUploadSession>;
+    signPart(session: ChunkUploadSession, part: UploadedPart): Promise<{
+        url: string;
+        headers: {
+            [k: string]: string;
+        };
+    }>;
+    complete(session: ChunkUploadSession): Promise<S2Object>;
+    cancel(session: ChunkUploadSession): Promise<void>;
+    private action;
+}

package/dist/s2.js

@@ -0,0 +1,31 @@
+/** Server-side adapter. Authorize the application's user and destination before forwarding browser requests. */
+export class S2UploadsClient {
+    client;
+    path;
+    constructor(client, bucketID) {
+        this.client = client;
+        if (!bucketID)
+            throw new Error('A bucket ID is required');
+        this.path = `/buckets/${encodeURIComponent(bucketID)}/uploads`;
+    }
+    create(input) {
+        return this.client.request(this.path, { method: 'POST', body: input });
+    }
+    resume(context) {
+        return this.action('resume', context);
+    }
+    async signPart(session, part) {
+        const result = await this.action('sign-part', session.uploadToken, part);
+        const headers = Object.fromEntries(Object.entries(result.headers ?? {}).map(([name, values]) => [name, values.join(', ')]));
+        return { url: result.url, headers };
+    }
+    complete(session) {
+        return this.action('complete', session.uploadToken);
+    }
+    async cancel(session) {
+        await this.action('cancel', session.uploadToken);
+    }
+    action(action, token, part) {
+        return this.client.request(`${this.path}/actions`, { method: 'POST', body: { action, token, part } });
+    }
+}

package/dist/types.d.ts

@@ -197,6 +197,18 @@ export interface ProjectListOptions {
     perPage?: number;
 }
 export interface Asset {
+    readiness?: {
+        state: "ready" | "processing" | "blocked" | "unknown";
+        stages: Array<{
+            id: string;
+            status: string;
+        }>;
+        actions: Record<"preview" | "download" | "edit" | "publish", {
+            state: "ready" | "blocked" | "unknown";
+            code: string;
+            message: string;
+        }>;
+    };
     id: string;
     bucket: string;
     key: string;

package/dist/upload-controller.d.ts

@@ -9,6 +9,7 @@ export interface UploadedPart {
     checksumSHA256?: string;
 }
 export interface ChunkUploadSession {
+    completionPending?: boolean;
     id: string;
     uploadToken: string;
     expiresAt: string;
@@ -52,6 +53,7 @@ export interface ChunkedUploadOptions extends ChunkUploadCallbacks {
     concurrency?: number;
     retryAttempts?: number;
     cancelOnAbort?: boolean;
+    requireMatchingFile?: boolean;
 }
 export declare class UploadResumeInvalidError extends Error {
     constructor(message?: string);

package/dist/upload-controller.js

@@ -16,13 +16,13 @@ export class ChunkedUploadController {
         throwIfAborted(options.signal);
         const resumeKey = options.resumeKey;
         const fingerprint = fileFingerprint(file, request);
-        let session = await this.restore(resumeKey, fingerprint);
+        let session = await this.restore(resumeKey, fingerprint, options.requireMatchingFile);
         if (!session)
             session = await this.transport.create(file, request);
         validateSession(session, file.size);
         options.onSession?.(session);
         await this.persist(resumeKey, fingerprint, session);
-        const completed = await verifiedCompletedParts(file, session);
+        const completed = await verifiedCompletedParts(file, session, options.requireMatchingFile);
         const loadedByPart = new Map(completed);
         const tasks = [];
         for (let offset = 0, partNumber = 1; offset < file.size; offset += session.partSize, partNumber += 1) {
@@ -37,8 +37,9 @@ export class ChunkedUploadController {
         const concurrency = boundedInteger(options.concurrency, 4, 1, 8);
         const attempts = boundedInteger(options.retryAttempts, 4, 1, 8);
         let next = 0;
+        let workerFailed = false;
         const worker = async () => {
-            while (next < tasks.length) {
+            while (!workerFailed && next < tasks.length) {
                 throwIfAborted(options.signal);
                 const task = tasks[next++];
                 const checksum = await sha256Blob(task.chunk);
@@ -61,7 +62,16 @@ export class ChunkedUploadController {
             }
         };
         try {
-            await Promise.all(Array.from({ length: Math.min(concurrency, tasks.length || 1) }, worker));
+            const workers = await Promise.allSettled(Array.from({ length: Math.min(concurrency, tasks.length || 1) }, () => worker().catch((error) => {
+                workerFailed = true;
+                throw error;
+            })));
+            const failed = workers.find((result) => result.status === 'rejected');
+            if (failed?.status === 'rejected')
+                throw failed.reason;
+            throwIfAborted(options.signal);
+            session.completionPending = true;
+            await this.persist(resumeKey, fingerprint, session);
             const result = await retryWithBackoff(() => this.transport.complete(session), attempts, options.signal);
             if (resumeKey)
                 await this.store?.delete(resumeKey);
@@ -69,9 +79,12 @@ export class ChunkedUploadController {
         }
         catch (error) {
             if (isAbortError(error) && options.cancelOnAbort) {
-                await this.transport.cancel(session).catch(() => undefined);
-                if (resumeKey)
-                    await this.store?.delete(resumeKey);
+                try {
+                    await this.transport.cancel(session);
+                    if (resumeKey)
+                        await this.store?.delete(resumeKey);
+                }
+                catch { /* Retain recovery state when remote cancellation is uncertain. */ }
             }
             throw error;
         }
@@ -80,19 +93,24 @@ export class ChunkedUploadController {
         const record = await this.store?.get(resumeKey);
         if (!record)
             return;
-        try {
-            await this.transport.cancel(record.session);
-        }
-        finally {
-            await this.store?.delete(resumeKey);
-        }
+        await this.transport.cancel(record.session);
+        await this.store?.delete(resumeKey);
     }
-    async restore(resumeKey, fingerprint) {
+    async restore(resumeKey, fingerprint, requireMatchingFile = false) {
         if (!resumeKey || !this.store)
             return undefined;
         const record = await this.store.get(resumeKey);
         if (!record)
             return undefined;
+        if (record.fingerprint !== fingerprint && requireMatchingFile) {
+            throw new Error('Reselect the original file to resume this upload, or cancel the saved upload first');
+        }
+        if (record.fingerprint === fingerprint && record.session.completionPending) {
+            if (Date.parse(record.session.expiresAt) <= Date.now()) {
+                throw new Error('Completion is uncertain and its recovery window expired; verify the destination before clearing saved state');
+            }
+            return record.session;
+        }
         if (record.fingerprint !== fingerprint || Date.parse(record.session.expiresAt) <= Date.now()) {
             await this.transport.cancel(record.session).catch(() => undefined);
             await this.store.delete(resumeKey);
@@ -117,7 +135,7 @@ export class ChunkedUploadController {
             session: { ...session, parts: session.parts.map((part) => ({ ...part })) },
             updatedAt: new Date().toISOString(),
         };
-        this.persistence = this.persistence.then(() => this.store.set(record));
+        this.persistence = this.persistence.catch(() => undefined).then(() => this.store.set(record));
         return this.persistence;
     }
 }
@@ -154,9 +172,10 @@ export async function sha256Blob(blob) {
     return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, '0')).join('');
 }
 function validateSession(session, size) {
-    if (!session.id || !session.uploadToken || session.partSize <= 0)
+    if (!session.id || !session.uploadToken || !Number.isSafeInteger(session.partSize) || session.partSize <= 0 ||
+        !Number.isSafeInteger(session.maxBytes) || session.maxBytes < 0 || !Array.isArray(session.parts))
         throw new Error('Upload session is incomplete');
-    if (Date.parse(session.expiresAt) <= Date.now())
+    if (!Number.isFinite(Date.parse(session.expiresAt)) || Date.parse(session.expiresAt) <= Date.now())
         throw new Error('Upload session has expired');
     if (size > session.maxBytes)
         throw new Error(`File exceeds upload limit of ${session.maxBytes} bytes`);
@@ -167,7 +186,7 @@ function expectedPartSize(fileSize, partSize, partNumber) {
         return -1;
     return Math.min(partSize, fileSize - offset);
 }
-async function verifiedCompletedParts(file, session) {
+async function verifiedCompletedParts(file, session, requireMatchingFile = false) {
     const completed = new Map();
     for (const part of session.parts) {
         const expectedSize = expectedPartSize(file.size, session.partSize, part.partNumber);
@@ -178,6 +197,9 @@ async function verifiedCompletedParts(file, session) {
         if (checksum.toLowerCase() === part.checksumSHA256.toLowerCase()) {
             completed.set(part.partNumber, part.size);
         }
+        else if (requireMatchingFile) {
+            throw new Error('The selected file differs from an uploaded part; reselect the original file or cancel this upload');
+        }
     }
     return completed;
 }
@@ -195,6 +217,7 @@ function boundedInteger(value, fallback, minimum, maximum) {
 async function retryWithBackoff(operation, attempts, signal) {
     let lastError;
     for (let attempt = 0; attempt < attempts; attempt += 1) {
+        throwIfAborted(signal);
         try {
             return await operation();
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackshift-cloud/sdk",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "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-simulation.test.mjs && node test/mail-platform.test.mjs && node test/mail-webhooks.test.mjs && node test/mail-advanced.test.mjs && node test/mail-tracking.test.mjs && node test/mail-subscribers.test.mjs && node test/mail-exports.test.mjs && node test/mail-diagnostics.test.mjs && node test/assets.test.mjs && node test/assets-platform.test.mjs && node test/assets-video.test.mjs && node test/assets-dam.test.mjs"
+    "test": "npm run build && node test/mail.test.mjs && node test/mail-simulation.test.mjs && node test/mail-platform.test.mjs && node test/mail-webhooks.test.mjs && node test/mail-advanced.test.mjs && node test/mail-tracking.test.mjs && node test/mail-subscribers.test.mjs && node test/mail-exports.test.mjs && node test/mail-diagnostics.test.mjs && node test/assets.test.mjs && node test/assets-platform.test.mjs && node test/assets-video.test.mjs && node test/assets-dam.test.mjs && node test/ai-credits.test.mjs && node --test test/s2-upload.test.mjs"
   },
   "devDependencies": {
     "typescript": "^5.4.0"