@rexnow/rslib-plugin 3.0.1 → 3.1.1

package/README.md

@@ -11,6 +11,7 @@
 
 - 🔧 **自动类型生成**：根据 `WidgetMetadata` 自动生成 TypeScript 类型定义
 - 📦 **构建优化**：清除 Rex Widget 不支持的导出声明
+- 🔐 **模块加密**：可选调用 Rex 官方加密服务，将产物写成 `REXENC` 格式
 - 🛠️ **开发体验**：提供完整的类型支持和智能提示
 - 🔄 **热更新**：开发模式下自动重新生成类型定义
 
@@ -56,6 +57,7 @@ export default defineConfig({
   plugins: [
     pluginRexWidget({
       typesFilePath: 'src/custom-types.d.ts', // 自定义类型文件路径
+      encrypt: true, // 生产构建后加密 JS 产物
     }),
   ],
   lib: [
@@ -73,6 +75,7 @@ export default defineConfig({
 | 选项 | 类型 | 默认值 | 描述 |
 |------|------|--------|------|
 | `typesFilePath` | `string` | `'src/rex-widget-env.d.ts'` | 生成的类型定义文件路径 |
+| `encrypt` | `boolean` | `false` | 生产构建后调用 [Rex 模块加密](https://rexnow.tv/encrypt/) 服务，将 JS 产物写成 `REXENC` 格式。`watch` 开发监听时不会加密。 |
 
 ## 💡 工作原理
 
@@ -154,6 +157,12 @@ type SearchContentType = typeof searchContent;
 
 插件会自动清除构建输出中的导出声明，因为 Rex Widget 不支持脚本有导出声明。
 
+### 4. 模块加密
+
+设置 `encrypt: true` 后，插件会在类型生成完成之后，把构建出的 `.js` 发送到 `https://api.rexnow.tv/api/widgets/encrypt`，并用返回的 `REXENC` 信封覆盖产物。协议与 [rexnow.tv/encrypt](https://rexnow.tv/encrypt/) 一致：`AES-256-GCM`（`A256GCM` / `rex-1`），加密结果仅供 Rex 使用。
+
+请保留未加密的源码。加密不会在 `rslib build --watch` 时执行，以免开发服务器读到密文。构建机需要能访问 `api.rexnow.tv`；加密失败会使生产构建失败。大文件可能需要 1–2 分钟；超过 2 MiB 或已经是 `REXENC` / `FWENC` 的文件会被拒绝。不要同时发布未加密的 source map。
+
 ## 📚 完整示例
 
 ### 项目结构

package/dist/encrypt.d.ts

@@ -0,0 +1,5 @@
+export declare const ENCRYPT_ENDPOINT = "https://api.rexnow.tv/api/widgets/encrypt";
+export declare const ENCRYPT_MAX_BYTES: number;
+export declare function isEncryptedWidget(source: string): boolean;
+export declare function validateEncryptEnvelope(text: string): void;
+export declare function encryptWidgetSource(source: string): Promise<string>;

package/dist/index.d.ts

@@ -10,6 +10,12 @@ interface RexWidgetPluginOptions {
      * @default 8000
      */
     devPort?: number;
+    /**
+     * 生产构建后调用 Rex 加密服务，将 JS 产物写成 REXENC 格式。
+     * watch / 开发监听时不会加密。
+     * @default false
+     */
+    encrypt?: boolean;
 }
-export declare const pluginRexWidget: ({ typesFilePath, devPort, }?: RexWidgetPluginOptions) => RsbuildPlugin;
+export declare const pluginRexWidget: ({ typesFilePath, devPort, encrypt, }?: RexWidgetPluginOptions) => RsbuildPlugin;
 export {};

package/dist/index.js

@@ -6058,7 +6058,7 @@ const videoItemChildSchema = schemas_object({
     previewUrl: schemas_string().optional(),
     trailers: schemas_array(trailerItemSchema).optional(),
     videoUrl: schemas_string().optional(),
-    link: schemas_string(),
+    link: schemas_string().optional(),
     episode: schemas_number().optional(),
     description: schemas_string().optional(),
     playerType: schemas_union([
@@ -6137,6 +6137,58 @@ const widgetMetadataSchema = schemas_object({
         params: schemas_array(widgetModuleParamSchema)
     }).optional()
 });
+const ENCRYPT_ENDPOINT = 'https://api.rexnow.tv/api/widgets/encrypt';
+const ENCRYPT_MAX_BYTES = 2097152;
+const ENCRYPT_TIMEOUT_MS = 150000;
+const HTTP_ERRORS = {
+    400: '服务无法识别这个模块，请检查源码。',
+    413: '文件过大，请缩小后重试。',
+    422: '源码无法完成混淆，请检查模块语法。',
+    429: '操作过于频繁，请稍后再试。',
+    503: '加密服务暂时繁忙，请稍后再试。'
+};
+function isEncryptedWidget(source) {
+    return /^(?:FWENC|REXENC)/.test(source.trimStart());
+}
+function validateEncryptEnvelope(text) {
+    const lines = text.split('\n');
+    if (3 !== lines.length || 'REXENC' !== lines[0]) throw new Error('服务返回了不兼容的格式，请稍后重试。');
+    try {
+        const header = JSON.parse(lines[1] ?? '');
+        if (2 !== header.v || 'rex-1' !== header.mkv || 'A256GCM' !== header.alg || 'string' != typeof header.iv || 'string' != typeof header.kb || 12 !== Buffer.from(header.iv, 'base64').length || 60 !== Buffer.from(header.kb, 'base64').length || Buffer.from((lines[2] ?? '').trim(), 'base64').length <= 16) throw new Error();
+    } catch  {
+        throw new Error('加密结果不完整，请重试。');
+    }
+}
+async function encryptWidgetSource(source) {
+    if (!source.trim()) throw new Error('请选择文件，或粘贴模块源码。');
+    if (Buffer.byteLength(source) > ENCRYPT_MAX_BYTES) throw new Error('文件超过 2 MiB，请缩小后重试。');
+    if (isEncryptedWidget(source)) throw new Error('这是已加密的模块。请使用原始 JavaScript 源码。');
+    const controller = new AbortController();
+    const timer = setTimeout(()=>controller.abort(), ENCRYPT_TIMEOUT_MS);
+    try {
+        const response = await fetch(ENCRYPT_ENDPOINT, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'text/plain; charset=utf-8'
+            },
+            body: source,
+            signal: controller.signal,
+            credentials: 'omit',
+            cache: 'no-store'
+        });
+        if (!response.ok) throw new Error(HTTP_ERRORS[response.status] ?? `加密失败（HTTP ${response.status}），请稍后重试。`);
+        const output = await response.text();
+        validateEncryptEnvelope(output);
+        return output;
+    } catch (error) {
+        if (error instanceof Error && 'AbortError' === error.name) throw new Error('等待已超时，请稍后重试。');
+        if (error instanceof TypeError) throw new Error('无法连接加密服务，请检查网络后重试。');
+        throw error;
+    } finally{
+        clearTimeout(timer);
+    }
+}
 const toPascalCase = (str)=>upperFirst(camelCase(str));
 function getParamTypeString(param) {
     switch(param.type){
@@ -6339,6 +6391,9 @@ function generateVideoModuleInterface(nameSpaceName, sourceFile, module) {
     });
     generateModuleFunctionType(sourceFile, module);
 }
+function toExecutableWidgetMetadataSource(content) {
+    return content.replace(/\b(?:export\s+)?(?:const|let|var)\s+WidgetMetadata\b/g, 'WidgetMetadata');
+}
 function safeParseWidgetMetadataFactory(api) {
     return (content)=>{
         try {
@@ -6347,7 +6402,7 @@ function safeParseWidgetMetadataFactory(api) {
             };
             const func = new Function("sandbox", `
         let WidgetMetadata;
-        ${content};
+        ${toExecutableWidgetMetadataSource(content)};
         sandbox.WidgetMetadata = WidgetMetadata;
       `);
             func(sandbox);
@@ -6449,7 +6504,17 @@ async function addSpaceToWidgetMetadata(distPath) {
     });
     await sourceFile.save();
 }
-async function processAfterBuild(api, stats, dtsPath) {
+async function encryptOutputFiles(api, outputFiles) {
+    const jsFiles = outputFiles.filter((file)=>file.endsWith(".js"));
+    for (const file of jsFiles){
+        const source = await node_fs.promises.readFile(file, "utf-8");
+        api.logger.info(`正在加密 ${node_path.basename(file)}…`);
+        const encrypted = await encryptWidgetSource(source);
+        await node_fs.promises.writeFile(file, encrypted);
+        api.logger.info(`已加密 ${node_path.basename(file)}`);
+    }
+}
+async function processAfterBuild(api, stats, dtsPath, options = {}) {
     const outputFiles = getOutputFiles(api, stats);
     if (!outputFiles.length) return void api.logger.warn("未找到输出文件，跳过类型生成");
     const typeDefFile = await setupTypeDefinitionFile(dtsPath);
@@ -6460,6 +6525,7 @@ async function processAfterBuild(api, stats, dtsPath) {
         await generateWidgetTypes(outputFile);
     }));
     await typeDefFile.save();
+    if (options.encrypt && !options.isWatch) await encryptOutputFiles(api, outputFiles);
 }
 function getOutputFiles(api, stats) {
     const buildStats = stats?.toJson({
@@ -6483,7 +6549,7 @@ async function setupTypeDefinitionFile(dtsPath) {
     typeDefFile.insertText(0, `/// <reference types='@rexnow/libs/env' />\n\n`);
     return typeDefFile;
 }
-const pluginRexWidget = ({ typesFilePath = "src/rex-widget-env.d.ts", devPort = 8000 } = {})=>({
+const pluginRexWidget = ({ typesFilePath = "src/rex-widget-env.d.ts", devPort = 8000, encrypt = false } = {})=>({
         name: "plugin-rex-widget",
         setup (api) {
             const dtsPath = node_path.resolve(api.context.rootPath, typesFilePath);
@@ -6495,9 +6561,13 @@ const pluginRexWidget = ({ typesFilePath = "src/rex-widget-env.d.ts", devPort =
             });
             api.onAfterBuild(async ({ stats, isWatch, isFirstCompile })=>{
                 try {
-                    await processAfterBuild(api, stats, dtsPath);
+                    await processAfterBuild(api, stats, dtsPath, {
+                        encrypt,
+                        isWatch
+                    });
                 } catch (error) {
                     api.logger.error("Rex Widget 插件处理失败", error);
+                    if (encrypt && !isWatch) throw error;
                 }
                 try {
                     if (isWatch && isFirstCompile) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rexnow/rslib-plugin",
-  "version": "3.0.1",
+  "version": "3.1.1",
   "type": "module",
   "exports": {
     ".": {
@@ -17,7 +17,7 @@
     "provenance": true
   },
   "devDependencies": {
-    "@rexnow/libs": "3.0.1",
+    "@rexnow/libs": "3.1.1",
     "@rsbuild/core": "^2.2.5",
     "@rslib/core": "^1.0.0",
     "@rstest/adapter-rslib": "^0.11.12",