@arizeai/phoenix-cli 1.3.0 → 1.4.0

package/build/settings.js

@@ -0,0 +1,299 @@
+/**
+ * Settings storage schema definitions and runtime I/O for the Phoenix CLI.
+ *
+ * The Zod schemas in this file are the canonical source for
+ * `schemas/phoenix-cli-settings.json` (emitted by `scripts/build-schema.ts`).
+ * Runtime I/O (path resolution, file read/write, profile lookup) also lives
+ * here so the module name matches the on-disk file (`settings.json`).
+ */
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import { z } from "zod";
+import { InvalidArgumentError } from "./exitCodes.js";
+export const ProfileEntrySchema = z.object({
+    endpoint: z
+        .string()
+        .url("endpoint must be an absolute URL (e.g. https://app.phoenix.arize.com or http://localhost:6006)")
+        .optional()
+        .describe("Phoenix server URL this profile targets (e.g. https://app.phoenix.arize.com or http://localhost:6006)."),
+    apiKey: z
+        .string()
+        .optional()
+        .describe("API key sent as `Authorization: Bearer <apiKey>` with every request. Accepts both user and system API keys for self-hosted Phoenix and Phoenix Cloud. Treat as a secret — the profiles file should be user-readable only (mode 0600)."),
+    project: z
+        .string()
+        .optional()
+        .describe("Default Phoenix project name used when commands don't pass --project."),
+    headers: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe("Extra HTTP headers sent with every request from this profile. Useful for custom auth or routing. Values override defaults."),
+});
+export const SettingsFileSchema = z.object({
+    $schema: z
+        .string()
+        .optional()
+        .describe("Optional JSON Schema URL for editor autocomplete. Pin to a GitHub raw URL at a released tag; see README."),
+    activeProfile: z
+        .union([z.string(), z.null()])
+        .describe("Name of the profile to use when no --profile flag is passed. Must match a key in `profiles`."),
+    profiles: z
+        .record(z.string(), ProfileEntrySchema)
+        .describe("Map of profile name to profile entry. Keys are the profile names referenced by `activeProfile` and the --profile flag."),
+});
+/**
+ * Typed error thrown by `loadSettings({ strict: true })` when the settings
+ * file is malformed or schema-invalid.
+ */
+export class SettingsFileError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SettingsFileError";
+    }
+}
+/**
+ * Typed error thrown when an explicitly requested profile (via `--profile`)
+ * does not resolve to an existing entry. Extends `InvalidArgumentError` so
+ * `getExitCodeForError` maps it to `ExitCode.INVALID_ARGUMENT` automatically.
+ */
+export class ProfileResolutionError extends InvalidArgumentError {
+    constructor(message) {
+        super(message);
+        this.name = "ProfileResolutionError";
+    }
+}
+/**
+ * Default `$schema` URL written into newly-created settings files so editors
+ * (VS Code, JetBrains, etc.) can validate and autocomplete out of the box.
+ *
+ * Pinned to `main` for now while the schema is still moving. We'll move it
+ * to a SchemaStore entry once registered, and at that point this constant
+ * becomes the fallback rather than the canonical pointer.
+ */
+export const DEFAULT_SCHEMA_URL = "https://raw.githubusercontent.com/Arize-ai/phoenix/main/schemas/phoenix-cli-settings.json";
+/**
+ * Empty settings state. Used as the forgiving-mode fallback when the file
+ * exists but is unreadable or unparseable — see {@link getInitialSettingsFile}
+ * for the freshly-created variant that includes `$schema`.
+ */
+export const DEFAULT_SETTINGS_FILE = {
+    activeProfile: null,
+    profiles: {},
+};
+/**
+ * Settings state used when no file exists yet. Differs from
+ * {@link DEFAULT_SETTINGS_FILE} only in that it carries a `$schema` pointer,
+ * so the very first `saveSettings` call writes a file editors can validate
+ * without users having to add the line themselves. Any subsequent load
+ * preserves whatever's already on disk — if a user removes `$schema`, we
+ * don't put it back.
+ */
+export function getInitialSettingsFile() {
+    return {
+        $schema: DEFAULT_SCHEMA_URL,
+        activeProfile: null,
+        profiles: {},
+    };
+}
+/**
+ * Format a Zod error path segment for human-readable messages.
+ */
+function formatZodPath(pathSegments) {
+    return pathSegments
+        .map((segment, i) => {
+        if (typeof segment === "number") {
+            return `[${segment}]`;
+        }
+        return i === 0 ? segment : `.${segment}`;
+    })
+        .join("");
+}
+/**
+ * Parse and validate a raw JSON string as a SettingsFile.
+ *
+ * Returns `{ ok: false, reason }` rather than throwing on any parse failure
+ * so callers can decide whether to warn+continue or throw a typed error.
+ */
+function parseSettingsFile(rawJson) {
+    let parsed;
+    try {
+        parsed = JSON.parse(rawJson);
+    }
+    catch {
+        return { ok: false, reason: "Invalid JSON in settings file" };
+    }
+    const result = SettingsFileSchema.safeParse(parsed);
+    if (result.success) {
+        return { ok: true, data: result.data };
+    }
+    const issue = result.error.issues[0];
+    const issuePath = issue.path;
+    if (issuePath.length === 0) {
+        return { ok: false, reason: "Settings file root must be an object" };
+    }
+    if (issuePath.length === 2 && issuePath[0] === "profiles") {
+        const name = issuePath[1];
+        return { ok: false, reason: `Profile "${name}" must be an object` };
+    }
+    if (issuePath.length === 3 && issuePath[0] === "profiles") {
+        const name = issuePath[1];
+        const field = issuePath[2];
+        if (field === "headers") {
+            return {
+                ok: false,
+                reason: `Profile "${name}".headers must be an object`,
+            };
+        }
+        // For string-typed fields the underlying issue is either a type
+        // mismatch ("must be a string") or a refinement failure (e.g. URL
+        // validation on `endpoint`). Surface Zod's own message for refinement
+        // failures so users see what actually went wrong.
+        if (issue.code === "invalid_type") {
+            return {
+                ok: false,
+                reason: `Profile "${name}".${field} must be a string`,
+            };
+        }
+        return {
+            ok: false,
+            reason: `Profile "${name}".${field}: ${issue.message}`,
+        };
+    }
+    if (issuePath.length === 4 &&
+        issuePath[0] === "profiles" &&
+        issuePath[2] === "headers") {
+        const name = issuePath[1];
+        const key = issuePath[3];
+        return {
+            ok: false,
+            reason: `Profile "${name}".headers["${key}"] must be a string`,
+        };
+    }
+    if (issuePath[0] === "activeProfile") {
+        return {
+            ok: false,
+            reason: "Settings file 'activeProfile' must be a string or null",
+        };
+    }
+    if (issuePath[0] === "profiles") {
+        return { ok: false, reason: "Settings file 'profiles' must be an object" };
+    }
+    return {
+        ok: false,
+        reason: `Invalid settings file at ${formatZodPath(issuePath)}: ${issue.message}`,
+    };
+}
+/**
+ * Return true if the profile name contains only alphanumeric characters,
+ * hyphens, or underscores. Empty strings and names with whitespace or other
+ * special characters are rejected.
+ */
+export function validateProfileName(name) {
+    if (!name || name.trim() !== name) {
+        return false;
+    }
+    return /^[a-zA-Z0-9_-]+$/.test(name);
+}
+/**
+ * Look up a profile entry by name. Returns `undefined` (rather than
+ * throwing) when the name does not exist in the profiles record so
+ * callers can decide whether a miss is fatal (e.g. an explicit
+ * `--profile` flag) or expected (e.g. a stale `activeProfile` pointer).
+ *
+ * Returns both the name and entry together so callers never need to
+ * re-resolve the name separately.
+ */
+export function getProfileByName(file, name) {
+    const entry = file.profiles[name];
+    return entry !== undefined ? { name, entry } : undefined;
+}
+/**
+ * Look up the profile pointed at by `file.activeProfile`. Returns
+ * `undefined` when no active profile is set, or when the pointer is
+ * stale (the named profile no longer exists). Stale-pointer handling
+ * is forgiving by design — callers fall through to env vars / defaults
+ * rather than failing.
+ */
+export function getStoredActiveProfile(file) {
+    if (file.activeProfile === null) {
+        return undefined;
+    }
+    return getProfileByName(file, file.activeProfile);
+}
+// ---------------------------------------------------------------------------
+// File I/O
+// ---------------------------------------------------------------------------
+/**
+ * Return the Phoenix config directory. Respects `XDG_CONFIG_HOME` if set
+ * (returns `$XDG_CONFIG_HOME/px`), otherwise falls back to `~/.px`.
+ */
+export function getConfigDir() {
+    const xdgConfigHome = process.env.XDG_CONFIG_HOME;
+    if (xdgConfigHome) {
+        return path.join(xdgConfigHome, "px");
+    }
+    return path.join(os.homedir(), ".px");
+}
+/**
+ * Return the absolute path to the settings config file.
+ */
+export function getSettingsPath() {
+    return path.join(getConfigDir(), "settings.json");
+}
+/**
+ * Load the settings file from disk.
+ *
+ * - Missing file: returns `getInitialSettingsFile()` — a fresh state that
+ *   carries `$schema`, so the very first save writes a file editors can
+ *   validate.
+ * - Malformed JSON / schema-invalid, forgiving mode (default): returns
+ *   `DEFAULT_SETTINGS_FILE` (no `$schema` — we don't want to clobber a user's
+ *   intentional removal during a forgiving fallback) and writes a warning to
+ *   stderr.
+ * - Malformed JSON / schema-invalid, strict mode: throws `SettingsFileError`.
+ */
+export function loadSettings(options) {
+    const strict = options?.strict ?? false;
+    const filePath = options?.settingsPath ?? getSettingsPath();
+    let rawJson;
+    try {
+        rawJson = fs.readFileSync(filePath, "utf-8");
+    }
+    catch (err) {
+        if (typeof err === "object" &&
+            err !== null &&
+            err.code === "ENOENT") {
+            return getInitialSettingsFile();
+        }
+        if (strict) {
+            throw err;
+        }
+        process.stderr.write(`Warning: Could not read settings file (${filePath}): ${String(err)}\n`);
+        return { ...DEFAULT_SETTINGS_FILE, profiles: {} };
+    }
+    const result = parseSettingsFile(rawJson);
+    if (result.ok) {
+        return result.data;
+    }
+    if (strict) {
+        throw new SettingsFileError(result.reason);
+    }
+    process.stderr.write(`Warning: ${result.reason}\n`);
+    return { ...DEFAULT_SETTINGS_FILE, profiles: {} };
+}
+/**
+ * Persist the settings file to disk.
+ *
+ * Creates the parent directory (and any ancestors) if it does not exist.
+ * Writes human-readable JSON with 2-space indentation.
+ */
+export function saveSettings(data, options) {
+    const filePath = options?.settingsPath ?? getSettingsPath();
+    fs.mkdirSync(path.dirname(filePath), { recursive: true, mode: 0o700 });
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", {
+        encoding: "utf-8",
+        mode: 0o600,
+    });
+}
+//# sourceMappingURL=settings.js.map

package/build/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arizeai/phoenix-cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "A command-line interface for Phoenix",
   "keywords": [
     "arize",
@@ -33,7 +33,8 @@
     "@arizeai/openinference-semantic-conventions": "^1.1.0",
     "@clack/prompts": "^1.0.1",
     "commander": "^12.1.0",
-    "@arizeai/phoenix-client": "6.8.0",
+    "zod": "^4.0.14",
+    "@arizeai/phoenix-client": "6.9.0",
     "@arizeai/phoenix-config": "0.1.3"
   },
   "devDependencies": {
@@ -47,7 +48,8 @@
     "node": ">=20"
   },
   "scripts": {
-    "build": "tsc && tsc-alias && chmod 755 build/index.js",
+    "build": "pnpm run build:schema && tsc && tsc-alias && chmod 755 build/index.js",
+    "build:schema": "tsx scripts/build-schema.ts && cd ../../.. && js/node_modules/.bin/oxfmt --config .oxfmtrc.jsonc schemas/phoenix-cli-settings.json",
     "clean": "rimraf build",
     "dev": "tsx src/index.ts",
     "prebuild": "pnpm run clean",