@pimia/sdk 0.2.0 → 0.4.0

package/dist/client.d.ts

@@ -13,8 +13,42 @@
  *  - **429**: respeta `Retry-After` y reintenta con espera acotada;
  *  - **errores tipados**: MissingScopeError trae el scope exacto que falta.
  */
+import type { components } from './api.js';
 import { OAuth, type OAuthConfig } from './oauth.js';
 import { type TokenStore } from './tokens.js';
+type Schemas = components['schemas'];
+/** Cliente tal y como lo devuelve la API. */
+export type CustomerResource = Schemas['CustomerResource'];
+/** Factura tal y como la devuelve la API. */
+export type InvoiceResource = Schemas['InvoiceResource'];
+/** Presupuesto tal y como lo devuelve la API. */
+export type EstimateResource = Schemas['EstimateResource'];
+/** Cuerpo de alta/edición de cliente. Incluye `customFields`. */
+export type CustomerRequest = Schemas['CustomerRequest'];
+/** Cuerpo de alta/edición de factura. Incluye `customFields`. */
+export type InvoicesRequest = Schemas['InvoicesRequest'];
+/** Cuerpo de alta/edición de presupuesto. Incluye `customFields`. */
+export type EstimatesRequest = Schemas['EstimatesRequest'];
+/**
+ * El sobre `{ data: … }` de Laravel para las escrituras que el spec **no
+ * tipa**.
+ *
+ * Hay 17 operaciones cuyo `200` sale del generador como objeto vacío, y entre
+ * ellas están `POST /invoices`, `PUT /invoices/{id}`, `PUT /customers/{id}` y
+ * `POST /estimates/{id}/convert-to-invoice`. Usar ahí el tipo generado sería
+ * peor que no tipar: `Record<string, never>` afirma que la respuesta **no
+ * tiene propiedades**, y el `data` real desaparecería del autocompletado.
+ *
+ * Así que el sobre se declara aquí y el recurso de dentro sí sale del spec.
+ * Está verificado contra los controladores del core, no supuesto: los cuatro
+ * devuelven `new XResource($modelo)` con el envoltorio `data` de Laravel
+ * activo. La causa del hueco es del generador —un `@return JsonResponse`
+ * heredado que le gana a la inferencia—, no del contrato; cuando se arregle
+ * en el core, estos tipos pasarán a salir de `Ok<…>` como los demás.
+ */
+export interface ResourceEnvelope<T> {
+    data: T;
+}
 export interface PimiaClientOptions extends OAuthConfig {
     tokens: TokenStore;
     /** Segundos de margen para refrescar antes de que caduque (default 60). */
@@ -94,21 +128,361 @@ export declare class PimiaClient {
     /** Cabeceras `X-RateLimit-*` de la última respuesta. */
     get rateLimit(): RateLimit;
     get invoices(): {
-        list: (query?: RequestOptions["query"]) => Promise<unknown>;
-        get: (id: number | string) => Promise<unknown>;
-        create: (body: unknown, options?: WriteOptions) => Promise<unknown>;
-        update: (id: number | string, body: unknown, options?: WriteOptions) => Promise<unknown>;
+        list: (query?: RequestOptions["query"]) => Promise<{
+            data: components["schemas"]["InvoiceResource"][];
+            meta: {
+                invoice_total_count: number;
+            };
+        }>;
+        get: (id: number | string) => Promise<{
+            data: components["schemas"]["InvoiceResource"] & Record<string, never>;
+        }>;
+        /**
+         * Devuelve `{ data: InvoiceResource }`. El tipo NO sale del spec: el
+         * `200` de `invoices.store` está vacío ahí (ver {@link ResourceEnvelope}).
+         */
+        create: (body: InvoicesRequest, options?: WriteOptions) => Promise<ResourceEnvelope<{
+            id: string;
+            invoice_date: string;
+            due_date: string;
+            invoice_number: string;
+            reference_number: string;
+            status: string;
+            paid_status: string;
+            tax_per_item: string;
+            tax_included: string;
+            discount_per_item: string;
+            notes: string;
+            discount_type: string;
+            discount: string;
+            discount_val: string;
+            sub_total: string;
+            total: string;
+            effective_total: string;
+            tax: string;
+            due_amount: string;
+            effective_due_amount: string;
+            sent: string;
+            viewed: string;
+            unique_hash: string;
+            template_name: string;
+            invoice_series_id: string;
+            customer_id: string;
+            external_ref: string | null;
+            payment_method_id: string;
+            recurring_invoice_id: string;
+            sequence_number: string;
+            exchange_rate: string;
+            base_discount_val: string;
+            base_sub_total: string;
+            base_total: string;
+            creator_id: string;
+            base_tax: string;
+            base_due_amount: string;
+            effective_base_total: string;
+            effective_base_due_amount: string;
+            credited_total: string;
+            credited_base_total: string;
+            currency_id: string;
+            formatted_created_at: string;
+            invoice_pdf_url: string;
+            formatted_invoice_date: string;
+            formatted_due_date: string;
+            allow_edit: string;
+            payment_module_enabled: string;
+            sales_tax_type: string;
+            sales_tax_address_type: string;
+            overdue: string;
+            effective_paid_status: string;
+            effective_overdue: string;
+            aeat_status: string;
+            qr_data: string;
+            hash: string;
+            aeat_csv: string;
+            is_credit_note: string | boolean;
+            rectified_invoice_id: string;
+            rectified_invoice_number?: string | null;
+            rectified_invoice?: {
+                id: string;
+                invoice_number: string;
+                tax_per_item: string;
+                tax_included: string;
+                sub_total: string;
+                discount_val: string;
+                tax: string;
+                total: string;
+                items: components["schemas"]["InvoiceItemResource"][];
+                taxes: components["schemas"]["TaxResource"][];
+            };
+            credit_notes_count: number;
+            items?: components["schemas"]["InvoiceItemResource"][];
+            payments?: components["schemas"]["PaymentResource"][];
+            customer?: components["schemas"]["CustomerResource"];
+            invoice_series?: components["schemas"]["InvoiceSeriesResource"];
+            payment_method?: components["schemas"]["PaymentMethodResource"];
+            creator?: components["schemas"]["UserResource"];
+            taxes: components["schemas"]["TaxResource"][];
+            fields?: components["schemas"]["CustomFieldValueResource"][];
+            company?: components["schemas"]["CompanyResource"];
+            currency?: components["schemas"]["CurrencyResource"];
+        }>>;
+        /** Mismo caso que `create`: el `200` de `invoices.update` no está tipado en el spec. */
+        update: (id: number | string, body: InvoicesRequest, options?: WriteOptions) => Promise<ResourceEnvelope<{
+            id: string;
+            invoice_date: string;
+            due_date: string;
+            invoice_number: string;
+            reference_number: string;
+            status: string;
+            paid_status: string;
+            tax_per_item: string;
+            tax_included: string;
+            discount_per_item: string;
+            notes: string;
+            discount_type: string;
+            discount: string;
+            discount_val: string;
+            sub_total: string;
+            total: string;
+            effective_total: string;
+            tax: string;
+            due_amount: string;
+            effective_due_amount: string;
+            sent: string;
+            viewed: string;
+            unique_hash: string;
+            template_name: string;
+            invoice_series_id: string;
+            customer_id: string;
+            external_ref: string | null;
+            payment_method_id: string;
+            recurring_invoice_id: string;
+            sequence_number: string;
+            exchange_rate: string;
+            base_discount_val: string;
+            base_sub_total: string;
+            base_total: string;
+            creator_id: string;
+            base_tax: string;
+            base_due_amount: string;
+            effective_base_total: string;
+            effective_base_due_amount: string;
+            credited_total: string;
+            credited_base_total: string;
+            currency_id: string;
+            formatted_created_at: string;
+            invoice_pdf_url: string;
+            formatted_invoice_date: string;
+            formatted_due_date: string;
+            allow_edit: string;
+            payment_module_enabled: string;
+            sales_tax_type: string;
+            sales_tax_address_type: string;
+            overdue: string;
+            effective_paid_status: string;
+            effective_overdue: string;
+            aeat_status: string;
+            qr_data: string;
+            hash: string;
+            aeat_csv: string;
+            is_credit_note: string | boolean;
+            rectified_invoice_id: string;
+            rectified_invoice_number?: string | null;
+            rectified_invoice?: {
+                id: string;
+                invoice_number: string;
+                tax_per_item: string;
+                tax_included: string;
+                sub_total: string;
+                discount_val: string;
+                tax: string;
+                total: string;
+                items: components["schemas"]["InvoiceItemResource"][];
+                taxes: components["schemas"]["TaxResource"][];
+            };
+            credit_notes_count: number;
+            items?: components["schemas"]["InvoiceItemResource"][];
+            payments?: components["schemas"]["PaymentResource"][];
+            customer?: components["schemas"]["CustomerResource"];
+            invoice_series?: components["schemas"]["InvoiceSeriesResource"];
+            payment_method?: components["schemas"]["PaymentMethodResource"];
+            creator?: components["schemas"]["UserResource"];
+            taxes: components["schemas"]["TaxResource"][];
+            fields?: components["schemas"]["CustomFieldValueResource"][];
+            company?: components["schemas"]["CompanyResource"];
+            currency?: components["schemas"]["CurrencyResource"];
+        }>>;
     };
     get customers(): {
-        list: (query?: RequestOptions["query"]) => Promise<unknown>;
-        get: (id: number | string) => Promise<unknown>;
-        create: (body: unknown, options?: WriteOptions) => Promise<unknown>;
-        update: (id: number | string, body: unknown, options?: WriteOptions) => Promise<unknown>;
+        list: (query?: RequestOptions["query"]) => Promise<{
+            data: components["schemas"]["CustomerResource"][];
+            meta: {
+                customer_total_count: number;
+            };
+        }>;
+        get: (id: number | string) => Promise<{
+            data: components["schemas"]["CustomerResource"];
+        }>;
+        create: (body: CustomerRequest, options?: WriteOptions) => Promise<{
+            data: components["schemas"]["CustomerResource"];
+        }>;
+        /** El `200` de `customers.update` no está tipado en el spec. */
+        update: (id: number | string, body: CustomerRequest, options?: WriteOptions) => Promise<ResourceEnvelope<{
+            id: string;
+            name: string;
+            email: string;
+            phone: string;
+            contact_name: string;
+            company_name: string;
+            website: string;
+            enable_portal: string;
+            password_added: boolean;
+            currency_id: string;
+            payment_method_id: string;
+            company_id: string;
+            facebook_id: string;
+            google_id: string;
+            github_id: string;
+            created_at: string;
+            formatted_created_at: string;
+            updated_at: string;
+            avatar: string;
+            due_amount: string;
+            base_due_amount: string;
+            prefix: string;
+            tax_id: string;
+            notes: string;
+            external_ref: string | null;
+            iban: string;
+            bic: string;
+            sepa_mandate_id: string;
+            sepa_mandate_date: string;
+            billing?: components["schemas"]["AddressResource"];
+            shipping?: components["schemas"]["AddressResource"];
+            fields?: components["schemas"]["CustomFieldValueResource"][];
+            company?: components["schemas"]["CompanyResource"];
+            currency?: components["schemas"]["CurrencyResource"];
+            payment_method?: components["schemas"]["PaymentMethodResource"];
+        }>>;
     };
     get estimates(): {
-        list: (query?: RequestOptions["query"]) => Promise<unknown>;
-        get: (id: number | string) => Promise<unknown>;
-        create: (body: unknown, options?: WriteOptions) => Promise<unknown>;
+        list: (query?: RequestOptions["query"]) => Promise<{
+            data: components["schemas"]["EstimateResource"][];
+            meta: {
+                estimate_total_count: number;
+            };
+        }>;
+        get: (id: number | string) => Promise<{
+            data: components["schemas"]["EstimateResource"];
+        }>;
+        create: (body: EstimatesRequest, options?: WriteOptions) => Promise<{
+            data: components["schemas"]["EstimateResource"];
+        }>;
+        /**
+         * Convierte un presupuesto aceptado en factura.
+         *
+         * El helper existe porque es el cierre natural del bucle
+         * `estimate.accepted` → facturar, y sin él hay que ir por ruta cruda y
+         * adivinar la forma de la respuesta.
+         *
+         * Dos cosas que conviene saber y que el spec no dice:
+         *
+         *  - **la factura nace BORRADOR y sin numerar**: `data.invoice_number` es
+         *    `null` hasta que la publiques cambiando su estado. No es un fallo;
+         *  - el id de la factura nueva está en `data.id`. El `r?.data?.id ?? r?.id`
+         *    defensivo que se ve por ahí sobra: la segunda rama nunca ocurre.
+         *
+         * Manda `idempotencyKey` —una clave estable por presupuesto, del estilo
+         * `estimate:{id}:invoice`— y el reintento tras un timeout no te creará
+         * una segunda factura.
+         *
+         * Exige `estimates:write` **e** `invoices:write`.
+         */
+        convertToInvoice: (id: number | string, options?: WriteOptions) => Promise<ResourceEnvelope<{
+            id: string;
+            invoice_date: string;
+            due_date: string;
+            invoice_number: string;
+            reference_number: string;
+            status: string;
+            paid_status: string;
+            tax_per_item: string;
+            tax_included: string;
+            discount_per_item: string;
+            notes: string;
+            discount_type: string;
+            discount: string;
+            discount_val: string;
+            sub_total: string;
+            total: string;
+            effective_total: string;
+            tax: string;
+            due_amount: string;
+            effective_due_amount: string;
+            sent: string;
+            viewed: string;
+            unique_hash: string;
+            template_name: string;
+            invoice_series_id: string;
+            customer_id: string;
+            external_ref: string | null;
+            payment_method_id: string;
+            recurring_invoice_id: string;
+            sequence_number: string;
+            exchange_rate: string;
+            base_discount_val: string;
+            base_sub_total: string;
+            base_total: string;
+            creator_id: string;
+            base_tax: string;
+            base_due_amount: string;
+            effective_base_total: string;
+            effective_base_due_amount: string;
+            credited_total: string;
+            credited_base_total: string;
+            currency_id: string;
+            formatted_created_at: string;
+            invoice_pdf_url: string;
+            formatted_invoice_date: string;
+            formatted_due_date: string;
+            allow_edit: string;
+            payment_module_enabled: string;
+            sales_tax_type: string;
+            sales_tax_address_type: string;
+            overdue: string;
+            effective_paid_status: string;
+            effective_overdue: string;
+            aeat_status: string;
+            qr_data: string;
+            hash: string;
+            aeat_csv: string;
+            is_credit_note: string | boolean;
+            rectified_invoice_id: string;
+            rectified_invoice_number?: string | null;
+            rectified_invoice?: {
+                id: string;
+                invoice_number: string;
+                tax_per_item: string;
+                tax_included: string;
+                sub_total: string;
+                discount_val: string;
+                tax: string;
+                total: string;
+                items: components["schemas"]["InvoiceItemResource"][];
+                taxes: components["schemas"]["TaxResource"][];
+            };
+            credit_notes_count: number;
+            items?: components["schemas"]["InvoiceItemResource"][];
+            payments?: components["schemas"]["PaymentResource"][];
+            customer?: components["schemas"]["CustomerResource"];
+            invoice_series?: components["schemas"]["InvoiceSeriesResource"];
+            payment_method?: components["schemas"]["PaymentMethodResource"];
+            creator?: components["schemas"]["UserResource"];
+            taxes: components["schemas"]["TaxResource"][];
+            fields?: components["schemas"]["CustomFieldValueResource"][];
+            company?: components["schemas"]["CompanyResource"];
+            currency?: components["schemas"]["CurrencyResource"];
+        }>>;
     };
     get<T = unknown>(path: string, query?: RequestOptions['query']): Promise<T>;
     post<T = unknown>(path: string, body?: unknown, options?: WriteOptions): Promise<T>;
@@ -149,3 +523,4 @@ export declare class PimiaClient {
     private captureRateLimit;
     private retryDelay;
 }
+export {};

package/dist/client.js

@@ -46,7 +46,12 @@ export class PimiaClient {
         return {
             list: (query) => this.get('/invoices', query),
             get: (id) => this.get(`/invoices/${id}`),
+            /**
+             * Devuelve `{ data: InvoiceResource }`. El tipo NO sale del spec: el
+             * `200` de `invoices.store` está vacío ahí (ver {@link ResourceEnvelope}).
+             */
             create: (body, options) => this.post('/invoices', body, options),
+            /** Mismo caso que `create`: el `200` de `invoices.update` no está tipado en el spec. */
             update: (id, body, options) => this.put(`/invoices/${id}`, body, options),
         };
     }
@@ -55,6 +60,7 @@ export class PimiaClient {
             list: (query) => this.get('/customers', query),
             get: (id) => this.get(`/customers/${id}`),
             create: (body, options) => this.post('/customers', body, options),
+            /** El `200` de `customers.update` no está tipado en el spec. */
             update: (id, body, options) => this.put(`/customers/${id}`, body, options),
         };
     }
@@ -63,6 +69,27 @@ export class PimiaClient {
             list: (query) => this.get('/estimates', query),
             get: (id) => this.get(`/estimates/${id}`),
             create: (body, options) => this.post('/estimates', body, options),
+            /**
+             * Convierte un presupuesto aceptado en factura.
+             *
+             * El helper existe porque es el cierre natural del bucle
+             * `estimate.accepted` → facturar, y sin él hay que ir por ruta cruda y
+             * adivinar la forma de la respuesta.
+             *
+             * Dos cosas que conviene saber y que el spec no dice:
+             *
+             *  - **la factura nace BORRADOR y sin numerar**: `data.invoice_number` es
+             *    `null` hasta que la publiques cambiando su estado. No es un fallo;
+             *  - el id de la factura nueva está en `data.id`. El `r?.data?.id ?? r?.id`
+             *    defensivo que se ve por ahí sobra: la segunda rama nunca ocurre.
+             *
+             * Manda `idempotencyKey` —una clave estable por presupuesto, del estilo
+             * `estimate:{id}:invoice`— y el reintento tras un timeout no te creará
+             * una segunda factura.
+             *
+             * Exige `estimates:write` **e** `invoices:write`.
+             */
+            convertToInvoice: (id, options) => this.post(`/estimates/${id}/convert-to-invoice`, {}, options),
         };
     }
     get(path, query) {

package/dist/errors.d.ts

@@ -38,6 +38,49 @@ export declare class NotFoundError extends PimiaApiError {
 export declare class ValidationError extends PimiaApiError {
     get errors(): Record<string, string[]>;
 }
+/**
+ * 422 `external_ref_already_used`: la referencia externa que intentaste colgar
+ * ya la lleva otro recurso del mismo tipo dentro de tu namespace (company +
+ * client OAuth).
+ *
+ * **Lo normal es que no sea un error tuyo, sino tu reintento**: «crea el cliente
+ * del deal 42» ejecutado dos veces porque el proceso se cayó entre el POST y el
+ * guardado de tu mapeo. Por eso el error trae {@link existingId}, el recurso que
+ * ya lleva esa referencia — que es lo que convierte el choque en un
+ * find-or-create sin mantener ningún mapeo local:
+ *
+ * ```ts
+ * async function clienteDelDeal(dealId: string, name: string): Promise<number> {
+ *   try {
+ *     const { id } = await crearCliente({ name, external_ref: `deal_${dealId}` })
+ *     return id
+ *   } catch (error) {
+ *     // Ya existía: el propio error dice cuál es.
+ *     if (error instanceof DuplicateExternalRefError) return error.existingId
+ *     throw error
+ *   }
+ * }
+ * ```
+ *
+ * Hereda de {@link ValidationError} a propósito: el cuerpo trae también el
+ * `errors` de siempre, así que el código que ya trataba los 422 por ese camino
+ * sigue funcionando sin ramas nuevas.
+ */
+export declare class DuplicateExternalRefError extends ValidationError {
+    /** Id del recurso que YA lleva esa referencia. Tu find-or-create acaba aquí. */
+    readonly existingId: number;
+    /** La referencia que chocó, tal y como la mandaste. */
+    readonly externalRef: string;
+    /** Tipo del recurso en el core (`customer`, `estimate`, `invoice`). */
+    readonly entityType: string;
+    constructor(
+    /** Id del recurso que YA lleva esa referencia. Tu find-or-create acaba aquí. */
+    existingId: number, 
+    /** La referencia que chocó, tal y como la mandaste. */
+    externalRef: string, 
+    /** Tipo del recurso en el core (`customer`, `estimate`, `invoice`). */
+    entityType: string, status: number, message: string, body: unknown, requestId?: string);
+}
 /** 429: pasado el rate limit. `retryAfter` en segundos si la API lo dijo. */
 export declare class RateLimitError extends PimiaApiError {
     readonly retryAfter: number | undefined;

package/dist/errors.js

@@ -30,8 +30,13 @@ export class PimiaApiError extends PimiaError {
                 return new MissingScopeError(scope, status, message, body, requestId);
             return new ForbiddenError(status, message, body, requestId);
         }
-        if (status === 422)
+        if (status === 422) {
+            const duplicate = duplicateExternalRefFrom(body);
+            if (duplicate) {
+                return new DuplicateExternalRefError(duplicate.existingId, duplicate.externalRef, duplicate.entityType, status, message, body, requestId);
+            }
             return new ValidationError(status, message, body, requestId);
+        }
         if (status === 404)
             return new NotFoundError(status, message, body, requestId);
         return new PimiaApiError(status, message, body, requestId);
@@ -67,6 +72,51 @@ export class ValidationError extends PimiaApiError {
         return body?.errors ?? {};
     }
 }
+/**
+ * 422 `external_ref_already_used`: la referencia externa que intentaste colgar
+ * ya la lleva otro recurso del mismo tipo dentro de tu namespace (company +
+ * client OAuth).
+ *
+ * **Lo normal es que no sea un error tuyo, sino tu reintento**: «crea el cliente
+ * del deal 42» ejecutado dos veces porque el proceso se cayó entre el POST y el
+ * guardado de tu mapeo. Por eso el error trae {@link existingId}, el recurso que
+ * ya lleva esa referencia — que es lo que convierte el choque en un
+ * find-or-create sin mantener ningún mapeo local:
+ *
+ * ```ts
+ * async function clienteDelDeal(dealId: string, name: string): Promise<number> {
+ *   try {
+ *     const { id } = await crearCliente({ name, external_ref: `deal_${dealId}` })
+ *     return id
+ *   } catch (error) {
+ *     // Ya existía: el propio error dice cuál es.
+ *     if (error instanceof DuplicateExternalRefError) return error.existingId
+ *     throw error
+ *   }
+ * }
+ * ```
+ *
+ * Hereda de {@link ValidationError} a propósito: el cuerpo trae también el
+ * `errors` de siempre, así que el código que ya trataba los 422 por ese camino
+ * sigue funcionando sin ramas nuevas.
+ */
+export class DuplicateExternalRefError extends ValidationError {
+    existingId;
+    externalRef;
+    entityType;
+    constructor(
+    /** Id del recurso que YA lleva esa referencia. Tu find-or-create acaba aquí. */
+    existingId, 
+    /** La referencia que chocó, tal y como la mandaste. */
+    externalRef, 
+    /** Tipo del recurso en el core (`customer`, `estimate`, `invoice`). */
+    entityType, status, message, body, requestId) {
+        super(status, message, body, requestId);
+        this.existingId = existingId;
+        this.externalRef = externalRef;
+        this.entityType = entityType;
+    }
+}
 /** 429: pasado el rate limit. `retryAfter` en segundos si la API lo dijo. */
 export class RateLimitError extends PimiaApiError {
     retryAfter;
@@ -103,6 +153,36 @@ function messageFrom(body) {
     }
     return undefined;
 }
+/**
+ * Reconoce el 422 de referencia duplicada por su campo `error`, no por la prosa
+ * del mensaje —que está en castellano y puede cambiar—. Sin `existing_id` usable
+ * no se promueve el error: sin ese id no hay find-or-create que hacer, y un
+ * {@link ValidationError} normal describe mejor lo que pasó.
+ */
+function duplicateExternalRefFrom(body) {
+    if (!body || typeof body !== 'object')
+        return undefined;
+    const record = body;
+    if (record.error !== 'external_ref_already_used')
+        return undefined;
+    // El core lo manda como entero; se normaliza igualmente porque en este
+    // contrato hay enteros que llegan como cadena según el driver. Ojo con
+    // `Number(null)`, que es 0 y no NaN: sin descartar antes los no-numéricos, un
+    // `existing_id: null` se colaría como el id 0.
+    const raw = record.existing_id;
+    const existingId = typeof raw === 'number'
+        ? raw
+        : typeof raw === 'string' && raw.trim() !== ''
+            ? Number(raw)
+            : Number.NaN;
+    if (!Number.isInteger(existingId))
+        return undefined;
+    return {
+        existingId,
+        externalRef: typeof record.external_ref === 'string' ? record.external_ref : '',
+        entityType: typeof record.entity_type === 'string' ? record.entity_type : '',
+    };
+}
 /** «Token lacks the invoices:write scope» → `invoices:write`. */
 function scopeFrom(message) {
     return /Token lacks the (\S+) scope/.exec(message)?.[1];

package/dist/index.d.ts

@@ -6,12 +6,14 @@
  * salen los tipos de `./api`.
  */
 export { PimiaClient } from './client.js';
-export type { PimiaClientOptions, RateLimit, RequestOptions, ResponseMeta, ResponseWithMeta, WriteOptions, } from './client.js';
+export type { CustomerRequest, CustomerResource, EstimateResource, EstimatesRequest, InvoiceResource, InvoicesRequest, PimiaClientOptions, RateLimit, RequestOptions, ResourceEnvelope, ResponseMeta, ResponseWithMeta, WriteOptions, } from './client.js';
 export { OAuth, createPkceChallenge, createState } from './oauth.js';
 export type { AuthorizationServerMetadata, AuthorizeUrlOptions, OAuthConfig, PkceChallenge, } from './oauth.js';
 export { MemoryTokenStore, isExpired, tokenSetFromResponse } from './tokens.js';
 export type { TokenSet, TokenStore } from './tokens.js';
-export { ForbiddenError, MissingScopeError, NotAuthenticatedError, NotFoundError, OAuthError, PimiaApiError, PimiaError, RateLimitError, UnauthorizedError, ValidationError, } from './errors.js';
+export { DuplicateExternalRefError, ForbiddenError, MissingScopeError, NotAuthenticatedError, NotFoundError, OAuthError, PimiaApiError, PimiaError, RateLimitError, UnauthorizedError, ValidationError, } from './errors.js';
+export { WEBHOOK_DEFAULT_TOLERANCE_SECONDS, WEBHOOK_EVENTS, WEBHOOK_HEADERS, WEBHOOK_SIGNATURE_VERSION, WebhookVerificationError, isWebhookEvent, signWebhook, verifyWebhook, } from './webhooks.js';
+export type { ApprovalDecidedPayload, AppRevokedPayload, CustomerPayload, EstimateAcceptedPayload, ExternalRef, InvoiceCreatedPayload, InvoicePaidPayload, InvoiceReceivedPayload, IsoDateTime, KnownWebhook, PimiaWebhook, SignWebhookOptions, UnknownWebhook, VerifyWebhookOptions, WebhookBodyInput, WebhookEvent, WebhookHeadersInput, WebhookPayloads, WebhookVerificationReason, } from './webhooks.js';
 /** Scopes granulares del catálogo de Pimia (paso 4). Pide siempre lo mínimo. */
 export declare const SCOPES: {
     readonly invoicesRead: "invoices:read";

package/dist/index.js

@@ -8,7 +8,8 @@
 export { PimiaClient } from './client.js';
 export { OAuth, createPkceChallenge, createState } from './oauth.js';
 export { MemoryTokenStore, isExpired, tokenSetFromResponse } from './tokens.js';
-export { ForbiddenError, MissingScopeError, NotAuthenticatedError, NotFoundError, OAuthError, PimiaApiError, PimiaError, RateLimitError, UnauthorizedError, ValidationError, } from './errors.js';
+export { DuplicateExternalRefError, ForbiddenError, MissingScopeError, NotAuthenticatedError, NotFoundError, OAuthError, PimiaApiError, PimiaError, RateLimitError, UnauthorizedError, ValidationError, } from './errors.js';
+export { WEBHOOK_DEFAULT_TOLERANCE_SECONDS, WEBHOOK_EVENTS, WEBHOOK_HEADERS, WEBHOOK_SIGNATURE_VERSION, WebhookVerificationError, isWebhookEvent, signWebhook, verifyWebhook, } from './webhooks.js';
 /** Scopes granulares del catálogo de Pimia (paso 4). Pide siempre lo mínimo. */
 export const SCOPES = {
     invoicesRead: 'invoices:read',