@deveco-test/deveco-cli 1.3.0-Test.14 → 1.3.0-Test.16

package/dist/internal/doc-init-background.js

@@ -1 +1 @@
-import*as L from"fs";import re from"proper-lockfile";import ne from"ora";import*as m from"fs";import*as b from"path";var G=["harmonyos-guides","harmonyos-references","best-practices","harmonyos-faqs","harmonyos-releases","harmonyos-roadmap"],N={"harmonyos-guides":"\u5F00\u53D1\u6307\u5357","harmonyos-references":"API\u53C2\u8003","best-practices":"\u6700\u4F73\u5B9E\u8DF5","harmonyos-faqs":"FAQ","harmonyos-releases":"\u7248\u672C\u8BF4\u660E","harmonyos-roadmap":"\u53D8\u66F4\u9884\u544A"};var O="1.9.1",ge=48*1024*1024;var he=Object.fromEntries(G.map((t,e)=>[N[t],e])),P=Object.fromEntries(G.map((t,e)=>[t,e]));import*as T from"fs";import*as a from"path";import{fileURLToPath as gt}from"url";import*as p from"fs";import*as mt from"path";import{homedir as Gt}from"os";import*as ut from"fs";import*as l from"path";function j(t,e){let r=l.relative(e,t);return r===""||!l.isAbsolute(r)&&!r.startsWith(`..${l.sep}`)&&r!==".."}function E(t){let e=l.resolve(t),r=[],n=e;for(;;)try{let o=ut.realpathSync(n);return r.length===0?o:l.join(o,...r.reverse())}catch(o){if(o.code!=="ENOENT")throw o;let u=l.dirname(n);if(u===n)return e;r.push(l.basename(n)),n=u}}function lt(t,e){let r=E(e),n=E(t);return j(n,r)?n:null}function Z(t){let e=t.trim();return(e.startsWith('"')&&e.endsWith('"')||e.startsWith("'")&&e.endsWith("'"))&&(e=e.slice(1,-1).trim()),e}function dt(t){let e=Z(t);if(!e)throw new Error("Path must not be empty.");return E(e)}var jt="deveco-cli",H,h=class extends Error{constructor(e){super(e),this.name="CliDataDirError"}};function pt(){let t=process.env.DEVECO_CLI_DATA_DIR,r=(t===void 0||t===""?"":Z(t))||mt.join(Gt(),".local","share",jt);try{return dt(r)}catch(n){throw new h(n instanceof Error?n.message:String(n))}}async function ft(){let t=pt();await p.promises.mkdir(t,{recursive:!0});let e;try{e=await p.promises.realpath(t)}catch(n){throw new h(`DEVECO_CLI_DATA_DIR is not usable: ${n instanceof Error?n.message:String(n)}`)}if(!(await p.promises.stat(e)).isDirectory())throw new h("DEVECO_CLI_DATA_DIR must be a writable directory.");return H=e,e}function M(){if(H!==void 0)return H;let t=pt();try{if(p.existsSync(t))return p.realpathSync(t)}catch{}return t}var Zt="docs";function Q(){return a.join(M(),Zt)}function c(){return a.join(Q(),".index")}function B(){return a.join(c(),"build.lock")}function D(){return a.join(c(),"build-status.json")}function _(){return a.join(c(),"build-meta.json")}function x(){return a.join(c(),"search.db")}function A(){return a.join(c(),".tmp")}function Ht(t,e){let r=e;for(;!r.endsWith(`${a.sep}dist`)&&r!==a.dirname(r);)r=a.dirname(r);return r}function ht(t,e){return a.dirname(Ht(t,e))}function St(){let t=gt(import.meta.url),e=a.dirname(t);return t.includes(`${a.sep}dist${a.sep}`)?ht(t,e):a.join(e,"..","..","..")}function Qt(...t){let e=gt(import.meta.url),r=a.dirname(e);return e.includes(`${a.sep}dist${a.sep}`)?[a.join(ht(e,r),...t)]:[a.join(r,"..","..","..",...t)]}function yt(...t){let e=St(),r=T.realpathSync(e);for(let n of Qt(...t))try{let o=T.lstatSync(n);if(o.isSymbolicLink()||!o.isFile())throw new Error(`Unsafe documentation package asset: ${t.join("/")} must be a regular file.`);let u=T.realpathSync(n);if(!j(u,r))throw new Error(`Unsafe documentation package asset: ${t.join("/")} is outside the package.`);return u}catch(o){if(o.code!=="ENOENT")throw o}return null}function C(){return yt("docs.zip")}function X(){return yt("index.zip")}function Et(){return a.join(St(),"index","data")}import*as S from"fs";import*as I from"path";var f=["harmonyos-terms.txt","harmonyos-synonyms.json","harmonyos-stopwords.txt"],W=class extends Error{constructor(e){super(e),this.name="LexiconNotFoundError"}};var _t=null;function Xt(){if(_t)return _t;let t=c();if(f.every(o=>S.existsSync(I.join(t,o))))return t;let r=Et();if(f.every(o=>S.existsSync(I.join(r,o))))return r;throw new W("Lexicon files not found. Install the documentation index first (index.zip).")}function $(t){let e=I.join(Xt(),t);return S.readFileSync(e,"utf-8")}function xt(t,e){return S.readFileSync(I.join(e,t),"utf-8")}import*as q from"fs";import*as Wt from"yauzl";function Y(){let t=C();return t!==null&&q.existsSync(t)}import*as d from"fs";import*as g from"path";import At from"adm-zip";import*as w from"fs";import*as v from"path";var F=class extends Error{constructor(e){super(`Unsafe documentation path: ${e}`),this.name="DocPathSafetyError"}};function K(t){return t instanceof h||t instanceof F||t instanceof Error&&(t.name==="CliDataDirError"||t.name==="DocPathSafetyError")}function tt(t){return new F(t)}function $t(){return E(M())}function J(t,e,r){let n=lt(t,e);if(n===null)throw tt(`${r} resolves outside the data directory.`);return n}async function V(t,e){await w.promises.mkdir(t,{recursive:!0});let r=J(t,e,"directory");if(!(await w.promises.stat(r)).isDirectory())throw tt("path must be a directory.")}function qt(t){let e=$t();try{let r=J(t,e,"file");if(!w.statSync(r).isFile())throw tt("path must be a regular file.")}catch(r){if(r.code==="ENOENT"){J(v.dirname(t),e,"file parent");return}throw r}}async function k(t={}){let e=t.mode??"write",r=await ft();await V(Q(),r),await V(c(),r),e==="write"&&await V(A(),r);for(let n of[x(),_(),D(),B(),...f.map(o=>v.join(c(),o))])qt(n)}var et=["search.db","build-meta.json",...f],Yt=["corpus.json","corpus-offsets.json","orama.dpack"];async function Vt(t){for(let e of Yt)await d.promises.rm(g.join(t,e),{force:!0})}function Ct(t){let r=new At(t).getEntry("build-meta.json");if(!r)throw new Error("index.zip is missing build-meta.json");return JSON.parse(r.getData().toString("utf-8"))}async function Jt(t){let e=c();await d.promises.mkdir(e,{recursive:!0});for(let r of et){let n=g.join(e,r);await d.promises.rm(n,{force:!0}),await d.promises.rename(g.join(t,r),n)}await Vt(e),await d.promises.rm(A(),{recursive:!0,force:!0})}function Tt(t){let e=X();if(!e)return!1;try{let r=Ct(e);return r.indexVersion===O&&r.docsZipSha256===t&&r.segmentCount>0}catch{return!1}}async function Dt(t){await k({mode:"write"});let e=X();if(!e)throw new Error("index.zip not found");let r=Ct(e);if(r.docsZipSha256!==t)throw new Error("Bundled index.zip does not match docs.zip. Rebuild index.zip with npm run build:index.");if(r.segmentCount<=0)throw new Error("Bundled index.zip is empty");let n=A();await d.promises.rm(n,{recursive:!0,force:!0}),await d.promises.mkdir(n,{recursive:!0});let o=new At(e);for(let y of et){let ct=o.getEntry(y);if(!ct)throw new Error(`index.zip is missing ${y}`);await d.promises.writeFile(g.join(n,y),ct.getData())}let u=JSON.parse(await d.promises.readFile(g.join(n,"build-meta.json"),"utf-8"));if(!d.existsSync(g.join(n,"search.db")))throw new Error("index.zip is missing search.db");return await Jt(n),u}async function It(){await d.promises.rm(A(),{recursive:!0,force:!0});let t=c();for(let e of et)await d.promises.rm(g.join(t,e),{force:!0})}import{createHash as wt}from"crypto";import*as bt from"fs";async function z(t){return new Promise((e,r)=>{let n=wt("sha256"),o=bt.createReadStream(t);o.on("data",u=>n.update(u)),o.on("error",r),o.on("end",()=>e(n.digest("hex")))})}function Rt(t){return wt("sha256").update(t,"utf8").digest("hex")}function Lt(t,e){let r=e?xt(t,e):$(t);return Rt(r)}function Nt(t){return Lt("harmonyos-synonyms.json",t)}function Ot(t){return Lt("harmonyos-terms.txt",t)}var Kt={state:"idle",phase:0,phaseLabel:"Idle",current:0,total:0,message:"",startedAt:0,updatedAt:0,error:null};async function Pt(){try{let t=await m.promises.readFile(D(),"utf-8");return JSON.parse(t)}catch{return{...Kt}}}async function rt(t){let e=D();await m.promises.mkdir(b.dirname(e),{recursive:!0}),await m.promises.writeFile(e,JSON.stringify(t,null,2))}function Mt(t){let e=Date.now();return{state:"installing",phase:1,phaseLabel:"Preparing documentation index",current:0,total:0,message:t,startedAt:e,updatedAt:e,error:null}}async function R(t){let r={...await Pt(),...t,updatedAt:Date.now()};return await rt(r),r}async function nt(){let t=C();return t?z(t):null}async function ot(){try{let t=await m.promises.readFile(_(),"utf-8");return JSON.parse(t)}catch{return null}}async function it(t=!1){if(t)return"no-index";let e=await ot();if(!e||e.segmentCount===0)return"no-index";let r=await nt();return r&&e.docsZipSha256!==r?"docs-changed":e.indexVersion!==O?"engine-upgraded":e.termsHash!==Ot()?"terms-changed":e.synonymsHash!==Nt()?"synonyms-changed":null}function st(){if(!Y()||!m.existsSync(x())||!m.existsSync(_()))return!1;let t=b.dirname(x());if(!f.every(e=>m.existsSync(b.join(t,e))))return!1;try{let e=m.readFileSync(_(),"utf-8");return JSON.parse(e).segmentCount>0}catch{return!1}}async function Bt(t=!1){return t?!0:Y()?st()?await it()!==null:!0:!1}import{createRequire as te}from"module";var Wr=te(import.meta.url);var Ft=["harmonyos-releases","harmonyos-roadmap"],Tn=new Set(Ft.map(t=>P[t])),Dn=Ft.map(t=>`${N[t]}/`);var ee=null,vt=null;function kt(){vt?.resetCache(),ee=null,vt=null}function at(){kt()}async function zt(t,e,r){e?.start(r),await R({state:"installing",phase:1,phaseLabel:"Installing index",message:r}),await Dt(t),at(),e&&(e.text="Documentation index installed.")}async function oe(t,e){try{return await zt(t,e,"Installing documentation index\u2026"),await Ut(e),!0}catch(r){if(K(r))throw r}try{return await It(),at(),await zt(t,e,"Retrying documentation index install\u2026"),await Ut(e),!0}catch(r){if(K(r))throw r;return!1}}async function Ut(t){await R({state:"done",phase:3,phaseLabel:"Done",message:"Documentation ready.",error:null}),t?.succeed("Documentation ready.")}async function ie(t){let e=await ot(),r=e?`Documentation already up to date. Documents: ${e.segmentCount.toLocaleString()}`:"Documentation already up to date.";t?.succeed(r),await R({state:"done",message:r,error:null})}async function se(t,e){let r=t instanceof Error?t.message:String(t);throw await R({state:"error",error:r}),e?.fail(r),t}async function ae(){let t=c();await L.promises.mkdir(t,{recursive:!0});let e=B();return L.existsSync(e)||await L.promises.writeFile(e,"","utf-8"),e}async function ce(){let t=await ae();return re.lock(t,{stale:1800*1e3})}async function ue(){let t=C(),e=(t?await z(t):null)??await nt();if(!e)throw new Error("docs.zip not found");return e}async function le(t,e){let r=await ue(),n=t.force||await Bt(t.force),o=await it(t.force);if(!n&&!o&&st()){await ie(e);return}if(!(Tt(r)&&await oe(r,e)))throw new Error("Documentation index bundle is unavailable or corrupted. Reinstall the package with: npm uninstall -g @deveco/deveco-cli && npm install -g <package.tgz>")}var U=class{static async run(e={}){let r=e.background??!1,o=e.quiet??r?void 0:ne({text:"Checking documentation\u2026",color:"cyan"}),u;try{e.assumeStorageSafe||await k({mode:"write"}),u=await ce(),await rt(Mt("Starting documentation setup\u2026")),await le(e,o)}catch(y){throw u&&await se(y,o),y}finally{u&&await u()}}};var de=process.env.DEVECO_CLI_POSTINSTALL?"postinstall":"doc-init";U.run({background:!0,builtBy:de}).then(()=>{process.exit(0)}).catch(()=>{process.exit(1)});
+import*as L from"fs";import re from"proper-lockfile";import ne from"ora";import*as m from"fs";import*as b from"path";var G=["harmonyos-guides","harmonyos-references","best-practices","harmonyos-faqs","harmonyos-releases","harmonyos-roadmap"],O={"harmonyos-guides":"\u5F00\u53D1\u6307\u5357","harmonyos-references":"API\u53C2\u8003","best-practices":"\u6700\u4F73\u5B9E\u8DF5","harmonyos-faqs":"FAQ","harmonyos-releases":"\u7248\u672C\u8BF4\u660E","harmonyos-roadmap":"\u53D8\u66F4\u9884\u544A"};var N="1.9.1",ge=48*1024*1024;var he=Object.fromEntries(G.map((t,e)=>[O[t],e])),P=Object.fromEntries(G.map((t,e)=>[t,e]));import*as w from"fs";import*as a from"path";import{fileURLToPath as gt}from"url";import*as p from"fs";import*as mt from"path";import{homedir as Gt}from"os";import*as ut from"fs";import*as l from"path";function j(t,e){let r=l.relative(e,t);return r===""||!l.isAbsolute(r)&&!r.startsWith(`..${l.sep}`)&&r!==".."}function E(t){let e=l.resolve(t),r=[],n=e;for(;;)try{let o=ut.realpathSync(n);return r.length===0?o:l.join(o,...r.reverse())}catch(o){if(o.code!=="ENOENT")throw o;let u=l.dirname(n);if(u===n)return e;r.push(l.basename(n)),n=u}}function lt(t,e){let r=E(e),n=E(t);return j(n,r)?n:null}function Z(t){let e=t.trim();return(e.startsWith('"')&&e.endsWith('"')||e.startsWith("'")&&e.endsWith("'"))&&(e=e.slice(1,-1).trim()),e}function dt(t){let e=Z(t);if(!e)throw new Error("Path must not be empty.");return E(e)}var jt="deveco-cli",H,h=class extends Error{constructor(e){super(e),this.name="CliDataDirError"}};function pt(){let t=process.env.DEVECO_CLI_DATA_DIR,r=(t===void 0||t===""?"":Z(t))||mt.join(Gt(),".local","share",jt);try{return dt(r)}catch(n){throw new h(n instanceof Error?n.message:String(n))}}async function ft(){let t=pt();await p.promises.mkdir(t,{recursive:!0});let e;try{e=await p.promises.realpath(t)}catch(n){throw new h(`DEVECO_CLI_DATA_DIR is not usable: ${n instanceof Error?n.message:String(n)}`)}if(!(await p.promises.stat(e)).isDirectory())throw new h("DEVECO_CLI_DATA_DIR must be a writable directory.");return H=e,e}function M(){if(H!==void 0)return H;let t=pt();try{if(p.existsSync(t))return p.realpathSync(t)}catch{}return t}var Zt="docs";function Q(){return a.join(M(),Zt)}function c(){return a.join(Q(),".index")}function B(){return a.join(c(),"build.lock")}function T(){return a.join(c(),"build-status.json")}function _(){return a.join(c(),"build-meta.json")}function x(){return a.join(c(),"search.db")}function A(){return a.join(c(),".tmp")}function Ht(t,e){let r=e;for(;!r.endsWith(`${a.sep}dist`)&&r!==a.dirname(r);)r=a.dirname(r);return r}function ht(t,e){return a.dirname(Ht(t,e))}function St(){let t=gt(import.meta.url),e=a.dirname(t);return t.includes(`${a.sep}dist${a.sep}`)?ht(t,e):a.join(e,"..","..","..")}function Qt(...t){let e=gt(import.meta.url),r=a.dirname(e);return e.includes(`${a.sep}dist${a.sep}`)?[a.join(ht(e,r),...t)]:[a.join(r,"..","..","..",...t)]}function yt(...t){let e=St(),r=w.realpathSync(e);for(let n of Qt(...t))try{let o=w.lstatSync(n);if(o.isSymbolicLink()||!o.isFile())throw new Error(`Unsafe documentation package asset: ${t.join("/")} must be a regular file.`);let u=w.realpathSync(n);if(!j(u,r))throw new Error(`Unsafe documentation package asset: ${t.join("/")} is outside the package.`);return u}catch(o){if(o.code!=="ENOENT")throw o}return null}function C(){return yt("docs.zip")}function X(){return yt("index.zip")}function Et(){return a.join(St(),"index","data")}import*as S from"fs";import*as D from"path";var f=["harmonyos-terms.txt","harmonyos-synonyms.json","harmonyos-stopwords.txt"],W=class extends Error{constructor(e){super(e),this.name="LexiconNotFoundError"}};var _t=null;function Xt(){if(_t)return _t;let t=c();if(f.every(o=>S.existsSync(D.join(t,o))))return t;let r=Et();if(f.every(o=>S.existsSync(D.join(r,o))))return r;throw new W("Lexicon files not found. Install the documentation index first (index.zip).")}function $(t){let e=D.join(Xt(),t);return S.readFileSync(e,"utf-8")}function xt(t,e){return S.readFileSync(D.join(e,t),"utf-8")}import*as q from"fs";import*as Wt from"yauzl";function Y(){let t=C();return t!==null&&q.existsSync(t)}import*as d from"fs";import*as g from"path";import At from"adm-zip";import*as I from"fs";import*as v from"path";var F=class extends Error{constructor(e){super(`Unsafe documentation path: ${e}`),this.name="DocPathSafetyError"}};function K(t){return t instanceof h||t instanceof F||t instanceof Error&&(t.name==="CliDataDirError"||t.name==="DocPathSafetyError")}function tt(t){return new F(t)}function $t(){return E(M())}function J(t,e,r){let n=lt(t,e);if(n===null)throw tt(`${r} resolves outside the data directory.`);return n}async function V(t,e){await I.promises.mkdir(t,{recursive:!0});let r=J(t,e,"directory");if(!(await I.promises.stat(r)).isDirectory())throw tt("path must be a directory.")}function qt(t){let e=$t();try{let r=J(t,e,"file");if(!I.statSync(r).isFile())throw tt("path must be a regular file.")}catch(r){if(r.code==="ENOENT"){J(v.dirname(t),e,"file parent");return}throw r}}async function k(t={}){let e=t.mode??"write",r=await ft();await V(Q(),r),await V(c(),r),e==="write"&&await V(A(),r);for(let n of[x(),_(),T(),B(),...f.map(o=>v.join(c(),o))])qt(n)}var et=["search.db","build-meta.json",...f],Yt=["corpus.json","corpus-offsets.json","orama.dpack"];async function Vt(t){for(let e of Yt)await d.promises.rm(g.join(t,e),{force:!0})}function Ct(t){let r=new At(t).getEntry("build-meta.json");if(!r)throw new Error("index.zip is missing build-meta.json");return JSON.parse(r.getData().toString("utf-8"))}async function Jt(t){let e=c();await d.promises.mkdir(e,{recursive:!0});for(let r of et){let n=g.join(e,r);await d.promises.rm(n,{force:!0}),await d.promises.rename(g.join(t,r),n)}await Vt(e),await d.promises.rm(A(),{recursive:!0,force:!0})}function wt(t){let e=X();if(!e)return!1;try{let r=Ct(e);return r.indexVersion===N&&r.docsZipSha256===t&&r.segmentCount>0}catch{return!1}}async function Tt(t){await k({mode:"write"});let e=X();if(!e)throw new Error("index.zip not found");let r=Ct(e);if(r.docsZipSha256!==t)throw new Error("Bundled index.zip does not match docs.zip. Rebuild index.zip with npm run build:index.");if(r.segmentCount<=0)throw new Error("Bundled index.zip is empty");let n=A();await d.promises.rm(n,{recursive:!0,force:!0}),await d.promises.mkdir(n,{recursive:!0});let o=new At(e);for(let y of et){let ct=o.getEntry(y);if(!ct)throw new Error(`index.zip is missing ${y}`);await d.promises.writeFile(g.join(n,y),ct.getData())}let u=JSON.parse(await d.promises.readFile(g.join(n,"build-meta.json"),"utf-8"));if(!d.existsSync(g.join(n,"search.db")))throw new Error("index.zip is missing search.db");return await Jt(n),u}async function Dt(){await d.promises.rm(A(),{recursive:!0,force:!0});let t=c();for(let e of et)await d.promises.rm(g.join(t,e),{force:!0})}import{createHash as It}from"crypto";import*as bt from"fs";async function z(t){return new Promise((e,r)=>{let n=It("sha256"),o=bt.createReadStream(t);o.on("data",u=>n.update(u)),o.on("error",r),o.on("end",()=>e(n.digest("hex")))})}function Rt(t){return It("sha256").update(t,"utf8").digest("hex")}function Lt(t,e){let r=e?xt(t,e):$(t);return Rt(r)}function Ot(t){return Lt("harmonyos-synonyms.json",t)}function Nt(t){return Lt("harmonyos-terms.txt",t)}var Kt={state:"idle",phase:0,phaseLabel:"Idle",current:0,total:0,message:"",startedAt:0,updatedAt:0,error:null};async function Pt(){try{let t=await m.promises.readFile(T(),"utf-8");return JSON.parse(t)}catch{return{...Kt}}}async function rt(t){let e=T();await m.promises.mkdir(b.dirname(e),{recursive:!0}),await m.promises.writeFile(e,JSON.stringify(t,null,2))}function Mt(t){let e=Date.now();return{state:"installing",phase:1,phaseLabel:"Preparing documentation index",current:0,total:0,message:t,startedAt:e,updatedAt:e,error:null}}async function R(t){let r={...await Pt(),...t,updatedAt:Date.now()};return await rt(r),r}async function nt(){let t=C();return t?z(t):null}async function ot(){try{let t=await m.promises.readFile(_(),"utf-8");return JSON.parse(t)}catch{return null}}async function it(t=!1){if(t)return"no-index";let e=await ot();if(!e||e.segmentCount===0)return"no-index";let r=await nt();return r&&e.docsZipSha256!==r?"docs-changed":e.indexVersion!==N?"engine-upgraded":e.termsHash!==Nt()?"terms-changed":e.synonymsHash!==Ot()?"synonyms-changed":null}function st(){if(!Y()||!m.existsSync(x())||!m.existsSync(_()))return!1;let t=b.dirname(x());if(!f.every(e=>m.existsSync(b.join(t,e))))return!1;try{let e=m.readFileSync(_(),"utf-8");return JSON.parse(e).segmentCount>0}catch{return!1}}async function Bt(t=!1){return t?!0:Y()?st()?await it()!==null:!0:!1}import{createRequire as te}from"module";var Wr=te(import.meta.url);var Ft=["harmonyos-releases","harmonyos-roadmap"],wn=new Set(Ft.map(t=>P[t])),Tn=Ft.map(t=>`${O[t]}/`);var oo=Promise.resolve();var ee=null,vt=null;function kt(){vt?.resetCache(),ee=null,vt=null}function at(){kt()}async function zt(t,e,r){e?.start(r),await R({state:"installing",phase:1,phaseLabel:"Installing index",message:r}),await Tt(t),at(),e&&(e.text="Documentation index installed.")}async function oe(t,e){try{return await zt(t,e,"Installing documentation index\u2026"),await Ut(e),!0}catch(r){if(K(r))throw r}try{return await Dt(),at(),await zt(t,e,"Retrying documentation index install\u2026"),await Ut(e),!0}catch(r){if(K(r))throw r;return!1}}async function Ut(t){await R({state:"done",phase:3,phaseLabel:"Done",message:"Documentation ready.",error:null}),t?.succeed("Documentation ready.")}async function ie(t){let e=await ot(),r=e?`Documentation already up to date. Documents: ${e.segmentCount.toLocaleString()}`:"Documentation already up to date.";t?.succeed(r),await R({state:"done",message:r,error:null})}async function se(t,e){let r=t instanceof Error?t.message:String(t);throw await R({state:"error",error:r}),e?.fail(r),t}async function ae(){let t=c();await L.promises.mkdir(t,{recursive:!0});let e=B();return L.existsSync(e)||await L.promises.writeFile(e,"","utf-8"),e}async function ce(){let t=await ae();return re.lock(t,{stale:1800*1e3})}async function ue(){let t=C(),e=(t?await z(t):null)??await nt();if(!e)throw new Error("docs.zip not found");return e}async function le(t,e){let r=await ue(),n=t.force||await Bt(t.force),o=await it(t.force);if(!n&&!o&&st()){await ie(e);return}if(!(wt(r)&&await oe(r,e)))throw new Error("Documentation index bundle is unavailable or corrupted. Reinstall the package with: npm uninstall -g @deveco/deveco-cli && npm install -g <package.tgz>")}var U=class{static async run(e={}){let r=e.background??!1,o=e.quiet??r?void 0:ne({text:"Checking documentation\u2026",color:"cyan"}),u;try{e.assumeStorageSafe||await k({mode:"write"}),u=await ce(),await rt(Mt("Starting documentation setup\u2026")),await le(e,o)}catch(y){throw u&&await se(y,o),y}finally{u&&await u()}}};var de=process.env.DEVECO_CLI_POSTINSTALL?"postinstall":"doc-init";U.run({background:!0,builtBy:de}).then(()=>{process.exit(0)}).catch(()=>{process.exit(1)});

package/dist/internal/telemetry-upload-background.js

@@ -0,0 +1,9 @@
+import At from"path";import*as S from"fs";import*as K from"path";import{homedir as pt}from"os";import*as U from"fs";import*as d from"path";function V(r){let t=d.resolve(r),e=[],n=t;for(;;)try{let i=U.realpathSync(n);return e.length===0?i:d.join(i,...e.reverse())}catch(i){if(i.code!=="ENOENT")throw i;let o=d.dirname(n);if(o===n)return t;e.push(d.basename(n)),n=o}}function R(r){let t=r.trim();return(t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'"))&&(t=t.slice(1,-1).trim()),t}function z(r){let t=R(r);if(!t)throw new Error("Path must not be empty.");return V(t)}var ft="deveco-cli",H,$=class extends Error{constructor(t){super(t),this.name="CliDataDirError"}};function dt(){let r=process.env.DEVECO_CLI_DATA_DIR,e=(r===void 0||r===""?"":R(r))||K.join(pt(),".local","share",ft);try{return z(e)}catch(n){throw new $(n instanceof Error?n.message:String(n))}}function J(){if(H!==void 0)return H;let r=dt();try{if(S.existsSync(r))return S.realpathSync(r)}catch{}return r}import ut from"crypto";import m from"fs";import B from"os";import v from"path";import vt from"https";var W={devecoApiTraceUpload:"https://cn.devecostudio.huawei.com/codeGenie/cli/trace/upload"};import*as c from"fs";import*as L from"path";import*as D from"os";import*as h from"path";import Yt from"json5";function Y(){if(process.platform==="win32"){let r=process.env.LOCALAPPDATA??h.join(D.homedir(),"AppData","Local");return h.join(r,"devecocli-mcp-server","logs")}return process.platform==="darwin"?h.join(D.homedir(),"Library","Logs","devecocli-mcp-server"):h.join(D.homedir(),".local","share","devecocli-mcp-server","logs")}var q="mcp-server.log",gt="mcp-server",ht={maxSize:10*1024*1024,maxFiles:4},P=class r{fd=null;logDir=null;currentLogFile=null;mode;rotationOptions;currentFileSize=0;currentDate="";isRotating=!1;minLevel;static LEVEL_ORDER={debug:0,info:1,warn:2,error:3};constructor(t,e){this.rotationOptions={...ht,...e},this.minLevel=t?"debug":"info",t?(this.mode="console",this.logDir=null,this.currentLogFile=null):(this.mode="file",this.logDir=Y(),this.currentLogFile=L.join(this.logDir,q),c.existsSync(this.logDir)||c.mkdirSync(this.logDir,{recursive:!0}),this.cleanupOrphanLogFiles(),this.openLogFile())}getCurrentDateString(){let t=new Date,e=t.getFullYear(),n=String(t.getMonth()+1).padStart(2,"0"),i=String(t.getDate()).padStart(2,"0");return`${e}-${n}-${i}`}getRotatedFileName(t,e){return L.join(this.logDir,`${gt}-${t}.log.${e}`)}fileExists(t){try{return c.accessSync(t,c.constants.F_OK),!0}catch{return!1}}cleanupOrphanLogFiles(){if(this.logDir)try{let t=c.readdirSync(this.logDir),e=[];for(let i of t)if(i===q||/^mcp-server-\d{4}-\d{2}-\d{2}\.log\.\d+$/.test(i)){let o=L.join(this.logDir,i),a=c.statSync(o);e.push({name:i,mtime:a.mtime,path:o})}e.sort((i,o)=>o.mtime.getTime()-i.mtime.getTime());let n=1+this.rotationOptions.maxFiles;for(let i=n;i<e.length;i++)try{c.unlinkSync(e[i].path)}catch{}}catch{}}rotateLog(){if(!(this.isRotating||!this.logDir||!this.currentLogFile)){this.isRotating=!0;try{if(this.closeLogFile(),!this.fileExists(this.currentLogFile)){this.isRotating=!1,this.openLogFile();return}let t=this.getCurrentDateString(),e=this.getRotatedFileName(t,this.rotationOptions.maxFiles);this.fileExists(e)&&c.unlinkSync(e);for(let i=this.rotationOptions.maxFiles-1;i>=1;i--){let o=this.getRotatedFileName(t,i),a=this.getRotatedFileName(t,i+1);this.fileExists(o)&&c.renameSync(o,a)}let n=this.getRotatedFileName(t,1);c.renameSync(this.currentLogFile,n),this.cleanupOrphanLogFiles(),this.openLogFile()}catch{this.openLogFile()}finally{this.isRotating=!1}}}openLogFile(){if(this.currentLogFile){this.currentDate=this.getCurrentDateString();try{if(this.fileExists(this.currentLogFile)){let t=c.statSync(this.currentLogFile);this.currentFileSize=t.size}else this.currentFileSize=0}catch{this.currentFileSize=0}try{this.fd=c.openSync(this.currentLogFile,"a")}catch{this.fd=null}}}closeLogFile(){if(this.fd!==null){try{c.closeSync(this.fd)}catch{}this.fd=null}}checkRotation(t){let e=this.getCurrentDateString();this.currentDate&&this.currentDate!==e&&(this.rotateLog(),this.currentDate=e),this.currentFileSize+=t,this.currentFileSize>=this.rotationOptions.maxSize&&this.rotateLog()}write(t,e,...n){if(this.mode==="silent"||r.LEVEL_ORDER[t]<r.LEVEL_ORDER[this.minLevel])return;let i=n.map(l=>l instanceof Error?`${l.name}: ${l.message}`:typeof l=="object"?JSON.stringify(l,null,2):String(l)).join(" "),o=i?`${e} ${i}`:e,f=`[${new Date().toLocaleString("sv-SE",{timeZone:"Asia/Shanghai",hour12:!1})+"."+String(new Date().getMilliseconds()).padStart(3,"0")}] [MCP/${t.toUpperCase()}] ${o}
+`;if(this.mode==="file"&&this.currentLogFile){if(this.fd===null&&this.openLogFile(),this.fd!==null)try{let l=Buffer.from(f);c.writeSync(this.fd,l),this.checkRotation(l.byteLength)}catch{this.closeLogFile(),this.openLogFile()}}else this.mode==="console"&&process.stderr.write(f)}debug(t,...e){this.write("debug",t,...e)}info(t,...e){this.write("info",t,...e)}warn(t,...e){this.write("warn",t,...e)}error(t,...e){this.write("error",t,...e)}dispose(){this.closeLogFile()}flush(){if(!(this.mode!=="file"||this.fd===null))try{c.fsyncSync(this.fd)}catch{}}getLogFilePath(){return this.currentLogFile}getLogDirectory(){return this.logDir}},E=null;function yt(r=!1){E&&E.dispose(),E=new P(r)}function C(){return E||yt(!1),E}var s={debug:(r,...t)=>C().debug(r,...t),info:(r,...t)=>C().info(r,...t),warn:(r,...t)=>C().warn(r,...t),error:(r,...t)=>C().error(r,...t)};var _=class r{static DEBUG=!0;static ENDPOINT=W.devecoApiTraceUpload;static SENDER="deveco-cli";async upload(t,e){let n={"Content-Type":"application/json",sender:r.SENDER,deviceid:e.replace(/-/g,""),"Content-Length":String(Buffer.byteLength(t,"utf8"))};r.log(`upload request: URL=${r.ENDPOINT}`);try{let{code:i,body:o}=await this.httpPost(r.ENDPOINT,n,Buffer.from(t,"utf8"),6e4);return r.log(`upload response: status=${i}, body=${o}`),r.isSuccess(o)}catch(i){return r.log(`upload failed: ${i instanceof Error?i.message:String(i)}`),!1}}static isSuccess(t){try{let e=JSON.parse(t),n=e?.code??e?.errorCode;return String(n)==="200"}catch{return!1}}async httpPost(t,e,n,i){let o=new URL(t);return new Promise((a,f)=>{let l=vt.request({protocol:o.protocol,hostname:o.hostname,port:o.port||(o.protocol==="https:"?443:80),path:o.pathname+o.search,method:"POST",headers:e,timeout:i},y=>{let g=[];y.on("data",w=>g.push(w)),y.on("end",()=>{a({code:y.statusCode??0,body:Buffer.concat(g).toString("utf8")})})});l.on("timeout",()=>{l.destroy(new Error("request timeout"))}),l.on("error",f),l.write(n),l.end()})}static log(t){r.DEBUG&&s.info("[TRACE]"+t)}};var X={identity:r=>r,camelCase:r=>r,snakeCase:r=>r.replace(/([a-z0-9])([A-Z])/g,"$1_$2").replace(/([A-Z]+)([A-Z][a-z])/g,"$1_$2").toLowerCase()},N=class{constructor(t={}){this.config=t}config;serialize(t){let e=this.transform(t);return this.config.pretty?JSON.stringify(e,null,2):JSON.stringify(e)}toObject(t){return this.transform(t)}transform(t){if(t==null)return t;if(Array.isArray(t))return t.map(o=>this.transform(o));if(typeof t!="object")return t;let e=this.config.namingStrategy??X.identity,n=this.config.fieldNames??{},i={};for(let[o,a]of Object.entries(t)){let f=n[o]??e(o);i[f]=this.transform(a)}return i}},G=new N({namingStrategy:X.snakeCase,fieldNames:{}});import x from"crypto";import F from"fs";import St from"path";var k="aes-256-gcm",Et=12,xt="deveco-cli-trace-file",bt="trace-file-secret",Q=32;function Z(r){try{let t=F.readFileSync(r,"utf8").trim();return t&&Buffer.from(t,"base64").length===Q?t:null}catch{return null}}function tt(r){let t=St.join(r,bt),e=Z(t);if(e)return M(e);let n=x.randomBytes(Q).toString("base64");try{F.mkdirSync(r,{recursive:!0});try{F.writeFileSync(t,n,{flag:"wx"})}catch{let i=Z(t);if(i)return M(i);F.writeFileSync(t,n)}}catch{}return M(n)}function M(r){return x.createHash("sha256").update(xt).update(r).digest()}function j(r,t){let e=x.randomBytes(Et),n=x.createCipheriv(k,t,e),i=Buffer.concat([n.update(r,"utf8"),n.final()]),o={version:1,algorithm:k,ciphertext:i.toString("base64"),iv:e.toString("base64"),authTag:n.getAuthTag().toString("base64")};return JSON.stringify(o)}function et(r,t){let e;try{e=JSON.parse(r)}catch{return null}if(!Tt(e))return r;try{let n=x.createDecipheriv(k,t,Buffer.from(e.iv,"base64"));return n.setAuthTag(Buffer.from(e.authTag,"base64")),Buffer.concat([n.update(Buffer.from(e.ciphertext,"base64")),n.final()]).toString("utf8")}catch{return null}}function Tt(r){if(!r||typeof r!="object")return!1;let t=r;return t.version===1&&t.algorithm===k&&typeof t.ciphertext=="string"&&typeof t.iv=="string"&&typeof t.authTag=="string"}import rt from"fs";import wt from"path";var b=300*1e3;function O(){let r=process.env.DEVECO_CLI_DISABLE_TELEMETRY;return r==="1"||r==="true"}var Dt="upload-state.json";function nt(r){return wt.join(r,Dt)}function Ct(){return{firstEventAt:null,lastUploadAt:null}}function it(r){try{let t=rt.readFileSync(nt(r),"utf8"),e=JSON.parse(t);return{firstEventAt:typeof e.firstEventAt=="number"?e.firstEventAt:null,lastUploadAt:typeof e.lastUploadAt=="number"?e.lastUploadAt:null}}catch{return Ct()}}function ot(r,t){try{rt.writeFileSync(nt(r),JSON.stringify(t),"utf8")}catch{}}function st(r){let t=it(r);t.firstEventAt===null&&(t.firstEventAt=Date.now(),ot(r,t))}function at(r){let t=it(r);t.lastUploadAt=Date.now(),t.firstEventAt=null,ot(r,t)}import Lt from"crypto";import A from"fs";import _t from"path";var Ft="install-id";function kt(r){return _t.join(r,Ft)}function ct(r){try{let t=A.readFileSync(r,"utf8").trim();return Ot(t)?t:null}catch{return null}}function Ot(r){return/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(r)}function lt(r){let t=kt(r),e=ct(t);if(e)return e;let n=Lt.randomUUID();try{A.mkdirSync(r,{recursive:!0});try{A.writeFileSync(t,n,{flag:"wx"})}catch{let i=ct(t);if(i)return i;A.writeFileSync(t,n)}}catch{}return n}var T=class r{static MAX_BATCH=200;static MAX_PAYLOAD_BYTES=Math.floor(1.7*1024*1024);static TRACE_OS_VERSION="1.0";static COUNTRY_CODE="CN";static EVENT_PREFIX="devecocli_";uploader=new _;storageDir="";failedDir="";installId="";disabled=O();traceFileKey=Buffer.alloc(0);sessionId=ut.randomUUID();cliVersion="";devecoStudioVersion=null;sourceType="";cltVersion=null;nodeVersion="";initialTimer=null;intervalTimer=null;constructor(){s.info(`[telemetry] instance created, sessionId=${this.sessionId}`)}init(t){this.storageDir=t,this.failedDir=v.join(t,"failed"),this.cliVersion="1.3.0-Test.16",this.nodeVersion=process.version,this.installId=lt(t).replace(/-/g,""),this.traceFileKey=tt(t),m.mkdirSync(t,{recursive:!0}),m.mkdirSync(this.failedDir,{recursive:!0}),s.info(`[telemetry] init: dir=${t}, failedDir=${this.failedDir}, cliVersion=${this.cliVersion}, os=${this.resolveOsName()}, arch=${this.resolveOsArch()}, node=${this.nodeVersion}`)}setStudioVersion(t){this.devecoStudioVersion=t,s.info(`[telemetry] studio version set: ${t}`)}setSourceType(t){this.sourceType=t,s.info(`[telemetry] sourceType set: ${t}`)}setCltVersion(t){this.cltVersion=t,s.info(`[telemetry] CLT version set: ${t}`)}async track(t,e){if(this.disabled)return typeof e=="function"?e():void 0;if(!this.storageDir)throw new Error("Telemetry not initialized. Call init() first.");if(s.info(`[telemetry] track: ${t.event}`),!e){await this.record(t,0,!0,null),s.info(`[telemetry] track recorded: ${t.event} (no measurement)`);return}if(typeof e!="function"){let o=e;await this.record(t,o.duration_ms,o.success,o.error_code),s.info(`[telemetry] track recorded: ${t.event} (measurement: duration=${o.duration_ms}ms, success=${o.success}, code=${o.error_code})`);return}let n=e,i=Date.now();try{let o=await n(),a=Date.now()-i;return await this.record(t,a,!0,null),s.info(`[telemetry] track success: ${t.event}, duration=${a}ms`),o}catch(o){let a=Date.now()-i,f=this.toErrorCode(o);throw await this.record(t,a,!1,f),s.info(`[telemetry] track failed: ${t.event}, duration=${a}ms, code=${f}`),o}}async record(t,e,n,i){let o=this.buildTraceEvent(t,e,n,i);try{let a=j(JSON.stringify(o),this.traceFileKey);await m.promises.appendFile(this.currentFile(),a+`
+`,"utf8"),s.info(`[telemetry] event persisted: ${o.properties.trace_uuid}`),st(this.storageDir)}catch(a){s.error("[telemetry] track write error:",a)}}buildTraceEvent(t,e,n,i){let o=`${r.EVENT_PREFIX}${t.event}`,a=G.toObject(t);return a&&typeof a=="object"&&delete a.event,{countryCode:r.COUNTRY_CODE,event:o,eventtime:String(Date.now()),properties:{uid:this.installId,trace_uuid:ut.randomUUID(),trace_os_version:r.TRACE_OS_VERSION,os_arch:this.resolveOsArch(),action:o,trace_os_name:this.resolveOsName(),version:`${this.cliVersion}_${this.resolveOsSuffix()}`,deveco_studio_version:this.formatVersion(this.devecoStudioVersion),command_line_version:this.formatVersion(this.cltVersion),source_type:this.sourceType,session_id:this.sessionId,node_version:this.nodeVersion,duration_ms:e,success:n,error_code:i,event_detail:a}}}toErrorCode(t){return t instanceof Error?t.code??t.name:"UnknownError"}resolveOsArch(){let t=B.arch();return t==="x64"?"amd64":t}resolveOsName(){switch(process.platform){case"win32":{let t=B.release().split(".");return(parseInt(t[t.length-1],10)||0)>=22e3?"Windows 11":"Windows 10"}case"darwin":return"macOS";case"linux":return"Linux";default:return process.platform}}resolveOsSuffix(){switch(process.platform){case"win32":return"windows";case"darwin":return B.arch()==="arm64"?"mac_arm":"mac";default:return"linux"}}formatVersion(t){return t?`${t}_${this.resolveOsSuffix()}`:""}dateString(){let t=new Date,e=String(t.getMonth()+1).padStart(2,"0"),n=String(t.getDate()).padStart(2,"0");return`${t.getFullYear()}-${e}-${n}`}currentFile(){return v.join(this.storageDir,`telemetry-${this.dateString()}.txt`)}startScheduler(){if(this.stopScheduler(),this.disabled){s.info("[telemetry] scheduler not started (telemetry disabled)");return}s.info(`[telemetry] scheduler started (first flush in ${b/1e3}s, then every ${b/1e3}s)`),this.initialTimer=setTimeout(()=>{this.flush().catch(t=>s.error("[telemetry] flush error:",t)),this.intervalTimer=setInterval(()=>{this.flush().catch(t=>s.error("[telemetry] flush error:",t))},b)},b)}stopScheduler(){this.initialTimer&&(clearTimeout(this.initialTimer),this.initialTimer=null),this.intervalTimer&&(clearInterval(this.intervalTimer),this.intervalTimer=null),s.info("[telemetry] scheduler stopped")}async flush(){if(this.disabled)return!0;if(!this.storageDir)throw new Error("Telemetry not initialized. Call init() first.");s.info("[telemetry] flush start");let t=await this.listPendingFiles();if(t.length===0)return s.info("[telemetry] flush: no event files"),!0;s.info(`[telemetry] flush: ${t.length} file(s) pending`);let e=!0;for(let n of t)await this.flushFile(n)||(e=!1);return s.info(`[telemetry] flush done, allOk=${e}`),at(this.storageDir),e}async listPendingFiles(){let t;try{t=await m.promises.readdir(this.storageDir)}catch{return[]}return t.filter(e=>e.startsWith("telemetry-")&&e.endsWith(".txt")).map(e=>v.join(this.storageDir,e)).sort()}async flushFile(t){let e=t+".pending";try{await m.promises.rename(t,e),s.info(`[telemetry] flush: renamed ${v.basename(t)} \u2192 pending`)}catch{return!1}let n;try{n=await m.promises.readFile(e,"utf8")}catch{return!1}let i=n.split(`
+`).map(f=>f.trim()).filter(Boolean),o=[],a=0;for(let f of i){let l=et(f,this.traceFileKey);if(l===null){a++;continue}o.push(l)}if(a>0&&s.warn(`[telemetry] flush: skipped ${a} undecryptable line(s)`),o.length===0){try{await m.promises.unlink(e)}catch{}return!0}return this.uploadInBatches(e,o)}async uploadInBatches(t,e){let n=0;for(;n<e.length;){let i=n,o=[],a=16;for(;n<e.length&&o.length<r.MAX_BATCH;){let g=e[n],w=Buffer.byteLength(g,"utf8")+1;if(o.length>0&&a+w>r.MAX_PAYLOAD_BYTES)break;o.push(g),a+=w,n++}let f=this.buildPayloadItems(o),l=JSON.stringify(f);s.info(`[telemetry] flush: uploading batch (${f.length} events, ${Buffer.byteLength(l,"utf8")} bytes)`);let y=!1;try{y=await this.uploader.upload(l,this.installId)}catch(g){s.error("[telemetry] build/upload error:",g)}if(!y){let g=e.slice(i).join(`
+`)+`
+`;return await this.moveToFailed(t,g),!1}}try{await m.promises.unlink(t)}catch{}return s.info("[telemetry] flush: file done, pending removed"),!0}buildPayloadItems(t){let e=[];for(let n of t)try{let i=JSON.parse(n);e.push({action:i.event,detail:JSON.stringify(i.properties),timestamp:Number(i.eventtime)||Date.now()})}catch{}return e}async moveToFailed(t,e){let n=v.basename(t,".pending"),i=v.join(this.failedDir,n);s.info(`[telemetry] moving to failed: ${n}`);try{let o=e.split(`
+`).filter(Boolean).map(a=>j(a,this.traceFileKey)).join(`
+`)+`
+`;await m.promises.appendFile(i,o,"utf8")}catch(o){s.error("[telemetry] move to failed error:",o);return}try{await m.promises.unlink(t)}catch{}}};var I=new T;import{spawn as je}from"child_process";import{existsSync as Ue}from"fs";import{dirname as ze,join as He}from"path";import{fileURLToPath as Je}from"url";var It=At.join(J(),"TraceLogData");I.init(It);I.flush().then(r=>{r?s.info("[telemetry] background upload completed"):s.warn("[telemetry] background upload completed with failures")}).catch(r=>{s.error("[telemetry] background upload error:",r),process.exit(1)});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deveco-test/deveco-cli",
-  "version": "1.3.0-Test.14",
+  "version": "1.3.0-Test.16",
   "description": "HarmonyOS application development command line tool",
   "license": "MIT",
   "type": "module",