@aimee.shop/sdk 0.0.1

package/dist/services/core/taxes/store-providers.client.js

@@ -0,0 +1,59 @@
+/**
+ * Manages per-store enablement of tenant-level tax providers.
+ *
+ * All endpoints require both tenant and store context (`setTenant` + `setStore`).
+ *
+ * @example
+ * ```typescript
+ * sdk.setTenant('tenant-uuid');
+ * sdk.setStore('store-uuid');
+ *
+ * // List all providers with per-store enabled status
+ * const { data } = await sdk.taxes.storeProviders.list();
+ *
+ * // Enable a provider for this store
+ * await sdk.taxes.storeProviders.enable(providerId, { sortOrder: 0 });
+ *
+ * // List only enabled providers
+ * const { data: enabled } = await sdk.taxes.storeProviders.listEnabled();
+ * ```
+ */
+export class StoreTaxProvidersClient {
+    http;
+    baseUrl;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * List all tenant providers with per-store enablement status
+     */
+    async list() {
+        return this.http.get(`${this.baseUrl}/v1/taxes/store-providers`);
+    }
+    /**
+     * List only enabled providers for this store
+     */
+    async listEnabled() {
+        return this.http.get(`${this.baseUrl}/v1/taxes/store-providers/enabled`);
+    }
+    /**
+     * Enable a tenant-level provider for this store
+     */
+    async enable(providerId, data) {
+        return this.http.post(`${this.baseUrl}/v1/taxes/store-providers/${providerId}/enable`, data ?? {});
+    }
+    /**
+     * Disable a provider for this store
+     */
+    async disable(providerId) {
+        await this.http.delete(`${this.baseUrl}/v1/taxes/store-providers/${providerId}/disable`);
+    }
+    /**
+     * Update store-provider settings (sort order, enabled flag)
+     */
+    async updateSettings(providerId, data) {
+        return this.http.patch(`${this.baseUrl}/v1/taxes/store-providers/${providerId}/settings`, data);
+    }
+}
+//# sourceMappingURL=store-providers.client.js.map

package/dist/services/core/taxes/store-providers.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-providers.client.js","sourceRoot":"","sources":["../../../../../../src/services/core/taxes/store-providers.client.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,uBAAuB;IAEf;IACA;IAFnB,YACmB,IAAgB,EAChB,OAAe;QADf,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAuB,GAAG,IAAI,CAAC,OAAO,2BAA2B,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAuB,GAAG,IAAI,CAAC,OAAO,mCAAmC,CAAC,CAAC;IACjG,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,UAAkB,EAClB,IAAgC;QAEhC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,GAAG,IAAI,CAAC,OAAO,6BAA6B,UAAU,SAAS,EAC/D,IAAI,IAAI,EAAE,CACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,6BAA6B,UAAU,UAAU,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,UAAkB,EAClB,IAA+B;QAE/B,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CACpB,GAAG,IAAI,CAAC,OAAO,6BAA6B,UAAU,WAAW,EACjE,IAAI,CACL,CAAC;IACJ,CAAC;CACF"}

package/dist/services/core/taxes/taxes.client.d.ts

@@ -0,0 +1,81 @@
+import type { HttpClientTransport as HttpClient } from '../../../core/http-client.js';
+import { TaxProvidersClient } from './providers.client.js';
+import { TaxJurisdictionsClient } from './jurisdictions.client.js';
+import { TaxRatesClient } from './rates.client.js';
+import { StoreTaxProvidersClient } from './store-providers.client.js';
+import type { CalculateTaxDto, TaxCalculationResult, BulkCalculateTaxDto, BulkTaxCalculationResult, TaxAddress, TaxAddressValidationResult, VerifyExemptionDto, ExemptionVerificationResult, TaxProviderHealthStatus } from './types.js';
+/**
+ * TaxesClient provides access to all tax functionality
+ * via nested sub-clients.
+ *
+ * @example
+ * ```typescript
+ * // Calculate tax for a transaction
+ * const result = await sdk.taxes.calculate({
+ *   transactionId: 'txn-123',
+ *   originAddress: { address1: '100 Main St', city: 'SF', state: 'CA', zip: '94105', country: 'US' },
+ *   destinationAddress: { address1: '123 Oak Ave', city: 'LA', state: 'CA', zip: '90210', country: 'US' },
+ *   lineItems: [{ lineNumber: '1', quantity: 2, amount: 100 }],
+ * });
+ *
+ * // Manage tax providers
+ * const providers = await sdk.taxes.providers.list();
+ * await sdk.taxes.providers.create({ name: 'Avalara', providerType: 'avalara', configuration: {} });
+ *
+ * // Manage jurisdictions
+ * const jurisdictions = await sdk.taxes.jurisdictions.list({ jurisdictionType: 'state' });
+ *
+ * // Manage tax rates
+ * const rates = await sdk.taxes.rates.list({ taxType: 'sales' });
+ * ```
+ */
+export declare class TaxesClient {
+    private readonly http;
+    private readonly baseUrl;
+    private _providers?;
+    private _jurisdictions?;
+    private _rates?;
+    private _storeProviders?;
+    constructor(httpClient: HttpClient, baseUrl: string);
+    /**
+     * Tax providers management (Avalara, TaxJar, internal)
+     */
+    get providers(): TaxProvidersClient;
+    /**
+     * Tax jurisdictions management (countries, states, counties, cities)
+     */
+    get jurisdictions(): TaxJurisdictionsClient;
+    /**
+     * Tax rates management
+     */
+    get rates(): TaxRatesClient;
+    /**
+     * Per-store tax provider enablement (requires store context)
+     */
+    get storeProviders(): StoreTaxProvidersClient;
+    /**
+     * Calculate tax for a transaction
+     */
+    calculate(data: CalculateTaxDto): Promise<TaxCalculationResult>;
+    /**
+     * Calculate tax for multiple transactions in bulk
+     */
+    bulkCalculate(data: BulkCalculateTaxDto): Promise<BulkTaxCalculationResult>;
+    /**
+     * Validate and normalize an address for tax purposes
+     */
+    validateAddress(address: TaxAddress): Promise<TaxAddressValidationResult>;
+    /**
+     * Verify the validity of a tax exemption certificate
+     */
+    verifyExemption(data: VerifyExemptionDto): Promise<ExemptionVerificationResult>;
+    /**
+     * Get health status of all configured tax providers
+     */
+    getProviderHealth(): Promise<TaxProviderHealthStatus[]>;
+    /**
+     * Manually trigger health checks for all tax providers
+     */
+    refreshProviderHealth(): Promise<void>;
+}
+//# sourceMappingURL=taxes.client.d.ts.map

package/dist/services/core/taxes/taxes.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxes.client.d.ts","sourceRoot":"","sources":["../../../../../../src/services/core/taxes/taxes.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,2BAA2B,EAC3B,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAGjC,OAAO,CAAC,UAAU,CAAC,CAAqB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAyB;IAChD,OAAO,CAAC,MAAM,CAAC,CAAiB;IAChC,OAAO,CAAC,eAAe,CAAC,CAA0B;gBAEtC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM;IAOnD;;OAEG;IACH,IAAI,SAAS,IAAI,kBAAkB,CAKlC;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,sBAAsB,CAK1C;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,cAAc,CAK1B;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,uBAAuB,CAK5C;IAID;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIrE;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAOjF;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAO/E;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAOrF;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAI7D;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7C"}

package/dist/services/core/taxes/taxes.client.js

@@ -0,0 +1,117 @@
+import { TaxProvidersClient } from './providers.client.js';
+import { TaxJurisdictionsClient } from './jurisdictions.client.js';
+import { TaxRatesClient } from './rates.client.js';
+import { StoreTaxProvidersClient } from './store-providers.client.js';
+/**
+ * TaxesClient provides access to all tax functionality
+ * via nested sub-clients.
+ *
+ * @example
+ * ```typescript
+ * // Calculate tax for a transaction
+ * const result = await sdk.taxes.calculate({
+ *   transactionId: 'txn-123',
+ *   originAddress: { address1: '100 Main St', city: 'SF', state: 'CA', zip: '94105', country: 'US' },
+ *   destinationAddress: { address1: '123 Oak Ave', city: 'LA', state: 'CA', zip: '90210', country: 'US' },
+ *   lineItems: [{ lineNumber: '1', quantity: 2, amount: 100 }],
+ * });
+ *
+ * // Manage tax providers
+ * const providers = await sdk.taxes.providers.list();
+ * await sdk.taxes.providers.create({ name: 'Avalara', providerType: 'avalara', configuration: {} });
+ *
+ * // Manage jurisdictions
+ * const jurisdictions = await sdk.taxes.jurisdictions.list({ jurisdictionType: 'state' });
+ *
+ * // Manage tax rates
+ * const rates = await sdk.taxes.rates.list({ taxType: 'sales' });
+ * ```
+ */
+export class TaxesClient {
+    http;
+    baseUrl;
+    // Lazy-loaded sub-clients
+    _providers;
+    _jurisdictions;
+    _rates;
+    _storeProviders;
+    constructor(httpClient, baseUrl) {
+        this.http = httpClient;
+        this.baseUrl = baseUrl;
+    }
+    // ==================== Sub-Clients ====================
+    /**
+     * Tax providers management (Avalara, TaxJar, internal)
+     */
+    get providers() {
+        if (!this._providers) {
+            this._providers = new TaxProvidersClient(this.http, this.baseUrl);
+        }
+        return this._providers;
+    }
+    /**
+     * Tax jurisdictions management (countries, states, counties, cities)
+     */
+    get jurisdictions() {
+        if (!this._jurisdictions) {
+            this._jurisdictions = new TaxJurisdictionsClient(this.http, this.baseUrl);
+        }
+        return this._jurisdictions;
+    }
+    /**
+     * Tax rates management
+     */
+    get rates() {
+        if (!this._rates) {
+            this._rates = new TaxRatesClient(this.http, this.baseUrl);
+        }
+        return this._rates;
+    }
+    /**
+     * Per-store tax provider enablement (requires store context)
+     */
+    get storeProviders() {
+        if (!this._storeProviders) {
+            this._storeProviders = new StoreTaxProvidersClient(this.http, this.baseUrl);
+        }
+        return this._storeProviders;
+    }
+    // ==================== Main Operations ====================
+    /**
+     * Calculate tax for a transaction
+     */
+    async calculate(data) {
+        return this.http.post(`${this.baseUrl}/v1/taxes/calculate`, data);
+    }
+    /**
+     * Calculate tax for multiple transactions in bulk
+     */
+    async bulkCalculate(data) {
+        return this.http.post(`${this.baseUrl}/v1/taxes/bulk-calculate`, data);
+    }
+    /**
+     * Validate and normalize an address for tax purposes
+     */
+    async validateAddress(address) {
+        return this.http.post(`${this.baseUrl}/v1/taxes/validate-address`, address);
+    }
+    /**
+     * Verify the validity of a tax exemption certificate
+     */
+    async verifyExemption(data) {
+        return this.http.post(`${this.baseUrl}/v1/taxes/verify-exemption`, data);
+    }
+    /**
+     * Get health status of all configured tax providers
+     */
+    async getProviderHealth() {
+        return this.http.get(`${this.baseUrl}/v1/taxes/providers/health`);
+    }
+    /**
+     * Manually trigger health checks for all tax providers
+     */
+    async refreshProviderHealth() {
+        await this.http.post(`${this.baseUrl}/v1/taxes/providers/refresh-health`, {});
+    }
+}
+//# sourceMappingURL=taxes.client.js.map

package/dist/services/core/taxes/taxes.client.js.map

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

package/dist/services/core/taxes/types.d.ts

@@ -0,0 +1,406 @@
+import type { AddressSnapshot } from '../../../core/types/address.js';
+export type TaxAddress = Pick<AddressSnapshot, 'address1' | 'address2' | 'city' | 'zip' | 'country' | 'countryName'> & {
+    state: string;
+    stateName?: string;
+};
+export interface TaxLineItem {
+    lineNumber: string;
+    description?: string;
+    quantity: number;
+    amount: number;
+    taxCode?: string;
+    productCategory?: string;
+}
+export interface CalculateTaxDto {
+    transactionId: string;
+    date?: string;
+    currency?: string;
+    customerType?: CustomerType;
+    customerId?: string;
+    originAddress: TaxAddress;
+    destinationAddress: TaxAddress;
+    lineItems: TaxLineItem[];
+    exemptionCertificate?: string;
+}
+export interface TaxCalculationResult {
+    transactionId: string;
+    provider: string;
+    totalAmount: number;
+    totalTax: number;
+    status: string;
+    lineItems?: TaxLineItemResult[];
+    breakdown?: TaxBreakdownItem[];
+}
+export interface TaxLineItemResult {
+    lineNumber: string;
+    taxableAmount: number;
+    taxAmount: number;
+    taxRate: number;
+    taxDetails?: TaxBreakdownItem[];
+}
+export interface TaxBreakdownItem {
+    jurisdictionName: string;
+    jurisdictionType: JurisdictionType;
+    taxType: TaxType;
+    taxableAmount: number;
+    taxAmount: number;
+    taxRate: number;
+}
+export interface BulkCalculateTaxDto {
+    requests: CalculateTaxDto[];
+}
+export type BulkTaxCalculationResult = TaxCalculationResult[];
+export interface TaxAddressValidationResult {
+    isValid: boolean;
+    confidenceScore: number;
+    validatedAddress?: TaxAddress;
+    messages?: string[];
+    suggestedAddresses?: TaxAddress[];
+}
+export interface VerifyExemptionDto {
+    certificateNumber: string;
+    customerId: string;
+}
+export interface ExemptionVerificationResult {
+    isValid: boolean;
+    exemptionType?: string;
+    validJurisdictions?: string[];
+    expirationDate?: string;
+    certificateNumber?: string;
+}
+export interface TaxProviderHealthStatus {
+    provider: string;
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    responseTime?: number;
+    lastChecked?: string;
+    message?: string;
+}
+export type TaxProviderType = 'internal' | 'avalara' | 'taxjar';
+export type TaxProviderEnvironment = 'sandbox' | 'production';
+export interface TaxProvider {
+    id: string;
+    tenantId: string;
+    name: string;
+    providerType: TaxProviderType;
+    isActive: boolean;
+    priority: number;
+    credentials: Record<string, unknown>;
+    settings: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    stats?: TaxProviderStats;
+}
+export interface TaxProviderStats {
+    totalCalculations: number;
+    successRate: number;
+    averageResponseTime: number;
+    lastUsed?: string;
+}
+export interface CreateTaxProviderDto {
+    name: string;
+    providerType: TaxProviderType;
+    environment?: TaxProviderEnvironment;
+    isActive?: boolean;
+    priority?: number;
+    credentials?: Record<string, unknown>;
+    settings?: Record<string, unknown>;
+}
+export interface UpdateTaxProviderDto {
+    name?: string;
+    providerType?: TaxProviderType;
+    environment?: TaxProviderEnvironment;
+    isActive?: boolean;
+    priority?: number;
+    credentials?: Record<string, unknown>;
+    settings?: Record<string, unknown>;
+}
+export interface TaxProviderFilters {
+    skip?: number;
+    take?: number;
+    providerType?: TaxProviderType;
+    isActive?: boolean;
+    includeStats?: boolean;
+}
+export interface TaxProviderConnectionTest {
+    success: boolean;
+    responseTime: number;
+    message?: string;
+    details?: Record<string, unknown>;
+}
+export type TaxImportFormat = 'standard' | 'soclean-jkim';
+export interface TaxImportFormats {
+    formats: Array<{
+        id: TaxImportFormat;
+        name: string;
+    }>;
+    autoDetect?: boolean;
+    note?: string;
+}
+export interface TaxImportTemplate {
+    headers: string[];
+    sampleRows: string[][];
+    instructions: string;
+}
+export interface TaxImportPreview {
+    totalRows: number;
+    validRows: number;
+    invalidRows: number;
+    errors: TaxImportError[];
+    preview: TaxImportPreviewRow[];
+}
+export interface TaxImportError {
+    row: number;
+    field: string;
+    message: string;
+}
+export interface TaxImportPreviewRow {
+    row: number;
+    data: Record<string, unknown>;
+    status: 'valid' | 'invalid' | 'duplicate';
+}
+export interface TaxImportResult {
+    success: boolean;
+    totalRows: number;
+    imported: number;
+    skipped: number;
+    errors: TaxImportError[];
+    jurisdictionsCreated: number;
+    ratesCreated: number;
+    ratesUpdated: number;
+}
+export interface TaxImportClearResult {
+    ratesDeleted: number;
+    jurisdictionsDeleted: number;
+}
+/** Durable tax CSV import job lifecycle status. */
+export type TaxImportJobStatus = 'uploading' | 'pending' | 'running' | 'completed' | 'failed';
+export interface TaxImportCommitResponse {
+    jobId: string;
+    status: TaxImportJobStatus;
+}
+export interface TaxImportJob {
+    id: string;
+    status: TaxImportJobStatus;
+    totalRows: number;
+    processedRows: number;
+    imported: number;
+    skipped: number;
+    errorCount: number;
+    jurisdictionsCreated: number;
+    ratesCreated: number;
+    ratesUpdated: number;
+    errorMessage?: string | null;
+    reportS3Key?: string | null;
+    createdAt: string;
+    completedAt?: string | null;
+}
+export interface TaxImportJobReportUrl {
+    downloadUrl: string;
+    expiresAt: string;
+}
+export interface TaxImportCommitOptions {
+    /** Required client-generated key sent as Idempotency-Key. */
+    idempotencyKey: string;
+    updateExisting?: boolean;
+    format?: TaxImportFormat;
+}
+export type JurisdictionType = 'country' | 'state' | 'county' | 'city' | 'district';
+export interface TaxJurisdiction {
+    id: string;
+    tenantId: string;
+    providerId: string;
+    name: string;
+    code: string;
+    jurisdictionType: JurisdictionType;
+    parentId?: string;
+    taxAuthority?: string;
+    nexusThreshold?: number;
+    isActive: boolean;
+    effectiveDate?: string;
+    expirationDate?: string;
+    createdAt: string;
+    updatedAt: string;
+    parent?: TaxJurisdiction;
+    children?: TaxJurisdiction[];
+}
+export interface CreateTaxJurisdictionDto {
+    providerId: string;
+    name: string;
+    code: string;
+    jurisdictionType: JurisdictionType;
+    parentId?: string;
+    taxAuthority?: string;
+    nexusThreshold?: number;
+    isActive?: boolean;
+    effectiveDate?: string;
+    expirationDate?: string;
+}
+export interface UpdateTaxJurisdictionDto {
+    providerId?: string;
+    name?: string;
+    code?: string;
+    jurisdictionType?: JurisdictionType;
+    parentId?: string;
+    taxAuthority?: string;
+    nexusThreshold?: number;
+    isActive?: boolean;
+    effectiveDate?: string;
+    expirationDate?: string;
+}
+export interface TaxJurisdictionFilters {
+    skip?: number;
+    take?: number;
+    providerId?: string;
+    jurisdictionType?: JurisdictionType;
+    parentId?: string;
+    isActive?: boolean;
+    includeHierarchy?: boolean;
+}
+export interface JurisdictionHierarchy {
+    jurisdiction: TaxJurisdiction;
+    ancestors: TaxJurisdiction[];
+    path: string[];
+}
+export interface JurisdictionLookupResult {
+    jurisdictions: TaxJurisdiction[];
+    combinedRate?: number;
+}
+export type TaxType = 'sales' | 'use' | 'vat' | 'gst' | 'excise';
+export type CustomerType = 'b2b' | 'b2c' | 'exempt';
+export interface TaxRate {
+    id: string;
+    tenantId: string;
+    providerId: string;
+    jurisdictionId: string;
+    taxType: TaxType;
+    rate: number;
+    country: string;
+    state: string;
+    county: string;
+    city: string;
+    postalCode: string;
+    isCompound: boolean;
+    minimumTaxable?: number;
+    maximumTaxable?: number;
+    productCategory?: string;
+    customerType?: CustomerType;
+    effectiveDate?: string;
+    expirationDate?: string;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+    jurisdiction?: TaxJurisdiction;
+}
+export interface CreateTaxRateDto {
+    providerId: string;
+    jurisdictionId: string;
+    taxType: TaxType;
+    rate: number;
+    country?: string;
+    state?: string;
+    county?: string;
+    city?: string;
+    postalCode?: string;
+    isCompound?: boolean;
+    minimumTaxable?: number;
+    maximumTaxable?: number;
+    productCategory?: string;
+    customerType?: CustomerType;
+    effectiveDate?: string;
+    expirationDate?: string;
+    isActive?: boolean;
+}
+export interface UpdateTaxRateDto {
+    providerId?: string;
+    jurisdictionId?: string;
+    taxType?: TaxType;
+    rate?: number;
+    country?: string;
+    state?: string;
+    county?: string;
+    city?: string;
+    postalCode?: string;
+    isCompound?: boolean;
+    minimumTaxable?: number;
+    maximumTaxable?: number;
+    productCategory?: string;
+    customerType?: CustomerType;
+    effectiveDate?: string;
+    expirationDate?: string;
+    isActive?: boolean;
+}
+export interface TaxRateFilters {
+    skip?: number;
+    take?: number;
+    providerId?: string;
+    jurisdictionId?: string;
+    taxType?: TaxType;
+    productCategory?: string;
+    customerType?: CustomerType;
+    isActive?: boolean;
+    includeJurisdiction?: boolean;
+}
+export interface EffectiveRatesRequest {
+    jurisdictionIds: string[];
+    productCategory?: string;
+    customerType?: CustomerType;
+    asOfDate?: string;
+}
+export interface EffectiveRatesResult {
+    rates: TaxRate[];
+    combinedRate: number;
+    breakdown: TaxBreakdownItem[];
+}
+export interface CombinedRateRequest {
+    jurisdictionIds: string[];
+    productCategory?: string;
+    customerType?: CustomerType;
+    amount: number;
+}
+export interface CombinedRateResult {
+    combinedRate: number;
+    taxAmount: number;
+    breakdown: TaxBreakdownItem[];
+}
+export interface StoreTaxProvider {
+    id: string;
+    tenantId: string;
+    storeId: string;
+    providerId: string;
+    isEnabled: boolean;
+    sortOrder: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TaxProviderSummary {
+    id: string;
+    name: string;
+    providerType: TaxProviderType;
+    isActive: boolean;
+    priority: number;
+}
+export interface StoreTaxProviderWithProvider extends StoreTaxProvider {
+    provider: TaxProviderSummary;
+}
+export interface StoreTaxProviderList {
+    data: StoreTaxProviderWithProvider[];
+    total: number;
+    hasMore: boolean;
+}
+export interface EnableStoreTaxProviderDto {
+    isEnabled?: boolean;
+    sortOrder?: number;
+}
+export interface UpdateStoreTaxProviderDto {
+    isEnabled?: boolean;
+    sortOrder?: number;
+}
+export interface TaxNexusRegion {
+    countryCode: string;
+    regionCode: string;
+    region: string;
+}
+export interface TaxNexusListResponse {
+    regions: TaxNexusRegion[];
+}
+//# sourceMappingURL=types.d.ts.map