@shotstack/shotstack-studio 2.10.2 → 2.11.1

package/dist/index.d.ts

@@ -192,7 +192,7 @@ export declare class Edit {
      * Move a clip identified by stable ID to a different track and/or start time.
      */
     moveClipById(clipId: string, toTrackIndex: number, newStart?: Seconds): Promise<void>;
-    addClip(trackIdx: number, clip: Clip): void | Promise<void>;
+    addClip(trackIdx: number, clip: Clip): Promise<void>;
     addSvgClip(svgMarkup: string, opts?: {
         trackIndex?: number;
         start?: Seconds;
@@ -219,6 +219,16 @@ export declare class Edit {
     canDeleteClip(trackIdx: number, clipIdx: number): boolean;
     deleteClip(trackIdx: number, clipIdx: number): Promise<void>;
     addTrack(trackIdx: number, track: Track): Promise<void>;
+    /**
+     * Add a font to the timeline.
+     */
+    addFont(src: string): Promise<void>;
+    /**
+     * Replace timeline fonts wholesale.
+     */
+    setFonts(fonts: Array<{
+        src: string;
+    }>): Promise<void>;
     /**
      * Auto-link rich-caption clips to the first eligible source clip.
      * If an alias reference in the caption's src can't be resolved, link it automatically.
@@ -233,6 +243,10 @@ export declare class Edit {
      */
     private addCommandToHistory;
     updateClip(trackIdx: number, clipIdx: number, updates: Partial<Clip>): Promise<void>;
+    /**
+     * HEAD-check every external http(s) URL in a payload
+     */
+    private preflightAssetUrls;
     /**
      * Handle command result - only add to history if successful.
      */

package/dist/internal.d.ts

@@ -97,7 +97,7 @@ export declare class Edit {
      * Move a clip identified by stable ID to a different track and/or start time.
      */
     moveClipById(clipId: string, toTrackIndex: number, newStart?: Seconds): Promise<void>;
-    addClip(trackIdx: number, clip: Clip): void | Promise<void>;
+    addClip(trackIdx: number, clip: Clip): Promise<void>;
     addSvgClip(svgMarkup: string, opts?: {
         trackIndex?: number;
         start?: Seconds;
@@ -124,6 +124,16 @@ export declare class Edit {
     canDeleteClip(trackIdx: number, clipIdx: number): boolean;
     deleteClip(trackIdx: number, clipIdx: number): Promise<void>;
     addTrack(trackIdx: number, track: Track): Promise<void>;
+    /**
+     * Add a font to the timeline.
+     */
+    addFont(src: string): Promise<void>;
+    /**
+     * Replace timeline fonts wholesale.
+     */
+    setFonts(fonts: Array<{
+        src: string;
+    }>): Promise<void>;
     /**
      * Auto-link rich-caption clips to the first eligible source clip.
      * If an alias reference in the caption's src can't be resolved, link it automatically.
@@ -138,6 +148,10 @@ export declare class Edit {
      */
     private addCommandToHistory;
     updateClip(trackIdx: number, clipIdx: number, updates: Partial<Clip>): Promise<void>;
+    /**
+     * HEAD-check every external http(s) URL in a payload
+     */
+    private preflightAssetUrls;
     /**
      * Handle command result - only add to history if successful.
      */
@@ -363,6 +377,18 @@ declare class EventEmitter<TEventPayloadMap extends EventPayloadMap = EventPaylo
 
 declare type EventPayloadMap<TPayload = any> = Record<string, TPayload>;
 
+/**
+ * Thrown by mutation methods (addClip, addTrack, addFont, setFonts) when a
+ * referenced asset/font URL fails preflight.
+ */
+export declare class InvalidAssetUrlError extends Error {
+    readonly code: "INVALID_ASSET_URL";
+    readonly url: string;
+    readonly status: number | undefined;
+    readonly reason: string;
+    constructor(url: string, status: number | undefined, reason: string);
+}
+
 declare type Listener<TPayload = any> = (payload: TPayload) => void;
 
 /**