@effing/ffs 0.2.0 → 0.4.0

package/dist/handlers/index.d.ts

@@ -1,6 +1,7 @@
-import { C as CacheStorage, H as HttpProxy } from '../proxy-BI8OMQl0.js';
+import { T as TransientStore, H as HttpProxy } from '../proxy-qTA69nOV.js';
 import { EffieSourceWithType, EffieData, EffieSources } from '@effing/effie';
 import express from 'express';
+import { Response } from 'undici';
 import 'stream';
 
 type UploadOptions = {
@@ -16,12 +17,25 @@ type RenderJob = {
     upload?: UploadOptions;
     createdAt: number;
 };
+type WarmupAndRenderJob = {
+    effie: EffieData<EffieSources>;
+    sources: EffieSourceWithType[];
+    scale: number;
+    upload?: UploadOptions;
+    warmupJobId: string;
+    renderJobId: string;
+    createdAt: number;
+};
 type ServerContext = {
-    cacheStorage: CacheStorage;
+    transientStore: TransientStore;
     httpProxy: HttpProxy;
     baseUrl: string;
     skipValidation: boolean;
-    cacheConcurrency: number;
+    warmupConcurrency: number;
+    warmupBackendBaseUrl?: string;
+    renderBackendBaseUrl?: string;
+    warmupBackendApiKey?: string;
+    renderBackendApiKey?: string;
 };
 type SSEEventSender = (event: string, data: object) => void;
 /**
@@ -55,4 +69,24 @@ declare function createRenderJob(req: express.Request, res: express.Response, ct
  */
 declare function streamRenderJob(req: express.Request, res: express.Response, ctx: ServerContext): Promise<void>;
 
-export { type RenderJob, type SSEEventSender, type ServerContext, type UploadOptions, type WarmupJob, createRenderJob, createServerContext, createWarmupJob, purgeCache, streamRenderJob, streamWarmupJob };
+/**
+ * POST /warmup-and-render - Create a combined warmup and render job
+ * Returns a job ID and URL for SSE streaming
+ */
+declare function createWarmupAndRenderJob(req: express.Request, res: express.Response, ctx: ServerContext): Promise<void>;
+/**
+ * GET /warmup-and-render/:id - Stream warmup and render progress via SSE
+ * Orchestrates warmup (local or remote) followed by render (local or remote)
+ */
+declare function streamWarmupAndRenderJob(req: express.Request, res: express.Response, ctx: ServerContext): Promise<void>;
+/**
+ * Proxy SSE events from a remote backend, prefixing event names
+ */
+declare function proxyRemoteSSE(url: string, sendEvent: SSEEventSender, prefix: string, res: express.Response, headers?: Record<string, string>): Promise<void>;
+/**
+ * Proxy a binary stream (e.g., video) from a fetch Response to an Express response.
+ * Forwards Content-Type and Content-Length headers.
+ */
+declare function proxyBinaryStream(response: Response, res: express.Response): Promise<void>;
+
+export { type RenderJob, type SSEEventSender, type ServerContext, type UploadOptions, type WarmupAndRenderJob, type WarmupJob, createRenderJob, createServerContext, createWarmupAndRenderJob, createWarmupJob, proxyBinaryStream, proxyRemoteSSE, purgeCache, streamRenderJob, streamWarmupAndRenderJob, streamWarmupJob };

package/dist/handlers/index.js

@@ -1,18 +1,26 @@
 import {
   createRenderJob,
   createServerContext,
+  createWarmupAndRenderJob,
   createWarmupJob,
+  proxyBinaryStream,
+  proxyRemoteSSE,
   purgeCache,
   streamRenderJob,
+  streamWarmupAndRenderJob,
   streamWarmupJob
-} from "../chunk-6YHSYHDY.js";
-import "../chunk-A7BAW24L.js";
+} from "../chunk-7FMPCMLO.js";
+import "../chunk-J64HSZNQ.js";
 export {
   createRenderJob,
   createServerContext,
+  createWarmupAndRenderJob,
   createWarmupJob,
+  proxyBinaryStream,
+  proxyRemoteSSE,
   purgeCache,
   streamRenderJob,
+  streamWarmupAndRenderJob,
   streamWarmupJob
 };
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Readable } from 'stream';
 import { EffieWebUrl, EffieData, EffieSources } from '@effing/effie';
-import { C as CacheStorage, H as HttpProxy } from './proxy-BI8OMQl0.js';
+import { T as TransientStore, H as HttpProxy } from './proxy-qTA69nOV.js';
 
 type EffieRendererOptions = {
     /**
@@ -11,10 +11,10 @@ type EffieRendererOptions = {
      */
     allowLocalFiles?: boolean;
     /**
-     * Cache storage instance for source lookups.
-     * If not provided, a shared lazy-initialized cache will be used.
+     * Transient store instance for source lookups.
+     * If not provided, sources will be fetched directly from network.
      */
-    cacheStorage?: CacheStorage;
+    transientStore?: TransientStore;
     /**
      * HTTP proxy for video/audio URLs.
      * When provided, HTTP(S) URLs for video/audio inputs will be routed
@@ -27,7 +27,7 @@ declare class EffieRenderer<U extends string = EffieWebUrl> {
     private effieData;
     private ffmpegRunner?;
     private allowLocalFiles;
-    private cacheStorage?;
+    private transientStore?;
     private httpProxy?;
     constructor(effieData: EffieData<EffieSources<U>, U>, options?: EffieRendererOptions);
     private fetchSource;

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   EffieRenderer,
   FFmpegCommand,
   FFmpegRunner
-} from "./chunk-A7BAW24L.js";
+} from "./chunk-J64HSZNQ.js";
 export {
   EffieRenderer,
   FFmpegCommand,

package/dist/{proxy-BI8OMQl0.d.ts → proxy-qTA69nOV.d.ts}

@@ -1,11 +1,15 @@
 import { Readable } from 'stream';
 
 /**
- * Cache storage interface
+ * Transient store interface for caching sources and storing ephemeral job metadata.
  */
-interface CacheStorage {
-    /** Store a stream with the given key */
-    put(key: string, stream: Readable): Promise<void>;
+interface TransientStore {
+    /** TTL for cached sources in milliseconds */
+    readonly sourceTtlMs: number;
+    /** TTL for job metadata in milliseconds */
+    readonly jobMetadataTtlMs: number;
+    /** Store a stream with the given key and optional TTL override */
+    put(key: string, stream: Readable, ttlMs?: number): Promise<void>;
     /** Get a stream for the given key, or null if not found */
     getStream(key: string): Promise<Readable | null>;
     /** Check if a key exists */
@@ -14,8 +18,8 @@ interface CacheStorage {
     existsMany(keys: string[]): Promise<Map<string, boolean>>;
     /** Delete a key */
     delete(key: string): Promise<void>;
-    /** Store JSON data */
-    putJson(key: string, data: object): Promise<void>;
+    /** Store JSON data with optional TTL override */
+    putJson(key: string, data: object, ttlMs?: number): Promise<void>;
     /** Get JSON data, or null if not found */
     getJson<T>(key: string): Promise<T | null>;
     /** Close and cleanup resources */
@@ -65,4 +69,4 @@ declare class HttpProxy {
     close(): void;
 }
 
-export { type CacheStorage as C, HttpProxy as H };
+export { HttpProxy as H, type TransientStore as T };