@elyonar/einvoice-js 0.1.0

package/dist/esm/types/common.d.ts

@@ -0,0 +1,53 @@
+export interface PaginationMeta {
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrevious: boolean;
+}
+export interface ApiResponseMeta {
+    statusCode: number;
+    success: boolean;
+    errors: Array<{
+        field?: string;
+        message: string;
+        code?: string;
+    }>;
+    message: string;
+    timestamp: string;
+    pagination?: PaginationMeta;
+}
+export interface ApiResponse<T> {
+    meta: ApiResponseMeta;
+    data: T;
+}
+export interface PaginationParams {
+    page?: number;
+    pageSize?: number;
+}
+export interface PaginatedResult<T> {
+    data: T[];
+    pagination: PaginationMeta;
+}
+export interface RateLimitInfo {
+    limit: number;
+    remaining: number;
+    reset: number;
+    resetAfter: number;
+}
+export interface RequestOptions {
+    /**
+     * Override timeout for this specific request (in milliseconds).
+     */
+    timeout?: number;
+    /**
+     * AbortSignal for request cancellation.
+     */
+    signal?: AbortSignal;
+    /**
+     * Additional headers to send with this request.
+     */
+    headers?: Record<string, string>;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/esm/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/types/common.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,CAAC,CAAC;CACT;AAMD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,EAAE,cAAc,CAAC;CAC5B;AAMD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}

package/dist/esm/types/common.js

@@ -0,0 +1,5 @@
+// ═══════════════════════════════════════════
+// API Response Envelope
+// ═══════════════════════════════════════════
+export {};
+//# sourceMappingURL=common.js.map

package/dist/esm/types/common.js.map

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

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

@@ -0,0 +1,6 @@
+export type { ApiResponse, ApiResponseMeta, PaginationMeta, PaginationParams, PaginatedResult, RateLimitInfo, RequestOptions, } from './common.js';
+export type { InvoiceType, InvoiceStatus, PaymentStatus, Currency, PostalAddress, LineItem, Invoice, CreateInvoiceParams, UpdateInvoiceParams, ListInvoicesParams, SubmitResult, BatchSubmitResult, RetryResult, InvoiceStatusResult, ValidationResult, DownloadResult, InvoiceStatistics, InvoiceStatisticsParams, CancelInvoiceParams, } from './invoice.js';
+export type { PartyType, PartyStatus, TinVerificationStatus, Seller, Buyer, CreateSellerParams, UpdateSellerParams, CreateBuyerParams, UpdateBuyerParams, ListSellersParams, ListBuyersParams, TinVerificationResult, SearchResult, } from './party.js';
+export type { 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, } from './billing.js';
+export type { WebhookEventType, WebhookEvent, WebhookHeaders, } from './webhook.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,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,GACpB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,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,GACb,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,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,GACrB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC"}

package/dist/esm/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/esm/types/invoice.d.ts

@@ -0,0 +1,183 @@
+export type InvoiceType = 'STANDARD' | 'CREDIT_NOTE' | 'DEBIT_NOTE';
+export type InvoiceStatus = 'draft' | 'queued' | 'pending' | 'accepted' | 'rejected' | 'failed' | 'cancelled';
+export type PaymentStatus = 'UNPAID' | 'PARTIALLY_PAID' | 'PAID';
+export type Currency = 'NGN' | 'USD' | 'EUR' | 'GBP';
+export interface PostalAddress {
+    buildingNumber?: string;
+    streetName: string;
+    additionalStreetName?: string;
+    cityName: string;
+    countrySubentity: string;
+    postalZone?: string;
+    countryCode: string;
+}
+export interface LineItem {
+    id?: string;
+    description: string;
+    quantity: number;
+    unitPrice: number;
+    lineExtensionAmount?: number;
+    taxPercent?: number;
+    taxAmount?: number;
+    totalAmount?: number;
+    hsnCode?: string;
+    unitCode?: string;
+    discountAmount?: number;
+}
+export interface Invoice {
+    id: string;
+    organizationId: string;
+    sellerId: string;
+    buyerId: string;
+    invoiceNumber: string;
+    invoiceType: InvoiceType;
+    status: InvoiceStatus;
+    invoiceDate: string;
+    issueTime?: string;
+    dueDate?: string;
+    deliveryDate?: string;
+    currency: Currency;
+    lineItems: LineItem[];
+    totalAmountExcludingTax: number;
+    totalTaxAmount: number;
+    totalAmountIncludingTax: number;
+    allowanceAmount: number;
+    chargeAmount: number;
+    payableAmount: number;
+    paymentStatus: PaymentStatus;
+    paymentTerms?: string;
+    notes?: string;
+    originalInvoiceNumber?: string;
+    purchaseOrderReference?: string;
+    accountingCost?: string;
+    jurisdiction: string;
+    regulatoryData?: Record<string, unknown>;
+    submissionAttempts: number;
+    lastSubmissionAttemptAt?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateInvoiceParams {
+    sellerId: string;
+    buyerId: string;
+    invoiceDate: string;
+    dueDate: string;
+    currency: Currency;
+    lineItems: Array<{
+        description: string;
+        quantity: number;
+        unitPrice: number;
+        vatRate: number;
+        hsnCode?: string;
+        unitCode?: string;
+        discountAmount?: number;
+    }>;
+    invoiceType?: InvoiceType;
+    deliveryDate?: string;
+    paymentTerms?: string;
+    notes?: string;
+    originalInvoiceNumber?: string;
+    purchaseOrderReference?: string;
+    accountingCost?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateInvoiceParams {
+    buyerId?: string;
+    invoiceDate?: string;
+    dueDate?: string;
+    currency?: Currency;
+    lineItems?: CreateInvoiceParams['lineItems'];
+    deliveryDate?: string;
+    paymentTerms?: string;
+    notes?: string;
+    purchaseOrderReference?: string;
+    accountingCost?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ListInvoicesParams {
+    page?: number;
+    pageSize?: number;
+    status?: InvoiceStatus;
+    sellerId?: string;
+    buyerId?: string;
+    startDate?: string;
+    endDate?: string;
+    search?: string;
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+}
+export interface SubmitResult {
+    jobId: string;
+    status: 'queued';
+    jurisdiction: string;
+}
+export interface BatchSubmitResult {
+    totalQueued: number;
+    totalFailed: number;
+    queued: Array<{
+        invoiceId: string;
+        jobId: string;
+    }>;
+    failed: Array<{
+        invoiceId: string;
+        error: string;
+    }>;
+}
+export interface RetryResult {
+    jobId: string;
+    status: 'queued';
+    attempt: number;
+}
+export interface InvoiceStatusResult {
+    invoiceId: string;
+    status: InvoiceStatus;
+    submissionAttempts: number;
+    lastSubmissionAttemptAt?: string;
+    regulatoryData?: Record<string, unknown>;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: Array<{
+        field: string;
+        message: string;
+        code: string;
+    }>;
+    warnings?: Array<{
+        field: string;
+        message: string;
+    }>;
+    calculations?: {
+        subtotal: number;
+        tax: number;
+        total: number;
+    };
+}
+export interface DownloadResult {
+    downloadUrl: string;
+    expiresAt: string;
+    fileName: string;
+}
+export interface InvoiceStatistics {
+    totalInvoices: number;
+    totalAmount?: number;
+    pendingInvoices?: number;
+    rejectedInvoices?: number;
+    byStatus?: Record<string, number>;
+    jurisdiction?: string;
+    period?: {
+        startDate: string;
+        endDate: string;
+    };
+}
+export interface InvoiceStatisticsParams {
+    startDate?: string;
+    endDate?: string;
+    jurisdiction?: string;
+    sellerId?: string;
+}
+export interface CancelInvoiceParams {
+    reason: string;
+    notes?: string;
+}
+//# sourceMappingURL=invoice.d.ts.map

package/dist/esm/types/invoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.d.ts","sourceRoot":"","sources":["../../../src/types/invoice.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,YAAY,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAC9G,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,gBAAgB,GAAG,MAAM,CAAC;AACjE,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAMrD,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,KAAK,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC5B;AAMD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,YAAY,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/esm/types/invoice.js

@@ -0,0 +1,5 @@
+// ═══════════════════════════════════════════
+// Enums
+// ═══════════════════════════════════════════
+export {};
+//# sourceMappingURL=invoice.js.map

package/dist/esm/types/invoice.js.map

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

package/dist/esm/types/party.d.ts

@@ -0,0 +1,128 @@
+import type { PostalAddress } from './invoice.js';
+export type PartyType = 'COMPANY' | 'INDIVIDUAL' | 'OTHER';
+export type PartyStatus = 'PENDING_VERIFICATION' | 'ACTIVE' | 'SUSPENDED' | 'INACTIVE';
+export type TinVerificationStatus = 'NOT_VERIFIED' | 'PENDING' | 'VERIFIED' | 'FAILED';
+export interface Seller {
+    id: string;
+    organizationId: string;
+    partyName: string;
+    tradingName?: string;
+    tin: string;
+    sellerType: PartyType;
+    status: PartyStatus;
+    registrationNumber?: string;
+    vatNumber?: string;
+    postalAddress?: PostalAddress;
+    email?: string;
+    phone?: string;
+    website?: string;
+    businessActivity?: string;
+    tinVerificationStatus: TinVerificationStatus;
+    tinVerifiedAt?: string;
+    logoUrl?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Buyer {
+    id: string;
+    organizationId: string;
+    partyName: string;
+    tradingName?: string;
+    tin: string;
+    buyerType: PartyType;
+    status: PartyStatus;
+    registrationNumber?: string;
+    postalAddress?: PostalAddress;
+    email?: string;
+    phone?: string;
+    businessActivity?: string;
+    tinVerificationStatus: TinVerificationStatus;
+    tinVerifiedAt?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateSellerParams {
+    partyName: string;
+    tin: string;
+    sellerType: PartyType;
+    tradingName?: string;
+    registrationNumber?: string;
+    vatNumber?: string;
+    postalAddress?: PostalAddress;
+    email?: string;
+    phone?: string;
+    website?: string;
+    businessActivity?: string;
+    logoUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateSellerParams {
+    partyName?: string;
+    tradingName?: string;
+    sellerType?: PartyType;
+    registrationNumber?: string;
+    vatNumber?: string;
+    postalAddress?: PostalAddress;
+    email?: string;
+    phone?: string;
+    website?: string;
+    businessActivity?: string;
+    logoUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CreateBuyerParams {
+    partyName: string;
+    tin: string;
+    buyerType: PartyType;
+    tradingName?: string;
+    registrationNumber?: string;
+    postalAddress?: PostalAddress;
+    email?: string;
+    phone?: string;
+    businessActivity?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateBuyerParams {
+    partyName?: string;
+    tradingName?: string;
+    buyerType?: PartyType;
+    registrationNumber?: string;
+    postalAddress?: PostalAddress;
+    email?: string;
+    phone?: string;
+    businessActivity?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ListSellersParams {
+    page?: number;
+    pageSize?: number;
+    status?: PartyStatus;
+    search?: string;
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+}
+export interface ListBuyersParams {
+    page?: number;
+    pageSize?: number;
+    status?: PartyStatus;
+    search?: string;
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+}
+export interface TinVerificationResult {
+    tinVerificationStatus: TinVerificationStatus;
+    tinVerifiedAt?: string;
+    tinVerificationResult?: Record<string, unknown>;
+}
+export interface SearchResult {
+    results: Array<{
+        id: string;
+        name: string;
+        tin: string;
+        type?: string;
+    }>;
+    count: number;
+}
+//# sourceMappingURL=party.d.ts.map

package/dist/esm/types/party.d.ts.map

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

package/dist/esm/types/party.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=party.js.map

package/dist/esm/types/party.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"party.js","sourceRoot":"","sources":["../../../src/types/party.ts"],"names":[],"mappings":""}

package/dist/esm/types/webhook.d.ts

@@ -0,0 +1,14 @@
+export type WebhookEventType = 'invoice.created' | 'invoice.submitted' | 'invoice.approved' | 'invoice.rejected' | 'invoice.failed' | 'invoice.cancelled' | 'billing.payment_succeeded' | 'billing.payment_failed' | 'billing.low_credit_alert' | 'billing.subscription_created' | 'billing.subscription_renewed' | 'billing.subscription_cancelled' | 'billing.trial_expiring_soon' | 'auth.user_invited' | 'auth.user_joined' | 'auth.api_key_created' | 'auth.api_key_revoked';
+export interface WebhookEvent<T = Record<string, unknown>> {
+    eventId: string;
+    eventType: WebhookEventType;
+    timestamp: string;
+    data: T;
+}
+export interface WebhookHeaders {
+    'x-webhook-signature': string;
+    'x-webhook-timestamp': string;
+    'x-webhook-event': string;
+    'x-webhook-event-id': string;
+}
+//# sourceMappingURL=webhook.d.ts.map

package/dist/esm/types/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../src/types/webhook.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,gBAAgB,GAExB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,GAChB,mBAAmB,GAEnB,2BAA2B,GAC3B,wBAAwB,GACxB,0BAA0B,GAC1B,8BAA8B,GAC9B,8BAA8B,GAC9B,gCAAgC,GAChC,6BAA6B,GAE7B,mBAAmB,GACnB,kBAAkB,GAClB,sBAAsB,GACtB,sBAAsB,CAAC;AAM3B,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,CAAC,CAAC;CACT;AAMD,MAAM,WAAW,cAAc;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;CAC9B"}

package/dist/esm/types/webhook.js

@@ -0,0 +1,5 @@
+// ═══════════════════════════════════════════
+// Webhook Event Types
+// ═══════════════════════════════════════════
+export {};
+//# sourceMappingURL=webhook.js.map

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

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

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

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

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

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

package/dist/esm/webhooks/index.js

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

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

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

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

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

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

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

package/dist/esm/webhooks/verify.js

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

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

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