@timbrix/cli 1.2.0 → 1.3.0

package/README.md

@@ -123,6 +123,13 @@ timbrix invoices create --org <organization-id> --api-key <api-key> --file invoi
 # List invoices for an organization (newest first)
 timbrix invoices list --org <organization-id>
 timbrix invoices list --org <organization-id> --page 2 --limit 50
+
+# Get a single invoice by its folio fiscal (UUID)
+timbrix invoices get <invoice-uuid>
+
+# Download the timbrado XML or PDF for an invoice
+timbrix invoices download <invoice-uuid> --format xml
+timbrix invoices download <invoice-uuid> --format pdf --output invoice.pdf
 ```
 
 ### SAT Catalogs

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

@@ -0,0 +1,14 @@
+import { Command } from "@oclif/core";
+export default class InvoicesDownload extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        uuid: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        format: 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=download.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../src/commands/invoices/download.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAe,MAAM,aAAa,CAAA;AAMlD,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,OAAO;IACnD,OAAgB,WAAW,SAC8C;IAEzE,OAAgB,QAAQ,WAGvB;IAED,OAAgB,IAAI;;MAKnB;IAED,OAAgB,KAAK;;;MAYpB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+BlC"}

package/dist/commands/invoices/download.js

@@ -0,0 +1,50 @@
+import { writeFileSync } from "node:fs";
+import { Command, Args, Flags } from "@oclif/core";
+import chalk from "chalk";
+import ora from "ora";
+import { createClient } from "../../utils/client.js";
+import { getErrorMessage } from "../../utils/error.js";
+export default class InvoicesDownload extends Command {
+    static description = "Download the timbrado XML or PDF representation of a CFDI 4.0 invoice";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> d3bfbc57-44af-4390-a064-f0afab85e5df --format xml",
+        "<%= config.bin %> <%= command.id %> d3bfbc57-44af-4390-a064-f0afab85e5df --format pdf --output invoice.pdf",
+    ];
+    static args = {
+        uuid: Args.string({
+            description: "Invoice UUID (folio fiscal)",
+            required: true,
+        }),
+    };
+    static flags = {
+        format: Flags.string({
+            char: "f",
+            description: "File format to download",
+            options: ["xml", "pdf"],
+            required: true,
+        }),
+        output: Flags.string({
+            char: "o",
+            description: "Path to save the downloaded file (defaults to <uuid>.<format> in the current directory)",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(InvoicesDownload);
+        const client = createClient();
+        const format = flags.format;
+        const outputPath = flags.output ?? `${args.uuid}.${format}`;
+        const spinner = ora(`Downloading invoice ${format.toUpperCase()}...`).start();
+        try {
+            const blob = format === "xml"
+                ? await client.invoices.getXml(args.uuid)
+                : await client.invoices.getPdf(args.uuid);
+            const buffer = Buffer.from(await blob.arrayBuffer());
+            writeFileSync(outputPath, buffer);
+            spinner.succeed(chalk.green(`✓ Invoice ${format.toUpperCase()} saved to: ${outputPath}`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red(`Failed to download invoice ${format.toUpperCase()}: ${getErrorMessage(error)}`));
+            this.exit(1);
+        }
+    }
+}

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

@@ -0,0 +1,10 @@
+import { Command } from "@oclif/core";
+export default class InvoicesGet extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        uuid: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=get.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/invoices/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,aAAa,CAAA;AAM3C,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC9C,OAAgB,WAAW,SACiC;IAE5D,OAAgB,QAAQ,WAEvB;IAED,OAAgB,IAAI;;MAKnB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgClC"}

package/dist/commands/invoices/get.js

@@ -0,0 +1,39 @@
+import { Command, Args } from "@oclif/core";
+import { createClient } from "../../utils/client.js";
+import { getErrorMessage } from "../../utils/error.js";
+import chalk from "chalk";
+import ora from "ora";
+export default class InvoicesGet extends Command {
+    static description = "Get a single CFDI 4.0 invoice by its folio fiscal (UUID)";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> d3bfbc57-44af-4390-a064-f0afab85e5df",
+    ];
+    static args = {
+        uuid: Args.string({
+            description: "Invoice UUID (folio fiscal)",
+            required: true,
+        }),
+    };
+    async run() {
+        const { args } = await this.parse(InvoicesGet);
+        const client = createClient();
+        const spinner = ora("Fetching invoice...").start();
+        try {
+            const invoice = await client.invoices.get(args.uuid);
+            spinner.stop();
+            this.log(chalk.cyan.bold("\nInvoice Details:"));
+            this.log(`  ${chalk.bold("ID:")} ${invoice.id}`);
+            this.log(`  ${chalk.bold("UUID:")} ${invoice.uuid}`);
+            this.log(`  ${chalk.bold("Status:")} ${invoice.status === "valid" ? chalk.green(invoice.status) : chalk.red(invoice.status)}`);
+            this.log(`  ${chalk.bold("Type:")} ${invoice.type}`);
+            this.log(`  ${chalk.bold("Series/Folio:")} ${invoice.series}-${invoice.folioNumber}`);
+            this.log(`  ${chalk.bold("Total:")} $${invoice.total.toFixed(2)}`);
+            this.log(`  ${chalk.bold("Date:")} ${new Date(invoice.date).toLocaleString()}`);
+            this.log(`  ${chalk.bold("Created:")} ${new Date(invoice.createdAt).toLocaleString()}`);
+        }
+        catch (error) {
+            spinner.fail(chalk.red("Failed to fetch invoice"));
+            this.error(getErrorMessage(error));
+        }
+    }
+}

package/oclif.manifest.json

@@ -549,6 +549,89 @@
         "create.js"
       ]
     },
+    "invoices:download": {
+      "aliases": [],
+      "args": {
+        "uuid": {
+          "description": "Invoice UUID (folio fiscal)",
+          "name": "uuid",
+          "required": true
+        }
+      },
+      "description": "Download the timbrado XML or PDF representation of a CFDI 4.0 invoice",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> d3bfbc57-44af-4390-a064-f0afab85e5df --format xml",
+        "<%= config.bin %> <%= command.id %> d3bfbc57-44af-4390-a064-f0afab85e5df --format pdf --output invoice.pdf"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "File format to download",
+          "name": "format",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "xml",
+            "pdf"
+          ],
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "Path to save the downloaded file (defaults to <uuid>.<format> in the current directory)",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "invoices:download",
+      "pluginAlias": "@timbrix/cli",
+      "pluginName": "@timbrix/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "invoices",
+        "download.js"
+      ]
+    },
+    "invoices:get": {
+      "aliases": [],
+      "args": {
+        "uuid": {
+          "description": "Invoice UUID (folio fiscal)",
+          "name": "uuid",
+          "required": true
+        }
+      },
+      "description": "Get a single CFDI 4.0 invoice by its folio fiscal (UUID)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> d3bfbc57-44af-4390-a064-f0afab85e5df"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "invoices:get",
+      "pluginAlias": "@timbrix/cli",
+      "pluginName": "@timbrix/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "invoices",
+        "get.js"
+      ]
+    },
     "invoices:list": {
       "aliases": [],
       "args": {},
@@ -1608,5 +1691,5 @@
       ]
     }
   },
-  "version": "1.2.0"
+  "version": "1.3.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timbrix/cli",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "CLI tool for Timbrix API",
   "author": "Ivan Sotelo",
   "bin": {
@@ -27,27 +27,27 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
-    "@oclif/core": "^4.13.2",
-    "@oclif/plugin-help": "^6.2.55",
-    "@oclif/plugin-plugins": "^5.4.86",
+    "@oclif/core": "^4.13.5",
+    "@oclif/plugin-help": "^6.2.58",
+    "@oclif/plugin-plugins": "^5.4.87",
     "chalk": "^6.0.0",
     "cli-table3": "^0.6.5",
     "conf": "^15.1.0",
     "ky": "^2.0.2",
     "ora": "^9.4.1",
     "update-notifier": "^7.3.1",
-    "@timbrix/sdk": "1.2.0"
+    "@timbrix/sdk": "1.3.0"
   },
   "devDependencies": {
-    "@types/node": "^26.1.2",
+    "@types/node": "^26.2.0",
     "@types/update-notifier": "^6.0.8",
-    "eslint": "^10.8.0",
-    "oclif": "^4.23.29",
+    "eslint": "^10.8.1",
+    "oclif": "^4.23.30",
     "shx": "^0.4.0",
-    "tsx": "^4.23.1",
+    "tsx": "^4.23.12",
     "typescript": "^6.0.3",
-    "@repo/eslint-config": "0.1.1",
-    "@repo/typescript-config": "0.1.0"
+    "@repo/typescript-config": "0.1.0",
+    "@repo/eslint-config": "0.1.1"
   },
   "oclif": {
     "bin": "timbrix",