swpp-backends 3.0.0-alpha.3 → 3.0.0-alpha.310

package/dist/swpp/database/CompilationEnv.js

@@ -1,45 +1,21 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AllowNotFoundEnum = exports.CompilationEnv = void 0;
 const fs_1 = __importDefault(require("fs"));
-const FileParser_1 = require("../FileParser");
 const NetworkFileHandler_1 = require("../NetworkFileHandler");
+const ResourcesScanner_1 = require("../ResourcesScanner");
 const untils_1 = require("../untils");
 const KeyValueDatabase_1 = require("./KeyValueDatabase");
-const HTMLParser = __importStar(require("fast-html-parser"));
 /**
  * 仅在编译期生效的配置项
  */
 class CompilationEnv extends KeyValueDatabase_1.KeyValueDatabase {
-    constructor(crossEnv, crossCode) {
-        super();
-        this.lazyInit(buildCommon(this, crossEnv, crossCode));
+    constructor() {
+        super('CompilationEnv');
+        this.lazyInit(buildCommon(this));
     }
 }
 exports.CompilationEnv = CompilationEnv;
@@ -53,32 +29,36 @@ var AllowNotFoundEnum;
     /** 拒绝任意形式的 404 */
     AllowNotFoundEnum[AllowNotFoundEnum["REJECT_ALL"] = 2] = "REJECT_ALL";
 })(AllowNotFoundEnum || (exports.AllowNotFoundEnum = AllowNotFoundEnum = {}));
-function buildCommon(_env, crossEnv, crossCode) {
+function buildCommon(_env) {
     const env = _env;
     return {
         DOMAIN_HOST: (0, KeyValueDatabase_1.buildEnv)({
-            default: 'www.example.com',
+            default: new URL("https://www.example.com"),
             checker(value) {
-                if (value === 'www.example.com')
-                    return {
-                        value, message: '应当手动设置一个域名而非使用默认域名'
-                    };
-                if (value.includes('/'))
+                if (value.host === 'www.example.com')
                     return {
-                        value, message: '传入的域名不应当包含“/”字符'
+                        value, message: 'DOMAIN_HOST 必须手动设置而非使用默认值'
                     };
-                if (value.includes('#') || value.includes('?'))
+                if (value.hash || value.search)
                     return {
                         value, message: '传入的域名不应当包含查询参数和片段标识符'
                     };
-                if (!value.includes('.') || !/^[a-zA-Z0-9.-]$/.test(value))
+                if (value.protocol !== 'https:' && value.host !== '127.0.0.1' && value.host !== 'localhost')
                     return {
-                        value, message: '传入的域名不是一个合法的域名'
+                        value, message: '传入的 URL 必须使用 https 协议'
                     };
                 return false;
             }
         }),
-        /** HTML 数量限制 */
+        SERVICE_WORKER: (0, KeyValueDatabase_1.buildEnv)({
+            default: 'sw',
+            checker(value) {
+                return value.endsWith('.js') ? {
+                    value, message: 'SW 文件名不需要包含拓展名'
+                } : false;
+            }
+        }),
+        /** HTML 数量限制，设置为 <= 0 表示不限制 */
         JSON_HTML_LIMIT: (0, KeyValueDatabase_1.buildEnv)({
             default: 0
         }),
@@ -96,16 +76,20 @@ function buildCommon(_env, crossEnv, crossCode) {
                 return false;
             }
         }),
-        /** 获取已经上线的版本文件 */
-        VERSION_FILE: (0, KeyValueDatabase_1.buildEnv)({
+        /** swpp 的 JSON 文件的基本信息 */
+        SWPP_JSON_FILE: (0, KeyValueDatabase_1.buildEnv)({
             default: {
-                path: 'update.json',
-                async fetcher() {
-                    const host = env.read('DOMAIN_HOST');
-                    const fetcher = env.read('FETCH_NETWORK_FILE');
-                    const isNotFound = env.read('IS_NOT_FOUND');
+                swppPath: 'swpp',
+                trackerPath: 'tracker.json',
+                versionPath: 'update.json',
+                async fetchVersionFile() {
+                    const baseUrl = env.read('DOMAIN_HOST');
+                    const fetcher = env.read('NETWORK_FILE_FETCHER');
+                    const isNotFound = env.read('isNotFound');
                     try {
-                        const response = await fetcher.fetch(`https://${host}/${this.path}`);
+                        const swppPath = (0, KeyValueDatabase_1.readThisValue)(this, 'swppPath');
+                        const versionPath = (0, KeyValueDatabase_1.readThisValue)(this, 'versionPath');
+                        const response = await fetcher.fetch(untils_1.utils.splicingUrl(baseUrl, swppPath, versionPath));
                         if (!isNotFound.response(response)) {
                             const json = await response.json();
                             return json;
@@ -116,11 +100,14 @@ function buildCommon(_env, crossEnv, crossCode) {
                             throw e;
                     }
                     return { global: 0, info: [] };
+                },
+                async fetchTrackerFile(compilation) {
+                    return await ResourcesScanner_1.FileUpdateTracker.parserJsonFromNetwork(compilation);
                 }
             }
         }),
         /** 读取一个本地文件 */
-        LOCAL_FILE_READER: (0, KeyValueDatabase_1.buildEnv)({
+        readLocalFile: (0, KeyValueDatabase_1.buildEnv)({
             default: (path) => {
                 return new Promise((resolve, reject) => {
                     fs_1.default.readFile(path, 'utf8', (err, data) => {
@@ -133,11 +120,11 @@ function buildCommon(_env, crossEnv, crossCode) {
             }
         }),
         /** 拉取网络文件 */
-        FETCH_NETWORK_FILE: (0, KeyValueDatabase_1.buildEnv)({
+        NETWORK_FILE_FETCHER: (0, KeyValueDatabase_1.buildEnv)({
             default: new NetworkFileHandler_1.FiniteConcurrencyFetcher()
         }),
         /** 判断文件是否是 404 */
-        IS_NOT_FOUND: (0, KeyValueDatabase_1.buildEnv)({
+        isNotFound: (0, KeyValueDatabase_1.buildEnv)({
             default: {
                 response: (response) => response.status == 404,
                 error: (err) => err?.cause?.code === 'ENOTFOUND'
@@ -157,152 +144,9 @@ function buildCommon(_env, crossEnv, crossCode) {
                 }
             }
         }),
-        /** 文件解析器 */
-        FILE_PARSER: (0, KeyValueDatabase_1.buildEnv)({
-            default: createRegister(env, crossEnv, crossCode)
+        /** 检查一个链接是否是稳定的（也就是 URL 不变其返回的结果永远不变） */
+        isStable: (0, KeyValueDatabase_1.buildEnv)({
+            default: (_url) => false
         })
     };
 }
-function createRegister(env, crossEnv, crossCode) {
-    const register = new FileParser_1.FileParserRegistry({
-        compilationEnv: env,
-        crossEnv,
-        crossDep: crossCode
-    });
-    register.registry('html', (0, FileParser_1.buildFileParser)({
-        readFromLocal(compilation, path) {
-            return compilation.compilationEnv.read('LOCAL_FILE_READER')(path);
-        },
-        readFromNetwork(_, response) {
-            return response.text();
-        },
-        async extractUrls(compilation, content) {
-            const host = compilation.compilationEnv.read("DOMAIN_HOST");
-            const html = HTMLParser.parse(content, {
-                script: true, style: true
-            });
-            const queue = [html];
-            const result = new Set();
-            async function handleItem(item) {
-                queue.push(...item.childNodes);
-                switch (item.tagName.toLowerCase()) {
-                    case 'script': {
-                        if (!register.containsType('script'))
-                            break;
-                        const src = item.attributes.src;
-                        if (src) {
-                            const son = await register.parserContent('script', item.rawText);
-                            son.forEach(it => result.add(it));
-                        }
-                        else if (!untils_1.utils.isSameHost(src, host)) {
-                            result.add(src);
-                        }
-                        break;
-                    }
-                    case 'link': {
-                        if (item.attributes.rel !== 'preconnect') {
-                            const href = item.attributes.href;
-                            if (!untils_1.utils.isSameHost(href, host))
-                                result.add(href);
-                        }
-                        break;
-                    }
-                    case 'img':
-                    case 'source':
-                    case 'iframe':
-                    case 'embed': {
-                        const src = item.attributes.src;
-                        if (src && !untils_1.utils.isSameHost(src, host)) {
-                            result.add(src);
-                        }
-                        break;
-                    }
-                    case 'object': {
-                        const data = item.attributes.data;
-                        if (data && !untils_1.utils.isSameHost(data, host)) {
-                            result.add(data);
-                        }
-                        break;
-                    }
-                    case 'style': {
-                        const son = await register.parserContent('css', item.rawText);
-                        son.forEach(it => result.add(it));
-                        break;
-                    }
-                }
-            }
-            do {
-                const item = queue.pop();
-                try {
-                    await handleItem(item);
-                }
-                catch (e) {
-                    untils_1.utils.printError('PARSER HTML', e);
-                }
-            } while (queue.length > 0);
-            return result;
-        }
-    }));
-    register.registry('css', (0, FileParser_1.buildFileParser)({
-        readFromLocal(compilation, path) {
-            return compilation.compilationEnv.read('LOCAL_FILE_READER')(path);
-        },
-        readFromNetwork(_, response) {
-            return response.text();
-        },
-        async extractUrls(compilation, content) {
-            const host = compilation.compilationEnv.read('DOMAIN_HOST');
-            const urls = new Set();
-            /** 从指定位置开始查询注释 */
-            const findComment = (tag, start) => {
-                for (let i = start; i < content.length;) {
-                    const item = content[i];
-                    switch (item) {
-                        case tag[0]:
-                            if (content[i + 1] === tag[1])
-                                return i;
-                            ++i;
-                            break;
-                        case '"':
-                        case '\'':
-                            while (true) {
-                                const index = content.indexOf(item, i + 1);
-                                if (index < 0)
-                                    return -1;
-                                i = index + 1;
-                                if (content[index - 1] !== '\\')
-                                    break;
-                            }
-                            break;
-                        default:
-                            ++i;
-                            break;
-                    }
-                }
-                return -1;
-            };
-            for (let i = 0; i < content.length;) {
-                const left = findComment('/*', i);
-                let sub;
-                if (left === -1) {
-                    sub = content.substring(i);
-                    i = Number.MAX_VALUE;
-                }
-                else {
-                    sub = content.substring(i, left);
-                    const right = findComment('*/', left + 2);
-                    if (right === -1)
-                        i = Number.MAX_VALUE;
-                    else
-                        i = right + 2;
-                }
-                sub.match(/(url\(.*?\))|(@import\s+['"].*?['"])|((https?:)?\/\/[^\s/$.?#].\S*)/g)
-                    ?.map(it => it.replace(/(^url\(\s*(['"]?))|((['"]?\s*)\)$)|(^@import\s+['"])|(['"]$)/g, ''))
-                    ?.filter(it => !untils_1.utils.isSameHost(it, host))
-                    ?.forEach(it => urls.add(it));
-            }
-            return urls;
-        }
-    }));
-    return register;
-}

package/dist/swpp/database/CompilationFileParser.d.ts

@@ -0,0 +1,81 @@
+import * as crypto from 'node:crypto';
+import { CompilationData } from '../SwCompiler';
+import { KeyValueDatabase } from './KeyValueDatabase';
+export type COMMON_TYPE_COMP_FP = ReturnType<typeof buildCommon>;
+export declare class CompilationFileParser extends KeyValueDatabase<FileParser<crypto.BinaryLike>, COMMON_TYPE_COMP_FP> {
+    constructor();
+    /** 解析本地文件 */
+    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>>;
+    /**
+     * 解析指定的 URL
+     * @param url 链接
+     * @param isCached 该链接指向的资源是否需要缓存
+     */
+    parserUrlFile(url: string, isCached: boolean): Promise<FileMark>;
+    /** 解析指定类型的文件内容 */
+    parserContent(type: string, content: string): Promise<Set<string>>;
+}
+declare function buildCommon($this: any): {
+    readonly html: {
+        readonly default: {
+            readonly readFromLocal: (compilation: CompilationData, path: string) => Promise<string>;
+            readonly readFromNetwork: (_: CompilationData, response: Response) => Promise<string>;
+            readonly extractUrls: (compilation: CompilationData, content: string) => Promise<Set<string>>;
+        };
+    };
+    readonly css: {
+        readonly default: {
+            readonly readFromLocal: (compilation: CompilationData, path: string) => Promise<string>;
+            readonly readFromNetwork: (_: CompilationData, response: Response) => Promise<string>;
+            readonly extractUrls: (compilation: CompilationData, content: string) => Promise<Set<string>>;
+        };
+    };
+};
+/**
+ * 文件处理器
+ *
+ * 用于处理指定类型的文件，从中提取文件的 mark 和外部链接列表
+ */
+export interface FileParser<T extends crypto.BinaryLike> {
+    /**
+     * 从本地读取一个文件
+     * @param compilation 编译期依赖
+     * @param path 文件路径
+     */
+    readFromLocal(compilation: CompilationData, path: string): Promise<T>;
+    /**
+     * 从网络读取一个文件
+     * @param compilation 编译期依赖
+     * @param response 拉取的结果
+     */
+    readFromNetwork(compilation: CompilationData, response: Response): Promise<T>;
+    /**
+     * 从文件内容中提取 URL
+     * @param compilation 编译期依赖
+     * @param content 文件内容
+     */
+    extractUrls(compilation: CompilationData, content: T): Promise<Set<string>>;
+    /**
+     * 计算一个链接对应的资源的标识符及其内部资源
+     * @return 返回 undefined/null 表示使用缺省逻辑
+     */
+    calcUrl?(url: string): Promise<Omit<FileMark, 'file'> | undefined | null>;
+}
+/**
+ * 存储文件标识信息
+ */
+export interface FileMark {
+    /** URL */
+    file: string;
+    /**
+     * 文件标识符或子文件列表
+     *
+     * 如果链接为稳定链接，则为子文件列表，否则为文件标识符
+     */
+    mark: string | Set<string>;
+    /** URL 列表 */
+    urls: Set<string>;
+}
+export {};

package/dist/swpp/database/CompilationFileParser.js

@@ -0,0 +1,267 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompilationFileParser = void 0;
+const HTMLParser = __importStar(require("fast-html-parser"));
+const path_1 = __importDefault(require("path"));
+const untils_1 = require("../untils");
+const KeyValueDatabase_1 = require("./KeyValueDatabase");
+class CompilationFileParser extends KeyValueDatabase_1.KeyValueDatabase {
+    constructor() {
+        super('CompilationFileParser');
+        this.lazyInit(buildCommon(this));
+    }
+    /** 解析本地文件 */
+    async parserLocalFile(path, cb, force) {
+        const extname = path_1.default.extname(path).substring(1);
+        if (this.hasKey(extname)) {
+            const parser = this.read(extname);
+            const content = await parser.readFromLocal(this.compilation, path);
+            cb?.(content);
+            return await parser.extractUrls(this.compilation, content);
+        }
+        else {
+            if (force && cb) {
+                const reader = this.compilation.compilationEnv.read('readLocalFile');
+                const content = await reader(path);
+                cb(content);
+            }
+            return new Set();
+        }
+    }
+    /** 解析网络文件 */
+    async parserNetworkFile(response, callback) {
+        const fileHandler = this.compilation.compilationEnv.read('NETWORK_FILE_FETCHER');
+        const contentType = fileHandler.getUrlContentType(response.url, response);
+        if (this.hasKey(contentType)) {
+            const parser = this.read(contentType);
+            const content = await parser.readFromNetwork(this.compilation, response);
+            if (callback)
+                await callback(content);
+            return await parser.extractUrls(this.compilation, content);
+        }
+        else {
+            if (callback) {
+                const blob = await response.blob();
+                const array = await blob.stream().getReader().read();
+                callback(array.value);
+            }
+            return new Set();
+        }
+    }
+    /**
+     * 解析指定的 URL
+     * @param url 链接
+     * @param isCached 该链接指向的资源是否需要缓存
+     */
+    async parserUrlFile(url, isCached) {
+        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.hasKey(contentType) ? this.read(contentType) : undefined;
+        if (!parser && !isCached)
+            return { file: url, mark: '', urls: new Set() };
+        if (parser?.calcUrl) {
+            const result = await parser.calcUrl(url);
+            if (result)
+                return {
+                    file: url,
+                    ...result
+                };
+        }
+        const fetcher = this.compilation.compilationEnv.read('NETWORK_FILE_FETCHER');
+        const urls = new Set();
+        let mark = '';
+        await fetcher.fetch(url)
+            .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 };
+    }
+    /** 解析指定类型的文件内容 */
+    async parserContent(type, content) {
+        if (!this.hasKey(type))
+            return new Set();
+        const parser = this.read(type);
+        return await parser.extractUrls(this.compilation, content);
+    }
+}
+exports.CompilationFileParser = CompilationFileParser;
+function buildCommon($this) {
+    const registry = $this;
+    return {
+        html: {
+            default: {
+                readFromLocal(compilation, path) {
+                    return compilation.compilationEnv.read('readLocalFile')(path);
+                },
+                readFromNetwork(_, response) {
+                    return response.text();
+                },
+                async extractUrls(compilation, content) {
+                    const baseUrl = compilation.compilationEnv.read("DOMAIN_HOST");
+                    const html = HTMLParser.parse(content, {
+                        script: true, style: true
+                    });
+                    const queue = [html];
+                    const result = new Set();
+                    async function handleItem(item) {
+                        queue.push(...(item.childNodes ?? []));
+                        if (!item.tagName)
+                            return;
+                        switch (item.tagName.toLowerCase()) {
+                            case 'script': {
+                                const src = item.attributes.src;
+                                if (src) {
+                                    if (!untils_1.utils.isSameHost(src, baseUrl)) {
+                                        result.add(src);
+                                    }
+                                }
+                                else {
+                                    const son = await registry.parserContent('js', item.rawText);
+                                    son.forEach(it => result.add(it));
+                                }
+                                break;
+                            }
+                            case 'link': {
+                                if (item.attributes.rel !== 'preconnect') {
+                                    const href = item.attributes.href;
+                                    if (!href) {
+                                        const son = await registry.parserContent('css', item.rawText);
+                                        son.forEach(it => result.add(it));
+                                    }
+                                    else if (!untils_1.utils.isSameHost(href, baseUrl)) {
+                                        result.add(href);
+                                    }
+                                }
+                                break;
+                            }
+                            case 'img':
+                            case 'source':
+                            case 'iframe':
+                            case 'embed': {
+                                const src = item.attributes.src;
+                                if (src && !untils_1.utils.isSameHost(src, baseUrl)) {
+                                    result.add(src);
+                                }
+                                break;
+                            }
+                            case 'object': {
+                                const data = item.attributes.data;
+                                if (data && !untils_1.utils.isSameHost(data, baseUrl)) {
+                                    result.add(data);
+                                }
+                                break;
+                            }
+                            case 'style': {
+                                const son = await registry.parserContent('css', item.rawText);
+                                son.forEach(it => result.add(it));
+                                break;
+                            }
+                        }
+                    }
+                    try {
+                        do {
+                            const item = queue.pop();
+                            await handleItem(item);
+                        } while (queue.length > 0);
+                    }
+                    catch (e) {
+                        throw new untils_1.RuntimeException(untils_1.exceptionNames.error, '解析 HTML 时出现错误', { cause: e });
+                    }
+                    return result;
+                }
+            }
+        },
+        css: {
+            default: {
+                readFromLocal(compilation, path) {
+                    return compilation.compilationEnv.read('readLocalFile')(path);
+                },
+                readFromNetwork(_, response) {
+                    return response.text();
+                },
+                async extractUrls(compilation, content) {
+                    const baseUrl = compilation.compilationEnv.read('DOMAIN_HOST');
+                    const urls = new Set();
+                    /** 从指定位置开始查询注释 */
+                    const findComment = (tag, start) => {
+                        for (let i = start; i < content.length;) {
+                            const item = content[i];
+                            switch (item) {
+                                case tag[0]:
+                                    if (content[i + 1] === tag[1])
+                                        return i;
+                                    ++i;
+                                    break;
+                                case '"':
+                                case '\'':
+                                    while (true) {
+                                        const index = content.indexOf(item, i + 1);
+                                        if (index < 0)
+                                            return -1;
+                                        i = index + 1;
+                                        if (content[index - 1] !== '\\')
+                                            break;
+                                    }
+                                    break;
+                                default:
+                                    ++i;
+                                    break;
+                            }
+                        }
+                        return -1;
+                    };
+                    for (let i = 0; i < content.length;) {
+                        const left = findComment('/*', i);
+                        let sub;
+                        if (left === -1) {
+                            sub = content.substring(i);
+                            i = Number.MAX_VALUE;
+                        }
+                        else {
+                            sub = content.substring(i, left);
+                            const right = findComment('*/', left + 2);
+                            if (right === -1)
+                                i = Number.MAX_VALUE;
+                            else
+                                i = right + 2;
+                        }
+                        sub.match(/(url\(.*?\))|(@import\s+['"].*?['"])|((https?:)?\/\/[^\s/$.?#].\S*)/g)
+                            ?.map(it => it.replace(/(^url\(\s*(['"]?))|((['"]?\s*)\)$)|(^@import\s+['"])|(['"]$)/g, ''))
+                            ?.filter(it => !untils_1.utils.isSameHost(it, baseUrl))
+                            ?.forEach(it => urls.add(it));
+                    }
+                    return urls;
+                }
+            }
+        }
+    };
+}

package/{types → dist}/swpp/database/CrossDepCode.d.ts

@@ -22,6 +22,10 @@ declare function buildCommon(): {
     readonly matchCacheRule: {
         readonly default: FunctionInBrowserAndNode<[_url: URL], number | false | null | undefined>;
     };
+    /** 归一化 URL */
+    readonly normalizeUrl: {
+        readonly default: FunctionInBrowserAndNode<[url: string], string>;
+    };
     /** 匹配缓存更新规则 */
     readonly matchUpdateRule: {
         readonly default: FunctionInBrowserAndNode<[exp: UpdateChangeExp], (url: string) => boolean | undefined | null>;