@frontfriend/sdk 0.0.0-stage → 1.0.0

package/dist/lib/core/api-client.js

@@ -0,0 +1,10 @@
+var m=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports);var W=m((Ha,st)=>{var pn="https://app.frontfriend.dev",mn=".cache/frontfriend",En={JS:["tokens.js","variables.js","semanticVariables.js","semanticDarkVariables.js","keyframes.js","animations.js","safelist.js","custom.js"],JSON:["fonts.json","icons.json","components-config.json","iconLibrary.json","version.json","versionMetadata.json","metadata.json","base.json","nativeTokens.json"]},gn={FF_ID:"FF_ID",FF_API_URL:"FF_API_URL",FF_AUTH_TOKEN:"FF_AUTH_TOKEN",FF_MACHINE_TOKEN:"FRONTFRIEND_MACHINE_TOKEN"};function $n(t){if(!t)return null;try{let e=new URL(t);return e.hostname.startsWith("app.")?`${e.protocol}//${e.hostname.replace(/^app\./,"registry.")}`:null}catch{return null}}st.exports={DEFAULT_API_URL:pn,CACHE_DIR_NAME:mn,CACHE_TTL_DAYS:7,CACHE_TTL_MS:6048e5,CACHE_FILES:En,ENV_VARS:gn,deriveRegistryFromApiUrl:$n}});var we=m((Va,nt)=>{var me=class extends Error{constructor(e,r,s){super(e),this.name="APIError",this.statusCode=r,this.url=s,this.code=`API_${r}`}},Ee=class extends Error{constructor(e,r){super(e),this.name="CacheError",this.operation=r,this.code=`CACHE_${r.toUpperCase()}`}},ge=class extends Error{constructor(e,r){super(e),this.name="ConfigError",this.field=r,this.code=r?`CONFIG_${String(r).toUpperCase()}`:"CONFIG_ERROR"}},$e=class extends Error{constructor(e,r){super(e),this.name="ProcessingError",this.token=r,this.code="PROCESSING_ERROR"}};nt.exports={APIError:me,CacheError:Ee,ConfigError:ge,ProcessingError:$e}});var ot=m((Xa,it)=>{var R=require("fs");function wn(t){try{let e=R.readFileSync(t,"utf8");return JSON.parse(e)}catch(e){if(e.code==="ENOENT")return null;throw e}}function Rn(t){try{return R.readFileSync(t,"utf8").replace(/^\uFEFF/,"")}catch(e){if(e.code==="ENOENT")return null;throw e}}function In(t,e,r=2){let s=JSON.stringify(e,null,r);R.writeFileSync(t,s,"utf8")}function Sn(t,e){R.writeFileSync(t,e,"utf8")}function yn(t,e){if(e==null||typeof e=="object"&&Object.keys(e).length===0||Array.isArray(e)&&e.length===0){let s=`module.exports = ${Array.isArray(e)?"[]":"{}"};`;R.writeFileSync(t,s,"utf8")}else{let r=`module.exports = ${JSON.stringify(e,null,2)};`;R.writeFileSync(t,r,"utf8")}}function Tn(t){return R.existsSync(t)}function Nn(t){R.mkdirSync(t,{recursive:!0})}function An(t){R.rmSync(t,{recursive:!0,force:!0})}function Ln(t){R.rmSync(t,{force:!0})}function On(t,e){R.mkdirSync(require("path").dirname(t),{recursive:!0,mode:448});let r=`${t}.${process.pid}.${Date.now()}.tmp`;try{R.writeFileSync(r,`${JSON.stringify(e,null,2)}
+`,{mode:384}),R.renameSync(r,t);try{R.chmodSync(t,384)}catch{}}finally{R.rmSync(r,{force:!0})}}async function Cn(t,e,r){R.mkdirSync(require("path").dirname(t),{recursive:!0,mode:448});let s=`${t}.lock`,n=Date.now()+2e4,i;for(;i===void 0;)try{i=R.openSync(s,"wx",384),R.writeFileSync(i,String(process.pid))}catch(o){if(o.code!=="EEXIST")throw o;try{let a=Number(R.readFileSync(s,"utf8"));if(Number.isInteger(a)&&a>0)try{process.kill(a,0)}catch(c){if(c.code==="ESRCH"){R.unlinkSync(s);continue}}}catch(a){if(a.code==="ENOENT")continue}if(Date.now()>=n)throw r();await new Promise(a=>setTimeout(a,50))}try{return await e()}finally{R.closeSync(i),R.unlinkSync(s)}}it.exports={writePrivateJsonFileAtomic:On,withPrivateFileLock:Cn,readJsonFileSafe:wn,readFileSafe:Rn,writeJsonFile:In,writeTextFile:Sn,writeModuleExportsFile:yn,fileExists:Tn,ensureDirectoryExists:Nn,removeDirectory:An,removeFile:Ln}});var dt=m((Ja,ht)=>{var{fileExists:vn,readJsonFileSafe:qn,removeFile:xn,writePrivateJsonFileAtomic:Pn,withPrivateFileLock:Fn}=ot(),ct=require("path"),kn=require("os"),Dn=require("https"),_n=require("http"),{URL:F}=require("url"),{DEFAULT_API_URL:D}=W(),Un=ct.join(kn.homedir(),".frontfriend"),_=ct.join(Un,"credentials");function bn(){return _}function z(){try{return qn(_)}catch{return null}}function at(t){try{let e=JSON.parse(Buffer.from(String(t).split(".")[1],"base64url").toString("utf8"));return typeof e.email=="string"?e.email:null}catch{return null}}function jn(){let t=z();if(!t||!t.accessToken)return null;let e=Number(t.refreshExpiresAt)||0;return{email:at(t.accessToken),apiUrl:t.ffApiUrl||null,expired:e>0&&e<Date.now()}}function ut(t){Pn(_,t)}function Gn(){return vn(_)?(xn(_),!0):!1}function Re(t,e=60*1e3){return!t?.accessToken||!t.expiresAt||Date.now()+e>=t.expiresAt}function P(t){let e=new Error(`${t}. Run \`frontfriend login\` to re-authenticate.`);return e.code="FF_AUTH_REFRESH_FAILED",e}function lt(t,e,r){return new Promise((s,n)=>{let i=new F(t);if(i.protocol!=="https:"&&!(i.protocol==="http:"&&["localhost","127.0.0.1","[::1]"].includes(i.hostname))){n(new Error("Frontfriend API URLs require HTTPS except on localhost"));return}let o=i.protocol==="https:"?Dn:_n,a=JSON.stringify(e||{}),c=o.request({hostname:i.hostname,port:i.port,path:`${i.pathname}${i.search}`,method:"POST",headers:{"content-type":"application/json","content-length":Buffer.byteLength(a),...r?{authorization:`Bearer ${r}`}:{}}},u=>{let l="";u.on("data",h=>{l+=h}),u.on("end",()=>{if(u.statusCode>=300&&u.statusCode<400){let E=u.headers.location?` to ${u.headers.location}`:"",f=new Error(`HTTP ${u.statusCode}: redirected${E}`);f.statusCode=u.statusCode,f.body=l,n(f);return}let h=null;try{h=l?JSON.parse(l):null}catch{let f=u.headers["content-type"]||"unknown content-type",I=new Error(`Expected JSON from FrontFriend API at ${t}, but received ${f} (HTTP ${u.statusCode}). Check FF_API_URL or pass --api-url with the FrontFriend app URL.`);if(I.statusCode=u.statusCode,I.body=l,u.statusCode>=400){n(I);return}n(I);return}if(u.statusCode>=400){let E=new Error(h?.error_description||h?.error||`HTTP ${u.statusCode}`);E.statusCode=u.statusCode,E.body=h,n(E);return}s(h)})});c.setTimeout(15e3,()=>c.destroy(new Error("Frontfriend API request timed out"))),c.on("error",n),c.write(a),c.end()})}async function Mn(t){return Fn(_,t,()=>P("Another process is refreshing the session"))}async function ft(t,e=D){return Mn(async()=>{let r=z();if(r&&new F(r.ffApiUrl||D).origin===new F(e).origin){if(!Re(r))return r;t=r}return Hn(t,e)})}async function Hn(t,e=D){if(new F(e).origin!==new F(t.ffApiUrl||D).origin)throw P("The stored session belongs to a different API origin");if(!t?.refreshToken||!t?.deviceId)throw P("FrontFriend session expired");let r;try{r=await lt(`${e}/api/plugin/token`,{grant_type:"refresh_token",refresh_token:t.refreshToken,device_id:t.deviceId})}catch(n){throw P(n?.message||"Could not refresh FrontFriend session")}if(!r?.access_token||!r?.refresh_token)throw P("Could not refresh FrontFriend session");let s={accessToken:r.access_token,refreshToken:r.refresh_token,deviceId:r.device_id||t.deviceId,expiresAt:Date.now()+(r.expires_in||900)*1e3,refreshExpiresAt:Date.now()+(r.refresh_expires_in||604800)*1e3,ffApiUrl:e};return ut(s),s}async function Vn(t={}){if(t.envToken)return t.envToken;if(!t.skipCredentials){let e=z();if(e?.accessToken||e?.refreshToken){let r=t.baseURL||e.ffApiUrl||D;if(new F(r).origin!==new F(e.ffApiUrl||D).origin)throw P("The stored session belongs to a different API origin");return e.accessToken&&!Re(e)?e.accessToken:(await ft(e,r)).accessToken}}return t.configuredToken?(t.silent||console.warn("\u26A0\uFE0F  auth-token in frontfriend.config.js is deprecated. Run `frontfriend login` to store credentials outside the repo."),t.configuredToken):null}ht.exports={accountEmail:at,signedInAccount:jn,getCredentialsPath:bn,readCredentials:z,writeCredentials:ut,deleteCredentials:Gn,isExpired:Re,postJson:lt,refreshCredentials:ft,resolveAuthToken:Vn,createAuthRefreshError:P}});var Rt=m((Ba,wt)=>{var{ConfigError:Xn}=we(),{DEFAULT_API_URL:Jn}=W(),pt="DESIGN_SYSTEM_REQUIRED",Ie="DESIGN_SYSTEM_NOT_FOUND",mt="DESIGN_SYSTEM_FORBIDDEN",Et="DESIGN_SYSTEM_OPERATION_DENIED",Bn=new Set(["TENANT_MISMATCH","RESOURCE_MISMATCH","UNAUTHENTICATED"]);function gt(t){return String(t||Jn).replace(/\/+$/,"")}function Yn({apiUrl:t,flagHint:e}){return[`     1. Create a Design System at ${gt(t)} (or open an existing one) and copy its ff-id.`,"     2. Connect it to this project:","          npx frontfriend login","          npx frontfriend setup --ff-id <ff-id>",`        or add "ff-id": "<ff-id>" to frontfriend.config.js${e?`, ${e}`:""}.`]}function $t({command:t,apiUrl:e,flagHint:r,reportOnly:s=!1}={}){return["\u{1F517} No Design System connected to this project.",`   ${t?`\`frontfriend ${t}\` works`:"Frontfriend works"} on a Design System (ff-id), and frontfriend.config.js has none yet.`,"   Connect one first:",...Yn({apiUrl:e,flagHint:r}),...s?[]:["   Nothing in this project was changed."]]}var K=class extends Xn{constructor({command:e,apiUrl:r,flagHint:s}={}){let n=$t({command:e,apiUrl:r,flagHint:s});super(n.join(`
+`),"ff-id"),this.name="DesignSystemRequiredError",this.code=pt,this.command=e,this.lines=n}};function Wn(t,{command:e,apiUrl:r,flagHint:s}={}){if(t&&typeof t.ffId=="string"&&t.ffId.trim())return t.ffId;throw new K({command:e,apiUrl:r,flagHint:s})}function zn(t){if(!t)return null;try{let e=new URL(t),r=e.pathname.match(/\/design-systems\/([^/]+)/);return r?decodeURIComponent(r[1]):e.searchParams.get("ffId")}catch{return null}}function Kn(t){try{return new URL(t).origin}catch{return null}}function Qn(t,{ffId:e,apiUrl:r}={}){if(!t||typeof t!="object")return null;let s=t.statusCode,n=`${t.message||""} ${t.serverMessage||""}`,i=e||zn(t.url),o=i?`"${i}"`:"configured in frontfriend.config.js",a=gt(r||Kn(t.url));if(s===404&&(t.serverCode===Ie||/design system not found/i.test(n)))return{code:Ie,lines:[`\u{1F517} Design System ${o} was not found on ${a}.`,"   The ff-id in frontfriend.config.js does not match any Design System there.","   Copy the ff-id again from the Design System in Frontfriend, or connect another one:","          npx frontfriend setup --ff-id <ff-id>"]};let c=/\/design-systems\/|[?&]ffId=/.test(t.url||"");return s===403&&c&&t.serverCode&&!Bn.has(t.serverCode)?{code:Et,lines:[`\u{1F512} Frontfriend denied this operation on Design System ${o}.`,`   ${t.serverMessage||"The operation is not allowed."} (${t.serverCode})`,"   Your login reaches this Design System: check your workspace role and plan, or ask a workspace admin."]}:s===403&&c?{code:mt,lines:[`\u{1F512} Design System ${o} is not accessible with your current Frontfriend login or permissions.`,"   Sign in with an account that belongs to its workspace (npx frontfriend login),","   or ask the workspace administrator to invite your sign-in email. For help, contact support@frontfriend.dev.","   or connect a Design System you can access:","          npx frontfriend setup --ff-id <ff-id>"]}:null}wt.exports={DESIGN_SYSTEM_REQUIRED:pt,DESIGN_SYSTEM_NOT_FOUND:Ie,DESIGN_SYSTEM_FORBIDDEN:mt,DESIGN_SYSTEM_OPERATION_DENIED:Et,DesignSystemRequiredError:K,missingDesignSystemLines:$t,requireDesignSystem:Wn,describeDesignSystemAccessError:Qn}});var Nt=m((Ya,Tt)=>{Tt.exports=yt;yt.sync=ei;var It=require("fs");function Zn(t,e){var r=e.pathExt!==void 0?e.pathExt:process.env.PATHEXT;if(!r||(r=r.split(";"),r.indexOf("")!==-1))return!0;for(var s=0;s<r.length;s++){var n=r[s].toLowerCase();if(n&&t.substr(-n.length).toLowerCase()===n)return!0}return!1}function St(t,e,r){return!t.isSymbolicLink()&&!t.isFile()?!1:Zn(e,r)}function yt(t,e,r){It.stat(t,function(s,n){r(s,s?!1:St(n,t,e))})}function ei(t,e){return St(It.statSync(t),t,e)}});var vt=m((Wa,Ct)=>{Ct.exports=Lt;Lt.sync=ti;var At=require("fs");function Lt(t,e,r){At.stat(t,function(s,n){r(s,s?!1:Ot(n,e))})}function ti(t,e){return Ot(At.statSync(t),e)}function Ot(t,e){return t.isFile()&&ri(t,e)}function ri(t,e){var r=t.mode,s=t.uid,n=t.gid,i=e.uid!==void 0?e.uid:process.getuid&&process.getuid(),o=e.gid!==void 0?e.gid:process.getgid&&process.getgid(),a=parseInt("100",8),c=parseInt("010",8),u=parseInt("001",8),l=a|c,h=r&u||r&c&&n===o||r&a&&s===i||r&l&&i===0;return h}});var xt=m((Ka,qt)=>{var za=require("fs"),Q;process.platform==="win32"||global.TESTING_WINDOWS?Q=Nt():Q=vt();qt.exports=Se;Se.sync=si;function Se(t,e,r){if(typeof e=="function"&&(r=e,e={}),!r){if(typeof Promise!="function")throw new TypeError("callback not provided");return new Promise(function(s,n){Se(t,e||{},function(i,o){i?n(i):s(o)})})}Q(t,e||{},function(s,n){s&&(s.code==="EACCES"||e&&e.ignoreErrors)&&(s=null,n=!1),r(s,n)})}function si(t,e){try{return Q.sync(t,e||{})}catch(r){if(e&&e.ignoreErrors||r.code==="EACCES")return!1;throw r}}});var bt=m((Qa,Ut)=>{var U=process.platform==="win32"||process.env.OSTYPE==="cygwin"||process.env.OSTYPE==="msys",Pt=require("path"),ni=U?";":":",Ft=xt(),kt=t=>Object.assign(new Error(`not found: ${t}`),{code:"ENOENT"}),Dt=(t,e)=>{let r=e.colon||ni,s=t.match(/\//)||U&&t.match(/\\/)?[""]:[...U?[process.cwd()]:[],...(e.path||process.env.PATH||"").split(r)],n=U?e.pathExt||process.env.PATHEXT||".EXE;.CMD;.BAT;.COM":"",i=U?n.split(r):[""];return U&&t.indexOf(".")!==-1&&i[0]!==""&&i.unshift(""),{pathEnv:s,pathExt:i,pathExtExe:n}},_t=(t,e,r)=>{typeof e=="function"&&(r=e,e={}),e||(e={});let{pathEnv:s,pathExt:n,pathExtExe:i}=Dt(t,e),o=[],a=u=>new Promise((l,h)=>{if(u===s.length)return e.all&&o.length?l(o):h(kt(t));let E=s[u],f=/^".*"$/.test(E)?E.slice(1,-1):E,I=Pt.join(f,t),v=!f&&/^\.[\\\/]/.test(t)?t.slice(0,2)+I:I;l(c(v,u,0))}),c=(u,l,h)=>new Promise((E,f)=>{if(h===n.length)return E(a(l+1));let I=n[h];Ft(u+I,{pathExt:i},(v,dn)=>{if(!v&&dn)if(e.all)o.push(u+I);else return E(u+I);return E(c(u,l,h+1))})});return r?a(0).then(u=>r(null,u),r):a(0)},ii=(t,e)=>{e=e||{};let{pathEnv:r,pathExt:s,pathExtExe:n}=Dt(t,e),i=[];for(let o=0;o<r.length;o++){let a=r[o],c=/^".*"$/.test(a)?a.slice(1,-1):a,u=Pt.join(c,t),l=!c&&/^\.[\\\/]/.test(t)?t.slice(0,2)+u:u;for(let h=0;h<s.length;h++){let E=l+s[h];try{if(Ft.sync(E,{pathExt:n}))if(e.all)i.push(E);else return E}catch{}}}if(e.all&&i.length)return i;if(e.nothrow)return null;throw kt(t)};Ut.exports=_t;_t.sync=ii});var Gt=m((Za,ye)=>{"use strict";var jt=(t={})=>{let e=t.env||process.env;return(t.platform||process.platform)!=="win32"?"PATH":Object.keys(e).reverse().find(s=>s.toUpperCase()==="PATH")||"Path"};ye.exports=jt;ye.exports.default=jt});var Xt=m((eu,Vt)=>{"use strict";var Mt=require("path"),oi=bt(),ci=Gt();function Ht(t,e){let r=t.options.env||process.env,s=process.cwd(),n=t.options.cwd!=null,i=n&&process.chdir!==void 0&&!process.chdir.disabled;if(i)try{process.chdir(t.options.cwd)}catch{}let o;try{o=oi.sync(t.command,{path:r[ci({env:r})],pathExt:e?Mt.delimiter:void 0})}catch{}finally{i&&process.chdir(s)}return o&&(o=Mt.resolve(n?t.options.cwd:"",o)),o}function ai(t){return Ht(t)||Ht(t,!0)}Vt.exports=ai});var Jt=m((tu,Ne)=>{"use strict";var Te=/([()\][%!^"`<>&|;, *?])/g;function ui(t){return t=t.replace(Te,"^$1"),t}function li(t,e){return t=`${t}`,t=t.replace(/(?=(\\+?)?)\1"/g,'$1$1\\"'),t=t.replace(/(?=(\\+?)?)\1$/,"$1$1"),t=`"${t}"`,t=t.replace(Te,"^$1"),e&&(t=t.replace(Te,"^$1")),t}Ne.exports.command=ui;Ne.exports.argument=li});var Yt=m((ru,Bt)=>{"use strict";Bt.exports=/^#!(.*)/});var zt=m((su,Wt)=>{"use strict";var fi=Yt();Wt.exports=(t="")=>{let e=t.match(fi);if(!e)return null;let[r,s]=e[0].replace(/#! ?/,"").split(" "),n=r.split("/").pop();return n==="env"?s:s?`${n} ${s}`:n}});var Qt=m((nu,Kt)=>{"use strict";var Ae=require("fs"),hi=zt();function di(t){let r=Buffer.alloc(150),s;try{s=Ae.openSync(t,"r"),Ae.readSync(s,r,0,150,0),Ae.closeSync(s)}catch{}return hi(r.toString())}Kt.exports=di});var rr=m((iu,tr)=>{"use strict";var pi=require("path"),Zt=Xt(),er=Jt(),mi=Qt(),Ei=process.platform==="win32",gi=/\.(?:com|exe)$/i,$i=/node_modules[\\/].bin[\\/][^\\/]+\.cmd$/i;function wi(t){t.file=Zt(t);let e=t.file&&mi(t.file);return e?(t.args.unshift(t.file),t.command=e,Zt(t)):t.file}function Ri(t){if(!Ei)return t;let e=wi(t),r=!gi.test(e);if(t.options.forceShell||r){let s=$i.test(e);t.command=pi.normalize(t.command),t.command=er.command(t.command),t.args=t.args.map(i=>er.argument(i,s));let n=[t.command].concat(t.args).join(" ");t.args=["/d","/s","/c",`"${n}"`],t.command=process.env.comspec||"cmd.exe",t.options.windowsVerbatimArguments=!0}return t}function Ii(t,e,r){e&&!Array.isArray(e)&&(r=e,e=null),e=e?e.slice(0):[],r=Object.assign({},r);let s={command:t,args:e,options:r,file:void 0,original:{command:t,args:e}};return r.shell?s:Ri(s)}tr.exports=Ii});var ir=m((ou,nr)=>{"use strict";var Le=process.platform==="win32";function Oe(t,e){return Object.assign(new Error(`${e} ${t.command} ENOENT`),{code:"ENOENT",errno:"ENOENT",syscall:`${e} ${t.command}`,path:t.command,spawnargs:t.args})}function Si(t,e){if(!Le)return;let r=t.emit;t.emit=function(s,n){if(s==="exit"){let i=sr(n,e);if(i)return r.call(t,"error",i)}return r.apply(t,arguments)}}function sr(t,e){return Le&&t===1&&!e.file?Oe(e.original,"spawn"):null}function yi(t,e){return Le&&t===1&&!e.file?Oe(e.original,"spawnSync"):null}nr.exports={hookChildProcess:Si,verifyENOENT:sr,verifyENOENTSync:yi,notFoundError:Oe}});var ar=m((cu,b)=>{"use strict";var or=require("child_process"),Ce=rr(),ve=ir();function cr(t,e,r){let s=Ce(t,e,r),n=or.spawn(s.command,s.args,s.options);return ve.hookChildProcess(n,s),n}function Ti(t,e,r){let s=Ce(t,e,r),n=or.spawnSync(s.command,s.args,s.options);return n.error=n.error||ve.verifyENOENTSync(n.status,s),n}b.exports=cr;b.exports.spawn=cr;b.exports.sync=Ti;b.exports._parse=Ce;b.exports._enoent=ve});var j=m((au,ur)=>{"use strict";var Ni="2.0.0",Ai=Number.MAX_SAFE_INTEGER||9007199254740991,Li=16,Oi=250,Ci=["major","premajor","minor","preminor","patch","prepatch","prerelease"];ur.exports={MAX_LENGTH:256,MAX_SAFE_COMPONENT_LENGTH:Li,MAX_SAFE_BUILD_LENGTH:Oi,MAX_SAFE_INTEGER:Ai,RELEASE_TYPES:Ci,SEMVER_SPEC_VERSION:Ni,FLAG_INCLUDE_PRERELEASE:1,FLAG_LOOSE:2}});var V=m((uu,lr)=>{"use strict";var vi=typeof process=="object"&&process.env&&process.env.NODE_DEBUG&&/\bsemver\b/i.test(process.env.NODE_DEBUG)?(...t)=>console.error("SEMVER",...t):()=>{};lr.exports=vi});var G=m((C,fr)=>{"use strict";var{MAX_SAFE_COMPONENT_LENGTH:qe,MAX_SAFE_BUILD_LENGTH:qi,MAX_LENGTH:xi}=j(),Pi=V();C=fr.exports={};var Fi=C.re=[],ki=C.safeRe=[],d=C.src=[],Di=C.safeSrc=[],p=C.t={},_i=0,xe="[a-zA-Z0-9-]",Ui=[["\\s",1],["\\d",xi],[xe,qi]],bi=t=>{for(let[e,r]of Ui)t=t.split(`${e}*`).join(`${e}{0,${r}}`).split(`${e}+`).join(`${e}{1,${r}}`);return t},g=(t,e,r)=>{let s=bi(e),n=_i++;Pi(t,n,e),p[t]=n,d[n]=e,Di[n]=s,Fi[n]=new RegExp(e,r?"g":void 0),ki[n]=new RegExp(s,r?"g":void 0)};g("NUMERICIDENTIFIER","0|[1-9]\\d*");g("NUMERICIDENTIFIERLOOSE","\\d+");g("NONNUMERICIDENTIFIER",`\\d*[a-zA-Z-]${xe}*`);g("MAINVERSION",`(${d[p.NUMERICIDENTIFIER]})\\.(${d[p.NUMERICIDENTIFIER]})\\.(${d[p.NUMERICIDENTIFIER]})`);g("MAINVERSIONLOOSE",`(${d[p.NUMERICIDENTIFIERLOOSE]})\\.(${d[p.NUMERICIDENTIFIERLOOSE]})\\.(${d[p.NUMERICIDENTIFIERLOOSE]})`);g("PRERELEASEIDENTIFIER",`(?:${d[p.NONNUMERICIDENTIFIER]}|${d[p.NUMERICIDENTIFIER]})`);g("PRERELEASEIDENTIFIERLOOSE",`(?:${d[p.NONNUMERICIDENTIFIER]}|${d[p.NUMERICIDENTIFIERLOOSE]})`);g("PRERELEASE",`(?:-(${d[p.PRERELEASEIDENTIFIER]}(?:\\.${d[p.PRERELEASEIDENTIFIER]})*))`);g("PRERELEASELOOSE",`(?:-?(${d[p.PRERELEASEIDENTIFIERLOOSE]}(?:\\.${d[p.PRERELEASEIDENTIFIERLOOSE]})*))`);g("BUILDIDENTIFIER",`${xe}+`);g("BUILD",`(?:\\+(${d[p.BUILDIDENTIFIER]}(?:\\.${d[p.BUILDIDENTIFIER]})*))`);g("FULLPLAIN",`v?${d[p.MAINVERSION]}${d[p.PRERELEASE]}?${d[p.BUILD]}?`);g("FULL",`^${d[p.FULLPLAIN]}$`);g("LOOSEPLAIN",`[v=\\s]*${d[p.MAINVERSIONLOOSE]}${d[p.PRERELEASELOOSE]}?${d[p.BUILD]}?`);g("LOOSE",`^${d[p.LOOSEPLAIN]}$`);g("GTLT","((?:<|>)?=?)");g("XRANGEIDENTIFIERLOOSE",`${d[p.NUMERICIDENTIFIERLOOSE]}|x|X|\\*`);g("XRANGEIDENTIFIER",`${d[p.NUMERICIDENTIFIER]}|x|X|\\*`);g("XRANGEPLAIN",`[v=\\s]*(${d[p.XRANGEIDENTIFIER]})(?:\\.(${d[p.XRANGEIDENTIFIER]})(?:\\.(${d[p.XRANGEIDENTIFIER]})(?:${d[p.PRERELEASE]})?${d[p.BUILD]}?)?)?`);g("XRANGEPLAINLOOSE",`[v=\\s]*(${d[p.XRANGEIDENTIFIERLOOSE]})(?:\\.(${d[p.XRANGEIDENTIFIERLOOSE]})(?:\\.(${d[p.XRANGEIDENTIFIERLOOSE]})(?:${d[p.PRERELEASELOOSE]})?${d[p.BUILD]}?)?)?`);g("XRANGE",`^${d[p.GTLT]}\\s*${d[p.XRANGEPLAIN]}$`);g("XRANGELOOSE",`^${d[p.GTLT]}\\s*${d[p.XRANGEPLAINLOOSE]}$`);g("COERCEPLAIN",`(^|[^\\d])(\\d{1,${qe}})(?:\\.(\\d{1,${qe}}))?(?:\\.(\\d{1,${qe}}))?`);g("COERCE",`${d[p.COERCEPLAIN]}(?:$|[^\\d])`);g("COERCEFULL",d[p.COERCEPLAIN]+`(?:${d[p.PRERELEASE]})?(?:${d[p.BUILD]})?(?:$|[^\\d])`);g("COERCERTL",d[p.COERCE],!0);g("COERCERTLFULL",d[p.COERCEFULL],!0);g("LONETILDE","(?:~>?)");g("TILDETRIM",`(\\s*)${d[p.LONETILDE]}\\s+`,!0);C.tildeTrimReplace="$1~";g("TILDE",`^${d[p.LONETILDE]}${d[p.XRANGEPLAIN]}$`);g("TILDELOOSE",`^${d[p.LONETILDE]}${d[p.XRANGEPLAINLOOSE]}$`);g("LONECARET","(?:\\^)");g("CARETTRIM",`(\\s*)${d[p.LONECARET]}\\s+`,!0);C.caretTrimReplace="$1^";g("CARET",`^${d[p.LONECARET]}${d[p.XRANGEPLAIN]}$`);g("CARETLOOSE",`^${d[p.LONECARET]}${d[p.XRANGEPLAINLOOSE]}$`);g("COMPARATORLOOSE",`^${d[p.GTLT]}\\s*(${d[p.LOOSEPLAIN]})$|^$`);g("COMPARATOR",`^${d[p.GTLT]}\\s*(${d[p.FULLPLAIN]})$|^$`);g("COMPARATORTRIM",`(\\s*)${d[p.GTLT]}\\s*(${d[p.LOOSEPLAIN]}|${d[p.XRANGEPLAIN]})`,!0);C.comparatorTrimReplace="$1$2$3";g("HYPHENRANGE",`^\\s*(${d[p.XRANGEPLAIN]})\\s+-\\s+(${d[p.XRANGEPLAIN]})\\s*$`);g("HYPHENRANGELOOSE",`^\\s*(${d[p.XRANGEPLAINLOOSE]})\\s+-\\s+(${d[p.XRANGEPLAINLOOSE]})\\s*$`);g("STAR","(<|>)?=?\\s*\\*");g("GTE0","^\\s*>=\\s*0\\.0\\.0\\s*$");g("GTE0PRE","^\\s*>=\\s*0\\.0\\.0-0\\s*$")});var Z=m((lu,hr)=>{"use strict";var ji=Object.freeze({loose:!0}),Gi=Object.freeze({}),Mi=t=>t?typeof t!="object"?ji:t:Gi;hr.exports=Mi});var Pe=m((fu,mr)=>{"use strict";var dr=/^[0-9]+$/,pr=(t,e)=>{if(typeof t=="number"&&typeof e=="number")return t===e?0:t<e?-1:1;let r=dr.test(t),s=dr.test(e);return r&&s&&(t=+t,e=+e),t===e?0:r&&!s?-1:s&&!r?1:t<e?-1:1},Hi=(t,e)=>pr(e,t);mr.exports={compareIdentifiers:pr,rcompareIdentifiers:Hi}});var y=m((hu,gr)=>{"use strict";var ee=V(),{MAX_LENGTH:Er,MAX_SAFE_INTEGER:te}=j(),{safeRe:re,t:se}=G(),Vi=Z(),{compareIdentifiers:Fe}=Pe(),Xi=(t,e)=>{let r=e.split(".");if(r.length>t.length)return!1;for(let s=0;s<r.length;s++)if(Fe(t[s],r[s])!==0)return!1;return!0},ke=class t{constructor(e,r){if(r=Vi(r),e instanceof t){if(e.loose===!!r.loose&&e.includePrerelease===!!r.includePrerelease)return e;e=e.version}else if(typeof e!="string")throw new TypeError(`Invalid version. Must be a string. Got type "${typeof e}".`);if(e.length>Er)throw new TypeError(`version is longer than ${Er} characters`);ee("SemVer",e,r),this.options=r,this.loose=!!r.loose,this.includePrerelease=!!r.includePrerelease;let s=e.trim().match(r.loose?re[se.LOOSE]:re[se.FULL]);if(!s)throw new TypeError(`Invalid Version: ${e}`);if(this.raw=e,this.major=+s[1],this.minor=+s[2],this.patch=+s[3],this.major>te||this.major<0)throw new TypeError("Invalid major version");if(this.minor>te||this.minor<0)throw new TypeError("Invalid minor version");if(this.patch>te||this.patch<0)throw new TypeError("Invalid patch version");s[4]?this.prerelease=s[4].split(".").map(n=>{if(/^[0-9]+$/.test(n)){let i=+n;if(i>=0&&i<te)return i}return n}):this.prerelease=[],this.build=s[5]?s[5].split("."):[],this.format()}format(){return this.version=`${this.major}.${this.minor}.${this.patch}`,this.prerelease.length&&(this.version+=`-${this.prerelease.join(".")}`),this.version}toString(){return this.version}compare(e){if(ee("SemVer.compare",this.version,this.options,e),!(e instanceof t)){if(typeof e=="string"&&e===this.version)return 0;e=new t(e,this.options)}return e.version===this.version?0:this.compareMain(e)||this.comparePre(e)}compareMain(e){return e instanceof t||(e=new t(e,this.options)),this.major<e.major?-1:this.major>e.major?1:this.minor<e.minor?-1:this.minor>e.minor?1:this.patch<e.patch?-1:this.patch>e.patch?1:0}comparePre(e){if(e instanceof t||(e=new t(e,this.options)),this.prerelease.length&&!e.prerelease.length)return-1;if(!this.prerelease.length&&e.prerelease.length)return 1;if(!this.prerelease.length&&!e.prerelease.length)return 0;let r=0;do{let s=this.prerelease[r],n=e.prerelease[r];if(ee("prerelease compare",r,s,n),s===void 0&&n===void 0)return 0;if(n===void 0)return 1;if(s===void 0)return-1;if(s===n)continue;return Fe(s,n)}while(++r)}compareBuild(e){e instanceof t||(e=new t(e,this.options));let r=0;do{let s=this.build[r],n=e.build[r];if(ee("build compare",r,s,n),s===void 0&&n===void 0)return 0;if(n===void 0)return 1;if(s===void 0)return-1;if(s===n)continue;return Fe(s,n)}while(++r)}inc(e,r,s){if(e.startsWith("pre")){if(!r&&s===!1)throw new Error("invalid increment argument: identifier is empty");if(r){let n=`-${r}`.match(this.options.loose?re[se.PRERELEASELOOSE]:re[se.PRERELEASE]);if(!n||n[1]!==r)throw new Error(`invalid identifier: ${r}`)}}switch(e){case"premajor":this.prerelease.length=0,this.patch=0,this.minor=0,this.major++,this.inc("pre",r,s);break;case"preminor":this.prerelease.length=0,this.patch=0,this.minor++,this.inc("pre",r,s);break;case"prepatch":this.prerelease.length=0,this.inc("patch",r,s),this.inc("pre",r,s);break;case"prerelease":this.prerelease.length===0&&this.inc("patch",r,s),this.inc("pre",r,s);break;case"release":if(this.prerelease.length===0)throw new Error(`version ${this.raw} is not a prerelease`);this.prerelease.length=0;break;case"major":(this.minor!==0||this.patch!==0||this.prerelease.length===0)&&this.major++,this.minor=0,this.patch=0,this.prerelease=[];break;case"minor":(this.patch!==0||this.prerelease.length===0)&&this.minor++,this.patch=0,this.prerelease=[];break;case"patch":this.prerelease.length===0&&this.patch++,this.prerelease=[];break;case"pre":{let n=Number(s)?1:0;if(this.prerelease.length===0)this.prerelease=[n];else{let i=this.prerelease.length;for(;--i>=0;)typeof this.prerelease[i]=="number"&&(this.prerelease[i]++,i=-2);if(i===-1){if(r===this.prerelease.join(".")&&s===!1)throw new Error("invalid increment argument: identifier already exists");this.prerelease.push(n)}}if(r){let i=[r,n];if(s===!1&&(i=[r]),Xi(this.prerelease,r)){let o=this.prerelease[r.split(".").length];isNaN(o)&&(this.prerelease=i)}else this.prerelease=i}break}default:throw new Error(`invalid increment argument: ${e}`)}return this.raw=this.format(),this.build.length&&(this.raw+=`+${this.build.join(".")}`),this}};gr.exports=ke});var q=m((du,wr)=>{"use strict";var $r=y(),Ji=(t,e,r=!1)=>{if(t instanceof $r)return t;try{return new $r(t,e)}catch(s){if(!r)return null;throw s}};wr.exports=Ji});var Ir=m((pu,Rr)=>{"use strict";var Bi=q(),Yi=(t,e)=>{let r=Bi(t,e);return r?r.version:null};Rr.exports=Yi});var yr=m((mu,Sr)=>{"use strict";var Wi=q(),zi=(t,e)=>{let r=Wi(t.trim().replace(/^[=v]+/,""),e);return r?r.version:null};Sr.exports=zi});var Ar=m((Eu,Nr)=>{"use strict";var Tr=y(),Ki=(t,e,r,s,n)=>{typeof r=="string"&&(n=s,s=r,r=void 0);try{return new Tr(t instanceof Tr?t.version:t,r).inc(e,s,n).version}catch{return null}};Nr.exports=Ki});var Cr=m((gu,Or)=>{"use strict";var Lr=q(),Qi=(t,e)=>{let r=Lr(t,null,!0),s=Lr(e,null,!0),n=r.compare(s);if(n===0)return null;let i=n>0,o=i?r:s,a=i?s:r,c=!!o.prerelease.length;if(!!a.prerelease.length&&!c){if(!a.patch&&!a.minor)return"major";if(a.compareMain(o)===0)return a.minor&&!a.patch?"minor":"patch"}let l=c?"pre":"";return r.major!==s.major?l+"major":r.minor!==s.minor?l+"minor":r.patch!==s.patch?l+"patch":"prerelease"};Or.exports=Qi});var qr=m(($u,vr)=>{"use strict";var Zi=y(),eo=(t,e)=>new Zi(t,e).major;vr.exports=eo});var Pr=m((wu,xr)=>{"use strict";var to=y(),ro=(t,e)=>new to(t,e).minor;xr.exports=ro});var kr=m((Ru,Fr)=>{"use strict";var so=y(),no=(t,e)=>new so(t,e).patch;Fr.exports=no});var _r=m((Iu,Dr)=>{"use strict";var io=q(),oo=(t,e)=>{let r=io(t,e);return r&&r.prerelease.length?r.prerelease:null};Dr.exports=oo});var A=m((Su,br)=>{"use strict";var Ur=y(),co=(t,e,r)=>new Ur(t,r).compare(new Ur(e,r));br.exports=co});var Gr=m((yu,jr)=>{"use strict";var ao=A(),uo=(t,e,r)=>ao(e,t,r);jr.exports=uo});var Hr=m((Tu,Mr)=>{"use strict";var lo=A(),fo=(t,e)=>lo(t,e,!0);Mr.exports=fo});var ne=m((Nu,Xr)=>{"use strict";var Vr=y(),ho=(t,e,r)=>{let s=new Vr(t,r),n=new Vr(e,r);return s.compare(n)||s.compareBuild(n)};Xr.exports=ho});var Br=m((Au,Jr)=>{"use strict";var po=ne(),mo=(t,e)=>t.sort((r,s)=>po(r,s,e));Jr.exports=mo});var Wr=m((Lu,Yr)=>{"use strict";var Eo=ne(),go=(t,e)=>t.sort((r,s)=>Eo(s,r,e));Yr.exports=go});var X=m((Ou,zr)=>{"use strict";var $o=A(),wo=(t,e,r)=>$o(t,e,r)>0;zr.exports=wo});var ie=m((Cu,Kr)=>{"use strict";var Ro=A(),Io=(t,e,r)=>Ro(t,e,r)<0;Kr.exports=Io});var De=m((vu,Qr)=>{"use strict";var So=A(),yo=(t,e,r)=>So(t,e,r)===0;Qr.exports=yo});var _e=m((qu,Zr)=>{"use strict";var To=A(),No=(t,e,r)=>To(t,e,r)!==0;Zr.exports=No});var oe=m((xu,es)=>{"use strict";var Ao=A(),Lo=(t,e,r)=>Ao(t,e,r)>=0;es.exports=Lo});var ce=m((Pu,ts)=>{"use strict";var Oo=A(),Co=(t,e,r)=>Oo(t,e,r)<=0;ts.exports=Co});var Ue=m((Fu,rs)=>{"use strict";var vo=De(),qo=_e(),xo=X(),Po=oe(),Fo=ie(),ko=ce(),Do=(t,e,r,s)=>{switch(e){case"===":return typeof t=="object"&&(t=t.version),typeof r=="object"&&(r=r.version),t===r;case"!==":return typeof t=="object"&&(t=t.version),typeof r=="object"&&(r=r.version),t!==r;case"":case"=":case"==":return vo(t,r,s);case"!=":return qo(t,r,s);case">":return xo(t,r,s);case">=":return Po(t,r,s);case"<":return Fo(t,r,s);case"<=":return ko(t,r,s);default:throw new TypeError(`Invalid operator: ${e}`)}};rs.exports=Do});var ns=m((ku,ss)=>{"use strict";var _o=y(),Uo=q(),{safeRe:ae,t:ue}=G(),bo=(t,e)=>{if(t instanceof _o)return t;if(typeof t=="number"&&(t=String(t)),typeof t!="string")return null;e=e||{};let r=null;if(!e.rtl)r=t.match(e.includePrerelease?ae[ue.COERCEFULL]:ae[ue.COERCE]);else{let c=e.includePrerelease?ae[ue.COERCERTLFULL]:ae[ue.COERCERTL],u;for(;(u=c.exec(t))&&(!r||r.index+r[0].length!==t.length);)(!r||u.index+u[0].length!==r.index+r[0].length)&&(r=u),c.lastIndex=u.index+u[1].length+u[2].length;c.lastIndex=-1}if(r===null)return null;let s=r[2],n=r[3]||"0",i=r[4]||"0",o=e.includePrerelease&&r[5]?`-${r[5]}`:"",a=e.includePrerelease&&r[6]?`+${r[6]}`:"";return Uo(`${s}.${n}.${i}${o}${a}`,e)};ss.exports=bo});var os=m((Du,is)=>{"use strict";var jo=q(),Go=j(),Mo=y(),Ho=(t,e,r)=>{if(!Go.RELEASE_TYPES.includes(e))return null;let s=Vo(t,r);return s&&Xo(s,e)},Vo=(t,e)=>{let r=t instanceof Mo?t.version:t;return jo(r,e)},Xo=(t,e)=>{if(Jo(e))return t.version;switch(t.prerelease=[],e){case"major":t.minor=0,t.patch=0;break;case"minor":t.patch=0;break}return t.format()},Jo=t=>t.startsWith("pre");is.exports=Ho});var as=m((_u,cs)=>{"use strict";var be=class{constructor(){this.max=1e3,this.map=new Map}get(e){let r=this.map.get(e);if(r!==void 0)return this.map.delete(e),this.map.set(e,r),r}delete(e){return this.map.delete(e)}set(e,r){if(!this.delete(e)&&r!==void 0){if(this.map.size>=this.max){let n=this.map.keys().next().value;this.delete(n)}this.map.set(e,r)}return this}};cs.exports=be});var L=m((Uu,hs)=>{"use strict";var Bo=/\s+/g,je=class t{constructor(e,r){if(r=Wo(r),e instanceof t)return e.loose===!!r.loose&&e.includePrerelease===!!r.includePrerelease?e:new t(e.raw,r);if(e instanceof Ge)return this.raw=e.value,this.set=[[e]],this.formatted=void 0,this;if(this.options=r,this.loose=!!r.loose,this.includePrerelease=!!r.includePrerelease,this.raw=e.trim().replace(Bo," "),this.set=this.raw.split("||").map(s=>this.parseRange(s.trim())).filter(s=>s.length),!this.set.length)throw new TypeError(`Invalid SemVer Range: ${this.raw}`);if(this.set.length>1){let s=this.set[0];if(this.set=this.set.filter(n=>!ls(n[0])),this.set.length===0)this.set=[s];else if(this.set.length>1){for(let n of this.set)if(n.length===1&&nc(n[0])){this.set=[n];break}}}this.formatted=void 0}get range(){if(this.formatted===void 0){this.formatted="";for(let e=0;e<this.set.length;e++){e>0&&(this.formatted+="||");let r=this.set[e];for(let s=0;s<r.length;s++)s>0&&(this.formatted+=" "),this.formatted+=r[s].toString().trim()}}return this.formatted}format(){return this.range}toString(){return this.range}parseRange(e){e=e.replace(sc,"");let s=((this.options.includePrerelease&&tc)|(this.options.loose&&rc))+":"+e,n=us.get(s);if(n)return n;let i=this.options.loose,o=i?N[T.HYPHENRANGELOOSE]:N[T.HYPHENRANGE];e=e.replace(o,mc(this.options.includePrerelease)),w("hyphen replace",e),e=e.replace(N[T.COMPARATORTRIM],Qo),w("comparator trim",e),e=e.replace(N[T.TILDETRIM],Zo),w("tilde trim",e),e=e.replace(N[T.CARETTRIM],ec),w("caret trim",e);let a=e.split(" ").map(h=>ic(h,this.options)).join(" ").split(/\s+/).map(h=>pc(h,this.options));i&&(a=a.filter(h=>(w("loose invalid filter",h,this.options),!!h.match(N[T.COMPARATORLOOSE])))),w("range list",a);let c=new Map,u=a.map(h=>new Ge(h,this.options));for(let h of u){if(ls(h))return[h];c.set(h.value,h)}c.size>1&&c.has("")&&c.delete("");let l=[...c.values()];return us.set(s,l),l}intersects(e,r){if(!(e instanceof t))throw new TypeError("a Range is required");return this.set.some(s=>fs(s,r)&&e.set.some(n=>fs(n,r)&&s.every(i=>n.every(o=>i.intersects(o,r)))))}test(e){if(!e)return!1;if(typeof e=="string")try{e=new zo(e,this.options)}catch{return!1}for(let r=0;r<this.set.length;r++)if(Ec(this.set[r],e,this.options))return!0;return!1}};hs.exports=je;var Yo=as(),us=new Yo,Wo=Z(),Ge=J(),w=V(),zo=y(),{safeRe:N,src:Ko,t:T,comparatorTrimReplace:Qo,tildeTrimReplace:Zo,caretTrimReplace:ec}=G(),{FLAG_INCLUDE_PRERELEASE:tc,FLAG_LOOSE:rc}=j(),sc=new RegExp(Ko[T.BUILD],"g"),ls=t=>t.value==="<0.0.0-0",nc=t=>t.value==="",fs=(t,e)=>{let r=!0,s=t.slice(),n=s.pop();for(;r&&s.length;)r=s.every(i=>n.intersects(i,e)),n=s.pop();return r},ic=(t,e)=>(t=t.replace(N[T.BUILD],""),w("comp",t,e),t=uc(t,e),w("caret",t),t=cc(t,e),w("tildes",t),t=fc(t,e),w("xrange",t),t=dc(t,e),w("stars",t),t),S=t=>!t||t.toLowerCase()==="x"||t==="*",oc=(t,e,r)=>S(t)&&!S(e)||S(e)&&r&&!S(r),cc=(t,e)=>t.trim().split(/\s+/).map(r=>ac(r,e)).join(" "),ac=(t,e)=>{let r=e.loose?N[T.TILDELOOSE]:N[T.TILDE],s=e.includePrerelease?"-0":"";return t.replace(r,(n,i,o,a,c)=>{w("tilde",t,n,i,o,a,c);let u;return S(i)?u="":S(o)?u=`>=${i}.0.0${s} <${+i+1}.0.0-0`:S(a)?u=`>=${i}.${o}.0${s} <${i}.${+o+1}.0-0`:c?(w("replaceTilde pr",c),u=`>=${i}.${o}.${a}-${c} <${i}.${+o+1}.0-0`):u=`>=${i}.${o}.${a} <${i}.${+o+1}.0-0`,w("tilde return",u),u})},uc=(t,e)=>t.trim().split(/\s+/).map(r=>lc(r,e)).join(" "),lc=(t,e)=>{w("caret",t,e);let r=e.loose?N[T.CARETLOOSE]:N[T.CARET],s=e.includePrerelease?"-0":"";return t.replace(r,(n,i,o,a,c)=>{w("caret",t,n,i,o,a,c);let u;return S(i)?u="":S(o)?u=`>=${i}.0.0${s} <${+i+1}.0.0-0`:S(a)?i==="0"?u=`>=${i}.${o}.0${s} <${i}.${+o+1}.0-0`:u=`>=${i}.${o}.0${s} <${+i+1}.0.0-0`:c?(w("replaceCaret pr",c),i==="0"?o==="0"?u=`>=${i}.${o}.${a}-${c} <${i}.${o}.${+a+1}-0`:u=`>=${i}.${o}.${a}-${c} <${i}.${+o+1}.0-0`:u=`>=${i}.${o}.${a}-${c} <${+i+1}.0.0-0`):(w("no pr"),i==="0"?o==="0"?u=`>=${i}.${o}.${a} <${i}.${o}.${+a+1}-0`:u=`>=${i}.${o}.${a} <${i}.${+o+1}.0-0`:u=`>=${i}.${o}.${a} <${+i+1}.0.0-0`),w("caret return",u),u})},fc=(t,e)=>(w("replaceXRanges",t,e),t.split(/\s+/).map(r=>hc(r,e)).join(" ")),hc=(t,e)=>{t=t.trim();let r=e.loose?N[T.XRANGELOOSE]:N[T.XRANGE];return t.replace(r,(s,n,i,o,a,c)=>{if(w("xRange",t,s,n,i,o,a,c),oc(i,o,a))return t;let u=S(i),l=u||S(o),h=l||S(a),E=h;return n==="="&&E&&(n=""),c=e.includePrerelease?"-0":"",u?n===">"||n==="<"?s="<0.0.0-0":s="*":n&&E?(l&&(o=0),a=0,n===">"?(n=">=",l?(i=+i+1,o=0,a=0):(o=+o+1,a=0)):n==="<="&&(n="<",l?i=+i+1:o=+o+1),n==="<"&&(c="-0"),s=`${n+i}.${o}.${a}${c}`):l?s=`>=${i}.0.0${c} <${+i+1}.0.0-0`:h&&(s=`>=${i}.${o}.0${c} <${i}.${+o+1}.0-0`),w("xRange return",s),s})},dc=(t,e)=>(w("replaceStars",t,e),t.trim().replace(N[T.STAR],"")),pc=(t,e)=>(w("replaceGTE0",t,e),t.trim().replace(N[e.includePrerelease?T.GTE0PRE:T.GTE0],"")),mc=t=>(e,r,s,n,i,o,a,c,u,l,h,E)=>(S(s)?r="":S(n)?r=`>=${s}.0.0${t?"-0":""}`:S(i)?r=`>=${s}.${n}.0${t?"-0":""}`:o?r=`>=${r}`:r=`>=${r}${t?"-0":""}`,S(u)?c="":S(l)?c=`<${+u+1}.0.0-0`:S(h)?c=`<${u}.${+l+1}.0-0`:E?c=`<=${u}.${l}.${h}-${E}`:t?c=`<${u}.${l}.${+h+1}-0`:c=`<=${c}`,`${r} ${c}`.trim()),Ec=(t,e,r)=>{for(let s=0;s<t.length;s++)if(!t[s].test(e))return!1;if(e.prerelease.length&&!r.includePrerelease){for(let s=0;s<t.length;s++)if(w(t[s].semver),t[s].semver!==Ge.ANY&&t[s].semver.prerelease.length>0){let n=t[s].semver;if(n.major===e.major&&n.minor===e.minor&&n.patch===e.patch)return!0}return!1}return!0}});var J=m((bu,$s)=>{"use strict";var B=Symbol("SemVer ANY"),Ve=class t{static get ANY(){return B}constructor(e,r){if(r=ds(r),e instanceof t){if(e.loose===!!r.loose)return e;e=e.value}e=e.trim().split(/\s+/).join(" "),He("comparator",e,r),this.options=r,this.loose=!!r.loose,this.parse(e),this.semver===B?this.value="":this.value=this.operator+this.semver.version,He("comp",this)}parse(e){let r=this.options.loose?ps[ms.COMPARATORLOOSE]:ps[ms.COMPARATOR],s=e.match(r);if(!s)throw new TypeError(`Invalid comparator: ${e}`);this.operator=s[1]!==void 0?s[1]:"",this.operator==="="&&(this.operator=""),s[2]?this.semver=new Es(s[2],this.options.loose):this.semver=B}toString(){return this.value}test(e){if(He("Comparator.test",e,this.options.loose),this.semver===B||e===B)return!0;if(typeof e=="string")try{e=new Es(e,this.options)}catch{return!1}return Me(e,this.operator,this.semver,this.options)}intersects(e,r){if(!(e instanceof t))throw new TypeError("a Comparator is required");return this.operator===""?this.value===""?!0:new gs(e.value,r).test(this.value):e.operator===""?e.value===""?!0:new gs(this.value,r).test(e.semver):(r=ds(r),r.includePrerelease&&(this.value==="<0.0.0-0"||e.value==="<0.0.0-0")||!r.includePrerelease&&(this.value.startsWith("<0.0.0")||e.value.startsWith("<0.0.0"))?!1:!!(this.operator.startsWith(">")&&e.operator.startsWith(">")||this.operator.startsWith("<")&&e.operator.startsWith("<")||this.semver.version===e.semver.version&&this.operator.includes("=")&&e.operator.includes("=")||Me(this.semver,"<",e.semver,r)&&this.operator.startsWith(">")&&e.operator.startsWith("<")||Me(this.semver,">",e.semver,r)&&this.operator.startsWith("<")&&e.operator.startsWith(">")))}};$s.exports=Ve;var ds=Z(),{safeRe:ps,t:ms}=G(),Me=Ue(),He=V(),Es=y(),gs=L()});var Y=m((ju,ws)=>{"use strict";var gc=L(),$c=(t,e,r)=>{try{e=new gc(e,r)}catch{return!1}return e.test(t)};ws.exports=$c});var Is=m((Gu,Rs)=>{"use strict";var wc=L(),Rc=(t,e)=>new wc(t,e).set.map(r=>r.map(s=>s.value).join(" ").trim().split(" "));Rs.exports=Rc});var ys=m((Mu,Ss)=>{"use strict";var Ic=y(),Sc=L(),yc=(t,e,r)=>{let s=null,n=null,i=null;try{i=new Sc(e,r)}catch{return null}return t.forEach(o=>{i.test(o)&&(!s||n.compare(o)===-1)&&(s=o,n=new Ic(s,r))}),s};Ss.exports=yc});var Ns=m((Hu,Ts)=>{"use strict";var Tc=y(),Nc=L(),Ac=(t,e,r)=>{let s=null,n=null,i=null;try{i=new Nc(e,r)}catch{return null}return t.forEach(o=>{i.test(o)&&(!s||n.compare(o)===1)&&(s=o,n=new Tc(s,r))}),s};Ts.exports=Ac});var Os=m((Vu,Ls)=>{"use strict";var Xe=y(),Lc=L(),As=X(),Oc=(t,e)=>{t=new Lc(t,e);let r=new Xe("0.0.0");if(t.test(r)||(r=new Xe("0.0.0-0"),t.test(r)))return r;r=null;for(let s=0;s<t.set.length;++s){let n=t.set[s],i=null;n.forEach(o=>{let a=new Xe(o.semver.version);switch(o.operator){case">":a.prerelease.length===0?a.patch++:a.prerelease.push(0),a.raw=a.format();case"":case">=":(!i||As(a,i))&&(i=a);break;case"<":case"<=":break;default:throw new Error(`Unexpected operation: ${o.operator}`)}}),i&&(!r||As(r,i))&&(r=i)}return r&&t.test(r)?r:null};Ls.exports=Oc});var vs=m((Xu,Cs)=>{"use strict";var Cc=L(),vc=(t,e)=>{try{return new Cc(t,e).range||"*"}catch{return null}};Cs.exports=vc});var le=m((Ju,Fs)=>{"use strict";var qc=y(),Ps=J(),{ANY:xc}=Ps,Pc=L(),Fc=Y(),qs=X(),xs=ie(),kc=ce(),Dc=oe(),_c=(t,e,r,s)=>{t=new qc(t,s),e=new Pc(e,s);let n,i,o,a,c;switch(r){case">":n=qs,i=kc,o=xs,a=">",c=">=";break;case"<":n=xs,i=Dc,o=qs,a="<",c="<=";break;default:throw new TypeError('Must provide a hilo val of "<" or ">"')}if(Fc(t,e,s))return!1;for(let u=0;u<e.set.length;++u){let l=e.set[u],h=null,E=null;if(l.forEach(f=>{f.semver===xc&&(f=new Ps(">=0.0.0")),h=h||f,E=E||f,n(f.semver,h.semver,s)?h=f:o(f.semver,E.semver,s)&&(E=f)}),h.operator===a||h.operator===c||(!E.operator||E.operator===a)&&i(t,E.semver))return!1;if(E.operator===c&&o(t,E.semver))return!1}return!0};Fs.exports=_c});var Ds=m((Bu,ks)=>{"use strict";var Uc=le(),bc=(t,e,r)=>Uc(t,e,">",r);ks.exports=bc});var Us=m((Yu,_s)=>{"use strict";var jc=le(),Gc=(t,e,r)=>jc(t,e,"<",r);_s.exports=Gc});var Gs=m((Wu,js)=>{"use strict";var bs=L(),Mc=(t,e,r)=>(t=new bs(t,r),e=new bs(e,r),t.intersects(e,r));js.exports=Mc});var Hs=m((zu,Ms)=>{"use strict";var Hc=Y(),Vc=A();Ms.exports=(t,e,r)=>{let s=[],n=null,i=null,o=t.sort((l,h)=>Vc(l,h,r));for(let l of o)Hc(l,e,r)?(i=l,n||(n=l)):(i&&s.push([n,i]),i=null,n=null);n&&s.push([n,null]);let a=[];for(let[l,h]of s)l===h?a.push(l):!h&&l===o[0]?a.push("*"):h?l===o[0]?a.push(`<=${h}`):a.push(`${l} - ${h}`):a.push(`>=${l}`);let c=a.join(" || "),u=typeof e.raw=="string"?e.raw:String(e);return c.length<u.length?c:e}});var Ws=m((Ku,Ys)=>{"use strict";var Vs=L(),Ye=J(),{ANY:Je}=Ye,Be=Y(),We=A(),Xc=(t,e,r={})=>{if(t===e)return!0;t=new Vs(t,r),e=new Vs(e,r);let s=!1;e:for(let n of t.set){for(let i of e.set){let o=Bc(n,i,r);if(s=s||o!==null,o)continue e}if(s)return!1}return!0},Jc=[new Ye(">=0.0.0-0")],Xs=[new Ye(">=0.0.0")],Bc=(t,e,r)=>{if(t===e)return!0;if(t.length===1&&t[0].semver===Je){if(e.length===1&&e[0].semver===Je)return!0;r.includePrerelease?t=Jc:t=Xs}if(e.length===1&&e[0].semver===Je){if(r.includePrerelease)return!0;e=Xs}let s=new Set,n,i;for(let f of t)f.operator===">"||f.operator===">="?n=Js(n,f,r):f.operator==="<"||f.operator==="<="?i=Bs(i,f,r):s.add(f.semver);if(s.size>1)return null;let o;if(n&&i){if(o=We(n.semver,i.semver,r),o>0)return null;if(o===0&&(n.operator!==">="||i.operator!=="<="))return null}for(let f of s){if(n&&!Be(f,String(n),r)||i&&!Be(f,String(i),r))return null;for(let I of e)if(!Be(f,String(I),r))return!1;return!0}let a,c,u,l,h=i&&!r.includePrerelease&&i.semver.prerelease.length?i.semver:!1,E=n&&!r.includePrerelease&&n.semver.prerelease.length?n.semver:!1;h&&h.prerelease.length===1&&i.operator==="<"&&h.prerelease[0]===0&&(h=!1);for(let f of e){if(l=l||f.operator===">"||f.operator===">=",u=u||f.operator==="<"||f.operator==="<=",n){if(E&&f.semver.prerelease&&f.semver.prerelease.length&&f.semver.major===E.major&&f.semver.minor===E.minor&&f.semver.patch===E.patch&&(E=!1),f.operator===">"||f.operator===">="){if(a=Js(n,f,r),a===f&&a!==n)return!1}else if(n.operator===">="&&!f.test(n.semver))return!1}if(i){if(h&&f.semver.prerelease&&f.semver.prerelease.length&&f.semver.major===h.major&&f.semver.minor===h.minor&&f.semver.patch===h.patch&&(h=!1),f.operator==="<"||f.operator==="<="){if(c=Bs(i,f,r),c===f&&c!==i)return!1}else if(i.operator==="<="&&!f.test(i.semver))return!1}if(!f.operator&&(i||n)&&o!==0)return!1}return!(n&&u&&!i&&o!==0||i&&l&&!n&&o!==0||E||h)},Js=(t,e,r)=>{if(!t)return e;let s=We(t.semver,e.semver,r);return s>0?t:s<0||e.operator===">"&&t.operator===">="?e:t},Bs=(t,e,r)=>{if(!t)return e;let s=We(t.semver,e.semver,r);return s<0?t:s>0||e.operator==="<"&&t.operator==="<="?e:t};Ys.exports=Xc});var Zs=m((Qu,Qs)=>{"use strict";var ze=G(),zs=j(),Yc=y(),Ks=Pe(),Wc=q(),zc=Ir(),Kc=yr(),Qc=Ar(),Zc=Cr(),ea=qr(),ta=Pr(),ra=kr(),sa=_r(),na=A(),ia=Gr(),oa=Hr(),ca=ne(),aa=Br(),ua=Wr(),la=X(),fa=ie(),ha=De(),da=_e(),pa=oe(),ma=ce(),Ea=Ue(),ga=ns(),$a=os(),wa=J(),Ra=L(),Ia=Y(),Sa=Is(),ya=ys(),Ta=Ns(),Na=Os(),Aa=vs(),La=le(),Oa=Ds(),Ca=Us(),va=Gs(),qa=Hs(),xa=Ws();Qs.exports={parse:Wc,valid:zc,clean:Kc,inc:Qc,diff:Zc,major:ea,minor:ta,patch:ra,prerelease:sa,compare:na,rcompare:ia,compareLoose:oa,compareBuild:ca,sort:aa,rsort:ua,gt:la,lt:fa,eq:ha,neq:da,gte:pa,lte:ma,cmp:Ea,coerce:ga,truncate:$a,Comparator:wa,Range:Ra,satisfies:Ia,toComparators:Sa,maxSatisfying:ya,minSatisfying:Ta,minVersion:Na,validRange:Aa,outside:La,gtr:Oa,ltr:Ca,intersects:va,simplifyRange:qa,subset:xa,SemVer:Yc,re:ze.re,src:ze.src,tokens:ze.t,SEMVER_SPEC_VERSION:zs.SEMVER_SPEC_VERSION,RELEASE_TYPES:zs.RELEASE_TYPES,compareIdentifiers:Ks.compareIdentifiers,rcompareIdentifiers:Ks.rcompareIdentifiers}});var ln=m((Zu,un)=>{var x=require("fs"),O=require("path"),tn=ar(),k=Zs(),Ke=["dependencies","devDependencies","optionalDependencies","peerDependencies"];function rn(t){let e=new Map;for(let r of t){let s=typeof r=="string"&&r.match(/^((?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*)(?:@([^\r\n]+))?$/);if(!s)throw new Error(`Invalid npm dependency: ${String(r)}`);let[,n,i]=s,o=e.get(n);e.set(n,o&&i?Pa(n,o,i):i||o)}return e}function Pa(t,e,r){if(e===r)return e;let s=k.validRange(e),n=k.validRange(r);if(s&&n)try{if(k.subset(n,s))return r;if(k.subset(s,n))return e}catch{}throw new Error(`Conflicting registry versions for ${t}: ${e} and ${r}`)}function sn(t,e){let r=typeof t=="string"&&k.validRange(t),s=k.validRange(e);if(!r||!s)return!1;try{return k.subset(r,s)}catch{return!1}}function nn(t,e){let r=rn(e);if(r.size===0)return;let s=O.join(t,"package.json"),n=JSON.parse(x.readFileSync(s,"utf8"));for(let[i,o]of r){let a=Ke.find(u=>Object.hasOwn(n[u]||{},i))||"dependencies";n[a]||={};let c=n[a][i];n[a][i]=o?sn(c,o)?c:o:c||"latest"}x.writeFileSync(s,`${JSON.stringify(n,null,2)}
+`)}function fe(t){let e=[["pnpm-lock.yaml","pnpm"],["yarn.lock","yarn"],["bun.lock","bun"],["bun.lockb","bun"],["package-lock.json","npm"],["npm-shrinkwrap.json","npm"]];for(let r=O.resolve(t);;r=O.dirname(r)){let s=O.join(r,"package.json");if(x.existsSync(s)){let n=JSON.parse(x.readFileSync(s,"utf8")),i=String(n.packageManager||"").split("@")[0];if(["npm","pnpm","yarn","bun"].includes(i))return i}for(let[n,i]of e)if(x.existsSync(O.join(r,n)))return i;if(O.dirname(r)===r)return"npm"}}var en={npm:"npx",pnpm:"pnpm exec",yarn:"yarn",bun:"bunx"};function Fa(t,e=process.cwd()){let r;try{r=fe(e)}catch{r="npm"}return`${en[r]||en.npm} frontfriend ${t}`}function Qe(t,e){let r=rn(e);if(r.size===0)return[];let s=JSON.parse(x.readFileSync(O.join(t,"package.json"),"utf8")),n=[];for(let[i,o]of r){let a=Ke.find(c=>Object.hasOwn(s[c]||{},i));a&&(!o||sn(s[a][i],o))||n.push(o?`${i}@${o}`:i)}return n}function on(t,e){return[t==="npm"?"install":"add",...e]}function ka(t){return/^[\w@/.:^~=+-]+$/.test(t)?t:`'${t.replace(/'/g,"'\\''")}'`}function cn(t,e){let r=fe(t);return[r,...on(r,e)].map(ka).join(" ")}function an(t,e,{stdio:r="inherit"}={}){let s=Qe(t,e);if(s.length===0)return;let n=fe(t),i=tn.sync(n,on(n,s),{cwd:t,stdio:r});if(i.error||i.status!==0)throw nn(t,e),i.error||new Error(`${n} dependency installation failed with status ${i.status}. Dependencies were saved; run ${n} install.`)}function Da(t,e,{install:r=!0,stdio:s="inherit",log:n=console.log}={}){let i=Qe(t,e);if(i.length===0)return{missing:i,command:null,installed:!1};let o=cn(t,i);if(!r)return n(`\u{1F4E6} Component dependencies missing from package.json. Install them with:
+   ${o}`),{missing:i,command:o,installed:!1};n(`\u{1F4E6} Installing component dependencies: ${o}`);try{return an(t,i,{stdio:s}),{missing:i,command:o,installed:!0}}catch(a){return n(`\u26A0\uFE0F  Component dependencies were not installed: ${a.message}
+   Install them with:
+   ${o}`),{missing:i,command:o,installed:!1,error:a.message}}}function _a(t,e){for(let r=O.resolve(t);;r=O.dirname(r)){if(x.existsSync(O.join(r,"node_modules",e,"package.json")))return!0;if(O.dirname(r)===r)return!1}}function Ua(t,e,{install:r=!0,stdio:s="inherit",log:n=console.log}={}){let i=JSON.parse(x.readFileSync(O.join(t,"package.json"),"utf8"));if(!Ke.some(h=>Object.hasOwn(i[h]||{},e))||_a(t,e))return{installed:!1,command:null};let a=fe(t),c=`${a} install`;if(!r)return n(`\u{1F4E6} ${e} is in package.json but not installed. Install it with:
+   ${c}`),{installed:!1,command:c};n(`\u{1F4E6} Installing ${e}: ${c}`);let u=tn.sync(a,["install"],{cwd:t,stdio:s});if(!u.error&&u.status===0)return{installed:!0,command:c};let l=u.error?u.error.message:`${a} install failed with status ${u.status}`;return n(`\u26A0\uFE0F  ${e} was not installed: ${l}
+   Install it with:
+   ${c}`),{installed:!1,command:c,error:l}}un.exports={cliCommand:Fa,installDeclaredPackage:Ua,saveNpmDependencies:nn,installNpmDependencies:an,installMissingNpmDependencies:Da,missingNpmDependencies:Qe,npmInstallCommand:cn}});var Ze=require("https"),et=require("http"),{URL:H}=require("url"),{DEFAULT_API_URL:ba,ENV_VARS:he}=W(),{APIError:$}=we(),{postJson:fn,resolveAuthToken:ja}=dt(),{describeDesignSystemAccessError:el}=Rt(),{cliCommand:Ga}=ln(),M=()=>`Authentication required. Run \`${Ga("login")}\` to sign in.`;function de(t){let e=new H(t);if(e.username||e.password||e.protocol!=="https:"&&!(e.protocol==="http:"&&["localhost","127.0.0.1","[::1]"].includes(e.hostname)))throw new Error("Frontfriend API URLs require HTTPS except on localhost, without URL credentials");return e}function hn(t,e,r,s,n,i){let o,a=setTimeout(()=>{let l=new $("Frontfriend API request timed out",408,e);i(l),o?.destroy(l)},n);a.unref?.();let c=()=>clearTimeout(a),u=l=>{l.once("end",c),l.once("error",c),l.once("aborted",()=>{c(),i(new $("Frontfriend API response was interrupted",0,e))}),s(l)};try{return o=r?t.get(new H(e),{headers:{authorization:`Bearer ${r}`}},u):t.get(e,u),o.once("error",c),o}catch(l){throw c(),l}}function tt(t,e=""){let r=t.headers?.location||"";return t.statusCode===401||t.statusCode===403||t.statusCode>=300&&t.statusCode<400&&r.includes("/sign-in")||String(e).trim().startsWith("/sign-in")}function pe(t,e,r=""){if(tt(t,r)){let c=new $(M(),t.statusCode,e);if(t.statusCode===403)try{let u=r?JSON.parse(r):null;typeof u?.code=="string"&&(c.serverCode=u.code);let l=u?.error||u?.message;typeof l=="string"&&(c.serverMessage=l)}catch{}return c}let s=t.statusMessage,n,i,o;try{let c=r?JSON.parse(r):null;n=c?.code||c?.error?.code,i=c?.currentVersion,typeof c?.message=="string"&&(o=c.message),typeof c?.error=="string"?s=c.error:typeof c?.error?.message=="string"&&(s=c.error.message);let u=[...Array.isArray(c?.cssErrors||c?.error?.details?.cssErrors)?(c.cssErrors||c.error.details.cssErrors).slice(0,5).map(l=>`${l.property}: ${l.className}`):[],...Array.isArray(c?.schemaErrors||c?.error?.details?.schemaErrors)?(c.schemaErrors||c.error.details.schemaErrors).slice(0,5):[]];u.length>0&&(s=`${s} (${u.join("; ")})`)}catch{}let a=new $(`HTTP ${t.statusCode}: ${s}`,t.statusCode,e);return n&&(a.code=n),i&&(a.currentVersion=i),o&&(a.serverMessage=o),a}var rt=class{constructor(e,r={}){if(this.ffId=e,this.baseURL=r.baseURL||process.env[he.FF_API_URL]||ba,de(this.baseURL),this.timeoutMs=r.timeoutMs??3e4,this.writeTimeoutMs=r.timeoutMs??18e4,!Number.isFinite(this.timeoutMs)||this.timeoutMs<=0)throw new Error("API timeout must be positive");this.configuredAuthToken=r.authToken||null,this.authToken=null,this.skipCredentials=r.skipCredentials}async getAuthToken(){return process.env[he.FF_MACHINE_TOKEN]?(this.authToken=process.env[he.FF_MACHINE_TOKEN],this.authToken):(this.authToken=await ja({baseURL:this.baseURL,envToken:process.env[he.FF_AUTH_TOKEN],configuredToken:this.configuredAuthToken,skipCredentials:this.skipCredentials}),this.authToken)}async fetchJson(e,r={}){let s=de(e),n=await this.getAuthToken();if(n&&s.origin!==new H(this.baseURL).origin)throw new Error("Refusing to send Frontfriend credentials to another API origin");return new Promise((i,o)=>{let a=e.startsWith("https")?Ze:et;hn(a,e,n,c=>{let u="";if(c.statusCode>=300&&(c.statusCode<400||r.readErrorBody===!1)){c.resume?.(),o(pe(c,e));return}c.on("data",l=>{u+=l}),c.on("end",()=>{if(c.statusCode>=300){o(pe(c,e,u));return}try{let l=JSON.parse(u);r.returnHeaders?i({data:l,headers:c.headers}):i(l)}catch(l){if(tt(c,u)){o(new $(M(),c.statusCode,e));return}o(new $(`Invalid JSON response: ${l.message}`,c.statusCode,e))}}),c.on("error",l=>{o(new $(`Response error: ${l.message}`,c.statusCode,e))})},this.timeoutMs,o).on("error",c=>{o(new $(`Network error: ${c.message}`,0,e))})})}async fetchRaw(e){let r=de(e),s=await this.getAuthToken();if(s&&r.origin!==new H(this.baseURL).origin)throw new Error("Refusing to send Frontfriend credentials to another API origin");return new Promise((n,i)=>{let o=e.startsWith("https")?Ze:et;hn(o,e,s,a=>{let c="";if(a.statusCode>=300){a.resume?.(),i(pe(a,e));return}a.on("data",u=>{c+=u}),a.on("end",()=>{n(c)}),a.on("error",u=>{i(new $(`Response error: ${u.message}`,a.statusCode,e))})},this.timeoutMs,i).on("error",a=>{i(new $(`Network error: ${a.message}`,0,e))})})}async fetchProcessedTokens(e={}){let r=new H(`${this.baseURL}/api/design-systems/${this.ffId}/processed-tokens`);e.tag&&r.searchParams.append("tag",e.tag),e.release&&r.searchParams.append("release",e.release),e.version&&r.searchParams.append("version",e.version),r.searchParams.set("colorFormat","oklch");let s=r.toString(),n=await this.fetchJson(s,{returnHeaders:!0,readErrorBody:!0});return n.headers&&(n.data.versionMetadata={version:n.headers["x-frontfriend-version"],versionId:n.headers["x-frontfriend-version-id"],releaseId:n.headers["x-frontfriend-release-id"],tag:n.headers["x-frontfriend-tag"],cached:n.headers["x-frontfriend-cached"]==="true"}),n.data}async sendJson(e,r,s){let n=de(e),i=await this.getAuthToken();if(!i)throw new $(M(),401,e);if(n.origin!==new H(this.baseURL).origin)throw new Error("Refusing to send Frontfriend credentials to another API origin");return new Promise((o,a)=>{let c,u=()=>clearTimeout(c),l=e.startsWith("https")?Ze:et,h=s===void 0?"":JSON.stringify(s||{}),E=l.request({hostname:n.hostname,port:n.port,path:`${n.pathname}${n.search}`,method:r,headers:{"content-type":"application/json","content-length":Buffer.byteLength(h),...i?{authorization:`Bearer ${i}`}:{}}},f=>{f.once("end",u),f.once("error",v=>{u(),a(new $(`Response error: ${v.message}`,0,e))}),f.once("aborted",()=>{u(),a(new $("Frontfriend API response was interrupted",0,e))});let I="";f.on("data",v=>{I+=v}),f.on("end",()=>{if(f.statusCode>=300){a(pe(f,e,I));return}if(!I){o(null);return}try{o(JSON.parse(I))}catch(v){if(tt(f,I)){a(new $(M(),f.statusCode,e));return}a(new $(`Invalid JSON response: ${v.message}`,f.statusCode,e))}})});c=setTimeout(()=>{let f=new $("Frontfriend API request timed out",408,e);a(f),E.destroy(f)},this.writeTimeoutMs),c.unref?.(),E.on("error",f=>{u(),a(new $(`Network error: ${f.message}`,0,e))}),E.write(h),E.end()})}async pushComponentsConfig(e,r,s,n={}){let i=`${this.baseURL}/api/design-systems/${this.ffId}/components-config`;if(!n.expectedVersionId)throw new $("expectedVersionId is required",0,i);let o={authoredComponentsConfig:e,expectedVersionId:n.expectedVersionId};return typeof r=="string"&&r.length>0&&(o.customCss=r),typeof s=="string"&&s.length>0&&(o.iconLibrary=s),n.themeStudioRecipe&&typeof n.themeStudioRecipe=="object"&&(o.themeStudioRecipe=n.themeStudioRecipe),this.sendJson(i,"PUT",o)}async migrateComponents(e){let r=`${this.baseURL}/api/design-systems/${this.ffId}/migrate`;return this.sendJson(r,"POST",e)}async importShadcn(e){return this.sendJson(`${this.baseURL}/api/design-systems/${this.ffId}/shadcn/import`,"POST",e)}async fetchCurrentVersionId(e={}){let r=typeof e=="string"?{tag:e}:e,s=r.version?`version=${encodeURIComponent(r.version)}`:r.tag?`tag=${encodeURIComponent(r.tag)}`:"root=true",n=`${this.baseURL}/api/design-systems/${this.ffId}/processed-tokens?${s}`,i=await this.fetchJson(n,{returnHeaders:!0,readErrorBody:!0});this.currentBaseLibrary=i?.data?.baseLibrary||i?.data?.base;let o=i?.headers||{};return o["x-frontfriend-version-id"]||o["X-Frontfriend-Version-Id"]}async listMigrationSnapshots(){let e=`${this.baseURL}/api/design-systems/${this.ffId}/migrate/snapshots`;return this.fetchJson(e)}async getMigrationSnapshot(e){let r=`${this.baseURL}/api/design-systems/${this.ffId}/migrate/snapshots/${e}`;return this.fetchJson(r)}async fetchPlanMetadata(e={}){if(!e.framework||!e.primitive)throw new $("Entitlement lookup requires an explicit Project target.",400);let r=`${this.baseURL}/api/design-systems/${this.ffId}/entitlements?framework=${encodeURIComponent(e.framework)}&primitive=${encodeURIComponent(e.primitive)}`,s=await this.fetchJson(r);if(s?.schemaVersion!==1||!s.canonicalCatalogue)throw new $("Unsupported entitlement response.",502,r);if(s.canonicalCatalogue.unavailable)throw new $("Entitlement policy unavailable.",503,r);return{access:"granted",subscriptionPlan:s.workspace.subscriptionPlan,freshPrivateSelection:s.capabilities?.freshPrivateSelection===!0||s.capabilities?.privateConsumption===!0,canonicalComponents:s.canonicalCatalogue.components,enforceCatalogue:!0,revisionId:s.canonicalCatalogue.revisionId}}async fetchReleaseChannels(){return this.fetchJson(`${this.baseURL}/api/design-systems/${this.ffId}/releases`)}async resolveReleaseTag({reference:e,appName:r,fallback:s}={}){let n=new URLSearchParams(e?{reference:e}:{app:r});return!e&&s&&n.set("fallback",s),this.sendJson(`${this.baseURL}/api/design-systems/${this.ffId}/workflow?${n}`,"GET")}async resolveContractRelease(e){let r=await this.fetchJson(`${this.baseURL}/api/design-systems/${this.ffId}/releases/${encodeURIComponent(e)}/resolve?runtime=sdk&contracts_only=true`);if(r.contractsOnly!==!0||r.runtime!=="sdk")throw new $("Upgrade the server before adopting contracts without a Project target.",400);return r}async resolveRelease(e,r){if(!r?.framework||!r?.primitive)throw new $("Release resolution requires an explicit Project target.",400);let s=`${this.baseURL}/api/design-systems/${this.ffId}/releases/${encodeURIComponent(e)}/resolve?runtime=sdk&framework=${encodeURIComponent(r.framework)}&primitive=${encodeURIComponent(r.primitive)}`,n=await this.fetchJson(s);if(n.runtime!=="sdk")throw new $("Upgrade the Frontfriend platform before adopting SDK Releases.",400,s);return n}async syncApplicationTarget(e,r={}){let s=await this.getAuthToken();if(!s)throw new $(M(),401);return fn(`${this.baseURL}/api/apps/sync`,{ffId:this.ffId,name:e.name,adopt:e.adopt,runtime:"sdk",releaseTagId:e.releaseTagId,expectedReleaseTagId:e.expectedReleaseTagId,framework:e.framework,primitive:e.primitive,dryRun:!!r.dryRun,contractsOnly:!!e.contractsOnly},s)}async publishPrivateComponent(e){let r=await this.getAuthToken();if(!r)throw new $(M(),401);try{return await fn(`${this.baseURL}/api/design-systems/${this.ffId}/components`,e,r)}catch(s){throw typeof s.body?.code=="string"&&(s.code=s.body.code),typeof s.body?.correlationId=="string"&&(s.correlationId=s.body.correlationId),s}}async authorizeEject(e={}){return this.sendJson(`${this.baseURL}/api/design-systems/${this.ffId}/eject`,"POST",e)}};module.exports={APIClient:rt};

package/dist/lib/core/application-adoption-lock.js

@@ -0,0 +1,6 @@
+var _=Object.create;var m=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var L=Object.getOwnPropertyNames;var $=Object.getPrototypeOf,N=Object.prototype.hasOwnProperty;var V=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports),F=(t,e)=>{for(var r in e)m(t,r,{get:e[r],enumerable:!0})},v=(t,e,r,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of L(e))!N.call(t,n)&&n!==r&&m(t,n,{get:()=>e[n],enumerable:!(s=M(e,n))||s.enumerable});return t};var H=(t,e,r)=>(r=t!=null?_($(t)):{},v(e||!t||!t.__esModule?m(r,"default",{value:t,enumerable:!0}):r,t)),J=t=>v(m({},"__esModule",{value:!0}),t);var O=V((ae,P)=>{var u=require("fs"),l=require("path"),{createHash:T}=require("crypto"),G=".frontfriend/design",q=".frontfriend/.gitignore";function W(){return["# Managed by `frontfriend design sync`.","# audit/ holds regenerable capture artifacts (screenshots, probes) \u2014 never commit.","# design/ is the committed read-only contract mirror \u2014 keep it tracked.","audit/","# design-working/ is an explicit, disposable working preview.","design-working/",""].join(`
+`)}function f(t){return typeof t!="string"||t.length===0||t.startsWith("/")||t.includes("\\")?!1:t.split("/").every(e=>e!==""&&e!=="."&&e!=="..")}function b(t){let e=t.body.endsWith(`
+`)?t.body.slice(0,-1):t.body;return["<!-- frontfriend design mirror \u2014 DO NOT EDIT (overwritten by `frontfriend design sync`)",`slug: ${t.slug}`,`maturity: ${t.maturity}`,`implemented: ${t.implemented}`,`implementation: ${t.implementation||"unknown"}`,`version: ${t.version}`,"-->","",e,""].join(`
+`)}function A(t){return[`# Frontfriend design mirror \u2014 ${t.name}`,"","This directory is a READ-ONLY mirror of the Design System design contracts",`(Design System "${t.name}", ff-id \`${t.ff_id}\`) managed on the Frontfriend platform.`,"","Every file here is overwritten by `frontfriend design sync`. Do not edit by","hand: local changes are discarded on the next sync, and files whose contract","was removed upstream are deleted. Edit contracts on the platform instead.",""].join(`
+`)}function E({design_system:t,contracts:e}){let r=[...e].filter(n=>f(n.slug)).sort((n,a)=>n.kind.localeCompare(a.kind)||n.slug.localeCompare(a.slug)),s={"README.md":A(t)};for(let n of r)s[n.slug]=b(n);return s}function I(t,e){let r={};for(let[n,a]of Object.entries(t))e[n]!==a&&(r[n]=a);let s=Object.keys(e).filter(n=>!(n in t)).sort();return{writes:r,deletes:s}}var R=t=>T("sha256").update(t).digest("hex");function X(t){return Object.fromEntries(Object.entries(t).filter(([e])=>e!=="README.md"&&f(e)).map(([e,r])=>[e,R(r)]))}function K(t,e){let r=()=>{throw new Error("Invalid or incomplete mirror response. No local files were changed; retry sync.")};(!t||typeof t.design_system?.ff_id!="string"||typeof t.design_system?.name!="string"||!Array.isArray(t.contracts))&&r();let s=new Map;for(let o of t.contracts)(!o||!f(o.slug)||o.slug==="README.md"||typeof o.body!="string"||typeof o.kind!="string"||typeof o.maturity!="string"||typeof o.implemented!="boolean"||!Number.isSafeInteger(o.version)||o.version<1||s.has(o.slug))&&r(),s.set(o.slug,b(o));if(t.protocol===void 0)return t.manifest!==void 0&&r(),I(E(t),e);(t.protocol!==1||!Array.isArray(t.manifest))&&r();let n={"README.md":A(t.design_system)},a=new Set;for(let o of t.manifest){(!o||!f(o.slug)||o.slug==="README.md"||!/^[a-f0-9]{64}$/.test(o.hash)||a.has(o.slug))&&r(),a.add(o.slug);let i=s.get(o.slug)??e[o.slug];(typeof i!="string"||R(i)!==o.hash)&&r(),Object.defineProperty(n,o.slug,{value:i,enumerable:!0})}return[...s.keys()].some(o=>!a.has(o))&&r(),I(n,e)}function Q(t){let e={};if(!u.existsSync(t))return e;let r=s=>{for(let n of u.readdirSync(s,{withFileTypes:!0})){let a=l.join(s,n.name);if(n.isDirectory())r(a);else if(n.isFile()){let o=l.relative(t,a).split(l.sep).join("/");e[o]=u.readFileSync(a,"utf8")}}};return r(t),e}function Y(t,e){for(let[r,s]of Object.entries(e.writes)){let n=l.join(t,...r.split("/"));u.mkdirSync(l.dirname(n),{recursive:!0}),u.writeFileSync(n,s)}for(let r of e.deletes){let s=l.join(t,...r.split("/"));u.rmSync(s,{force:!0});let n=l.dirname(s),a=l.resolve(t);for(;l.resolve(n)!==a&&u.existsSync(n)&&u.readdirSync(n).length===0;)u.rmdirSync(n),n=l.dirname(n)}}function B(t,e,r){if(!e||t.contract_selection!==1||t.selection?.design_snapshot_id!==e.snapshotId||t.selection?.digest!==e.snapshotDigest||t.app?.id!==e.appId||t.design_system?.ff_id!==r)throw new Error("Contract mirror does not match the selected App snapshot.");let s=[...e.sharedContracts,...e.contracts],n=t.manifest??t.contracts,a=new Map(s.map(o=>[o.slug,o]));if(!Array.isArray(n)||!Array.isArray(t.contracts)||n.length!==s.length||new Set(n.map(o=>o.slug)).size!==s.length||n.some(o=>!a.has(o.slug)))throw new Error("Contract mirror inventory does not match the snapshot.");for(let o of t.contracts){let i=a.get(o.slug);if(!i||o.revision_id!==i.revisionId||o.digest!==i.digest||o.version!==i.version||o.kind!==i.kind)throw new Error("Contract body identity does not match its snapshot pin.");let p={appId:e.contracts.some(d=>d.slug===i.slug)?e.appId:null,body:o.body,designSystemId:e.designSystemId,kind:o.kind,maturity:o.maturity,slug:o.slug,title:o.title};if(T("sha256").update(JSON.stringify(p)).digest("hex")!==i.digest)throw new Error("Contract content does not match its immutable digest.")}return s}P.exports={validatePinnedMirror:B,MIRROR_DIR:G,FRONTFRIEND_GITIGNORE_PATH:q,renderFrontfriendGitignore:W,isSafeSlug:f,renderContractFile:b,renderMirrorReadme:A,buildMirrorTree:E,planMirrorSync:I,hashMirrorFile:R,knownMirrorHashes:X,planMirrorResponse:K,readMirrorTree:Q,applyMirrorPlan:Y}});var ne={};F(ne,{adoptionDigest:()=>x,normalizeLock:()=>j,parseApplicationLock:()=>ee,serializeApplicationLock:()=>te,sortedObject:()=>C});module.exports=J(ne);var z=Object.freeze([Object.freeze({framework:"react",primitive:"radix"}),Object.freeze({framework:"react",primitive:"base"}),Object.freeze({framework:"react",primitive:"aria"}),Object.freeze({framework:"vue",primitive:"reka"})]),U=new Set(z.map(t=>`${t.framework}/${t.primitive}`)),w=class extends Error{constructor(e,r,s={}){super(r),this.name="ProjectTargetError",this.code=e,Object.assign(this,s)}};function h(t,e="Project target"){let r=t,s=typeof r?.framework=="string"?r.framework.trim().toLowerCase():"",n=typeof r?.primitive=="string"?r.primitive.trim().toLowerCase():"",a=`${s}/${n}`;if(!s||!n||!U.has(a))throw new w("INVALID_PROJECT_TARGET",`${e} must be exactly one of react/radix, react/base, react/aria, or vue/reka; received ${a}.`,{framework:s||null,primitive:n||null});return{framework:s,primitive:n}}var c=class extends Error{constructor(r,s=[]){super(r);this.code="ADOPTION_CONFLICT";this.name="AdoptionConflictError",this.conflicts=s}};var S=H(require("node:crypto"));function k(t){return S.default.createHash("sha256").update(Buffer.from(t)).digest("hex")}var{isSafeSlug:Z}=O();function C(t){return Object.fromEntries(Object.entries(t).sort(([e],[r])=>e.localeCompare(r)).map(([e,r])=>[e,r&&typeof r=="object"&&!Array.isArray(r)?{...r,...Array.isArray(r.files)?{files:[...r.files].sort((s,n)=>s.path.localeCompare(n.path))}:{}}:r]))}function y(t){return Array.isArray(t)?t.map(y):t&&typeof t=="object"?Object.fromEntries(Object.keys(t).filter(e=>e!=="adoptionDigest").sort().map(e=>[e,y(t[e])])):t}function x(t){return k(JSON.stringify(y(t)))}function j(t){let e=t;if(!e||![1,2,3].includes(Number(e.schemaVersion))||typeof e.components!="object"||e.components===null)throw new c("Unsupported or malformed frontfriend.lock.json.");let r=Object.fromEntries(Object.entries(e.components).map(([i,p])=>{let g=p;if(!g||!["canonical","private"].includes(String(g.source))||typeof g.versionId!="string"||typeof g.semver!="string")throw new c(`Unsupported source kind for ${i}.`);return[i,g]})),s={releaseId:e.releaseId==null?null:String(e.releaseId),tokenVersionId:String(e.tokenVersionId),projectTarget:e.schemaVersion===3&&e.projectTarget===null&&Object.keys(r).length===0?null:h(e.projectTarget,"Application lock target"),components:r};for(let i of Object.values(r)){if(!i.projectTarget)continue;let p=h(i.projectTarget,"Component adoption target");if(!s.projectTarget||p.framework!==s.projectTarget.framework||p.primitive!==s.projectTarget.primitive)throw new c("Component adoption belongs to another Project target.")}if(e.schemaVersion===1)return{...s,projectTarget:h(e.projectTarget,"Application lock target"),schemaVersion:1,components:r};if(typeof e.designSystemId!="string"||!e.designSystemId||typeof e.ffId!="string"||!e.ffId||typeof e.adoptionDigest!="string"||!e.adoptionDigest||typeof e.tokenSourceReleaseId!="string"||!e.tokenSourceReleaseId||!Array.isArray(e.sourceReleaseIds))throw new c("Malformed v2 Frontfriend adoption snapshot.");let n={...s,schemaVersion:e.schemaVersion===3?3:2,...e.schemaVersion===3?{design:e.design}:{},designSystemId:e.designSystemId,ffId:e.ffId,...e.baseLibrary!==void 0?{baseLibrary:e.baseLibrary}:{},...e.baseProvenance!==void 0?{baseProvenance:e.baseProvenance}:{},...e.replacements!==void 0?{replacements:e.replacements}:{},adoptionDigest:e.adoptionDigest,tokenSourceReleaseId:e.tokenSourceReleaseId,sourceReleaseIds:[...new Set(e.sourceReleaseIds.map(String))].sort(),components:r};if(n.baseLibrary!==void 0&&!["frontfriend","shadcn"].includes(n.baseLibrary))throw new c("Unsupported base library in Application lock.");if(n.schemaVersion===3){let i=n.design;if(!i||i.designSystemId!==n.designSystemId||!i.appId||!i.snapshotId||!i.sharedSourceReleaseId||!Array.isArray(i.contracts)||!Array.isArray(i.sharedContracts))throw new c("Malformed Application design adoption.");let p=[...i.sharedContracts,...i.contracts];if(new Set(p.map(d=>d.slug)).size!==p.length||p.some(d=>d.designSystemId!==n.designSystemId||!d.revisionId||!d.contractId||!Z(d.slug)||!d.slug.endsWith(".md")||!Number.isInteger(d.version)||d.version<1||!/^[a-f0-9]{64}$/.test(d.digest)))throw new c("Invalid contract revision pins in the Application lock.");if(i.sharedContracts.some(d=>!["guidelines","design-context","guideline-chapter","layout","pattern"].includes(d.kind))||i.contracts.some(d=>!["app-context","page"].includes(d.kind)))throw new c("Contract pins have invalid shared or App ownership.");if(k(JSON.stringify(y({schemaVersion:1,appId:i.appId,sharedSourceReleaseId:i.sharedSourceReleaseId,contracts:[...i.contracts].sort((d,D)=>d.slug.localeCompare(D.slug))})))!==i.snapshotDigest)throw new c("Application design snapshot digest does not match its manifest.")}else if(e.design!==void 0)throw new c("Contract pins require a schema version 3 Application lock.");let a=Object.values(n.components).map(i=>{if(typeof i.sourceReleaseId!="string"||!i.sourceReleaseId)throw new c("Every v2 component adoption must identify its immutable source Release.");return i.sourceReleaseId}),o=[...new Set([n.tokenSourceReleaseId,...a,...n.design?[n.design.sharedSourceReleaseId]:[]])].sort();if(JSON.stringify(o)!==JSON.stringify(n.sourceReleaseIds))throw new c("The adoption source Releases do not match the token and component provenance.");if(n.releaseId&&(o.length!==1||o[0]!==n.releaseId))throw new c("A lock may reference a Release only when its complete closure matches that Release.");if(x(n)!==n.adoptionDigest)throw new c("The adoption snapshot digest does not match its manifest.");return n}function ee(t){try{return j(typeof t=="string"?JSON.parse(t):t)}catch(e){throw e instanceof c?e:new c(`Invalid frontfriend.lock.json: ${e instanceof Error?e.message:String(e)}`)}}function te(t){let e=j(t);return`${JSON.stringify({...e,components:C(e.components)},null,2)}
+`}0&&(module.exports={adoptionDigest,normalizeLock,parseApplicationLock,serializeApplicationLock,sortedObject});