@twick/render-server 0.15.14 → 0.15.15

package/dist/index.js

@@ -26,10 +26,42 @@ module.exports = __toCommonJS(index_exports);
 
 // src/renderer.ts
 var import_renderer = require("@twick/renderer");
+var activeRenders = 0;
+var renderQueue = [];
+var getMaxConcurrentRenders = () => {
+  const fromEnv = process.env.TWICK_MAX_CONCURRENT_RENDERS;
+  const parsed = fromEnv ? parseInt(fromEnv, 10) : NaN;
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 2;
+};
+async function withRenderSlot(fn) {
+  const maxConcurrent = getMaxConcurrentRenders();
+  if (activeRenders >= maxConcurrent) {
+    await new Promise((resolve) => {
+      renderQueue.push(resolve);
+    });
+  }
+  activeRenders++;
+  try {
+    return await fn();
+  } finally {
+    activeRenders--;
+    const next = renderQueue.shift();
+    if (next) {
+      next();
+    }
+  }
+}
 var renderTwickVideo = async (variables, settings) => {
+  const start = Date.now();
   try {
     const { input } = variables;
     const { properties } = input;
+    const maxWidth = parseInt(process.env.TWICK_MAX_RENDER_WIDTH ?? "3840", 10) || 3840;
+    const maxHeight = parseInt(process.env.TWICK_MAX_RENDER_HEIGHT ?? "2160", 10) || 2160;
+    const maxFps = parseInt(process.env.TWICK_MAX_RENDER_FPS ?? "60", 10) || 60;
+    const width = Math.min(properties.width, maxWidth);
+    const height = Math.min(properties.height, maxHeight);
+    const fps = Math.min(properties.fps ?? 30, maxFps);
     const mergedSettings = {
       logProgress: true,
       outDir: "./output",
@@ -40,22 +72,34 @@ var renderTwickVideo = async (variables, settings) => {
           name: "@twick/core/wasm"
         },
         size: {
-          x: properties.width,
-          y: properties.height
-        }
+          x: width,
+          y: height
+        },
+        fps
       },
       ...settings
       // Allow user settings to override defaults
     };
-    const file = await (0, import_renderer.renderVideo)({
-      projectFile: "@twick/visualizer/dist/project.js",
-      variables,
-      settings: mergedSettings
+    const result = await withRenderSlot(async () => {
+      const file = await (0, import_renderer.renderVideo)({
+        projectFile: "@twick/visualizer/dist/project.js",
+        variables,
+        settings: mergedSettings
+      });
+      return file;
     });
-    console.log("Successfully rendered: ", file);
-    return file;
+    const elapsedMs = Date.now() - start;
+    console.log(
+      `[RenderServer] Render completed in ${elapsedMs}ms (active=${activeRenders}) ->`,
+      result
+    );
+    return result;
   } catch (error) {
-    console.error("Render error:", error);
+    const elapsedMs = Date.now() - start;
+    console.error(
+      `[RenderServer] Render error after ${elapsedMs}ms (active=${activeRenders}):`,
+      error
+    );
     throw error;
   }
 };

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/**\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  try {\n    const { input } = variables;\n    const { properties } = input;\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: properties.width,\n          y: properties.height,\n        },\n      },\n      ...settings, // Allow user settings to override defaults\n    };\n\n    const file = await renderVideo({\n      projectFile: \"@twick/visualizer/dist/project.js\",\n      variables: variables,\n      settings: mergedSettings,\n    });\n    console.log(\"Successfully rendered: \", file);\n    return file;\n  } catch (error) {\n    console.error(\"Render error:\", error);\n    throw error;\n  }\n};\n\nexport default renderTwickVideo;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,sBAA4B;AAoB5B,IAAM,mBAAmB,OAAO,WAAgB,aAAkB;AAChE,MAAI;AACF,UAAM,EAAE,MAAM,IAAI;AAClB,UAAM,EAAE,WAAW,IAAI;AAEvB,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,WAAW;AAAA,UACd,GAAG,WAAW;AAAA,QAChB;AAAA,MACF;AAAA,MACA,GAAG;AAAA;AAAA,IACL;AAEA,UAAM,OAAO,UAAM,6BAAY;AAAA,MAC7B,aAAa;AAAA,MACb;AAAA,MACA,UAAU;AAAA,IACZ,CAAC;AACD,YAAQ,IAAI,2BAA2B,IAAI;AAC3C,WAAO;AAAA,EACT,SAAS,OAAO;AACd,YAAQ,MAAM,iBAAiB,KAAK;AACpC,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\",\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

@@ -1,9 +1,41 @@
 // src/renderer.ts
 import { renderVideo } from "@twick/renderer";
+var activeRenders = 0;
+var renderQueue = [];
+var getMaxConcurrentRenders = () => {
+  const fromEnv = process.env.TWICK_MAX_CONCURRENT_RENDERS;
+  const parsed = fromEnv ? parseInt(fromEnv, 10) : NaN;
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 2;
+};
+async function withRenderSlot(fn) {
+  const maxConcurrent = getMaxConcurrentRenders();
+  if (activeRenders >= maxConcurrent) {
+    await new Promise((resolve) => {
+      renderQueue.push(resolve);
+    });
+  }
+  activeRenders++;
+  try {
+    return await fn();
+  } finally {
+    activeRenders--;
+    const next = renderQueue.shift();
+    if (next) {
+      next();
+    }
+  }
+}
 var renderTwickVideo = async (variables, settings) => {
+  const start = Date.now();
   try {
     const { input } = variables;
     const { properties } = input;
+    const maxWidth = parseInt(process.env.TWICK_MAX_RENDER_WIDTH ?? "3840", 10) || 3840;
+    const maxHeight = parseInt(process.env.TWICK_MAX_RENDER_HEIGHT ?? "2160", 10) || 2160;
+    const maxFps = parseInt(process.env.TWICK_MAX_RENDER_FPS ?? "60", 10) || 60;
+    const width = Math.min(properties.width, maxWidth);
+    const height = Math.min(properties.height, maxHeight);
+    const fps = Math.min(properties.fps ?? 30, maxFps);
     const mergedSettings = {
       logProgress: true,
       outDir: "./output",
@@ -14,22 +46,34 @@ var renderTwickVideo = async (variables, settings) => {
           name: "@twick/core/wasm"
         },
         size: {
-          x: properties.width,
-          y: properties.height
-        }
+          x: width,
+          y: height
+        },
+        fps
       },
       ...settings
       // Allow user settings to override defaults
     };
-    const file = await renderVideo({
-      projectFile: "@twick/visualizer/dist/project.js",
-      variables,
-      settings: mergedSettings
+    const result = await withRenderSlot(async () => {
+      const file = await renderVideo({
+        projectFile: "@twick/visualizer/dist/project.js",
+        variables,
+        settings: mergedSettings
+      });
+      return file;
     });
-    console.log("Successfully rendered: ", file);
-    return file;
+    const elapsedMs = Date.now() - start;
+    console.log(
+      `[RenderServer] Render completed in ${elapsedMs}ms (active=${activeRenders}) ->`,
+      result
+    );
+    return result;
   } catch (error) {
-    console.error("Render error:", error);
+    const elapsedMs = Date.now() - start;
+    console.error(
+      `[RenderServer] Render error after ${elapsedMs}ms (active=${activeRenders}):`,
+      error
+    );
     throw error;
   }
 };

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/renderer.ts"],"sourcesContent":["import { renderVideo } from \"@twick/renderer\";\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  try {\n    const { input } = variables;\n    const { properties } = input;\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: properties.width,\n          y: properties.height,\n        },\n      },\n      ...settings, // Allow user settings to override defaults\n    };\n\n    const file = await renderVideo({\n      projectFile: \"@twick/visualizer/dist/project.js\",\n      variables: variables,\n      settings: mergedSettings,\n    });\n    console.log(\"Successfully rendered: \", file);\n    return file;\n  } catch (error) {\n    console.error(\"Render error:\", error);\n    throw error;\n  }\n};\n\nexport default renderTwickVideo;\n"],"mappings":";AAAA,SAAS,mBAAmB;AAoB5B,IAAM,mBAAmB,OAAO,WAAgB,aAAkB;AAChE,MAAI;AACF,UAAM,EAAE,MAAM,IAAI;AAClB,UAAM,EAAE,WAAW,IAAI;AAEvB,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,WAAW;AAAA,UACd,GAAG,WAAW;AAAA,QAChB;AAAA,MACF;AAAA,MACA,GAAG;AAAA;AAAA,IACL;AAEA,UAAM,OAAO,MAAM,YAAY;AAAA,MAC7B,aAAa;AAAA,MACb;AAAA,MACA,UAAU;AAAA,IACZ,CAAC;AACD,YAAQ,IAAI,2BAA2B,IAAI;AAC3C,WAAO;AAAA,EACT,SAAS,OAAO;AACd,YAAQ,MAAM,iBAAiB,KAAK;AACpC,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\",\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

@@ -6,10 +6,42 @@ import { fileURLToPath } from "url";
 
 // src/renderer.ts
 import { renderVideo } from "@twick/renderer";
+var activeRenders = 0;
+var renderQueue = [];
+var getMaxConcurrentRenders = () => {
+  const fromEnv = process.env.TWICK_MAX_CONCURRENT_RENDERS;
+  const parsed = fromEnv ? parseInt(fromEnv, 10) : NaN;
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 2;
+};
+async function withRenderSlot(fn) {
+  const maxConcurrent = getMaxConcurrentRenders();
+  if (activeRenders >= maxConcurrent) {
+    await new Promise((resolve) => {
+      renderQueue.push(resolve);
+    });
+  }
+  activeRenders++;
+  try {
+    return await fn();
+  } finally {
+    activeRenders--;
+    const next = renderQueue.shift();
+    if (next) {
+      next();
+    }
+  }
+}
 var renderTwickVideo = async (variables, settings) => {
+  const start = Date.now();
   try {
     const { input } = variables;
     const { properties } = input;
+    const maxWidth = parseInt(process.env.TWICK_MAX_RENDER_WIDTH ?? "3840", 10) || 3840;
+    const maxHeight = parseInt(process.env.TWICK_MAX_RENDER_HEIGHT ?? "2160", 10) || 2160;
+    const maxFps = parseInt(process.env.TWICK_MAX_RENDER_FPS ?? "60", 10) || 60;
+    const width = Math.min(properties.width, maxWidth);
+    const height = Math.min(properties.height, maxHeight);
+    const fps = Math.min(properties.fps ?? 30, maxFps);
     const mergedSettings = {
       logProgress: true,
       outDir: "./output",
@@ -20,22 +52,34 @@ var renderTwickVideo = async (variables, settings) => {
           name: "@twick/core/wasm"
         },
         size: {
-          x: properties.width,
-          y: properties.height
-        }
+          x: width,
+          y: height
+        },
+        fps
       },
       ...settings
       // Allow user settings to override defaults
     };
-    const file = await renderVideo({
-      projectFile: "@twick/visualizer/dist/project.js",
-      variables,
-      settings: mergedSettings
+    const result = await withRenderSlot(async () => {
+      const file = await renderVideo({
+        projectFile: "@twick/visualizer/dist/project.js",
+        variables,
+        settings: mergedSettings
+      });
+      return file;
     });
-    console.log("Successfully rendered: ", file);
-    return file;
+    const elapsedMs = Date.now() - start;
+    console.log(
+      `[RenderServer] Render completed in ${elapsedMs}ms (active=${activeRenders}) ->`,
+      result
+    );
+    return result;
   } catch (error) {
-    console.error("Render error:", error);
+    const elapsedMs = Date.now() - start;
+    console.error(
+      `[RenderServer] Render error after ${elapsedMs}ms (active=${activeRenders}):`,
+      error
+    );
     throw error;
   }
 };

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/**\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  try {\n    const { input } = variables;\n    const { properties } = input;\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: properties.width,\n          y: properties.height,\n        },\n      },\n      ...settings, // Allow user settings to override defaults\n    };\n\n    const file = await renderVideo({\n      projectFile: \"@twick/visualizer/dist/project.js\",\n      variables: variables,\n      settings: mergedSettings,\n    });\n    console.log(\"Successfully rendered: \", file);\n    return file;\n  } catch (error) {\n    console.error(\"Render error:\", error);\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\",\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.14",
+  "version": "0.15.15",
   "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.14",
-    "@twick/core": "^0.15.14",
-    "@twick/ffmpeg": "^0.15.14",
-    "@twick/renderer": "^0.15.14",
-    "@twick/ui": "^0.15.14",
-    "@twick/visualizer": "0.15.14",
+    "@twick/2d": "^0.15.15",
+    "@twick/core": "^0.15.15",
+    "@twick/ffmpeg": "^0.15.15",
+    "@twick/renderer": "^0.15.15",
+    "@twick/ui": "^0.15.15",
+    "@twick/visualizer": "0.15.15",
     "cors": "^2.8.5",
     "express": "^4.18.2",
     "express-rate-limit": "^8.0.1",

package/package.json.bak

@@ -1,6 +1,6 @@
 {
   "name": "@twick/render-server",
-  "version": "0.15.14",
+  "version": "0.15.15",
   "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.14",
-    "@twick/core": "^0.15.14",
-    "@twick/ffmpeg": "^0.15.14",
-    "@twick/renderer": "^0.15.14",
-    "@twick/ui": "^0.15.14",
-    "@twick/visualizer": "0.15.14",
+    "@twick/2d": "^0.15.15",
+    "@twick/core": "^0.15.15",
+    "@twick/ffmpeg": "^0.15.15",
+    "@twick/renderer": "^0.15.15",
+    "@twick/ui": "^0.15.15",
+    "@twick/visualizer": "0.15.15",
     "cors": "^2.8.5",
     "express": "^4.18.2",
     "express-rate-limit": "^8.0.1",

package/src/renderer.ts

@@ -1,5 +1,37 @@
 import { renderVideo } from "@twick/renderer";
 
+// Simple in-process concurrency control for render jobs.
+// This helps avoid overloading a single server instance.
+let activeRenders = 0;
+const renderQueue: Array<() => void> = [];
+
+const getMaxConcurrentRenders = () => {
+  const fromEnv = process.env.TWICK_MAX_CONCURRENT_RENDERS;
+  const parsed = fromEnv ? parseInt(fromEnv, 10) : NaN;
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 2;
+};
+
+async function withRenderSlot<T>(fn: () => Promise<T>): Promise<T> {
+  const maxConcurrent = getMaxConcurrentRenders();
+
+  if (activeRenders >= maxConcurrent) {
+    await new Promise<void>((resolve) => {
+      renderQueue.push(resolve);
+    });
+  }
+
+  activeRenders++;
+  try {
+    return await fn();
+  } finally {
+    activeRenders--;
+    const next = renderQueue.shift();
+    if (next) {
+      next();
+    }
+  }
+}
+
 /**
  * Renders a Twick video with the provided variables and settings.
  * Processes project variables, merges settings with defaults, and
@@ -19,9 +51,23 @@ import { renderVideo } from "@twick/renderer";
  * ```
  */
 const renderTwickVideo = async (variables: any, settings: any) => {
+  const start = Date.now();
   try {
     const { input } = variables;
     const { properties } = input;
+
+    // Basic safety limits (can be overridden via env)
+    const maxWidth =
+      parseInt(process.env.TWICK_MAX_RENDER_WIDTH ?? "3840", 10) || 3840;
+    const maxHeight =
+      parseInt(process.env.TWICK_MAX_RENDER_HEIGHT ?? "2160", 10) || 2160;
+    const maxFps =
+      parseInt(process.env.TWICK_MAX_RENDER_FPS ?? "60", 10) || 60;
+
+    const width = Math.min(properties.width, maxWidth);
+    const height = Math.min(properties.height, maxHeight);
+    const fps = Math.min(properties.fps ?? 30, maxFps);
+
     // Merge user settings with defaults
     const mergedSettings = {
       logProgress: true,
@@ -33,22 +79,35 @@ const renderTwickVideo = async (variables: any, settings: any) => {
           name: "@twick/core/wasm",
         },
         size: {
-          x: properties.width,
-          y: properties.height,
+          x: width,
+          y: height,
         },
+        fps,
       },
       ...settings, // Allow user settings to override defaults
     };
 
-    const file = await renderVideo({
-      projectFile: "@twick/visualizer/dist/project.js",
-      variables: variables,
-      settings: mergedSettings,
+    const result = await withRenderSlot(async () => {
+      const file = await renderVideo({
+        projectFile: "@twick/visualizer/dist/project.js",
+        variables,
+        settings: mergedSettings,
+      });
+      return file;
     });
-    console.log("Successfully rendered: ", file);
-    return file;
+
+    const elapsedMs = Date.now() - start;
+    console.log(
+      `[RenderServer] Render completed in ${elapsedMs}ms (active=${activeRenders}) ->`,
+      result,
+    );
+    return result;
   } catch (error) {
-    console.error("Render error:", error);
+    const elapsedMs = Date.now() - start;
+    console.error(
+      `[RenderServer] Render error after ${elapsedMs}ms (active=${activeRenders}):`,
+      error,
+    );
     throw error;
   }
 };