nport 2.1.0 → 2.1.2

package/dist/bin-manager.js

@@ -0,0 +1 @@
+var C=Object.defineProperty;var o=(r,n)=>C(r,"name",{value:n,configurable:!0});import s from"fs";import u from"path";import S from"https";import w from"os";import{execSync as _}from"child_process";import{fileURLToPath as E}from"url";var $=E(import.meta.url),v=u.dirname(u.dirname($)),m=u.join(v,"bin"),g="cloudflared",A=".tgz",R="cloudflared.tgz",f=w.platform(),p=w.arch(),h=f==="win32",N=h?`${g}.exe`:g,i=u.join(m,N),P="https://github.com/cloudflare/cloudflared/releases/latest/download",T=[301,302],D=200,M="755",U={darwin:{x64:"cloudflared-darwin-amd64.tgz",arm64:"cloudflared-darwin-arm64.tgz"},win32:{x64:"cloudflared-windows-amd64.exe",ia32:"cloudflared-windows-386.exe"},linux:{x64:"cloudflared-linux-amd64",arm64:"cloudflared-linux-arm64",arm:"cloudflared-linux-arm"}};function b(r){return{x64:"x64",amd64:"amd64",arm64:"arm64",ia32:"ia32",arm:"arm"}[r]||r}o(b,"normalizeArch");function B(){let r=b(p),n=U[f];if(!n)throw new Error(`Unsupported platform: ${f}. Supported platforms: darwin, win32, linux`);let t=n[r];if(!t)throw new Error(`Unsupported architecture: ${p} for platform ${f}. Supported architectures: ${Object.keys(n).join(", ")}`);return`${P}/${t}`}o(B,"getDownloadUrl");function L(r){return r.endsWith(A)}o(L,"isCompressedArchive");function O(r){s.existsSync(r)||s.mkdirSync(r,{recursive:!0})}o(O,"ensureDirectory");function c(r){try{s.existsSync(r)&&s.unlinkSync(r)}catch{}}o(c,"safeUnlink");function x(r,n=M){h||s.chmodSync(r,n)}o(x,"setExecutablePermissions");function z(r,n){if(!s.existsSync(r))throw new Error(n||`File not found: ${r}`)}o(z,"validateFileExists");async function y(r,n){return new Promise((t,d)=>{let e=s.createWriteStream(n);S.get(r,a=>{if(T.includes(a.statusCode)){e.close(),c(n),y(a.headers.location,n).then(t).catch(d);return}if(a.statusCode!==D){e.close(),c(n),d(new Error(`Download failed with status code ${a.statusCode} from ${r}`));return}a.pipe(e),e.on("finish",()=>{e.close(()=>t(n))}),e.on("error",I=>{e.close(),c(n),d(I)})}).on("error",a=>{e.close(),c(n),d(new Error(`Network error: ${a.message}`))})})}o(y,"downloadFile");function F(r,n){try{_(`tar -xzf "${r}" -C "${n}"`,{stdio:"pipe"})}catch(t){throw new Error(`Extraction failed: ${t.message}`)}}o(F,"extractTarGz");var l={info:o(r=>console.log(`\u2139\uFE0F  ${r}`),"info"),success:o(r=>console.log(`\u2705 ${r}`),"success"),warn:o(r=>console.warn(`\u26A0\uFE0F  ${r}`),"warn"),error:o(r=>console.error(`\u274C ${r}`),"error"),progress:o(r=>console.log(`\u{1F6A7} ${r}`),"progress"),extract:o(r=>console.log(`\u{1F4E6} ${r}`),"extract")};async function k(){l.progress("Cloudflared binary not found. Downloading... (This happens only once)");let r=B(),n=L(r),t=n?u.join(m,R):i;try{return await y(r,t),n&&(l.extract("Extracting binary..."),F(t,m),c(t),z(i,"Extraction failed: Binary not found after extraction")),x(i),l.success("Download complete."),i}catch(d){throw c(t),c(i),d}}o(k,"installBinary");async function G(){if(O(m),s.existsSync(i))return x(i),i;try{return await k()}catch(r){l.error(`Installation failed: ${r.message}`),process.exit(1)}}o(G,"ensureCloudflared");function H(){return!!(process.env.CI||process.env.GITHUB_ACTIONS||process.env.GITLAB_CI||process.env.CIRCLECI||process.env.TRAVIS||process.env.JENKINS_URL||process.env.BUILDKITE)}o(H,"isCI");async function W(){if(H()){l.info("Running in CI environment - skipping binary download");return}try{let r=await G();l.success(`Cloudflared binary is ready at: ${r}`)}catch(r){l.error(r.message),process.exit(1)}}o(W,"main");var j=E(import.meta.url);(process.argv[1]===j||process.argv[1]?.endsWith("bin-manager.js"))&&W();export{G as ensureCloudflared};

package/dist/index.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+var he=Object.defineProperty;var i=(o,e)=>he(o,"name",{value:e,configurable:!0});import on from"ora";import b from"chalk";import P from"path";import{fileURLToPath as Ie}from"url";import{createRequire as we}from"module";var Q="https://api.nport.link";var X="user-";var $={THRESHOLD:5,COOLDOWN:3e4},Z={SUCCESS:["Registered tunnel connection"],ERROR:["ERR","error"],NETWORK_WARNING:["failed to accept QUIC stream","failed to dial to edge with quic","failed to accept incoming stream requests","Failed to dial a quic connection","timeout: no recent network activity","failed to dial to edge","quic:"],IGNORE:["Cannot determine default origin certificate path","No file cert.pem","origincert option","TUNNEL_ORIGIN_CERT","context canceled","failed to run the datagram handler","failed to serve tunnel connection","Connection terminated","no more connections active and exiting","Serve tunnel error","accept stream listener encountered a failure","Retrying connection","icmp router terminated","use of closed network connection","Application error 0x0"]},ee=["en","vi"],ne="https://github.com/tuanngocptn/nport",B="https://nport.link",te="https://buymeacoffee.com/tuanngocptn";var Ee=Ie(import.meta.url),oe=P.dirname(P.dirname(Ee)),be=we(import.meta.url),re=be("../package.json");function Ce(){return process.env.NPORT_BACKEND_URL?process.env.NPORT_BACKEND_URL:Q}i(Ce,"getBackendUrl");var u={PACKAGE_NAME:re.name,CURRENT_VERSION:re.version,BACKEND_URL:Ce(),DEFAULT_PORT:8080,SUBDOMAIN_PREFIX:X,TUNNEL_TIMEOUT_HOURS:4,UPDATE_CHECK_TIMEOUT:3e3},ke={IS_WINDOWS:process.platform==="win32",BIN_NAME:process.platform==="win32"?"cloudflared.exe":"cloudflared"},x={BIN_DIR:P.join(oe,"bin"),BIN_PATH:P.join(oe,"bin",ke.BIN_NAME)},U=Z,W={WARNING_THRESHOLD:$.THRESHOLD,WARNING_COOLDOWN:$.COOLDOWN},se=u.TUNNEL_TIMEOUT_HOURS*60*60*1e3;var O=class{static{i(this,"ArgumentParser")}static parse(e){let n=this.parsePort(e),t=this.parseSubdomain(e),r=this.parseLanguage(e),c=this.parseBackendUrl(e),g=this.parseSetBackend(e);return{port:n,subdomain:t,language:r,backendUrl:c,setBackend:g}}static parsePort(e){return parseInt(e[0],10)||u.DEFAULT_PORT}static parseSubdomain(e){let n=[()=>this.findFlagWithEquals(e,"--subdomain="),()=>this.findFlagWithEquals(e,"-s="),()=>this.findFlagWithValue(e,"--subdomain"),()=>this.findFlagWithValue(e,"-s")];for(let t of n){let r=t();if(r)return r}return this.generateRandomSubdomain()}static parseLanguage(e){if(e.includes("--language")||e.includes("--lang")||e.includes("-l")){let t=e.indexOf("--language")!==-1?e.indexOf("--language"):e.indexOf("--lang")!==-1?e.indexOf("--lang"):e.indexOf("-l"),r=e[t+1];if(!r||r.startsWith("-"))return"prompt"}let n=[()=>this.findFlagWithEquals(e,"--language="),()=>this.findFlagWithEquals(e,"--lang="),()=>this.findFlagWithEquals(e,"-l="),()=>this.findFlagWithValue(e,"--language"),()=>this.findFlagWithValue(e,"--lang"),()=>this.findFlagWithValue(e,"-l")];for(let t of n){let r=t();if(r)return r}return null}static parseBackendUrl(e){let n=[()=>this.findFlagWithEquals(e,"--backend="),()=>this.findFlagWithEquals(e,"-b="),()=>this.findFlagWithValue(e,"--backend"),()=>this.findFlagWithValue(e,"-b")];for(let t of n){let r=t();if(r)return r}return null}static parseSetBackend(e){let n=[()=>this.findFlagWithEquals(e,"--set-backend="),()=>this.findFlagWithValue(e,"--set-backend")];for(let t of n){let r=t();if(r)return r}return e.includes("--set-backend")?"clear":null}static findFlagWithEquals(e,n){let t=e.find(r=>r.startsWith(n));return t?t.split("=")[1]:null}static findFlagWithValue(e,n){let t=e.indexOf(n);return t!==-1&&e[t+1]?e[t+1]:null}static generateRandomSubdomain(){return`${u.SUBDOMAIN_PREFIX}${Math.floor(Math.random()*1e4)}`}};import nn from"ora";import J from"chalk";import tn from"fs";var M=class{static{i(this,"TunnelState")}tunnelId=null;subdomain=null;port=null;backendUrl=null;tunnelProcess=null;timeoutId=null;connectionCount=0;startTime=null;updateInfo=null;networkIssueCount=0;lastNetworkWarningTime=0;networkWarningShown=!1;setTunnel(e,n,t,r=null){this.tunnelId=e,this.subdomain=n,this.port=t,this.backendUrl=r,this.startTime||(this.startTime=Date.now())}setUpdateInfo(e){this.updateInfo=e}setProcess(e){this.tunnelProcess=e}setTimeout(e){this.timeoutId=e}clearTimeout(){this.timeoutId&&(clearTimeout(this.timeoutId),this.timeoutId=null)}incrementConnection(){return this.connectionCount++,this.connectionCount}hasTunnel(){return this.tunnelId!==null}hasProcess(){return this.tunnelProcess!==null&&!this.tunnelProcess.killed}getDurationSeconds(){return this.startTime?(Date.now()-this.startTime)/1e3:0}incrementNetworkIssue(){return this.networkIssueCount++,this.networkIssueCount}resetNetworkIssues(){this.networkIssueCount=0}shouldShowNetworkWarning(e,n){let t=Date.now();return this.networkIssueCount>=e&&t-this.lastNetworkWarningTime>n?(this.lastNetworkWarningTime=t,!0):!1}setNetworkWarningShown(e){this.networkWarningShown=e}reset(){this.clearTimeout(),this.tunnelId=null,this.subdomain=null,this.port=null,this.backendUrl=null,this.tunnelProcess=null,this.connectionCount=0,this.startTime=null,this.updateInfo=null,this.networkIssueCount=0,this.lastNetworkWarningTime=0,this.networkWarningShown=!1}},l=new M;import{spawn as Se}from"child_process";import p from"chalk";import Ue from"fs";import a from"chalk";import Ne from"readline";import T from"fs";import G from"path";import ve from"os";var V=class{static{i(this,"ConfigManager")}configDir;configFile;oldLangFile;config;constructor(){this.configDir=G.join(ve.homedir(),".nport"),this.configFile=G.join(this.configDir,"config.json"),this.oldLangFile=G.join(this.configDir,"lang"),this.config=this.loadConfig(),this.migrateOldConfig()}loadConfig(){try{if(T.existsSync(this.configFile)){let e=T.readFileSync(this.configFile,"utf8");return JSON.parse(e)}}catch{console.warn("Warning: Could not load config file, using defaults")}return{}}migrateOldConfig(){try{if(!this.config.language&&T.existsSync(this.oldLangFile)){let e=T.readFileSync(this.oldLangFile,"utf8").trim();if(e&&["en","vi"].includes(e)){this.config.language=e,this.saveConfig();try{T.unlinkSync(this.oldLangFile)}catch{}}}}catch{}}saveConfig(){try{return T.existsSync(this.configDir)||T.mkdirSync(this.configDir,{recursive:!0}),T.writeFileSync(this.configFile,JSON.stringify(this.config,null,2),"utf8"),!0}catch{return console.warn("Warning: Could not save configuration"),!1}}getBackendUrl(){return this.config.backendUrl??null}setBackendUrl(e){return e?this.config.backendUrl=e:delete this.config.backendUrl,this.saveConfig()}getLanguage(){return this.config.language??null}setLanguage(e){return e?this.config.language=e:delete this.config.language,this.saveConfig()}getAll(){return{...this.config}}clear(){return this.config={},this.saveConfig()}},I=new V;var H={en:{header:"N P O R T  \u26A1\uFE0F  Free & Open Source from Vietnam \u2764\uFE0F",creatingTunnel:"Creating tunnel for port {port}...",checkingUpdates:"Checking for updates...",tunnelLive:"\u{1F680} WE LIVE BABY!",connection1:"   \u2714 [1/2] Connection established...",connection2:"   \u2714 [2/2] Compression enabled...",timeRemaining:"\u23F1\uFE0F  Time:     {hours}h remaining",footerTitle:"\u{1F525} KEEP THE VIBE ALIVE?",footerSubtitle:"(Made with \u2764\uFE0F  in Vietnam)",dropStar:"\u2B50\uFE0F  Drop a Star:   ",sendCoffee:"\u2615\uFE0F  Buy Coffee:    ",newVersion:"\u{1F6A8} NEW VERSION (v{version}) detected!",updateCommand:"> npm install -g nport@latest",tunnelShutdown:"\u{1F6D1} TUNNEL SHUTDOWN.",cleaningUp:"Cleaning up... ",cleanupDone:"Done.",cleanupFailed:"Failed.",subdomainReleased:"Subdomain...   Released. \u{1F5D1}\uFE0F",serverBusy:"(Server might be down or busy)",goodbyeTitle:"\u{1F44B} BEFORE YOU GO...",goodbyeMessage:"Thanks for using NPort!",website:"\u{1F310} Website:     ",author:"\u{1F464} Author:      ",changeLanguage:"\u{1F30D} Language:    ",changeLanguageHint:"nport --language",versionTitle:"NPort v{version}",versionSubtitle:"Free & open source ngrok alternative",versionLatest:"\u2714 You're running the latest version!",versionAvailable:"\u{1F6A8} New version available: v{version}",versionUpdate:"Update now: ",learnMore:"Learn more: ",languagePrompt:`
+\u{1F30D} Language Selection / Ch\u1ECDn ng\xF4n ng\u1EEF
+`,languageQuestion:"Choose your language (1-2): ",languageEnglish:"1. English",languageVietnamese:"2. Ti\u1EBFng Vi\u1EC7t (Vietnamese)",languageInvalid:"Invalid choice. Using English by default.",languageSaved:"\u2714 Language preference saved!",networkIssueTitle:`
+\u26A0\uFE0F  NETWORK CONNECTIVITY ISSUE DETECTED`,networkIssueDesc:"   Cloudflared is having trouble maintaining a stable connection to Cloudflare's edge servers.",networkIssueTunnel:"   \u{1F4E1} Your tunnel is still working, but connection quality may be affected.",networkIssueReasons:`
+   \u{1F4A1} Possible reasons:`,networkIssueReason1:"      \u2022 Unstable internet connection or high packet loss",networkIssueReason2:"      \u2022 Firewall/Router blocking UDP traffic (QUIC protocol)",networkIssueReason3:"      \u2022 ISP throttling or network congestion",networkIssueFix:`
+   \u{1F527} What to try:`,networkIssueFix1:"      \u2022 Check your internet connection stability",networkIssueFix2:"      \u2022 Try connecting from a different network",networkIssueFix3:"      \u2022 Disable VPN/Proxy if you're using one",networkIssueFix4:"      \u2022 The tunnel will automatically fallback to HTTP/2 if QUIC fails",networkIssueIgnore:`
+   \u2139\uFE0F  This is usually not critical - your tunnel should continue working normally.
+`},vi:{header:"N P O R T  \u26A1\uFE0F  Vi\u1EC7t Nam M\xE3i \u0110\u1EC9nh \u2764\uFE0F",creatingTunnel:"\u{1F6E0}\uFE0F \u0110ang kh\u1EDFi \u0111\u1ED9ng c\u1ED5ng {port}... Chu\u1EA9n b\u1ECB bay n\xE0o!",checkingUpdates:"\u{1F50D} \u0110ang d\xF2 la b\u1EA3n c\u1EADp nh\u1EADt m\u1EDBi... \u0110\u1EE3i t\xED s\u1EAFp c\xF3 qu\xE0!",tunnelLive:"\u{1F680} B\u1EACT MODE T\u1ED0C H\xC0NH! \u0110ANG BAY R\u1ED2I N\xC8!",connection1:"   \u2714 [1/2] \u0110ang c\u1EAFm d\xE2y m\u1EA1ng v\u0169 tr\u1EE5...",connection2:"   \u2714 [2/2] \u0110ang b\u01A1m si\xEAu n\xE9n kh\xED t\u1ED1c \u0111\u1ED9 \xE1nh s\xE1ng...",timeRemaining:"\u23F1\uFE0F  T\u0103ng t\u1ED1c th\u1EA7n s\u1EA7u: C\xF2n {hours}h \u0111\u1EC3 qu\u1EA9y!",footerTitle:"\u{1F525} L\u01AFU DANH S\u1EEC S\xC1CH! \u0110\u1EEANG QU\xCAN STAR \u2B50\uFE0F",footerSubtitle:"(Made in Vi\u1EC7t Nam, chu\u1EA9n kh\xF4ng c\u1EA7n ch\u1EC9nh! \u2764\uFE0F)",dropStar:"\u2B50\uFE0F  Th\u1EA3 Star: ",sendCoffee:"\u2615\uFE0F  T\u1EB7ng Coffee: ",newVersion:"\u{1F680} B\u1EA2N M\u1EDAI (v{version}) v\u1EEBa h\u1EA1 c\xE1nh!",updateCommand:"\u{1F4A1} G\xF5 li\u1EC1n: npm install -g nport@latest",tunnelShutdown:"\u{1F6D1} \u0110\xE3 t\u1EDBi gi\u1EDD 'ch\u1ED1t' deal r\u1ED3i c\u1EA3 nh\xE0 \u01A1i...",cleaningUp:"\u0110ang d\u1ECDn d\u1EB9p chi\u1EBFn tr\u01B0\u1EDDng... \u{1F9F9}",cleanupDone:"X\u1ECBn x\xF2! \u0110\xE3 d\u1ECDn xong r\u1ED3i n\xE8.",cleanupFailed:"O\u1EB1n tr\u1EDDi, d\u1ECDn kh\xF4ng n\u1ED5i!",subdomainReleased:"Subdomain...   X\xED xo\xE1! T\u1EA1m bi\u1EC7t nh\xE9 \u{1F5D1}\uFE0F\u2728",serverBusy:"(C\xF3 th\u1EC3 server \u0111ang b\u1EADn order tr\xE0 s\u1EEFa)",goodbyeTitle:"\u{1F44B} G\u1EB6P L\u1EA0I B\u1EA0N \u1EDE \u0110\u01AF\u1EDCNG B\u0102NG KH\xC1C...",goodbyeMessage:"C\u1EA3m \u01A1n \u0111\xE3 qu\u1EA9y NPort! L\u1EA7n sau ch\u01A1i ti\u1EBFp nha \u{1F618}",website:"\u{1F310} S\xE2n ch\u01A1i ch\xEDnh: ",author:"\u{1F464} Nh\xE0 t\xE0i tr\u1EE3: ",changeLanguage:"\u{1F30D} \u0110\u1ED5i ng\xF4n ng\u1EEF: ",changeLanguageHint:"nport --language",versionTitle:"NPort v{version}",versionSubtitle:"H\u01A1n c\u1EA3 Ngrok - Ma-de in Vi\u1EC7t Nam",versionLatest:"\u{1F389} Ch\xFAc m\u1EEBng! \u0110ang c\xF9ng server v\u1EDBi b\u1EA3n m\u1EDBi nh\u1EA5t!",versionAvailable:"\u{1F31F} V\xE8o v\xE8o: C\xF3 b\u1EA3n m\u1EDBi v{version} v\u1EEBa c\u1EADp b\u1EBFn!",versionUpdate:"Update kh\u1EA9n tr\u01B0\u01A1ng l\u1EB9 l\xE0ng: ",learnMore:"Kh\xE1m ph\xE1 th\xEAm cho n\xF3ng: ",languagePrompt:`
+\u{1F30D} Ch\u1ECDn l\u1EF1a ng\xF4n ng\u1EEF ngay b\xEAn d\u01B0\u1EDBi n\xE0o!
+`,languageQuestion:"Ch\u1EDBp l\u1EA5y m\u1ED9t l\u1EF1a ch\u1ECDn nha (1-2): ",languageEnglish:"1. English (Chu\u1EA9n qu\u1ED1c t\u1EBF!)",languageVietnamese:"2. Ti\u1EBFng Vi\u1EC7t (\u0110\u1EC9nh c\u1EE7a ch\xF3p)",languageInvalid:"\u01A0 h\u01A1, ch\u1ECDn sai r\u1ED3i! M\u1EB7c \u0111\u1ECBnh Ti\u1EBFng Vi\u1EC7t lu\xF4n cho n\xF3ng.",languageSaved:"\u{1F3AF} Xong r\u1ED3i! L\u01B0u ng\xF4n ng\u1EEF th\xE0nh c\xF4ng!",networkIssueTitle:`
+\u26A0\uFE0F  PH\xC1T HI\u1EC6N V\u1EA4N \u0110\u1EC0 M\u1EA0NG`,networkIssueDesc:"   Cloudflared \u0111ang g\u1EB7p kh\xF3 kh\u0103n khi gi\u1EEF k\u1EBFt n\u1ED1i \u1ED5n \u0111\u1ECBnh t\u1EDBi Cloudflare edge servers.",networkIssueTunnel:"   \u{1F4E1} Tunnel c\u1EE7a b\u1EA1n v\u1EABn ho\u1EA1t \u0111\u1ED9ng, nh\u01B0ng ch\u1EA5t l\u01B0\u1EE3ng k\u1EBFt n\u1ED1i c\xF3 th\u1EC3 b\u1ECB \u1EA3nh h\u01B0\u1EDFng.",networkIssueReasons:`
+   \u{1F4A1} C\xF3 th\u1EC3 do:`,networkIssueReason1:"      \u2022 M\u1EA1ng internet kh\xF4ng \u1ED5n \u0111\u1ECBnh ho\u1EB7c m\u1EA5t g\xF3i tin",networkIssueReason2:"      \u2022 Firewall/Router ch\u1EB7n UDP traffic (giao th\u1EE9c QUIC)",networkIssueReason3:"      \u2022 Nh\xE0 m\u1EA1ng throttle ho\u1EB7c t\u1EAFc ngh\u1EBDn m\u1EA1ng",networkIssueFix:`
+   \u{1F527} Th\u1EED c\xE1c c\xE1ch sau:`,networkIssueFix1:"      \u2022 Ki\u1EC3m tra k\u1EBFt n\u1ED1i internet c\u1EE7a b\u1EA1n",networkIssueFix2:"      \u2022 Th\u1EED \u0111\u1ED5i sang m\u1EA1ng kh\xE1c (v\xED d\u1EE5: 4G/5G)",networkIssueFix3:"      \u2022 T\u1EAFt VPN/Proxy n\u1EBFu \u0111ang b\u1EADt",networkIssueFix4:"      \u2022 Tunnel s\u1EBD t\u1EF1 \u0111\u1ED9ng chuy\u1EC3n sang HTTP/2 n\u1EBFu QUIC fail",networkIssueIgnore:`
+   \u2139\uFE0F  L\u1ED7i n\xE0y th\u01B0\u1EDDng kh\xF4ng nghi\xEAm tr\u1ECDng - tunnel v\u1EABn ho\u1EA1t \u0111\u1ED9ng b\xECnh th\u01B0\u1EDDng.
+`}},j=class{static{i(this,"LanguageManager")}currentLanguage="en";availableLanguages=ee;t(e,n={}){let r=(H[this.currentLanguage]||H.en)[e]||H.en[e]||e;return Object.keys(n).forEach(c=>{let g=n[c];g!==void 0&&(r=r.replace(`{${c}}`,String(g)))}),r}loadLanguagePreference(){let e=I.getLanguage();return e&&this.availableLanguages.includes(e)?e:null}saveLanguagePreference(e){I.setLanguage(e)}setLanguage(e){return this.availableLanguages.includes(e)?(this.currentLanguage=e,!0):!1}getLanguage(){return this.currentLanguage}async promptLanguageSelection(){return new Promise(e=>{let n=Ne.createInterface({input:process.stdin,output:process.stdout});console.log(this.t("languagePrompt")),console.log(`   ${this.t("languageEnglish")}`),console.log(`   ${this.t("languageVietnamese")}
+`),n.question(`${this.t("languageQuestion")}`,t=>{n.close();let r=t.trim(),c="en";r==="1"?c="en":r==="2"?c="vi":console.log(`
+${this.t("languageInvalid")}
+`),this.setLanguage(c),this.saveLanguagePreference(c),console.log(`${this.t("languageSaved")}
+`),e(c)})})}async initialize(e=null){if(e&&e!=="prompt"&&this.setLanguage(e))return this.saveLanguagePreference(e),e;if(e==="prompt")return await this.promptLanguageSelection();let n=this.loadLanguagePreference();return n?(this.setLanguage(n),n):await this.promptLanguageSelection()}},s=new j;var m=class{static{i(this,"UI")}static displayProjectInfo(){let e="\u2500".repeat(56),n=s.t("header"),r=" ".repeat(Math.max(0,59-n.length-4));console.log(a.gray(`
+ \u256D${e}\u256E`)),console.log(a.cyan.bold(` \u2502  ${n}`)+r+a.gray("\u2502")),console.log(a.gray(` \u2570${e}\u256F
+`))}static displayStartupBanner(e){this.displayProjectInfo()}static displayTunnelSuccess(e,n,t){console.log(),console.log(a.cyan.bold(`   \u{1F449}  ${e}  \u{1F448}
+`)),console.log(a.gray("   "+"\u2500".repeat(54)+`
+`)),console.log(a.gray(`   ${s.t("timeRemaining",{hours:u.TUNNEL_TIMEOUT_HOURS})}
+`))}static displayFooter(e){console.log(a.gray("   "+"\u2500".repeat(54)+`
+`)),console.log(a.yellow.bold(`   ${s.t("footerTitle")}
+`)),console.log(a.gray(`      ${s.t("footerSubtitle")}
+`)),console.log(a.cyan(`   ${s.t("dropStar")}`)+a.white(ne)),console.log(a.yellow(`   ${s.t("sendCoffee")}`)+a.white(te)),e?.shouldUpdate&&(console.log(a.red.bold(`
+   ${s.t("newVersion",{version:e.latest})}`)),console.log(a.gray("      ")+a.cyan(s.t("updateCommand")))),console.log()}static displayTimeoutWarning(){console.log(a.yellow(`
+\u23F0 Tunnel has been running for ${u.TUNNEL_TIMEOUT_HOURS} hours.`)),console.log(a.yellow("   Automatically shutting down..."))}static displayError(e,n=null){n&&n.fail("Failed to connect to server."),console.error(a.red(e.message))}static displayCleanupStart(){console.log(a.red.bold(`
+
+   ${s.t("tunnelShutdown")}
+`)),process.stdout.write(a.gray(`      ${s.t("cleaningUp")}`))}static displayCleanupSuccess(){console.log(a.green(s.t("cleanupDone"))),console.log(a.gray(`      ${s.t("subdomainReleased")}
+`)),this.displayGoodbye()}static displayCleanupError(){console.log(a.red(s.t("cleanupFailed"))),console.log(a.gray(`      ${s.t("serverBusy")}
+`)),this.displayGoodbye()}static displayGoodbye(){console.log(a.gray("   "+"\u2500".repeat(54)+`
+`)),console.log(a.cyan.bold(`   ${s.t("goodbyeTitle")}
+`)),console.log(a.gray(`      ${s.t("goodbyeMessage")}
+`)),console.log(a.cyan(`      ${s.t("website")}`)+a.white(B)),console.log(a.cyan(`      ${s.t("author")}`)+a.white("Nick Pham (https://github.com/tuanngocptn)")),console.log(a.cyan(`      ${s.t("changeLanguage")}`)+a.yellow(s.t("changeLanguageHint"))),console.log()}static displayVersion(e,n){console.log(a.cyan.bold(`
+${s.t("versionTitle",{version:e})}`)),console.log(a.gray(`${s.t("versionSubtitle")}
+`)),n?.shouldUpdate?(console.log(a.yellow(s.t("versionAvailable",{version:n.latest}))),console.log(a.cyan(s.t("versionUpdate"))+a.white(`npm install -g nport@latest
+`))):console.log(a.green(`${s.t("versionLatest")}
+`)),console.log(a.gray(s.t("learnMore"))+a.cyan(`${B}
+`))}};var v=class{static{i(this,"BinaryManager")}static validate(e){return Ue.existsSync(e)?!0:(console.error(p.red(`
+\u274C Error: Cloudflared binary not found at: ${e}`)),console.error(p.yellow(`\u{1F449} Please run 'npm install' again to download the binary.
+`)),!1)}static spawn(e,n,t){return Se(e,["tunnel","run","--token",n,"--url",`http://localhost:${t}`])}static attachHandlers(e,n=null){e.stderr?.on("data",t=>this.handleStderr(t)),e.on("error",t=>this.handleError(t,n)),e.on("close",t=>this.handleClose(t))}static handleStderr(e){let n=e.toString();if(!U.IGNORE.some(t=>n.includes(t))){if(U.NETWORK_WARNING.some(t=>n.includes(t))){this.handleNetworkWarning();return}if(U.SUCCESS.some(t=>n.includes(t))){let t=l.incrementConnection();t===1?(l.resetNetworkIssues(),console.log(p.green(s.t("connection1")))):t===4&&(console.log(p.green(s.t("connection2"))),m.displayFooter(l.updateInfo));return}U.ERROR.some(t=>n.includes(t))&&console.error(p.red(`[Cloudflared] ${n.trim()}`))}}static handleNetworkWarning(){l.incrementNetworkIssue(),l.shouldShowNetworkWarning(W.WARNING_THRESHOLD,W.WARNING_COOLDOWN)&&this.displayNetworkWarning()}static displayNetworkWarning(){console.log(p.yellow(s.t("networkIssueTitle"))),console.log(p.gray(s.t("networkIssueDesc"))),console.log(p.cyan(s.t("networkIssueTunnel"))),console.log(p.yellow(s.t("networkIssueReasons"))),console.log(p.gray(s.t("networkIssueReason1"))),console.log(p.gray(s.t("networkIssueReason2"))),console.log(p.gray(s.t("networkIssueReason3"))),console.log(p.yellow(s.t("networkIssueFix"))),console.log(p.gray(s.t("networkIssueFix1"))),console.log(p.gray(s.t("networkIssueFix2"))),console.log(p.gray(s.t("networkIssueFix3"))),console.log(p.gray(s.t("networkIssueFix4"))),console.log(p.blue(s.t("networkIssueIgnore")))}static handleError(e,n){n&&n.fail("Failed to spawn cloudflared process."),console.error(p.red(`Process Error: ${e.message}`))}static handleClose(e){e!==0&&e!==null&&console.log(p.red(`Tunnel process exited with code ${e}`))}};import E from"fs";import R from"path";import Re from"https";import le from"os";import{execSync as _e}from"child_process";import{fileURLToPath as ce}from"url";var Le=ce(import.meta.url),Ae=R.dirname(R.dirname(Le)),D=R.join(Ae,"bin"),ie="cloudflared",Pe=".tgz",xe="cloudflared.tgz",F=le.platform(),ae=le.arch(),ue=F==="win32",Oe=ue?`${ie}.exe`:ie,w=R.join(D,Oe),Fe="https://github.com/cloudflare/cloudflared/releases/latest/download",De=[301,302],$e=200,Be="755",We={darwin:{x64:"cloudflared-darwin-amd64.tgz",arm64:"cloudflared-darwin-arm64.tgz"},win32:{x64:"cloudflared-windows-amd64.exe",ia32:"cloudflared-windows-386.exe"},linux:{x64:"cloudflared-linux-amd64",arm64:"cloudflared-linux-arm64",arm:"cloudflared-linux-arm"}};function Me(o){return{x64:"x64",amd64:"amd64",arm64:"arm64",ia32:"ia32",arm:"arm"}[o]||o}i(Me,"normalizeArch");function Ge(){let o=Me(ae),e=We[F];if(!e)throw new Error(`Unsupported platform: ${F}. Supported platforms: darwin, win32, linux`);let n=e[o];if(!n)throw new Error(`Unsupported architecture: ${ae} for platform ${F}. Supported architectures: ${Object.keys(e).join(", ")}`);return`${Fe}/${n}`}i(Ge,"getDownloadUrl");function Ve(o){return o.endsWith(Pe)}i(Ve,"isCompressedArchive");function He(o){E.existsSync(o)||E.mkdirSync(o,{recursive:!0})}i(He,"ensureDirectory");function C(o){try{E.existsSync(o)&&E.unlinkSync(o)}catch{}}i(C,"safeUnlink");function ge(o,e=Be){ue||E.chmodSync(o,e)}i(ge,"setExecutablePermissions");function je(o,e){if(!E.existsSync(o))throw new Error(e||`File not found: ${o}`)}i(je,"validateFileExists");async function de(o,e){return new Promise((n,t)=>{let r=E.createWriteStream(e);Re.get(o,c=>{if(De.includes(c.statusCode)){r.close(),C(e),de(c.headers.location,e).then(n).catch(t);return}if(c.statusCode!==$e){r.close(),C(e),t(new Error(`Download failed with status code ${c.statusCode} from ${o}`));return}c.pipe(r),r.on("finish",()=>{r.close(()=>n(e))}),r.on("error",g=>{r.close(),C(e),t(g)})}).on("error",c=>{r.close(),C(e),t(new Error(`Network error: ${c.message}`))})})}i(de,"downloadFile");function Ke(o,e){try{_e(`tar -xzf "${o}" -C "${e}"`,{stdio:"pipe"})}catch(n){throw new Error(`Extraction failed: ${n.message}`)}}i(Ke,"extractTarGz");var k={info:i(o=>console.log(`\u2139\uFE0F  ${o}`),"info"),success:i(o=>console.log(`\u2705 ${o}`),"success"),warn:i(o=>console.warn(`\u26A0\uFE0F  ${o}`),"warn"),error:i(o=>console.error(`\u274C ${o}`),"error"),progress:i(o=>console.log(`\u{1F6A7} ${o}`),"progress"),extract:i(o=>console.log(`\u{1F4E6} ${o}`),"extract")};async function qe(){k.progress("Cloudflared binary not found. Downloading... (This happens only once)");let o=Ge(),e=Ve(o),n=e?R.join(D,xe):w;try{return await de(o,n),e&&(k.extract("Extracting binary..."),Ke(n,D),C(n),je(w,"Extraction failed: Binary not found after extraction")),ge(w),k.success("Download complete."),w}catch(t){throw C(n),C(w),t}}i(qe,"installBinary");async function K(){if(He(D),E.existsSync(w))return ge(w),w;try{return await qe()}catch(o){k.error(`Installation failed: ${o.message}`),process.exit(1)}}i(K,"ensureCloudflared");function ze(){return!!(process.env.CI||process.env.GITHUB_ACTIONS||process.env.GITLAB_CI||process.env.CIRCLECI||process.env.TRAVIS||process.env.JENKINS_URL||process.env.BUILDKITE)}i(ze,"isCI");async function Je(){if(ze()){k.info("Running in CI environment - skipping binary download");return}try{let o=await K();k.success(`Cloudflared binary is ready at: ${o}`)}catch(o){k.error(o.message),process.exit(1)}}i(Je,"main");var Ye=ce(import.meta.url);(process.argv[1]===Ye||process.argv[1]?.endsWith("bin-manager.js"))&&Je();import pe from"axios";import d from"chalk";var _=class{static{i(this,"APIClient")}static async createTunnel(e,n=null){let t=n||u.BACKEND_URL;try{let{data:r}=await pe.post(t,{subdomain:e});if(!r.success)throw new Error(r.error||"Unknown error from backend");return{tunnelId:r.tunnelId,tunnelToken:r.tunnelToken,url:r.url}}catch(r){throw this.handleError(r,e)}}static async deleteTunnel(e,n,t=null){let r=t||u.BACKEND_URL;await pe.delete(r,{data:{subdomain:e,tunnelId:n}})}static handleError(e,n){let t=e.response?.data?.error;return t?t.includes("SUBDOMAIN_PROTECTED:")?new Error(`Subdomain "${n}" is already taken or in use.
+
+`+d.yellow(`\u{1F4A1} Try one of these options:
+`)+d.gray("   1. Choose a different subdomain: ")+d.cyan(`nport ${l.port||u.DEFAULT_PORT} -s ${n}-v2
+`)+d.gray("   2. Use a random subdomain:       ")+d.cyan(`nport ${l.port||u.DEFAULT_PORT}
+`)+d.gray("   3. Wait a few minutes and retry if you just stopped a tunnel with this name")):t.includes("SUBDOMAIN_IN_USE:")||t.includes("currently in use")||t.includes("already exists and is currently active")?new Error(d.red(`\u2717 Subdomain "${n}" is already in use!
+
+`)+d.yellow(`\u{1F4A1} This subdomain is currently being used by another active tunnel.
+
+`)+d.white(`Choose a different subdomain:
+`)+d.gray("   1. Add a suffix:     ")+d.cyan(`nport ${l.port||u.DEFAULT_PORT} -s ${n}-2
+`)+d.gray("   2. Try a variation:  ")+d.cyan(`nport ${l.port||u.DEFAULT_PORT} -s my-${n}
+`)+d.gray("   3. Use random name:  ")+d.cyan(`nport ${l.port||u.DEFAULT_PORT}
+`)):t.includes("already have a tunnel")||t.includes("[1013]")?new Error(`Subdomain "${n}" is already taken or in use.
+
+`+d.yellow(`\u{1F4A1} Try one of these options:
+`)+d.gray("   1. Choose a different subdomain: ")+d.cyan(`nport ${l.port||u.DEFAULT_PORT} -s ${n}-v2
+`)+d.gray("   2. Use a random subdomain:       ")+d.cyan(`nport ${l.port||u.DEFAULT_PORT}
+`)+d.gray("   3. Wait a few minutes and retry if you just stopped a tunnel with this name")):new Error(`Backend Error: ${t}`):e.response?new Error(`Backend Error: ${JSON.stringify(e.response.data,null,2)}`):e}};import en from"axios";import Xe from"axios";import{createHash as Ze}from"crypto";import y from"os";import L from"fs";import me from"path";var q={measurementId:"G-JJHG4DP1K9",apiSecret:"NjNID8jtRJe9s8uSBz2jfw"},h={enabled:!0,debug:process.env.NPORT_DEBUG==="true",timeout:2e3,userIdFile:me.join(y.homedir(),".nport","analytics-id")},z=class{static{i(this,"AnalyticsManager")}userId=null;sessionId=null;sessionStartTime=null;disabled=!1;constructor(){process.env.NPORT_ANALYTICS==="false"&&(this.disabled=!0)}async initialize(){if(!this.disabled){if(!q.apiSecret){h.debug&&console.warn("[Analytics] API secret not configured. Analytics disabled."),this.disabled=!0;return}try{this.userId=await this.getUserId(),this.sessionId=this.generateSessionId(),this.sessionStartTime=Date.now(),h.debug&&(console.log("[Analytics] Initialized successfully"),console.log(`[Analytics] User ID: ${this.userId}`),console.log(`[Analytics] Session ID: ${this.sessionId}`))}catch(e){h.debug&&console.warn("[Analytics] Failed to initialize:",e),this.disabled=!0}}}async getUserId(){try{let e=me.join(y.homedir(),".nport");if(L.existsSync(e)||L.mkdirSync(e,{recursive:!0}),L.existsSync(h.userIdFile)){let t=L.readFileSync(h.userIdFile,"utf8").trim();if(t)return t}let n=this.generateAnonymousId();return L.writeFileSync(h.userIdFile,n,"utf8"),n}catch{return this.generateAnonymousId()}}generateAnonymousId(){let e=[y.hostname(),y.platform(),y.arch(),y.homedir()].join("-");return Ze("sha256").update(e).digest("hex").substring(0,32)}generateSessionId(){return Math.floor(Date.now()/1e3)}async trackEvent(e,n={}){if(!(this.disabled||!h.enabled||!this.userId))try{let t=this.buildPayload(e,n),c=`https://www.google-analytics.com/mp/collect?measurement_id=${q.measurementId}&api_secret=${q.apiSecret}`;h.debug&&(console.log(`[Analytics] Sending event: ${e}`),console.log("[Analytics] Payload:",JSON.stringify(t,null,2))),Xe.post(c,t,{timeout:h.timeout,headers:{"Content-Type":"application/json"}}).then(g=>{h.debug&&(console.log(`[Analytics] Response status: ${g.status}`),g.data&&console.log("[Analytics] Response:",JSON.stringify(g.data,null,2)))}).catch(g=>{h.debug&&console.warn("[Analytics] Request failed:",g.message)})}catch(t){h.debug&&console.warn("[Analytics] Error tracking event:",t)}}getEngagementTime(){return this.sessionStartTime?Math.max(100,Date.now()-this.sessionStartTime):100}buildPayload(e,n){return{client_id:this.userId,timestamp_micros:Date.now()*1e3,events:[{name:e,params:{session_id:String(this.sessionId),engagement_time_msec:this.getEngagementTime(),...this.getSystemInfo(),...n}}]}}getSystemInfo(){return{os_platform:y.platform(),os_version:y.release(),os_arch:y.arch(),node_version:process.version}}trackCliStart(e,n,t){this.trackEvent("cli_start",{port:String(e),has_custom_subdomain:n&&!n.startsWith("user-"),cli_version:t})}trackTunnelCreated(e,n){this.trackEvent("tunnel_created",{subdomain_type:e.startsWith("user-")?"random":"custom",port:String(n)})}trackTunnelError(e,n){this.trackEvent("tunnel_error",{error_type:e,error_message:n.substring(0,100)})}trackTunnelShutdown(e,n){this.trackEvent("tunnel_shutdown",{shutdown_reason:e,duration_seconds:String(Math.floor(n))})}trackUpdateAvailable(e,n){this.trackEvent("update_available",{current_version:e,latest_version:n})}},f=new z;var N=class{static{i(this,"VersionManager")}static async checkForUpdates(){try{let n=(await en.get(`https://registry.npmjs.org/${u.PACKAGE_NAME}/latest`,{timeout:u.UPDATE_CHECK_TIMEOUT})).data.version,t=this.compareVersions(n,u.CURRENT_VERSION)>0;return t&&f.trackUpdateAvailable(u.CURRENT_VERSION,n),{current:u.CURRENT_VERSION,latest:n,shouldUpdate:t}}catch{return null}}static compareVersions(e,n){let t=e.split(".").map(Number),r=n.split(".").map(Number),c=Math.max(t.length,r.length);for(let g=0;g<c;g++){let A=t[g]||0,Y=r[g]||0;if(A>Y)return 1;if(A<Y)return-1}return 0}};var S=class{static{i(this,"TunnelOrchestrator")}static async start(e){l.setTunnel(null,e.subdomain,e.port,e.backendUrl),await f.initialize(),f.trackCliStart(e.port,e.subdomain,u.CURRENT_VERSION),m.displayStartupBanner(e.port);let n=await N.checkForUpdates();if(l.setUpdateInfo(n),!tn.existsSync(x.BIN_PATH)){console.log(J.yellow(`
+\u{1F4E6} Cloudflared binary not found. Downloading...
+`));try{await K()}catch(r){f.trackTunnelError("binary_download_failed",r.message),console.error(J.red(`
+\u274C Failed to download cloudflared: ${r.message}`)),process.exit(1)}}v.validate(x.BIN_PATH)||(f.trackTunnelError("binary_missing","Cloudflared binary not found"),await new Promise(r=>setTimeout(r,100)),process.exit(1));let t=nn(s.t("creatingTunnel",{port:e.port})).start();try{let r=await _.createTunnel(e.subdomain,e.backendUrl);l.setTunnel(r.tunnelId,e.subdomain,e.port,e.backendUrl),f.trackTunnelCreated(e.subdomain,e.port),t.stop(),console.log(J.green(`   ${s.t("tunnelLive")}`)),m.displayTunnelSuccess(r.url,e.port,n);let c=v.spawn(x.BIN_PATH,r.tunnelToken,e.port);l.setProcess(c),v.attachHandlers(c,t);let g=setTimeout(()=>{m.displayTimeoutWarning(),this.cleanup("timeout")},se);l.setTimeout(g)}catch(r){let c=r,g=c.message.includes("already taken")?"subdomain_taken":"tunnel_creation_failed";f.trackTunnelError(g,c.message),m.displayError(c,t),await new Promise(A=>setTimeout(A,100)),process.exit(1)}}static async cleanup(e="manual"){l.clearTimeout(),l.hasTunnel()||process.exit(0),m.displayCleanupStart();let n=l.getDurationSeconds();f.trackTunnelShutdown(e,n);try{l.hasProcess()&&l.tunnelProcess&&l.tunnelProcess.kill(),l.subdomain&&l.tunnelId&&await _.deleteTunnel(l.subdomain,l.tunnelId,l.backendUrl),m.displayCleanupSuccess()}catch{m.displayCleanupError()}await new Promise(t=>setTimeout(t,100)),process.exit(0)}};async function rn(){let o=on(s.t("checkingUpdates")).start(),e=await N.checkForUpdates();o.stop(),m.displayVersion(u.CURRENT_VERSION,e)}i(rn,"displayVersion");function sn(o){o==="clear"?(I.setBackendUrl(null),console.log(b.green("\u2714 Backend URL cleared. Using default backend.")),console.log(b.gray(`  Default: https://api.nport.link
+`))):(I.setBackendUrl(o),console.log(b.green("\u2714 Backend URL saved successfully!")),console.log(b.cyan(`  Backend: ${o}`)),console.log(b.gray(`
+  This backend will be used for all future sessions.`)),console.log(b.gray(`  To clear: nport --set-backend
+`)));let e=I.getBackendUrl();e&&(console.log(b.white("Current configuration:")),console.log(b.cyan(`  Saved backend: ${e}`)))}i(sn,"handleSetBackend");async function an(){try{let o=process.argv.slice(2),e=O.parse(o);await s.initialize(e.language),(o.includes("-v")||o.includes("--version"))&&(await rn(),process.exit(0)),e.setBackend&&(sn(e.setBackend),process.exit(0)),e.language==="prompt"&&(o.includes("--language")||o.includes("--lang")||o.includes("-l"))&&process.exit(0);let n=e.backendUrl;if(!n){let r=I.getBackendUrl();r&&(n=r)}let t={port:e.port,subdomain:e.subdomain,backendUrl:n,language:e.language};await S.start(t)}catch(o){console.error(`Fatal Error: ${o.message}`),process.exit(1)}}i(an,"main");process.on("SIGINT",()=>S.cleanup());process.on("SIGTERM",()=>S.cleanup());an();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nport",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Free & open source ngrok alternative - Tunnel HTTP/HTTPS connections via Cloudflare Edge with custom subdomains",
   "type": "module",
   "main": "dist/index.js",
@@ -63,13 +63,14 @@
     }
   ],
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
+    "build": "node scripts/build.js",
+    "dev": "node scripts/build.js --watch",
     "start": "node dist/index.js",
     "postinstall": "node scripts/postinstall.js",
     "test": "vitest run",
     "test:watch": "vitest",
-    "lint": "tsc --noEmit"
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "axios": "^1.13.2",
@@ -78,15 +79,14 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "esbuild": "^0.24.0",
     "typescript": "^5.7.0",
     "vitest": "~3.2.0"
   },
   "files": [
     "dist/",
-    "bin/",
-    "scripts/",
+    "scripts/postinstall.js",
     "README.md",
-    "CHANGELOG.md",
     "LICENSE"
   ],
   "os": [

package/CHANGELOG.md

@@ -1,432 +0,0 @@
-# Changelog
-
-All notable changes to NPort will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [2.1.0] - 2026-01-27
-
-### Added
-- 🔷 **Full TypeScript Migration**: Complete rewrite of CLI and Server in TypeScript
-  - Strict type checking enabled across the entire codebase
-  - All modules converted from JavaScript to TypeScript
-  - Type-safe interfaces for configuration, tunnels, analytics, and i18n
-  - Better IDE support with IntelliSense and autocompletion
-- 📚 **Comprehensive Documentation**: New docs folder with detailed guides
-  - `docs/ARCHITECTURE.md`: System overview, component diagrams, and data flow
-  - `docs/API.md`: Complete API reference with endpoints and examples
-  - `docs/CONTRIBUTING.md`: Contribution guidelines and development setup
-- 🤖 **AI Context Support**: Added `.ai/context.md` for AI-assisted development
-  - Project structure and key patterns documented
-  - Coding conventions and architecture decisions
-  - Makes AI pair programming more effective
-- 🧪 **Unit Testing with Vitest**: Comprehensive test suite for CLI
-  - Tests for argument parsing (`tests/args.test.ts`)
-  - Tests for version comparison (`tests/version.test.ts`)
-  - Tests for state management (`tests/state.test.ts`)
-  - Easy to run with `npm test`
-- 📋 **Code Ownership**: Added `.github/CODEOWNERS` file
-  - Clear ownership for code review assignments
-  - Faster PR reviews with automatic reviewer assignment
-- 📝 **Cursor Rules**: Added `.cursorrules` for consistent AI assistance
-  - Project-specific coding conventions
-  - TypeScript and naming guidelines
-  - Common patterns and anti-patterns
-- 🔄 **Auto-download Cloudflared**: Binary downloads automatically on first run
-  - No need to run separate install commands
-  - Seamless first-time user experience
-  - Progress indicator during download
-- 🔒 **Protected Subdomain Support**: Enhanced error handling for reserved subdomains
-  - User-friendly error message when trying to create protected subdomains (like `api`)
-  - Formatted error output matching existing error style
-  - Helpful suggestions to use alternative subdomain names
-  - Prevents accidental use of backend service subdomains
-- 📋 **TODO Management**: Added `TODO.md` for tracking planned features
-  - Move time limit enforcement to backend
-  - Update README powered-by section
-  - Track terminal link clicks
-
-### Changed
-- 🏗️ **Project Structure**: Reorganized for better maintainability
-  - All source code in `src/` directory
-  - Type definitions in `src/types/`
-  - Shared constants in `src/constants.ts`
-  - Tests in `tests/` directory
-- 📦 **Build System**: Updated to TypeScript compilation
-  - Uses `tsc` for compilation
-  - Output to `dist/` directory
-  - Source maps for debugging
-- 🔧 **Development Workflow**: Improved developer experience
-  - `npm run dev` for watch mode
-  - `npm run build` for production
-  - `npm test` for running tests
-  - `npm run lint` for type checking
-- ⚙️ **System Requirements**: Updated to Node.js 20+
-  - Minimum Node.js version: 20.0.0
-  - Minimum npm version: 10.0.0
-  - Better security and performance with latest LTS
-
-### Improved
-- ✨ **Better Error Messages**: Enhanced user feedback for protected subdomains
-  - Catches `SUBDOMAIN_PROTECTED` errors from backend
-  - Formats error messages consistently with other error types
-  - Shows actionable options when subdomain is reserved
-
-### Fixed
-- 🐛 **Intel Mac Binary Download**: Fixed cloudflared binary download on Intel Macs
-  - Node.js reports architecture as `x64`, not `amd64` - now correctly mapped
-  - Fixed ARM64 Macs to download the correct `cloudflared-darwin-arm64.tgz` binary
-  - Previously ARM64 Macs were incorrectly downloading the AMD64 binary
-
-### Server (v1.1.0)
-- 🔷 **TypeScript Migration**: Server fully converted to TypeScript
-  - Type-safe Cloudflare Worker handlers
-  - Properly typed API responses
-  - Full type coverage for Cloudflare API interactions
-- 🧪 **Server Tests**: Updated test suite for TypeScript
-  - Vitest with Cloudflare Workers pool
-  - Tests for all API endpoints
-  - Scheduled task testing
-- 🔒 **Protected Subdomains**: Infrastructure to protect critical subdomains from deletion or overwriting
-  - New `PROTECTED_SUBDOMAINS` constant array for easy management of reserved subdomains
-  - Default protected subdomain: `api` (reserved for NPort backend service)
-  - Easy to add more protected subdomains by updating the array
-  - Protected subdomains are blocked at both creation and cleanup stages
-- 🛡️ **Backend Service Protection**: Prevents accidental deletion or overwriting of production services
-  - `api` subdomain is now protected from user creation attempts
-  - Scheduled cleanup job skips protected subdomains
-  - Returns clear error message when users try to use protected names
-- 🔧 **Manual Cleanup Endpoint**: Added `GET /scheduled` endpoint to manually trigger cleanup
-  - Useful for testing and on-demand cleanup
-  - Respects protected subdomains configuration
-  - Returns JSON response with cleanup results
-
-### Technical Details
-- **Type System**: 
-  - `TunnelConfig`, `TunnelState`, `ConnectionInfo` interfaces
-  - `AnalyticsParams`, `VersionInfo`, `I18nStrings` types
-  - `LogPatterns` with readonly arrays for constants
-- **ESM Compliance**: All imports use `.js` extensions as required
-- **Constants**: Centralized in `src/constants.ts` with `as const` assertions
-- **Error Handling**: Type-safe error boundaries throughout
-
-### Migration
-- Automatic migration - no manual steps required
-- Existing configuration in `~/.nport/config.json` remains compatible
-- All CLI flags and options unchanged
-
-### Breaking Changes
-- None - fully backward compatible!
-
-## [2.0.7] - 2026-01-14
-
-### Added
-- 🌐 **Smart Network Warning System**: Intelligent handling of QUIC/network connectivity issues
-  - Automatic detection and filtering of QUIC protocol errors
-  - User-friendly warning messages instead of scary red error spam
-  - Bilingual support (English & Vietnamese)
-  - Smart throttling: Shows warning only after 5 errors, max once per 30 seconds
-  - Clear explanations of what's happening and how to fix it
-  - Automatic reset when connection is restored
-- 🔒 **Protected Subdomain Support**: Enhanced error handling for reserved subdomains
-  - User-friendly error message when trying to create protected subdomains (like `api`)
-  - Formatted error output matching existing error style
-  - Helpful suggestions to use alternative subdomain names
-  - Prevents accidental use of backend service subdomains
-
-### Improved
-- 🔇 **Cleaner Terminal Output**: No more error spam from cloudflared
-  - QUIC timeout errors are now silently tracked instead of displayed
-  - Network warnings filtered: "failed to accept QUIC stream", "timeout: no recent network activity", etc.
-  - Only shows meaningful warnings when there's an actual persistent issue
-  - Terminal stays clean and readable during normal operation
-- 📡 **Better User Communication**: Context-aware network issue reporting
-  - Explains that QUIC failures are usually not critical
-  - Tunnel continues working via HTTP/2 fallback
-  - Provides actionable troubleshooting steps
-  - Reassures users that the tunnel is still functional
-- ✨ **Better Error Messages**: Enhanced user feedback for protected subdomains
-  - Catches `SUBDOMAIN_PROTECTED` errors from backend
-  - Formats error messages consistently with other error types
-  - Shows actionable options when subdomain is reserved
-
-### Technical Details
-- **Network Error Patterns**: Added detection for 7 common QUIC/network error patterns
-- **State Management**: New network issue tracking in application state
-  - `networkIssueCount`: Counter for network errors
-  - `lastNetworkWarningTime`: Timestamp tracking for cooldown
-  - `shouldShowNetworkWarning()`: Smart decision logic
-- **Configuration**: New `NETWORK_CONFIG` with threshold and cooldown settings
-- **Bilingual Messages**: Complete translations for all network warning messages
-- **Protected Subdomain Handling**: Enhanced error handling in `src/api.js`
-  - Added check for `SUBDOMAIN_PROTECTED` error type
-  - Consistent formatting with existing error messages
-  - Clear user guidance for alternative subdomain choices
-
-### User Experience
-**Before:**
-```
-[Cloudflared] 2026-01-14T04:33:02Z ERR failed to accept QUIC stream...
-[Cloudflared] 2026-01-14T04:33:03Z ERR failed to accept QUIC stream...
-[Cloudflared] 2026-01-14T04:33:04Z ERR failed to accept QUIC stream...
-[Cloudflared] 2026-01-14T04:33:05Z ERR failed to accept QUIC stream...
-```
-
-**After:**
-```
-✔ [1/2] Connection established...
-✔ [2/2] Compression enabled...
-
-⚠️  NETWORK CONNECTIVITY ISSUE DETECTED
-   Cloudflared is having trouble maintaining a stable connection...
-   📡 Your tunnel is still working, but connection quality may be affected.
-   
-   💡 Possible reasons:
-      • Unstable internet connection or high packet loss
-      • Firewall/Router blocking UDP traffic (QUIC protocol)
-      • ISP throttling or network congestion
-      
-   🔧 What to try:
-      • Check your internet connection stability
-      • Try connecting from a different network
-      • Disable VPN/Proxy if you're using one
-      
-   ℹ️  This is usually not critical - your tunnel should continue working normally.
-```
-
-## [2.0.6] - 2026-01-13
-
-### Added
-- 🔧 **Backend URL Configuration**: Full control over backend server
-  - `--backend` / `-b` flag for temporary backend override
-  - `--set-backend` command to save backend URL permanently
-  - `NPORT_BACKEND_URL` environment variable support
-  - Saved backend configuration persists across sessions
-  - Priority system: CLI flag > Saved config > Env var > Default
-- 🗂️ **Unified Configuration System**: All settings in one place
-  - New centralized `config-manager.js` module
-  - All preferences stored in `~/.nport/config.json`
-  - Automatic migration from old format (v2.0.5)
-  - Easy to read and manually edit JSON format
-- 🌐 **New Default Backend**: Updated to `api.nport.link`
-  - Professional domain structure
-  - Better branding alignment
-  - Shorter and easier to remember
-
-### Changed
-- 📝 **Language Configuration**: Now uses unified config system
-  - Language setting moved from `~/.nport/lang` to `~/.nport/config.json`
-  - Automatic migration from old file format
-  - Consistent configuration approach across all settings
-- 📚 **Documentation Updates**: Complete overhaul
-  - Updated `README.md` with backend configuration options
-  - New `CLIENT_SETUP.md` focused on npm installation and backend setup
-  - Comprehensive backend URL documentation
-  - Clear priority order explanation
-
-### Improved
-- 🎯 **Consistency**: Unified approach to all configuration
-  - Backend URL and language now use same storage system
-  - Single config file for all preferences
-  - Cleaner architecture and code organization
-- 💾 **Configuration File Structure**:
-  ```json
-  {
-    "backendUrl": "https://api.nport.link",
-    "language": "en"
-  }
-  ```
-
-### Migration
-- Automatic migration from v2.0.5 configuration files
-- Old `~/.nport/lang` file automatically migrated to `config.json`
-- No manual steps required
-- Old files removed after successful migration
-
-## [2.0.5] - 2026-01-13
-
-### Added
-- 🌍 **Multilingual Support**: Full internationalization with English and Vietnamese
-  - Interactive language selection on first run
-  - `--language` / `-l` flag to change language anytime
-  - Language preference saved to `~/.nport/lang`
-- 🎨 **Enhanced UI**: Complete redesign with better visual hierarchy
-  - New header design with Vietnamese pride
-  - Improved connection status messages
-  - Better formatted output with consistent spacing
-  - Language change hint in goodbye message
-- 📂 **Modular Architecture**: Refactored codebase into organized modules
-  - Split code into `/src` directory with clear separation of concerns
-  - Better maintainability and testability
-  - Modules: config, state, args, binary, api, version, ui, tunnel, lang, analytics
-- ✅ **Version Command**: Added `-v` / `--version` flag
-  - Shows current version
-  - Checks for updates automatically
-  - Displays update instructions if available
-- 📝 **Configuration Directory**: Organized config files under `~/.nport/`
-  - Language preference: `~/.nport/lang`
-  - Analytics ID: `~/.nport/analytics-id`
-
-### Changed
-- 🎯 **Improved Console Output**: Better formatting and spacing throughout
-  - Connection messages now properly indented
-  - Time remaining display updated
-  - Footer redesigned with clearer calls-to-action
-- 🔧 **Better Argument Parsing**: Enhanced CLI argument handling
-  - Support for multiple language flag formats
-  - Interactive prompt when using `--language` without value
-- 📚 **Updated Documentation**: Complete README overhaul
-  - Added multilingual feature documentation
-  - New CLI options table
-  - Project structure documentation
-  - Cleaner examples and better organization
-
-### Fixed
-- 🐛 **Terminal Compatibility**: Removed problematic emoji flags
-  - Vietnamese flag emoji replaced with text
-  - Better compatibility across different terminals
-
-## [2.0.4] - Previous Release
-
-### Features
-- Basic tunnel functionality
-- Custom subdomain support
-- Cloudflare integration
-- Auto-cleanup on exit
-- 4-hour tunnel timeout
-
----
-
-## Version Upgrade Guide
-
-### From 2.0.7 to 2.1.0
-
-```bash
-npm install -g nport@latest
-```
-
-**What's New:**
-
-1. **Full TypeScript Rewrite**
-   - Both CLI and Server now fully typed
-   - Better IDE support and autocompletion
-   - Catches errors at compile time
-
-2. **Comprehensive Documentation**
-   - Architecture guide in `docs/ARCHITECTURE.md`
-   - API reference in `docs/API.md`
-   - Contributing guide in `docs/CONTRIBUTING.md`
-
-3. **Unit Testing**
-   - Run tests with `npm test`
-   - Covers argument parsing, version checks, state management
-
-4. **Auto-download Cloudflared**
-   - Binary downloads automatically on first `nport` run
-   - No separate install step needed
-
-5. **AI-Friendly Codebase**
-   - `.ai/context.md` for AI assistants
-   - `.cursorrules` for consistent AI suggestions
-   - JSDoc comments throughout
-
-**For Contributors:**
-```bash
-git clone https://github.com/tuanngocptn/nport
-cd nport
-npm install
-npm run build
-npm run dev  # Watch mode
-```
-
-**Breaking Changes:** None - fully backward compatible!
-
-### From 2.0.6 to 2.0.7
-
-```bash
-npm install -g nport@latest
-```
-
-**What's New:**
-
-1. **Cleaner Terminal Experience**
-   - No more scary red QUIC error spam
-   - Smart network warnings when needed
-   - Automatic fallback to HTTP/2 when QUIC fails
-
-2. **Better Error Communication**
-   - Understand what's happening with your connection
-   - Clear explanations in your language (EN/VI)
-   - Actionable troubleshooting steps
-
-3. **When You'll See Warnings**
-   - Only after multiple network issues (not just one)
-   - Maximum once every 30 seconds (no spam)
-   - Automatically disappears when connection improves
-
-**Breaking Changes:** None - fully backward compatible!
-
-### From 2.0.5 to 2.0.6
-
-```bash
-npm install -g nport@latest
-```
-
-**New Features to Try:**
-
-1. **Set Your Backend Permanently**
-   ```bash
-   nport --set-backend https://api.nport.link
-   ```
-
-2. **Use Custom Backend Temporarily**
-   ```bash
-   nport 3000 -b https://your-backend.com
-   ```
-
-3. **Check Current Configuration**
-   ```bash
-   cat ~/.nport/config.json
-   ```
-
-4. **Use Environment Variable**
-   ```bash
-   export NPORT_BACKEND_URL=https://your-backend.com
-   nport 3000
-   ```
-
-**Breaking Changes:** None - fully backward compatible!
-
-**Migration:** Your language preference from v2.0.5 will be automatically migrated to the new unified config format.
-
-### From 2.0.4 to 2.0.5
-
-```bash
-npm install -g nport@latest
-```
-
-**New Features to Try:**
-
-1. **Change Language**
-   ```bash
-   nport --language
-   ```
-
-2. **Check Version**
-   ```bash
-   nport -v
-   ```
-
-3. **Direct Language Selection**
-   ```bash
-   nport 3000 -l vi  # Vietnamese
-   nport 3000 -l en  # English
-   ```
-
-**Breaking Changes:** None - fully backward compatible!
-
----
-
-Made with ❤️ in Vietnam by [Nick Pham](https://github.com/tuanngocptn)
-