@timbrix/cli 0.3.0 → 1.0.0

package/README.md

@@ -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/invoices/create.d.ts

@@ -0,0 +1,12 @@
+import { Command } from "@oclif/core";
+export default class InvoicesCreate extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        "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,SAG6C;IAExE,OAAgB,QAAQ,WAGvB;IAED,OAAgB,KAAK;;;;MAepB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6ClC"}

package/dist/commands/invoices/create.js

@@ -0,0 +1,62 @@
+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. " +
+        "The issuing organization is resolved from the API key, so this command " +
+        "authenticates with --api-key instead of the `timbrix login` session.";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> --api-key sk_live_... --file invoice.json",
+        "<%= config.bin %> <%= command.id %> --api-key sk_live_... --file invoice.json --output invoice.xml",
+    ];
+    static flags = {
+        "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(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/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.map

@@ -1 +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;CAsClC"}
+{"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/usos-cfdi/list.d.ts.map

@@ -1 +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;CAmClC"}
+{"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/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/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

@@ -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"
@@ -489,6 +489,57 @@
         "list.js"
       ]
     },
+    "invoices:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create and stamp (timbrar) a CFDI 4.0 invoice via the configured PAC. The issuing organization is resolved from the API key, so this command authenticates with --api-key instead of the `timbrix login` session.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --api-key sk_live_... --file invoice.json",
+        "<%= config.bin %> <%= command.id %> --api-key sk_live_... --file invoice.json --output invoice.xml"
+      ],
+      "flags": {
+        "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"
+      ]
+    },
     "oauth-apps:create": {
       "aliases": [],
       "args": {},
@@ -1368,5 +1419,5 @@
       ]
     }
   },
-  "version": "0.3.0"
+  "version": "1.0.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timbrix/cli",
-  "version": "0.3.0",
+  "version": "1.0.0",
   "description": "CLI tool for Timbrix API",
   "author": "Ivan Sotelo",
   "bin": {
@@ -26,28 +26,28 @@
     "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.3.0"
+    "@timbrix/sdk": "1.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.5.0",
+    "@types/node": "^26.1.2",
     "@types/update-notifier": "^6.0.8",
-    "eslint": "^9.39.4",
-    "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/typescript-config": "0.1.0",
-    "@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": {
     "bin": "timbrix",