@rebasepro/cli 0.9.1-canary.d198c11 → 0.9.1-canary.d906fb7

package/dist/commands/cloud/context.d.ts

@@ -28,9 +28,42 @@ export declare function requireClient(rawArgs: string[]): Promise<{
     client: CloudClient;
     url: string;
 }>;
+export declare function fetchTenantBaseDomain(client: CloudClient, url: string): Promise<string | undefined>;
+/**
+ * Public host for a project — `<subdomain>.<base>`, or the bare subdomain when
+ * the base domain is unknown.
+ *
+ * It deliberately never falls back to a guessed domain. The user copies this
+ * string into a browser, so a plausible-but-wrong hostname is worse than an
+ * obviously incomplete one: `acme.rebase.pro` looks reachable and isn't, while
+ * `acme` reads as "the subdomain is acme" and prompts no wasted debugging.
+ */
+export declare function formatTenantHost(subdomain: string | undefined, baseDomain: string | undefined): string | undefined;
+/** The fields of a project row this module needs to render a host. */
+export interface HostableProject {
+    subdomain?: string;
+    /** Resolved server-side; absent on control planes older than the host hook. */
+    host?: string;
+}
+/**
+ * The host to display for a project.
+ *
+ * Prefers `host` off the record: the control plane resolves it through the same
+ * `tenantHost()` the ingress uses, so it accounts for the project's *cluster*
+ * base domain. The CLI cannot compute that itself — `clusters` is admin-only
+ * under RLS, so a normal user's token cannot read `baseDomain`, and a project on
+ * a second cluster is served somewhere the platform default does not name.
+ *
+ * `baseDomain` (from `platform-config`) remains the fallback for a control plane
+ * that predates the hook — right for the single-cluster case, which is every
+ * project today.
+ */
+export declare function projectHost(project: HostableProject, baseDomain: string | undefined): string | undefined;
 export interface ProjectLink {
     url: string;
     projectId: string;
+    /** The project's subdomain — the slug users see in console URLs and type into --project. */
+    slug?: string;
     projectName?: string;
     orgId?: string;
 }
@@ -38,17 +71,80 @@ export declare function readLink(cwd?: string): ProjectLink | null;
 export declare function writeLink(link: ProjectLink, cwd?: string): void;
 export declare function removeLink(cwd?: string): boolean;
 /**
- * Resolve the project id to operate on: explicit `--project` flag wins,
+ * The raw project reference to operate on: explicit `--project` flag wins,
  * otherwise the linked project. Exits with guidance when neither is present.
+ * The value is a slug (the project's subdomain, as shown in console URLs) or,
+ * for old scripts and link files, a raw project UUID.
  */
-export declare function requireProjectId(rawArgs: string[]): string;
+export declare function requireProjectRef(rawArgs: string[]): string;
+/**
+ * Resolve a project reference — slug or UUID — to the internal id the API
+ * takes, or undefined when no such project is visible. Slugs cost one lookup;
+ * UUIDs pass through untouched so linked directories and old scripts skip the
+ * round-trip.
+ */
+export declare function lookupProjectId(ref: string, client: CloudClient): Promise<string | undefined>;
+/** Like `lookupProjectId`, but exits with guidance when the ref matches nothing. */
+export declare function resolveProjectRef(ref: string, client: CloudClient): Promise<string>;
+/** `requireProjectRef` + `resolveProjectRef` in one step. */
+export declare function requireProject(rawArgs: string[], client: CloudClient): Promise<string>;
+/**
+ * The project reference to SHOW: the slug the user typed or the linked slug.
+ * Never resolves — for human output only. Old link files predate `slug` and
+ * fall back to the stored id.
+ */
+export declare function displayProjectRef(rawArgs: string[]): string;
+/**
+ * Resolve and latch the output mode for this invocation. Call once at the top of
+ * `cloudCommand`, before anything can print or `fail`. Returns the resolved mode
+ * (handy for tests, which otherwise leave it at its `false` default).
+ */
+export declare function initOutputMode(rawArgs: string[]): boolean;
+/** Whether the current invocation is emitting machine-readable JSON. */
+export declare function isJsonMode(): boolean;
+/** Force the mode (tests only — production latches it via `initOutputMode`). */
+export declare function setJsonModeForTest(value: boolean): void;
+/** Write one JSON value to stdout, followed by a newline. */
+export declare function printJson(value: unknown): void;
+/**
+ * The one output primitive every new command uses: in JSON mode emit `json`
+ * (and nothing else); otherwise run `human`. Keeping the two behind a single
+ * call is what guarantees a command can never print a table AND a JSON blob.
+ */
+export declare function emit(human: () => void, json: unknown): void;
 /** Print an error (+ optional hint) and exit non-zero. Never returns. */
-export declare function fail(message: string, hint?: string): never;
+export declare function fail(message: string, hint?: string, code?: string): never;
+/**
+ * Confirm a destructive/irreversible action, respecting non-interactive use.
+ *
+ * With `--yes`/`-y` it proceeds silently. In JSON mode or a non-TTY it REFUSES
+ * to prompt — a prompt that can hang is a known repo landmine — and fails,
+ * telling the caller to pass `--yes`. Only an interactive terminal gets a real
+ * confirm prompt; declining there aborts cleanly (exit 0).
+ */
+export declare function confirmDestructive(opts: {
+    yes: boolean;
+    prompt: string;
+}): Promise<void>;
+/**
+ * Positional tokens after `rebase cloud` — `[group, action, arg1, …]`.
+ *
+ * Deliberately NOT `arg({}, { permissive: true })._`: in permissive mode `arg`
+ * pushes UNKNOWN FLAGS onto `_` too, so `rollback --yes --json` would report
+ * `--yes` as the deployment id. Operand extraction must see operands only, so
+ * anything starting with `-` is dropped — the same filter the db backup handler
+ * has always used.
+ */
+export declare function cloudPositionals(rawArgs: string[]): string[];
 export declare function success(message: string): void;
 /** Colorize a deployment / resource status token. */
 export declare function colorStatus(status: string | undefined): string;
-/** Render a two-column key/value block with aligned keys. */
-export declare function keyValues(rows: Array<[string, string | undefined]>): void;
+/**
+ * Render a two-column key/value block with aligned keys. Empty rows are skipped
+ * — including `null`, which the API sends for an unset column and which used to
+ * print the literal string "null" (e.g. `Custom domain: null`).
+ */
+export declare function keyValues(rows: Array<[string, string | null | undefined]>): void;
 /**
  * Surface an SDK/HTTP error consistently. The SDK throws RebaseApiError with
  * a `.status` and `.message`; anything else falls back to its string form.

package/dist/commands/cloud/deploy.d.ts

@@ -1,2 +1,2 @@
-export declare function deployCommand(rawArgs: string[], projectId: string): Promise<void>;
-export declare function logsCommand(rawArgs: string[], projectId: string): Promise<void>;
+export declare function deployCommand(rawArgs: string[], projectRef: string): Promise<void>;
+export declare function logsCommand(rawArgs: string[], projectRef: string): Promise<void>;

package/dist/commands/cloud/deployments.d.ts

@@ -0,0 +1,39 @@
+/** A deployment row, as the data API hands it back (camel or snake columns). */
+export interface DeploymentRow {
+    id: string | number;
+    status?: string;
+    createdAt?: string | Date;
+    created_at?: string | Date;
+    finishedAt?: string | Date;
+    finished_at?: string | Date;
+    imageUrl?: string;
+    image_url?: string;
+    rollbackOf?: string;
+    rollback_of?: string;
+    triggeredBy?: string;
+    triggered_by?: string;
+    triggerSource?: string;
+    trigger_source?: string;
+    triggeredByUserId?: string;
+    triggered_by_user_id?: string;
+    gitCommitHash?: string;
+    gitCommitMessage?: string;
+}
+export declare function deploymentImage(dep: DeploymentRow): string | null;
+/**
+ * The backend's rule EXACTLY: a rollback is honoured only for a successful
+ * deploy that recorded an image. Any other row 409s `deploy_not_rollbackable`.
+ */
+export declare function isRollbackable(dep: DeploymentRow): boolean;
+/** finishedAt − createdAt in ms, or null (still running / missing / skewed). */
+export declare function deploymentDurationMs(dep: DeploymentRow): number | null;
+export declare function triggerInfo(dep: DeploymentRow): {
+    by: string;
+    source: string;
+    userId: string;
+};
+/** Shape one deployment row into the stable JSON view the CLI publishes. */
+export declare function deploymentView(dep: DeploymentRow): Record<string, unknown>;
+export declare function deploymentsListCommand(rawArgs: string[]): Promise<void>;
+export declare function rollbackCommand(rawArgs: string[]): Promise<void>;
+export declare function cancelCommand(rawArgs: string[]): Promise<void>;

package/dist/commands/cloud/domains.d.ts

@@ -0,0 +1 @@
+export declare function domainsCommand(action: string | undefined, rawArgs: string[]): Promise<void>;

package/dist/commands/cloud/env.d.ts

@@ -0,0 +1,6 @@
+export declare function envCommand(action: string | undefined, rawArgs: string[]): Promise<void>;
+/** Parse `KEY=VALUE` or `KEY VALUE` from the positional operands. */
+export declare function parseEnvAssignment(operands: string[]): {
+    key: string;
+    value: string;
+} | null;

package/dist/commands/cloud/extensions.d.ts

@@ -0,0 +1,3 @@
+/** The identifier CREATE EXTENSION takes. `pgvector` is a common alias. */
+export declare function resolveExtensionAlias(name: string): string;
+export declare function extensionsCommand(action: string | undefined, rawArgs: string[]): Promise<void>;

package/dist/commands/cloud/power.d.ts

@@ -0,0 +1,4 @@
+type PowerAction = "start" | "stop" | "restart";
+export declare function powerCommand(action: PowerAction, rawArgs: string[]): Promise<void>;
+export declare function isPowerAction(v: string | undefined): v is PowerAction;
+export {};

package/dist/commands/cloud/projects.d.ts

@@ -1,8 +1,8 @@
 import { type CloudClient } from "./context";
 export declare function listProjects(rawArgs: string[]): Promise<void>;
 export declare function createProject(rawArgs: string[]): Promise<void>;
-export declare function projectInfo(rawArgs: string[], projectId: string): Promise<void>;
-export declare function deleteProject(rawArgs: string[], projectId: string): Promise<void>;
+export declare function projectInfo(rawArgs: string[], projectRef: string): Promise<void>;
+export declare function deleteProject(rawArgs: string[], projectRef: string): Promise<void>;
 export declare function firstRow(client: CloudClient, collection: string, projectId: string): Promise<Record<string, unknown> | undefined>;
 export declare function latestDeployment(client: CloudClient, projectId: string): Promise<{
     id: string | number;

package/dist/commands/cloud/settings.d.ts

@@ -0,0 +1,8 @@
+export declare function settingsCommand(action: string | undefined, rawArgs: string[]): Promise<void>;
+/** Build the update patch from the flags actually supplied (pure/testable). */
+export declare function buildSettingsPatch(args: {
+    name?: string;
+    subdomain?: string;
+    repo?: string;
+    branch?: string;
+}): Record<string, string>;

package/dist/commands/init.d.ts

@@ -1,4 +1,6 @@
 import type { PackageManager, PMCommands } from "../utils/package-manager";
+/** Returns an error message, or null when the name is a valid package name. */
+export declare function validateProjectName(name: string): string | null;
 export type TemplatePreset = "blog" | "ecommerce" | "blank";
 /**
  * How much of Rebase to scaffold.
@@ -28,6 +30,12 @@ export interface InitOptions {
     pm: PackageManager;
     /** Command helpers for the detected PM. */
     pmCommands: PMCommands;
+    /** Cloud project slug (its subdomain) to link the scaffold to. */
+    cloudProject?: string;
+    /** One-time setup key that authenticates the cloud link. */
+    setupKey?: string;
+    /** Control-plane URL the setup key is redeemed against. */
+    cloudUrl?: string;
 }
 export interface BuildQuestionsParams {
     nameArg?: string;