@timbrix/sdk 0.3.1 → 1.1.0

package/dist/index.d.mts

@@ -201,7 +201,7 @@ interface WebhookDelivery {
     success: boolean;
     createdAt: string;
 }
-type ApiKeyScope = "read:user" | "write:user" | "read:organization" | "write:organization" | "read:members" | "write:members" | "read:webhooks" | "write:webhooks" | "read:api-keys" | "write:api-keys";
+type ApiKeyScope = "read:user" | "write:user" | "read:organization" | "write:organization" | "read:members" | "write:members" | "read:webhooks" | "write:webhooks" | "read:api-keys" | "write:api-keys" | "read:invoices" | "write:invoices";
 interface ApiKey {
     id: string;
     organizationId: string;
@@ -408,6 +408,138 @@ 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;
+    /** SAT régimen fiscal code — required unless the customer is público en general */
+    taxSystem?: string;
+    zip?: string;
+}
+interface InvoiceTaxInput {
+    type: string;
+    factorType: string;
+    rate?: string;
+    base?: number;
+    amount?: number;
+}
+interface InvoiceItemInput {
+    quantity: number;
+    amount: number;
+    /** 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[];
+}
+interface CreateInvoiceInput {
+    /** Ingreso, Egreso, or Traslado — default: I */
+    type?: "I" | "E" | "T";
+    series: string;
+    folioNumber: string;
+    date: string;
+    paymentForm: string;
+    /** Default: PUE */
+    paymentMethod?: "PUE" | "PPD";
+    /** Default: MXN */
+    currency?: string;
+    /** Default: 1 */
+    exchange?: number;
+    /** SAT clave de exportación — default: 01 */
+    export?: string;
+    /** SAT uso CFDI catalog code */
+    use: string;
+    /** Inline customer — mutually exclusive with customerId */
+    customer?: InvoiceCustomerInput;
+    /** Existing customer ID — mutually exclusive with customer */
+    customerId?: string;
+    items: InvoiceItemInput[];
+    /**
+     * Client-supplied key to safely retry this request without
+     * double-stamping. If an invoice was already created for this
+     * organization with the same key, that invoice is returned instead of
+     * stamping again.
+     */
+    idempotencyKey?: string;
+}
+interface Invoice {
+    id: string;
+    uuid: string;
+    status: "valid";
+    series: string;
+    folioNumber: string;
+    total: number;
+    date: string;
+    xml: string;
+    createdAt: string;
+}
+interface ListInvoicesParams {
+    /** Page number (1-indexed). Default: 1 */
+    page?: number;
+    /** Results per page (1-100). Default: 20 */
+    limit?: number;
+}
+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[];
@@ -485,6 +617,25 @@ declare class CustomersResource {
     delete(organizationId: string, customerId: string): Promise<void>;
 }
 
+declare class InvoicesResource {
+    private http;
+    constructor(http: KyInstance);
+    /**
+     * Create and stamp (timbrar) a CFDI 4.0 invoice via the configured PAC.
+     * 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(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 {
     private http;
     constructor(http: KyInstance);
@@ -602,6 +753,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 {
@@ -617,6 +782,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 {
@@ -687,6 +862,7 @@ declare class Timbrix {
     readonly oauth: OAuthResource;
     readonly products: ProductsResource;
     readonly sat: SatResource;
+    readonly invoices: InvoicesResource;
     constructor(config?: TimbrixConfig);
     /**
      * Update authentication strategy (useful for CLI when token changes)
@@ -715,4 +891,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 CreateOAuthAppInput, type CreateOrganizationInput, type CreateProductInput, type CreateWebhookInput, type Customer, type CustomerAddress, CustomersResource, type ExchangeCodeInput, type GenerateTokenInput, type InviteMemberInput, 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

@@ -201,7 +201,7 @@ interface WebhookDelivery {
     success: boolean;
     createdAt: string;
 }
-type ApiKeyScope = "read:user" | "write:user" | "read:organization" | "write:organization" | "read:members" | "write:members" | "read:webhooks" | "write:webhooks" | "read:api-keys" | "write:api-keys";
+type ApiKeyScope = "read:user" | "write:user" | "read:organization" | "write:organization" | "read:members" | "write:members" | "read:webhooks" | "write:webhooks" | "read:api-keys" | "write:api-keys" | "read:invoices" | "write:invoices";
 interface ApiKey {
     id: string;
     organizationId: string;
@@ -408,6 +408,138 @@ 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;
+    /** SAT régimen fiscal code — required unless the customer is público en general */
+    taxSystem?: string;
+    zip?: string;
+}
+interface InvoiceTaxInput {
+    type: string;
+    factorType: string;
+    rate?: string;
+    base?: number;
+    amount?: number;
+}
+interface InvoiceItemInput {
+    quantity: number;
+    amount: number;
+    /** 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[];
+}
+interface CreateInvoiceInput {
+    /** Ingreso, Egreso, or Traslado — default: I */
+    type?: "I" | "E" | "T";
+    series: string;
+    folioNumber: string;
+    date: string;
+    paymentForm: string;
+    /** Default: PUE */
+    paymentMethod?: "PUE" | "PPD";
+    /** Default: MXN */
+    currency?: string;
+    /** Default: 1 */
+    exchange?: number;
+    /** SAT clave de exportación — default: 01 */
+    export?: string;
+    /** SAT uso CFDI catalog code */
+    use: string;
+    /** Inline customer — mutually exclusive with customerId */
+    customer?: InvoiceCustomerInput;
+    /** Existing customer ID — mutually exclusive with customer */
+    customerId?: string;
+    items: InvoiceItemInput[];
+    /**
+     * Client-supplied key to safely retry this request without
+     * double-stamping. If an invoice was already created for this
+     * organization with the same key, that invoice is returned instead of
+     * stamping again.
+     */
+    idempotencyKey?: string;
+}
+interface Invoice {
+    id: string;
+    uuid: string;
+    status: "valid";
+    series: string;
+    folioNumber: string;
+    total: number;
+    date: string;
+    xml: string;
+    createdAt: string;
+}
+interface ListInvoicesParams {
+    /** Page number (1-indexed). Default: 1 */
+    page?: number;
+    /** Results per page (1-100). Default: 20 */
+    limit?: number;
+}
+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[];
@@ -485,6 +617,25 @@ declare class CustomersResource {
     delete(organizationId: string, customerId: string): Promise<void>;
 }
 
+declare class InvoicesResource {
+    private http;
+    constructor(http: KyInstance);
+    /**
+     * Create and stamp (timbrar) a CFDI 4.0 invoice via the configured PAC.
+     * 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(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 {
     private http;
     constructor(http: KyInstance);
@@ -602,6 +753,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 {
@@ -617,6 +782,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 {
@@ -687,6 +862,7 @@ declare class Timbrix {
     readonly oauth: OAuthResource;
     readonly products: ProductsResource;
     readonly sat: SatResource;
+    readonly invoices: InvoicesResource;
     constructor(config?: TimbrixConfig);
     /**
      * Update authentication strategy (useful for CLI when token changes)
@@ -715,4 +891,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 CreateOAuthAppInput, type CreateOrganizationInput, type CreateProductInput, type CreateWebhookInput, type Customer, type CustomerAddress, CustomersResource, type ExchangeCodeInput, type GenerateTokenInput, type InviteMemberInput, 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

@@ -35,6 +35,7 @@ __export(index_exports, {
   AuthResource: () => AuthResource,
   BearerAuth: () => BearerAuth,
   CustomersResource: () => CustomersResource,
+  InvoicesResource: () => InvoicesResource,
   OAuthResource: () => OAuthResource,
   OrganizationsResource: () => OrganizationsResource,
   ProductsResource: () => ProductsResource,
@@ -206,6 +207,37 @@ var CustomersResource = class {
   }
 };
 
+// src/resources/invoices.ts
+var InvoicesResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Create and stamp (timbrar) a CFDI 4.0 invoice via the configured PAC.
+   * 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(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);
+    return this.http.get(`organizations/${organizationId}/invoices`, {
+      searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
+    }).json();
+  }
+};
+
 // src/resources/oauth.ts
 var OAuthResource = class {
   constructor(http) {
@@ -416,6 +448,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
@@ -447,6 +502,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
@@ -548,6 +627,7 @@ var Timbrix = class {
   oauth;
   products;
   sat;
+  invoices;
   constructor(config = {}) {
     const baseUrl = config.baseUrl || "http://localhost:3001";
     if (config.bearerToken) {
@@ -582,6 +662,7 @@ var Timbrix = class {
     this.oauth = new OAuthResource(this.http);
     this.products = new ProductsResource(this.http);
     this.sat = new SatResource(this.http);
+    this.invoices = new InvoicesResource(this.http);
   }
   /**
    * Update authentication strategy (useful for CLI when token changes)
@@ -609,6 +690,7 @@ var Timbrix = class {
   AuthResource,
   BearerAuth,
   CustomersResource,
+  InvoicesResource,
   OAuthResource,
   OrganizationsResource,
   ProductsResource,

package/dist/index.mjs

@@ -159,6 +159,37 @@ var CustomersResource = class {
   }
 };
 
+// src/resources/invoices.ts
+var InvoicesResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Create and stamp (timbrar) a CFDI 4.0 invoice via the configured PAC.
+   * 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(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);
+    return this.http.get(`organizations/${organizationId}/invoices`, {
+      searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
+    }).json();
+  }
+};
+
 // src/resources/oauth.ts
 var OAuthResource = class {
   constructor(http) {
@@ -369,6 +400,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
@@ -400,6 +454,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
@@ -501,6 +579,7 @@ var Timbrix = class {
   oauth;
   products;
   sat;
+  invoices;
   constructor(config = {}) {
     const baseUrl = config.baseUrl || "http://localhost:3001";
     if (config.bearerToken) {
@@ -535,6 +614,7 @@ var Timbrix = class {
     this.oauth = new OAuthResource(this.http);
     this.products = new ProductsResource(this.http);
     this.sat = new SatResource(this.http);
+    this.invoices = new InvoicesResource(this.http);
   }
   /**
    * Update authentication strategy (useful for CLI when token changes)
@@ -561,6 +641,7 @@ export {
   AuthResource,
   BearerAuth,
   CustomersResource,
+  InvoicesResource,
   OAuthResource,
   OrganizationsResource,
   ProductsResource,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timbrix/sdk",
-  "version": "0.3.1",
+  "version": "1.1.0",
   "description": "TypeScript SDK for Timbrix API",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -32,8 +32,8 @@
   "devDependencies": {
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "@repo/typescript-config": "0.1.0",
-    "@repo/eslint-config": "0.1.1"
+    "@repo/eslint-config": "0.1.1",
+    "@repo/typescript-config": "0.1.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts",