@twick/cloud-export-video 0.14.14 → 0.14.16

package/README.md

@@ -37,8 +37,86 @@ npx twick-export-video ecr-login us-east-1 123456789012
 npx twick-export-video push twick-export-video:latest us-east-1 123456789012
 ```
 
-### AWS Lambda (container) notes
+### AWS Lambda (container) usage
 
+This package ships with an AWS Lambda container template (Dockerfile + handler).
+
+#### Build image
+
+In the `packages/cloud-functions/export-video` directory:
+
+```bash
+docker buildx build --platform linux/amd64 -t twick-export-video:latest -f platform/aws/Dockerfile .
+```
+
+#### Push image to AWS ECR
+
+To deploy the container image to AWS Elastic Container Registry (ECR) for use with Lambda:
+
+**Prerequisites:**
+- AWS CLI configured with appropriate credentials
+- Docker installed and running
+
+**Steps:**
+
+1. **Get your AWS Account ID:**
+   ```bash
+   AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
+   ```
+
+2. **Set your AWS region and repository name:**
+   ```bash
+   AWS_REGION="your-aws-region"  # e.g., ap-south-1, us-east-1
+   REPOSITORY_NAME="twick-export-video"
+   ```
+
+3. **Login to ECR:**
+   ```bash
+   aws ecr get-login-password --region $AWS_REGION | docker login --username AWS --password-stdin $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com
+   ```
+
+4. **Create ECR repository (if it doesn't exist):**
+   ```bash
+   aws ecr create-repository \
+     --repository-name $REPOSITORY_NAME \
+     --image-scanning-configuration scanOnPush=true \
+     --region $AWS_REGION
+   ```
+
+5. **Tag the image:**
+   ```bash
+   docker tag twick-export-video:latest $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/$REPOSITORY_NAME:latest
+   ```
+
+6. **Push the image:**
+   ```bash
+   docker push $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/$REPOSITORY_NAME:latest
+   ```
+
+**Complete example script:**
+```bash
+#!/bin/bash
+AWS_REGION="ap-south-1"
+REPOSITORY_NAME="twick-export-video"
+AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
+
+# Build the image
+docker buildx build --platform linux/amd64 -t twick-export-video:latest -f platform/aws/Dockerfile .
+
+# Login to ECR
+aws ecr get-login-password --region $AWS_REGION | docker login --username AWS --password-stdin $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com
+
+# Create repository if it doesn't exist
+aws ecr create-repository --repository-name $REPOSITORY_NAME --image-scanning-configuration scanOnPush=true --region $AWS_REGION 2>/dev/null || true
+
+# Tag and push
+docker tag twick-export-video:latest $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/$REPOSITORY_NAME:latest
+docker push $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/$REPOSITORY_NAME:latest
+```
+
+After pushing, you can use the ECR image URI (`$AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/$REPOSITORY_NAME:latest`) when creating or updating your Lambda function.
+
+**Notes:**
 - The Dockerfile is based on `revideo/aws-lambda-base-image` and prepares Chromium and ffmpeg for headless rendering.
 - The handler expects an `event.arguments.input` payload with `{ project, mediaFiles? }`.
 - The response is a `video/mp4` base64 body, or a text file on error.

package/core/renderer.js

@@ -71,4 +71,4 @@ const renderTwickVideo = async (variables, settings) => {
   }
 };
 
-export default renderTwickVideo;
+export { renderTwickVideo };

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@twick/cloud-export-video",
-  "version": "0.14.14",
+  "version": "0.14.16",
   "description": "Twick cloud function for exporting video with platform-specific templates (AWS Lambda container)",
   "type": "module",
   "main": "core/renderer.js",
   "exports": {
     ".": "./core/renderer.js",
     "./aws": "./platform/aws/handler.js",
+    "./aws/cjs": "./platform/aws/handler.cjs",
     "./platform/aws/*": "./platform/aws/*"
   },
   "bin": {
@@ -43,13 +44,13 @@
   },
   "dependencies": {
     "@sparticuz/chromium": "^129.0.0",
-    "@twick/2d": "0.14.14",
-    "@twick/core": "0.14.14",
-    "@twick/ffmpeg": "0.14.14",
-    "@twick/renderer": "0.14.14",
-    "@twick/ui": "0.14.14",
-    "@twick/vite-plugin": "0.14.14",
-    "@twick/visualizer": "0.14.14",
+    "@twick/2d": "0.14.16",
+    "@twick/core": "0.14.16",
+    "@twick/ffmpeg": "0.14.16",
+    "@twick/renderer": "0.14.16",
+    "@twick/ui": "0.14.16",
+    "@twick/vite-plugin": "0.14.16",
+    "@twick/visualizer": "0.14.16",
     "@aws-sdk/client-s3": "^3.620.0",
     "ffmpeg-static": "^5.2.0",
     "fluent-ffmpeg": "^2.1.3"

package/platform/aws/Dockerfile

@@ -33,4 +33,4 @@ ENV HOME=/tmp
 
 ENV DONT_WRITE_TO_META_FILES=true
 
-CMD ["platform/aws/handler.handler"]
+CMD ["handler.handler"]

package/platform/aws/handler.js

@@ -1,5 +1,5 @@
 import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3';
-import renderTwickVideo from '../../core/renderer.js';
+import { renderTwickVideo } from '@twick/cloud-export-video';
 
 const s3Client = new S3Client({
   region: process.env.EXPORT_VIDEO_S3_REGION || process.env.AWS_REGION || 'us-east-1',
@@ -107,11 +107,25 @@ const buildPublicUrl = ({ bucket, key, region, baseUrl }) => {
  * Returns: JSON payload containing the uploaded video URL and metadata
  */
 
-export const handler = async (event) => {
+const handler = async (event) => {
   console.log('Video processor function invoked');
   console.log('Event:', JSON.stringify(event));
   const projectData = event.arguments || {};
   
+  if(!renderTwickVideo) {
+    return {
+      statusCode: 500,
+      headers: {
+        'Content-Type': 'application/json',
+        'Access-Control-Allow-Origin': '*',
+      },
+      body: JSON.stringify({
+        error: 'Failed to load renderTwickVideo',
+        message: 'Failed to load renderTwickVideo',
+      }),
+    };
+  }
+  
   try {
     // Validate required fields
     if (!projectData) {
@@ -293,3 +307,5 @@ ${mediaFiles.map((file, index) => `  ${index + 1}. ${file.filename} (${file.data
     };
   }
 };
+
+module.exports.handler = handler;