domain-quotes 0.1.0 → 0.2.0

package/README.md

@@ -25,37 +25,37 @@ npm i domain-quotes
 Usage
 
 ```ts
-import { getDefaultQuote, DomainPrices, DEFAULT_RATES } from 'domain-quotes';
+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 }
 
 // Advanced: custom or explicit config via the class
-const dp = new DomainPrices(DEFAULT_RATES); // or provide your own DomainPricesConfig
-const eur = await dp.getPrice('example.com', 'EUR', { discountPolicy: 'stack' });
+const dq = new DomainQuotes(DEFAULT_CONFIG); // or provide your own DomainQuoteConfig
+const eur = await dq.getQuote('example.com', 'EUR', { discountPolicy: 'stack' });
 
 // Add a 15% markup before discounts/taxes
-const withMarkup = new DomainPrices({
-  ...DEFAULT_RATES,
+const withMarkup = new DomainQuotes({
+  ...DEFAULT_CONFIG,
   markup: { type: 'percentage', value: 0.15 },
 });
-const quoteWithMarkup = await withMarkup.getPrice('example.com', 'USD', { discountCodes: ['SAVE10'] });
+const quoteWithMarkup = await withMarkup.getQuote('example.com', 'USD', { discountCodes: ['SAVE10'] });
+
 ```
 
 API
 
-- `getDefaultQuote(extension: string, currency: string, options?: GetPriceOptions): Promise<PriceQuote>`
+- `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.
-  - Alias: `getDefaultPrice(...)` for backward-compatibility.
   - `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).
 
-- `class DomainPrices(config: DomainPricesConfig)`
-  - `getPrice(extension: string, currency: string, options?: GetPriceOptions): Promise<PriceQuote>` – same behavior as above, but uses the provided config. Alias: `getQuote(...)`.
-  - `DEFAULT_RATES: DomainPricesConfig` – exported snapshot config used by `getDefaultQuote`.
+- `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`.
 
 - `listSupportedExtensions(): string[]`
   - All extensions with a non-zero price in the dataset.
@@ -73,21 +73,21 @@ Types
 ```ts
 type DiscountPolicy = 'stack' | 'max';
 
-interface GetPriceOptions {
+interface GetQuoteOptions {
   discountCodes?: string[];
   now?: number | Date;
   discountPolicy?: DiscountPolicy;
   transaction?: 'create' | 'renew' | 'restore' | 'transfer'; // default 'create'
 }
 
-type MarkupType = 'percentage' | 'fixed_usd';
+type MarkupType = 'percentage' | 'fixedUsd';
 
-interface PriceMarkup {
-  type: MarkupType;            // percentage -> 0.2 === +20%, fixed_usd -> +$ value before conversion
+interface Markup {
+  type: MarkupType;            // percentage -> 0.2 === +20%, fixedUsd -> +$ value before conversion
   value: number;
 }
 
-interface PriceQuote {
+interface Quote {
   extension: string;
   currency: string;
   basePrice: number;
@@ -114,7 +114,7 @@ interface DiscountConfig {
   endAt: string;   // ISO timestamp
 }
 
-interface DomainPricesConfig {
+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>;
@@ -123,7 +123,7 @@ interface DomainPricesConfig {
   exchangeRates: ExchangeRateData[];           // currency conversion data
   vatRate: number;                             // single VAT rate applied to subtotal
   discounts: Record<string, DiscountConfig>;   // discount code → config
-  markup?: PriceMarkup;                        // optional markup applied before conversion
+  markup?: Markup;                             // optional markup applied before conversion
 }
 ```
 

package/dist/index.js

@@ -1 +1 @@
-var S={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 U=.075;function I(){return(_.supportedCurrencies??["USD","NGN"]).slice()}function et(e){if(!e)return!1;let t=e.toUpperCase();return I().includes(t)}function nt(){let e=y();return Object.keys(e).sort()}function rt(e){let t=y(),n=A(e),r=t[n];return typeof r=="number"&&r>0}function A(e){return e&&e.trim().toLowerCase().replace(/^\.+/,"")}function $(e){return e instanceof Date?e.getTime():typeof e=="number"?e:Date.now()}var L="https://raw.githubusercontent.com/namewiz/registrar-pricelist/refs/heads/main/data/unified-create-prices.csv",M="https://raw.githubusercontent.com/namewiz/registrar-pricelist/refs/heads/main/data/exchange-rates.json";async function Z(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 j(e){let t=await fetch(e);if(!t.ok)throw new Error(`Failed to fetch ${e}: ${t.status} ${t.statusText}`);return t.json()}function V(e){let t=e.split(/\r?\n/).map(i=>i.trim()).filter(Boolean);if(t.length===0)return{};let n=t.shift(),r={};for(let i of t){let g=i.split(",");if(g.length<3)continue;let u=g[0]?.trim().toLowerCase(),s=g[2]?.trim(),o=Number(s);!u||!Number.isFinite(o)||o<=0||(!(u in r)||o<r[u])&&(r[u]=o)}return r}var[z,J]=await Promise.all([Z(L).then(V),j(M)]);function y(){return z}function X(){return J}function H(){return S}var h=class extends Error{constructor(t,n){super(n),this.name="DomainPricesError",this.code=t}},R=class extends h{constructor(t){super("ERR_UNSUPPORTED_EXTENSION",`Unsupported extension: ${t}`),this.name="UnsupportedExtensionError"}},P=class extends h{constructor(t){super("ERR_UNSUPPORTED_CURRENCY",`Unsupported currency: ${t}`),this.name="UnsupportedCurrencyError"}};function q(){return{countryCode:"US",currencyName:"United States Dollar",currencySymbol:"$",currencyCode:"USD",exchangeRate:1,inverseRate:1}}function p(e){return Number(e.toFixed(2))}function B(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 E=class{constructor(t){this.config=t}findRateInfo(t){if(t==="USD")return q();let n=this.config.exchangeRates.find(r=>r.currencyCode===t);if(!n)throw new P(t);return n}async getPrice(t,n,r={}){let i=this.config.createPrices,g=typeof this.config.vatRate=="number"?this.config.vatRate:U,u=this.config.discounts,s=A(t),o=r.transaction||"create",c;switch(o){case"renew":c=this.config.renewPrices?.[s]??i[s];break;case"restore":c=this.config.restorePrices?.[s]??i[s];break;case"transfer":c=this.config.transferPrices?.[s]??i[s];break;case"create":default:c=i[s];break}if(c===void 0||c===0)throw new R(s);let x=(n||"").toUpperCase();if(!(this.config.supportedCurrencies??["USD","NGN"]).includes(x))throw new P(n);let D=this.findRateInfo(x),k=D.currencySymbol,v=B(c,this.config.markup),d=p(v*D.exchangeRate),G=g,O=Array.from(new Set((r.discountCodes||[]).map(m=>m.toUpperCase()))),C=$(r.now),l=[];for(let m of O){let a=u[m];if(!a)continue;let w=Date.parse(a.startAt),N=Date.parse(a.endAt);Number.isNaN(w)||Number.isNaN(N)||C<w||C>N||a.extensions.includes(s)&&l.push(p(d*a.rate))}let f=0;l.length>0&&(r.discountPolicy==="stack"?f=p(l.reduce((m,a)=>m+a,0)):f=Math.max(...l)),f>d&&(f=d);let b=p(d-f),T=p(b*G),Q=p(b+T);return{extension:s,currency:x,basePrice:d,discount:f,tax:T,totalPrice:Q,symbol:k,transaction:o}}async getQuote(t,n,r={}){return this.getPrice(t,n,r)}},_={createPrices:y(),exchangeRates:X(),vatRate:U,discounts:H(),supportedCurrencies:["USD","NGN"]};async function W(e,t,n={}){return new E(_).getPrice(e,t,n)}async function st(e,t,n={}){return W(e,t,n)}export{_ as DEFAULT_CONFIG,U as DEFAULT_VAT_RATE,E as DomainPrices,E as DomainQuote,P as UnsupportedCurrencyError,R as UnsupportedExtensionError,W as getDefaultPrice,st as getDefaultQuote,et as isSupportedCurrency,rt as isSupportedExtension,I as listSupportedCurrencies,nt as listSupportedExtensions};
+var P={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 U=.075;function O(){return(Q.supportedCurrencies??["USD","NGN"]).slice()}function tt(e){if(!e)return!1;let t=e.toUpperCase();return O().includes(t)}function et(){let e=y();return Object.keys(e).sort()}function nt(e){let t=y(),n=A(e),r=t[n];return typeof r=="number"&&r>0}function A(e){return e&&e.trim().toLowerCase().replace(/^\.+/,"")}function $(e){return e instanceof Date?e.getTime():typeof e=="number"?e:Date.now()}var L="https://raw.githubusercontent.com/namewiz/registrar-pricelist/refs/heads/main/data/unified-create-prices.csv",M="https://raw.githubusercontent.com/namewiz/registrar-pricelist/refs/heads/main/data/exchange-rates.json";async function Z(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 j(e){let t=await fetch(e);if(!t.ok)throw new Error(`Failed to fetch ${e}: ${t.status} ${t.statusText}`);return t.json()}function V(e){let t=e.split(/\r?\n/).map(o=>o.trim()).filter(Boolean);if(t.length===0)return{};let n=t.shift(),r={};for(let o of t){let g=o.split(",");if(g.length<3)continue;let u=g[0]?.trim().toLowerCase(),s=g[2]?.trim(),i=Number(s);!u||!Number.isFinite(i)||i<=0||(!(u in r)||i<r[u])&&(r[u]=i)}return r}var[q,z]=await Promise.all([Z(L).then(V),j(M)]);function y(){return q}function J(){return z}function X(){return P}var h=class extends Error{constructor(t,n){super(n),this.name="DomainQuoteError",this.code=t}},E=class extends h{constructor(t){super("ERR_UNSUPPORTED_EXTENSION",`Unsupported extension: ${t}`),this.name="UnsupportedExtensionError"}},x=class extends h{constructor(t){super("ERR_UNSUPPORTED_CURRENCY",`Unsupported currency: ${t}`),this.name="UnsupportedCurrencyError"}};function H(){return{countryCode:"US",currencyName:"United States Dollar",currencySymbol:"$",currencyCode:"USD",exchangeRate:1,inverseRate:1}}function p(e){return Number(e.toFixed(2))}function B(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 H();let n=this.config.exchangeRates.find(r=>r.currencyCode===t);if(!n)throw new x(t);return n}async getQuote(t,n,r={}){let o=this.config.createPrices,g=typeof this.config.vatRate=="number"?this.config.vatRate:U,u=this.config.discounts,s=A(t),i=r.transaction||"create",c;switch(i){case"renew":c=this.config.renewPrices?.[s]??o[s];break;case"restore":c=this.config.restorePrices?.[s]??o[s];break;case"transfer":c=this.config.transferPrices?.[s]??o[s];break;case"create":default:c=o[s];break}if(c===void 0||c===0)throw new E(s);let R=(n||"").toUpperCase();if(!(this.config.supportedCurrencies??["USD","NGN"]).includes(R))throw new x(n);let D=this.findRateInfo(R),_=D.currencySymbol,k=B(c,this.config.markup),d=p(k*D.exchangeRate),v=g,F=Array.from(new Set((r.discountCodes||[]).map(m=>m.toUpperCase()))),b=$(r.now),l=[];for(let m of F){let a=u[m];if(!a)continue;let N=Date.parse(a.startAt),S=Date.parse(a.endAt);Number.isNaN(N)||Number.isNaN(S)||b<N||b>S||a.extensions.includes(s)&&l.push(p(d*a.rate))}let f=0;l.length>0&&(r.discountPolicy==="stack"?f=p(l.reduce((m,a)=>m+a,0)):f=Math.max(...l)),f>d&&(f=d);let T=p(d-f),w=p(T*v),G=p(T+w);return{extension:s,currency:R,basePrice:d,discount:f,tax:w,totalPrice:G,symbol:_,transaction:i}}},Q={createPrices:y(),exchangeRates:J(),vatRate:U,discounts:X(),supportedCurrencies:["USD","NGN"]};async function rt(e,t,n={}){return new C(Q).getQuote(e,t,n)}export{Q as DEFAULT_CONFIG,U as DEFAULT_VAT_RATE,C as DomainQuotes,x as UnsupportedCurrencyError,E as UnsupportedExtensionError,rt as getDefaultQuote,tt as isSupportedCurrency,nt as isSupportedExtension,O as listSupportedCurrencies,et as listSupportedExtensions};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domain-quotes",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Fast multi-currency domain quote checker library across registrars.",
   "type": "module",
   "main": "./dist/index.js",