@component-compass/cli 0.1.23 → 0.1.24

package/package.json

@@ -1,11 +1,9 @@
 {
   "name": "@component-compass/cli",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Open-source CLI for measuring design-system component usage across multi-framework consumer repos.",
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
   "bin": {
     "component-compass": "dist/cli.js"
   },
@@ -16,50 +14,48 @@
     "README.md"
   ],
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
     "./package.json": "./package.json",
     "./schema/config.schema.json": "./schema/config.schema.json"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "node scripts/build.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "lint": "biome lint src tests",
-    "clean": "rm -rf dist .turbo"
+    "lint": "biome lint src tests scripts",
+    "clean": "rm -rf dist .turbo",
+    "smoke": "node scripts/smoke.mjs"
   },
   "dependencies": {
+    "@component-compass/ast-utils": "0.1.24",
+    "@component-compass/plugin-core": "0.1.24",
+    "oxc-parser": "0.130.0"
+  },
+  "devDependencies": {
     "@babel/parser": "7.29.3",
     "@babel/types": "7.29.0",
     "@clack/prompts": "^1.5.1",
-    "@component-compass/ast-utils": "0.1.23",
-    "@component-compass/parser-html": "0.1.23",
-    "@component-compass/parser-lit": "0.1.23",
-    "@component-compass/parser-react": "0.1.23",
-    "@component-compass/parser-vue": "0.1.23",
-    "@component-compass/plugin-core": "0.1.23",
-    "@component-compass/reference-graph": "0.1.23",
+    "@component-compass/parser-html": "0.1.24",
+    "@component-compass/parser-lit": "0.1.24",
+    "@component-compass/parser-react": "0.1.24",
+    "@component-compass/parser-vue": "0.1.24",
+    "@component-compass/reference-graph": "0.1.24",
+    "@oxc-project/types": "0.130.0",
+    "@types/js-yaml": "4.0.9",
+    "@types/node": "24.12.2",
+    "@types/picomatch": "4.0.3",
     "@vue/compiler-sfc": "3.5.33",
     "ajv": "8.20.0",
+    "esbuild": "0.28.0",
     "glob": "13.0.6",
     "globby": "16.2.0",
     "js-yaml": "4.2.0",
     "jsonc-parser": "^3.3.1",
-    "oxc-parser": "0.130.0",
     "oxc-walker": "1.0.0",
     "parse5": "8.0.1",
     "picomatch": "4.0.4",
-    "ulid": "3.0.2"
-  },
-  "devDependencies": {
-    "@oxc-project/types": "0.130.0",
-    "@types/js-yaml": "4.0.9",
-    "@types/node": "24.12.2",
-    "@types/picomatch": "4.0.3",
     "typescript": "5.9.3",
+    "ulid": "3.0.2",
     "vitest": "4.1.5"
   },
   "engines": {

package/dist/auth/browser.d.ts

@@ -1,13 +0,0 @@
-type SpawnLike = (cmd: string, args: string[], opts: {
-    stdio: "ignore";
-    detached: boolean;
-}) => {
-    on(event: "error", listener: () => void): unknown;
-    unref(): void;
-};
-/** Best-effort: open `url` in the user's browser. Never throws; returns whether spawn was attempted. */
-export declare function openBrowser(url: string, deps?: {
-    platform?: NodeJS.Platform;
-    spawnFn?: SpawnLike;
-}): boolean;
-export {};

package/dist/auth/browser.js

@@ -1,21 +0,0 @@
-import { spawn } from "node:child_process";
-/** Best-effort: open `url` in the user's browser. Never throws; returns whether spawn was attempted. */
-export function openBrowser(url, deps = {}) {
-    const platform = deps.platform ?? process.platform;
-    const spawnFn = deps.spawnFn ?? spawn;
-    const [cmd, args] = platform === "darwin"
-        ? ["open", [url]]
-        : platform === "win32"
-            ? ["cmd", ["/c", "start", "", url]]
-            : ["xdg-open", [url]];
-    try {
-        const child = spawnFn(cmd, [...args], { stdio: "ignore", detached: true });
-        child.on("error", () => { });
-        child.unref();
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-//# sourceMappingURL=browser.js.map

package/dist/auth/browser.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/auth/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAQ3C,wGAAwG;AACxG,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,OAA4D,EAAE;IAE9D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAK,KAA8B,CAAC;IAChE,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GACf,QAAQ,KAAK,QAAQ;QACnB,CAAC,CAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAW;QAC5B,CAAC,CAAC,QAAQ,KAAK,OAAO;YACpB,CAAC,CAAE,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAW;YAC9C,CAAC,CAAE,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAW,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5B,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/auth/client.d.ts

@@ -1,48 +0,0 @@
-export type DeviceCodeResponse = {
-    deviceCode: string;
-    userCode: string;
-    verificationUri: string;
-    verificationUriComplete: string;
-    expiresIn: number;
-    interval: number;
-};
-export type TokenPair = {
-    accessToken: string;
-    refreshToken: string;
-    expiresIn: number;
-    /** Present on login (`token`), absent on `refresh`. */
-    email?: string;
-};
-export type PollResult = {
-    kind: "tokens";
-    tokens: TokenPair;
-} | {
-    kind: "pending";
-} | {
-    kind: "slow_down";
-} | {
-    kind: "expired";
-} | {
-    kind: "denied";
-};
-export type RefreshResult = {
-    kind: "tokens";
-    tokens: TokenPair;
-} | {
-    kind: "terminal";
-    error: string;
-} | {
-    kind: "transient";
-    error: string;
-};
-export declare class AuthHttpError extends Error {
-    status: number;
-    constructor(status: number, message: string);
-}
-export declare function requestDeviceCode(base: string): Promise<DeviceCodeResponse>;
-export declare function pollToken(base: string, deviceCode: string): Promise<PollResult>;
-export declare function refreshTokens(base: string, refreshToken: string): Promise<RefreshResult>;
-export declare function whoami(base: string, accessToken: string): Promise<{
-    userId: string;
-    email: string | null;
-} | null>;

package/dist/auth/client.js

@@ -1,89 +0,0 @@
-export class AuthHttpError extends Error {
-    status;
-    constructor(status, message) {
-        super(message);
-        this.status = status;
-    }
-}
-function endpoint(base, path) {
-    return `${base.replace(/\/+$/, "")}${path}`;
-}
-async function readError(res) {
-    const body = (await res.json().catch(() => ({})));
-    return body.error ?? "unknown_error";
-}
-function toTokenPair(body) {
-    return {
-        accessToken: body.access_token,
-        refreshToken: body.refresh_token,
-        expiresIn: body.expires_in,
-        ...(body.email !== undefined ? { email: body.email } : {}),
-    };
-}
-export async function requestDeviceCode(base) {
-    const res = await fetch(endpoint(base, "/api/auth/cli/device-code"), { method: "POST" });
-    if (!res.ok)
-        throw new AuthHttpError(res.status, `device-code failed: ${await readError(res)}`);
-    const b = (await res.json());
-    return {
-        deviceCode: b.device_code,
-        userCode: b.user_code,
-        verificationUri: b.verification_uri,
-        verificationUriComplete: b.verification_uri_complete,
-        expiresIn: b.expires_in,
-        interval: b.interval,
-    };
-}
-export async function pollToken(base, deviceCode) {
-    const res = await fetch(endpoint(base, "/api/auth/cli/token"), {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ device_code: deviceCode }),
-    });
-    if (res.ok) {
-        return { kind: "tokens", tokens: toTokenPair((await res.json())) };
-    }
-    const error = await readError(res);
-    switch (error) {
-        case "authorization_pending":
-            return { kind: "pending" };
-        case "slow_down":
-            return { kind: "slow_down" };
-        case "expired_token":
-            return { kind: "expired" };
-        case "access_denied":
-            return { kind: "denied" };
-        default:
-            throw new AuthHttpError(res.status, `token poll failed: ${error}`);
-    }
-}
-export async function refreshTokens(base, refreshToken) {
-    let res;
-    try {
-        res = await fetch(endpoint(base, "/api/auth/cli/refresh"), {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({ refresh_token: refreshToken }),
-        });
-    }
-    catch (err) {
-        // Network/DNS failure — treat as transient so we never discard a session.
-        return { kind: "transient", error: err instanceof Error ? err.message : "network_error" };
-    }
-    if (res.ok)
-        return { kind: "tokens", tokens: toTokenPair((await res.json())) };
-    const error = await readError(res);
-    const terminal = res.status === 401 && ["invalid_token", "sso_revoked", "not_authorized"].includes(error);
-    return terminal ? { kind: "terminal", error } : { kind: "transient", error };
-}
-export async function whoami(base, accessToken) {
-    const res = await fetch(endpoint(base, "/api/auth/cli/whoami"), {
-        headers: { Authorization: `Bearer ${accessToken}` },
-    });
-    if (res.status === 401)
-        return null;
-    if (!res.ok)
-        throw new AuthHttpError(res.status, `whoami failed: ${await readError(res)}`);
-    return (await res.json());
-}
-//# sourceMappingURL=client.js.map

package/dist/auth/client.js.map

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

package/dist/auth/paths.d.ts

@@ -1,2 +0,0 @@
-/** Absolute path to the hosts.json token store. */
-export declare function hostsFilePath(env?: NodeJS.ProcessEnv): string;

package/dist/auth/paths.js

@@ -1,14 +0,0 @@
-import { homedir } from "node:os";
-import { join } from "node:path";
-/** Directory holding the component-compass CLI config (XDG-aware). */
-function configDir(env = process.env) {
-    // biome-ignore lint/complexity/useLiteralKeys: env access
-    const xdg = env["XDG_CONFIG_HOME"];
-    const base = xdg && xdg.trim() !== "" ? xdg : join(homedir(), ".config");
-    return join(base, "component-compass");
-}
-/** Absolute path to the hosts.json token store. */
-export function hostsFilePath(env = process.env) {
-    return join(configDir(env), "hosts.json");
-}
-//# sourceMappingURL=paths.js.map

package/dist/auth/paths.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/auth/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,sEAAsE;AACtE,SAAS,SAAS,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrD,0DAA0D;IAC1D,MAAM,GAAG,GAAG,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;AACzC,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;AAC5C,CAAC"}

package/dist/auth/session.d.ts

@@ -1,38 +0,0 @@
-import { type Store } from "./store.js";
-export declare class NotSignedInError extends Error {
-    host: string;
-    constructor(host: string);
-}
-export declare class ReloginRequiredError extends Error {
-    host: string;
-    constructor(host: string);
-}
-export declare class IdpUnavailableError extends Error {
-    host: string;
-    reason: string;
-    constructor(host: string, reason: string);
-}
-/** Host precedence: flag → repo config → COMPONENT_COMPASS_HOST → stored default. Returns a normalized base URL. */
-export declare function resolveHost(opts: {
-    flagHost?: string;
-    configHost?: string;
-    env?: NodeJS.ProcessEnv;
-    store: Store;
-}): string;
-/**
- * Return a valid access token for `host`, silently refreshing when near expiry
- * (or when `force` is set). Persists the rotated pair. Throws:
- *  - NotSignedInError      — no stored entry
- *  - ReloginRequiredError  — terminal refresh failure (tokens cleared)
- *  - IdpUnavailableError   — transient refresh failure (tokens kept)
- */
-export declare function getAccessToken(host: string, deps?: {
-    force?: boolean;
-    now?: () => number;
-    filePath?: string;
-}): Promise<{
-    accessToken: string;
-    userEmail: string;
-}>;
-/** Map an auth error to friendly copy, or null if it is not an auth error. */
-export declare function formatAuthError(err: unknown): string | null;

package/dist/auth/session.js

@@ -1,88 +0,0 @@
-import { loadStore, saveStore, normalizeHost } from "./store.js";
-import { refreshTokens } from "./client.js";
-/** Refresh this many ms before the recorded expiry. */
-const EXPIRY_SKEW_MS = 60_000;
-export class NotSignedInError extends Error {
-    host;
-    constructor(host) {
-        super(`Not signed in to ${host}. Run \`component-compass auth login --host ${host}\`.`);
-        this.host = host;
-    }
-}
-export class ReloginRequiredError extends Error {
-    host;
-    constructor(host) {
-        super(`Session for ${host} expired or was revoked. Run \`component-compass auth login --host ${host}\`.`);
-        this.host = host;
-    }
-}
-export class IdpUnavailableError extends Error {
-    host;
-    reason;
-    constructor(host, reason) {
-        super(`Could not reach the identity provider to refresh credentials for ${host} (${reason}). Check your network and retry.`);
-        this.host = host;
-        this.reason = reason;
-    }
-}
-/** Host precedence: flag → repo config → COMPONENT_COMPASS_HOST → stored default. Returns a normalized base URL. */
-export function resolveHost(opts) {
-    const env = opts.env ?? process.env;
-    // biome-ignore lint/complexity/useLiteralKeys: env access
-    const raw = opts.flagHost ?? opts.configHost ?? env["COMPONENT_COMPASS_HOST"] ?? opts.store.default;
-    if (!raw) {
-        throw new Error("No upload host configured. Pass --host, set COMPONENT_COMPASS_HOST, add `host` to component-compass.config.json, or run `component-compass auth login --host <url>`.");
-    }
-    return normalizeHost(raw);
-}
-/**
- * Return a valid access token for `host`, silently refreshing when near expiry
- * (or when `force` is set). Persists the rotated pair. Throws:
- *  - NotSignedInError      — no stored entry
- *  - ReloginRequiredError  — terminal refresh failure (tokens cleared)
- *  - IdpUnavailableError   — transient refresh failure (tokens kept)
- */
-export async function getAccessToken(host, deps = {}) {
-    const now = deps.now ?? Date.now;
-    const base = normalizeHost(host);
-    const store = await loadStore(deps.filePath);
-    const entry = store.hosts[base];
-    if (!entry)
-        throw new NotSignedInError(base);
-    const stillValid = Date.parse(entry.expiresAt) - now() > EXPIRY_SKEW_MS;
-    if (stillValid && !deps.force) {
-        return { accessToken: entry.accessToken, userEmail: entry.userEmail };
-    }
-    const result = await refreshTokens(base, entry.refreshToken);
-    if (result.kind === "tokens") {
-        const updated = {
-            accessToken: result.tokens.accessToken,
-            refreshToken: result.tokens.refreshToken,
-            userEmail: result.tokens.email ?? entry.userEmail,
-            expiresAt: new Date(now() + result.tokens.expiresIn * 1000).toISOString(),
-        };
-        store.hosts[base] = updated;
-        await saveStore(store, deps.filePath);
-        return { accessToken: updated.accessToken, userEmail: updated.userEmail };
-    }
-    if (result.kind === "terminal") {
-        const { [base]: _removed, ...remainingHosts } = store.hosts;
-        const cleared = {
-            hosts: remainingHosts,
-            ...(store.default && store.default !== base ? { default: store.default } : {}),
-        };
-        await saveStore(cleared, deps.filePath);
-        throw new ReloginRequiredError(base);
-    }
-    throw new IdpUnavailableError(base, result.error);
-}
-/** Map an auth error to friendly copy, or null if it is not an auth error. */
-export function formatAuthError(err) {
-    if (err instanceof NotSignedInError ||
-        err instanceof ReloginRequiredError ||
-        err instanceof IdpUnavailableError) {
-        return err.message;
-    }
-    return null;
-}
-//# sourceMappingURL=session.js.map

package/dist/auth/session.js.map

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

package/dist/auth/store.d.ts

@@ -1,16 +0,0 @@
-export type HostEntry = {
-    accessToken: string;
-    refreshToken: string;
-    userEmail: string;
-    /** ISO 8601 access-token expiry. */
-    expiresAt: string;
-};
-export type Store = {
-    /** Normalized base URL of the default host, if any. */
-    default?: string;
-    hosts: Record<string, HostEntry>;
-};
-/** Canonical base URL: prepend https:// when no scheme, strip trailing slashes. */
-export declare function normalizeHost(input: string): string;
-export declare function loadStore(filePath?: string): Promise<Store>;
-export declare function saveStore(store: Store, filePath?: string): Promise<void>;

package/dist/auth/store.js

@@ -1,37 +0,0 @@
-import { mkdir, readFile, writeFile, chmod } from "node:fs/promises";
-import { dirname } from "node:path";
-import { hostsFilePath } from "./paths.js";
-/** Canonical base URL: prepend https:// when no scheme, strip trailing slashes. */
-export function normalizeHost(input) {
-    const trimmed = input.trim();
-    if (trimmed === "")
-        throw new Error("Host must not be empty.");
-    const withScheme = /^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`;
-    return withScheme.replace(/\/+$/, "");
-}
-export async function loadStore(filePath = hostsFilePath()) {
-    let raw;
-    try {
-        raw = await readFile(filePath, "utf8");
-    }
-    catch (err) {
-        if (err.code === "ENOENT")
-            return { hosts: {} };
-        throw err;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        throw new Error(`Token store at ${filePath} contains invalid JSON. Delete it and run \`component-compass auth login\` again.`);
-    }
-    return { ...(parsed.default ? { default: parsed.default } : {}), hosts: parsed.hosts ?? {} };
-}
-export async function saveStore(store, filePath = hostsFilePath()) {
-    await mkdir(dirname(filePath), { recursive: true, mode: 0o700 });
-    await writeFile(filePath, `${JSON.stringify(store, null, 2)}\n`, { mode: 0o600 });
-    // writeFile's mode is ignored when the file already exists; force it.
-    await chmod(filePath, 0o600);
-}
-//# sourceMappingURL=store.js.map

package/dist/auth/store.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/auth/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgB3C,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,OAAO,EAAE,CAAC;IAC7F,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAQ,GAAG,aAAa,EAAE;IACxD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAC3E,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,MAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,mFAAmF,CAAC,CAAC;IACjI,CAAC;IACD,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;AAC/F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAY,EAAE,QAAQ,GAAG,aAAa,EAAE;IACtE,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjE,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAClF,sEAAsE;IACtE,MAAM,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/auth/upload-auth.d.ts

@@ -1,22 +0,0 @@
-import { type UploadResult } from "../upload.js";
-export type AuthedUploader = {
-    /** Normalized base URL uploads are sent to. */
-    base: string;
-    /** Upload one artifact. Store-backed path refreshes + retries once on a 401; COMPONENT_COMPASS_TOKEN path sends the token directly with no refresh or retry. */
-    upload: (artifactJson: string) => Promise<UploadResult>;
-};
-/**
- * Resolve the host from precedence, obtain an access token, and return an
- * uploader that injects the token. When COMPONENT_COMPASS_TOKEN is set the token is used
- * directly with no refresh or 401-retry. Otherwise the store-backed path
- * silently refreshes a stale token and retries once on 401.
- * Throws NotSignedInError / ReloginRequiredError / IdpUnavailableError up front
- * (store-backed path only).
- */
-export declare function createAuthedUploader(opts: {
-    flagHost?: string;
-    configHost?: string;
-    store?: {
-        filePath?: string;
-    };
-}): Promise<AuthedUploader>;

package/dist/auth/upload-auth.js

@@ -1,51 +0,0 @@
-import { loadStore } from "./store.js";
-import { resolveHost, getAccessToken } from "./session.js";
-import { uploadArtifact, UploadError } from "../upload.js";
-/**
- * Resolve the host from precedence, obtain an access token, and return an
- * uploader that injects the token. When COMPONENT_COMPASS_TOKEN is set the token is used
- * directly with no refresh or 401-retry. Otherwise the store-backed path
- * silently refreshes a stale token and retries once on 401.
- * Throws NotSignedInError / ReloginRequiredError / IdpUnavailableError up front
- * (store-backed path only).
- */
-export async function createAuthedUploader(opts) {
-    const filePath = opts.store?.filePath;
-    const store = await loadStore(filePath);
-    const base = resolveHost({
-        ...(opts.flagHost !== undefined ? { flagHost: opts.flagHost } : {}),
-        ...(opts.configHost !== undefined ? { configHost: opts.configHost } : {}),
-        store,
-    });
-    // Non-interactive path: a CI runner sets COMPONENT_COMPASS_TOKEN to a shared secret
-    // (or any pre-obtained bearer). Use it directly and skip the token lookup,
-    // refresh, and 401-retry — there is nothing to refresh; a 401 is a hard
-    // failure to surface, not a recoverable state.
-    // biome-ignore lint/complexity/useLiteralKeys: env access
-    const ciToken = process.env["COMPONENT_COMPASS_TOKEN"];
-    if (ciToken) {
-        return {
-            base,
-            async upload(artifactJson) {
-                return await uploadArtifact({ host: base, token: ciToken, artifactJson });
-            },
-        };
-    }
-    let token = (await getAccessToken(base, filePath !== undefined ? { filePath } : {})).accessToken;
-    return {
-        base,
-        async upload(artifactJson) {
-            try {
-                return await uploadArtifact({ host: base, token, artifactJson });
-            }
-            catch (err) {
-                if (err instanceof UploadError && err.code === 401) {
-                    token = (await getAccessToken(base, { force: true, ...(filePath !== undefined ? { filePath } : {}) })).accessToken;
-                    return await uploadArtifact({ host: base, token, artifactJson });
-                }
-                throw err;
-            }
-        },
-    };
-}
-//# sourceMappingURL=upload-auth.js.map

package/dist/auth/upload-auth.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"upload-auth.js","sourceRoot":"","sources":["../../src/auth/upload-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAqB,MAAM,cAAc,CAAC;AAS9E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAI1C;IACC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;IAExC,MAAM,IAAI,GAAG,WAAW,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,KAAK;KACN,CAAC,CAAC;IACH,oFAAoF;IACpF,2EAA2E;IAC3E,wEAAwE;IACxE,+CAA+C;IAC/C,0DAA0D;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO;YACL,IAAI;YACJ,KAAK,CAAC,MAAM,CAAC,YAAoB;gBAC/B,OAAO,MAAM,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;YAC5E,CAAC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,MAAM,cAAc,CAAC,IAAI,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IAEjG,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,MAAM,CAAC,YAAoB;YAC/B,IAAI,CAAC;gBACH,OAAO,MAAM,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YACnE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,WAAW,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;oBACnD,KAAK,GAAG,CAAC,MAAM,cAAc,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;oBACnH,OAAO,MAAM,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;gBACnE,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/help.d.ts

@@ -1,4 +0,0 @@
-/** Top-level overview: `component-compass`, `component-compass --help`. */
-export declare function topHelp(): string;
-/** Per-command usage: `component-compass <cmd> --help`. Falls back to the overview. */
-export declare function commandHelp(command: string): string;

package/dist/cli/help.js

@@ -1,52 +0,0 @@
-const TOP = `component-compass <command> [options]
-
-Commands:
-  scan          Scan repo and write component-compass.json
-  init          Scaffold component-compass.config.json
-  auth          Sign in / out of a Component Compass host (login | logout | status)
-
-Run \`component-compass <command> --help\` for command-specific options.
-
-Other:
-  --help, -h
-  --version, -v
-`;
-const SCAN = `component-compass scan [options]
-
-Scan the repo and write component-compass.json.
-
-Options:
-  --config <path>    Override config path (default: ./component-compass.config.json)
-  --output <path>    Override output path
-  --quiet            Suppress STDOUT summary
-  --repo-id <value>  Override repo identifier in the artifact
-  --repo-root <dir>  Directory to treat as the repository root for artefact paths (default: git toplevel)
-  --upload           Also POST the scan to the configured host
-  --host <url>       Override host URL (else config.host, else COMPONENT_COMPASS_HOST env)
-`;
-const INIT = `component-compass init [options]
-
-Scaffold component-compass.config.json. Interactive when run in a terminal.
-
-Options:
-  --output <path>     Config output path (default: ./component-compass.config.json)
-  --framework <name>  Pre-select a framework (repeatable): react | vue | lit | html | wc
-  --repo-id <value>   Repo identifier (default: derived from package.json / dir)
-  -y, --yes           Accept defaults without prompting (non-interactive)
-`;
-const AUTH = `component-compass auth <login|logout|status> [--host <url>]
-
-  login   Device-flow browser login; stores tokens in ~/.config/component-compass/hosts.json
-  logout  Remove stored tokens for a host
-  status  Show the signed-in identity
-`;
-const REGISTRY = { scan: SCAN, init: INIT, auth: AUTH };
-/** Top-level overview: `component-compass`, `component-compass --help`. */
-export function topHelp() {
-    return TOP;
-}
-/** Per-command usage: `component-compass <cmd> --help`. Falls back to the overview. */
-export function commandHelp(command) {
-    return REGISTRY[command] ?? TOP;
-}
-//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,MAAM,GAAG,GAAG;;;;;;;;;;;;CAYX,CAAC;AAEF,MAAM,IAAI,GAAG;;;;;;;;;;;;CAYZ,CAAC;AAEF,MAAM,IAAI,GAAG;;;;;;;;;CASZ,CAAC;AAEF,MAAM,IAAI,GAAG;;;;;CAKZ,CAAC;AAEF,MAAM,QAAQ,GAA2B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAEhF,2EAA2E;AAC3E,MAAM,UAAU,OAAO;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC;AAClC,CAAC"}

package/dist/cli/parse.d.ts

@@ -1,14 +0,0 @@
-/** A user-facing CLI error: its message is printed and `exitCode` is returned. */
-export declare class CliError extends Error {
-    exitCode: number;
-    constructor(message: string, exitCode?: number);
-}
-export declare const KNOWN_COMMANDS: readonly ["scan", "init", "auth"];
-export type ParsedCommand = {
-    values: Record<string, string | boolean | string[] | undefined>;
-    positionals: string[];
-};
-/** Parse one command's argv in strict mode, mapping failures to a CliError. */
-export declare function parseCommand(command: string, argv: string[]): ParsedCommand;
-/** Message for an unrecognised top-level command, with a nearest-match hint. */
-export declare function unknownCommandMessage(command: string): string;