@twick/render-server 0.14.2

package/README.md

@@ -0,0 +1,116 @@
+# @twick/render-server
+
+A simple Node.js server for rendering videos using Twick.
+
+## Installation
+
+```bash
+pnpm install @twick/render-server
+```
+
+## Usage
+
+### Starting the server
+
+```bash
+# Development mode
+pnpm run dev
+
+# Production mode
+pnpm run build
+pnpm start
+```
+
+The server will start on port 3001 by default. You can change this by setting the `PORT` environment variable.
+
+### API Endpoints
+
+#### POST /api/render-video
+
+Renders a video using Twick.
+
+**Request Body:**
+```json
+{
+  "variables":  {
+    "input": {
+      "properties": {
+        "width": 720,
+        "height": 1280
+      },
+      "tracks": [
+        {
+          "id": "t-track-1",
+          "type": "element",
+          "elements": [
+            {
+              "id": "e-244f8d5a3baa",
+              "trackId": "t-track-1",
+              "type": "rect",
+              "s": 0,
+              "e": 5,
+              "props": {
+                "width": 720,
+                "height": 1280,
+                "fill": "#fff000"
+              }
+            }
+          ],
+          "name": "element"
+        }
+      ]
+    }
+  },
+  "settings": {
+    "outFile": "my-video.mp4",
+  }
+}
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "downloadUrl": "http://localhost:3001/download/output/my-video.mp4"
+}
+```
+
+#### GET /download/:outFile
+
+Downloads a rendered video file.
+
+#### GET /health
+
+Health check endpoint.
+
+## Configuration
+
+The server uses the following environment variables:
+
+- `PORT`: Server port (default: 3001)
+- `NODE_ENV`: Environment (development/production)
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Start development server
+pnpm run dev
+
+# Build for production
+pnpm run build
+
+# Start production server
+pnpm start
+
+# Test
+node test.js
+```
+
+> **Note:** This server will work on Linux and macOS only. Windows is not supported.
+
+## License
+
+Apache-2.0 

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default as renderTwickVideo } from "./renderer";
+export { default as createServer } from "./server";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,5 @@
+// Export the renderer function
+export { default as renderTwickVideo } from "./renderer";
+// Re-export the server for programmatic usage
+export { default as createServer } from "./server";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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;AAEzD,8CAA8C;AAC9C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/renderer.d.ts

@@ -0,0 +1,3 @@
+declare const renderTwickVideo: (variables: any, settings: any) => Promise<string>;
+export default renderTwickVideo;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

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

package/dist/renderer.js

@@ -0,0 +1,37 @@
+import { renderVideo } from "@twick/renderer";
+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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,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

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

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -0,0 +1,121 @@
+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
+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")));
+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",
+        });
+    }
+});
+// Apply rate limiting to download endpoint
+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
+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

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@twick/render-server",
+  "version": "0.14.2",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/server.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/server.ts",
+    "start": "node dist/server.js",
+    "clean": "rimraf dist"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@twick/2d": "0.14.2",
+    "@twick/core": "0.14.2",
+    "@twick/ffmpeg": "0.14.2",
+    "@twick/renderer": "0.14.2",
+    "@twick/ui": "0.14.2",
+    "@twick/visualizer": "0.14.2",
+    "@types/express-rate-limit": "^6.0.2",
+    "cors": "^2.8.5",
+    "express": "^4.18.2",
+    "express-rate-limit": "^8.0.1",
+    "node-fetch": "^3.3.2",
+    "path": "^0.12.7"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.10.0",
+    "rimraf": "^5.0.5",
+    "tsx": "^4.7.0",
+    "typescript": "5.4.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/package.json.bak

@@ -0,0 +1,41 @@
+{
+  "name": "@twick/render-server",
+  "version": "0.14.2",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/server.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/server.ts",
+    "start": "node dist/server.js",
+    "clean": "rimraf dist"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@twick/2d": "0.14.2",
+    "@twick/core": "0.14.2",
+    "@twick/ffmpeg": "0.14.2",
+    "@twick/renderer": "0.14.2",
+    "@twick/ui": "0.14.2",
+    "@twick/visualizer": "0.14.2",
+    "@types/express-rate-limit": "^6.0.2",
+    "cors": "^2.8.5",
+    "express": "^4.18.2",
+    "express-rate-limit": "^8.0.1",
+    "node-fetch": "^3.3.2",
+    "path": "^0.12.7"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.10.0",
+    "rimraf": "^5.0.5",
+    "tsx": "^4.7.0",
+    "typescript": "5.4.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+// Export the renderer function
+export { default as renderTwickVideo } from "./renderer";
+
+// Re-export the server for programmatic usage
+export { default as createServer } from "./server";

package/src/renderer.ts

@@ -0,0 +1,38 @@
+import { renderVideo } from "@twick/renderer";
+
+const renderTwickVideo = async (variables: any, settings: any) => {
+  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;

package/src/server.ts

@@ -0,0 +1,145 @@
+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
+
+// In-memory store for rate limiting
+interface RateLimitEntry {
+  count: number;
+  resetTime: number;
+}
+
+const rateLimitStore = new Map<string, RateLimitEntry>();
+
+// Cleanup expired entries periodically
+setInterval(() => {
+  const now = Date.now();
+  for (const [key, entry] of rateLimitStore.entries()) {
+    if (now > entry.resetTime) {
+      rateLimitStore.delete(key);
+    }
+  }
+}, RATE_LIMIT_CLEANUP_INTERVAL_MS);
+
+// Rate limiting middleware
+const rateLimitMiddleware = (req: express.Request, res: express.Response, next: express.NextFunction) => {
+  const clientIP = req.ip || req.connection.remoteAddress || 'unknown';
+  const now = Date.now();
+  
+  // Get or create rate limit entry for this IP
+  let entry = rateLimitStore.get(clientIP);
+  
+  if (!entry || now > entry.resetTime) {
+    // New window or expired entry
+    entry = {
+      count: 1,
+      resetTime: now + RATE_LIMIT_WINDOW_MS
+    };
+    rateLimitStore.set(clientIP, entry);
+  } else {
+    // Increment count in current window
+    entry.count++;
+    
+    if (entry.count > RATE_LIMIT_MAX_REQUESTS) {
+      // Rate limit exceeded
+      const retryAfter = Math.ceil((entry.resetTime - now) / 1000);
+      res.set('Retry-After', retryAfter.toString());
+      res.set('X-RateLimit-Limit', RATE_LIMIT_MAX_REQUESTS.toString());
+      res.set('X-RateLimit-Remaining', '0');
+      res.set('X-RateLimit-Reset', new Date(entry.resetTime).toISOString());
+      
+      return res.status(429).json({
+        success: false,
+        error: 'Too many requests',
+        message: `Rate limit exceeded. Try again in ${retryAfter} seconds.`,
+        retryAfter
+      });
+    }
+  }
+  
+  // Add rate limit headers
+  res.set('X-RateLimit-Limit', RATE_LIMIT_MAX_REQUESTS.toString());
+  res.set('X-RateLimit-Remaining', (RATE_LIMIT_MAX_REQUESTS - entry.count).toString());
+  res.set('X-RateLimit-Reset', new Date(entry.resetTime).toISOString());
+  
+  next();
+};
+
+const nodeApp: import("express").Express = express();
+
+nodeApp.use(cors());
+nodeApp.use(express.json());
+
+// Serve static files from output directory
+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 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",
+    });
+  }
+});
+
+// Apply rate limiting to download endpoint
+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
+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`);
+});

package/test.js

@@ -0,0 +1,163 @@
+// Simple test script for the render server
+import fetch from 'node-fetch';
+
+const API_URL = 'http://localhost:3001';
+
+const sample = {
+    "input": {
+      "properties": {
+        "width": 720,
+        "height": 1280
+      },
+      "tracks": [
+        {
+          "id": "t-track-1",
+          "type": "element",
+          "elements": [
+            {
+              "id": "e-244f8d5a3baa",
+              "trackId": "t-track-1",
+              "type": "rect",
+              "s": 0,
+              "e": 5,
+              "props": {
+                "width": 720,
+                "height": 1280,
+                "fill": "#fff000"
+              }
+            }
+          ],
+          "name": "element"
+        },
+        {
+          "id": "t-track-2",
+          "type": "element",
+          "elements": [
+            {
+              "id": "e-244f8d5a3bba",
+              "trackId": "t-track-2",
+              "type": "text",
+              "s": 0,
+              "e": 1,
+              "props": {
+                "text": "Hello Guys!",
+                "fontSize": 100,
+                "fill": "#FF0000"
+              }
+            },
+            {
+              "id": "e-244f8d5a3bbb",
+              "trackId": "t-track-2",
+              "type": "text",
+              "s": 1,
+              "e": 4,
+              "props": {
+                "text": "Welcome to the world of Twick!",
+                "fontSize": 100,
+                "fill": "#FF0000",
+                "maxWidth": 500,
+                "textAlign": "center",
+                "textWrap": true
+              }
+            },
+            {
+              "id": "e-244f8d5a3bbc",
+              "trackId": "t-track-2",
+              "type": "text",
+              "s": 4,
+              "e": 5,
+              "props": {
+                "text": "Thank You !",
+                "fontSize": 100,
+                "fill": "#FF0000"
+              }
+            }
+          ],
+          "name": "element"
+        },
+        {
+          "id": "t-track-3",
+          "type": "element",
+          "elements": [
+            {
+              "id": "e-244f8d5aabaa",
+              "trackId": "t-track-3",
+              "type": "audio",
+              "s": 0,
+              "e": 5,
+              "props": {
+                "src": "https://cdn.pixabay.com/audio/2024/09/15/audio_e00d39651a.mp3",
+                "play": true,
+                "volume": 1
+              }
+            }
+          ],
+          "name": "audio"
+        }
+      ],
+      "version": 1
+    }
+  }
+
+
+async function testHealth() {
+  try {
+    const response = await fetch(`${API_URL}/health`);
+    const result = await response.json();
+    console.log('✅ Health check passed:', result);
+    return true;
+  } catch (error) {
+    console.error('❌ Health check failed:', error.message);
+    return false;
+  }
+}
+
+async function testRender() {
+  try {
+    console.log('🔄 Testing video render...');
+    
+    const response = await fetch(`${API_URL}/api/render-video`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        variables: sample,
+        settings: {
+          outFile: `test-${Date.now()}.mp4`,          
+        }
+      })
+    });
+
+    const result = await response.json();
+    
+    if (result.success) {
+      console.log('✅ Render test passed!');
+      console.log('📁 Output:', result.downloadUrl);
+      return true;
+    } else {
+      console.error('❌ Render test failed:', result.error);
+      return false;
+    }
+  } catch (error) {
+    console.error('❌ Render test failed:', error.message);
+    return false;
+  }
+}
+
+async function runTests() {
+  console.log('🧪 Running render server tests...\n');
+  
+  const healthPassed = await testHealth();
+  console.log('');
+  
+  if (healthPassed) {
+    await testRender();
+  } else {
+    console.log('❌ Skipping render test due to health check failure');
+  }
+  
+  console.log('\n🏁 Tests completed');
+}
+
+runTests().catch(console.error); 

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "allowJs": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "noEmit": false
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}