@elyonar/einvoice-js 0.1.0

package/dist/esm/errors.js

@@ -0,0 +1,89 @@
+/**
+ * Base error class for all E-Invoice SDK errors.
+ */
+export class EInvoiceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'EInvoiceError';
+    }
+}
+/**
+ * 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 class EInvoiceApiError extends EInvoiceError {
+    statusCode;
+    errorCode;
+    errors;
+    constructor(message, statusCode, errorCode, errors = []) {
+        super(message);
+        this.statusCode = statusCode;
+        this.errorCode = errorCode;
+        this.errors = errors;
+        this.name = 'EInvoiceApiError';
+    }
+}
+/**
+ * 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 class EInvoiceRateLimitError extends EInvoiceApiError {
+    retryAfter;
+    constructor(message, retryAfter) {
+        super(message, 429, 'RATE_LIMIT_EXCEEDED');
+        this.retryAfter = retryAfter;
+        this.name = 'EInvoiceRateLimitError';
+    }
+}
+/**
+ * Thrown when a request times out.
+ */
+export class EInvoiceTimeoutError extends EInvoiceError {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`Request timed out after ${timeoutMs}ms`);
+        this.timeoutMs = timeoutMs;
+        this.name = 'EInvoiceTimeoutError';
+    }
+}
+/**
+ * Thrown when the SDK is misconfigured (e.g. missing API key).
+ */
+export class EInvoiceConfigError extends EInvoiceError {
+    constructor(message) {
+        super(message);
+        this.name = 'EInvoiceConfigError';
+    }
+}
+/**
+ * Thrown when webhook signature verification fails.
+ */
+export class EInvoiceWebhookError extends EInvoiceError {
+    constructor(message) {
+        super(message);
+        this.name = 'EInvoiceWebhookError';
+    }
+}
+//# 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":"AAAA;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IAG/B;IACA;IACA;IAJlB,YACE,OAAe,EACC,UAAkB,EAClB,SAAkB,EAClB,SAAoE,EAAE;QAEtF,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,eAAU,GAAV,UAAU,CAAQ;QAClB,cAAS,GAAT,SAAS,CAAS;QAClB,WAAM,GAAN,MAAM,CAAgE;QAGtF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,sBAAuB,SAAQ,gBAAgB;IAGxC;IAFlB,YACE,OAAe,EACC,UAAkB;QAElC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,qBAAqB,CAAC,CAAC;QAF3B,eAAU,GAAV,UAAU,CAAQ;QAGlC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACzB;IAA5B,YAA4B,SAAiB;QAC3C,KAAK,CAAC,2BAA2B,SAAS,IAAI,CAAC,CAAC;QADtB,cAAS,GAAT,SAAS,CAAQ;QAE3C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/esm/index.d.ts

@@ -0,0 +1,12 @@
+export { EInvoice } from './einvoice.js';
+export { InvoiceService } from './services/invoices.js';
+export { SellerService } from './services/sellers.js';
+export { BuyerService } from './services/buyers.js';
+export { BillingService } from './services/billing.js';
+export { HttpClient } from './client/http-client.js';
+export type { HttpClientConfig } from './client/http-client.js';
+export { EInvoiceError, EInvoiceApiError, EInvoiceRateLimitError, EInvoiceTimeoutError, EInvoiceConfigError, EInvoiceWebhookError, } from './errors.js';
+export { verifyWebhook } from './webhooks/verify.js';
+export type { VerifyWebhookOptions } from './webhooks/verify.js';
+export type { ApiResponse, ApiResponseMeta, PaginationMeta, PaginationParams, PaginatedResult, RateLimitInfo, RequestOptions, InvoiceType, InvoiceStatus, PaymentStatus, Currency, PostalAddress, LineItem, Invoice, CreateInvoiceParams, UpdateInvoiceParams, ListInvoicesParams, SubmitResult, BatchSubmitResult, RetryResult, InvoiceStatusResult, ValidationResult, DownloadResult, InvoiceStatistics, InvoiceStatisticsParams, CancelInvoiceParams, PartyType, PartyStatus, TinVerificationStatus, Seller, Buyer, CreateSellerParams, UpdateSellerParams, CreateBuyerParams, UpdateBuyerParams, ListSellersParams, ListBuyersParams, TinVerificationResult, SearchResult, BillingMode, BillingAccountStatus, SubscriptionStatus, SubscriptionInterval, BillingPaymentStatus, CreditTransactionType, CreditTransactionStatus, BillingAccount, SubscriptionPlan, SubscriptionPlanPrice, Subscription, CreditPackage, CreditPackagePrice, CreditTransaction, Payment, BalanceCheck, PurchaseCreditsParams, PurchaseResult, UsageAnalytics, BillingSetup, ListPlansParams, ListPackagesParams, ListPaymentsParams, ListTransactionsParams, UsageAnalyticsParams, WebhookEventType, WebhookEvent, WebhookHeaders, } from './types/index.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":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAKzC,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;AAKvD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAKjE,YAAY,EAEV,WAAW,EACX,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,EAGd,WAAW,EACX,aAAa,EACb,aAAa,EACb,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,OAAO,EACP,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EAGnB,SAAS,EACT,WAAW,EACX,qBAAqB,EACrB,MAAM,EACN,KAAK,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EAGZ,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,OAAO,EACP,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EAGpB,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,24 @@
+// ═══════════════════════════════════════════
+// Main Client
+// ═══════════════════════════════════════════
+export { EInvoice } from './einvoice.js';
+// ═══════════════════════════════════════════
+// Services (for advanced/custom usage)
+// ═══════════════════════════════════════════
+export { InvoiceService } from './services/invoices.js';
+export { SellerService } from './services/sellers.js';
+export { BuyerService } from './services/buyers.js';
+export { BillingService } from './services/billing.js';
+// ═══════════════════════════════════════════
+// HTTP Client (for advanced/custom usage)
+// ═══════════════════════════════════════════
+export { HttpClient } from './client/http-client.js';
+// ═══════════════════════════════════════════
+// Errors
+// ═══════════════════════════════════════════
+export { EInvoiceError, EInvoiceApiError, EInvoiceRateLimitError, EInvoiceTimeoutError, EInvoiceConfigError, EInvoiceWebhookError, } from './errors.js';
+// ═══════════════════════════════════════════
+// Webhooks
+// ═══════════════════════════════════════════
+export { verifyWebhook } from './webhooks/verify.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,cAAc;AACd,8CAA8C;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,8CAA8C;AAC9C,uCAAuC;AACvC,8CAA8C;AAC9C,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,8CAA8C;AAC9C,0CAA0C;AAC1C,8CAA8C;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,8CAA8C;AAC9C,SAAS;AACT,8CAA8C;AAC9C,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,8CAA8C;AAC9C,WAAW;AACX,8CAA8C;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/esm/services/billing.d.ts

@@ -0,0 +1,75 @@
+import type { HttpClient } from '../client/http-client.js';
+import type { ApiResponse, RequestOptions } from '../types/common.js';
+import type { BillingAccount, BalanceCheck, BillingSetup, SubscriptionPlan, CreditPackage, Subscription, Payment, CreditTransaction, PurchaseCreditsParams, PurchaseResult, UsageAnalytics, ListPlansParams, ListPackagesParams, ListPaymentsParams, ListTransactionsParams, UsageAnalyticsParams } from '../types/billing.js';
+/**
+ * Service for managing billing, subscriptions, credits, and payments.
+ *
+ * @example
+ * ```ts
+ * const client = new EInvoice({ apiKey: 'sk_test_...' });
+ *
+ * // Check credit balance
+ * const account = await client.billing.getAccount();
+ * console.log(account.data.creditBalance);
+ *
+ * // Verify sufficient credits before submitting
+ * const check = await client.billing.checkBalance(5);
+ * if (!check.data.sufficient) {
+ *   console.log(`Need ${check.data.deficit} more credits`);
+ * }
+ * ```
+ */
+export declare class BillingService {
+    private readonly http;
+    /** @internal */
+    constructor(http: HttpClient);
+    /**
+     * Get the current billing account details including credit balance.
+     */
+    getAccount(options?: RequestOptions): Promise<ApiResponse<BillingAccount>>;
+    /**
+     * Check if the account has sufficient credits for a given number of submissions.
+     */
+    checkBalance(credits: number, options?: RequestOptions): Promise<ApiResponse<BalanceCheck>>;
+    /**
+     * Get full billing setup overview (account, subscription, plans, usage).
+     */
+    getSetup(options?: RequestOptions): Promise<ApiResponse<BillingSetup>>;
+    /**
+     * List available subscription plans.
+     */
+    getPlans(params?: ListPlansParams, options?: RequestOptions): Promise<ApiResponse<SubscriptionPlan[]>>;
+    /**
+     * List available credit packages for one-time purchase.
+     */
+    getPackages(params?: ListPackagesParams, options?: RequestOptions): Promise<ApiResponse<CreditPackage[]>>;
+    /**
+     * Get the currently active subscription.
+     */
+    getActiveSubscription(options?: RequestOptions): Promise<ApiResponse<Subscription>>;
+    /**
+     * Get subscription history.
+     */
+    getSubscriptionHistory(options?: RequestOptions): Promise<ApiResponse<Subscription[]>>;
+    /**
+     * Purchase credits. Returns a checkout URL for payment.
+     */
+    purchaseCredits(params: PurchaseCreditsParams, options?: RequestOptions): Promise<ApiResponse<PurchaseResult>>;
+    /**
+     * Get payment history.
+     */
+    getPayments(params?: ListPaymentsParams, options?: RequestOptions): Promise<ApiResponse<Payment[]>>;
+    /**
+     * Get credit transaction history.
+     */
+    getTransactions(params?: ListTransactionsParams, options?: RequestOptions): Promise<ApiResponse<CreditTransaction[]>>;
+    /**
+     * Get usage analytics: submissions, credits used, daily breakdown.
+     */
+    getUsageAnalytics(params?: UsageAnalyticsParams, options?: RequestOptions): Promise<ApiResponse<UsageAnalytics>>;
+    /**
+     * Get credit consumption breakdown by API endpoint.
+     */
+    getConsumptionBreakdown(options?: RequestOptions): Promise<ApiResponse<Record<string, unknown>>>;
+}
+//# sourceMappingURL=billing.d.ts.map

package/dist/esm/services/billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../../src/services/billing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,OAAO,EACP,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc;IAEb,OAAO,CAAC,QAAQ,CAAC,IAAI;IADjC,gBAAgB;gBACa,IAAI,EAAE,UAAU;IAM7C;;OAEG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAQhF;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IASjG;;OAEG;IACG,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAY5E;;OAEG;IACG,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAS5G;;OAEG;IACG,WAAW,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC;IAa/G;;OAEG;IACG,qBAAqB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAQzF;;OAEG;IACG,sBAAsB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC;IAY5F;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IASpH;;OAEG;IACG,WAAW,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IASzG;;OAEG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAa3H;;OAEG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAStH;;OAEG;IACG,uBAAuB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAOvG"}

package/dist/esm/services/billing.js

@@ -0,0 +1,168 @@
+/**
+ * Service for managing billing, subscriptions, credits, and payments.
+ *
+ * @example
+ * ```ts
+ * const client = new EInvoice({ apiKey: 'sk_test_...' });
+ *
+ * // Check credit balance
+ * const account = await client.billing.getAccount();
+ * console.log(account.data.creditBalance);
+ *
+ * // Verify sufficient credits before submitting
+ * const check = await client.billing.checkBalance(5);
+ * if (!check.data.sufficient) {
+ *   console.log(`Need ${check.data.deficit} more credits`);
+ * }
+ * ```
+ */
+export class BillingService {
+    http;
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    // ═══════════════════════════════════════════
+    // Account
+    // ═══════════════════════════════════════════
+    /**
+     * Get the current billing account details including credit balance.
+     */
+    async getAccount(options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/b/v1/billing-accounts/me',
+            requestOptions: options,
+        });
+    }
+    /**
+     * Check if the account has sufficient credits for a given number of submissions.
+     */
+    async checkBalance(credits, options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/b/v1/billing-accounts/me/check-balance',
+            query: { credits },
+            requestOptions: options,
+        });
+    }
+    /**
+     * Get full billing setup overview (account, subscription, plans, usage).
+     */
+    async getSetup(options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/b/v1/setup',
+            requestOptions: options,
+        });
+    }
+    // ═══════════════════════════════════════════
+    // Plans & Packages
+    // ═══════════════════════════════════════════
+    /**
+     * List available subscription plans.
+     */
+    async getPlans(params, options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/b/v1/plans/subscriptions',
+            query: params,
+            requestOptions: options,
+        });
+    }
+    /**
+     * List available credit packages for one-time purchase.
+     */
+    async getPackages(params, options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/b/v1/plans/packages',
+            query: params,
+            requestOptions: options,
+        });
+    }
+    // ═══════════════════════════════════════════
+    // Subscriptions
+    // ═══════════════════════════════════════════
+    /**
+     * Get the currently active subscription.
+     */
+    async getActiveSubscription(options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/b/v1/subscriptions/active',
+            requestOptions: options,
+        });
+    }
+    /**
+     * Get subscription history.
+     */
+    async getSubscriptionHistory(options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/b/v1/subscriptions/history',
+            requestOptions: options,
+        });
+    }
+    // ═══════════════════════════════════════════
+    // Payments & Credits
+    // ═══════════════════════════════════════════
+    /**
+     * Purchase credits. Returns a checkout URL for payment.
+     */
+    async purchaseCredits(params, options) {
+        return this.http.request({
+            method: 'POST',
+            path: '/b/v1/payments/purchase',
+            body: params,
+            requestOptions: options,
+        });
+    }
+    /**
+     * Get payment history.
+     */
+    async getPayments(params, options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/b/v1/payments/history',
+            query: params,
+            requestOptions: options,
+        });
+    }
+    /**
+     * Get credit transaction history.
+     */
+    async getTransactions(params, options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/b/v1/transactions',
+            query: params,
+            requestOptions: options,
+        });
+    }
+    // ═══════════════════════════════════════════
+    // Analytics
+    // ═══════════════════════════════════════════
+    /**
+     * Get usage analytics: submissions, credits used, daily breakdown.
+     */
+    async getUsageAnalytics(params, options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/b/v1/transactions/analytics/usage',
+            query: params,
+            requestOptions: options,
+        });
+    }
+    /**
+     * Get credit consumption breakdown by API endpoint.
+     */
+    async getConsumptionBreakdown(options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/b/v1/transactions/breakdown/by-endpoint',
+            requestOptions: options,
+        });
+    }
+}
+//# sourceMappingURL=billing.js.map

package/dist/esm/services/billing.js.map

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

package/dist/esm/services/buyers.d.ts

@@ -0,0 +1,57 @@
+import type { HttpClient } from '../client/http-client.js';
+import type { ApiResponse, RequestOptions } from '../types/common.js';
+import type { Buyer, CreateBuyerParams, UpdateBuyerParams, ListBuyersParams, TinVerificationResult, SearchResult } from '../types/party.js';
+/**
+ * Service for managing buyers (customers who receive invoices).
+ *
+ * @example
+ * ```ts
+ * const client = new EInvoice({ apiKey: 'sk_test_...' });
+ *
+ * const buyer = await client.buyers.create({
+ *   partyName: 'Widget Co',
+ *   tin: '98765432-0001',
+ *   buyerType: 'COMPANY',
+ * });
+ * ```
+ */
+export declare class BuyerService {
+    private readonly http;
+    /** @internal */
+    constructor(http: HttpClient);
+    /**
+     * Register a new buyer.
+     */
+    create(params: CreateBuyerParams, options?: RequestOptions): Promise<ApiResponse<Buyer>>;
+    /**
+     * Get a buyer by ID.
+     */
+    get(id: string, options?: RequestOptions): Promise<ApiResponse<Buyer>>;
+    /**
+     * List buyers with optional filtering and pagination.
+     */
+    list(params?: ListBuyersParams, options?: RequestOptions): Promise<ApiResponse<Buyer[]>>;
+    /**
+     * Update buyer details. Note: TIN cannot be changed after creation.
+     */
+    update(id: string, params: UpdateBuyerParams, options?: RequestOptions): Promise<ApiResponse<Buyer>>;
+    /**
+     * Delete a buyer. Only buyers with no associated invoices can be deleted.
+     */
+    delete(id: string, options?: RequestOptions): Promise<ApiResponse<{
+        deleted: boolean;
+    }>>;
+    /**
+     * Trigger TIN verification with the tax authority.
+     */
+    verifyTin(id: string, options?: RequestOptions): Promise<ApiResponse<TinVerificationResult>>;
+    /**
+     * Check TIN verification status.
+     */
+    getVerificationStatus(id: string, options?: RequestOptions): Promise<ApiResponse<TinVerificationResult>>;
+    /**
+     * Search buyers by name or TIN.
+     */
+    search(query: string, options?: RequestOptions): Promise<ApiResponse<SearchResult>>;
+}
+//# sourceMappingURL=buyers.d.ts.map

package/dist/esm/services/buyers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buyers.d.ts","sourceRoot":"","sources":["../../../src/services/buyers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EACV,KAAK,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY;IAEX,OAAO,CAAC,QAAQ,CAAC,IAAI;IADjC,gBAAgB;gBACa,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAS9F;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAQ5E;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;IAS9F;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAS1G;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAQ9F;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAQlG;;OAEG;IACG,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAQ9G;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;CAQ1F"}

package/dist/esm/services/buyers.js

@@ -0,0 +1,106 @@
+/**
+ * Service for managing buyers (customers who receive invoices).
+ *
+ * @example
+ * ```ts
+ * const client = new EInvoice({ apiKey: 'sk_test_...' });
+ *
+ * const buyer = await client.buyers.create({
+ *   partyName: 'Widget Co',
+ *   tin: '98765432-0001',
+ *   buyerType: 'COMPANY',
+ * });
+ * ```
+ */
+export class BuyerService {
+    http;
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Register a new buyer.
+     */
+    async create(params, options) {
+        return this.http.request({
+            method: 'POST',
+            path: '/i/v1/buyers',
+            body: params,
+            requestOptions: options,
+        });
+    }
+    /**
+     * Get a buyer by ID.
+     */
+    async get(id, options) {
+        return this.http.request({
+            method: 'GET',
+            path: `/i/v1/buyers/${id}`,
+            requestOptions: options,
+        });
+    }
+    /**
+     * List buyers with optional filtering and pagination.
+     */
+    async list(params, options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/i/v1/buyers',
+            query: params,
+            requestOptions: options,
+        });
+    }
+    /**
+     * Update buyer details. Note: TIN cannot be changed after creation.
+     */
+    async update(id, params, options) {
+        return this.http.request({
+            method: 'PATCH',
+            path: `/i/v1/buyers/${id}`,
+            body: params,
+            requestOptions: options,
+        });
+    }
+    /**
+     * Delete a buyer. Only buyers with no associated invoices can be deleted.
+     */
+    async delete(id, options) {
+        return this.http.request({
+            method: 'DELETE',
+            path: `/i/v1/buyers/${id}`,
+            requestOptions: options,
+        });
+    }
+    /**
+     * Trigger TIN verification with the tax authority.
+     */
+    async verifyTin(id, options) {
+        return this.http.request({
+            method: 'POST',
+            path: `/i/v1/buyers/${id}/verify-tax-number`,
+            requestOptions: options,
+        });
+    }
+    /**
+     * Check TIN verification status.
+     */
+    async getVerificationStatus(id, options) {
+        return this.http.request({
+            method: 'GET',
+            path: `/i/v1/buyers/${id}/verification-status`,
+            requestOptions: options,
+        });
+    }
+    /**
+     * Search buyers by name or TIN.
+     */
+    async search(query, options) {
+        return this.http.request({
+            method: 'GET',
+            path: '/i/v1/buyers/search',
+            query: { q: query },
+            requestOptions: options,
+        });
+    }
+}
+//# sourceMappingURL=buyers.js.map

package/dist/esm/services/buyers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buyers.js","sourceRoot":"","sources":["../../../src/services/buyers.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,YAAY;IAEM;IAD7B,gBAAgB;IAChB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAAyB,EAAE,OAAwB;QAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAQ;YAC9B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,MAAM;YACZ,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU,EAAE,OAAwB;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAQ;YAC9B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,EAAE,EAAE;YAC1B,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAyB,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAU;YAChC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,cAAc;YACpB,KAAK,EAAE,MAAqD;YAC5D,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAAyB,EAAE,OAAwB;QAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAQ;YAC9B,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,gBAAgB,EAAE,EAAE;YAC1B,IAAI,EAAE,MAAM;YACZ,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuB;YAC7C,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,gBAAgB,EAAE,EAAE;YAC1B,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,EAAU,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAwB;YAC9C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB,EAAE,oBAAoB;YAC5C,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,EAAU,EAAE,OAAwB;QAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAwB;YAC9C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,EAAE,sBAAsB;YAC9C,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAe;YACrC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,qBAAqB;YAC3B,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE;YACnB,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,5 @@
+export { InvoiceService } from './invoices.js';
+export { SellerService } from './sellers.js';
+export { BuyerService } from './buyers.js';
+export { BillingService } from './billing.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/services/index.js

@@ -0,0 +1,5 @@
+export { InvoiceService } from './invoices.js';
+export { SellerService } from './sellers.js';
+export { BuyerService } from './buyers.js';
+export { BillingService } from './billing.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}