@facturino/node 1.0.0

package/dist/cjs/resources/creditNotes.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditNotes = void 0;
+const pagination_js_1 = require("../pagination.js");
+/** Credit note operations — the legal way to correct or cancel a finalized invoice. */
+class CreditNotes {
+    constructor(client) {
+        this.client = client;
+    }
+    async create(params, options) {
+        return this.client.post('/v1/credit-notes', params, options);
+    }
+    list(params) {
+        return new pagination_js_1.AutoPaginatingList(this.client, '/v1/credit-notes', params);
+    }
+    async get(id) {
+        return this.client.get(`/v1/credit-notes/${id}`);
+    }
+    async update(id, params) {
+        return this.client.patch(`/v1/credit-notes/${id}`, params);
+    }
+    async del(id) {
+        await this.client.del(`/v1/credit-notes/${id}`);
+    }
+    /** Assign number and lock. Irreversible. */
+    async finalize(id, options) {
+        return this.client.post(`/v1/credit-notes/${id}/finalize`, undefined, options);
+    }
+    /** Submit to PA. */
+    async send(id, options) {
+        return this.client.post(`/v1/credit-notes/${id}/send`, undefined, options);
+    }
+    /**
+     * Send the credit note to its customer by email with the PDF (and optional
+     * Factur-X XML) attached. Returns `{status: 'sent'}` on success or
+     * `{status: 'pending'}` if the PDF is still being generated.
+     */
+    async email(id, params, options) {
+        return this.client.post(`/v1/credit-notes/${id}/email`, params, options);
+    }
+    /**
+     * Record the disbursement of a finalized credit note back to the customer.
+     * Writes a negative `refund` payment on the linked invoice (mirrors the app).
+     * `amount` is in integer centimes and defaults to the full credit-note total.
+     */
+    async refund(id, params, options) {
+        return this.client.post(`/v1/credit-notes/${id}/refund`, params, options);
+    }
+    async getPdf(id) {
+        return this.client.get(`/v1/credit-notes/${id}/pdf`);
+    }
+    /** Factur-X PDF/A-3 with embedded XML. URL or async job. */
+    async getFacturx(id) {
+        return this.client.get(`/v1/credit-notes/${id}/facturx`);
+    }
+    /** Raw CII or UBL XML. */
+    async getXml(id, format) {
+        const query = format ? `?format=${format}` : '';
+        return this.client.get(`/v1/credit-notes/${id}/xml${query}`);
+    }
+}
+exports.CreditNotes = CreditNotes;

package/dist/cjs/resources/customers.d.ts

@@ -0,0 +1,17 @@
+import type { HttpClient } from '../client.js';
+import { AutoPaginatingList } from '../pagination.js';
+import type { Customer, CustomerCreateParams, CustomerUpdateParams, CustomerListParams, CustomerLookupParams, SireneLookupResponse, JobResponse, RequestOptions } from '../types.js';
+/** CRUD operations on customers, with SIRENE lookup and CSV import/export. */
+export declare class Customers {
+    private readonly client;
+    constructor(client: HttpClient);
+    create(params: CustomerCreateParams, options?: RequestOptions): Promise<Customer>;
+    list(params?: CustomerListParams): AutoPaginatingList<Customer>;
+    get(id: string): Promise<Customer>;
+    update(id: string, params: CustomerUpdateParams): Promise<Customer>;
+    del(id: string): Promise<void>;
+    /** Sirene lookup by SIRET or name. */
+    lookup(params: CustomerLookupParams): Promise<SireneLookupResponse>;
+    importCsv(csv: string, options?: RequestOptions): Promise<JobResponse>;
+    exportCsv(): Promise<JobResponse>;
+}

package/dist/cjs/resources/customers.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Customers = void 0;
+const pagination_js_1 = require("../pagination.js");
+/** CRUD operations on customers, with SIRENE lookup and CSV import/export. */
+class Customers {
+    constructor(client) {
+        this.client = client;
+    }
+    async create(params, options) {
+        return this.client.post('/v1/customers', params, options);
+    }
+    list(params) {
+        return new pagination_js_1.AutoPaginatingList(this.client, '/v1/customers', params);
+    }
+    async get(id) {
+        return this.client.get(`/v1/customers/${id}`);
+    }
+    async update(id, params) {
+        return this.client.patch(`/v1/customers/${id}`, params);
+    }
+    async del(id) {
+        await this.client.del(`/v1/customers/${id}`);
+    }
+    /** Sirene lookup by SIRET or name. */
+    async lookup(params) {
+        return this.client.post('/v1/customers/lookup', params);
+    }
+    async importCsv(csv, options) {
+        return this.client.post('/v1/customers/import', { csv }, options);
+    }
+    async exportCsv() {
+        return this.client.get('/v1/customers/export');
+    }
+}
+exports.Customers = Customers;

package/dist/cjs/resources/ereporting.d.ts

@@ -0,0 +1,12 @@
+import type { HttpClient } from '../client.js';
+import { AutoPaginatingList } from '../pagination.js';
+import type { EReporting, EReportingCreateParams, EReportingListParams, RequestOptions } from '../types.js';
+/** E-reporting declarations for B2C and international transactions (art. 290 CGI). */
+export declare class EReportingResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    createDeclaration(params: EReportingCreateParams, options?: RequestOptions): Promise<EReporting>;
+    list(params?: EReportingListParams): AutoPaginatingList<EReporting>;
+    get(id: string): Promise<EReporting>;
+    submitDeclaration(id: string, options?: RequestOptions): Promise<EReporting>;
+}

package/dist/cjs/resources/ereporting.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EReportingResource = void 0;
+const pagination_js_1 = require("../pagination.js");
+/** E-reporting declarations for B2C and international transactions (art. 290 CGI). */
+class EReportingResource {
+    constructor(client) {
+        this.client = client;
+    }
+    async createDeclaration(params, options) {
+        return this.client.post('/v1/ereporting/declarations', params, options);
+    }
+    list(params) {
+        return new pagination_js_1.AutoPaginatingList(this.client, '/v1/ereporting/declarations', params);
+    }
+    async get(id) {
+        return this.client.get(`/v1/ereporting/declarations/${id}`);
+    }
+    async submitDeclaration(id, options) {
+        return this.client.post(`/v1/ereporting/declarations/${id}/submit`, undefined, options);
+    }
+}
+exports.EReportingResource = EReportingResource;

package/dist/cjs/resources/events.d.ts

@@ -0,0 +1,11 @@
+import type { HttpClient } from '../client.js';
+import { AutoPaginatingList } from '../pagination.js';
+import type { WebhookEvent, EventListParams } from '../types.js';
+/** Webhook event log — list, inspect, and retry delivery of past events. */
+export declare class Events {
+    private readonly client;
+    constructor(client: HttpClient);
+    list(params?: EventListParams): AutoPaginatingList<WebhookEvent>;
+    get(id: string): Promise<WebhookEvent>;
+    retry(id: string): Promise<WebhookEvent>;
+}

package/dist/cjs/resources/events.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Events = void 0;
+const pagination_js_1 = require("../pagination.js");
+/** Webhook event log — list, inspect, and retry delivery of past events. */
+class Events {
+    constructor(client) {
+        this.client = client;
+    }
+    list(params) {
+        return new pagination_js_1.AutoPaginatingList(this.client, '/v1/events', params);
+    }
+    async get(id) {
+        return this.client.get(`/v1/events/${id}`);
+    }
+    async retry(id) {
+        return this.client.post(`/v1/events/${id}/retry`);
+    }
+}
+exports.Events = Events;

package/dist/cjs/resources/exports.d.ts

@@ -0,0 +1,20 @@
+import type { HttpClient } from '../client.js';
+import type { FecExportParams, InvoiceExportParams, JobResponse, RequestOptions } from '../types.js';
+/**
+ * Data exports — FEC accounting files and the invoices ZIP. For RGPD data
+ * portability (art. 20), use `account.requestExport`.
+ */
+export declare class Exports {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Async FEC generation (art. A.47 A-1 LPF). Pro/Cabinet plan. */
+    generateFec(params?: FecExportParams, options?: RequestOptions): Promise<JobResponse>;
+    getFecStatus(jobId: string): Promise<JobResponse>;
+    getExportStatus(jobId: string): Promise<JobResponse>;
+    /**
+     * Bulk export finalized invoices as a ZIP (Factur-X PDF + CII XML per invoice).
+     * Available on all plans. Optionally filter by issue-date period and/or
+     * lifecycle statuses; with no params, every non-draft invoice is exported.
+     */
+    exportInvoices(params?: InvoiceExportParams, options?: RequestOptions): Promise<JobResponse>;
+}

package/dist/cjs/resources/exports.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Exports = void 0;
+/**
+ * Data exports — FEC accounting files and the invoices ZIP. For RGPD data
+ * portability (art. 20), use `account.requestExport`.
+ */
+class Exports {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Async FEC generation (art. A.47 A-1 LPF). Pro/Cabinet plan. */
+    async generateFec(params, options) {
+        return this.client.post('/v1/exports/fec', params ?? {}, options);
+    }
+    async getFecStatus(jobId) {
+        return this.client.get(`/v1/exports/fec/${jobId}`);
+    }
+    async getExportStatus(jobId) {
+        return this.client.get(`/v1/exports/${jobId}`);
+    }
+    /**
+     * Bulk export finalized invoices as a ZIP (Factur-X PDF + CII XML per invoice).
+     * Available on all plans. Optionally filter by issue-date period and/or
+     * lifecycle statuses; with no params, every non-draft invoice is exported.
+     */
+    async exportInvoices(params, options) {
+        return this.client.post('/v1/exports/invoices', params ?? {}, options);
+    }
+}
+exports.Exports = Exports;

package/dist/cjs/resources/health.d.ts

@@ -0,0 +1,13 @@
+import type { HttpClient } from '../client.js';
+import type { HealthStatus } from '../types.js';
+/**
+ * Health — lightweight liveness probe for the Facturino API. Returns the
+ * service status and the API version; handy for uptime checks and to confirm
+ * an API key reaches the platform before running real traffic.
+ */
+export declare class Health {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Return the current service health snapshot (`GET /v1/health`). */
+    check(): Promise<HealthStatus>;
+}

package/dist/cjs/resources/health.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Health = void 0;
+/**
+ * Health — lightweight liveness probe for the Facturino API. Returns the
+ * service status and the API version; handy for uptime checks and to confirm
+ * an API key reaches the platform before running real traffic.
+ */
+class Health {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Return the current service health snapshot (`GET /v1/health`). */
+    async check() {
+        return this.client.get('/v1/health');
+    }
+}
+exports.Health = Health;

package/dist/cjs/resources/invoices.d.ts

@@ -0,0 +1,112 @@
+import type { HttpClient } from '../client.js';
+import { AutoPaginatingList } from '../pagination.js';
+import { Payments } from './payments.js';
+import type { Invoice, InvoiceCreateParams, InvoiceUpdateParams, InvoiceListParams, InvoiceRetrieveParams, InvoiceStatusResponse, InvoiceVerifyResponse, DocumentUrlResponse, JobResponse, PaymentLinkResponse, PaymentLinkCreateParams, PaymentTokenResponse, PaginatedResponse, LifecycleEntry, IncomingInvoiceCreateParams, ReceivedInvoice, RequestOptions } from '../types.js';
+/** Manages invoice lifecycle — creation, finalization, sending, and document retrieval. */
+export declare class Invoices {
+    private readonly client;
+    readonly payments: Payments;
+    constructor(client: HttpClient);
+    create(params: InvoiceCreateParams, options?: RequestOptions): Promise<Invoice>;
+    list(params?: InvoiceListParams): AutoPaginatingList<Invoice>;
+    /**
+     * Retrieve an invoice. Pass `expand` to inline related objects in the
+     * response under `invoice.expanded` — `customer`, `items.product`, and
+     * `credit_notes`. With `credit_notes`, the response also carries
+     * `expanded.net_balance` (TTC minus credited amounts, in integer cents).
+     */
+    get(id: string, params?: InvoiceRetrieveParams): Promise<Invoice>;
+    update(id: string, params: InvoiceUpdateParams): Promise<Invoice>;
+    /** Soft-delete (draft only). */
+    del(id: string): Promise<void>;
+    /** Assign number and lock. Irreversible. */
+    finalize(id: string, options?: RequestOptions): Promise<Invoice>;
+    /** Submit to PA. Returns 202 (async). */
+    send(id: string, options?: RequestOptions): Promise<{
+        id: string;
+        object: 'invoice';
+        status: string;
+    }>;
+    /**
+     * Send a finalized invoice by email with PDF (and optionally XML) attached.
+     * Returns `{status: 'sent'}` on success or `{status: 'pending'}` if the PDF
+     * is still being generated (caller should poll the returned `jobId`).
+     */
+    email(id: string, params?: {
+        recipientEmail?: string;
+        customMessage?: string;
+        includeXml?: boolean;
+        customSubject?: string;
+    }, options?: RequestOptions): Promise<{
+        status: 'sent';
+        invoiceId: string;
+        recipient: string;
+        sentAt: string;
+    } | {
+        status: 'pending';
+        invoiceId: string;
+        jobId: string;
+        pollUrl: string;
+        reason: string;
+    }>;
+    /**
+     * Cancel a DRAFT invoice (status `draft` only). This soft-deletes the
+     * draft and returns `{ id, object: 'invoice', deleted: true }`. Finalized
+     * invoices are immutable under French law (CGI art. 289) — use
+     * `creditNotes.create()` to refund or correct a finalized invoice.
+     *
+     * @throws {FacturinoError} when called on a non-draft invoice (API returns 400)
+     */
+    cancel(id: string, options?: RequestOptions): Promise<{
+        id: string;
+        object: 'invoice';
+        deleted: true;
+    }>;
+    remind(id: string, options?: RequestOptions): Promise<{
+        id: string;
+        object: 'invoice';
+        reminder_sent: boolean;
+    }>;
+    /** Clone as new draft. */
+    clone(id: string, options?: RequestOptions): Promise<Invoice>;
+    /** Signed download URL, or async job if generation needed. */
+    getPdf(id: string, template?: string): Promise<DocumentUrlResponse | JobResponse>;
+    /** Factur-X PDF/A-3 with embedded XML. URL or async job. */
+    getFacturx(id: string, template?: string): Promise<DocumentUrlResponse | JobResponse>;
+    /** Raw CII or UBL XML. */
+    getXml(id: string, format?: 'cii' | 'ubl'): Promise<string>;
+    getStatus(id: string): Promise<InvoiceStatusResponse>;
+    /** Verify archive hash chain integrity. */
+    verify(id: string): Promise<InvoiceVerifyResponse>;
+    listEvents(id: string): Promise<PaginatedResponse<LifecycleEntry>>;
+    getAuditTrail(id: string, params?: {
+        limit?: number;
+        starting_after?: string;
+        action?: string;
+    }): Promise<PaginatedResponse<Record<string, unknown>>>;
+    /** Async audit trail PDF generation. */
+    generateAuditTrailPdf(id: string, options?: RequestOptions): Promise<JobResponse>;
+    /** Stripe payment link (Pro plan). */
+    createPaymentLink(id: string, params?: PaymentLinkCreateParams, options?: RequestOptions): Promise<PaymentLinkResponse>;
+    /** Token for client-facing payment portal. */
+    createPaymentToken(id: string, options?: RequestOptions): Promise<PaymentTokenResponse>;
+    /**
+     * Generate a signed client-portal link for a finalized invoice. The
+     * URL points to a public, branded portal where the customer can view
+     * the invoice, download the PDF and trigger the payment flow. The
+     * token embedded in the URL grants read-only access to a single
+     * invoice and expires after the configured lifetime.
+     *
+     * Rejects with `invalid_status_transition` if the invoice is still
+     * in draft.
+     */
+    createPortalLink(id: string, options?: RequestOptions): Promise<{
+        url: string;
+        token: string;
+        expires_at: string;
+    }>;
+    /** Record a supplier invoice received outside the platform (manual entry). */
+    createIncoming(params: IncomingInvoiceCreateParams, options?: RequestOptions): Promise<ReceivedInvoice>;
+    /** List inbound supplier invoices (manual entries + e-invoices received via the PA). */
+    listIncoming(params?: InvoiceListParams): AutoPaginatingList<ReceivedInvoice>;
+}

package/dist/cjs/resources/invoices.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Invoices = void 0;
+const pagination_js_1 = require("../pagination.js");
+const payments_js_1 = require("./payments.js");
+/** Manages invoice lifecycle — creation, finalization, sending, and document retrieval. */
+class Invoices {
+    constructor(client) {
+        this.client = client;
+        this.payments = new payments_js_1.Payments(client);
+    }
+    async create(params, options) {
+        return this.client.post('/v1/invoices', params, options);
+    }
+    list(params) {
+        return new pagination_js_1.AutoPaginatingList(this.client, '/v1/invoices', params);
+    }
+    /**
+     * Retrieve an invoice. Pass `expand` to inline related objects in the
+     * response under `invoice.expanded` — `customer`, `items.product`, and
+     * `credit_notes`. With `credit_notes`, the response also carries
+     * `expanded.net_balance` (TTC minus credited amounts, in integer cents).
+     */
+    async get(id, params) {
+        const expand = params?.expand;
+        const query = expand && expand.length ? `?expand=${expand.map(encodeURIComponent).join(',')}` : '';
+        return this.client.get(`/v1/invoices/${id}${query}`);
+    }
+    async update(id, params) {
+        return this.client.patch(`/v1/invoices/${id}`, params);
+    }
+    /** Soft-delete (draft only). */
+    async del(id) {
+        await this.client.del(`/v1/invoices/${id}`);
+    }
+    /** Assign number and lock. Irreversible. */
+    async finalize(id, options) {
+        return this.client.post(`/v1/invoices/${id}/finalize`, undefined, options);
+    }
+    /** Submit to PA. Returns 202 (async). */
+    async send(id, options) {
+        return this.client.post(`/v1/invoices/${id}/send`, undefined, options);
+    }
+    /**
+     * Send a finalized invoice by email with PDF (and optionally XML) attached.
+     * Returns `{status: 'sent'}` on success or `{status: 'pending'}` if the PDF
+     * is still being generated (caller should poll the returned `jobId`).
+     */
+    async email(id, params, options) {
+        return this.client.post(`/v1/invoices/${id}/email`, params, options);
+    }
+    /**
+     * Cancel a DRAFT invoice (status `draft` only). This soft-deletes the
+     * draft and returns `{ id, object: 'invoice', deleted: true }`. Finalized
+     * invoices are immutable under French law (CGI art. 289) — use
+     * `creditNotes.create()` to refund or correct a finalized invoice.
+     *
+     * @throws {FacturinoError} when called on a non-draft invoice (API returns 400)
+     */
+    async cancel(id, options) {
+        return this.client.post(`/v1/invoices/${id}/cancel`, undefined, options);
+    }
+    async remind(id, options) {
+        return this.client.post(`/v1/invoices/${id}/remind`, undefined, options);
+    }
+    /** Clone as new draft. */
+    async clone(id, options) {
+        return this.client.post(`/v1/invoices/${id}/clone`, undefined, options);
+    }
+    /** Signed download URL, or async job if generation needed. */
+    async getPdf(id, template) {
+        const query = template ? `?template=${encodeURIComponent(template)}` : '';
+        return this.client.get(`/v1/invoices/${id}/pdf${query}`);
+    }
+    /** Factur-X PDF/A-3 with embedded XML. URL or async job. */
+    async getFacturx(id, template) {
+        const query = template ? `?template=${encodeURIComponent(template)}` : '';
+        return this.client.get(`/v1/invoices/${id}/facturx${query}`);
+    }
+    /** Raw CII or UBL XML. */
+    async getXml(id, format) {
+        const query = format ? `?format=${format}` : '';
+        return this.client.get(`/v1/invoices/${id}/xml${query}`);
+    }
+    async getStatus(id) {
+        return this.client.get(`/v1/invoices/${id}/status`);
+    }
+    /** Verify archive hash chain integrity. */
+    async verify(id) {
+        return this.client.get(`/v1/invoices/${id}/verify`);
+    }
+    async listEvents(id) {
+        return this.client.get(`/v1/invoices/${id}/events`);
+    }
+    async getAuditTrail(id, params) {
+        const queryParams = {};
+        if (params?.limit)
+            queryParams.limit = String(params.limit);
+        if (params?.starting_after)
+            queryParams.starting_after = params.starting_after;
+        if (params?.action)
+            queryParams.action = params.action;
+        const qs = new URLSearchParams(queryParams).toString();
+        const url = qs ? `/v1/invoices/${id}/audit-trail?${qs}` : `/v1/invoices/${id}/audit-trail`;
+        return this.client.get(url);
+    }
+    /** Async audit trail PDF generation. */
+    async generateAuditTrailPdf(id, options) {
+        return this.client.post(`/v1/invoices/${id}/audit-trail/pdf`, undefined, options);
+    }
+    /** Stripe payment link (Pro plan). */
+    async createPaymentLink(id, params, options) {
+        return this.client.post(`/v1/invoices/${id}/payment-link`, params, options);
+    }
+    /** Token for client-facing payment portal. */
+    async createPaymentToken(id, options) {
+        return this.client.post(`/v1/invoices/${id}/payment-token`, undefined, options);
+    }
+    /**
+     * Generate a signed client-portal link for a finalized invoice. The
+     * URL points to a public, branded portal where the customer can view
+     * the invoice, download the PDF and trigger the payment flow. The
+     * token embedded in the URL grants read-only access to a single
+     * invoice and expires after the configured lifetime.
+     *
+     * Rejects with `invalid_status_transition` if the invoice is still
+     * in draft.
+     */
+    async createPortalLink(id, options) {
+        return this.client.post(`/v1/invoices/${id}/portal-link`, undefined, options);
+    }
+    /** Record a supplier invoice received outside the platform (manual entry). */
+    async createIncoming(params, options) {
+        return this.client.post('/v1/invoices/incoming', params, options);
+    }
+    /** List inbound supplier invoices (manual entries + e-invoices received via the PA). */
+    listIncoming(params) {
+        return new pagination_js_1.AutoPaginatingList(this.client, '/v1/invoices/incoming', params);
+    }
+}
+exports.Invoices = Invoices;

package/dist/cjs/resources/jobs.d.ts

@@ -0,0 +1,10 @@
+import type { HttpClient } from '../client.js';
+import type { Job } from '../types.js';
+/** Track and poll async background jobs such as PDF generation or PA submission. */
+export declare class Jobs {
+    private readonly client;
+    constructor(client: HttpClient);
+    get(id: string): Promise<Job>;
+    /** Poll until completed or failed. */
+    poll(id: string, intervalMs?: number, maxAttempts?: number): Promise<Job>;
+}

package/dist/cjs/resources/jobs.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Jobs = void 0;
+/** Track and poll async background jobs such as PDF generation or PA submission. */
+class Jobs {
+    constructor(client) {
+        this.client = client;
+    }
+    async get(id) {
+        return this.client.get(`/v1/jobs/${id}`);
+    }
+    /** Poll until completed or failed. */
+    async poll(id, intervalMs = 2000, maxAttempts = 30) {
+        for (let i = 0; i < maxAttempts; i++) {
+            const job = await this.get(id);
+            if (job.status === 'completed' || job.status === 'failed') {
+                return job;
+            }
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        }
+        throw new Error(`Job ${id} did not complete within ${maxAttempts} polling attempts`);
+    }
+}
+exports.Jobs = Jobs;

package/dist/cjs/resources/payments.d.ts

@@ -0,0 +1,16 @@
+import type { HttpClient } from '../client.js';
+import { AutoPaginatingList } from '../pagination.js';
+import type { Payment, PaymentCreateParams, PaymentCancelResult, PaginationParams, RequestOptions } from '../types.js';
+/** Records payments against an invoice — accessed via `facturino.invoices.payments`. */
+export declare class Payments {
+    private readonly client;
+    constructor(client: HttpClient);
+    create(invoiceId: string, params: PaymentCreateParams, options?: RequestOptions): Promise<Payment>;
+    list(invoiceId: string, params?: PaginationParams): AutoPaginatingList<Payment>;
+    /**
+     * Cancel a recorded payment. The payment is kept for the audit trail
+     * (status `cancelled`) and the invoice is re-settled from the reversal.
+     * Rejected once the payment has been reported to the tax authority.
+     */
+    cancel(invoiceId: string, paymentId: string, options?: RequestOptions): Promise<PaymentCancelResult>;
+}

package/dist/cjs/resources/payments.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Payments = void 0;
+const pagination_js_1 = require("../pagination.js");
+/** Records payments against an invoice — accessed via `facturino.invoices.payments`. */
+class Payments {
+    constructor(client) {
+        this.client = client;
+    }
+    async create(invoiceId, params, options) {
+        return this.client.post(`/v1/invoices/${invoiceId}/payments`, params, options);
+    }
+    list(invoiceId, params) {
+        return new pagination_js_1.AutoPaginatingList(this.client, `/v1/invoices/${invoiceId}/payments`, params);
+    }
+    /**
+     * Cancel a recorded payment. The payment is kept for the audit trail
+     * (status `cancelled`) and the invoice is re-settled from the reversal.
+     * Rejected once the payment has been reported to the tax authority.
+     */
+    async cancel(invoiceId, paymentId, options) {
+        return this.client.post(`/v1/invoices/${invoiceId}/payments/${paymentId}/cancel`, undefined, options);
+    }
+}
+exports.Payments = Payments;

package/dist/cjs/resources/products.d.ts

@@ -0,0 +1,15 @@
+import type { HttpClient } from '../client.js';
+import { AutoPaginatingList } from '../pagination.js';
+import type { Product, ProductCreateParams, ProductUpdateParams, ProductListParams, JobResponse, RequestOptions } from '../types.js';
+/** Product catalog management with CSV import/export support. */
+export declare class Products {
+    private readonly client;
+    constructor(client: HttpClient);
+    create(params: ProductCreateParams, options?: RequestOptions): Promise<Product>;
+    list(params?: ProductListParams): AutoPaginatingList<Product>;
+    get(id: string): Promise<Product>;
+    update(id: string, params: ProductUpdateParams): Promise<Product>;
+    del(id: string): Promise<void>;
+    importCsv(csv: string, options?: RequestOptions): Promise<JobResponse>;
+    exportCsv(): Promise<JobResponse>;
+}

package/dist/cjs/resources/products.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Products = void 0;
+const pagination_js_1 = require("../pagination.js");
+/** Product catalog management with CSV import/export support. */
+class Products {
+    constructor(client) {
+        this.client = client;
+    }
+    async create(params, options) {
+        return this.client.post('/v1/products', params, options);
+    }
+    list(params) {
+        return new pagination_js_1.AutoPaginatingList(this.client, '/v1/products', params);
+    }
+    async get(id) {
+        return this.client.get(`/v1/products/${id}`);
+    }
+    async update(id, params) {
+        return this.client.patch(`/v1/products/${id}`, params);
+    }
+    async del(id) {
+        await this.client.del(`/v1/products/${id}`);
+    }
+    async importCsv(csv, options) {
+        return this.client.post('/v1/products/import', { csv }, options);
+    }
+    async exportCsv() {
+        return this.client.get('/v1/products/export');
+    }
+}
+exports.Products = Products;