@twick/render-server 0.15.20 → 0.15.22

package/dist/index.js

@@ -69,7 +69,7 @@ var renderTwickVideo = async (variables, settings) => {
       quality: "medium",
       projectSettings: {
         exporter: {
-          name: "@twick/core/wasm"
+          name: "@twick/core/wasm-effects"
         },
         size: {
           x: width,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/renderer.ts"],"sourcesContent":["// Export the renderer function\nexport { default as renderTwickVideo } from \"./renderer\";\n\n","import { renderVideo } from \"@twick/renderer\";\n\n// Simple in-process concurrency control for render jobs.\n// This helps avoid overloading a single server instance.\nlet activeRenders = 0;\nconst renderQueue: Array<() => void> = [];\n\nconst getMaxConcurrentRenders = () => {\n  const fromEnv = process.env.TWICK_MAX_CONCURRENT_RENDERS;\n  const parsed = fromEnv ? parseInt(fromEnv, 10) : NaN;\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : 2;\n};\n\nasync function withRenderSlot<T>(fn: () => Promise<T>): Promise<T> {\n  const maxConcurrent = getMaxConcurrentRenders();\n\n  if (activeRenders >= maxConcurrent) {\n    await new Promise<void>((resolve) => {\n      renderQueue.push(resolve);\n    });\n  }\n\n  activeRenders++;\n  try {\n    return await fn();\n  } finally {\n    activeRenders--;\n    const next = renderQueue.shift();\n    if (next) {\n      next();\n    }\n  }\n}\n\n/**\n * Renders a Twick video with the provided variables and settings.\n * Processes project variables, merges settings with defaults, and\n * generates a video file using the Twick renderer.\n *\n * @param variables - Project variables containing input configuration\n * @param settings - Optional render settings to override defaults\n * @returns Promise resolving to the path of the rendered video file\n * \n * @example\n * ```js\n * const videoPath = await renderTwickVideo(\n *   { input: { properties: { width: 1920, height: 1080 } } },\n *   { quality: \"high\", outFile: \"my-video.mp4\" }\n * );\n * // videoPath = \"./output/my-video.mp4\"\n * ```\n */\nconst renderTwickVideo = async (variables: any, settings: any) => {\n  const start = Date.now();\n  try {\n    const { input } = variables;\n    const { properties } = input;\n\n    // Basic safety limits (can be overridden via env)\n    const maxWidth =\n      parseInt(process.env.TWICK_MAX_RENDER_WIDTH ?? \"3840\", 10) || 3840;\n    const maxHeight =\n      parseInt(process.env.TWICK_MAX_RENDER_HEIGHT ?? \"2160\", 10) || 2160;\n    const maxFps =\n      parseInt(process.env.TWICK_MAX_RENDER_FPS ?? \"60\", 10) || 60;\n\n    const width = Math.min(properties.width, maxWidth);\n    const height = Math.min(properties.height, maxHeight);\n    const fps = Math.min(properties.fps ?? 30, maxFps);\n\n    // Merge user settings with defaults\n    const mergedSettings = {\n      logProgress: true,\n      outDir: \"./output\",\n      outFile: properties.reqesutId ?? `video-${Date.now()}` + \".mp4\",\n      quality: \"medium\",\n      projectSettings: {\n        exporter: {\n          name: \"@twick/core/wasm\",\n        },\n        size: {\n          x: width,\n          y: height,\n        },\n        fps,\n      },\n      ...settings, // Allow user settings to override defaults\n    };\n\n    const result = await withRenderSlot(async () => {\n      const file = await renderVideo({\n        projectFile: \"@twick/visualizer/dist/project.js\",\n        variables,\n        settings: mergedSettings,\n      });\n      return file;\n    });\n\n    const elapsedMs = Date.now() - start;\n    console.log(\n      `[RenderServer] Render completed in ${elapsedMs}ms (active=${activeRenders}) ->`,\n      result,\n    );\n    return result;\n  } catch (error) {\n    const elapsedMs = Date.now() - start;\n    console.error(\n      `[RenderServer] Render error after ${elapsedMs}ms (active=${activeRenders}):`,\n      error,\n    );\n    throw error;\n  }\n};\n\nexport default renderTwickVideo;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,sBAA4B;AAI5B,IAAI,gBAAgB;AACpB,IAAM,cAAiC,CAAC;AAExC,IAAM,0BAA0B,MAAM;AACpC,QAAM,UAAU,QAAQ,IAAI;AAC5B,QAAM,SAAS,UAAU,SAAS,SAAS,EAAE,IAAI;AACjD,SAAO,OAAO,SAAS,MAAM,KAAK,SAAS,IAAI,SAAS;AAC1D;AAEA,eAAe,eAAkB,IAAkC;AACjE,QAAM,gBAAgB,wBAAwB;AAE9C,MAAI,iBAAiB,eAAe;AAClC,UAAM,IAAI,QAAc,CAAC,YAAY;AACnC,kBAAY,KAAK,OAAO;AAAA,IAC1B,CAAC;AAAA,EACH;AAEA;AACA,MAAI;AACF,WAAO,MAAM,GAAG;AAAA,EAClB,UAAE;AACA;AACA,UAAM,OAAO,YAAY,MAAM;AAC/B,QAAI,MAAM;AACR,WAAK;AAAA,IACP;AAAA,EACF;AACF;AAoBA,IAAM,mBAAmB,OAAO,WAAgB,aAAkB;AAChE,QAAM,QAAQ,KAAK,IAAI;AACvB,MAAI;AACF,UAAM,EAAE,MAAM,IAAI;AAClB,UAAM,EAAE,WAAW,IAAI;AAGvB,UAAM,WACJ,SAAS,QAAQ,IAAI,0BAA0B,QAAQ,EAAE,KAAK;AAChE,UAAM,YACJ,SAAS,QAAQ,IAAI,2BAA2B,QAAQ,EAAE,KAAK;AACjE,UAAM,SACJ,SAAS,QAAQ,IAAI,wBAAwB,MAAM,EAAE,KAAK;AAE5D,UAAM,QAAQ,KAAK,IAAI,WAAW,OAAO,QAAQ;AACjD,UAAM,SAAS,KAAK,IAAI,WAAW,QAAQ,SAAS;AACpD,UAAM,MAAM,KAAK,IAAI,WAAW,OAAO,IAAI,MAAM;AAGjD,UAAM,iBAAiB;AAAA,MACrB,aAAa;AAAA,MACb,QAAQ;AAAA,MACR,SAAS,WAAW,aAAa,SAAS,KAAK,IAAI,CAAC;AAAA,MACpD,SAAS;AAAA,MACT,iBAAiB;AAAA,QACf,UAAU;AAAA,UACR,MAAM;AAAA,QACR;AAAA,QACA,MAAM;AAAA,UACJ,GAAG;AAAA,UACH,GAAG;AAAA,QACL;AAAA,QACA;AAAA,MACF;AAAA,MACA,GAAG;AAAA;AAAA,IACL;AAEA,UAAM,SAAS,MAAM,eAAe,YAAY;AAC9C,YAAM,OAAO,UAAM,6BAAY;AAAA,QAC7B,aAAa;AAAA,QACb;AAAA,QACA,UAAU;AAAA,MACZ,CAAC;AACD,aAAO;AAAA,IACT,CAAC;AAED,UAAM,YAAY,KAAK,IAAI,IAAI;AAC/B,YAAQ;AAAA,MACN,sCAAsC,SAAS,cAAc,aAAa;AAAA,MAC1E;AAAA,IACF;AACA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,YAAY,KAAK,IAAI,IAAI;AAC/B,YAAQ;AAAA,MACN,qCAAqC,SAAS,cAAc,aAAa;AAAA,MACzE;AAAA,IACF;AACA,UAAM;AAAA,EACR;AACF;AAEA,IAAO,mBAAQ;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/renderer.ts"],"sourcesContent":["// Export the renderer function\nexport { default as renderTwickVideo } from \"./renderer\";\n\n","import { renderVideo } from \"@twick/renderer\";\n\n// Simple in-process concurrency control for render jobs.\n// This helps avoid overloading a single server instance.\nlet activeRenders = 0;\nconst renderQueue: Array<() => void> = [];\n\nconst getMaxConcurrentRenders = () => {\n  const fromEnv = process.env.TWICK_MAX_CONCURRENT_RENDERS;\n  const parsed = fromEnv ? parseInt(fromEnv, 10) : NaN;\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : 2;\n};\n\nasync function withRenderSlot<T>(fn: () => Promise<T>): Promise<T> {\n  const maxConcurrent = getMaxConcurrentRenders();\n\n  if (activeRenders >= maxConcurrent) {\n    await new Promise<void>((resolve) => {\n      renderQueue.push(resolve);\n    });\n  }\n\n  activeRenders++;\n  try {\n    return await fn();\n  } finally {\n    activeRenders--;\n    const next = renderQueue.shift();\n    if (next) {\n      next();\n    }\n  }\n}\n\n/**\n * Renders a Twick video with the provided variables and settings.\n * Processes project variables, merges settings with defaults, and\n * generates a video file using the Twick renderer.\n *\n * @param variables - Project variables containing input configuration\n * @param settings - Optional render settings to override defaults\n * @returns Promise resolving to the path of the rendered video file\n * \n * @example\n * ```js\n * const videoPath = await renderTwickVideo(\n *   { input: { properties: { width: 1920, height: 1080 } } },\n *   { quality: \"high\", outFile: \"my-video.mp4\" }\n * );\n * // videoPath = \"./output/my-video.mp4\"\n * ```\n */\nconst renderTwickVideo = async (variables: any, settings: any) => {\n  const start = Date.now();\n  try {\n    const { input } = variables;\n    const { properties } = input;\n\n    // Basic safety limits (can be overridden via env)\n    const maxWidth =\n      parseInt(process.env.TWICK_MAX_RENDER_WIDTH ?? \"3840\", 10) || 3840;\n    const maxHeight =\n      parseInt(process.env.TWICK_MAX_RENDER_HEIGHT ?? \"2160\", 10) || 2160;\n    const maxFps =\n      parseInt(process.env.TWICK_MAX_RENDER_FPS ?? \"60\", 10) || 60;\n\n    const width = Math.min(properties.width, maxWidth);\n    const height = Math.min(properties.height, maxHeight);\n    const fps = Math.min(properties.fps ?? 30, maxFps);\n\n    // Merge user settings with defaults\n    const mergedSettings = {\n      logProgress: true,\n      outDir: \"./output\",\n      outFile: properties.reqesutId ?? `video-${Date.now()}` + \".mp4\",\n      quality: \"medium\",\n      projectSettings: {\n        exporter: {\n          name: \"@twick/core/wasm-effects\",\n        },\n        size: {\n          x: width,\n          y: height,\n        },\n        fps,\n      },\n      ...settings, // Allow user settings to override defaults\n    };\n\n    const result = await withRenderSlot(async () => {\n      const file = await renderVideo({\n        projectFile: \"@twick/visualizer/dist/project.js\",\n        variables,\n        settings: mergedSettings,\n      });\n      return file;\n    });\n\n    const elapsedMs = Date.now() - start;\n    console.log(\n      `[RenderServer] Render completed in ${elapsedMs}ms (active=${activeRenders}) ->`,\n      result,\n    );\n    return result;\n  } catch (error) {\n    const elapsedMs = Date.now() - start;\n    console.error(\n      `[RenderServer] Render error after ${elapsedMs}ms (active=${activeRenders}):`,\n      error,\n    );\n    throw error;\n  }\n};\n\nexport default renderTwickVideo;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,sBAA4B;AAI5B,IAAI,gBAAgB;AACpB,IAAM,cAAiC,CAAC;AAExC,IAAM,0BAA0B,MAAM;AACpC,QAAM,UAAU,QAAQ,IAAI;AAC5B,QAAM,SAAS,UAAU,SAAS,SAAS,EAAE,IAAI;AACjD,SAAO,OAAO,SAAS,MAAM,KAAK,SAAS,IAAI,SAAS;AAC1D;AAEA,eAAe,eAAkB,IAAkC;AACjE,QAAM,gBAAgB,wBAAwB;AAE9C,MAAI,iBAAiB,eAAe;AAClC,UAAM,IAAI,QAAc,CAAC,YAAY;AACnC,kBAAY,KAAK,OAAO;AAAA,IAC1B,CAAC;AAAA,EACH;AAEA;AACA,MAAI;AACF,WAAO,MAAM,GAAG;AAAA,EAClB,UAAE;AACA;AACA,UAAM,OAAO,YAAY,MAAM;AAC/B,QAAI,MAAM;AACR,WAAK;AAAA,IACP;AAAA,EACF;AACF;AAoBA,IAAM,mBAAmB,OAAO,WAAgB,aAAkB;AAChE,QAAM,QAAQ,KAAK,IAAI;AACvB,MAAI;AACF,UAAM,EAAE,MAAM,IAAI;AAClB,UAAM,EAAE,WAAW,IAAI;AAGvB,UAAM,WACJ,SAAS,QAAQ,IAAI,0BAA0B,QAAQ,EAAE,KAAK;AAChE,UAAM,YACJ,SAAS,QAAQ,IAAI,2BAA2B,QAAQ,EAAE,KAAK;AACjE,UAAM,SACJ,SAAS,QAAQ,IAAI,wBAAwB,MAAM,EAAE,KAAK;AAE5D,UAAM,QAAQ,KAAK,IAAI,WAAW,OAAO,QAAQ;AACjD,UAAM,SAAS,KAAK,IAAI,WAAW,QAAQ,SAAS;AACpD,UAAM,MAAM,KAAK,IAAI,WAAW,OAAO,IAAI,MAAM;AAGjD,UAAM,iBAAiB;AAAA,MACrB,aAAa;AAAA,MACb,QAAQ;AAAA,MACR,SAAS,WAAW,aAAa,SAAS,KAAK,IAAI,CAAC;AAAA,MACpD,SAAS;AAAA,MACT,iBAAiB;AAAA,QACf,UAAU;AAAA,UACR,MAAM;AAAA,QACR;AAAA,QACA,MAAM;AAAA,UACJ,GAAG;AAAA,UACH,GAAG;AAAA,QACL;AAAA,QACA;AAAA,MACF;AAAA,MACA,GAAG;AAAA;AAAA,IACL;AAEA,UAAM,SAAS,MAAM,eAAe,YAAY;AAC9C,YAAM,OAAO,UAAM,6BAAY;AAAA,QAC7B,aAAa;AAAA,QACb;AAAA,QACA,UAAU;AAAA,MACZ,CAAC;AACD,aAAO;AAAA,IACT,CAAC;AAED,UAAM,YAAY,KAAK,IAAI,IAAI;AAC/B,YAAQ;AAAA,MACN,sCAAsC,SAAS,cAAc,aAAa;AAAA,MAC1E;AAAA,IACF;AACA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,YAAY,KAAK,IAAI,IAAI;AAC/B,YAAQ;AAAA,MACN,qCAAqC,SAAS,cAAc,aAAa;AAAA,MACzE;AAAA,IACF;AACA,UAAM;AAAA,EACR;AACF;AAEA,IAAO,mBAAQ;","names":[]}

package/dist/index.mjs

@@ -43,7 +43,7 @@ var renderTwickVideo = async (variables, settings) => {
       quality: "medium",
       projectSettings: {
         exporter: {
-          name: "@twick/core/wasm"
+          name: "@twick/core/wasm-effects"
         },
         size: {
           x: width,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/renderer.ts"],"sourcesContent":["import { renderVideo } from \"@twick/renderer\";\n\n// Simple in-process concurrency control for render jobs.\n// This helps avoid overloading a single server instance.\nlet activeRenders = 0;\nconst renderQueue: Array<() => void> = [];\n\nconst getMaxConcurrentRenders = () => {\n  const fromEnv = process.env.TWICK_MAX_CONCURRENT_RENDERS;\n  const parsed = fromEnv ? parseInt(fromEnv, 10) : NaN;\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : 2;\n};\n\nasync function withRenderSlot<T>(fn: () => Promise<T>): Promise<T> {\n  const maxConcurrent = getMaxConcurrentRenders();\n\n  if (activeRenders >= maxConcurrent) {\n    await new Promise<void>((resolve) => {\n      renderQueue.push(resolve);\n    });\n  }\n\n  activeRenders++;\n  try {\n    return await fn();\n  } finally {\n    activeRenders--;\n    const next = renderQueue.shift();\n    if (next) {\n      next();\n    }\n  }\n}\n\n/**\n * Renders a Twick video with the provided variables and settings.\n * Processes project variables, merges settings with defaults, and\n * generates a video file using the Twick renderer.\n *\n * @param variables - Project variables containing input configuration\n * @param settings - Optional render settings to override defaults\n * @returns Promise resolving to the path of the rendered video file\n * \n * @example\n * ```js\n * const videoPath = await renderTwickVideo(\n *   { input: { properties: { width: 1920, height: 1080 } } },\n *   { quality: \"high\", outFile: \"my-video.mp4\" }\n * );\n * // videoPath = \"./output/my-video.mp4\"\n * ```\n */\nconst renderTwickVideo = async (variables: any, settings: any) => {\n  const start = Date.now();\n  try {\n    const { input } = variables;\n    const { properties } = input;\n\n    // Basic safety limits (can be overridden via env)\n    const maxWidth =\n      parseInt(process.env.TWICK_MAX_RENDER_WIDTH ?? \"3840\", 10) || 3840;\n    const maxHeight =\n      parseInt(process.env.TWICK_MAX_RENDER_HEIGHT ?? \"2160\", 10) || 2160;\n    const maxFps =\n      parseInt(process.env.TWICK_MAX_RENDER_FPS ?? \"60\", 10) || 60;\n\n    const width = Math.min(properties.width, maxWidth);\n    const height = Math.min(properties.height, maxHeight);\n    const fps = Math.min(properties.fps ?? 30, maxFps);\n\n    // Merge user settings with defaults\n    const mergedSettings = {\n      logProgress: true,\n      outDir: \"./output\",\n      outFile: properties.reqesutId ?? `video-${Date.now()}` + \".mp4\",\n      quality: \"medium\",\n      projectSettings: {\n        exporter: {\n          name: \"@twick/core/wasm\",\n        },\n        size: {\n          x: width,\n          y: height,\n        },\n        fps,\n      },\n      ...settings, // Allow user settings to override defaults\n    };\n\n    const result = await withRenderSlot(async () => {\n      const file = await renderVideo({\n        projectFile: \"@twick/visualizer/dist/project.js\",\n        variables,\n        settings: mergedSettings,\n      });\n      return file;\n    });\n\n    const elapsedMs = Date.now() - start;\n    console.log(\n      `[RenderServer] Render completed in ${elapsedMs}ms (active=${activeRenders}) ->`,\n      result,\n    );\n    return result;\n  } catch (error) {\n    const elapsedMs = Date.now() - start;\n    console.error(\n      `[RenderServer] Render error after ${elapsedMs}ms (active=${activeRenders}):`,\n      error,\n    );\n    throw error;\n  }\n};\n\nexport default renderTwickVideo;\n"],"mappings":";AAAA,SAAS,mBAAmB;AAI5B,IAAI,gBAAgB;AACpB,IAAM,cAAiC,CAAC;AAExC,IAAM,0BAA0B,MAAM;AACpC,QAAM,UAAU,QAAQ,IAAI;AAC5B,QAAM,SAAS,UAAU,SAAS,SAAS,EAAE,IAAI;AACjD,SAAO,OAAO,SAAS,MAAM,KAAK,SAAS,IAAI,SAAS;AAC1D;AAEA,eAAe,eAAkB,IAAkC;AACjE,QAAM,gBAAgB,wBAAwB;AAE9C,MAAI,iBAAiB,eAAe;AAClC,UAAM,IAAI,QAAc,CAAC,YAAY;AACnC,kBAAY,KAAK,OAAO;AAAA,IAC1B,CAAC;AAAA,EACH;AAEA;AACA,MAAI;AACF,WAAO,MAAM,GAAG;AAAA,EAClB,UAAE;AACA;AACA,UAAM,OAAO,YAAY,MAAM;AAC/B,QAAI,MAAM;AACR,WAAK;AAAA,IACP;AAAA,EACF;AACF;AAoBA,IAAM,mBAAmB,OAAO,WAAgB,aAAkB;AAChE,QAAM,QAAQ,KAAK,IAAI;AACvB,MAAI;AACF,UAAM,EAAE,MAAM,IAAI;AAClB,UAAM,EAAE,WAAW,IAAI;AAGvB,UAAM,WACJ,SAAS,QAAQ,IAAI,0BAA0B,QAAQ,EAAE,KAAK;AAChE,UAAM,YACJ,SAAS,QAAQ,IAAI,2BAA2B,QAAQ,EAAE,KAAK;AACjE,UAAM,SACJ,SAAS,QAAQ,IAAI,wBAAwB,MAAM,EAAE,KAAK;AAE5D,UAAM,QAAQ,KAAK,IAAI,WAAW,OAAO,QAAQ;AACjD,UAAM,SAAS,KAAK,IAAI,WAAW,QAAQ,SAAS;AACpD,UAAM,MAAM,KAAK,IAAI,WAAW,OAAO,IAAI,MAAM;AAGjD,UAAM,iBAAiB;AAAA,MACrB,aAAa;AAAA,MACb,QAAQ;AAAA,MACR,SAAS,WAAW,aAAa,SAAS,KAAK,IAAI,CAAC;AAAA,MACpD,SAAS;AAAA,MACT,iBAAiB;AAAA,QACf,UAAU;AAAA,UACR,MAAM;AAAA,QACR;AAAA,QACA,MAAM;AAAA,UACJ,GAAG;AAAA,UACH,GAAG;AAAA,QACL;AAAA,QACA;AAAA,MACF;AAAA,MACA,GAAG;AAAA;AAAA,IACL;AAEA,UAAM,SAAS,MAAM,eAAe,YAAY;AAC9C,YAAM,OAAO,MAAM,YAAY;AAAA,QAC7B,aAAa;AAAA,QACb;AAAA,QACA,UAAU;AAAA,MACZ,CAAC;AACD,aAAO;AAAA,IACT,CAAC;AAED,UAAM,YAAY,KAAK,IAAI,IAAI;AAC/B,YAAQ;AAAA,MACN,sCAAsC,SAAS,cAAc,aAAa;AAAA,MAC1E;AAAA,IACF;AACA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,YAAY,KAAK,IAAI,IAAI;AAC/B,YAAQ;AAAA,MACN,qCAAqC,SAAS,cAAc,aAAa;AAAA,MACzE;AAAA,IACF;AACA,UAAM;AAAA,EACR;AACF;AAEA,IAAO,mBAAQ;","names":[]}
+{"version":3,"sources":["../src/renderer.ts"],"sourcesContent":["import { renderVideo } from \"@twick/renderer\";\n\n// Simple in-process concurrency control for render jobs.\n// This helps avoid overloading a single server instance.\nlet activeRenders = 0;\nconst renderQueue: Array<() => void> = [];\n\nconst getMaxConcurrentRenders = () => {\n  const fromEnv = process.env.TWICK_MAX_CONCURRENT_RENDERS;\n  const parsed = fromEnv ? parseInt(fromEnv, 10) : NaN;\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : 2;\n};\n\nasync function withRenderSlot<T>(fn: () => Promise<T>): Promise<T> {\n  const maxConcurrent = getMaxConcurrentRenders();\n\n  if (activeRenders >= maxConcurrent) {\n    await new Promise<void>((resolve) => {\n      renderQueue.push(resolve);\n    });\n  }\n\n  activeRenders++;\n  try {\n    return await fn();\n  } finally {\n    activeRenders--;\n    const next = renderQueue.shift();\n    if (next) {\n      next();\n    }\n  }\n}\n\n/**\n * Renders a Twick video with the provided variables and settings.\n * Processes project variables, merges settings with defaults, and\n * generates a video file using the Twick renderer.\n *\n * @param variables - Project variables containing input configuration\n * @param settings - Optional render settings to override defaults\n * @returns Promise resolving to the path of the rendered video file\n * \n * @example\n * ```js\n * const videoPath = await renderTwickVideo(\n *   { input: { properties: { width: 1920, height: 1080 } } },\n *   { quality: \"high\", outFile: \"my-video.mp4\" }\n * );\n * // videoPath = \"./output/my-video.mp4\"\n * ```\n */\nconst renderTwickVideo = async (variables: any, settings: any) => {\n  const start = Date.now();\n  try {\n    const { input } = variables;\n    const { properties } = input;\n\n    // Basic safety limits (can be overridden via env)\n    const maxWidth =\n      parseInt(process.env.TWICK_MAX_RENDER_WIDTH ?? \"3840\", 10) || 3840;\n    const maxHeight =\n      parseInt(process.env.TWICK_MAX_RENDER_HEIGHT ?? \"2160\", 10) || 2160;\n    const maxFps =\n      parseInt(process.env.TWICK_MAX_RENDER_FPS ?? \"60\", 10) || 60;\n\n    const width = Math.min(properties.width, maxWidth);\n    const height = Math.min(properties.height, maxHeight);\n    const fps = Math.min(properties.fps ?? 30, maxFps);\n\n    // Merge user settings with defaults\n    const mergedSettings = {\n      logProgress: true,\n      outDir: \"./output\",\n      outFile: properties.reqesutId ?? `video-${Date.now()}` + \".mp4\",\n      quality: \"medium\",\n      projectSettings: {\n        exporter: {\n          name: \"@twick/core/wasm-effects\",\n        },\n        size: {\n          x: width,\n          y: height,\n        },\n        fps,\n      },\n      ...settings, // Allow user settings to override defaults\n    };\n\n    const result = await withRenderSlot(async () => {\n      const file = await renderVideo({\n        projectFile: \"@twick/visualizer/dist/project.js\",\n        variables,\n        settings: mergedSettings,\n      });\n      return file;\n    });\n\n    const elapsedMs = Date.now() - start;\n    console.log(\n      `[RenderServer] Render completed in ${elapsedMs}ms (active=${activeRenders}) ->`,\n      result,\n    );\n    return result;\n  } catch (error) {\n    const elapsedMs = Date.now() - start;\n    console.error(\n      `[RenderServer] Render error after ${elapsedMs}ms (active=${activeRenders}):`,\n      error,\n    );\n    throw error;\n  }\n};\n\nexport default renderTwickVideo;\n"],"mappings":";AAAA,SAAS,mBAAmB;AAI5B,IAAI,gBAAgB;AACpB,IAAM,cAAiC,CAAC;AAExC,IAAM,0BAA0B,MAAM;AACpC,QAAM,UAAU,QAAQ,IAAI;AAC5B,QAAM,SAAS,UAAU,SAAS,SAAS,EAAE,IAAI;AACjD,SAAO,OAAO,SAAS,MAAM,KAAK,SAAS,IAAI,SAAS;AAC1D;AAEA,eAAe,eAAkB,IAAkC;AACjE,QAAM,gBAAgB,wBAAwB;AAE9C,MAAI,iBAAiB,eAAe;AAClC,UAAM,IAAI,QAAc,CAAC,YAAY;AACnC,kBAAY,KAAK,OAAO;AAAA,IAC1B,CAAC;AAAA,EACH;AAEA;AACA,MAAI;AACF,WAAO,MAAM,GAAG;AAAA,EAClB,UAAE;AACA;AACA,UAAM,OAAO,YAAY,MAAM;AAC/B,QAAI,MAAM;AACR,WAAK;AAAA,IACP;AAAA,EACF;AACF;AAoBA,IAAM,mBAAmB,OAAO,WAAgB,aAAkB;AAChE,QAAM,QAAQ,KAAK,IAAI;AACvB,MAAI;AACF,UAAM,EAAE,MAAM,IAAI;AAClB,UAAM,EAAE,WAAW,IAAI;AAGvB,UAAM,WACJ,SAAS,QAAQ,IAAI,0BAA0B,QAAQ,EAAE,KAAK;AAChE,UAAM,YACJ,SAAS,QAAQ,IAAI,2BAA2B,QAAQ,EAAE,KAAK;AACjE,UAAM,SACJ,SAAS,QAAQ,IAAI,wBAAwB,MAAM,EAAE,KAAK;AAE5D,UAAM,QAAQ,KAAK,IAAI,WAAW,OAAO,QAAQ;AACjD,UAAM,SAAS,KAAK,IAAI,WAAW,QAAQ,SAAS;AACpD,UAAM,MAAM,KAAK,IAAI,WAAW,OAAO,IAAI,MAAM;AAGjD,UAAM,iBAAiB;AAAA,MACrB,aAAa;AAAA,MACb,QAAQ;AAAA,MACR,SAAS,WAAW,aAAa,SAAS,KAAK,IAAI,CAAC;AAAA,MACpD,SAAS;AAAA,MACT,iBAAiB;AAAA,QACf,UAAU;AAAA,UACR,MAAM;AAAA,QACR;AAAA,QACA,MAAM;AAAA,UACJ,GAAG;AAAA,UACH,GAAG;AAAA,QACL;AAAA,QACA;AAAA,MACF;AAAA,MACA,GAAG;AAAA;AAAA,IACL;AAEA,UAAM,SAAS,MAAM,eAAe,YAAY;AAC9C,YAAM,OAAO,MAAM,YAAY;AAAA,QAC7B,aAAa;AAAA,QACb;AAAA,QACA,UAAU;AAAA,MACZ,CAAC;AACD,aAAO;AAAA,IACT,CAAC;AAED,UAAM,YAAY,KAAK,IAAI,IAAI;AAC/B,YAAQ;AAAA,MACN,sCAAsC,SAAS,cAAc,aAAa;AAAA,MAC1E;AAAA,IACF;AACA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,YAAY,KAAK,IAAI,IAAI;AAC/B,YAAQ;AAAA,MACN,qCAAqC,SAAS,cAAc,aAAa;AAAA,MACzE;AAAA,IACF;AACA,UAAM;AAAA,EACR;AACF;AAEA,IAAO,mBAAQ;","names":[]}

package/dist/server.mjs

@@ -49,7 +49,7 @@ var renderTwickVideo = async (variables, settings) => {
       quality: "medium",
       projectSettings: {
         exporter: {
-          name: "@twick/core/wasm"
+          name: "@twick/core/wasm-effects"
         },
         size: {
           x: width,

package/dist/server.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts","../src/renderer.ts"],"sourcesContent":["import express from \"express\";\nimport cors from \"cors\";\nimport path from \"path\";\nimport { fileURLToPath } from \"url\";\nimport renderTwickVideo from \"./renderer\";\n\nconst PORT = process.env.PORT || 5000;\nconst BASE_PATH = `http://localhost:${PORT}`;\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n// Rate limiting configuration (all configurable via env)\nconst RATE_LIMIT_WINDOW_MS =\n  parseInt(process.env.RATE_LIMIT_WINDOW_MS ?? \"900000\", 10) || 15 * 60 * 1000; // default 15 min (ms)\nconst RATE_LIMIT_MAX_REQUESTS =\n  parseInt(process.env.RATE_LIMIT_MAX_REQUESTS ?? \"100\", 10) || 100; // max requests per window\nconst RATE_LIMIT_CLEANUP_INTERVAL_MS =\n  parseInt(process.env.RATE_LIMIT_CLEANUP_INTERVAL_MS ?? \"60000\", 10) || 60 * 1000; // default 1 min (ms)\n\n// In-memory store for rate limiting\ninterface RateLimitEntry {\n  count: number;\n  resetTime: number;\n}\n\nconst rateLimitStore = new Map<string, RateLimitEntry>();\n\n// Cleanup expired entries periodically\nsetInterval(() => {\n  const now = Date.now();\n  for (const [key, entry] of rateLimitStore.entries()) {\n    if (now > entry.resetTime) {\n      rateLimitStore.delete(key);\n    }\n  }\n}, RATE_LIMIT_CLEANUP_INTERVAL_MS);\n\n/**\n * Rate limiting middleware for API endpoints.\n * Tracks request counts per IP address and enforces rate limits\n * to prevent abuse of the render server.\n *\n * @param req - Express request object\n * @param res - Express response object\n * @param next - Express next function\n * \n * @example\n * ```js\n * app.use('/api', rateLimitMiddleware);\n * // Applies rate limiting to all /api routes\n * ```\n */\nconst rateLimitMiddleware = (req: express.Request, res: express.Response, next: express.NextFunction) => {\n  const clientIP = req.ip || req.connection.remoteAddress || 'unknown';\n  const now = Date.now();\n  \n  // Get or create rate limit entry for this IP\n  let entry = rateLimitStore.get(clientIP);\n  \n  if (!entry || now > entry.resetTime) {\n    // New window or expired entry\n    entry = {\n      count: 1,\n      resetTime: now + RATE_LIMIT_WINDOW_MS\n    };\n    rateLimitStore.set(clientIP, entry);\n  } else {\n    // Increment count in current window\n    entry.count++;\n    \n    if (entry.count > RATE_LIMIT_MAX_REQUESTS) {\n      // Rate limit exceeded\n      const retryAfter = Math.ceil((entry.resetTime - now) / 1000);\n      res.set('Retry-After', retryAfter.toString());\n      res.set('X-RateLimit-Limit', RATE_LIMIT_MAX_REQUESTS.toString());\n      res.set('X-RateLimit-Remaining', '0');\n      res.set('X-RateLimit-Reset', new Date(entry.resetTime).toISOString());\n      \n      return res.status(429).json({\n        success: false,\n        error: 'Too many requests',\n        message: `Rate limit exceeded. Try again in ${retryAfter} seconds.`,\n        retryAfter\n      });\n    }\n  }\n  \n  // Add rate limit headers\n  res.set('X-RateLimit-Limit', RATE_LIMIT_MAX_REQUESTS.toString());\n  res.set('X-RateLimit-Remaining', (RATE_LIMIT_MAX_REQUESTS - entry.count).toString());\n  res.set('X-RateLimit-Reset', new Date(entry.resetTime).toISOString());\n  \n  next();\n};\n\nconst nodeApp: import(\"express\").Express = express();\n\nnodeApp.use(cors());\nnodeApp.use(express.json());\n\n// Serve static files from output directory\nnodeApp.use(\"/output\", express.static(path.join(__dirname, \"../output\")));\n\n/**\n * POST endpoint for video rendering requests.\n * Accepts project variables and settings, renders the video,\n * and returns a download URL for the completed video.\n *\n * @param req - Express request object containing variables and settings\n * @param res - Express response object\n * \n * @example\n * ```js\n * POST /api/render-video\n * Body: { variables: {...}, settings: {...} }\n * Response: { success: true, downloadUrl: \"...\" }\n * ```\n */\nnodeApp.post(\"/api/render-video\", async (req, res) => {\n  const { variables, settings } = req.body;\n\n  try {\n    const outputPath = await renderTwickVideo(variables, settings);\n    res.json({\n      success: true,\n      downloadUrl: `${BASE_PATH}/download/${path.basename(outputPath)}`,\n    });\n  } catch (error) {\n    console.error(\"Render error:\", error);\n    res.status(500).json({\n      success: false,\n      error: error instanceof Error ? error.message : \"Unknown error\",\n    });\n  }\n});\n\n/**\n * GET endpoint for downloading rendered videos.\n * Serves video files with rate limiting and security checks\n * to prevent path traversal attacks.\n *\n * @param req - Express request object with filename parameter\n * @param res - Express response object\n * \n * @example\n * ```js\n * GET /download/video-123.mp4\n * // Downloads the specified video file\n * ```\n */\nnodeApp.get(\"/download/:filename\", rateLimitMiddleware, (req, res) => {\n  const outputDir = path.resolve(__dirname, \"../output\");\n  const requestedPath = path.resolve(outputDir, req.params.filename);\n  if (!requestedPath.startsWith(outputDir + path.sep)) {\n    // Attempted path traversal or access outside output directory\n    res.status(403).json({\n      success: false,\n      error: \"Forbidden\",\n    });\n    return;\n  }\n  res.download(requestedPath, (err) => {\n    if (err) {\n      res.status(404).json({\n        success: false,\n        error: \"File not found\",\n      });\n    }\n  });\n});\n\n/**\n * Health check endpoint for monitoring server status.\n * Returns server status and current timestamp for health monitoring.\n *\n * @param req - Express request object\n * @param res - Express response object\n * \n * @example\n * ```js\n * GET /health\n * Response: { status: \"ok\", timestamp: \"2024-01-01T00:00:00.000Z\" }\n * ```\n */\nnodeApp.get(\"/health\", (req, res) => {\n  res.json({\n    status: \"ok\",\n    timestamp: new Date().toISOString(),\n  });\n});\n\n// Export the app for programmatic usage\nexport default nodeApp;\n\n// Start the server\nnodeApp.listen(PORT, () => {\n  console.log(`Render server running on port ${PORT}`);\n  console.log(`Health check: ${BASE_PATH}/health`);\n  console.log(`API endpoint: ${BASE_PATH}/api/render-video`);\n  console.log(`Download endpoint rate limited: ${RATE_LIMIT_MAX_REQUESTS} requests per ${RATE_LIMIT_WINDOW_MS / 60000} minutes`);\n});\n","import { renderVideo } from \"@twick/renderer\";\n\n// Simple in-process concurrency control for render jobs.\n// This helps avoid overloading a single server instance.\nlet activeRenders = 0;\nconst renderQueue: Array<() => void> = [];\n\nconst getMaxConcurrentRenders = () => {\n  const fromEnv = process.env.TWICK_MAX_CONCURRENT_RENDERS;\n  const parsed = fromEnv ? parseInt(fromEnv, 10) : NaN;\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : 2;\n};\n\nasync function withRenderSlot<T>(fn: () => Promise<T>): Promise<T> {\n  const maxConcurrent = getMaxConcurrentRenders();\n\n  if (activeRenders >= maxConcurrent) {\n    await new Promise<void>((resolve) => {\n      renderQueue.push(resolve);\n    });\n  }\n\n  activeRenders++;\n  try {\n    return await fn();\n  } finally {\n    activeRenders--;\n    const next = renderQueue.shift();\n    if (next) {\n      next();\n    }\n  }\n}\n\n/**\n * Renders a Twick video with the provided variables and settings.\n * Processes project variables, merges settings with defaults, and\n * generates a video file using the Twick renderer.\n *\n * @param variables - Project variables containing input configuration\n * @param settings - Optional render settings to override defaults\n * @returns Promise resolving to the path of the rendered video file\n * \n * @example\n * ```js\n * const videoPath = await renderTwickVideo(\n *   { input: { properties: { width: 1920, height: 1080 } } },\n *   { quality: \"high\", outFile: \"my-video.mp4\" }\n * );\n * // videoPath = \"./output/my-video.mp4\"\n * ```\n */\nconst renderTwickVideo = async (variables: any, settings: any) => {\n  const start = Date.now();\n  try {\n    const { input } = variables;\n    const { properties } = input;\n\n    // Basic safety limits (can be overridden via env)\n    const maxWidth =\n      parseInt(process.env.TWICK_MAX_RENDER_WIDTH ?? \"3840\", 10) || 3840;\n    const maxHeight =\n      parseInt(process.env.TWICK_MAX_RENDER_HEIGHT ?? \"2160\", 10) || 2160;\n    const maxFps =\n      parseInt(process.env.TWICK_MAX_RENDER_FPS ?? \"60\", 10) || 60;\n\n    const width = Math.min(properties.width, maxWidth);\n    const height = Math.min(properties.height, maxHeight);\n    const fps = Math.min(properties.fps ?? 30, maxFps);\n\n    // Merge user settings with defaults\n    const mergedSettings = {\n      logProgress: true,\n      outDir: \"./output\",\n      outFile: properties.reqesutId ?? `video-${Date.now()}` + \".mp4\",\n      quality: \"medium\",\n      projectSettings: {\n        exporter: {\n          name: \"@twick/core/wasm\",\n        },\n        size: {\n          x: width,\n          y: height,\n        },\n        fps,\n      },\n      ...settings, // Allow user settings to override defaults\n    };\n\n    const result = await withRenderSlot(async () => {\n      const file = await renderVideo({\n        projectFile: \"@twick/visualizer/dist/project.js\",\n        variables,\n        settings: mergedSettings,\n      });\n      return file;\n    });\n\n    const elapsedMs = Date.now() - start;\n    console.log(\n      `[RenderServer] Render completed in ${elapsedMs}ms (active=${activeRenders}) ->`,\n      result,\n    );\n    return result;\n  } catch (error) {\n    const elapsedMs = Date.now() - start;\n    console.error(\n      `[RenderServer] Render error after ${elapsedMs}ms (active=${activeRenders}):`,\n      error,\n    );\n    throw error;\n  }\n};\n\nexport default renderTwickVideo;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/server.ts","../src/renderer.ts"],"sourcesContent":["import express from \"express\";\nimport cors from \"cors\";\nimport path from \"path\";\nimport { fileURLToPath } from \"url\";\nimport renderTwickVideo from \"./renderer\";\n\nconst PORT = process.env.PORT || 5000;\nconst BASE_PATH = `http://localhost:${PORT}`;\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n// Rate limiting configuration (all configurable via env)\nconst RATE_LIMIT_WINDOW_MS =\n  parseInt(process.env.RATE_LIMIT_WINDOW_MS ?? \"900000\", 10) || 15 * 60 * 1000; // default 15 min (ms)\nconst RATE_LIMIT_MAX_REQUESTS =\n  parseInt(process.env.RATE_LIMIT_MAX_REQUESTS ?? \"100\", 10) || 100; // max requests per window\nconst RATE_LIMIT_CLEANUP_INTERVAL_MS =\n  parseInt(process.env.RATE_LIMIT_CLEANUP_INTERVAL_MS ?? \"60000\", 10) || 60 * 1000; // default 1 min (ms)\n\n// In-memory store for rate limiting\ninterface RateLimitEntry {\n  count: number;\n  resetTime: number;\n}\n\nconst rateLimitStore = new Map<string, RateLimitEntry>();\n\n// Cleanup expired entries periodically\nsetInterval(() => {\n  const now = Date.now();\n  for (const [key, entry] of rateLimitStore.entries()) {\n    if (now > entry.resetTime) {\n      rateLimitStore.delete(key);\n    }\n  }\n}, RATE_LIMIT_CLEANUP_INTERVAL_MS);\n\n/**\n * Rate limiting middleware for API endpoints.\n * Tracks request counts per IP address and enforces rate limits\n * to prevent abuse of the render server.\n *\n * @param req - Express request object\n * @param res - Express response object\n * @param next - Express next function\n * \n * @example\n * ```js\n * app.use('/api', rateLimitMiddleware);\n * // Applies rate limiting to all /api routes\n * ```\n */\nconst rateLimitMiddleware = (req: express.Request, res: express.Response, next: express.NextFunction) => {\n  const clientIP = req.ip || req.connection.remoteAddress || 'unknown';\n  const now = Date.now();\n  \n  // Get or create rate limit entry for this IP\n  let entry = rateLimitStore.get(clientIP);\n  \n  if (!entry || now > entry.resetTime) {\n    // New window or expired entry\n    entry = {\n      count: 1,\n      resetTime: now + RATE_LIMIT_WINDOW_MS\n    };\n    rateLimitStore.set(clientIP, entry);\n  } else {\n    // Increment count in current window\n    entry.count++;\n    \n    if (entry.count > RATE_LIMIT_MAX_REQUESTS) {\n      // Rate limit exceeded\n      const retryAfter = Math.ceil((entry.resetTime - now) / 1000);\n      res.set('Retry-After', retryAfter.toString());\n      res.set('X-RateLimit-Limit', RATE_LIMIT_MAX_REQUESTS.toString());\n      res.set('X-RateLimit-Remaining', '0');\n      res.set('X-RateLimit-Reset', new Date(entry.resetTime).toISOString());\n      \n      return res.status(429).json({\n        success: false,\n        error: 'Too many requests',\n        message: `Rate limit exceeded. Try again in ${retryAfter} seconds.`,\n        retryAfter\n      });\n    }\n  }\n  \n  // Add rate limit headers\n  res.set('X-RateLimit-Limit', RATE_LIMIT_MAX_REQUESTS.toString());\n  res.set('X-RateLimit-Remaining', (RATE_LIMIT_MAX_REQUESTS - entry.count).toString());\n  res.set('X-RateLimit-Reset', new Date(entry.resetTime).toISOString());\n  \n  next();\n};\n\nconst nodeApp: import(\"express\").Express = express();\n\nnodeApp.use(cors());\nnodeApp.use(express.json());\n\n// Serve static files from output directory\nnodeApp.use(\"/output\", express.static(path.join(__dirname, \"../output\")));\n\n/**\n * POST endpoint for video rendering requests.\n * Accepts project variables and settings, renders the video,\n * and returns a download URL for the completed video.\n *\n * @param req - Express request object containing variables and settings\n * @param res - Express response object\n * \n * @example\n * ```js\n * POST /api/render-video\n * Body: { variables: {...}, settings: {...} }\n * Response: { success: true, downloadUrl: \"...\" }\n * ```\n */\nnodeApp.post(\"/api/render-video\", async (req, res) => {\n  const { variables, settings } = req.body;\n\n  try {\n    const outputPath = await renderTwickVideo(variables, settings);\n    res.json({\n      success: true,\n      downloadUrl: `${BASE_PATH}/download/${path.basename(outputPath)}`,\n    });\n  } catch (error) {\n    console.error(\"Render error:\", error);\n    res.status(500).json({\n      success: false,\n      error: error instanceof Error ? error.message : \"Unknown error\",\n    });\n  }\n});\n\n/**\n * GET endpoint for downloading rendered videos.\n * Serves video files with rate limiting and security checks\n * to prevent path traversal attacks.\n *\n * @param req - Express request object with filename parameter\n * @param res - Express response object\n * \n * @example\n * ```js\n * GET /download/video-123.mp4\n * // Downloads the specified video file\n * ```\n */\nnodeApp.get(\"/download/:filename\", rateLimitMiddleware, (req, res) => {\n  const outputDir = path.resolve(__dirname, \"../output\");\n  const requestedPath = path.resolve(outputDir, req.params.filename);\n  if (!requestedPath.startsWith(outputDir + path.sep)) {\n    // Attempted path traversal or access outside output directory\n    res.status(403).json({\n      success: false,\n      error: \"Forbidden\",\n    });\n    return;\n  }\n  res.download(requestedPath, (err) => {\n    if (err) {\n      res.status(404).json({\n        success: false,\n        error: \"File not found\",\n      });\n    }\n  });\n});\n\n/**\n * Health check endpoint for monitoring server status.\n * Returns server status and current timestamp for health monitoring.\n *\n * @param req - Express request object\n * @param res - Express response object\n * \n * @example\n * ```js\n * GET /health\n * Response: { status: \"ok\", timestamp: \"2024-01-01T00:00:00.000Z\" }\n * ```\n */\nnodeApp.get(\"/health\", (req, res) => {\n  res.json({\n    status: \"ok\",\n    timestamp: new Date().toISOString(),\n  });\n});\n\n// Export the app for programmatic usage\nexport default nodeApp;\n\n// Start the server\nnodeApp.listen(PORT, () => {\n  console.log(`Render server running on port ${PORT}`);\n  console.log(`Health check: ${BASE_PATH}/health`);\n  console.log(`API endpoint: ${BASE_PATH}/api/render-video`);\n  console.log(`Download endpoint rate limited: ${RATE_LIMIT_MAX_REQUESTS} requests per ${RATE_LIMIT_WINDOW_MS / 60000} minutes`);\n});\n","import { renderVideo } from \"@twick/renderer\";\n\n// Simple in-process concurrency control for render jobs.\n// This helps avoid overloading a single server instance.\nlet activeRenders = 0;\nconst renderQueue: Array<() => void> = [];\n\nconst getMaxConcurrentRenders = () => {\n  const fromEnv = process.env.TWICK_MAX_CONCURRENT_RENDERS;\n  const parsed = fromEnv ? parseInt(fromEnv, 10) : NaN;\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : 2;\n};\n\nasync function withRenderSlot<T>(fn: () => Promise<T>): Promise<T> {\n  const maxConcurrent = getMaxConcurrentRenders();\n\n  if (activeRenders >= maxConcurrent) {\n    await new Promise<void>((resolve) => {\n      renderQueue.push(resolve);\n    });\n  }\n\n  activeRenders++;\n  try {\n    return await fn();\n  } finally {\n    activeRenders--;\n    const next = renderQueue.shift();\n    if (next) {\n      next();\n    }\n  }\n}\n\n/**\n * Renders a Twick video with the provided variables and settings.\n * Processes project variables, merges settings with defaults, and\n * generates a video file using the Twick renderer.\n *\n * @param variables - Project variables containing input configuration\n * @param settings - Optional render settings to override defaults\n * @returns Promise resolving to the path of the rendered video file\n * \n * @example\n * ```js\n * const videoPath = await renderTwickVideo(\n *   { input: { properties: { width: 1920, height: 1080 } } },\n *   { quality: \"high\", outFile: \"my-video.mp4\" }\n * );\n * // videoPath = \"./output/my-video.mp4\"\n * ```\n */\nconst renderTwickVideo = async (variables: any, settings: any) => {\n  const start = Date.now();\n  try {\n    const { input } = variables;\n    const { properties } = input;\n\n    // Basic safety limits (can be overridden via env)\n    const maxWidth =\n      parseInt(process.env.TWICK_MAX_RENDER_WIDTH ?? \"3840\", 10) || 3840;\n    const maxHeight =\n      parseInt(process.env.TWICK_MAX_RENDER_HEIGHT ?? \"2160\", 10) || 2160;\n    const maxFps =\n      parseInt(process.env.TWICK_MAX_RENDER_FPS ?? \"60\", 10) || 60;\n\n    const width = Math.min(properties.width, maxWidth);\n    const height = Math.min(properties.height, maxHeight);\n    const fps = Math.min(properties.fps ?? 30, maxFps);\n\n    // Merge user settings with defaults\n    const mergedSettings = {\n      logProgress: true,\n      outDir: \"./output\",\n      outFile: properties.reqesutId ?? `video-${Date.now()}` + \".mp4\",\n      quality: \"medium\",\n      projectSettings: {\n        exporter: {\n          name: \"@twick/core/wasm-effects\",\n        },\n        size: {\n          x: width,\n          y: height,\n        },\n        fps,\n      },\n      ...settings, // Allow user settings to override defaults\n    };\n\n    const result = await withRenderSlot(async () => {\n      const file = await renderVideo({\n        projectFile: \"@twick/visualizer/dist/project.js\",\n        variables,\n        settings: mergedSettings,\n      });\n      return file;\n    });\n\n    const elapsedMs = Date.now() - start;\n    console.log(\n      `[RenderServer] Render completed in ${elapsedMs}ms (active=${activeRenders}) ->`,\n      result,\n    );\n    return result;\n  } catch (error) {\n    const elapsedMs = Date.now() - start;\n    console.error(\n      `[RenderServer] Render error after ${elapsedMs}ms (active=${activeRenders}):`,\n      error,\n    );\n    throw error;\n  }\n};\n\nexport default renderTwickVideo;\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twick/render-server",
-  "version": "0.15.20",
+  "version": "0.15.22",
   "license": "https://github.com/ncounterspecialist/twick/blob/main/LICENSE.md",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -26,12 +26,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@twick/2d": "^0.15.20",
-    "@twick/core": "^0.15.20",
-    "@twick/ffmpeg": "^0.15.20",
-    "@twick/renderer": "^0.15.20",
-    "@twick/ui": "^0.15.20",
-    "@twick/visualizer": "0.15.20",
+    "@twick/2d": "^0.15.22",
+    "@twick/core": "^0.15.22",
+    "@twick/ffmpeg": "^0.15.22",
+    "@twick/renderer": "^0.15.22",
+    "@twick/ui": "^0.15.22",
+    "@twick/visualizer": "0.15.22",
     "cors": "^2.8.5",
     "express": "^4.18.2",
     "express-rate-limit": "^8.0.1",
@@ -49,5 +49,8 @@
   },
   "engines": {
     "node": ">=20.0.0"
-  }
+  },
+  "files": [
+    "dist"
+  ]
 }

package/.dockerignore

@@ -1,13 +0,0 @@
-node_modules
-npm-debug.log
-Dockerfile
-.dockerignore
-*.md
-dist
-.git
-.gitignore
-.env*
-*.log
-coverage
-.nyc_output
-test.js

package/Dockerfile

@@ -1,39 +0,0 @@
-FROM ghcr.io/puppeteer/puppeteer:latest AS builder
-WORKDIR /app
-
-COPY package*.json ./
-RUN npm install
-
-# Copy only source and config (avoid overwriting node_modules from context)
-COPY src ./src
-COPY tsup.config.ts tsconfig.json ./
-RUN npm run build
-# Ensure server entry point exists (tsup outputs ESM as .mjs)
-RUN test -f /app/dist/server.mjs || test -f /app/dist/server.js || (echo "Missing dist/server.mjs or server.js. Contents of /app/dist:" && ls -la /app/dist 2>/dev/null || true && exit 1)
-
-FROM ghcr.io/puppeteer/puppeteer:latest
-
-WORKDIR /app
-
-# Switch to root to install system packages (needed for ffmpeg)
-USER root
-
-RUN apt-get update && apt-get install -y ffmpeg && rm -rf /var/lib/apt/lists/*
-
-# Drop back to the non-root Puppeteer user for runtime
-USER pptruser
-
-# Tell @twick/ffmpeg to use the system binaries
-ENV FFMPEG_PATH=/usr/bin/ffmpeg
-ENV FFPROBE_PATH=/usr/bin/ffprobe
-
-COPY package*.json ./
-RUN npm install --only=production
-
-COPY --from=builder /app/dist ./dist
-
-EXPOSE 5000
-
-# Start the built-in render server on port 5000
-CMD ["node", "dist/server.mjs"]
-

package/docker-compose.yml

@@ -1,22 +0,0 @@
-# @twick/render-server — configurable via .env
-# Copy .env.example to .env and adjust values.
-
-services:
-  render-server:
-    build:
-      context: .
-      dockerfile: Dockerfile
-    image: twick-render-server:latest
-    container_name: twick-render-server
-    restart: unless-stopped
-
-    environment:
-      PORT: "${PORT:-5000}"
-      NODE_ENV: "${NODE_ENV:-production}"
-      # Rate limiting: window in ms, max requests per window, cleanup interval in ms
-      RATE_LIMIT_WINDOW_MS: "${RATE_LIMIT_WINDOW_MS:-900000}"
-      RATE_LIMIT_MAX_REQUESTS: "${RATE_LIMIT_MAX_REQUESTS:-100}"
-      RATE_LIMIT_CLEANUP_INTERVAL_MS: "${RATE_LIMIT_CLEANUP_INTERVAL_MS:-60000}"
-
-    ports:
-      - "${PORT:-5000}:${PORT:-5000}"

package/package.json.bak

@@ -1,53 +0,0 @@
-{
-  "name": "@twick/render-server",
-  "version": "0.15.20",
-  "license": "https://github.com/ncounterspecialist/twick/blob/main/LICENSE.md",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    }
-  },
-  "bin": {
-    "twick-render-server": "./dist/cli.js"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsx watch src/server.ts",
-    "start": "node dist/server.js",
-    "test:render": "tsx src/test-render.ts",
-    "clean": "rimraf dist"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@twick/2d": "^0.15.20",
-    "@twick/core": "^0.15.20",
-    "@twick/ffmpeg": "^0.15.20",
-    "@twick/renderer": "^0.15.20",
-    "@twick/ui": "^0.15.20",
-    "@twick/visualizer": "0.15.20",
-    "cors": "^2.8.5",
-    "express": "^4.18.2",
-    "express-rate-limit": "^8.0.1",
-    "node-fetch": "^3.3.2",
-    "path": "^0.12.7"
-  },
-  "devDependencies": {
-    "@types/cors": "^2.8.17",
-    "@types/express": "^4.17.21",
-    "@types/node": "^20.10.0",
-    "rimraf": "^5.0.5",
-    "tsup": "^8.0.0",
-    "tsx": "^4.7.0",
-    "typescript": "5.4.2"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  }
-}

package/src/cli.ts

@@ -1,326 +0,0 @@
-#!/usr/bin/env node
-
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const SERVER_TEMPLATE = `import express from "express";
-import cors from "cors";
-import path from "path";
-import { fileURLToPath } from "url";
-import { renderTwickVideo } from "@twick/render-server";
-
-const PORT = process.env.PORT || 3001;
-const BASE_PATH = \`http://localhost:\${PORT}\`;
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// Rate limiting configuration
-const RATE_LIMIT_WINDOW_MS = 15 * 60 * 1000; // 15 minutes
-const RATE_LIMIT_MAX_REQUESTS = 100; // Maximum requests per window
-const RATE_LIMIT_CLEANUP_INTERVAL_MS = 60 * 1000; // Cleanup every minute
-
-// In-memory store for rate limiting
-interface RateLimitEntry {
-  count: number;
-  resetTime: number;
-}
-
-const rateLimitStore = new Map<string, RateLimitEntry>();
-
-// Cleanup expired entries periodically
-setInterval(() => {
-  const now = Date.now();
-  for (const [key, entry] of rateLimitStore.entries()) {
-    if (now > entry.resetTime) {
-      rateLimitStore.delete(key);
-    }
-  }
-}, RATE_LIMIT_CLEANUP_INTERVAL_MS);
-
-/**
- * Rate limiting middleware for API endpoints.
- * Tracks request counts per IP address and enforces rate limits
- * to prevent abuse of the render server.
- *
- * @param req - Express request object
- * @param res - Express response object
- * @param next - Express next function
- * 
- * @example
- * \`\`\`js
- * app.use('/api', rateLimitMiddleware);
- * // Applies rate limiting to all /api routes
- * \`\`\`
- */
-const rateLimitMiddleware = (req: express.Request, res: express.Response, next: express.NextFunction) => {
-  const clientIP = req.ip || req.connection.remoteAddress || 'unknown';
-  const now = Date.now();
-  
-  // Get or create rate limit entry for this IP
-  let entry = rateLimitStore.get(clientIP);
-  
-  if (!entry || now > entry.resetTime) {
-    // New window or expired entry
-    entry = {
-      count: 1,
-      resetTime: now + RATE_LIMIT_WINDOW_MS
-    };
-    rateLimitStore.set(clientIP, entry);
-  } else {
-    // Increment count in current window
-    entry.count++;
-    
-    if (entry.count > RATE_LIMIT_MAX_REQUESTS) {
-      // Rate limit exceeded
-      const retryAfter = Math.ceil((entry.resetTime - now) / 1000);
-      res.set('Retry-After', retryAfter.toString());
-      res.set('X-RateLimit-Limit', RATE_LIMIT_MAX_REQUESTS.toString());
-      res.set('X-RateLimit-Remaining', '0');
-      res.set('X-RateLimit-Reset', new Date(entry.resetTime).toISOString());
-      
-      return res.status(429).json({
-        success: false,
-        error: 'Too many requests',
-        message: \`Rate limit exceeded. Try again in \${retryAfter} seconds.\`,
-        retryAfter
-      });
-    }
-  }
-  
-  // Add rate limit headers
-  res.set('X-RateLimit-Limit', RATE_LIMIT_MAX_REQUESTS.toString());
-  res.set('X-RateLimit-Remaining', (RATE_LIMIT_MAX_REQUESTS - entry.count).toString());
-  res.set('X-RateLimit-Reset', new Date(entry.resetTime).toISOString());
-  
-  next();
-};
-
-const app = express();
-
-app.use(cors());
-app.use(express.json());
-
-// Serve static files from output directory
-app.use("/output", express.static(path.join(__dirname, "output")));
-
-/**
- * POST endpoint for video rendering requests.
- * Accepts project variables and settings, renders the video,
- * and returns a download URL for the completed video.
- *
- * @param req - Express request object containing variables and settings
- * @param res - Express response object
- * 
- * @example
- * \`\`\`js
- * POST /api/render-video
- * Body: { variables: {...}, settings: {...} }
- * Response: { success: true, downloadUrl: "..." }
- * \`\`\`
- */
-app.post("/api/render-video", async (req, res) => {
-  const { variables, settings } = req.body;
-
-  try {
-    const outputPath = await renderTwickVideo(variables, settings);
-    res.json({
-      success: true,
-      downloadUrl: \`\${BASE_PATH}/download/\${path.basename(outputPath)}\`,
-    });
-  } catch (error) {
-    console.error("Render error:", error);
-    res.status(500).json({
-      success: false,
-      error: error instanceof Error ? error.message : "Unknown error",
-    });
-  }
-});
-
-/**
- * GET endpoint for downloading rendered videos.
- * Serves video files with rate limiting and security checks
- * to prevent path traversal attacks.
- *
- * @param req - Express request object with filename parameter
- * @param res - Express response object
- * 
- * @example
- * \`\`\`js
- * GET /download/video-123.mp4
- * // Downloads the specified video file
- * \`\`\`
- */
-app.get("/download/:filename", rateLimitMiddleware, (req, res) => {
-  const outputDir = path.resolve(__dirname, "output");
-  const requestedPath = path.resolve(outputDir, req.params.filename);
-  if (!requestedPath.startsWith(outputDir + path.sep)) {
-    // Attempted path traversal or access outside output directory
-    res.status(403).json({
-      success: false,
-      error: "Forbidden",
-    });
-    return;
-  }
-  res.download(requestedPath, (err) => {
-    if (err) {
-      res.status(404).json({
-        success: false,
-        error: "File not found",
-      });
-    }
-  });
-});
-
-/**
- * Health check endpoint for monitoring server status.
- * Returns server status and current timestamp for health monitoring.
- *
- * @param req - Express request object
- * @param res - Express response object
- * 
- * @example
- * \`\`\`js
- * GET /health
- * Response: { status: "ok", timestamp: "2024-01-01T00:00:00.000Z" }
- * \`\`\`
- */
-app.get("/health", (req, res) => {
-  res.json({
-    status: "ok",
-    timestamp: new Date().toISOString(),
-  });
-});
-
-// Start the server
-app.listen(PORT, () => {
-  console.log(\`Render server running on port \${PORT}\`);
-  console.log(\`Health check: \${BASE_PATH}/health\`);
-  console.log(\`API endpoint: \${BASE_PATH}/api/render-video\`);
-  console.log(\`Download endpoint rate limited: \${RATE_LIMIT_MAX_REQUESTS} requests per \${RATE_LIMIT_WINDOW_MS / 60000} minutes\`);
-});
-`;
-
-const PACKAGE_JSON_TEMPLATE = `{
-  "name": "twick-render-server",
-  "version": "1.0.0",
-  "type": "module",
-  "scripts": {
-    "dev": "tsx watch server.ts",
-    "build": "tsc",
-    "start": "node dist/server.js"
-  },
-  "dependencies": {
-    "@twick/render-server": "^0.14.11",
-    "cors": "^2.8.5",
-    "express": "^4.18.2"
-  },
-  "devDependencies": {
-    "@types/cors": "^2.8.17",
-    "@types/express": "^4.17.21",
-    "@types/node": "^20.10.0",
-    "tsx": "^4.7.0",
-    "typescript": "5.4.2"
-  }
-}
-`;
-
-const TSCONFIG_TEMPLATE = `{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "allowSyntheticDefaultImports": true,
-    "esModuleInterop": true,
-    "allowJs": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "outDir": "./dist",
-    "rootDir": ".",
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "resolveJsonModule": true,
-    "noEmit": false
-  },
-  "include": ["server.ts"],
-  "exclude": ["node_modules", "dist"]
-}
-`;
-
-const GITIGNORE_TEMPLATE = `node_modules/
-dist/
-output/
-.env
-*.log
-`;
-
-function scaffoldServer() {
-  const currentDir = process.cwd();
-  const serverDir = path.join(currentDir, "twick-render-server");
-
-  // Check if directory already exists
-  if (fs.existsSync(serverDir)) {
-    console.error(`Error: Directory "${serverDir}" already exists.`);
-    console.error("Please remove it or choose a different location.");
-    process.exit(1);
-  }
-
-  // Create server directory
-  fs.mkdirSync(serverDir, { recursive: true });
-  fs.mkdirSync(path.join(serverDir, "output"), { recursive: true });
-
-  // Write server.ts
-  fs.writeFileSync(
-    path.join(serverDir, "server.ts"),
-    SERVER_TEMPLATE,
-    "utf-8"
-  );
-
-  // Write package.json
-  fs.writeFileSync(
-    path.join(serverDir, "package.json"),
-    PACKAGE_JSON_TEMPLATE,
-    "utf-8"
-  );
-
-  // Write tsconfig.json
-  fs.writeFileSync(
-    path.join(serverDir, "tsconfig.json"),
-    TSCONFIG_TEMPLATE,
-    "utf-8"
-  );
-
-  // Write .gitignore
-  fs.writeFileSync(
-    path.join(serverDir, ".gitignore"),
-    GITIGNORE_TEMPLATE,
-    "utf-8"
-  );
-
-  console.log(`✅ Successfully scaffolded Twick render server!`);
-  console.log(`\n📁 Server created at: ${serverDir}`);
-  console.log(`\n📝 Next steps:`);
-  console.log(`   1. cd ${path.basename(serverDir)}`);
-  console.log(`   2. npm install`);
-  console.log(`   3. npm run dev (for development)`);
-  console.log(`   4. npm run build && npm start (for production)`);
-}
-
-// Parse command line arguments
-const args = process.argv.slice(2);
-const command = args[0];
-
-if (command === "init") {
-  scaffoldServer();
-} else {
-  console.log("Usage: npx twick-render-server init");
-  console.log("\nThis command scaffolds a new Twick render server in the current directory.");
-  process.exit(1);
-}
-

package/src/index.ts

@@ -1,3 +0,0 @@
-// Export the renderer function
-export { default as renderTwickVideo } from "./renderer";
-