docs-cache 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/chunks/sync.mjs +7 -6
- package/dist/lock.mjs +3 -0
- package/package.json +3 -2
package/dist/chunks/sync.mjs
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
|
-
import{rm as
|
|
2
|
-
`).filter(Boolean);return
|
|
3
|
-
`;await
|
|
4
|
-
`;
|
|
5
|
-
`)}throw
|
|
6
|
-
`;o.update(
|
|
1
|
+
import{createHash as L,randomBytes as me}from"node:crypto";import{rm as $,mkdtemp as N,writeFile as W,mkdir as R,access as X,rename as B,open as j,lstat as he,symlink as we,cp as pe,readFile as J}from"node:fs/promises";import w from"node:path";import M from"picocolors";import{t as _,r as H,D as ge,g as ye,u as v,s as O,a as Se}from"../shared/docs-cache.D9_kM5zq.mjs";import{a as U,l as De,D as ve,b as xe}from"../shared/docs-cache.goBsJvLg.mjs";import{execFile as K}from"node:child_process";import Ce,{tmpdir as q}from"node:os";import{promisify as V}from"node:util";import{writeLock as Pe,resolveLockPath as Ee,readLock as Me}from"../lock.mjs";import{M as z,v as Z}from"./verify.mjs";import{createWriteStream as Q,createReadStream as Oe,constants as ee}from"node:fs";import{pipeline as $e}from"node:stream/promises";import te from"fast-glob";const Te=/^(https?:\/\/)([^@]+)@/i,I=e=>e.replace(Te,"$1***@"),ke=V(K),Fe=3e4,Ie=new Set(["file:","ftp:","data:","javascript:"]),be=e=>{try{const r=new URL(e);if(Ie.has(r.protocol))throw new Error(`Blocked protocol '${r.protocol}' in repo URL '${I(e)}'.`)}catch(r){if(r instanceof TypeError)return;throw r}},Re=e=>{if(be(e),e.startsWith("git@")){const r=e.indexOf("@"),t=e.indexOf(":",r+1);return t===-1?null:e.slice(r+1,t)||null}try{const r=new URL(e);return r.protocol!=="https:"&&r.protocol!=="ssh:"?null:r.hostname||null}catch{return null}},re=(e,r)=>{const t=Re(e);if(!t)throw new Error(`Unsupported repo URL '${I(e)}'. Use HTTPS or SSH.`);const i=t.toLowerCase();if(!r.map(o=>o.toLowerCase()).includes(i))throw new Error(`Host '${t}' is not in allowHosts for '${I(e)}'.`)},oe=e=>{const r=e.trim().split(`
|
|
2
|
+
`).filter(Boolean);return r.length===0?null:r[0].split(/\s+/)[0]||null},_e=async e=>{re(e.repo,e.allowHosts);const{stdout:r}=await ke("git",["ls-remote",e.repo,e.ref],{timeout:e.timeoutMs??Fe,maxBuffer:1024*1024}),t=oe(r);if(!t)throw new Error(`Unable to resolve ref '${e.ref}' for ${I(e.repo)}.`);return{repo:e.repo,ref:e.ref,resolvedCommit:t}},se=V(K),ie=3e4,A=async(e,r)=>{await se("git",["-c","core.hooksPath=/dev/null","-c","submodule.recurse=false","-c","protocol.file.allow=never","-c","protocol.ext.allow=never",...e],{cwd:r?.cwd,timeout:r?.timeoutMs??ie,maxBuffer:1024*1024,env:{PATH:process.env.PATH,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"}}})},Ae=async(e,r,t,i)=>{const o=w.join(t,"archive.tar");await A(["archive","--remote",e,"--format=tar","--output",o,r],{timeoutMs:i}),await se("tar",["-xf",o,"-C",t],{timeout:i??ie,maxBuffer:1024*1024}),await $(o,{force:!0})},Le=e=>{if(!e||e.length===0)return!1;for(const r of e)if(!r||r.includes("**"))return!1;return!0},Ne=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)))},Be=async(e,r)=>{const t=/^[0-9a-f]{7,40}$/i.test(e.ref),i=Le(e.include),o=["clone","--no-checkout","--filter=blob:none","--depth",String(e.depth),"--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 A(o,{timeoutMs:e.timeoutMs}),i){const s=Ne(e.include);s.length>0&&await A(["-C",r,"sparse-checkout","set",...s],{timeoutMs:e.timeoutMs})}await A(["-C",r,"checkout","--detach",e.resolvedCommit],{timeoutMs:e.timeoutMs})},je=async e=>{const r=await N(w.join(q(),`docs-cache-${e.sourceId}-`));try{return await Ae(e.repo,e.resolvedCommit,r,e.timeoutMs),r}catch(t){throw await $(r,{recursive:!0,force:!0}),t}},He=async e=>{U(e.sourceId,"sourceId");try{const r=await je(e);return{repoDir:r,cleanup:async()=>{await $(r,{recursive:!0,force:!0})}}}catch{const r=await N(w.join(q(),`docs-cache-${e.sourceId}-`));try{return await Be(e,r),{repoDir:r,cleanup:async()=>{await $(r,{recursive:!0,force:!0})}}}catch(t){throw await $(r,{recursive:!0,force:!0}),t}}},Ue=async e=>{const r=new Map(e.sources.map(u=>[u.id,u])),t={};for(const[u,m]of Object.entries(e.lock.sources)){const l=r.get(u),h=l?.targetDir?_(H(e.configPath,l.targetDir)):void 0;t[u]={repo:m.repo,ref:m.ref,resolvedCommit:m.resolvedCommit,bytes:m.bytes,fileCount:m.fileCount,manifestSha256:m.manifestSha256,updatedAt:m.updatedAt,cachePath:_(w.join(e.cacheDir,u)),...h?{targetDir:h}:{}}}const i={generatedAt:new Date().toISOString(),cacheDir:_(e.cacheDir),sources:t},o=w.join(e.cacheDir,ge),s=`${JSON.stringify(i,null,2)}
|
|
3
|
+
`;await W(o,s,"utf8")},F=e=>_(e),G=Number(process.env.DOCS_CACHE_STREAM_THRESHOLD_MB??"2"),ze=Number.isFinite(G)&&G>0?Math.floor(G*1024*1024):1024*1024,Ge=(e,r)=>{const t=w.resolve(e);if(!w.resolve(r).startsWith(t+w.sep))throw new Error(`Path traversal detected: ${r}`)},ae=async e=>{try{return await j(e,ee.O_RDONLY|ee.O_NOFOLLOW)}catch(r){const t=r.code;if(t==="ELOOP")return null;if(t==="EINVAL"||t==="ENOSYS"||t==="ENOTSUP")return(await he(e)).isSymbolicLink()?null:await j(e,"r");throw r}},Ye=async(e,r=5e3)=>{const t=Date.now();for(;Date.now()-t<r;)try{const i=await j(e,"wx");return{release:async()=>{await i.close(),await $(e,{force:!0})}}}catch(i){if(i.code!=="EEXIST")throw i;await new Promise(o=>setTimeout(o,100))}throw new Error(`Failed to acquire lock for ${e}.`)},We=async e=>{U(e.sourceId,"sourceId");const r=ye(e.cacheDir,e.sourceId);await R(e.cacheDir,{recursive:!0});const t=await N(w.join(e.cacheDir,`.tmp-${e.sourceId}-`));let i=null;const o=async()=>{const s=i;!s||s.closed||s.destroyed||await new Promise(u=>{const m=()=>{s.off("close",l),s.off("error",h),u()},l=()=>m(),h=()=>m();s.once("close",l),s.once("error",h);try{s.end()}catch{m()}})};try{const s=await te(e.include,{cwd:e.repoDir,ignore:[".git/**",...e.exclude??[]],dot:!0,onlyFiles:!0,followSymbolicLinks:!1});s.sort((f,c)=>F(f).localeCompare(F(c)));const u=new Set;for(const f of s)u.add(w.dirname(f));await Promise.all(Array.from(u,f=>R(w.join(t,f),{recursive:!0})));let m=0,l=0;const h=Math.max(1,Math.min(s.length,Math.max(8,Math.min(128,Ce.cpus().length*8)))),C=w.join(t,z),g=Q(C,{encoding:"utf8"});i=g;const x=L("sha256"),y=async f=>new Promise((c,p)=>{const d=P=>{g.off("drain",a),p(P)},a=()=>{g.off("error",d),c()};g.once("error",d),g.write(f)?(g.off("error",d),c()):g.once("drain",a)});for(let f=0;f<s.length;f+=h){const c=s.slice(f,f+h),p=await Promise.all(c.map(async d=>{const a=F(d),P=w.join(e.repoDir,d),D=await ae(P);if(!D)return null;try{const k=await D.stat();if(!k.isFile())return null;const T=w.join(t,d);if(Ge(t,T),k.size>=ze){const E=Oe(P,{fd:D.fd,autoClose:!1}),de=Q(T);await $e(E,de)}else{const E=await D.readFile();await W(T,E)}return{path:a,size:k.size}}finally{await D.close()}}));for(const d of p){if(!d)continue;if(e.maxFiles!==void 0&&l+1>e.maxFiles)throw new Error(`Materialized content exceeds maxFiles (${e.maxFiles}).`);if(m+=d.size,m>e.maxBytes)throw new Error(`Materialized content exceeds maxBytes (${e.maxBytes}).`);const a=`${JSON.stringify(d)}
|
|
4
|
+
`;x.update(a),await y(a),l+=1}}await new Promise((f,c)=>{g.end(()=>f()),g.once("error",c)});const n=x.digest("hex"),S=async f=>{try{return await X(f),!0}catch{return!1}};return await(async(f,c)=>{const p=await Ye(`${c}.lock`);try{const d=await S(c),a=`${c}.bak-${me(8).toString("hex")}`;d&&await B(c,a);try{await B(f,c)}catch(P){if(d)try{await B(a,c)}catch(D){const k=D instanceof Error?D.message:String(D);process.stderr.write(`Warning: Failed to restore backup: ${k}
|
|
5
|
+
`)}throw P}d&&await $(a,{recursive:!0,force:!0})}finally{await p.release()}})(t,r.sourceDir),{bytes:m,fileCount:l,manifestSha256:n}}catch(s){try{await o()}catch{}throw await $(t,{recursive:!0,force:!0}),s}},Xe=async e=>{U(e.sourceId,"sourceId");const r=await te(e.include,{cwd:e.repoDir,ignore:[".git/**",...e.exclude??[]],dot:!0,onlyFiles:!0,followSymbolicLinks:!1});r.sort((s,u)=>F(s).localeCompare(F(u)));let t=0,i=0;const o=L("sha256");for(const s of r){const u=F(s),m=w.join(e.repoDir,s),l=await ae(m);if(l)try{const h=await l.stat();if(!h.isFile())continue;if(e.maxFiles!==void 0&&i+1>e.maxFiles)throw new Error(`Materialized content exceeds maxFiles (${e.maxFiles}).`);if(t+=h.size,t>e.maxBytes)throw new Error(`Materialized content exceeds maxBytes (${e.maxBytes}).`);const C=`${JSON.stringify({path:u,size:h.size})}
|
|
6
|
+
`;o.update(C),i+=1}finally{await l.close()}}return{bytes:t,fileCount:i,manifestSha256:o.digest("hex")}},Je=async(e,r)=>{await r.rm(e,{recursive:!0,force:!0})},Y=async e=>{const r=e.deps??{cp:pe,mkdir:R,rm:$,symlink:we,stderr:process.stderr},t=w.dirname(e.targetDir);await r.mkdir(t,{recursive:!0}),await Je(e.targetDir,r);const i=process.platform==="win32"?"copy":"symlink";if((e.mode??i)==="copy"){await r.cp(e.sourceDir,e.targetDir,{recursive:!0});return}const o=process.platform==="win32"?"junction":"dir";try{await r.symlink(e.sourceDir,e.targetDir,o)}catch(s){const u=s.code;if(u&&new Set(["EPERM","EACCES","ENOTSUP","EINVAL"]).has(u)){if(e.explicitTargetMode){const m=s instanceof Error?s.message:String(s);r.stderr.write(`Warning: Failed to create symlink at ${e.targetDir}. Falling back to copy. ${m}
|
|
7
|
+
`)}await r.cp(e.sourceDir,e.targetDir,{recursive:!0});return}throw s}},Ke=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]}`},b=async e=>{try{return await X(e),!0}catch{return!1}},ne=async(e,r)=>{const t=w.join(e,r);return await b(t)?await b(w.join(t,z)):!1},ce=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()},qe=e=>{const r={include:ce(e.include),exclude:ce(e.exclude)},t=L("sha256");return t.update(JSON.stringify(r)),t.digest("hex")},le=async(e,r={})=>{const{config:t,resolvedPath:i,sources:o}=await De(e.configPath),s=t.defaults??ve.defaults,u=Se(i,t.cacheDir??xe,e.cacheDirOverride),m=Ee(i),l=await b(m);let h=null;l&&(h=await Me(m));const C=r.resolveRemoteCommit??_e,g=e.sourceFilter?.length?o.filter(y=>e.sourceFilter?.includes(y.id)):o,x=await Promise.all(g.map(async y=>{const n=h?.sources?.[y.id],S=y.include??s.include,f=y.exclude,c=qe({include:S,exclude:f});if(e.offline){const P=await ne(u,y.id);return{id:y.id,repo:n?.repo??y.repo,ref:n?.ref??y.ref??s.ref,resolvedCommit:n?.resolvedCommit??"offline",lockCommit:n?.resolvedCommit??null,lockRulesSha256:n?.rulesSha256,status:n&&P?"up-to-date":"missing",bytes:n?.bytes,fileCount:n?.fileCount,manifestSha256:n?.manifestSha256,rulesSha256:c}}const p=await C({repo:y.repo,ref:y.ref,allowHosts:s.allowHosts,timeoutMs:e.timeoutMs}),d=n?.resolvedCommit===p.resolvedCommit&&n?.rulesSha256===c,a=n?d?"up-to-date":"changed":"missing";return{id:y.id,repo:p.repo,ref:p.ref,resolvedCommit:p.resolvedCommit,lockCommit:n?.resolvedCommit??null,lockRulesSha256:n?.rulesSha256,status:a,bytes:n?.bytes,fileCount:n?.fileCount,manifestSha256:n?.manifestSha256,rulesSha256:c}}));return{config:t,configPath:i,cacheDir:u,lockPath:m,lockExists:l,lockData:h,results:x,sources:g,defaults:s}},Ve=async()=>{const e=w.resolve(process.cwd(),"package.json");try{const r=await J(e,"utf8"),t=JSON.parse(r.toString());return typeof t.version=="string"?t.version:"0.0.0"}catch{}try{const r=await J(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"}},Ze=async(e,r)=>{const t=await Ve(),i=new Date().toISOString(),o={...r?.sources??{}};for(const s of e.results){const u=o[s.id];o[s.id]={repo:s.repo,ref:s.ref,resolvedCommit:s.resolvedCommit,bytes:s.bytes??u?.bytes??0,fileCount:s.fileCount??u?.fileCount??0,manifestSha256:s.manifestSha256??u?.manifestSha256??s.resolvedCommit,rulesSha256:s.rulesSha256??u?.rulesSha256,updatedAt:i}}return{version:1,generatedAt:i,toolVersion:t,sources:o}},ue=async(e,r={})=>{const t=process.hrtime.bigint();let i=0;const o=await le(e,r);await R(o.cacheDir,{recursive:!0});const s=o.lockData,u=o.results.filter(l=>{const h=o.sources.find(C=>C.id===l.id);return l.status==="missing"&&(h?.required??!0)});if(e.failOnMiss&&u.length>0)throw new Error(`Missing required source(s): ${u.map(l=>l.id).join(", ")}.`);if(!e.lockOnly){const l=o.defaults,h=r.fetchSource??He,C=r.materializeSource??We,g=async(n,S)=>{const f=n?.length?o.results.filter(c=>n.includes(c.id)):o.results;return(await Promise.all(f.map(async c=>{const p=o.sources.find(a=>a.id===c.id);if(!p)return null;const d=await ne(o.cacheDir,c.id);return S||c.status!=="up-to-date"||!d?{result:c,source:p}:null}))).filter(Boolean)},x=async()=>{await Promise.all(o.sources.map(async n=>{if(!n.targetDir)return;const S=H(o.configPath,n.targetDir);await b(S)||await Y({sourceDir:w.join(o.cacheDir,n.id),targetDir:S,mode:n.targetMode??l.targetMode,explicitTargetMode:n.targetMode!==void 0})}))},y=async n=>{const S=e.concurrency??4;let f=0;const c=async()=>{const p=n[f];if(!p||!p.source)return;f+=1;const{result:d,source:a}=p,P=o.lockData?.sources?.[a.id];e.json||v.step("Fetching",a.id);const D=await h({sourceId:a.id,repo:a.repo,ref:a.ref,resolvedCommit:d.resolvedCommit,cacheDir:o.cacheDir,depth:a.depth??l.depth,include:a.include??l.include,timeoutMs:e.timeoutMs});try{const k=w.join(o.cacheDir,a.id,z);if(d.status!=="up-to-date"&&P?.manifestSha256&&await b(k)){const E=await Xe({sourceId:a.id,repoDir:D.repoDir,cacheDir:o.cacheDir,include:a.include??l.include,exclude:a.exclude,maxBytes:a.maxBytes??l.maxBytes,maxFiles:a.maxFiles??l.maxFiles});if(E.manifestSha256===P.manifestSha256){d.bytes=E.bytes,d.fileCount=E.fileCount,d.manifestSha256=E.manifestSha256,d.status="up-to-date",e.json||v.item(O.success,a.id,"no content changes"),await c();return}}const T=await C({sourceId:a.id,repoDir:D.repoDir,cacheDir:o.cacheDir,include:a.include??l.include,exclude:a.exclude,maxBytes:a.maxBytes??l.maxBytes,maxFiles:a.maxFiles??l.maxFiles});if(a.targetDir){const E=H(o.configPath,a.targetDir);await Y({sourceDir:w.join(o.cacheDir,a.id),targetDir:E,mode:a.targetMode??l.targetMode,explicitTargetMode:a.targetMode!==void 0})}d.bytes=T.bytes,d.fileCount=T.fileCount,d.manifestSha256=T.manifestSha256,e.json||v.item(O.success,a.id,`synced ${T.fileCount} files`)}finally{await D.cleanup()}await c()};await Promise.all(Array.from({length:Math.min(S,n.length)},c))};if(e.offline)await x();else{const n=await g();await y(n),await x()}if(!e.offline){const n=(await Z({configPath:o.configPath,cacheDirOverride:o.cacheDir})).results.filter(S=>!S.ok);if(n.length>0){const S=await g(n.map(c=>c.id),!0);S.length>0&&(await y(S),await x());const f=(await Z({configPath:o.configPath,cacheDirOverride:o.cacheDir})).results.filter(c=>!c.ok);if(f.length>0&&(i+=1,!e.json)){const c=f.map(p=>`${p.id} (${p.issues.join("; ")})`).join(", ");v.line(`${O.warn} Verify failed for ${f.length} source(s): ${c}`)}}}}const m=await Ze(o,s);if(await Pe(o.lockPath,m),!e.json){const l=Number(process.hrtime.bigint()-t)/1e6,h=o.results.reduce((g,x)=>g+(x.bytes??0),0),C=o.results.reduce((g,x)=>g+(x.fileCount??0),0);v.line(`${O.info} Completed in ${l.toFixed(0)}ms \xB7 ${Ke(h)} \xB7 ${C} files${i?` \xB7 ${i} warning${i===1?"":"s"}`:""}`)}return o.config.index&&await Ue({cacheDir:o.cacheDir,configPath:o.configPath,lock:m,sources:o.sources}),o.lockExists=!0,o},fe=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){v.line(`${O.info} No sources to sync.`);return}v.line(`${O.info} ${e.results.length} sources (${r.upToDate} up-to-date, ${r.changed} changed, ${r.missing} missing)`);for(const t of e.results){const i=v.hash(t.resolvedCommit),o=v.hash(t.lockCommit),s=!!t.lockRulesSha256&&!!t.rulesSha256&&t.lockRulesSha256!==t.rulesSha256;if(t.status==="up-to-date"){v.item(O.success,t.id,`${M.dim("up-to-date")} ${M.gray(i)}`);continue}if(t.status==="changed"){if(t.lockCommit===t.resolvedCommit&&s){v.item(O.warn,t.id,`${M.dim("rules changed")} ${M.gray(i)}`);continue}v.item(O.warn,t.id,`${M.dim("changed")} ${M.gray(o)} ${M.dim("->")} ${M.gray(i)}`);continue}v.item(O.warn,t.id,`${M.dim("missing")} ${M.gray(i)}`)}},Qe={__proto__:null,getSyncPlan:le,printSyncPlan:fe,runSync:ue};export{Y as a,fe as b,ue as c,re as e,oe as p,I as r,Qe as s};
|
|
7
8
|
//# sourceMappingURL=sync.mjs.map
|
package/dist/lock.mjs
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import{readFile as m,writeFile as d}from"node:fs/promises";import c from"node:path";const u="docs.lock",a=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),i=(e,o)=>{if(typeof e!="string"||e.length===0)throw new Error(`${o} must be a non-empty string.`);return e},w=(e,o)=>{if(typeof e!="number"||Number.isNaN(e))throw new Error(`${o} must be a number.`);return e},l=(e,o)=>{const n=w(e,o);if(n<0)throw new Error(`${o} must be zero or greater.`);return n},f=e=>{if(!a(e))throw new Error("Lock file must be a JSON object.");if(e.version!==1)throw new Error("Lock file version must be 1.");const o=i(e.generatedAt,"generatedAt"),n=i(e.toolVersion,"toolVersion");if(!a(e.sources))throw new Error("sources must be an object.");const t={};for(const[r,s]of Object.entries(e.sources)){if(!a(s))throw new Error(`sources.${r} must be an object.`);t[r]={repo:i(s.repo,`sources.${r}.repo`),ref:i(s.ref,`sources.${r}.ref`),resolvedCommit:i(s.resolvedCommit,`sources.${r}.resolvedCommit`),bytes:l(s.bytes,`sources.${r}.bytes`),fileCount:l(s.fileCount,`sources.${r}.fileCount`),manifestSha256:i(s.manifestSha256,`sources.${r}.manifestSha256`),rulesSha256:s.rulesSha256===void 0?void 0:i(s.rulesSha256,`sources.${r}.rulesSha256`),updatedAt:i(s.updatedAt,`sources.${r}.updatedAt`)}}return{version:1,generatedAt:o,toolVersion:n,sources:t}},h=e=>c.resolve(c.dirname(e),u),b=async e=>{let o;try{o=await m(e,"utf8")}catch(t){const r=t instanceof Error?t.message:String(t);throw new Error(`Failed to read lock file at ${e}: ${r}`)}let n;try{n=JSON.parse(o)}catch(t){const r=t instanceof Error?t.message:String(t);throw new Error(`Invalid JSON in ${e}: ${r}`)}return f(n)},$=async(e,o)=>{const n=`${JSON.stringify(o,null,2)}
|
|
2
|
+
`;await d(e,n,"utf8")};export{u as DEFAULT_LOCK_FILENAME,b as readLock,h as resolveLockPath,f as validateLock,$ as writeLock};
|
|
3
|
+
//# sourceMappingURL=lock.mjs.map
|
package/package.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "docs-cache",
|
|
3
3
|
"private": false,
|
|
4
4
|
"type": "module",
|
|
5
|
-
"version": "0.1.
|
|
5
|
+
"version": "0.1.2",
|
|
6
6
|
"description": "CLI for deterministic local caching of external documentation for agents and tools",
|
|
7
7
|
"author": "Frederik Bosch",
|
|
8
8
|
"license": "MIT",
|
|
@@ -34,6 +34,7 @@
|
|
|
34
34
|
"bin",
|
|
35
35
|
"dist/cli.mjs",
|
|
36
36
|
"dist/chunks/*.mjs",
|
|
37
|
+
"dist/lock.mjs",
|
|
37
38
|
"dist/shared/*.mjs",
|
|
38
39
|
"README.md",
|
|
39
40
|
"LICENSE"
|
|
@@ -78,7 +79,7 @@
|
|
|
78
79
|
"build": "unbuild",
|
|
79
80
|
"dev": "unbuild --stub",
|
|
80
81
|
"lint": "biome check .",
|
|
81
|
-
"release": "pnpm run lint && pnpm run typecheck && bumpp && pnpm
|
|
82
|
+
"release": "pnpm run lint && pnpm run typecheck && bumpp && pnpm publish --access public",
|
|
82
83
|
"test": "pnpm build && node --test",
|
|
83
84
|
"test:coverage": "pnpm build && c8 --include dist --exclude bin --reporter=text node --test",
|
|
84
85
|
"bench": "pnpm build && node scripts/benchmarks/run.mjs",
|