@getpara/cli 2.15.0

package/dist/auth/polling-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling-flow.d.ts","sourceRoot":"","sources":["../../src/auth/polling-flow.ts"],"names":[],"mappings":"AACA,OAAO,EAA8C,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEpG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAepD,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsEtH"}

package/dist/auth/polling-flow.js

@@ -0,0 +1,94 @@
+import { randomBytes, createHash } from "node:crypto";
+import { PORTAL_URLS, BASE_URLS, DEV_PORTAL_API_KEY } from "../core/constants.js";
+import { AuthError } from "../core/error-handler.js";
+const POLL_INTERVAL_MS = 2e3;
+const POLL_TIMEOUT_MS = 60 * 1e3;
+function generateCodeVerifier() {
+  return randomBytes(32).toString("base64url").slice(0, 64);
+}
+function generateCodeChallenge(verifier) {
+  return createHash("sha256").update(verifier).digest("base64url");
+}
+async function startPollingLogin(environment, opts = {}) {
+  const { openBrowser = true } = opts;
+  const codeVerifier = generateCodeVerifier();
+  const codeChallenge = generateCodeChallenge(codeVerifier);
+  const portalUrl = PORTAL_URLS[environment];
+  const baseUrl = BASE_URLS[environment];
+  const createResponse = await fetch(`${baseUrl}/cli/auth/session-lookup`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "X-External-API-Key": DEV_PORTAL_API_KEY
+    },
+    body: JSON.stringify({ codeChallenge, codeChallengeMethod: "S256" })
+  });
+  if (!createResponse.ok) {
+    throw new AuthError("Failed to create session lookup. Please try again.");
+  }
+  const { id: lookupId } = await createResponse.json();
+  if (!lookupId) {
+    throw new AuthError("Server returned an invalid session lookup response.");
+  }
+  const loginUrl = `${portalUrl}/cli-auth?lookup_id=${lookupId}`;
+  if (openBrowser) {
+    console.log("Opening browser for authentication...");
+    console.log(`If the browser doesn't open, visit: ${loginUrl}`);
+    try {
+      const { default: open } = await import("open");
+      await open(loginUrl);
+    } catch {
+      console.log(`Open this URL in your browser:
+  ${loginUrl}`);
+    }
+  } else {
+    console.log(`Open this URL in any browser to authenticate:
+  ${loginUrl}`);
+  }
+  const startTime = Date.now();
+  while (Date.now() - startTime < POLL_TIMEOUT_MS) {
+    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+    try {
+      const response = await fetch(`${baseUrl}/cli/auth/session-lookup/${lookupId}/status`, {
+        headers: {
+          "X-External-API-Key": DEV_PORTAL_API_KEY
+        }
+      });
+      if (response.ok) {
+        const data = await response.json();
+        if (data.authenticated && data.code) {
+          return await exchangeCodeForSession(baseUrl, data.code, codeVerifier);
+        }
+      }
+    } catch {
+    }
+  }
+  throw new AuthError("Authentication timed out. Please try again.");
+}
+async function exchangeCodeForSession(baseUrl, code, codeVerifier) {
+  const response = await fetch(`${baseUrl}/cli/auth/callback`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "X-External-API-Key": DEV_PORTAL_API_KEY
+    },
+    body: JSON.stringify({ code, code_verifier: codeVerifier })
+  });
+  if (!response.ok) {
+    throw new AuthError("Failed to exchange authorization code for session.");
+  }
+  const data = await response.json();
+  const sessionId = response.headers.get("x-capsule-sid");
+  if (!sessionId) {
+    throw new AuthError("Server did not return session cookie in x-capsule-sid header");
+  }
+  return {
+    sessionId,
+    userId: data.userId,
+    email: data.email,
+    expiresAt: data.sessionExpiresAt
+  };
+}
+export {
+  startPollingLogin
+};

package/dist/auth/session-manager.d.ts

@@ -0,0 +1,7 @@
+import type { Environment } from '../core/constants.js';
+import type { SessionInfo } from '../core/types.js';
+import { storeSession, clearSession } from '../config/credential-store.js';
+export declare function resolveSession(environment: Environment): Promise<SessionInfo | null>;
+export declare function ensureAuthenticated(environment: Environment): Promise<SessionInfo>;
+export { storeSession, clearSession };
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/auth/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/auth/session-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAc,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGvF,wBAAsB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAE1F;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAuCxF;AAED,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/auth/session-manager.js

@@ -0,0 +1,42 @@
+import { AuthError } from "../core/error-handler.js";
+import { getSession, storeSession, clearSession } from "../config/credential-store.js";
+import { ParaApiClient } from "../api/client.js";
+async function resolveSession(environment) {
+  return getSession(environment);
+}
+async function ensureAuthenticated(environment) {
+  const session = await resolveSession(environment);
+  if (!session) {
+    throw new AuthError("Not authenticated. Run `para login` to authenticate.");
+  }
+  if (session.expiresAt && Date.now() > session.expiresAt) {
+    await clearSession(environment);
+    throw new AuthError("Session expired. Run `para login` to re-authenticate.", true);
+  }
+  try {
+    const client = new ParaApiClient({ environment, sessionId: session.sessionId });
+    const status = await client.getAuthStatus();
+    const updated = {
+      sessionId: session.sessionId,
+      userId: status.userId || session.userId,
+      email: status.email || session.email,
+      expiresAt: status.sessionExpiresAt ?? session.expiresAt
+    };
+    if (updated.email !== session.email || updated.userId !== session.userId || updated.expiresAt !== session.expiresAt) {
+      await storeSession(environment, updated);
+    }
+    return updated;
+  } catch (error) {
+    if (error instanceof AuthError) {
+      await clearSession(environment);
+      throw new AuthError("Session is no longer valid. Run `para login` to re-authenticate.", true);
+    }
+    throw error;
+  }
+}
+export {
+  clearSession,
+  ensureAuthenticated,
+  resolveSession,
+  storeSession
+};

package/dist/cli.d.ts

@@ -0,0 +1,16 @@
+import { Command } from 'commander';
+import type { GlobalOptions } from './core/types.js';
+import { OutputFormatter } from './output/formatter.js';
+/**
+ * Build help text with global options + examples for a command.
+ * Use with `.addHelpText('after', helpText('Examples:\n  $ para ...'))`.
+ */
+export declare function helpText(examples: string): string;
+/**
+ * Add examples and global options reference to a command's help output.
+ */
+export declare function addExamples(cmd: Command, examples: string): void;
+export declare function getGlobalOptions(cmd: Command): Promise<GlobalOptions>;
+export declare function createFormatter(opts: GlobalOptions): OutputFormatter;
+export declare function cli(argv: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAwBxD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEhE;AAsFD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA6B3E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe,CAKpE;AAED,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CvD"}

package/dist/cli.js

@@ -0,0 +1,151 @@
+import { Command } from "commander";
+import { CLI_VERSION, CLI_NAME, DEFAULT_ENVIRONMENT, parseEnvironment } from "./core/constants.js";
+import { OutputFormatter } from "./output/formatter.js";
+import { handleError, setJsonMode } from "./core/error-handler.js";
+import { setNonInteractive } from "./output/prompts.js";
+import { startUpdateCheck } from "./core/update-check.js";
+import { readGlobalConfig } from "./config/config-store.js";
+import { readProjectConfig } from "./config/project-config.js";
+function isCi() {
+  return !!(process.env["CI"] || process.env["CONTINUOUS_INTEGRATION"] || process.env["BUILD_NUMBER"]);
+}
+const GLOBAL_OPTIONS_TEXT = `
+Global Options:
+  -e, --environment <env>  Target environment (default: BETA)
+  --json                   Output as JSON
+  --org <id>               Organization ID override
+  --project <id>           Project ID override
+  -q, --quiet              Suppress non-essential output
+  --no-input               Disable interactive prompts (auto-detected in CI)`;
+function helpText(examples) {
+  return `${GLOBAL_OPTIONS_TEXT}
+${examples}`;
+}
+function addExamples(cmd, examples) {
+  cmd.addHelpText("after", `${GLOBAL_OPTIONS_TEXT}
+${examples}`);
+}
+const GROUPED_COMMANDS_TEXT = `
+Getting started:
+  1. para login              Sign in via the developer portal
+  2. para orgs switch        Pick your organization
+  3. para projects switch    Pick your project
+  4. para keys list          View your API keys
+
+Auth:
+  login [options]            Sign in via the Para developer portal
+  logout [options]           Clear stored credentials
+  whoami                     Show current user, org, and project context
+
+Resources:
+  orgs                       List and switch organizations
+  projects                   List, create, update, archive, and restore projects
+  keys                       Manage API keys: list, create, rotate, archive, config
+
+Setup:
+  create [options] [name]    Scaffold a new Para-powered app from a template
+  init [options]             Save current org/project/env to .pararc
+  config                     View or update CLI defaults
+  doctor [options] [path]    Check a project for common SDK issues
+
+Run "para <command> --help" for more information on a specific command.
+`;
+function createProgram() {
+  const program = new Command().name(CLI_NAME).description("Unified CLI for Para SDK").version(CLI_VERSION, "-v, --version").option("--json", "Output as JSON", false).option("-e, --environment <env>", "Target environment (default: BETA)", (value) => parseEnvironment(value)).option("--org <id>", "Organization ID override").option("--project <id>", "Project ID override").option("-q, --quiet", "Suppress non-essential output", false).option("--no-input", "Disable interactive prompts (auto-detected in CI)").showHelpAfterError('Run "para --help" for available commands.').exitOverride();
+  const originalHelpInfo = program.helpInformation.bind(program);
+  program.helpInformation = function() {
+    if (this.parent) {
+      return originalHelpInfo.call(this);
+    }
+    const lines = [];
+    lines.push(`Usage: ${this.name()} [options] [command]
+`);
+    lines.push(this.description() + "\n");
+    const opts = this.options;
+    const allFlags = [
+      ...opts.map((o) => ({ flags: o.flags, desc: o.description })),
+      { flags: "-h, --help", desc: "Display help for command" }
+    ];
+    lines.push("Options:");
+    for (const { flags, desc } of allFlags) {
+      const padding = 27 - flags.length;
+      lines.push(`  ${flags}${" ".repeat(Math.max(1, padding))}${desc}`);
+    }
+    lines.push("");
+    lines.push(GROUPED_COMMANDS_TEXT);
+    return lines.join("\n");
+  };
+  if (process.env["NO_COLOR"]) {
+    process.env["FORCE_COLOR"] = "0";
+  }
+  return program;
+}
+async function getGlobalOptions(cmd) {
+  const opts = cmd.optsWithGlobals();
+  let environment;
+  if (opts.environment) {
+    environment = parseEnvironment(opts.environment);
+  } else {
+    const projectConfig = await readProjectConfig(process.cwd()).catch(() => ({}));
+    const globalConfig = await readGlobalConfig();
+    const configEnv = projectConfig.environment ?? globalConfig.defaultEnvironment;
+    environment = configEnv ? parseEnvironment(configEnv) : DEFAULT_ENVIRONMENT;
+  }
+  const json = opts.json ?? false;
+  if (json) setJsonMode(true);
+  const noInput = opts.input === false || isCi();
+  if (noInput) setNonInteractive(true);
+  return {
+    json,
+    environment,
+    org: opts.org,
+    project: opts.project,
+    quiet: opts.quiet ?? false,
+    noInput
+  };
+}
+function createFormatter(opts) {
+  return new OutputFormatter({
+    json: opts.json,
+    quiet: opts.quiet
+  });
+}
+async function cli(argv) {
+  if (argv.includes("--json")) setJsonMode(true);
+  if (argv.includes("--no-input") || isCi()) setNonInteractive(true);
+  const isQuiet = argv.includes("--json") || argv.includes("-q") || argv.includes("--quiet");
+  const showUpdate = !isQuiet && !isCi() ? startUpdateCheck() : null;
+  const program = createProgram();
+  const { registerDoctorCommand } = await import("./commands/doctor.js");
+  registerDoctorCommand(program);
+  const { registerCreateCommand } = await import("./commands/create.js");
+  registerCreateCommand(program);
+  const { registerInitCommand } = await import("./commands/init.js");
+  registerInitCommand(program);
+  const { registerConfigCommand } = await import("./commands/config.js");
+  registerConfigCommand(program);
+  const { registerAuthCommands } = await import("./commands/auth/index.js");
+  registerAuthCommands(program);
+  const { registerWhoamiCommand } = await import("./commands/whoami.js");
+  registerWhoamiCommand(program);
+  const { registerOrgsCommands } = await import("./commands/orgs/index.js");
+  registerOrgsCommands(program);
+  const { registerProjectsCommands } = await import("./commands/projects/index.js");
+  registerProjectsCommands(program);
+  const { registerKeysCommands } = await import("./commands/keys/index.js");
+  registerKeysCommands(program);
+  try {
+    await program.parseAsync(argv);
+    await showUpdate?.();
+  } catch (error) {
+    await showUpdate?.();
+    handleError(error);
+  }
+}
+export {
+  addExamples,
+  cli,
+  createFormatter,
+  getGlobalOptions,
+  helpText
+};

package/dist/commands/auth/index.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerAuthCommands(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmB3D"}

package/dist/commands/auth/index.js

@@ -0,0 +1,18 @@
+import { registerLoginCommand } from "./login.js";
+import { registerLogoutCommand } from "./logout.js";
+import { registerAuthStatusCommand } from "./status.js";
+function registerAuthCommands(program) {
+  const auth = program.command("auth").description("Authentication commands (login, logout, status)").addHelpText(
+    "after",
+    `
+Tip: "para login" and "para logout" also work as top-level shortcuts.`
+  );
+  registerLoginCommand(auth);
+  registerLogoutCommand(auth);
+  registerAuthStatusCommand(auth);
+  registerLoginCommand(program);
+  registerLogoutCommand(program);
+}
+export {
+  registerAuthCommands
+};

package/dist/commands/auth/login.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerLoginCommand(parent: Command): void;
+//# sourceMappingURL=login.d.ts.map

package/dist/commands/auth/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/login.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA8C1D"}

package/dist/commands/auth/login.js

@@ -0,0 +1,70 @@
+import { getGlobalOptions, createFormatter, addExamples } from "../../cli.js";
+import { ensureAuthenticated, storeSession } from "../../auth/session-manager.js";
+import { startPollingLogin } from "../../auth/polling-flow.js";
+import { createSpinner } from "../../output/spinner.js";
+import { ParaApiClient } from "../../api/client.js";
+import { updateGlobalConfig } from "../../config/config-store.js";
+function registerLoginCommand(parent) {
+  const cmd = parent.command("login").description("Authenticate with your Para developer account").option("--no-browser", "Use URL-based authentication (for headless environments)").action(async (cmdOpts, actionCmd) => {
+    const opts = await getGlobalOptions(actionCmd);
+    const formatter = createFormatter(opts);
+    try {
+      const existing = await ensureAuthenticated(opts.environment);
+      formatter.success(`Already authenticated as ${existing.email || existing.userId}`);
+      formatter.flush();
+      return;
+    } catch {
+    }
+    const spinner = createSpinner();
+    spinner.start("Waiting for browser authentication...");
+    const session = await startPollingLogin(opts.environment, {
+      openBrowser: cmdOpts.browser
+    });
+    spinner.stop("Browser authentication complete.");
+    await storeSession(opts.environment, session);
+    formatter.json({ email: session.email, userId: session.userId, environment: opts.environment });
+    formatter.success(`Authenticated as ${session.email || session.userId}`);
+    await autoResolveContext(session, opts.environment, formatter);
+    formatter.flush();
+  });
+  addExamples(
+    cmd,
+    `Examples:
+  $ para login                    Opens the developer portal \u2014 sign in and the CLI picks up your session
+  $ para login --no-browser       Prints a URL to open manually (useful for SSH/CI)
+  $ para login -e DEV             Sign in against a local dev server`
+  );
+}
+async function autoResolveContext(session, environment, formatter) {
+  try {
+    const client = new ParaApiClient({ environment, sessionId: session.sessionId });
+    let userId = session.userId;
+    if (!userId) {
+      const status = await client.getAuthStatus();
+      userId = status.userId ?? "";
+    }
+    if (!userId) return;
+    const orgs = await client.getOrganizations(userId);
+    if (orgs.length === 0) return;
+    const org = orgs[0];
+    const updates = { defaultOrganizationId: org.id };
+    formatter.info(`Active organization: ${org.name} (${org.id})`);
+    if (orgs.length > 1) {
+      formatter.info(`  You have ${orgs.length} organizations. Run \`para orgs switch\` to change.`);
+    }
+    const projects = await client.getProjects(org.id);
+    const active = projects.filter((p) => !p.archived);
+    if (active.length > 0) {
+      updates.defaultProjectId = active[0].id;
+      formatter.info(`Active project: ${active[0].name} (${active[0].id})`);
+      if (active.length > 1) {
+        formatter.info(`  You have ${active.length} projects. Run \`para projects switch\` to change.`);
+      }
+    }
+    await updateGlobalConfig(updates);
+  } catch {
+  }
+}
+export {
+  registerLoginCommand
+};

package/dist/commands/auth/logout.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerLogoutCommand(parent: Command): void;
+//# sourceMappingURL=logout.d.ts.map

package/dist/commands/auth/logout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/logout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA8C3D"}

package/dist/commands/auth/logout.js

@@ -0,0 +1,45 @@
+import { getGlobalOptions, createFormatter, addExamples } from "../../cli.js";
+import { resolveSession } from "../../auth/session-manager.js";
+import { clearSession, clearAllSessions } from "../../config/credential-store.js";
+import { updateGlobalConfig } from "../../config/config-store.js";
+import { ParaApiClient } from "../../api/client.js";
+function registerLogoutCommand(parent) {
+  const cmd = parent.command("logout").description("Clear stored authentication credentials").option("--all", "Clear sessions for all environments").action(async (cmdOpts, actionCmd) => {
+    const opts = await getGlobalOptions(actionCmd);
+    const formatter = createFormatter(opts);
+    try {
+      const session = await resolveSession(opts.environment);
+      if (session?.sessionId) {
+        const client = new ParaApiClient({
+          environment: opts.environment,
+          sessionId: session.sessionId
+        });
+        await client.logout().catch(() => {
+        });
+      }
+    } catch {
+    }
+    if (cmdOpts.all) {
+      await clearAllSessions();
+      await updateGlobalConfig({ defaultOrganizationId: void 0, defaultProjectId: void 0 });
+      formatter.json({ loggedOut: true, scope: "all" });
+      formatter.success("Cleared all stored sessions and context.");
+    } else {
+      await clearSession(opts.environment);
+      await updateGlobalConfig({ defaultOrganizationId: void 0, defaultProjectId: void 0 });
+      formatter.json({ loggedOut: true, scope: opts.environment });
+      formatter.success(`Cleared session and context for ${opts.environment} environment.`);
+    }
+    formatter.flush();
+  });
+  addExamples(
+    cmd,
+    `Examples:
+  $ para logout                   Sign out of the current environment (BETA by default)
+  $ para logout --all             Sign out of every environment at once
+  $ para logout -e PROD           Sign out of production only`
+  );
+}
+export {
+  registerLogoutCommand
+};

package/dist/commands/auth/status.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerAuthStatusCommand(parent: Command): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/auth/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAuD/D"}

package/dist/commands/auth/status.js

@@ -0,0 +1,54 @@
+import { getGlobalOptions, createFormatter, addExamples } from "../../cli.js";
+import { ensureAuthenticated } from "../../auth/session-manager.js";
+import { AuthError } from "../../core/error-handler.js";
+function registerAuthStatusCommand(parent) {
+  const cmd = parent.command("status").description("Check authentication status (server-validated)").action(async (_, actionCmd) => {
+    const opts = await getGlobalOptions(actionCmd);
+    const formatter = createFormatter(opts);
+    try {
+      const session = await ensureAuthenticated(opts.environment);
+      if (opts.json) {
+        formatter.json({
+          authenticated: true,
+          environment: opts.environment,
+          email: session.email || void 0,
+          userId: session.userId || void 0,
+          expiresAt: session.expiresAt || void 0
+        });
+      } else {
+        formatter.detail([
+          { label: "Status", value: "Authenticated" },
+          { label: "Environment", value: opts.environment },
+          ...session.email ? [{ label: "Email", value: session.email }] : [],
+          ...session.expiresAt ? [
+            {
+              label: "Expires",
+              value: new Date(session.expiresAt).toLocaleString()
+            }
+          ] : []
+        ]);
+      }
+    } catch (error) {
+      if (error instanceof AuthError) {
+        if (opts.json) {
+          formatter.json({ authenticated: false, environment: opts.environment });
+        } else {
+          formatter.warn(error.message);
+        }
+      } else {
+        throw error;
+      }
+    }
+    formatter.flush();
+  });
+  addExamples(
+    cmd,
+    `Examples:
+  $ para auth status              Show session validity, email, and expiration
+  $ para auth status -e PROD      Check auth for a specific environment
+  $ para auth status --json       Output status as JSON (useful in scripts)`
+  );
+}
+export {
+  registerAuthStatusCommand
+};

package/dist/commands/config.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerConfigCommand(program: Command): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4I5D"}