@elyonar/einvoice-mcp 0.1.1

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,133 @@
+# @einvoice/mcp-server
+
+MCP (Model Context Protocol) server for the E-Invoice platform. Enables AI agents like Claude to manage invoices, sellers, buyers, and billing through Nigeria's FIRS-compliant e-invoicing system.
+
+## Quick Start
+
+### Claude Desktop Configuration
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "einvoice": {
+      "command": "npx",
+      "args": ["-y", "@einvoice/mcp-server"],
+      "env": {
+        "EINVOICE_API_KEY": "sk_live_your_key_here",
+        "EINVOICE_BASE_URL": "https://api.einvoice.ng"
+      }
+    }
+  }
+}
+```
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `EINVOICE_API_KEY` | Yes | API key (`sk_live_...` or `sk_test_...`) |
+| `EINVOICE_BASE_URL` | No | API gateway URL (default: `https://api.einvoice.ng`) |
+| `EINVOICE_REQUEST_TIMEOUT` | No | Request timeout in ms (default: `30000`) |
+| `EINVOICE_RETRY_ATTEMPTS` | No | Max retries for failed requests (default: `3`) |
+
+## Available Tools (41)
+
+### Invoice Tools (15)
+- `create_invoice` — Create a new invoice in draft status
+- `get_invoice` — Get invoice details by ID
+- `list_invoices` — List/filter/search invoices
+- `update_invoice` — Update a draft invoice
+- `delete_invoice` — Delete a draft invoice
+- `submit_invoice` — Submit to FIRS
+- `batch_submit_invoices` — Batch submit multiple invoices
+- `retry_invoice_submission` — Retry a failed submission
+- `cancel_invoice` — Cancel an accepted invoice (creates credit note)
+- `get_invoice_status` — Get status from local DB
+- `query_invoice_status` — Query FIRS for real-time status
+- `validate_invoice` — Validate without creating
+- `download_invoice` — Get PDF/XML download URL
+- `get_invoice_statistics` — Analytics and metrics
+- `get_invoice_setup` — Reference data for invoice creation
+
+### Seller Tools (7)
+- `create_seller` — Register a new seller
+- `get_seller` — Get seller details
+- `list_sellers` — List/search sellers
+- `update_seller` — Update seller (TIN immutable)
+- `delete_seller` — Delete seller (no invoices)
+- `verify_seller_tin` — Trigger TIN verification
+- `get_seller_verification_status` — Check TIN status
+
+### Buyer Tools (7)
+- `create_buyer` — Register a new buyer
+- `get_buyer` — Get buyer details
+- `list_buyers` — List/search buyers
+- `update_buyer` — Update buyer (TIN immutable)
+- `delete_buyer` — Delete buyer (no invoices)
+- `verify_buyer_tin` — Trigger TIN verification
+- `get_buyer_verification_status` — Check TIN status
+
+### Billing Tools (12)
+- `get_billing_account` — Credit balance and account status
+- `check_balance` — Verify sufficient credits before operations
+- `get_billing_setup` — Full billing overview
+- `get_subscription_plans` — Available subscription plans
+- `get_credit_packages` — Available credit packages for purchase
+- `get_active_subscription` — Current subscription details
+- `get_subscription_history` — Past subscriptions
+- `purchase_credits` — Buy a credit package (returns checkout URL)
+- `get_payment_history` — Payment transaction history
+- `get_transaction_history` — Credit ledger (purchases, consumption, refunds)
+- `get_usage_analytics` — Submission counts, credit usage, daily breakdown
+- `get_consumption_breakdown` — Credit usage by API endpoint
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+npm run dev  # run with tsx (hot reload)
+```
+
+## Architecture
+
+```
+src/
+├── index.ts               # MCP server entry point (stdio transport)
+├── client/
+│   ├── http-client.ts     # HTTP client with auth, retry, rate limiting
+│   ├── invoice-client.ts  # Invoice service API client
+│   └── billing-client.ts  # Billing service API client
+├── tools/
+│   ├── invoice-tools.ts   # 15 invoice tool definitions + handlers
+│   ├── seller-tools.ts    # 7 seller tool definitions + handlers
+│   ├── buyer-tools.ts     # 7 buyer tool definitions + handlers
+│   └── billing-tools.ts   # 12 billing tool definitions + handlers
+├── types/
+│   ├── invoice.ts         # Invoice/seller/buyer types
+│   └── billing.ts         # Billing/subscription/payment types
+└── utils/
+    └── format.ts          # Response formatting utilities
+```
+
+## Versioning
+
+This project follows [Semantic Versioning](https://semver.org/) with [Conventional Commits](https://www.conventionalcommits.org/).
+
+```bash
+npm run release         # auto-bump based on commits
+npm run release:patch   # 0.1.0 → 0.1.1
+npm run release:minor   # 0.1.0 → 0.2.0
+npm run release:major   # 0.1.0 → 1.0.0
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for commit conventions, branching strategy, and how to add new tools.
+
+## License
+
+[MIT](LICENSE)

package/bin/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/index.js');

package/dist/client/billing-client.d.ts

@@ -0,0 +1,19 @@
+import { HttpClient } from './http-client.js';
+import type { ApiResponse, BillingAccount, BillingSetup, BalanceCheck, SubscriptionPlan, Subscription, CreditPackage, CreditTransaction, Payment, PurchaseResult, UsageAnalytics } from '../types/index.js';
+export declare class BillingClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    getBillingAccount(): Promise<ApiResponse<BillingAccount>>;
+    checkBalance(credits: number): Promise<ApiResponse<BalanceCheck>>;
+    getBillingSetup(): Promise<ApiResponse<BillingSetup>>;
+    getSubscriptionPlans(query?: Record<string, string | number | undefined>): Promise<ApiResponse<SubscriptionPlan[]>>;
+    getCreditPackages(query?: Record<string, string | number | undefined>): Promise<ApiResponse<CreditPackage[]>>;
+    getActiveSubscription(): Promise<ApiResponse<Subscription>>;
+    getSubscriptionHistory(): Promise<ApiResponse<Subscription[]>>;
+    purchaseCredits(data: Record<string, unknown>): Promise<ApiResponse<PurchaseResult>>;
+    getPaymentHistory(query?: Record<string, string | number | undefined>): Promise<ApiResponse<Payment[]>>;
+    getTransactionHistory(query?: Record<string, string | number | undefined>): Promise<ApiResponse<CreditTransaction[]>>;
+    getUsageAnalytics(query?: Record<string, string | number | undefined>): Promise<ApiResponse<UsageAnalytics>>;
+    getConsumptionBreakdown(): Promise<ApiResponse<Record<string, unknown>>>;
+}
+//# sourceMappingURL=billing-client.d.ts.map

package/dist/client/billing-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-client.d.ts","sourceRoot":"","sources":["../../src/client/billing-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EACV,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EACvD,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAC7C,iBAAiB,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAC3D,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAMvC,iBAAiB,IAAI,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAIzD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAIjE,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAQrD,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAInH,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC;IAQ7G,qBAAqB,IAAI,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAI3D,sBAAsB,IAAI,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC;IAQ9D,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAIpF,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAQvG,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAIrH,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAI5G,uBAAuB,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAG/E"}

package/dist/client/billing-client.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillingClient = void 0;
+class BillingClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    // ═══════════════════════════════════════════
+    // BILLING ACCOUNT
+    // ═══════════════════════════════════════════
+    async getBillingAccount() {
+        return this.http.request({ method: 'GET', path: '/b/v1/billing-accounts/me' });
+    }
+    async checkBalance(credits) {
+        return this.http.request({ method: 'GET', path: '/b/v1/billing-accounts/me/check-balance', query: { credits } });
+    }
+    async getBillingSetup() {
+        return this.http.request({ method: 'GET', path: '/b/v1/setup' });
+    }
+    // ═══════════════════════════════════════════
+    // PLANS
+    // ═══════════════════════════════════════════
+    async getSubscriptionPlans(query) {
+        return this.http.request({ method: 'GET', path: '/b/v1/plans/subscriptions', query });
+    }
+    async getCreditPackages(query) {
+        return this.http.request({ method: 'GET', path: '/b/v1/plans/packages', query });
+    }
+    // ═══════════════════════════════════════════
+    // SUBSCRIPTIONS
+    // ═══════════════════════════════════════════
+    async getActiveSubscription() {
+        return this.http.request({ method: 'GET', path: '/b/v1/subscriptions/active' });
+    }
+    async getSubscriptionHistory() {
+        return this.http.request({ method: 'GET', path: '/b/v1/subscriptions/history' });
+    }
+    // ═══════════════════════════════════════════
+    // PAYMENTS & CREDITS
+    // ═══════════════════════════════════════════
+    async purchaseCredits(data) {
+        return this.http.request({ method: 'POST', path: '/b/v1/payments/purchase', body: data });
+    }
+    async getPaymentHistory(query) {
+        return this.http.request({ method: 'GET', path: '/b/v1/payments/history', query });
+    }
+    // ═══════════════════════════════════════════
+    // TRANSACTIONS & ANALYTICS
+    // ═══════════════════════════════════════════
+    async getTransactionHistory(query) {
+        return this.http.request({ method: 'GET', path: '/b/v1/transactions', query });
+    }
+    async getUsageAnalytics(query) {
+        return this.http.request({ method: 'GET', path: '/b/v1/transactions/analytics/usage', query });
+    }
+    async getConsumptionBreakdown() {
+        return this.http.request({ method: 'GET', path: '/b/v1/transactions/breakdown/by-endpoint' });
+    }
+}
+exports.BillingClient = BillingClient;
+//# sourceMappingURL=billing-client.js.map

package/dist/client/billing-client.js.map

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

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

@@ -0,0 +1,44 @@
+import type { ApiResponse } from '../types/index.js';
+export interface HttpClientConfig {
+    baseUrl: string;
+    apiKey: string;
+    timeout?: number;
+    maxRetries?: number;
+    retryBaseDelay?: number;
+}
+export interface RequestOptions {
+    method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    path: string;
+    body?: unknown;
+    query?: Record<string, string | number | undefined>;
+}
+export declare class EInvoiceApiError extends Error {
+    readonly statusCode: number;
+    readonly errorCode?: string | undefined;
+    readonly errors: Array<{
+        field?: string;
+        message: string;
+    }>;
+    constructor(message: string, statusCode: number, errorCode?: string | undefined, errors?: Array<{
+        field?: string;
+        message: string;
+    }>);
+}
+export declare class EInvoiceRateLimitError extends EInvoiceApiError {
+    readonly retryAfter: number;
+    constructor(message: string, retryAfter: number);
+}
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeout;
+    private readonly maxRetries;
+    private readonly retryBaseDelay;
+    constructor(config: HttpClientConfig);
+    request<T>(options: RequestOptions): Promise<ApiResponse<T>>;
+    private doFetch;
+    private buildUrl;
+    private calculateBackoff;
+    private sleep;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/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,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,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,SAAS,CAAC,CAAC;CACrD;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,UAAU,EAAE,MAAM;aAClB,SAAS,CAAC,EAAE,MAAM;aAClB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;gBAHlE,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,CAAA;KAAE,CAAM;CAK1E;AAED,qBAAa,sBAAuB,SAAQ,gBAAgB;aAGxC,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM;CAKrC;AAED,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;IAQ9B,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAsDpD,OAAO;IAsBrB,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,KAAK;CAGd"}

package/dist/client/http-client.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = exports.EInvoiceRateLimitError = exports.EInvoiceApiError = void 0;
+class EInvoiceApiError extends Error {
+    statusCode;
+    errorCode;
+    errors;
+    constructor(message, statusCode, errorCode, errors = []) {
+        super(message);
+        this.statusCode = statusCode;
+        this.errorCode = errorCode;
+        this.errors = errors;
+        this.name = 'EInvoiceApiError';
+    }
+}
+exports.EInvoiceApiError = EInvoiceApiError;
+class EInvoiceRateLimitError extends EInvoiceApiError {
+    retryAfter;
+    constructor(message, retryAfter) {
+        super(message, 429, 'RATE_LIMIT_EXCEEDED');
+        this.retryAfter = retryAfter;
+        this.name = 'EInvoiceRateLimitError';
+    }
+}
+exports.EInvoiceRateLimitError = EInvoiceRateLimitError;
+class HttpClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    maxRetries;
+    retryBaseDelay;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.apiKey = config.apiKey;
+        this.timeout = config.timeout ?? 30_000;
+        this.maxRetries = config.maxRetries ?? 3;
+        this.retryBaseDelay = config.retryBaseDelay ?? 1000;
+    }
+    async request(options) {
+        const url = this.buildUrl(options.path, options.query);
+        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);
+                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) {
+                lastError = error;
+                if (error instanceof EInvoiceApiError && error.statusCode < 500) {
+                    throw error; // Don't retry client errors (except 429 handled above)
+                }
+                if (attempt === this.maxRetries) {
+                    throw lastError;
+                }
+            }
+        }
+        throw lastError ?? new Error('Request failed after retries');
+    }
+    async doFetch(url, options) {
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+        };
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        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/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/client/index.d.ts

@@ -0,0 +1,4 @@
+export { HttpClient, type HttpClientConfig, EInvoiceApiError, EInvoiceRateLimitError } from './http-client.js';
+export { InvoiceClient } from './invoice-client.js';
+export { BillingClient } from './billing-client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/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,KAAK,gBAAgB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/G,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillingClient = exports.InvoiceClient = exports.EInvoiceRateLimitError = exports.EInvoiceApiError = 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; } });
+Object.defineProperty(exports, "EInvoiceApiError", { enumerable: true, get: function () { return http_client_js_1.EInvoiceApiError; } });
+Object.defineProperty(exports, "EInvoiceRateLimitError", { enumerable: true, get: function () { return http_client_js_1.EInvoiceRateLimitError; } });
+var invoice_client_js_1 = require("./invoice-client.js");
+Object.defineProperty(exports, "InvoiceClient", { enumerable: true, get: function () { return invoice_client_js_1.InvoiceClient; } });
+var billing_client_js_1 = require("./billing-client.js");
+Object.defineProperty(exports, "BillingClient", { enumerable: true, get: function () { return billing_client_js_1.BillingClient; } });
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;AAAA,mDAA+G;AAAtG,4GAAA,UAAU,OAAA;AAAyB,kHAAA,gBAAgB,OAAA;AAAE,wHAAA,sBAAsB,OAAA;AACpF,yDAAoD;AAA3C,kHAAA,aAAa,OAAA;AACtB,yDAAoD;AAA3C,kHAAA,aAAa,OAAA"}

package/dist/client/invoice-client.d.ts

@@ -0,0 +1,42 @@
+import { HttpClient } from './http-client.js';
+import type { ApiResponse, Invoice, Seller, Buyer, SubmitResult, BatchSubmitResult, RetryResult, InvoiceStatusResult, ValidationResult, DownloadResult, InvoiceStatistics, TinVerificationResult } from '../types/index.js';
+export declare class InvoiceClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    createInvoice(data: Record<string, unknown>): Promise<ApiResponse<Invoice>>;
+    getInvoice(id: string): Promise<ApiResponse<Invoice>>;
+    listInvoices(query?: Record<string, string | number | undefined>): Promise<ApiResponse<Invoice[]>>;
+    updateInvoice(id: string, data: Record<string, unknown>): Promise<ApiResponse<Invoice>>;
+    deleteInvoice(id: string): Promise<ApiResponse<{
+        deleted: boolean;
+    }>>;
+    submitInvoice(id: string): Promise<ApiResponse<SubmitResult>>;
+    batchSubmitInvoices(invoiceIds: string[]): Promise<ApiResponse<BatchSubmitResult>>;
+    retryInvoice(id: string): Promise<ApiResponse<RetryResult>>;
+    cancelInvoice(id: string, reason: string, notes?: string): Promise<ApiResponse<Invoice>>;
+    getInvoiceStatus(id: string): Promise<ApiResponse<InvoiceStatusResult>>;
+    queryInvoiceStatus(id: string): Promise<ApiResponse<InvoiceStatusResult>>;
+    validateInvoice(data: Record<string, unknown>): Promise<ApiResponse<ValidationResult>>;
+    downloadInvoice(id: string, format?: string): Promise<ApiResponse<DownloadResult>>;
+    getInvoiceStatistics(query?: Record<string, string | number | undefined>): Promise<ApiResponse<InvoiceStatistics>>;
+    getInvoiceSetup(): Promise<ApiResponse<Record<string, unknown>>>;
+    createSeller(data: Record<string, unknown>): Promise<ApiResponse<Seller>>;
+    getSeller(id: string): Promise<ApiResponse<Seller>>;
+    listSellers(query?: Record<string, string | number | undefined>): Promise<ApiResponse<Seller[]>>;
+    updateSeller(id: string, data: Record<string, unknown>): Promise<ApiResponse<Seller>>;
+    deleteSeller(id: string): Promise<ApiResponse<{
+        deleted: boolean;
+    }>>;
+    verifySellerTin(id: string): Promise<ApiResponse<TinVerificationResult>>;
+    getSellerVerificationStatus(id: string): Promise<ApiResponse<TinVerificationResult>>;
+    createBuyer(data: Record<string, unknown>): Promise<ApiResponse<Buyer>>;
+    getBuyer(id: string): Promise<ApiResponse<Buyer>>;
+    listBuyers(query?: Record<string, string | number | undefined>): Promise<ApiResponse<Buyer[]>>;
+    updateBuyer(id: string, data: Record<string, unknown>): Promise<ApiResponse<Buyer>>;
+    deleteBuyer(id: string): Promise<ApiResponse<{
+        deleted: boolean;
+    }>>;
+    verifyBuyerTin(id: string): Promise<ApiResponse<TinVerificationResult>>;
+    getBuyerVerificationStatus(id: string): Promise<ApiResponse<TinVerificationResult>>;
+}
+//# sourceMappingURL=invoice-client.d.ts.map

package/dist/client/invoice-client.d.ts.map

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

package/dist/client/invoice-client.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvoiceClient = void 0;
+class InvoiceClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    // ═══════════════════════════════════════════
+    // INVOICES
+    // ═══════════════════════════════════════════
+    async createInvoice(data) {
+        return this.http.request({ method: 'POST', path: '/i/v1/invoices', body: data });
+    }
+    async getInvoice(id) {
+        return this.http.request({ method: 'GET', path: `/i/v1/invoices/${id}` });
+    }
+    async listInvoices(query) {
+        return this.http.request({ method: 'GET', path: '/i/v1/invoices', query });
+    }
+    async updateInvoice(id, data) {
+        return this.http.request({ method: 'PATCH', path: `/i/v1/invoices/${id}`, body: data });
+    }
+    async deleteInvoice(id) {
+        return this.http.request({ method: 'DELETE', path: `/i/v1/invoices/${id}` });
+    }
+    async submitInvoice(id) {
+        return this.http.request({ method: 'POST', path: `/i/v1/invoices/${id}/submit` });
+    }
+    async batchSubmitInvoices(invoiceIds) {
+        return this.http.request({ method: 'POST', path: '/i/v1/invoices/batch-submit', body: { invoiceIds } });
+    }
+    async retryInvoice(id) {
+        return this.http.request({ method: 'POST', path: `/i/v1/invoices/${id}/retry` });
+    }
+    async cancelInvoice(id, reason, notes) {
+        return this.http.request({ method: 'POST', path: `/i/v1/invoices/${id}/cancel`, body: { reason, notes } });
+    }
+    async getInvoiceStatus(id) {
+        return this.http.request({ method: 'GET', path: `/i/v1/invoices/${id}/status` });
+    }
+    async queryInvoiceStatus(id) {
+        return this.http.request({ method: 'POST', path: `/i/v1/invoices/${id}/query-status` });
+    }
+    async validateInvoice(data) {
+        return this.http.request({ method: 'POST', path: '/i/v1/invoices/validate', body: data });
+    }
+    async downloadInvoice(id, format) {
+        return this.http.request({ method: 'GET', path: `/i/v1/invoices/${id}/download`, query: { format } });
+    }
+    async getInvoiceStatistics(query) {
+        return this.http.request({ method: 'GET', path: '/i/v1/invoices/statistics', query });
+    }
+    async getInvoiceSetup() {
+        return this.http.request({ method: 'GET', path: '/i/v1/invoices/setup' });
+    }
+    // ═══════════════════════════════════════════
+    // SELLERS
+    // ═══════════════════════════════════════════
+    async createSeller(data) {
+        return this.http.request({ method: 'POST', path: '/i/v1/sellers', body: data });
+    }
+    async getSeller(id) {
+        return this.http.request({ method: 'GET', path: `/i/v1/sellers/${id}` });
+    }
+    async listSellers(query) {
+        return this.http.request({ method: 'GET', path: '/i/v1/sellers', query });
+    }
+    async updateSeller(id, data) {
+        return this.http.request({ method: 'PATCH', path: `/i/v1/sellers/${id}`, body: data });
+    }
+    async deleteSeller(id) {
+        return this.http.request({ method: 'DELETE', path: `/i/v1/sellers/${id}` });
+    }
+    async verifySellerTin(id) {
+        return this.http.request({ method: 'POST', path: `/i/v1/sellers/${id}/verify-tin` });
+    }
+    async getSellerVerificationStatus(id) {
+        return this.http.request({ method: 'GET', path: `/i/v1/sellers/${id}/verification-status` });
+    }
+    // ═══════════════════════════════════════════
+    // BUYERS
+    // ═══════════════════════════════════════════
+    async createBuyer(data) {
+        return this.http.request({ method: 'POST', path: '/i/v1/buyers', body: data });
+    }
+    async getBuyer(id) {
+        return this.http.request({ method: 'GET', path: `/i/v1/buyers/${id}` });
+    }
+    async listBuyers(query) {
+        return this.http.request({ method: 'GET', path: '/i/v1/buyers', query });
+    }
+    async updateBuyer(id, data) {
+        return this.http.request({ method: 'PATCH', path: `/i/v1/buyers/${id}`, body: data });
+    }
+    async deleteBuyer(id) {
+        return this.http.request({ method: 'DELETE', path: `/i/v1/buyers/${id}` });
+    }
+    async verifyBuyerTin(id) {
+        return this.http.request({ method: 'POST', path: `/i/v1/buyers/${id}/verify-tin` });
+    }
+    async getBuyerVerificationStatus(id) {
+        return this.http.request({ method: 'GET', path: `/i/v1/buyers/${id}/verification-status` });
+    }
+}
+exports.InvoiceClient = InvoiceClient;
+//# sourceMappingURL=invoice-client.js.map

package/dist/client/invoice-client.js.map

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