@naverpay/nurl 1.1.0-canary.251230-92343a8 → 1.1.0-canary.251230-7c2e8df

package/dist/cjs/index.d.ts

@@ -1,3 +1,5 @@
+import { MaskOptions } from './utils.js';
+
 type Query = Record<string, any>;
 
 interface URLOptions extends Partial<Pick<URL, 'href' | 'protocol' | 'host' | 'hostname' | 'port' | 'pathname' | 'search' | 'hash' | 'username' | 'password'>> {
@@ -5,13 +7,6 @@ interface URLOptions extends Partial<Pick<URL, 'href' | 'protocol' | 'host' | 'h
     query?: Query;
     basePath?: string;
 }
-interface MaskOptions {
-    patterns: string[];
-    sensitiveParams: string[];
-    maskChar?: string;
-    maskLength?: number;
-    preserveLength?: boolean;
-}
 declare class NURL implements URL {
     private _href;
     private _protocol;
@@ -80,7 +75,7 @@ declare class NURL implements URL {
     get decodedIDN(): string;
     get decodedHostname(): string;
     static match(url: string, pattern: string): Record<string, string> | null;
-    static mask(url: string, { patterns, sensitiveParams, maskChar, maskLength, preserveLength }: MaskOptions): string;
+    static mask(url: string, options: MaskOptions): string;
 }
 
 export { NURL as default };

package/dist/cjs/nurl.js

@@ -1 +1 @@
-"use strict";const l=require("./punycode.js"),a=require("./utils.js");class c{constructor(t){if(this._href="",this._protocol="",this._host="",this._hostname="",this._port="",this._pathname="",this._search="",this._hash="",this._origin="",this._username="",this._password="",this._baseUrl="",this._searchParams=new URLSearchParams,this._basePath="",this.punycodePrefix="xn--",this._searchParams=new URLSearchParams,typeof t=="string"||t instanceof URL)this.href=t.toString();else if(t){if(t.basePath&&(this._basePath=t.basePath.startsWith("/")?t.basePath:`/${t.basePath}`),t.baseUrl&&(this.baseUrl=t.baseUrl),t.href&&(this.href=t.href),t.protocol&&(this.protocol=t.protocol),t.host&&(this.host=t.host),t.hostname&&(this.hostname=t.hostname),t.port&&(this.port=t.port),t.pathname!==void 0&&(t.pathname===""?this._pathname="":this.pathname=a.refinePathnameWithQuery(t.pathname,t.query??{})),t.search&&(this.search=t.search),t.hash&&(this.hash=t.hash),t.username&&(this.username=t.username),t.password&&(this.password=t.password),t.query){const s=a.refineQueryWithPathname(t.pathname??"",t.query);Object.keys(s).length>0&&(this.search=new URLSearchParams(a.convertQueryToArray(s)).toString())}this.updateHref()}}static withBasePath(t){return s=>typeof s=="string"||s instanceof URL?new c({href:s.toString(),basePath:t}):new c({...s,basePath:t})}static create(t){return new c(t)}static canParse(t){if(t.startsWith("/"))return/^\/[^?#]*(\?[^#]*)?(#.*)?$/.test(t);try{return new URL(t),!0}catch{return/^[^:/?#]+(\.[^:/?#]+)+(\/[^?#]*(\?[^#]*)?(#.*)?)?$/.test(t)}}get baseUrl(){return this._baseUrl}set baseUrl(t){this._baseUrl=t;try{const s=new URL(t);this._protocol=s.protocol,this._host=s.host,this._hostname=s.hostname,this._port=s.port,this._origin=s.origin,this._username=s.username,this._password=s.password,s.pathname!=="/"&&(this._pathname=s.pathname),s.search&&(this._search=s.search,this._searchParams=new URLSearchParams(s.search)),s.hash&&(this._hash=s.hash),this.updateHref()}catch(s){console.warn(`Invalid baseUrl: ${t}`,s)}}get href(){return this._href}set href(t){try{const s=new URL(t);this._href=s.href,this._protocol=s.protocol,this._host=s.host,this._hostname=s.hostname,this._port=s.port,this._pathname=s.pathname,this._search=s.search,this._hash=s.hash,this._origin=s.origin,this._username=s.username,this._password=s.password,this._searchParams=s.searchParams}catch(s){const e=c.parseStringToURLLike(t);if(!e)throw console.warn(`Can not parse ${t}`),s;this._href=e.href,this._protocol=e.protocol,this._host=e.hostname,this._hostname=e.hostname,this._port=e.port,this._pathname=e.pathname,this._search=e.search,this._hash=e.hash,this._origin=e.origin,this._username=e.username,this._password=e.password,this._searchParams=e.searchParams}}static parseStringToURLLike(t){const s=/^(?:(https?:\/\/)(?:([^:@]+)(?::([^@]+))?@)?((?:[^/:?#]+)(?::(\d+))?)?)?([/][^?#]*)?(\?[^#]*)?(#.*)?$/,e=t.match(s),[r=t,i="",n="",_="",h="",o="",m="",p="",f=""]=e||[];if(!e||i&&!h&&!m&&!p&&!f)return null;const d=i&&h?`${i}//${h}${o?`:${o}`:""}`:"";return{href:r,protocol:i,host:h,hostname:h,port:o,pathname:t?m||"/":"",search:p,hash:f,origin:d,username:n,password:_,searchParams:new URLSearchParams(p)}}get protocol(){return this._protocol}set protocol(t){this._protocol=t,this.updateHref()}get host(){return this._host}set host(t){const[s,e]=t.split(":"),r=this.encodeHostname(s);this._host=e?`${r}:${e}`:r,this._hostname=r,this._port=e||"",this.updateHref()}get hostname(){return this._hostname}set hostname(t){const s=this.encodeHostname(t);this._hostname=s,this._host=this._port?`${s}:${this._port}`:s,this.updateHref()}get port(){return this._port}set port(t){this._port=t,this._host=`${this._hostname}${t?":"+t:""}`,this.updateHref()}get pathname(){return this._pathname}set pathname(t){let s=t;if(t===""){s="/",this._pathname=s,this.updateHref();return}this._basePath&&!s.startsWith(this._basePath)&&(s=`${this._basePath}${s.startsWith("/")?"":"/"}${s}`);const e=s.split("/").map(r=>a.isDynamicPath(r)?r:encodeURI(r)).join("/");this._pathname=e.startsWith("/")?e:`/${e}`,this.updateHref()}get search(){return this._search}set search(t){this._search=t.startsWith("?")?t:`?${t}`,this._searchParams=new URLSearchParams(t),this.updateHref()}setSearchParams(t){const s=new URLSearchParams(t);this._search=s.toString()?`?${s.toString()}`:"",this._searchParams=s,this.updateHref()}appendSearchParams(t){const s=new URLSearchParams(this._searchParams),e=a.getDynamicPaths(this._pathname).map(a.extractPathKey);Object.keys(t).forEach(r=>{e.includes(r)?this._pathname=a.refinePathnameWithQuery(this._pathname,{[r]:t[r]}):s.append(r,t[r])}),this._search=s.toString()?`?${s.toString()}`:"",this._searchParams=s,this.updateHref()}removeSearchParams(...t){const s=new URLSearchParams(this._searchParams);t.forEach(e=>{s.delete(e)}),this._search=s.toString()?`?${s.toString()}`:"",this._searchParams=s,this.updateHref()}get searchParams(){return new Proxy(this._searchParams,{get:(t,s,e)=>{const r=Reflect.get(t,s,e);return typeof r=="function"?(...i)=>{const n=r.apply(t,i);return this._search=this._searchParams.toString()?`?${this._searchParams.toString()}`:"",this.updateHref(),n}:r}})}get hash(){return this._hash}set hash(t){this._hash=t.startsWith("#")?t:`#${t}`,this.updateHref()}get origin(){return this._origin}get username(){return this._username}set username(t){this._username=t,this.updateHref()}get password(){return this._password}set password(t){this._password=t,this.updateHref()}updateHref(){const t=this._pathname;if(this._baseUrl){const s=new URL(this._baseUrl);s.pathname=t,s.search=this._search,s.hash=this._hash,this._href=s.href,this._origin=s.origin}else this._href=`${this._protocol}${this._protocol&&"//"}${this._username}${this._password?":"+this._password:""}${this._username||this._password?"@":""}${this._hostname}${this._port?":"+this._port:""}${t}${this._search}${this._hash}`,this._origin=`${this._protocol}//${this._hostname}${this._port?":"+this._port:""}`}toString(){return this.href}toJSON(){return this.href}encodeHostname(t){return t.split(".").map(s=>{for(const e of s)if(a.isASCIICodeChar(e))return`${this.punycodePrefix}${l.encode(s)}`;return s}).join(".")}get decodedIDN(){let t=this._href;return this._hostname.split(".").forEach(s=>{t=t.replace(s,l.decode(s.replace(this.punycodePrefix,"")))}),t}get decodedHostname(){return this._hostname.split(".").map(t=>l.decode(t.replace(this.punycodePrefix,""))).join(".")}static match(t,s){if(!c.canParse(t)||!c.canParse(s))return null;const e=t.split(/[?#]/)[0]?.split("/").filter(Boolean)||[],r=s.split(/[?#]/)[0]?.split("/").filter(Boolean)||[];if(e.length!==r.length)return null;const i={};for(let n=0;n<r.length;n++){const _=r[n],h=e[n];if(a.isDynamicPath(_)){const o=a.extractPathKey(_);i[o]=h}else if(_!==h)return null}return i}static mask(t,{patterns:s,sensitiveParams:e,maskChar:r="*",maskLength:i=4,preserveLength:n=!1}){const _=[...s].sort((h,o)=>a.getPathPriority(o)>a.getPathPriority(h)?1:-1);for(const h of _){const o=c.create(t),m=c.match(o.pathname,h);if(m)return e.forEach(p=>{if(p in m){const f=m[p],d=n?f.length:i;m[p]=r.repeat(d)}}),o.pathname=a.refinePathnameWithQuery(h,m),o.toString()}return t}}module.exports=c;
+"use strict";const m=require("./punycode.js"),d=require("./utils/external.js"),r=require("./utils/internal.js");class i{constructor(t){if(this._href="",this._protocol="",this._host="",this._hostname="",this._port="",this._pathname="",this._search="",this._hash="",this._origin="",this._username="",this._password="",this._baseUrl="",this._searchParams=new URLSearchParams,this._basePath="",this.punycodePrefix="xn--",this._searchParams=new URLSearchParams,typeof t=="string"||t instanceof URL)this.href=t.toString();else if(t){if(t.basePath&&(this._basePath=t.basePath.startsWith("/")?t.basePath:`/${t.basePath}`),t.baseUrl&&(this.baseUrl=t.baseUrl),t.href&&(this.href=t.href),t.protocol&&(this.protocol=t.protocol),t.host&&(this.host=t.host),t.hostname&&(this.hostname=t.hostname),t.port&&(this.port=t.port),t.pathname!==void 0&&(t.pathname===""?this._pathname="":this.pathname=r.refinePathnameWithQuery(t.pathname,t.query??{})),t.search&&(this.search=t.search),t.hash&&(this.hash=t.hash),t.username&&(this.username=t.username),t.password&&(this.password=t.password),t.query){const s=r.refineQueryWithPathname(t.pathname??"",t.query);Object.keys(s).length>0&&(this.search=new URLSearchParams(r.convertQueryToArray(s)).toString())}this.updateHref()}}static withBasePath(t){return s=>typeof s=="string"||s instanceof URL?new i({href:s.toString(),basePath:t}):new i({...s,basePath:t})}static create(t){return new i(t)}static canParse(t){if(t.startsWith("/"))return/^\/[^?#]*(\?[^#]*)?(#.*)?$/.test(t);try{return new URL(t),!0}catch{return/^[^:/?#]+(\.[^:/?#]+)+(\/[^?#]*(\?[^#]*)?(#.*)?)?$/.test(t)}}get baseUrl(){return this._baseUrl}set baseUrl(t){this._baseUrl=t;try{const s=new URL(t);this._protocol=s.protocol,this._host=s.host,this._hostname=s.hostname,this._port=s.port,this._origin=s.origin,this._username=s.username,this._password=s.password,s.pathname!=="/"&&(this._pathname=s.pathname),s.search&&(this._search=s.search,this._searchParams=new URLSearchParams(s.search)),s.hash&&(this._hash=s.hash),this.updateHref()}catch(s){console.warn(`Invalid baseUrl: ${t}`,s)}}get href(){return this._href}set href(t){try{const s=new URL(t);this._href=s.href,this._protocol=s.protocol,this._host=s.host,this._hostname=s.hostname,this._port=s.port,this._pathname=s.pathname,this._search=s.search,this._hash=s.hash,this._origin=s.origin,this._username=s.username,this._password=s.password,this._searchParams=s.searchParams}catch(s){const e=i.parseStringToURLLike(t);if(!e)throw console.warn(`Can not parse ${t}`),s;this._href=e.href,this._protocol=e.protocol,this._host=e.hostname,this._hostname=e.hostname,this._port=e.port,this._pathname=e.pathname,this._search=e.search,this._hash=e.hash,this._origin=e.origin,this._username=e.username,this._password=e.password,this._searchParams=e.searchParams}}static parseStringToURLLike(t){const s=/^(?:(https?:\/\/)(?:([^:@]+)(?::([^@]+))?@)?((?:[^/:?#]+)(?::(\d+))?)?)?([/][^?#]*)?(\?[^#]*)?(#.*)?$/,e=t.match(s),[h=t,a="",n="",P="",o="",c="",p="",_="",f=""]=e||[];if(!e||a&&!o&&!p&&!_&&!f)return null;const l=a&&o?`${a}//${o}${c?`:${c}`:""}`:"";return{href:h,protocol:a,host:o,hostname:o,port:c,pathname:t?p||"/":"",search:_,hash:f,origin:l,username:n,password:P,searchParams:new URLSearchParams(_)}}get protocol(){return this._protocol}set protocol(t){this._protocol=t,this.updateHref()}get host(){return this._host}set host(t){const[s,e]=t.split(":"),h=this.encodeHostname(s);this._host=e?`${h}:${e}`:h,this._hostname=h,this._port=e||"",this.updateHref()}get hostname(){return this._hostname}set hostname(t){const s=this.encodeHostname(t);this._hostname=s,this._host=this._port?`${s}:${this._port}`:s,this.updateHref()}get port(){return this._port}set port(t){this._port=t,this._host=`${this._hostname}${t?":"+t:""}`,this.updateHref()}get pathname(){return this._pathname}set pathname(t){let s=t;if(t===""){s="/",this._pathname=s,this.updateHref();return}this._basePath&&!s.startsWith(this._basePath)&&(s=`${this._basePath}${s.startsWith("/")?"":"/"}${s}`);const e=s.split("/").map(h=>r.isDynamicPath(h)?h:encodeURI(h)).join("/");this._pathname=e.startsWith("/")?e:`/${e}`,this.updateHref()}get search(){return this._search}set search(t){this._search=t.startsWith("?")?t:`?${t}`,this._searchParams=new URLSearchParams(t),this.updateHref()}setSearchParams(t){const s=new URLSearchParams(t);this._search=s.toString()?`?${s.toString()}`:"",this._searchParams=s,this.updateHref()}appendSearchParams(t){const s=new URLSearchParams(this._searchParams),e=r.getDynamicPaths(this._pathname).map(r.extractPathKey);Object.keys(t).forEach(h=>{e.includes(h)?this._pathname=r.refinePathnameWithQuery(this._pathname,{[h]:t[h]}):s.append(h,t[h])}),this._search=s.toString()?`?${s.toString()}`:"",this._searchParams=s,this.updateHref()}removeSearchParams(...t){const s=new URLSearchParams(this._searchParams);t.forEach(e=>{s.delete(e)}),this._search=s.toString()?`?${s.toString()}`:"",this._searchParams=s,this.updateHref()}get searchParams(){return new Proxy(this._searchParams,{get:(t,s,e)=>{const h=Reflect.get(t,s,e);return typeof h=="function"?(...a)=>{const n=h.apply(t,a);return this._search=this._searchParams.toString()?`?${this._searchParams.toString()}`:"",this.updateHref(),n}:h}})}get hash(){return this._hash}set hash(t){this._hash=t.startsWith("#")?t:`#${t}`,this.updateHref()}get origin(){return this._origin}get username(){return this._username}set username(t){this._username=t,this.updateHref()}get password(){return this._password}set password(t){this._password=t,this.updateHref()}updateHref(){const t=this._pathname;if(this._baseUrl){const s=new URL(this._baseUrl);s.pathname=t,s.search=this._search,s.hash=this._hash,this._href=s.href,this._origin=s.origin}else this._href=`${this._protocol}${this._protocol&&"//"}${this._username}${this._password?":"+this._password:""}${this._username||this._password?"@":""}${this._hostname}${this._port?":"+this._port:""}${t}${this._search}${this._hash}`,this._origin=`${this._protocol}//${this._hostname}${this._port?":"+this._port:""}`}toString(){return this.href}toJSON(){return this.href}encodeHostname(t){return t.split(".").map(s=>{for(const e of s)if(r.isASCIICodeChar(e))return`${this.punycodePrefix}${m.encode(s)}`;return s}).join(".")}get decodedIDN(){let t=this._href;return this._hostname.split(".").forEach(s=>{t=t.replace(s,m.decode(s.replace(this.punycodePrefix,"")))}),t}get decodedHostname(){return this._hostname.split(".").map(t=>m.decode(t.replace(this.punycodePrefix,""))).join(".")}static match(t,s){return d.match(t,s)}static mask(t,s){return d.mask(t,s)}}module.exports=i;

package/dist/cjs/utils/external.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("../nurl.js"),l=require("./internal.js"),g=(r,c)=>{if(!f.canParse(r)||!f.canParse(c))return null;const i=r.split(/[?#]/)[0]?.split("/").filter(Boolean)||[],a=c.split(/[?#]/)[0]?.split("/").filter(Boolean)||[];if(i.length!==a.length)return null;const u={};for(let n=0;n<a.length;n++){const o=a[n],t=i[n];if(l.isDynamicPath(o)){const e=l.extractPathKey(o);u[e]=t}else if(o!==t)return null}return u},P=(r,{patterns:c,sensitiveParams:i,maskChar:a="*",maskLength:u=4,preserveLength:n=!1})=>{const o=[...c].sort((t,e)=>l.getPathPriority(e)>l.getPathPriority(t)?1:-1);for(const t of o){const e=f.create(r),s=g(e.pathname,t);if(s)return i.forEach(h=>{if(h in s){const m=s[h],p=n?m.length:u;s[h]=a.repeat(p)}}),e.pathname=l.refinePathnameWithQuery(t,s),e.toString()}return r};exports.mask=P;exports.match=g;

package/dist/cjs/utils/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./external.js");exports.mask=e.mask;exports.match=e.match;

package/dist/cjs/utils.d.ts

@@ -0,0 +1,11 @@
+declare const match: (url: string, pattern: string) => Record<string, string> | null;
+interface MaskOptions {
+    patterns: string[];
+    sensitiveParams: string[];
+    maskChar?: string;
+    maskLength?: number;
+    preserveLength?: boolean;
+}
+declare const mask: (url: string, { patterns, sensitiveParams, maskChar, maskLength, preserveLength }: MaskOptions) => string;
+
+export { type MaskOptions, mask, match };

package/dist/esm/index.d.mts

@@ -1,3 +1,5 @@
+import { MaskOptions } from './utils.mjs';
+
 type Query = Record<string, any>;
 
 interface URLOptions extends Partial<Pick<URL, 'href' | 'protocol' | 'host' | 'hostname' | 'port' | 'pathname' | 'search' | 'hash' | 'username' | 'password'>> {
@@ -5,13 +7,6 @@ interface URLOptions extends Partial<Pick<URL, 'href' | 'protocol' | 'host' | 'h
     query?: Query;
     basePath?: string;
 }
-interface MaskOptions {
-    patterns: string[];
-    sensitiveParams: string[];
-    maskChar?: string;
-    maskLength?: number;
-    preserveLength?: boolean;
-}
 declare class NURL implements URL {
     private _href;
     private _protocol;
@@ -80,7 +75,7 @@ declare class NURL implements URL {
     get decodedIDN(): string;
     get decodedHostname(): string;
     static match(url: string, pattern: string): Record<string, string> | null;
-    static mask(url: string, { patterns, sensitiveParams, maskChar, maskLength, preserveLength }: MaskOptions): string;
+    static mask(url: string, options: MaskOptions): string;
 }
 
 export { NURL as default };

package/dist/esm/nurl.mjs

@@ -1,28 +1,29 @@
-import { encode as $, decode as d } from "./punycode.mjs";
-import { refinePathnameWithQuery as l, refineQueryWithPathname as w, convertQueryToArray as S, isDynamicPath as P, getDynamicPaths as y, extractPathKey as g, isASCIICodeChar as b, getPathPriority as u } from "./utils.mjs";
-class n {
+import { encode as l, decode as p } from "./punycode.mjs";
+import { match as g, mask as u } from "./utils/external.mjs";
+import { refinePathnameWithQuery as f, refineQueryWithPathname as $, convertQueryToArray as w, isDynamicPath as S, getDynamicPaths as U, extractPathKey as H, isASCIICodeChar as b } from "./utils/internal.mjs";
+class i {
   constructor(t) {
     if (this._href = "", this._protocol = "", this._host = "", this._hostname = "", this._port = "", this._pathname = "", this._search = "", this._hash = "", this._origin = "", this._username = "", this._password = "", this._baseUrl = "", this._searchParams = new URLSearchParams(), this._basePath = "", this.punycodePrefix = "xn--", this._searchParams = new URLSearchParams(), typeof t == "string" || t instanceof URL)
       this.href = t.toString();
     else if (t) {
-      if (t.basePath && (this._basePath = t.basePath.startsWith("/") ? t.basePath : `/${t.basePath}`), t.baseUrl && (this.baseUrl = t.baseUrl), t.href && (this.href = t.href), t.protocol && (this.protocol = t.protocol), t.host && (this.host = t.host), t.hostname && (this.hostname = t.hostname), t.port && (this.port = t.port), t.pathname !== void 0 && (t.pathname === "" ? this._pathname = "" : this.pathname = l(t.pathname, t.query ?? {})), t.search && (this.search = t.search), t.hash && (this.hash = t.hash), t.username && (this.username = t.username), t.password && (this.password = t.password), t.query) {
-        const s = w(t.pathname ?? "", t.query);
-        Object.keys(s).length > 0 && (this.search = new URLSearchParams(S(s)).toString());
+      if (t.basePath && (this._basePath = t.basePath.startsWith("/") ? t.basePath : `/${t.basePath}`), t.baseUrl && (this.baseUrl = t.baseUrl), t.href && (this.href = t.href), t.protocol && (this.protocol = t.protocol), t.host && (this.host = t.host), t.hostname && (this.hostname = t.hostname), t.port && (this.port = t.port), t.pathname !== void 0 && (t.pathname === "" ? this._pathname = "" : this.pathname = f(t.pathname, t.query ?? {})), t.search && (this.search = t.search), t.hash && (this.hash = t.hash), t.username && (this.username = t.username), t.password && (this.password = t.password), t.query) {
+        const s = $(t.pathname ?? "", t.query);
+        Object.keys(s).length > 0 && (this.search = new URLSearchParams(w(s)).toString());
       }
       this.updateHref();
     }
   }
   static withBasePath(t) {
-    return (s) => typeof s == "string" || s instanceof URL ? new n({
+    return (s) => typeof s == "string" || s instanceof URL ? new i({
       href: s.toString(),
       basePath: t
-    }) : new n({
+    }) : new i({
       ...s,
       basePath: t
     });
   }
   static create(t) {
-    return new n(t);
+    return new i(t);
   }
   static canParse(t) {
     if (t.startsWith("/"))
@@ -53,30 +54,30 @@ class n {
       const s = new URL(t);
       this._href = s.href, this._protocol = s.protocol, this._host = s.host, this._hostname = s.hostname, this._port = s.port, this._pathname = s.pathname, this._search = s.search, this._hash = s.hash, this._origin = s.origin, this._username = s.username, this._password = s.password, this._searchParams = s.searchParams;
     } catch (s) {
-      const e = n.parseStringToURLLike(t);
+      const e = i.parseStringToURLLike(t);
       if (!e)
         throw console.warn(`Can not parse ${t}`), s;
       this._href = e.href, this._protocol = e.protocol, this._host = e.hostname, this._hostname = e.hostname, this._port = e.port, this._pathname = e.pathname, this._search = e.search, this._hash = e.hash, this._origin = e.origin, this._username = e.username, this._password = e.password, this._searchParams = e.searchParams;
     }
   }
   static parseStringToURLLike(t) {
-    const s = /^(?:(https?:\/\/)(?:([^:@]+)(?::([^@]+))?@)?((?:[^/:?#]+)(?::(\d+))?)?)?([/][^?#]*)?(\?[^#]*)?(#.*)?$/, e = t.match(s), [r = t, a = "", i = "", m = "", h = "", o = "", c = "", _ = "", p = ""] = e || [];
-    if (!e || a && !h && !c && !_ && !p)
+    const s = /^(?:(https?:\/\/)(?:([^:@]+)(?::([^@]+))?@)?((?:[^/:?#]+)(?::(\d+))?)?)?([/][^?#]*)?(\?[^#]*)?(#.*)?$/, e = t.match(s), [h = t, r = "", o = "", d = "", a = "", n = "", _ = "", c = "", m = ""] = e || [];
+    if (!e || r && !a && !_ && !c && !m)
       return null;
-    const f = a && h ? `${a}//${h}${o ? `:${o}` : ""}` : "";
+    const P = r && a ? `${r}//${a}${n ? `:${n}` : ""}` : "";
     return {
-      href: r,
-      protocol: a,
-      host: h,
-      hostname: h,
-      port: o,
-      pathname: t ? c || "/" : "",
-      search: _,
-      hash: p,
-      origin: f,
-      username: i,
-      password: m,
-      searchParams: new URLSearchParams(_)
+      href: h,
+      protocol: r,
+      host: a,
+      hostname: a,
+      port: n,
+      pathname: t ? _ || "/" : "",
+      search: c,
+      hash: m,
+      origin: P,
+      username: o,
+      password: d,
+      searchParams: new URLSearchParams(c)
     };
   }
   get protocol() {
@@ -89,8 +90,8 @@ class n {
     return this._host;
   }
   set host(t) {
-    const [s, e] = t.split(":"), r = this.encodeHostname(s);
-    this._host = e ? `${r}:${e}` : r, this._hostname = r, this._port = e || "", this.updateHref();
+    const [s, e] = t.split(":"), h = this.encodeHostname(s);
+    this._host = e ? `${h}:${e}` : h, this._hostname = h, this._port = e || "", this.updateHref();
   }
   get hostname() {
     return this._hostname;
@@ -115,7 +116,7 @@ class n {
       return;
     }
     this._basePath && !s.startsWith(this._basePath) && (s = `${this._basePath}${s.startsWith("/") ? "" : "/"}${s}`);
-    const e = s.split("/").map((r) => P(r) ? r : encodeURI(r)).join("/");
+    const e = s.split("/").map((h) => S(h) ? h : encodeURI(h)).join("/");
     this._pathname = e.startsWith("/") ? e : `/${e}`, this.updateHref();
   }
   get search() {
@@ -129,11 +130,11 @@ class n {
     this._search = s.toString() ? `?${s.toString()}` : "", this._searchParams = s, this.updateHref();
   }
   appendSearchParams(t) {
-    const s = new URLSearchParams(this._searchParams), e = y(this._pathname).map(g);
-    Object.keys(t).forEach((r) => {
-      e.includes(r) ? this._pathname = l(this._pathname, {
-        [r]: t[r]
-      }) : s.append(r, t[r]);
+    const s = new URLSearchParams(this._searchParams), e = U(this._pathname).map(H);
+    Object.keys(t).forEach((h) => {
+      e.includes(h) ? this._pathname = f(this._pathname, {
+        [h]: t[h]
+      }) : s.append(h, t[h]);
     }), this._search = s.toString() ? `?${s.toString()}` : "", this._searchParams = s, this.updateHref();
   }
   removeSearchParams(...t) {
@@ -145,11 +146,11 @@ class n {
   get searchParams() {
     return new Proxy(this._searchParams, {
       get: (t, s, e) => {
-        const r = Reflect.get(t, s, e);
-        return typeof r == "function" ? (...a) => {
-          const i = r.apply(t, a);
-          return this._search = this._searchParams.toString() ? `?${this._searchParams.toString()}` : "", this.updateHref(), i;
-        } : r;
+        const h = Reflect.get(t, s, e);
+        return typeof h == "function" ? (...r) => {
+          const o = h.apply(t, r);
+          return this._search = this._searchParams.toString() ? `?${this._searchParams.toString()}` : "", this.updateHref(), o;
+        } : h;
       }
     });
   }
@@ -192,57 +193,26 @@ class n {
     return t.split(".").map((s) => {
       for (const e of s)
         if (b(e))
-          return `${this.punycodePrefix}${$(s)}`;
+          return `${this.punycodePrefix}${l(s)}`;
       return s;
     }).join(".");
   }
   get decodedIDN() {
     let t = this._href;
     return this._hostname.split(".").forEach((s) => {
-      t = t.replace(s, d(s.replace(this.punycodePrefix, "")));
+      t = t.replace(s, p(s.replace(this.punycodePrefix, "")));
     }), t;
   }
   get decodedHostname() {
-    return this._hostname.split(".").map((t) => d(t.replace(this.punycodePrefix, ""))).join(".");
+    return this._hostname.split(".").map((t) => p(t.replace(this.punycodePrefix, ""))).join(".");
   }
   static match(t, s) {
-    if (!n.canParse(t) || !n.canParse(s))
-      return null;
-    const e = t.split(/[?#]/)[0]?.split("/").filter(Boolean) || [], r = s.split(/[?#]/)[0]?.split("/").filter(Boolean) || [];
-    if (e.length !== r.length)
-      return null;
-    const a = {};
-    for (let i = 0; i < r.length; i++) {
-      const m = r[i], h = e[i];
-      if (P(m)) {
-        const o = g(m);
-        a[o] = h;
-      } else if (m !== h)
-        return null;
-    }
-    return a;
-  }
-  static mask(t, {
-    patterns: s,
-    sensitiveParams: e,
-    maskChar: r = "*",
-    maskLength: a = 4,
-    preserveLength: i = !1
-  }) {
-    const m = [...s].sort((h, o) => u(o) > u(h) ? 1 : -1);
-    for (const h of m) {
-      const o = n.create(t), c = n.match(o.pathname, h);
-      if (c)
-        return e.forEach((_) => {
-          if (_ in c) {
-            const p = c[_], f = i ? p.length : a;
-            c[_] = r.repeat(f);
-          }
-        }), o.pathname = l(h, c), o.toString();
-    }
-    return t;
+    return g(t, s);
+  }
+  static mask(t, s) {
+    return u(t, s);
   }
 }
 export {
-  n as default
+  i as default
 };

package/dist/esm/utils/external.mjs

@@ -0,0 +1,42 @@
+import h from "../nurl.mjs";
+import { isDynamicPath as g, extractPathKey as P, getPathPriority as m, refinePathnameWithQuery as y } from "./internal.mjs";
+const S = (r, l) => {
+  if (!h.canParse(r) || !h.canParse(l))
+    return null;
+  const c = r.split(/[?#]/)[0]?.split("/").filter(Boolean) || [], o = l.split(/[?#]/)[0]?.split("/").filter(Boolean) || [];
+  if (c.length !== o.length)
+    return null;
+  const i = {};
+  for (let n = 0; n < o.length; n++) {
+    const a = o[n], t = c[n];
+    if (g(a)) {
+      const e = P(a);
+      i[e] = t;
+    } else if (a !== t)
+      return null;
+  }
+  return i;
+}, x = (r, {
+  patterns: l,
+  sensitiveParams: c,
+  maskChar: o = "*",
+  maskLength: i = 4,
+  preserveLength: n = !1
+}) => {
+  const a = [...l].sort((t, e) => m(e) > m(t) ? 1 : -1);
+  for (const t of a) {
+    const e = h.create(r), s = S(e.pathname, t);
+    if (s)
+      return c.forEach((f) => {
+        if (f in s) {
+          const p = s[f], u = n ? p.length : i;
+          s[f] = o.repeat(u);
+        }
+      }), e.pathname = y(t, s), e.toString();
+  }
+  return r;
+};
+export {
+  x as mask,
+  S as match
+};

package/dist/esm/utils/index.mjs

@@ -0,0 +1,5 @@
+import { mask as o, match as r } from "./external.mjs";
+export {
+  o as mask,
+  r as match
+};

package/dist/esm/utils.d.mts

@@ -0,0 +1,11 @@
+declare const match: (url: string, pattern: string) => Record<string, string> | null;
+interface MaskOptions {
+    patterns: string[];
+    sensitiveParams: string[];
+    maskChar?: string;
+    maskLength?: number;
+    preserveLength?: boolean;
+}
+declare const mask: (url: string, { patterns, sensitiveParams, maskChar, maskLength, preserveLength }: MaskOptions) => string;
+
+export { type MaskOptions, mask, match };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naverpay/nurl",
-  "version": "1.1.0-canary.251230-92343a8",
+  "version": "1.1.0-canary.251230-7c2e8df",
   "description": "URL build library",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.mjs",
@@ -16,6 +16,16 @@
         "default": "./dist/cjs/index.js"
       }
     },
+    "./utils": {
+      "import": {
+        "types": "./dist/esm/utils.d.mts",
+        "default": "./dist/esm/utils/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/utils.d.ts",
+        "default": "./dist/cjs/utils/index.js"
+      }
+    },
     "./package.json": "./package.json"
   },
   "files": [