@timbrix/sdk 1.2.0 → 1.4.0

package/dist/index.d.mts

@@ -638,12 +638,40 @@ declare class InvoicesResource {
      * belong to `organizationId`).
      */
     create(organizationId: string, data: CreateInvoiceInput): Promise<Invoice>;
+    /**
+     * Generate a PDF preview of a CFDI 4.0 invoice without stamping
+     * (timbrar) it via the PAC. Nothing is persisted and no stamping quota
+     * is consumed. Accepts the same body shape as `create`. Works with
+     * either a Supabase bearer session (internal dashboard, the user must
+     * be a member of `organizationId`) or an API key (external
+     * integrations, requires the `write:invoices` scope — the key must
+     * belong to `organizationId`).
+     */
+    previewPdf(organizationId: string, data: CreateInvoiceInput): Promise<Blob>;
     /**
      * List invoices for an organization, newest first. Works with either a
      * Supabase bearer session or an API key (requires the `read:invoices`
      * scope), same rules as `create`.
      */
     list(organizationId: string, params?: ListInvoicesParams): Promise<ListInvoicesResponse>;
+    /**
+     * Get a single CFDI 4.0 invoice by its folio fiscal (UUID). Works with
+     * either a Supabase bearer session or an API key (requires the
+     * `read:invoices` scope).
+     */
+    get(uuid: string): Promise<Invoice>;
+    /**
+     * Download the timbrado XML for an invoice. Works with either a
+     * Supabase bearer session or an API key (requires the `read:invoices`
+     * scope).
+     */
+    getXml(uuid: string): Promise<Blob>;
+    /**
+     * Download the PDF representation for an invoice. Works with either a
+     * Supabase bearer session or an API key (requires the `read:invoices`
+     * scope).
+     */
+    getPdf(uuid: string): Promise<Blob>;
 }
 
 declare class OAuthResource {

package/dist/index.d.ts

@@ -638,12 +638,40 @@ declare class InvoicesResource {
      * belong to `organizationId`).
      */
     create(organizationId: string, data: CreateInvoiceInput): Promise<Invoice>;
+    /**
+     * Generate a PDF preview of a CFDI 4.0 invoice without stamping
+     * (timbrar) it via the PAC. Nothing is persisted and no stamping quota
+     * is consumed. Accepts the same body shape as `create`. Works with
+     * either a Supabase bearer session (internal dashboard, the user must
+     * be a member of `organizationId`) or an API key (external
+     * integrations, requires the `write:invoices` scope — the key must
+     * belong to `organizationId`).
+     */
+    previewPdf(organizationId: string, data: CreateInvoiceInput): Promise<Blob>;
     /**
      * List invoices for an organization, newest first. Works with either a
      * Supabase bearer session or an API key (requires the `read:invoices`
      * scope), same rules as `create`.
      */
     list(organizationId: string, params?: ListInvoicesParams): Promise<ListInvoicesResponse>;
+    /**
+     * Get a single CFDI 4.0 invoice by its folio fiscal (UUID). Works with
+     * either a Supabase bearer session or an API key (requires the
+     * `read:invoices` scope).
+     */
+    get(uuid: string): Promise<Invoice>;
+    /**
+     * Download the timbrado XML for an invoice. Works with either a
+     * Supabase bearer session or an API key (requires the `read:invoices`
+     * scope).
+     */
+    getXml(uuid: string): Promise<Blob>;
+    /**
+     * Download the PDF representation for an invoice. Works with either a
+     * Supabase bearer session or an API key (requires the `read:invoices`
+     * scope).
+     */
+    getPdf(uuid: string): Promise<Blob>;
 }
 
 declare class OAuthResource {

package/dist/index.js

@@ -223,6 +223,20 @@ var InvoicesResource = class {
   async create(organizationId, data) {
     return this.http.post(`organizations/${organizationId}/invoices`, { json: data }).json();
   }
+  /**
+   * Generate a PDF preview of a CFDI 4.0 invoice without stamping
+   * (timbrar) it via the PAC. Nothing is persisted and no stamping quota
+   * is consumed. Accepts the same body shape as `create`. Works with
+   * either a Supabase bearer session (internal dashboard, the user must
+   * be a member of `organizationId`) or an API key (external
+   * integrations, requires the `write:invoices` scope — the key must
+   * belong to `organizationId`).
+   */
+  async previewPdf(organizationId, data) {
+    return this.http.post(`organizations/${organizationId}/invoices/preview/pdf`, {
+      json: data
+    }).blob();
+  }
   /**
    * List invoices for an organization, newest first. Works with either a
    * Supabase bearer session or an API key (requires the `read:invoices`
@@ -238,6 +252,30 @@ var InvoicesResource = class {
       searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
     }).json();
   }
+  /**
+   * Get a single CFDI 4.0 invoice by its folio fiscal (UUID). Works with
+   * either a Supabase bearer session or an API key (requires the
+   * `read:invoices` scope).
+   */
+  async get(uuid) {
+    return this.http.get(`invoices/${uuid}`).json();
+  }
+  /**
+   * Download the timbrado XML for an invoice. Works with either a
+   * Supabase bearer session or an API key (requires the `read:invoices`
+   * scope).
+   */
+  async getXml(uuid) {
+    return this.http.get(`invoices/${uuid}/xml`).blob();
+  }
+  /**
+   * Download the PDF representation for an invoice. Works with either a
+   * Supabase bearer session or an API key (requires the `read:invoices`
+   * scope).
+   */
+  async getPdf(uuid) {
+    return this.http.get(`invoices/${uuid}/pdf`).blob();
+  }
 };
 
 // src/resources/oauth.ts

package/dist/index.mjs

@@ -175,6 +175,20 @@ var InvoicesResource = class {
   async create(organizationId, data) {
     return this.http.post(`organizations/${organizationId}/invoices`, { json: data }).json();
   }
+  /**
+   * Generate a PDF preview of a CFDI 4.0 invoice without stamping
+   * (timbrar) it via the PAC. Nothing is persisted and no stamping quota
+   * is consumed. Accepts the same body shape as `create`. Works with
+   * either a Supabase bearer session (internal dashboard, the user must
+   * be a member of `organizationId`) or an API key (external
+   * integrations, requires the `write:invoices` scope — the key must
+   * belong to `organizationId`).
+   */
+  async previewPdf(organizationId, data) {
+    return this.http.post(`organizations/${organizationId}/invoices/preview/pdf`, {
+      json: data
+    }).blob();
+  }
   /**
    * List invoices for an organization, newest first. Works with either a
    * Supabase bearer session or an API key (requires the `read:invoices`
@@ -190,6 +204,30 @@ var InvoicesResource = class {
       searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
     }).json();
   }
+  /**
+   * Get a single CFDI 4.0 invoice by its folio fiscal (UUID). Works with
+   * either a Supabase bearer session or an API key (requires the
+   * `read:invoices` scope).
+   */
+  async get(uuid) {
+    return this.http.get(`invoices/${uuid}`).json();
+  }
+  /**
+   * Download the timbrado XML for an invoice. Works with either a
+   * Supabase bearer session or an API key (requires the `read:invoices`
+   * scope).
+   */
+  async getXml(uuid) {
+    return this.http.get(`invoices/${uuid}/xml`).blob();
+  }
+  /**
+   * Download the PDF representation for an invoice. Works with either a
+   * Supabase bearer session or an API key (requires the `read:invoices`
+   * scope).
+   */
+  async getPdf(uuid) {
+    return this.http.get(`invoices/${uuid}/pdf`).blob();
+  }
 };
 
 // src/resources/oauth.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timbrix/sdk",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "TypeScript SDK for Timbrix API",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",