@itzenata/efact-node 1.0.1

package/dist/_generated/models/invoice-status-response.d.ts

@@ -0,0 +1,83 @@
+/**
+ * EFact API
+ * Compliance-as-a-service backend for Moroccan DGI electronic invoicing
+ *
+ * The version of the OpenAPI document: v0.0.1-SNAPSHOT
+ * Contact: contact@itzenata.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Lightweight status response for polling invoice processing state
+ * @export
+ * @interface InvoiceStatusResponse
+ */
+export interface InvoiceStatusResponse {
+    /**
+     * Unique invoice identifier
+     * @type {string}
+     * @memberof InvoiceStatusResponse
+     */
+    'id'?: string;
+    /**
+     * Current processing status
+     * @type {string}
+     * @memberof InvoiceStatusResponse
+     */
+    'status'?: InvoiceStatusResponseStatusEnum;
+    /**
+     * DGI clearance reference assigned after successful submission
+     * @type {string}
+     * @memberof InvoiceStatusResponse
+     */
+    'dgiReference'?: string;
+    /**
+     * Raw QR code payload content assigned by DGI after clearance
+     * @type {string}
+     * @memberof InvoiceStatusResponse
+     */
+    'dgiQrPayload'?: string;
+    /**
+     * DGI error code if submission was rejected
+     * @type {string}
+     * @memberof InvoiceStatusResponse
+     */
+    'dgiErrorCode'?: string;
+    /**
+     * DGI human-readable error description if submission was rejected
+     * @type {string}
+     * @memberof InvoiceStatusResponse
+     */
+    'dgiErrorMessage'?: string;
+    /**
+     * Timestamp when the invoice was submitted to DGI
+     * @type {string}
+     * @memberof InvoiceStatusResponse
+     */
+    'dgiSubmittedAt'?: string;
+    /**
+     * Timestamp when DGI validated (cleared) the invoice
+     * @type {string}
+     * @memberof InvoiceStatusResponse
+     */
+    'dgiValidatedAt'?: string;
+    /**
+     * Timestamp when DGI rejected the invoice
+     * @type {string}
+     * @memberof InvoiceStatusResponse
+     */
+    'dgiRejectedAt'?: string;
+}
+export declare const InvoiceStatusResponseStatusEnum: {
+    readonly Pending: "PENDING";
+    readonly Signed: "SIGNED";
+    readonly Transmitted: "TRANSMITTED";
+    readonly Accepted: "ACCEPTED";
+    readonly Rejected: "REJECTED";
+    readonly Failed: "FAILED";
+    readonly Cancelled: "CANCELLED";
+};
+export type InvoiceStatusResponseStatusEnum = typeof InvoiceStatusResponseStatusEnum[keyof typeof InvoiceStatusResponseStatusEnum];
+//# sourceMappingURL=invoice-status-response.d.ts.map

package/dist/_generated/models/invoice-status-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-status-response.d.ts","sourceRoot":"","sources":["../../../src/_generated/models/invoice-status-response.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAC;IAC3C;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,+BAA+B;;;;;;;;CAQlC,CAAC;AAEX,MAAM,MAAM,+BAA+B,GAAG,OAAO,+BAA+B,CAAC,MAAM,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/_generated/models/invoice-status-response.js

@@ -0,0 +1,24 @@
+// @ts-nocheck
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * EFact API
+ * Compliance-as-a-service backend for Moroccan DGI electronic invoicing
+ *
+ * The version of the OpenAPI document: v0.0.1-SNAPSHOT
+ * Contact: contact@itzenata.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+export const InvoiceStatusResponseStatusEnum = {
+    Pending: 'PENDING',
+    Signed: 'SIGNED',
+    Transmitted: 'TRANSMITTED',
+    Accepted: 'ACCEPTED',
+    Rejected: 'REJECTED',
+    Failed: 'FAILED',
+    Cancelled: 'CANCELLED'
+};
+//# sourceMappingURL=invoice-status-response.js.map

package/dist/_generated/models/invoice-status-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-status-response.js","sourceRoot":"","sources":["../../../src/_generated/models/invoice-status-response.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,oBAAoB;AACpB,oBAAoB;AACpB;;;;;;;;;;GAUG;AAkEH,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC3C,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;CAChB,CAAC"}

package/dist/_generated/models/page-response-invoice-response.d.ts

@@ -0,0 +1,62 @@
+/**
+ * EFact API
+ * Compliance-as-a-service backend for Moroccan DGI electronic invoicing
+ *
+ * The version of the OpenAPI document: v0.0.1-SNAPSHOT
+ * Contact: contact@itzenata.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { InvoiceResponse } from './invoice-response.js';
+/**
+ *
+ * @export
+ * @interface PageResponseInvoiceResponse
+ */
+export interface PageResponseInvoiceResponse {
+    /**
+     *
+     * @type {Array<InvoiceResponse>}
+     * @memberof PageResponseInvoiceResponse
+     */
+    'content'?: Array<InvoiceResponse>;
+    /**
+     *
+     * @type {number}
+     * @memberof PageResponseInvoiceResponse
+     */
+    'page'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof PageResponseInvoiceResponse
+     */
+    'size'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof PageResponseInvoiceResponse
+     */
+    'totalElements'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof PageResponseInvoiceResponse
+     */
+    'totalPages'?: number;
+    /**
+     *
+     * @type {boolean}
+     * @memberof PageResponseInvoiceResponse
+     */
+    'first'?: boolean;
+    /**
+     *
+     * @type {boolean}
+     * @memberof PageResponseInvoiceResponse
+     */
+    'last'?: boolean;
+}
+//# sourceMappingURL=page-response-invoice-response.d.ts.map

package/dist/_generated/models/page-response-invoice-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-response-invoice-response.d.ts","sourceRoot":"","sources":["../../../src/_generated/models/page-response-invoice-response.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IACnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/_generated/models/page-response-invoice-response.js

@@ -0,0 +1,16 @@
+// @ts-nocheck
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * EFact API
+ * Compliance-as-a-service backend for Moroccan DGI electronic invoicing
+ *
+ * The version of the OpenAPI document: v0.0.1-SNAPSHOT
+ * Contact: contact@itzenata.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+export {};
+//# sourceMappingURL=page-response-invoice-response.js.map

package/dist/_generated/models/page-response-invoice-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-response-invoice-response.js","sourceRoot":"","sources":["../../../src/_generated/models/page-response-invoice-response.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,oBAAoB;AACpB,oBAAoB;AACpB;;;;;;;;;;GAUG"}

package/dist/_generated/models/update-invoice-request.d.ts

@@ -0,0 +1,121 @@
+/**
+ * EFact API
+ * Compliance-as-a-service backend for Moroccan DGI electronic invoicing
+ *
+ * The version of the OpenAPI document: v0.0.1-SNAPSHOT
+ * Contact: contact@itzenata.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Request body to update an existing invoice. All fields are optional — only provided fields are applied.
+ * @export
+ * @interface UpdateInvoiceRequest
+ */
+export interface UpdateInvoiceRequest {
+    /**
+     * Updated invoice number
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'invoiceNumber'?: string;
+    /**
+     * Updated invoice status
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'status'?: UpdateInvoiceRequestStatusEnum;
+    /**
+     * Buyer\'s ICE — 15-digit Moroccan business identifier
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'buyerIce'?: string;
+    /**
+     * Buyer\'s legal company name
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'buyerName'?: string;
+    /**
+     * Buyer\'s registered address
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'buyerAddress'?: string;
+    /**
+     * Date the invoice was issued
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'invoiceDate'?: string;
+    /**
+     * Payment due date
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'dueDate'?: string;
+    /**
+     * 3-letter ISO 4217 currency code
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'currency'?: string;
+    /**
+     * Payment method
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'paymentMethod'?: UpdateInvoiceRequestPaymentMethodEnum;
+    /**
+     * DGI clearance reference assigned after submission
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'dgiReference'?: string;
+    /**
+     * Error code if processing failed
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'errorCode'?: string;
+    /**
+     * Human-readable error message if processing failed
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'errorMessage'?: string;
+    /**
+     * Storage path of the generated UBL 2.1 XML
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'ublXmlPath'?: string;
+    /**
+     * Storage path of the XAdES-B-B signed XML
+     * @type {string}
+     * @memberof UpdateInvoiceRequest
+     */
+    'signedXmlPath'?: string;
+}
+export declare const UpdateInvoiceRequestStatusEnum: {
+    readonly Pending: "PENDING";
+    readonly Signed: "SIGNED";
+    readonly Transmitted: "TRANSMITTED";
+    readonly Accepted: "ACCEPTED";
+    readonly Rejected: "REJECTED";
+    readonly Failed: "FAILED";
+    readonly Cancelled: "CANCELLED";
+};
+export type UpdateInvoiceRequestStatusEnum = typeof UpdateInvoiceRequestStatusEnum[keyof typeof UpdateInvoiceRequestStatusEnum];
+export declare const UpdateInvoiceRequestPaymentMethodEnum: {
+    readonly BankTransfer: "BANK_TRANSFER";
+    readonly Cash: "CASH";
+    readonly Check: "CHECK";
+    readonly Card: "CARD";
+    readonly Other: "OTHER";
+};
+export type UpdateInvoiceRequestPaymentMethodEnum = typeof UpdateInvoiceRequestPaymentMethodEnum[keyof typeof UpdateInvoiceRequestPaymentMethodEnum];
+//# sourceMappingURL=update-invoice-request.d.ts.map

package/dist/_generated/models/update-invoice-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-invoice-request.d.ts","sourceRoot":"","sources":["../../../src/_generated/models/update-invoice-request.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,8BAA8B,CAAC;IAC1C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,qCAAqC,CAAC;IACxD;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,8BAA8B;;;;;;;;CAQjC,CAAC;AAEX,MAAM,MAAM,8BAA8B,GAAG,OAAO,8BAA8B,CAAC,MAAM,OAAO,8BAA8B,CAAC,CAAC;AAChI,eAAO,MAAM,qCAAqC;;;;;;CAMxC,CAAC;AAEX,MAAM,MAAM,qCAAqC,GAAG,OAAO,qCAAqC,CAAC,MAAM,OAAO,qCAAqC,CAAC,CAAC"}

package/dist/_generated/models/update-invoice-request.js

@@ -0,0 +1,31 @@
+// @ts-nocheck
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * EFact API
+ * Compliance-as-a-service backend for Moroccan DGI electronic invoicing
+ *
+ * The version of the OpenAPI document: v0.0.1-SNAPSHOT
+ * Contact: contact@itzenata.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+export const UpdateInvoiceRequestStatusEnum = {
+    Pending: 'PENDING',
+    Signed: 'SIGNED',
+    Transmitted: 'TRANSMITTED',
+    Accepted: 'ACCEPTED',
+    Rejected: 'REJECTED',
+    Failed: 'FAILED',
+    Cancelled: 'CANCELLED'
+};
+export const UpdateInvoiceRequestPaymentMethodEnum = {
+    BankTransfer: 'BANK_TRANSFER',
+    Cash: 'CASH',
+    Check: 'CHECK',
+    Card: 'CARD',
+    Other: 'OTHER'
+};
+//# sourceMappingURL=update-invoice-request.js.map

package/dist/_generated/models/update-invoice-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-invoice-request.js","sourceRoot":"","sources":["../../../src/_generated/models/update-invoice-request.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,oBAAoB;AACpB,oBAAoB;AACpB;;;;;;;;;;GAUG;AAgGH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC1C,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;CAChB,CAAC;AAGX,MAAM,CAAC,MAAM,qCAAqC,GAAG;IACjD,YAAY,EAAE,eAAe;IAC7B,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACR,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,73 @@
+import { InvoicesResource, type ListInvoicesParams } from "./invoices.js";
+import type { CreateInvoiceRequest, InvoiceResponse, InvoiceStatusResponse, PageResponseInvoiceResponse, UpdateInvoiceRequest } from "./_generated/index.js";
+/**
+ * Environnements publics et leur URL de base (host uniquement — les chemins
+ * générés portent déjà le préfixe /v1). Seuls les environnements destinés aux
+ * clients sont nommés ; le dev local passe par l'option `baseUrl`
+ * (ex. baseUrl: "http://localhost:8080").
+ *
+ * NOTE : l'URL "production" pointe temporairement sur preview, qui fait office
+ * de prod tant que l'URL de prod définitive n'est pas déployée. La changer ici
+ * (et dans les serveurs OpenAPI) suffira — aucun changement côté clients.
+ */
+export declare const ENVIRONMENTS: {
+    readonly production: "https://preview.efact-api.itzenata.com";
+};
+export type EFactEnvironment = keyof typeof ENVIRONMENTS;
+export interface EFactOptions {
+    /** Environnement cible. Défaut "production". Ignoré si `baseUrl` est fourni. */
+    environment?: EFactEnvironment;
+    /** URL de base explicite (host), p.ex. "http://localhost:8080" en dev local. */
+    baseUrl?: string;
+    /** Délai max par requête, en ms (défaut 30000). */
+    timeout?: number;
+    /** Nombre max de nouveaux essais pour les requêtes sûres (défaut 2). */
+    maxRetries?: number;
+}
+/**
+ * Client EFact e-Facture.
+ *
+ * @example
+ * const efact = new EFact(process.env.EFACT_SECRET_KEY);
+ * const invoice = await efact.invoices.create({ ... });
+ */
+export declare class EFact {
+    private readonly http;
+    private readonly baseUrl;
+    private readonly maskedKey;
+    /** Opérations sur les factures : efact.invoices.create/list/retrieve/... */
+    readonly invoices: InvoicesResource;
+    /**
+     * @param secretKey Clé secrète au format efact_sk_... (jamais loggée en clair).
+     * @param options   Options facultatives (environment, baseUrl, timeout, maxRetries).
+     */
+    constructor(secretKey: string, options?: EFactOptions);
+    /** Configuration non sensible (la clé est toujours masquée). */
+    getConfig(): {
+        baseUrl: string;
+        apiKeyMasked: string;
+    };
+}
+export interface EFactClientConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+/** @deprecated Utiliser `new EFact(secretKey, { baseUrl })`. */
+export declare class EFactClient extends EFact {
+    constructor(config: EFactClientConfig);
+    /** @deprecated Utiliser efact.invoices.create(). */
+    createInvoice(data: CreateInvoiceRequest): Promise<InvoiceResponse>;
+    /** @deprecated Utiliser efact.invoices.list(). */
+    listInvoices(params?: ListInvoicesParams): Promise<PageResponseInvoiceResponse>;
+    /** @deprecated Utiliser efact.invoices.retrieve(). */
+    getInvoice(invoiceId: string): Promise<InvoiceResponse>;
+    /** @deprecated Utiliser efact.invoices.retrieveStatus(). */
+    getInvoiceStatus(invoiceId: string): Promise<InvoiceStatusResponse>;
+    /** @deprecated Utiliser efact.invoices.update(). */
+    updateInvoice(invoiceId: string, data: UpdateInvoiceRequest): Promise<InvoiceResponse>;
+    /** @deprecated Utiliser efact.invoices.cancel(). */
+    cancelInvoice(invoiceId: string): Promise<InvoiceResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;;CAEf,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,YAAY,CAAC;AAMzD,MAAM,WAAW,YAAY;IAC3B,gFAAgF;IAChF,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,4EAA4E;IAC5E,SAAgB,QAAQ,EAAE,gBAAgB,CAAC;IAE3C;;;OAGG;gBACS,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;IAkBzD,gEAAgE;IACzD,SAAS,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;CAG9D;AAMD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gEAAgE;AAChE,qBAAa,WAAY,SAAQ,KAAK;gBACxB,MAAM,EAAE,iBAAiB;IAQrC,oDAAoD;IACpD,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAInE,kDAAkD;IAClD,YAAY,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAI/E,sDAAsD;IACtD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIvD,4DAA4D;IAC5D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAInE,oDAAoD;IACpD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAItF,oDAAoD;IACpD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAG3D"}

package/dist/client.js

@@ -0,0 +1,155 @@
+import { InvoicesApi } from "./_generated/api/invoices-api.js";
+import { EFactConfigError } from "./errors.js";
+import { createHttpInstance } from "./runtime.js";
+import { InvoicesResource } from "./invoices.js";
+/**
+ * Environnements publics et leur URL de base (host uniquement — les chemins
+ * générés portent déjà le préfixe /v1). Seuls les environnements destinés aux
+ * clients sont nommés ; le dev local passe par l'option `baseUrl`
+ * (ex. baseUrl: "http://localhost:8080").
+ *
+ * NOTE : l'URL "production" pointe temporairement sur preview, qui fait office
+ * de prod tant que l'URL de prod définitive n'est pas déployée. La changer ici
+ * (et dans les serveurs OpenAPI) suffira — aucun changement côté clients.
+ */
+export const ENVIRONMENTS = {
+    production: "https://preview.efact-api.itzenata.com",
+};
+const DEFAULT_ENVIRONMENT = "production";
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_RETRIES = 2;
+/**
+ * Client EFact e-Facture.
+ *
+ * @example
+ * const efact = new EFact(process.env.EFACT_SECRET_KEY);
+ * const invoice = await efact.invoices.create({ ... });
+ */
+export class EFact {
+    http;
+    baseUrl;
+    maskedKey;
+    /** Opérations sur les factures : efact.invoices.create/list/retrieve/... */
+    invoices;
+    /**
+     * @param secretKey Clé secrète au format efact_sk_... (jamais loggée en clair).
+     * @param options   Options facultatives (environment, baseUrl, timeout, maxRetries).
+     */
+    constructor(secretKey, options = {}) {
+        if (typeof secretKey !== "string" || secretKey.trim() === "") {
+            throw new EFactConfigError("[EFact] Erreur d'initialisation : la clé secrète est obligatoire.");
+        }
+        const key = secretKey.trim();
+        this.baseUrl = normalizeBaseUrl(resolveBaseUrl(options));
+        this.maskedKey = maskKey(key);
+        const timeoutMs = resolvePositiveInt(options.timeout, DEFAULT_TIMEOUT_MS, "timeout");
+        const maxRetries = resolveNonNegativeInt(options.maxRetries, DEFAULT_MAX_RETRIES, "maxRetries");
+        this.http = createHttpInstance(key, this.baseUrl, { timeoutMs, maxRetries });
+        // baseURL est porté par l'instance axios : InvoicesApi n'a besoin que d'elle.
+        this.invoices = new InvoicesResource(new InvoicesApi(undefined, undefined, this.http));
+    }
+    /** Configuration non sensible (la clé est toujours masquée). */
+    getConfig() {
+        return { baseUrl: this.baseUrl, apiKeyMasked: this.maskedKey };
+    }
+}
+/** @deprecated Utiliser `new EFact(secretKey, { baseUrl })`. */
+export class EFactClient extends EFact {
+    constructor(config) {
+        const opts = {};
+        if (config.baseUrl !== undefined)
+            opts.baseUrl = config.baseUrl;
+        if (config.timeout !== undefined)
+            opts.timeout = config.timeout;
+        if (config.maxRetries !== undefined)
+            opts.maxRetries = config.maxRetries;
+        super(config.apiKey, opts);
+    }
+    /** @deprecated Utiliser efact.invoices.create(). */
+    createInvoice(data) {
+        return this.invoices.create(data);
+    }
+    /** @deprecated Utiliser efact.invoices.list(). */
+    listInvoices(params) {
+        return this.invoices.list(params);
+    }
+    /** @deprecated Utiliser efact.invoices.retrieve(). */
+    getInvoice(invoiceId) {
+        return this.invoices.retrieve(invoiceId);
+    }
+    /** @deprecated Utiliser efact.invoices.retrieveStatus(). */
+    getInvoiceStatus(invoiceId) {
+        return this.invoices.retrieveStatus(invoiceId);
+    }
+    /** @deprecated Utiliser efact.invoices.update(). */
+    updateInvoice(invoiceId, data) {
+        return this.invoices.update(invoiceId, data);
+    }
+    /** @deprecated Utiliser efact.invoices.cancel(). */
+    cancelInvoice(invoiceId) {
+        return this.invoices.cancel(invoiceId);
+    }
+}
+// ============================================================================
+// Validation des options de configuration.
+// ============================================================================
+function resolveBaseUrl(options) {
+    if (options.baseUrl !== undefined) {
+        return options.baseUrl;
+    }
+    const env = options.environment ?? DEFAULT_ENVIRONMENT;
+    const url = ENVIRONMENTS[env];
+    if (url === undefined) {
+        const known = Object.keys(ENVIRONMENTS).join(", ");
+        throw new EFactConfigError(`[EFact] environment inconnu : "${env}". Valeurs valides : ${known}.`);
+    }
+    return url;
+}
+/** Valide la baseUrl (URL absolue http/https) et avertit si non-HTTPS hors localhost. */
+function normalizeBaseUrl(raw) {
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        throw new EFactConfigError(`[EFact] baseUrl invalide : "${raw}" n'est pas une URL absolue.`);
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new EFactConfigError(`[EFact] baseUrl invalide : protocole "${parsed.protocol}" non supporté (http/https requis).`);
+    }
+    const isLocal = parsed.hostname === "localhost" ||
+        parsed.hostname === "127.0.0.1" ||
+        parsed.hostname === "[::1]" ||
+        parsed.hostname === "::1";
+    if (parsed.protocol === "http:" && !isLocal) {
+        console.warn(`[EFact] Attention : baseUrl utilise HTTP non chiffré (${parsed.origin}). ` +
+            "La clé secrète transiterait en clair. Utilisez HTTPS en production.");
+    }
+    return raw;
+}
+/**
+ * Version masquée de la clé : au plus 4 caractères de tête/queue, jamais plus
+ * de la moitié d'une clé courte. Pour le diagnostic.
+ */
+function maskKey(k) {
+    if (k.length <= 8)
+        return "****";
+    return `${k.slice(0, 4)}...${k.slice(-4)}`;
+}
+function resolvePositiveInt(value, fallback, name) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new EFactConfigError(`[EFact] Option "${name}" invalide : un nombre positif est attendu.`);
+    }
+    return Math.floor(value);
+}
+function resolveNonNegativeInt(value, fallback, name) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isFinite(value) || value < 0) {
+        throw new EFactConfigError(`[EFact] Option "${name}" invalide : un entier >= 0 est attendu.`);
+    }
+    return Math.floor(value);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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