@videan/cli 0.1.1 → 0.2.0

package/dist/index.js

@@ -120,8 +120,8 @@ var CloudClient = class {
     const res = await this.request("GET", "/plans");
     return res.data;
   }
-  async request(method, path4, body) {
-    const url = `${this.baseUrl}${path4}`;
+  async request(method, path5, body) {
+    const url = `${this.baseUrl}${path5}`;
     const headers = {
       "Authorization": `Bearer ${this.apiKey}`,
       "Content-Type": "application/json"
@@ -290,8 +290,8 @@ var AppsNamespace = class {
     if (opts?.instance) params.set("instance", opts.instance);
     if (opts?.nextToken) params.set("next_token", opts.nextToken);
     const query = params.toString();
-    const path4 = `/apps/${appId}/logs${query ? `?${query}` : ""}`;
-    const res = await this.client.request("GET", path4);
+    const path5 = `/apps/${appId}/logs${query ? `?${query}` : ""}`;
+    const res = await this.client.request("GET", path5);
     return res.data;
   }
   /**
@@ -934,35 +934,100 @@ var logoutCommand = new Command2("logout").description("Forget the saved key, or
 import { Command as Command3 } from "commander";
 import inquirer2 from "inquirer";
 import chalk3 from "chalk";
+import fs2 from "fs-extra";
+import path2 from "node:path";
+
+// src/videan-md.ts
 import fs from "fs-extra";
 import path from "node:path";
-var initCommand = new Command3("init").description("Initialize a new Cloud app in the current directory").action(async () => {
-  const configPath2 = path.join(process.cwd(), CONFIG_FILE_NAME);
-  if (await fs.pathExists(configPath2)) {
-    console.log(chalk3.yellow(`${CONFIG_FILE_NAME} already exists in this directory.`));
-    const { overwrite } = await inquirer2.prompt([
-      { type: "confirm", name: "overwrite", message: "Overwrite?", default: false }
-    ]);
-    if (!overwrite) return;
+var VIDEAN_MD = `# This project deploys to Videan
+
+Deploy: \`videan deploy\` (from this directory). Logs: \`videan logs -f\`.
+Undo a bad deploy: \`videan rollback\`. Full agent guide: https://videan.xyz/llms.txt
+
+The contract: serve HTTP on **port 3000**. Runtime (Node/Python/Next.js/Go/
+Dockerfile) is detected from the files \u2014 no config needed. If the app has a
+managed database, read \`DATABASE_URL\` from the environment. Log to stdout.
+
+## Auth \u2014 read this before writing any login code
+
+This platform puts a sign-in gate in front of apps unless they are public.
+
+- **Gated app (visibility private/org/authenticated \u2014 the default): DO NOT
+  build a login page.** Every request arrives with the visitor already
+  authenticated: read \`X-User-Id\`, \`X-User-Email\`, \`X-User-Roles\`. If the
+  app needs its own user records, find-or-create a local user from
+  \`X-User-Email\` and start your session from that \u2014 never render a login
+  form when the header is present.
+- **Public app** (\`videan apps set --public\`): the gate is out of the path,
+  no headers arrive, bring your own auth if the app needs any. Required for
+  anything that must receive webhooks from external services.
+
+Secrets: \`videan secrets set KEY=value\` (UPPERCASE keys) \u2014 injected as env
+vars on the next deploy. Never commit credentials to this repo instead.
+`;
+var POINTER = "\n## Videan\n\nThis project deploys to Videan \u2014 see VIDEAN.md for the platform contract (port 3000, auth headers, deploy commands) before writing server or login code.\n";
+async function writeVideanMd(dir) {
+  const wrote = [];
+  const target = path.join(dir, "VIDEAN.md");
+  if (!await fs.pathExists(target)) {
+    await fs.writeFile(target, VIDEAN_MD, "utf-8");
+    wrote.push("VIDEAN.md");
+  }
+  for (const name of ["CLAUDE.md", "AGENTS.md"]) {
+    const p = path.join(dir, name);
+    if (!await fs.pathExists(p)) continue;
+    const body = await fs.readFile(p, "utf-8");
+    if (body.includes("VIDEAN.md")) continue;
+    await fs.appendFile(p, POINTER, "utf-8");
+    wrote.push(`${name} (pointer)`);
+  }
+  return wrote;
+}
+
+// src/commands/init.ts
+var initCommand = new Command3("init").description("Initialize a new Cloud app in the current directory").option("--name <name>", "App name (defaults to the directory name)").option("--runtime <runtime>", "One of: " + SUPPORTED_RUNTIMES.join(", ")).option("--entrypoint <file>", "Entry file", "index.ts").option("--yes", "Take the defaults without prompting").action(async (opts) => {
+  const configPath2 = path2.join(process.cwd(), CONFIG_FILE_NAME);
+  const interactive = process.stdin.isTTY && !opts.yes;
+  if (await fs2.pathExists(configPath2)) {
+    if (!interactive) {
+      console.log(chalk3.yellow(`${CONFIG_FILE_NAME} already exists; leaving it alone.`));
+    } else {
+      console.log(chalk3.yellow(`${CONFIG_FILE_NAME} already exists in this directory.`));
+      const { overwrite } = await inquirer2.prompt([
+        { type: "confirm", name: "overwrite", message: "Overwrite?", default: false }
+      ]);
+      if (!overwrite) {
+        for (const f of await writeVideanMd(process.cwd())) console.log(chalk3.green(`Wrote ${f}`));
+        return;
+      }
+    }
   }
-  const answers = await inquirer2.prompt([
-    { type: "input", name: "name", message: "App name:", default: path.basename(process.cwd()) },
-    {
-      type: "list",
-      name: "runtime",
-      message: "Runtime:",
-      choices: SUPPORTED_RUNTIMES
-    },
-    { type: "input", name: "entrypoint", message: "Entrypoint:", default: "index.ts" }
-  ]);
-  const config2 = [
-    `name: ${answers.name}`,
-    `runtime: ${answers.runtime}`,
-    `entrypoint: ${answers.entrypoint}`,
-    ""
-  ].join("\n");
-  await fs.writeFile(configPath2, config2, "utf-8");
-  console.log(chalk3.green(`Created ${CONFIG_FILE_NAME}`));
+  if (!await fs2.pathExists(configPath2) || interactive) {
+    const answers = interactive ? await inquirer2.prompt([
+      { type: "input", name: "name", message: "App name:", default: opts.name || path2.basename(process.cwd()) },
+      {
+        type: "list",
+        name: "runtime",
+        message: "Runtime:",
+        choices: SUPPORTED_RUNTIMES
+      },
+      { type: "input", name: "entrypoint", message: "Entrypoint:", default: opts.entrypoint }
+    ]) : {
+      name: opts.name || path2.basename(process.cwd()),
+      runtime: opts.runtime || SUPPORTED_RUNTIMES[0],
+      entrypoint: opts.entrypoint
+    };
+    const config2 = [
+      `name: ${answers.name}`,
+      `runtime: ${answers.runtime}`,
+      `entrypoint: ${answers.entrypoint}`,
+      ""
+    ].join("\n");
+    await fs2.writeFile(configPath2, config2, "utf-8");
+    console.log(chalk3.green(`Created ${CONFIG_FILE_NAME}`));
+  }
+  for (const f of await writeVideanMd(process.cwd())) console.log(chalk3.green(`Wrote ${f}`));
 });
 
 // src/commands/deploy.ts
@@ -971,8 +1036,8 @@ import chalk5 from "chalk";
 import ora2 from "ora";
 
 // src/util.ts
-import fs2 from "fs-extra";
-import path2 from "node:path";
+import fs3 from "fs-extra";
+import path3 from "node:path";
 import ignore from "ignore";
 import chalk4 from "chalk";
 var MAX_FILE_BYTES = 10 * 1024 * 1024;
@@ -989,30 +1054,30 @@ async function collectFiles(dir) {
     ".DS_Store",
     "*.log"
   ]);
-  const gitignorePath = path2.join(dir, ".gitignore");
-  if (await fs2.pathExists(gitignorePath)) {
-    const content = await fs2.readFile(gitignorePath, "utf-8");
+  const gitignorePath = path3.join(dir, ".gitignore");
+  if (await fs3.pathExists(gitignorePath)) {
+    const content = await fs3.readFile(gitignorePath, "utf-8");
     ig.add(content);
   }
-  const cloudignorePath = path2.join(dir, ".cloudignore");
-  if (await fs2.pathExists(cloudignorePath)) {
-    const content = await fs2.readFile(cloudignorePath, "utf-8");
+  const cloudignorePath = path3.join(dir, ".cloudignore");
+  if (await fs3.pathExists(cloudignorePath)) {
+    const content = await fs3.readFile(cloudignorePath, "utf-8");
     ig.add(content);
   }
   const files = {};
   const binaryFiles = {};
   const skipped = [];
   async function walk(currentDir) {
-    const entries = await fs2.readdir(currentDir, { withFileTypes: true });
+    const entries = await fs3.readdir(currentDir, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = path2.join(currentDir, entry.name);
-      const relativePath = path2.relative(dir, fullPath);
+      const fullPath = path3.join(currentDir, entry.name);
+      const relativePath = path3.relative(dir, fullPath);
       const ignorePath = entry.isDirectory() ? `${relativePath}/` : relativePath;
       if (ig.ignores(ignorePath)) continue;
       if (entry.isDirectory()) {
         await walk(fullPath);
       } else if (entry.isFile()) {
-        const buffer = await fs2.readFile(fullPath);
+        const buffer = await fs3.readFile(fullPath);
         if (buffer.byteLength > MAX_FILE_BYTES) {
           skipped.push({
             path: relativePath,
@@ -1118,6 +1183,16 @@ var deployCommand = new Command4("deploy").description("Deploy the current direc
   }
   if (current.status === "running") {
     spinner.succeed(chalk5.green(`Deployed successfully!`));
+    try {
+      const app = await client4.apps.get(appId);
+      const gated = app.visibility ? app.visibility !== "public" : app.authRequired !== false;
+      console.log(
+        gated ? chalk5.gray(
+          `  Access: ${app.visibility || "org"} \u2014 visitors sign in once at the edge; your app receives X-User-Id / X-User-Email on every request. Don't build a login page.`
+        ) : chalk5.gray(`  Access: public \u2014 reachable by anyone; bring your own auth if it needs any.`)
+      );
+    } catch {
+    }
     if (current.url) {
       const url = /^https?:\/\//.test(current.url) ? current.url : `https://${current.url}`;
       console.log(chalk5.cyan(`  URL: ${url}`));
@@ -1689,8 +1764,8 @@ orgsCommand.command("invite <email>").description("Invite a member by email").op
 // src/commands/storage.ts
 import { Command as Command13 } from "commander";
 import chalk14 from "chalk";
-import fs3 from "fs-extra";
-import path3 from "node:path";
+import fs4 from "fs-extra";
+import path4 from "node:path";
 var storageCommand = new Command13("storage").description("Store files for an app");
 function client() {
   const apiKey = getApiKey();
@@ -1737,12 +1812,12 @@ ${objects.length} object(s), ${human(total)}`));
 });
 storageCommand.command("put <file> [key]").description("Upload a file (key defaults to the file's name)").option("-a, --app <id>", "App ID").option("-t, --type <mime>", "Content type").action(async (file, key, opts) => {
   const appId = requireApp(opts.app);
-  if (!await fs3.pathExists(file)) {
+  if (!await fs4.pathExists(file)) {
     console.error(chalk14.red(`No such file: ${file}`));
     process.exit(1);
   }
-  const body = await fs3.readFile(file);
-  const objectKey = key || path3.basename(file);
+  const body = await fs4.readFile(file);
+  const objectKey = key || path4.basename(file);
   const stored = await client().storage.upload(appId, objectKey, body, {
     contentType: opts.type
   });
@@ -1754,8 +1829,8 @@ storageCommand.command("put <file> [key]").description("Upload a file (key defau
 storageCommand.command("get <key> [file]").description("Download an object (defaults to the key's basename)").option("-a, --app <id>", "App ID").action(async (key, file, opts) => {
   const appId = requireApp(opts.app);
   const bytes = await client().storage.download(appId, key);
-  const dest = file || path3.basename(key);
-  await fs3.writeFile(dest, bytes);
+  const dest = file || path4.basename(key);
+  await fs4.writeFile(dest, bytes);
   console.log(chalk14.green(`Wrote ${dest}`) + chalk14.dim(` (${human(bytes.length)})`));
 });
 storageCommand.command("rm <key>").description("Delete an object").option("-a, --app <id>", "App ID").action(async (key, opts) => {
@@ -1791,7 +1866,7 @@ storageCommand.command("usage").description("Total objects and bytes stored").op
 // src/commands/email.ts
 import { Command as Command14 } from "commander";
 import chalk15 from "chalk";
-import fs4 from "fs-extra";
+import fs5 from "fs-extra";
 var emailCommand = new Command14("email").description("Send email from an app");
 function client2() {
   const apiKey = getApiKey();
@@ -1812,7 +1887,7 @@ emailCommand.command("send").description("Send an email").requiredOption("-t, --
     let text = opts.text;
     let html = opts.html;
     if (opts.bodyFile) {
-      const contents = await fs4.readFile(opts.bodyFile, "utf-8");
+      const contents = await fs5.readFile(opts.bodyFile, "utf-8");
       if (/\.html?$/i.test(opts.bodyFile)) html = contents;
       else text = contents;
     }
@@ -1857,7 +1932,7 @@ emailCommand.command("quota").description("Show today's sending allowance").opti
 // src/commands/jobs.ts
 import { Command as Command15 } from "commander";
 import chalk16 from "chalk";
-import fs5 from "fs-extra";
+import fs6 from "fs-extra";
 var jobsCommand = new Command15("jobs").description("Enqueue and inspect background jobs");
 function client3() {
   const apiKey = getApiKey();
@@ -1893,7 +1968,7 @@ function statusLabel(status) {
 jobsCommand.command("enqueue").description("Queue a job for the app to run").option("-a, --app <id>", "App ID").option("-q, --queue <name>", "Queue name (default: default)").option("-p, --path <path>", "Path on the app to POST to (default: /jobs)").option("-d, --data <json>", "JSON payload").option("-f, --file <path>", "Read the JSON payload from a file").option("--delay <seconds>", "Run no earlier than this many seconds from now").option("--attempts <n>", "Attempts before the job is given up on (default: 3)").option("--timeout <seconds>", "How long the handler gets per attempt (default: 60)").option("--key <key>", "Idempotency key -- a repeat returns the same job").option("--json", "Print the raw response").action(async (opts) => {
   const appId = requireApp3(opts.app);
   let payload;
-  const raw = opts.file ? await fs5.readFile(opts.file, "utf-8") : opts.data;
+  const raw = opts.file ? await fs6.readFile(opts.file, "utf-8") : opts.data;
   if (raw !== void 0) {
     try {
       payload = JSON.parse(raw);