minidev 0.0.0 → 0.0.1-49682569

package/README.md

@@ -0,0 +1,14 @@
+
+# Minidev - 支付宝小程序开发 Cli 
+
+支付宝小程序开发 cli（minidev）提供了常用的支付宝系小程序开发指令，能够方便地在各类平台上快速进行小程序的开发、预览、上传等操作。
+
+# 基本使用
+
+请参阅我们官方网站的[在线文档](https://opendocs.alipay.com/mini/02q17h)
+
+# 问题反馈
+
+如果您在使用过程中产生任何疑问，或者有任何建议，可以前往支付宝开发者社区 (https://forum.alipay.com/mini-app) 进行提问，或者通过官方钉钉群来联系我们。
+
+![](https://cdn.nlark.com/yuque/0/2021/jpeg/179989/1634201432267-6c65d9ce-dc9f-409b-ab35-d544f214bb94.jpeg?x-oss-process=image%2Fresize%2Cw_600)

package/assets/builder-debug-utils/README.md

@@ -0,0 +1,73 @@
+# builder-debug-utils
+
+```ts
+const debugUtils = require('@alipay/builder-debug-utils');
+
+const debugUtils.generateInjectCodePath({
+  target: 'Mini',
+  mode: 'Preview',
+  compilePlugin: false,
+}); // /Users/foo/bar
+
+tiny-cli --injectCodePath /Users/foo/bar
+```
+
+/offline/assets_map - 用于存储构建脚本文本
+$TMPDIR/builder_debug_output_v2 - 用于作为 tiny-cli injectCodePath 入参
+
+### API
+
+- 检查更新
+  比较本地与服务端资源 sha256 是否相同，若不同更新本地资源
+
+```ts
+const injectCodePath = await updateInjectCodeAssets();
+```
+
+- 生成 injectCode
+
+```ts
+await generateInjectCode({
+  mode: 'Remotex',
+});
+
+generateInjectCodeSync({
+  mode: 'Remotex',
+});
+```
+
+- 生成 injectCodePath
+
+```ts
+await generateInjectCodePath({
+  mode: 'Remotex',
+});
+
+generateInjectCodePathSync({
+  mode: 'Remotex',
+});
+```
+
+- 获取 boatman 资源路径
+
+```ts
+await getBoatmanBundlePath();
+
+getBoatmanBundlePathSync();
+```
+
+## 开发
+
+本地开发可以使用 watch 模式，watch 模式可以通过环境变量来监听指定文件的变化，可以通过 .env 文件来设置哪些文件要监听：
+
+```sh
+touch .env
+```
+
+```env
+BOATMAN_PATH="path/to/boatman"
+```
+
+```sh
+yarn generate:watch
+```

package/assets/builder-debug-utils/dist/index.js

@@ -0,0 +1 @@
+"use strict";var e=require("fs-extra"),t=require("bent"),n=require("crypto"),o=require("os"),a=require("path"),r="undefined"!=typeof globalThis?globalThis:"undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self?self:{};function i(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var s,u,d,l={},c={};s=c,Object.defineProperty(s,"__esModule",{value:!0}),s.ECompileModeType=s.ECompileTargetType=void 0,(u=s.ECompileTargetType||(s.ECompileTargetType={})).Mini="Mini",u.Cube="Cube",(d=s.ECompileModeType||(s.ECompileModeType={})).Remote="Remote",d.Remotex="Remotex",d.RemotexLite="RemotexLite",d.Preview="Preview",d.RemoteBoatman="RemoteBoatman";var p={},f={},m={};Object.defineProperty(m,"__esModule",{value:!0}),m.libName=m.defaultConfig=void 0;const g=o,h=a,y=c;m.defaultConfig={assetsQueryUrl:"https://render.alipay.com/p/h5data/h5config_builder-debug-h5data.json",injectCodeTempPath:(0,h.join)((0,g.tmpdir)(),"./builder_debug_output_v2"),offlineDirectoryPath:(0,h.join)(__dirname,"../offline"),readonlyDirectoryPath:(0,h.join)(__dirname,"../readonly"),assetsMapFilename:"assets_map",boatmanFilename:{[y.ECompileTargetType.Mini]:"boatman_mini",[y.ECompileTargetType.Cube]:"boatman_cube"}},m.libName="builder-debug-utils";var b=r&&r.__awaiter||function(e,t,n,o){return new(n||(n=Promise))((function(a,r){function i(e){try{u(o.next(e))}catch(e){r(e)}}function s(e){try{u(o.throw(e))}catch(e){r(e)}}function u(e){var t;e.done?a(e.value):(t=e.value,t instanceof n?t:new n((function(e){e(t)}))).then(i,s)}u((o=o.apply(e,t||[])).next())}))},C=r&&r.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(f,"__esModule",{value:!0}),f.AssetsUpdater=void 0;const P=C(t),v=C(e),T=C(n),j=m,_=c,w=(0,P.default)("json"),M=(0,P.default)("buffer"),B=`[${j.libName}]`;f.AssetsUpdater=class{constructor(e){this.context=e}updateOfflineAssetsToday(){return b(this,void 0,void 0,(function*(){!function(e){return b(this,void 0,void 0,(function*(){try{const t=yield v.default.stat(e),n=new Date(parseInt(`${t.mtimeMs}`,10));return(new Date).toLocaleDateString()===n.toLocaleDateString()}catch(e){return!1}}))}(this.context.getAssetsMapFilePath())?(console.log(`${B} local assets are outdated, start to download new debug assets`),yield this.updateOfflineAssets()):console.log(`${B} local assets are in the period of validity`)}))}updateOfflineAssets(){return b(this,void 0,void 0,(function*(){if(this.updatingTask)return this.updatingTask;this.updatingTask=this.runUpdateTask();try{yield this.updatingTask,this.updatingTask=void 0}catch(e){throw this.updatingTask=void 0,e}}))}runUpdateTask(){return b(this,void 0,void 0,(function*(){let e;try{e=yield w(j.defaultConfig.assetsQueryUrl)}catch(e){throw new Error("Failed to request online config")}yield Promise.all([this.updateLocalFile(this.context.getAssetsMapFilePath(),e.url_v2,e.integrity_v2),this.updateLocalFile(this.context.getBoatmanFilePath(_.ECompileTargetType.Mini),e.url_boatman_mini,e.integrity_boatman_mini),this.updateLocalFile(this.context.getBoatmanFilePath(_.ECompileTargetType.Cube),e.url_boatman_cube,e.integrity_boatman_cube)])}))}updateLocalFile(e,t,n){return b(this,void 0,void 0,(function*(){if(!t||!n)return void console.error(`${B} Empty key in config`);try{const t=yield v.default.readFile(e);if(T.default.createHash("sha256").update(t).digest("base64")===n)return void console.log(`${B} Local is latested`)}catch(e){}let o;console.log(`${B} Start to update local`);try{o=yield M(t)}catch(e){return void console.error(`${B} Download error ${e.message}`)}if(T.default.createHash("sha256").update(o).digest("base64")!==n)throw new Error("Failed to verify");yield v.default.writeFile(e,o),console.log(`${B} Updated`)}))}};var O={};Object.defineProperty(O,"__esModule",{value:!0}),O.composeAssetsByCompileMode=void 0;const A=c,R=m;function S(...e){return e.join("\n")}function E(e,t){return t.target===A.ECompileTargetType.Cube?{}:{workerTop:e.bugmeWPreview,webTop:`window.__BUGME_ENV__='preview';${e.bugmeRPreview}`,htmlTop:`<script>window.__BUGME_ENV__='preview';${e.bugmeRPreview}<\/script>`}}function I(e){return`<script snapshot-delete="">${null!=e?e:""}<\/script>`}function x(e,t){return{webTop:e.bugmeRRemote,htmlTop:I(e.bugmeRRemote)}}function F(e,t){return t.compilePlugin?{workerTop:e.bugmeWRemote,pluginWorkerTop:e.tyroAgent,webTop:e.bugmeRRemote,htmlTop:I(e.bugmeRRemote)}:{workerTop:S(e.tyroAgent||"",e.bugmeWRemote||""),webTop:e.bugmeRRemote,htmlTop:I(e.bugmeRRemote)}}function D(e,t){return{workerTop:S("var __BUGME_CONSOLE_ENABLE__=true;",e.bugmeWRemote||""),webTop:e.bugmeRRemote,htmlTop:I(e.bugmeRRemote)}}function k(e,t){if(t.target===A.ECompileTargetType.Cube)return{};{const n={webTop:e.bugmeRRemote,htmlTop:I(e.bugmeRRemote)};return t.compilePlugin&&(n.workerTop=e.bugmeWRemote),n}}O.composeAssetsByCompileMode=function(e,t){let n;switch(t.mode){case A.ECompileModeType.Preview:n=E;break;case A.ECompileModeType.Remote:n=x;break;case A.ECompileModeType.Remotex:n=F;break;case A.ECompileModeType.RemotexLite:n=D;break;case A.ECompileModeType.RemoteBoatman:n=k;break;default:throw new Error(`[${R.libName}] unknown compile mode: ${t.mode}`)}return n(e,t)};var $={};Object.defineProperty($,"__esModule",{value:!0}),$.BuilderDebugContext=void 0;const U=a;$.BuilderDebugContext=class{constructor(e){this.assetsQueryUrl="",this.injectCodeTempPath="",this.offlineDirectoryPath="",this.readonlyDirectoryPath="",this.assetsMapFilename="",this.assetsQueryUrl=e.assetsQueryUrl,this.injectCodeTempPath=e.injectCodeTempPath,this.offlineDirectoryPath=e.offlineDirectoryPath,this.readonlyDirectoryPath=e.readonlyDirectoryPath,this.assetsMapFilename=e.assetsMapFilename,this.boatmanFilename=e.boatmanFilename}getAssetsMapFilePath(){return(0,U.join)(this.offlineDirectoryPath,this.assetsMapFilename)}getBoatmanFilePath(e){return(0,U.join)(this.offlineDirectoryPath,this.boatmanFilename[e])}getReadonlyAssetsMapFilePath(){return(0,U.join)(this.readonlyDirectoryPath,this.assetsMapFilename)}getReadonlyBoatmanFilePath(e){return(0,U.join)(this.readonlyDirectoryPath,this.boatmanFilename[e])}};var N=r&&r.__awaiter||function(e,t,n,o){return new(n||(n=Promise))((function(a,r){function i(e){try{u(o.next(e))}catch(e){r(e)}}function s(e){try{u(o.throw(e))}catch(e){r(e)}}function u(e){var t;e.done?a(e.value):(t=e.value,t instanceof n?t:new n((function(e){e(t)}))).then(i,s)}u((o=o.apply(e,t||[])).next())}))},L=r&&r.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(p,"__esModule",{value:!0}),p.BuilderDebugClient=void 0;const q=L(e),J=c,W=f,Q=m,G=O,H=$;function K(e){const t={target:J.ECompileTargetType.Mini};return e.target&&Object.keys(J.ECompileTargetType).indexOf(e.target)>-1&&(t.target=e.target),t}function V(e){const t=Object.assign({},e);if(!t.mode||-1===Object.keys(J.ECompileModeType).indexOf(t.mode))throw new Error(`[${Q.libName}] invalid 'mode' option: ${t.mode}`);return t.target&&-1!==Object.keys(J.ECompileTargetType).indexOf(t.target)||(t.target=J.ECompileTargetType.Mini),e}p.BuilderDebugClient=class{constructor(e){this.context=new H.BuilderDebugContext(Object.assign(Object.assign({},Q.defaultConfig),e))}updateOfflineAssets(e){return N(this,void 0,void 0,(function*(){this.assetsUpdater||(this.assetsUpdater=new W.AssetsUpdater(this.context)),e.cacheToday?yield this.assetsUpdater.updateOfflineAssetsToday():yield this.assetsUpdater.updateOfflineAssets()}))}generateInjectCode(e){return N(this,void 0,void 0,(function*(){e=V(e);const t=yield this.readAssetsMap();return(0,G.composeAssetsByCompileMode)(t,e)}))}generateInjectCodeSync(e){e=V(e);const t=this.readAssetsMapSync();return(0,G.composeAssetsByCompileMode)(t,e)}readAssetsMapSync(){let e=q.default.readJSONSync(this.context.getAssetsMapFilePath(),{throws:!1});return e||(console.log(`[${Q.libName}] offline assets_map file was damaged, fallback to readonly file`),e=q.default.readJSONSync(this.context.getReadonlyAssetsMapFilePath())),e}readAssetsMap(){return N(this,void 0,void 0,(function*(){let e;try{e=yield q.default.readJSON(this.context.getAssetsMapFilePath(),{throws:!1})}catch(e){}return e||(console.log(`[${Q.libName}] offline assets_map file was damaged, fallback to readonly file`),e=yield q.default.readJSON(this.context.getReadonlyAssetsMapFilePath())),e}))}generateInjectCodePath(e){return N(this,void 0,void 0,(function*(){const t=yield this.generateInjectCode(e);return yield q.default.writeJSON(Q.defaultConfig.injectCodeTempPath,t),Q.defaultConfig.injectCodeTempPath}))}generateInjectCodePathSync(e){const t=this.generateInjectCodeSync(e);return q.default.writeJSONSync(Q.defaultConfig.injectCodeTempPath,t),Q.defaultConfig.injectCodeTempPath}getBoatmanBundlePath(e){return N(this,void 0,void 0,(function*(){const t=K(e);try{const e=this.context.getBoatmanFilePath(t.target);return yield q.default.access(e,q.default.constants.R_OK),e}catch(e){return this.context.getReadonlyBoatmanFilePath(t.target)}}))}getBoatmanBundlePathSync(e){const t=K(e);try{const e=this.context.getBoatmanFilePath(t.target);return q.default.accessSync(e,q.default.constants.R_OK),e}catch(e){return this.context.getReadonlyBoatmanFilePath(t.target)}}};var z={},X=r&&r.__awaiter||function(e,t,n,o){return new(n||(n=Promise))((function(a,r){function i(e){try{u(o.next(e))}catch(e){r(e)}}function s(e){try{u(o.throw(e))}catch(e){r(e)}}function u(e){var t;e.done?a(e.value):(t=e.value,t instanceof n?t:new n((function(e){e(t)}))).then(i,s)}u((o=o.apply(e,t||[])).next())}))};Object.defineProperty(z,"__esModule",{value:!0}),z.readAssetsMap=z.readAssetsMapSync=z.loadConfig=z.getBoatmanBundlePathSync=z.getBoatmanBundlePath=z.generateInjectCodePathSync=z.generateInjectCodePath=z.generateInjectCodeSync=z.generateInjectCode=z.updateInjectCodeAssets=void 0;const Y=p;let Z;function ee(){return Z||(Z=new Y.BuilderDebugClient),Z}z.updateInjectCodeAssets=function(e={}){return X(this,void 0,void 0,(function*(){return ee().updateOfflineAssets(e)}))},z.generateInjectCode=function(e){return X(this,void 0,void 0,(function*(){return ee().generateInjectCode(e)}))},z.generateInjectCodeSync=function(e){return ee().generateInjectCodeSync(e)},z.generateInjectCodePath=function(e){return X(this,void 0,void 0,(function*(){return ee().generateInjectCodePath(e)}))},z.generateInjectCodePathSync=function(e){return ee().generateInjectCodePathSync(e)},z.getBoatmanBundlePath=function(e={}){return X(this,void 0,void 0,(function*(){return ee().getBoatmanBundlePath(e)}))},z.getBoatmanBundlePathSync=function(e={}){return ee().getBoatmanBundlePathSync(e)},z.loadConfig=function(e){Z=new Y.BuilderDebugClient(e)},z.readAssetsMapSync=function(){return ee().readAssetsMapSync()},z.readAssetsMap=function(){return ee().readAssetsMap()},function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.loadConfig=e.getBoatmanBundlePathSync=e.readAssetsMap=e.readAssetsMapSync=e.getBoatmanBundlePath=e.generateInjectCodePathSync=e.generateInjectCodePath=e.generateInjectCodeSync=e.generateInjectCode=e.updateInjectCodeAssets=e.BuilderDebugClient=e.ECompileTargetType=e.ECompileModeType=void 0;var t=c;Object.defineProperty(e,"ECompileModeType",{enumerable:!0,get:function(){return t.ECompileModeType}}),Object.defineProperty(e,"ECompileTargetType",{enumerable:!0,get:function(){return t.ECompileTargetType}});var n=p;Object.defineProperty(e,"BuilderDebugClient",{enumerable:!0,get:function(){return n.BuilderDebugClient}});var o=z;Object.defineProperty(e,"updateInjectCodeAssets",{enumerable:!0,get:function(){return o.updateInjectCodeAssets}}),Object.defineProperty(e,"generateInjectCode",{enumerable:!0,get:function(){return o.generateInjectCode}}),Object.defineProperty(e,"generateInjectCodeSync",{enumerable:!0,get:function(){return o.generateInjectCodeSync}}),Object.defineProperty(e,"generateInjectCodePath",{enumerable:!0,get:function(){return o.generateInjectCodePath}}),Object.defineProperty(e,"generateInjectCodePathSync",{enumerable:!0,get:function(){return o.generateInjectCodePathSync}}),Object.defineProperty(e,"getBoatmanBundlePath",{enumerable:!0,get:function(){return o.getBoatmanBundlePath}}),Object.defineProperty(e,"readAssetsMapSync",{enumerable:!0,get:function(){return o.readAssetsMapSync}}),Object.defineProperty(e,"readAssetsMap",{enumerable:!0,get:function(){return o.readAssetsMap}}),Object.defineProperty(e,"getBoatmanBundlePathSync",{enumerable:!0,get:function(){return o.getBoatmanBundlePathSync}}),Object.defineProperty(e,"loadConfig",{enumerable:!0,get:function(){return o.loadConfig}})}(l);var te=i(l);module.exports=te;

package/assets/builder-debug-utils/lib/compose.d.ts

@@ -0,0 +1,2 @@
+import { IGenerateInjectCodeOptions, IInjectionPoints, IAssetsMap } from './interface';
+export declare function composeAssetsByCompileMode(assetsMap: IAssetsMap, options: IGenerateInjectCodeOptions): IInjectionPoints;

package/assets/builder-debug-utils/lib/compose.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeAssetsByCompileMode = void 0;
+const interface_1 = require("./interface");
+const config_1 = require("./config");
+function concatSource(...argv) {
+    return argv.join('\n');
+}
+function composeAssetsByCompileMode(assetsMap, options) {
+    let composeMethod;
+    switch (options.mode) {
+        case interface_1.ECompileModeType.Preview:
+            composeMethod = composeAssets4Preview;
+            break;
+        case interface_1.ECompileModeType.Remote:
+            composeMethod = composeAssets4Remote;
+            break;
+        case interface_1.ECompileModeType.Remotex:
+            composeMethod = composeAssets4Remotex;
+            break;
+        case interface_1.ECompileModeType.RemotexLite:
+            composeMethod = composeAssets4RemotexLite;
+            break;
+        case interface_1.ECompileModeType.RemoteBoatman:
+            composeMethod = composeAssets4RemoteBoatman;
+            break;
+        default:
+            throw new Error(`[${config_1.libName}] unknown compile mode: ${options.mode}`);
+    }
+    return composeMethod(assetsMap, options);
+}
+exports.composeAssetsByCompileMode = composeAssetsByCompileMode;
+function composeAssets4Preview(assetsMap, options) {
+    if (options.target === interface_1.ECompileTargetType.Cube) {
+        return {};
+    }
+    else {
+        return {
+            workerTop: assetsMap.bugmeWPreview,
+            webTop: `window.__BUGME_ENV__='preview';${assetsMap.bugmeRPreview}`,
+            htmlTop: `<script>window.__BUGME_ENV__='preview';${assetsMap.bugmeRPreview}</script>`,
+        };
+    }
+}
+function toHtmlTop(text) {
+    return `<script snapshot-delete="">${text !== null && text !== void 0 ? text : ''}</script>`;
+}
+function composeAssets4Remote(assetsMap, _options) {
+    return {
+        webTop: assetsMap.bugmeRRemote,
+        htmlTop: toHtmlTop(assetsMap.bugmeRRemote),
+    };
+}
+function composeAssets4Remotex(assetsMap, options) {
+    return options.compilePlugin
+        ? {
+            workerTop: assetsMap.bugmeWRemote,
+            pluginWorkerTop: assetsMap.tyroAgent,
+            webTop: assetsMap.bugmeRRemote,
+            htmlTop: toHtmlTop(assetsMap.bugmeRRemote),
+        }
+        : {
+            workerTop: concatSource(assetsMap.tyroAgent || '', assetsMap.bugmeWRemote || ''),
+            webTop: assetsMap.bugmeRRemote,
+            htmlTop: toHtmlTop(assetsMap.bugmeRRemote),
+        };
+}
+function composeAssets4RemotexLite(assetsMap, _options) {
+    return {
+        workerTop: concatSource('var __BUGME_CONSOLE_ENABLE__=true;', assetsMap.bugmeWRemote || ''),
+        webTop: assetsMap.bugmeRRemote,
+        htmlTop: toHtmlTop(assetsMap.bugmeRRemote),
+    };
+}
+function composeAssets4RemoteBoatman(assetsMap, options) {
+    if (options.target === interface_1.ECompileTargetType.Cube) {
+        return {};
+    }
+    else {
+        // Boatman 模式下 tinybugme 会跟随 boatman_mini 一起注入到 worker 中
+        const points = {
+            webTop: assetsMap.bugmeRRemote,
+            htmlTop: toHtmlTop(assetsMap.bugmeRRemote),
+        };
+        // 插件模式下 boatman_mini 注入到插件上下文中，tinybugme 不会生效，因此需要额外注入到宿主 worker 中
+        if (options.compilePlugin) {
+            points.workerTop = assetsMap.bugmeWRemote;
+        }
+        return points;
+    }
+}

package/assets/builder-debug-utils/lib/config.d.ts

@@ -0,0 +1,3 @@
+import { IBuilderDebugConfig } from './interface';
+export declare const defaultConfig: IBuilderDebugConfig;
+export declare const libName = "builder-debug-utils";

package/assets/builder-debug-utils/lib/config.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.libName = exports.defaultConfig = void 0;
+const os_1 = require("os");
+const path_1 = require("path");
+const interface_1 = require("./interface");
+exports.defaultConfig = {
+    assetsQueryUrl: 'https://render.alipay.com/p/h5data/h5config_builder-debug-h5data.json',
+    injectCodeTempPath: (0, path_1.join)((0, os_1.tmpdir)(), './builder_debug_output_v2'),
+    offlineDirectoryPath: (0, path_1.join)(__dirname, '../offline'),
+    readonlyDirectoryPath: (0, path_1.join)(__dirname, '../readonly'),
+    assetsMapFilename: 'assets_map',
+    boatmanFilename: {
+        [interface_1.ECompileTargetType.Mini]: 'boatman_mini',
+        // Cube 未支持，先占位
+        [interface_1.ECompileTargetType.Cube]: 'boatman_cube',
+    },
+};
+exports.libName = 'builder-debug-utils';

package/assets/builder-debug-utils/lib/context.d.ts

@@ -0,0 +1,14 @@
+import { IBuilderDebugConfig, ECompileTargetType } from './interface';
+export declare class BuilderDebugContext {
+    assetsQueryUrl: string;
+    injectCodeTempPath: string;
+    protected offlineDirectoryPath: string;
+    protected readonlyDirectoryPath: string;
+    protected assetsMapFilename: string;
+    protected boatmanFilename: Record<ECompileTargetType, string>;
+    constructor(config: IBuilderDebugConfig);
+    getAssetsMapFilePath(): string;
+    getBoatmanFilePath(target: ECompileTargetType): string;
+    getReadonlyAssetsMapFilePath(): string;
+    getReadonlyBoatmanFilePath(target: ECompileTargetType): string;
+}

package/assets/builder-debug-utils/lib/context.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuilderDebugContext = void 0;
+const path_1 = require("path");
+class BuilderDebugContext {
+    constructor(config) {
+        this.assetsQueryUrl = '';
+        this.injectCodeTempPath = '';
+        this.offlineDirectoryPath = '';
+        this.readonlyDirectoryPath = '';
+        this.assetsMapFilename = '';
+        this.assetsQueryUrl = config.assetsQueryUrl;
+        this.injectCodeTempPath = config.injectCodeTempPath;
+        this.offlineDirectoryPath = config.offlineDirectoryPath;
+        this.readonlyDirectoryPath = config.readonlyDirectoryPath;
+        this.assetsMapFilename = config.assetsMapFilename;
+        this.boatmanFilename = config.boatmanFilename;
+    }
+    getAssetsMapFilePath() {
+        return (0, path_1.join)(this.offlineDirectoryPath, this.assetsMapFilename);
+    }
+    getBoatmanFilePath(target) {
+        return (0, path_1.join)(this.offlineDirectoryPath, this.boatmanFilename[target]);
+    }
+    getReadonlyAssetsMapFilePath() {
+        return (0, path_1.join)(this.readonlyDirectoryPath, this.assetsMapFilename);
+    }
+    getReadonlyBoatmanFilePath(target) {
+        return (0, path_1.join)(this.readonlyDirectoryPath, this.boatmanFilename[target]);
+    }
+}
+exports.BuilderDebugContext = BuilderDebugContext;

package/assets/builder-debug-utils/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { ECompileModeType, ECompileTargetType, IBuilderDebugClient, IBuilderDebugClientOptions } from './interface';
+export { BuilderDebugClient } from './sdk';
+export { updateInjectCodeAssets, generateInjectCode, generateInjectCodeSync, generateInjectCodePath, generateInjectCodePathSync, getBoatmanBundlePath, readAssetsMapSync, readAssetsMap, getBoatmanBundlePathSync, loadConfig, } from './utils';

package/assets/builder-debug-utils/lib/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = exports.getBoatmanBundlePathSync = exports.readAssetsMap = exports.readAssetsMapSync = exports.getBoatmanBundlePath = exports.generateInjectCodePathSync = exports.generateInjectCodePath = exports.generateInjectCodeSync = exports.generateInjectCode = exports.updateInjectCodeAssets = exports.BuilderDebugClient = exports.ECompileTargetType = exports.ECompileModeType = void 0;
+// export * 导出 commonjs 会多一层 default
+var interface_1 = require("./interface");
+Object.defineProperty(exports, "ECompileModeType", { enumerable: true, get: function () { return interface_1.ECompileModeType; } });
+Object.defineProperty(exports, "ECompileTargetType", { enumerable: true, get: function () { return interface_1.ECompileTargetType; } });
+var sdk_1 = require("./sdk");
+Object.defineProperty(exports, "BuilderDebugClient", { enumerable: true, get: function () { return sdk_1.BuilderDebugClient; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "updateInjectCodeAssets", { enumerable: true, get: function () { return utils_1.updateInjectCodeAssets; } });
+Object.defineProperty(exports, "generateInjectCode", { enumerable: true, get: function () { return utils_1.generateInjectCode; } });
+Object.defineProperty(exports, "generateInjectCodeSync", { enumerable: true, get: function () { return utils_1.generateInjectCodeSync; } });
+Object.defineProperty(exports, "generateInjectCodePath", { enumerable: true, get: function () { return utils_1.generateInjectCodePath; } });
+Object.defineProperty(exports, "generateInjectCodePathSync", { enumerable: true, get: function () { return utils_1.generateInjectCodePathSync; } });
+Object.defineProperty(exports, "getBoatmanBundlePath", { enumerable: true, get: function () { return utils_1.getBoatmanBundlePath; } });
+Object.defineProperty(exports, "readAssetsMapSync", { enumerable: true, get: function () { return utils_1.readAssetsMapSync; } });
+Object.defineProperty(exports, "readAssetsMap", { enumerable: true, get: function () { return utils_1.readAssetsMap; } });
+Object.defineProperty(exports, "getBoatmanBundlePathSync", { enumerable: true, get: function () { return utils_1.getBoatmanBundlePathSync; } });
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return utils_1.loadConfig; } });

package/assets/builder-debug-utils/lib/interface.d.ts

@@ -0,0 +1,86 @@
+export declare enum ECompileTargetType {
+    Mini = "Mini",
+    Cube = "Cube"
+}
+export declare enum ECompileModeType {
+    Remote = "Remote",
+    Remotex = "Remotex",
+    RemotexLite = "RemotexLite",
+    Preview = "Preview",
+    RemoteBoatman = "RemoteBoatman"
+}
+export interface IGenerateInjectCodeOptions {
+    mode: ECompileModeType;
+    target?: ECompileTargetType;
+    compilePlugin?: boolean;
+}
+export interface IGetBoatmanBundleOptions {
+    target?: ECompileTargetType;
+}
+export interface IInjectionPoints {
+    htmlTop?: string;
+    webTop?: string;
+    workerTop?: string;
+    pluginWebTop?: string;
+    pluginWorkerTop?: string;
+}
+export interface IUpdateAssetsOptions {
+    cacheToday?: boolean;
+}
+export interface IOnlineAssetsConfig {
+    integrity: string;
+    url: string;
+    integrity_v2: string;
+    url_v2: string;
+    url_boatman_mini: string;
+    integrity_boatman_mini: string;
+    url_boatman_cube?: string;
+    integrity_boatman_cube: string;
+}
+export interface IAssetsMap {
+    tyroAgent?: string;
+    bugmeRRemote?: string;
+    bugmeRPreview?: string;
+    bugmeWRemote?: string;
+    bugmeWPreview?: string;
+}
+export interface IBuilderDebugClientOptions extends IBuilderDebugConfig {
+}
+export interface IBuilderDebugConfig {
+    assetsQueryUrl: string;
+    injectCodeTempPath: string;
+    offlineDirectoryPath: string;
+    readonlyDirectoryPath: string;
+    assetsMapFilename: string;
+    boatmanFilename: Record<ECompileTargetType, string>;
+}
+export interface IBuilderDebugClient {
+    /**
+     * 检查更新本地 offline 目录下的资源文件
+     */
+    updateOfflineAssets(options: IUpdateAssetsOptions): Promise<void>;
+    /**
+     * 生成构建器消费的 InjectCode 注入点对象
+     */
+    generateInjectCode(options: IGenerateInjectCodeOptions): Promise<IInjectionPoints>;
+    /**
+     * generateInjectCode 同步方法
+     */
+    generateInjectCodeSync(options: IGenerateInjectCodeOptions): IInjectionPoints;
+    /**
+     * 生成构建器消费的 InjectCode JSON 文件，并返回路径
+     */
+    generateInjectCodePath(options: IGenerateInjectCodeOptions): Promise<string>;
+    /**
+     * generateInjectCodePath 同步方法
+     */
+    generateInjectCodePathSync(options: IGenerateInjectCodeOptions): string;
+    /**
+     * 获取本地 boatman 文件资源路径
+     */
+    getBoatmanBundlePath(options: IGetBoatmanBundleOptions): Promise<string>;
+    /**
+     * getBoatmanBundlePath 同步方法
+     */
+    getBoatmanBundlePathSync(options: IGetBoatmanBundleOptions): string;
+}

package/assets/builder-debug-utils/lib/interface.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ECompileModeType = exports.ECompileTargetType = void 0;
+var ECompileTargetType;
+(function (ECompileTargetType) {
+    ECompileTargetType["Mini"] = "Mini";
+    ECompileTargetType["Cube"] = "Cube";
+})(ECompileTargetType = exports.ECompileTargetType || (exports.ECompileTargetType = {}));
+var ECompileModeType;
+(function (ECompileModeType) {
+    ECompileModeType["Remote"] = "Remote";
+    ECompileModeType["Remotex"] = "Remotex";
+    ECompileModeType["RemotexLite"] = "RemotexLite";
+    ECompileModeType["Preview"] = "Preview";
+    ECompileModeType["RemoteBoatman"] = "RemoteBoatman";
+})(ECompileModeType = exports.ECompileModeType || (exports.ECompileModeType = {}));

package/assets/builder-debug-utils/lib/sdk.d.ts

@@ -0,0 +1,32 @@
+import { IBuilderDebugClient, IBuilderDebugClientOptions, IUpdateAssetsOptions, IGenerateInjectCodeOptions, IGetBoatmanBundleOptions, IAssetsMap } from './interface';
+import { AssetsUpdater } from './updater';
+import { BuilderDebugContext } from './context';
+export declare class BuilderDebugClient implements IBuilderDebugClient {
+    protected assetsUpdater: AssetsUpdater;
+    protected context: BuilderDebugContext;
+    constructor(options?: IBuilderDebugClientOptions);
+    updateOfflineAssets(options: IUpdateAssetsOptions): Promise<void>;
+    generateInjectCode(options: IGenerateInjectCodeOptions): Promise<import("./interface").IInjectionPoints>;
+    /**
+     * generateInjectCode 同步方法
+     */
+    generateInjectCodeSync(options: IGenerateInjectCodeOptions): import("./interface").IInjectionPoints;
+    readAssetsMapSync(): IAssetsMap;
+    readAssetsMap(): Promise<IAssetsMap>;
+    /**
+     * 生成构建器消费的 InjectCode JSON 文件，并返回路径
+     */
+    generateInjectCodePath(options: IGenerateInjectCodeOptions): Promise<string>;
+    /**
+     * generateInjectCodePath 同步方法
+     */
+    generateInjectCodePathSync(options: IGenerateInjectCodeOptions): string;
+    /**
+     * 获取本地 boatman 文件资源路径
+     */
+    getBoatmanBundlePath(options: IGetBoatmanBundleOptions): Promise<string>;
+    /**
+     * getBoatmanBundlePath 同步方法
+     */
+    getBoatmanBundlePathSync(options: IGetBoatmanBundleOptions): string;
+}

package/assets/builder-debug-utils/lib/sdk.js

@@ -0,0 +1,150 @@
+"use strict";
+/* eslint-disable no-console */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuilderDebugClient = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const interface_1 = require("./interface");
+const updater_1 = require("./updater");
+const config_1 = require("./config");
+const compose_1 = require("./compose");
+const context_1 = require("./context");
+class BuilderDebugClient {
+    constructor(options) {
+        this.context = new context_1.BuilderDebugContext(Object.assign(Object.assign({}, config_1.defaultConfig), options));
+    }
+    updateOfflineAssets(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.assetsUpdater) {
+                this.assetsUpdater = new updater_1.AssetsUpdater(this.context);
+            }
+            if (options.cacheToday) {
+                yield this.assetsUpdater.updateOfflineAssetsToday();
+            }
+            else {
+                yield this.assetsUpdater.updateOfflineAssets();
+            }
+        });
+    }
+    generateInjectCode(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            options = getInjectCodeOptions(options);
+            const assetsMap = yield this.readAssetsMap();
+            return (0, compose_1.composeAssetsByCompileMode)(assetsMap, options);
+        });
+    }
+    /**
+     * generateInjectCode 同步方法
+     */
+    generateInjectCodeSync(options) {
+        options = getInjectCodeOptions(options);
+        const assetsMap = this.readAssetsMapSync();
+        return (0, compose_1.composeAssetsByCompileMode)(assetsMap, options);
+    }
+    readAssetsMapSync() {
+        let localJSON = fs_extra_1.default.readJSONSync(this.context.getAssetsMapFilePath(), { throws: false });
+        if (!localJSON) {
+            console.log(`[${config_1.libName}] offline assets_map file was damaged, fallback to readonly file`);
+            // 避免文件损坏，readonly/assets_map 做兜底
+            localJSON = fs_extra_1.default.readJSONSync(this.context.getReadonlyAssetsMapFilePath());
+        }
+        return localJSON;
+    }
+    readAssetsMap() {
+        return __awaiter(this, void 0, void 0, function* () {
+            let localJSON;
+            try {
+                localJSON = yield fs_extra_1.default.readJSON(this.context.getAssetsMapFilePath(), { throws: false });
+            }
+            catch (error) {
+                // throws if file is not found
+            }
+            if (!localJSON) {
+                console.log(`[${config_1.libName}] offline assets_map file was damaged, fallback to readonly file`);
+                // 避免文件损坏，readonly/assets_map 做兜底
+                localJSON = yield fs_extra_1.default.readJSON(this.context.getReadonlyAssetsMapFilePath());
+            }
+            return localJSON;
+        });
+    }
+    /**
+     * 生成构建器消费的 InjectCode JSON 文件，并返回路径
+     */
+    generateInjectCodePath(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const injectCode = yield this.generateInjectCode(options);
+            yield fs_extra_1.default.writeJSON(config_1.defaultConfig.injectCodeTempPath, injectCode);
+            return config_1.defaultConfig.injectCodeTempPath;
+        });
+    }
+    /**
+     * generateInjectCodePath 同步方法
+     */
+    generateInjectCodePathSync(options) {
+        const injectCode = this.generateInjectCodeSync(options);
+        fs_extra_1.default.writeJSONSync(config_1.defaultConfig.injectCodeTempPath, injectCode);
+        return config_1.defaultConfig.injectCodeTempPath;
+    }
+    /**
+     * 获取本地 boatman 文件资源路径
+     */
+    getBoatmanBundlePath(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const opt = getGetBoatmanBundleOptions(options);
+            // 若文件不存在降级到 readonly 备份
+            try {
+                const offlineFile = this.context.getBoatmanFilePath(opt.target);
+                yield fs_extra_1.default.access(offlineFile, fs_extra_1.default.constants.R_OK);
+                return offlineFile;
+            }
+            catch (error) {
+                return this.context.getReadonlyBoatmanFilePath(opt.target);
+            }
+        });
+    }
+    /**
+     * getBoatmanBundlePath 同步方法
+     */
+    getBoatmanBundlePathSync(options) {
+        const opt = getGetBoatmanBundleOptions(options);
+        try {
+            const offlineFile = this.context.getBoatmanFilePath(opt.target);
+            fs_extra_1.default.accessSync(offlineFile, fs_extra_1.default.constants.R_OK);
+            return offlineFile;
+        }
+        catch (error) {
+            return this.context.getReadonlyBoatmanFilePath(opt.target);
+        }
+    }
+}
+exports.BuilderDebugClient = BuilderDebugClient;
+function getGetBoatmanBundleOptions(options) {
+    const result = {
+        target: interface_1.ECompileTargetType.Mini,
+    };
+    if (options.target && Object.keys(interface_1.ECompileTargetType).indexOf(options.target) > -1) {
+        result.target = options.target;
+    }
+    return result;
+}
+function getInjectCodeOptions(options) {
+    const opt = Object.assign({}, options);
+    if (!opt.mode || Object.keys(interface_1.ECompileModeType).indexOf(opt.mode) === -1) {
+        throw new Error(`[${config_1.libName}] invalid 'mode' option: ${opt.mode}`);
+    }
+    if (!opt.target || Object.keys(interface_1.ECompileTargetType).indexOf(opt.target) === -1) {
+        opt.target = interface_1.ECompileTargetType.Mini;
+    }
+    return options;
+}

package/assets/builder-debug-utils/lib/updater.d.ts

@@ -0,0 +1,16 @@
+import { BuilderDebugContext } from './context';
+export declare class AssetsUpdater {
+    protected context: BuilderDebugContext;
+    protected updatingTask: Promise<void> | undefined;
+    constructor(context: BuilderDebugContext);
+    /**
+     * 检查本地资源文件是否过期并进行更新，每日只更新一次
+     */
+    updateOfflineAssetsToday(): Promise<void>;
+    /**
+     * 更新本地资源文件
+     */
+    updateOfflineAssets(): Promise<void>;
+    protected runUpdateTask(): Promise<void>;
+    protected updateLocalFile(filePath: string, url: string | undefined, integrity: string | undefined): Promise<void>;
+}