@kici-dev/orchestrator 0.2.0 → 0.4.0

package/dist/cli/api-client.d.ts

@@ -63,6 +63,28 @@ export interface GenericSourceResponse {
     /** Universal-git config; raw JSON string or parsed object (pg driver dependent). */
     git_config?: string | GenericSourceGitConfigPayload | null;
 }
+/**
+ * `fetch` rejects with a bare `TypeError: fetch failed` when it cannot reach the
+ * host — it names neither the address dialled nor the knob that sets it. Printed
+ * through the CLI's `Error: ${message}` handler that becomes `Error: fetch
+ * failed`, which reads like a fault in the subcommand rather than a misaddressed
+ * client, and sends the operator debugging the wrong thing.
+ *
+ * The trap is sharpened by two details of this CLI. The base URL comes from
+ * `KICI_ADMIN_URL`, not the `KICI_ORCHESTRATOR_URL` an operator is likelier to
+ * have exported; and subcommands accepting `--database-url` fall back to direct
+ * DB access, so on a host with `KICI_DATABASE_URL` set they keep working while
+ * the HTTP-only ones fail — making it look like specific subcommands are broken.
+ *
+ * So: name the address, name the variable, and name the near-miss.
+ */
+/**
+ * Best-effort one-line detail from a rejected `fetch`. Returns '' when nothing
+ * useful is available, so the caller can omit the parenthetical rather than
+ * print an empty one.
+ */
+export declare function firstCauseMessage(err: unknown): string;
+export declare function fetchAdminApi(url: string, init: RequestInit, baseUrl: string): Promise<Response>;
 export declare class AdminApiClient {
     private readonly baseUrl;
     private readonly token;