@facturino/node 1.0.0

package/dist/esm/resources/creditNotes.js

@@ -0,0 +1,59 @@
+import { AutoPaginatingList } from '../pagination.js';
+/** Credit note operations — the legal way to correct or cancel a finalized invoice. */
+export class CreditNotes {
+    constructor(client) {
+        this.client = client;
+    }
+    async create(params, options) {
+        return this.client.post('/v1/credit-notes', params, options);
+    }
+    list(params) {
+        return new 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}`);
+    }
+}
+//# sourceMappingURL=creditNotes.js.map

package/dist/esm/resources/creditNotes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creditNotes.js","sourceRoot":"","sources":["../../../src/resources/creditNotes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAYrD,uFAAuF;AACvF,MAAM,OAAO,WAAW;IACtB,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,KAAK,CAAC,MAAM,CAAC,MAA8B,EAAE,OAAwB;QACnE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAa,kBAAkB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IAC1E,CAAC;IAED,IAAI,CAAC,MAA6B;QAChC,OAAO,IAAI,kBAAkB,CAAa,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAA;IACpF,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAa,oBAAoB,EAAE,EAAE,CAAC,CAAA;IAC9D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAA8B;QACrD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAa,oBAAoB,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;IACxE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAO,oBAAoB,EAAE,EAAE,CAAC,CAAA;IACvD,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAa,oBAAoB,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;IAC5F,CAAC;IAED,oBAAoB;IACpB,KAAK,CAAC,IAAI,CAAC,EAAU,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;IAC5E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CACT,EAAU,EACV,MAKC,EACD,OAAwB;QAKxB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IAC1E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CACV,EAAU,EACV,MAAyE,EACzE,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3E,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAA;IACtD,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAA;IAC1D,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAAsB;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAS,oBAAoB,EAAE,OAAO,KAAK,EAAE,CAAC,CAAA;IACtE,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+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>;
+}
+//# sourceMappingURL=customers.d.ts.map

package/dist/esm/resources/customers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../../../src/resources/customers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EACV,QAAQ,EACR,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,cAAc,EACf,MAAM,aAAa,CAAA;AAEpB,8EAA8E;AAC9E,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEzC,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvF,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAAC,QAAQ,CAAC;IAIzD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIlC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAInE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,sCAAsC;IAChC,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAInE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAItE,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC;CAGxC"}

package/dist/esm/resources/customers.js

@@ -0,0 +1,33 @@
+import { AutoPaginatingList } from '../pagination.js';
+/** CRUD operations on customers, with SIRENE lookup and CSV import/export. */
+export class Customers {
+    constructor(client) {
+        this.client = client;
+    }
+    async create(params, options) {
+        return this.client.post('/v1/customers', params, options);
+    }
+    list(params) {
+        return new 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');
+    }
+}
+//# sourceMappingURL=customers.js.map

package/dist/esm/resources/customers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.js","sourceRoot":"","sources":["../../../src/resources/customers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAYrD,8EAA8E;AAC9E,MAAM,OAAO,SAAS;IACpB,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,KAAK,CAAC,MAAM,CAAC,MAA4B,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAW,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IACrE,CAAC;IAED,IAAI,CAAC,MAA2B;QAC9B,OAAO,IAAI,kBAAkB,CAAW,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,CAAA;IAC/E,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAW,iBAAiB,EAAE,EAAE,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAA4B;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAW,iBAAiB,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;IACnE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAO,iBAAiB,EAAE,EAAE,CAAC,CAAA;IACpD,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,MAAM,CAAC,MAA4B;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAuB,sBAAsB,EAAE,MAAM,CAAC,CAAA;IAC/E,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAc,sBAAsB,EAAE,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,CAAA;IAChF,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAc,sBAAsB,CAAC,CAAA;IAC7D,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+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>;
+}
+//# sourceMappingURL=ereporting.d.ts.map

package/dist/esm/resources/ereporting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ereporting.d.ts","sourceRoot":"","sources":["../../../src/resources/ereporting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EACV,UAAU,EACV,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACf,MAAM,aAAa,CAAA;AAEpB,sFAAsF;AACtF,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEzC,iBAAiB,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAItG,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,CAAC,UAAU,CAAC;IAI7D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpC,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;CAGnF"}

package/dist/esm/resources/ereporting.js

@@ -0,0 +1,20 @@
+import { AutoPaginatingList } from '../pagination.js';
+/** E-reporting declarations for B2C and international transactions (art. 290 CGI). */
+export class EReportingResource {
+    constructor(client) {
+        this.client = client;
+    }
+    async createDeclaration(params, options) {
+        return this.client.post('/v1/ereporting/declarations', params, options);
+    }
+    list(params) {
+        return new 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);
+    }
+}
+//# sourceMappingURL=ereporting.js.map

package/dist/esm/resources/ereporting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ereporting.js","sourceRoot":"","sources":["../../../src/resources/ereporting.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAQrD,sFAAsF;AACtF,MAAM,OAAO,kBAAkB;IAC7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,KAAK,CAAC,iBAAiB,CAAC,MAA8B,EAAE,OAAwB;QAC9E,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAa,6BAA6B,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IACrF,CAAC;IAED,IAAI,CAAC,MAA6B;QAChC,OAAO,IAAI,kBAAkB,CAAa,IAAI,CAAC,MAAM,EAAE,6BAA6B,EAAE,MAAM,CAAC,CAAA;IAC/F,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAa,+BAA+B,EAAE,EAAE,CAAC,CAAA;IACzE,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,EAAU,EAAE,OAAwB;QAC1D,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAa,+BAA+B,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;IACrG,CAAC;CACF"}

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

@@ -0,0 +1,12 @@
+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>;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/esm/resources/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/resources/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAEhE,4EAA4E;AAC5E,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,kBAAkB,CAAC,YAAY,CAAC;IAI1D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAItC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAG/C"}

package/dist/esm/resources/events.js

@@ -0,0 +1,17 @@
+import { AutoPaginatingList } from '../pagination.js';
+/** Webhook event log — list, inspect, and retry delivery of past events. */
+export class Events {
+    constructor(client) {
+        this.client = client;
+    }
+    list(params) {
+        return new 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`);
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/esm/resources/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/resources/events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAGrD,4EAA4E;AAC5E,MAAM,OAAO,MAAM;IACjB,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,IAAI,CAAC,MAAwB;QAC3B,OAAO,IAAI,kBAAkB,CAAe,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA;IAChF,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAe,cAAc,EAAE,EAAE,CAAC,CAAA;IAC1D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAe,cAAc,EAAE,QAAQ,CAAC,CAAA;IACjE,CAAC;CACF"}

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

@@ -0,0 +1,21 @@
+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>;
+}
+//# sourceMappingURL=exports.d.ts.map

package/dist/esm/resources/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/resources/exports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEpG;;;GAGG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,kEAAkE;IAC5D,WAAW,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAIrF,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIjD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI1D;;;;OAIG;IACG,cAAc,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;CAGnG"}

package/dist/esm/resources/exports.js

@@ -0,0 +1,28 @@
+/**
+ * Data exports — FEC accounting files and the invoices ZIP. For RGPD data
+ * portability (art. 20), use `account.requestExport`.
+ */
+export 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);
+    }
+}
+//# sourceMappingURL=exports.js.map

package/dist/esm/resources/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../src/resources/exports.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,OAAO;IAClB,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,kEAAkE;IAClE,KAAK,CAAC,WAAW,CAAC,MAAwB,EAAE,OAAwB;QAClE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAc,iBAAiB,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAA;IAChF,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAc,mBAAmB,KAAK,EAAE,CAAC,CAAA;IACjE,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAa;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAc,eAAe,KAAK,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,MAA4B,EAAE,OAAwB;QACzE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAc,sBAAsB,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAA;IACrF,CAAC;CACF"}

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

@@ -0,0 +1,14 @@
+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>;
+}
+//# sourceMappingURL=health.d.ts.map

package/dist/esm/resources/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/resources/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;GAIG;AACH,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,qEAAqE;IAC/D,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;CAGrC"}

package/dist/esm/resources/health.js

@@ -0,0 +1,15 @@
+/**
+ * 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 class Health {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Return the current service health snapshot (`GET /v1/health`). */
+    async check() {
+        return this.client.get('/v1/health');
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/esm/resources/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/resources/health.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,OAAO,MAAM;IACjB,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,qEAAqE;IACrE,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAe,YAAY,CAAC,CAAA;IACpD,CAAC;CACF"}

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

@@ -0,0 +1,113 @@
+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>;
+}
+//# sourceMappingURL=invoices.d.ts.map

package/dist/esm/resources/invoices.d.ts.map

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

package/dist/esm/resources/invoices.js

@@ -0,0 +1,138 @@
+import { AutoPaginatingList } from '../pagination.js';
+import { Payments } from './payments.js';
+/** Manages invoice lifecycle — creation, finalization, sending, and document retrieval. */
+export class Invoices {
+    constructor(client) {
+        this.client = client;
+        this.payments = new Payments(client);
+    }
+    async create(params, options) {
+        return this.client.post('/v1/invoices', params, options);
+    }
+    list(params) {
+        return new 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 AutoPaginatingList(this.client, '/v1/invoices/incoming', params);
+    }
+}
+//# sourceMappingURL=invoices.js.map

package/dist/esm/resources/invoices.js.map

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

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

@@ -0,0 +1,11 @@
+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>;
+}
+//# sourceMappingURL=jobs.d.ts.map

package/dist/esm/resources/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../src/resources/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AAEtC,oFAAoF;AACpF,qBAAa,IAAI;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEzC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAInC,sCAAsC;IAChC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,SAAO,EAAE,WAAW,SAAK,GAAG,OAAO,CAAC,GAAG,CAAC;CAa1E"}

package/dist/esm/resources/jobs.js

@@ -0,0 +1,21 @@
+/** Track and poll async background jobs such as PDF generation or PA submission. */
+export 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`);
+    }
+}
+//# sourceMappingURL=jobs.js.map

package/dist/esm/resources/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../../src/resources/jobs.ts"],"names":[],"mappings":"AAGA,oFAAoF;AACpF,MAAM,OAAO,IAAI;IACf,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAM,YAAY,EAAE,EAAE,CAAC,CAAA;IAC/C,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAU,EAAE,UAAU,GAAG,IAAI,EAAE,WAAW,GAAG,EAAE;QACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAE9B,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC1D,OAAO,GAAG,CAAA;YACZ,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;QACjE,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,4BAA4B,WAAW,mBAAmB,CAAC,CAAA;IACtF,CAAC;CACF"}