n8n-nodes-tornado-api 1.0.1 → 1.1.0

package/README.md

@@ -2,6 +2,15 @@
 
 Download YouTube videos & Spotify podcasts directly in your n8n workflows.
 
+## What's New in v1.1.0
+
+- **🎬 Video Clipping**: Extract segments with `clip_start` and `clip_end` timestamps
+- **📺 Live Stream Recording**: Record live streams with `live_recording`, `live_from_start`, `max_duration`
+- **📊 Resolution Selection**: Limit quality with `max_resolution` (4K, 1080p, 720p, etc.)
+- **📈 Dashboard Resource**: New operations for stats, daily metrics, cluster activity, billing
+- **🔔 Enhanced Webhook Trigger**: New events (`batch_completed`, `progress`) and `job_id` filter
+- **⚡ Progress Webhooks**: Get real-time updates during download/mux/upload stages
+
 ## Installation
 
 ### Via npm (recommended)
@@ -47,6 +56,18 @@ Creates a download job. Returns immediately with a `job_id`.
 | Filename | string | ❌ | Custom filename |
 | Folder | string | ❌ | S3 folder prefix |
 | Webhook URL | string | ❌ | Notification URL |
+| Audio Only | boolean | ❌ | Extract audio only |
+| Download Subtitles | boolean | ❌ | Download subtitles |
+| Download Thumbnail | boolean | ❌ | Download thumbnail |
+| Quality Preset | select | ❌ | highest, high, medium, low, lowest |
+| Max Resolution | select | ❌ | best, 2160, 1440, 1080, 720, 480, 360 |
+| Clip Start | string | ❌ | Start timestamp (HH:MM:SS or seconds) |
+| Clip End | string | ❌ | End timestamp (HH:MM:SS or seconds) |
+| Live Recording | boolean | ❌ | Enable live stream mode |
+| Live From Start | boolean | ❌ | Record from stream beginning |
+| Max Duration | number | ❌ | Max recording duration (seconds) |
+| Wait for Video | boolean | ❌ | Wait for scheduled streams |
+| Enable Progress Webhook | boolean | ❌ | Receive progress updates |
 
 **Output (YouTube):**
 ```json
@@ -89,18 +110,91 @@ Check the current status of a job.
 
 ---
 
-### Job → Wait for Completion
+### Dashboard Operations (NEW in v1.1.0)
 
-Polls until the job is complete or fails. **Best for simple workflows.**
+Monitor your Tornado API usage directly from n8n.
 
-**Input:**
-| Field | Type | Default | Description |
-|-------|------|---------|-------------|
-| Job ID | string | - | The job UUID |
-| Timeout | number | 600 | Max wait time (seconds) |
-| Poll Interval | number | 5 | Time between checks (seconds) |
+#### Dashboard → Get Stats
+Get aggregated statistics for your API key.
+
+**Output:**
+```json
+{
+  "total_jobs": 1523,
+  "pending_jobs": 5,
+  "processing_jobs": 12,
+  "completed_jobs": 1450,
+  "failed_jobs": 56,
+  "storage_used_gb": 50.0,
+  "avg_processing_time_seconds": 45.2
+}
+```
+
+#### Dashboard → Get Daily Stats
+Get job statistics for the last 7 days.
+
+**Output:**
+```json
+{
+  "daily_stats": [
+    { "date": "2024-01-08", "completed": 45, "failed": 2 },
+    { "date": "2024-01-09", "completed": 62, "failed": 5 }
+  ]
+}
+```
+
+#### Dashboard → Get Cluster Stats
+Get real-time cluster activity.
+
+**Output:**
+```json
+{
+  "total_downloading": 45,
+  "total_muxing": 12,
+  "total_uploading": 8
+}
+```
+
+#### Dashboard → Get Billing
+Get Stripe billing information.
+
+**Output:**
+```json
+{
+  "billing_enabled": true,
+  "total_usage_gb": 45.67,
+  "period_start_formatted": "Jan 01, 2024",
+  "period_end_formatted": "Feb 01, 2024"
+}
+```
+
+---
+
+## 🔔 Webhook Trigger (NEW events in v1.1.0)
 
-**Output:** Same as Get Status (when completed)
+Listen for Tornado events in real-time.
+
+| Event | Description |
+|-------|-------------|
+| Job Completed | When a job finishes successfully |
+| Job Failed | When a job fails |
+| Batch Completed | When all episodes in a batch are done |
+| Progress Update | Real-time progress (downloading, muxing, uploading) |
+| Any Event | Trigger on all events |
+
+**Filter Options:**
+- Filter by Job ID
+- Filter by Batch ID
+
+**Example Progress Webhook Payload:**
+```json
+{
+  "type": "progress",
+  "job_id": "550e8400-...",
+  "stage": "muxing",
+  "progress_percent": 33
+}
+```
 
 ---
 
@@ -156,16 +250,18 @@ Google Drive node:
 
 ## 🔄 Workflow Examples
 
-### Example 1: Simple YouTube Download
+### Example 1: Simple YouTube Download with Polling
+
+Use n8n's **Wait** and **IF** nodes to poll for job completion:
 
 ```
-┌─────────────┐    ┌─────────────┐    ┌─────────────┐
-│   Trigger   │ →  │ Tornado API │ →  │ Tornado API │
-│  (Manual)   │    │ Job:Create  │    │ Job:Wait    │
-└─────────────┘    └─────────────┘    └─────────────┘
-                         │                   │
-                         ▼                   ▼
-                   { job_id: ... }    { s3_url: ... }
+┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
+│   Trigger   │ →  │ Tornado API │ →  │    Wait     │ →  │ Tornado API │ →  │     IF      │
+│  (Manual)   │    │ Job:Create  │    │  (5 sec)    │    │ Job:Status  │    │ Completed?  │
+└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
+                         │                                      ▲                  │
+                         ▼                                      │                  ▼
+                   { job_id: ... }                         Loop back         { s3_url: ... }
 ```
 
 **Node 1 - Tornado API (Create):**
@@ -173,25 +269,33 @@ Google Drive node:
 - Operation: Create
 - URL: `https://youtube.com/watch?v=dQw4w9WgXcQ`
 
-**Node 2 - Tornado API (Wait):**
+**Node 2 - Wait:**
+- Wait Time: 5 seconds
+
+**Node 3 - Tornado API (Get Status):**
 - Resource: Job
-- Operation: Wait for Completion
-- Job ID: `{{ $json.job_id }}`
+- Operation: Get Status
+- Job ID: `{{ $('Tornado API').item.json.job_id }}`
+
+**Node 4 - IF:**
+- Condition: `{{ $json.status }}` equals `Completed`
+- True: Continue to next step
+- False: Loop back to Wait node
 
 ---
 
 ### Example 2: Download + Send to Telegram
 
 ```
-┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
-│  Telegram   │ →  │ Tornado API │ →  │ Tornado API │ →  │  Telegram   │
-│  Trigger    │    │ Job:Create  │    │ Job:Wait    │    │ Send Video  │
-└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
+┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
+│  Telegram   │ →  │ Tornado API │ →  │    Wait     │ →  │ Tornado API │ →  │  Telegram   │
+│  Trigger    │    │ Job:Create  │    │  + Loop     │    │ Job:Status  │    │ Send Video  │
+└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
 ```
 
 **Telegram Trigger:** Receives YouTube URL from user
 **Tornado Create:** URL = `{{ $json.message.text }}`
-**Tornado Wait:** Job ID = `{{ $json.job_id }}`
+**Wait + Loop:** Poll every 5 seconds until status = Completed
 **Telegram Send:** Video URL = `{{ $json.s3_url }}`
 
 ---
@@ -201,12 +305,12 @@ Google Drive node:
 ```
 ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
 │   Trigger   │ →  │ Tornado API │ →  │  Split In   │ →  │ Tornado API │
-│             │    │ Job:Create  │    │   Batches   │    │ Job:Wait    │
+│             │    │ Job:Create  │    │   Batches   │    │ Job:Status  │
 └─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
-                         │
-                         ▼
-                   { batch_id: ...,
-                     episode_jobs: [...] }
+                         │                                      │
+                         ▼                                      ▼
+                   { batch_id: ...,                    (with Wait + Loop
+                     episode_jobs: [...] }              for each job)
 ```
 
 **Tornado Create:**
@@ -217,8 +321,9 @@ Google Drive node:
 - Input: `{{ $json.episode_jobs }}`
 - Batch Size: 10
 
-**Tornado Wait (for each):**
+**Tornado Get Status (with Wait + Loop):**
 - Job ID: `{{ $json }}`
+- Loop until status = Completed
 
 ---
 
@@ -228,8 +333,8 @@ Use your own S3 bucket (AWS, Cloudflare R2, MinIO):
 
 ```
 ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
-│   Manual    │ →  │ Tornado API │ →  │ Tornado API │ →  │ Tornado API │
-│   Trigger   │    │ Storage:    │    │ Job:Create  │    │ Job:Wait    │
+│   Manual    │ →  │ Tornado API │ →  │ Tornado API │ →  │    Wait     │
+│   Trigger   │    │ Storage:    │    │ Job:Create  │    │  + Loop     │
 │             │    │ Configure   │    │             │    │             │
 └─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
                          │                                      │
@@ -253,12 +358,10 @@ Use your own S3 bucket (AWS, Cloudflare R2, MinIO):
 - Operation: Create
 - URL: `https://youtube.com/watch?v=...`
 
-**Node 3 - Tornado API (Wait):**
-- Resource: Job
-- Operation: Wait for Completion
-- Job ID: `{{ $json.job_id }}`
+**Node 3 - Wait + Loop:**
+- Use n8n Wait node (5 seconds) + Get Status + IF node to poll until completed
 
-**Output:**
+**Output (when completed):**
 ```json
 {
   "status": "Completed",