@facturino/node 1.0.0

package/dist/esm/index.js

@@ -0,0 +1,61 @@
+import { HttpClient } from './client.js';
+import { Webhooks } from './webhooks.js';
+import { Invoices } from './resources/invoices.js';
+import { Payments } from './resources/payments.js';
+import { Customers } from './resources/customers.js';
+import { Products } from './resources/products.js';
+import { Quotes } from './resources/quotes.js';
+import { CreditNotes } from './resources/creditNotes.js';
+import { Events } from './resources/events.js';
+import { WebhookEndpoints } from './resources/webhookEndpoints.js';
+import { RecurringInvoices } from './resources/recurringInvoices.js';
+import { Companies } from './resources/companies.js';
+import { Exports } from './resources/exports.js';
+import { EReportingResource } from './resources/ereporting.js';
+import { Jobs } from './resources/jobs.js';
+import { Sandbox } from './resources/sandbox.js';
+import { ReceivedInvoices } from './resources/received-invoices.js';
+import { Reporting } from './resources/reporting.js';
+import { AccountResource } from './resources/account.js';
+import { Billing } from './resources/billing.js';
+import { Usage } from './resources/usage.js';
+import { Validate } from './resources/validate.js';
+import { Reference } from './resources/reference.js';
+import { Archives } from './resources/archives.js';
+import { Health } from './resources/health.js';
+/** Facturino API client for French e-invoicing — initialize with your API key to access all resources. */
+class Facturino {
+    constructor(apiKey, config) {
+        const client = new HttpClient(apiKey, config);
+        this.account = new AccountResource(client);
+        this.billing = new Billing(client);
+        this.invoices = new Invoices(client);
+        this.payments = new Payments(client);
+        this.customers = new Customers(client);
+        this.products = new Products(client);
+        this.quotes = new Quotes(client);
+        this.creditNotes = new CreditNotes(client);
+        this.events = new Events(client);
+        this.webhookEndpoints = new WebhookEndpoints(client);
+        this.recurringInvoices = new RecurringInvoices(client);
+        this.companies = new Companies(client);
+        this.exports = new Exports(client);
+        this.ereporting = new EReportingResource(client);
+        this.jobs = new Jobs(client);
+        this.reference = new Reference(client);
+        this.sandbox = new Sandbox(client);
+        this.usage = new Usage(client);
+        this.validate = new Validate(client);
+        this.webhooks = new Webhooks();
+        this.receivedInvoices = new ReceivedInvoices(client);
+        this.reporting = new Reporting(client);
+        this.archives = new Archives(client);
+        this.health = new Health(client);
+    }
+}
+export default Facturino;
+export { Facturino };
+export { FacturinoError, ApiError, InvalidRequestError, ValidationError, AuthenticationError, PermissionError, NotFoundError, ConflictError, RateLimitError, PlanLimitError, ApiInternalError, ConnectionError, } from './errors.js';
+export { Webhooks } from './webhooks.js';
+export { AutoPaginatingList } from './pagination.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,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAG9C,0GAA0G;AAC1G,MAAM,SAAS;IA0Bb,YAAY,MAAc,EAAE,MAAwB;QAClD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAE7C,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAA;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAA;QACpC,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAA;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAA;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAA;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAA;QAChC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAA;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAA;QAChC,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAA;QACpD,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;QACtD,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAA;QACtC,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;QAClC,IAAI,CAAC,UAAU,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAA;QAChD,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAA;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAA;QACtC,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;QAClC,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAA;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAA;QACpC,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAA;QAC9B,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAA;QACpD,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAA;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAA;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAA;IAClC,CAAC;CACF;AAED,eAAe,SAAS,CAAA;AACxB,OAAO,EAAE,SAAS,EAAE,CAAA;AA6IpB,OAAO,EACL,cAAc,EACd,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/esm/pagination.d.ts

@@ -0,0 +1,25 @@
+import type { HttpClient } from './client.js';
+import type { PaginatedResponse, PaginationParams } from './types.js';
+/**
+ * Async-iterable list with auto-pagination.
+ *
+ * ```ts
+ * for await (const inv of facturino.invoices.list()) { ... }
+ * // or: const page = await facturino.invoices.list()
+ * ```
+ */
+export declare class AutoPaginatingList<T extends {
+    id: string;
+}> implements AsyncIterable<T>, PromiseLike<PaginatedResponse<T>> {
+    private readonly client;
+    private readonly path;
+    private readonly params;
+    private firstPagePromise;
+    constructor(client: HttpClient, path: string, params?: PaginationParams);
+    /** Await resolves to the first page. */
+    then<TResult1 = PaginatedResponse<T>, TResult2 = never>(onfulfilled?: ((value: PaginatedResponse<T>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    /** Yields items across all pages. */
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+    private getFirstPage;
+}
+//# 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,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAErE;;;;;;;GAOG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CACtD,YAAW,aAAa,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAE9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,gBAAgB,CAA6C;gBAGnE,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,gBAAgB;IAO3B,wCAAwC;IACxC,IAAI,CAAC,QAAQ,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,EACpD,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EACxF,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAC1E,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAI/B,qCAAqC;IAC9B,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;IAkCjD,OAAO,CAAC,YAAY;CAiBrB"}

package/dist/esm/pagination.js

@@ -0,0 +1,65 @@
+/**
+ * Async-iterable list with auto-pagination.
+ *
+ * ```ts
+ * for await (const inv of facturino.invoices.list()) { ... }
+ * // or: const page = await facturino.invoices.list()
+ * ```
+ */
+export class AutoPaginatingList {
+    constructor(client, path, params) {
+        this.firstPagePromise = null;
+        this.client = client;
+        this.path = path;
+        this.params = { ...(params ?? {}) };
+    }
+    /** Await resolves to the first page. */
+    then(onfulfilled, onrejected) {
+        return this.getFirstPage().then(onfulfilled, onrejected);
+    }
+    /** Yields items across all pages. */
+    async *[Symbol.asyncIterator]() {
+        let cursor = this.params.starting_after;
+        const limit = this.params.limit ?? 25;
+        for (;;) {
+            const queryParams = {};
+            if (limit)
+                queryParams.limit = String(limit);
+            if (cursor)
+                queryParams.starting_after = cursor;
+            // Forward filter params (status, type, active, etc.)
+            for (const [key, value] of Object.entries(this.params)) {
+                if (key === 'limit' || key === 'starting_after')
+                    continue;
+                if (value !== undefined && value !== null) {
+                    queryParams[key] = String(value);
+                }
+            }
+            const qs = new URLSearchParams(queryParams).toString();
+            const url = qs ? `${this.path}?${qs}` : this.path;
+            const page = await this.client.get(url);
+            for (const item of page.data) {
+                yield item;
+            }
+            if (!page.has_more || page.data.length === 0) {
+                break;
+            }
+            cursor = page.next_cursor ?? page.data[page.data.length - 1].id;
+        }
+    }
+    getFirstPage() {
+        if (!this.firstPagePromise) {
+            const queryParams = {};
+            for (const [key, value] of Object.entries(this.params)) {
+                if (value !== undefined && value !== null) {
+                    queryParams[key] = String(value);
+                }
+            }
+            const qs = new URLSearchParams(queryParams).toString();
+            const url = qs ? `${this.path}?${qs}` : this.path;
+            this.firstPagePromise = this.client.get(url);
+        }
+        return this.firstPagePromise;
+    }
+}
+//# 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":"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"}

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

@@ -0,0 +1,59 @@
+import type { HttpClient } from '../client.js';
+import type { Account } from '../types.js';
+/**
+ * Result of `POST /v1/account/export` (202 Accepted). The export runs
+ * asynchronously — poll `exports.getExportStatus(id)` until the job exposes
+ * `download_url`.
+ */
+export interface AccountExportResponse {
+    object: 'job';
+    /** Job id (`job_…`) — poll it via `exports.getExportStatus`. */
+    id: string;
+    type: 'rgpd_export';
+    status: string;
+}
+/** Short-lived (5 min) signed-URL response for a prepared RGPD export. */
+export interface AccountExportDownloadResponse {
+    object: 'export_url';
+    url: string;
+    /** ISO 8601 expiry of the signed URL (5 minutes). */
+    expires_at: string;
+}
+/**
+ * Account introspection — returns the authenticated user, the active
+ * company, the current plan and the scopes attached to the API key in
+ * use. Every integration should expose this on a "Connected to
+ * Facturino" surface so users can confirm which company and which
+ * environment (`fac_test_` vs `fac_live_`) their requests target.
+ *
+ * Also exposes the RGPD data-export endpoints (article 20): request a
+ * full export and download it once prepared.
+ */
+export declare class AccountResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /**
+     * Return the account context (user, company, plan, livemode, scopes)
+     * associated with the API key used by this client. Equivalent to
+     * Stripe's `accounts.retrieve('me')` — no path parameter, the key
+     * implicitly identifies "self".
+     */
+    retrieve(): Promise<Account>;
+    /**
+     * Request a full export of the account's data (RGPD article 20).
+     * Returns 202 with a job id; the file is prepared asynchronously.
+     * Poll `exports.getExportStatus(id)` until the job carries a
+     * `download_url` (the user also receives an in-app notification).
+     */
+    requestExport(): Promise<AccountExportResponse>;
+    /**
+     * Return a short-lived (5 minutes) signed URL for a prepared RGPD
+     * export. Takes the `rgpdexp_…` export id delivered by the
+     * `export_ready` notification — NOT the `job_…` id returned by
+     * {@link requestExport} (poll that one via `exports.getExportStatus`).
+     * The export metadata is keyed under the authenticated user —
+     * cross-user access is impossible.
+     */
+    downloadExport(exportId: string): Promise<AccountExportDownloadResponse>;
+}
+//# sourceMappingURL=account.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../src/resources/account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,KAAK,CAAA;IACb,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,aAAa,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,0EAA0E;AAC1E,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,YAAY,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;;OAKG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC;;;;;OAKG;IACG,aAAa,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAIrD;;;;;;;OAOG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;CAK/E"}

package/dist/esm/resources/account.js

@@ -0,0 +1,45 @@
+/**
+ * Account introspection — returns the authenticated user, the active
+ * company, the current plan and the scopes attached to the API key in
+ * use. Every integration should expose this on a "Connected to
+ * Facturino" surface so users can confirm which company and which
+ * environment (`fac_test_` vs `fac_live_`) their requests target.
+ *
+ * Also exposes the RGPD data-export endpoints (article 20): request a
+ * full export and download it once prepared.
+ */
+export class AccountResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Return the account context (user, company, plan, livemode, scopes)
+     * associated with the API key used by this client. Equivalent to
+     * Stripe's `accounts.retrieve('me')` — no path parameter, the key
+     * implicitly identifies "self".
+     */
+    async retrieve() {
+        return this.client.get('/v1/account');
+    }
+    /**
+     * Request a full export of the account's data (RGPD article 20).
+     * Returns 202 with a job id; the file is prepared asynchronously.
+     * Poll `exports.getExportStatus(id)` until the job carries a
+     * `download_url` (the user also receives an in-app notification).
+     */
+    async requestExport() {
+        return this.client.post('/v1/account/export');
+    }
+    /**
+     * Return a short-lived (5 minutes) signed URL for a prepared RGPD
+     * export. Takes the `rgpdexp_…` export id delivered by the
+     * `export_ready` notification — NOT the `job_…` id returned by
+     * {@link requestExport} (poll that one via `exports.getExportStatus`).
+     * The export metadata is keyed under the authenticated user —
+     * cross-user access is impossible.
+     */
+    async downloadExport(exportId) {
+        return this.client.get(`/v1/account/exports/${exportId}/download`);
+    }
+}
+//# sourceMappingURL=account.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/resources/account.ts"],"names":[],"mappings":"AAwBA;;;;;;;;;GASG;AACH,MAAM,OAAO,eAAe;IAC1B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;OAKG;IACH,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAU,aAAa,CAAC,CAAA;IAChD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAwB,oBAAoB,CAAC,CAAA;IACtE,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc,CAAC,QAAgB;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CACpB,uBAAuB,QAAQ,WAAW,CAC3C,CAAA;IACH,CAAC;CACF"}

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

@@ -0,0 +1,17 @@
+import type { HttpClient } from '../client.js';
+import { AutoPaginatingList } from '../pagination.js';
+import type { PaginationParams } from '../types.js';
+/** Archive retrieval — access legally archived invoices and verify integrity. */
+export declare class Archives {
+    private readonly client;
+    constructor(client: HttpClient);
+    list(params?: PaginationParams): AutoPaginatingList<{
+        id: string;
+        [key: string]: unknown;
+    }>;
+    get(invoiceId: string): Promise<{
+        id: string;
+        [key: string]: unknown;
+    }>;
+}
+//# sourceMappingURL=archives.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archives.d.ts","sourceRoot":"","sources":["../../../src/resources/archives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,aAAa,CAAA;AAEpB,iFAAiF;AACjF,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAIrF,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CAG9E"}

package/dist/esm/resources/archives.js

@@ -0,0 +1,14 @@
+import { AutoPaginatingList } from '../pagination.js';
+/** Archive retrieval — access legally archived invoices and verify integrity. */
+export class Archives {
+    constructor(client) {
+        this.client = client;
+    }
+    list(params) {
+        return new AutoPaginatingList(this.client, '/v1/archives', params);
+    }
+    async get(invoiceId) {
+        return this.client.get(`/v1/archives/${invoiceId}`);
+    }
+}
+//# sourceMappingURL=archives.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archives.js","sourceRoot":"","sources":["../../../src/resources/archives.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAMrD,iFAAiF;AACjF,MAAM,OAAO,QAAQ;IACnB,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,IAAI,CAAC,MAAyB;QAC5B,OAAO,IAAI,kBAAkB,CAAyC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,CAAA;IAC5G,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAyC,gBAAgB,SAAS,EAAE,CAAC,CAAA;IAC7F,CAAC;CACF"}

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

@@ -0,0 +1,31 @@
+import type { HttpClient } from '../client.js';
+import type { BillingSubscription, PaginatedResponse, PlatformInvoice } from '../types.js';
+/**
+ * Billing — read-only access to the current subscription and the
+ * Facturino → user platform-invoice history.
+ *
+ * Plan changes, checkout and the Stripe Customer Portal are handled
+ * through the Facturino dashboard, not the API.
+ */
+export declare class Billing {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Current subscription (plan, status, period). */
+    retrieveSubscription(): Promise<BillingSubscription>;
+    /** Paginated list of platform invoices (Facturino → user) for the current account. */
+    listInvoices(params?: {
+        limit?: number;
+        starting_after?: string;
+    }): Promise<PaginatedResponse<PlatformInvoice>>;
+    /**
+     * Short-lived signed URL for a platform-invoice PDF. The URL expires
+     * within minutes — fetch it just-in-time when the user clicks
+     * "Download", do not store it.
+     */
+    getInvoicePdf(invoiceId: string): Promise<{
+        object: 'file_url';
+        url: string;
+        expires_in: number;
+    }>;
+}
+//# sourceMappingURL=billing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../../src/resources/billing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EAChB,MAAM,aAAa,CAAA;AAapB;;;;;;GAMG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,mDAAmD;IAC7C,oBAAoB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI1D,sFAAsF;IAChF,YAAY,CAAC,MAAM,CAAC,EAAE;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,cAAc,CAAC,EAAE,MAAM,CAAA;KACxB,GAAG,OAAO,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAK/C;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAGzG"}

package/dist/esm/resources/billing.js

@@ -0,0 +1,42 @@
+/** Encode a flat object as a `?k=v&…` query string (skips undefined/null). */
+function buildQuery(params) {
+    const entries = [];
+    for (const [k, v] of Object.entries(params)) {
+        if (v === undefined || v === null)
+            continue;
+        entries.push([k, String(v)]);
+    }
+    if (entries.length === 0)
+        return '';
+    return `?${new URLSearchParams(entries).toString()}`;
+}
+/**
+ * Billing — read-only access to the current subscription and the
+ * Facturino → user platform-invoice history.
+ *
+ * Plan changes, checkout and the Stripe Customer Portal are handled
+ * through the Facturino dashboard, not the API.
+ */
+export class Billing {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Current subscription (plan, status, period). */
+    async retrieveSubscription() {
+        return this.client.get('/v1/billing/subscription');
+    }
+    /** Paginated list of platform invoices (Facturino → user) for the current account. */
+    async listInvoices(params) {
+        const qs = params ? buildQuery(params) : '';
+        return this.client.get(`/v1/billing/invoices${qs}`);
+    }
+    /**
+     * Short-lived signed URL for a platform-invoice PDF. The URL expires
+     * within minutes — fetch it just-in-time when the user clicks
+     * "Download", do not store it.
+     */
+    async getInvoicePdf(invoiceId) {
+        return this.client.get(`/v1/billing/invoices/${invoiceId}/pdf`);
+    }
+}
+//# sourceMappingURL=billing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../../src/resources/billing.ts"],"names":[],"mappings":"AAOA,8EAA8E;AAC9E,SAAS,UAAU,CAAC,MAA+B;IACjD,MAAM,OAAO,GAAuB,EAAE,CAAA;IACtC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YAAE,SAAQ;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACnC,OAAO,IAAI,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAA;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,OAAO;IAClB,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,mDAAmD;IACnD,KAAK,CAAC,oBAAoB;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAsB,0BAA0B,CAAC,CAAA;IACzE,CAAC;IAED,sFAAsF;IACtF,KAAK,CAAC,YAAY,CAAC,MAGlB;QACC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAqC,uBAAuB,EAAE,EAAE,CAAC,CAAA;IACzF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,wBAAwB,SAAS,MAAM,CAAC,CAAA;IACjE,CAAC;CACF"}

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

@@ -0,0 +1,48 @@
+import type { HttpClient } from '../client.js';
+import type { Address, BankDetails, Company, CompanyUpdateParams, CgvResponse, LegalFormInput, NafCodeInput, PaginatedResponse, RequestOptions } from '../types.js';
+/** Body for `POST /v1/companies` — create a new company under the authenticated user. */
+export interface CompanyCreateParams {
+    name: string;
+    siret: string;
+    address: Address;
+    vatNumber?: string;
+    legalForm?: LegalFormInput;
+    naf?: NafCodeInput;
+    tvaIntracom?: string;
+    rcs?: string;
+    capitalSocial?: string;
+    vatRegime?: 'normal' | 'franchise' | 'simplified' | 'debit';
+    email?: string;
+    phone?: string;
+    website?: string;
+    bankDetails?: BankDetails;
+}
+/** Company profile and settings — legal information, bank details, and CGV documents. */
+export declare class Companies {
+    private readonly client;
+    constructor(client: HttpClient);
+    list(): Promise<PaginatedResponse<Company>>;
+    /**
+     * Create a new company under the authenticated user. Subject to the
+     * per-plan company quota (free: 1, essential: 1, pro: 3, cabinet_*: 50+);
+     * exceeding the quota returns a `402 plan_limit_error`.
+     */
+    create(params: CompanyCreateParams, options?: RequestOptions): Promise<Company>;
+    get(id: string): Promise<Company>;
+    update(id: string, params: CompanyUpdateParams): Promise<Company>;
+    /**
+     * Mark an onboarding milestone as reached (e.g. `first_invoice_sent`,
+     * `pa_connected`, `bank_added`). Used by the dashboard to compute the
+     * onboarding progress and surface remaining steps.
+     */
+    addMilestone(id: string, milestone: string): Promise<{
+        object: 'company_milestone';
+        milestone: string;
+        reachedAt: string;
+    }>;
+    /** Base64-encoded PDF, max 5 MB. */
+    uploadCgv(companyId: string, content: string, options?: RequestOptions): Promise<CgvResponse>;
+    getCgv(companyId: string): Promise<CgvResponse>;
+    deleteCgv(companyId: string): Promise<CgvResponse>;
+}
+//# sourceMappingURL=companies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"companies.d.ts","sourceRoot":"","sources":["../../../src/resources/companies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EACX,OAAO,EACP,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACf,MAAM,aAAa,CAAA;AAEpB,yFAAyF;AACzF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,GAAG,CAAC,EAAE,YAAY,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,CAAA;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED,yFAAyF;AACzF,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEzC,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAIjD;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvE;;;;OAIG;IACG,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,MAAM,EAAE,mBAAmB,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAIjF,oCAAoC;IAC9B,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAI7F,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAGzD"}

package/dist/esm/resources/companies.js

@@ -0,0 +1,42 @@
+/** Company profile and settings — legal information, bank details, and CGV documents. */
+export class Companies {
+    constructor(client) {
+        this.client = client;
+    }
+    async list() {
+        return this.client.get('/v1/companies');
+    }
+    /**
+     * Create a new company under the authenticated user. Subject to the
+     * per-plan company quota (free: 1, essential: 1, pro: 3, cabinet_*: 50+);
+     * exceeding the quota returns a `402 plan_limit_error`.
+     */
+    async create(params, options) {
+        return this.client.post('/v1/companies', params, options);
+    }
+    async get(id) {
+        return this.client.get(`/v1/companies/${id}`);
+    }
+    async update(id, params) {
+        return this.client.patch(`/v1/companies/${id}`, params);
+    }
+    /**
+     * Mark an onboarding milestone as reached (e.g. `first_invoice_sent`,
+     * `pa_connected`, `bank_added`). Used by the dashboard to compute the
+     * onboarding progress and surface remaining steps.
+     */
+    async addMilestone(id, milestone) {
+        return this.client.post(`/v1/companies/${id}/milestones`, { milestone });
+    }
+    /** Base64-encoded PDF, max 5 MB. */
+    async uploadCgv(companyId, content, options) {
+        return this.client.post(`/v1/companies/${companyId}/cgv`, { content }, options);
+    }
+    async getCgv(companyId) {
+        return this.client.get(`/v1/companies/${companyId}/cgv`);
+    }
+    async deleteCgv(companyId) {
+        return this.client.del(`/v1/companies/${companyId}/cgv`);
+    }
+}
+//# sourceMappingURL=companies.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"companies.js","sourceRoot":"","sources":["../../../src/resources/companies.ts"],"names":[],"mappings":"AA+BA,yFAAyF;AACzF,MAAM,OAAO,SAAS;IACpB,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAA6B,eAAe,CAAC,CAAA;IACrE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,MAA2B,EAAE,OAAwB;QAChE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAU,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IACpE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAU,iBAAiB,EAAE,EAAE,CAAC,CAAA;IACxD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAA2B;QAClD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAU,iBAAiB,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;IAClE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAChB,EAAU,EACV,SAAiB;QAEjB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;IAC1E,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,OAAe,EAAE,OAAwB;QAC1E,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAc,iBAAiB,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAA;IAC9F,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAc,iBAAiB,SAAS,MAAM,CAAC,CAAA;IACvE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,SAAiB;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAc,iBAAiB,SAAS,MAAM,CAAC,CAAA;IACvE,CAAC;CACF"}

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

@@ -0,0 +1,65 @@
+import type { HttpClient } from '../client.js';
+import { AutoPaginatingList } from '../pagination.js';
+import type { CreditNote, CreditNoteCreateParams, CreditNoteUpdateParams, CreditNoteListParams, DocumentUrlResponse, JobResponse, PaymentMethod, RequestOptions } from '../types.js';
+/** Credit note operations — the legal way to correct or cancel a finalized invoice. */
+export declare class CreditNotes {
+    private readonly client;
+    constructor(client: HttpClient);
+    create(params: CreditNoteCreateParams, options?: RequestOptions): Promise<CreditNote>;
+    list(params?: CreditNoteListParams): AutoPaginatingList<CreditNote>;
+    get(id: string): Promise<CreditNote>;
+    update(id: string, params: CreditNoteUpdateParams): Promise<CreditNote>;
+    del(id: string): Promise<void>;
+    /** Assign number and lock. Irreversible. */
+    finalize(id: string, options?: RequestOptions): Promise<CreditNote>;
+    /** Submit to PA. */
+    send(id: string, options?: RequestOptions): Promise<{
+        id: string;
+        object: 'credit_note';
+        status: string;
+    }>;
+    /**
+     * 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.
+     */
+    email(id: string, params?: {
+        recipientEmail?: string;
+        customMessage?: string;
+        includeXml?: boolean;
+        customSubject?: string;
+    }, options?: RequestOptions): Promise<{
+        status: 'sent';
+        creditNoteId: string;
+        recipient: string;
+        sentAt: string;
+    } | {
+        status: 'pending';
+        creditNoteId: string;
+        jobId: string;
+        pollUrl: string;
+        reason: string;
+    }>;
+    /**
+     * 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.
+     */
+    refund(id: string, params?: {
+        amount?: number;
+        method?: PaymentMethod;
+        refundedAt?: string;
+    }, options?: RequestOptions): Promise<{
+        id: string;
+        object: 'refund';
+        creditNoteId: string;
+        invoiceId: string;
+        amount: number;
+    }>;
+    getPdf(id: string): Promise<DocumentUrlResponse | JobResponse>;
+    /** Factur-X PDF/A-3 with embedded XML. URL or async job. */
+    getFacturx(id: string): Promise<DocumentUrlResponse | JobResponse>;
+    /** Raw CII or UBL XML. */
+    getXml(id: string, format?: 'cii' | 'ubl'): Promise<string>;
+}
+//# sourceMappingURL=creditNotes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"creditNotes.d.ts","sourceRoot":"","sources":["../../../src/resources/creditNotes.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,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,cAAc,EACf,MAAM,aAAa,CAAA;AAEpB,uFAAuF;AACvF,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEzC,MAAM,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAI3F,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,CAAC,UAAU,CAAC;IAI7D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;IAIvE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,4CAA4C;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAIzE,oBAAoB;IACd,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhH;;;;OAIG;IACG,KAAK,CACT,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE;QACP,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,EACD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CACN;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC3E;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAC9F;IAID;;;;OAIG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,aAAa,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EACzE,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAI/F,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,WAAW,CAAC;IAIpE,4DAA4D;IACtD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,WAAW,CAAC;IAIxE,0BAA0B;IACpB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;CAIlE"}