@editframe/api 0.12.0-beta.2 → 0.12.0-beta.21

package/dist/ProgressIterator.d.ts

@@ -1,4 +1,4 @@
-import { CompleteEvent, ProgressEvent, StreamEventSource } from './StreamEventSource.ts';
+import { CompleteEvent, ProgressEvent, StreamEventSource } from './StreamEventSource.js';
 declare abstract class BaseEventIterator<T extends CompleteEvent | any> implements AsyncIterable<T> {
     protected eventSource: StreamEventSource;
     protected queue: T[];

package/dist/ProgressIterator.js

@@ -1,9 +1,21 @@
+const promiseWithResolvers = () => {
+  if (typeof Promise.withResolvers === "function") {
+    return Promise.withResolvers();
+  }
+  let resolve;
+  let reject;
+  const promise = new Promise((res, rej) => {
+    resolve = res;
+    reject = rej;
+  });
+  return { promise, resolve, reject };
+};
 class BaseEventIterator {
   constructor(eventSource) {
     this.queue = [];
     this.index = 0;
     this.isComplete = false;
-    this.resolversNext = Promise.withResolvers();
+    this.resolversNext = promiseWithResolvers();
     this.eventSource = eventSource;
   }
   async whenComplete() {
@@ -14,7 +26,7 @@ class BaseEventIterator {
   push(event) {
     this.queue.push(event);
     this.resolversNext.resolve();
-    this.resolversNext = Promise.withResolvers();
+    this.resolversNext = promiseWithResolvers();
   }
   get queueLength() {
     return this.queue.length - this.index;

package/dist/StreamEventSource.d.ts

@@ -1,4 +1,4 @@
-type EventCallback<T> = (event: T) => void;
+export type EventCallback<T> = (event: T) => void;
 export type StreamEventSourceEventMap = {
     progress: ProgressEvent;
     complete: CompleteEvent;
@@ -8,7 +8,7 @@ export type StreamEventSourceEventMap = {
         id: string | undefined;
         data: string;
     };
-    end: [];
+    end: Array<unknown>;
     error: Error;
 };
 export type ProgressEvent = {
@@ -47,4 +47,3 @@ export declare class StreamEventSource {
     private startReading;
     close(): void;
 }
-export {};

package/dist/StreamEventSource.js

@@ -105,7 +105,6 @@ class StreamEventSource {
         }
         this.parser.feed(chunk);
       }
-      this.activeReader.releaseLock();
       this.activeReader = null;
       this.emit("end", []);
     } catch (error) {
@@ -119,7 +118,6 @@ class StreamEventSource {
   }
   close() {
     if (this.activeReader) {
-      this.activeReader.releaseLock();
       this.activeReader = null;
     }
     this.parser.reset();

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { StreamEventSource } from './StreamEventSource.ts';
+import { StreamEventSource } from './StreamEventSource.js';
 export declare class Client {
     #private;
     constructor(token?: string, efHost?: string);

package/dist/index.d.ts

@@ -1,10 +1,13 @@
-export { createCaptionFile, CreateCaptionFilePayload, type CreateCaptionFileResult, uploadCaptionFile, type LookupCaptionFileByMd5Result, lookupCaptionFileByMd5, } from './resources/caption-file.ts';
-export { createImageFile, CreateImageFilePayload, type CreateImageFileResult, uploadImageFile, type LookupImageFileByMd5Result, lookupImageFileByMd5, } from './resources/image-file.ts';
-export { createISOBMFFFile, CreateISOBMFFFilePayload, type CreateISOBMFFFileResult, uploadFragmentIndex, type LookupISOBMFFFileByMd5Result, lookupISOBMFFFileByMd5, type GetISOBMFFFileTranscriptionResult, getISOBMFFFileTranscription, } from './resources/isobmff-file.ts';
-export { createISOBMFFTrack, CreateISOBMFFTrackPayload, type CreateISOBMFFTrackResult, uploadISOBMFFTrack, } from './resources/isobmff-track.ts';
-export { createRender, CreateRenderPayload, type CreateRenderResult, uploadRender, type LookupRenderByMd5Result, lookupRenderByMd5, } from './resources/renders.ts';
-export { createTranscription, CreateTranscriptionPayload, type CreateTranscriptionResult, getTranscriptionInfo, getTranscriptionProgress, type TranscriptionInfoResult, } from './resources/transcriptions.ts';
-export { createURLToken, type URLTokenResult, } from './resources/url-token.ts';
-export { createUnprocessedFile, CreateUnprocessedFilePayload, type CreateUnprocessedFileResult, uploadUnprocessedFile, type LookupUnprocessedFileByMd5Result, lookupUnprocessedFileByMd5, processIsobmffFile, type ProcessIsobmffFileResult, } from './resources/unprocessed-file.ts';
-export { getIsobmffProcessInfo, getIsobmffProcessProgress, type IsobmffProcessInfoResult, } from './resources/process-isobmff.ts';
-export { Client } from './client.ts';
+export { createCaptionFile, CreateCaptionFilePayload, type CreateCaptionFileResult, uploadCaptionFile, type LookupCaptionFileByMd5Result, lookupCaptionFileByMd5, } from './resources/caption-file.js';
+export { createImageFile, CreateImageFilePayload, type CreateImageFileResult, uploadImageFile, type LookupImageFileByMd5Result, lookupImageFileByMd5, } from './resources/image-file.js';
+export { createISOBMFFFile, CreateISOBMFFFilePayload, type CreateISOBMFFFileResult, uploadFragmentIndex, type LookupISOBMFFFileByMd5Result, lookupISOBMFFFileByMd5, type GetISOBMFFFileTranscriptionResult, getISOBMFFFileTranscription, type TranscribeISOBMFFFileResult, transcribeISOBMFFFile, TranscribeISOBMFFFilePayload, } from './resources/isobmff-file.js';
+export { createISOBMFFTrack, CreateISOBMFFTrackPayload, type CreateISOBMFFTrackResult, uploadISOBMFFTrack, } from './resources/isobmff-track.js';
+export { createRender, CreateRenderPayload, type CreateRenderResult, uploadRender, type LookupRenderByMd5Result, lookupRenderByMd5, } from './resources/renders.js';
+export { createTranscription, CreateTranscriptionPayload, type CreateTranscriptionResult, getTranscriptionInfo, getTranscriptionProgress, type TranscriptionInfoResult, } from './resources/transcriptions.js';
+export { createURLToken, type URLTokenResult, } from './resources/url-token.js';
+export { createUnprocessedFile, CreateUnprocessedFilePayload, type CreateUnprocessedFileResult, uploadUnprocessedReadableStream, type LookupUnprocessedFileByMd5Result, lookupUnprocessedFileByMd5, processIsobmffFile, type ProcessIsobmffFileResult, type UnprocessedFileUploadDetails, type UnprocessedFile, } from './resources/unprocessed-file.js';
+export { getIsobmffProcessInfo, getIsobmffProcessProgress, type IsobmffProcessInfoResult, } from './resources/process-isobmff.js';
+export { Client } from './client.js';
+export type { IteratorWithPromise, UploadChunkEvent } from './uploadChunks.js';
+export type { ProgressIterator, CompletionIterator, } from './ProgressIterator.js';
+export type { StreamEventSource, ProgressEvent, CompletionEvent, StreamEventSourceEventMap, EventCallback, } from './StreamEventSource.js';

package/dist/index.js

@@ -1,11 +1,11 @@
 import { CreateCaptionFilePayload, createCaptionFile, lookupCaptionFileByMd5, uploadCaptionFile } from "./resources/caption-file.js";
 import { CreateImageFilePayload, createImageFile, lookupImageFileByMd5, uploadImageFile } from "./resources/image-file.js";
-import { CreateISOBMFFFilePayload, createISOBMFFFile, getISOBMFFFileTranscription, lookupISOBMFFFileByMd5, uploadFragmentIndex } from "./resources/isobmff-file.js";
+import { CreateISOBMFFFilePayload, TranscribeISOBMFFFilePayload, createISOBMFFFile, getISOBMFFFileTranscription, lookupISOBMFFFileByMd5, transcribeISOBMFFFile, uploadFragmentIndex } from "./resources/isobmff-file.js";
 import { CreateISOBMFFTrackPayload, createISOBMFFTrack, uploadISOBMFFTrack } from "./resources/isobmff-track.js";
 import { CreateRenderPayload, createRender, lookupRenderByMd5, uploadRender } from "./resources/renders.js";
 import { CreateTranscriptionPayload, createTranscription, getTranscriptionInfo, getTranscriptionProgress } from "./resources/transcriptions.js";
 import { createURLToken } from "./resources/url-token.js";
-import { CreateUnprocessedFilePayload, createUnprocessedFile, lookupUnprocessedFileByMd5, processIsobmffFile, uploadUnprocessedFile } from "./resources/unprocessed-file.js";
+import { CreateUnprocessedFilePayload, createUnprocessedFile, lookupUnprocessedFileByMd5, processIsobmffFile, uploadUnprocessedReadableStream } from "./resources/unprocessed-file.js";
 import { getIsobmffProcessInfo, getIsobmffProcessProgress } from "./resources/process-isobmff.js";
 import { Client } from "./client.js";
 export {
@@ -17,6 +17,7 @@ export {
   CreateRenderPayload,
   CreateTranscriptionPayload,
   CreateUnprocessedFilePayload,
+  TranscribeISOBMFFFilePayload,
   createCaptionFile,
   createISOBMFFFile,
   createISOBMFFTrack,
@@ -36,10 +37,11 @@ export {
   lookupRenderByMd5,
   lookupUnprocessedFileByMd5,
   processIsobmffFile,
+  transcribeISOBMFFFile,
   uploadCaptionFile,
   uploadFragmentIndex,
   uploadISOBMFFTrack,
   uploadImageFile,
   uploadRender,
-  uploadUnprocessedFile
+  uploadUnprocessedReadableStream
 };

package/dist/node.d.ts

@@ -0,0 +1,6 @@
+import { Client } from './client.js';
+import { UnprocessedFileUploadDetails } from './resources/unprocessed-file.js';
+export declare const createImageFileFromPath: (client: Client, path: string) => Promise<import('./index.js').CreateImageFileResult>;
+export declare const createUnprocessedFileFromPath: (client: Client, path: string) => Promise<import('./index.js').CreateUnprocessedFileResult>;
+export declare const uploadUnprocessedFile: (client: Client, uploadDetails: UnprocessedFileUploadDetails, path: string) => Promise<import('./uploadChunks.ts').IteratorWithPromise<import('./uploadChunks.ts').UploadChunkEvent>>;
+export * from './index.js';

package/dist/node.js

@@ -0,0 +1,92 @@
+import { stat } from "node:fs/promises";
+import { basename } from "node:path";
+import mime from "mime";
+import { md5FilePath } from "@editframe/assets";
+import { createImageFile, CreateImageFilePayload } from "./resources/image-file.js";
+import { lookupImageFileByMd5, uploadImageFile } from "./resources/image-file.js";
+import { createUnprocessedFile, uploadUnprocessedReadableStream } from "./resources/unprocessed-file.js";
+import { CreateUnprocessedFilePayload, lookupUnprocessedFileByMd5, processIsobmffFile } from "./resources/unprocessed-file.js";
+import { CreateCaptionFilePayload, createCaptionFile, lookupCaptionFileByMd5, uploadCaptionFile } from "./resources/caption-file.js";
+import { CreateISOBMFFFilePayload, TranscribeISOBMFFFilePayload, createISOBMFFFile, getISOBMFFFileTranscription, lookupISOBMFFFileByMd5, transcribeISOBMFFFile, uploadFragmentIndex } from "./resources/isobmff-file.js";
+import { CreateISOBMFFTrackPayload, createISOBMFFTrack, uploadISOBMFFTrack } from "./resources/isobmff-track.js";
+import { CreateRenderPayload, createRender, lookupRenderByMd5, uploadRender } from "./resources/renders.js";
+import { CreateTranscriptionPayload, createTranscription, getTranscriptionInfo, getTranscriptionProgress } from "./resources/transcriptions.js";
+import { createURLToken } from "./resources/url-token.js";
+import { getIsobmffProcessInfo, getIsobmffProcessProgress } from "./resources/process-isobmff.js";
+import { Client } from "./client.js";
+const createImageFileFromPath = async (client, path) => {
+  const fileInfo = await stat(path);
+  const byte_size = fileInfo.size;
+  const md5 = await md5FilePath(path);
+  const mime_type = mime.getType(path);
+  return createImageFile(client, {
+    ...CreateImageFilePayload.parse({
+      md5,
+      height: 0,
+      width: 0,
+      mime_type,
+      filename: basename(path),
+      byte_size
+    })
+  });
+};
+const createUnprocessedFileFromPath = async (client, path) => {
+  const fileInfo = await stat(path);
+  const byte_size = fileInfo.size;
+  const md5 = await md5FilePath(path);
+  return createUnprocessedFile(client, {
+    md5,
+    filename: basename(path),
+    byte_size
+  });
+};
+const uploadUnprocessedFile = async (client, uploadDetails, path) => {
+  const { createReadStream } = await import("node:fs");
+  const readStream = createReadStream(path);
+  const { createReadableStreamFromReadable } = await import("./utils/createReadableStreamFromReadable.js");
+  return uploadUnprocessedReadableStream(
+    client,
+    uploadDetails,
+    createReadableStreamFromReadable(readStream)
+  );
+};
+export {
+  Client,
+  CreateCaptionFilePayload,
+  CreateISOBMFFFilePayload,
+  CreateISOBMFFTrackPayload,
+  CreateImageFilePayload,
+  CreateRenderPayload,
+  CreateTranscriptionPayload,
+  CreateUnprocessedFilePayload,
+  TranscribeISOBMFFFilePayload,
+  createCaptionFile,
+  createISOBMFFFile,
+  createISOBMFFTrack,
+  createImageFile,
+  createImageFileFromPath,
+  createRender,
+  createTranscription,
+  createURLToken,
+  createUnprocessedFile,
+  createUnprocessedFileFromPath,
+  getISOBMFFFileTranscription,
+  getIsobmffProcessInfo,
+  getIsobmffProcessProgress,
+  getTranscriptionInfo,
+  getTranscriptionProgress,
+  lookupCaptionFileByMd5,
+  lookupISOBMFFFileByMd5,
+  lookupImageFileByMd5,
+  lookupRenderByMd5,
+  lookupUnprocessedFileByMd5,
+  processIsobmffFile,
+  transcribeISOBMFFFile,
+  uploadCaptionFile,
+  uploadFragmentIndex,
+  uploadISOBMFFTrack,
+  uploadImageFile,
+  uploadRender,
+  uploadUnprocessedFile,
+  uploadUnprocessedReadableStream
+};

package/dist/resources/caption-file.d.ts

@@ -1,26 +1,54 @@
 import { z } from 'zod';
-import { Client } from '../client.ts';
+import { Client } from '../client.js';
 export declare const CreateCaptionFilePayload: z.ZodObject<{
+    /**
+     * The md5 hash of the caption file
+     */
     md5: z.ZodString;
+    /**
+     * The filename of the caption file
+     */
     filename: z.ZodString;
+    /**
+     * The size of the caption file in bytes
+     */
     byte_size: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    md5: string;
     filename: string;
+    md5: string;
     byte_size: number;
 }, {
-    md5: string;
     filename: string;
+    md5: string;
     byte_size: number;
 }>;
+export type CreateCaptionFilePayload = z.infer<typeof CreateCaptionFilePayload>;
 export interface CreateCaptionFileResult {
+    /**
+     * Whether the caption file is complete
+     */
     complete: boolean | null;
+    /**
+     * The id of the caption file
+     */
     id: string;
+    /**
+     * The md5 hash of the caption file
+     */
     md5: string;
 }
 export interface LookupCaptionFileByMd5Result {
+    /**
+     * Whether the caption file is complete
+     */
     complete: boolean | null;
+    /**
+     * The id of the caption file
+     */
     id: string;
+    /**
+     * The md5 hash of the caption file
+     */
     md5: string;
 }
 /**
@@ -40,6 +68,6 @@ export interface LookupCaptionFileByMd5Result {
  * @resource
  * @beta
  */
-export declare const createCaptionFile: (client: Client, payload: z.infer<typeof CreateCaptionFilePayload>) => Promise<CreateCaptionFileResult>;
+export declare const createCaptionFile: (client: Client, payload: CreateCaptionFilePayload) => Promise<CreateCaptionFileResult>;
 export declare const uploadCaptionFile: (client: Client, fileId: string, fileStream: ReadableStream, fileSize: number) => Promise<any>;
 export declare const lookupCaptionFileByMd5: (client: Client, md5: string) => Promise<LookupCaptionFileByMd5Result | null>;

package/dist/resources/caption-file.js

@@ -3,8 +3,17 @@ import { z } from "zod";
 const log = debug("ef:api:caption-file");
 const MAX_CAPTION_SIZE = 1024 * 1024 * 2;
 const CreateCaptionFilePayload = z.object({
+  /**
+   * The md5 hash of the caption file
+   */
   md5: z.string(),
+  /**
+   * The filename of the caption file
+   */
   filename: z.string(),
+  /**
+   * The size of the caption file in bytes
+   */
   byte_size: z.number().int().max(MAX_CAPTION_SIZE)
 });
 const restrictSize = (size) => {

package/dist/resources/image-file.d.ts

@@ -1,37 +1,61 @@
 import { z } from 'zod';
-import { Client } from '../client.ts';
+import { Client } from '../client.js';
 export declare const CreateImageFilePayload: z.ZodObject<{
+    /**
+     * The md5 hash of the image file.
+     */
     md5: z.ZodString;
+    /**
+     * The height of the image file in pixels.
+     */
     height: z.ZodNumber;
+    /**
+     * The width of the image file in pixels.
+     */
     width: z.ZodNumber;
+    /**
+     * The mime type of the image file.
+     */
     mime_type: z.ZodEnum<["image/jpeg", "image/png", "image/jpg", "image/webp"]>;
+    /**
+     * The filename of the image file.
+     */
     filename: z.ZodString;
+    /**
+     * The byte size of the image file.
+     */
     byte_size: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    md5: string;
-    filename: string;
-    byte_size: number;
-    height: number;
     width: number;
-    mime_type: "image/jpeg" | "image/png" | "image/jpg" | "image/webp";
-}, {
-    md5: string;
+    height: number;
     filename: string;
+    md5: string;
+    mime_type: "image/jpeg" | "image/png" | "image/jpg" | "image/webp";
     byte_size: number;
-    height: number;
+}, {
     width: number;
+    height: number;
+    filename: string;
+    md5: string;
     mime_type: "image/jpeg" | "image/png" | "image/jpg" | "image/webp";
+    byte_size: number;
 }>;
+export type CreateImageFilePayload = z.infer<typeof CreateImageFilePayload>;
 export interface CreateImageFileResult {
     complete: boolean | null;
+    byte_size: number;
     id: string;
     md5: string;
 }
 export interface LookupImageFileByMd5Result {
     complete: boolean | null;
+    byte_size: number;
     id: string;
     md5: string;
 }
-export declare const createImageFile: (client: Client, payload: z.infer<typeof CreateImageFilePayload>) => Promise<CreateImageFileResult>;
-export declare const uploadImageFile: (client: Client, fileId: string, fileStream: ReadableStream, fileSize: number) => import('../uploadChunks.ts').IteratorWithPromise<import('../uploadChunks.ts').UploadChunkEvent>;
+export declare const createImageFile: (client: Client, payload: CreateImageFilePayload) => Promise<CreateImageFileResult>;
+export declare const uploadImageFile: (client: Client, uploadDetails: {
+    id: string;
+    byte_size: number;
+}, fileStream: ReadableStream) => import('../uploadChunks.js').IteratorWithPromise<import('../uploadChunks.js').UploadChunkEvent>;
 export declare const lookupImageFileByMd5: (client: Client, md5: string) => Promise<LookupImageFileByMd5Result | null>;

package/dist/resources/image-file.js

@@ -4,11 +4,29 @@ import { uploadChunks } from "../uploadChunks.js";
 const log = debug("ef:api:image-file");
 const MAX_IMAGE_SIZE = 1024 * 1024 * 16;
 const CreateImageFilePayload = z.object({
+  /**
+   * The md5 hash of the image file.
+   */
   md5: z.string(),
+  /**
+   * The height of the image file in pixels.
+   */
   height: z.number().int(),
+  /**
+   * The width of the image file in pixels.
+   */
   width: z.number().int(),
+  /**
+   * The mime type of the image file.
+   */
   mime_type: z.enum(["image/jpeg", "image/png", "image/jpg", "image/webp"]),
+  /**
+   * The filename of the image file.
+   */
   filename: z.string(),
+  /**
+   * The byte size of the image file.
+   */
   byte_size: z.number().int().max(MAX_IMAGE_SIZE)
 });
 const createImageFile = async (client, payload) => {
@@ -26,11 +44,11 @@ const createImageFile = async (client, payload) => {
     `Failed to create file ${response.status} ${response.statusText}`
   );
 };
-const uploadImageFile = (client, fileId, fileStream, fileSize) => {
-  log("Uploading image file", fileId);
+const uploadImageFile = (client, uploadDetails, fileStream) => {
+  log("Uploading image file", uploadDetails.id);
   return uploadChunks(client, {
-    url: `/api/v1/image_files/${fileId}/upload`,
-    fileSize,
+    url: `/api/v1/image_files/${uploadDetails.id}/upload`,
+    fileSize: uploadDetails.byte_size,
     fileStream,
     maxSize: MAX_IMAGE_SIZE
   });

package/dist/resources/isobmff-file.d.ts

@@ -1,23 +1,42 @@
 import { z } from 'zod';
-import { Client } from '../client.ts';
+import { Client } from '../client.js';
 export declare const CreateISOBMFFFilePayload: z.ZodObject<{
     md5: z.ZodString;
     filename: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    md5: string;
     filename: string;
-}, {
     md5: string;
+}, {
     filename: string;
+    md5: string;
 }>;
+export type CreateISOBMFFFilePayload = z.infer<typeof CreateISOBMFFFilePayload>;
 export interface CreateISOBMFFFileResult {
+    /**
+     * Whether the fragment index is complete. The fragment index is used internally by editframe to efficiently seek within files.
+     */
     fragment_index_complete: boolean;
+    /**
+     * The filename of the isobmff file
+     */
     filename: string;
+    /**
+     * The id of the isobmff file
+     */
     id: string;
+    /**
+     * The md5 hash of the isobmff file
+     */
     md5: string;
 }
 export interface LookupISOBMFFFileByMd5Result {
+    /**
+     * Whether the fragment index is complete
+     */
     fragment_index_complete: boolean;
+    /**
+     * The filename of the isobmff file
+     */
     filename: string;
     id: string;
     md5: string;
@@ -29,7 +48,21 @@ export interface GetISOBMFFFileTranscriptionResult {
         duration_ms: number;
     };
 }
-export declare const createISOBMFFFile: (client: Client, payload: z.infer<typeof CreateISOBMFFFilePayload>) => Promise<CreateISOBMFFFileResult>;
+export declare const createISOBMFFFile: (client: Client, payload: CreateISOBMFFFilePayload) => Promise<CreateISOBMFFFileResult>;
 export declare const uploadFragmentIndex: (client: Client, fileId: string, fileStream: ReadableStream, fileSize: number) => Promise<any>;
 export declare const lookupISOBMFFFileByMd5: (client: Client, md5: string) => Promise<LookupISOBMFFFileByMd5Result | null>;
 export declare const getISOBMFFFileTranscription: (client: Client, id: string) => Promise<GetISOBMFFFileTranscriptionResult | null>;
+export declare const TranscribeISOBMFFFilePayload: z.ZodObject<{
+    trackId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    trackId?: string | undefined;
+}, {
+    trackId?: string | undefined;
+}>;
+export type TranscribeISOBMFFFilePayload = z.infer<typeof TranscribeISOBMFFFilePayload>;
+export interface TranscribeISOBMFFFileResult {
+    id: string;
+    file_id: string;
+    track_id: number;
+}
+export declare const transcribeISOBMFFFile: (client: Client, id: string, payload?: TranscribeISOBMFFFilePayload) => Promise<TranscribeISOBMFFFileResult>;

package/dist/resources/isobmff-file.js

@@ -73,10 +73,30 @@ const getISOBMFFFileTranscription = async (client, id) => {
     `Failed to get isobmff file transcription ${id} ${response.status} ${response.statusText}`
   );
 };
+const TranscribeISOBMFFFilePayload = z.object({
+  trackId: z.string().optional()
+});
+const transcribeISOBMFFFile = async (client, id, payload = {}) => {
+  const response = await client.authenticatedFetch(
+    `/api/v1/isobmff_files/${id}/transcribe`,
+    {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }
+  );
+  if (response.ok) {
+    return await response.json();
+  }
+  throw new Error(
+    `Failed to transcribe isobmff file ${id} ${response.status} ${response.statusText}`
+  );
+};
 export {
   CreateISOBMFFFilePayload,
+  TranscribeISOBMFFFilePayload,
   createISOBMFFFile,
   getISOBMFFFileTranscription,
   lookupISOBMFFFileByMd5,
+  transcribeISOBMFFFile,
   uploadFragmentIndex
 };