@light-cloud/cli 0.1.0 → 0.1.3

package/README.md

@@ -21,6 +21,14 @@ $ lc deploy
 └  Live at https://my-app.acme.light-cloud.io
 ```
 
+## No account yet? Start here
+
+```
+$ npx @light-cloud/cli login --device --email you@example.com
+```
+
+Type the 8-character code it prints at `console.light-cloud.com/device` from any device (approve the link in the email we send for a new address). That creates the account — free plan, no password, no form — and signs the terminal in. `lc billing card add --plan pro` later, when you need a paid plan; the card goes through a Stripe-hosted link, never through `lc`.
+
 ## Install
 
 ```bash

package/dist/index.js

@@ -756,6 +756,16 @@ var LightCloudApi = class {
       environmentId
     });
   }
+  /** Visitor password gate. No password turns the gate off. */
+  async setEnvironmentPassword(organisationId, environmentId, password2) {
+    const enabled = Boolean(password2);
+    return this.client.post("/api/environments/password", {
+      targetOrganisationId: organisationId,
+      environmentId,
+      enabled,
+      ...enabled ? { password: password2 } : {}
+    });
+  }
   async createEnvironment(request) {
     return this.client.post("/api/environments/create", request);
   }
@@ -1696,6 +1706,21 @@ function packageSource(options = {}) {
   });
 }
 
+// src/lib/upload/storage-error.ts
+function describeStorageUploadFailure(response) {
+  switch (response.status) {
+    case 401:
+    case 403:
+      return `Light Cloud storage refused the upload (${response.status}). This is a platform-side fault, not your account, plan or permissions \u2014 deploy from a git repository for now and report it to Light Cloud support.`;
+    case 400:
+      return "the upload link was rejected, most likely expired \u2014 run the deploy again.";
+    case 413:
+      return "the archive is too large for a single upload \u2014 exclude build output and large assets, or deploy from a git repository.";
+    default:
+      return `Light Cloud storage answered ${response.status}${response.statusText ? ` ${response.statusText}` : ""} \u2014 try again in a moment.`;
+  }
+}
+
 // src/commands/shared.ts
 function contextFrom(command) {
   const options = command.optsWithGlobals();
@@ -1811,9 +1836,12 @@ async function uploadSource(ctx, directory, detection) {
   });
   if (!put.ok) {
     spin.stop("Upload failed", 1);
-    throw new CliError(`Upload rejected by storage (${put.status} ${put.statusText}).`, { hint: "Try again in a moment." });
+    throw new CliError(`Upload failed: ${describeStorageUploadFailure(put)}`, {
+      hint: put.status === 403 ? "Deploy from a git repository meanwhile: lc deploy --repo <owner/name>." : "Try again in a moment."
+    });
   }
-  await ctx.api.completeUpload(org.id, session.uploadId, {
+  spin.message("Inspecting source");
+  const server = await ctx.api.completeUpload(org.id, session.uploadId, {
     detectedFramework: detection.framework,
     detectedRuntime: detection.runtime,
     detectedDeploymentType: detection.deploymentType,
@@ -1821,7 +1849,11 @@ async function uploadSource(ctx, directory, detection) {
     detectedOutputDirectory: detection.outputDirectory
   });
   spin.stop(`Uploaded ${pack.fileCount} files ${c.dim(`(${formatBytes(pack.buffer.length)})`)}`);
-  return { uploadId: session.uploadId, fileCount: pack.fileCount, totalSize: pack.totalSize, archiveSize: pack.buffer.length };
+  if (server.detectionSource === "server" && server.detectedFramework && server.detectedFramework !== detection.framework) {
+    log.info(`Light Cloud read the source as ${server.detectedFramework} (${server.detectedDeploymentType}).`);
+  }
+  if (server.configWarning) log.warn(server.configWarning);
+  return { uploadId: session.uploadId, fileCount: pack.fileCount, totalSize: pack.totalSize, archiveSize: pack.buffer.length, server };
 }
 function describeDetection(detection) {
   const parts = [];
@@ -2101,6 +2133,8 @@ async function browserSignIn(consoleUrl, openIt) {
     out(`${c.dim("\u2502")}  Open this link in your browser to sign in:`);
   }
   out(`${c.dim("\u2502")}  ${link(flow.url)}`);
+  if (isJson()) process.stderr.write(`Open this link to sign in: ${flow.url}
+`);
   const spin = spinner2();
   spin.start("Waiting for you to sign in\u2026");
   try {
@@ -2134,6 +2168,8 @@ async function deviceSignIn(client, emailFlag) {
   out(`${c.dim("\u2502")}      ${c.bold(flow.userCode)}`);
   out(`${c.dim("\u2502")}`);
   out(`${c.dim("\u2502")}  ${c.dim(`The code expires in ${minutes} minutes.`)}`);
+  if (isJson()) process.stderr.write(`Enter code ${flow.userCode} at ${flow.verificationUrl} (expires in ${minutes} min)
+`);
   if (!flow.emailSent) {
     log.warn("The confirmation email could not be sent; an existing account can still approve by signing in on the page above.");
   }
@@ -3045,7 +3081,8 @@ function registerDeployCommand(program2) {
       out(`${c.dim("\u2502")}  ${c.bold(app.name)} ${c.dim(sym.arrow)} ${env.name}${env.is_production ? c.accent(` ${sym.star}`) : ""}`);
     }
     let uploadId;
-    if (options.upload) {
+    const linkedHere = isUploadApp && ctx.project?.config.applicationId === app.id;
+    if (options.upload || linkedHere) {
       uploadId = await uploadForDeploy(ctx, options.dir);
     } else if (isUploadApp) {
       if (!isJson()) out(`${c.dim("\u2502")}  Source: last upload ${c.dim("(pass --upload to send this folder)")}`);
@@ -3343,6 +3380,20 @@ function registerEnvCommands(program2) {
       if (result.dedicated_addon_notice) log.info(result.dedicated_addon_notice);
     });
   });
+  env.command("password [env]").description("Gate the site behind a visitor password, or make it public again").option("-a, --app <app>", "app name or id").option("--set <password>", "password visitors must enter (6-128 characters)").option("--off", "remove the password gate").action(async (ref, options, command) => {
+    const ctx = contextFrom(command);
+    if (!options.set && !options.off) {
+      throw new CliError("Nothing to change.", { hint: "Pass --set <password> or --off.", exitCode: EXIT.USAGE });
+    }
+    const app = await ctx.resolveApp(options.app);
+    const target = await ctx.resolveEnv(app, ref);
+    const org = await ctx.resolveOrg();
+    const result = await ctx.api.setEnvironmentPassword(org.id, target.id, options.off ? void 0 : options.set);
+    emit(result, () => {
+      if (result.passwordEnabled) log.success(`${app.name} / ${target.name} is password protected.`);
+      else log.success(`${app.name} / ${target.name} is public.`);
+    });
+  });
   const vars = env.command("vars").description("Environment variables");
   vars.command("list", { isDefault: true }).description("List variables (values masked unless --reveal)").option("-a, --app <app>", "app name or id").option("-e, --env <env>", "environment (default: production)").option("--reveal", "print values in clear").action(async (options, command) => {
     const ctx = contextFrom(command);
@@ -3492,7 +3543,6 @@ function printEnvDetails(env) {
     ["Memory", env.memory ?? void 0],
     ["Instances", env.min_instances != null || env.max_instances != null ? `${env.min_instances ?? 0} ${c.dim(sym.arrow)} ${env.max_instances ?? "?"}` : void 0],
     ["Password", env.password_enabled ? "protected" : void 0],
-    ["Region", env.cloud_run_region ?? void 0],
     ["Variables", `${Object.keys(env.environment_vars ?? {}).length}`],
     ["Last deploy", relativeTime(env.last_deployed_at)],
     ["ID", c.dim(env.id)]
@@ -3552,7 +3602,7 @@ function registerInitCommands(program2) {
       outro2(`Linked ${c.bold(app.name)} ${c.dim(sym.arrow)} ${c.dim(file)}`);
     });
   });
-  program2.command("create").description("Create an app from a git repository or a local folder (non-interactive friendly)").option("-n, --name <name>", "app name (default: folder or repository name)").option("-r, --repo <url>", "GitHub repository URL (default: the origin remote)").option("-b, --branch <branch>", "branch to deploy (default: current branch or main)").option("-u, --upload", "upload the folder instead of connecting a repository").option("-d, --dir <path>", "project folder", ".").option("-f, --framework <id>", "framework id (see `lc frameworks`)").option("-t, --type <type>", "deployment type: static or container").option("--build <command>", "build command").option("--output <dir>", "output directory for static sites").option("--port <port>", "container port").option("--root <dir>", "monorepo root directory inside the repository").option("--no-deploy", "create without deploying").option("--no-watch", "do not follow the first deployment").option("--no-link", "do not write a .lightcloud file").action(async (options, command) => {
+  program2.command("create").description("Create an app from a git repository or a local folder (non-interactive friendly)").option("-n, --name <name>", "app name (default: folder or repository name)").option("-r, --repo <url>", "GitHub repository URL (default: the origin remote)").option("-b, --branch <branch>", "branch to deploy (default: current branch or main)").option("-u, --upload", "upload the folder instead of connecting a repository").option("-d, --dir <path>", "project folder", ".").option("-f, --framework <id>", "framework id (see `lc frameworks`)").option("-t, --type <type>", "deployment type: static or container").option("--build <command>", "build command").option("--output <dir>", "output directory for static sites").option("--port <port>", "container port").option("--root <dir>", "monorepo root directory inside the repository").option("--no-deploy", "create without deploying").option("--no-watch", "do not follow the first deployment").option("--no-link", "do not write a .lightcloud file").option("--password <password>", "gate the site behind a visitor password (6-128 characters)").action(async (options, command) => {
     const ctx = contextFrom(command);
     const directory = path9.resolve(options.dir);
     ctx.requireAuth();
@@ -3566,8 +3616,13 @@ function registerInitCommands(program2) {
     }
     let url = app.deployed_url ?? void 0;
     let status = app.status;
+    const env = (app.environments ?? []).find((e) => e.is_production) ?? app.environments?.[0];
+    if (options.password && env) {
+      const org = await ctx.resolveOrg();
+      await ctx.api.setEnvironmentPassword(org.id, env.id, options.password);
+      if (!isJson()) log.info("Visitors will be asked for the password.");
+    }
     if (options.deploy && options.watch) {
-      const env = (app.environments ?? []).find((e) => e.is_production) ?? app.environments?.[0];
       const org = await ctx.resolveOrg();
       const result = await watchResource(ctx.api, env ? { kind: "environment", id: env.id, organisationId: org.id } : { kind: "application", id: app.id, organisationId: org.id });
       url = result.update.deployed_url ?? url;
@@ -3739,6 +3794,15 @@ async function createApp(ctx, directory, options, extra = {}) {
   const name = await pickName(options.name ?? path9.basename(directory), interactive);
   const definition = framework ? getFrameworkById(framework) : void 0;
   const upload = await uploadSource(ctx, directory, { ...detection, framework, deploymentType, buildCommand, outputDirectory });
+  const server = upload.server.detectionSource === "server" ? upload.server : void 0;
+  if (server) {
+    framework = options.framework ?? server.detectedFramework ?? framework;
+    deploymentType = options.type ?? server.detectedDeploymentType ?? deploymentType;
+    buildCommand = options.build ?? server.detectedBuildCommand ?? buildCommand;
+    outputDirectory = options.output ?? server.detectedOutputDirectory ?? outputDirectory;
+    containerPort = options.port ? Number(options.port) : server.detectedContainerPort ?? containerPort;
+  }
+  const finalDefinition = framework ? getFrameworkById(framework) : definition;
   const spinCreate = spinner2();
   spinCreate.start(`Creating ${name}`);
   const app = await ctx.api.createFromUpload({
@@ -3747,7 +3811,7 @@ async function createApp(ctx, directory, options, extra = {}) {
     uploadId: upload.uploadId,
     deploymentType,
     framework: framework ?? (detection.hasDockerfile ? "custom" : void 0),
-    runtime: definition?.runtime ?? (detection.hasDockerfile ? "custom" : void 0),
+    runtime: server?.detectedRuntime ?? finalDefinition?.runtime ?? (detection.hasDockerfile ? "custom" : void 0),
     buildCommand,
     outputDirectory: deploymentType === "static" ? outputDirectory : void 0,
     containerPort: deploymentType === "container" ? containerPort : void 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@light-cloud/cli",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Light Cloud command-line interface: deploy, watch, inspect and manage applications, environments and databases from the terminal.",
   "type": "module",
   "bin": {