@elyonar/einvoice-js 0.1.0

package/dist/cjs/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/cjs/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"}

package/dist/cjs/errors.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EInvoiceWebhookError = exports.EInvoiceConfigError = exports.EInvoiceTimeoutError = exports.EInvoiceRateLimitError = exports.EInvoiceApiError = exports.EInvoiceError = void 0;
+/**
+ * Base error class for all E-Invoice SDK errors.
+ */
+class EInvoiceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'EInvoiceError';
+    }
+}
+exports.EInvoiceError = 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' }]
+ *   }
+ * }
+ * ```
+ */
+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';
+    }
+}
+exports.EInvoiceApiError = 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`);
+ *   }
+ * }
+ * ```
+ */
+class EInvoiceRateLimitError extends EInvoiceApiError {
+    retryAfter;
+    constructor(message, retryAfter) {
+        super(message, 429, 'RATE_LIMIT_EXCEEDED');
+        this.retryAfter = retryAfter;
+        this.name = 'EInvoiceRateLimitError';
+    }
+}
+exports.EInvoiceRateLimitError = EInvoiceRateLimitError;
+/**
+ * Thrown when a request times out.
+ */
+class EInvoiceTimeoutError extends EInvoiceError {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`Request timed out after ${timeoutMs}ms`);
+        this.timeoutMs = timeoutMs;
+        this.name = 'EInvoiceTimeoutError';
+    }
+}
+exports.EInvoiceTimeoutError = EInvoiceTimeoutError;
+/**
+ * Thrown when the SDK is misconfigured (e.g. missing API key).
+ */
+class EInvoiceConfigError extends EInvoiceError {
+    constructor(message) {
+        super(message);
+        this.name = 'EInvoiceConfigError';
+    }
+}
+exports.EInvoiceConfigError = EInvoiceConfigError;
+/**
+ * Thrown when webhook signature verification fails.
+ */
+class EInvoiceWebhookError extends EInvoiceError {
+    constructor(message) {
+        super(message);
+        this.name = 'EInvoiceWebhookError';
+    }
+}
+exports.EInvoiceWebhookError = EInvoiceWebhookError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAa,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;AAVD,4CAUC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAa,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;AARD,wDAQC;AAED;;GAEG;AACH,MAAa,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;AALD,oDAKC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,aAAa;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED;;GAEG;AACH,MAAa,oBAAqB,SAAQ,aAAa;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC"}

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

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyWebhook = exports.EInvoiceWebhookError = exports.EInvoiceConfigError = exports.EInvoiceTimeoutError = exports.EInvoiceRateLimitError = exports.EInvoiceApiError = exports.EInvoiceError = exports.HttpClient = exports.BillingService = exports.BuyerService = exports.SellerService = exports.InvoiceService = exports.EInvoice = void 0;
+// ═══════════════════════════════════════════
+// Main Client
+// ═══════════════════════════════════════════
+var einvoice_js_1 = require("./einvoice.js");
+Object.defineProperty(exports, "EInvoice", { enumerable: true, get: function () { return einvoice_js_1.EInvoice; } });
+// ═══════════════════════════════════════════
+// Services (for advanced/custom usage)
+// ═══════════════════════════════════════════
+var invoices_js_1 = require("./services/invoices.js");
+Object.defineProperty(exports, "InvoiceService", { enumerable: true, get: function () { return invoices_js_1.InvoiceService; } });
+var sellers_js_1 = require("./services/sellers.js");
+Object.defineProperty(exports, "SellerService", { enumerable: true, get: function () { return sellers_js_1.SellerService; } });
+var buyers_js_1 = require("./services/buyers.js");
+Object.defineProperty(exports, "BuyerService", { enumerable: true, get: function () { return buyers_js_1.BuyerService; } });
+var billing_js_1 = require("./services/billing.js");
+Object.defineProperty(exports, "BillingService", { enumerable: true, get: function () { return billing_js_1.BillingService; } });
+// ═══════════════════════════════════════════
+// HTTP Client (for advanced/custom usage)
+// ═══════════════════════════════════════════
+var http_client_js_1 = require("./client/http-client.js");
+Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return http_client_js_1.HttpClient; } });
+// ═══════════════════════════════════════════
+// Errors
+// ═══════════════════════════════════════════
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "EInvoiceError", { enumerable: true, get: function () { return errors_js_1.EInvoiceError; } });
+Object.defineProperty(exports, "EInvoiceApiError", { enumerable: true, get: function () { return errors_js_1.EInvoiceApiError; } });
+Object.defineProperty(exports, "EInvoiceRateLimitError", { enumerable: true, get: function () { return errors_js_1.EInvoiceRateLimitError; } });
+Object.defineProperty(exports, "EInvoiceTimeoutError", { enumerable: true, get: function () { return errors_js_1.EInvoiceTimeoutError; } });
+Object.defineProperty(exports, "EInvoiceConfigError", { enumerable: true, get: function () { return errors_js_1.EInvoiceConfigError; } });
+Object.defineProperty(exports, "EInvoiceWebhookError", { enumerable: true, get: function () { return errors_js_1.EInvoiceWebhookError; } });
+// ═══════════════════════════════════════════
+// Webhooks
+// ═══════════════════════════════════════════
+var verify_js_1 = require("./webhooks/verify.js");
+Object.defineProperty(exports, "verifyWebhook", { enumerable: true, get: function () { return verify_js_1.verifyWebhook; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/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,6CAAyC;AAAhC,uGAAA,QAAQ,OAAA;AAEjB,8CAA8C;AAC9C,uCAAuC;AACvC,8CAA8C;AAC9C,sDAAwD;AAA/C,6GAAA,cAAc,OAAA;AACvB,oDAAsD;AAA7C,2GAAA,aAAa,OAAA;AACtB,kDAAoD;AAA3C,yGAAA,YAAY,OAAA;AACrB,oDAAuD;AAA9C,4GAAA,cAAc,OAAA;AAEvB,8CAA8C;AAC9C,0CAA0C;AAC1C,8CAA8C;AAC9C,0DAAqD;AAA5C,4GAAA,UAAU,OAAA;AAGnB,8CAA8C;AAC9C,SAAS;AACT,8CAA8C;AAC9C,yCAOqB;AANnB,0GAAA,aAAa,OAAA;AACb,6GAAA,gBAAgB,OAAA;AAChB,mHAAA,sBAAsB,OAAA;AACtB,iHAAA,oBAAoB,OAAA;AACpB,gHAAA,mBAAmB,OAAA;AACnB,iHAAA,oBAAoB,OAAA;AAGtB,8CAA8C;AAC9C,WAAW;AACX,8CAA8C;AAC9C,kDAAqD;AAA5C,0GAAA,aAAa,OAAA"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

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

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillingService = void 0;
+/**
+ * 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`);
+ * }
+ * ```
+ */
+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,
+        });
+    }
+}
+exports.BillingService = BillingService;
+//# sourceMappingURL=billing.js.map

package/dist/cjs/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/cjs/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/cjs/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"}