@wave-av/cli 1.0.0

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@wave-av/cli",
+  "version": "1.0.0",
+  "description": "WAVE CLI - Command-line interface for the WAVE streaming platform",
+  "main": "./dist/index.js",
+  "type": "module",
+  "bin": {
+    "wave": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "wave",
+    "cli",
+    "streaming",
+    "video",
+    "broadcast",
+    "production"
+  ],
+  "author": "WAVE Inc. <cli@wave.online>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wave-av/wave-surfer-connect.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://docs.wave.online/cli",
+  "bugs": {
+    "url": "https://github.com/wave-av/wave-surfer-connect/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@wave-av/sdk": "workspace:*",
+    "chalk": "^5.4.1",
+    "cli-table3": "^0.6.5",
+    "commander": "^13.1.0",
+    "conf": "^13.1.0",
+    "inquirer": "^12.3.2",
+    "keytar": "^7.9.0",
+    "open": "^10.1.0",
+    "ora": "^8.2.0",
+    "ws": "^8.18.0",
+    "yaml": "^2.7.0",
+    "zod": "3.25.76"
+  },
+  "devDependencies": {
+    "@sentry/node": "^9.4.0",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^22.13.0",
+    "@types/ws": "^8.5.14",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  }
+}

package/templates/api-integration/.env.example

@@ -0,0 +1,2 @@
+WAVE_API_KEY=wave_live_your_api_key_here
+WAVE_ORG_ID=your_org_id_here

package/templates/api-integration/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "wave-api-integration",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npx tsx src/index.ts",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@wave/sdk": "^2.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.9.0"
+  }
+}

package/templates/api-integration/src/index.ts

@@ -0,0 +1,24 @@
+import { Wave } from "@wave/sdk";
+
+const wave = new Wave({
+  apiKey: process.env.WAVE_API_KEY!,
+});
+
+async function main() {
+  // List your streams
+  const streams = await wave.pipeline.list({ limit: 10 });
+  console.log(`Found ${streams.data.length} streams\n`);
+
+  for (const stream of streams.data) {
+    console.log(`  ${stream.id} - ${stream.title} (${stream.status})`);
+  }
+
+  // Get organization usage
+  const usage = await wave.billing.getUsage();
+  console.log(`\nCurrent usage:`);
+  console.log(`  Streams: ${usage.streams_count}`);
+  console.log(`  Storage: ${usage.storage_gb}GB`);
+  console.log(`  Bandwidth: ${usage.bandwidth_gb}GB`);
+}
+
+main().catch(console.error);

package/templates/blank/.env.example

@@ -0,0 +1 @@
+WAVE_API_KEY=wave_live_your_api_key_here

package/templates/blank/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "wave-project",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npx tsx src/index.ts",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@wave/sdk": "^2.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.9.0"
+  }
+}

package/templates/blank/src/index.ts

@@ -0,0 +1,16 @@
+import { Wave } from "@wave/sdk";
+
+const wave = new Wave({
+  apiKey: process.env.WAVE_API_KEY!,
+});
+
+async function main() {
+  const streams = await wave.pipeline.list();
+  console.log(`Found ${streams.data.length} streams`);
+
+  for (const stream of streams.data) {
+    console.log(`- ${stream.title} (${stream.status})`);
+  }
+}
+
+main().catch(console.error);

package/templates/multi-camera/.env.example

@@ -0,0 +1 @@
+WAVE_API_KEY=wave_live_your_api_key_here

package/templates/multi-camera/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "wave-multi-camera",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npx tsx src/index.ts",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@wave/sdk": "^2.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.9.0"
+  }
+}

package/templates/multi-camera/src/index.ts

@@ -0,0 +1,49 @@
+import { Wave } from "@wave/sdk";
+
+const wave = new Wave({
+  apiKey: process.env.WAVE_API_KEY!,
+});
+
+async function main() {
+  // Create a multi-camera production session
+  const production = await wave.studio.create({
+    title: "Multi-Camera Production",
+    description: "Multi-source production demo",
+  });
+
+  console.log(`Production created: ${production.id}`);
+
+  // Add camera sources
+  const cam1 = await wave.studio.addSource(production.id, {
+    type: "camera",
+    label: "Camera 1 - Wide",
+    url: "rtmp://localhost/live/cam1",
+  });
+
+  const cam2 = await wave.studio.addSource(production.id, {
+    type: "camera",
+    label: "Camera 2 - Close-up",
+    url: "rtmp://localhost/live/cam2",
+  });
+
+  console.log(`Sources added: ${cam1.id}, ${cam2.id}`);
+
+  // Create scenes
+  const fullscreen = await wave.studio.createScene(production.id, {
+    name: "Fullscreen",
+    layout: "single",
+  });
+
+  const sideBySide = await wave.studio.createScene(production.id, {
+    name: "Side by Side",
+    layout: "split",
+  });
+
+  console.log(`Scenes created: ${fullscreen.id}, ${sideBySide.id}`);
+
+  // Start production
+  await wave.studio.start(production.id);
+  console.log("Production started!");
+}
+
+main().catch(console.error);

package/templates/podcast/.env.example

@@ -0,0 +1 @@
+WAVE_API_KEY=wave_live_your_api_key_here

package/templates/podcast/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "wave-podcast",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npx tsx src/index.ts",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@wave/sdk": "^2.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.9.0"
+  }
+}

package/templates/podcast/src/index.ts

@@ -0,0 +1,33 @@
+import { Wave } from "@wave/sdk";
+
+const wave = new Wave({
+  apiKey: process.env.WAVE_API_KEY!,
+});
+
+async function main() {
+  // Create a podcast episode recording
+  const stream = await wave.pipeline.create({
+    title: "Podcast Episode Recording",
+    protocol: "webrtc",
+    description: "Audio-focused recording session",
+  });
+
+  console.log(`Recording session created: ${stream.id}`);
+
+  // Start recording
+  await wave.pipeline.start(stream.id);
+  const recording = await wave.pipeline.startRecording(stream.id);
+  console.log(`Recording started: ${recording.id}`);
+
+  // After recording, generate transcription
+  console.log("Generating transcription...");
+  const transcription = await wave.transcribe.create({
+    recording_id: recording.id,
+    language: "en",
+    model: "enhanced",
+  });
+
+  console.log(`Transcription: ${transcription.id} (${transcription.status})`);
+}
+
+main().catch(console.error);

package/templates/srt-contribution/.env.example

@@ -0,0 +1 @@
+WAVE_API_KEY=wave_live_your_api_key_here

package/templates/srt-contribution/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "wave-srt-contribution",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npx tsx src/index.ts",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@wave/sdk": "^2.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.9.0"
+  }
+}

package/templates/srt-contribution/src/index.ts

@@ -0,0 +1,29 @@
+import { Wave } from "@wave/sdk";
+
+const wave = new Wave({
+  apiKey: process.env.WAVE_API_KEY!,
+});
+
+async function main() {
+  // Create an SRT contribution stream (low-latency ingest)
+  const stream = await wave.pipeline.create({
+    title: "SRT Contribution Feed",
+    protocol: "srt",
+    description: "Low-latency SRT ingest for remote contribution",
+  });
+
+  console.log(`SRT stream created: ${stream.id}`);
+  console.log(`SRT ingest URL: ${stream.ingest_url}`);
+  console.log(`Use this URL in your SRT encoder (OBS, vMix, etc.)`);
+
+  // Start accepting connections
+  const started = await wave.pipeline.start(stream.id);
+  console.log(`Status: ${started.status}`);
+
+  // Monitor health
+  const health = await wave.pipeline.getHealth(stream.id);
+  console.log(`Bitrate: ${health.bitrate_kbps}kbps`);
+  console.log(`Latency: ${health.latency_ms}ms`);
+}
+
+main().catch(console.error);

package/templates/studio-plugin/.env.example

@@ -0,0 +1,2 @@
+WAVE_API_KEY=wave_live_your_api_key_here
+WAVE_ORG_ID=your_org_id_here

package/templates/studio-plugin/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "wave-studio-plugin",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npx tsx src/index.ts",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@wave/sdk": "^2.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.9.0"
+  }
+}

package/templates/studio-plugin/src/index.ts

@@ -0,0 +1,32 @@
+import { Wave } from "@wave/sdk";
+
+const wave = new Wave({
+  apiKey: process.env.WAVE_API_KEY!,
+});
+
+async function main() {
+  // Register a custom Studio plugin
+  const plugin = await wave.studio.registerPlugin({
+    name: "My Custom Plugin",
+    description: "A custom production plugin for WAVE Studio",
+    version: "1.0.0",
+    capabilities: ["overlay", "transition"],
+  });
+
+  console.log(`Plugin registered: ${plugin.id}`);
+
+  // Listen for Studio events
+  const connection = await wave.studio.connect(plugin.id);
+
+  connection.on("scene.switch", (scene) => {
+    console.log(`Scene switched to: ${scene.name}`);
+  });
+
+  connection.on("source.added", (source) => {
+    console.log(`New source added: ${source.name} (${source.type})`);
+  });
+
+  console.log("Studio plugin connected and listening for events...");
+}
+
+main().catch(console.error);

package/templates/webhook-handler/.env.example

@@ -0,0 +1,3 @@
+WAVE_API_KEY=wave_live_your_api_key_here
+WAVE_WEBHOOK_SECRET=whsec_your_webhook_secret_here
+PORT=3000

package/templates/webhook-handler/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "wave-webhook-handler",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npx tsx src/index.ts",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@wave/sdk": "^2.0.0",
+    "express": "^4.21.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.9.0"
+  }
+}

package/templates/webhook-handler/src/index.ts

@@ -0,0 +1,52 @@
+import express from "express";
+import { Wave } from "@wave/sdk";
+
+const wave = new Wave({
+  apiKey: process.env.WAVE_API_KEY!,
+});
+
+const app = express();
+
+// WAVE sends JSON payloads for webhook events
+app.use(express.json());
+
+// Verify webhook signatures to ensure requests are from WAVE
+app.post("/webhooks/wave", async (req, res) => {
+  const signature = req.headers["wave-signature"] as string | undefined;
+  const secret = process.env.WAVE_WEBHOOK_SECRET;
+
+  if (!signature || !secret) {
+    res.status(401).json({ error: "Missing signature or secret" });
+    return;
+  }
+
+  const isValid = wave.webhooks.verify(req.body, signature, secret);
+  if (!isValid) {
+    res.status(401).json({ error: "Invalid signature" });
+    return;
+  }
+
+  const event = req.body;
+  console.log(`Received event: ${event.type}`);
+
+  switch (event.type) {
+    case "stream.started":
+      console.log(`Stream ${event.data.stream_id} started`);
+      break;
+    case "stream.ended":
+      console.log(`Stream ${event.data.stream_id} ended`);
+      break;
+    case "recording.ready":
+      console.log(`Recording ready: ${event.data.recording_url}`);
+      break;
+    default:
+      console.log(`Unhandled event type: ${event.type}`);
+  }
+
+  res.json({ received: true });
+});
+
+const PORT = process.env.PORT ?? 3000;
+app.listen(PORT, () => {
+  console.log(`Webhook server listening on port ${PORT}`);
+});

package/templates/webrtc-demo/.env.example

@@ -0,0 +1 @@
+WAVE_API_KEY=wave_live_your_api_key_here

package/templates/webrtc-demo/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "wave-webrtc-demo",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npx tsx src/index.ts",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@wave/sdk": "^2.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.9.0"
+  }
+}

package/templates/webrtc-demo/src/index.ts

@@ -0,0 +1,31 @@
+import { Wave } from "@wave/sdk";
+
+const wave = new Wave({
+  apiKey: process.env.WAVE_API_KEY!,
+});
+
+async function main() {
+  // Create a WebRTC stream
+  const stream = await wave.pipeline.create({
+    title: "WebRTC Demo Stream",
+    protocol: "webrtc",
+    description: "Created with WAVE CLI",
+  });
+
+  console.log(`Stream created: ${stream.id}`);
+  console.log(`Ingest URL: ${stream.ingest_url}`);
+  console.log(`Playback URL: ${stream.playback_url}`);
+
+  // Start the stream
+  const started = await wave.pipeline.start(stream.id);
+  console.log(`Stream status: ${started.status}`);
+
+  // Wait for it to go live
+  const live = await wave.pipeline.waitForLive(stream.id, {
+    timeout: 60000,
+    pollInterval: 2000,
+  });
+  console.log(`Stream is live! Viewers: ${live.viewer_count}`);
+}
+
+main().catch(console.error);