@effing/ffs 0.7.3 → 0.9.0

package/dist/server.js

@@ -136,9 +136,27 @@ var HttpProxy = class {
 
 // src/handlers/shared.ts
 import { effieDataSchema } from "@effing/effie";
+
+// src/handlers/errors.ts
+var ErrorCode = {
+  UNAUTHORIZED: "UNAUTHORIZED",
+  INVALID_EFFIE: "INVALID_EFFIE",
+  NOT_FOUND: "NOT_FOUND",
+  BACKEND_FAILED: "BACKEND_FAILED",
+  INTERNAL_ERROR: "INTERNAL_ERROR",
+  FETCH_FAILED: "FETCH_FAILED"
+};
+function sendError(res, status, code, message, issues) {
+  if (res.headersSent) return;
+  const body = { error: message, code };
+  if (issues) body.issues = issues;
+  res.status(status).json(body);
+}
+
+// src/handlers/shared.ts
 async function createServerContext(options) {
   const port2 = process.env.FFS_PORT || process.env.PORT || 2e3;
-  const enableHttpProxy = options?.httpProxy ?? !options?.renderBackendResolver;
+  const enableHttpProxy = options?.httpProxy ?? true;
   let httpProxy;
   if (enableHttpProxy) {
     httpProxy = new HttpProxy();
@@ -162,6 +180,7 @@ function parseEffieData(body, skipValidation) {
     if (!result.success) {
       return {
         error: "Invalid effie data",
+        code: ErrorCode.INVALID_EFFIE,
         issues: result.error.issues.map((issue) => ({
           path: issue.path.join("."),
           message: issue.message
@@ -172,7 +191,10 @@ function parseEffieData(body, skipValidation) {
   } else {
     const effie = rawEffieData;
     if (!effie?.segments) {
-      return { error: "Invalid effie data: missing segments" };
+      return {
+        error: "Invalid effie data: missing segments",
+        code: ErrorCode.INVALID_EFFIE
+      };
     }
     return { effie };
   }
@@ -187,7 +209,7 @@ function setupSSEResponse(res) {
   res.setHeader("Connection", "keep-alive");
   res.flushHeaders();
 }
-function createSSEEventSender(res) {
+function createEventSender(res) {
   return (event, data) => {
     res.write(`event: ${event}
 data: ${JSON.stringify(data)}
@@ -196,9 +218,9 @@ data: ${JSON.stringify(data)}
   };
 }
 function prefixEventSender(sendEvent, prefix) {
-  return (event, data) => {
+  return ((event, data) => {
     sendEvent(`${prefix}${event}`, data);
-  };
+  });
 }
 async function proxyRemoteSSE(url, sendEvent, prefix, res, headers) {
   const response = await ffsFetch(url, {
@@ -216,6 +238,8 @@ async function proxyRemoteSSE(url, sendEvent, prefix, res, headers) {
   }
   const decoder = new TextDecoder();
   let buffer = "";
+  let currentEvent = "";
+  let currentData = "";
   try {
     while (true) {
       const { done, value } = await reader.read();
@@ -227,8 +251,6 @@ async function proxyRemoteSSE(url, sendEvent, prefix, res, headers) {
       buffer += decoder.decode(value, { stream: true });
       const lines = buffer.split("\n");
       buffer = lines.pop() || "";
-      let currentEvent = "";
-      let currentData = "";
       for (const line of lines) {
         if (line.startsWith("event: ")) {
           currentEvent = line.slice(7);
@@ -307,7 +329,12 @@ async function createWarmupJob(req, res, ctx2, options) {
     });
   } catch (error) {
     console.error("Error creating warmup job:", error);
-    res.status(500).json({ error: "Failed to create warmup job" });
+    sendError(
+      res,
+      500,
+      ErrorCode.INTERNAL_ERROR,
+      "Failed to create warmup job"
+    );
   }
 }
 async function streamWarmupProgress(req, res, ctx2) {
@@ -317,14 +344,14 @@ async function streamWarmupProgress(req, res, ctx2) {
     const jobStoreKey = storeKeys.warmupJob(jobId);
     const job = await ctx2.transientStore.getJson(jobStoreKey);
     if (!job) {
-      res.status(404).json({ error: "Job not found" });
+      sendError(res, 404, ErrorCode.NOT_FOUND, "Job not found");
       return;
     }
     if (ctx2.warmupBackendResolver) {
       const backend = ctx2.warmupBackendResolver(job.sources, job.metadata);
       if (backend) {
         setupSSEResponse(res);
-        const sendEvent2 = createSSEEventSender(res);
+        const sendEvent2 = createEventSender(res);
         try {
           await proxyRemoteSSE(
             `${backend.baseUrl}/warmup/${jobId}/progress`,
@@ -341,7 +368,7 @@ async function streamWarmupProgress(req, res, ctx2) {
     }
     ctx2.transientStore.delete(jobStoreKey);
     setupSSEResponse(res);
-    const sendEvent = createSSEEventSender(res);
+    const sendEvent = createEventSender(res);
     try {
       await warmupSources(job.sources, sendEvent, ctx2);
       sendEvent("complete", { status: "ready" });
@@ -353,7 +380,7 @@ async function streamWarmupProgress(req, res, ctx2) {
   } catch (error) {
     console.error("Error in warmup streaming:", error);
     if (!res.headersSent) {
-      res.status(500).json({ error: "Warmup streaming failed" });
+      sendError(res, 500, ErrorCode.INTERNAL_ERROR, "Warmup streaming failed");
     } else {
       res.end();
     }
@@ -382,7 +409,7 @@ async function purgeCache(req, res, ctx2) {
     res.json(result);
   } catch (error) {
     console.error("Error purging cache:", error);
-    res.status(500).json({ error: "Failed to purge cache" });
+    sendError(res, 500, ErrorCode.INTERNAL_ERROR, "Failed to purge cache");
   }
 }
 async function warmupSources(sources, sendEvent, ctx2) {
@@ -525,50 +552,51 @@ import "express";
 import { randomUUID as randomUUID2 } from "crypto";
 import {
   extractEffieSourcesWithTypes as extractEffieSourcesWithTypes2,
-  extractEffieSources as extractEffieSources2,
-  effieDataSchema as effieDataSchema2
+  extractEffieSources as extractEffieSources2
 } from "@effing/effie";
 async function createRenderJob(req, res, ctx2, options) {
   try {
     const body = req.body;
-    let rawEffieData;
     if (typeof body.effie === "string") {
-      const response = await ffsFetch(body.effie);
-      if (!response.ok) {
-        throw new Error(
-          `Failed to fetch Effie data: ${response.status} ${response.statusText}`
+      let response;
+      try {
+        response = await ffsFetch(body.effie);
+      } catch (error) {
+        sendError(
+          res,
+          502,
+          ErrorCode.FETCH_FAILED,
+          `Failed to fetch Effie data: ${error instanceof Error ? error.message : String(error)}`
         );
-      }
-      rawEffieData = await response.json();
-    } else {
-      rawEffieData = body.effie;
-    }
-    let effie;
-    if (!ctx2.skipValidation) {
-      const result = effieDataSchema2.safeParse(rawEffieData);
-      if (!result.success) {
-        res.status(400).json({
-          error: "Invalid effie data",
-          issues: result.error.issues.map((issue) => ({
-            path: issue.path.join("."),
-            message: issue.message
-          }))
-        });
         return;
       }
-      effie = result.data;
-    } else {
-      const data = rawEffieData;
-      if (!data?.segments) {
-        res.status(400).json({ error: "Invalid effie data: missing segments" });
+      if (!response.ok) {
+        sendError(
+          res,
+          502,
+          ErrorCode.FETCH_FAILED,
+          `Failed to fetch Effie data: ${response.status} ${response.statusText}`
+        );
         return;
       }
-      effie = data;
+      body.effie = await response.json();
+    }
+    const parseResult = parseEffieData(body, ctx2.skipValidation);
+    if ("error" in parseResult) {
+      sendError(
+        res,
+        400,
+        parseResult.code,
+        parseResult.error,
+        parseResult.issues
+      );
+      return;
     }
+    const effie = parseResult.effie;
     const sources = extractEffieSourcesWithTypes2(effie);
-    const scale = body.scale ?? 1;
+    const scale = body.scale ?? (req.query?.scale ? parseFloat(req.query.scale) : void 0) ?? 1;
+    const purge = body.purge ?? (req.query?.purge === "true" ? true : void 0) ?? false;
     const upload = body.upload;
-    const purge = body.purge;
     const jobId = randomUUID2();
     const warmupJobId = randomUUID2();
     const job = {
@@ -597,7 +625,12 @@ async function createRenderJob(req, res, ctx2, options) {
     });
   } catch (error) {
     console.error("Error creating render job:", error);
-    res.status(500).json({ error: "Failed to create render job" });
+    sendError(
+      res,
+      500,
+      ErrorCode.INTERNAL_ERROR,
+      "Failed to create render job"
+    );
   }
 }
 async function streamRenderProgress(req, res, ctx2) {
@@ -607,14 +640,15 @@ async function streamRenderProgress(req, res, ctx2) {
     const jobStoreKey = storeKeys.renderJob(jobId);
     const job = await ctx2.transientStore.getJson(jobStoreKey);
     if (!job) {
-      res.status(404).json({ error: "Job not found" });
+      sendError(res, 404, ErrorCode.NOT_FOUND, "Job not found");
       return;
     }
     ctx2.transientStore.delete(jobStoreKey);
     const warmupBackend = ctx2.warmupBackendResolver ? ctx2.warmupBackendResolver(job.sources, job.metadata) : null;
     const renderBackend = ctx2.renderBackendResolver ? ctx2.renderBackendResolver(job.effie, job.metadata) : null;
     setupSSEResponse(res);
-    const sendEvent = createSSEEventSender(res);
+    const sendEvent = createEventSender(res);
+    const rawSendEvent = createEventSender(res);
     let keepalivePhase = "warmup";
     const keepalive = setInterval(() => {
       sendEvent("keepalive", { phase: keepalivePhase });
@@ -631,13 +665,16 @@ async function streamRenderProgress(req, res, ctx2) {
       if (warmupBackend) {
         await proxyRemoteSSE(
           `${warmupBackend.baseUrl}/warmup/${job.warmupJobId}/progress`,
-          sendEvent,
+          rawSendEvent,
           "warmup:",
           res,
           warmupBackend.apiKey ? { Authorization: `Bearer ${warmupBackend.apiKey}` } : void 0
         );
       } else {
-        const warmupSender = prefixEventSender(sendEvent, "warmup:");
+        const warmupSender = prefixEventSender(
+          rawSendEvent,
+          "warmup:"
+        );
         await warmupSources(job.sources, warmupSender, ctx2);
         warmupSender("complete", { status: "ready" });
       }
@@ -646,7 +683,8 @@ async function streamRenderProgress(req, res, ctx2) {
         if (renderBackend) {
           const videoJob = {
             effie: job.effie,
-            scale: job.scale
+            scale: job.scale,
+            metadata: job.metadata
           };
           await ctx2.transientStore.putJson(
             storeKeys.videoJob(jobId),
@@ -667,7 +705,10 @@ async function streamRenderProgress(req, res, ctx2) {
             job.upload,
             sendEvent
           );
-          sendEvent("render:complete", timings);
+          sendEvent(
+            "render:complete",
+            timings
+          );
         } else {
           const timings = await renderAndUploadInternal(
             job.effie,
@@ -676,13 +717,17 @@ async function streamRenderProgress(req, res, ctx2) {
             sendEvent,
             ctx2
           );
-          sendEvent("render:complete", timings);
+          sendEvent(
+            "render:complete",
+            timings
+          );
         }
         sendEvent("complete", { status: "done" });
       } else {
         const videoJob = {
           effie: job.effie,
-          scale: job.scale
+          scale: job.scale,
+          metadata: job.metadata
         };
         await ctx2.transientStore.putJson(
           storeKeys.videoJob(jobId),
@@ -704,7 +749,12 @@ async function streamRenderProgress(req, res, ctx2) {
   } catch (error) {
     console.error("Error in render progress streaming:", error);
     if (!res.headersSent) {
-      res.status(500).json({ error: "Render progress streaming failed" });
+      sendError(
+        res,
+        500,
+        ErrorCode.INTERNAL_ERROR,
+        "Render progress streaming failed"
+      );
     } else {
       res.end();
     }
@@ -717,18 +767,26 @@ async function streamRenderVideo(req, res, ctx2) {
     const videoJobKey = storeKeys.videoJob(jobId);
     const videoJob = await ctx2.transientStore.getJson(videoJobKey);
     if (!videoJob) {
-      res.status(404).json({ error: "Video not found or expired" });
+      sendError(res, 404, ErrorCode.NOT_FOUND, "Video not found or expired");
       return;
     }
     if (ctx2.renderBackendResolver) {
-      const backend = ctx2.renderBackendResolver(videoJob.effie);
+      const backend = ctx2.renderBackendResolver(
+        videoJob.effie,
+        videoJob.metadata
+      );
       if (backend) {
         const backendUrl = `${backend.baseUrl}/render/${jobId}/video`;
         const response = await ffsFetch(backendUrl, {
           headers: backend.apiKey ? { Authorization: `Bearer ${backend.apiKey}` } : void 0
         });
         if (!response.ok) {
-          res.status(response.status).json({ error: "Backend render failed" });
+          sendError(
+            res,
+            response.status,
+            ErrorCode.BACKEND_FAILED,
+            "Backend render failed"
+          );
           return;
         }
         await proxyBinaryStream(response, res);
@@ -740,14 +798,14 @@ async function streamRenderVideo(req, res, ctx2) {
   } catch (error) {
     console.error("Error streaming video:", error);
     if (!res.headersSent) {
-      res.status(500).json({ error: "Video streaming failed" });
+      sendError(res, 500, ErrorCode.INTERNAL_ERROR, "Video streaming failed");
     } else {
       res.end();
     }
   }
 }
 async function streamRenderDirect(res, job, ctx2) {
-  const { EffieRenderer } = await import("./render-OMXRUVX5.js");
+  const { EffieRenderer } = await import("./render-YKC5W4YT.js");
   const renderer = new EffieRenderer(job.effie, {
     transientStore: ctx2.transientStore,
     httpProxy: ctx2.httpProxy
@@ -821,26 +879,30 @@ async function uploadRenderedVideo(videoBuffer, effie, upload, sendEvent) {
 }
 async function renderAndUploadInternal(effie, scale, upload, sendEvent, ctx2) {
   const renderStartTime = Date.now();
-  const { EffieRenderer } = await import("./render-OMXRUVX5.js");
+  const { EffieRenderer } = await import("./render-YKC5W4YT.js");
   const renderer = new EffieRenderer(effie, {
     transientStore: ctx2.transientStore,
     httpProxy: ctx2.httpProxy
   });
-  const videoStream = await renderer.render(scale);
-  const chunks = [];
-  for await (const chunk of videoStream) {
-    chunks.push(Buffer.from(chunk));
+  try {
+    const videoStream = await renderer.render(scale);
+    const chunks = [];
+    for await (const chunk of videoStream) {
+      chunks.push(Buffer.from(chunk));
+    }
+    const videoBuffer = Buffer.concat(chunks);
+    const renderTime = Date.now() - renderStartTime;
+    const timings = await uploadRenderedVideo(
+      videoBuffer,
+      effie,
+      upload,
+      sendEvent
+    );
+    timings.renderTime = renderTime;
+    return timings;
+  } finally {
+    renderer.close();
   }
-  const videoBuffer = Buffer.concat(chunks);
-  const renderTime = Date.now() - renderStartTime;
-  const timings = await uploadRenderedVideo(
-    videoBuffer,
-    effie,
-    upload,
-    sendEvent
-  );
-  timings.renderTime = renderTime;
-  return timings;
 }
 
 // src/server.ts
@@ -856,7 +918,7 @@ function validateAuth(req, res) {
   if (!apiKey) return true;
   const authHeader = req.headers.authorization;
   if (!authHeader || authHeader !== `Bearer ${apiKey}`) {
-    res.status(401).json({ error: "Unauthorized" });
+    sendError(res, 401, ErrorCode.UNAUTHORIZED, "Unauthorized");
     return false;
   }
   return true;

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import express from \"express\";\nimport bodyParser from \"body-parser\";\nimport {\n  createServerContext,\n  createWarmupJob,\n  streamWarmupProgress,\n  purgeCache,\n  createRenderJob,\n  streamRenderProgress,\n  streamRenderVideo,\n} from \"./handlers\";\n\nconst app: express.Express = express();\napp.disable(\"x-powered-by\");\napp.use(bodyParser.json({ limit: \"50mb\" })); // Support large JSON requests\n\nconst ctx = await createServerContext();\nif (ctx.httpProxy) {\n  console.log(`FFS HTTP proxy listening on port ${ctx.httpProxy.port}`);\n}\n\nfunction validateAuth(req: express.Request, res: express.Response): boolean {\n  const apiKey = process.env.FFS_API_KEY;\n  if (!apiKey) return true; // No auth required if api key not set\n\n  const authHeader = req.headers.authorization;\n  if (!authHeader || authHeader !== `Bearer ${apiKey}`) {\n    res.status(401).json({ error: \"Unauthorized\" });\n    return false;\n  }\n  return true;\n}\n\n// Routes with auth (POST endpoints)\napp.post(\"/warmup\", (req, res) => {\n  if (!validateAuth(req, res)) return;\n  createWarmupJob(req, res, ctx);\n});\napp.post(\"/purge\", (req, res) => {\n  if (!validateAuth(req, res)) return;\n  purgeCache(req, res, ctx);\n});\napp.post(\"/render\", (req, res) => {\n  if (!validateAuth(req, res)) return;\n  createRenderJob(req, res, ctx);\n});\n\n// Routes without auth (GET endpoints use job ID as capability token)\napp.get(\"/warmup/:id/progress\", (req, res) =>\n  streamWarmupProgress(req, res, ctx),\n);\napp.get(\"/render/:id/progress\", (req, res) =>\n  streamRenderProgress(req, res, ctx),\n);\napp.get(\"/render/:id/video\", (req, res) => streamRenderVideo(req, res, ctx));\n\n// Server lifecycle\nconst port = process.env.FFS_PORT || process.env.PORT || 2000; // ffmpeg was conceived in the year 2000\nconst server = app.listen(port, () => {\n  console.log(`FFS server listening on port ${port}`);\n});\n\nfunction shutdown() {\n  console.log(\"Shutting down FFS server...\");\n  ctx.httpProxy?.close();\n  ctx.transientStore.close();\n  server.close(() => {\n    console.log(\"FFS server stopped\");\n    process.exit(0);\n  });\n}\n\nprocess.on(\"SIGTERM\", shutdown);\nprocess.on(\"SIGINT\", shutdown);\n\nexport { app };\n"],"mappings":";;;;;;;;;;;;AAAA,OAAO,aAAa;AACpB,OAAO,gBAAgB;AAWvB,IAAM,MAAuB,QAAQ;AACrC,IAAI,QAAQ,cAAc;AAC1B,IAAI,IAAI,WAAW,KAAK,EAAE,OAAO,OAAO,CAAC,CAAC;AAE1C,IAAM,MAAM,MAAM,oBAAoB;AACtC,IAAI,IAAI,WAAW;AACjB,UAAQ,IAAI,oCAAoC,IAAI,UAAU,IAAI,EAAE;AACtE;AAEA,SAAS,aAAa,KAAsB,KAAgC;AAC1E,QAAM,SAAS,QAAQ,IAAI;AAC3B,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,aAAa,IAAI,QAAQ;AAC/B,MAAI,CAAC,cAAc,eAAe,UAAU,MAAM,IAAI;AACpD,QAAI,OAAO,GAAG,EAAE,KAAK,EAAE,OAAO,eAAe,CAAC;AAC9C,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAGA,IAAI,KAAK,WAAW,CAAC,KAAK,QAAQ;AAChC,MAAI,CAAC,aAAa,KAAK,GAAG,EAAG;AAC7B,kBAAgB,KAAK,KAAK,GAAG;AAC/B,CAAC;AACD,IAAI,KAAK,UAAU,CAAC,KAAK,QAAQ;AAC/B,MAAI,CAAC,aAAa,KAAK,GAAG,EAAG;AAC7B,aAAW,KAAK,KAAK,GAAG;AAC1B,CAAC;AACD,IAAI,KAAK,WAAW,CAAC,KAAK,QAAQ;AAChC,MAAI,CAAC,aAAa,KAAK,GAAG,EAAG;AAC7B,kBAAgB,KAAK,KAAK,GAAG;AAC/B,CAAC;AAGD,IAAI;AAAA,EAAI;AAAA,EAAwB,CAAC,KAAK,QACpC,qBAAqB,KAAK,KAAK,GAAG;AACpC;AACA,IAAI;AAAA,EAAI;AAAA,EAAwB,CAAC,KAAK,QACpC,qBAAqB,KAAK,KAAK,GAAG;AACpC;AACA,IAAI,IAAI,qBAAqB,CAAC,KAAK,QAAQ,kBAAkB,KAAK,KAAK,GAAG,CAAC;AAG3E,IAAM,OAAO,QAAQ,IAAI,YAAY,QAAQ,IAAI,QAAQ;AACzD,IAAM,SAAS,IAAI,OAAO,MAAM,MAAM;AACpC,UAAQ,IAAI,gCAAgC,IAAI,EAAE;AACpD,CAAC;AAED,SAAS,WAAW;AAClB,UAAQ,IAAI,6BAA6B;AACzC,MAAI,WAAW,MAAM;AACrB,MAAI,eAAe,MAAM;AACzB,SAAO,MAAM,MAAM;AACjB,YAAQ,IAAI,oBAAoB;AAChC,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AACH;AAEA,QAAQ,GAAG,WAAW,QAAQ;AAC9B,QAAQ,GAAG,UAAU,QAAQ;","names":[]}
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import express from \"express\";\nimport bodyParser from \"body-parser\";\nimport {\n  createServerContext,\n  createWarmupJob,\n  streamWarmupProgress,\n  purgeCache,\n  createRenderJob,\n  streamRenderProgress,\n  streamRenderVideo,\n  sendError,\n  ErrorCode,\n} from \"./handlers\";\n\nconst app: express.Express = express();\napp.disable(\"x-powered-by\");\napp.use(bodyParser.json({ limit: \"50mb\" })); // Support large JSON requests\n\nconst ctx = await createServerContext();\nif (ctx.httpProxy) {\n  console.log(`FFS HTTP proxy listening on port ${ctx.httpProxy.port}`);\n}\n\nfunction validateAuth(req: express.Request, res: express.Response): boolean {\n  const apiKey = process.env.FFS_API_KEY;\n  if (!apiKey) return true; // No auth required if api key not set\n\n  const authHeader = req.headers.authorization;\n  if (!authHeader || authHeader !== `Bearer ${apiKey}`) {\n    sendError(res, 401, ErrorCode.UNAUTHORIZED, \"Unauthorized\");\n    return false;\n  }\n  return true;\n}\n\n// Routes with auth (POST endpoints)\napp.post(\"/warmup\", (req, res) => {\n  if (!validateAuth(req, res)) return;\n  createWarmupJob(req, res, ctx);\n});\napp.post(\"/purge\", (req, res) => {\n  if (!validateAuth(req, res)) return;\n  purgeCache(req, res, ctx);\n});\napp.post(\"/render\", (req, res) => {\n  if (!validateAuth(req, res)) return;\n  createRenderJob(req, res, ctx);\n});\n\n// Routes without auth (GET endpoints use job ID as capability token)\napp.get(\"/warmup/:id/progress\", (req, res) =>\n  streamWarmupProgress(req, res, ctx),\n);\napp.get(\"/render/:id/progress\", (req, res) =>\n  streamRenderProgress(req, res, ctx),\n);\napp.get(\"/render/:id/video\", (req, res) => streamRenderVideo(req, res, ctx));\n\n// Server lifecycle\nconst port = process.env.FFS_PORT || process.env.PORT || 2000; // ffmpeg was conceived in the year 2000\nconst server = app.listen(port, () => {\n  console.log(`FFS server listening on port ${port}`);\n});\n\nfunction shutdown() {\n  console.log(\"Shutting down FFS server...\");\n  ctx.httpProxy?.close();\n  ctx.transientStore.close();\n  server.close(() => {\n    console.log(\"FFS server stopped\");\n    process.exit(0);\n  });\n}\n\nprocess.on(\"SIGTERM\", shutdown);\nprocess.on(\"SIGINT\", shutdown);\n\nexport { app };\n"],"mappings":";;;;;;;;;;;;;;AAAA,OAAO,aAAa;AACpB,OAAO,gBAAgB;AAavB,IAAM,MAAuB,QAAQ;AACrC,IAAI,QAAQ,cAAc;AAC1B,IAAI,IAAI,WAAW,KAAK,EAAE,OAAO,OAAO,CAAC,CAAC;AAE1C,IAAM,MAAM,MAAM,oBAAoB;AACtC,IAAI,IAAI,WAAW;AACjB,UAAQ,IAAI,oCAAoC,IAAI,UAAU,IAAI,EAAE;AACtE;AAEA,SAAS,aAAa,KAAsB,KAAgC;AAC1E,QAAM,SAAS,QAAQ,IAAI;AAC3B,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,aAAa,IAAI,QAAQ;AAC/B,MAAI,CAAC,cAAc,eAAe,UAAU,MAAM,IAAI;AACpD,cAAU,KAAK,KAAK,UAAU,cAAc,cAAc;AAC1D,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAGA,IAAI,KAAK,WAAW,CAAC,KAAK,QAAQ;AAChC,MAAI,CAAC,aAAa,KAAK,GAAG,EAAG;AAC7B,kBAAgB,KAAK,KAAK,GAAG;AAC/B,CAAC;AACD,IAAI,KAAK,UAAU,CAAC,KAAK,QAAQ;AAC/B,MAAI,CAAC,aAAa,KAAK,GAAG,EAAG;AAC7B,aAAW,KAAK,KAAK,GAAG;AAC1B,CAAC;AACD,IAAI,KAAK,WAAW,CAAC,KAAK,QAAQ;AAChC,MAAI,CAAC,aAAa,KAAK,GAAG,EAAG;AAC7B,kBAAgB,KAAK,KAAK,GAAG;AAC/B,CAAC;AAGD,IAAI;AAAA,EAAI;AAAA,EAAwB,CAAC,KAAK,QACpC,qBAAqB,KAAK,KAAK,GAAG;AACpC;AACA,IAAI;AAAA,EAAI;AAAA,EAAwB,CAAC,KAAK,QACpC,qBAAqB,KAAK,KAAK,GAAG;AACpC;AACA,IAAI,IAAI,qBAAqB,CAAC,KAAK,QAAQ,kBAAkB,KAAK,KAAK,GAAG,CAAC;AAG3E,IAAM,OAAO,QAAQ,IAAI,YAAY,QAAQ,IAAI,QAAQ;AACzD,IAAM,SAAS,IAAI,OAAO,MAAM,MAAM;AACpC,UAAQ,IAAI,gCAAgC,IAAI,EAAE;AACpD,CAAC;AAED,SAAS,WAAW;AAClB,UAAQ,IAAI,6BAA6B;AACzC,MAAI,WAAW,MAAM;AACrB,MAAI,eAAe,MAAM;AACzB,SAAO,MAAM,MAAM;AACjB,YAAQ,IAAI,oBAAoB;AAChC,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AACH;AAEA,QAAQ,GAAG,WAAW,QAAQ;AAC9B,QAAQ,GAAG,UAAU,QAAQ;","names":[]}

package/dist/sse.d.ts

@@ -0,0 +1,72 @@
+type WarmupEventMap = {
+    start: {
+        total: number;
+    };
+    progress: {
+        url: string;
+        status: "skipped" | "hit" | "cached" | "error";
+        cached: number;
+        failed: number;
+        skipped: number;
+        total: number;
+        ms?: number;
+        error?: string;
+        reason?: string;
+    };
+    downloading: {
+        url: string;
+        status: "started" | "downloading";
+        bytesReceived: number;
+    };
+    keepalive: {
+        cached: number;
+        failed: number;
+        skipped: number;
+        total: number;
+    };
+    summary: {
+        cached: number;
+        failed: number;
+        skipped: number;
+        total: number;
+    };
+    complete: {
+        status: "ready";
+    };
+    error: {
+        message: string;
+    };
+};
+type RenderEventMap = {
+    keepalive: {
+        phase: "warmup" | "render";
+    } | {
+        status: "uploading";
+    };
+    "purge:complete": {
+        purged: number;
+        total: number;
+    };
+    "render:complete": {
+        renderTime?: number;
+        uploadTime: number;
+        uploadCoverTime?: number;
+        fetchCoverTime?: number;
+    };
+    complete: {
+        status: "done";
+    };
+    ready: {
+        videoUrl: string;
+    };
+    error: {
+        phase: "warmup" | "render";
+        message: string;
+    };
+};
+type TypedEventSender<TMap extends Record<string, unknown>> = <K extends keyof TMap & string>(event: K, data: TMap[K]) => void;
+type WarmupEventSender = TypedEventSender<WarmupEventMap>;
+type RenderEventSender = TypedEventSender<RenderEventMap>;
+type EventSender = (event: string, data: object) => void;
+
+export type { EventSender, RenderEventMap, RenderEventSender, TypedEventSender, WarmupEventMap, WarmupEventSender };

package/dist/sse.js

@@ -0,0 +1 @@
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effing/ffs",
-  "version": "0.7.3",
+  "version": "0.9.0",
   "description": "FFmpeg-based effie rendering service",
   "type": "module",
   "exports": {
@@ -15,6 +15,10 @@
     "./handlers": {
       "types": "./dist/handlers/index.d.ts",
       "import": "./dist/handlers/index.js"
+    },
+    "./sse": {
+      "types": "./dist/sse.d.ts",
+      "import": "./dist/sse.js"
     }
   },
   "bin": {
@@ -32,10 +36,10 @@
     "tar-stream": "^3.1.7",
     "undici": "^7.3.0",
     "zod": "^3.25.76",
-    "@effing/effie": "0.7.3"
+    "@effing/effie": "0.9.0"
   },
   "optionalDependencies": {
-    "@effing/ffmpeg": "0.7.3"
+    "@effing/ffmpeg": "0.9.0"
   },
   "devDependencies": {
     "@types/body-parser": "^1.19.5",