@veriko-mx/sdk 0.4.3

package/dist/esm/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * SDK oficial de Veriko para JavaScript y TypeScript.
+ *
+ * Veriko valida transferencias SPEI mexicanas contra el CEP (Comprobante
+ * Electrónico de Pago) que emite el Banco de México, y devuelve un veredicto.
+ *
+ * ```ts
+ * import { Veriko, hasCep } from '@veriko-mx/sdk';
+ *
+ * const client = new Veriko(); // lee VERIKO_API_KEY del entorno
+ *
+ * const validation = await client.validateTransfer({
+ *   fecha: '2025-03-15',
+ *   monto: 15000.5,
+ *   claveRastreo: 'MXBA20250315001234',
+ *   cuentaBeneficiaria: '012180004412345678',
+ * });
+ *
+ * if (hasCep(validation)) {
+ *   const cep = await client.getCep(validation.id, { format: 'pdf' });
+ *   await writeFile(cep.filename, cep.content);
+ * }
+ * ```
+ *
+ * Documentación de la API: https://docs.veriko.mx
+ */
+export { API_KEY_ENV_VAR, BASE_URL_ENV_VAR, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, VERSION, Veriko, type VerikoOptions, } from './client.js';
+export { ApiError, AuthenticationError, ConfigurationError, ConflictError, ConnectionError, ForbiddenError, InvalidRequestError, NotFoundError, RateLimitError, ServerError, SignatureVerificationError, TimeoutError, VerikoError, type ApiErrorEntry, } from './errors.js';
+export { Account, Beneficiaries, Billing, Catalog, Dashboard, Finance, Insights, Plans, Usage, Validations, Webhooks, } from './resources.js';
+export { type IterOptions, type Page } from './pagination.js';
+export { DEFAULT_RETRY, RETRYABLE_STATUSES, Transport, parseRetryAfter, type RetryConfig, } from './http.js';
+export { CEP_FORMATS, EXPORT_FORMATS, IMPORT_TEMPLATE_FORMATS, IMPORT_TERMINAL_STATUSES, RETRYABLE_OUTCOMES, TERMINAL_STATUSES, WEBHOOK_EVENTS, hasCep, isImportSettled, isImportTerminal, isSettled, isTerminal, type ApiUsage, type BillingSubscription, type Bank, type BankList, type BanksOptions, type BanxicoMetric, type BanxicoStatus, type BanxicoTimeseries, type BanxicoWindow, type Beneficiary, type BeneficiaryAccountType, type BeneficiaryImportCommitted, type BeneficiaryImportJob, type BeneficiaryImportRow, type BeneficiaryImportStarted, type BeneficiaryLookup, type BinLookup, type CepDocument, type CepFormat, type CreateBeneficiaryParams, type CreateWebhookParams, type DeliveriesParams, type DeliveryEventType, type DeliveryStatus, type DashboardSummary, type DashboardSummaryParams, type DownloadedFile, type EditImportRowParams, type ErrorObject, type ExportBeneficiariesParams, type ExportDeliveriesParams, type ExportFormat, type ExportUsageParams, type ExportValidationsParams, type FinanceAccountingParams, type FinanceCepsParams, type FinanceDecimal, type FinanceParams, type FinancePreview, type FinancePreviewFormat, type FinancePreviewParams, type FinanceStatementFormat, type FinanceStatementParams, type FinanceSummary, type GetValidationOptions, type IdempotentOptions, type ImportParseMode, type ImportPreviewParams, type ImportRowBucket, type ImportStartOptions, type ImportTemplateFormat, type ImportTemplateOptions, type InsightsOverview, type InsightsTopBanks, type UserInsightsTopBanksParams, type InsightsTopBeneficiaries, type UserInsightsTopBeneficiariesParams, type InsightsTrends, type ListBeneficiariesParams, type ListValidationsParams, type OcrValidationRequest, type QueuedValidation, type RetryAttempt, type RetryPolicy, type RetryState, type RetryStateFilter, type RetryStateResource, type PublicPlanComparison, type PublicPlans, type TelegramDispatch, type TimeseriesParams, type UpdateBeneficiaryParams, type UpdateWebhookParams, type UserInsightsTrendsParams, type UserProfile, type UserRetryPolicy, type UsageBreakdown, type UsageBreakdownParams, type UsageHeatmap, type UsageHeatmapParams, type UsageHistory, type UsageHistoryParams, type UsageLimits, type UsageSummary, type ValidateOcrParams, type ValidateTransferParams, type Validation, type ValidationAttributes, type ValidationFilters, type ValidationQueuedResource, type ValidationRequest, type ValidationStats, type ValidationStatus, type ValidationSummary, type ValidationType, type ValidationWithEtag, type WaitForOptions, type WebhookDelivery, type WebhookEndpoint, type WebhookEvent, type WebhookEventName, type WebhookStatus, type WebhookSubscriptionEvent, type WebhookTestResult, } from './types.js';
+export { DELIVERY_ID_HEADER, EVENT_HEADER, SIGNATURE_HEADER, TIMESTAMP_HEADER, computeSignature, parseWebhook, signatureFromHeaders, verifyWebhook, } from './webhooks.js';
+export type { components, operations, paths } from './generated/openapi.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -0,0 +1,33 @@
+/**
+ * SDK oficial de Veriko para JavaScript y TypeScript.
+ *
+ * Veriko valida transferencias SPEI mexicanas contra el CEP (Comprobante
+ * Electrónico de Pago) que emite el Banco de México, y devuelve un veredicto.
+ *
+ * ```ts
+ * import { Veriko, hasCep } from '@veriko-mx/sdk';
+ *
+ * const client = new Veriko(); // lee VERIKO_API_KEY del entorno
+ *
+ * const validation = await client.validateTransfer({
+ *   fecha: '2025-03-15',
+ *   monto: 15000.5,
+ *   claveRastreo: 'MXBA20250315001234',
+ *   cuentaBeneficiaria: '012180004412345678',
+ * });
+ *
+ * if (hasCep(validation)) {
+ *   const cep = await client.getCep(validation.id, { format: 'pdf' });
+ *   await writeFile(cep.filename, cep.content);
+ * }
+ * ```
+ *
+ * Documentación de la API: https://docs.veriko.mx
+ */
+export { API_KEY_ENV_VAR, BASE_URL_ENV_VAR, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, VERSION, Veriko, } from './client.js';
+export { ApiError, AuthenticationError, ConfigurationError, ConflictError, ConnectionError, ForbiddenError, InvalidRequestError, NotFoundError, RateLimitError, ServerError, SignatureVerificationError, TimeoutError, VerikoError, } from './errors.js';
+export { Account, Beneficiaries, Billing, Catalog, Dashboard, Finance, Insights, Plans, Usage, Validations, Webhooks, } from './resources.js';
+export { DEFAULT_RETRY, RETRYABLE_STATUSES, Transport, parseRetryAfter, } from './http.js';
+export { CEP_FORMATS, EXPORT_FORMATS, IMPORT_TEMPLATE_FORMATS, IMPORT_TERMINAL_STATUSES, RETRYABLE_OUTCOMES, TERMINAL_STATUSES, WEBHOOK_EVENTS, hasCep, isImportSettled, isImportTerminal, isSettled, isTerminal, } from './types.js';
+export { DELIVERY_ID_HEADER, EVENT_HEADER, SIGNATURE_HEADER, TIMESTAMP_HEADER, computeSignature, parseWebhook, signatureFromHeaders, verifyWebhook, } from './webhooks.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,OAAO,EACP,MAAM,GAEP,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,WAAW,EACX,0BAA0B,EAC1B,YAAY,EACZ,WAAW,GAEZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,OAAO,EACP,aAAa,EACb,OAAO,EACP,OAAO,EACP,SAAS,EACT,OAAO,EACP,QAAQ,EACR,KAAK,EACL,KAAK,EACL,WAAW,EACX,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,eAAe,GAEhB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,MAAM,EACN,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,UAAU,GAyGX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,aAAa,GACd,MAAM,eAAe,CAAC"}

package/dist/esm/internal.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Ayudantes compartidos por el cliente y las familias de operaciones.
+ *
+ * Nada de aquí se reexporta desde `index.ts`.
+ */
+import type { RawResponse } from './http.js';
+/**
+ * Una clave por llamada, estable entre los reintentos de esa misma llamada.
+ *
+ * Reintentar un `POST` sin clave de idempotencia puede duplicar la validación,
+ * y su cargo, cuando la respuesta se perdió pero la petición llegó. Con clave,
+ * el reintento devuelve la respuesta original.
+ *
+ * Esta clave no sobrevive al proceso que la generó. La que protege un reenvío
+ * posterior es la que se pasa en `idempotencyKey`.
+ */
+export declare function newIdempotencyKey(): string;
+/** Un identificador no puede venir vacío ni traer barras, signos de consulta o almohadillas. */
+export declare function checkedId(value: string): string;
+/** El identificador numérico de un recurso, que la API acepta como número o como cadena. */
+export type EntityId = string | number;
+/** Un identificador ya validado, listo para ir en la ruta. */
+export declare function pathSegment(value: string): string;
+/** Los filtros de una consulta: lo que no se pasa no viaja. */
+export type Query = Record<string, string | number | readonly string[] | undefined>;
+/** Une una lista de valores con comas, que es como la API recibe varios estados. */
+export declare function joinList(value: string | readonly string[] | undefined): string | undefined;
+/** Lee el cuerpo de una respuesta JSON:API como un objeto. */
+export declare function readDocument(response: RawResponse): Record<string, unknown>;
+/**
+ * El recurso `data` de una respuesta. `what` completa el mensaje si falta.
+ *
+ * El tipo lo fija quien llama: es el cast del JSON ya leído al tipo del spec.
+ */
+export declare function readData<T>(response: RawResponse, what: string): T;
+/** La lista `data` de una colección. */
+export declare function readList<T>(response: RawResponse, what: string): T[];
+/** `meta` de una respuesta, o un objeto vacío cuando no viene. */
+export declare function readMeta(document: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=internal.d.ts.map

package/dist/esm/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED,4FAA4F;AAC5F,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,+DAA+D;AAC/D,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAEpF,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG1F;AAMD,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW3E;AAED;;;;GAIG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAMlE;AAED,wCAAwC;AACxC,wBAAgB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,CAMpE;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnF"}

package/dist/esm/internal.js

@@ -0,0 +1,82 @@
+/**
+ * Ayudantes compartidos por el cliente y las familias de operaciones.
+ *
+ * Nada de aquí se reexporta desde `index.ts`.
+ */
+import { randomUUID } from 'node:crypto';
+import { ApiError, ConfigurationError } from './errors.js';
+/**
+ * Una clave por llamada, estable entre los reintentos de esa misma llamada.
+ *
+ * Reintentar un `POST` sin clave de idempotencia puede duplicar la validación,
+ * y su cargo, cuando la respuesta se perdió pero la petición llegó. Con clave,
+ * el reintento devuelve la respuesta original.
+ *
+ * Esta clave no sobrevive al proceso que la generó. La que protege un reenvío
+ * posterior es la que se pasa en `idempotencyKey`.
+ */
+export function newIdempotencyKey() {
+    return `veriko-js-${randomUUID().replace(/-/g, '')}`;
+}
+/** Un identificador no puede venir vacío ni traer barras, signos de consulta o almohadillas. */
+export function checkedId(value) {
+    const cleaned = value.trim();
+    if (!cleaned || /[/?#]/.test(cleaned)) {
+        throw new ConfigurationError(`Identificador inservible: ${JSON.stringify(value)}`);
+    }
+    return cleaned;
+}
+/** Un identificador ya validado, listo para ir en la ruta. */
+export function pathSegment(value) {
+    return encodeURIComponent(checkedId(value));
+}
+/** Une una lista de valores con comas, que es como la API recibe varios estados. */
+export function joinList(value) {
+    if (value === undefined)
+        return undefined;
+    return typeof value === 'string' ? value : value.join(',');
+}
+function malformed(response, detail) {
+    return new ApiError(detail, { status: response.status, headers: response.headers });
+}
+/** Lee el cuerpo de una respuesta JSON:API como un objeto. */
+export function readDocument(response) {
+    let parsed;
+    try {
+        parsed = JSON.parse(new TextDecoder().decode(response.body));
+    }
+    catch {
+        parsed = undefined;
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw malformed(response, 'La respuesta no es un documento JSON');
+    }
+    return parsed;
+}
+/**
+ * El recurso `data` de una respuesta. `what` completa el mensaje si falta.
+ *
+ * El tipo lo fija quien llama: es el cast del JSON ya leído al tipo del spec.
+ */
+// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters
+export function readData(response, what) {
+    const data = readDocument(response)['data'];
+    if (data === undefined || data === null) {
+        throw malformed(response, `La respuesta no trae el recurso \`data\` ${what}`);
+    }
+    return data;
+}
+/** La lista `data` de una colección. */
+export function readList(response, what) {
+    const data = readDocument(response)['data'];
+    if (!Array.isArray(data)) {
+        throw malformed(response, `La respuesta no trae la lista \`data\` ${what}`);
+    }
+    return data;
+}
+/** `meta` de una respuesta, o un objeto vacío cuando no viene. */
+export function readMeta(document) {
+    const meta = document['meta'];
+    return meta && typeof meta === 'object' ? meta : {};
+}
+//# sourceMappingURL=internal.js.map

package/dist/esm/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAG3D;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,aAAa,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAKD,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,kBAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC;AAKD,oFAAoF;AACpF,MAAM,UAAU,QAAQ,CAAC,KAA6C;IACpE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,SAAS,CAAC,QAAqB,EAAE,MAAc;IACtD,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;AACtF,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAAC,QAAqB;IAChD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,SAAS,CAAC,QAAQ,EAAE,sCAAsC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,MAAiC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,6EAA6E;AAC7E,MAAM,UAAU,QAAQ,CAAI,QAAqB,EAAE,IAAY;IAC7D,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,SAAS,CAAC,QAAQ,EAAE,4CAA4C,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,IAAS,CAAC;AACnB,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,QAAQ,CAAI,QAAqB,EAAE,IAAY;IAC7D,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,SAAS,CAAC,QAAQ,EAAE,0CAA0C,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,IAAW,CAAC;AACrB,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,QAAiC;IACxD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnF,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/pagination.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Paginación: una página, y la forma de recorrerlas todas.
+ *
+ * Las colecciones de la API viajan con `meta.pagination`. El SDK devuelve una
+ * `Page` con los elementos y los contadores. Para recorrer una colección entera
+ * están los iteradores `iter*` de cada familia, que piden la página siguiente
+ * sólo cuando la anterior se agota.
+ *
+ * @see https://docs.veriko.mx/es/concepts/pagination
+ */
+import type { RawResponse } from './http.js';
+/** Una página de resultados, con los contadores que devolvió la API. */
+export interface Page<T> {
+    items: T[];
+    /** Número de esta página, empezando en 1. */
+    page: number;
+    perPage: number;
+    /** Elementos que casan con la consulta, sumando todas las páginas. */
+    total: number;
+    totalPages: number;
+    /** `true` cuando queda al menos una página por pedir. */
+    hasNext: boolean;
+}
+/** Opciones de los iteradores. */
+export interface IterOptions {
+    /** Cuántas páginas recorrer como máximo. Sin él, se recorren todas. */
+    maxPages?: number;
+}
+/** Convierte una respuesta de colección en una `Page`. */
+export declare function parsePage<T>(response: RawResponse): Page<T>;
+/**
+ * Recorre las páginas una a una y va entregando sus elementos.
+ *
+ * Pide la siguiente sólo cuando la anterior se agotó, de modo que un consumidor
+ * que corta a la mitad no gasta peticiones de más.
+ */
+export declare function iteratePages<T>(fetchPage: (page: number) => Promise<Page<T>>, options?: {
+    startPage?: number;
+    maxPages?: number;
+}): AsyncGenerator<T, void, undefined>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/esm/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,wEAAwE;AACxE,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CA0B3D;AAED;;;;;GAKG;AACH,wBAAuB,YAAY,CAAC,CAAC,EACnC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAC7C,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAWpC"}

package/dist/esm/pagination.js

@@ -0,0 +1,62 @@
+/**
+ * Paginación: una página, y la forma de recorrerlas todas.
+ *
+ * Las colecciones de la API viajan con `meta.pagination`. El SDK devuelve una
+ * `Page` con los elementos y los contadores. Para recorrer una colección entera
+ * están los iteradores `iter*` de cada familia, que piden la página siguiente
+ * sólo cuando la anterior se agota.
+ *
+ * @see https://docs.veriko.mx/es/concepts/pagination
+ */
+import { ApiError } from './errors.js';
+import { readDocument, readMeta } from './internal.js';
+function count(value, fallback) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+}
+/** Convierte una respuesta de colección en una `Page`. */
+export function parsePage(response) {
+    const document = readDocument(response);
+    const data = document['data'];
+    if (!Array.isArray(data)) {
+        throw new ApiError('La respuesta no trae la lista `data`', {
+            status: response.status,
+            headers: response.headers,
+        });
+    }
+    const items = data;
+    const rawPagination = readMeta(document)['pagination'];
+    const pagination = rawPagination && typeof rawPagination === 'object'
+        ? rawPagination
+        : {};
+    const page = count(pagination['page'], 1);
+    const totalPages = count(pagination['total_pages'], 1);
+    return {
+        items,
+        page,
+        perPage: count(pagination['per_page'], items.length),
+        total: count(pagination['total'], items.length),
+        totalPages,
+        hasNext: page < totalPages,
+    };
+}
+/**
+ * Recorre las páginas una a una y va entregando sus elementos.
+ *
+ * Pide la siguiente sólo cuando la anterior se agotó, de modo que un consumidor
+ * que corta a la mitad no gasta peticiones de más.
+ */
+export async function* iteratePages(fetchPage, options = {}) {
+    let current = options.startPage ?? 1;
+    let pagesRead = 0;
+    for (;;) {
+        const page = await fetchPage(current);
+        yield* page.items;
+        pagesRead += 1;
+        if (options.maxPages !== undefined && pagesRead >= options.maxPages)
+            return;
+        if (!page.hasNext || page.items.length === 0)
+            return;
+        current += 1;
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/esm/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAqBvD,SAAS,KAAK,CAAC,KAAc,EAAE,QAAgB;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChF,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,SAAS,CAAI,QAAqB;IAChD,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,QAAQ,CAAC,sCAAsC,EAAE;YACzD,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,IAAW,CAAC;IAC1B,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,UAAU,GACd,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ;QAChD,CAAC,CAAE,aAAyC;QAC5C,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;IACvD,OAAO;QACL,KAAK;QACL,IAAI;QACJ,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC;QACpD,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC;QAC/C,UAAU;QACV,OAAO,EAAE,IAAI,GAAG,UAAU;KAC3B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,YAAY,CACjC,SAA6C,EAC7C,UAAqD,EAAE;IAEvD,IAAI,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACrC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QACtC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QAClB,SAAS,IAAI,CAAC,CAAC;QACf,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,SAAS,IAAI,OAAO,CAAC,QAAQ;YAAE,OAAO;QAC5E,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACrD,OAAO,IAAI,CAAC,CAAC;IACf,CAAC;AACH,CAAC"}