docs-cache 0.4.3 → 0.5.1

package/dist/chunks/sync.mjs

@@ -1,9 +0,0 @@
-import{createHash as N,randomBytes as Me}from"node:crypto";import{mkdtemp as ie,mkdir as b,rm as j,readFile as H,writeFile as se,access as _,rename as J,open as q,lstat as Pe,symlink as xe,readdir as Ee,cp as Te}from"node:fs/promises";import g from"node:path";import F from"picocolors";import{g as Oe,u as $,b as T,t as K,D as V,r as Z,c as Fe}from"../shared/docs-cache.CQiaFDb_.mjs";import{a as Q,l as ke,D as Re,b as be}from"../shared/docs-cache.CaOcl4OS.mjs";import je,{tmpdir as He}from"node:os";import{pathToFileURL as Ae}from"node:url";import{execa as Ie}from"execa";import{g as B,M as U,v as ae}from"./verify.mjs";import{e as Le,r as ne}from"../shared/docs-cache.kK1DPQIQ.mjs";import{execFile as Ne}from"node:child_process";import{promisify as _e}from"node:util";import{writeLock as Be,resolveLockPath as Ue,readLock as ze}from"../lock.mjs";import{createWriteStream as ce,createReadStream as Ye,constants as le}from"node:fs";import{pipeline as Ge}from"node:stream/promises";import ue from"fast-glob";const Xe=/^(https?:\/\/)([^@]+)@/i,A=e=>e.replace(Xe,"$1***@"),We=_e(Ne),Je=3e4,qe=new Set(["file:","ftp:","data:","javascript:"]),Ke=e=>{try{const r=new URL(e);if(qe.has(r.protocol))throw new Error(`Blocked protocol '${r.protocol}' in repo URL '${A(e)}'.`)}catch(r){if(r instanceof TypeError)return;throw r}},Ve=e=>{Ke(e);const r=e.match(/^[^@]+@([^:]+):/);if(r)return r[1]||null;try{const t=new URL(e);return t.protocol!=="https:"&&t.protocol!=="ssh:"?null:t.hostname||null}catch{return null}},fe=(e,r)=>{const t=Ve(e);if(!t)throw new Error(`Unsupported repo URL '${A(e)}'. Use HTTPS or SSH.`);const i=t.toLowerCase();if(!r.map(o=>o.toLowerCase()).some(o=>i===o||i.endsWith(`.${o}`)))throw new Error(`Host '${t}' is not in allowHosts for '${A(e)}'.`)},me=e=>{const r=e.trim().split(`
-`).filter(Boolean);return r.length===0?null:r[0].split(/\s+/)[0]||null},Ze=async e=>{fe(e.repo,e.allowHosts);const r=A(e.repo);e.logger?.(`git ls-remote ${r} ${e.ref}`);const{stdout:t}=await We("git",["ls-remote",e.repo,e.ref],{timeout:e.timeoutMs??Je,maxBuffer:1024*1024}),i=me(t);if(!i)throw new Error(`Unable to resolve ref '${e.ref}' for ${A(e.repo)}.`);return{repo:e.repo,ref:e.ref,resolvedCommit:i}},Qe=12e4,z=1,et=3,tt=100,k=async(e,r)=>{const t=process.env.PATH??process.env.Path,i=process.env.PATHEXT??(process.platform==="win32"?".COM;.EXE;.BAT;.CMD":void 0),o=["-c","core.hooksPath=/dev/null","-c","submodule.recurse=false","-c","protocol.ext.allow=never"];r?.allowFileProtocol?o.push("-c","protocol.file.allow=always"):o.push("-c","protocol.file.allow=never");const n=[...o,...e],s=`git ${n.join(" ")}`;r?.logger?.(s);const a=Ie("git",n,{cwd:r?.cwd,timeout:r?.timeoutMs??Qe,maxBuffer:10*1024*1024,stdout:"pipe",stderr:"pipe",env:{...process.env,...t?{PATH:t,Path:t}:{},...i?{PATHEXT:i}:{},HOME:process.env.HOME,USER:process.env.USER,USERPROFILE:process.env.USERPROFILE,TMPDIR:process.env.TMPDIR,TMP:process.env.TMP,TEMP:process.env.TEMP,SYSTEMROOT:process.env.SYSTEMROOT,WINDIR:process.env.WINDIR,SSH_AUTH_SOCK:process.env.SSH_AUTH_SOCK,SSH_AGENT_PID:process.env.SSH_AGENT_PID,HTTP_PROXY:process.env.HTTP_PROXY,HTTPS_PROXY:process.env.HTTPS_PROXY,NO_PROXY:process.env.NO_PROXY,GIT_TERMINAL_PROMPT:"0",GIT_CONFIG_NOSYSTEM:"1",GIT_CONFIG_NOGLOBAL:"1",...process.platform==="win32"?{}:{GIT_ASKPASS:"/bin/false"}}});if(r?.logger){const l=u=>{u&&u.on("data",f=>{const m=f instanceof Buffer?f.toString("utf8"):String(f);for(const y of m.split(/\r?\n/))y&&r.logger?.(`${s} | ${y}`)})};l(a.stdout),l(a.stderr)}await a},I=async(e,r=et)=>{for(let t=0;t<=r;t+=1)try{await j(e,{recursive:!0,force:!0});return}catch(i){const o=B(i);if(o!=="ENOTEMPTY"&&o!=="EBUSY"&&o!=="EPERM"||t===r)throw i;await new Promise(n=>setTimeout(n,tt*(t+1)))}},rt=e=>N("sha256").update(e).digest("hex").substring(0,16),ot=e=>{const r=rt(e);return g.join(ne(),r)},it=async e=>{try{return await k(["rev-parse","--git-dir"],{cwd:e}),!0}catch{return!1}},de=async e=>{try{const r=g.join(e,".git","config"),t=(await H(r,"utf8")).toLowerCase();return t.includes("partialclone")||t.includes("promisor")||t.includes("partialclonefilter")}catch{return!1}},ee=async(e,r,t)=>{try{await k(["-C",e,"cat-file","-e",`${r}^{commit}`],{timeoutMs:t?.timeoutMs,allowFileProtocol:t?.allowFileProtocol,logger:t?.logger});return}catch{}await k(["-C",e,"fetch","origin",r],{timeoutMs:t?.timeoutMs,allowFileProtocol:t?.allowFileProtocol,logger:t?.logger})},he=e=>{if(!e||e.length===0)return!1;for(const r of e)if(!r||r.includes("**"))return!1;return!0},pe=e=>{if(!e)return[];const r=e.map(t=>{const i=t.replace(/\\/g,"/"),o=i.indexOf("*");return(o===-1?i:i.slice(0,o)).replace(/\/+$|\/$/,"")});return Array.from(new Set(r.filter(t=>t.length>0)))},te=async(e,r)=>{const t=/^[0-9a-f]{7,40}$/i.test(e.ref),i=he(e.include),o=["clone","--no-checkout","--depth",String(z),"--recurse-submodules=no","--no-tags"];if(i&&o.push("--sparse"),t||(o.push("--single-branch"),e.ref!=="HEAD"&&o.push("--branch",e.ref)),o.push(e.repo,r),await k(o,{timeoutMs:e.timeoutMs,logger:e.logger}),await ee(r,e.resolvedCommit,{timeoutMs:e.timeoutMs,logger:e.logger}),i){const n=pe(e.include);n.length>0&&await k(["-C",r,"sparse-checkout","set",...n],{timeoutMs:e.timeoutMs,logger:e.logger})}await k(["-C",r,"checkout","--quiet","--detach",e.resolvedCommit],{timeoutMs:e.timeoutMs,logger:e.logger})},st=async(e,r)=>{const t=ot(e.repo),i=await Le(t),o=i&&await it(t),n=/^[0-9a-f]{7,40}$/i.test(e.ref),s=he(e.include);let a=o;const l=ne();if(await b(l,{recursive:!0}),o)if(await de(t))await I(t),await te(e,t),a=!1;else try{const m=["fetch","origin"];if(n)m.push("--depth",String(z));else{const y=e.ref==="HEAD"?"HEAD":`${e.ref}:refs/remotes/origin/${e.ref}`;m.push(y,"--depth",String(z))}await k(["-C",t,...m],{timeoutMs:e.timeoutMs,logger:e.logger}),await ee(t,e.resolvedCommit,{timeoutMs:e.timeoutMs,logger:e.logger})}catch{await I(t),await te(e,t),a=!1}else i&&await I(t),await te(e,t),a=!1;await b(r,{recursive:!0});const u=["clone","--no-checkout","--depth",String(z),"--recurse-submodules=no","--no-tags"];await de(t)&&u.splice(2,0,"--filter=blob:none"),s&&u.push("--sparse"),n||(u.push("--single-branch"),e.ref!=="HEAD"&&u.push("--branch",e.ref));const f=Ae(t).href;if(u.push(f,r),await k(u,{timeoutMs:e.timeoutMs,allowFileProtocol:!0,logger:e.logger}),s){const m=pe(e.include);m.length>0&&await k(["-C",r,"sparse-checkout","set",...m],{timeoutMs:e.timeoutMs,allowFileProtocol:!0,logger:e.logger})}return await ee(r,e.resolvedCommit,{timeoutMs:e.timeoutMs,allowFileProtocol:!0,logger:e.logger}),await k(["-C",r,"checkout","--quiet","--detach",e.resolvedCommit],{timeoutMs:e.timeoutMs,allowFileProtocol:!0,logger:e.logger}),{usedCache:a}},at=async e=>{Q(e.sourceId,"sourceId");const r=await ie(g.join(He(),`docs-cache-${e.sourceId}-`));try{const{usedCache:t}=await st(e,r);return{repoDir:r,cleanup:async()=>{await I(r)},fromCache:t}}catch(t){throw await I(r),t}},Y=e=>K(e),nt=e=>{let r="",t=!1;for(const i of e){if(t){r+=i,t=!1;continue}if(i==="\\"){r+=i,t=!0;continue}if(i==="("||i===")"){r+=`\\${i}`;continue}r+=i}return r},ge=e=>e.map(r=>{let t=r;if(r.includes("%"))try{t=decodeURIComponent(r)}catch{t=r}return/(^|[^\\])[@!+?*]\(/.test(t)?t:nt(t)}),re=Number(process.env.DOCS_CACHE_STREAM_THRESHOLD_MB??"2"),ct=Number.isFinite(re)&&re>0?Math.floor(re*1024*1024):1024*1024,lt=(e,r)=>{const t=g.resolve(e);if(!g.resolve(r).startsWith(t+g.sep))throw new Error(`Path traversal detected: ${r}`)},we=async e=>{try{return await q(e,le.O_RDONLY|le.O_NOFOLLOW)}catch(r){const t=B(r);if(t==="ELOOP")return null;if(t==="EINVAL"||t==="ENOSYS"||t==="ENOTSUP")return(await Pe(e)).isSymbolicLink()?null:await q(e,"r");throw r}},ut=(e,r)=>{if(!r||e.length===0)return null;let t="";for(;;){let i=null;for(const n of e){const s=(t?n.normalized.slice(t.length):n.normalized).split("/");if(s.length<2)return t||null;const a=s[0];if(!i){i=a;continue}if(i!==a)return t||null}if(!i)return t||null;const o=`${t}${i}/`;if(o===t)return t||null;t=o}},ft=e=>({...e,exclude:e.exclude??[],ignoreHidden:e.ignoreHidden??!1,unwrapSingleRootDir:e.unwrapSingleRootDir??!1,json:e.json??!1}),mt=async(e,r=5e3)=>{const t=Date.now();for(;Date.now()-t<r;)try{const i=await q(e,"wx");return{release:async()=>{await i.close(),await j(e,{force:!0})}}}catch(i){if(B(i)!=="EEXIST")throw i;await new Promise(o=>setTimeout(o,100))}throw new Error(`Failed to acquire lock for ${e}.`)},dt=async e=>{const r=ft(e);Q(r.sourceId,"sourceId");const t=Oe(r.cacheDir,r.sourceId);await b(r.cacheDir,{recursive:!0});const i=await ie(g.join(r.cacheDir,`.tmp-${r.sourceId}-`));let o=null;const n=async()=>{const s=o;!s||s.closed||s.destroyed||await new Promise(a=>{const l=()=>{s.off("close",u),s.off("error",f),a()},u=()=>l(),f=()=>l();s.once("close",u),s.once("error",f);try{s.end()}catch{l()}})};try{const s=[".git/**",...r.ignoreHidden?[".*","**/.*","**/.*/**"]:[],...r.exclude],a=ge(r.include),l=await ue(a,{cwd:r.repoDir,ignore:s,dot:!0,onlyFiles:!0,followSymbolicLinks:!1});!r.json&&a.length>0&&l.length===0&&$.line(`${T.warn} No files matched include patterns for ${r.sourceId}: ${a.join(", ")}`);const u=l.map(c=>({relativePath:c,normalized:Y(c)})).sort((c,D)=>c.normalized.localeCompare(D.normalized)),f=ut(u,r.unwrapSingleRootDir),m=new Set;for(const{normalized:c}of u){const D=f?c.slice(f.length):c;m.add(g.posix.dirname(D))}await Promise.all(Array.from(m,c=>b(g.join(i,c),{recursive:!0})));let y=0,d=0;const h=Math.max(1,Math.min(u.length,Math.max(8,Math.min(128,je.cpus().length*8)))),S=g.join(i,U),w=ce(S,{encoding:"utf8"});o=w;const x=N("sha256"),p=async c=>new Promise((D,O)=>{const C=P=>{w.off("drain",M),O(P)},M=()=>{w.off("error",C),D()};w.once("error",C),w.write(c)?(w.off("error",C),D()):w.once("drain",M)});for(let c=0;c<u.length;c+=h){const D=u.slice(c,c+h),O=await Promise.all(D.map(async C=>{const M=g.join(r.repoDir,C.relativePath),P=await we(M);if(!P)return null;try{const R=await P.stat();if(!R.isFile())return null;const G=f?C.normalized.slice(f.length):C.normalized,X=g.join(i,G);if(lt(i,X),R.size>=ct){const W=Ye(M,{fd:P.fd,autoClose:!1}),$e=ce(X);await Ge(W,$e)}else{const W=await P.readFile();await se(X,W)}return{path:f?C.normalized.slice(f.length):C.normalized,size:R.size}}finally{await P.close()}}));for(const C of O){if(!C)continue;if(r.maxFiles!==void 0&&d+1>r.maxFiles)throw new Error(`Materialized content exceeds maxFiles (${r.maxFiles}).`);if(y+=C.size,y>r.maxBytes)throw new Error(`Materialized content exceeds maxBytes (${r.maxBytes}).`);const M=`${JSON.stringify(C)}
-`;x.update(M),await p(M),d+=1}}await new Promise((c,D)=>{w.end(()=>c()),w.once("error",D)});const E=x.digest("hex"),v=async c=>{try{return await _(c),!0}catch{return!1}};return await(async(c,D)=>{const O=await mt(`${D}.lock`);try{const C=await v(D),M=`${D}.bak-${Me(8).toString("hex")}`;C&&await J(D,M);try{await J(c,D)}catch(P){if(C)try{await J(M,D)}catch(R){const G=R instanceof Error?R.message:String(R);process.stderr.write(`Warning: Failed to restore backup: ${G}
-`)}throw P}C&&await j(M,{recursive:!0,force:!0})}finally{await O.release()}})(i,t.sourceDir),{bytes:y,fileCount:d,manifestSha256:E}}catch(s){try{await n()}catch{}throw await j(i,{recursive:!0,force:!0}),s}},ht=async e=>{Q(e.sourceId,"sourceId");const r=ge(e.include),t=await ue(r,{cwd:e.repoDir,ignore:[".git/**",...e.ignoreHidden?[".*","**/.*","**/.*/**"]:[],...e.exclude??[]],dot:!0,onlyFiles:!0,followSymbolicLinks:!1});t.sort((s,a)=>Y(s).localeCompare(Y(a)));let i=0,o=0;const n=N("sha256");for(const s of t){const a=Y(s),l=g.join(e.repoDir,s),u=await we(l);if(u)try{const f=await u.stat();if(!f.isFile())continue;if(e.maxFiles!==void 0&&o+1>e.maxFiles)throw new Error(`Materialized content exceeds maxFiles (${e.maxFiles}).`);if(i+=f.size,i>e.maxBytes)throw new Error(`Materialized content exceeds maxBytes (${e.maxBytes}).`);const m=`${JSON.stringify({path:a,size:f.size})}
-`;n.update(m),o+=1}finally{await u.close()}}return{bytes:i,fileCount:o,manifestSha256:n.digest("hex")}},pt=async(e,r)=>{await r.rm(e,{recursive:!0,force:!0})},gt=async(e,r)=>{if(!e.unwrapSingleRootDir)return e.sourceDir;const t=await r.readdir(e.sourceDir,{withFileTypes:!0}),i=new Set([U,V]),o=t.filter(a=>!(a.isFile()&&i.has(a.name))),n=o.filter(a=>a.isDirectory()),s=o.filter(a=>a.isFile());return n.length!==1||s.length>0?e.sourceDir:g.join(e.sourceDir,n[0].name)},oe=async e=>{const r=e.deps??{cp:Te,mkdir:b,readdir:Ee,rm:j,symlink:xe,stderr:process.stderr},t=await gt(e,r),i=g.dirname(e.targetDir);await r.mkdir(i,{recursive:!0}),await pt(e.targetDir,r);const o=process.platform==="win32"?"copy":"symlink";if((e.mode??o)==="copy"){await r.cp(t,e.targetDir,{recursive:!0});return}const n=process.platform==="win32"?"junction":"dir";try{await r.symlink(t,e.targetDir,n)}catch(s){const a=B(s);if(a&&new Set(["EPERM","EACCES","ENOTSUP","EINVAL"]).has(a)){if(e.explicitTargetMode){const l=s instanceof Error?s.message:String(s);r.stderr.write(`Warning: Failed to create symlink at ${e.targetDir}. Falling back to copy. ${l}
-`)}await r.cp(t,e.targetDir,{recursive:!0});return}throw s}},wt=e=>{const r={dirs:new Map,files:[]};for(const t of e){const i=t.split("/").filter(Boolean);if(i.length===0)continue;let o=r;for(const s of i.slice(0,-1)){let a=o.dirs.get(s);a||(a={dirs:new Map,files:[]},o.dirs.set(s,a)),o=a}const n=i[i.length-1];o.files.push({name:n,path:t})}return r},ye=(e,r,t)=>{const i="  ".repeat(r),o=Array.from(e.dirs.keys()).sort(),n=[...e.files].sort((s,a)=>s.name.localeCompare(a.name));for(const s of o){t.push(`${i}- ${s}/`);const a=e.dirs.get(s);a&&ye(a,r+1,t)}for(const s of n)t.push(`${i}- [${s.name}](./${s.path})`)},yt=(e,r,t)=>{const i=[...e].sort((a,l)=>a.localeCompare(l)),o=new Map;for(const a of i){const l=a.lastIndexOf("/"),u=l===-1?"":a.substring(0,l),f=l===-1?a:a.substring(l+1),m=o.get(u);m?m.push(f):o.set(u,[f])}const n=Array.from(o.keys()).sort(),s=[];s.push(`[${t}]`);for(const a of n){const l=o.get(a);if(!l)continue;const u=l.join(",");a===""?s.push(`root:{${u}}`):s.push(`${a}:{${u}}`)}r.push(s.join("|"))},St=(e,r="compressed")=>{const t=[];if(r==="tree"){t.push(`# ${e.id} - Documentation`),t.push(""),t.push("## Files"),t.push("");const i=wt(e.files);ye(i,0,t)}else{const i=`${e.id} Docs Index`;yt(e.files,t,i)}return t.push(""),t.join(`
-`)},Dt=async e=>{const r=g.join(e,".manifest.jsonl");try{const t=await H(r,"utf8"),i=[];for(const o of t.split(`
-`))if(o.trim()){const n=JSON.parse(o);n.path&&i.push(n.path)}return i}catch{return[]}},vt=async e=>{const r=new Map(e.sources.map(i=>[i.id,i])),t=new Map((e.results??[]).map(i=>[i.id,i]));for(const[i,o]of Object.entries(e.lock.sources)){const n=r.get(i);n?.targetDir&&K(Z(e.configPath,n.targetDir));const s=g.join(e.cacheDir,i);try{await _(s)}catch{continue}const a=await Dt(s),l={id:i,repo:o.repo,ref:o.ref,resolvedCommit:o.resolvedCommit,fileCount:o.fileCount,cachePath:K(g.join(e.cacheDir,i)),files:a},u=n?.toc,f=u!==!1;let m="compressed";typeof u=="string"&&(m=u);const y=g.join(s,V);if(f){if(t.get(i)?.status==="up-to-date")try{await _(y);continue}catch{}let d=null;try{d=await H(y,"utf8")}catch{d=null}const h=St(l,m);d!==null&&d!==h&&$.line(`${T.warn} Overwriting existing ${V} for ${i}`),await se(y,h,"utf8")}else try{await j(y,{force:!0})}catch{}}},Ct=e=>{if(e<1024)return`${e} B`;const r=["KB","MB","GB","TB"];let t=e,i=-1;for(;t>=1024&&i<r.length-1;)t/=1024,i+=1;return`${t.toFixed(1)} ${r[i]}`},L=async e=>{try{return await _(e),!0}catch{return!1}},Se=async(e,r)=>{const t=g.join(e,r);return await L(t)?await L(g.join(t,U)):!1},$t=e=>{if(!e||e.length===0)return[];const r=e.map(t=>t.trim()).filter(t=>t.length>0);return Array.from(new Set(r)).sort()},Mt=["mode","include","exclude","maxBytes","maxFiles","ignoreHidden","unwrapSingleRootDir"],Pt=(e,r)=>e==="include"&&Array.isArray(r)||e==="exclude"&&Array.isArray(r)?$t(r):r,xt=e=>{const r=Mt.map(o=>[o,Pt(o,e[o])]);r.sort(([o],[n])=>o.localeCompare(n));const t=Object.fromEntries(r),i=N("sha256");return i.update(JSON.stringify(t)),i.digest("hex")},De=async(e,r={})=>{const{config:t,resolvedPath:i,sources:o}=await ke(e.configPath),n=t.defaults??Re.defaults,s=Fe(i,t.cacheDir??be,e.cacheDirOverride),a=Ue(i),l=await L(a);let u=null;l&&(u=await ze(a));const f=r.resolveRemoteCommit??Ze,m=e.sourceFilter?.length?o.filter(d=>e.sourceFilter?.includes(d.id)):o,y=await Promise.all(m.map(async d=>{const h=u?.sources?.[d.id],S=d.include??n.include,w=d.exclude??n.exclude,x=xt({...d,include:S,exclude:w});if(e.offline){const c=await Se(s,d.id);return{id:d.id,repo:h?.repo??d.repo,ref:h?.ref??d.ref??n.ref,resolvedCommit:h?.resolvedCommit??"offline",lockCommit:h?.resolvedCommit??null,lockRulesSha256:h?.rulesSha256,status:h&&c?"up-to-date":"missing",bytes:h?.bytes,fileCount:h?.fileCount,manifestSha256:h?.manifestSha256,rulesSha256:x}}const p=await f({repo:d.repo,ref:d.ref,allowHosts:n.allowHosts,timeoutMs:e.timeoutMs,logger:e.verbose&&!e.json?$.debug:void 0}),E=h?.resolvedCommit===p.resolvedCommit&&h?.rulesSha256===x,v=h?E?"up-to-date":"changed":"missing";return{id:d.id,repo:p.repo,ref:p.ref,resolvedCommit:p.resolvedCommit,lockCommit:h?.resolvedCommit??null,lockRulesSha256:h?.rulesSha256,status:v,bytes:h?.bytes,fileCount:h?.fileCount,manifestSha256:h?.manifestSha256,rulesSha256:x}}));return{config:t,configPath:i,cacheDir:s,lockPath:a,lockExists:l,lockData:u,results:y,sources:m,defaults:n}},Et=async()=>{const e=g.resolve(process.cwd(),"package.json");try{const r=await H(e,"utf8"),t=JSON.parse(r.toString());return typeof t.version=="string"?t.version:"0.0.0"}catch{}try{const r=await H(new URL("../package.json",import.meta.url),"utf8"),t=JSON.parse(r.toString());return typeof t.version=="string"?t.version:"0.0.0"}catch{}try{const r=await H(new URL("../../package.json",import.meta.url),"utf8"),t=JSON.parse(r.toString());return typeof t.version=="string"?t.version:"0.0.0"}catch{return"0.0.0"}},Tt=async(e,r)=>{const t=await Et(),i=new Date().toISOString(),o={...r?.sources??{}};for(const n of e.results){const s=o[n.id];o[n.id]={repo:n.repo,ref:n.ref,resolvedCommit:n.resolvedCommit,bytes:n.bytes??s?.bytes??0,fileCount:n.fileCount??s?.fileCount??0,manifestSha256:n.manifestSha256??s?.manifestSha256??n.resolvedCommit,rulesSha256:n.rulesSha256??s?.rulesSha256,updatedAt:i}}return{version:1,generatedAt:i,toolVersion:t,sources:o}},ve=async(e,r={})=>{const t=process.hrtime.bigint();let i=0;const o=await De(e,r);await b(o.cacheDir,{recursive:!0});const n=o.lockData,s=o.results.filter(l=>{const u=o.sources.find(f=>f.id===l.id);return l.status==="missing"&&(u?.required??!0)});if(e.failOnMiss&&s.length>0)throw new Error(`Missing required source(s): ${s.map(l=>l.id).join(", ")}.`);if(!e.lockOnly){const l=o.defaults,u=r.fetchSource??at,f=r.materializeSource??dt,m=new Map,y=async(S,w)=>{const x=S?.length?o.results.filter(p=>S.includes(p.id)):o.results;return(await Promise.all(x.map(async p=>{const E=o.sources.find(c=>c.id===p.id);if(!E)return null;if(w)return{result:p,source:E};let v=m.get(p.id);return v===void 0&&(v=await Se(o.cacheDir,p.id),m.set(p.id,v)),p.status!=="up-to-date"||!v?{result:p,source:E}:null}))).filter(Boolean)},d=async()=>{await Promise.all(o.sources.map(async S=>{if(!S.targetDir)return;const w=Z(o.configPath,S.targetDir);await L(w)||await oe({sourceDir:g.join(o.cacheDir,S.id),targetDir:w,mode:S.targetMode??l.targetMode,explicitTargetMode:S.targetMode!==void 0,unwrapSingleRootDir:S.unwrapSingleRootDir})}))},h=async S=>{const w=e.concurrency??4;let x=0;const p=async()=>{const E=S[x];if(!E||!E.source)return;x+=1;const{result:v,source:c}=E,D=o.lockData?.sources?.[c.id],O=await u({sourceId:c.id,repo:c.repo,ref:c.ref,resolvedCommit:v.resolvedCommit,cacheDir:o.cacheDir,include:c.include??l.include,timeoutMs:e.timeoutMs,logger:e.verbose&&!e.json?$.debug:void 0});e.json||$.step(O.fromCache?"Restoring from cache":"Downloading repo",c.id);try{const C=g.join(o.cacheDir,c.id,U);if(v.status!=="up-to-date"&&D?.manifestSha256&&D?.rulesSha256===v.rulesSha256&&await L(C)){const P=await ht({sourceId:c.id,repoDir:O.repoDir,cacheDir:o.cacheDir,include:c.include??l.include,exclude:c.exclude,maxBytes:c.maxBytes??l.maxBytes,maxFiles:c.maxFiles??l.maxFiles,ignoreHidden:c.ignoreHidden??l.ignoreHidden});if(P.manifestSha256===D.manifestSha256){v.bytes=P.bytes,v.fileCount=P.fileCount,v.manifestSha256=P.manifestSha256,v.status="up-to-date",e.json||$.item(T.success,c.id,"no content changes"),await p();return}}e.json||$.step("Materializing",c.id);const M=await f({sourceId:c.id,repoDir:O.repoDir,cacheDir:o.cacheDir,include:c.include??l.include,exclude:c.exclude,maxBytes:c.maxBytes??l.maxBytes,maxFiles:c.maxFiles??l.maxFiles,ignoreHidden:c.ignoreHidden??l.ignoreHidden,unwrapSingleRootDir:c.unwrapSingleRootDir,json:e.json});if(c.targetDir){const P=Z(o.configPath,c.targetDir);await oe({sourceDir:g.join(o.cacheDir,c.id),targetDir:P,mode:c.targetMode??l.targetMode,explicitTargetMode:c.targetMode!==void 0,unwrapSingleRootDir:c.unwrapSingleRootDir})}v.bytes=M.bytes,v.fileCount=M.fileCount,v.manifestSha256=M.manifestSha256,e.json||$.item(T.success,c.id,`synced ${M.fileCount} files`)}finally{await O.cleanup()}await p()};await Promise.all(Array.from({length:Math.min(w,S.length)},p))};if(e.offline)await d();else{const S=await y();await h(S),await d()}if(!e.offline){const S=(await ae({configPath:o.configPath,cacheDirOverride:o.cacheDir})).results.filter(w=>!w.ok);if(S.length>0){const w=await y(S.map(p=>p.id),!0);w.length>0&&(await h(w),await d());const x=(await ae({configPath:o.configPath,cacheDirOverride:o.cacheDir})).results.filter(p=>!p.ok);if(x.length>0&&(i+=1,!e.json)){const p=x.map(E=>`${E.id} (${E.issues.join("; ")})`).join(", ");$.line(`${T.warn} Verify failed for ${x.length} source(s): ${p}`)}}}}const a=await Tt(o,n);if(await Be(o.lockPath,a),!e.json){const l=Number(process.hrtime.bigint()-t)/1e6,u=o.results.reduce((m,y)=>m+(y.bytes??0),0),f=o.results.reduce((m,y)=>m+(y.fileCount??0),0);$.line(`${T.info} Completed in ${l.toFixed(0)}ms \xB7 ${Ct(u)} \xB7 ${f} files${i?` \xB7 ${i} warning${i===1?"":"s"}`:""}`)}return await vt({cacheDir:o.cacheDir,configPath:o.configPath,lock:a,sources:o.sources,results:o.results}),o.lockExists=!0,o},Ce=e=>{const r={upToDate:e.results.filter(t=>t.status==="up-to-date").length,changed:e.results.filter(t=>t.status==="changed").length,missing:e.results.filter(t=>t.status==="missing").length};if(e.results.length===0){$.line(`${T.info} No sources to sync.`);return}$.line(`${T.info} ${e.results.length} sources (${r.upToDate} up-to-date, ${r.changed} changed, ${r.missing} missing)`);for(const t of e.results){const i=$.hash(t.resolvedCommit),o=$.hash(t.lockCommit),n=!!t.lockRulesSha256&&!!t.rulesSha256&&t.lockRulesSha256!==t.rulesSha256;if(t.status==="up-to-date"){$.item(T.success,t.id,`${F.dim("up-to-date")} ${F.gray(i)}`);continue}if(t.status==="changed"){if(t.lockCommit===t.resolvedCommit&&n){$.item(T.warn,t.id,`${F.dim("rules changed")} ${F.gray(i)}`);continue}$.item(T.warn,t.id,`${F.dim("changed")} ${F.gray(o)} ${F.dim("->")} ${F.gray(i)}`);continue}$.item(T.warn,t.id,`${F.dim("missing")} ${F.gray(i)}`)}},Ot={__proto__:null,getSyncPlan:De,printSyncPlan:Ce,runSync:ve};export{oe as a,Ce as b,ve as c,fe as e,me as p,A as r,Ot as s};
-//# sourceMappingURL=sync.mjs.map

package/dist/chunks/verify.mjs

@@ -1,2 +0,0 @@
-import{stat as N,access as z}from"node:fs/promises";import h from"node:path";import{c as $,r as v,u as l,b as m}from"../shared/docs-cache.CQiaFDb_.mjs";import{l as M,b as j}from"../shared/docs-cache.CaOcl4OS.mjs";import{createReadStream as k}from"node:fs";import C from"node:readline";const T=t=>typeof t=="object"&&t!==null&&"code"in t&&(typeof t.code=="string"||typeof t.code=="number"||t.code===void 0),y=t=>T(t)&&typeof t.code=="string"?t.code:void 0,_=t=>{if(!t||typeof t!="object")throw new Error("Manifest entry must be an object.");const e=t;if(typeof e.path!="string"||e.path.length===0)throw new Error("Manifest entry path must be a non-empty string.");if(typeof e.size!="number"||Number.isNaN(e.size))throw new Error("Manifest entry size must be a number.");if(e.size<0)throw new Error("Manifest entry size must be zero or greater.");return{path:e.path,size:e.size}},w=".manifest.jsonl",I=async function*(t){const e=h.join(t,w),a=k(e,{encoding:"utf8"}),s=C.createInterface({input:a,crlfDelay:1/0});try{for await(const u of s){const f=u.trim();f&&(yield _(JSON.parse(f)))}}finally{s.close(),a.destroy()}},O=async t=>{try{return await z(t),!0}catch{return!1}},E=async t=>{const{config:e,resolvedPath:a,sources:s}=await M(t.configPath),u=$(a,e.cacheDir??j,t.cacheDirOverride),f=async(i,n)=>{if(!await O(i))return{ok:!1,issues:[n==="source"?"missing source directory":"missing target directory"]};try{let r=0,o=0;for await(const g of I(i)){const D=h.join(i,g.path);try{(await N(D)).size!==g.size&&(o+=1)}catch(p){const d=y(p);if(d==="ENOENT"||d==="ENOTDIR"){r+=1;continue}throw p}}const c=[];return r>0&&c.push(n==="source"?`missing files: ${r}`:`target missing files: ${r}`),o>0&&c.push(n==="source"?`size mismatch: ${o}`:`target size mismatch: ${o}`),{ok:c.length===0,issues:c}}catch(r){const o=y(r);if(o==="ENOENT"||o==="ENOTDIR")return{ok:!1,issues:[n==="source"?"missing manifest":"missing target manifest"]};throw r}},b=await Promise.all(s.map(async i=>{const n=h.join(u,i.id),r=[...(await f(n,"source")).issues];if(i.targetDir&&i.targetMode==="copy"){const o=v(a,i.targetDir),c=await f(o,"target");r.push(...c.issues)}return{id:i.id,ok:r.length===0,issues:r}}));return{cacheDir:u,results:b}},R=t=>{const e=t.results.filter(s=>s.ok).length,a=t.results.length-e;if(t.results.length===0){l.line(`${m.warn} No sources to verify.`);return}l.line(`${m.info} Verified ${t.results.length} sources (${e} ok, ${a} failed)`);for(const s of t.results)s.ok?l.item(m.success,s.id):l.item(m.warn,s.id,s.issues.join(", "))},A={__proto__:null,printVerify:R,verifyCache:E};export{w as M,A as a,y as g,E as v};
-//# sourceMappingURL=verify.mjs.map

package/dist/shared/docs-cache.BOr9BnyP.mjs

@@ -1,5 +0,0 @@
-import{readFile as o,writeFile as f,access as P}from"node:fs/promises";import a from"node:path";import{t as p}from"./docs-cache.CQiaFDb_.mjs";const g=async n=>{try{return await P(n),!0}catch{return!1}},l=n=>{const r=n.trim();if(!r||r.startsWith("#")||r.startsWith("!"))return"";let t=r.replace(/^\//,"");return t=t.replace(/^\.\//,""),t=t.replace(/\/+$/,""),p(t)},d=(n,r)=>{const t=a.isAbsolute(r)?a.resolve(r):a.resolve(n,r),e=a.relative(n,t);return e===".."||e.startsWith(`..${a.sep}`)||a.isAbsolute(e)?null:e.length===0?".":e},u=async(n,r)=>{const t=a.resolve(n,".gitignore"),e=d(n,r);if(!e)return{gitignorePath:t,entry:null,hasEntry:!1};const i=l(e);if(!i)return{gitignorePath:t,entry:null,hasEntry:!1};let s="";await g(t)&&(s=await o(t,"utf8"));const h=s.split(/\r?\n/),c=new Set(h.map(y=>l(y)).filter(Boolean));return{gitignorePath:t,entry:`${i}/`,hasEntry:c.has(i)}},w=async(n,r)=>{const t=await u(n,r);if(!t.entry)return{updated:!1,gitignorePath:t.gitignorePath,entry:null};if(t.hasEntry)return{updated:!1,gitignorePath:t.gitignorePath,entry:t.entry};let e="";await g(t.gitignorePath)&&(e=await o(t.gitignorePath,"utf8"));const i=e.length===0||e.endsWith(`
-`)?"":`
-`,s=`${e}${i}${t.entry}
-`;return await f(t.gitignorePath,s,"utf8"),{updated:!0,gitignorePath:t.gitignorePath,entry:t.entry}};export{w as e,u as g};
-//# sourceMappingURL=docs-cache.BOr9BnyP.mjs.map

package/dist/shared/docs-cache.BSvQNKuf.mjs

@@ -1,2 +0,0 @@
-const h=f=>{const e=f.trim(),p=e.match(/^git@([^:]+):(.+)$/);if(p){const t=p[1],r=p[2],[o,n]=r.split("#",2),i=o.replace(/^\//,""),c=i.split("/").filter(Boolean).pop()?.replace(/\.git$/i,""),s=`git@${t}:${i}`,a=n?.trim()||void 0;return{repoUrl:s,ref:a,inferredId:c}}const d=e.match(/^([^\s/:]+)\/([^\s#]+)(?:#(.+))?$/);if(d){const[,t,r,o]=d;return{repoUrl:`https://github.com/${`${t}/${r}`.replace(/\.git$/i,"")}.git`,ref:o?.trim()||void 0,inferredId:r.replace(/\.git$/i,"")}}const l=e.match(/^(github|gitlab):(.+)$/i);if(l){const t=l[1].toLowerCase(),r=l[2],[o,n]=r.split("#",2),i=o.replace(/^\//,""),c=i.split("/").filter(Boolean).pop()?.replace(/\.git$/i,""),s=t==="gitlab"?"gitlab.com":"github.com",a=i.endsWith(".git")?"":".git",g=`https://${s}/${i}${a}`,$=n?.trim()||void 0;return{repoUrl:g,ref:$,inferredId:c}}try{const t=new URL(e);if(t.protocol==="https:"||t.protocol==="ssh:"){const r=t.pathname.split("/").filter(Boolean).pop()?.replace(/\.git$/i,"");return{repoUrl:e,ref:void 0,inferredId:r}}}catch{}return{repoUrl:e,ref:void 0,inferredId:void 0}};export{h as r};
-//# sourceMappingURL=docs-cache.BSvQNKuf.mjs.map

package/dist/shared/docs-cache.CQiaFDb_.mjs

@@ -1,7 +0,0 @@
-import g from"node:process";import b from"cac";import u from"node:path";import d from"picocolors";var h=(e=>(e[e.Success=0]="Success",e[e.FatalError=1]="FatalError",e[e.InvalidArgument=9]="InvalidArgument",e))(h||{});const E=["add","remove","sync","status","clean","clean-cache","prune","verify","init"],$=new Set(["--source","--target","--target-dir","--id"]),k=new Set(["--config","--cache-dir","--concurrency","--timeout-ms"]),w=e=>{const t=e.findIndex(l=>!l.startsWith("-")),o=t===-1?[]:e.slice(t+1),r=[];let n=-1,c=null,i=!1;const m=new Set(["--config","--cache-dir","--concurrency","--timeout-ms"]);for(let l=0;l<o.length;l+=1){const s=o[l];if(s==="--id"||s.startsWith("--id=")){const a=s==="--id"?o[l+1]:s.slice(5);if(!a||a.startsWith("-"))throw new Error("--id expects a value.");if(s==="--id"&&(l+=1),i&&n!==-1&&r[n]?.id===void 0&&c===null){r[n].id=a,i=!1;continue}if(c!==null)throw new Error("--id must be followed by a source.");c=a,i=!1;continue}if(s==="--source"){const a=o[l+1];if(!a||a.startsWith("-"))throw new Error("--source expects a value.");r.push({repo:a,...c?{id:c}:{}}),n=r.length-1,c=null,i=!0,l+=1;continue}if(s==="--target"||s==="--target-dir"){const a=o[l+1];if(!a||a.startsWith("-"))throw new Error("--target expects a value.");if(n===-1)throw new Error("--target must follow a --source entry.");r[n].targetDir=a,l+=1,i=!1;continue}if(m.has(s)){l+=1,i=!1;continue}if(s.startsWith("--")){i=!1;continue}r.push({repo:s,...c?{id:c}:{}}),n=r.length-1,c=null,i=!0}if(c!==null)throw new Error("--id must be followed by a source.");return r},v=e=>{const t=e.findIndex(n=>!n.startsWith("-")),o=t===-1?[]:e.slice(t+1),r=[];for(let n=0;n<o.length;n+=1){const c=o[n];if(k.has(c)){n+=1;continue}c.startsWith("--")||r.push(c)}return r},W=(e,t)=>{if(e!=="add")for(const o of t){if($.has(o))throw new Error(`${o} is only valid for add.`);if(o.startsWith("--id=")||o.startsWith("--source=")||o.startsWith("--target=")||o.startsWith("--target-dir="))throw new Error(`${o.split("=")[0]} is only valid for add.`)}},S=(e=g.argv)=>{try{const t=b("docs-cache");t.option("--config <path>","Path to config file").option("--cache-dir <path>","Override cache directory").option("--offline","Disable network access").option("--fail-on-miss","Fail when required sources are missing").option("--lock-only","Update lock without materializing files").option("--prune","Prune cache on remove").option("--concurrency <n>","Concurrency limit").option("--json","Output JSON").option("--timeout-ms <n>","Network timeout in milliseconds").option("--silent","Suppress non-error output").option("--verbose","Enable verbose logging").help(),t.command("add [repo...]","Add sources to the config").option("--source <repo>","Source repo").option("--target <dir>","Target directory for source").option("--target-dir <path>","Target directory for source").option("--id <id>","Source id"),t.command("remove <id...>","Remove sources from the config and targets"),t.command("sync","Synchronize cache with config"),t.command("status","Show cache status"),t.command("clean","Remove project cache"),t.command("clean-cache","Clear global git cache"),t.command("prune","Remove unused data"),t.command("verify","Validate cache integrity"),t.command("init","Create a new config interactively");const o=t.parse(e,{run:!1}),r=e.slice(2),n=r.findIndex(a=>!a.startsWith("-")),c=n===-1?void 0:r[n];if(c&&!E.includes(c))throw new Error(`Unknown command '${c}'.`);const i={config:o.options.config,cacheDir:o.options.cacheDir,offline:!!o.options.offline,failOnMiss:!!o.options.failOnMiss,lockOnly:!!o.options.lockOnly,prune:!!o.options.prune,concurrency:o.options.concurrency?Number(o.options.concurrency):void 0,json:!!o.options.json,timeoutMs:o.options.timeoutMs?Number(o.options.timeoutMs):void 0,silent:!!o.options.silent,verbose:!!o.options.verbose};if(i.concurrency!==void 0&&i.concurrency<1)throw new Error("--concurrency must be a positive number.");if(i.timeoutMs!==void 0&&i.timeoutMs<1)throw new Error("--timeout-ms must be a positive number.");W(c??null,r);let m=null;const l=(()=>{switch(c??null){case"add":return m=w(r),m.map(a=>a.repo);case"remove":return v(r);default:return v(r)}})();let s;switch(c??null){case"add":s={command:"add",entries:m??w(r),options:i};break;case"remove":s={command:"remove",ids:l,options:i};break;case"sync":s={command:"sync",options:i};break;case"status":s={command:"status",options:i};break;case"clean":s={command:"clean",options:i};break;case"clean-cache":s={command:"clean-cache",options:i};break;case"prune":s={command:"prune",options:i};break;case"verify":s={command:"verify",options:i};break;case"init":s={command:"init",options:i};break;default:s={command:null,options:i};break}return{command:c??null,options:i,positionals:l,rawArgs:r,help:!!o.options.help,parsed:s}}catch(t){const o=t instanceof Error?t.message:String(t);console.error(o),g.exit(h.InvalidArgument)}},D="TOC.md",f=e=>e.replace(/\\/g,"/"),M=(e,t)=>{const o=u.dirname(u.resolve(e)),r=u.resolve(o,t),n=u.relative(o,r);if(n===".."||n.startsWith(`..${u.sep}`)||u.isAbsolute(n))throw new Error(`targetDir '${t}' escapes project directory. Must be within ${o}.`);if(f(n).split("/").filter(Boolean).includes(".git"))throw new Error("targetDir cannot be within .git directory.");return r},x=(e,t,o)=>{if(o)return u.resolve(o);const r=u.dirname(e);return u.resolve(r,t)},A=(e,t)=>{u.join(e,"repos");const o=u.join(e,t);return{cacheDir:e,sourceDir:o}},O={error:d.red("\u2716"),success:d.green("\u2714"),info:d.blue("\u2139"),warn:d.yellow("\u26A0")};let p=!1,y=!1;const C=e=>{p=e},j=e=>{y=e},I={path:e=>{const t=u.relative(process.cwd(),e),o=t.length<e.length?t:e;return f(o)},hash:e=>e?e.slice(0,7):"-",pad:(e,t)=>e.padEnd(t),line:(e="")=>{p||process.stdout.write(`${e}
-`)},header:(e,t)=>{p||process.stdout.write(`${d.blue("\u2139")} ${e.padEnd(10)} ${t}
-`)},item:(e,t,o)=>{if(p)return;const r=d.bold(t),n=o?d.gray(o):"";process.stdout.write(`  ${e} ${r} ${n}
-`)},step:(e,t,o)=>{if(p)return;const r=d.cyan("\u2192");process.stdout.write(`  ${r} ${e} ${d.bold(t)}${o?` ${d.dim(o)}`:""}
-`)},debug:e=>{p||!y||process.stdout.write(`${d.dim("\u2022")} ${d.dim(e)}
-`)}};export{D,h as E,j as a,O as b,x as c,A as g,S as p,M as r,C as s,f as t,I as u};
-//# sourceMappingURL=docs-cache.CQiaFDb_.mjs.map

package/dist/shared/docs-cache.CaOcl4OS.mjs

@@ -1,3 +0,0 @@
-import{writeFile as I,readFile as T,access as z}from"node:fs/promises";import w from"node:path";import{z as t}from"zod";import{r as L}from"./docs-cache.CQiaFDb_.mjs";const x=t.enum(["symlink","copy"]),M=t.enum(["materialize"]),F=t.enum(["tree","compressed"]),U=t.object({type:t.enum(["commit","manifest"]),value:t.string().nullable()}).strict(),_=t.object({ref:t.string().min(1),mode:M,include:t.array(t.string().min(1)).min(1),exclude:t.array(t.string().min(1)).optional(),targetMode:x.optional(),required:t.boolean(),maxBytes:t.number().min(1),maxFiles:t.number().min(1).optional(),ignoreHidden:t.boolean(),allowHosts:t.array(t.string().min(1)).min(1),toc:t.union([t.boolean(),F]).optional(),unwrapSingleRootDir:t.boolean().optional()}).strict(),P=t.object({id:t.string().min(1),repo:t.string().min(1),targetDir:t.string().min(1).optional(),targetMode:x.optional(),ref:t.string().min(1).optional(),mode:M.optional(),include:t.array(t.string().min(1)).optional(),exclude:t.array(t.string().min(1)).optional(),required:t.boolean().optional(),maxBytes:t.number().min(1).optional(),maxFiles:t.number().min(1).optional(),ignoreHidden:t.boolean().optional(),integrity:U.optional(),toc:t.union([t.boolean(),F]).optional(),unwrapSingleRootDir:t.boolean().optional()}).strict(),J=t.object({$schema:t.string().min(1).optional(),cacheDir:t.string().min(1).optional(),targetMode:x.optional(),defaults:_.partial().optional(),sources:t.array(P)}).strict(),G=/^[a-zA-Z0-9_-]+$/,V=new Set([".","..","CON","PRN","AUX","NUL","COM1","LPT1"]),H=(e,r)=>{if(typeof e!="string"||e.length===0)throw new Error(`${r} must be a non-empty string.`);if(e.length>200)throw new Error(`${r} exceeds maximum length of 200.`);if(!G.test(e))throw new Error(`${r} must contain only alphanumeric characters, hyphens, and underscores.`);if(V.has(e.toUpperCase()))throw new Error(`${r} uses reserved name '${e}'.`);return e},j="docs.config.json",v=".docs",A="package.json",X=process.platform==="win32"?"copy":"symlink",f={cacheDir:v,defaults:{ref:"HEAD",mode:"materialize",include:["**/*.{md,mdx,markdown,mkd,txt,rst,adoc,asciidoc}"],exclude:[],targetMode:X,required:!0,maxBytes:2e8,ignoreHidden:!1,allowHosts:["github.com","gitlab.com","visualstudio.com"],toc:!0,unwrapSingleRootDir:!1},sources:[]},Z=(e,r)=>!e||!r?e===r:e.length!==r.length?!1:e.every((o,a)=>o===r[a]),C=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),R=(e,r)=>{const o={};for(const[a,i]of Object.entries(e)){const d=r[a];if(Array.isArray(i)&&Array.isArray(d)){Z(i,d)||(o[a]=i);continue}if(C(i)&&C(d)){const s=R(i,d);Object.keys(s).length>0&&(o[a]=s);continue}i!==d&&(o[a]=i)}return o},K=e=>{const r={...f,$schema:e.$schema,defaults:{...f.defaults,...e.targetMode?{targetMode:e.targetMode}:void 0}},o=R(e,r),a={$schema:o.$schema,cacheDir:o.cacheDir,targetMode:o.targetMode,defaults:o.defaults,sources:e.sources};return(!a.defaults||Object.keys(a.defaults).length===0)&&delete a.defaults,a},y=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),m=(e,r)=>{if(typeof e!="string"||e.length===0)throw new Error(`${r} must be a non-empty string.`);return e},g=(e,r)=>{if(typeof e!="boolean")throw new Error(`${r} must be a boolean.`);return e},Q=(e,r)=>{if(typeof e!="number"||Number.isNaN(e))throw new Error(`${r} must be a number.`);return e},h=(e,r)=>{const o=Q(e,r);if(o<1)throw new Error(`${r} must be greater than zero.`);return o},p=(e,r)=>{if(!Array.isArray(e)||e.length===0)throw new Error(`${r} must be a non-empty array of strings.`);for(const o of e)if(typeof o!="string"||o.length===0)throw new Error(`${r} must contain non-empty strings.`);return e},k=(e,r)=>{const o=m(e,r);if(o!=="symlink"&&o!=="copy")throw new Error(`${r} must be "symlink" or "copy".`);return o},q=(e,r)=>{if(e!=="materialize")throw new Error(`${r} must be "materialize".`);return e},W=(e,r)=>{if(!y(e))throw new Error(`${r} must be an object.`);const o=e.type;if(o!=="commit"&&o!=="manifest")throw new Error(`${r}.type must be "commit" or "manifest".`);const a=e.value;if(typeof a!="string"&&a!==null)throw new Error(`${r}.value must be a string or null.`);return{type:o,value:a}},B=e=>{if(!y(e))throw new Error("Config must be a JSON object.");const r=J.safeParse(e);if(!r.success){const n=r.error.issues.map(c=>`${c.path.join(".")||"config"} ${c.message}`).join("; ");throw new Error(`Config does not match schema: ${n}.`)}const o=r.data,a=o.cacheDir?m(o.cacheDir,"cacheDir"):v,i=o.defaults,d=o.targetMode!==void 0?k(o.targetMode,"targetMode"):void 0,s=f.defaults;let l=s;if(i!==void 0){if(!y(i))throw new Error("defaults must be an object.");l={ref:i.ref!==void 0?m(i.ref,"defaults.ref"):s.ref,mode:i.mode!==void 0?q(i.mode,"defaults.mode"):s.mode,include:i.include!==void 0?p(i.include,"defaults.include"):s.include,exclude:i.exclude!==void 0?p(i.exclude,"defaults.exclude"):s.exclude,targetMode:i.targetMode!==void 0?k(i.targetMode,"defaults.targetMode"):d??s.targetMode,required:i.required!==void 0?g(i.required,"defaults.required"):s.required,maxBytes:i.maxBytes!==void 0?h(i.maxBytes,"defaults.maxBytes"):s.maxBytes,maxFiles:i.maxFiles!==void 0?h(i.maxFiles,"defaults.maxFiles"):s.maxFiles,ignoreHidden:i.ignoreHidden!==void 0?g(i.ignoreHidden,"defaults.ignoreHidden"):s.ignoreHidden,allowHosts:i.allowHosts!==void 0?p(i.allowHosts,"defaults.allowHosts"):s.allowHosts,toc:i.toc!==void 0?i.toc:s.toc,unwrapSingleRootDir:i.unwrapSingleRootDir!==void 0?g(i.unwrapSingleRootDir,"defaults.unwrapSingleRootDir"):s.unwrapSingleRootDir}}else d!==void 0&&(l={...s,targetMode:d});const E=o.sources.map((n,c)=>{if(!y(n))throw new Error(`sources[${c}] must be an object.`);const u={id:H(n.id,`sources[${c}].id`),repo:m(n.repo,`sources[${c}].repo`)};if(n.targetDir!==void 0&&(u.targetDir=m(n.targetDir,`sources[${c}].targetDir`)),n.targetMode!==void 0){const b=m(n.targetMode,`sources[${c}].targetMode`);if(b!=="symlink"&&b!=="copy")throw new Error(`sources[${c}].targetMode must be "symlink" or "copy".`);u.targetMode=b}return n.ref!==void 0&&(u.ref=m(n.ref,`sources[${c}].ref`)),n.mode!==void 0&&(u.mode=q(n.mode,`sources[${c}].mode`)),n.include!==void 0&&(u.include=p(n.include,`sources[${c}].include`)),n.exclude!==void 0&&(u.exclude=p(n.exclude,`sources[${c}].exclude`)),n.required!==void 0&&(u.required=g(n.required,`sources[${c}].required`)),n.maxBytes!==void 0&&(u.maxBytes=h(n.maxBytes,`sources[${c}].maxBytes`)),n.maxFiles!==void 0&&(u.maxFiles=h(n.maxFiles,`sources[${c}].maxFiles`)),n.ignoreHidden!==void 0&&(u.ignoreHidden=g(n.ignoreHidden,`sources[${c}].ignoreHidden`)),n.integrity!==void 0&&(u.integrity=W(n.integrity,`sources[${c}].integrity`)),n.toc!==void 0&&(u.toc=n.toc),n.unwrapSingleRootDir!==void 0&&(u.unwrapSingleRootDir=g(n.unwrapSingleRootDir,`sources[${c}].unwrapSingleRootDir`)),u}),S=new Set,$=[];for(const n of E)S.has(n.id)&&$.push(n.id),S.add(n.id);if($.length>0)throw new Error(`Duplicate source IDs found: ${$.join(", ")}. Each source must have a unique ID.`);return{cacheDir:a,targetMode:d,defaults:l,sources:E}},Y=e=>{const r=e.defaults??f.defaults;return e.sources.map(o=>({id:o.id,repo:o.repo,targetDir:o.targetDir,targetMode:o.targetMode??r.targetMode,ref:o.ref??r.ref,mode:o.mode??r.mode,include:o.include??r.include,exclude:o.exclude??r.exclude,required:o.required??r.required,maxBytes:o.maxBytes??r.maxBytes,maxFiles:o.maxFiles??r.maxFiles,ignoreHidden:o.ignoreHidden??r.ignoreHidden,integrity:o.integrity,toc:o.toc??r.toc,unwrapSingleRootDir:o.unwrapSingleRootDir??r.unwrapSingleRootDir}))},N=e=>e?w.resolve(e):w.resolve(process.cwd(),j),ee=()=>w.resolve(process.cwd(),A),O=async e=>{try{return await z(e),!0}catch{return!1}},D=async(e,r)=>{let o;try{o=await T(e,"utf8")}catch(s){const l=s instanceof Error?s.message:String(s);throw new Error(`Failed to read config at ${e}: ${l}`)}let a;try{a=JSON.parse(o)}catch(s){const l=s instanceof Error?s.message:String(s);throw new Error(`Invalid JSON in ${e}: ${l}`)}const i=r==="package"?a?.["docs-cache"]:a;if(r==="package"&&i===void 0)throw new Error(`Missing docs-cache config in ${e}.`);const d=B(i);for(const s of d.sources)s.targetDir&&L(e,s.targetDir);return{config:d,resolvedPath:e,sources:Y(d)}},re=async(e,r)=>{const o=`${JSON.stringify(r,null,2)}
-`;await I(e,o,"utf8")},oe=async e=>{const r=N(e),o=w.basename(r)===A;if(e)return D(r,o?"package":"config");if(await O(r))return D(r,"config");const a=ee();if(await O(a))try{return await D(a,"package")}catch{}throw new Error(`No docs.config.json found at ${r} and no docs-cache config in ${a}.`)};export{f as D,H as a,v as b,j as c,oe as l,N as r,K as s,B as v,re as w};
-//# sourceMappingURL=docs-cache.CaOcl4OS.mjs.map

package/dist/shared/docs-cache.kK1DPQIQ.mjs

@@ -1,2 +0,0 @@
-import{access as s}from"node:fs/promises";import{homedir as a}from"node:os";import e from"node:path";const c=()=>{const r=a();switch(process.platform){case"darwin":return e.join(r,"Library","Caches");case"win32":return process.env.LOCALAPPDATA||e.join(r,"AppData","Local");default:return process.env.XDG_CACHE_HOME||e.join(r,".cache")}},t=()=>process.env.DOCS_CACHE_GIT_DIR||e.join(c(),"docs-cache-git"),o=async r=>{try{return await s(r),!0}catch{return!1}};export{o as e,t as r};
-//# sourceMappingURL=docs-cache.kK1DPQIQ.mjs.map