@scalepad/cli 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+export interface ProfileMetadata {
+    storage?: "keytar" | "file";
+}
+export interface CliConfig {
+    currentProfile: string;
+    profiles: Record<string, ProfileMetadata>;
+}
+export declare function getConfigPath(): string;
+export declare function getFallbackCredentialsPath(): string;
+export declare function ensureConfigDir(): Promise<void>;
+export declare function loadConfig(): Promise<CliConfig>;
+export declare function saveConfig(config: CliConfig): Promise<void>;
+export declare function writePrivateJson(path: string, value: unknown): Promise<void>;

package/dist/config.js

@@ -0,0 +1,49 @@
+import { chmod, mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const DEFAULT_CONFIG = {
+    currentProfile: "default",
+    profiles: {}
+};
+function configRoot() {
+    const xdg = process.env.XDG_CONFIG_HOME;
+    if (xdg) {
+        return join(xdg, "scalepad-cli");
+    }
+    return join(homedir(), ".config", "scalepad-cli");
+}
+export function getConfigPath() {
+    return join(configRoot(), "config.json");
+}
+export function getFallbackCredentialsPath() {
+    return join(configRoot(), "credentials.json");
+}
+export async function ensureConfigDir() {
+    await mkdir(configRoot(), { recursive: true });
+}
+export async function loadConfig() {
+    try {
+        const raw = await readFile(getConfigPath(), "utf8");
+        const parsed = JSON.parse(raw);
+        return {
+            currentProfile: parsed.currentProfile ?? "default",
+            profiles: parsed.profiles ?? {}
+        };
+    }
+    catch {
+        return structuredClone(DEFAULT_CONFIG);
+    }
+}
+export async function saveConfig(config) {
+    await ensureConfigDir();
+    const path = getConfigPath();
+    await writeFile(path, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    await chmod(path, 0o600);
+}
+export async function writePrivateJson(path, value) {
+    await ensureConfigDir();
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+    await chmod(path, 0o600);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAW1C,MAAM,cAAc,GAAc;IAChC,cAAc,EAAE,SAAS;IACzB,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF,SAAS,UAAU;IACjB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACxC,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,aAAa,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,kBAAkB,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;QACrD,OAAO;YACL,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,SAAS;YAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;SAChC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAiB;IAChD,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtE,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAc;IACjE,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrE,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/credentials.d.ts

@@ -0,0 +1,9 @@
+export declare function storeApiKey(profile: string, apiKey: string): Promise<"keytar" | "file">;
+export declare function readStoredApiKey(profile: string): Promise<string | null>;
+export declare function deleteStoredApiKey(profile: string): Promise<boolean>;
+export interface ResolveApiKeyOptions {
+    explicitApiKey?: string;
+    envApiKey?: string;
+    profile: string;
+}
+export declare function resolveApiKey(options: ResolveApiKeyOptions): Promise<string | null>;

package/dist/credentials.js

@@ -0,0 +1,91 @@
+import { chmod, readFile, rm } from "node:fs/promises";
+import { getFallbackCredentialsPath, loadConfig, saveConfig, writePrivateJson } from "./config.js";
+const SERVICE_NAME = "@scalepad/cli";
+async function maybeLoadKeytar() {
+    try {
+        const module = await import("keytar");
+        return module.default;
+    }
+    catch {
+        return null;
+    }
+}
+function accountName(profile) {
+    return `profile:${profile}`;
+}
+async function readFallbackFile() {
+    try {
+        const raw = await readFile(getFallbackCredentialsPath(), "utf8");
+        const parsed = JSON.parse(raw);
+        return { profiles: parsed.profiles ?? {} };
+    }
+    catch {
+        return { profiles: {} };
+    }
+}
+async function writeFallbackFile(value) {
+    await writePrivateJson(getFallbackCredentialsPath(), value);
+}
+export async function storeApiKey(profile, apiKey) {
+    const config = await loadConfig();
+    const keytar = await maybeLoadKeytar();
+    if (keytar) {
+        await keytar.setPassword(SERVICE_NAME, accountName(profile), apiKey);
+        config.profiles[profile] = { storage: "keytar" };
+        config.currentProfile = profile;
+        await saveConfig(config);
+        return "keytar";
+    }
+    const fallback = await readFallbackFile();
+    fallback.profiles[profile] = apiKey;
+    await writeFallbackFile(fallback);
+    await chmod(getFallbackCredentialsPath(), 0o600);
+    config.profiles[profile] = { storage: "file" };
+    config.currentProfile = profile;
+    await saveConfig(config);
+    return "file";
+}
+export async function readStoredApiKey(profile) {
+    const keytar = await maybeLoadKeytar();
+    if (keytar) {
+        const key = await keytar.getPassword(SERVICE_NAME, accountName(profile));
+        if (key) {
+            return key;
+        }
+    }
+    const fallback = await readFallbackFile();
+    return fallback.profiles[profile] ?? null;
+}
+export async function deleteStoredApiKey(profile) {
+    const config = await loadConfig();
+    let removed = false;
+    const keytar = await maybeLoadKeytar();
+    if (keytar) {
+        removed = (await keytar.deletePassword(SERVICE_NAME, accountName(profile))) || removed;
+    }
+    const fallback = await readFallbackFile();
+    if (profile in fallback.profiles) {
+        delete fallback.profiles[profile];
+        await writeFallbackFile(fallback);
+        removed = true;
+    }
+    delete config.profiles[profile];
+    if (config.currentProfile === profile) {
+        config.currentProfile = "default";
+    }
+    await saveConfig(config);
+    if (Object.keys(fallback.profiles).length === 0) {
+        await rm(getFallbackCredentialsPath(), { force: true });
+    }
+    return removed;
+}
+export async function resolveApiKey(options) {
+    if (options.explicitApiKey) {
+        return options.explicitApiKey;
+    }
+    if (options.envApiKey) {
+        return options.envApiKey;
+    }
+    return readStoredApiKey(options.profile);
+}
+//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

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

package/dist/filters.d.ts

@@ -0,0 +1,6 @@
+export declare function parseFilterArgs(values: string[]): Record<string, string>;
+export declare function buildSort(sortField: string | undefined, desc: boolean): string | undefined;
+type JsonLike = Record<string, unknown>;
+export declare function projectRecord(record: JsonLike, fields: string[] | undefined): JsonLike;
+export declare function flattenRecord(value: JsonLike, prefix?: string): Record<string, string>;
+export {};

package/dist/filters.js

@@ -0,0 +1,56 @@
+export function parseFilterArgs(values) {
+    const filters = {};
+    for (const rawValue of values) {
+        const separatorIndex = rawValue.indexOf("=");
+        if (separatorIndex <= 0 || separatorIndex === rawValue.length - 1) {
+            throw new Error(`Invalid filter '${rawValue}'. Expected field=expression.`);
+        }
+        const field = rawValue.slice(0, separatorIndex).trim();
+        const expression = rawValue.slice(separatorIndex + 1).trim();
+        if (!field || !expression) {
+            throw new Error(`Invalid filter '${rawValue}'. Expected field=expression.`);
+        }
+        filters[field] = expression;
+    }
+    return filters;
+}
+export function buildSort(sortField, desc) {
+    if (!sortField) {
+        return undefined;
+    }
+    return `${desc ? "-" : "+"}${sortField}`;
+}
+function getNestedValue(record, path) {
+    const segments = path.split(".");
+    let current = record;
+    for (const segment of segments) {
+        if (current == null || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+export function projectRecord(record, fields) {
+    if (!fields || fields.length === 0) {
+        return record;
+    }
+    return Object.fromEntries(fields.map((field) => [field, getNestedValue(record, field)]));
+}
+export function flattenRecord(value, prefix = "") {
+    const flattened = {};
+    for (const [key, fieldValue] of Object.entries(value)) {
+        const nextKey = prefix ? `${prefix}.${key}` : key;
+        if (Array.isArray(fieldValue)) {
+            flattened[nextKey] = JSON.stringify(fieldValue);
+            continue;
+        }
+        if (fieldValue != null && typeof fieldValue === "object") {
+            Object.assign(flattened, flattenRecord(fieldValue, nextKey));
+            continue;
+        }
+        flattened[nextKey] = fieldValue == null ? "" : String(fieldValue);
+    }
+    return flattened;
+}
+//# sourceMappingURL=filters.js.map

package/dist/filters.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,20 @@
+export type JsonLike = Record<string, unknown>;
+export type OutputFormat = "table" | "json" | "jsonl" | "csv";
+export interface FormatFlags {
+    json?: boolean;
+    jsonl?: boolean;
+    csv?: boolean;
+    table?: boolean;
+}
+export interface ExtractedList {
+    items: JsonLike[];
+    nextCursor?: string | null;
+    totalCount?: number | null;
+}
+export declare function resolveOutputFormat(flags: FormatFlags): OutputFormat;
+export declare function extractList(payload: unknown): ExtractedList;
+export declare function printList(payload: unknown, format: OutputFormat, fields?: string[], metadataWriter?: (message: string) => void): void;
+export declare function printObject(payload: unknown, format: OutputFormat, fields?: string[]): void;
+export declare function parseFields(value: string | undefined): string[] | undefined;
+export declare function formatApiError(error: unknown): string;
+export declare function toPlainMessage(value: unknown): string;

package/dist/format.js

@@ -0,0 +1,155 @@
+import { flattenRecord, projectRecord } from "./filters.js";
+export function resolveOutputFormat(flags) {
+    if (flags.json) {
+        return "json";
+    }
+    if (flags.jsonl) {
+        return "jsonl";
+    }
+    if (flags.csv) {
+        return "csv";
+    }
+    return "table";
+}
+export function extractList(payload) {
+    if (Array.isArray(payload)) {
+        return { items: payload.filter(isJsonLike) };
+    }
+    if (!isJsonLike(payload)) {
+        return { items: [] };
+    }
+    const dataCandidate = payload.data;
+    const nextCursor = typeof payload.next_cursor === "string" ? payload.next_cursor : null;
+    const totalCount = typeof payload.total_count === "number" ? payload.total_count : null;
+    if (Array.isArray(dataCandidate)) {
+        return {
+            items: dataCandidate.filter(isJsonLike),
+            nextCursor,
+            totalCount
+        };
+    }
+    return { items: [payload], nextCursor, totalCount };
+}
+function isJsonLike(value) {
+    return value != null && typeof value === "object" && !Array.isArray(value);
+}
+function formatScalar(value) {
+    if (value == null) {
+        return "";
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    return JSON.stringify(value);
+}
+function renderTable(records) {
+    if (records.length === 0) {
+        return "No records found.";
+    }
+    const columnSet = new Set();
+    const rows = records.map((record) => flattenRecord(record));
+    for (const row of rows) {
+        for (const key of Object.keys(row)) {
+            columnSet.add(key);
+        }
+    }
+    const columns = [...columnSet];
+    const widths = columns.map((column) => column.length);
+    rows.forEach((row) => {
+        columns.forEach((column, index) => {
+            widths[index] = Math.max(widths[index] ?? 0, (row[column] ?? "").length);
+        });
+    });
+    const header = columns.map((column, index) => column.padEnd(widths[index] ?? column.length)).join("  ");
+    const separator = columns.map((column, index) => "-".repeat(widths[index] ?? column.length)).join("  ");
+    const body = rows.map((row) => columns.map((column, index) => (row[column] ?? "").padEnd(widths[index] ?? column.length)).join("  "));
+    return [header, separator, ...body].join("\n");
+}
+function renderCsv(records) {
+    if (records.length === 0) {
+        return "";
+    }
+    const flattened = records.map((record) => flattenRecord(record));
+    const columns = [...new Set(flattened.flatMap((record) => Object.keys(record)))];
+    const escapeValue = (value) => {
+        if (value.includes(",") || value.includes("\"") || value.includes("\n")) {
+            return `"${value.replaceAll("\"", "\"\"")}"`;
+        }
+        return value;
+    };
+    const lines = [
+        columns.join(","),
+        ...flattened.map((record) => columns.map((column) => escapeValue(record[column] ?? "")).join(","))
+    ];
+    return lines.join("\n");
+}
+export function printList(payload, format, fields, metadataWriter = console.error) {
+    if (format === "json") {
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+    }
+    const extracted = extractList(payload);
+    const projected = extracted.items.map((item) => projectRecord(item, fields));
+    switch (format) {
+        case "jsonl":
+            projected.forEach((item) => {
+                console.log(JSON.stringify(item));
+            });
+            break;
+        case "csv":
+            console.log(renderCsv(projected));
+            break;
+        case "table":
+            console.log(renderTable(projected));
+            break;
+        default:
+            break;
+    }
+    const parts = [];
+    parts.push(`items=${projected.length}`);
+    if (extracted.totalCount != null) {
+        parts.push(`total_count=${extracted.totalCount}`);
+    }
+    if (extracted.nextCursor) {
+        parts.push(`next_cursor=${extracted.nextCursor}`);
+    }
+    metadataWriter(parts.join(" "));
+}
+export function printObject(payload, format, fields) {
+    if (!isJsonLike(payload)) {
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+    }
+    const projected = projectRecord(payload, fields);
+    if (format === "json" || format === "jsonl") {
+        console.log(JSON.stringify(projected, null, format === "json" ? 2 : 0));
+        return;
+    }
+    if (format === "csv") {
+        console.log(renderCsv([projected]));
+        return;
+    }
+    console.log(renderTable([projected]));
+}
+export function parseFields(value) {
+    if (!value) {
+        return undefined;
+    }
+    return value.split(",").map((field) => field.trim()).filter(Boolean);
+}
+export function formatApiError(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+export function toPlainMessage(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    return formatScalar(value);
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};