@elyonar/einvoice-js 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elyonar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,230 @@
+# @elyonar/einvoice-js
+
+Official TypeScript/JavaScript SDK for the [E-Invoice Nigeria](https://einvoice.ng) platform.
+
+[![npm version](https://img.shields.io/npm/v/@elyonar/einvoice-js)](https://www.npmjs.com/package/@elyonar/einvoice-js)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## Features
+
+- Full coverage of all E-Invoice APIs (invoices, sellers, buyers, billing)
+- First-class TypeScript support with complete type definitions
+- Automatic retry with exponential backoff and jitter
+- Rate limit handling with `Retry-After` support
+- Webhook signature verification (HMAC-SHA256 with replay protection)
+- Zero runtime dependencies — uses native `fetch`, `crypto`, and `AbortController`
+- Dual ESM/CJS builds for maximum compatibility
+- Node.js 18+ support
+
+## Installation
+
+```bash
+npm install @elyonar/einvoice-js
+```
+
+## Quick Start
+
+```typescript
+import { EInvoice } from '@elyonar/einvoice-js';
+
+const client = new EInvoice({ apiKey: 'sk_test_...' });
+
+// Create an invoice
+const invoice = await client.invoices.create({
+  sellerId: 'sel_123',
+  buyerId: 'buy_456',
+  invoiceDate: '2026-03-20',
+  dueDate: '2026-04-20',
+  currency: 'NGN',
+  lineItems: [
+    { description: 'Consulting services', quantity: 10, unitPrice: 50000, vatRate: 7.5 },
+  ],
+});
+
+// Submit to tax authority
+const result = await client.invoices.submit(invoice.data.id);
+console.log(result.data.jobId); // 'job_abc123'
+```
+
+## Configuration
+
+```typescript
+const client = new EInvoice({
+  apiKey: 'sk_live_...',           // Required
+  baseUrl: 'https://api.einvoice.ng', // Default
+  timeout: 30000,                     // 30s default
+  maxRetries: 3,                      // Default
+  retryBaseDelay: 1000,               // 1s default
+});
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | `string` | — | **Required.** Your API key (`sk_live_*` or `sk_test_*`) |
+| `baseUrl` | `string` | `https://api.einvoice.ng` | API gateway URL |
+| `timeout` | `number` | `30000` | Request timeout in ms |
+| `maxRetries` | `number` | `3` | Max retries for 5xx/429 errors |
+| `retryBaseDelay` | `number` | `1000` | Base delay for exponential backoff (ms) |
+
+## API Reference
+
+### Invoices — `client.invoices`
+
+```typescript
+// CRUD
+client.invoices.create(params)        // Create a draft invoice
+client.invoices.get(id)               // Get invoice by ID
+client.invoices.list(params?)         // List with filters (status, date range, etc.)
+client.invoices.update(id, params)    // Update a draft invoice
+client.invoices.delete(id)            // Delete a draft invoice
+
+// Submission
+client.invoices.submit(id)            // Submit to tax authority (irreversible)
+client.invoices.batchSubmit(ids)      // Batch submit 1–100 invoices
+client.invoices.retry(id)             // Retry a failed submission
+client.invoices.cancel(id, params)    // Cancel an accepted invoice
+
+// Status & Validation
+client.invoices.getStatus(id)         // Get status from local DB
+client.invoices.queryStatus(id)       // Query tax authority for real-time status
+client.invoices.validate(params)      // Validate without creating
+client.invoices.download(id, format?) // Get PDF/XML download URL
+
+// Analytics
+client.invoices.getStatistics(params?) // Invoice analytics
+client.invoices.getSetup()             // Reference data for creation
+```
+
+### Sellers — `client.sellers`
+
+```typescript
+client.sellers.create(params)              // Register a seller
+client.sellers.get(id)                     // Get seller by ID
+client.sellers.list(params?)               // List sellers
+client.sellers.update(id, params)          // Update seller (TIN is immutable)
+client.sellers.delete(id)                  // Delete seller (no invoices)
+client.sellers.verifyTin(id)               // Trigger TIN verification
+client.sellers.getVerificationStatus(id)   // Check verification status
+client.sellers.search(query)               // Search by name or TIN
+```
+
+### Buyers — `client.buyers`
+
+```typescript
+client.buyers.create(params)              // Register a buyer
+client.buyers.get(id)                     // Get buyer by ID
+client.buyers.list(params?)               // List buyers
+client.buyers.update(id, params)          // Update buyer (TIN is immutable)
+client.buyers.delete(id)                  // Delete buyer (no invoices)
+client.buyers.verifyTin(id)               // Trigger TIN verification
+client.buyers.getVerificationStatus(id)   // Check verification status
+client.buyers.search(query)               // Search by name or TIN
+```
+
+### Billing — `client.billing`
+
+```typescript
+// Account
+client.billing.getAccount()                // Credit balance & status
+client.billing.checkBalance(credits)       // Verify sufficient credits
+client.billing.getSetup()                  // Full billing overview
+
+// Plans & Packages
+client.billing.getPlans(params?)           // Available subscription plans
+client.billing.getPackages(params?)        // Available credit packages
+
+// Subscriptions
+client.billing.getActiveSubscription()     // Current subscription
+client.billing.getSubscriptionHistory()    // Past subscriptions
+
+// Payments & Credits
+client.billing.purchaseCredits(params)     // Buy credits (returns checkout URL)
+client.billing.getPayments(params?)        // Payment history
+client.billing.getTransactions(params?)    // Credit transaction history
+
+// Analytics
+client.billing.getUsageAnalytics(params?)  // Submissions, credits, daily breakdown
+client.billing.getConsumptionBreakdown()   // Credits by API endpoint
+```
+
+## Webhook Verification
+
+```typescript
+import { verifyWebhook } from '@elyonar/einvoice-js/webhooks';
+
+// Express example
+app.post('/webhooks/einvoice', (req, res) => {
+  try {
+    const event = verifyWebhook(req.body, req.headers, process.env.WEBHOOK_SECRET);
+
+    switch (event.eventType) {
+      case 'invoice.approved':
+        console.log('Invoice approved:', event.data);
+        break;
+      case 'billing.low_credit_alert':
+        console.log('Low credits!', event.data);
+        break;
+    }
+
+    res.sendStatus(200);
+  } catch (err) {
+    console.error('Webhook verification failed:', err);
+    res.sendStatus(400);
+  }
+});
+```
+
+The `verifyWebhook` function performs HMAC-SHA256 signature verification with timing-safe comparison and 5-minute replay protection.
+
+## Error Handling
+
+```typescript
+import { EInvoiceApiError, EInvoiceRateLimitError } from '@elyonar/einvoice-js';
+
+try {
+  await client.invoices.submit('inv_123');
+} catch (err) {
+  if (err instanceof EInvoiceRateLimitError) {
+    console.log(`Rate limited. Retry after ${err.retryAfter}s`);
+  } else if (err instanceof EInvoiceApiError) {
+    console.log(err.statusCode);  // 422
+    console.log(err.errorCode);   // 'INVALID_STATE_TRANSITION'
+    console.log(err.errors);      // [{ field: 'status', message: '...' }]
+  }
+}
+```
+
+| Error Class | When |
+|-------------|------|
+| `EInvoiceApiError` | API returned a 4xx/5xx error |
+| `EInvoiceRateLimitError` | API returned 429 after max retries |
+| `EInvoiceTimeoutError` | Request exceeded timeout |
+| `EInvoiceConfigError` | Invalid SDK configuration |
+| `EInvoiceWebhookError` | Webhook signature verification failed |
+
+## Per-Request Options
+
+Every method accepts an optional `RequestOptions` object:
+
+```typescript
+const controller = new AbortController();
+
+await client.invoices.list({ status: 'draft' }, {
+  timeout: 5000,               // Override timeout for this request
+  signal: controller.signal,   // AbortSignal for cancellation
+  headers: { 'X-Request-Id': 'req_123' }, // Additional headers
+});
+```
+
+## Development
+
+```bash
+npm install       # Install dependencies
+npm test          # Run tests with coverage
+npm run build     # Build ESM + CJS
+npm run lint      # Type check
+```
+
+## License
+
+MIT

package/dist/cjs/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/cjs/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/cjs/client/http-client.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const errors_js_1 = require("../errors.js");
+// ═══════════════════════════════════════════
+// HTTP Client
+// ═══════════════════════════════════════════
+class HttpClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    maxRetries;
+    retryBaseDelay;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new errors_js_1.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 errors_js_1.EInvoiceRateLimitError('Rate limit exceeded', retryAfter);
+                }
+                const body = await response.json();
+                if (!response.ok) {
+                    const meta = body?.meta;
+                    throw new errors_js_1.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 errors_js_1.EInvoiceTimeoutError(timeout);
+                }
+                lastError = error;
+                // Don't retry client errors (4xx except 429, which is handled above)
+                if (error instanceof errors_js_1.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));
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=http-client.js.map

package/dist/cjs/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/cjs/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/cjs/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/cjs/client/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAArC,4GAAA,UAAU,OAAA"}

package/dist/cjs/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/cjs/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/cjs/einvoice.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EInvoice = void 0;
+const http_client_js_1 = require("./client/http-client.js");
+const invoices_js_1 = require("./services/invoices.js");
+const sellers_js_1 = require("./services/sellers.js");
+const buyers_js_1 = require("./services/buyers.js");
+const billing_js_1 = require("./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();
+ * ```
+ */
+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 http_client_js_1.HttpClient(config);
+        this.invoices = new invoices_js_1.InvoiceService(this.httpClient);
+        this.sellers = new sellers_js_1.SellerService(this.httpClient);
+        this.buyers = new buyers_js_1.BuyerService(this.httpClient);
+        this.billing = new billing_js_1.BillingService(this.httpClient);
+    }
+}
+exports.EInvoice = EInvoice;
+//# sourceMappingURL=einvoice.js.map

package/dist/cjs/einvoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"einvoice.js","sourceRoot":"","sources":["../../src/einvoice.ts"],"names":[],"mappings":";;;AAAA,4DAAqD;AAErD,wDAAwD;AACxD,sDAAsD;AACtD,oDAAoD;AACpD,sDAAuD;AAEvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,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,2BAAU,CAAC,MAAM,CAAC,CAAC;QAEzC,IAAI,CAAC,QAAQ,GAAG,IAAI,4BAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,GAAG,IAAI,0BAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,wBAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,2BAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,CAAC;CACF;AAnDD,4BAmDC"}