@elyonar/einvoice-js 0.1.0

package/dist/cjs/types/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../../src/types/webhook.ts"],"names":[],"mappings":";AAAA,8CAA8C;AAC9C,sBAAsB;AACtB,8CAA8C"}

package/dist/cjs/webhooks/index.d.ts

@@ -0,0 +1,3 @@
+export { verifyWebhook } from './verify.js';
+export type { VerifyWebhookOptions } from './verify.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/webhooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/webhooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/cjs/webhooks/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyWebhook = void 0;
+var verify_js_1 = require("./verify.js");
+Object.defineProperty(exports, "verifyWebhook", { enumerable: true, get: function () { return verify_js_1.verifyWebhook; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/webhooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/webhooks/index.ts"],"names":[],"mappings":";;;AAAA,yCAA4C;AAAnC,0GAAA,aAAa,OAAA"}

package/dist/cjs/webhooks/verify.d.ts

@@ -0,0 +1,43 @@
+import type { WebhookEvent, WebhookHeaders } from '../types/webhook.js';
+export interface VerifyWebhookOptions {
+    /**
+     * Maximum allowed age of the webhook timestamp (in seconds).
+     * Prevents replay attacks.
+     * @default 300
+     */
+    toleranceSeconds?: number;
+}
+/**
+ * Verify and parse a webhook event from the E-Invoice platform.
+ *
+ * Performs HMAC-SHA256 signature verification with timing-safe comparison
+ * and replay protection via timestamp validation.
+ *
+ * @param payload - The raw request body (string or Buffer).
+ * @param headers - The webhook request headers (or a plain object with the relevant keys).
+ * @param secret - Your webhook signing secret.
+ * @param options - Optional verification options.
+ * @returns The parsed and verified webhook event.
+ * @throws {EInvoiceWebhookError} If verification fails.
+ *
+ * @example
+ * ```ts
+ * import { verifyWebhook } from '@elyonar/einvoice-js/webhooks';
+ *
+ * app.post('/webhooks/einvoice', (req, res) => {
+ *   try {
+ *     const event = verifyWebhook(req.body, req.headers, process.env.WEBHOOK_SECRET);
+ *     switch (event.eventType) {
+ *       case 'invoice.approved':
+ *         // Handle approved invoice
+ *         break;
+ *     }
+ *     res.sendStatus(200);
+ *   } catch (err) {
+ *     res.sendStatus(400);
+ *   }
+ * });
+ * ```
+ */
+export declare function verifyWebhook<T = Record<string, unknown>>(payload: string | Buffer, headers: Partial<WebhookHeaders> | Record<string, string | string[] | undefined>, secret: string, options?: VerifyWebhookOptions): WebhookEvent<T>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/cjs/webhooks/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/webhooks/verify.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQxE,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EAChF,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,YAAY,CAAC,CAAC,CAAC,CAgDjB"}

package/dist/cjs/webhooks/verify.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyWebhook = verifyWebhook;
+const node_crypto_1 = require("node:crypto");
+const errors_js_1 = require("../errors.js");
+/**
+ * Maximum age (in seconds) for a webhook timestamp before it's considered stale.
+ * Default: 300 seconds (5 minutes).
+ */
+const DEFAULT_TOLERANCE_SECONDS = 300;
+/**
+ * Verify and parse a webhook event from the E-Invoice platform.
+ *
+ * Performs HMAC-SHA256 signature verification with timing-safe comparison
+ * and replay protection via timestamp validation.
+ *
+ * @param payload - The raw request body (string or Buffer).
+ * @param headers - The webhook request headers (or a plain object with the relevant keys).
+ * @param secret - Your webhook signing secret.
+ * @param options - Optional verification options.
+ * @returns The parsed and verified webhook event.
+ * @throws {EInvoiceWebhookError} If verification fails.
+ *
+ * @example
+ * ```ts
+ * import { verifyWebhook } from '@elyonar/einvoice-js/webhooks';
+ *
+ * app.post('/webhooks/einvoice', (req, res) => {
+ *   try {
+ *     const event = verifyWebhook(req.body, req.headers, process.env.WEBHOOK_SECRET);
+ *     switch (event.eventType) {
+ *       case 'invoice.approved':
+ *         // Handle approved invoice
+ *         break;
+ *     }
+ *     res.sendStatus(200);
+ *   } catch (err) {
+ *     res.sendStatus(400);
+ *   }
+ * });
+ * ```
+ */
+function verifyWebhook(payload, headers, secret, options) {
+    const tolerance = options?.toleranceSeconds ?? DEFAULT_TOLERANCE_SECONDS;
+    // Extract headers (case-insensitive)
+    const signature = getHeader(headers, 'x-webhook-signature');
+    const timestamp = getHeader(headers, 'x-webhook-timestamp');
+    if (!signature) {
+        throw new errors_js_1.EInvoiceWebhookError('Missing X-Webhook-Signature header');
+    }
+    if (!timestamp) {
+        throw new errors_js_1.EInvoiceWebhookError('Missing X-Webhook-Timestamp header');
+    }
+    // Validate timestamp (replay protection)
+    const webhookTime = parseInt(timestamp, 10);
+    if (isNaN(webhookTime)) {
+        throw new errors_js_1.EInvoiceWebhookError('Invalid X-Webhook-Timestamp header');
+    }
+    const now = Math.floor(Date.now() / 1000);
+    if (Math.abs(now - webhookTime) > tolerance) {
+        throw new errors_js_1.EInvoiceWebhookError(`Webhook timestamp too old. Received: ${webhookTime}, current: ${now}, tolerance: ${tolerance}s`);
+    }
+    // Build the signed payload: "{timestamp}.{rawBody}"
+    const rawBody = typeof payload === 'string' ? payload : payload.toString('utf-8');
+    const signedPayload = `${timestamp}.${rawBody}`;
+    // Compute expected signature
+    const expectedSignature = `sha256=${(0, node_crypto_1.createHmac)('sha256', secret).update(signedPayload).digest('hex')}`;
+    // Timing-safe comparison
+    const sigBuffer = Buffer.from(signature, 'utf-8');
+    const expectedBuffer = Buffer.from(expectedSignature, 'utf-8');
+    if (sigBuffer.length !== expectedBuffer.length || !(0, node_crypto_1.timingSafeEqual)(sigBuffer, expectedBuffer)) {
+        throw new errors_js_1.EInvoiceWebhookError('Webhook signature verification failed');
+    }
+    // Parse and return the event
+    try {
+        return JSON.parse(rawBody);
+    }
+    catch {
+        throw new errors_js_1.EInvoiceWebhookError('Failed to parse webhook payload as JSON');
+    }
+}
+/**
+ * Extract a header value, handling case insensitivity and arrays.
+ */
+function getHeader(headers, key) {
+    // Try exact match first, then lowercase
+    const value = headers[key] ?? headers[key.toLowerCase()];
+    if (Array.isArray(value))
+        return value[0];
+    return value;
+}
+//# sourceMappingURL=verify.js.map

package/dist/cjs/webhooks/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../src/webhooks/verify.ts"],"names":[],"mappings":";;AAmDA,sCAqDC;AAxGD,6CAA0D;AAC1D,4CAAoD;AAGpD;;;GAGG;AACH,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAWtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,SAAgB,aAAa,CAC3B,OAAwB,EACxB,OAAgF,EAChF,MAAc,EACd,OAA8B;IAE9B,MAAM,SAAS,GAAG,OAAO,EAAE,gBAAgB,IAAI,yBAAyB,CAAC;IAEzE,qCAAqC;IACrC,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IAE5D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,gCAAoB,CAAC,oCAAoC,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,gCAAoB,CAAC,oCAAoC,CAAC,CAAC;IACvE,CAAC;IAED,yCAAyC;IACzC,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,gCAAoB,CAAC,oCAAoC,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,WAAW,CAAC,GAAG,SAAS,EAAE,CAAC;QAC5C,MAAM,IAAI,gCAAoB,CAC5B,wCAAwC,WAAW,cAAc,GAAG,gBAAgB,SAAS,GAAG,CACjG,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClF,MAAM,aAAa,GAAG,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;IAEhD,6BAA6B;IAC7B,MAAM,iBAAiB,GAAG,UAAU,IAAA,wBAAU,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAEvG,yBAAyB;IACzB,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAE/D,IAAI,SAAS,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM,IAAI,CAAC,IAAA,6BAAe,EAAC,SAAS,EAAE,cAAc,CAAC,EAAE,CAAC;QAC9F,MAAM,IAAI,gCAAoB,CAAC,uCAAuC,CAAC,CAAC;IAC1E,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gCAAoB,CAAC,yCAAyC,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAChB,OAAsD,EACtD,GAAW;IAEX,wCAAwC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/esm/client/http-client.d.ts

@@ -0,0 +1,52 @@
+import type { ApiResponse, RequestOptions as PerRequestOptions } from '../types/common.js';
+export interface HttpClientConfig {
+    /**
+     * API key for authentication. Must start with `sk_live_` or `sk_test_`.
+     */
+    apiKey: string;
+    /**
+     * Base URL of the E-Invoice API gateway.
+     * @default 'https://api.einvoice.ng'
+     */
+    baseUrl?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Maximum number of retry attempts for failed requests.
+     * Only 5xx errors and 429 rate limits are retried.
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Base delay for exponential backoff (in milliseconds).
+     * @default 1000
+     */
+    retryBaseDelay?: number;
+}
+export interface InternalRequestOptions {
+    method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    path: string;
+    body?: unknown;
+    query?: Record<string, string | number | boolean | undefined>;
+    requestOptions?: PerRequestOptions;
+}
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeout;
+    private readonly maxRetries;
+    private readonly retryBaseDelay;
+    constructor(config: HttpClientConfig);
+    /**
+     * Make an authenticated HTTP request to the E-Invoice API.
+     */
+    request<T>(options: InternalRequestOptions): Promise<ApiResponse<T>>;
+    private doFetch;
+    private buildUrl;
+    private calculateBackoff;
+    private sleep;
+}
+//# sourceMappingURL=http-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../src/client/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAY3F,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC9D,cAAc,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAMD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,EAAE,gBAAgB;IAYpC;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YA2D5D,OAAO;IAgCrB,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,KAAK;CAGd"}

package/dist/esm/client/http-client.js

@@ -0,0 +1,113 @@
+import { EInvoiceApiError, EInvoiceRateLimitError, EInvoiceTimeoutError, EInvoiceConfigError, } from '../errors.js';
+// ═══════════════════════════════════════════
+// HTTP Client
+// ═══════════════════════════════════════════
+export class HttpClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    maxRetries;
+    retryBaseDelay;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new EInvoiceConfigError('API key is required. Pass `apiKey` to the client constructor.');
+        }
+        this.baseUrl = (config.baseUrl ?? 'https://api.einvoice.ng').replace(/\/$/, '');
+        this.apiKey = config.apiKey;
+        this.timeout = config.timeout ?? 30_000;
+        this.maxRetries = config.maxRetries ?? 3;
+        this.retryBaseDelay = config.retryBaseDelay ?? 1000;
+    }
+    /**
+     * Make an authenticated HTTP request to the E-Invoice API.
+     */
+    async request(options) {
+        const url = this.buildUrl(options.path, options.query);
+        const timeout = options.requestOptions?.timeout ?? this.timeout;
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            if (attempt > 0) {
+                const delay = this.calculateBackoff(attempt);
+                await this.sleep(delay);
+            }
+            try {
+                const response = await this.doFetch(url, options, timeout);
+                // Handle rate limiting
+                if (response.status === 429) {
+                    const retryAfter = parseInt(response.headers.get('retry-after') ?? '5', 10);
+                    if (attempt < this.maxRetries) {
+                        await this.sleep(retryAfter * 1000);
+                        continue;
+                    }
+                    throw new EInvoiceRateLimitError('Rate limit exceeded', retryAfter);
+                }
+                const body = await response.json();
+                if (!response.ok) {
+                    const meta = body?.meta;
+                    throw new EInvoiceApiError(meta?.message ?? `HTTP ${response.status}`, response.status, meta?.errors?.[0]?.code, meta?.errors ?? []);
+                }
+                return body;
+            }
+            catch (error) {
+                // Convert AbortError to timeout error
+                if (error instanceof DOMException && error.name === 'AbortError') {
+                    throw new EInvoiceTimeoutError(timeout);
+                }
+                lastError = error;
+                // Don't retry client errors (4xx except 429, which is handled above)
+                if (error instanceof EInvoiceApiError && error.statusCode < 500) {
+                    throw error;
+                }
+                if (attempt === this.maxRetries) {
+                    throw lastError;
+                }
+            }
+        }
+        throw lastError ?? new Error('Request failed after retries');
+    }
+    async doFetch(url, options, timeout) {
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+            ...options.requestOptions?.headers,
+        };
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        // If the caller provided an AbortSignal, wire it up
+        if (options.requestOptions?.signal) {
+            options.requestOptions.signal.addEventListener('abort', () => controller.abort());
+        }
+        try {
+            return await fetch(url, {
+                method: options.method,
+                headers,
+                body: options.body ? JSON.stringify(options.body) : undefined,
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    buildUrl(path, query) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined && value !== null && value !== '') {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    calculateBackoff(attempt) {
+        const base = this.retryBaseDelay * Math.pow(2, attempt - 1);
+        const jitter = Math.random() * base * 0.1;
+        return base + jitter;
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/esm/client/http-client.js.map

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

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

@@ -0,0 +1,3 @@
+export { HttpClient } from './http-client.js';
+export type { HttpClientConfig, InternalRequestOptions } from './http-client.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/client/index.js

@@ -0,0 +1,2 @@
+export { HttpClient } from './http-client.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/einvoice.d.ts

@@ -0,0 +1,69 @@
+import type { HttpClientConfig } from './client/http-client.js';
+import { InvoiceService } from './services/invoices.js';
+import { SellerService } from './services/sellers.js';
+import { BuyerService } from './services/buyers.js';
+import { BillingService } from './services/billing.js';
+/**
+ * The main E-Invoice SDK client.
+ *
+ * Provides access to all E-Invoice platform APIs through typed service objects.
+ *
+ * @example
+ * ```ts
+ * import { EInvoice } from '@elyonar/einvoice-js';
+ *
+ * const client = new EInvoice({ apiKey: 'sk_test_...' });
+ *
+ * // Invoices
+ * const invoice = await client.invoices.create({ ... });
+ * await client.invoices.submit(invoice.data.id);
+ *
+ * // Sellers & Buyers
+ * const sellers = await client.sellers.list();
+ * const buyers = await client.buyers.search('Acme');
+ *
+ * // Billing
+ * const balance = await client.billing.getAccount();
+ * ```
+ */
+export declare class EInvoice {
+    /** @internal */
+    private readonly httpClient;
+    /**
+     * Invoice management: create, submit, validate, download, and more.
+     */
+    readonly invoices: InvoiceService;
+    /**
+     * Seller management: register, update, verify TIN.
+     */
+    readonly sellers: SellerService;
+    /**
+     * Buyer management: register, update, verify TIN.
+     */
+    readonly buyers: BuyerService;
+    /**
+     * Billing management: account, credits, subscriptions, payments, analytics.
+     */
+    readonly billing: BillingService;
+    /**
+     * Create a new E-Invoice SDK client.
+     *
+     * @param config - Client configuration. At minimum, `apiKey` is required.
+     *
+     * @example
+     * ```ts
+     * // Minimal configuration
+     * const client = new EInvoice({ apiKey: 'sk_test_...' });
+     *
+     * // Full configuration
+     * const client = new EInvoice({
+     *   apiKey: 'sk_live_...',
+     *   baseUrl: 'https://api.einvoice.ng',
+     *   timeout: 15000,
+     *   maxRetries: 2,
+     * });
+     * ```
+     */
+    constructor(config: HttpClientConfig);
+}
+//# sourceMappingURL=einvoice.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"einvoice.d.ts","sourceRoot":"","sources":["../../src/einvoice.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,QAAQ;IACnB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC;;OAEG;IACH,SAAgB,QAAQ,EAAE,cAAc,CAAC;IAEzC;;OAEG;IACH,SAAgB,OAAO,EAAE,aAAa,CAAC;IAEvC;;OAEG;IACH,SAAgB,MAAM,EAAE,YAAY,CAAC;IAErC;;OAEG;IACH,SAAgB,OAAO,EAAE,cAAc,CAAC;IAExC;;;;;;;;;;;;;;;;;;OAkBG;gBACS,MAAM,EAAE,gBAAgB;CAQrC"}

package/dist/esm/einvoice.js

@@ -0,0 +1,75 @@
+import { HttpClient } from './client/http-client.js';
+import { InvoiceService } from './services/invoices.js';
+import { SellerService } from './services/sellers.js';
+import { BuyerService } from './services/buyers.js';
+import { BillingService } from './services/billing.js';
+/**
+ * The main E-Invoice SDK client.
+ *
+ * Provides access to all E-Invoice platform APIs through typed service objects.
+ *
+ * @example
+ * ```ts
+ * import { EInvoice } from '@elyonar/einvoice-js';
+ *
+ * const client = new EInvoice({ apiKey: 'sk_test_...' });
+ *
+ * // Invoices
+ * const invoice = await client.invoices.create({ ... });
+ * await client.invoices.submit(invoice.data.id);
+ *
+ * // Sellers & Buyers
+ * const sellers = await client.sellers.list();
+ * const buyers = await client.buyers.search('Acme');
+ *
+ * // Billing
+ * const balance = await client.billing.getAccount();
+ * ```
+ */
+export class EInvoice {
+    /** @internal */
+    httpClient;
+    /**
+     * Invoice management: create, submit, validate, download, and more.
+     */
+    invoices;
+    /**
+     * Seller management: register, update, verify TIN.
+     */
+    sellers;
+    /**
+     * Buyer management: register, update, verify TIN.
+     */
+    buyers;
+    /**
+     * Billing management: account, credits, subscriptions, payments, analytics.
+     */
+    billing;
+    /**
+     * Create a new E-Invoice SDK client.
+     *
+     * @param config - Client configuration. At minimum, `apiKey` is required.
+     *
+     * @example
+     * ```ts
+     * // Minimal configuration
+     * const client = new EInvoice({ apiKey: 'sk_test_...' });
+     *
+     * // Full configuration
+     * const client = new EInvoice({
+     *   apiKey: 'sk_live_...',
+     *   baseUrl: 'https://api.einvoice.ng',
+     *   timeout: 15000,
+     *   maxRetries: 2,
+     * });
+     * ```
+     */
+    constructor(config) {
+        this.httpClient = new HttpClient(config);
+        this.invoices = new InvoiceService(this.httpClient);
+        this.sellers = new SellerService(this.httpClient);
+        this.buyers = new BuyerService(this.httpClient);
+        this.billing = new BillingService(this.httpClient);
+    }
+}
+//# sourceMappingURL=einvoice.js.map

package/dist/esm/einvoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"einvoice.js","sourceRoot":"","sources":["../../src/einvoice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,QAAQ;IACnB,gBAAgB;IACC,UAAU,CAAa;IAExC;;OAEG;IACa,QAAQ,CAAiB;IAEzC;;OAEG;IACa,OAAO,CAAgB;IAEvC;;OAEG;IACa,MAAM,CAAe;IAErC;;OAEG;IACa,OAAO,CAAiB;IAExC;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,MAAwB;QAClC,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAEzC,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/esm/errors.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Base error class for all E-Invoice SDK errors.
+ */
+export declare class EInvoiceError extends Error {
+    constructor(message: string);
+}
+/**
+ * Represents an API error response from the E-Invoice platform.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.invoices.get('inv_123');
+ * } catch (err) {
+ *   if (err instanceof EInvoiceApiError) {
+ *     console.log(err.statusCode); // 404
+ *     console.log(err.errorCode);  // 'INVOICE_NOT_FOUND'
+ *     console.log(err.errors);     // [{ field: 'id', message: 'Invoice not found' }]
+ *   }
+ * }
+ * ```
+ */
+export declare class EInvoiceApiError extends EInvoiceError {
+    readonly statusCode: number;
+    readonly errorCode?: string | undefined;
+    readonly errors: Array<{
+        field?: string;
+        message: string;
+        code?: string;
+    }>;
+    constructor(message: string, statusCode: number, errorCode?: string | undefined, errors?: Array<{
+        field?: string;
+        message: string;
+        code?: string;
+    }>);
+}
+/**
+ * Thrown when the API returns HTTP 429 (Too Many Requests).
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.invoices.list();
+ * } catch (err) {
+ *   if (err instanceof EInvoiceRateLimitError) {
+ *     console.log(`Retry after ${err.retryAfter} seconds`);
+ *   }
+ * }
+ * ```
+ */
+export declare class EInvoiceRateLimitError extends EInvoiceApiError {
+    readonly retryAfter: number;
+    constructor(message: string, retryAfter: number);
+}
+/**
+ * Thrown when a request times out.
+ */
+export declare class EInvoiceTimeoutError extends EInvoiceError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+/**
+ * Thrown when the SDK is misconfigured (e.g. missing API key).
+ */
+export declare class EInvoiceConfigError extends EInvoiceError {
+    constructor(message: string);
+}
+/**
+ * Thrown when webhook signature verification fails.
+ */
+export declare class EInvoiceWebhookError extends EInvoiceError {
+    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;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;aAG/B,UAAU,EAAE,MAAM;aAClB,SAAS,CAAC,EAAE,MAAM;aAClB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;gBAHjF,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,MAAM,GAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAM;CAKzF;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;aAGxC,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM;CAKrC;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;aACzB,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAI9C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,OAAO,EAAE,MAAM;CAI5B"}