@timbrix/cli 0.3.1 → 1.1.0

package/README.md

@@ -90,6 +90,61 @@ timbrix webhooks delete <webhook-id> --org <organization-id>
 timbrix webhooks delete <webhook-id> --org <organization-id> --force
 ```
 
+### Products
+
+```bash
+# List products/services for an organization
+timbrix products list --org <organization-id>
+
+# Get product details
+timbrix products get <product-id> --org <organization-id>
+
+# Create a product
+timbrix products create --org <organization-id>
+timbrix products create --org <organization-id> --description Ukelele --product-key 60131324 --price 345.60
+
+# Update a product
+timbrix products update <product-id> --org <organization-id>
+
+# Bulk import products/services from a CSV file
+timbrix products import --org <organization-id> --file ./products.csv
+
+# Delete a product (PERMANENT)
+timbrix products delete <product-id> --org <organization-id>
+```
+
+### Invoices (CFDI 4.0)
+
+```bash
+# Stamp (timbrar) a new invoice — authenticates with an API key, not the login session
+timbrix invoices create --org <organization-id> --api-key <api-key> --file invoice.json
+timbrix invoices create --org <organization-id> --api-key <api-key> --file invoice.json --output invoice.xml
+
+# List invoices for an organization (newest first)
+timbrix invoices list --org <organization-id>
+timbrix invoices list --org <organization-id> --page 2 --limit 50
+```
+
+### SAT Catalogs
+
+```bash
+# Search SAT claves de producto o servicio (c_ClaveProdServ)
+timbrix sat claves-prod-serv --query ukelele
+timbrix sat claves-prod-serv -q "servicios de consultoria" --limit 10
+
+# Search SAT claves de unidad de medida (c_ClaveUnidad)
+timbrix sat claves-unidad --query pieza
+timbrix sat claves-unidad -q kilogramo --limit 10
+
+# List SAT régimenes fiscales
+timbrix sat regimenes list
+timbrix sat regimenes list --tipo-persona moral
+
+# List SAT usos de CFDI
+timbrix sat usos-cfdi list
+timbrix sat usos-cfdi list --regimen 601
+```
+
 ### API Keys
 
 ```bash
@@ -252,7 +307,9 @@ src/
 │   ├── logout.ts
 │   ├── organizations/ # Organization management
 │   ├── webhooks/      # Webhook management
-│   └── api-keys/      # API key management
+│   ├── api-keys/      # API key management
+│   ├── products/      # Products/services + CSV import
+│   └── sat/           # SAT catalog search (claves, régimenes, usos CFDI)
 ├── config/
 │   └── auth.ts        # Auth configuration manager
 ├── utils/

package/dist/commands/invoices/create.d.ts

@@ -0,0 +1,13 @@
+import { Command } from "@oclif/core";
+export default class InvoicesCreate extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        org: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "api-key": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        file: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/invoices/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/invoices/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAO5C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,OAAgB,WAAW,SAG4C;IAEvE,OAAgB,QAAQ,WAGvB;IAED,OAAgB,KAAK;;;;;MAoBpB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6ClC"}

package/dist/commands/invoices/create.js

@@ -0,0 +1,67 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { Command, Flags } from "@oclif/core";
+import chalk from "chalk";
+import ora from "ora";
+import { createApiKeyClient } from "../../utils/client.js";
+import { getErrorMessage } from "../../utils/error.js";
+export default class InvoicesCreate extends Command {
+    static description = "Create and stamp (timbrar) a CFDI 4.0 invoice via the configured PAC. " +
+        "This command authenticates with --api-key instead of the `timbrix login` " +
+        "session — the key must belong to the organization passed via --org.";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> --org org-id --api-key sk_live_... --file invoice.json",
+        "<%= config.bin %> <%= command.id %> --org org-id --api-key sk_live_... --file invoice.json --output invoice.xml",
+    ];
+    static flags = {
+        org: Flags.string({
+            char: "o",
+            description: "Organization ID (must match the API key's organization)",
+            required: true,
+        }),
+        "api-key": Flags.string({
+            description: "Timbrix API key (needs the write:invoices scope)",
+            env: "TIMBRIX_API_KEY",
+            required: true,
+        }),
+        file: Flags.string({
+            char: "f",
+            description: "Path to a JSON file with the invoice payload (series, folioNumber, date, paymentForm, use, customer|customerId, items)",
+            required: true,
+        }),
+        output: Flags.string({
+            description: "Path to save the timbrado CFDI XML (optional)",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(InvoicesCreate);
+        const client = createApiKeyClient(flags["api-key"]);
+        let payload;
+        try {
+            payload = JSON.parse(readFileSync(flags.file, "utf-8"));
+        }
+        catch (error) {
+            this.error(chalk.red(`Failed to read invoice payload file: ${getErrorMessage(error)}`));
+        }
+        const spinner = ora("Stamping invoice...").start();
+        try {
+            const invoice = await client.invoices.create(flags.org, payload);
+            spinner.succeed(chalk.green("✓ Invoice stamped successfully!"));
+            this.log(chalk.gray("\nInvoice Details:"));
+            this.log(`  ${chalk.bold("ID:")} ${invoice.id}`);
+            this.log(`  ${chalk.bold("UUID:")} ${invoice.uuid}`);
+            this.log(`  ${chalk.bold("Series/Folio:")} ${invoice.series}-${invoice.folioNumber}`);
+            this.log(`  ${chalk.bold("Total:")} $${invoice.total.toFixed(2)}`);
+            if (flags.output) {
+                writeFileSync(flags.output, invoice.xml, "utf-8");
+                this.log(`  ${chalk.bold("XML saved to:")} ${flags.output}`);
+            }
+            else {
+                this.log(chalk.gray("\nPass --output <path> to save the CFDI XML to a file."));
+            }
+        }
+        catch (error) {
+            spinner.fail(chalk.red(`Failed to stamp invoice: ${getErrorMessage(error)}`));
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/invoices/list.d.ts

@@ -0,0 +1,12 @@
+import { Command } from "@oclif/core";
+export default class InvoicesList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        org: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        page: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/invoices/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/invoices/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAQ5C,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,OAAgB,WAAW,SACmC;IAE9D,OAAgB,QAAQ,WAGvB;IAED,OAAgB,KAAK;;;;MAcpB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4DlC"}

package/dist/commands/invoices/list.js

@@ -0,0 +1,75 @@
+import { Command, Flags } from "@oclif/core";
+import chalk from "chalk";
+import ora from "ora";
+import { createClient } from "../../utils/client.js";
+import { getErrorMessage } from "../../utils/error.js";
+import { createTable } from "../../utils/table.js";
+export default class InvoicesList extends Command {
+    static description = "List invoices (CFDI 4.0) for an organization, newest first";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id",
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id --page 2 --limit 50",
+    ];
+    static flags = {
+        org: Flags.string({
+            char: "o",
+            description: "Organization ID",
+            required: true,
+        }),
+        page: Flags.integer({
+            char: "p",
+            description: "Page number (1-indexed)",
+        }),
+        limit: Flags.integer({
+            char: "l",
+            description: "Results per page (1-100)",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(InvoicesList);
+        const client = createClient();
+        const spinner = ora("Fetching invoices...").start();
+        try {
+            const result = await client.invoices.list(flags.org, {
+                page: flags.page,
+                limit: flags.limit,
+            });
+            spinner.stop();
+            if (result.data.length === 0) {
+                this.log(chalk.yellow("No invoices found"));
+                this.log(chalk.gray(`\nStamp an invoice with: timbrix invoices create --org ${flags.org} --api-key <key> --file invoice.json`));
+                return;
+            }
+            const table = createTable([
+                "ID",
+                "UUID",
+                "Series/Folio",
+                "Type",
+                "RFC Receptor",
+                "Total",
+                "Status",
+                "Created",
+            ]);
+            result.data.forEach((invoice) => {
+                table.push([
+                    invoice.id.substring(0, 8) + "...",
+                    invoice.uuid,
+                    `${invoice.serie}-${invoice.folio}`,
+                    invoice.tipoComprobante,
+                    invoice.rfcReceptor,
+                    `$${invoice.total.toFixed(2)} ${invoice.moneda}`,
+                    invoice.status === "vigente"
+                        ? chalk.green(invoice.status)
+                        : chalk.red(invoice.status),
+                    new Date(invoice.createdAt).toLocaleDateString(),
+                ]);
+            });
+            this.log(table.toString());
+            this.log(chalk.gray(`\nPage ${result.page} of ${result.totalPages} — ${result.total} invoice(s) total`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red("Failed to fetch invoices"));
+            this.error(getErrorMessage(error));
+        }
+    }
+}

package/dist/commands/products/import.d.ts

@@ -0,0 +1,11 @@
+import { Command } from "@oclif/core";
+export default class ProductsImport extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        org: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        file: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=import.d.ts.map

package/dist/commands/products/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../../src/commands/products/import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAS5C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,OAAgB,WAAW,SAAkD;IAE7E,OAAgB,QAAQ,WAEvB;IAED,OAAgB,KAAK;;;MAWpB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiDlC"}

package/dist/commands/products/import.js

@@ -0,0 +1,62 @@
+import { Command, Flags } from "@oclif/core";
+import { existsSync, readFileSync } from "node:fs";
+import { basename } from "node:path";
+import chalk from "chalk";
+import ora from "ora";
+import { createClient } from "../../utils/client.js";
+import { getErrorMessage } from "../../utils/error.js";
+import { createTable } from "../../utils/table.js";
+export default class ProductsImport extends Command {
+    static description = "Bulk import products/services from a CSV file";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id --file ./products.csv",
+    ];
+    static flags = {
+        org: Flags.string({
+            char: "o",
+            description: "Organization ID",
+            required: true,
+        }),
+        file: Flags.string({
+            char: "f",
+            description: "Path to the CSV file to import",
+            required: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ProductsImport);
+        const client = createClient();
+        if (!existsSync(flags.file)) {
+            this.error(chalk.red(`File not found: ${flags.file}`));
+        }
+        if (!flags.file.toLowerCase().endsWith(".csv")) {
+            this.error(chalk.red("File must be a .csv file"));
+        }
+        const spinner = ora("Importing products...").start();
+        try {
+            const buffer = readFileSync(flags.file);
+            const filename = basename(flags.file);
+            const blob = new Blob([buffer], { type: "text/csv" });
+            const result = await client.products.importCsv(flags.org, blob, filename);
+            spinner.succeed(chalk.green("✓ Import finished"));
+            this.log(chalk.gray("\nImport Summary:"));
+            this.log(`  ${chalk.bold("Total rows:")} ${result.totalRows}`);
+            this.log(`  ${chalk.bold("Created:")} ${chalk.green(result.successCount)}`);
+            this.log(`  ${chalk.bold("Errors:")} ${result.errorCount > 0
+                ? chalk.red(result.errorCount)
+                : result.errorCount}`);
+            if (result.errors.length > 0) {
+                this.log(chalk.yellow("\nRow errors:"));
+                const table = createTable(["Row", "Message"]);
+                result.errors.forEach((rowError) => {
+                    table.push([String(rowError.row), rowError.message]);
+                });
+                this.log(table.toString());
+            }
+        }
+        catch (error) {
+            spinner.fail(chalk.red("Failed to import products"));
+            this.error(getErrorMessage(error));
+        }
+    }
+}

package/dist/commands/sat/claves-prod-serv.d.ts

@@ -0,0 +1,11 @@
+import { Command } from "@oclif/core";
+export default class SatClavesProdServ extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        query: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=claves-prod-serv.d.ts.map

package/dist/commands/sat/claves-prod-serv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claves-prod-serv.d.ts","sourceRoot":"","sources":["../../../src/commands/sat/claves-prod-serv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAQ5C,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,OAAO;IACpD,OAAgB,WAAW,SACmC;IAE9D,OAAgB,QAAQ,WAGvB;IAED,OAAgB,KAAK;;;MAUpB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6ClC"}

package/dist/commands/sat/claves-prod-serv.js

@@ -0,0 +1,60 @@
+import { Command, Flags } from "@oclif/core";
+import chalk from "chalk";
+import ora from "ora";
+import { createClient } from "../../utils/client.js";
+import { getErrorMessage } from "../../utils/error.js";
+import { createTable, truncate } from "../../utils/table.js";
+export default class SatClavesProdServ extends Command {
+    static description = "Search SAT claves de producto o servicio (c_ClaveProdServ)";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> --query ukelele",
+        '<%= config.bin %> <%= command.id %> -q "servicios de consultoria" --limit 10',
+    ];
+    static flags = {
+        query: Flags.string({
+            char: "q",
+            description: "Search text (partial match on código or descripción)",
+            required: true,
+        }),
+        limit: Flags.integer({
+            char: "l",
+            description: "Maximum number of results to return (1-50)",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SatClavesProdServ);
+        const client = createClient();
+        const spinner = ora("Searching claves de producto o servicio...").start();
+        try {
+            const result = await client.sat.searchClavesProdServ({
+                q: flags.query,
+                limit: flags.limit,
+            });
+            spinner.stop();
+            if (result.data.length === 0) {
+                this.log(chalk.yellow("No results found"));
+                return;
+            }
+            const table = createTable([
+                "Código",
+                "Descripción",
+                "IVA Trasladado",
+                "IEPS Trasladado",
+            ]);
+            result.data.forEach((clave) => {
+                table.push([
+                    clave.codigo,
+                    truncate(clave.descripcion, 60),
+                    clave.incluyeIvaTrasladado ? "Sí" : "No",
+                    clave.incluyeIepsTrasladado ? "Sí" : "No",
+                ]);
+            });
+            this.log(table.toString());
+            this.log(chalk.gray(`\nShowing ${result.data.length} of ${result.total} matching clave(s)`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red("Failed to search claves de producto o servicio"));
+            this.error(getErrorMessage(error));
+        }
+    }
+}

package/dist/commands/sat/claves-unidad.d.ts

@@ -0,0 +1,11 @@
+import { Command } from "@oclif/core";
+export default class SatClavesUnidad extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        query: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=claves-unidad.d.ts.map

package/dist/commands/sat/claves-unidad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claves-unidad.d.ts","sourceRoot":"","sources":["../../../src/commands/sat/claves-unidad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAQ5C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,OAAgB,WAAW,SAC8B;IAEzD,OAAgB,QAAQ,WAGvB;IAED,OAAgB,KAAK;;;MAWpB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAwClC"}

package/dist/commands/sat/claves-unidad.js

@@ -0,0 +1,55 @@
+import { Command, Flags } from "@oclif/core";
+import chalk from "chalk";
+import ora from "ora";
+import { createClient } from "../../utils/client.js";
+import { getErrorMessage } from "../../utils/error.js";
+import { createTable, truncate } from "../../utils/table.js";
+export default class SatClavesUnidad extends Command {
+    static description = "Search SAT claves de unidad de medida (c_ClaveUnidad)";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> --query pieza",
+        "<%= config.bin %> <%= command.id %> -q kilogramo --limit 10",
+    ];
+    static flags = {
+        query: Flags.string({
+            char: "q",
+            description: "Search text (partial match on código, nombre or descripción)",
+            required: true,
+        }),
+        limit: Flags.integer({
+            char: "l",
+            description: "Maximum number of results to return (1-100)",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SatClavesUnidad);
+        const client = createClient();
+        const spinner = ora("Searching claves de unidad de medida...").start();
+        try {
+            const result = await client.sat.searchClavesUnidad({
+                q: flags.query,
+                limit: flags.limit,
+            });
+            spinner.stop();
+            if (result.data.length === 0) {
+                this.log(chalk.yellow("No results found"));
+                return;
+            }
+            const table = createTable(["Código", "Nombre", "Descripción", "Símbolo"]);
+            result.data.forEach((clave) => {
+                table.push([
+                    clave.codigo,
+                    truncate(clave.nombre, 30),
+                    truncate(clave.descripcion, 40),
+                    clave.simbolo ?? "-",
+                ]);
+            });
+            this.log(table.toString());
+            this.log(chalk.gray(`\nShowing ${result.data.length} of ${result.total} matching clave(s)`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red("Failed to search claves de unidad de medida"));
+            this.error(getErrorMessage(error));
+        }
+    }
+}

package/dist/utils/client.d.ts

@@ -3,4 +3,11 @@ import { Timbrix } from "@timbrix/sdk";
  * Create an authenticated Timbrix client
  */
 export declare function createClient(): Timbrix;
+/**
+ * Create a Timbrix client authenticated with an API key rather than the
+ * logged-in session. Used by commands whose API endpoint resolves the
+ * organization from the API key (e.g. `invoices create`), which is a
+ * different auth model than the rest of the CLI's `timbrix login` session.
+ */
+export declare function createApiKeyClient(apiKey: string): Timbrix;
 //# sourceMappingURL=client.d.ts.map

package/dist/utils/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/utils/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAItC;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAetC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/utils/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAItC;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAetC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAK1D"}

package/dist/utils/client.js

@@ -16,3 +16,15 @@ export function createClient() {
         baseUrl,
     });
 }
+/**
+ * Create a Timbrix client authenticated with an API key rather than the
+ * logged-in session. Used by commands whose API endpoint resolves the
+ * organization from the API key (e.g. `invoices create`), which is a
+ * different auth model than the rest of the CLI's `timbrix login` session.
+ */
+export function createApiKeyClient(apiKey) {
+    return new Timbrix({
+        apiKey,
+        baseUrl: AuthManager.getBaseUrl(),
+    });
+}

package/oclif.manifest.json

@@ -489,6 +489,117 @@
         "list.js"
       ]
     },
+    "invoices:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create and stamp (timbrar) a CFDI 4.0 invoice via the configured PAC. This command authenticates with --api-key instead of the `timbrix login` session — the key must belong to the organization passed via --org.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --org org-id --api-key sk_live_... --file invoice.json",
+        "<%= config.bin %> <%= command.id %> --org org-id --api-key sk_live_... --file invoice.json --output invoice.xml"
+      ],
+      "flags": {
+        "org": {
+          "char": "o",
+          "description": "Organization ID (must match the API key's organization)",
+          "name": "org",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "Timbrix API key (needs the write:invoices scope)",
+          "env": "TIMBRIX_API_KEY",
+          "name": "api-key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "char": "f",
+          "description": "Path to a JSON file with the invoice payload (series, folioNumber, date, paymentForm, use, customer|customerId, items)",
+          "name": "file",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "description": "Path to save the timbrado CFDI XML (optional)",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "invoices:create",
+      "pluginAlias": "@timbrix/cli",
+      "pluginName": "@timbrix/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "invoices",
+        "create.js"
+      ]
+    },
+    "invoices:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List invoices (CFDI 4.0) for an organization, newest first",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id",
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id --page 2 --limit 50"
+      ],
+      "flags": {
+        "org": {
+          "char": "o",
+          "description": "Organization ID",
+          "name": "org",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page": {
+          "char": "p",
+          "description": "Page number (1-indexed)",
+          "name": "page",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Results per page (1-100)",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "invoices:list",
+      "pluginAlias": "@timbrix/cli",
+      "pluginName": "@timbrix/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "invoices",
+        "list.js"
+      ]
+    },
     "oauth-apps:create": {
       "aliases": [],
       "args": {},
@@ -956,6 +1067,49 @@
         "get.js"
       ]
     },
+    "products:import": {
+      "aliases": [],
+      "args": {},
+      "description": "Bulk import products/services from a CSV file",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id --file ./products.csv"
+      ],
+      "flags": {
+        "org": {
+          "char": "o",
+          "description": "Organization ID",
+          "name": "org",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "char": "f",
+          "description": "Path to the CSV file to import",
+          "name": "file",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "products:import",
+      "pluginAlias": "@timbrix/cli",
+      "pluginName": "@timbrix/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "products",
+        "import.js"
+      ]
+    },
     "products:list": {
       "aliases": [],
       "args": {},
@@ -1111,6 +1265,92 @@
         "update.js"
       ]
     },
+    "sat:claves-prod-serv": {
+      "aliases": [],
+      "args": {},
+      "description": "Search SAT claves de producto o servicio (c_ClaveProdServ)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --query ukelele",
+        "<%= config.bin %> <%= command.id %> -q \"servicios de consultoria\" --limit 10"
+      ],
+      "flags": {
+        "query": {
+          "char": "q",
+          "description": "Search text (partial match on código or descripción)",
+          "name": "query",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of results to return (1-50)",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sat:claves-prod-serv",
+      "pluginAlias": "@timbrix/cli",
+      "pluginName": "@timbrix/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sat",
+        "claves-prod-serv.js"
+      ]
+    },
+    "sat:claves-unidad": {
+      "aliases": [],
+      "args": {},
+      "description": "Search SAT claves de unidad de medida (c_ClaveUnidad)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --query pieza",
+        "<%= config.bin %> <%= command.id %> -q kilogramo --limit 10"
+      ],
+      "flags": {
+        "query": {
+          "char": "q",
+          "description": "Search text (partial match on código, nombre or descripción)",
+          "name": "query",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of results to return (1-100)",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sat:claves-unidad",
+      "pluginAlias": "@timbrix/cli",
+      "pluginName": "@timbrix/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sat",
+        "claves-unidad.js"
+      ]
+    },
     "webhooks:create": {
       "aliases": [],
       "args": {},
@@ -1368,5 +1608,5 @@
       ]
     }
   },
-  "version": "0.3.1"
+  "version": "1.1.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timbrix/cli",
-  "version": "0.3.1",
+  "version": "1.1.0",
   "description": "CLI tool for Timbrix API",
   "author": "Ivan Sotelo",
   "bin": {
@@ -36,7 +36,7 @@
     "ky": "^2.0.2",
     "ora": "^9.4.1",
     "update-notifier": "^7.3.1",
-    "@timbrix/sdk": "0.3.1"
+    "@timbrix/sdk": "1.1.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",