repovid 0.1.0 → 0.2.0

package/README.md

@@ -9,8 +9,8 @@ npx repovid login
 
 Then open Claude Code or Codex in your project and ask for a RepoVid walkthrough or demo.
 
-Your first run is free. After that, `npx repovid upgrade` unlocks unlimited videos for $5, once.
+Your first run is free. `npx repovid upgrade` unlocks unlimited local videos for $5, once. `npx repovid plans` adds a hosted link you can share.
 
 RepoVid records and renders on your machine. It needs Node 20 or newer and a web app running locally with demo data.
 
-More at https://repovid.vercel.app. Support: repovid.support@gmail.com.
+More at https://repovid.carles-mallafre.workers.dev. Support: repovid.support@gmail.com.

package/bin/repovid.mjs

@@ -1,12 +1,13 @@
 #!/usr/bin/env node
-// repovid login | upgrade | doctor | init | schema | inspect <path> [--role r] | validate <plan.json> | render <plan.json> [--only a,b] [--out dir]
+// repovid login | upgrade | plans | publish | doctor | init | schema | inspect <path> [--role r] | validate <plan.json> | render <plan.json> [--only a,b] [--out dir]
 import { execFileSync, spawnSync } from "node:child_process";
 import { appendFileSync, copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { createRequire } from "node:module";
 import { dirname, join, resolve } from "node:path";
 import ffmpegPath from "ffmpeg-static";
-import { completeExport, login, requestExport, upgrade } from "../src/account.mjs";
+import { completeExport, login, plans, requestExport, upgrade } from "../src/account.mjs";
+import { publish } from "../src/publish.mjs";
 import { writeGuide } from "../src/guide.mjs";
 import { validatePlan, validateProject } from "../src/plan.mjs";
 import { inspectScreen, launch, recordVideo } from "../src/record.mjs";
@@ -85,9 +86,14 @@ async function render() {
   for (const d of ["videos", "guide/media"]) mkdirSync(join(outDir, d), { recursive: true });
   // The free selection is remembered, so retrying failed videos one by one keeps all of them eligible.
   const freeFile = join(outDir, ".free.json");
-  const freeSelection = existsSync(freeFile) ? JSON.parse(readFileSync(freeFile, "utf8")) : selected.map(v => v.id);
+  const stateFile = join(outDir, ".render.json");
+  const previous = existsSync(stateFile) ? JSON.parse(readFileSync(stateFile, "utf8")) : [];
+  // If nothing has exported yet, the free run hasn't really started, so the choice can still change.
+  const remembered = previous.length && existsSync(freeFile) ? JSON.parse(readFileSync(freeFile, "utf8")) : null;
+  const freeSelection = remembered ?? selected.map(v => v.id);
 
   const grant = await requestExport(plan.mode, plan.videos.length);
+  if (grant.plan === "refunded") { console.error("This licence was refunded. Contact repovid.support@gmail.com to buy again."); process.exit(1); }
   if (grant.plan === "none") { console.error("Your free run is used. Run repovid upgrade to unlock unlimited videos for $5."); process.exit(1); }
   const outsideFree = grant.plan === "free" && selected.some(v => !freeSelection.includes(v.id));
   if (grant.plan === "free" && (outsideFree || freeSelection.length > grant.allowed)) {
@@ -102,8 +108,6 @@ async function render() {
   const wavs = await synthesize([...new Set(videos.flatMap(v => v.scenes.map(s => s.say)))], join(homedir(), ".cache", "repovid", "voice"), console.log);
   const browser = await launch(plan.testIdAttribute);
   // Earlier runs count too: retrying one video with --only must not lock the others.
-  const stateFile = join(outDir, ".render.json");
-  const previous = existsSync(stateFile) ? JSON.parse(readFileSync(stateFile, "utf8")) : [];
   const rendered = new Map(previous.filter(r => plan.videos.some(v => v.id === r.id) && existsSync(join(outDir, "videos", `${r.id}.mp4`))).map(r => [r.id, r]));
   let failed = 0;
   for (const video of videos) {
@@ -131,10 +135,12 @@ process.on("uncaughtException", e => { console.error(e.message); process.exit(1)
 if (command === "doctor") await doctor();
 else if (command === "login") await login();
 else if (command === "upgrade") await upgrade();
+else if (command === "plans") await plans(file);
+else if (command === "publish" && file) await publish(file, flag("out") ?? "repovid-output", rest.includes("--public-link"));
 else if (command === "init") init();
 else if (command === "schema") process.stdout.write(readFileSync(asset("schema.md"), "utf8"));
 else if (command === "inspect") await inspect();
 else if (command === "validate" && file) { loadPlan(); console.log("plan is valid"); }
 else if (command === "render" && file) await render();
-else { console.error("usage: repovid login | upgrade | doctor | init | schema | inspect <path> [--role role] | validate <plan.json> | render <plan.json> [--only a,b] [--out dir]"); process.exit(2); }
+else { console.error("usage: repovid login | upgrade | plans [name] | publish <plan.json> --public-link | doctor | init | schema | inspect <path> [--role role] | validate <plan.json> | render <plan.json> [--only a,b] [--out dir]"); process.exit(2); }
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "repovid",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Turn your web app into narrated demo videos and a guide page, using the coding agent you already have.",
-  "homepage": "https://repovid.vercel.app",
+  "homepage": "https://repovid.carles-mallafre.workers.dev",
   "license": "UNLICENSED",
   "keywords": [
     "demo",

package/src/account.mjs

@@ -4,7 +4,7 @@ import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { spawn } from "node:child_process";
 
-const API = process.env.REPOVID_API ?? "https://repovid.vercel.app";
+const API = process.env.REPOVID_API ?? "https://repovid.carles-mallafre.workers.dev";
 const AUTH_FILE = join(homedir(), ".config", "repovid", "auth.json");
 const POLL_MS = 2000, LOGIN_MS = 10 * 60 * 1000;
 
@@ -47,8 +47,22 @@ export async function login() {
   throw new Error("Sign-in expired. Run repovid login again.");
 }
 
+export const authed = () => { if (!readToken()) throw new Error("Sign in first with repovid login."); };
+export const api = call;
+
+export async function plans(plan) {
+  authed();
+  if (!plan) {
+    console.log("Hosting plans, billed yearly:\n  solo   3 projects,  30 videos each,   5 GB   $12\n  pro   10 projects,  50 videos each,  25 GB   $29\n  team  50 projects, 100 videos each, 100 GB   $79\nChoose one: repovid plans <name>");
+    return;
+  }
+  const { url } = await call("/api/hosting/checkout", { plan });
+  console.log(`Opening ${url}`);
+  openBrowser(url);
+}
+
 export async function upgrade() {
-  if (!readToken()) throw new Error("Sign in first with repovid login.");
+  authed();
   const { url } = await call("/api/checkout");
   console.log(`Opening ${url}`);
   openBrowser(url);

package/src/publish.mjs

@@ -0,0 +1,48 @@
+// Sends structured guide text and rendered files to RepoVid. The plan's actions never leave the machine.
+import { existsSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { api, authed } from "./account.mjs";
+
+const stateName = ".published.json";
+const put = async (url, file, type) => {
+  const res = await fetch(url, { method: "PUT", body: readFileSync(file), headers: { "content-type": type } });
+  if (!res.ok) throw new Error(`upload failed (${res.status})`);
+};
+
+export async function publish(planFile, out, confirmed) {
+  authed();
+  if (!confirmed) throw new Error("Anyone with the link will be able to watch these videos. Review them first, then add --public-link.");
+  const outDir = resolve(out);
+  const plan = JSON.parse(readFileSync(planFile, "utf8"));
+  const stateFile = join(outDir, ".render.json");
+  if (!existsSync(stateFile)) throw new Error("Render the videos first.");
+  const rendered = new Map(JSON.parse(readFileSync(stateFile, "utf8")).map(r => [r.id, r]));
+  const videos = plan.videos.filter(v => rendered.has(v.id) && existsSync(join(outDir, "videos", `${v.id}.mp4`)));
+  if (!videos.length) throw new Error("Nothing to publish yet.");
+
+  const guide = {
+    mode: plan.mode, name: plan.project.name, summary: plan.project.summary, sections: plan.project.sections ?? [],
+    videos: videos.map(v => { const r = rendered.get(v.id); return { id: v.id, title: v.title, summary: v.summary, role: v.role, steps: v.steps, length: r.length, cues: r.cues }; }),
+  };
+  const publishedFile = join(outDir, stateName);
+  const slug = existsSync(publishedFile) ? JSON.parse(readFileSync(publishedFile, "utf8")).slug : undefined;
+  const bytes = videos.reduce((n, v) => n + statSync(join(outDir, "videos", `${v.id}.mp4`)).size + statSync(join(outDir, "guide", "media", `${v.id}.jpg`)).size, 0);
+  const draft = await api("/api/guides", { guide, slug, bytes });
+  // Saved before commit: if the reply is lost, the guide can still be updated or removed from here.
+  writeFileSync(publishedFile, JSON.stringify({ slug: draft.slug, url: draft.url }));
+  for (const u of draft.uploads) {
+    const mp4 = join(outDir, "videos", `${u.id}.mp4`);
+    if (statSync(mp4).size > draft.maxVideoBytes) throw new Error(`${u.id} is too large to publish.`);
+    await put(u.video, mp4, "video/mp4");
+    await put(u.poster, join(outDir, "guide", "media", `${u.id}.jpg`), "image/jpeg");
+    console.log(`uploaded ${u.id}`);
+  }
+  // Large projects finish over several calls.
+  for (;;) {
+    const r = await api("/api/guides/commit", { guideId: draft.guideId, version: draft.version });
+    if (!r.remaining) break;
+    console.log(`processing, ${r.remaining} left`);
+  }
+  console.log(`Published: ${draft.url}\nAnyone with this link can watch. Manage it at ${new URL(draft.url).origin}/app.`);
+}
+

package/src/skill.md

@@ -49,6 +49,7 @@ Run `npx repovid schema` for the format, then write `.repovid/plan.json`.
 - Each scene's `say` is what the narrator says while that scene's actions run. Plain, friendly English for the people who use this app. Explain why, not only what.
 - Fill `project.summary` and `project.sections` (title and text pairs). walkthrough: what it is, how it works, roles, high-level architecture. demo: what it is, who it's for, what problem it solves, how to get started.
 - Give each walkthrough video a `summary` and short `steps`.
+- Project text may be published, so keep local URLs, file names, demo users and internal details out of it. "How to get started" should describe the product, not this machine.
 - Spell product names the way they sound if a voice would read them wrongly.
 - Use only fake people and contact details. Don't submit forms that send real emails or messages, and never touch billing.
 
@@ -62,3 +63,6 @@ Run `npx repovid render .repovid/plan.json`. If a video fails, inspect that scre
 Rendering really uses the app, so records a flow creates stay there. Before rendering a video again, tell the user which demo data to reset, because a second run can find duplicates or taken slots.
 
 Then tell the user to open `repovid-output/guide/index.html`, and to review every video before sharing, in case something private is on screen.
+
+## 7. Share (optional)
+`npx repovid publish .repovid/plan.json --public-link` uploads the videos and guide text to RepoVid and returns a link. Anyone with the link can watch. Only run it after the user has watched every video and told you to publish. Publishing again from the same folder updates the same link and keeps earlier versions. The owner manages projects in the web dashboard. Publishing needs a hosting plan: `npx repovid plans`.