domain-quotes 0.1.0 → 0.2.1

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 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};

package/package.json

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