swpp-backends 3.0.0-alpha.0 → 3.0.0-alpha.100

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/** 版本号 */
+export declare const swppVersion: any;
+export { utils, RuntimeException } from './swpp/untils';
+export { ResourcesScanner, FileUpdateTracker, } from './swpp/ResourcesScanner';
+export { JsonBuilder, UpdateJson, UpdateChangeExp, TrackerHeaderDiff } from './swpp/JsonBuilder';
+export { FileParserRegistry, FileParser, FileMark } from './swpp/FileParser';
+export { SwCompiler, CompilationData, RuntimeData, BrowserVersion } from './swpp/SwCompiler';
+export { NetworkFileHandler, FiniteConcurrencyFetcher } from './swpp/NetworkFileHandler';
+export { ConfigLoader } from './swpp/config/ConfigLoader';
+export { KeyValueDatabase } from './swpp/database/KeyValueDatabase';
+export { RuntimeKeyValueDatabase } from './swpp/database/RuntimeKeyValueDatabase';
+export { RuntimeEventCode } from './swpp/database/RuntimeEventCode';
+export { RuntimeCoreCode } from './swpp/database/RuntimeCoreCode';
+export { RuntimeDepCode } from './swpp/database/RuntimeDepCode';
+export { CrossEnv } from './swpp/database/CrossEnv';
+export { CrossDepCode } from './swpp/database/CrossDepCode';
+export { CompilationEnv, AllowNotFoundEnum } from './swpp/database/CompilationEnv';
+export { DomCode } from './swpp/database/DomCode';
+export { defineIndivisibleConfig, defineConfig, defineRuntimeEvent, defineDomConfig, defineRuntimeCore, defineCrossDep, defineRuntimeDep, defineCrossEnv, defineCompilationEnv } from './swpp/config/ConfigCluster';

package/dist/index.js

@@ -1,7 +1,53 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.version = void 0;
+exports.defineCompilationEnv = exports.defineCrossEnv = exports.defineRuntimeDep = exports.defineCrossDep = exports.defineRuntimeCore = exports.defineDomConfig = exports.defineRuntimeEvent = exports.defineConfig = exports.defineIndivisibleConfig = exports.DomCode = exports.AllowNotFoundEnum = exports.CompilationEnv = exports.CrossDepCode = exports.CrossEnv = exports.RuntimeDepCode = exports.RuntimeCoreCode = exports.RuntimeEventCode = exports.RuntimeKeyValueDatabase = exports.KeyValueDatabase = exports.ConfigLoader = exports.FiniteConcurrencyFetcher = exports.RuntimeData = exports.CompilationData = exports.SwCompiler = exports.FileParserRegistry = exports.JsonBuilder = exports.FileUpdateTracker = exports.ResourcesScanner = exports.utils = exports.swppVersion = void 0;
 const untils_1 = require("./swpp/untils");
 /** 版本号 */
-exports.version = require('../package.json').version;
-untils_1.utils.printInfo('INDEX', `欢迎使用 swpp@${exports.version}`);
+exports.swppVersion = require('../package.json').version;
+var untils_2 = require("./swpp/untils");
+Object.defineProperty(exports, "utils", { enumerable: true, get: function () { return untils_2.utils; } });
+var ResourcesScanner_1 = require("./swpp/ResourcesScanner");
+Object.defineProperty(exports, "ResourcesScanner", { enumerable: true, get: function () { return ResourcesScanner_1.ResourcesScanner; } });
+Object.defineProperty(exports, "FileUpdateTracker", { enumerable: true, get: function () { return ResourcesScanner_1.FileUpdateTracker; } });
+var JsonBuilder_1 = require("./swpp/JsonBuilder");
+Object.defineProperty(exports, "JsonBuilder", { enumerable: true, get: function () { return JsonBuilder_1.JsonBuilder; } });
+var FileParser_1 = require("./swpp/FileParser");
+Object.defineProperty(exports, "FileParserRegistry", { enumerable: true, get: function () { return FileParser_1.FileParserRegistry; } });
+var SwCompiler_1 = require("./swpp/SwCompiler");
+Object.defineProperty(exports, "SwCompiler", { enumerable: true, get: function () { return SwCompiler_1.SwCompiler; } });
+Object.defineProperty(exports, "CompilationData", { enumerable: true, get: function () { return SwCompiler_1.CompilationData; } });
+Object.defineProperty(exports, "RuntimeData", { enumerable: true, get: function () { return SwCompiler_1.RuntimeData; } });
+var NetworkFileHandler_1 = require("./swpp/NetworkFileHandler");
+Object.defineProperty(exports, "FiniteConcurrencyFetcher", { enumerable: true, get: function () { return NetworkFileHandler_1.FiniteConcurrencyFetcher; } });
+var ConfigLoader_1 = require("./swpp/config/ConfigLoader");
+Object.defineProperty(exports, "ConfigLoader", { enumerable: true, get: function () { return ConfigLoader_1.ConfigLoader; } });
+var KeyValueDatabase_1 = require("./swpp/database/KeyValueDatabase");
+Object.defineProperty(exports, "KeyValueDatabase", { enumerable: true, get: function () { return KeyValueDatabase_1.KeyValueDatabase; } });
+var RuntimeKeyValueDatabase_1 = require("./swpp/database/RuntimeKeyValueDatabase");
+Object.defineProperty(exports, "RuntimeKeyValueDatabase", { enumerable: true, get: function () { return RuntimeKeyValueDatabase_1.RuntimeKeyValueDatabase; } });
+var RuntimeEventCode_1 = require("./swpp/database/RuntimeEventCode");
+Object.defineProperty(exports, "RuntimeEventCode", { enumerable: true, get: function () { return RuntimeEventCode_1.RuntimeEventCode; } });
+var RuntimeCoreCode_1 = require("./swpp/database/RuntimeCoreCode");
+Object.defineProperty(exports, "RuntimeCoreCode", { enumerable: true, get: function () { return RuntimeCoreCode_1.RuntimeCoreCode; } });
+var RuntimeDepCode_1 = require("./swpp/database/RuntimeDepCode");
+Object.defineProperty(exports, "RuntimeDepCode", { enumerable: true, get: function () { return RuntimeDepCode_1.RuntimeDepCode; } });
+var CrossEnv_1 = require("./swpp/database/CrossEnv");
+Object.defineProperty(exports, "CrossEnv", { enumerable: true, get: function () { return CrossEnv_1.CrossEnv; } });
+var CrossDepCode_1 = require("./swpp/database/CrossDepCode");
+Object.defineProperty(exports, "CrossDepCode", { enumerable: true, get: function () { return CrossDepCode_1.CrossDepCode; } });
+var CompilationEnv_1 = require("./swpp/database/CompilationEnv");
+Object.defineProperty(exports, "CompilationEnv", { enumerable: true, get: function () { return CompilationEnv_1.CompilationEnv; } });
+Object.defineProperty(exports, "AllowNotFoundEnum", { enumerable: true, get: function () { return CompilationEnv_1.AllowNotFoundEnum; } });
+var DomCode_1 = require("./swpp/database/DomCode");
+Object.defineProperty(exports, "DomCode", { enumerable: true, get: function () { return DomCode_1.DomCode; } });
+untils_1.utils.printInfo('INDEX', `欢迎使用 swpp@${exports.swppVersion}`);
+var ConfigCluster_1 = require("./swpp/config/ConfigCluster");
+Object.defineProperty(exports, "defineIndivisibleConfig", { enumerable: true, get: function () { return ConfigCluster_1.defineIndivisibleConfig; } });
+Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return ConfigCluster_1.defineConfig; } });
+Object.defineProperty(exports, "defineRuntimeEvent", { enumerable: true, get: function () { return ConfigCluster_1.defineRuntimeEvent; } });
+Object.defineProperty(exports, "defineDomConfig", { enumerable: true, get: function () { return ConfigCluster_1.defineDomConfig; } });
+Object.defineProperty(exports, "defineRuntimeCore", { enumerable: true, get: function () { return ConfigCluster_1.defineRuntimeCore; } });
+Object.defineProperty(exports, "defineCrossDep", { enumerable: true, get: function () { return ConfigCluster_1.defineCrossDep; } });
+Object.defineProperty(exports, "defineRuntimeDep", { enumerable: true, get: function () { return ConfigCluster_1.defineRuntimeDep; } });
+Object.defineProperty(exports, "defineCrossEnv", { enumerable: true, get: function () { return ConfigCluster_1.defineCrossEnv; } });
+Object.defineProperty(exports, "defineCompilationEnv", { enumerable: true, get: function () { return ConfigCluster_1.defineCompilationEnv; } });

package/{types → dist}/swpp/FileParser.d.ts

@@ -1,17 +1,17 @@
-/// <reference types="node" />
 import * as crypto from 'node:crypto';
+import { FileUpdateTracker } from './ResourcesScanner';
 import { CompilationData } from './SwCompiler';
 export declare class FileParserRegistry {
     private compilation;
+    private oldTracker?;
     private map;
-    constructor(compilation: CompilationData, obj?: {
-        [key: string]: FileParser<any>;
-    });
+    constructor(compilation: CompilationData, oldTracker?: FileUpdateTracker | undefined);
+    /** 注册一种处理器 */
     registry(type: string, parser: FileParser<any>): void;
     /** 判断是否支持指定类型 */
     containsType(type: string): boolean;
     /** 解析本地文件 */
-    parserLocalFile(path: string): Promise<Set<string>>;
+    parserLocalFile(path: string, cb?: (content: crypto.BinaryLike) => void, force?: boolean): Promise<Set<string>>;
     /** 解析网络文件 */
     parserNetworkFile(response: Response, callback?: (content: crypto.BinaryLike) => Promise<any> | any): Promise<Set<string>>;
     /**
@@ -59,8 +59,12 @@ export interface FileParser<T extends crypto.BinaryLike> {
 export interface FileMark {
     /** URL */
     file: string;
-    /** 文件标识符 */
-    mark: string;
+    /**
+     * 文件标识符或子文件列表
+     *
+     * 如果链接为稳定链接，则为子文件列表，否则为文件标识符
+     */
+    mark: string | Set<string>;
     /** URL 列表 */
     urls: Set<string>;
 }

package/dist/swpp/FileParser.js

@@ -3,17 +3,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildFileParser = exports.FileParserRegistry = void 0;
+exports.FileParserRegistry = void 0;
+exports.buildFileParser = buildFileParser;
 const path_1 = __importDefault(require("path"));
 const untils_1 = require("./untils");
 class FileParserRegistry {
-    constructor(compilation, obj = {}) {
+    constructor(compilation, oldTracker) {
         this.compilation = compilation;
+        this.oldTracker = oldTracker;
         this.map = new Map();
-        for (let key in obj) {
-            this.map.set(key, obj[key]);
-        }
     }
+    /** 注册一种处理器 */
     registry(type, parser) {
         this.map.set(type, parser);
     }
@@ -22,20 +22,33 @@ class FileParserRegistry {
         return this.map.has(type);
     }
     /** 解析本地文件 */
-    async parserLocalFile(path) {
-        const parser = this.map.get(path_1.default.extname(path));
-        if (!parser)
+    async parserLocalFile(path, cb, force) {
+        const parser = this.map.get(path_1.default.extname(path).substring(1));
+        if (!parser) {
+            if (force && cb) {
+                const reader = this.compilation.compilationEnv.read('readLocalFile');
+                const content = await reader(path);
+                cb(content);
+            }
             return new Set();
+        }
         const content = await parser.readFromLocal(this.compilation, path);
+        cb?.(content);
         return await parser.extractUrls(this.compilation, content);
     }
     /** 解析网络文件 */
     async parserNetworkFile(response, callback) {
-        const fileHandler = this.compilation.compilationEnv.read('FETCH_NETWORK_FILE');
+        const fileHandler = this.compilation.compilationEnv.read('NETWORK_FILE_FETCHER');
         const contentType = fileHandler.getUrlContentType(response.url, response);
         const parser = this.map.get(contentType);
-        if (!parser)
+        if (!parser) {
+            if (callback) {
+                const blob = await response.blob();
+                const array = await blob.stream().getReader().read();
+                callback(array.value);
+            }
             return new Set();
+        }
         const content = await parser.readFromNetwork(this.compilation, response);
         if (callback)
             await callback(content);
@@ -47,11 +60,13 @@ class FileParserRegistry {
      * @param isCached 该链接指向的资源是否需要缓存
      */
     async parserUrlFile(url, isCached) {
-        const fileHandler = this.compilation.compilationEnv.read('FETCH_NETWORK_FILE');
+        const fileHandler = this.compilation.compilationEnv.read('NETWORK_FILE_FETCHER');
         const contentType = fileHandler.getUrlContentType(url);
         if (!contentType && !isCached)
             return { file: url, mark: '', urls: new Set() };
         const parser = this.map.get(contentType);
+        if (!parser && !isCached)
+            return { file: url, mark: '', urls: new Set() };
         if (parser?.calcUrl) {
             const result = await parser.calcUrl(url);
             if (result)
@@ -60,13 +75,13 @@ class FileParserRegistry {
                     ...result
                 };
         }
-        const fetcher = this.compilation.compilationEnv.read('FETCH_NETWORK_FILE');
+        const fetcher = this.compilation.compilationEnv.read('NETWORK_FILE_FETCHER');
         const urls = new Set();
         let mark = '';
         await fetcher.fetch(url)
-            .then(response => this.parserNetworkFile(response, content => {
+            .then(response => this.parserNetworkFile(response, isCached ? content => {
             mark = untils_1.utils.calcHash(content);
-        }))
+        } : undefined))
             .then(urls => urls.forEach(it => urls.add(it)));
         return { file: url, mark, urls };
     }
@@ -82,4 +97,3 @@ exports.FileParserRegistry = FileParserRegistry;
 function buildFileParser(parser) {
     return parser;
 }
-exports.buildFileParser = buildFileParser;

package/dist/swpp/JsonBuilder.js

@@ -15,13 +15,14 @@ class JsonBuilder {
     putHeader(key, value) {
         this.headers.set(key, value);
     }
+    // noinspection JSUnusedGlobalSymbols
     async buildJson() {
-        const json = await this.compilation.compilationEnv.read('VERSION_FILE')();
+        const json = await this.compilation.compilationEnv.read('SWPP_JSON_FILE').fetchVersionFile();
         if (json.info.length == 0) {
             json.info.push({ version: 1 });
             return json;
         }
-        const newChange = createUpdateChangeExps(this.urls, this.map.values());
+        const newChange = createUpdateChangeExps(this.urls, this.map.keys());
         json.info.unshift({
             version: json.info[0].version + 1,
             change: [newChange]

package/dist/swpp/NetworkFileHandler.js

@@ -11,7 +11,7 @@ class FiniteConcurrencyFetcher {
         this.fetchingCount = 0;
         this.waitList = [];
         this.limit = 100;
-        this.referer = 'swpp-backends';
+        this.referer = 'https://swpp.example.com';
         this.userAgent = 'swpp-backends';
         this.headers = {};
     }
@@ -52,7 +52,7 @@ class FiniteConcurrencyFetcher {
             contentType = 'html';
         }
         else {
-            contentType = path_1.default.extname(url);
+            contentType = path_1.default.extname(url).substring(1);
         }
         if (!contentType) {
             if (response)
@@ -60,7 +60,7 @@ class FiniteConcurrencyFetcher {
             if (contentType.startsWith('text/'))
                 contentType = contentType.substring(5);
             if (contentType === 'javascript')
-                contentType = 'script';
+                contentType = 'js';
         }
         return contentType;
     }

package/{types → dist}/swpp/ResourcesScanner.d.ts

@@ -5,7 +5,8 @@ import { CompilationData } from './SwCompiler';
  */
 export declare class ResourcesScanner {
     private compilation;
-    constructor(compilation: CompilationData);
+    private oldTracker?;
+    constructor(compilation: CompilationData, oldTracker?: FileUpdateTracker | undefined);
     /** 扫描指定目录下的所有文件 */
     scanLocalFile(path: string): Promise<FileUpdateTracker>;
     /** 扫描网络文件 */
@@ -24,9 +25,14 @@ export declare class FileUpdateTracker {
     protected allUrl: Set<string>;
     constructor(compilation: CompilationData);
     /** 更新一个文件的标识符 */
-    update(uri: string, value: string): void;
+    update(uri: string, value: string | Set<string> | string[]): void;
+    /**
+     * 同步指定的稳定资源（同步时会连同同步其连接的稳定资源）
+     * @return 直接或间接连接的一些需要扫描的资源
+     */
+    syncStable(uri: URL, value: string[], oldTracker: FileUpdateTracker): string[];
     /** 读取一个文件的标识符 */
-    get(uri: string): string | undefined;
+    get(uri: string): string | string[] | undefined;
     /** 设置一个 header */
     putHeader(key: string, value: any): void;
     /** 读取一个 header */
@@ -43,7 +49,7 @@ export declare class FileUpdateTracker {
      * + 在新旧 tracker 中都存在且唯一标识符发生变化
      * + 在新 tracker 中不存在且在旧 tracker 中存在
      */
-    diff(oldTracker: FileUpdateTracker): JsonBuilder;
+    diff(): Promise<JsonBuilder>;
     /**
      * 将数据序列化为 JSON
      *
@@ -64,4 +70,6 @@ export declare class FileUpdateTracker {
     json(): string;
     /** 解序列化数据 */
     static unJson(compilation: CompilationData, jsonStr: string): FileUpdateTracker;
+    /** 从网络拉取并解析 tracker */
+    static parserJsonFromNetwork(compilation: CompilationData): Promise<FileUpdateTracker>;
 }

package/dist/swpp/ResourcesScanner.js

@@ -30,41 +30,46 @@ exports.FileUpdateTracker = exports.ResourcesScanner = void 0;
 const fs_1 = __importDefault(require("fs"));
 const crypto = __importStar(require("node:crypto"));
 const path_1 = __importDefault(require("path"));
+const CompilationEnv_1 = require("./database/CompilationEnv");
 const JsonBuilder_1 = require("./JsonBuilder");
 const untils_1 = require("./untils");
 /**
  * 资源文件扫描器
  */
 class ResourcesScanner {
-    constructor(compilation) {
+    constructor(compilation, oldTracker) {
         this.compilation = compilation;
+        this.oldTracker = oldTracker;
     }
+    // noinspection JSUnusedGlobalSymbols
     /** 扫描指定目录下的所有文件 */
     async scanLocalFile(path) {
         const matchCacheRule = this.compilation.crossDep.read('matchCacheRule');
         const register = this.compilation.compilationEnv.read('FILE_PARSER');
+        const jsonInfo = this.compilation.compilationEnv.read('SWPP_JSON_FILE');
+        const excludes = [
+            path_1.default.posix.join(path, jsonInfo.swppPath, jsonInfo.versionPath),
+            path_1.default.posix.join(path, jsonInfo.swppPath, jsonInfo.trackerPath),
+            path_1.default.posix.join(path, this.compilation.compilationEnv.read('SERVICE_WORKER') + '.js')
+        ];
         const urls = new Set();
         const tracker = new FileUpdateTracker(this.compilation);
         await traverseDirectory(path, async (file) => {
-            const stream = fs_1.default.createReadStream(file);
-            const hash = crypto.createHash('md5');
-            stream.on('data', data => hash.update(data));
+            if (excludes.includes(file))
+                return;
             const localUrl = tracker.normalizeUri(file.substring(path.length));
-            if (matchCacheRule.runOnNode(localUrl)) {
+            const isCached = !!matchCacheRule.runOnNode(localUrl);
+            if (isCached) {
                 tracker.addUrl(localUrl.href);
             }
-            const type = path_1.default.extname(file);
-            if (register.containsType(type)) {
-                const set = await register.parserLocalFile(file);
-                set.forEach(it => urls.add(it));
-            }
-            await new Promise((resolve, reject) => {
-                stream.on('end', () => {
-                    tracker.update(file, hash.digest('hex'));
-                    resolve();
-                });
-                stream.on('error', err => reject(err));
-            });
+            const set = await register.parserLocalFile(file, content => {
+                if (isCached) {
+                    const hash = crypto.createHash('md5');
+                    hash.update(content);
+                    tracker.update(localUrl.pathname, hash.digest('hex'));
+                }
+            }, isCached);
+            set.forEach(it => urls.add(it));
         });
         await this.scanNetworkFile(tracker, urls);
         return tracker;
@@ -73,6 +78,7 @@ class ResourcesScanner {
     async scanNetworkFile(tracker, urls, record = new Set()) {
         const matchCacheRule = this.compilation.crossDep.read('matchCacheRule');
         const registry = this.compilation.compilationEnv.read('FILE_PARSER');
+        const isStable = this.compilation.compilationEnv.read('isStable');
         const appendedUrls = new Set();
         const taskList = new Array(urls.size);
         let i = 0;
@@ -85,9 +91,19 @@ class ResourcesScanner {
             if (isCached) {
                 tracker.addUrl(normalizeUri.href);
             }
+            if (isStable(normalizeUri)) {
+                const oldValue = this.oldTracker?.get?.(normalizeUri.href);
+                if (Array.isArray(oldValue)) {
+                    const list = tracker.syncStable(normalizeUri, oldValue, this.oldTracker);
+                    list.forEach(it => appendedUrls.add(it));
+                    continue;
+                }
+            }
             taskList[i++] = registry.parserUrlFile(normalizeUri.href, !!isCached)
                 .then(value => {
-                tracker.update(value.file, value.mark);
+                if (isCached) {
+                    tracker.update(value.file, value.mark);
+                }
                 value.urls.forEach(it => appendedUrls.add(it));
             }).catch(err => untils_1.utils.printError('SCAN NETWORK FILE', err));
         }
@@ -110,7 +126,7 @@ async function traverseDirectory(dir, callback) {
                 if (err)
                     reject(err);
                 else {
-                    Promise.all(files.map(it => traverseDirectory(path_1.default.join(dir, it), callback))).then(() => resolve());
+                    Promise.all(files.map(it => traverseDirectory(path_1.default.posix.join(dir, it), callback))).then(() => resolve());
                 }
             });
         });
@@ -134,11 +150,51 @@ class FileUpdateTracker {
     }
     /** 更新一个文件的标识符 */
     update(uri, value) {
-        this.map.set(uri, value);
+        if (typeof value == 'string') {
+            if (value.startsWith('['))
+                throw {
+                    code: untils_1.exceptionNames.invalidValue,
+                    message: `插入数据（"${value}"）时，不应当以方括号开头`
+                };
+            this.map.set(uri, value);
+        }
+        else if (Array.isArray(value)) {
+            this.map.set(uri, JSON.stringify(value));
+        }
+        else {
+            this.map.set(uri, JSON.stringify(Array.from(value)));
+        }
+    }
+    /**
+     * 同步指定的稳定资源（同步时会连同同步其连接的稳定资源）
+     * @return 直接或间接连接的一些需要扫描的资源
+     */
+    syncStable(uri, value, oldTracker) {
+        const isStable = this.compilation.compilationEnv.read('isStable');
+        this.update(uri.href, value);
+        this.addUrl(uri.href);
+        const result = [];
+        for (let item of value) {
+            this.addUrl(item);
+            const itemUrl = new URL(item);
+            if (isStable(itemUrl)) {
+                const oldValue = oldTracker.get(item);
+                if (Array.isArray(oldValue)) {
+                    const son = this.syncStable(itemUrl, oldValue, oldTracker);
+                    result.push(...son);
+                    continue;
+                }
+            }
+            result.push(item);
+        }
+        return result;
     }
     /** 读取一个文件的标识符 */
     get(uri) {
-        return this.map.get(this.normalizeUri(uri).href);
+        const value = this.map.get(this.normalizeUri(uri).href);
+        if (!value)
+            return;
+        return value.startsWith('[') ? JSON.parse(value) : value;
     }
     /** 设置一个 header */
     putHeader(key, value) {
@@ -153,12 +209,15 @@ class FileUpdateTracker {
         if (uri.startsWith('http:'))
             uri = `https:${uri.substring(5)}`;
         const domain = this.compilation.compilationEnv.read('DOMAIN_HOST');
-        return new URL(uri, `https://${domain}`);
+        const url = new URL(uri, `https://${domain}`);
+        const normalizer = this.compilation.crossDep.read('normalizeUrl');
+        return new URL(normalizer.runOnNode(url.href));
     }
     /** 添加一个 URL */
     addUrl(url) {
         this.allUrl.add(url);
     }
+    // noinspection JSUnusedGlobalSymbols
     /**
      * 判断两个 tracker 的差异
      *
@@ -167,15 +226,17 @@ class FileUpdateTracker {
      * + 在新旧 tracker 中都存在且唯一标识符发生变化
      * + 在新 tracker 中不存在且在旧 tracker 中存在
      */
-    diff(oldTracker) {
+    async diff() {
+        const host = this.compilation.compilationEnv.read('DOMAIN_HOST');
         const diff = new JsonBuilder_1.JsonBuilder(this.compilation, this.allUrl);
+        const oldTracker = await this.compilation.compilationEnv.read('SWPP_JSON_FILE').fetchTrackerFile(this.compilation);
         oldTracker.map.forEach((value, key) => {
             if (this.map.has(key)) {
                 if (this.get(key) !== value)
-                    diff.update(key, value);
+                    diff.update(untils_1.utils.splicingUrl(host, key).href, value);
             }
             else {
-                diff.update(key, value);
+                diff.update(untils_1.utils.splicingUrl(host, key).href, value);
             }
         });
         this.headers.forEach((value, key) => {
@@ -186,6 +247,7 @@ class FileUpdateTracker {
         });
         return diff;
     }
+    // noinspection JSUnusedGlobalSymbols
     /**
      * 将数据序列化为 JSON
      *
@@ -206,12 +268,16 @@ class FileUpdateTracker {
     json() {
         const result = {
             version: 4,
-            tracker: {}
+            tracker: {},
+            headers: {}
         };
         this.map.forEach((value, key) => {
             result.tracker[key] = value;
         });
-        return JSON.stringify(result.tracker);
+        this.headers.forEach((value, key) => {
+            result.headers[key] = value;
+        });
+        return JSON.stringify(result);
     }
     /** 解序列化数据 */
     static unJson(compilation, jsonStr) {
@@ -242,5 +308,48 @@ class FileUpdateTracker {
         }
         return tracker;
     }
+    // noinspection JSUnusedGlobalSymbols
+    /** 从网络拉取并解析 tracker */
+    static async parserJsonFromNetwork(compilation) {
+        const domain = compilation.compilationEnv.read('DOMAIN_HOST');
+        const jsonInfo = compilation.compilationEnv.read('SWPP_JSON_FILE');
+        const url = untils_1.utils.splicingUrl(domain, jsonInfo.swppPath, jsonInfo.trackerPath);
+        const fetcher = compilation.compilationEnv.read('NETWORK_FILE_FETCHER');
+        const isNotFound = compilation.compilationEnv.read('isNotFound');
+        const notFoundLevel = compilation.compilationEnv.read('ALLOW_NOT_FOUND');
+        let error;
+        const result = await (async () => {
+            try {
+                const response = await fetcher.fetch(url);
+                if (isNotFound.response(response)) {
+                    if (notFoundLevel == CompilationEnv_1.AllowNotFoundEnum.REJECT_ALL) {
+                        error = {
+                            code: untils_1.exceptionNames.notFound,
+                            message: `拉取 ${url} 时出现 404 错误`
+                        };
+                        return;
+                    }
+                    untils_1.utils.printWarning('SCANNER', '拉取 tracker 时服务器返回了 404，如果是第一次携带 swpp v3 构建网站请忽视这条信息');
+                    return new FileUpdateTracker(compilation);
+                }
+                const text = await response.text();
+                return FileUpdateTracker.unJson(compilation, text);
+            }
+            catch (e) {
+                if (isNotFound.error(e) && notFoundLevel == CompilationEnv_1.AllowNotFoundEnum.ALLOW_ALL) {
+                    untils_1.utils.printWarning('SCANNER', '拉取 tracker 时 DNS 解析失败，如果是第一次携带 swpp v3 构建网站且网站暂时无法解析请忽视这条信息');
+                    return new FileUpdateTracker(compilation);
+                }
+                untils_1.utils.printError('SCANNER', e);
+                throw {
+                    code: untils_1.exceptionNames.error,
+                    message: `拉取或解析历史 Tracker 时出现错误`
+                };
+            }
+        })();
+        if (result)
+            return result;
+        throw error;
+    }
 }
 exports.FileUpdateTracker = FileUpdateTracker;

package/{types → dist}/swpp/SwCompiler.d.ts

@@ -1,5 +1,6 @@
 import { CompilationEnv } from './database/CompilationEnv';
 import { CrossDepCode } from './database/CrossDepCode';
+import { DomCode } from './database/DomCode';
 import { RuntimeCoreCode } from './database/RuntimeCoreCode';
 import { RuntimeDepCode } from './database/RuntimeDepCode';
 import { CrossEnv } from './database/CrossEnv';
@@ -15,24 +16,27 @@ export declare class SwCompiler {
 /** 运行时数据 */
 export declare class RuntimeData {
     /** 控制插入顺序 */
-    readonly insertOrder: (Exclude<keyof RuntimeData, 'insertOrder'> | string)[];
+    readonly insertOrder: (Exclude<keyof RuntimeData, 'insertOrder' | 'domConfig'> | string)[];
     /** 运行时环境变量 */
-    readonly crossEnv: CrossEnv;
+    crossEnv: CrossEnv;
     /** 运行时工具函数 */
-    readonly runtimeDep: RuntimeDepCode;
+    runtimeDep: RuntimeDepCode;
     /** 运行时核心功能函数 */
-    readonly runtimeCore: RuntimeCoreCode;
+    runtimeCore: RuntimeCoreCode;
     /** 运行时事件注册 */
-    readonly runtimeEvent: RuntimeEventCode;
+    runtimeEvent: RuntimeEventCode;
     /** 运行时/编译时工具函数 */
-    readonly crossDep: CrossDepCode;
+    crossDep: CrossDepCode;
+    /** DOM 相关设置 */
+    domConfig: DomCode;
+    constructor(compilationData: CompilationData);
     getDatabase(key: string): RuntimeKeyValueDatabase<any, {}>;
 }
 /** 编译时数据 */
-export interface CompilationData {
-    compilationEnv: CompilationEnv;
+export declare class CompilationData {
     crossEnv: CrossEnv;
     crossDep: CrossDepCode;
+    compilationEnv: CompilationEnv;
 }
 /** 版本号信息 */
 export interface BrowserVersion {