@timbrix/cli 0.1.0 → 0.3.1

package/README.md

@@ -1,10 +1,10 @@
 # @timbrix/cli
 
 ```
-  _____ _           _          _      
+  _____ _           _          _
  |_   _(_)_ __ ___ | |__  _ __(_)_  __
    | | | | '_ ` _ \| '_ \| '__| \ \/ /
-   | | | | | | | | | |_) | |  | |>  < 
+   | | | | | | | | | |_) | |  | |>  <
    |_| |_|_| |_| |_|_.__/|_|  |_/_/\_\
 ```
 
@@ -171,7 +171,7 @@ Configuration is stored in `~/.timbrix/config.json`:
 {
   "bearerToken": "eyJhbGc...",
   "email": "user@example.com",
-  "baseUrl": "http://localhost:3001/api"
+  "baseUrl": "http://localhost:3001"
 }
 ```
 

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

@@ -0,0 +1,25 @@
+import { Command } from "@oclif/core";
+export default class CustomersCreate extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        org: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "legal-name": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "tax-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "tax-system": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        email: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        phone: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "default-invoice-use": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "address-street": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "address-exterior": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "address-interior": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "address-neighborhood": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "address-city": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "address-municipality": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "address-zip": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "address-state": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "address-country": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/customers/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAO5C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,OAAgB,WAAW,SAA0B;IAErD,OAAgB,QAAQ,WAGvB;IAED,OAAgB,KAAK;;;;;;;;;;;;;;;;;MAsDpB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+JlC"}

package/dist/commands/customers/create.js

@@ -0,0 +1,188 @@
+import { Command, Flags } from "@oclif/core";
+import { input } from "@inquirer/prompts";
+import { createClient } from "../../utils/client.js";
+import { getErrorMessage } from "../../utils/error.js";
+import chalk from "chalk";
+import ora from "ora";
+export default class CustomersCreate extends Command {
+    static description = "Create a new customer";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id",
+        '<%= config.bin %> <%= command.id %> --org acme-corp-id --legal-name "ACME SA DE CV" --tax-id XAXX010101000',
+    ];
+    static flags = {
+        org: Flags.string({
+            char: "o",
+            description: "Organization ID",
+            required: true,
+        }),
+        "legal-name": Flags.string({
+            char: "n",
+            description: "Legal name (razón social)",
+        }),
+        "tax-id": Flags.string({
+            char: "t",
+            description: "RFC (12 or 13 characters)",
+        }),
+        "tax-system": Flags.string({
+            description: "SAT tax system code (e.g. 601)",
+        }),
+        email: Flags.string({
+            char: "e",
+            description: "Email address",
+        }),
+        phone: Flags.string({
+            description: "Phone number (optional)",
+        }),
+        "default-invoice-use": Flags.string({
+            description: "Default CFDI invoice use code (e.g. G03)",
+        }),
+        "address-street": Flags.string({
+            description: "Street name",
+        }),
+        "address-exterior": Flags.string({
+            description: "Exterior number",
+        }),
+        "address-interior": Flags.string({
+            description: "Interior number (optional)",
+        }),
+        "address-neighborhood": Flags.string({
+            description: "Neighborhood (colonia)",
+        }),
+        "address-city": Flags.string({
+            description: "City",
+        }),
+        "address-municipality": Flags.string({
+            description: "Municipality",
+        }),
+        "address-zip": Flags.string({
+            description: "ZIP code (5 digits)",
+        }),
+        "address-state": Flags.string({
+            description: "State",
+        }),
+        "address-country": Flags.string({
+            description: "Country code (default: MEX)",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CustomersCreate);
+        const client = createClient();
+        try {
+            const legalName = flags["legal-name"] ||
+                (await input({
+                    message: "Legal name (razón social):",
+                    validate: (v) => v.trim().length > 0 || "Legal name is required",
+                }));
+            const taxId = flags["tax-id"] ||
+                (await input({
+                    message: "RFC (12 or 13 characters, uppercase):",
+                    validate: (v) => {
+                        const trimmed = v.trim();
+                        if (trimmed.length < 12 || trimmed.length > 13) {
+                            return "RFC must be 12 or 13 characters";
+                        }
+                        if (trimmed !== trimmed.toUpperCase()) {
+                            return "RFC must be uppercase";
+                        }
+                        return true;
+                    },
+                }));
+            const taxSystem = flags["tax-system"] ||
+                (await input({
+                    message: "SAT tax system code (e.g. 601):",
+                    validate: (v) => v.trim().length > 0 || "Tax system is required",
+                }));
+            const email = flags.email ||
+                (await input({
+                    message: "Email:",
+                    validate: (v) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(v) || "Invalid email format",
+                }));
+            const phone = flags.phone ||
+                (await input({
+                    message: "Phone (leave empty to skip):",
+                })) ||
+                undefined;
+            const defaultInvoiceUse = flags["default-invoice-use"] ||
+                (await input({
+                    message: "Default CFDI invoice use (e.g. G03):",
+                    validate: (v) => v.trim().length > 0 || "Default invoice use is required",
+                }));
+            const addressStreet = flags["address-street"] ||
+                (await input({
+                    message: "Street:",
+                    validate: (v) => v.trim().length > 0 || "Street is required",
+                }));
+            const addressExterior = flags["address-exterior"] ||
+                (await input({
+                    message: "Exterior number:",
+                    validate: (v) => v.trim().length > 0 || "Exterior number is required",
+                }));
+            const addressInterior = flags["address-interior"] ||
+                (await input({
+                    message: "Interior number (leave empty to skip):",
+                })) ||
+                undefined;
+            const addressNeighborhood = flags["address-neighborhood"] ||
+                (await input({
+                    message: "Neighborhood (colonia):",
+                    validate: (v) => v.trim().length > 0 || "Neighborhood is required",
+                }));
+            const addressCity = flags["address-city"] ||
+                (await input({
+                    message: "City:",
+                    validate: (v) => v.trim().length > 0 || "City is required",
+                }));
+            const addressMunicipality = flags["address-municipality"] ||
+                (await input({
+                    message: "Municipality:",
+                    validate: (v) => v.trim().length > 0 || "Municipality is required",
+                }));
+            const addressZip = flags["address-zip"] ||
+                (await input({
+                    message: "ZIP code (5 digits):",
+                    validate: (v) => /^\d{5}$/.test(v) || "ZIP must be exactly 5 digits",
+                }));
+            const addressState = flags["address-state"] ||
+                (await input({
+                    message: "State:",
+                    validate: (v) => v.trim().length > 0 || "State is required",
+                }));
+            const addressCountry = flags["address-country"] ||
+                (await input({
+                    message: "Country code:",
+                    default: "MEX",
+                }));
+            const spinner = ora("Creating customer...").start();
+            const customer = await client.customers.create(flags.org, {
+                legalName,
+                taxId,
+                taxSystem,
+                email,
+                phone: phone || undefined,
+                defaultInvoiceUse,
+                addressStreet,
+                addressExterior,
+                addressInterior: addressInterior || undefined,
+                addressNeighborhood,
+                addressCity,
+                addressMunicipality,
+                addressZip,
+                addressState,
+                addressCountry,
+            });
+            spinner.succeed(chalk.green("✓ Customer created successfully!"));
+            this.log(chalk.gray("\nCustomer Details:"));
+            this.log(`  ${chalk.bold("ID:")} ${customer.id}`);
+            this.log(`  ${chalk.bold("Legal Name:")} ${customer.legalName}`);
+            this.log(`  ${chalk.bold("RFC:")} ${customer.taxId}`);
+            this.log(`  ${chalk.bold("Email:")} ${customer.email}`);
+            const addr = customer.address;
+            const interiorPart = addr.interior ? ` Int. ${addr.interior}` : "";
+            this.log(`  ${chalk.bold("Address:")} ${addr.street} ${addr.exterior}${interiorPart}, ${addr.neighborhood}, ${addr.city}, ${addr.state}, ${addr.zip}, ${addr.country}`);
+        }
+        catch (error) {
+            this.error(chalk.red(`Failed to create customer: ${getErrorMessage(error)}`));
+        }
+    }
+}

package/dist/commands/customers/delete.d.ts

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

package/dist/commands/customers/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/customers/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAO5C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,OAAgB,WAAW,SAAsB;IAEjD,OAAgB,QAAQ,WAGvB;IAED,OAAgB,KAAK;;;;MAepB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA0BlC"}

package/dist/commands/customers/delete.js

@@ -0,0 +1,52 @@
+import { Command, Flags } from "@oclif/core";
+import { confirm } from "@inquirer/prompts";
+import chalk from "chalk";
+import ora from "ora";
+import { createClient } from "../../utils/client.js";
+import { getErrorMessage } from "../../utils/error.js";
+export default class CustomersDelete extends Command {
+    static description = "Delete a customer";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id --id customer-uuid",
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id --id customer-uuid --force",
+    ];
+    static flags = {
+        org: Flags.string({
+            char: "o",
+            description: "Organization ID",
+            required: true,
+        }),
+        id: Flags.string({
+            description: "Customer ID",
+            required: true,
+        }),
+        force: Flags.boolean({
+            char: "f",
+            description: "Skip confirmation prompt",
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CustomersDelete);
+        const client = createClient();
+        if (!flags.force) {
+            const ok = await confirm({
+                message: `Delete customer ${flags.id}? This action cannot be undone.`,
+                default: false,
+            });
+            if (!ok) {
+                this.log(chalk.gray("Deletion cancelled"));
+                return;
+            }
+        }
+        const spinner = ora("Deleting customer...").start();
+        try {
+            await client.customers.delete(flags.org, flags.id);
+            spinner.succeed(chalk.green("✓ Customer deleted successfully!"));
+        }
+        catch (error) {
+            spinner.fail(chalk.red("Failed to delete customer"));
+            this.error(getErrorMessage(error));
+        }
+    }
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/customers/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAQ5C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,OAAO;IAChD,OAAgB,WAAW,SAA2C;IAEtE,OAAgB,QAAQ,WAEvB;IAED,OAAgB,KAAK;;MAMpB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAuClC"}

package/dist/commands/customers/list.js

@@ -0,0 +1,49 @@
+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 CustomersList extends Command {
+    static description = "List all customers for an organization";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id",
+    ];
+    static flags = {
+        org: Flags.string({
+            char: "o",
+            description: "Organization ID",
+            required: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CustomersList);
+        const client = createClient();
+        const spinner = ora("Fetching customers...").start();
+        try {
+            const customers = await client.customers.list(flags.org);
+            spinner.stop();
+            if (customers.length === 0) {
+                this.log(chalk.yellow("No customers found"));
+                this.log(chalk.gray(`\nCreate a customer with: timbrix customers create --org ${flags.org}`));
+                return;
+            }
+            const table = createTable(["ID", "Legal Name", "RFC", "Email", "Created"]);
+            customers.forEach((customer) => {
+                table.push([
+                    customer.id.substring(0, 8) + "...",
+                    truncate(customer.legalName, 30),
+                    customer.taxId,
+                    customer.email,
+                    new Date(customer.createdAt).toLocaleDateString(),
+                ]);
+            });
+            this.log(table.toString());
+            this.log(chalk.gray(`\nTotal: ${customers.length} customer(s)`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red("Failed to fetch customers"));
+            this.error(getErrorMessage(error));
+        }
+    }
+}

package/dist/commands/login.js

@@ -20,7 +20,7 @@ export default class Login extends Command {
         "base-url": Flags.string({
             char: "u",
             description: "API base URL",
-            default: "http://localhost:3001/api",
+            default: "http://localhost:3001",
         }),
     };
     async run() {

package/dist/commands/sat/regimenes/list.d.ts

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

package/dist/commands/sat/regimenes/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/commands/sat/regimenes/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAQ5C,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,OAAO;IACnD,OAAgB,WAAW,SAAgC;IAE3D,OAAgB,QAAQ,WAIvB;IAED,OAAgB,KAAK;;MAMpB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAmClC"}

package/dist/commands/sat/regimenes/list.js

@@ -0,0 +1,50 @@
+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 SatRegimenesList extends Command {
+    static description = "List SAT régimenes fiscales";
+    static examples = [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --tipo-persona fisica",
+        "<%= config.bin %> <%= command.id %> --tipo-persona moral",
+    ];
+    static flags = {
+        "tipo-persona": Flags.string({
+            char: "t",
+            description: "Filter by persona type",
+            options: ["fisica", "moral", "ambas"],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SatRegimenesList);
+        const client = createClient();
+        const spinner = ora("Fetching régimenes fiscales...").start();
+        try {
+            const regimenes = await client.sat.regimenes({
+                tipoPersona: flags["tipo-persona"],
+            });
+            spinner.stop();
+            if (regimenes.length === 0) {
+                this.log(chalk.yellow("No results found"));
+                return;
+            }
+            const table = createTable(["Código", "Descripción", "Tipo Persona"]);
+            regimenes.forEach((regimen) => {
+                table.push([
+                    regimen.codigo,
+                    truncate(regimen.descripcion, 50),
+                    regimen.tipoPersona,
+                ]);
+            });
+            this.log(table.toString());
+            this.log(chalk.gray(`\nTotal: ${regimenes.length} régimen(es)`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red("Failed to fetch régimenes fiscales"));
+            this.error(getErrorMessage(error));
+        }
+    }
+}

package/dist/commands/sat/usos-cfdi/list.d.ts

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

package/dist/commands/sat/usos-cfdi/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/commands/sat/usos-cfdi/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAQ5C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,OAAgB,WAAW,SAA0B;IAErD,OAAgB,QAAQ,WAKvB;IAED,OAAgB,KAAK;;;MAUpB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgClC"}

package/dist/commands/sat/usos-cfdi/list.js

@@ -0,0 +1,52 @@
+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 SatUsosCfdiList extends Command {
+    static description = "List SAT usos de CFDI";
+    static examples = [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --tipo-persona fisica",
+        "<%= config.bin %> <%= command.id %> --regimen 601",
+        "<%= config.bin %> <%= command.id %> --regimen 601 --tipo-persona moral",
+    ];
+    static flags = {
+        "tipo-persona": Flags.string({
+            char: "t",
+            description: "Filter by persona type",
+            options: ["fisica", "moral", "ambas"],
+        }),
+        regimen: Flags.string({
+            char: "r",
+            description: "Filter by régimen fiscal code (e.g. 601)",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SatUsosCfdiList);
+        const client = createClient();
+        const spinner = ora("Fetching usos CFDI...").start();
+        try {
+            const usosCfdi = await client.sat.usosCfdi({
+                tipoPersona: flags["tipo-persona"],
+                regimen: flags.regimen,
+            });
+            spinner.stop();
+            if (usosCfdi.length === 0) {
+                this.log(chalk.yellow("No usos CFDI found for the given filters"));
+                return;
+            }
+            const table = createTable(["Código", "Descripción", "Tipo Persona"]);
+            usosCfdi.forEach((uso) => {
+                table.push([uso.codigo, truncate(uso.descripcion, 50), uso.tipoPersona]);
+            });
+            this.log(table.toString());
+            this.log(chalk.gray(`\nTotal: ${usosCfdi.length} uso(s) CFDI`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red("Failed to fetch usos CFDI"));
+            this.error(getErrorMessage(error));
+        }
+    }
+}

package/dist/config/auth.js

@@ -33,7 +33,7 @@ export class AuthManager {
      * Get base URL
      */
     static getBaseUrl() {
-        return config.get("baseUrl") || "http://localhost:3001/api";
+        return config.get("baseUrl") || "http://localhost:3001";
     }
     /**
      * Check if user is authenticated

package/oclif.manifest.json

@@ -21,7 +21,7 @@
           "char": "u",
           "description": "API base URL",
           "name": "base-url",
-          "default": "http://localhost:3001/api",
+          "default": "http://localhost:3001",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -262,6 +262,233 @@
         "list.js"
       ]
     },
+    "customers:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a new customer",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id",
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id --legal-name \"ACME SA DE CV\" --tax-id XAXX010101000"
+      ],
+      "flags": {
+        "org": {
+          "char": "o",
+          "description": "Organization ID",
+          "name": "org",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "legal-name": {
+          "char": "n",
+          "description": "Legal name (razón social)",
+          "name": "legal-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tax-id": {
+          "char": "t",
+          "description": "RFC (12 or 13 characters)",
+          "name": "tax-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tax-system": {
+          "description": "SAT tax system code (e.g. 601)",
+          "name": "tax-system",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "email": {
+          "char": "e",
+          "description": "Email address",
+          "name": "email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "phone": {
+          "description": "Phone number (optional)",
+          "name": "phone",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "default-invoice-use": {
+          "description": "Default CFDI invoice use code (e.g. G03)",
+          "name": "default-invoice-use",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "address-street": {
+          "description": "Street name",
+          "name": "address-street",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "address-exterior": {
+          "description": "Exterior number",
+          "name": "address-exterior",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "address-interior": {
+          "description": "Interior number (optional)",
+          "name": "address-interior",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "address-neighborhood": {
+          "description": "Neighborhood (colonia)",
+          "name": "address-neighborhood",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "address-city": {
+          "description": "City",
+          "name": "address-city",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "address-municipality": {
+          "description": "Municipality",
+          "name": "address-municipality",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "address-zip": {
+          "description": "ZIP code (5 digits)",
+          "name": "address-zip",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "address-state": {
+          "description": "State",
+          "name": "address-state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "address-country": {
+          "description": "Country code (default: MEX)",
+          "name": "address-country",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "customers:create",
+      "pluginAlias": "@timbrix/cli",
+      "pluginName": "@timbrix/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "customers",
+        "create.js"
+      ]
+    },
+    "customers:delete": {
+      "aliases": [],
+      "args": {},
+      "description": "Delete a customer",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id --id customer-uuid",
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id --id customer-uuid --force"
+      ],
+      "flags": {
+        "org": {
+          "char": "o",
+          "description": "Organization ID",
+          "name": "org",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "id": {
+          "description": "Customer ID",
+          "name": "id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "char": "f",
+          "description": "Skip confirmation prompt",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "customers:delete",
+      "pluginAlias": "@timbrix/cli",
+      "pluginName": "@timbrix/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "customers",
+        "delete.js"
+      ]
+    },
+    "customers:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all customers for an organization",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --org acme-corp-id"
+      ],
+      "flags": {
+        "org": {
+          "char": "o",
+          "description": "Organization ID",
+          "name": "org",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "customers:list",
+      "pluginAlias": "@timbrix/cli",
+      "pluginName": "@timbrix/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "customers",
+        "list.js"
+      ]
+    },
     "oauth-apps:create": {
       "aliases": [],
       "args": {},
@@ -1048,7 +1275,98 @@
         "webhooks",
         "list.js"
       ]
+    },
+    "sat:regimenes:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List SAT régimenes fiscales",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --tipo-persona fisica",
+        "<%= config.bin %> <%= command.id %> --tipo-persona moral"
+      ],
+      "flags": {
+        "tipo-persona": {
+          "char": "t",
+          "description": "Filter by persona type",
+          "name": "tipo-persona",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "fisica",
+            "moral",
+            "ambas"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sat:regimenes:list",
+      "pluginAlias": "@timbrix/cli",
+      "pluginName": "@timbrix/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sat",
+        "regimenes",
+        "list.js"
+      ]
+    },
+    "sat:usos-cfdi:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List SAT usos de CFDI",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --tipo-persona fisica",
+        "<%= config.bin %> <%= command.id %> --regimen 601",
+        "<%= config.bin %> <%= command.id %> --regimen 601 --tipo-persona moral"
+      ],
+      "flags": {
+        "tipo-persona": {
+          "char": "t",
+          "description": "Filter by persona type",
+          "name": "tipo-persona",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "fisica",
+            "moral",
+            "ambas"
+          ],
+          "type": "option"
+        },
+        "regimen": {
+          "char": "r",
+          "description": "Filter by régimen fiscal code (e.g. 601)",
+          "name": "regimen",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sat:usos-cfdi:list",
+      "pluginAlias": "@timbrix/cli",
+      "pluginName": "@timbrix/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sat",
+        "usos-cfdi",
+        "list.js"
+      ]
     }
   },
-  "version": "0.1.0"
+  "version": "0.3.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timbrix/cli",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "CLI tool for Timbrix API",
   "author": "Ivan Sotelo",
   "bin": {
@@ -21,27 +21,32 @@
     "oclif"
   ],
   "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "dependencies": {
-    "@inquirer/prompts": "^8.3.2",
-    "@oclif/core": "^4.10.3",
-    "@oclif/plugin-help": "^6.2.41",
-    "@oclif/plugin-plugins": "^5.4.59",
-    "chalk": "^5.6.2",
+    "@inquirer/prompts": "^8.5.2",
+    "@oclif/core": "^4.13.2",
+    "@oclif/plugin-help": "^6.2.55",
+    "@oclif/plugin-plugins": "^5.4.86",
+    "chalk": "^6.0.0",
     "cli-table3": "^0.6.5",
     "conf": "^15.1.0",
-    "ky": "^1.14.3",
-    "ora": "^9.3.0",
+    "ky": "^2.0.2",
+    "ora": "^9.4.1",
     "update-notifier": "^7.3.1",
-    "@timbrix/sdk": "0.1.0"
+    "@timbrix/sdk": "0.3.1"
   },
   "devDependencies": {
-    "@types/node": "^25.5.0",
+    "@types/node": "^26.1.2",
     "@types/update-notifier": "^6.0.8",
-    "oclif": "^4.22.96",
+    "eslint": "^10.8.0",
+    "oclif": "^4.23.29",
     "shx": "^0.4.0",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "@repo/eslint-config": "0.1.0",
+    "tsx": "^4.23.1",
+    "typescript": "^6.0.3",
+    "@repo/eslint-config": "0.1.1",
     "@repo/typescript-config": "0.1.0"
   },
   "oclif": {
@@ -60,7 +65,7 @@
     "topicSeparator": " "
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=24.0.0"
   },
   "scripts": {
     "build": "shx rm -rf dist && tsc -b",