@gjsify/cli 0.4.10 → 0.4.11

package/dist/cli.gjs.mjs

@@ -792,4 +792,5 @@ jobs:
 `)})}Be(),gx();const wE={command:`workspace <name> <script> [args..]`,description:"Run a workspace script (`yarn workspace <name> run <script>` equivalent).",builder:n=>n.positional(`name`,{description:"Workspace name (matches package.json `name` field).",type:`string`,demandOption:!0}).positional(`script`,{description:`Script name to run inside that workspace.`,type:`string`,demandOption:!0}).positional(`args`,{description:`Extra arguments forwarded to the script.`,type:`string`,array:!0}),handler:async n=>{let a=discoverWorkspaces(findWorkspaceRoot(process.cwd())??process.cwd()),S=a.find(a=>a.name===n.name);S||(ze.error(`gjsify workspace: no workspace named "${n.name}" — discovered ${a.length} workspace(s)`),process.exit(1)),typeof(S.manifest.scripts??{})[n.script]!=`string`&&(ze.error(`gjsify workspace: workspace "${n.name}" has no script "${n.script}"`),process.exit(1));let C=detectPackageManager(),N=C===`gjsify`?[`run`,n.script,...n.args??[]]:[`run`,n.script,...n.args&&n.args.length>0?[`--`,...n.args]:[]];await new Promise((n,a)=>{let F=spawn(C,N,{cwd:S.location,stdio:`inherit`,env:process.env});F.on(`close`,S=>{S===0?n():a(Error(`${C} ${N.join(` `)} exited with code ${S}`))}),F.on(`error`,a)}).catch(n=>{ze.error(n.message),process.exit(1)}),process.exit(0)}};function detectPackageManager(){let n=process.env.npm_config_user_agent??``;return n.startsWith(`yarn/`)?`yarn`:n.startsWith(`gjsify/`)?`gjsify`:`npm`}Be(),Rs(),Ma(),qo(),mE();const TE={command:`pack [path]`,description:`Produce an npm-compatible .tgz tarball for the workspace at <path> (default: cwd). Rewrites workspace:^/~/* deps to resolved versions.`,builder:n=>n.positional(`path`,{description:`Workspace path (default: cwd).`,type:`string`}).option(`pack-destination`,{description:`Directory to write the tarball into. Default: workspace cwd.`,type:`string`}).option(`json`,{description:"Emit pack metadata as JSON on stdout (mirrors `npm pack --json`).",type:`boolean`,default:!1}).option(`dry-run`,{description:`Compute everything but do not write the .tgz.`,type:`boolean`,default:!1}),handler:async n=>{let a=await packWorkspace(No(n.path??process.cwd()),{destination:n[`pack-destination`],dryRun:n[`dry-run`]===!0});n.json?process.stdout.write(`${JSON.stringify([a],null,2)}\n`):process.stdout.write(`${a.filename}\n`)}};async function packWorkspace(n,a={}){let S=Io(n,`package.json`);if(!existsSync(S))throw Error(`gjsify pack: no package.json at ${n}`);let C=readFileSync(S,`utf-8`),N=JSON.parse(C),F=typeof N.name==`string`?N.name:``,I=typeof N.version==`string`?N.version:`0.0.0`;if(!F)throw Error(`gjsify pack: package.json at ${n} has no "name"`);let H=a.skipWorkspaceRewrite?N:rewriteWorkspaceDeps(N,n),W=JSON.stringify(H,null,indentOf(C))+`
 `,K=collectFiles(n,N),q=[{name:`package/`,directory:!0,mode:493}],Y=[],X=0;for(let a of K){let S;S=a===`package.json`?new TextEncoder().encode(W):new Uint8Array(readFileSync(Io(n,a)));let C=statSync(Io(n,a)).mode&511;q.push({name:`package/${a}`,body:S,mode:C,mtime:0}),Y.push({path:a,size:S.byteLength,mode:C}),X+=S.byteLength}let te=await gzip(createTarball(q)),ne=`${F.startsWith(`@`)?F.slice(1).replace(`/`,`-`):F}-${I}.tgz`,re=createHash(`sha1`).update(te).digest(`hex`),ie=`sha512-${createHash(`sha512`).update(te).digest(`base64`)}`,ae=a.destination?No(a.destination):n,oe=Io(ae,ne);return a.dryRun||(mkdirSync(ae,{recursive:!0}),writeFileSync(oe,te)),{filename:ne,name:F,version:I,size:te.byteLength,unpackedSize:X,shasum:re,integrity:ie,entryCount:Y.length,files:Y,absolutePath:a.dryRun?null:oe}}function collectFiles(n,a){let S=forceIncluded(a),C=Array.isArray(a.files)?a.files.filter(n=>typeof n==`string`):null,N;N=C?expandFilesPatterns(n,C):walkAll(n);let F=loadIgnore(n),I=new Set;for(let n of N)F(n)||I.add(n);for(let a of S)existsSync(Io(n,a))&&I.add(a);return[...I].sort()}const EE=new Set([`.git`,`.svn`,`.hg`,`.gitignore`,`.gitattributes`,`.npmrc`,`CVS`,`.DS_Store`,`node_modules`,`.npmignore`,`package-lock.json`,`gjsify-lock.json`,`yarn.lock`,`yarn-error.log`,`.yarn`,`.pnp.cjs`,`.pnp.loader.mjs`,`tsconfig.tsbuildinfo`]);function forceIncluded(n){let a=new Set;a.add(`package.json`);for(let n of[`README`,`README.md`,`LICENSE`,`LICENSE.md`,`NOTICE`,`NOTICE.md`])a.add(n);let S=typeof n.main==`string`?n.main:null;S&&a.add(S.replace(/^\.\//,``));let C=n.bin;if(typeof C==`string`)a.add(C.replace(/^\.\//,``));else if(C&&typeof C==`object`)for(let n of Object.values(C))typeof n==`string`&&a.add(n.replace(/^\.\//,``));return[...a]}function walkAll(n,a=``){let S=[],C=a?Io(n,a):n,N;try{N=readdirSync(C,{withFileTypes:!0})}catch{return S}for(let C of N){if(EE.has(C.name)||C.name.startsWith(`.tsbuildinfo`))continue;let N=a?`${a}/${C.name}`:C.name;C.isDirectory()?S.push(...walkAll(n,N)):C.isFile()&&S.push(N)}return S}function expandFilesPatterns(n,a){let S=new Set;for(let C of a){let a=C.replace(/^\.\//,``).replace(/\/$/,``),N=Io(n,a);if(!existsSync(N))continue;let F=statSync(N);if(F.isDirectory())for(let C of walkAll(n,a))S.add(C);else F.isFile()&&S.add(a);!existsSync(N)&&/[*?[]/.test(C)&&ze.warn(`gjsify pack: files entry "${C}" looks like a glob but glob expansion isn't implemented — pass literal files/dirs`)}return[...S]}function loadIgnore(n){let a=Io(n,`.npmignore`),S=Io(n,`.gitignore`),C=[],N=existsSync(a)?a:existsSync(S)?S:null;if(N){let n=readFileSync(N,`utf-8`).split(`
 `);for(let a of n){let n=a.trim();!n||n.startsWith(`#`)||n.startsWith(`!`)||C.push(globToRegex(n))}}return n=>{for(let a of C)if(a.test(n))return!0;return!1}}function globToRegex(n){let a=n.replace(/^\//,``);return a=a.replace(/[.+^${}()|[\]\\]/g,`\\$&`),a=a.replace(/\*\*/g,`__DOUBLESTAR__`).replace(/\*/g,`[^/]*`).replace(/__DOUBLESTAR__/g,`.*`),a=a.replace(/\?/g,`[^/]`),RegExp(`^${a}($|/)`)}function rewriteWorkspaceDeps(n,a){let S=findWorkspaceRoot(a);if(!S)return n;let C=new Map;for(let n of discoverWorkspaces(S))n.name&&n.version&&C.set(n.name,n.version);let N=JSON.parse(JSON.stringify(n));for(let n of[`dependencies`,`devDependencies`,`peerDependencies`,`optionalDependencies`]){let a=N[n];if(a)for(let[n,F]of Object.entries(a)){if(typeof F!=`string`||!F.startsWith(`workspace:`))continue;let I=C.get(n);if(!I)throw Error(`gjsify pack: ${N.name} declares workspace:^ on ${n} but no sibling workspace with that name exists in the monorepo at ${S}`);let H=F.slice(10);H===`*`||H===``?a[n]=I:H===`^`||H===`~`?a[n]=`${H}${I}`:a[n]=H}}return N}function indentOf(n){let a=n.match(/\n([ \t]+)"/);return a?a[1]:`  `}Be(),Rs(),op(),qo(),lE();const DE={command:`publish [path]`,description:"Pack + upload the workspace at <path> (default: cwd) to its npm registry. Drop-in for `npm publish` with workspace:^ rewrite handled automatically.",builder:n=>n.positional(`path`,{description:`Workspace path (default: cwd).`,type:`string`}).option(`tag`,{description:`Dist-tag to publish under. Default: latest.`,type:`string`,default:`latest`}).option(`access`,{description:"Package access — `public` or `restricted` (required for first publish of scoped packages on the public registry).",type:`string`}).option(`tolerate-republish`,{description:"Treat a 409 conflict (version already published) as success. Matches yarn `--tolerate-republish`.",type:`boolean`,default:!1}).option(`provenance`,{description:`Pass-through flag — recorded in the payload but no signing happens (gjsify doesn't ship a sigstore signer yet).`,type:`boolean`,default:!1}).option(`dry-run`,{description:`Pack only, do not PUT.`,type:`boolean`,default:!1}).option(`json`,{description:`Emit publish metadata as JSON on stdout.`,type:`boolean`,default:!1}),handler:async n=>{let a=No(n.path??process.cwd()),S=n.tag??`latest`,C=n.access,N=n[`tolerate-republish`]===!0,F=n.provenance===!0,I=n[`dry-run`]===!0;F&&ze.warn(`gjsify publish: --provenance recorded but not signed (no sigstore integration yet).`);let H=await packWorkspace(a,{dryRun:!0}),W=await packWorkspaceToBytes(a),K=readFileSync(Io(a,`package.json`),`utf-8`),q=await loadRewrittenManifest(a,JSON.parse(K));if(I){let a={ok:!0,action:`dry-run`,name:H.name,version:H.version,filename:H.filename,size:H.size,shasum:H.shasum,integrity:H.integrity};n.json?process.stdout.write(`${JSON.stringify(a,null,2)}\n`):process.stdout.write(`+ ${H.name}@${H.version} (dry-run, ${H.size} bytes, ${H.entryCount} files)\n`);return}let Y=await loadNpmrc(a),X=process.env.npm_config_registry??registryFor(H.name,Y)??cE,te=X.endsWith(`/`)?X.slice(0,-1):X,ne=`${te}/${H.name.startsWith(`@`)?(()=>{let n=H.name.indexOf(`/`),a=H.name.slice(1,n),S=H.name.slice(n+1);return`@${encodeURIComponent(a)}%2f${encodeURIComponent(S)}`})():encodeURIComponent(H.name)}`,re=`${H.name.includes(`/`)?H.name.slice(H.name.indexOf(`/`)+1):H.name}-${H.version}.tgz`,ie=buildPublishPayload({pkg:q,tag:S,access:C,tarballBytes:W,tarballUrl:`${te}/${H.name}/-/${re}`,packed:{...H,wireFilename:re},provenance:F}),ae=buildHeaders(ne,{npmrc:Y});ae[`content-type`]=`application/json`,ae.accept=`*/*`,process.env.GJSIFY_PUBLISH_DEBUG&&(ze.error(`gjsify publish: PUT ${ne} (${H.name}@${H.version})`),ze.error(`  authorization: ${ae.authorization?`(set)`:`(none)`}`),ze.error(`  payload size: ${JSON.stringify(ie).length} bytes`));let oe=await fetch(ne,{method:`PUT`,headers:ae,body:JSON.stringify(ie)});if(oe.ok){let a={ok:!0,name:H.name,version:H.version,filename:H.filename,size:H.size,integrity:H.integrity,tag:S,registry:te};n.json?process.stdout.write(`${JSON.stringify(a,null,2)}\n`):process.stdout.write(`+ ${H.name}@${H.version}\n`);return}let Z=await oe.text().catch(()=>`<no body>`);if(oe.status===409&&N){let a={ok:!0,action:`republish-tolerated`,name:H.name,version:H.version,status:409};n.json?process.stdout.write(`${JSON.stringify(a,null,2)}\n`):process.stdout.write(`= ${H.name}@${H.version} (already published, tolerated)\n`);return}ze.error(`gjsify publish: ${H.name}@${H.version} — ${oe.status} ${oe.statusText}`),ze.error(Z),process.exit(1)}};async function packWorkspaceToBytes(n){let a=`/tmp/gjsify-publish-${process.pid}-${Date.now()}`,S=await packWorkspace(n,{destination:a,dryRun:!1});if(!S.absolutePath)throw Error(`gjsify publish: pack did not produce a file`);let C=new Uint8Array(readFileSync(S.absolutePath));try{(await Promise.resolve().then(()=>(Rs(),Fs))).rmSync(S.absolutePath)}catch{}try{(await Promise.resolve().then(()=>(Rs(),Fs))).rmdirSync(a)}catch{}return C}async function loadRewrittenManifest(n,a){let S=`/tmp/gjsify-publish-manifest-${process.pid}-${Date.now()}.tgz`,C=await packWorkspace(n,{destination:S.substring(0,S.lastIndexOf(`/`)),dryRun:!1}),{rmSync:N}=await Promise.resolve().then(()=>(Rs(),Fs));if(!C.absolutePath)throw Error(`gjsify publish: pack did not produce a file`);let{gunzip:F,parseTar:I}=await Promise.resolve().then(()=>(mE(),pE)),H=new Uint8Array(readFileSync(C.absolutePath));N(C.absolutePath);let W=await F(H);for(let n of I(W))if(n.name===`package/package.json`&&n.body)return JSON.parse(new TextDecoder().decode(n.body));return a}async function loadNpmrc(n){let a=[],S=Io(n,`.npmrc`);existsSync(S)&&a.push(readFileSync(S,`utf-8`));let C=process.env.NPM_CONFIG_USERCONFIG;if(C&&existsSync(C))a.push(readFileSync(C,`utf-8`));else{let n=Io(homedir(),`.npmrc`);existsSync(n)&&a.push(readFileSync(n,`utf-8`))}return parseNpmrc(a.join(`
-`).replace(/\$\{([A-Z_][A-Z0-9_]*)\}/gi,(n,a)=>process.env[a]??``))}function buildPublishPayload(n){let{pkg:a,tag:S,access:C,tarballBytes:N,tarballUrl:F,packed:I,provenance:H}=n,W={...a,_id:`${I.name}@${I.version}`,dist:{integrity:I.integrity,shasum:I.shasum,tarball:F}};H&&(W._hasShrinkwrap=!1);let K={_id:I.name,name:I.name,description:typeof a.description==`string`?a.description:``,"dist-tags":{[S]:I.version},versions:{[I.version]:W},readme:``,_attachments:{[I.wireFilename]:{content_type:`application/octet-stream`,data:base64Encode(N),length:N.byteLength}}};return C&&(K.access=C),K}function base64Encode(n){let a=``,S=32768;for(let C=0;C<n.length;C+=S)a+=String.fromCharCode(...n.subarray(C,C+S));return btoa(a)}Be(),Rs(),qo(),tn(),lE();const OE=`@gjsify/cli`,kE={command:`self-update`,description:`Update the installed ${OE} to the latest release (or pinned --tag).`,builder:n=>n.option(`check`,{description:`Only check whether a newer version is available; do not install.`,type:`boolean`,default:!1}).option(`force`,{description:`Reinstall even when the current version already matches the target tag.`,type:`boolean`,default:!1}).option(`tag`,{description:"npm dist-tag or pinned version to install (e.g. `latest`, `next`, `0.5.0`).",type:`string`,default:`latest`}),handler:async n=>{let a=defaultGlobalLayout(),S=Io(Io(a.prefix,`node_modules`,OE),`package.json`),C=readCurrentVersion(),N=existsSync(S);ze.log(`Current ${OE}: v${C??`(unknown)`}`),N||ze.warn(`\nWarning: no @gjsify/cli install found under ${a.prefix}.\nself-update only manages installs created by install.mjs or \`gjsify install -g\`.\nIf you installed via \`npm install -g\`, remove that and use:\n  curl -fsSL https://github.com/gjsify/gjsify/releases/latest/download/install.mjs -o /tmp/g.mjs && gjs -m /tmp/g.mjs && rm /tmp/g.mjs`),ze.log(`Fetching dist-tags for ${OE}@${n.tag} ...`);let F;try{F=await fetchPackument(OE)}catch(n){let a=n instanceof Error?n.message:String(n);ze.error(`Failed to fetch packument: ${a}`),process.exit(1);return}let I=resolveTag(F,n.tag);if(!I){ze.error(`Unknown dist-tag '${n.tag}' on ${OE}. Known tags: ${Object.keys(F[`dist-tags`]??{}).join(`, `)||`(none)`}`),process.exit(1);return}if(ze.log(`Latest matching --tag ${n.tag}: v${I}`),C===I&&!n.force){ze.log(`Already up to date (v${I}).`),n.check||ze.log(`Run with --force to reinstall anyway.`);return}if(n.check){ze.log(C?`Update available: v${C} → v${I}`:`Install required: → v${I}`),process.exit(1);return}ze.log(`Installing ${OE}@${I} ...`),await installPackages({prefix:a.prefix,specs:[`${OE}@${I}`],verbose:!1});let H=linkGlobalBins([OE],a);if(H.length===0)ze.warn("self-update: install completed but no bins were linked — package.json may be missing a `bin` field.");else for(let n of H)ze.log(`  • ${n.link}  →  ${n.target}`);ze.log(`\nUpdated ${OE} to v${I}.`)}};function readCurrentVersion(){try{let n=zo(No(fileURLToPath(import.meta.url)));for(let a=0;a<8&&n!==zo(n);a++){let a=Io(n,`package.json`);if(existsSync(a)){let n=JSON.parse(readFileSync(a,`utf-8`));if(n.name===OE&&typeof n.version==`string`)return n.version}n=zo(n)}}catch{}return null}function resolveTag(n,a){let S=n[`dist-tags`]??{};return S[a]?S[a]:n.versions&&typeof n.versions==`object`&&n.versions[a]?a:null}Be(),Rs(),qo();function loadInstallerTemplate(){return readFileSync(new URL(`../templates/install.mjs.tmpl`,import.meta.url),`utf-8`)}const AE={command:`generate-installer [target]`,description:`Scaffold an install.mjs in the current directory for a GJS-runnable npm package.`,builder:n=>n.positional(`target`,{description:`Npm package name to install (default: current package.json name).`,type:`string`}).option(`bin-name`,{description:"Bin name produced by the installer (default: first key of `gjsify.bin` or `bin`).",type:`string`}).option(`bootstrap-url`,{description:`Override the cli.gjs.mjs bootstrap bundle URL (default: gjsify GitHub releases/latest).`,type:`string`}).option(`output`,{description:`Where to write the generated installer.`,type:`string`,default:`install.mjs`}).option(`force`,{description:`Overwrite an existing output file.`,type:`boolean`,default:!1}),handler:n=>{let a=No(process.cwd(),n.output);if(existsSync(a)&&!n.force){ze.error(`${n.output} already exists. Re-run with --force to overwrite.`),process.exit(1);return}let S=No(process.cwd(),`package.json`),C=null;if(existsSync(S))try{C=JSON.parse(readFileSync(S,`utf-8`))}catch{}let N=n.target??C?.name;if(!N){ze.error("No target package: pass `gjsify generate-installer <pkg>` or run inside a directory with a package.json."),process.exit(1);return}let F=n[`bin-name`]??pickDefaultBinName(C,N),I=n[`bootstrap-url`]??`https://github.com/gjsify/gjsify/releases/latest/download/cli.gjs.mjs`;writeFileSync(a,loadInstallerTemplate().replace(/const DEFAULT_TARGET = '[^']+';/,`const DEFAULT_TARGET = ${JSON.stringify(N)};`).replace(/const DEFAULT_BIN_NAME = '[^']+';/,`const DEFAULT_BIN_NAME = ${JSON.stringify(F)};`).replace(/const DEFAULT_BOOTSTRAP_URL =\s*'[^']+';/,`const DEFAULT_BOOTSTRAP_URL = ${JSON.stringify(I)};`),{mode:493}),ze.log(`Wrote ${n.output} (target=${N}, bin=${F}).`),ze.log(``),ze.log(`Install one-liner for your README:`),ze.log(`  curl -fsSL https://github.com/<you>/<repo>/raw/main/${n.output} -o /tmp/i.mjs \\`),ze.log(`    && gjs -m /tmp/i.mjs && rm /tmp/i.mjs`)}};function pickDefaultBinName(n,a){let S=n?.gjsify?.bin;if(S&&typeof S==`object`){let n=Object.keys(S)[0];if(n)return n}let C=n?.bin;if(C&&typeof C==`object`){let n=Object.keys(C)[0];if(n)return n}return a.startsWith(`@`)?a.slice(a.indexOf(`/`)+1):a}await du(hideBin(process.argv)).scriptName(fu).strict().command(UT.command,UT.description,UT.builder,UT.handler).command(SE.command,SE.description,SE.builder,SE.handler).command(AT.command,AT.description,AT.builder,AT.handler).command(jT.command,jT.description,jT.builder,jT.handler).command(xE.command,xE.description,xE.builder,xE.handler).command(MT.command,MT.description,MT.builder,MT.handler).command(LT.command,LT.description,LT.builder,LT.handler).command(RT.command,RT.description,RT.builder,RT.handler).command(GT.command,GT.description,GT.builder,GT.handler).command(qT.command,qT.description,qT.builder,qT.handler).command(YT.command,YT.description,YT.builder,YT.handler).command(nE.command,nE.description,nE.builder,nE.handler).command(CE.command,CE.description,CE.builder,CE.handler).command(wE.command,wE.description,wE.builder,wE.handler).command(TE.command,TE.description,TE.builder,TE.handler).command(DE.command,DE.description,DE.builder,DE.handler).command(kE.command,kE.description,kE.builder,kE.handler).command(AE.command,AE.description,AE.builder,AE.handler).demandCommand(1).help().parseAsync();
+`).replace(/\$\{([A-Z_][A-Z0-9_]*)\}/gi,(n,a)=>process.env[a]??``))}function buildPublishPayload(n){let{pkg:a,tag:S,access:C,tarballBytes:N,tarballUrl:F,packed:I,provenance:H}=n,W={...a,_id:`${I.name}@${I.version}`,dist:{integrity:I.integrity,shasum:I.shasum,tarball:F}};H&&(W._hasShrinkwrap=!1);let K={_id:I.name,name:I.name,description:typeof a.description==`string`?a.description:``,"dist-tags":{[S]:I.version},versions:{[I.version]:W},readme:``,_attachments:{[I.wireFilename]:{content_type:`application/octet-stream`,data:base64Encode(N),length:N.byteLength}}};return C&&(K.access=C),K}function base64Encode(n){let a=``,S=32768;for(let C=0;C<n.length;C+=S)a+=String.fromCharCode(...n.subarray(C,C+S));return btoa(a)}Be(),Rs(),qo(),tn(),lE();const OE=`@gjsify/cli`,kE={command:`self-update`,description:`Update the installed ${OE} to the latest release (or pinned --tag).`,builder:n=>n.option(`check`,{description:`Only check whether a newer version is available; do not install.`,type:`boolean`,default:!1}).option(`force`,{description:`Reinstall even when the current version already matches the target tag.`,type:`boolean`,default:!1}).option(`tag`,{description:"npm dist-tag or pinned version to install (e.g. `latest`, `next`, `0.5.0`).",type:`string`,default:`latest`}),handler:async n=>{let a=defaultGlobalLayout(),S=Io(Io(a.prefix,`node_modules`,OE),`package.json`),C=readCurrentVersion(),N=existsSync(S);ze.log(`Current ${OE}: v${C??`(unknown)`}`),N||ze.warn(`\nWarning: no @gjsify/cli install found under ${a.prefix}.\nself-update only manages installs created by install.mjs or \`gjsify install -g\`.\nIf you installed via \`npm install -g\`, remove that and use:\n  curl -fsSL https://github.com/gjsify/gjsify/releases/latest/download/install.mjs -o /tmp/g.mjs && gjs -m /tmp/g.mjs && rm /tmp/g.mjs`),ze.log(`Fetching dist-tags for ${OE}@${n.tag} ...`);let F;try{F=await fetchPackument(OE)}catch(n){let a=n instanceof Error?n.message:String(n);ze.error(`Failed to fetch packument: ${a}`),process.exit(1);return}let I=resolveTag(F,n.tag);if(!I){ze.error(`Unknown dist-tag '${n.tag}' on ${OE}. Known tags: ${Object.keys(F[`dist-tags`]??{}).join(`, `)||`(none)`}`),process.exit(1);return}if(ze.log(`Latest matching --tag ${n.tag}: v${I}`),C===I&&!n.force){ze.log(`Already up to date (v${I}).`),n.check||ze.log(`Run with --force to reinstall anyway.`);return}if(n.check){ze.log(C?`Update available: v${C} → v${I}`:`Install required: → v${I}`),process.exit(1);return}ze.log(`Installing ${OE}@${I} ...`),await installPackages({prefix:a.prefix,specs:[`${OE}@${I}`],verbose:!1});let H=linkGlobalBins([OE],a);if(H.length===0)ze.warn("self-update: install completed but no bins were linked — package.json may be missing a `bin` field.");else for(let n of H)ze.log(`  • ${n.link}  →  ${n.target}`);ze.log(`\nUpdated ${OE} to v${I}.`)}};function readCurrentVersion(){try{let n=zo(No(fileURLToPath(import.meta.url)));for(let a=0;a<8&&n!==zo(n);a++){let a=Io(n,`package.json`);if(existsSync(a)){let n=JSON.parse(readFileSync(a,`utf-8`));if(n.name===OE&&typeof n.version==`string`)return n.version}n=zo(n)}}catch{}return null}function resolveTag(n,a){let S=n[`dist-tags`]??{};return S[a]?S[a]:n.versions&&typeof n.versions==`object`&&n.versions[a]?a:null}Be(),Rs(),qo();function loadInstallerTemplate(){return readFileSync(new URL(`../templates/install.mjs.tmpl`,import.meta.url),`utf-8`)}const AE={command:`generate-installer [target]`,description:`Scaffold an install.mjs in the current directory for a GJS-runnable npm package.`,builder:n=>n.positional(`target`,{description:`Npm package name to install (default: current package.json name).`,type:`string`}).option(`bin-name`,{description:"Bin name produced by the installer (default: first key of `gjsify.bin` or `bin`).",type:`string`}).option(`bootstrap-url`,{description:`Override the cli.gjs.mjs bootstrap bundle URL (default: gjsify GitHub releases/latest).`,type:`string`}).option(`output`,{description:`Where to write the generated installer.`,type:`string`,default:`install.mjs`}).option(`force`,{description:`Overwrite an existing output file.`,type:`boolean`,default:!1}),handler:n=>{let a=No(process.cwd(),n.output);if(existsSync(a)&&!n.force){ze.error(`${n.output} already exists. Re-run with --force to overwrite.`),process.exit(1);return}let S=No(process.cwd(),`package.json`),C=null;if(existsSync(S))try{C=JSON.parse(readFileSync(S,`utf-8`))}catch{}let N=n.target??C?.name;if(!N){ze.error("No target package: pass `gjsify generate-installer <pkg>` or run inside a directory with a package.json."),process.exit(1);return}let F=n[`bin-name`]??pickDefaultBinName(C,N),I=n[`bootstrap-url`]??`https://github.com/gjsify/gjsify/releases/latest/download/cli.gjs.mjs`;writeFileSync(a,loadInstallerTemplate().replace(/const DEFAULT_TARGET = '[^']+';/,`const DEFAULT_TARGET = ${JSON.stringify(N)};`).replace(/const DEFAULT_BIN_NAME = '[^']+';/,`const DEFAULT_BIN_NAME = ${JSON.stringify(F)};`).replace(/const DEFAULT_BOOTSTRAP_URL =\s*'[^']+';/,`const DEFAULT_BOOTSTRAP_URL = ${JSON.stringify(I)};`),{mode:493}),ze.log(`Wrote ${n.output} (target=${N}, bin=${F}).`),ze.log(``),ze.log(`Install one-liner for your README:`),ze.log(`  curl -fsSL https://github.com/<you>/<repo>/raw/main/${n.output} -o /tmp/i.mjs \\`),ze.log(`    && gjs -m /tmp/i.mjs && rm /tmp/i.mjs`)}};function pickDefaultBinName(n,a){let S=n?.gjsify?.bin;if(S&&typeof S==`object`){let n=Object.keys(S)[0];if(n)return n}let C=n?.bin;if(C&&typeof C==`object`){let n=Object.keys(C)[0];if(n)return n}return a.startsWith(`@`)?a.slice(a.indexOf(`/`)+1):a}Be(),Rs(),qo();const jE={command:`uninstall <packages..>`,description:"Uninstall a previously installed package. Currently only `--global` mode is supported.",builder:n=>n.positional(`packages`,{description:`Package(s) to uninstall (npm names, optionally with version).`,type:`string`,array:!0,demandOption:!0}).option(`global`,{description:`Uninstall from the user-global XDG location (the install -g target).`,type:`boolean`,alias:`g`,default:!1}).option(`dry-run`,{description:`Show what would be removed without touching the filesystem.`,type:`boolean`,default:!1}).option(`verbose`,{description:`Verbose logging.`,type:`boolean`,default:!1}),handler:n=>{if(!n.global){ze.error("gjsify uninstall currently only supports --global. For project-local removal, edit package.json + re-run `gjsify install`."),process.exit(1);return}let a=defaultGlobalLayout(),S=n[`dry-run`]??!1,C=n.verbose??!1,N=`gjsify uninstall${S?` (dry-run)`:``} --global`;ze.log(`${N}  ← ${a.prefix}`),ze.log(`${` `.repeat(N.length)}      bins ← ${a.binDir}`);let F=!1;for(let N of n.packages){let n=specToPackageName(N),I=Io(a.prefix,`node_modules`,n);if(!existsSync(I)){ze.warn(`  ✗  ${n} — not installed at ${I}`);continue}let H=findBinShimsForPackage(a.binDir,I,C);if(S){ze.log(`  •  would remove ${I}`);for(let n of H)ze.log(`  •  would remove ${n}`)}else{rmSync(I,{recursive:!0,force:!0}),ze.log(`  •  removed ${I}`);for(let n of H)unlinkSync(n),ze.log(`  •  removed ${n}`)}F=!0}F||(ze.error(`
+No packages removed.`),process.exit(1))}};function findBinShimsForPackage(n,a,S){if(!existsSync(n))return[];let C=[],N;try{N=readdirSync(n)}catch{return[]}for(let F of N){let N=Io(n,F);try{if(!statSync(N).isFile())continue;let n=readFileSync(N,`utf-8`);if(!n.startsWith(`#!/bin/sh`))continue;let S=n.match(/'([^']+)'/);if(!S)continue;let F=S[1];(F.startsWith(a+`/`)||F===a)&&C.push(N)}catch(n){S&&ze.warn(`  ?  could not inspect ${N}: ${n.message}`)}}return C}await du(hideBin(process.argv)).scriptName(fu).strict().command(UT.command,UT.description,UT.builder,UT.handler).command(SE.command,SE.description,SE.builder,SE.handler).command(AT.command,AT.description,AT.builder,AT.handler).command(jT.command,jT.description,jT.builder,jT.handler).command(xE.command,xE.description,xE.builder,xE.handler).command(MT.command,MT.description,MT.builder,MT.handler).command(LT.command,LT.description,LT.builder,LT.handler).command(RT.command,RT.description,RT.builder,RT.handler).command(GT.command,GT.description,GT.builder,GT.handler).command(qT.command,qT.description,qT.builder,qT.handler).command(YT.command,YT.description,YT.builder,YT.handler).command(nE.command,nE.description,nE.builder,nE.handler).command(CE.command,CE.description,CE.builder,CE.handler).command(wE.command,wE.description,wE.builder,wE.handler).command(TE.command,TE.description,TE.builder,TE.handler).command(DE.command,DE.description,DE.builder,DE.handler).command(kE.command,kE.description,kE.builder,kE.handler).command(AE.command,AE.description,AE.builder,AE.handler).command(jE.command,jE.description,jE.builder,jE.handler).demandCommand(1).help().parseAsync();

package/lib/commands/index.d.ts

@@ -16,3 +16,4 @@ export * from './pack.js';
 export * from './publish.js';
 export * from './self-update.js';
 export * from './generate-installer.js';
+export * from './uninstall.js';

package/lib/commands/index.js

@@ -16,3 +16,4 @@ export * from './pack.js';
 export * from './publish.js';
 export * from './self-update.js';
 export * from './generate-installer.js';
+export * from './uninstall.js';

package/lib/commands/uninstall.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from '../types/index.js';
+interface UninstallOptions {
+    packages: string[];
+    global?: boolean;
+    'dry-run'?: boolean;
+    verbose?: boolean;
+}
+export declare const uninstallCommand: Command<any, UninstallOptions>;
+export {};

package/lib/commands/uninstall.js

@@ -0,0 +1,145 @@
+// `gjsify uninstall -g <pkg>` — symmetric inverse of `install -g`.
+//
+// Removes the installed package tree from the user-global XDG location
+// and any bin shims under `~/.local/bin/` that point into it. Mirrors
+// the layout decisions in install-global.ts:
+//
+//   ~/.local/share/gjsify/global/node_modules/<pkg>/   ← deleted
+//   ~/.local/bin/<bin>                                  ← deleted iff it
+//                                                        execs a path
+//                                                        inside the
+//                                                        removed tree
+//
+// Scope: --global only. Project-local uninstall (mirror of `npm uninstall
+// <pkg>` without -g) is a separate workstream — it needs to rewrite
+// package.json + refresh the lockfile, which install -g doesn't touch.
+import { existsSync, readFileSync, readdirSync, rmSync, statSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { defaultGlobalLayout, specToPackageName } from '../utils/install-global.js';
+export const uninstallCommand = {
+    command: 'uninstall <packages..>',
+    description: 'Uninstall a previously installed package. Currently only `--global` mode is supported.',
+    builder: (yargs) => yargs
+        .positional('packages', {
+        description: 'Package(s) to uninstall (npm names, optionally with version).',
+        type: 'string',
+        array: true,
+        demandOption: true,
+    })
+        .option('global', {
+        description: 'Uninstall from the user-global XDG location (the install -g target).',
+        type: 'boolean',
+        alias: 'g',
+        default: false,
+    })
+        .option('dry-run', {
+        description: 'Show what would be removed without touching the filesystem.',
+        type: 'boolean',
+        default: false,
+    })
+        .option('verbose', {
+        description: 'Verbose logging.',
+        type: 'boolean',
+        default: false,
+    }),
+    handler: (args) => {
+        if (!args.global) {
+            console.error('gjsify uninstall currently only supports --global. ' +
+                'For project-local removal, edit package.json + re-run `gjsify install`.');
+            process.exit(1);
+            return;
+        }
+        const layout = defaultGlobalLayout();
+        const dryRun = args['dry-run'] ?? false;
+        const verbose = args.verbose ?? false;
+        const prefix = `gjsify uninstall${dryRun ? ' (dry-run)' : ''} --global`;
+        console.log(`${prefix}  ← ${layout.prefix}`);
+        console.log(`${' '.repeat(prefix.length)}      bins ← ${layout.binDir}`);
+        let removedAny = false;
+        for (const spec of args.packages) {
+            const pkgName = specToPackageName(spec);
+            const pkgDir = join(layout.prefix, 'node_modules', pkgName);
+            if (!existsSync(pkgDir)) {
+                console.warn(`  ✗  ${pkgName} — not installed at ${pkgDir}`);
+                continue;
+            }
+            // Find bin shims that exec into this package's tree. The shims
+            // are POSIX sh launchers written by linkGlobalBins; we identify
+            // candidates by reading the launcher script and matching the
+            // absolute path.
+            const binsToRemove = findBinShimsForPackage(layout.binDir, pkgDir, verbose);
+            if (dryRun) {
+                console.log(`  •  would remove ${pkgDir}`);
+                for (const bin of binsToRemove) {
+                    console.log(`  •  would remove ${bin}`);
+                }
+            }
+            else {
+                rmSync(pkgDir, { recursive: true, force: true });
+                console.log(`  •  removed ${pkgDir}`);
+                for (const bin of binsToRemove) {
+                    unlinkSync(bin);
+                    console.log(`  •  removed ${bin}`);
+                }
+            }
+            removedAny = true;
+        }
+        if (!removedAny) {
+            console.error('\nNo packages removed.');
+            process.exit(1);
+        }
+    },
+};
+/**
+ * Scan `binDir` for POSIX `sh` launchers whose `exec` target points into
+ * `pkgDir`. The launcher shape is fixed by `linkGlobalBins` — either:
+ *
+ *   #!/bin/sh
+ *   exec '<absolute-path>' "$@"
+ *
+ * or (for `.gjs.mjs` / `.mjs` targets):
+ *
+ *   #!/bin/sh
+ *   exec gjs -m '<absolute-path>' "$@"
+ *
+ * We parse the absolute path out of the single-quoted segment and check
+ * whether it's under `pkgDir`. Non-shim files (e.g. unrelated binaries
+ * the user installed via `npm install -g`) are skipped silently.
+ */
+function findBinShimsForPackage(binDir, pkgDir, verbose) {
+    if (!existsSync(binDir))
+        return [];
+    const matches = [];
+    let entries;
+    try {
+        entries = readdirSync(binDir);
+    }
+    catch {
+        return [];
+    }
+    for (const name of entries) {
+        const fullPath = join(binDir, name);
+        try {
+            const st = statSync(fullPath);
+            if (!st.isFile())
+                continue;
+            const content = readFileSync(fullPath, 'utf-8');
+            if (!content.startsWith('#!/bin/sh'))
+                continue;
+            // Match the first single-quoted absolute path.
+            const m = content.match(/'([^']+)'/);
+            if (!m)
+                continue;
+            const target = m[1];
+            if (target.startsWith(pkgDir + '/') || target === pkgDir) {
+                matches.push(fullPath);
+            }
+        }
+        catch (err) {
+            if (verbose) {
+                console.warn(`  ?  could not inspect ${fullPath}: ${err.message}`);
+            }
+        }
+    }
+    return matches;
+}

package/lib/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
-import { buildCommand as build, runCommand as run, infoCommand as info, checkCommand as check, showcaseCommand as showcase, createCommand as create, gresourceCommand as gresource, gettextCommand as gettext, gsettingsCommand as gsettings, flatpakCommand as flatpak, dlxCommand as dlx, installCommand as install, foreachCommand as foreach, workspaceCommand as workspace, packCommand as pack, publishCommand as publish, selfUpdateCommand as selfUpdate, generateInstallerCommand as generateInstaller, } from './commands/index.js';
+import { buildCommand as build, runCommand as run, infoCommand as info, checkCommand as check, showcaseCommand as showcase, createCommand as create, gresourceCommand as gresource, gettextCommand as gettext, gsettingsCommand as gsettings, flatpakCommand as flatpak, dlxCommand as dlx, installCommand as install, foreachCommand as foreach, workspaceCommand as workspace, packCommand as pack, publishCommand as publish, selfUpdateCommand as selfUpdate, generateInstallerCommand as generateInstaller, uninstallCommand as uninstall, } from './commands/index.js';
 import { APP_NAME } from './constants.js';
 // `parseAsync()` instead of `.argv` so the top-level await keeps the
 // process alive until command handlers complete. Under Node this is
@@ -29,6 +29,7 @@ await yargs(hideBin(process.argv))
     .command(publish.command, publish.description, publish.builder, publish.handler)
     .command(selfUpdate.command, selfUpdate.description, selfUpdate.builder, selfUpdate.handler)
     .command(generateInstaller.command, generateInstaller.description, generateInstaller.builder, generateInstaller.handler)
+    .command(uninstall.command, uninstall.description, uninstall.builder, uninstall.handler)
     .demandCommand(1)
     .help()
     .parseAsync();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/cli",
-    "version": "0.4.10",
+    "version": "0.4.11",
     "description": "CLI for Gjsify",
     "type": "module",
     "main": "lib/index.js",
@@ -37,18 +37,18 @@
         "cli"
     ],
     "dependencies": {
-        "@gjsify/buffer": "^0.4.10",
-        "@gjsify/create-app": "^0.4.10",
-        "@gjsify/node-globals": "^0.4.10",
-        "@gjsify/node-polyfills": "^0.4.10",
-        "@gjsify/npm-registry": "^0.4.10",
-        "@gjsify/resolve-npm": "^0.4.10",
-        "@gjsify/rolldown-plugin-gjsify": "^0.4.10",
-        "@gjsify/rolldown-plugin-pnp": "^0.4.10",
-        "@gjsify/semver": "^0.4.10",
-        "@gjsify/tar": "^0.4.10",
-        "@gjsify/web-polyfills": "^0.4.10",
-        "@gjsify/workspace": "^0.4.10",
+        "@gjsify/buffer": "^0.4.11",
+        "@gjsify/create-app": "^0.4.11",
+        "@gjsify/node-globals": "^0.4.11",
+        "@gjsify/node-polyfills": "^0.4.11",
+        "@gjsify/npm-registry": "^0.4.11",
+        "@gjsify/resolve-npm": "^0.4.11",
+        "@gjsify/rolldown-plugin-gjsify": "^0.4.11",
+        "@gjsify/rolldown-plugin-pnp": "^0.4.11",
+        "@gjsify/semver": "^0.4.11",
+        "@gjsify/tar": "^0.4.11",
+        "@gjsify/web-polyfills": "^0.4.11",
+        "@gjsify/workspace": "^0.4.11",
         "cosmiconfig": "^9.0.1",
         "get-tsconfig": "^4.14.0",
         "pkg-types": "^2.3.1",
@@ -56,12 +56,12 @@
         "yargs": "^18.0.0"
     },
     "devDependencies": {
-        "@gjsify/unit": "^0.4.10",
+        "@gjsify/unit": "^0.4.11",
         "@types/yargs": "^17.0.35",
         "typescript": "^6.0.3"
     },
     "peerDependencies": {
-        "@gjsify/rolldown-native": "^0.4.10"
+        "@gjsify/rolldown-native": "^0.4.11"
     },
     "peerDependenciesMeta": {
         "@gjsify/rolldown-native": {