@twick/render-server 0.15.21 → 0.15.22

package/package.json

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

package/.dockerignore

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

package/Dockerfile

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

package/docker-compose.yml

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

package/package.json.bak

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

package/src/cli.ts

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

package/src/index.ts

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

package/src/renderer.ts

@@ -1,115 +0,0 @@
-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
- * 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: 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,
-      outDir: "./output",
-      outFile: properties.reqesutId ?? `video-${Date.now()}` + ".mp4",
-      quality: "medium",
-      projectSettings: {
-        exporter: {
-          name: "@twick/core/wasm-effects",
-        },
-        size: {
-          x: width,
-          y: height,
-        },
-        fps,
-      },
-      ...settings, // Allow user settings to override defaults
-    };
-
-    const result = await withRenderSlot(async () => {
-      const file = await renderVideo({
-        projectFile: "@twick/visualizer/dist/project.js",
-        variables,
-        settings: mergedSettings,
-      });
-      return file;
-    });
-
-    const elapsedMs = Date.now() - start;
-    console.log(
-      `[RenderServer] Render completed in ${elapsedMs}ms (active=${activeRenders}) ->`,
-      result,
-    );
-    return result;
-  } catch (error) {
-    const elapsedMs = Date.now() - start;
-    console.error(
-      `[RenderServer] Render error after ${elapsedMs}ms (active=${activeRenders}):`,
-      error,
-    );
-    throw error;
-  }
-};
-
-export default renderTwickVideo;

package/src/server.ts

@@ -1,202 +0,0 @@
-import express from "express";
-import cors from "cors";
-import path from "path";
-import { fileURLToPath } from "url";
-import renderTwickVideo from "./renderer";
-
-const PORT = process.env.PORT || 5000;
-const BASE_PATH = `http://localhost:${PORT}`;
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// Rate limiting configuration (all configurable via env)
-const RATE_LIMIT_WINDOW_MS =
-  parseInt(process.env.RATE_LIMIT_WINDOW_MS ?? "900000", 10) || 15 * 60 * 1000; // default 15 min (ms)
-const RATE_LIMIT_MAX_REQUESTS =
-  parseInt(process.env.RATE_LIMIT_MAX_REQUESTS ?? "100", 10) || 100; // max requests per window
-const RATE_LIMIT_CLEANUP_INTERVAL_MS =
-  parseInt(process.env.RATE_LIMIT_CLEANUP_INTERVAL_MS ?? "60000", 10) || 60 * 1000; // default 1 min (ms)
-
-// In-memory store for rate limiting
-interface RateLimitEntry {
-  count: number;
-  resetTime: number;
-}
-
-const rateLimitStore = new Map<string, RateLimitEntry>();
-
-// Cleanup expired entries periodically
-setInterval(() => {
-  const now = Date.now();
-  for (const [key, entry] of rateLimitStore.entries()) {
-    if (now > entry.resetTime) {
-      rateLimitStore.delete(key);
-    }
-  }
-}, RATE_LIMIT_CLEANUP_INTERVAL_MS);
-
-/**
- * Rate limiting middleware for API endpoints.
- * Tracks request counts per IP address and enforces rate limits
- * to prevent abuse of the render server.
- *
- * @param req - Express request object
- * @param res - Express response object
- * @param next - Express next function
- * 
- * @example
- * ```js
- * app.use('/api', rateLimitMiddleware);
- * // Applies rate limiting to all /api routes
- * ```
- */
-const rateLimitMiddleware = (req: express.Request, res: express.Response, next: express.NextFunction) => {
-  const clientIP = req.ip || req.connection.remoteAddress || 'unknown';
-  const now = Date.now();
-  
-  // Get or create rate limit entry for this IP
-  let entry = rateLimitStore.get(clientIP);
-  
-  if (!entry || now > entry.resetTime) {
-    // New window or expired entry
-    entry = {
-      count: 1,
-      resetTime: now + RATE_LIMIT_WINDOW_MS
-    };
-    rateLimitStore.set(clientIP, entry);
-  } else {
-    // Increment count in current window
-    entry.count++;
-    
-    if (entry.count > RATE_LIMIT_MAX_REQUESTS) {
-      // Rate limit exceeded
-      const retryAfter = Math.ceil((entry.resetTime - now) / 1000);
-      res.set('Retry-After', retryAfter.toString());
-      res.set('X-RateLimit-Limit', RATE_LIMIT_MAX_REQUESTS.toString());
-      res.set('X-RateLimit-Remaining', '0');
-      res.set('X-RateLimit-Reset', new Date(entry.resetTime).toISOString());
-      
-      return res.status(429).json({
-        success: false,
-        error: 'Too many requests',
-        message: `Rate limit exceeded. Try again in ${retryAfter} seconds.`,
-        retryAfter
-      });
-    }
-  }
-  
-  // Add rate limit headers
-  res.set('X-RateLimit-Limit', RATE_LIMIT_MAX_REQUESTS.toString());
-  res.set('X-RateLimit-Remaining', (RATE_LIMIT_MAX_REQUESTS - entry.count).toString());
-  res.set('X-RateLimit-Reset', new Date(entry.resetTime).toISOString());
-  
-  next();
-};
-
-const 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")));
-
-/**
- * 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`);
-});

package/src/test-render.ts

@@ -1,159 +0,0 @@
-/**
- * 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: 720,
-      height: 1280,
-      fps: 30,
-    },
-      "tracks": [
-          {
-              "id": "t-sample",
-              "name": "sample",
-              "type": "element",
-              "props": {},
-              "elements": [
-                  {
-                      "id": "e-sample",
-                      "trackId": "t-sample",
-                      "type": "text",
-                      "name": "sample",
-                      "s": 0,
-                      "e": 5,
-                      "props": {
-                          "text": "Twick SDK",
-                          "fill": "#FFFFFF"
-                      }
-                  }
-              ]
-          },
-          {
-              "id": "t-948a8e683ebb",
-              "name": "Track_1772121198607",
-              "type": "element",
-              "props": {},
-              "elements": [
-                  {
-                      "id": "e-cc0401034d3e",
-                      "trackId": "t-948a8e683ebb",
-                      "type": "image",
-                      "s": 0,
-                      "e": 3,
-                      "props": {
-                          "src": "https://images.pexels.com/photos/358457/pexels-photo-358457.jpeg",
-                          "mediaFilter": "none"
-                      },
-                      "frame": {
-                          "size": [
-                              720,
-                              1080.2700675168792
-                          ],
-                          "x": 0,
-                          "y": 0
-                      },
-                      "frameEffects": [],
-                      "objectFit": "cover"
-                  }
-              ]
-          },
-          {
-              "id": "t-85e232b36bd0",
-              "name": "Track_1772121202675",
-              "type": "element",
-              "props": {},
-              "elements": [
-                  {
-                      "id": "e-b262ef2b4ff1",
-                      "trackId": "t-85e232b36bd0",
-                      "type": "effect",
-                      "s": 0,
-                      "e": 1,
-                      "props": {
-                          "effectKey": "vignette",
-                          "intensity": 1
-                      }
-                  }
-              ]
-          }
-      ],
-      "version": 6,
-      "metadata": {}
-  },
-};
-
-/**
- * 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/test.js

@@ -1,163 +0,0 @@
-// 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

@@ -1,22 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "Node16",
-    "moduleResolution": "Node16",
-    "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", "src/**/*.test.ts", "src/test-render.ts"]
-} 

package/tsup.config.ts

@@ -1,49 +0,0 @@
-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'
-    ],
-  },
-]);