@timbrix/sdk 1.0.0 → 1.2.0

package/dist/index.d.mts

@@ -408,6 +408,40 @@ interface ListUsosCfdiParams {
     tipoPersona?: TipoPersona;
     regimen?: string;
 }
+interface ClaveProdServ {
+    codigo: string;
+    descripcion: string;
+    incluyeIvaTrasladado: boolean;
+    incluyeIepsTrasladado: boolean;
+}
+interface ClaveUnidad {
+    codigo: string;
+    nombre: string;
+    descripcion: string;
+    simbolo?: string | null;
+}
+interface SearchClavesParams {
+    q?: string;
+    limit?: number;
+}
+interface SearchClavesProdServResult {
+    data: ClaveProdServ[];
+    total: number;
+}
+interface SearchClavesUnidadResult {
+    data: ClaveUnidad[];
+    total: number;
+}
+interface ImportProductsCsvRowError {
+    row: number;
+    message: string;
+}
+interface ImportProductsCsvResult {
+    totalRows: number;
+    successCount: number;
+    errorCount: number;
+    errors: ImportProductsCsvRowError[];
+}
 interface InvoiceCustomerInput {
     legalName: string;
     taxId: string;
@@ -421,14 +455,22 @@ interface InvoiceTaxInput {
     rate?: string;
     base?: number;
     amount?: number;
+    /** true = retención, false/omitted = traslado */
+    withholding?: boolean;
 }
 interface InvoiceItemInput {
     quantity: number;
-    description: string;
-    unitPrice: number;
     amount: number;
-    productKey: string;
-    unitKey: string;
+    /** Existing product/service ID — mutually exclusive with `productKey`/`unitKey`/`description`/`unitPrice` (inline concept data) */
+    productId?: string;
+    /** Required unless `productId` is provided */
+    description?: string;
+    /** Required unless `productId` is provided */
+    unitPrice?: number;
+    /** Required unless `productId` is provided */
+    productKey?: string;
+    /** Required unless `productId` is provided */
+    unitKey?: string;
     unit?: string;
     taxObject?: string;
     taxes?: InvoiceTaxInput[];
@@ -436,6 +478,8 @@ interface InvoiceItemInput {
 interface CreateInvoiceInput {
     /** Ingreso, Egreso, or Traslado — default: I */
     type?: "I" | "E" | "T";
+    /** Required when type is "E" — UUID fiscal of the original Ingreso CFDI */
+    relatedInvoiceUuid?: string;
     series: string;
     folioNumber: string;
     date: string;
@@ -467,6 +511,8 @@ interface Invoice {
     id: string;
     uuid: string;
     status: "valid";
+    /** I = Ingreso, E = Egreso, T = Traslado */
+    type: "I" | "E" | "T";
     series: string;
     folioNumber: string;
     total: number;
@@ -474,6 +520,36 @@ interface Invoice {
     xml: string;
     createdAt: string;
 }
+interface ListInvoicesParams {
+    /** Page number (1-indexed). Default: 1 */
+    page?: number;
+    /** Results per page (1-100). Default: 20 */
+    limit?: number;
+    /** Filter by tipo de comprobante */
+    type?: "I" | "E" | "T";
+    /** Filter by status */
+    status?: "vigente" | "cancelado";
+}
+interface InvoiceListItem {
+    id: string;
+    uuid: string;
+    serie: string;
+    folio: string;
+    /** I = Ingreso, E = Egreso, T = Traslado */
+    tipoComprobante: string;
+    rfcReceptor: string;
+    moneda: string;
+    total: number;
+    status: "vigente" | "cancelado";
+    createdAt: string;
+}
+interface ListInvoicesResponse {
+    data: InvoiceListItem[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}
 interface TimbrixError {
     statusCode: number;
     message: string | string[];
@@ -556,10 +632,18 @@ declare class InvoicesResource {
     constructor(http: KyInstance);
     /**
      * Create and stamp (timbrar) a CFDI 4.0 invoice via the configured PAC.
-     * Requires an API-key-authenticated client — the issuing organization is
-     * resolved from the key, there is no organizationId parameter.
+     * 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`).
      */
-    create(data: CreateInvoiceInput): Promise<Invoice>;
+    create(organizationId: string, data: CreateInvoiceInput): Promise<Invoice>;
+    /**
+     * 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>;
 }
 
 declare class OAuthResource {
@@ -679,6 +763,20 @@ declare class ProductsResource {
      * Delete a product
      */
     delete(organizationId: string, productId: string): Promise<void>;
+    /**
+     * Bulk import products/services from a CSV file (multipart/form-data,
+     * field name "file"). Works in both Node (18+) and browser environments,
+     * since both provide the global `Blob`/`File` and `FormData` APIs.
+     *
+     * Required CSV columns: description, productKey, price. Optional
+     * columns: unitKey (default H87), unitName, sku, taxIncluded,
+     * taxability, livemode. Processing is partial — valid rows are created
+     * even if other rows fail, and every failure is reported with its row
+     * number and reason.
+     *
+     * Calls POST /organizations/:organizationId/products/import
+     */
+    importCsv(organizationId: string, file: Blob | File, filename?: string): Promise<ImportProductsCsvResult>;
 }
 
 declare class SatResource {
@@ -694,6 +792,16 @@ declare class SatResource {
      * Calls GET /sat/usos-cfdi
      */
     usosCfdi(params?: ListUsosCfdiParams): Promise<UsoCfdi[]>;
+    /**
+     * Search claves de producto o servicio in the SAT catalog (c_ClaveProdServ)
+     * Calls GET /sat/claves-prod-serv
+     */
+    searchClavesProdServ(params?: SearchClavesParams): Promise<SearchClavesProdServResult>;
+    /**
+     * Search claves de unidad de medida in the SAT catalog (c_ClaveUnidad)
+     * Calls GET /sat/claves-unidad
+     */
+    searchClavesUnidad(params?: SearchClavesParams): Promise<SearchClavesUnidadResult>;
 }
 
 declare class UsersResource {
@@ -793,4 +901,4 @@ declare class ApiKeyAuth implements AuthStrategy {
     applyAuth(options: Options): Options;
 }
 
-export { type ApiKey, ApiKeyAuth, type ApiKeyScope, type ApiKeyStats, type ApiKeyValidateResponse, ApiKeysResource, type AuthMode, AuthResource, type AuthStrategy, BearerAuth, type CreateApiKeyInput, type CreateApiKeyResponse, type CreateCustomerInput, type CreateInvoiceInput, type CreateOAuthAppInput, type CreateOrganizationInput, type CreateProductInput, type CreateWebhookInput, type Customer, type CustomerAddress, CustomersResource, type ExchangeCodeInput, type GenerateTokenInput, type InviteMemberInput, type Invoice, type InvoiceCustomerInput, type InvoiceItemInput, type InvoiceTaxInput, InvoicesResource, type LegalAddress, type ListProductsFilters, type ListRegimenesParams, type ListUsosCfdiParams, type LoginInput, type LoginResponse, type OAuthApp, type OAuthAppWithSecret, OAuthResource, type OAuthScope, type OAuthToken, type Organization, type OrganizationDetails, type OrganizationInvite, type OrganizationMember, type OrganizationRole, OrganizationsResource, type Product, type ProductTax, ProductsResource, type RefreshTokenInput, type RegimenFiscal, SatResource, Timbrix, type TimbrixConfig, type TimbrixError, type TimbrixUser, type TipoPersona, type TokenResponse, type UpdateApiKeyInput, type UpdateCustomerInput, type UpdateLegalDataInput, type UpdateMemberRoleInput, type UpdateOAuthAppInput, type UpdateOrganizationInput, type UpdateProductInput, type UpdateWebhookInput, UsersResource, type UsoCfdi, type ValidateCertificateResponse, type Webhook, type WebhookDelivery, type WebhookEvent, WebhooksResource };
+export { type ApiKey, ApiKeyAuth, type ApiKeyScope, type ApiKeyStats, type ApiKeyValidateResponse, ApiKeysResource, type AuthMode, AuthResource, type AuthStrategy, BearerAuth, type ClaveProdServ, type ClaveUnidad, type CreateApiKeyInput, type CreateApiKeyResponse, type CreateCustomerInput, type CreateInvoiceInput, type CreateOAuthAppInput, type CreateOrganizationInput, type CreateProductInput, type CreateWebhookInput, type Customer, type CustomerAddress, CustomersResource, type ExchangeCodeInput, type GenerateTokenInput, type ImportProductsCsvResult, type ImportProductsCsvRowError, type InviteMemberInput, type Invoice, type InvoiceCustomerInput, type InvoiceItemInput, type InvoiceListItem, type InvoiceTaxInput, InvoicesResource, type LegalAddress, type ListInvoicesParams, type ListInvoicesResponse, type ListProductsFilters, type ListRegimenesParams, type ListUsosCfdiParams, type LoginInput, type LoginResponse, type OAuthApp, type OAuthAppWithSecret, OAuthResource, type OAuthScope, type OAuthToken, type Organization, type OrganizationDetails, type OrganizationInvite, type OrganizationMember, type OrganizationRole, OrganizationsResource, type Product, type ProductTax, ProductsResource, type RefreshTokenInput, type RegimenFiscal, SatResource, type SearchClavesParams, type SearchClavesProdServResult, type SearchClavesUnidadResult, Timbrix, type TimbrixConfig, type TimbrixError, type TimbrixUser, type TipoPersona, type TokenResponse, type UpdateApiKeyInput, type UpdateCustomerInput, type UpdateLegalDataInput, type UpdateMemberRoleInput, type UpdateOAuthAppInput, type UpdateOrganizationInput, type UpdateProductInput, type UpdateWebhookInput, UsersResource, type UsoCfdi, type ValidateCertificateResponse, type Webhook, type WebhookDelivery, type WebhookEvent, WebhooksResource };

package/dist/index.d.ts

@@ -408,6 +408,40 @@ interface ListUsosCfdiParams {
     tipoPersona?: TipoPersona;
     regimen?: string;
 }
+interface ClaveProdServ {
+    codigo: string;
+    descripcion: string;
+    incluyeIvaTrasladado: boolean;
+    incluyeIepsTrasladado: boolean;
+}
+interface ClaveUnidad {
+    codigo: string;
+    nombre: string;
+    descripcion: string;
+    simbolo?: string | null;
+}
+interface SearchClavesParams {
+    q?: string;
+    limit?: number;
+}
+interface SearchClavesProdServResult {
+    data: ClaveProdServ[];
+    total: number;
+}
+interface SearchClavesUnidadResult {
+    data: ClaveUnidad[];
+    total: number;
+}
+interface ImportProductsCsvRowError {
+    row: number;
+    message: string;
+}
+interface ImportProductsCsvResult {
+    totalRows: number;
+    successCount: number;
+    errorCount: number;
+    errors: ImportProductsCsvRowError[];
+}
 interface InvoiceCustomerInput {
     legalName: string;
     taxId: string;
@@ -421,14 +455,22 @@ interface InvoiceTaxInput {
     rate?: string;
     base?: number;
     amount?: number;
+    /** true = retención, false/omitted = traslado */
+    withholding?: boolean;
 }
 interface InvoiceItemInput {
     quantity: number;
-    description: string;
-    unitPrice: number;
     amount: number;
-    productKey: string;
-    unitKey: string;
+    /** Existing product/service ID — mutually exclusive with `productKey`/`unitKey`/`description`/`unitPrice` (inline concept data) */
+    productId?: string;
+    /** Required unless `productId` is provided */
+    description?: string;
+    /** Required unless `productId` is provided */
+    unitPrice?: number;
+    /** Required unless `productId` is provided */
+    productKey?: string;
+    /** Required unless `productId` is provided */
+    unitKey?: string;
     unit?: string;
     taxObject?: string;
     taxes?: InvoiceTaxInput[];
@@ -436,6 +478,8 @@ interface InvoiceItemInput {
 interface CreateInvoiceInput {
     /** Ingreso, Egreso, or Traslado — default: I */
     type?: "I" | "E" | "T";
+    /** Required when type is "E" — UUID fiscal of the original Ingreso CFDI */
+    relatedInvoiceUuid?: string;
     series: string;
     folioNumber: string;
     date: string;
@@ -467,6 +511,8 @@ interface Invoice {
     id: string;
     uuid: string;
     status: "valid";
+    /** I = Ingreso, E = Egreso, T = Traslado */
+    type: "I" | "E" | "T";
     series: string;
     folioNumber: string;
     total: number;
@@ -474,6 +520,36 @@ interface Invoice {
     xml: string;
     createdAt: string;
 }
+interface ListInvoicesParams {
+    /** Page number (1-indexed). Default: 1 */
+    page?: number;
+    /** Results per page (1-100). Default: 20 */
+    limit?: number;
+    /** Filter by tipo de comprobante */
+    type?: "I" | "E" | "T";
+    /** Filter by status */
+    status?: "vigente" | "cancelado";
+}
+interface InvoiceListItem {
+    id: string;
+    uuid: string;
+    serie: string;
+    folio: string;
+    /** I = Ingreso, E = Egreso, T = Traslado */
+    tipoComprobante: string;
+    rfcReceptor: string;
+    moneda: string;
+    total: number;
+    status: "vigente" | "cancelado";
+    createdAt: string;
+}
+interface ListInvoicesResponse {
+    data: InvoiceListItem[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}
 interface TimbrixError {
     statusCode: number;
     message: string | string[];
@@ -556,10 +632,18 @@ declare class InvoicesResource {
     constructor(http: KyInstance);
     /**
      * Create and stamp (timbrar) a CFDI 4.0 invoice via the configured PAC.
-     * Requires an API-key-authenticated client — the issuing organization is
-     * resolved from the key, there is no organizationId parameter.
+     * 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`).
      */
-    create(data: CreateInvoiceInput): Promise<Invoice>;
+    create(organizationId: string, data: CreateInvoiceInput): Promise<Invoice>;
+    /**
+     * 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>;
 }
 
 declare class OAuthResource {
@@ -679,6 +763,20 @@ declare class ProductsResource {
      * Delete a product
      */
     delete(organizationId: string, productId: string): Promise<void>;
+    /**
+     * Bulk import products/services from a CSV file (multipart/form-data,
+     * field name "file"). Works in both Node (18+) and browser environments,
+     * since both provide the global `Blob`/`File` and `FormData` APIs.
+     *
+     * Required CSV columns: description, productKey, price. Optional
+     * columns: unitKey (default H87), unitName, sku, taxIncluded,
+     * taxability, livemode. Processing is partial — valid rows are created
+     * even if other rows fail, and every failure is reported with its row
+     * number and reason.
+     *
+     * Calls POST /organizations/:organizationId/products/import
+     */
+    importCsv(organizationId: string, file: Blob | File, filename?: string): Promise<ImportProductsCsvResult>;
 }
 
 declare class SatResource {
@@ -694,6 +792,16 @@ declare class SatResource {
      * Calls GET /sat/usos-cfdi
      */
     usosCfdi(params?: ListUsosCfdiParams): Promise<UsoCfdi[]>;
+    /**
+     * Search claves de producto o servicio in the SAT catalog (c_ClaveProdServ)
+     * Calls GET /sat/claves-prod-serv
+     */
+    searchClavesProdServ(params?: SearchClavesParams): Promise<SearchClavesProdServResult>;
+    /**
+     * Search claves de unidad de medida in the SAT catalog (c_ClaveUnidad)
+     * Calls GET /sat/claves-unidad
+     */
+    searchClavesUnidad(params?: SearchClavesParams): Promise<SearchClavesUnidadResult>;
 }
 
 declare class UsersResource {
@@ -793,4 +901,4 @@ declare class ApiKeyAuth implements AuthStrategy {
     applyAuth(options: Options): Options;
 }
 
-export { type ApiKey, ApiKeyAuth, type ApiKeyScope, type ApiKeyStats, type ApiKeyValidateResponse, ApiKeysResource, type AuthMode, AuthResource, type AuthStrategy, BearerAuth, type CreateApiKeyInput, type CreateApiKeyResponse, type CreateCustomerInput, type CreateInvoiceInput, type CreateOAuthAppInput, type CreateOrganizationInput, type CreateProductInput, type CreateWebhookInput, type Customer, type CustomerAddress, CustomersResource, type ExchangeCodeInput, type GenerateTokenInput, type InviteMemberInput, type Invoice, type InvoiceCustomerInput, type InvoiceItemInput, type InvoiceTaxInput, InvoicesResource, type LegalAddress, type ListProductsFilters, type ListRegimenesParams, type ListUsosCfdiParams, type LoginInput, type LoginResponse, type OAuthApp, type OAuthAppWithSecret, OAuthResource, type OAuthScope, type OAuthToken, type Organization, type OrganizationDetails, type OrganizationInvite, type OrganizationMember, type OrganizationRole, OrganizationsResource, type Product, type ProductTax, ProductsResource, type RefreshTokenInput, type RegimenFiscal, SatResource, Timbrix, type TimbrixConfig, type TimbrixError, type TimbrixUser, type TipoPersona, type TokenResponse, type UpdateApiKeyInput, type UpdateCustomerInput, type UpdateLegalDataInput, type UpdateMemberRoleInput, type UpdateOAuthAppInput, type UpdateOrganizationInput, type UpdateProductInput, type UpdateWebhookInput, UsersResource, type UsoCfdi, type ValidateCertificateResponse, type Webhook, type WebhookDelivery, type WebhookEvent, WebhooksResource };
+export { type ApiKey, ApiKeyAuth, type ApiKeyScope, type ApiKeyStats, type ApiKeyValidateResponse, ApiKeysResource, type AuthMode, AuthResource, type AuthStrategy, BearerAuth, type ClaveProdServ, type ClaveUnidad, type CreateApiKeyInput, type CreateApiKeyResponse, type CreateCustomerInput, type CreateInvoiceInput, type CreateOAuthAppInput, type CreateOrganizationInput, type CreateProductInput, type CreateWebhookInput, type Customer, type CustomerAddress, CustomersResource, type ExchangeCodeInput, type GenerateTokenInput, type ImportProductsCsvResult, type ImportProductsCsvRowError, type InviteMemberInput, type Invoice, type InvoiceCustomerInput, type InvoiceItemInput, type InvoiceListItem, type InvoiceTaxInput, InvoicesResource, type LegalAddress, type ListInvoicesParams, type ListInvoicesResponse, type ListProductsFilters, type ListRegimenesParams, type ListUsosCfdiParams, type LoginInput, type LoginResponse, type OAuthApp, type OAuthAppWithSecret, OAuthResource, type OAuthScope, type OAuthToken, type Organization, type OrganizationDetails, type OrganizationInvite, type OrganizationMember, type OrganizationRole, OrganizationsResource, type Product, type ProductTax, ProductsResource, type RefreshTokenInput, type RegimenFiscal, SatResource, type SearchClavesParams, type SearchClavesProdServResult, type SearchClavesUnidadResult, Timbrix, type TimbrixConfig, type TimbrixError, type TimbrixUser, type TipoPersona, type TokenResponse, type UpdateApiKeyInput, type UpdateCustomerInput, type UpdateLegalDataInput, type UpdateMemberRoleInput, type UpdateOAuthAppInput, type UpdateOrganizationInput, type UpdateProductInput, type UpdateWebhookInput, UsersResource, type UsoCfdi, type ValidateCertificateResponse, type Webhook, type WebhookDelivery, type WebhookEvent, WebhooksResource };

package/dist/index.js

@@ -215,11 +215,28 @@ var InvoicesResource = class {
   http;
   /**
    * Create and stamp (timbrar) a CFDI 4.0 invoice via the configured PAC.
-   * Requires an API-key-authenticated client — the issuing organization is
-   * resolved from the key, there is no organizationId parameter.
+   * 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 create(data) {
-    return this.http.post("invoices", { json: data }).json();
+  async create(organizationId, data) {
+    return this.http.post(`organizations/${organizationId}/invoices`, { json: data }).json();
+  }
+  /**
+   * 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`.
+   */
+  async list(organizationId, params) {
+    const searchParams = {};
+    if (params?.page !== void 0) searchParams.page = String(params.page);
+    if (params?.limit !== void 0) searchParams.limit = String(params.limit);
+    if (params?.type !== void 0) searchParams.type = params.type;
+    if (params?.status !== void 0) searchParams.status = params.status;
+    return this.http.get(`organizations/${organizationId}/invoices`, {
+      searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
+    }).json();
   }
 };
 
@@ -433,6 +450,29 @@ var ProductsResource = class {
       `organizations/${organizationId}/products/${productId}`
     );
   }
+  /**
+   * Bulk import products/services from a CSV file (multipart/form-data,
+   * field name "file"). Works in both Node (18+) and browser environments,
+   * since both provide the global `Blob`/`File` and `FormData` APIs.
+   *
+   * Required CSV columns: description, productKey, price. Optional
+   * columns: unitKey (default H87), unitName, sku, taxIncluded,
+   * taxability, livemode. Processing is partial — valid rows are created
+   * even if other rows fail, and every failure is reported with its row
+   * number and reason.
+   *
+   * Calls POST /organizations/:organizationId/products/import
+   */
+  async importCsv(organizationId, file, filename = "products.csv") {
+    const formData = new FormData();
+    formData.append("file", file, filename);
+    return this.http.post(`organizations/${organizationId}/products/import`, {
+      body: formData,
+      // Let fetch set the multipart Content-Type (with boundary) itself —
+      // unset the JSON default header inherited from the client instance.
+      headers: { "Content-Type": void 0 }
+    }).json();
+  }
 };
 
 // src/resources/sat.ts
@@ -464,6 +504,30 @@ var SatResource = class {
       searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
     }).json();
   }
+  /**
+   * Search claves de producto o servicio in the SAT catalog (c_ClaveProdServ)
+   * Calls GET /sat/claves-prod-serv
+   */
+  async searchClavesProdServ(params) {
+    const searchParams = {};
+    if (params?.q) searchParams.q = params.q;
+    if (params?.limit !== void 0) searchParams.limit = String(params.limit);
+    return this.http.get("sat/claves-prod-serv", {
+      searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
+    }).json();
+  }
+  /**
+   * Search claves de unidad de medida in the SAT catalog (c_ClaveUnidad)
+   * Calls GET /sat/claves-unidad
+   */
+  async searchClavesUnidad(params) {
+    const searchParams = {};
+    if (params?.q) searchParams.q = params.q;
+    if (params?.limit !== void 0) searchParams.limit = String(params.limit);
+    return this.http.get("sat/claves-unidad", {
+      searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
+    }).json();
+  }
 };
 
 // src/resources/users.ts

package/dist/index.mjs

@@ -167,11 +167,28 @@ var InvoicesResource = class {
   http;
   /**
    * Create and stamp (timbrar) a CFDI 4.0 invoice via the configured PAC.
-   * Requires an API-key-authenticated client — the issuing organization is
-   * resolved from the key, there is no organizationId parameter.
+   * 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 create(data) {
-    return this.http.post("invoices", { json: data }).json();
+  async create(organizationId, data) {
+    return this.http.post(`organizations/${organizationId}/invoices`, { json: data }).json();
+  }
+  /**
+   * 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`.
+   */
+  async list(organizationId, params) {
+    const searchParams = {};
+    if (params?.page !== void 0) searchParams.page = String(params.page);
+    if (params?.limit !== void 0) searchParams.limit = String(params.limit);
+    if (params?.type !== void 0) searchParams.type = params.type;
+    if (params?.status !== void 0) searchParams.status = params.status;
+    return this.http.get(`organizations/${organizationId}/invoices`, {
+      searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
+    }).json();
   }
 };
 
@@ -385,6 +402,29 @@ var ProductsResource = class {
       `organizations/${organizationId}/products/${productId}`
     );
   }
+  /**
+   * Bulk import products/services from a CSV file (multipart/form-data,
+   * field name "file"). Works in both Node (18+) and browser environments,
+   * since both provide the global `Blob`/`File` and `FormData` APIs.
+   *
+   * Required CSV columns: description, productKey, price. Optional
+   * columns: unitKey (default H87), unitName, sku, taxIncluded,
+   * taxability, livemode. Processing is partial — valid rows are created
+   * even if other rows fail, and every failure is reported with its row
+   * number and reason.
+   *
+   * Calls POST /organizations/:organizationId/products/import
+   */
+  async importCsv(organizationId, file, filename = "products.csv") {
+    const formData = new FormData();
+    formData.append("file", file, filename);
+    return this.http.post(`organizations/${organizationId}/products/import`, {
+      body: formData,
+      // Let fetch set the multipart Content-Type (with boundary) itself —
+      // unset the JSON default header inherited from the client instance.
+      headers: { "Content-Type": void 0 }
+    }).json();
+  }
 };
 
 // src/resources/sat.ts
@@ -416,6 +456,30 @@ var SatResource = class {
       searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
     }).json();
   }
+  /**
+   * Search claves de producto o servicio in the SAT catalog (c_ClaveProdServ)
+   * Calls GET /sat/claves-prod-serv
+   */
+  async searchClavesProdServ(params) {
+    const searchParams = {};
+    if (params?.q) searchParams.q = params.q;
+    if (params?.limit !== void 0) searchParams.limit = String(params.limit);
+    return this.http.get("sat/claves-prod-serv", {
+      searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
+    }).json();
+  }
+  /**
+   * Search claves de unidad de medida in the SAT catalog (c_ClaveUnidad)
+   * Calls GET /sat/claves-unidad
+   */
+  async searchClavesUnidad(params) {
+    const searchParams = {};
+    if (params?.q) searchParams.q = params.q;
+    if (params?.limit !== void 0) searchParams.limit = String(params.limit);
+    return this.http.get("sat/claves-unidad", {
+      searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
+    }).json();
+  }
 };
 
 // src/resources/users.ts

package/package.json

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