@editframe/api 0.37.3-beta → 0.38.1

package/dist/resources/file.cjs

@@ -0,0 +1,145 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_ProgressIterator = require('../ProgressIterator.cjs');
+const require_uploadChunks = require('../uploadChunks.cjs');
+const require_isobmff_track = require('./isobmff-track.cjs');
+let debug = require("debug");
+debug = require_rolldown_runtime.__toESM(debug);
+let zod = require("zod");
+zod = require_rolldown_runtime.__toESM(zod);
+
+//#region src/resources/file.ts
+const log = (0, debug.default)("ef:api:file");
+const MAX_VIDEO_SIZE = 1024 * 1024 * 1024;
+const MAX_IMAGE_SIZE = 1024 * 1024 * 16;
+const MAX_CAPTION_SIZE = 1024 * 1024 * 2;
+const FileType = zod.z.enum([
+	"video",
+	"image",
+	"caption"
+]);
+const FileStatus = zod.z.enum([
+	"created",
+	"uploading",
+	"processing",
+	"ready",
+	"failed"
+]);
+const CreateFilePayload = zod.z.object({
+	filename: zod.z.string(),
+	type: FileType,
+	byte_size: zod.z.number().int().positive(),
+	md5: zod.z.string().optional(),
+	mime_type: zod.z.string().optional()
+});
+const MAX_SIZE_BY_TYPE = {
+	video: MAX_VIDEO_SIZE,
+	image: MAX_IMAGE_SIZE,
+	caption: MAX_CAPTION_SIZE
+};
+const createFile = async (client, payload) => {
+	log("Creating a file", payload);
+	CreateFilePayload.parse(payload);
+	const maxSize = MAX_SIZE_BY_TYPE[payload.type];
+	if (payload.byte_size > maxSize) throw new Error(`File size ${payload.byte_size} bytes exceeds limit ${maxSize} bytes for type ${payload.type}`);
+	const response = await client.authenticatedFetch("/api/v1/files", {
+		method: "POST",
+		body: JSON.stringify(payload)
+	});
+	log("File created", response.status, response.statusText);
+	if (response.ok) return await response.json();
+	throw new Error(`Failed to create file ${response.status} ${response.statusText}`);
+};
+const uploadFile = (client, uploadDetails, fileStream) => {
+	log("Uploading file", uploadDetails.id);
+	const maxSize = MAX_SIZE_BY_TYPE[uploadDetails.type];
+	return require_uploadChunks.uploadChunks(client, {
+		url: `/api/v1/files/${uploadDetails.id}/upload`,
+		fileSize: uploadDetails.byte_size,
+		fileStream,
+		maxSize
+	});
+};
+const getFileDetail = async (client, id) => {
+	const response = await client.authenticatedFetch(`/api/v1/files/${id}`, { method: "GET" });
+	if (response.ok) return await response.json();
+	if (response.status === 404) throw new Error(`File not found: ${id}`);
+	throw new Error(`Failed to get file detail ${response.status} ${response.statusText}`);
+};
+const lookupFileByMd5 = async (client, md5) => {
+	const response = await client.authenticatedFetch(`/api/v1/files/md5/${md5}`, { method: "GET" });
+	if (response.ok) return await response.json();
+	if (response.status === 404) return null;
+	throw new Error(`Failed to lookup file by md5 ${md5} ${response.status} ${response.statusText}`);
+};
+const deleteFile = async (client, id) => {
+	const response = await client.authenticatedFetch(`/api/v1/files/${id}/delete`, { method: "POST" });
+	if (response.ok) return await response.json();
+	throw new Error(`Failed to delete file ${id} ${response.status} ${response.statusText}`);
+};
+const getFileProcessingProgress = async (client, id) => {
+	return new require_ProgressIterator.ProgressIterator(await client.authenticatedEventSource(`/api/v1/files/${id}/progress`));
+};
+const transcribeFile = async (client, id, options = {}) => {
+	const response = await client.authenticatedFetch(`/api/v1/files/${id}/transcribe`, {
+		method: "POST",
+		body: JSON.stringify(options)
+	});
+	if (response.ok) return await response.json();
+	throw new Error(`Failed to transcribe file ${id} ${response.status} ${response.statusText}`);
+};
+const getFileTranscription = async (client, id) => {
+	const response = await client.authenticatedFetch(`/api/v1/files/${id}/transcription`, { method: "GET" });
+	if (response.ok) return await response.json();
+	if (response.status === 404) return null;
+	throw new Error(`Failed to get file transcription ${id} ${response.status} ${response.statusText}`);
+};
+const createFileTrack = async (client, fileId, payload) => {
+	log("Creating file track", fileId, payload);
+	require_isobmff_track.CreateISOBMFFTrackPayload.parse(payload);
+	const response = await client.authenticatedFetch(`/api/v1/files/${fileId}/tracks`, {
+		method: "POST",
+		body: JSON.stringify(payload)
+	});
+	log("File track created", response.status, response.statusText);
+	if (response.ok) return await response.json();
+	throw new Error(`Failed to create file track ${response.status} ${response.statusText}`);
+};
+const uploadFileTrack = (client, fileId, trackId, byteSize, fileStream) => {
+	log("Uploading file track", fileId, trackId);
+	return require_uploadChunks.uploadChunks(client, {
+		url: `/api/v1/files/${fileId}/tracks/${trackId}/upload`,
+		fileSize: byteSize,
+		fileStream,
+		maxSize: MAX_VIDEO_SIZE
+	});
+};
+const FRAGMENT_INDEX_SIZE_LIMIT = 1024 * 1024 * 50;
+const uploadFileIndex = async (client, fileId, fileStream, fileSize) => {
+	log("Uploading file index", fileId);
+	if (fileSize > FRAGMENT_INDEX_SIZE_LIMIT) throw new Error(`Fragment index size ${fileSize} exceeds limit of ${FRAGMENT_INDEX_SIZE_LIMIT} bytes`);
+	const response = await client.authenticatedFetch(`/api/v1/files/${fileId}/index/upload`, {
+		method: "POST",
+		body: fileStream,
+		duplex: "half"
+	});
+	log("File index uploaded", response.status, response.statusText);
+	if (response.ok) return response.json();
+	throw new Error(`Failed to upload file index ${response.status} ${response.statusText}`);
+};
+
+//#endregion
+exports.CreateFilePayload = CreateFilePayload;
+exports.FileStatus = FileStatus;
+exports.FileType = FileType;
+exports.createFile = createFile;
+exports.createFileTrack = createFileTrack;
+exports.deleteFile = deleteFile;
+exports.getFileDetail = getFileDetail;
+exports.getFileProcessingProgress = getFileProcessingProgress;
+exports.getFileTranscription = getFileTranscription;
+exports.lookupFileByMd5 = lookupFileByMd5;
+exports.transcribeFile = transcribeFile;
+exports.uploadFile = uploadFile;
+exports.uploadFileIndex = uploadFileIndex;
+exports.uploadFileTrack = uploadFileTrack;
+//# sourceMappingURL=file.cjs.map

package/dist/resources/file.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.cjs","names":["z","MAX_SIZE_BY_TYPE: Record<FileType, number>","uploadChunks","ProgressIterator"],"sources":["../../src/resources/file.ts"],"sourcesContent":["import debug from \"debug\";\nimport { z } from \"zod\";\n\nimport type { Client } from \"../client.js\";\nimport { ProgressIterator } from \"../ProgressIterator.js\";\nimport { uploadChunks } from \"../uploadChunks.js\";\nimport {\n  CreateISOBMFFTrackPayload,\n  type CreateISOBMFFTrackResult,\n} from \"./isobmff-track.js\";\n\nconst log = debug(\"ef:api:file\");\n\nconst MAX_VIDEO_SIZE = 1024 * 1024 * 1024; // 1GiB\nconst MAX_IMAGE_SIZE = 1024 * 1024 * 16; // 16MB\nconst MAX_CAPTION_SIZE = 1024 * 1024 * 2; // 2MB\n\nexport const FileType = z.enum([\"video\", \"image\", \"caption\"]);\nexport type FileType = z.infer<typeof FileType>;\n\nexport const FileStatus = z.enum([\n  \"created\",\n  \"uploading\",\n  \"processing\",\n  \"ready\",\n  \"failed\",\n]);\nexport type FileStatus = z.infer<typeof FileStatus>;\n\nexport const CreateFilePayload = z.object({\n  filename: z.string(),\n  type: FileType,\n  byte_size: z.number().int().positive(),\n  md5: z.string().optional(),\n  mime_type: z.string().optional(),\n});\n\nexport type CreateFilePayload = z.infer<typeof CreateFilePayload>;\n\nexport interface FileRecord {\n  id: string;\n  filename: string;\n  type: FileType;\n  status: FileStatus;\n  byte_size: number | null;\n  md5: string | null;\n  next_byte: number;\n}\n\nexport interface CreateFileResult extends FileRecord {}\n\nexport interface FileDetail extends FileRecord {\n  mime_type?: string | null;\n  width?: number | null;\n  height?: number | null;\n  created_at?: string;\n  completed_at?: string | null;\n  expires_at?: string | null;\n  tracks?: Array<{\n    track_id: number;\n    type: string;\n    codec_name: string;\n    duration_ms: number;\n    byte_size: number;\n  }>;\n}\n\nexport interface LookupFileByMd5Result extends FileRecord {}\n\nexport interface TranscribeFileResult {\n  id: string;\n  file_id: string;\n  track_id: number;\n}\n\nexport interface FileTranscriptionResult {\n  id: string;\n  work_slice_ms: number;\n  status: string;\n  completed_at: string | null;\n  failed_at: string | null;\n}\n\nconst MAX_SIZE_BY_TYPE: Record<FileType, number> = {\n  video: MAX_VIDEO_SIZE,\n  image: MAX_IMAGE_SIZE,\n  caption: MAX_CAPTION_SIZE,\n};\n\nexport const createFile = async (\n  client: Client,\n  payload: CreateFilePayload,\n) => {\n  log(\"Creating a file\", payload);\n  CreateFilePayload.parse(payload);\n\n  const maxSize = MAX_SIZE_BY_TYPE[payload.type];\n  if (payload.byte_size > maxSize) {\n    throw new Error(\n      `File size ${payload.byte_size} bytes exceeds limit ${maxSize} bytes for type ${payload.type}`,\n    );\n  }\n\n  const response = await client.authenticatedFetch(\"/api/v1/files\", {\n    method: \"POST\",\n    body: JSON.stringify(payload),\n  });\n\n  log(\"File created\", response.status, response.statusText);\n\n  if (response.ok) {\n    return (await response.json()) as CreateFileResult;\n  }\n\n  throw new Error(\n    `Failed to create file ${response.status} ${response.statusText}`,\n  );\n};\n\nexport const uploadFile = (\n  client: Client,\n  uploadDetails: { id: string; byte_size: number; type: FileType },\n  fileStream: ReadableStream,\n) => {\n  log(\"Uploading file\", uploadDetails.id);\n\n  const maxSize = MAX_SIZE_BY_TYPE[uploadDetails.type];\n\n  return uploadChunks(client, {\n    url: `/api/v1/files/${uploadDetails.id}/upload`,\n    fileSize: uploadDetails.byte_size,\n    fileStream,\n    maxSize,\n  });\n};\n\nexport const getFileDetail = async (\n  client: Client,\n  id: string,\n): Promise<FileDetail> => {\n  const response = await client.authenticatedFetch(`/api/v1/files/${id}`, {\n    method: \"GET\",\n  });\n\n  if (response.ok) {\n    return (await response.json()) as FileDetail;\n  }\n\n  if (response.status === 404) {\n    throw new Error(`File not found: ${id}`);\n  }\n\n  throw new Error(\n    `Failed to get file detail ${response.status} ${response.statusText}`,\n  );\n};\n\nexport const lookupFileByMd5 = async (\n  client: Client,\n  md5: string,\n): Promise<LookupFileByMd5Result | null> => {\n  const response = await client.authenticatedFetch(`/api/v1/files/md5/${md5}`, {\n    method: \"GET\",\n  });\n\n  if (response.ok) {\n    return (await response.json()) as LookupFileByMd5Result;\n  }\n\n  if (response.status === 404) {\n    return null;\n  }\n\n  throw new Error(\n    `Failed to lookup file by md5 ${md5} ${response.status} ${response.statusText}`,\n  );\n};\n\nexport const deleteFile = async (client: Client, id: string) => {\n  const response = await client.authenticatedFetch(\n    `/api/v1/files/${id}/delete`,\n    {\n      method: \"POST\",\n    },\n  );\n\n  if (response.ok) {\n    return (await response.json()) as { success: boolean };\n  }\n\n  throw new Error(\n    `Failed to delete file ${id} ${response.status} ${response.statusText}`,\n  );\n};\n\nexport const getFileProcessingProgress = async (client: Client, id: string) => {\n  const eventSource = await client.authenticatedEventSource(\n    `/api/v1/files/${id}/progress`,\n  );\n\n  return new ProgressIterator(eventSource);\n};\n\nexport const transcribeFile = async (\n  client: Client,\n  id: string,\n  options: { trackId?: number } = {},\n): Promise<TranscribeFileResult> => {\n  const response = await client.authenticatedFetch(\n    `/api/v1/files/${id}/transcribe`,\n    {\n      method: \"POST\",\n      body: JSON.stringify(options),\n    },\n  );\n\n  if (response.ok) {\n    return (await response.json()) as TranscribeFileResult;\n  }\n\n  throw new Error(\n    `Failed to transcribe file ${id} ${response.status} ${response.statusText}`,\n  );\n};\n\nexport const getFileTranscription = async (\n  client: Client,\n  id: string,\n): Promise<FileTranscriptionResult | null> => {\n  const response = await client.authenticatedFetch(\n    `/api/v1/files/${id}/transcription`,\n    {\n      method: \"GET\",\n    },\n  );\n\n  if (response.ok) {\n    return (await response.json()) as FileTranscriptionResult;\n  }\n\n  if (response.status === 404) {\n    return null;\n  }\n\n  throw new Error(\n    `Failed to get file transcription ${id} ${response.status} ${response.statusText}`,\n  );\n};\n\nexport type { CreateISOBMFFTrackPayload as CreateFileTrackPayload };\nexport type { CreateISOBMFFTrackResult as CreateFileTrackResult };\n\nexport const createFileTrack = async (\n  client: Client,\n  fileId: string,\n  payload: CreateISOBMFFTrackPayload,\n): Promise<CreateISOBMFFTrackResult> => {\n  log(\"Creating file track\", fileId, payload);\n  CreateISOBMFFTrackPayload.parse(payload);\n\n  const response = await client.authenticatedFetch(\n    `/api/v1/files/${fileId}/tracks`,\n    {\n      method: \"POST\",\n      body: JSON.stringify(payload),\n    },\n  );\n\n  log(\"File track created\", response.status, response.statusText);\n\n  if (response.ok) {\n    return (await response.json()) as CreateISOBMFFTrackResult;\n  }\n\n  throw new Error(\n    `Failed to create file track ${response.status} ${response.statusText}`,\n  );\n};\n\nexport const uploadFileTrack = (\n  client: Client,\n  fileId: string,\n  trackId: number,\n  byteSize: number,\n  fileStream: ReadableStream,\n) => {\n  log(\"Uploading file track\", fileId, trackId);\n\n  return uploadChunks(client, {\n    url: `/api/v1/files/${fileId}/tracks/${trackId}/upload`,\n    fileSize: byteSize,\n    fileStream,\n    maxSize: MAX_VIDEO_SIZE,\n  });\n};\n\nconst FRAGMENT_INDEX_SIZE_LIMIT = 1024 * 1024 * 50; // 50MB\n\nexport const uploadFileIndex = async (\n  client: Client,\n  fileId: string,\n  fileStream: ReadableStream,\n  fileSize: number,\n) => {\n  log(\"Uploading file index\", fileId);\n  if (fileSize > FRAGMENT_INDEX_SIZE_LIMIT) {\n    throw new Error(\n      `Fragment index size ${fileSize} exceeds limit of ${FRAGMENT_INDEX_SIZE_LIMIT} bytes`,\n    );\n  }\n\n  const response = await client.authenticatedFetch(\n    `/api/v1/files/${fileId}/index/upload`,\n    {\n      method: \"POST\",\n      body: fileStream,\n      duplex: \"half\",\n    },\n  );\n\n  log(\"File index uploaded\", response.status, response.statusText);\n\n  if (response.ok) {\n    return response.json();\n  }\n\n  throw new Error(\n    `Failed to upload file index ${response.status} ${response.statusText}`,\n  );\n};\n"],"mappings":"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"}

package/dist/resources/file.d.cts

@@ -0,0 +1,91 @@
+import { Client } from "../client.cjs";
+import { ProgressIterator } from "../ProgressIterator.cjs";
+import { IteratorWithPromise, UploadChunkEvent } from "../uploadChunks.cjs";
+import { CreateISOBMFFTrackPayload, CreateISOBMFFTrackResult } from "./isobmff-track.cjs";
+import { z } from "zod";
+
+//#region src/resources/file.d.ts
+declare const FileType: z.ZodEnum<["video", "image", "caption"]>;
+type FileType = z.infer<typeof FileType>;
+declare const FileStatus: z.ZodEnum<["created", "uploading", "processing", "ready", "failed"]>;
+type FileStatus = z.infer<typeof FileStatus>;
+declare const CreateFilePayload: z.ZodObject<{
+  filename: z.ZodString;
+  type: z.ZodEnum<["video", "image", "caption"]>;
+  byte_size: z.ZodNumber;
+  md5: z.ZodOptional<z.ZodString>;
+  mime_type: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+  filename: string;
+  byte_size: number;
+  type: "video" | "image" | "caption";
+  md5?: string | undefined;
+  mime_type?: string | undefined;
+}, {
+  filename: string;
+  byte_size: number;
+  type: "video" | "image" | "caption";
+  md5?: string | undefined;
+  mime_type?: string | undefined;
+}>;
+type CreateFilePayload = z.infer<typeof CreateFilePayload>;
+interface FileRecord {
+  id: string;
+  filename: string;
+  type: FileType;
+  status: FileStatus;
+  byte_size: number | null;
+  md5: string | null;
+  next_byte: number;
+}
+interface CreateFileResult extends FileRecord {}
+interface FileDetail extends FileRecord {
+  mime_type?: string | null;
+  width?: number | null;
+  height?: number | null;
+  created_at?: string;
+  completed_at?: string | null;
+  expires_at?: string | null;
+  tracks?: Array<{
+    track_id: number;
+    type: string;
+    codec_name: string;
+    duration_ms: number;
+    byte_size: number;
+  }>;
+}
+interface LookupFileByMd5Result extends FileRecord {}
+interface TranscribeFileResult {
+  id: string;
+  file_id: string;
+  track_id: number;
+}
+interface FileTranscriptionResult {
+  id: string;
+  work_slice_ms: number;
+  status: string;
+  completed_at: string | null;
+  failed_at: string | null;
+}
+declare const createFile: (client: Client, payload: CreateFilePayload) => Promise<CreateFileResult>;
+declare const uploadFile: (client: Client, uploadDetails: {
+  id: string;
+  byte_size: number;
+  type: FileType;
+}, fileStream: ReadableStream) => IteratorWithPromise<UploadChunkEvent>;
+declare const getFileDetail: (client: Client, id: string) => Promise<FileDetail>;
+declare const lookupFileByMd5: (client: Client, md5: string) => Promise<LookupFileByMd5Result | null>;
+declare const deleteFile: (client: Client, id: string) => Promise<{
+  success: boolean;
+}>;
+declare const getFileProcessingProgress: (client: Client, id: string) => Promise<ProgressIterator>;
+declare const transcribeFile: (client: Client, id: string, options?: {
+  trackId?: number;
+}) => Promise<TranscribeFileResult>;
+declare const getFileTranscription: (client: Client, id: string) => Promise<FileTranscriptionResult | null>;
+declare const createFileTrack: (client: Client, fileId: string, payload: CreateISOBMFFTrackPayload) => Promise<CreateISOBMFFTrackResult>;
+declare const uploadFileTrack: (client: Client, fileId: string, trackId: number, byteSize: number, fileStream: ReadableStream) => IteratorWithPromise<UploadChunkEvent>;
+declare const uploadFileIndex: (client: Client, fileId: string, fileStream: ReadableStream, fileSize: number) => Promise<any>;
+//#endregion
+export { CreateFilePayload, CreateFileResult, FileDetail, FileRecord, FileStatus, FileTranscriptionResult, FileType, LookupFileByMd5Result, TranscribeFileResult, createFile, createFileTrack, deleteFile, getFileDetail, getFileProcessingProgress, getFileTranscription, lookupFileByMd5, transcribeFile, uploadFile, uploadFileIndex, uploadFileTrack };
+//# sourceMappingURL=file.d.cts.map

package/dist/resources/file.d.ts

@@ -0,0 +1,91 @@
+import { Client } from "../client.js";
+import { ProgressIterator } from "../ProgressIterator.js";
+import { IteratorWithPromise, UploadChunkEvent } from "../uploadChunks.js";
+import { CreateISOBMFFTrackPayload, CreateISOBMFFTrackResult } from "./isobmff-track.js";
+import { z } from "zod";
+
+//#region src/resources/file.d.ts
+declare const FileType: z.ZodEnum<["video", "image", "caption"]>;
+type FileType = z.infer<typeof FileType>;
+declare const FileStatus: z.ZodEnum<["created", "uploading", "processing", "ready", "failed"]>;
+type FileStatus = z.infer<typeof FileStatus>;
+declare const CreateFilePayload: z.ZodObject<{
+  filename: z.ZodString;
+  type: z.ZodEnum<["video", "image", "caption"]>;
+  byte_size: z.ZodNumber;
+  md5: z.ZodOptional<z.ZodString>;
+  mime_type: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+  filename: string;
+  byte_size: number;
+  type: "video" | "image" | "caption";
+  md5?: string | undefined;
+  mime_type?: string | undefined;
+}, {
+  filename: string;
+  byte_size: number;
+  type: "video" | "image" | "caption";
+  md5?: string | undefined;
+  mime_type?: string | undefined;
+}>;
+type CreateFilePayload = z.infer<typeof CreateFilePayload>;
+interface FileRecord {
+  id: string;
+  filename: string;
+  type: FileType;
+  status: FileStatus;
+  byte_size: number | null;
+  md5: string | null;
+  next_byte: number;
+}
+interface CreateFileResult extends FileRecord {}
+interface FileDetail extends FileRecord {
+  mime_type?: string | null;
+  width?: number | null;
+  height?: number | null;
+  created_at?: string;
+  completed_at?: string | null;
+  expires_at?: string | null;
+  tracks?: Array<{
+    track_id: number;
+    type: string;
+    codec_name: string;
+    duration_ms: number;
+    byte_size: number;
+  }>;
+}
+interface LookupFileByMd5Result extends FileRecord {}
+interface TranscribeFileResult {
+  id: string;
+  file_id: string;
+  track_id: number;
+}
+interface FileTranscriptionResult {
+  id: string;
+  work_slice_ms: number;
+  status: string;
+  completed_at: string | null;
+  failed_at: string | null;
+}
+declare const createFile: (client: Client, payload: CreateFilePayload) => Promise<CreateFileResult>;
+declare const uploadFile: (client: Client, uploadDetails: {
+  id: string;
+  byte_size: number;
+  type: FileType;
+}, fileStream: ReadableStream) => IteratorWithPromise<UploadChunkEvent>;
+declare const getFileDetail: (client: Client, id: string) => Promise<FileDetail>;
+declare const lookupFileByMd5: (client: Client, md5: string) => Promise<LookupFileByMd5Result | null>;
+declare const deleteFile: (client: Client, id: string) => Promise<{
+  success: boolean;
+}>;
+declare const getFileProcessingProgress: (client: Client, id: string) => Promise<ProgressIterator>;
+declare const transcribeFile: (client: Client, id: string, options?: {
+  trackId?: number;
+}) => Promise<TranscribeFileResult>;
+declare const getFileTranscription: (client: Client, id: string) => Promise<FileTranscriptionResult | null>;
+declare const createFileTrack: (client: Client, fileId: string, payload: CreateISOBMFFTrackPayload) => Promise<CreateISOBMFFTrackResult>;
+declare const uploadFileTrack: (client: Client, fileId: string, trackId: number, byteSize: number, fileStream: ReadableStream) => IteratorWithPromise<UploadChunkEvent>;
+declare const uploadFileIndex: (client: Client, fileId: string, fileStream: ReadableStream, fileSize: number) => Promise<any>;
+//#endregion
+export { CreateFilePayload, CreateFileResult, FileDetail, FileRecord, FileStatus, FileTranscriptionResult, FileType, LookupFileByMd5Result, TranscribeFileResult, createFile, createFileTrack, deleteFile, getFileDetail, getFileProcessingProgress, getFileTranscription, lookupFileByMd5, transcribeFile, uploadFile, uploadFileIndex, uploadFileTrack };
+//# sourceMappingURL=file.d.ts.map

package/dist/resources/file.js

@@ -0,0 +1,129 @@
+import { ProgressIterator } from "../ProgressIterator.js";
+import { uploadChunks } from "../uploadChunks.js";
+import { CreateISOBMFFTrackPayload } from "./isobmff-track.js";
+import debug from "debug";
+import { z } from "zod";
+
+//#region src/resources/file.ts
+const log = debug("ef:api:file");
+const MAX_VIDEO_SIZE = 1024 * 1024 * 1024;
+const MAX_IMAGE_SIZE = 1024 * 1024 * 16;
+const MAX_CAPTION_SIZE = 1024 * 1024 * 2;
+const FileType = z.enum([
+	"video",
+	"image",
+	"caption"
+]);
+const FileStatus = z.enum([
+	"created",
+	"uploading",
+	"processing",
+	"ready",
+	"failed"
+]);
+const CreateFilePayload = z.object({
+	filename: z.string(),
+	type: FileType,
+	byte_size: z.number().int().positive(),
+	md5: z.string().optional(),
+	mime_type: z.string().optional()
+});
+const MAX_SIZE_BY_TYPE = {
+	video: MAX_VIDEO_SIZE,
+	image: MAX_IMAGE_SIZE,
+	caption: MAX_CAPTION_SIZE
+};
+const createFile = async (client, payload) => {
+	log("Creating a file", payload);
+	CreateFilePayload.parse(payload);
+	const maxSize = MAX_SIZE_BY_TYPE[payload.type];
+	if (payload.byte_size > maxSize) throw new Error(`File size ${payload.byte_size} bytes exceeds limit ${maxSize} bytes for type ${payload.type}`);
+	const response = await client.authenticatedFetch("/api/v1/files", {
+		method: "POST",
+		body: JSON.stringify(payload)
+	});
+	log("File created", response.status, response.statusText);
+	if (response.ok) return await response.json();
+	throw new Error(`Failed to create file ${response.status} ${response.statusText}`);
+};
+const uploadFile = (client, uploadDetails, fileStream) => {
+	log("Uploading file", uploadDetails.id);
+	const maxSize = MAX_SIZE_BY_TYPE[uploadDetails.type];
+	return uploadChunks(client, {
+		url: `/api/v1/files/${uploadDetails.id}/upload`,
+		fileSize: uploadDetails.byte_size,
+		fileStream,
+		maxSize
+	});
+};
+const getFileDetail = async (client, id) => {
+	const response = await client.authenticatedFetch(`/api/v1/files/${id}`, { method: "GET" });
+	if (response.ok) return await response.json();
+	if (response.status === 404) throw new Error(`File not found: ${id}`);
+	throw new Error(`Failed to get file detail ${response.status} ${response.statusText}`);
+};
+const lookupFileByMd5 = async (client, md5) => {
+	const response = await client.authenticatedFetch(`/api/v1/files/md5/${md5}`, { method: "GET" });
+	if (response.ok) return await response.json();
+	if (response.status === 404) return null;
+	throw new Error(`Failed to lookup file by md5 ${md5} ${response.status} ${response.statusText}`);
+};
+const deleteFile = async (client, id) => {
+	const response = await client.authenticatedFetch(`/api/v1/files/${id}/delete`, { method: "POST" });
+	if (response.ok) return await response.json();
+	throw new Error(`Failed to delete file ${id} ${response.status} ${response.statusText}`);
+};
+const getFileProcessingProgress = async (client, id) => {
+	return new ProgressIterator(await client.authenticatedEventSource(`/api/v1/files/${id}/progress`));
+};
+const transcribeFile = async (client, id, options = {}) => {
+	const response = await client.authenticatedFetch(`/api/v1/files/${id}/transcribe`, {
+		method: "POST",
+		body: JSON.stringify(options)
+	});
+	if (response.ok) return await response.json();
+	throw new Error(`Failed to transcribe file ${id} ${response.status} ${response.statusText}`);
+};
+const getFileTranscription = async (client, id) => {
+	const response = await client.authenticatedFetch(`/api/v1/files/${id}/transcription`, { method: "GET" });
+	if (response.ok) return await response.json();
+	if (response.status === 404) return null;
+	throw new Error(`Failed to get file transcription ${id} ${response.status} ${response.statusText}`);
+};
+const createFileTrack = async (client, fileId, payload) => {
+	log("Creating file track", fileId, payload);
+	CreateISOBMFFTrackPayload.parse(payload);
+	const response = await client.authenticatedFetch(`/api/v1/files/${fileId}/tracks`, {
+		method: "POST",
+		body: JSON.stringify(payload)
+	});
+	log("File track created", response.status, response.statusText);
+	if (response.ok) return await response.json();
+	throw new Error(`Failed to create file track ${response.status} ${response.statusText}`);
+};
+const uploadFileTrack = (client, fileId, trackId, byteSize, fileStream) => {
+	log("Uploading file track", fileId, trackId);
+	return uploadChunks(client, {
+		url: `/api/v1/files/${fileId}/tracks/${trackId}/upload`,
+		fileSize: byteSize,
+		fileStream,
+		maxSize: MAX_VIDEO_SIZE
+	});
+};
+const FRAGMENT_INDEX_SIZE_LIMIT = 1024 * 1024 * 50;
+const uploadFileIndex = async (client, fileId, fileStream, fileSize) => {
+	log("Uploading file index", fileId);
+	if (fileSize > FRAGMENT_INDEX_SIZE_LIMIT) throw new Error(`Fragment index size ${fileSize} exceeds limit of ${FRAGMENT_INDEX_SIZE_LIMIT} bytes`);
+	const response = await client.authenticatedFetch(`/api/v1/files/${fileId}/index/upload`, {
+		method: "POST",
+		body: fileStream,
+		duplex: "half"
+	});
+	log("File index uploaded", response.status, response.statusText);
+	if (response.ok) return response.json();
+	throw new Error(`Failed to upload file index ${response.status} ${response.statusText}`);
+};
+
+//#endregion
+export { CreateFilePayload, FileStatus, FileType, createFile, createFileTrack, deleteFile, getFileDetail, getFileProcessingProgress, getFileTranscription, lookupFileByMd5, transcribeFile, uploadFile, uploadFileIndex, uploadFileTrack };
+//# sourceMappingURL=file.js.map

package/dist/resources/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","names":["MAX_SIZE_BY_TYPE: Record<FileType, number>"],"sources":["../../src/resources/file.ts"],"sourcesContent":["import debug from \"debug\";\nimport { z } from \"zod\";\n\nimport type { Client } from \"../client.js\";\nimport { ProgressIterator } from \"../ProgressIterator.js\";\nimport { uploadChunks } from \"../uploadChunks.js\";\nimport {\n  CreateISOBMFFTrackPayload,\n  type CreateISOBMFFTrackResult,\n} from \"./isobmff-track.js\";\n\nconst log = debug(\"ef:api:file\");\n\nconst MAX_VIDEO_SIZE = 1024 * 1024 * 1024; // 1GiB\nconst MAX_IMAGE_SIZE = 1024 * 1024 * 16; // 16MB\nconst MAX_CAPTION_SIZE = 1024 * 1024 * 2; // 2MB\n\nexport const FileType = z.enum([\"video\", \"image\", \"caption\"]);\nexport type FileType = z.infer<typeof FileType>;\n\nexport const FileStatus = z.enum([\n  \"created\",\n  \"uploading\",\n  \"processing\",\n  \"ready\",\n  \"failed\",\n]);\nexport type FileStatus = z.infer<typeof FileStatus>;\n\nexport const CreateFilePayload = z.object({\n  filename: z.string(),\n  type: FileType,\n  byte_size: z.number().int().positive(),\n  md5: z.string().optional(),\n  mime_type: z.string().optional(),\n});\n\nexport type CreateFilePayload = z.infer<typeof CreateFilePayload>;\n\nexport interface FileRecord {\n  id: string;\n  filename: string;\n  type: FileType;\n  status: FileStatus;\n  byte_size: number | null;\n  md5: string | null;\n  next_byte: number;\n}\n\nexport interface CreateFileResult extends FileRecord {}\n\nexport interface FileDetail extends FileRecord {\n  mime_type?: string | null;\n  width?: number | null;\n  height?: number | null;\n  created_at?: string;\n  completed_at?: string | null;\n  expires_at?: string | null;\n  tracks?: Array<{\n    track_id: number;\n    type: string;\n    codec_name: string;\n    duration_ms: number;\n    byte_size: number;\n  }>;\n}\n\nexport interface LookupFileByMd5Result extends FileRecord {}\n\nexport interface TranscribeFileResult {\n  id: string;\n  file_id: string;\n  track_id: number;\n}\n\nexport interface FileTranscriptionResult {\n  id: string;\n  work_slice_ms: number;\n  status: string;\n  completed_at: string | null;\n  failed_at: string | null;\n}\n\nconst MAX_SIZE_BY_TYPE: Record<FileType, number> = {\n  video: MAX_VIDEO_SIZE,\n  image: MAX_IMAGE_SIZE,\n  caption: MAX_CAPTION_SIZE,\n};\n\nexport const createFile = async (\n  client: Client,\n  payload: CreateFilePayload,\n) => {\n  log(\"Creating a file\", payload);\n  CreateFilePayload.parse(payload);\n\n  const maxSize = MAX_SIZE_BY_TYPE[payload.type];\n  if (payload.byte_size > maxSize) {\n    throw new Error(\n      `File size ${payload.byte_size} bytes exceeds limit ${maxSize} bytes for type ${payload.type}`,\n    );\n  }\n\n  const response = await client.authenticatedFetch(\"/api/v1/files\", {\n    method: \"POST\",\n    body: JSON.stringify(payload),\n  });\n\n  log(\"File created\", response.status, response.statusText);\n\n  if (response.ok) {\n    return (await response.json()) as CreateFileResult;\n  }\n\n  throw new Error(\n    `Failed to create file ${response.status} ${response.statusText}`,\n  );\n};\n\nexport const uploadFile = (\n  client: Client,\n  uploadDetails: { id: string; byte_size: number; type: FileType },\n  fileStream: ReadableStream,\n) => {\n  log(\"Uploading file\", uploadDetails.id);\n\n  const maxSize = MAX_SIZE_BY_TYPE[uploadDetails.type];\n\n  return uploadChunks(client, {\n    url: `/api/v1/files/${uploadDetails.id}/upload`,\n    fileSize: uploadDetails.byte_size,\n    fileStream,\n    maxSize,\n  });\n};\n\nexport const getFileDetail = async (\n  client: Client,\n  id: string,\n): Promise<FileDetail> => {\n  const response = await client.authenticatedFetch(`/api/v1/files/${id}`, {\n    method: \"GET\",\n  });\n\n  if (response.ok) {\n    return (await response.json()) as FileDetail;\n  }\n\n  if (response.status === 404) {\n    throw new Error(`File not found: ${id}`);\n  }\n\n  throw new Error(\n    `Failed to get file detail ${response.status} ${response.statusText}`,\n  );\n};\n\nexport const lookupFileByMd5 = async (\n  client: Client,\n  md5: string,\n): Promise<LookupFileByMd5Result | null> => {\n  const response = await client.authenticatedFetch(`/api/v1/files/md5/${md5}`, {\n    method: \"GET\",\n  });\n\n  if (response.ok) {\n    return (await response.json()) as LookupFileByMd5Result;\n  }\n\n  if (response.status === 404) {\n    return null;\n  }\n\n  throw new Error(\n    `Failed to lookup file by md5 ${md5} ${response.status} ${response.statusText}`,\n  );\n};\n\nexport const deleteFile = async (client: Client, id: string) => {\n  const response = await client.authenticatedFetch(\n    `/api/v1/files/${id}/delete`,\n    {\n      method: \"POST\",\n    },\n  );\n\n  if (response.ok) {\n    return (await response.json()) as { success: boolean };\n  }\n\n  throw new Error(\n    `Failed to delete file ${id} ${response.status} ${response.statusText}`,\n  );\n};\n\nexport const getFileProcessingProgress = async (client: Client, id: string) => {\n  const eventSource = await client.authenticatedEventSource(\n    `/api/v1/files/${id}/progress`,\n  );\n\n  return new ProgressIterator(eventSource);\n};\n\nexport const transcribeFile = async (\n  client: Client,\n  id: string,\n  options: { trackId?: number } = {},\n): Promise<TranscribeFileResult> => {\n  const response = await client.authenticatedFetch(\n    `/api/v1/files/${id}/transcribe`,\n    {\n      method: \"POST\",\n      body: JSON.stringify(options),\n    },\n  );\n\n  if (response.ok) {\n    return (await response.json()) as TranscribeFileResult;\n  }\n\n  throw new Error(\n    `Failed to transcribe file ${id} ${response.status} ${response.statusText}`,\n  );\n};\n\nexport const getFileTranscription = async (\n  client: Client,\n  id: string,\n): Promise<FileTranscriptionResult | null> => {\n  const response = await client.authenticatedFetch(\n    `/api/v1/files/${id}/transcription`,\n    {\n      method: \"GET\",\n    },\n  );\n\n  if (response.ok) {\n    return (await response.json()) as FileTranscriptionResult;\n  }\n\n  if (response.status === 404) {\n    return null;\n  }\n\n  throw new Error(\n    `Failed to get file transcription ${id} ${response.status} ${response.statusText}`,\n  );\n};\n\nexport type { CreateISOBMFFTrackPayload as CreateFileTrackPayload };\nexport type { CreateISOBMFFTrackResult as CreateFileTrackResult };\n\nexport const createFileTrack = async (\n  client: Client,\n  fileId: string,\n  payload: CreateISOBMFFTrackPayload,\n): Promise<CreateISOBMFFTrackResult> => {\n  log(\"Creating file track\", fileId, payload);\n  CreateISOBMFFTrackPayload.parse(payload);\n\n  const response = await client.authenticatedFetch(\n    `/api/v1/files/${fileId}/tracks`,\n    {\n      method: \"POST\",\n      body: JSON.stringify(payload),\n    },\n  );\n\n  log(\"File track created\", response.status, response.statusText);\n\n  if (response.ok) {\n    return (await response.json()) as CreateISOBMFFTrackResult;\n  }\n\n  throw new Error(\n    `Failed to create file track ${response.status} ${response.statusText}`,\n  );\n};\n\nexport const uploadFileTrack = (\n  client: Client,\n  fileId: string,\n  trackId: number,\n  byteSize: number,\n  fileStream: ReadableStream,\n) => {\n  log(\"Uploading file track\", fileId, trackId);\n\n  return uploadChunks(client, {\n    url: `/api/v1/files/${fileId}/tracks/${trackId}/upload`,\n    fileSize: byteSize,\n    fileStream,\n    maxSize: MAX_VIDEO_SIZE,\n  });\n};\n\nconst FRAGMENT_INDEX_SIZE_LIMIT = 1024 * 1024 * 50; // 50MB\n\nexport const uploadFileIndex = async (\n  client: Client,\n  fileId: string,\n  fileStream: ReadableStream,\n  fileSize: number,\n) => {\n  log(\"Uploading file index\", fileId);\n  if (fileSize > FRAGMENT_INDEX_SIZE_LIMIT) {\n    throw new Error(\n      `Fragment index size ${fileSize} exceeds limit of ${FRAGMENT_INDEX_SIZE_LIMIT} bytes`,\n    );\n  }\n\n  const response = await client.authenticatedFetch(\n    `/api/v1/files/${fileId}/index/upload`,\n    {\n      method: \"POST\",\n      body: fileStream,\n      duplex: \"half\",\n    },\n  );\n\n  log(\"File index uploaded\", response.status, response.statusText);\n\n  if (response.ok) {\n    return response.json();\n  }\n\n  throw new Error(\n    `Failed to upload file index ${response.status} ${response.statusText}`,\n  );\n};\n"],"mappings":"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"}

package/dist/resources/image-file.cjs

@@ -0,0 +1,87 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_uploadChunks = require('../uploadChunks.cjs');
+let debug = require("debug");
+debug = require_rolldown_runtime.__toESM(debug);
+let zod = require("zod");
+zod = require_rolldown_runtime.__toESM(zod);
+let mime_types = require("mime-types");
+mime_types = require_rolldown_runtime.__toESM(mime_types);
+
+//#region src/resources/image-file.ts
+const log = (0, debug.default)("ef:api:image-file");
+const MAX_IMAGE_SIZE = 1024 * 1024 * 16;
+const ImageFileMimeTypes = zod.z.enum([
+	"image/jpeg",
+	"image/png",
+	"image/jpg",
+	"image/webp",
+	"image/svg+xml"
+]);
+function getFileExtension(path) {
+	const match = path.match(/\.([^.]+)$/);
+	return match ? match[1] : null;
+}
+const CreateImageFilePayload = zod.z.object({
+	md5: zod.z.string().optional(),
+	height: zod.z.number().int().optional(),
+	width: zod.z.number().int().optional(),
+	mime_type: ImageFileMimeTypes.optional(),
+	filename: zod.z.string(),
+	byte_size: zod.z.number().int().max(MAX_IMAGE_SIZE)
+}).superRefine((data, ctx) => {
+	const extension = getFileExtension(data.filename);
+	const mimeType = extension ? mime_types.types[extension] : null;
+	const parsedMimeType = ImageFileMimeTypes.safeParse(mimeType).data;
+	if (parsedMimeType) data.mime_type = parsedMimeType;
+	if (!parsedMimeType && !data.mime_type) ctx.addIssue({
+		code: zod.z.ZodIssueCode.custom,
+		message: "mime_type is required when filename extension doesn't match a known image type",
+		path: ["mime_type"]
+	});
+});
+/** @deprecated Use the unified file API from ./file.js instead */
+const createImageFile = async (client, payload) => {
+	log("Creating image file", payload);
+	CreateImageFilePayload.parse(payload);
+	const response = await client.authenticatedFetch("/api/v1/image_files", {
+		method: "POST",
+		body: JSON.stringify(payload)
+	});
+	log("Image file created", response);
+	if (response.ok) return await response.json();
+	throw new Error(`Failed to create file ${response.status} ${response.statusText}`);
+};
+/** @deprecated Use the unified file API from ./file.js instead */
+const uploadImageFile = (client, uploadDetails, fileStream, chunkSizeBytes) => {
+	log("Uploading image file", uploadDetails.id);
+	return require_uploadChunks.uploadChunks(client, {
+		url: `/api/v1/image_files/${uploadDetails.id}/upload`,
+		fileSize: uploadDetails.byte_size,
+		fileStream,
+		maxSize: MAX_IMAGE_SIZE,
+		chunkSizeBytes
+	});
+};
+/** @deprecated Use the unified file API from ./file.js instead */
+const getImageFileMetadata = async (client, id) => {
+	const response = await client.authenticatedFetch(`/api/v1/image_files/${id}.json`, { method: "GET" });
+	if (response.ok) return await response.json();
+	return null;
+};
+/** @deprecated Use the unified file API from ./file.js instead */
+const lookupImageFileByMd5 = async (client, md5) => {
+	const response = await client.authenticatedFetch(`/api/v1/image_files/md5/${md5}`, { method: "GET" });
+	log("Image file lookup", response);
+	if (response.ok) return await response.json();
+	if (response.status === 404) return null;
+	throw new Error(`Failed to lookup image by md5 ${md5} ${response.status} ${response.statusText}`);
+};
+
+//#endregion
+exports.CreateImageFilePayload = CreateImageFilePayload;
+exports.ImageFileMimeTypes = ImageFileMimeTypes;
+exports.createImageFile = createImageFile;
+exports.getImageFileMetadata = getImageFileMetadata;
+exports.lookupImageFileByMd5 = lookupImageFileByMd5;
+exports.uploadImageFile = uploadImageFile;
+//# sourceMappingURL=image-file.cjs.map

package/dist/resources/image-file.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-file.cjs","names":["z","types","uploadChunks"],"sources":["../../src/resources/image-file.ts"],"sourcesContent":["import debug from \"debug\";\nimport { types } from \"mime-types\";\nimport { z } from \"zod\";\n\nimport type { Client } from \"../client.js\";\nimport { uploadChunks } from \"../uploadChunks.js\";\n\nconst log = debug(\"ef:api:image-file\");\n\nconst MAX_IMAGE_SIZE = 1024 * 1024 * 16; // 16MB\n\nexport const ImageFileMimeTypes = z.enum([\n  \"image/jpeg\",\n  \"image/png\",\n  \"image/jpg\",\n  \"image/webp\",\n  \"image/svg+xml\",\n]);\n\nfunction getFileExtension(path: string) {\n  const match = path.match(/\\.([^.]+)$/);\n  return match ? match[1] : null;\n}\n\nexport const CreateImageFilePayload = z\n  .object({\n    /**\n     * The md5 hash of the image file.\n     */\n    md5: z.string().optional(),\n    /**\n     * The height of the image file in pixels.\n     */\n    height: z.number().int().optional(),\n    /**\n     * The width of the image file in pixels.\n     */\n    width: z.number().int().optional(),\n    /**\n     * The mime type of the image file. Optional if the filename has a known file extension.\n     */\n    mime_type: ImageFileMimeTypes.optional(),\n    /**\n     * The filename of the image file.\n     */\n    filename: z.string(),\n    /**\n     * The byte size of the image file.\n     */\n    byte_size: z.number().int().max(MAX_IMAGE_SIZE),\n  })\n  .superRefine((data, ctx) => {\n    const extension = getFileExtension(data.filename);\n    const mimeType = extension ? types[extension] : null;\n    const parsedMimeType = ImageFileMimeTypes.safeParse(mimeType).data;\n\n    if (parsedMimeType) {\n      data.mime_type = parsedMimeType;\n    }\n\n    if (!parsedMimeType && !data.mime_type) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        message:\n          \"mime_type is required when filename extension doesn't match a known image type\",\n        path: [\"mime_type\"],\n      });\n    }\n  });\n\nexport type CreateImageFilePayload = z.infer<typeof CreateImageFilePayload>;\n\n/** @deprecated Use the unified file API from ./file.js instead */\nexport interface CreateImageFileResult {\n  /**\n   * Whether the image file has been fully uploaded.\n   */\n  complete: boolean | null;\n  /**\n   * The byte size of the image file.\n   */\n  byte_size: number;\n  /**\n   * The id of the image file.\n   */\n  id: string;\n  /**\n   * The md5 hash of the image file.\n   */\n  md5: string | null;\n}\n\n/** @deprecated Use the unified file API from ./file.js instead */\nexport interface LookupImageFileByMd5Result {\n  /**\n   * Whether the image file has been fully uploaded.\n   */\n  complete: boolean | null;\n  /**\n   * The byte size of the image file.\n   */\n  byte_size: number;\n  /**\n   * The id of the image file.\n   */\n  id: string;\n  /**\n   * md5 hash of the image file.\n   */\n  md5: string | null;\n  /**\n   * The height of the image file in pixels.\n   */\n  height: number | null;\n  /**\n   * The width of the image file in pixels.\n   */\n  width: number | null;\n}\n\n/** @deprecated Use the unified file API from ./file.js instead */\nexport interface GetImageFileMetadataResult extends LookupImageFileByMd5Result {}\n\n/** @deprecated Use the unified file API from ./file.js instead */\nexport const createImageFile = async (\n  client: Client,\n  payload: CreateImageFilePayload,\n) => {\n  log(\"Creating image file\", payload);\n  CreateImageFilePayload.parse(payload);\n  const response = await client.authenticatedFetch(\"/api/v1/image_files\", {\n    method: \"POST\",\n    body: JSON.stringify(payload),\n  });\n\n  log(\"Image file created\", response);\n\n  if (response.ok) {\n    return (await response.json()) as CreateImageFileResult;\n  }\n\n  throw new Error(\n    `Failed to create file ${response.status} ${response.statusText}`,\n  );\n};\n\n/** @deprecated Use the unified file API from ./file.js instead */\nexport const uploadImageFile = (\n  client: Client,\n  uploadDetails: {\n    id: string;\n    byte_size: number;\n  },\n  fileStream: ReadableStream,\n  chunkSizeBytes?: number,\n) => {\n  log(\"Uploading image file\", uploadDetails.id);\n\n  return uploadChunks(client, {\n    url: `/api/v1/image_files/${uploadDetails.id}/upload`,\n    fileSize: uploadDetails.byte_size,\n    fileStream,\n    maxSize: MAX_IMAGE_SIZE,\n    chunkSizeBytes,\n  });\n};\n\n/** @deprecated Use the unified file API from ./file.js instead */\nexport const getImageFileMetadata = async (\n  client: Client,\n  id: string,\n): Promise<GetImageFileMetadataResult | null> => {\n  const response = await client.authenticatedFetch(\n    `/api/v1/image_files/${id}.json`,\n    {\n      method: \"GET\",\n    },\n  );\n\n  if (response.ok) {\n    return (await response.json()) as LookupImageFileByMd5Result;\n  }\n\n  return null;\n};\n\n/** @deprecated Use the unified file API from ./file.js instead */\nexport const lookupImageFileByMd5 = async (\n  client: Client,\n  md5: string,\n): Promise<LookupImageFileByMd5Result | null> => {\n  const response = await client.authenticatedFetch(\n    `/api/v1/image_files/md5/${md5}`,\n    {\n      method: \"GET\",\n    },\n  );\n  log(\"Image file lookup\", response);\n\n  if (response.ok) {\n    return (await response.json()) as LookupImageFileByMd5Result;\n  }\n\n  if (response.status === 404) {\n    return null;\n  }\n\n  throw new Error(\n    `Failed to lookup image by md5 ${md5} ${response.status} ${response.statusText}`,\n  );\n};\n"],"mappings":";;;;;;;;;;AAOA,MAAM,yBAAY,oBAAoB;AAEtC,MAAM,iBAAiB,OAAO,OAAO;AAErC,MAAa,qBAAqBA,MAAE,KAAK;CACvC;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAS,iBAAiB,MAAc;CACtC,MAAM,QAAQ,KAAK,MAAM,aAAa;AACtC,QAAO,QAAQ,MAAM,KAAK;;AAG5B,MAAa,yBAAyBA,MACnC,OAAO;CAIN,KAAKA,MAAE,QAAQ,CAAC,UAAU;CAI1B,QAAQA,MAAE,QAAQ,CAAC,KAAK,CAAC,UAAU;CAInC,OAAOA,MAAE,QAAQ,CAAC,KAAK,CAAC,UAAU;CAIlC,WAAW,mBAAmB,UAAU;CAIxC,UAAUA,MAAE,QAAQ;CAIpB,WAAWA,MAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,eAAe;CAChD,CAAC,CACD,aAAa,MAAM,QAAQ;CAC1B,MAAM,YAAY,iBAAiB,KAAK,SAAS;CACjD,MAAM,WAAW,YAAYC,iBAAM,aAAa;CAChD,MAAM,iBAAiB,mBAAmB,UAAU,SAAS,CAAC;AAE9D,KAAI,eACF,MAAK,YAAY;AAGnB,KAAI,CAAC,kBAAkB,CAAC,KAAK,UAC3B,KAAI,SAAS;EACX,MAAMD,MAAE,aAAa;EACrB,SACE;EACF,MAAM,CAAC,YAAY;EACpB,CAAC;EAEJ;;AAwDJ,MAAa,kBAAkB,OAC7B,QACA,YACG;AACH,KAAI,uBAAuB,QAAQ;AACnC,wBAAuB,MAAM,QAAQ;CACrC,MAAM,WAAW,MAAM,OAAO,mBAAmB,uBAAuB;EACtE,QAAQ;EACR,MAAM,KAAK,UAAU,QAAQ;EAC9B,CAAC;AAEF,KAAI,sBAAsB,SAAS;AAEnC,KAAI,SAAS,GACX,QAAQ,MAAM,SAAS,MAAM;AAG/B,OAAM,IAAI,MACR,yBAAyB,SAAS,OAAO,GAAG,SAAS,aACtD;;;AAIH,MAAa,mBACX,QACA,eAIA,YACA,mBACG;AACH,KAAI,wBAAwB,cAAc,GAAG;AAE7C,QAAOE,kCAAa,QAAQ;EAC1B,KAAK,uBAAuB,cAAc,GAAG;EAC7C,UAAU,cAAc;EACxB;EACA,SAAS;EACT;EACD,CAAC;;;AAIJ,MAAa,uBAAuB,OAClC,QACA,OAC+C;CAC/C,MAAM,WAAW,MAAM,OAAO,mBAC5B,uBAAuB,GAAG,QAC1B,EACE,QAAQ,OACT,CACF;AAED,KAAI,SAAS,GACX,QAAQ,MAAM,SAAS,MAAM;AAG/B,QAAO;;;AAIT,MAAa,uBAAuB,OAClC,QACA,QAC+C;CAC/C,MAAM,WAAW,MAAM,OAAO,mBAC5B,2BAA2B,OAC3B,EACE,QAAQ,OACT,CACF;AACD,KAAI,qBAAqB,SAAS;AAElC,KAAI,SAAS,GACX,QAAQ,MAAM,SAAS,MAAM;AAG/B,KAAI,SAAS,WAAW,IACtB,QAAO;AAGT,OAAM,IAAI,MACR,iCAAiC,IAAI,GAAG,SAAS,OAAO,GAAG,SAAS,aACrE"}