@stackshift-cloud/sdk 1.1.0 → 1.3.0

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

@@ -0,0 +1,116 @@
+export interface AssetVideoPackage {
+    id: string;
+    asset_space_id: string;
+    asset_id: string;
+    version_id: string;
+    source_checksum_sha256: string;
+    recipe_hash: string;
+    recipe: string;
+    processor_revision: string;
+    status: 'queued' | 'processing' | 'ready' | 'degraded' | 'failed' | 'cancelled';
+    phase: string;
+    progress_percent: number;
+    job_id?: string;
+    published_attempt?: string;
+    admitted_at?: string;
+    created_at: string;
+    updated_at: string;
+    failure_code: string;
+    metadata: {
+        asset_id: string;
+        duration_seconds: number;
+        width: number;
+        height: number;
+        codec: string;
+        bitrate: number;
+        frame_rate: number;
+        has_audio: boolean;
+        rotation: number;
+        created_at: string;
+        updated_at: string;
+    };
+}
+export interface AssetVideoWorkspace {
+    active?: AssetVideoPackage;
+    pending?: AssetVideoPackage;
+    source?: {
+        version_id: string;
+        scan_status: 'pending' | 'clean' | 'infected' | 'failed';
+        review_status: 'not_required' | 'pending' | 'approved' | 'rejected';
+        review_reason: string;
+    };
+    renditions: Array<{
+        id: string;
+        package_id?: string;
+        asset_id: string;
+        source_checksum_sha256: string;
+        kind: 'hls' | 'mp4' | 'poster';
+        profile: string;
+        width: number;
+        height: number;
+        size: number;
+        mime_type: string;
+        status: string;
+        created_at: string;
+        updated_at: string;
+    }>;
+    admission_enabled: boolean;
+}
+export interface AssetVideoCaptionInput {
+    /** Atomically replace this active track; the new reference receives a new ID. */
+    replace_caption_id?: string;
+    caption_asset_id: string;
+    caption_version_id: string;
+    language: string;
+    label: string;
+    kind: 'captions' | 'subtitles';
+    is_default?: boolean;
+}
+export interface AssetVideoCaption extends AssetVideoCaptionInput {
+    id: string;
+    asset_space_id: string;
+    asset_id: string;
+    version_id: string;
+    is_default: boolean;
+}
+export interface AssetPlaybackGrant {
+    has_audio: boolean;
+    session: {
+        id: string;
+        asset_space_id: string;
+        asset_id: string;
+        package_id: string;
+        version_id: string;
+        owner_id?: string;
+        is_private: boolean;
+        expires_at: string;
+        maximum_expires_at: string;
+        revoked_at?: string;
+        created_at: string;
+    };
+    credential: string;
+    hls: string;
+    mp4: string;
+    poster?: string;
+    captions: Array<{
+        id: string;
+        url: string;
+        language: string;
+        label: string;
+        kind: 'captions' | 'subtitles';
+        is_default: boolean;
+    }>;
+}
+export interface AssetPlaybackEvent {
+    sequence: number;
+    kind: 'startup' | 'rebuffer' | 'error' | 'quality' | 'watched' | 'completed';
+    value: number;
+}
+export interface AssetPlaybackAnalytics {
+    starts: number;
+    completions: number;
+    errors: number;
+    startup_ms: number;
+    rebuffer_ms: number;
+    watched_ms: number;
+}

package/dist/assets-video-types.js

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

package/dist/assets-video.d.ts

@@ -0,0 +1,25 @@
+import type { StackShift } from './client.js';
+import type { AssetVideoWorkspace, AssetVideoPackage, AssetVideoCaption, AssetVideoCaptionInput, AssetPlaybackGrant, AssetPlaybackEvent, AssetPlaybackAnalytics } from './assets-video-types.js';
+export declare class AssetVideoClient {
+    private readonly client;
+    constructor(client: StackShift);
+    workspace(assetId: string): Promise<AssetVideoWorkspace>;
+    process(assetId: string, versionId: string): Promise<AssetVideoPackage>;
+    createSession(assetId: string): Promise<AssetPlaybackGrant>;
+    renewSession(credential: string): Promise<AssetPlaybackGrant>;
+    revokeSession(assetId: string, sessionId: string): Promise<{
+        revoked: boolean;
+    }>;
+    captions(assetId: string, versionId: string): Promise<AssetVideoCaption[]>;
+    addCaption(assetId: string, versionId: string, input: AssetVideoCaptionInput): Promise<AssetVideoCaption>;
+    removeCaption(assetId: string, versionId: string, captionId: string): Promise<{
+        removed: boolean;
+    }>;
+    review(assetId: string, versionId: string, decision: 'approved' | 'rejected', reason: string): Promise<{
+        reviewed: boolean;
+    }>;
+    events(credential: string, events: AssetPlaybackEvent[]): Promise<{
+        accepted: boolean;
+    }>;
+    analytics(assetId: string): Promise<AssetPlaybackAnalytics>;
+}

package/dist/assets-video.js

@@ -0,0 +1,19 @@
+const assetPath = (id) => `/assets/${encodeURIComponent(id)}`;
+const versionPath = (id, version) => `${assetPath(id)}/versions/${encodeURIComponent(version)}/video`;
+export class AssetVideoClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    workspace(assetId) { return this.client.request(`${assetPath(assetId)}/video`); }
+    process(assetId, versionId) { return this.client.request(versionPath(assetId, versionId), { method: 'POST' }); }
+    createSession(assetId) { return this.client.request(`${assetPath(assetId)}/playback-sessions`, { method: 'POST' }); }
+    renewSession(credential) { return this.client.playbackRequest('/sessions/renew', credential, {}); }
+    revokeSession(assetId, sessionId) { return this.client.request(`${assetPath(assetId)}/playback-sessions/${encodeURIComponent(sessionId)}`, { method: 'DELETE' }); }
+    captions(assetId, versionId) { return this.client.request(`${versionPath(assetId, versionId)}/captions`); }
+    addCaption(assetId, versionId, input) { return this.client.request(`${versionPath(assetId, versionId)}/captions`, { method: 'POST', body: input }); }
+    removeCaption(assetId, versionId, captionId) { return this.client.request(`${versionPath(assetId, versionId)}/captions/${encodeURIComponent(captionId)}`, { method: 'DELETE' }); }
+    review(assetId, versionId, decision, reason) { return this.client.request(`${versionPath(assetId, versionId)}/review`, { method: 'POST', body: { decision, reason } }); }
+    events(credential, events) { return this.client.playbackRequest('/events', credential, { events }); }
+    analytics(assetId) { return this.client.request(`${assetPath(assetId)}/video/analytics`); }
+}

package/dist/assets.d.ts

@@ -1,3 +1,5 @@
+import { AssetDAMClient } from './assets-dam.js';
+import { AssetVideoClient } from './assets-video.js';
 import type { StackShift } from './client.js';
 import { AssetConnectionsClient, AssetMigrationsClient, AssetStorageClient, AssetTextClient, AssetUploadCapabilitiesClient } from './assets-platform.js';
 import { AssetWorkflowsClient } from './asset-workflows.js';
@@ -9,6 +11,8 @@ export declare function assetTransformOptions(preset: AssetTransformPreset): Ass
 export declare function assetTransformSpec(options: AssetTransformOptions): string;
 export declare class AssetsClient {
     private readonly client;
+    readonly dam: AssetDAMClient;
+    readonly video: AssetVideoClient;
     readonly connections: AssetConnectionsClient;
     readonly storage: AssetStorageClient;
     readonly migrations: AssetMigrationsClient;
@@ -79,7 +83,7 @@ export declare class AssetsClient {
         description?: string;
         asset_ids?: string[];
     }): Promise<AssetCollection>;
-    updateCollection(collectionId: string, input: {
+    updateCollection(collectionId: string, revision: number, input: {
         name: string;
         description?: string;
         asset_ids?: string[];

package/dist/assets.js

@@ -1,3 +1,5 @@
+import { AssetDAMClient } from './assets-dam.js';
+import { AssetVideoClient } from './assets-video.js';
 import { AssetConnectionsClient, AssetMigrationsClient, AssetStorageClient, AssetTextClient, AssetUploadCapabilitiesClient } from './assets-platform.js';
 import { AssetWorkflowsClient } from './asset-workflows.js';
 import { ChunkedUploadController, putBlob, sha256Blob } from './upload-controller.js';
@@ -44,6 +46,8 @@ export function assetTransformSpec(options) {
 }
 export class AssetsClient {
     client;
+    dam;
+    video;
     connections;
     storage;
     migrations;
@@ -52,6 +56,8 @@ export class AssetsClient {
     workflows;
     constructor(client) {
         this.client = client;
+        this.dam = new AssetDAMClient(client);
+        this.video = new AssetVideoClient(client);
         this.connections = new AssetConnectionsClient(client);
         this.storage = new AssetStorageClient(client);
         this.migrations = new AssetMigrationsClient(client);
@@ -76,6 +82,9 @@ export class AssetsClient {
         append(query, 'type', options.type);
         append(query, 'folder', options.folder);
         append(query, 'checksum', options.checksum);
+        append(query, 'collection_id', options.collectionId);
+        append(query, 'duplicates', options.duplicates === undefined ? undefined : String(options.duplicates));
+        append(query, 'security', options.security);
         append(query, 'status', options.status);
         append(query, 'scan_status', options.scanStatus);
         append(query, 'replication_status', options.replicationStatus);
@@ -300,8 +309,8 @@ export class AssetsClient {
     createCollection(input) {
         return this.client.request('/assets/collections', { method: 'POST', body: input });
     }
-    updateCollection(collectionId, input) {
-        return this.client.request(`/assets/collections/${encodeURIComponent(collectionId)}`, { method: 'PUT', body: input });
+    updateCollection(collectionId, revision, input) {
+        return this.client.request(`/assets/collections/${encodeURIComponent(collectionId)}`, { method: 'PUT', body: input, headers: { 'If-Match': `"${revision}"` } });
     }
     deleteCollection(collectionId) {
         return this.client.request(`/assets/collections/${encodeURIComponent(collectionId)}`, { method: 'DELETE' });

package/dist/client.d.ts

@@ -1,8 +1,12 @@
+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;
     readonly mailBaseUrl: string;
@@ -10,6 +14,7 @@ export declare class StackShift {
     readonly projects: ProjectsClient;
     readonly assets: AssetsClient;
     readonly mail: MailClient;
+    readonly workloadSecurity: WorkloadSecurityClient;
     private readonly fetcher;
     constructor(options?: StackShiftOptions);
     request<T>(path: string, init?: {
@@ -27,6 +32,7 @@ export declare class StackShift {
         body?: unknown;
         headers?: Record<string, string>;
     }): Promise<T>;
+    playbackRequest<T>(path: '/sessions/renew' | '/events', credential: string, body: unknown): Promise<T>;
     private requestFrom;
     private fetchFrom;
 }

package/dist/client.js

@@ -1,10 +1,14 @@
+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';
 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;
     mailBaseUrl;
@@ -12,20 +16,24 @@ export class StackShift {
     projects;
     assets;
     mail;
+    workloadSecurity;
     fetcher;
     constructor(options = {}) {
         const apiKey = options.apiKey ?? env('STACKSHIFT_API_KEY');
         if (!apiKey) {
             throw new Error('StackShift SDK requires an apiKey');
         }
+        this.assetSpaceId = options.assetSpaceId;
         this.apiKey = apiKey;
         this.baseUrl = (options.baseUrl ?? defaultBaseUrl).replace(/\/$/, '');
         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);
+        this.workloadSecurity = new WorkloadSecurityClient(this);
     }
     async request(path, init = {}) {
         return this.requestFrom(this.baseUrl, path, init);
@@ -36,6 +44,11 @@ export class StackShift {
     async mailRequest(path, init = {}) {
         return this.requestFrom(this.mailBaseUrl, path, init);
     }
+    playbackRequest(path, credential, body) {
+        return this.requestFrom(new URL(this.baseUrl).origin, `/playback${path}`, {
+            method: 'POST', body, headers: { Authorization: `Bearer ${credential}` },
+        });
+    }
     async requestFrom(baseUrl, path, init) {
         const response = await this.fetchFrom(baseUrl, path, init);
         const raw = await response.text();
@@ -51,6 +64,7 @@ export class StackShift {
             method: init.method ?? 'GET',
             headers: stripUndefined({
                 Authorization: `Bearer ${this.apiKey}`,
+                'X-Asset-Space-ID': path.startsWith('/assets') ? this.assetSpaceId : undefined,
                 'Content-Type': isFormData ? undefined : 'application/json',
                 ...init.headers,
             }),