@twick/render-server 0.14.20 → 0.15.1

package/README.md

@@ -48,8 +48,9 @@ The server will start on port 3001 by default. You can change this by setting th
 
 ### Option 2: Use Programmatically
 
-Import and use the `renderTwickVideo` function directly:
+Import and use the `renderTwickVideo` function directly. The package supports both ESM and CommonJS:
 
+**ESM (import):**
 ```typescript
 import { renderTwickVideo } from "@twick/render-server";
 
@@ -67,6 +68,24 @@ const videoPath = await renderTwickVideo(
 );
 ```
 
+**CommonJS (require):**
+```javascript
+const { renderTwickVideo } = require("@twick/render-server");
+
+const videoPath = await renderTwickVideo(
+  {
+    input: {
+      properties: { width: 1920, height: 1080 },
+      // ... your project variables
+    }
+  },
+  {
+    outFile: "my-video.mp4",
+    quality: "high"
+  }
+);
+```
+
 ## API Endpoints
 
 ### POST /api/render-video
@@ -168,7 +187,7 @@ Renders a Twick video with the provided variables and settings.
 
 **Returns:** `Promise<string>` - Path to the rendered video file
 
-**Example:**
+**Example (ESM):**
 ```typescript
 import { renderTwickVideo } from "@twick/render-server";
 
@@ -187,12 +206,39 @@ const videoPath = await renderTwickVideo(
 );
 ```
 
+**Example (CommonJS):**
+```javascript
+const { renderTwickVideo } = require("@twick/render-server");
+
+const videoPath = await renderTwickVideo(
+  {
+    input: {
+      properties: { width: 1920, height: 1080 },
+      tracks: [/* ... */]
+    }
+  },
+  {
+    outFile: "my-video.mp4",
+    quality: "high",
+    outDir: "./output"
+  }
+);
+```
+
 > **Note:** This server will work on Linux and macOS only. Windows is not supported.
 
+## Module Support
+
+This package supports both ESM and CommonJS:
+- **ESM**: Use `import { renderTwickVideo } from "@twick/render-server"`
+- **CommonJS**: Use `const { renderTwickVideo } = require("@twick/render-server")`
+
+The package automatically provides the correct format based on your module system.
+
 ## Browser Support
 
 This package requires a Node.js environment with support for:
-- Node.js 18 or higher
+- Node.js 20 or higher
 - Puppeteer for video rendering
 - File system operations
 

package/dist/{cli.js → cli.mjs}

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
+
+// src/cli.ts
 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";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path.dirname(__filename);
+var SERVER_TEMPLATE = `import express from "express";
 import cors from "cors";
 import path from "path";
 import { fileURLToPath } from "url";
@@ -201,7 +203,7 @@ app.listen(PORT, () => {
   console.log(\`Download endpoint rate limited: \${RATE_LIMIT_MAX_REQUESTS} requests per \${RATE_LIMIT_WINDOW_MS / 60000} minutes\`);
 });
 `;
-const PACKAGE_JSON_TEMPLATE = `{
+var PACKAGE_JSON_TEMPLATE = `{
   "name": "twick-render-server",
   "version": "1.0.0",
   "type": "module",
@@ -224,7 +226,7 @@ const PACKAGE_JSON_TEMPLATE = `{
   }
 }
 `;
-const TSCONFIG_TEMPLATE = `{
+var TSCONFIG_TEMPLATE = `{
   "compilerOptions": {
     "target": "ES2022",
     "module": "ESNext",
@@ -247,49 +249,59 @@ const TSCONFIG_TEMPLATE = `{
   "exclude": ["node_modules", "dist"]
 }
 `;
-const GITIGNORE_TEMPLATE = `node_modules/
+var 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)`);
+  const currentDir = process.cwd();
+  const serverDir = path.join(currentDir, "twick-render-server");
+  if (fs.existsSync(serverDir)) {
+    console.error(`Error: Directory "${serverDir}" already exists.`);
+    console.error("Please remove it or choose a different location.");
+    process.exit(1);
+  }
+  fs.mkdirSync(serverDir, { recursive: true });
+  fs.mkdirSync(path.join(serverDir, "output"), { recursive: true });
+  fs.writeFileSync(
+    path.join(serverDir, "server.ts"),
+    SERVER_TEMPLATE,
+    "utf-8"
+  );
+  fs.writeFileSync(
+    path.join(serverDir, "package.json"),
+    PACKAGE_JSON_TEMPLATE,
+    "utf-8"
+  );
+  fs.writeFileSync(
+    path.join(serverDir, "tsconfig.json"),
+    TSCONFIG_TEMPLATE,
+    "utf-8"
+  );
+  fs.writeFileSync(
+    path.join(serverDir, ".gitignore"),
+    GITIGNORE_TEMPLATE,
+    "utf-8"
+  );
+  console.log(`\u2705 Successfully scaffolded Twick render server!`);
+  console.log(`
+\u{1F4C1} Server created at: ${serverDir}`);
+  console.log(`
+\u{1F4DD} 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];
+var args = process.argv.slice(2);
+var 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);
+  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);
 }
-//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport fs from \"fs\";\nimport path from \"path\";\nimport { fileURLToPath } from \"url\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nconst SERVER_TEMPLATE = `import express from \"express\";\nimport cors from \"cors\";\nimport path from \"path\";\nimport { fileURLToPath } from \"url\";\nimport { renderTwickVideo } from \"@twick/render-server\";\n\nconst PORT = process.env.PORT || 3001;\nconst BASE_PATH = \\`http://localhost:\\${PORT}\\`;\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n// Rate limiting configuration\nconst RATE_LIMIT_WINDOW_MS = 15 * 60 * 1000; // 15 minutes\nconst RATE_LIMIT_MAX_REQUESTS = 100; // Maximum requests per window\nconst RATE_LIMIT_CLEANUP_INTERVAL_MS = 60 * 1000; // Cleanup every minute\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 app = express();\n\napp.use(cors());\napp.use(express.json());\n\n// Serve static files from output directory\napp.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 */\napp.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 */\napp.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 */\napp.get(\"/health\", (req, res) => {\n  res.json({\n    status: \"ok\",\n    timestamp: new Date().toISOString(),\n  });\n});\n\n// Start the server\napp.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`;\n\nconst PACKAGE_JSON_TEMPLATE = `{\n  \"name\": \"twick-render-server\",\n  \"version\": \"1.0.0\",\n  \"type\": \"module\",\n  \"scripts\": {\n    \"dev\": \"tsx watch server.ts\",\n    \"build\": \"tsc\",\n    \"start\": \"node dist/server.js\"\n  },\n  \"dependencies\": {\n    \"@twick/render-server\": \"^0.14.11\",\n    \"cors\": \"^2.8.5\",\n    \"express\": \"^4.18.2\"\n  },\n  \"devDependencies\": {\n    \"@types/cors\": \"^2.8.17\",\n    \"@types/express\": \"^4.17.21\",\n    \"@types/node\": \"^20.10.0\",\n    \"tsx\": \"^4.7.0\",\n    \"typescript\": \"5.4.2\"\n  }\n}\n`;\n\nconst TSCONFIG_TEMPLATE = `{\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"module\": \"ESNext\",\n    \"moduleResolution\": \"bundler\",\n    \"allowSyntheticDefaultImports\": true,\n    \"esModuleInterop\": true,\n    \"allowJs\": true,\n    \"strict\": true,\n    \"skipLibCheck\": true,\n    \"forceConsistentCasingInFileNames\": true,\n    \"outDir\": \"./dist\",\n    \"rootDir\": \".\",\n    \"declaration\": true,\n    \"declarationMap\": true,\n    \"sourceMap\": true,\n    \"resolveJsonModule\": true,\n    \"noEmit\": false\n  },\n  \"include\": [\"server.ts\"],\n  \"exclude\": [\"node_modules\", \"dist\"]\n}\n`;\n\nconst GITIGNORE_TEMPLATE = `node_modules/\ndist/\noutput/\n.env\n*.log\n`;\n\nfunction scaffoldServer() {\n  const currentDir = process.cwd();\n  const serverDir = path.join(currentDir, \"twick-render-server\");\n\n  // Check if directory already exists\n  if (fs.existsSync(serverDir)) {\n    console.error(`Error: Directory \"${serverDir}\" already exists.`);\n    console.error(\"Please remove it or choose a different location.\");\n    process.exit(1);\n  }\n\n  // Create server directory\n  fs.mkdirSync(serverDir, { recursive: true });\n  fs.mkdirSync(path.join(serverDir, \"output\"), { recursive: true });\n\n  // Write server.ts\n  fs.writeFileSync(\n    path.join(serverDir, \"server.ts\"),\n    SERVER_TEMPLATE,\n    \"utf-8\"\n  );\n\n  // Write package.json\n  fs.writeFileSync(\n    path.join(serverDir, \"package.json\"),\n    PACKAGE_JSON_TEMPLATE,\n    \"utf-8\"\n  );\n\n  // Write tsconfig.json\n  fs.writeFileSync(\n    path.join(serverDir, \"tsconfig.json\"),\n    TSCONFIG_TEMPLATE,\n    \"utf-8\"\n  );\n\n  // Write .gitignore\n  fs.writeFileSync(\n    path.join(serverDir, \".gitignore\"),\n    GITIGNORE_TEMPLATE,\n    \"utf-8\"\n  );\n\n  console.log(`✅ Successfully scaffolded Twick render server!`);\n  console.log(`\\n📁 Server created at: ${serverDir}`);\n  console.log(`\\n📝 Next steps:`);\n  console.log(`   1. cd ${path.basename(serverDir)}`);\n  console.log(`   2. npm install`);\n  console.log(`   3. npm run dev (for development)`);\n  console.log(`   4. npm run build && npm start (for production)`);\n}\n\n// Parse command line arguments\nconst args = process.argv.slice(2);\nconst command = args[0];\n\nif (command === \"init\") {\n  scaffoldServer();\n} else {\n  console.log(\"Usage: npx twick-render-server init\");\n  console.log(\"\\nThis command scaffolds a new Twick render server in the current directory.\");\n  process.exit(1);\n}\n\n"],"mappings":"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","names":[]}

package/dist/{renderer.d.ts → index.d.mts}

@@ -17,5 +17,5 @@
  * ```
  */
 declare const renderTwickVideo: (variables: any, settings: any) => Promise<string>;
-export default renderTwickVideo;
-//# sourceMappingURL=renderer.d.ts.map
+
+export { renderTwickVideo };

package/dist/index.d.ts

@@ -1,2 +1,21 @@
-export { default as renderTwickVideo } from "./renderer";
-//# sourceMappingURL=index.d.ts.map
+/**
+ * Renders a Twick video with the provided variables and settings.
+ * Processes project variables, merges settings with defaults, and
+ * generates a video file using the Twick renderer.
+ *
+ * @param variables - Project variables containing input configuration
+ * @param settings - Optional render settings to override defaults
+ * @returns Promise resolving to the path of the rendered video file
+ *
+ * @example
+ * ```js
+ * const videoPath = await renderTwickVideo(
+ *   { input: { properties: { width: 1920, height: 1080 } } },
+ *   { quality: "high", outFile: "my-video.mp4" }
+ * );
+ * // videoPath = "./output/my-video.mp4"
+ * ```
+ */
+declare const renderTwickVideo: (variables: any, settings: any) => Promise<string>;
+
+export { renderTwickVideo };

package/dist/index.js

@@ -1,3 +1,67 @@
-// Export the renderer function
-export { default as renderTwickVideo } from "./renderer";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  renderTwickVideo: () => renderer_default
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/renderer.ts
+var import_renderer = require("@twick/renderer");
+var renderTwickVideo = async (variables, settings) => {
+  try {
+    const { input } = variables;
+    const { properties } = input;
+    const mergedSettings = {
+      logProgress: true,
+      outDir: "./output",
+      outFile: properties.reqesutId ?? `video-${Date.now()}.mp4`,
+      quality: "medium",
+      projectSettings: {
+        exporter: {
+          name: "@twick/core/wasm"
+        },
+        size: {
+          x: properties.width,
+          y: properties.height
+        }
+      },
+      ...settings
+      // Allow user settings to override defaults
+    };
+    const file = await (0, import_renderer.renderVideo)({
+      projectFile: "@twick/visualizer/dist/project.js",
+      variables,
+      settings: mergedSettings
+    });
+    console.log("Successfully rendered: ", file);
+    return file;
+  } catch (error) {
+    console.error("Render error:", error);
+    throw error;
+  }
+};
+var renderer_default = renderTwickVideo;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  renderTwickVideo
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"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":[]}

package/dist/index.mjs

@@ -0,0 +1,40 @@
+// src/renderer.ts
+import { renderVideo } from "@twick/renderer";
+var renderTwickVideo = async (variables, settings) => {
+  try {
+    const { input } = variables;
+    const { properties } = input;
+    const mergedSettings = {
+      logProgress: true,
+      outDir: "./output",
+      outFile: properties.reqesutId ?? `video-${Date.now()}.mp4`,
+      quality: "medium",
+      projectSettings: {
+        exporter: {
+          name: "@twick/core/wasm"
+        },
+        size: {
+          x: properties.width,
+          y: properties.height
+        }
+      },
+      ...settings
+      // Allow user settings to override defaults
+    };
+    const file = await renderVideo({
+      projectFile: "@twick/visualizer/dist/project.js",
+      variables,
+      settings: mergedSettings
+    });
+    console.log("Successfully rendered: ", file);
+    return file;
+  } catch (error) {
+    console.error("Render error:", error);
+    throw error;
+  }
+};
+var renderer_default = renderTwickVideo;
+export {
+  renderer_default as renderTwickVideo
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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":[]}

package/dist/server.mjs

@@ -0,0 +1,147 @@
+// src/server.ts
+import express from "express";
+import cors from "cors";
+import path from "path";
+import { fileURLToPath } from "url";
+
+// src/renderer.ts
+import { renderVideo } from "@twick/renderer";
+var renderTwickVideo = async (variables, settings) => {
+  try {
+    const { input } = variables;
+    const { properties } = input;
+    const mergedSettings = {
+      logProgress: true,
+      outDir: "./output",
+      outFile: properties.reqesutId ?? `video-${Date.now()}.mp4`,
+      quality: "medium",
+      projectSettings: {
+        exporter: {
+          name: "@twick/core/wasm"
+        },
+        size: {
+          x: properties.width,
+          y: properties.height
+        }
+      },
+      ...settings
+      // Allow user settings to override defaults
+    };
+    const file = await renderVideo({
+      projectFile: "@twick/visualizer/dist/project.js",
+      variables,
+      settings: mergedSettings
+    });
+    console.log("Successfully rendered: ", file);
+    return file;
+  } catch (error) {
+    console.error("Render error:", error);
+    throw error;
+  }
+};
+var renderer_default = renderTwickVideo;
+
+// src/server.ts
+var PORT = process.env.PORT || 3001;
+var BASE_PATH = `http://localhost:${PORT}`;
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path.dirname(__filename);
+var RATE_LIMIT_WINDOW_MS = 15 * 60 * 1e3;
+var RATE_LIMIT_MAX_REQUESTS = 100;
+var RATE_LIMIT_CLEANUP_INTERVAL_MS = 60 * 1e3;
+var rateLimitStore = /* @__PURE__ */ new Map();
+setInterval(() => {
+  const now = Date.now();
+  for (const [key, entry] of rateLimitStore.entries()) {
+    if (now > entry.resetTime) {
+      rateLimitStore.delete(key);
+    }
+  }
+}, RATE_LIMIT_CLEANUP_INTERVAL_MS);
+var rateLimitMiddleware = (req, res, next) => {
+  const clientIP = req.ip || req.connection.remoteAddress || "unknown";
+  const now = Date.now();
+  let entry = rateLimitStore.get(clientIP);
+  if (!entry || now > entry.resetTime) {
+    entry = {
+      count: 1,
+      resetTime: now + RATE_LIMIT_WINDOW_MS
+    };
+    rateLimitStore.set(clientIP, entry);
+  } else {
+    entry.count++;
+    if (entry.count > RATE_LIMIT_MAX_REQUESTS) {
+      const retryAfter = Math.ceil((entry.resetTime - now) / 1e3);
+      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
+      });
+    }
+  }
+  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();
+};
+var nodeApp = express();
+nodeApp.use(cors());
+nodeApp.use(express.json());
+nodeApp.use("/output", express.static(path.join(__dirname, "../output")));
+nodeApp.post("/api/render-video", async (req, res) => {
+  const { variables, settings } = req.body;
+  try {
+    const outputPath = await renderer_default(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"
+    });
+  }
+});
+nodeApp.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)) {
+    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"
+      });
+    }
+  });
+});
+nodeApp.get("/health", (req, res) => {
+  res.json({
+    status: "ok",
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  });
+});
+var server_default = nodeApp;
+nodeApp.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 / 6e4} minutes`);
+});
+export {
+  server_default as default
+};
+//# sourceMappingURL=server.mjs.map

package/dist/server.mjs.map

@@ -0,0 +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 || 3001;\nconst BASE_PATH = `http://localhost:${PORT}`;\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n// Rate limiting configuration\nconst RATE_LIMIT_WINDOW_MS = 15 * 60 * 1000; // 15 minutes\nconst RATE_LIMIT_MAX_REQUESTS = 100; // Maximum requests per window\nconst RATE_LIMIT_CLEANUP_INTERVAL_MS = 60 * 1000; // Cleanup every minute\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":[]}

package/package.json

@@ -1,28 +1,37 @@
 {
   "name": "@twick/render-server",
-  "version": "0.14.20",
+  "version": "0.15.1",
   "license": "SEE LICENSE IN LICENSE.md",
-  "type": "module",
-  "main": "dist/index.js",
+  "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": "tsc",
+    "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.14.20",
-    "@twick/core": "^0.14.20",
-    "@twick/ffmpeg": "^0.14.20",
-    "@twick/renderer": "^0.14.20",
-    "@twick/ui": "^0.14.20",
-    "@twick/visualizer": "0.14.20",
+    "@twick/2d": "^0.15.1",
+    "@twick/core": "^0.15.1",
+    "@twick/ffmpeg": "^0.15.1",
+    "@twick/renderer": "^0.15.1",
+    "@twick/ui": "^0.15.1",
+    "@twick/visualizer": "^0.15.1",
     "cors": "^2.8.5",
     "express": "^4.18.2",
     "express-rate-limit": "^8.0.1",
@@ -34,10 +43,11 @@
     "@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": ">=18.0.0"
+    "node": ">=20.0.0"
   }
 }

package/package.json.bak

@@ -1,28 +1,37 @@
 {
   "name": "@twick/render-server",
-  "version": "0.14.20",
+  "version": "0.15.1",
   "license": "SEE LICENSE IN LICENSE.md",
-  "type": "module",
-  "main": "dist/index.js",
+  "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": "tsc",
+    "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.14.20",
-    "@twick/core": "^0.14.20",
-    "@twick/ffmpeg": "^0.14.20",
-    "@twick/renderer": "^0.14.20",
-    "@twick/ui": "^0.14.20",
-    "@twick/visualizer": "0.14.20",
+    "@twick/2d": "^0.15.1",
+    "@twick/core": "^0.15.1",
+    "@twick/ffmpeg": "^0.15.1",
+    "@twick/renderer": "^0.15.1",
+    "@twick/ui": "^0.15.1",
+    "@twick/visualizer": "^0.15.1",
     "cors": "^2.8.5",
     "express": "^4.18.2",
     "express-rate-limit": "^8.0.1",
@@ -34,10 +43,11 @@
     "@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": ">=18.0.0"
+    "node": ">=20.0.0"
   }
 }

package/src/server.ts

@@ -2,7 +2,7 @@ import express from "express";
 import cors from "cors";
 import path from "path";
 import { fileURLToPath } from "url";
-import renderTwickVideo from "./renderer.js";
+import renderTwickVideo from "./renderer";
 
 const PORT = process.env.PORT || 3001;
 const BASE_PATH = `http://localhost:${PORT}`;

package/src/test-render.ts

@@ -0,0 +1,228 @@
+/**
+ * Test file for rendering a video with an example project
+ * 
+ * This script demonstrates how to use the renderTwickVideo function
+ * to create a video from a Twick project configuration.
+ * 
+ * Run with: tsx src/test-render.ts
+ */
+
+import { renderTwickVideo } from "./index.js";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/**
+ * Example project configuration
+ * This creates a simple video with:
+ * - A colored background rectangle
+ * - Animated text elements
+ * - Audio track
+ */
+const exampleProject = {
+  input: {
+    properties: {
+      width: 1920,
+      height: 1080,
+      fps: 30,
+    },
+    tracks: [
+      {
+        id: "t-background",
+        type: "element",
+        name: "background",
+        elements: [
+          {
+            id: "e-bg-1",
+            trackId: "t-background",
+            type: "rect",
+            s: 0,
+            e: 10,
+            props: {
+              width: 1920,
+              height: 1080,
+              fill: "#1a1a2e",
+            },
+          },
+        ],
+      },
+      {
+        id: "t-text",
+        type: "element",
+        name: "text",
+        elements: [
+          {
+            id: "e-text-1",
+            trackId: "t-text",
+            type: "text",
+            s: 1,
+            e: 4,
+            t: "Welcome to Twick!",
+            props: {
+              fill: "#ffffff",
+              fontSize: 72,
+              fontFamily: "Arial",
+              fontWeight: "bold",
+              x: 0,
+              y: -200,
+            },
+            animation: {
+              name: "fade",
+              animate: "enter",
+              duration: 1,
+            },
+            textEffect: {
+              name: "typewriter",
+              duration: 2,
+            },
+          },
+          {
+            id: "e-text-2",
+            trackId: "t-text",
+            type: "text",
+            s: 4,
+            e: 7,
+            t: "Create Amazing Videos",
+            props: {
+              fill: "#4ecdc4",
+              fontSize: 64,
+              fontFamily: "Arial",
+              fontWeight: "bold",
+              x: 0,
+              y: 0,
+            },
+            animation: {
+              name: "rise",
+              animate: "enter",
+              duration: 1,
+            },
+          },
+          {
+            id: "e-text-3",
+            trackId: "t-text",
+            type: "text",
+            s: 7,
+            e: 10,
+            t: "Programmatically!",
+            props: {
+              fill: "#ffd700",
+              fontSize: 80,
+              fontFamily: "Arial",
+              fontWeight: "bold",
+              x: 0,
+              y: 200,
+            },
+            animation: {
+              name: "fade",
+              animate: "enter",
+              duration: 1,
+            },
+          },
+        ],
+      },
+      {
+        id: "t-shapes",
+        type: "element",
+        name: "shapes",
+        elements: [
+          {
+            id: "e-circle-1",
+            trackId: "t-shapes",
+            type: "circle",
+            s: 2,
+            e: 8,
+            props: {
+              width: 200,
+              height: 200,
+              fill: "#ff6b6b",
+              x: -400,
+              y: 0,
+            },
+            animation: {
+              name: "fade",
+              animate: "enter",
+              duration: 1,
+            },
+          },
+          {
+            id: "e-rect-1",
+            trackId: "t-shapes",
+            type: "rect",
+            s: 5,
+            e: 10,
+            props: {
+              width: 300,
+              height: 150,
+              fill: "#4ecdc4",
+              x: 400,
+              y: 0,
+            },
+            animation: {
+              name: "rise",
+              animate: "enter",
+              duration: 1,
+            },
+          },
+        ],
+      },
+    ],
+    version: 1,
+  },
+};
+
+/**
+ * Render settings
+ */
+const renderSettings = {
+  outFile: `test-video-${Date.now()}.mp4`,
+  outDir: join(__dirname, "../output"),
+  quality: "medium",
+  logProgress: true,
+};
+
+/**
+ * Main test function
+ */
+async function testVideoRender() {
+  console.log("🎬 Starting video render test...\n");
+  console.log("📋 Project Configuration:");
+  console.log(`   Resolution: ${exampleProject.input.properties.width}x${exampleProject.input.properties.height}`);
+  console.log(`   FPS: ${exampleProject.input.properties.fps}`);
+  console.log(`   Tracks: ${exampleProject.input.tracks.length}`);
+  console.log(`   Total Elements: ${exampleProject.input.tracks.reduce((sum, track) => sum + track.elements.length, 0)}\n`);
+
+  try {
+    console.log("🔄 Rendering video...");
+    const startTime = Date.now();
+
+    const outputPath = await renderTwickVideo(exampleProject, renderSettings);
+
+    const endTime = Date.now();
+    const duration = ((endTime - startTime) / 1000).toFixed(2);
+
+    console.log("\n✅ Video rendered successfully!");
+    console.log(`📁 Output file: ${outputPath}`);
+    console.log(`⏱️  Render time: ${duration}s`);
+    console.log(`\n🎉 Test completed successfully!`);
+
+    return outputPath;
+  } catch (error) {
+    console.error("\n❌ Render failed:");
+    console.error(error);
+    if (error instanceof Error) {
+      console.error(`   Error: ${error.message}`);
+      if (error.stack) {
+        console.error(`   Stack: ${error.stack}`);
+      }
+    }
+    process.exit(1);
+  }
+}
+
+// Run the test
+testVideoRender().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/tsconfig.json

@@ -1,8 +1,8 @@
 {
   "compilerOptions": {
     "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
+    "module": "Node16",
+    "moduleResolution": "Node16",
     "allowSyntheticDefaultImports": true,
     "esModuleInterop": true,
     "allowJs": true,
@@ -18,5 +18,5 @@
     "noEmit": false
   },
   "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
+  "exclude": ["node_modules", "dist", "src/**/*.test.ts", "src/test-render.ts"]
 } 

package/tsup.config.ts

@@ -0,0 +1,49 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig([
+  // Build index.ts in both CJS and ESM for library exports
+  {
+    entry: ['src/index.ts'],
+    format: ['cjs', 'esm'],
+    dts: true,
+    splitting: false,
+    sourcemap: true,
+    clean: true,
+    outDir: 'dist',
+    external: [
+      '@twick/2d',
+      '@twick/core',
+      '@twick/ffmpeg',
+      '@twick/renderer',
+      '@twick/ui',
+      '@twick/visualizer',
+      'cors',
+      'express',
+      'express-rate-limit',
+      'node-fetch',
+      'path'
+    ],
+  },
+  // Build cli.ts and server.ts only as ESM (they use import.meta)
+  {
+    entry: ['src/cli.ts', 'src/server.ts'],
+    format: ['esm'],
+    dts: false, // No need for declarations for CLI/server files
+    splitting: false,
+    sourcemap: true,
+    outDir: 'dist',
+    external: [
+      '@twick/2d',
+      '@twick/core',
+      '@twick/ffmpeg',
+      '@twick/renderer',
+      '@twick/ui',
+      '@twick/visualizer',
+      'cors',
+      'express',
+      'express-rate-limit',
+      'node-fetch',
+      'path'
+    ],
+  },
+]);

package/dist/cli.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/renderer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,gBAAgB,GAAU,WAAW,GAAG,EAAE,UAAU,GAAG,oBAiC5D,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/renderer.js

@@ -1,55 +0,0 @@
-import { renderVideo } from "@twick/renderer";
-/**
- * Renders a Twick video with the provided variables and settings.
- * Processes project variables, merges settings with defaults, and
- * generates a video file using the Twick renderer.
- *
- * @param variables - Project variables containing input configuration
- * @param settings - Optional render settings to override defaults
- * @returns Promise resolving to the path of the rendered video file
- *
- * @example
- * ```js
- * const videoPath = await renderTwickVideo(
- *   { input: { properties: { width: 1920, height: 1080 } } },
- *   { quality: "high", outFile: "my-video.mp4" }
- * );
- * // videoPath = "./output/my-video.mp4"
- * ```
- */
-const renderTwickVideo = async (variables, settings) => {
-    try {
-        const { input } = variables;
-        const { properties } = input;
-        // Merge user settings with defaults
-        const mergedSettings = {
-            logProgress: true,
-            outDir: "./output",
-            outFile: properties.reqesutId ?? `video-${Date.now()}` + ".mp4",
-            quality: "medium",
-            projectSettings: {
-                exporter: {
-                    name: "@twick/core/wasm",
-                },
-                size: {
-                    x: properties.width,
-                    y: properties.height,
-                },
-            },
-            ...settings, // Allow user settings to override defaults
-        };
-        const file = await renderVideo({
-            projectFile: "@twick/visualizer/dist/project.js",
-            variables: variables,
-            settings: mergedSettings,
-        });
-        console.log("Successfully rendered: ", file);
-        return file;
-    }
-    catch (error) {
-        console.error("Render error:", error);
-        throw error;
-    }
-};
-export default renderTwickVideo;
-//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,gBAAgB,GAAG,KAAK,EAAE,SAAc,EAAE,QAAa,EAAE,EAAE;IAC/D,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;QAC5B,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;QAC7B,oCAAoC;QACpC,MAAM,cAAc,GAAG;YACrB,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,UAAU,CAAC,SAAS,IAAI,SAAS,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,MAAM;YAC/D,OAAO,EAAE,QAAQ;YACjB,eAAe,EAAE;gBACf,QAAQ,EAAE;oBACR,IAAI,EAAE,kBAAkB;iBACzB;gBACD,IAAI,EAAE;oBACJ,CAAC,EAAE,UAAU,CAAC,KAAK;oBACnB,CAAC,EAAE,UAAU,CAAC,MAAM;iBACrB;aACF;YACD,GAAG,QAAQ,EAAE,2CAA2C;SACzD,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC;YAC7B,WAAW,EAAE,mCAAmC;YAChD,SAAS,EAAE,SAAS;YACpB,QAAQ,EAAE,cAAc;SACzB,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QACtC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/server.d.ts

@@ -1,3 +0,0 @@
-declare const nodeApp: import("express").Express;
-export default nodeApp;
-//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AA6FA,QAAA,MAAM,OAAO,EAAE,OAAO,SAAS,EAAE,OAAmB,CAAC;AAiGrD,eAAe,OAAO,CAAC"}

package/dist/server.js

@@ -1,175 +0,0 @@
-import express from "express";
-import cors from "cors";
-import path from "path";
-import { fileURLToPath } from "url";
-import renderTwickVideo from "./renderer.js";
-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
-const rateLimitStore = new Map();
-// 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, res, next) => {
-    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 nodeApp = express();
-nodeApp.use(cors());
-nodeApp.use(express.json());
-// Serve static files from output directory
-nodeApp.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: "..." }
- * ```
- */
-nodeApp.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
- * ```
- */
-nodeApp.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" }
- * ```
- */
-nodeApp.get("/health", (req, res) => {
-    res.json({
-        status: "ok",
-        timestamp: new Date().toISOString(),
-    });
-});
-// Export the app for programmatic usage
-export default nodeApp;
-// Start the server
-nodeApp.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`);
-});
-//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}