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

package/dist/index.js

@@ -1,7 +1,48 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.version = void 0;
+exports.AllowNotFoundEnum = exports.CompilationEnv = exports.CrossDepCode = exports.CrossEnv = exports.RuntimeDepCode = exports.RuntimeCoreCode = exports.RuntimeEventCode = exports.RuntimeKeyValueDatabase = exports.KeyValueDatabase = exports.defineIndivisibleConfig = exports.defineRuntimeEvent = exports.defineRuntimeCore = exports.defineRuntimeDep = exports.defineCrossDep = exports.defineCrossEnv = exports.defineConfig = exports.defineCompilationEnv = exports.ConfigLoader = exports.FiniteConcurrencyFetcher = exports.RuntimeData = exports.SwCompiler = exports.FileParserRegistry = exports.JsonBuilder = exports.FileUpdateTracker = exports.ResourcesScanner = exports.utils = exports.version = void 0;
 const untils_1 = require("./swpp/untils");
 /** 版本号 */
 exports.version = 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, "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; } });
+Object.defineProperty(exports, "defineCompilationEnv", { enumerable: true, get: function () { return ConfigLoader_1.defineCompilationEnv; } });
+Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return ConfigLoader_1.defineConfig; } });
+Object.defineProperty(exports, "defineCrossEnv", { enumerable: true, get: function () { return ConfigLoader_1.defineCrossEnv; } });
+Object.defineProperty(exports, "defineCrossDep", { enumerable: true, get: function () { return ConfigLoader_1.defineCrossDep; } });
+Object.defineProperty(exports, "defineRuntimeDep", { enumerable: true, get: function () { return ConfigLoader_1.defineRuntimeDep; } });
+Object.defineProperty(exports, "defineRuntimeCore", { enumerable: true, get: function () { return ConfigLoader_1.defineRuntimeCore; } });
+Object.defineProperty(exports, "defineRuntimeEvent", { enumerable: true, get: function () { return ConfigLoader_1.defineRuntimeEvent; } });
+Object.defineProperty(exports, "defineIndivisibleConfig", { enumerable: true, get: function () { return ConfigLoader_1.defineIndivisibleConfig; } });
+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; } });
 untils_1.utils.printInfo('INDEX', `欢迎使用 swpp@${exports.version}`);

package/dist/swpp/FileParser.js

@@ -3,7 +3,8 @@ 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 {
@@ -82,4 +83,3 @@ exports.FileParserRegistry = FileParserRegistry;
 function buildFileParser(parser) {
     return parser;
 }
-exports.buildFileParser = buildFileParser;

package/dist/swpp/JsonBuilder.js

@@ -15,6 +15,7 @@ class JsonBuilder {
     putHeader(key, value) {
         this.headers.set(key, value);
     }
+    // noinspection JSUnusedGlobalSymbols
     async buildJson() {
         const json = await this.compilation.compilationEnv.read('VERSION_FILE')();
         if (json.info.length == 0) {

package/dist/swpp/ResourcesScanner.js

@@ -30,6 +30,7 @@ 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");
 /**
@@ -39,6 +40,7 @@ class ResourcesScanner {
     constructor(compilation) {
         this.compilation = compilation;
     }
+    // noinspection JSUnusedGlobalSymbols
     /** 扫描指定目录下的所有文件 */
     async scanLocalFile(path) {
         const matchCacheRule = this.compilation.crossDep.read('matchCacheRule');
@@ -159,6 +161,7 @@ class FileUpdateTracker {
     addUrl(url) {
         this.allUrl.add(url);
     }
+    // noinspection JSUnusedGlobalSymbols
     /**
      * 判断两个 tracker 的差异
      *
@@ -186,6 +189,7 @@ class FileUpdateTracker {
         });
         return diff;
     }
+    // noinspection JSUnusedGlobalSymbols
     /**
      * 将数据序列化为 JSON
      *
@@ -242,5 +246,45 @@ class FileUpdateTracker {
         }
         return tracker;
     }
+    // noinspection JSUnusedGlobalSymbols
+    /** 从网络拉取并解析 tracker */
+    static async parserJsonFromNetwork(compilation, url) {
+        const fetcher = compilation.compilationEnv.read('FETCH_NETWORK_FILE');
+        const isNotFound = compilation.compilationEnv.read('IS_NOT_FOUND');
+        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/dist/swpp/SwCompiler.js

@@ -11,6 +11,7 @@ class SwCompiler {
     constructor() {
         this.swCode = '';
     }
+    // noinspection JSUnusedGlobalSymbols
     /**
      * 构建 sw 代码，该函数结果会被缓存
      */

package/dist/swpp/config/ConfigLoader.js

@@ -3,14 +3,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineRuntimeEvent = exports.defineRuntimeCore = exports.defineCrossDep = exports.defineRuntimeDep = exports.defineCrossEnv = exports.defineCompilationEnv = exports.defineConfig = exports.ConfigLoader = void 0;
+exports.ConfigLoader = void 0;
+exports.defineConfig = defineConfig;
+exports.defineCompilationEnv = defineCompilationEnv;
+exports.defineCrossEnv = defineCrossEnv;
+exports.defineRuntimeDep = defineRuntimeDep;
+exports.defineCrossDep = defineCrossDep;
+exports.defineRuntimeCore = defineRuntimeCore;
+exports.defineRuntimeEvent = defineRuntimeEvent;
+exports.defineIndivisibleConfig = defineIndivisibleConfig;
 const jiti_1 = require("jiti");
 const path_1 = __importDefault(require("path"));
 const untils_1 = require("../untils");
+const IndivisibleName = '1indivisible__';
 class ConfigLoader {
     constructor() {
         this.isBuilt = false;
     }
+    // noinspection JSUnusedGlobalSymbols
     /**
      * 加载一个配置文件，越早加载的优先级越高
      * @param file
@@ -38,6 +48,7 @@ class ConfigLoader {
         else
             this.config = newConfig;
     }
+    // noinspection JSUnusedGlobalSymbols
     /** 将配置项的内容写入到环境中 */
     write(runtime, compilation) {
         if (!this.config)
@@ -124,7 +135,7 @@ class ConfigLoader {
                     }
                     if (typeof highValue != typeof lowValue)
                         continue;
-                    if (typeof highValue == 'object') {
+                    if (typeof highValue == 'object' && !highValue[IndivisibleName] && !lowValue[IndivisibleName]) {
                         mergeHelper(highValue, lowValue);
                     }
                 }
@@ -143,43 +154,77 @@ ConfigLoader.extensions = [
 ];
 ConfigLoader.jiti = (0, jiti_1.createJiti)(__filename, {
     fsCache: false,
-    moduleCache: false,
     alias: {
-        'swpp-backends': path_1.default.join(__dirname, '..')
+        'swpp-backends': path_1.default.join(__dirname, '..', '..', 'index')
     }
 });
 /** 定义一个通过 `export default` 导出的配置 */
 function defineConfig(config) {
     return config;
 }
-exports.defineConfig = defineConfig;
 /** 定义一个通过 `export const compilationEnv` 导出的配置 */
 function defineCompilationEnv(config) {
     return config;
 }
-exports.defineCompilationEnv = defineCompilationEnv;
 /** 定义一个通过 `export const crossEnv` 导出的配置 */
 function defineCrossEnv(config) {
     return config;
 }
-exports.defineCrossEnv = defineCrossEnv;
 /** 定义一个通过 `export const runtimeDep` 导出的配置 */
 function defineRuntimeDep(config) {
     return config;
 }
-exports.defineRuntimeDep = defineRuntimeDep;
 /** 定义一个通过 `export const crossDep` 导出的配置 */
 function defineCrossDep(config) {
     return config;
 }
-exports.defineCrossDep = defineCrossDep;
 /** 定义一个通过 `export const runtimeCore` 导出的配置 */
 function defineRuntimeCore(config) {
     return config;
 }
-exports.defineRuntimeCore = defineRuntimeCore;
 /** 定义一个通过 `export const runtimeEvent` 导出的配置 */
 function defineRuntimeEvent(config) {
     return config;
 }
-exports.defineRuntimeEvent = defineRuntimeEvent;
+/**
+ * 定义一个无法分割的对象配置，这对一些强依赖对象内部属性的设置很有用，可以避免对象被错误地拼接。
+ *
+ * 默认情况下，当定义一个对象配置时，将允许从其它配置文件中合并一部分配置到对象中，比如：
+ *
+ * ```typescript
+ * // 当前配置
+ * exampleConfig.obj = {
+ *     value1: 'hello world'
+ * }
+ * // 如果还有一个配置文件中也声明了这个配置
+ * exampleConfig.obj = {
+ *     value2: 'hello swpp'
+ * }
+ * // 最终将合并生成如下配置
+ * exampleConfig.obj = {
+ *     value1: 'hello world',
+ *     value2: 'hello swpp'
+ * }
+ * ```
+ *
+ * 通过该函数，可以禁止 swpp 合并配置时仅选取对象的部分字段，要么全部使用 [value] 的值，要么完全不使用 [value] 的值。
+ *
+ * 放入到上述例子中，假如两个 obj 任意一个或多个通过 `defineIndivisibleConfig({ xxx: xxx })` 设置，最终的值将取决于两个配置文件的优先级，
+ * 若 `value2` 的优先级高将产生：
+ *
+ * ```typescript
+ * // 最终结果
+ * exampleConfig.obj = {
+ *     value2: 'hello swpp'
+ * }
+ * ```
+ */
+function defineIndivisibleConfig(value) {
+    Object.defineProperty(value, IndivisibleName, {
+        value: true,
+        writable: false,
+        configurable: false,
+        enumerable: false
+    });
+    return value;
+}

package/dist/swpp/database/CompilationEnv.js

@@ -26,7 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CompilationEnv = void 0;
+exports.AllowNotFoundEnum = exports.CompilationEnv = void 0;
 const fs_1 = __importDefault(require("fs"));
 const FileParser_1 = require("../FileParser");
 const NetworkFileHandler_1 = require("../NetworkFileHandler");
@@ -43,6 +43,16 @@ class CompilationEnv extends KeyValueDatabase_1.KeyValueDatabase {
     }
 }
 exports.CompilationEnv = CompilationEnv;
+/** 拉取版本信息和 tracker 时的 404 等级 */
+var AllowNotFoundEnum;
+(function (AllowNotFoundEnum) {
+    /** 允许任意形式的 404，包含 DNS 解析失败 */
+    AllowNotFoundEnum[AllowNotFoundEnum["ALLOW_ALL"] = 0] = "ALLOW_ALL";
+    /** 允许服务器返回 404 */
+    AllowNotFoundEnum[AllowNotFoundEnum["ALLOW_STATUS"] = 1] = "ALLOW_STATUS";
+    /** 拒绝任意形式的 404 */
+    AllowNotFoundEnum[AllowNotFoundEnum["REJECT_ALL"] = 2] = "REJECT_ALL";
+})(AllowNotFoundEnum || (exports.AllowNotFoundEnum = AllowNotFoundEnum = {}));
 function buildCommon(_env, crossEnv, crossCode) {
     const env = _env;
     return {
@@ -130,6 +140,19 @@ function buildCommon(_env, crossEnv, crossCode) {
                 error: (err) => err?.cause?.code === 'ENOTFOUND'
             }
         }),
+        ALLOW_NOT_FOUND: (0, KeyValueDatabase_1.buildEnv)({
+            default: AllowNotFoundEnum.ALLOW_STATUS,
+            checker(value) {
+                switch (value) {
+                    case AllowNotFoundEnum.ALLOW_ALL:
+                    case AllowNotFoundEnum.ALLOW_STATUS:
+                    case AllowNotFoundEnum.REJECT_ALL:
+                        return false;
+                    default:
+                        return { value, message: '填写了非法的 ALLOW_NOT_FOUND 值' };
+                }
+            }
+        }),
         FILE_PARSER: (0, KeyValueDatabase_1.buildEnv)({
             default: createRegister(env, crossEnv, crossCode)
         })

package/dist/swpp/database/KeyValueDatabase.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildEnv = exports.KeyValueDatabase = void 0;
+exports.KeyValueDatabase = void 0;
+exports.buildEnv = buildEnv;
 /** 键值对存储器 */
 class KeyValueDatabase {
     constructor(map) {
@@ -73,4 +74,3 @@ exports.KeyValueDatabase = KeyValueDatabase;
 function buildEnv(env) {
     return env;
 }
-exports.buildEnv = buildEnv;

package/dist/swpp/untils.js

@@ -177,7 +177,7 @@ exports.utils = Object.freeze({
         return `${hours}:${minutes}:${seconds}`;
     },
     printError(title, err) {
-        console.error(`[${this.time()}] [ERR] [SWPP] [${title}]: ${JSON.stringify(err, null, 2)}`);
+        console.error(`[${this.time()}] [ERR] [SWPP] [${title}]: `, err);
     },
     printInfo(title, info) {
         console.info(`[${this.time()}] [INFO] [SWPP] [${title}]: ${JSON.stringify(info, null, 2)}`);
@@ -252,5 +252,9 @@ exports.exceptionNames = {
     /** 空指针 */
     nullPoint: 'null_point',
     /** 配置文件已经完成构建 */
-    configBuilt: 'config_built'
+    configBuilt: 'config_built',
+    /** 404 错误 */
+    notFound: 'not_found',
+    /** 未知分类错误 */
+    error: 'error'
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swpp-backends",
-  "version": "3.0.0-alpha.0",
+  "version": "3.0.0-alpha.1",
   "main": "dist/index.js",
   "typings": "types/index.d.ts",
   "description": "Generate a powerful ServiceWorker for your website.",
@@ -12,8 +12,8 @@
   ],
   "devDependencies": {
     "@types/fast-html-parser": "^1.0.2",
-    "@types/node": "^20.4.5",
-    "typescript": "^5.1.6"
+    "@types/node": "^22.0.2",
+    "typescript": "^5.5.4"
   },
   "dependencies": {
     "fast-html-parser": "^1.0.1",

package/types/index.d.ts

@@ -1,2 +1,31 @@
+import { COMMON_TYPE_COMP_ENV } from './swpp/database/CompilationEnv';
+import { COMMON_TYPE_CROSS_DEP } from './swpp/database/CrossDepCode';
+import { COMMON_TYPE_CROSS_ENV } from './swpp/database/CrossEnv';
+import { COMMON_TYPE_RUNTIME_CORE } from './swpp/database/RuntimeCoreCode';
+import { COMMON_KEY_RUNTIME_DEP } from './swpp/database/RuntimeDepCode';
+import { COMMON_TYPE_RUNTIME_EVENT } from './swpp/database/RuntimeEventCode';
 /** 版本号 */
 export declare const version: 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, SwppConfigRuntimeEvent, SwppConfigRuntimeCore, SwppConfigRuntimeDep, SwppConfigCrossDep, SwppConfigCrossEnv, SwppConfigCompilationEnv, SwppConfigTemplate, defineCompilationEnv, defineConfig, defineCrossEnv, defineCrossDep, defineRuntimeDep, defineRuntimeCore, defineRuntimeEvent, defineIndivisibleConfig } from './swpp/config/ConfigLoader';
+export { KeyValueDatabase, DatabaseValue, RuntimeEnvErrorTemplate, RuntimeEnvException } 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 declare namespace SwppType {
+    type RuntimeEventCode = COMMON_TYPE_RUNTIME_EVENT;
+    type RuntimeCoreCode = COMMON_TYPE_RUNTIME_CORE;
+    type RuntimeDepCode = COMMON_KEY_RUNTIME_DEP;
+    type CrossEnv = COMMON_TYPE_CROSS_ENV;
+    type CrossDep = COMMON_TYPE_CROSS_DEP;
+    type CompilationEnv = COMMON_TYPE_COMP_ENV;
+}

package/types/swpp/FileParser.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import * as crypto from 'node:crypto';
 import { CompilationData } from './SwCompiler';
 export declare class FileParserRegistry {

package/types/swpp/ResourcesScanner.d.ts

@@ -64,4 +64,6 @@ export declare class FileUpdateTracker {
     json(): string;
     /** 解序列化数据 */
     static unJson(compilation: CompilationData, jsonStr: string): FileUpdateTracker;
+    /** 从网络拉取并解析 tracker */
+    static parserJsonFromNetwork(compilation: CompilationData, url: RequestInfo | URL): Promise<FileUpdateTracker>;
 }

package/types/swpp/config/ConfigLoader.d.ts

@@ -35,6 +35,40 @@ export declare function defineCrossDep(config: SwppConfigCrossDep): SwppConfigCr
 export declare function defineRuntimeCore(config: SwppConfigRuntimeCore): SwppConfigRuntimeCore;
 /** 定义一个通过 `export const runtimeEvent` 导出的配置 */
 export declare function defineRuntimeEvent(config: SwppConfigRuntimeEvent): SwppConfigRuntimeEvent;
+/**
+ * 定义一个无法分割的对象配置，这对一些强依赖对象内部属性的设置很有用，可以避免对象被错误地拼接。
+ *
+ * 默认情况下，当定义一个对象配置时，将允许从其它配置文件中合并一部分配置到对象中，比如：
+ *
+ * ```typescript
+ * // 当前配置
+ * exampleConfig.obj = {
+ *     value1: 'hello world'
+ * }
+ * // 如果还有一个配置文件中也声明了这个配置
+ * exampleConfig.obj = {
+ *     value2: 'hello swpp'
+ * }
+ * // 最终将合并生成如下配置
+ * exampleConfig.obj = {
+ *     value1: 'hello world',
+ *     value2: 'hello swpp'
+ * }
+ * ```
+ *
+ * 通过该函数，可以禁止 swpp 合并配置时仅选取对象的部分字段，要么全部使用 [value] 的值，要么完全不使用 [value] 的值。
+ *
+ * 放入到上述例子中，假如两个 obj 任意一个或多个通过 `defineIndivisibleConfig({ xxx: xxx })` 设置，最终的值将取决于两个配置文件的优先级，
+ * 若 `value2` 的优先级高将产生：
+ *
+ * ```typescript
+ * // 最终结果
+ * exampleConfig.obj = {
+ *     value2: 'hello swpp'
+ * }
+ * ```
+ */
+export declare function defineIndivisibleConfig<T extends Record<string, any>>(value: T): T;
 type ValueOrReturnValue<T> = T | ((this: CompilationData) => T);
 /**
  * SWPP 配置模板

package/types/swpp/database/CompilationEnv.d.ts

@@ -11,6 +11,15 @@ export type COMMON_TYPE_COMP_ENV = ReturnType<typeof buildCommon>;
 export declare class CompilationEnv extends KeyValueDatabase<any, COMMON_TYPE_COMP_ENV> {
     constructor(crossEnv: CrossEnv, crossCode: CrossDepCode);
 }
+/** 拉取版本信息和 tracker 时的 404 等级 */
+export declare enum AllowNotFoundEnum {
+    /** 允许任意形式的 404，包含 DNS 解析失败 */
+    ALLOW_ALL = 0,
+    /** 允许服务器返回 404 */
+    ALLOW_STATUS = 1,
+    /** 拒绝任意形式的 404 */
+    REJECT_ALL = 2
+}
 declare function buildCommon(_env: any, crossEnv: CrossEnv, crossCode: CrossDepCode): {
     readonly DOMAIN_HOST: import("./KeyValueDatabase").DatabaseValue<string>;
     /** HTML 数量限制 */
@@ -28,6 +37,7 @@ declare function buildCommon(_env: any, crossEnv: CrossEnv, crossCode: CrossDepC
         response: (response: Response) => boolean;
         error: (err: any) => boolean;
     }>;
+    readonly ALLOW_NOT_FOUND: import("./KeyValueDatabase").DatabaseValue<AllowNotFoundEnum>;
     readonly FILE_PARSER: import("./KeyValueDatabase").DatabaseValue<FileParserRegistry>;
 };
 export {};

package/types/swpp/untils.d.ts

@@ -34,7 +34,7 @@ export declare const utils: Readonly<{
      */
     anyToSource(obj: {
         [p: string]: any;
-    }, includeEmptyValue?: boolean, writeAsVar?: 'let' | 'const'): string;
+    }, includeEmptyValue?: boolean, writeAsVar?: "let" | "const"): string;
     /** 判断指定链接的 host 是否为指定的 host */
     isSameHost(path: string, host: string): boolean;
     /** 计算字符串的哈希值 */
@@ -48,21 +48,21 @@ export declare const utils: Readonly<{
      * @param obj
      * @param transfer
      */
-    objMap<T_1, R>(obj: {
-        [key: string]: T_1;
-    }, transfer: (item: T_1) => R): {
+    objMap<T, R>(obj: {
+        [key: string]: T;
+    }, transfer: (item: T) => R): {
         [key: string]: R;
     };
     /** 深度冻结一个对象 */
-    deepFreeze<T_2>(obj: T_2): Readonly<T_2>;
+    deepFreeze<T>(obj: T): Readonly<T>;
     /** 二分查找 */
-    binarySearch<T_3>(array: T_3[], value: T_3, startInclude?: number, endExclude?: number, comparator?: (a: T_3, b: T_3) => number): number;
+    binarySearch<T>(array: T[], value: T, startInclude?: number, endExclude?: number, comparator?: (a: T, b: T) => number): number;
     /**
      * 在可迭代容器中查找满足指定条件的元素的下标
      */
-    findValueInIterable<T_4>(set: Iterable<T_4>, predicate: (item: T_4) => boolean): {
+    findValueInIterable<T>(set: Iterable<T>, predicate: (item: T) => boolean): {
         index: number;
-        value: T_4;
+        value: T;
     }[];
 }>;
 export declare const exceptionNames: {
@@ -80,6 +80,10 @@ export declare const exceptionNames: {
     readonly nullPoint: "null_point";
     /** 配置文件已经完成构建 */
     readonly configBuilt: "config_built";
+    /** 404 错误 */
+    readonly notFound: "not_found";
+    /** 未知分类错误 */
+    readonly error: "error";
 };
 export interface RuntimeException {
     /** 报错类型代码 */