@hue-run/sdk 0.4.2 → 0.5.0

package/dist/cli/login.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `hue login`: guided storage of keys that a person creates in Hue. The command never mints a key.
+ * Hue's setup credentials are deliberately isolated from ordinary project keys, so this flow
+ * points at the settings page, reads the pasted keys without echo, validates each one against
+ * the configured origin and stores them in a private env file. Key values are never printed.
+ */
+/** Streams, environment and network seams for {@link runLoginCommand}; tests inject these. */
+export interface LoginCommandIo {
+    stdin?: NodeJS.ReadableStream;
+    stdout?: NodeJS.WritableStream;
+    stderr?: NodeJS.WritableStream;
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+    fetch?: typeof fetch;
+    openBrowser?: (url: string) => Promise<boolean>;
+}
+export declare const LOGIN_USAGE = "Usage: hue login [--origin URL] [--env-file PATH] [--keys evaluations|coding-agent|both]\n                 [--no-browser] [--force] [--gitignore]\n\nStore keys you created in Hue in a private env file. Each key is validated against Hue before it\nis stored; key values are never printed.\n\nOptions:\n  --origin URL     Hue origin (default https://app.hue.run)\n  --env-file PATH  Env file to write (default .env.hue in the current directory)\n  --keys KIND      evaluations (HUE_API_KEY), coding-agent (HUE_MCP_KEY) or both (default both)\n  --no-browser     Do not open the key settings page in a browser\n  --force          Replace an existing different value in the env file\n  --gitignore      Add the env file to .gitignore when a git repository does not ignore it\n  -h, --help       Show this help";
+/** Hue MCP endpoint that pairs with an application origin. */
+export declare function mcpUrlForOrigin(origin: string): string;
+/** Normalizes a Hue origin: HTTPS, or HTTP for loopback only; no credentials, path, query or hash. */
+export declare function parseHueOrigin(value: string): string | null;
+/** Explains why a pasted value cannot be a Hue key, or returns null when it is acceptable. */
+export declare function invalidKeyReason(value: string): string | null;
+/** Reads the effective value of a variable from env-file text; the last assignment wins. */
+export declare function readEnvValue(text: string, variable: string): string | undefined;
+/** Replaces or appends the given assignments while preserving every other line. */
+export declare function mergeEnvText(text: string, entries: Record<string, string>): string;
+/**
+ * Runs `hue login` and returns the process exit code: 0 stored, 1 failed, 2 usage error, 130
+ * interrupted. `argv` may start with the `login` command word.
+ */
+export declare function runLoginCommand(argv: string[], io?: LoginCommandIo): Promise<number>;