@videan/cli 0.3.1 → 0.4.0

package/README.md

@@ -16,6 +16,11 @@ videan secrets set KEY=value
 videan apps list
 ```
 
+Apps run as a **container** (default: always on) or **serverless** (scales to
+zero, cold start after idle): `videan apps create --mode serverless`, or switch
+later with `videan apps set --mode …` — applied by the next deploy. Serverless
+refuses cron, background jobs, WebSockets and custom Dockerfiles.
+
 The deployed contract is **expose an HTTP port on 3000**. Runtime (Node,
 Python, Next.js, Go, or your own Dockerfile) is detected from the files.
 Every deploy is an immutable snapshot; production is a pointer to one.

package/dist/index.js

@@ -14,6 +14,9 @@ import os from "node:os";
 var DEFAULT_API_URL = "https://api.videan.xyz/v1";
 var APP_DOMAIN = process.env.CLOUD_APP_DOMAIN || "videan.xyz";
 var MAX_FILE_SIZE_BYTES = 50 * 1024 * 1024;
+var APP_PORT = 3e3;
+var LAMBDA_ADAPTER = `COPY --from=public.ecr.aws/awsguru/aws-lambda-adapter:0.9.1 /lambda-adapter /opt/extensions/lambda-adapter
+ENV AWS_LWA_PORT=${APP_PORT}`;
 var FARGATE_SIZES = {
   256: { min: 512, max: 2048, step: 512 },
   512: { min: 1024, max: 4096, step: 1024 },
@@ -170,7 +173,9 @@ var AppsNamespace = class {
       storage_enabled: opts.storage,
       email_enabled: opts.email,
       auth_required: opts.authRequired,
-      visibility: opts.visibility
+      visibility: opts.visibility,
+      stack: opts.stack,
+      mode: opts.mode
     };
     const res = await this.client.request("POST", "/apps", body);
     return res.data;
@@ -199,6 +204,8 @@ var AppsNamespace = class {
     if (changes.postgres !== void 0) body.postgres_enabled = changes.postgres;
     if (changes.storage !== void 0) body.storage_enabled = changes.storage;
     if (changes.email !== void 0) body.email_enabled = changes.email;
+    if (changes.stack !== void 0) body.stack = changes.stack;
+    if (changes.mode !== void 0) body.mode = changes.mode;
     const res = await this.client.request(
       "PATCH",
       `/apps/${appId}`,
@@ -677,6 +684,12 @@ var OrgsNamespace = class {
   }
 };
 
+// ../shared/src/types.ts
+var APP_MODES = ["container", "serverless"];
+function isAppMode(value) {
+  return APP_MODES.includes(value);
+}
+
 // ../shared/src/constants.ts
 var SUPPORTED_RUNTIMES = [
   "node-20",
@@ -694,6 +707,11 @@ function appUrl(slug) {
 var CONFIG_FILE_NAME = "cloud.yaml";
 var MAX_FILE_SIZE_BYTES2 = 50 * 1024 * 1024;
 
+// ../shared/src/detect.ts
+var APP_PORT2 = 3e3;
+var LAMBDA_ADAPTER2 = `COPY --from=public.ecr.aws/awsguru/aws-lambda-adapter:0.9.1 /lambda-adapter /opt/extensions/lambda-adapter
+ENV AWS_LWA_PORT=${APP_PORT2}`;
+
 // ../shared/src/sizing.ts
 var FARGATE_SIZES2 = {
   256: { min: 512, max: 2048, step: 512 },
@@ -965,6 +983,15 @@ This platform puts a sign-in gate in front of apps unless they are public.
 
 Secrets: \`videan secrets set KEY=value\` (UPPERCASE keys) \u2014 injected as env
 vars on the next deploy. Never commit credentials to this repo instead.
+
+## Execution modes
+
+Apps run as a **container** (default: always on, no cold starts) or
+**serverless** (scales to zero, cold start after idle \u2014 good for internal
+tools with sporadic traffic). Set at create (\`videan apps create --mode
+serverless\`) or later (\`videan apps set --mode \u2026\`, applied by the next
+deploy). Serverless refuses cron, background jobs, WebSockets and custom
+Dockerfiles; container mode supports all of them.
 `;
 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) {
@@ -1503,6 +1530,15 @@ function accessOption(value) {
   }
   return tier;
 }
+function modeOption(value) {
+  if (value === void 0) return void 0;
+  const mode = value.trim().toLowerCase();
+  if (!isAppMode(mode)) {
+    console.error(chalk11.red(`Unknown --mode value "${value}". Use one of: ${APP_MODES.join(", ")}`));
+    process.exit(1);
+  }
+  return mode;
+}
 function describeAccess(app) {
   const tier = app.visibility ? visibilityOf(app.visibility) : app.authRequired ? "org" : "public";
   return `${tier} \u2014 ${VISIBILITY_LABELS[tier].toLowerCase()}`;
@@ -1523,7 +1559,13 @@ appsCommand.command("list").description("List all apps").option("-o, --org <id>"
     console.log(formatRow([app.name, app.id, app.status, appUrl(app.slug)], widths));
   }
 });
-appsCommand.command("create").description("Create a new app").option("-n, --name <name>", "App name").option("-o, --org <id>", "Organization ID").option("--postgres", "Provision a managed Postgres database").option("--storage", "Give the app an object-storage prefix").option("--email", "Let the app send mail through the platform").option("--public", "Serve the app without the platform login gate (same as --access public)").option("--access <tier>", `Who may open the app: ${VISIBILITIES.join(" | ")} (default: ${DEFAULT_VISIBILITY})`).action(
+appsCommand.command("create").description("Create a new app").option("-n, --name <name>", "App name").option("-o, --org <id>", "Organization ID").option("--postgres", "Provision a managed Postgres database").option("--storage", "Give the app an object-storage prefix").option("--email", "Let the app send mail through the platform").option("--public", "Serve the app without the platform login gate (same as --access public)").option("--access <tier>", `Who may open the app: ${VISIBILITIES.join(" | ")} (default: ${DEFAULT_VISIBILITY})`).option(
+  "--stack <label>",
+  "Group this app with its siblings (set the same label on a split frontend and backend)"
+).option(
+  "--mode <mode>",
+  `How the app runs: ${APP_MODES.join(" | ")} (default: container). serverless scales to zero but runs no cron, jobs or WebSockets`
+).action(
   async (opts) => {
     const apiKey = getApiKey();
     requireApiKey(apiKey);
@@ -1540,6 +1582,7 @@ appsCommand.command("create").description("Create a new app").option("-n, --name
       process.exit(1);
     }
     const visibility = accessOption(opts.access) ?? (opts.public ? "public" : void 0);
+    const mode = modeOption(opts.mode);
     const client4 = new CloudClient({ apiKey, baseUrl: getBaseUrl() });
     const app = await client4.apps.create({
       name,
@@ -1547,16 +1590,19 @@ appsCommand.command("create").description("Create a new app").option("-n, --name
       postgres: opts.postgres ?? false,
       storage: opts.storage ?? false,
       email: opts.email ?? false,
-      visibility
+      visibility,
+      stack: opts.stack,
+      mode
     });
     setCurrentApp(app.id);
     console.log(chalk11.green(`App "${app.name}" created (${app.id})`));
+    console.log(chalk11.gray(`  Mode:   ${app.mode ?? "container"}`));
     console.log(chalk11.gray(`  Access: ${describeAccess(app)}`));
     console.log(chalk11.gray(`  URL after first deploy: ${appUrl(app.slug)}`));
     console.log(chalk11.gray("  Push code with `videan deploy` \u2014 the runtime is auto-detected."));
   }
 );
-appsCommand.command("set").description("Change an app's settings (scale, rate limit, gate, capabilities)").option("-a, --app <id>", "App ID").option("-n, --name <name>", "Rename the app (the URL keeps its original slug)").option("--cpu <units>", "CPU units per instance (256 = 0.25 vCPU)").option("--memory <mib>", "Memory per instance, in MiB").option("--instances <n>", "Number of instances to run").option("--rate-limit <rpm>", "Requests per minute per client").option("--no-rate-limit", "Remove the rate limit").option("--access <tier>", `Who may open the app: ${VISIBILITIES.join(" | ")}`).option("--public", "Serve without the platform login gate (same as --access public)").option("--private", "Require platform login (leaves the tier alone if it is already gated)").option("--postgres", "Provision a managed Postgres database").option("--storage", "Give the app an object-storage prefix").option("--email", "Let the app send mail through the platform").option("--json", "Print the raw response").action(
+appsCommand.command("set").description("Change an app's settings (scale, rate limit, gate, capabilities)").option("-a, --app <id>", "App ID").option("-n, --name <name>", "Rename the app (the URL keeps its original slug)").option("--cpu <units>", "CPU units per instance (256 = 0.25 vCPU)").option("--memory <mib>", "Memory per instance, in MiB").option("--instances <n>", "Number of instances to run").option("--rate-limit <rpm>", "Requests per minute per client").option("--no-rate-limit", "Remove the rate limit").option("--access <tier>", `Who may open the app: ${VISIBILITIES.join(" | ")}`).option("--public", "Serve without the platform login gate (same as --access public)").option("--private", "Require platform login (leaves the tier alone if it is already gated)").option("--postgres", "Provision a managed Postgres database").option("--storage", "Give the app an object-storage prefix").option("--email", "Let the app send mail through the platform").option("--stack <label>", "Group this app with its siblings under a shared label").option("--no-stack", "Remove the app from its stack").option("--mode <mode>", `How the app runs: ${APP_MODES.join(" | ")} (applies on the next deploy or restart)`).option("--json", "Print the raw response").action(
   async (opts) => {
     const apiKey = getApiKey();
     requireApiKey(apiKey);
@@ -1574,8 +1620,10 @@ appsCommand.command("set").description("Change an app's settings (scale, rate li
       console.error(chalk11.red("--access already says who may open the app; drop --public/--private."));
       process.exit(1);
     }
+    const mode = modeOption(opts.mode);
     const changes = {};
     if (opts.name) changes.name = opts.name;
+    if (mode) changes.mode = mode;
     if (opts.cpu !== void 0) changes.cpu = intOption("--cpu", opts.cpu);
     if (opts.memory !== void 0) changes.memory = intOption("--memory", opts.memory);
     if (opts.instances !== void 0) {
@@ -1591,6 +1639,8 @@ appsCommand.command("set").description("Change an app's settings (scale, rate li
     if (opts.postgres) changes.postgres = true;
     if (opts.storage) changes.storage = true;
     if (opts.email) changes.email = true;
+    if (opts.stack === false) changes.stack = null;
+    else if (typeof opts.stack === "string") changes.stack = opts.stack;
     if (Object.keys(changes).length === 0) {
       console.error(chalk11.red("Nothing to change. Pass at least one option."));
       process.exit(1);
@@ -1602,6 +1652,7 @@ appsCommand.command("set").description("Change an app's settings (scale, rate li
       return;
     }
     console.log(chalk11.green(`Updated ${app.name} (${app.id})`));
+    console.log(`  Mode:        ${app.mode ?? "container"}`);
     console.log(`  Access:      ${describeAccess(app)}`);
     console.log(`  Scale:       ${app.cpu ?? "default"} CPU / ${app.memory ?? "default"} MiB`);
     console.log(
@@ -2237,7 +2288,7 @@ function period(start, end) {
 
 // src/index.ts
 var program = new Command18();
-program.name("videan").description("Videan CLI \u2014 deploy apps in seconds").version("0.1.0");
+program.name("videan").description("Videan CLI \u2014 deploy apps in seconds").version("0.4.0");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
 program.addCommand(initCommand);