@facturino/node 1.0.0

package/dist/cjs/types.js

@@ -0,0 +1,5 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/webhooks.d.ts

@@ -0,0 +1,14 @@
+import type { WebhookEvent } from './types.js';
+export interface WebhookVerifyOptions {
+    /** Max event age in seconds (default: 300). */
+    tolerance?: number;
+}
+/** HMAC-SHA256 webhook signature verification. Header format: `t=<ts>,v1=<sig>` */
+export declare class Webhooks {
+    /** Verify signature and parse the event payload. */
+    constructEvent(payload: string | Buffer, signature: string, secret: string, options?: WebhookVerifyOptions): WebhookEvent;
+    /** Verify signature without parsing. Throws on mismatch or stale timestamp. */
+    verifySignature(payload: string | Buffer, signature: string, secret: string, options?: WebhookVerifyOptions): void;
+    /** Generate a test signature header. */
+    generateTestSignature(payload: string, secret: string, timestamp?: number): string;
+}

package/dist/cjs/webhooks.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Webhooks = void 0;
+const node_crypto_1 = require("node:crypto");
+const errors_js_1 = require("./errors.js");
+const DEFAULT_TOLERANCE_SECONDS = 300; // 5 minutes
+/** HMAC-SHA256 webhook signature verification. Header format: `t=<ts>,v1=<sig>` */
+class Webhooks {
+    /** Verify signature and parse the event payload. */
+    constructEvent(payload, signature, secret, options) {
+        this.verifySignature(payload, signature, secret, options);
+        const body = typeof payload === 'string' ? payload : payload.toString('utf-8');
+        const event = JSON.parse(body);
+        return event;
+    }
+    /** Verify signature without parsing. Throws on mismatch or stale timestamp. */
+    verifySignature(payload, signature, secret, options) {
+        if (!signature) {
+            throw new errors_js_1.FacturinoError('Missing Facturino-Signature header');
+        }
+        if (!secret) {
+            throw new errors_js_1.FacturinoError('Missing webhook signing secret');
+        }
+        const tolerance = options?.tolerance ?? DEFAULT_TOLERANCE_SECONDS;
+        const parts = signature.split(',');
+        const timestampPart = parts.find((p) => p.startsWith('t='));
+        const signaturePart = parts.find((p) => p.startsWith('v1='));
+        if (!timestampPart || !signaturePart) {
+            throw new errors_js_1.FacturinoError('Invalid Facturino-Signature header format. Expected "t=<timestamp>,v1=<signature>".');
+        }
+        const timestamp = parseInt(timestampPart.slice(2), 10);
+        const expectedSignature = signaturePart.slice(3);
+        if (Number.isNaN(timestamp)) {
+            throw new errors_js_1.FacturinoError('Invalid timestamp in Facturino-Signature header');
+        }
+        const now = Math.floor(Date.now() / 1000);
+        if (Math.abs(now - timestamp) > tolerance) {
+            throw new errors_js_1.FacturinoError(`Webhook timestamp is outside tolerance of ${tolerance} seconds. ` +
+                `Event timestamp: ${timestamp}, current time: ${now}.`);
+        }
+        const payloadStr = typeof payload === 'string' ? payload : payload.toString('utf-8');
+        const signedPayload = `${timestamp}.${payloadStr}`;
+        const computedSignature = (0, node_crypto_1.createHmac)('sha256', secret)
+            .update(signedPayload)
+            .digest('hex');
+        const expectedBuf = Buffer.from(expectedSignature, 'hex');
+        const computedBuf = Buffer.from(computedSignature, 'hex');
+        if (expectedBuf.length !== computedBuf.length ||
+            !(0, node_crypto_1.timingSafeEqual)(expectedBuf, computedBuf)) {
+            throw new errors_js_1.FacturinoError('Webhook signature verification failed. The payload may have been tampered with.');
+        }
+    }
+    /** Generate a test signature header. */
+    generateTestSignature(payload, secret, timestamp) {
+        const ts = timestamp ?? Math.floor(Date.now() / 1000);
+        const signedPayload = `${ts}.${payload}`;
+        const signature = (0, node_crypto_1.createHmac)('sha256', secret)
+            .update(signedPayload)
+            .digest('hex');
+        return `t=${ts},v1=${signature}`;
+    }
+}
+exports.Webhooks = Webhooks;

package/dist/esm/client.d.ts

@@ -0,0 +1,25 @@
+import type { FacturinoConfig, RequestOptions } from './types.js';
+/** HTTP client with retries, exponential backoff, and structured errors. */
+export declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly maxRetries;
+    private readonly timeout;
+    private readonly apiVersion;
+    constructor(apiKey: string, config?: FacturinoConfig);
+    request<T>(method: string, path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    patch<T>(path: string, body: unknown): Promise<T>;
+    del<T>(path: string, body?: unknown): Promise<T>;
+    /**
+     * Map an HTTP status + error body to the most specific {@link ApiError}
+     * subclass. Both the status and the `error.type` from the body are used:
+     * the status decides the primary class (401 → Authentication, 429 →
+     * RateLimit…) but for 4xx codes that share a status — notably 422 vs
+     * 400 — we look at `body.error.type` to discriminate further.
+     */
+    private buildError;
+    private getRetryDelay;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgB,cAAc,EAAE,MAAM,YAAY,CAAA;AA0B/E,4EAA4E;AAC5E,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEvB,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,eAAoB;IAoBlD,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAqHP,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAI3E,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAItD;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAgDlB,OAAO,CAAC,aAAa;CAStB"}

package/dist/esm/client.js

@@ -0,0 +1,200 @@
+import { ApiError, ApiInternalError, AuthenticationError, ConflictError, ConnectionError, InvalidRequestError, NotFoundError, PermissionError, PlanLimitError, RateLimitError, ValidationError, } from './errors.js';
+const DEFAULT_BASE_URL = 'https://facturino.com/api';
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_TIMEOUT = 30000;
+const DEFAULT_API_VERSION = '2026-03-01';
+const RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503]);
+const INITIAL_RETRY_DELAY_MS = 500;
+const MAX_RETRY_DELAY_MS = 30000;
+const VERSION = '1.0.0';
+/** HTTP client with retries, exponential backoff, and structured errors. */
+export class HttpClient {
+    constructor(apiKey, config = {}) {
+        if (!apiKey) {
+            throw new Error('No API key provided. Pass your key as the first argument: new Facturino("fac_test_...")');
+        }
+        if (!apiKey.startsWith('fac_test_') && !apiKey.startsWith('fac_live_')) {
+            throw new Error('Invalid API key format. Keys must start with "fac_test_" or "fac_live_".');
+        }
+        this.apiKey = apiKey;
+        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.timeout = config.timeout ?? DEFAULT_TIMEOUT;
+        this.apiVersion = config.apiVersion ?? DEFAULT_API_VERSION;
+    }
+    async request(method, path, body, options) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+            'Facturino-Version': this.apiVersion,
+            'User-Agent': `facturino-node/${VERSION}`,
+        };
+        if (options?.idempotencyKey) {
+            headers['Idempotency-Key'] = options.idempotencyKey;
+        }
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            if (attempt > 0) {
+                const delay = this.getRetryDelay(attempt, lastError);
+                await sleep(delay);
+            }
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+            try {
+                const fetchOptions = {
+                    method,
+                    headers,
+                    signal: controller.signal,
+                };
+                if (body !== undefined && method !== 'GET') {
+                    fetchOptions.body = JSON.stringify(body);
+                }
+                const response = await fetch(url, fetchOptions);
+                clearTimeout(timeoutId);
+                if (response.status === 204) {
+                    return undefined;
+                }
+                let responseBody;
+                const contentType = response.headers.get('content-type') ?? '';
+                if (contentType.includes('application/json')) {
+                    responseBody = await response.json();
+                }
+                else {
+                    const text = await response.text();
+                    responseBody = text;
+                }
+                if (response.ok) {
+                    return responseBody;
+                }
+                const errorBody = responseBody;
+                const hasStructuredError = errorBody &&
+                    typeof errorBody === 'object' &&
+                    'error' in errorBody &&
+                    typeof errorBody.error === 'object';
+                if (!hasStructuredError) {
+                    const syntheticError = {
+                        error: {
+                            type: 'api_error',
+                            code: 'unknown',
+                            message: typeof responseBody === 'string' ? responseBody : `HTTP ${response.status}`,
+                            request_id: response.headers.get('x-request-id') ?? 'req_unknown',
+                        },
+                    };
+                    lastError = this.buildError(response.status, syntheticError, response.headers);
+                }
+                else {
+                    lastError = this.buildError(response.status, errorBody, response.headers);
+                }
+                if (RETRYABLE_STATUS_CODES.has(response.status) && attempt < this.maxRetries) {
+                    continue;
+                }
+                throw lastError;
+            }
+            catch (err) {
+                clearTimeout(timeoutId);
+                if (err instanceof ApiError) {
+                    throw err;
+                }
+                if (err instanceof Error && err.name === 'AbortError') {
+                    lastError = new ConnectionError(`Request to ${method} ${path} timed out after ${this.timeout}ms`);
+                    if (attempt < this.maxRetries) {
+                        continue;
+                    }
+                    throw lastError;
+                }
+                if (err instanceof TypeError && (err.message.includes('fetch') || err.message.includes('network'))) {
+                    lastError = new ConnectionError(`Network error on ${method} ${path}: ${err.message}`);
+                    if (attempt < this.maxRetries) {
+                        continue;
+                    }
+                    throw lastError;
+                }
+                throw err;
+            }
+        }
+        throw lastError ?? new ConnectionError('Request failed after all retries');
+    }
+    async get(path) {
+        return this.request('GET', path);
+    }
+    async post(path, body, options) {
+        return this.request('POST', path, body, options);
+    }
+    async patch(path, body) {
+        return this.request('PATCH', path, body);
+    }
+    async del(path, body) {
+        return this.request('DELETE', path, body);
+    }
+    /**
+     * Map an HTTP status + error body to the most specific {@link ApiError}
+     * subclass. Both the status and the `error.type` from the body are used:
+     * the status decides the primary class (401 → Authentication, 429 →
+     * RateLimit…) but for 4xx codes that share a status — notably 422 vs
+     * 400 — we look at `body.error.type` to discriminate further.
+     */
+    buildError(status, body, headers) {
+        const type = body?.error?.type;
+        switch (status) {
+            case 400:
+                return new InvalidRequestError(status, body);
+            case 401:
+                return new AuthenticationError(status, body);
+            case 402:
+                return new PlanLimitError(status, body);
+            case 403:
+                return new PermissionError(status, body);
+            case 404:
+                return new NotFoundError(status, body);
+            case 409:
+                return new ConflictError(status, body);
+            case 422:
+                return new ValidationError(status, body);
+            case 429: {
+                const retryAfterHeader = headers.get('retry-after');
+                const retryAfter = retryAfterHeader ? parseInt(retryAfterHeader, 10) : null;
+                return new RateLimitError(status, body, Number.isNaN(retryAfter) ? null : retryAfter);
+            }
+            case 500:
+            case 502:
+            case 503:
+            case 504:
+                return new ApiInternalError(status, body);
+            default:
+                // Use the body `type` as a fallback for non-standard status codes so
+                // a 418 with `type: 'rate_limit_error'` still maps to the right
+                // class instead of falling through to the generic `ApiError`.
+                if (type === 'validation_error')
+                    return new ValidationError(status, body);
+                if (type === 'authentication_error')
+                    return new AuthenticationError(status, body);
+                if (type === 'permission_error')
+                    return new PermissionError(status, body);
+                if (type === 'conflict_error')
+                    return new ConflictError(status, body);
+                if (type === 'plan_limit_error')
+                    return new PlanLimitError(status, body);
+                if (type === 'rate_limit_error')
+                    return new RateLimitError(status, body, null);
+                if (type === 'not_found_error')
+                    return new NotFoundError(status, body);
+                if (type === 'api_error')
+                    return new ApiInternalError(status, body);
+                return new ApiError(status, body);
+        }
+    }
+    getRetryDelay(attempt, lastError) {
+        if (lastError instanceof RateLimitError && lastError.retryAfter !== null) {
+            return Math.min(lastError.retryAfter * 1000, MAX_RETRY_DELAY_MS);
+        }
+        const baseDelay = INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt - 1);
+        const jitter = baseDelay * 0.2 * Math.random();
+        return Math.min(baseDelay + jitter, MAX_RETRY_DELAY_MS);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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

package/dist/esm/errors.d.ts

@@ -0,0 +1,77 @@
+import type { ApiErrorBody } from './types.js';
+/** Base SDK error. */
+export declare class FacturinoError extends Error {
+    constructor(message: string);
+}
+/** Structured API error response. */
+export declare class ApiError extends FacturinoError {
+    readonly status: number;
+    readonly type: string;
+    readonly code: string;
+    readonly param?: string;
+    readonly docUrl?: string;
+    readonly requestId: string;
+    readonly hint?: string;
+    constructor(status: number, body: ApiErrorBody);
+}
+/**
+ * 400 — request payload is malformed, a field is missing or invalid.
+ * Inspect `error.param` to identify the offending field.
+ */
+export declare class InvalidRequestError extends ApiError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/**
+ * 422 — Zod schema validation rejected the payload. The offending field is
+ * surfaced in `error.param`. Distinct from {@link InvalidRequestError} so
+ * callers can differentiate "shape malformed" (400) from "value out of
+ * range / wrong type" (422) when re-displaying validation feedback.
+ */
+export declare class ValidationError extends ApiError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/** 401 — invalid, revoked, or missing API key. */
+export declare class AuthenticationError extends ApiError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/**
+ * 403 — the API key authenticated successfully but lacks the scope required
+ * for the requested operation. The required scope is exposed in
+ * `error.param`.
+ */
+export declare class PermissionError extends ApiError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/** 404 — resource not found, or not visible with this key's livemode. */
+export declare class NotFoundError extends ApiError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/**
+ * 409 — the request conflicts with the current state of the resource
+ * (state-machine transition refused, finalized invoice cannot be edited,
+ * idempotency key reused with a different payload).
+ */
+export declare class ConflictError extends ApiError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/** 429 — rate limit exceeded. `retryAfter` is the recommended back-off in seconds. */
+export declare class RateLimitError extends ApiError {
+    readonly retryAfter: number | null;
+    constructor(status: number, body: ApiErrorBody, retryAfter: number | null);
+}
+/** 402 — quota or plan limit exceeded. Upgrade or revoke resources to recover. */
+export declare class PlanLimitError extends ApiError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/**
+ * 500/503 — Facturino is experiencing an internal error. The API is monitored
+ * automatically; safe to retry with exponential back-off.
+ */
+export declare class ApiInternalError extends ApiError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/** Network or timeout error. Not surfaced by the API itself. */
+export declare class ConnectionError extends FacturinoError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,sBAAsB;AACtB,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAK5B;AAED,qCAAqC;AACrC,qBAAa,QAAS,SAAQ,cAAc;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAY/C;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED,kDAAkD;AAClD,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED,yEAAyE;AACzE,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED,sFAAsF;AACtF,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;gBAEtB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;CAK1E;AAED,kFAAkF;AAClF,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;gBAChC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED,gEAAgE;AAChE,qBAAa,eAAgB,SAAQ,cAAc;gBACrC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/esm/errors.js

@@ -0,0 +1,114 @@
+/** Base SDK error. */
+export class FacturinoError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FacturinoError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** Structured API error response. */
+export class ApiError extends FacturinoError {
+    constructor(status, body) {
+        const err = body.error;
+        super(err.message);
+        this.name = 'ApiError';
+        this.status = status;
+        this.type = err.type;
+        this.code = err.code;
+        this.param = err.param;
+        this.docUrl = err.doc_url;
+        this.requestId = err.request_id;
+        this.hint = err.hint;
+    }
+}
+/**
+ * 400 — request payload is malformed, a field is missing or invalid.
+ * Inspect `error.param` to identify the offending field.
+ */
+export class InvalidRequestError extends ApiError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = 'InvalidRequestError';
+    }
+}
+/**
+ * 422 — Zod schema validation rejected the payload. The offending field is
+ * surfaced in `error.param`. Distinct from {@link InvalidRequestError} so
+ * callers can differentiate "shape malformed" (400) from "value out of
+ * range / wrong type" (422) when re-displaying validation feedback.
+ */
+export class ValidationError extends ApiError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = 'ValidationError';
+    }
+}
+/** 401 — invalid, revoked, or missing API key. */
+export class AuthenticationError extends ApiError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * 403 — the API key authenticated successfully but lacks the scope required
+ * for the requested operation. The required scope is exposed in
+ * `error.param`.
+ */
+export class PermissionError extends ApiError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = 'PermissionError';
+    }
+}
+/** 404 — resource not found, or not visible with this key's livemode. */
+export class NotFoundError extends ApiError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * 409 — the request conflicts with the current state of the resource
+ * (state-machine transition refused, finalized invoice cannot be edited,
+ * idempotency key reused with a different payload).
+ */
+export class ConflictError extends ApiError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = 'ConflictError';
+    }
+}
+/** 429 — rate limit exceeded. `retryAfter` is the recommended back-off in seconds. */
+export class RateLimitError extends ApiError {
+    constructor(status, body, retryAfter) {
+        super(status, body);
+        this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+/** 402 — quota or plan limit exceeded. Upgrade or revoke resources to recover. */
+export class PlanLimitError extends ApiError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = 'PlanLimitError';
+    }
+}
+/**
+ * 500/503 — Facturino is experiencing an internal error. The API is monitored
+ * automatically; safe to retry with exponential back-off.
+ */
+export class ApiInternalError extends ApiError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = 'ApiInternalError';
+    }
+}
+/** Network or timeout error. Not surfaced by the API itself. */
+export class ConnectionError extends FacturinoError {
+    constructor(message) {
+        super(message);
+        this.name = 'ConnectionError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,60 @@
+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';
+import type { FacturinoConfig } from './types.js';
+/** Facturino API client for French e-invoicing — initialize with your API key to access all resources. */
+declare class Facturino {
+    readonly account: AccountResource;
+    readonly billing: Billing;
+    readonly invoices: Invoices;
+    readonly payments: Payments;
+    readonly customers: Customers;
+    readonly products: Products;
+    readonly quotes: Quotes;
+    readonly creditNotes: CreditNotes;
+    readonly events: Events;
+    readonly webhookEndpoints: WebhookEndpoints;
+    readonly recurringInvoices: RecurringInvoices;
+    readonly companies: Companies;
+    readonly exports: Exports;
+    readonly ereporting: EReportingResource;
+    readonly jobs: Jobs;
+    readonly reference: Reference;
+    readonly sandbox: Sandbox;
+    readonly usage: Usage;
+    readonly validate: Validate;
+    readonly webhooks: Webhooks;
+    readonly receivedInvoices: ReceivedInvoices;
+    readonly reporting: Reporting;
+    readonly archives: Archives;
+    readonly health: Health;
+    constructor(apiKey: string, config?: FacturinoConfig);
+}
+export default Facturino;
+export { Facturino };
+export type { FacturinoConfig, RequestOptions, PaginationParams, PaginatedResponse, ApiErrorBody, Address, Contact, ContactRole, LineItem, VatBreakdown, Totals, CustomerRef, CustomerSnapshot, LifecycleEntry, Currency, Unit, VatCode, VatexCode, PaymentMethod, InvoiceType, InvoiceStatus, InvoiceDates, InvoicePaymentTerms, InvoiceEinvoicing, InvoicePortal, InvoiceArchive, InvoiceFiles, Invoice, InvoiceExpandField, InvoiceExpanded, InvoiceRetrieveParams, InvoiceBuyerParam, InvoiceCreateDates, InvoiceCreateParams, InvoiceLineItemParam, InvoiceUpdateParams, InvoiceListParams, IncomingInvoiceCreateParams, InvoiceStatusResponse, InvoiceVerifyResponse, DocumentUrlResponse, JobResponse, PaymentLinkResponse, PaymentLinkCreateParams, PaymentTokenResponse, Payment, PaymentCreateParams, Customer, CustomerCreateParams, CustomerUpdateParams, CustomerListParams, CustomerLookupParams, SireneLookupResponse, SireneCompany, Product, PriceHistoryEntry, ProductCreateParams, ProductUpdateParams, ProductListParams, QuoteStatus, QuoteDates, QuoteSignature, Quote, QuoteCreateParams, QuoteUpdateParams, QuoteListParams, CreditNoteType, CreditNoteStatus, CreditNoteReasonCode, CreditNote, CreditNoteCreateParams, CreditNoteUpdateParams, CreditNoteListParams, WebhookEventType, WebhookEvent, EventListParams, WebhookEndpoint, WebhookEndpointCreateParams, WebhookEndpointUpdateParams, RecurringFrequency, RecurringInvoice, RecurringInvoiceCreateParams, RecurringInvoiceUpdateParams, RecurringInvoiceListParams, BankDetails, InvoiceSettings, CreditNoteSettings, CreditNoteNumberingMode, Company, CompanyUpdateParams, CgvResponse, FecExportParams, EReportingType, EReportingStatus, EReportingLine, EReportingLineResponse, EReporting, EReportingCreateParams, EReportingListParams, JobType, JobStatus, Job, SandboxResetResponse, SimulateStatusParams, SimulateStatusResponse, ReceivedInvoiceStatus, ReceivedInvoice, ReceivedInvoiceListParams, ReceivedInvoiceRefuseParams, ReceivedInvoiceRecordPaymentParams, ReceivedInvoiceActionResponse, VatReportParams, VatReportBreakdown, VatReport, RevenueReportParams, RevenueReportBreakdownItem, RevenueReport, AccountPlan, Account, BillingCycle, BillingSubscription, PlatformInvoice, UsageMeter, UsageSummary, ValidateParams, ValidateResponse, LegalForm, NafCode, LegalFormInput, NafCodeInput, PaProvider, HealthStatus, } from './types.js';
+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.d.ts.map

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

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