@ecomweb/cli 0.1.0

package/dist/lib/errors.d.ts

@@ -0,0 +1,30 @@
+export declare enum ExitCode {
+    SUCCESS = 0,
+    ERROR = 1,
+    VALIDATION = 2,
+    AUTH_FAILURE = 3,
+    NOT_FOUND = 4
+}
+export interface CliErrorPayload {
+    code: string;
+    message: string;
+    hint?: string;
+    details?: Record<string, unknown>;
+}
+export declare class CliError extends Error {
+    readonly exitCode: ExitCode;
+    readonly payload: CliErrorPayload;
+    constructor(code: string, message: string, exitCode?: ExitCode, options?: {
+        hint?: string;
+        details?: Record<string, unknown>;
+    });
+    toJSON(): {
+        error: CliErrorPayload;
+    };
+}
+export declare function formatError(error: unknown): {
+    json: {
+        error: CliErrorPayload;
+    };
+    exitCode: ExitCode;
+};

package/dist/lib/errors.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliError = exports.ExitCode = void 0;
+exports.formatError = formatError;
+var ExitCode;
+(function (ExitCode) {
+    ExitCode[ExitCode["SUCCESS"] = 0] = "SUCCESS";
+    ExitCode[ExitCode["ERROR"] = 1] = "ERROR";
+    ExitCode[ExitCode["VALIDATION"] = 2] = "VALIDATION";
+    ExitCode[ExitCode["AUTH_FAILURE"] = 3] = "AUTH_FAILURE";
+    ExitCode[ExitCode["NOT_FOUND"] = 4] = "NOT_FOUND";
+})(ExitCode || (exports.ExitCode = ExitCode = {}));
+class CliError extends Error {
+    constructor(code, message, exitCode = ExitCode.ERROR, options) {
+        super(message);
+        this.name = "CliError";
+        this.exitCode = exitCode;
+        this.payload = {
+            code,
+            message,
+            ...(options?.hint && { hint: options.hint }),
+            ...(options?.details && { details: options.details }),
+        };
+    }
+    toJSON() {
+        return { error: this.payload };
+    }
+}
+exports.CliError = CliError;
+function formatError(error) {
+    if (error instanceof CliError) {
+        return { json: error.toJSON(), exitCode: error.exitCode };
+    }
+    if (isAxiosError(error)) {
+        return mapHttpError(error);
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        json: { error: { code: "UNEXPECTED_ERROR", message } },
+        exitCode: ExitCode.ERROR,
+    };
+}
+function isAxiosError(err) {
+    return typeof err === "object" && err !== null && "isAxiosError" in err && err.isAxiosError === true;
+}
+function mapHttpError(err) {
+    const status = err.response?.status;
+    const data = err.response?.data;
+    const serverMessage = data?.message || data?.error || err.message;
+    switch (status) {
+        case 401:
+            return {
+                json: {
+                    error: {
+                        code: "UNAUTHORIZED",
+                        message: serverMessage || "Authentication required.",
+                        hint: "Run: ecomweb auth login",
+                    },
+                },
+                exitCode: ExitCode.AUTH_FAILURE,
+            };
+        case 403:
+            return {
+                json: {
+                    error: {
+                        code: "FORBIDDEN",
+                        message: serverMessage || "Insufficient permissions.",
+                        hint: "Check your API key scopes.",
+                    },
+                },
+                exitCode: ExitCode.AUTH_FAILURE,
+            };
+        case 404:
+            return {
+                json: {
+                    error: {
+                        code: "NOT_FOUND",
+                        message: serverMessage || "Resource not found.",
+                    },
+                },
+                exitCode: ExitCode.NOT_FOUND,
+            };
+        case 422:
+            return {
+                json: {
+                    error: {
+                        code: "VALIDATION_ERROR",
+                        message: serverMessage || "Validation failed.",
+                        ...(data && { details: data }),
+                    },
+                },
+                exitCode: ExitCode.VALIDATION,
+            };
+        case 429:
+            return {
+                json: {
+                    error: {
+                        code: "RATE_LIMITED",
+                        message: "Rate limit exceeded. Try again later.",
+                    },
+                },
+                exitCode: ExitCode.ERROR,
+            };
+        default:
+            return {
+                json: {
+                    error: {
+                        code: `HTTP_${status || "UNKNOWN"}`,
+                        message: serverMessage || `HTTP error ${status}`,
+                    },
+                },
+                exitCode: ExitCode.ERROR,
+            };
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

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

package/dist/lib/output.d.ts

@@ -0,0 +1,39 @@
+export type OutputFormat = "json" | "table" | "csv";
+export interface OutputEnvelope {
+    resource: string;
+    action: string;
+    store_id?: number;
+    data: any;
+    meta?: Record<string, any>;
+    total_count?: number;
+    query?: string;
+    found?: number;
+    page?: number;
+    request_params?: Record<string, any>;
+    available_actions?: string[];
+    hints?: Record<string, string>;
+}
+export interface OutputOptions {
+    format: OutputFormat;
+    quiet: boolean;
+    full: boolean;
+    fields?: string[];
+    exclude?: string[];
+}
+export declare function formatOutput(envelope: OutputEnvelope, options: OutputOptions): string;
+export declare function listEnvelope(resource: string, storeId: number, data: any[], meta: Record<string, any>, options?: {
+    availableActions?: string[];
+    hints?: Record<string, string>;
+}): OutputEnvelope;
+export declare function getEnvelope(resource: string, storeId: number, data: any, options?: {
+    hints?: Record<string, string>;
+}): OutputEnvelope;
+export declare function mutationEnvelope(resource: string, action: string, storeId: number, data: any, hints?: Record<string, string>): OutputEnvelope;
+export declare function allEnvelope(resource: string, storeId: number, data: any[], options?: {
+    hints?: Record<string, string>;
+}): OutputEnvelope;
+export declare function searchEnvelope(resource: string, storeId: number, query: string, data: any[], meta: {
+    found: number;
+    page: number;
+    request_params: Record<string, any>;
+}, hints?: Record<string, string>): OutputEnvelope;

package/dist/lib/output.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatOutput = formatOutput;
+exports.listEnvelope = listEnvelope;
+exports.getEnvelope = getEnvelope;
+exports.mutationEnvelope = mutationEnvelope;
+exports.allEnvelope = allEnvelope;
+exports.searchEnvelope = searchEnvelope;
+const HEAVY_FIELDS = ["content", "toc"];
+function formatOutput(envelope, options) {
+    const { format } = options;
+    const filtered = filterFields(envelope, options);
+    switch (format) {
+        case "table":
+            return formatTable(filtered);
+        case "csv":
+            return formatCsv(filtered);
+        case "json":
+        default:
+            return JSON.stringify(filtered, null, 2);
+    }
+}
+function filterFields(envelope, options) {
+    const { full, fields, exclude } = options;
+    let { data } = envelope;
+    if (!data)
+        return envelope;
+    const isArray = Array.isArray(data);
+    const items = isArray ? data : [data];
+    const filtered = items.map((item) => {
+        if (typeof item !== "object" || item === null)
+            return item;
+        let result = { ...item };
+        if (isArray && !full) {
+            for (const field of HEAVY_FIELDS) {
+                delete result[field];
+            }
+        }
+        if (fields && fields.length > 0) {
+            const picked = {};
+            for (const f of fields) {
+                if (f in result)
+                    picked[f] = result[f];
+            }
+            result = picked;
+        }
+        if (exclude && exclude.length > 0) {
+            for (const f of exclude) {
+                delete result[f];
+            }
+        }
+        return result;
+    });
+    return { ...envelope, data: isArray ? filtered : filtered[0] };
+}
+function formatTable(envelope) {
+    const { data } = envelope;
+    if (!data)
+        return "(no data)";
+    const items = Array.isArray(data) ? data : [data];
+    if (items.length === 0)
+        return "(no results)";
+    const keys = Object.keys(items[0]).filter((k) => typeof items[0][k] !== "object" || items[0][k] === null);
+    const widths = {};
+    for (const key of keys) {
+        widths[key] = key.length;
+        for (const item of items) {
+            const val = String(item[key] ?? "");
+            widths[key] = Math.max(widths[key], Math.min(val.length, 40));
+        }
+    }
+    const header = keys.map((k) => k.padEnd(widths[k])).join(" | ");
+    const separator = keys.map((k) => "-".repeat(widths[k])).join("-+-");
+    const rows = items.map((item) => keys.map((k) => {
+        const val = String(item[k] ?? "");
+        return val.substring(0, 40).padEnd(widths[k]);
+    }).join(" | "));
+    const lines = [header, separator, ...rows];
+    if (envelope.meta) {
+        lines.push("");
+        lines.push(`Total: ${envelope.meta.total ?? items.length}`);
+    }
+    return lines.join("\n");
+}
+function formatCsv(envelope) {
+    const { data } = envelope;
+    if (!data)
+        return "";
+    const items = Array.isArray(data) ? data : [data];
+    if (items.length === 0)
+        return "";
+    const keys = Object.keys(items[0]).filter((k) => typeof items[0][k] !== "object" || items[0][k] === null);
+    const escape = (val) => {
+        const str = String(val ?? "");
+        if (str.includes(",") || str.includes('"') || str.includes("\n")) {
+            return `"${str.replace(/"/g, '""')}"`;
+        }
+        return str;
+    };
+    const header = keys.join(",");
+    const rows = items.map((item) => keys.map((k) => escape(item[k])).join(","));
+    return [header, ...rows].join("\n");
+}
+function listEnvelope(resource, storeId, data, meta, options) {
+    return {
+        resource,
+        action: "list",
+        store_id: storeId,
+        data,
+        meta,
+        available_actions: options?.availableActions || defaultActions(resource),
+        hints: options?.hints || defaultHints(resource),
+    };
+}
+function getEnvelope(resource, storeId, data, options) {
+    return {
+        resource,
+        action: "get",
+        store_id: storeId,
+        data,
+        available_actions: ["update", "delete"],
+        hints: options?.hints || {
+            update: `ecomweb ${resource} update ${data?.id} --stdin`,
+            delete: `ecomweb ${resource} delete ${data?.id}`,
+        },
+    };
+}
+function mutationEnvelope(resource, action, storeId, data, hints) {
+    return {
+        resource,
+        action,
+        store_id: storeId,
+        data,
+        ...(hints && { hints }),
+    };
+}
+function allEnvelope(resource, storeId, data, options) {
+    return {
+        resource,
+        action: "all",
+        store_id: storeId,
+        data,
+        total_count: data.length,
+        available_actions: ["get", "update", "delete", "batch-update", "batch-delete"],
+        hints: options?.hints || {
+            get_detail: `ecomweb ${resource} get <id>`,
+        },
+    };
+}
+function searchEnvelope(resource, storeId, query, data, meta, hints) {
+    return {
+        resource,
+        action: "search",
+        store_id: storeId,
+        query,
+        found: meta.found,
+        data,
+        page: meta.page,
+        request_params: meta.request_params,
+        available_actions: ["get", "update", "delete"],
+        hints: hints || {
+            get_detail: `ecomweb ${resource} get <id>`,
+            next_page: `ecomweb ${resource} search '${query}' --page ${meta.page + 1}`,
+        },
+    };
+}
+function defaultActions(resource) {
+    return ["get", "create", "update", "delete", "search", "all", "batch-create", "batch-update", "batch-delete"];
+}
+function defaultHints(resource) {
+    return {
+        get_detail: `ecomweb ${resource} get <id>`,
+        create: `ecomweb ${resource} create --stdin`,
+    };
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

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

package/dist/lib/pagination.d.ts

@@ -0,0 +1,8 @@
+import { ApiClient } from "./api-client";
+export interface PaginationParams {
+    limit?: number;
+    offset?: number;
+    [key: string]: any;
+}
+export declare function paginateAll<T>(client: ApiClient, path: string, params?: PaginationParams): AsyncGenerator<T, void, undefined>;
+export declare function collectAll<T>(client: ApiClient, path: string, params?: PaginationParams): Promise<T[]>;

package/dist/lib/pagination.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paginateAll = paginateAll;
+exports.collectAll = collectAll;
+async function* paginateAll(client, path, params = {}) {
+    const limit = params.limit || 100;
+    let offset = params.offset || 0;
+    while (true) {
+        const response = await client.listPaginated(path, { ...params, limit, offset });
+        for (const item of response.data) {
+            yield item;
+        }
+        if (!response.meta.hasNext)
+            break;
+        offset += limit;
+    }
+}
+async function collectAll(client, path, params = {}) {
+    const items = [];
+    for await (const item of paginateAll(client, path, params)) {
+        items.push(item);
+    }
+    return items;
+}
+//# sourceMappingURL=pagination.js.map

package/dist/lib/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/lib/pagination.ts"],"names":[],"mappings":";;AAiBA,kCAkBC;AAKD,gCAUC;AAjCM,KAAK,SAAS,CAAC,CAAC,WAAW,CAChC,MAAiB,EACjB,IAAY,EACZ,SAA2B,EAAE;IAE7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC;IAClC,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IAEhC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAI,IAAI,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnF,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC;QACb,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO;YAAE,MAAM;QAClC,MAAM,IAAI,KAAK,CAAC;IAClB,CAAC;AACH,CAAC;AAKM,KAAK,UAAU,UAAU,CAC9B,MAAiB,EACjB,IAAY,EACZ,SAA2B,EAAE;IAE7B,MAAM,KAAK,GAAQ,EAAE,CAAC;IACtB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,WAAW,CAAI,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/stdin.d.ts

@@ -0,0 +1,9 @@
+export declare function readStdin(): Promise<string | null>;
+export declare function parseJsonInput(options: {
+    stdin?: boolean;
+    file?: string;
+}): Promise<any | null>;
+export declare function getJsonInput(flags: {
+    stdin?: boolean;
+    file?: string;
+}): Promise<any | null>;

package/dist/lib/stdin.js

@@ -0,0 +1,86 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readStdin = readStdin;
+exports.parseJsonInput = parseJsonInput;
+exports.getJsonInput = getJsonInput;
+const fs = __importStar(require("fs"));
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return null;
+    return new Promise((resolve, reject) => {
+        let data = "";
+        process.stdin.setEncoding("utf-8");
+        process.stdin.on("data", (chunk) => (data += chunk));
+        process.stdin.on("end", () => resolve(data.trim() || null));
+        process.stdin.on("error", reject);
+    });
+}
+async function parseJsonInput(options) {
+    if (options.file) {
+        const content = fs.readFileSync(options.file, "utf-8");
+        return JSON.parse(content);
+    }
+    if (options.stdin) {
+        const input = await readStdin();
+        if (input)
+            return JSON.parse(input);
+    }
+    return null;
+}
+async function getJsonInput(flags) {
+    if (flags.stdin || !process.stdin.isTTY) {
+        const input = await readStdin();
+        if (input) {
+            try {
+                return JSON.parse(input);
+            }
+            catch {
+                throw new Error(`Invalid JSON input from stdin: ${input.substring(0, 100)}...`);
+            }
+        }
+    }
+    if (flags.file) {
+        const content = fs.readFileSync(flags.file, "utf-8");
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            throw new Error(`Invalid JSON in file: ${flags.file}`);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=stdin.js.map

package/dist/lib/stdin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.js","sourceRoot":"","sources":["../../src/lib/stdin.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,8BAUC;AAKD,wCAeC;AAMD,oCA0BC;AApED,uCAAyB;AAMlB,KAAK,UAAU,SAAS;IAC7B,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAErC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;QAC5D,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAKM,KAAK,UAAU,cAAc,CAAC,OAGpC;IACC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;QAChC,IAAI,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAMM,KAAK,UAAU,YAAY,CAAC,KAGlC;IAEC,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;QAChC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/validators.d.ts

@@ -0,0 +1,19 @@
+export interface FieldDescriptor {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    constraints?: string;
+    values?: string[];
+    default?: any;
+}
+export interface ResourceSchema {
+    resource: string;
+    operation: string;
+    fields: FieldDescriptor[];
+    example: Record<string, any>;
+    hint: string;
+}
+export declare function getResourceSchema(resource: string, operation: string): ResourceSchema | undefined;
+export declare function getAvailableResources(): string[];
+export declare function getAvailableOperations(resource: string): string[];