@catladder/cli 0.0.0-next-95928577 → 0.0.0-next-e7541a00

package/dist/cli/src/core/index.js

@@ -0,0 +1,52 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.runCommand = exports.getCommandsByGroup = exports.getAllCommands = exports.getCommand = exports.registerCommand = exports.defineCommand = exports.MissingInputError = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "MissingInputError", {
+  enumerable: true,
+  get: function () {
+    return types_1.MissingInputError;
+  }
+});
+var defineCommand_1 = require("./defineCommand");
+Object.defineProperty(exports, "defineCommand", {
+  enumerable: true,
+  get: function () {
+    return defineCommand_1.defineCommand;
+  }
+});
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "registerCommand", {
+  enumerable: true,
+  get: function () {
+    return registry_1.registerCommand;
+  }
+});
+Object.defineProperty(exports, "getCommand", {
+  enumerable: true,
+  get: function () {
+    return registry_1.getCommand;
+  }
+});
+Object.defineProperty(exports, "getAllCommands", {
+  enumerable: true,
+  get: function () {
+    return registry_1.getAllCommands;
+  }
+});
+Object.defineProperty(exports, "getCommandsByGroup", {
+  enumerable: true,
+  get: function () {
+    return registry_1.getCommandsByGroup;
+  }
+});
+var runner_1 = require("./runner");
+Object.defineProperty(exports, "runCommand", {
+  enumerable: true,
+  get: function () {
+    return runner_1.runCommand;
+  }
+});

package/dist/cli/src/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/index.ts"],"names":[],"mappings":";;;AAcA,iCAA4C;AAAnC,0GAAA,iBAAiB,OAAA;AAC1B,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,uCAKoB;AAJlB,2GAAA,eAAe,OAAA;AACf,sGAAA,UAAU,OAAA;AACV,0GAAA,cAAc,OAAA;AACd,8GAAA,kBAAkB,OAAA;AAEpB,mCAAsC;AAA7B,oGAAA,UAAU,OAAA"}

package/dist/cli/src/core/registry.d.ts

@@ -0,0 +1,5 @@
+import type { CommandDef } from "./types";
+export declare function registerCommand(def: CommandDef): void;
+export declare function getCommand(name: string): CommandDef | undefined;
+export declare function getAllCommands(): CommandDef[];
+export declare function getCommandsByGroup(group: string): CommandDef[];

package/dist/cli/src/core/registry.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getCommandsByGroup = exports.getAllCommands = exports.getCommand = exports.registerCommand = void 0;
+const commands = new Map();
+function registerCommand(def) {
+  if (commands.has(def.name)) {
+    throw new Error(`Command "${def.name}" is already registered`);
+  }
+  commands.set(def.name, def);
+}
+exports.registerCommand = registerCommand;
+function getCommand(name) {
+  return commands.get(name);
+}
+exports.getCommand = getCommand;
+function getAllCommands() {
+  return Array.from(commands.values());
+}
+exports.getAllCommands = getAllCommands;
+function getCommandsByGroup(group) {
+  return getAllCommands().filter(c => c.group === group);
+}
+exports.getCommandsByGroup = getCommandsByGroup;

package/dist/cli/src/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/core/registry.ts"],"names":[],"mappings":";;;AAEA,MAAM,QAAQ,GAA4B,IAAI,GAAG,EAAE,CAAC;AAEpD,SAAgB,eAAe,CAAC,GAAe;IAC7C,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC,IAAI,yBAAyB,CAAC,CAAC;IACjE,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC;AALD,0CAKC;AAED,SAAgB,UAAU,CAAC,IAAY;IACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAFD,gCAEC;AAED,SAAgB,cAAc;IAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC;AAFD,wCAEC;AAED,SAAgB,kBAAkB,CAAC,KAAa;IAC9C,OAAO,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AAC3D,CAAC;AAFD,gDAEC"}

package/dist/cli/src/core/runner.d.ts

@@ -0,0 +1,19 @@
+import type { CommandDef, InputsSchema } from "./types";
+/**
+ * Run a command programmatically.
+ * This is the main entry point for calling commands from code.
+ *
+ * @example
+ * ```ts
+ * import { commandPortForward } from "./commands/project/portForward";
+ * import { runCommand } from "./core/runner";
+ *
+ * await runCommand(commandPortForward, {
+ *   inputs: { envComponent: "dev:web", podName: "web-abc", localPort: 3000, remotePort: 3000 },
+ * });
+ * ```
+ */
+export declare function runCommand<TInputs extends InputsSchema>(command: CommandDef<TInputs>, options?: {
+  inputs?: Record<string, unknown>;
+  onLog?: (message: string) => void;
+}): Promise<void>;

package/dist/cli/src/core/runner.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.runCommand = void 0;
+const programmatic_1 = require("../adapters/programmatic");
+/**
+ * Run a command programmatically.
+ * This is the main entry point for calling commands from code.
+ *
+ * @example
+ * ```ts
+ * import { commandPortForward } from "./commands/project/portForward";
+ * import { runCommand } from "./core/runner";
+ *
+ * await runCommand(commandPortForward, {
+ *   inputs: { envComponent: "dev:web", podName: "web-abc", localPort: 3000, remotePort: 3000 },
+ * });
+ * ```
+ */
+async function runCommand(command, options = {}) {
+  const ctx = (0, programmatic_1.createProgrammaticContext)(command, {
+    inputs: options.inputs,
+    onLog: options.onLog
+  });
+  await command.execute(ctx);
+}
+exports.runCommand = runCommand;

package/dist/cli/src/core/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../../src/core/runner.ts"],"names":[],"mappings":";;;AACA,2DAAqE;AAErE;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,UAAU,CAC9B,OAA4B,EAC5B,UAGI,EAAE;IAEN,MAAM,GAAG,GAAG,IAAA,wCAAyB,EAAC,OAAO,EAAE;QAC7C,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAbD,gCAaC"}

package/dist/cli/src/core/types.d.ts

@@ -0,0 +1,107 @@
+import type { ComponentContext } from "../../../pipeline/src/index.js";
+export type PromptChoice = string | {
+  name: string;
+  value: string;
+};
+/**
+ * Function that returns choices for an input.
+ * Receives the command context so it can resolve other inputs first.
+ */
+export type ChoicesFn<TCtx = any> = (ctx: TCtx) => PromptChoice[] | Promise<PromptChoice[]>;
+export type StringInputDef = {
+  type: "string";
+  message: string;
+  default?: string;
+  positional?: boolean;
+  required?: boolean;
+  /** If provided, renders as a list selection in interactive mode */
+  choices?: ChoicesFn;
+};
+export type StringArrayInputDef = {
+  type: "string[]";
+  message: string;
+  positional?: boolean;
+  required?: boolean;
+  /** If provided, renders as checkboxes in interactive mode */
+  choices?: ChoicesFn;
+};
+export type NumberInputDef = {
+  type: "number";
+  message: string;
+  default?: number;
+  positional?: boolean;
+  required?: boolean;
+};
+export type BooleanInputDef = {
+  type: "boolean";
+  message: string;
+  default?: boolean;
+  positional?: boolean;
+  required?: boolean;
+};
+export type InputDef = StringInputDef | StringArrayInputDef | NumberInputDef | BooleanInputDef;
+/** Map an InputDef to its resolved TypeScript value type */
+export type InputResultType<P extends InputDef> = P extends {
+  type: "string";
+} ? string : P extends {
+  type: "string[]";
+} ? string[] : P extends {
+  type: "number";
+} ? number : P extends {
+  type: "boolean";
+} ? boolean : never;
+export type InputsSchema = Record<string, InputDef>;
+/**
+ * Base IO interface for helper functions that need to log or prompt.
+ * Helpers use `promptDirect` for ad-hoc prompts (confirmations, sub-selections)
+ * that are NOT part of a command's declared input schema.
+ */
+export interface IO {
+  log(message: string): void;
+  /**
+   * Ask for confirmation. Returns true/false.
+   * Skipped (returns true) when --yes is active.
+   * Throws or returns false on decline, depending on the adapter.
+   */
+  confirm(message: string): Promise<boolean>;
+  promptDirect<P extends InputDef>(spec: P & {
+    name: string;
+  }): Promise<InputResultType<P>>;
+}
+/**
+ * Runtime context passed to command execute functions.
+ * Extends IO so it can be passed to helpers that only need log + promptDirect.
+ *
+ * - `get(name)`: consume a declared input by name (type-safe).
+ *   Returns the value if already provided (positional arg, CLI flag, JSON),
+ *   or prompts for it interactively, or throws if non-interactive.
+ * - `log(message)`: output a message.
+ * - `promptDirect(spec)`: ad-hoc prompt for helpers (not type-checked against schema).
+ */
+export interface CommandContext<TInputs extends InputsSchema> extends IO {
+  /**
+   * Consume a declared input by name.
+   * - Compile error if `name` is not in TInputs
+   * - Return type matches the input's type (string, number, boolean, string[])
+   * - If `required: false`, returns `undefined` when not provided (no prompt)
+   * - Otherwise: pre-supplied value > choices function + interactive prompt > default > throw
+   */
+  get<K extends keyof TInputs & string>(name: K): Promise<OptionalInput<TInputs[K]>>;
+}
+/** If the input has `required: false`, the result can be undefined */
+export type OptionalInput<T extends InputDef> = T extends {
+  required: false;
+} ? InputResultType<T> | undefined : InputResultType<T>;
+export interface CommandDef<TInputs extends InputsSchema = InputsSchema> {
+  name: string;
+  description: string;
+  group?: string;
+  inputs: TInputs;
+  isAvailable?: (contexts: ComponentContext[]) => boolean;
+  execute: (ctx: CommandContext<TInputs>) => Promise<void>;
+}
+export declare class MissingInputError extends Error {
+  readonly inputName: string;
+  readonly promptMessage: string;
+  constructor(inputName: string, promptMessage: string);
+}

package/dist/cli/src/core/types.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.MissingInputError = void 0;
+// ─── Errors ──────────────────────────────────────────────────────────
+class MissingInputError extends Error {
+  constructor(inputName, promptMessage) {
+    super(`Missing required input: "${inputName}" (${promptMessage}). ` + `Provide it via --${inputName}=<value> or --inputs='{"${inputName}": ...}'`);
+    this.inputName = inputName;
+    this.promptMessage = promptMessage;
+    this.name = "MissingInputError";
+  }
+}
+exports.MissingInputError = MissingInputError;

package/dist/cli/src/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/types.ts"],"names":[],"mappings":";;;AAmIA,wEAAwE;AAExE,MAAa,iBAAkB,SAAQ,KAAK;IAC1C,YACkB,SAAiB,EACjB,aAAqB;QAErC,KAAK,CACH,4BAA4B,SAAS,MAAM,aAAa,KAAK;YAC3D,oBAAoB,SAAS,2BAA2B,SAAS,UAAU,CAC9E,CAAC;QANc,cAAS,GAAT,SAAS,CAAQ;QACjB,kBAAa,GAAb,aAAa,CAAQ;QAMrC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAXD,8CAWC"}

package/dist/cli/src/gcloud/artifactsRegistry.d.ts

@@ -1,5 +1,5 @@
 import type { Gcloudregion } from "../../../pipeline/src/index.js";
 export declare const upsertGcloudArtifactsRegistry: (config: {
-    projectId: string;
-    region: Gcloudregion;
-}) => Promise<void>;
+  projectId: string;
+  region: Gcloudregion;
+}) => Promise<void>;

package/dist/cli/src/gcloud/artifactsRegistry.js

@@ -1,15 +1,16 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
 exports.upsertGcloudArtifactsRegistry = void 0;
 const child_process_promise_1 = require("child-process-promise");
-const upsertGcloudArtifactsRegistry = async (config) => {
-    try {
-        await (0, child_process_promise_1.exec)(`gcloud artifacts repositories create catladder-deploy --project="${config.projectId}" --repository-format=docker --location=${config.region}`);
-    }
-    catch (e) {
-        // probably already exists
-        //
-    }
+const upsertGcloudArtifactsRegistry = async config => {
+  try {
+    await (0, child_process_promise_1.exec)(`gcloud artifacts repositories create catladder-deploy --project="${config.projectId}" --repository-format=docker --location=${config.region}`);
+  } catch (e) {
+    // probably already exists
+    //
+  }
 };
-exports.upsertGcloudArtifactsRegistry = upsertGcloudArtifactsRegistry;
-//# sourceMappingURL=artifactsRegistry.js.map
+exports.upsertGcloudArtifactsRegistry = upsertGcloudArtifactsRegistry;

package/dist/cli/src/gcloud/cloudRun/getCloudRunDomainSuffix.d.ts

@@ -1,2 +1,2 @@
 import type { DeployConfigCloudRun } from "../../../../pipeline/src/index.js";
-export declare const getCloudRunDomainSuffix: (config: DeployConfigCloudRun) => Promise<any>;
+export declare const getCloudRunDomainSuffix: (config: DeployConfigCloudRun) => Promise<any>;

package/dist/cli/src/gcloud/cloudRun/getCloudRunDomainSuffix.js

@@ -1,28 +1,29 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
 exports.getCloudRunDomainSuffix = void 0;
 const child_process_promise_1 = require("child-process-promise");
-const getSuffixFromService = (service) => {
-    const fullUrl = service.status.url;
-    const name = service.metadata.name;
-    return fullUrl.replace("https://" + name + "-", "");
+const getSuffixFromService = service => {
+  const fullUrl = service.status.url;
+  const name = service.metadata.name;
+  return fullUrl.replace("https://" + name + "-", "");
 };
-const getCloudRunDomainSuffix = async (config) => {
-    /* google cloud run domains are partially predictable, they have a fixed suffix that depends on the region and project, but we don't know it beforehand
+const getCloudRunDomainSuffix = async config => {
+  /* google cloud run domains are partially predictable, they have a fixed suffix that depends on the region and project, but we don't know it beforehand
+     So what we do is either:
+   - get one service and extract its suffix
+   - create a dummy project, extract the suffix and save that as a gitlab variable
   
-    So what we do is either:
-     - get one service and extract its suffix
-     - create a dummy project, extract the suffix and save that as a gitlab variable
-    
-    
-    */
-    const dummyServiceName = "cl-dummy-service-delete-me";
-    const existingServices = await (0, child_process_promise_1.exec)(`gcloud run services list --format=json  --project="${config.projectId}"  --region=${config.region} --limit=1`).then((r) => JSON.parse(r.stdout));
-    if (existingServices.length > 0) {
-        return getSuffixFromService(existingServices[0]);
-    }
-    const result = await (0, child_process_promise_1.exec)(`gcloud run deploy ${dummyServiceName} --region=${config.region} --allow-unauthenticated --project ${config.projectId} --image=us-docker.pkg.dev/cloudrun/container/hello --format=json`).then((r) => JSON.parse(r.stdout));
-    return await getSuffixFromService(result);
+  
+  */
+  const dummyServiceName = "cl-dummy-service-delete-me";
+  const existingServices = await (0, child_process_promise_1.exec)(`gcloud run services list --format=json  --project="${config.projectId}"  --region=${config.region} --limit=1`).then(r => JSON.parse(r.stdout));
+  if (existingServices.length > 0) {
+    return getSuffixFromService(existingServices[0]);
+  }
+  const result = await (0, child_process_promise_1.exec)(`gcloud run deploy ${dummyServiceName} --region=${config.region} --allow-unauthenticated --project ${config.projectId} --image=us-docker.pkg.dev/cloudrun/container/hello --format=json`).then(r => JSON.parse(r.stdout));
+  return await getSuffixFromService(result);
 };
-exports.getCloudRunDomainSuffix = getCloudRunDomainSuffix;
-//# sourceMappingURL=getCloudRunDomainSuffix.js.map
+exports.getCloudRunDomainSuffix = getCloudRunDomainSuffix;

package/dist/cli/src/gcloud/cloudRun/openCloudRunDashboards.d.ts

@@ -1,3 +1,3 @@
 import type { ComponentContext } from "../../../../pipeline/src/index.js";
-import type { CommandInstance } from "vorpal";
-export declare const openGoogleCloudRunDashboard: (instance: CommandInstance, context: ComponentContext) => Promise<void>;
+import type { IO } from "../../core/types";
+export declare const openGoogleCloudRunDashboard: (instance: IO, context: ComponentContext) => Promise<void>;

package/dist/cli/src/gcloud/cloudRun/openCloudRunDashboards.js

@@ -1,18 +1,25 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
 exports.openGoogleCloudRunDashboard = void 0;
 const pipeline_1 = require("../../../../pipeline/src/index.js");
 const openDashboard_1 = require("../openDashboard");
 const openGoogleCloudRunDashboard = async (instance, context) => {
-    var _a;
-    if (!(0, pipeline_1.isOfDeployType)((_a = context.deploy) === null || _a === void 0 ? void 0 : _a.config, "google-cloudrun")) {
-        throw new Error("deploy type is not google-cloudrun ");
-    }
-    const { fullName } = context.environment;
-    const { region, projectId } = context.deploy.config;
-    await (0, openDashboard_1.openGoogleCloudDashboard)(instance, `run/detail/${region}/${fullName}/metrics`, {
-        project: projectId,
-    });
+  var _a;
+  if (!(0, pipeline_1.isOfDeployType)((_a = context.deploy) === null || _a === void 0 ? void 0 : _a.config, "google-cloudrun")) {
+    throw new Error("deploy type is not google-cloudrun ");
+  }
+  const {
+    fullName
+  } = context.environment;
+  const {
+    region,
+    projectId
+  } = context.deploy.config;
+  await (0, openDashboard_1.openGoogleCloudDashboard)(instance, `run/detail/${region}/${fullName}/metrics`, {
+    project: projectId
+  });
 };
-exports.openGoogleCloudRunDashboard = openGoogleCloudRunDashboard;
-//# sourceMappingURL=openCloudRunDashboards.js.map
+exports.openGoogleCloudRunDashboard = openGoogleCloudRunDashboard;

package/dist/cli/src/gcloud/cloudRun/openCloudRunDashboards.js.map

@@ -1 +1 @@
-{"version":3,"file":"openCloudRunDashboards.js","sourceRoot":"","sources":["../../../../../src/gcloud/cloudRun/openCloudRunDashboards.ts"],"names":[],"mappings":";;;AACA,kDAAqD;AAErD,oDAA4D;AAErD,MAAM,2BAA2B,GAAG,KAAK,EAC9C,QAAyB,EACzB,OAAyB,EACzB,EAAE;;IACF,IAAI,CAAC,IAAA,yBAAc,EAAC,MAAA,OAAO,CAAC,MAAM,0CAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;IACpD,MAAM,IAAA,wCAAwB,EAC5B,QAAQ,EACR,cAAc,MAAM,IAAI,QAAQ,UAAU,EAC1C;QACE,OAAO,EAAE,SAAS;KACnB,CACF,CAAC;AACJ,CAAC,CAAC;AAhBW,QAAA,2BAA2B,+BAgBtC"}
+{"version":3,"file":"openCloudRunDashboards.js","sourceRoot":"","sources":["../../../../../src/gcloud/cloudRun/openCloudRunDashboards.ts"],"names":[],"mappings":";;;AACA,kDAAqD;AAErD,oDAA4D;AAErD,MAAM,2BAA2B,GAAG,KAAK,EAC9C,QAAY,EACZ,OAAyB,EACzB,EAAE;;IACF,IAAI,CAAC,IAAA,yBAAc,EAAC,MAAA,OAAO,CAAC,MAAM,0CAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;IACpD,MAAM,IAAA,wCAAwB,EAC5B,QAAQ,EACR,cAAc,MAAM,IAAI,QAAQ,UAAU,EAC1C;QACE,OAAO,EAAE,SAAS;KACnB,CACF,CAAC;AACJ,CAAC,CAAC;AAhBW,QAAA,2BAA2B,+BAgBtC"}

package/dist/cli/src/gcloud/cloudSql/copyDb.d.ts

@@ -1,12 +1,12 @@
 type Opts = {
-    targetPassword: string;
-    targetPort: number;
-    targetUsername: string;
-    sourceUsername: string;
-    sourcePassword: string;
-    sourcePort: number;
-    sourceDbName: string;
-    targetDbName: string;
+  targetPassword: string;
+  targetPort: number;
+  targetUsername: string;
+  sourceUsername: string;
+  sourcePassword: string;
+  sourcePort: number;
+  sourceDbName: string;
+  targetDbName: string;
 };
 export declare const spawnCopyDb: (opts: Opts) => Promise<unknown>;
-export {};
+export {};

package/dist/cli/src/gcloud/cloudSql/copyDb.js

@@ -1,38 +1,54 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
 exports.spawnCopyDb = void 0;
 const child_process_promise_1 = require("child-process-promise");
-const spawnCopyDb = async (opts) => {
-    const script = createCopyDbScript(opts);
-    return await (0, child_process_promise_1.spawn)(script, [], {
-        shell: "bash",
-        stdio: "inherit",
-    });
+const spawnCopyDb = async opts => {
+  const script = createCopyDbScript(opts);
+  return await (0, child_process_promise_1.spawn)(script, [], {
+    shell: "bash",
+    stdio: "inherit"
+  });
 };
 exports.spawnCopyDb = spawnCopyDb;
-const createCopyDbScript = ({ targetPassword, targetPort, targetUsername, sourceUsername, sourcePassword, sourcePort, sourceDbName, targetDbName, }) => {
-    const targetPSQL = (command) => `PGPASSWORD=${targetPassword} psql -p ${targetPort} --host=localhost --user=${targetUsername} -q ${command}`;
-    const copyDBScript = `
+const createCopyDbScript = ({
+  targetPassword,
+  targetPort,
+  targetUsername,
+  sourceUsername,
+  sourcePassword,
+  sourcePort,
+  sourceDbName,
+  targetDbName
+}) => {
+  const targetPSQL = command => `PGPASSWORD=${targetPassword} psql -p ${targetPort} --host=localhost --user=${targetUsername} -q ${command}`;
+  // URL-encode credentials to handle special characters like @, :, /, etc.
+  const encodedSourceUsername = encodeURIComponent(sourceUsername);
+  const encodedSourcePassword = encodeURIComponent(sourcePassword);
+  const copyDBScript = `
       set -e
-     
-    
-
-      dumptmp=$(mktemp /tmp/dump.XXXXXX)
 
-      echo "Dumping file to $dumptmp"
-      pg_dump --dbname=postgres://${sourceUsername}:${sourcePassword}@localhost:${sourcePort}/${sourceDbName} --no-owner --no-privileges > $dumptmp
-      echo "dump done"
       ${targetPSQL(`-c 'drop database "${targetDbName}" WITH (FORCE)' 1> /dev/null || true`)}
       ${targetPSQL(`-c 'create database "${targetDbName}"' 1> /dev/null`)}
-          echo "Restoring dump..."
-      ${targetPSQL(`"${targetDbName}" < $dumptmp 1> /dev/null`)}
-  
+      echo "Estimating database size..."
+      DB_SIZE=$(PGPASSWORD=${encodedSourcePassword} psql --dbname=postgres://${encodedSourceUsername}:${encodedSourcePassword}@localhost:${sourcePort}/${sourceDbName} -t -A -c "SELECT pg_database_size('${sourceDbName}')")
+      # pg_database_size includes indexes, TOAST, and free space — pg_dump output is roughly 40% of that
+      ESTIMATED_DUMP_SIZE=$((DB_SIZE * 40 / 100))
+      echo "Estimated dump size: $((ESTIMATED_DUMP_SIZE / 1024 / 1024)) MB (~40% of $((DB_SIZE / 1024 / 1024)) MB database size)"
+
+      PROGRESS=""
+      if command -v pv &> /dev/null; then
+        PROGRESS="pv -s $ESTIMATED_DUMP_SIZE |"
+      else
+        echo "(install 'pv' for progress info)"
+      fi
+
+      echo "Dumping and restoring via pipe..."
+      eval "pg_dump --dbname=postgres://${encodedSourceUsername}:${encodedSourcePassword}@localhost:${sourcePort}/${sourceDbName} --no-owner --no-privileges | $PROGRESS ${targetPSQL(`"${targetDbName}" 1> /dev/null`)}"
 
-      echo "Clean up..."
-      set +e
-      rm $dumptmp
       echo "\n🐱 Done!"
       `;
-    return copyDBScript;
-};
-//# sourceMappingURL=copyDb.js.map
+  return copyDBScript;
+};

package/dist/cli/src/gcloud/cloudSql/copyDb.js.map

@@ -1 +1 @@
-{"version":3,"file":"copyDb.js","sourceRoot":"","sources":["../../../../../src/gcloud/cloudSql/copyDb.ts"],"names":[],"mappings":";;;AAAA,iEAA8C;AAWvC,MAAM,WAAW,GAAG,KAAK,EAAE,IAAU,EAAE,EAAE;IAC9C,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAExC,OAAO,MAAM,IAAA,6BAAK,EAAC,MAAM,EAAE,EAAE,EAAE;QAC7B,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;AACL,CAAC,CAAC;AAPW,QAAA,WAAW,eAOtB;AACF,MAAM,kBAAkB,GAAG,CAAC,EAC1B,cAAc,EACd,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,YAAY,GACP,EAAE,EAAE;IACT,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,EAAE,CACrC,cAAc,cAAc,YAAY,UAAU,4BAA4B,cAAc,OAAO,OAAO,EAAE,CAAC;IAE/G,MAAM,YAAY,GAAG;;;;;;;;oCAQa,cAAc,IAAI,cAAc,cAAc,UAAU,IAAI,YAAY;;QAEpG,UAAU,CACV,sBAAsB,YAAY,sCAAsC,CACzE;QACC,UAAU,CAAC,wBAAwB,YAAY,iBAAiB,CAAC;;QAEjE,UAAU,CAAC,IAAI,YAAY,2BAA2B,CAAC;;;;;;;OAOxD,CAAC;IACN,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC"}
+{"version":3,"file":"copyDb.js","sourceRoot":"","sources":["../../../../../src/gcloud/cloudSql/copyDb.ts"],"names":[],"mappings":";;;AAAA,iEAA8C;AAWvC,MAAM,WAAW,GAAG,KAAK,EAAE,IAAU,EAAE,EAAE;IAC9C,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAExC,OAAO,MAAM,IAAA,6BAAK,EAAC,MAAM,EAAE,EAAE,EAAE;QAC7B,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;AACL,CAAC,CAAC;AAPW,QAAA,WAAW,eAOtB;AACF,MAAM,kBAAkB,GAAG,CAAC,EAC1B,cAAc,EACd,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,YAAY,GACP,EAAE,EAAE;IACT,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,EAAE,CACrC,cAAc,cAAc,YAAY,UAAU,4BAA4B,cAAc,OAAO,OAAO,EAAE,CAAC;IAE/G,yEAAyE;IACzE,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACjE,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAEjE,MAAM,YAAY,GAAG;;;QAGf,UAAU,CACV,sBAAsB,YAAY,sCAAsC,CACzE;QACC,UAAU,CAAC,wBAAwB,YAAY,iBAAiB,CAAC;;6BAE5C,qBAAqB,6BAA6B,qBAAqB,IAAI,qBAAqB,cAAc,UAAU,IAAI,YAAY,uCAAuC,YAAY;;;;;;;;;;;;;0CAa9K,qBAAqB,IAAI,qBAAqB,cAAc,UAAU,IAAI,YAAY,2CAA2C,UAAU,CAAC,IAAI,YAAY,gBAAgB,CAAC;;;OAGhN,CAAC;IACN,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC"}

package/dist/cli/src/gcloud/cloudSql/parseConnectionString.d.ts

@@ -0,0 +1,9 @@
+import { type IConnectionStringParameters } from "connection-string-parser";
+/**
+ * Parses a PostgreSQL connection string.
+ * Accepts both postgres:// and postgresql:// schemes and normalizes to postgresql://
+ *
+ * @param connectionString - The connection string to parse (e.g., "postgresql://user:pass@localhost:5432/dbname")
+ * @returns Parsed connection string parameters
+ */
+export declare function parseConnectionString(connectionString: string): IConnectionStringParameters;

package/dist/cli/src/gcloud/cloudSql/parseConnectionString.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.parseConnectionString = void 0;
+const connection_string_parser_1 = require("connection-string-parser");
+/**
+ * Parses a PostgreSQL connection string.
+ * Accepts both postgres:// and postgresql:// schemes and normalizes to postgresql://
+ *
+ * @param connectionString - The connection string to parse (e.g., "postgresql://user:pass@localhost:5432/dbname")
+ * @returns Parsed connection string parameters
+ */
+function parseConnectionString(connectionString) {
+  const parser = new connection_string_parser_1.ConnectionStringParser({
+    scheme: "postgresql",
+    hosts: []
+  });
+  // Normalize postgres:// to postgresql:// (the official IANA scheme)
+  const normalizedConnectionString = connectionString.replace(/^postgres:\/\//, "postgresql://");
+  return parser.parse(normalizedConnectionString);
+}
+exports.parseConnectionString = parseConnectionString;

package/dist/cli/src/gcloud/cloudSql/parseConnectionString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseConnectionString.js","sourceRoot":"","sources":["../../../../../src/gcloud/cloudSql/parseConnectionString.ts"],"names":[],"mappings":";;;AAAA,uEAGkC;AAElC;;;;;;GAMG;AACH,SAAgB,qBAAqB,CACnC,gBAAwB;IAExB,MAAM,MAAM,GAAG,IAAI,iDAAsB,CAAC;QACxC,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,EAAE;KACV,CAAC,CAAC;IAEH,oEAAoE;IACpE,MAAM,0BAA0B,GAAG,gBAAgB,CAAC,OAAO,CACzD,gBAAgB,EAChB,eAAe,CAChB,CAAC;IAEF,OAAO,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAClD,CAAC;AAfD,sDAeC"}

package/dist/cli/src/gcloud/cloudSql/startProxy.d.ts

@@ -1,10 +1,10 @@
 export declare const ERROR_NOT_INSTALLED = "cloud-sql-proxy not installed";
 export type CloudSqlBackgroundProxy = {
-    stop: () => void;
+  stop: () => void;
 };
 export type CloudSqlProxyOptions = {
-    instanceName: string;
-    localPort: number;
+  instanceName: string;
+  localPort: number;
 };
 export declare const startCloudSqlProxyInCurrentShell: (opts: CloudSqlProxyOptions) => Promise<void>;
-export declare const startCloudSqlProxyInBackground: (opts: CloudSqlProxyOptions) => Promise<CloudSqlBackgroundProxy>;
+export declare const startCloudSqlProxyInBackground: (opts: CloudSqlProxyOptions) => Promise<CloudSqlBackgroundProxy>;