domain-quotes 0.2.1 → 0.3.2

package/README.md

@@ -11,91 +11,250 @@ Domain Quote is a lightweight TypeScript/JavaScript library to compute domain re
 Includes:
 - Extension support based on unified registrar price list (OpenProvider/NIRA)
 - Currency conversion via remote exchange rates
-- VAT calculation per currency (US, GB, DE, NG mapping)
-- Optional discount codes with max-or-stack policy
+- VAT calculation with configurable rate
+- Flexible discount system with date ranges, extension/transaction filtering, and custom eligibility callbacks
 - Configurable markup to increase base prices before taxes/discounts
+- Extension normalization (`.com` and `com` are treated identically)
 - Clean ESM API with TypeScript types
 
-Install
+## Install
 
 ```bash
 npm i domain-quotes
 ```
 
-Usage
+## Usage
 
 ```ts
 import { getDefaultQuote, DomainQuotes, DEFAULT_CONFIG } from 'domain-quotes';
 
-// Quick quote (uses bundled defaults)
-const quote = await getDefaultQuote('com', 'USD', { discountCodes: ['SAVE10'] });
-// → { extension, currency, basePrice, discount, tax, totalPrice, symbol }
+// Quick quote (uses bundled defaults, no discounts configured by default)
+const quote = await getDefaultQuote('com', 'USD');
+// → { extension, currency, basePrice, discount, tax, totalPrice, symbol, domainTransaction }
 
-// Advanced: custom or explicit config via the class
-const dq = new DomainQuotes(DEFAULT_CONFIG); // or provide your own DomainQuoteConfig
-const eur = await dq.getQuote('example.com', 'EUR', { discountPolicy: 'stack' });
+// Extensions are normalized - leading dots are stripped
+const quote2 = await getDefaultQuote('.com', 'USD'); // same as 'com'
+
+// Custom config with discounts
+const dq = new DomainQuotes({
+  ...DEFAULT_CONFIG,
+  discounts: {
+    SAVE10: {
+      rate: 0.1, // 10% discount
+      extensions: ['com', 'net', 'org'],
+      startAt: '2024-01-01T00:00:00Z',
+      endAt: '2024-12-31T23:59:59Z',
+    },
+  },
+});
+const discounted = await dq.getQuote('com', 'USD', { discountCodes: ['SAVE10'] });
 
 // Add a 15% markup before discounts/taxes
 const withMarkup = new DomainQuotes({
   ...DEFAULT_CONFIG,
   markup: { type: 'percentage', value: 0.15 },
 });
-const quoteWithMarkup = await withMarkup.getQuote('example.com', 'USD', { discountCodes: ['SAVE10'] });
+const quoteWithMarkup = await withMarkup.getQuote('com', 'USD');
+```
+
+## Discounts
+
+Discounts are configured via the `discounts` field in `DomainQuoteConfig`. Each discount can be filtered by:
+
+- **Date range**: `startAt` and `endAt` (ISO timestamps)
+- **Extensions**: List of eligible extensions (normalized, so `.com` and `com` are equivalent)
+- **Transaction types**: Optional list of transaction types (`create`, `renew`, `restore`, `transfer`)
+- **Custom eligibility**: Optional callback for complex eligibility logic
+
+```ts
+const dq = new DomainQuotes({
+  ...DEFAULT_CONFIG,
+  discounts: {
+    // Basic discount
+    WELCOME: {
+      rate: 0.1,
+      extensions: ['com', 'net'],
+      startAt: '2024-01-01T00:00:00Z',
+      endAt: '2024-12-31T23:59:59Z',
+    },
+
+    // Discount limited to specific transaction types
+    NEWUSER: {
+      rate: 0.2,
+      extensions: ['com', 'net', 'org'],
+      startAt: '2024-01-01T00:00:00Z',
+      endAt: '2024-12-31T23:59:59Z',
+      transactions: ['create'], // Only applies to new registrations
+    },
+
+    // Discount with custom eligibility callback
+    BIGSPENDER: {
+      rate: 0.25,
+      extensions: ['com', 'net', 'org'],
+      startAt: '2024-01-01T00:00:00Z',
+      endAt: '2024-12-31T23:59:59Z',
+      isEligible: (ctx) => ctx.basePrice >= 50, // Only if base price >= $50
+    },
+
+    // Async eligibility (e.g., check external service)
+    VIP: {
+      rate: 0.3,
+      extensions: ['com'],
+      startAt: '2024-01-01T00:00:00Z',
+      endAt: '2024-12-31T23:59:59Z',
+      isEligible: async (ctx) => {
+        // Check if user is VIP via external service
+        const isVip = await checkVipStatus(ctx.discountCode);
+        return isVip;
+      },
+    },
+  },
+});
+
+// Apply discounts
+const quote = await dq.getQuote('com', 'USD', {
+  discountCodes: ['WELCOME', 'NEWUSER'],
+  discountPolicy: 'max', // default: use highest discount
+});
+
+// Stack multiple discounts
+const stacked = await dq.getQuote('com', 'USD', {
+  discountCodes: ['WELCOME', 'NEWUSER'],
+  discountPolicy: 'stack', // sum all applicable discounts
+});
+```
+
+### Eligibility Callback Context
+
+The `isEligible` callback receives a context object with:
 
+```ts
+interface DiscountEligibilityContext {
+  extension: string;        // Normalized extension (e.g., 'com')
+  currency: string;         // Currency code (e.g., 'USD')
+  transaction: TransactionType; // Transaction type
+  basePrice: number;        // Base price before discount
+  discountCode: string;     // The discount code being evaluated
+}
 ```
 
-API
+The callback is only invoked after all other criteria (date range, extension, transaction type) are satisfied. If the callback throws an error, the discount is skipped.
+
+## API
+
+### Functions
+
+- **`getDefaultQuote(extension, currency, options?): Promise<Quote>`**
+
+  Computes a quote using bundled defaults (no discounts configured by default).
+
+  ```ts
+  const quote = await getDefaultQuote('com', 'USD');
+  const withOptions = await getDefaultQuote('.ng', 'NGN', {
+    discountCodes: ['SAVE10'],
+    transaction: 'renew',
+  });
+  ```
+
+- **`normalizeExtension(extension: string): string`**
+
+  Normalizes an extension by trimming whitespace, lowercasing, and removing leading dots.
+
+  ```ts
+  normalizeExtension('.COM')   // → 'com'
+  normalizeExtension('..ng')   // → 'ng'
+  normalizeExtension('  org ') // → 'org'
+  ```
 
-- `getDefaultQuote(extension: string, currency: string, options?: GetQuoteOptions): Promise<Quote>`
-  - Computes a quote for a TLD/SLD extension (e.g. `com`, `com.ng`, `.org`) using the bundled defaults.
-  - `options`
-    - `discountCodes?: string[]` – one or more codes; case-insensitive.
-    - `now?: number | Date` – inject time for deterministic tests.
-    - `discountPolicy?: 'stack' | 'max'` – default `'max'` (highest single discount only).
+- **`listSupportedExtensions(): string[]`**
 
-- `class DomainQuotes(config: DomainQuoteConfig)`
-  - `getQuote(extension: string, currency: string, options?: GetQuoteOptions): Promise<Quote>` – same behavior as above, but uses the provided config.
-  - `DEFAULT_CONFIG: DomainQuoteConfig` – exported snapshot config used by `getDefaultQuote`.
+  Returns all extensions with pricing data.
 
-- `listSupportedExtensions(): string[]`
-  - All extensions with a non-zero price in the dataset.
+- **`isSupportedExtension(extension: string): boolean`**
 
-- `isSupportedExtension(extOrDomain: string): boolean`
-  - Accepts an extension or a full domain (resolved by longest-known suffix match against bundled price data).
+  Checks if an extension is supported (normalizes input).
 
-- `listSupportedCurrencies(): string[]`
-  - Currently returns `['USD','GBP','EUR','NGN']`. These map to VAT via country ISO codes.
+- **`listSupportedCurrencies(): string[]`**
 
-- `isSupportedCurrency(code: string): boolean`
+  Returns supported currencies (default: `['USD', 'NGN']`).
 
-Types
+- **`isSupportedCurrency(code: string): boolean`**
+
+  Checks if a currency is supported (case-insensitive).
+
+### Class
+
+- **`new DomainQuotes(config: DomainQuoteConfig)`**
+
+  Creates a quote calculator with custom configuration.
+
+  ```ts
+  const dq = new DomainQuotes({
+    ...DEFAULT_CONFIG,
+    vatRate: 0.2,
+    supportedCurrencies: ['USD', 'NGN', 'EUR', 'GBP'],
+    discounts: { /* ... */ },
+  });
+
+  const quote = await dq.getQuote('com', 'EUR', options);
+  ```
+
+### Constants
+
+- **`DEFAULT_CONFIG: DomainQuoteConfig`**
+
+  The default configuration with remote pricing data, 7.5% VAT, and no discounts.
+
+- **`DEFAULT_VAT_RATE`** = `0.075` (7.5%)
+
+## Types
 
 ```ts
+type TransactionType = 'create' | 'renew' | 'restore' | 'transfer';
 type DiscountPolicy = 'stack' | 'max';
+type MarkupType = 'percentage' | 'fixedUsd';
 
 interface GetQuoteOptions {
-  discountCodes?: string[];
-  now?: number | Date;
-  discountPolicy?: DiscountPolicy;
-  transaction?: 'create' | 'renew' | 'restore' | 'transfer'; // default 'create'
+  discountCodes?: string[];          // Discount codes to apply (case-insensitive)
+  now?: number | Date;               // Override current time for testing
+  discountPolicy?: DiscountPolicy;   // 'max' (default) or 'stack'
+  transaction?: TransactionType;     // default: 'create'
 }
 
-type MarkupType = 'percentage' | 'fixedUsd';
+interface Quote {
+  extension: string;                 // Normalized extension
+  currency: string;                  // Currency code
+  basePrice: number;                 // Price before discount
+  discount: number;                  // Total discount amount
+  tax: number;                       // Tax amount
+  totalPrice: number;                // Final price (basePrice - discount + tax)
+  symbol: string;                    // Currency symbol
+  domainTransaction: TransactionType; // Transaction type
+}
 
 interface Markup {
-  type: MarkupType;            // percentage -> 0.2 === +20%, fixedUsd -> +$ value before conversion
-  value: number;
+  type: MarkupType;                  // 'percentage' or 'fixedUsd'
+  value: number;                     // 0.2 = +20%, or fixed USD amount
 }
 
-interface Quote {
+interface DiscountEligibilityContext {
   extension: string;
   currency: string;
+  transaction: TransactionType;
   basePrice: number;
-  discount: number;
-  tax: number;
-  totalPrice: number;
-  symbol: string;
-  transaction: 'create' | 'renew' | 'restore' | 'transfer';
+  discountCode: string;
+}
+
+type DiscountEligibilityCallback =
+  (context: DiscountEligibilityContext) => boolean | Promise<boolean>;
+
+interface DiscountConfig {
+  rate: number;                      // e.g., 0.1 for 10%
+  extensions: string[];              // Eligible extensions (normalized)
+  startAt: string;                   // ISO timestamp
+  endAt: string;                     // ISO timestamp
+  transactions?: TransactionType[];  // Limit to specific transaction types
+  isEligible?: DiscountEligibilityCallback; // Custom eligibility logic
 }
 
 interface ExchangeRateData {
@@ -107,38 +266,49 @@ interface ExchangeRateData {
   inverseRate: number;
 }
 
-interface DiscountConfig {
-  rate: number; // e.g. 0.1 for 10%
-  extensions: string[]; // eligible extensions
-  startAt: string; // ISO timestamp
-  endAt: string;   // ISO timestamp
-}
+type PriceEntry = number | Record<string, number>;
+type PriceTable = Record<string, PriceEntry>;
 
 interface DomainQuoteConfig {
-  createPrices: Record<string, number>;        // base USD prices for create
-  // Optional price tables per transaction type (all USD). Falls back to `createPrices` when absent.
-  renewPrices?: Record<string, number>;
-  restorePrices?: Record<string, number>;
-  transferPrices?: Record<string, number>;
-  exchangeRates: ExchangeRateData[];           // currency conversion data
-  vatRate: number;                             // single VAT rate applied to subtotal
-  discounts: Record<string, DiscountConfig>;   // discount code → config
-  markup?: Markup;                             // optional markup applied before conversion
+  createPrices: PriceTable;                    // Base prices for create
+  renewPrices?: PriceTable;                    // Optional prices for renew
+  restorePrices?: PriceTable;                  // Optional prices for restore
+  transferPrices?: PriceTable;                 // Optional prices for transfer
+  exchangeRates: ExchangeRateData[];           // Currency conversion data
+  vatRate: number;                             // VAT rate (e.g., 0.075 for 7.5%)
+  discounts: Record<string, DiscountConfig>;   // Discount configurations
+  markup?: Markup;                             // Optional markup
+  supportedCurrencies?: string[];              // Allowed currencies (default: ['USD', 'NGN'])
 }
 ```
 
-Errors
+## Errors
+
+- **`UnsupportedExtensionError`** - `code: 'ERR_UNSUPPORTED_EXTENSION'`
+- **`UnsupportedCurrencyError`** - `code: 'ERR_UNSUPPORTED_CURRENCY'`
 
-- `UnsupportedExtensionError` with `code = 'ERR_UNSUPPORTED_EXTENSION'`
-- `UnsupportedCurrencyError` with `code = 'ERR_UNSUPPORTED_CURRENCY'`
+```ts
+import { UnsupportedExtensionError, UnsupportedCurrencyError } from 'domain-quotes';
+
+try {
+  await getDefaultQuote('invalid-tld', 'USD');
+} catch (err) {
+  if (err instanceof UnsupportedExtensionError) {
+    console.log(err.code); // 'ERR_UNSUPPORTED_EXTENSION'
+  }
+}
+```
 
-Notes
+## Notes
 
-- Rounding is to 2 decimal places at each step to keep totals predictable (`base`, `discount`, `tax`, `total`).
-- A single VAT rate is applied to the subtotal by default (7.5% in the default config). Override `vatRate` in the config to change it.
-- Price and exchange-rate data are fetched from maintained remote sources at import time:
+- **Rounding**: All monetary values are rounded to 2 decimal places at each step.
+- **VAT**: A single VAT rate is applied to the subtotal (base price - discount). Default is 7.5%.
+- **Extension normalization**: Leading dots are stripped and extensions are lowercased. `.COM`, `..com`, and `com` are all equivalent.
+- **Discount order**: The `isEligible` callback is only called after date range, extension, and transaction type checks pass.
+- **Remote data**: Price and exchange-rate data are fetched at import time from:
   - Prices: `https://raw.githubusercontent.com/namewiz/registrar-pricelist/refs/heads/main/data/unified-create-prices.csv`
   - Exchange rates: `https://raw.githubusercontent.com/namewiz/registrar-pricelist/refs/heads/main/data/exchange-rates.json`
+
   These are cached in-memory for the life of the process.
 
 ## Testing
@@ -147,4 +317,4 @@ Notes
 npm test
 ```
 
-The test suite uses Node’s built-in `node:test` runner and builds the library first.
+The test suite uses Node's built-in `node:test` runner and builds the library first.

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EAEjB,eAAe,EAIf,KAAK,EAEN,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,cAAc,EACd,2BAA2B,EAC3B,0BAA0B,EAC1B,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,MAAM,EACN,UAAU,EACV,UAAU,EACV,UAAU,EACV,KAAK,EACL,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAGlD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKzD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAGlD;AAuBD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAK/D;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK5D;AAoGD,cAAM,gBAAiB,SAAQ,KAAK;IAClC,IAAI,EAAE,MAAM,CAAC;gBACA,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK3C;AAED,qBAAa,yBAA0B,SAAQ,gBAAgB;gBAChD,GAAG,EAAE,MAAM;CAIzB;AAED,qBAAa,wBAAyB,SAAQ,gBAAgB;gBAC/C,QAAQ,EAAE,MAAM;CAI9B;AA+BD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAE9B,MAAM,EAAE,iBAAiB;IAItC,OAAO,CAAC,YAAY;IAOd,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,KAAK,CAAC;CAmHlB;AAGD,eAAO,MAAM,cAAc,EAAE,iBAQ5B,CAAC;AAEF,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,KAAK,CAAC,CAGhB"}

package/dist/index.js

@@ -1 +1 @@
-var O={SAVE1:{rate:.01,extensions:["com","net"],startAt:"2023-01-01T00:00:00Z",endAt:"2025-12-31T23:59:59Z"},NEWUSER15:{rate:.15,extensions:["com","net","org"],startAt:"2023-01-01T00:00:00Z",endAt:"2024-12-31T23:59:59Z"},FALL20:{rate:.2,extensions:["org","info"],startAt:"2024-09-01T00:00:00Z",endAt:"2024-12-01T00:00:00Z"}};var k=.075;function Z(){return(M.supportedCurrencies??["USD","NGN"]).slice()}function ce(e){if(!e)return!1;let t=e.toUpperCase();return Z().includes(t)}function ae(){let e=N();return Object.keys(e).sort()}function w(e){if(e==null)return;if(typeof e=="number")return!Number.isFinite(e)||e<=0?void 0:{USD:e};let t={};for(let[n,r]of Object.entries(e)){let c=n?.toUpperCase();if(!c||!Number.isFinite(r)||r<=0)continue;let a=t[c];t[c]=a===void 0?r:Math.min(a,r)}return Object.keys(t).length>0?t:void 0}function V(e){return!!w(e)}function ue(e){let t=N(),n=F(e),r=t[n];return V(r)}function F(e){return e&&e.trim().toLowerCase().replace(/^\.+/,"")}function q(e){return e instanceof Date?e.getTime():typeof e=="number"?e:Date.now()}var z="https://raw.githubusercontent.com/namewiz/registrar-pricelist/refs/heads/main/data/unified-create-prices.csv",J="https://raw.githubusercontent.com/namewiz/registrar-pricelist/refs/heads/main/data/exchange-rates.json";async function X(e){let t=await fetch(e);if(!t.ok)throw new Error(`Failed to fetch ${e}: ${t.status} ${t.statusText}`);return t.text()}async function H(e){let t=await fetch(e);if(!t.ok)throw new Error(`Failed to fetch ${e}: ${t.status} ${t.statusText}`);return t.json()}function B(e){let t=e.split(/\r?\n/).map(c=>c.trim()).filter(Boolean);if(t.length===0)return{};let n=t.shift(),r={};for(let c of t){let a=c.split(",");if(a.length<4)continue;let x=a[0]?.trim().toLowerCase(),o=a[2]?.trim().toUpperCase(),E=a[3]?.trim(),d=Number(E);if(!x||!o||!Number.isFinite(d)||d<=0)continue;let i=r[x],u;i===void 0?u={}:typeof i=="number"?u={USD:i}:u=i;let p=u[o];u[o]=p===void 0?d:Math.min(p,d),r[x]=u}return r}async function W(){try{let[e,t]=await Promise.all([X(z).then(B),H(J)]);return[e,t]}catch(e){let t=e instanceof Error?e:new Error(typeof e=="string"?e:"Unknown error");throw t.message=`domain-quotes: failed to load remote pricing data: ${t.message}`,t}}var[Y,K]=await W();function N(){return Y}function ee(){return K}function te(){return O}var D=class extends Error{constructor(t,n){super(n),this.name="DomainQuoteError",this.code=t}},R=class extends D{constructor(t){super("ERR_UNSUPPORTED_EXTENSION",`Unsupported extension: ${t}`),this.name="UnsupportedExtensionError"}},P=class extends D{constructor(t){super("ERR_UNSUPPORTED_CURRENCY",`Unsupported currency: ${t}`),this.name="UnsupportedCurrencyError"}};function ne(){return{countryCode:"US",currencyName:"United States Dollar",currencySymbol:"$",currencyCode:"USD",exchangeRate:1,inverseRate:1}}function m(e){return Number(e.toFixed(2))}function re(e,t){if(!t)return e;let n=typeof t.value=="number"?t.value:0;if(!Number.isFinite(n)||n<=0)return e;switch(t.type){case"percentage":return e+e*n;case"fixedUsd":return e+n;default:return e}}var C=class{constructor(t){this.config=t}findRateInfo(t){if(t==="USD")return ne();let n=this.config.exchangeRates.find(r=>r.currencyCode===t);if(!n)throw new P(t);return n}async getQuote(t,n,r={}){let c=this.config.createPrices,a=typeof this.config.vatRate=="number"?this.config.vatRate:k,x=this.config.discounts,o=F(t),E=r.transaction||"create",d=w(c[o]);if(!d)throw new R(o);let i={...d},u=(()=>{switch(E){case"renew":return this.config.renewPrices;case"restore":return this.config.restorePrices;case"transfer":return this.config.transferPrices;case"create":default:return}})();if(u){let s=w(u[o]);s&&(i={...i,...s})}if(Object.keys(i).length===0)throw new R(o);let p=(n||"").toUpperCase();if(!(this.config.supportedCurrencies??["USD","NGN"]).includes(p))throw new P(n);let T=this.findRateInfo(p),G=T.currencySymbol,f=i.USD;f===void 0&&(f=d.USD);let b=i[p];if(f===void 0&&b!==void 0&&(f=b/T.exchangeRate),f===void 0||f<=0)throw new R(o);let S=re(f,this.config.markup),l;if(b!==void 0&&f>0){let s=b/f;l=m(S*s)}else l=m(S*T.exchangeRate);let I=a,$=Array.from(new Set((r.discountCodes||[]).map(s=>s.toUpperCase()))),U=q(r.now),y=[];for(let s of $){let g=x[s];if(!g)continue;let Q=Date.parse(g.startAt),_=Date.parse(g.endAt);Number.isNaN(Q)||Number.isNaN(_)||U<Q||U>_||g.extensions.includes(o)&&y.push(m(l*g.rate))}let h=0;y.length>0&&(r.discountPolicy==="stack"?h=m(y.reduce((s,g)=>s+g,0)):h=Math.max(...y)),h>l&&(h=l);let A=m(l-h),v=m(A*I),j=m(A+v);return{extension:o,currency:p,basePrice:l,discount:h,tax:v,totalPrice:j,symbol:G,transaction:E}}},M={createPrices:N(),exchangeRates:ee(),vatRate:k,discounts:te(),supportedCurrencies:["USD","NGN"]};async function fe(e,t,n={}){return new C(M).getQuote(e,t,n)}export{M as DEFAULT_CONFIG,k as DEFAULT_VAT_RATE,C as DomainQuotes,P as UnsupportedCurrencyError,R as UnsupportedExtensionError,fe as getDefaultQuote,ce as isSupportedCurrency,ue as isSupportedExtension,Z as listSupportedCurrencies,ae as listSupportedExtensions};
+var fe=.075;function L(){return(O.supportedCurrencies??["USD","NGN"]).slice()}function de(e){if(!e)return!1;let t=e.toUpperCase();return L().includes(t)}function le(){let e=_();return Object.keys(e).sort()}function N(e){if(e==null)return;if(typeof e=="number")return!Number.isFinite(e)||e<=0?void 0:{USD:e};let t={};for(let[n,r]of Object.entries(e)){let a=n?.toUpperCase();if(!a||!Number.isFinite(r)||r<=0)continue;let u=t[a];t[a]=u===void 0?r:Math.min(u,r)}return Object.keys(t).length>0?t:void 0}function j(e){return!!N(e)}function pe(e){let t=_(),n=S(e),r=t[n];return j(r)}function S(e){return e&&e.trim().toLowerCase().replace(/^\.+/,"")}function q(e){return e instanceof Date?e.getTime():typeof e=="number"?e:Date.now()}var X="https://raw.githubusercontent.com/namewiz/registrar-pricelist/refs/heads/main/data/unified-create-prices.csv",H="https://raw.githubusercontent.com/namewiz/registrar-pricelist/refs/heads/main/data/unified-renew-prices.csv",J="https://raw.githubusercontent.com/namewiz/registrar-pricelist/refs/heads/main/data/unified-transfer-prices.csv",W="https://raw.githubusercontent.com/namewiz/registrar-pricelist/refs/heads/main/data/exchange-rates.json";async function D(e){let t=await fetch(e);if(!t.ok)throw new Error(`Failed to fetch ${e}: ${t.status} ${t.statusText}`);return t.text()}async function B(e){let t=await fetch(e);if(!t.ok)throw new Error(`Failed to fetch ${e}: ${t.status} ${t.statusText}`);return t.json()}function y(e){let t=e.split(/\r?\n/).map(a=>a.trim()).filter(Boolean);if(t.length===0)return{};let n=t.shift(),r={};for(let a of t){let u=a.split(",");if(u.length<4)continue;let b=u[0]?.trim().toLowerCase(),i=u[2]?.trim().toUpperCase(),h=u[3]?.trim(),l=Number(h);if(!b||!i||!Number.isFinite(l)||l<=0)continue;let c=r[b],f;c===void 0?f={}:typeof c=="number"?f={USD:c}:f=c;let p=f[i];f[i]=p===void 0?l:Math.min(p,l),r[b]=f}return r}async function Y(){try{let[e,t,n,r]=await Promise.all([D(X).then(y),D(H).then(y),D(J).then(y),B(W)]);return[e,t,n,r]}catch(e){let t=e instanceof Error?e:new Error(typeof e=="string"?e:"Unknown error");throw t.message=`domain-quotes: failed to load remote pricing data: ${t.message}`,t}}var[K,Z,ee,te]=await Y();function _(){return K}function ne(){return Z}function re(){return ee}function ie(){return te}var T=class extends Error{constructor(t,n){super(n),this.name="DomainQuoteError",this.code=t}},R=class extends T{constructor(t){super("ERR_UNSUPPORTED_EXTENSION",`Unsupported extension: ${t}`),this.name="UnsupportedExtensionError"}},w=class extends T{constructor(t){super("ERR_UNSUPPORTED_CURRENCY",`Unsupported currency: ${t}`),this.name="UnsupportedCurrencyError"}};function se(){return{countryCode:"US",currencyName:"United States Dollar",currencySymbol:"$",currencyCode:"USD",exchangeRate:1,inverseRate:1}}function m(e){return Number(e.toFixed(2))}function oe(e,t){if(!t)return e;let n=typeof t.value=="number"?t.value:0;if(!Number.isFinite(n)||n<=0)return e;switch(t.type){case"percentage":return e+e*n;case"fixedUsd":return e+n;default:return e}}var U=class{constructor(t){this.config=t}findRateInfo(t){if(t==="USD")return se();let n=this.config.exchangeRates.find(r=>r.currencyCode===t);if(!n)throw new w(t);return n}async getQuote(t,n,r={}){let a=this.config.createPrices,u=typeof this.config.vatRate=="number"?this.config.vatRate:.075,b=this.config.discounts,i=S(t),h=r.transaction||"create",l=N(a[i]);if(!l)throw new R(i);let c={...l},f=(()=>{switch(h){case"renew":return this.config.renewPrices;case"restore":return this.config.restorePrices;case"transfer":return this.config.transferPrices;default:return}})();if(f){let o=N(f[i]);o&&(c={...c,...o})}if(Object.keys(c).length===0)throw new R(i);let p=(n||"").toUpperCase();if(!(this.config.supportedCurrencies??["USD","NGN"]).includes(p))throw new w(n);let C=this.findRateInfo(p),M=C.currencySymbol,d=c.USD;d===void 0&&(d=l.USD);let P=c[p];if(d===void 0&&P!==void 0&&(d=P/C.exchangeRate),d===void 0||d<=0)throw new R(i);let A=oe(d,this.config.markup),g;if(P!==void 0&&d>0){let o=P/d;g=m(A*o)}else g=m(A*C.exchangeRate);let G=u,$=Array.from(new Set((r.discountCodes||[]).map(o=>o.toUpperCase()))),v=q(r.now),x=[];for(let o of $){let s=b[o];if(!s)continue;let Q=Date.parse(s.startAt),k=Date.parse(s.endAt);if(!(Number.isNaN(Q)||Number.isNaN(k)||v<Q||v>k||!s.extensions.map(S).includes(i))&&!(s.transactions&&s.transactions.length>0&&!s.transactions.includes(h))){if(s.isEligible)try{let z={extension:i,currency:p,transaction:h,basePrice:g,discountCode:o};if(!await Promise.resolve(s.isEligible(z)))continue}catch{continue}x.push(m(g*s.rate))}}let E=0;x.length>0&&(r.discountPolicy==="stack"?E=m(x.reduce((o,s)=>o+s,0)):E=Math.max(...x)),E>g&&(E=g);let I=m(g-E),F=m(I*G),V=m(I+F);return{extension:i,currency:p,basePrice:g,discount:E,tax:F,totalPrice:V,symbol:M,domainTransaction:h}}},O={createPrices:_(),renewPrices:ne(),transferPrices:re(),exchangeRates:ie(),vatRate:.075,discounts:{},supportedCurrencies:["USD","NGN"]};async function ge(e,t,n={}){return new U(O).getQuote(e,t,n)}export{O as DEFAULT_CONFIG,fe as DEFAULT_VAT_RATE,U as DomainQuotes,w as UnsupportedCurrencyError,R as UnsupportedExtensionError,ge as getDefaultQuote,de as isSupportedCurrency,pe as isSupportedExtension,L as listSupportedCurrencies,le as listSupportedExtensions,S as normalizeExtension};

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;AAEnD,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,uDAAuD;AACvD,MAAM,WAAW,0BAA0B;IACzC,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,WAAW,EAAE,eAAe,CAAC;IAC7B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,4GAA4G;AAC5G,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,EAAE,0BAA0B,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAE9G,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,iHAAiH;IACjH,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,2GAA2G;IAC3G,UAAU,CAAC,EAAE,2BAA2B,CAAC;CAC1C;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,KAAK,CAAC;AAC7C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,UAAU,CAAC;IAEzB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAElC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "domain-quotes",
-  "version": "0.2.1",
+  "version": "0.3.2",
   "description": "Fast multi-currency domain quote checker library across registrars.",
   "type": "module",
   "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "scripts": {
-    "build": "npx -y esbuild src/index.ts --bundle --minify --format=esm --target=esnext --outdir=dist/ --platform=neutral",
+    "build": "npx -y esbuild src/index.ts --bundle --minify --format=esm --target=esnext --outdir=dist/ --platform=neutral && tsc --emitDeclarationOnly",
     "postbuild": "cp dist/index.js docs/domain-quotes.js",
     "test": "npm run build && node --test",
     "start": "npm run build && cp dist/index.js docs/domain-quotes.js && npx serve docs"
@@ -29,11 +30,10 @@
     "quote-check"
   ],
   "exports": {
-    ".": "./dist/index.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
   },
-  "license": "MIT",
-  "engines": {
-    "node": "^22.12.0",
-    "npm": "^10.9.0"
-  }
+  "license": "MIT"
 }