@tachybase/module-workflow 1.6.0 → 1.6.1

package/dist/server/features/omni-trigger/CustomActionTrigger.js

@@ -47,20 +47,20 @@ class CustomActionInterceptionError extends Error {
 const _OmniTrigger = class _OmniTrigger extends import_triggers.default {
   constructor(workflow) {
     super(workflow);
-    this.triggerAction = async (context, next) => {
+    this.triggerAction = async (ctx, next) => {
       const {
         params: { filterByTk, values, triggerWorkflows = "", filter, resourceName, actionName }
-      } = context.action;
+      } = ctx.action;
       if (actionName !== "trigger" || resourceName === "workflows") {
         return next();
       }
-      const { currentUser, currentRole } = context.state;
+      const { currentUser, currentRole } = ctx.state;
       const { model: UserModel } = this.workflow.db.getCollection("users");
       const userInfo = {
         user: UserModel.build(currentUser).desensitize(),
         roleName: currentRole
       };
-      const dataSourceHeader = context.get("x-data-source");
+      const dataSourceHeader = ctx.get("x-data-source");
       const jointCollectionName = (0, import_server.joinCollectionName)(dataSourceHeader, resourceName);
       const triggerWorkflowsMap = /* @__PURE__ */ new Map();
       const triggerWorkflowsArray = [];
@@ -92,7 +92,7 @@ const _OmniTrigger = class _OmniTrigger extends import_triggers.default {
         const [dataSourceName, collectionName] = (0, import_server.parseCollectionName)(workflow.config.collection);
         const dataPath = triggerWorkflowsMap.get(workflow.key);
         const event = [workflow];
-        const { repository } = context.app.dataSourceManager.dataSources.get(dataSourceName).collectionManager.getCollection(collectionName);
+        const { repository } = ctx.tego.dataSourceManager.dataSources.get(dataSourceName).collectionManager.getCollection(collectionName);
         const formData = dataPath ? import_lodash.default.get(values, dataPath) : values;
         let data = formData;
         if (filterByTk != null) {
@@ -116,9 +116,9 @@ const _OmniTrigger = class _OmniTrigger extends import_triggers.default {
         (workflow.sync ? syncGroup : asyncGroup).push(event);
       }
       for (const event of syncGroup) {
-        const processor = await this.workflow.trigger(event[0], event[1], { httpContext: context });
+        const processor = await this.workflow.trigger(event[0], event[1], { httpContext: ctx });
         if (!processor) {
-          return context.throw(500);
+          return ctx.throw(500);
         }
         const { lastSavedJob, nodesMap } = processor;
         const lastNode = nodesMap.get(lastSavedJob == null ? void 0 : lastSavedJob.nodeId);
@@ -130,34 +130,34 @@ const _OmniTrigger = class _OmniTrigger extends import_triggers.default {
         }
         if (processor.execution.status < import_constants.EXECUTION_STATUS.STARTED) {
           if ((lastNode == null ? void 0 : lastNode.type) !== "end") {
-            return context.throw(
+            return ctx.throw(
               500,
-              context.t("Workflow on your action failed, please contact the administrator", { ns: "workflow" })
+              ctx.t("Workflow on your action failed, please contact the administrator", { ns: "workflow" })
             );
           }
           const err = new CustomActionInterceptionError("Request is intercepted by workflow");
           err.status = 400;
-          err.messages = context.state.messages;
-          return context.throw(err.status, err);
+          err.messages = ctx.state.messages;
+          return ctx.throw(err.status, err);
         }
-        return context.throw(500, "Workflow on your action hangs, please contact the administrator");
+        return ctx.throw(500, "Workflow on your action hangs, please contact the administrator");
       }
       for (const event of asyncGroup) {
         this.workflow.trigger(event[0], event[1]);
       }
       await next();
     };
-    this.middleware = async (context, next) => {
+    this.middleware = async (ctx, next) => {
       const {
         resourceName,
         actionName,
         params: { triggerWorkflows, beforeWorkflows }
-      } = context.action;
+      } = ctx.action;
       if (beforeWorkflows) {
-        await this.trigger(context, beforeWorkflows, "before");
+        await this.trigger(ctx, beforeWorkflows, "before");
       }
       if (resourceName === "workflows" && actionName === "trigger") {
-        return this.triggerAction(context, next);
+        return this.triggerAction(ctx, next);
       }
       await next();
       if (!triggerWorkflows) {
@@ -166,7 +166,7 @@ const _OmniTrigger = class _OmniTrigger extends import_triggers.default {
       if (!["create", "update"].includes(actionName)) {
         return;
       }
-      return this.trigger(context, triggerWorkflows);
+      return this.trigger(ctx, triggerWorkflows);
     };
     this.workflow.app.resourcer.registerActionHandler("trigger", this.triggerAction);
     this.workflow.app.acl.allow("*", "trigger", "loggedIn");
@@ -181,13 +181,13 @@ const _OmniTrigger = class _OmniTrigger extends import_triggers.default {
     );
     workflow.app.resourcer.use(this.middleware, { tag: "workflowTrigger", after: "acl" });
   }
-  async trigger(context, workflowList, order = "after") {
+  async trigger(ctx, workflowList, order = "after") {
     if (!workflowList) {
       return;
     }
-    const { values } = context.action.params;
-    const dataSourceHeader = context.get("x-data-source") || "main";
-    const { currentUser, currentRole } = context.state;
+    const { values } = ctx.action.params;
+    const dataSourceHeader = ctx.get("x-data-source") || "main";
+    const { currentUser, currentRole } = ctx.state;
     const { model: UserModel } = this.workflow.db.getCollection("users");
     const userInfo = {
       user: UserModel.build(currentUser).desensitize(),
@@ -210,19 +210,19 @@ const _OmniTrigger = class _OmniTrigger extends import_triggers.default {
       const [dataSourceName, collectionName] = (0, import_server.parseCollectionName)(collection);
       const trigger = triggers.find((trigger2) => trigger2[0] === workflow.key);
       const event = [workflow];
-      if (context.action.resourceName !== "workflows") {
+      if (ctx.action.resourceName !== "workflows") {
         if (order === "before") {
-          event.push({ data: context.action.params, ...userInfo });
+          event.push({ data: ctx.action.params, ...userInfo });
           (workflow.sync ? syncGroup : asyncGroup).push(event);
           continue;
         }
-        if (!context.body) {
+        if (!ctx.body) {
           continue;
         }
         if (dataSourceName !== dataSourceHeader) {
           continue;
         }
-        const { body: data } = context;
+        const { body: data } = ctx;
         for (const row of Array.isArray(data) ? data : [data]) {
           let payload = row;
           if (trigger[1]) {
@@ -251,7 +251,7 @@ const _OmniTrigger = class _OmniTrigger extends import_triggers.default {
           event.push({ data: (0, import_utils.toJSON)(payload), ...userInfo });
         }
       } else {
-        const { model, repository } = context.app.dataSourceManager.dataSources.get(dataSourceName).collectionManager.getCollection(collectionName);
+        const { model, repository } = ctx.tego.dataSourceManager.dataSources.get(dataSourceName).collectionManager.getCollection(collectionName);
         let data = trigger[1] ? (0, import_lodash.get)(values, trigger[1]) : values;
         const pk = (0, import_lodash.get)(data, model.primaryKeyAttribute);
         if (appends.length && pk != null) {
@@ -265,7 +265,7 @@ const _OmniTrigger = class _OmniTrigger extends import_triggers.default {
       (workflow.sync ? syncGroup : asyncGroup).push(event);
     }
     for (const event of syncGroup) {
-      await this.workflow.trigger(event[0], event[1], { httpContext: context });
+      await this.workflow.trigger(event[0], event[1], { httpContext: ctx });
     }
     for (const event of asyncGroup) {
       this.workflow.trigger(event[0], event[1]);

package/dist/server/features/script/script.instruction.js

@@ -38,9 +38,151 @@ var import_jsonata = __toESM(require("jsonata"));
 var import_lodash = __toESM(require("lodash"));
 var import_qrcode = __toESM(require("qrcode"));
 var import__ = require("../..");
+var import_get_remote_code_fetcher = require("../../utils/get-remote-code-fetcher");
 class ScriptInstruction extends import__.Instruction {
   async run(node, input, processor) {
-    const { sourceArray, type, code = "", model } = node.config;
+    const {
+      sourceArray,
+      type,
+      code = "",
+      model,
+      codeSource = "local",
+      codeType,
+      codeUrl,
+      codeBranch = "main",
+      codeAuthType,
+      codeAuthToken,
+      codeAuthUsername
+    } = node.config;
+    let actualCode = code;
+    if (codeSource === "remote" && codeUrl && codeType) {
+      try {
+        const app = processor.options.plugin.app;
+        const remoteCodeFetcher = (0, import_get_remote_code_fetcher.getRemoteCodeFetcher)(app);
+        if (remoteCodeFetcher) {
+          const codeCache = node.config.codeCache;
+          if (codeCache == null ? void 0 : codeCache.content) {
+            app.logger.info(`[Workflow Node ${node.id}] Using cached remote code from database`);
+            actualCode = codeCache.content;
+          } else {
+            app.logger.info(
+              `[Workflow Node ${node.id}] No cache found, fetching remote code from ${codeUrl} (type: ${codeType}, branch: ${codeBranch || "main"})`
+            );
+            actualCode = await remoteCodeFetcher.fetchCode(
+              codeUrl,
+              codeType,
+              codeBranch || "main",
+              // 使用配置的分支，默认为 'main'
+              void 0,
+              // codePath - 使用默认值
+              codeAuthType,
+              codeAuthToken,
+              codeAuthUsername
+            );
+            const nodeRepo = app.db.getRepository("flow_nodes");
+            await nodeRepo.update({
+              filterByTk: node.id,
+              values: {
+                config: {
+                  ...node.config,
+                  codeCache: {
+                    content: actualCode,
+                    timestamp: Date.now()
+                    // 保留 timestamp 用于记录，但不用于验证
+                  }
+                }
+              }
+            });
+            app.logger.info(`[Workflow Node ${node.id}] Remote code fetched and cached successfully`);
+          }
+        } else {
+          const codeCache = node.config.codeCache;
+          if (codeCache == null ? void 0 : codeCache.content) {
+            app.logger.info(`[Workflow Node ${node.id}] Using cached remote code from database (fallback mode)`);
+            actualCode = codeCache.content;
+          } else {
+            const http = require("node:http");
+            const https = require("node:https");
+            const { URL } = require("node:url");
+            const urlObj = new URL(codeUrl);
+            const client = urlObj.protocol === "https:" ? https : http;
+            app.logger.info(
+              `[Workflow Node ${node.id}] No cache found, fetching remote code via HTTP (type: ${codeType}, branch: ${codeBranch || "main"})`
+            );
+            actualCode = await new Promise((resolve, reject) => {
+              const headers = {
+                "User-Agent": "TegoWorkflow/1.0"
+              };
+              if (codeAuthType === "token" && codeAuthToken) {
+                headers["Authorization"] = `Bearer ${codeAuthToken}`;
+              } else if (codeAuthType === "basic" && codeAuthUsername && codeAuthToken) {
+                const credentials = Buffer.from(`${codeAuthUsername}:${codeAuthToken}`).toString("base64");
+                headers["Authorization"] = `Basic ${credentials}`;
+              }
+              const request = client.get(
+                {
+                  hostname: urlObj.hostname,
+                  port: urlObj.port || (urlObj.protocol === "https:" ? 443 : 80),
+                  path: urlObj.pathname + urlObj.search,
+                  headers,
+                  timeout: 1e4
+                },
+                (res) => {
+                  if (res.statusCode !== 200) {
+                    reject(new Error(`Failed to fetch: HTTP ${res.statusCode}`));
+                    return;
+                  }
+                  let data2 = "";
+                  res.on("data", (chunk) => {
+                    data2 += chunk;
+                  });
+                  res.on("end", () => {
+                    resolve(data2);
+                  });
+                }
+              );
+              request.on("error", reject);
+              request.on("timeout", () => {
+                request.destroy();
+                reject(new Error("Request timeout"));
+              });
+            });
+            const nodeRepo = app.db.getRepository("flow_nodes");
+            await nodeRepo.update({
+              filterByTk: node.id,
+              values: {
+                config: {
+                  ...node.config,
+                  codeCache: {
+                    content: actualCode,
+                    timestamp: Date.now()
+                    // 保留 timestamp 用于记录，但不用于验证
+                  }
+                }
+              }
+            });
+            app.logger.info(`[Workflow Node ${node.id}] Remote code fetched and cached successfully (fallback mode)`);
+          }
+        }
+      } catch (error) {
+        const app = processor.options.plugin.app;
+        app.logger.error("Failed to fetch remote code for script node", {
+          error: error instanceof Error ? error.message : String(error),
+          nodeId: node.id,
+          codeUrl
+        });
+        const codeCache = node.config.codeCache;
+        if (codeCache == null ? void 0 : codeCache.content) {
+          app.logger.warn(`[Workflow Node ${node.id}] Remote fetch failed, using cached code as fallback`);
+          actualCode = codeCache.content;
+        } else if (!code) {
+          throw new Error(`Failed to fetch remote code: ${error instanceof Error ? error.message : String(error)}`);
+        } else {
+          app.logger.warn(`[Workflow Node ${node.id}] Remote code fetch failed, falling back to local code`);
+          actualCode = code;
+        }
+      }
+    }
     let data = {};
     switch (sourceArray.length) {
       case 0: {
@@ -74,13 +216,13 @@ class ScriptInstruction extends import__.Instruction {
       let result = {};
       switch (type) {
         case "jsonata":
-          result = await convertByJSONata(code, data);
+          result = await convertByJSONata(actualCode, data);
           break;
         case "js":
-          result = await convertByJsCode(code, data);
+          result = await convertByJsCode(actualCode, data);
           break;
         case "ts":
-          result = await convertByTsCode(code, data, processor);
+          result = await convertByTsCode(actualCode, data, processor);
           break;
         default:
       }

package/dist/server/features/trigger-instruction/TriggerInstruction.d.ts

@@ -11,5 +11,9 @@ export declare class TriggerInstruction extends Instruction {
         status: 0;
         result?: undefined;
     }>;
+    /**
+     * 将数据按照 model 配置进行字段映射
+     */
+    private mapModel;
     resume(node: any, prevJob: any, processor: Processor): Promise<any>;
 }

package/dist/server/features/trigger-instruction/TriggerInstruction.js

@@ -30,12 +30,13 @@ __export(TriggerInstruction_exports, {
   TriggerInstruction: () => TriggerInstruction
 });
 module.exports = __toCommonJS(TriggerInstruction_exports);
+var import_lodash = __toESM(require("lodash"));
 var import_constants = require("../../constants");
 var import_instructions = __toESM(require("../../instructions"));
 class TriggerInstruction extends import_instructions.default {
   async run(node, input, processor) {
     var _a;
-    const workflowKey = node.config.workflowKey;
+    const { workflowKey, sourceArray = [], model } = node.config;
     const wfRepo = this.workflow.db.getRepository("workflows");
     const wf = await wfRepo.findOne({ filter: { key: workflowKey, enabled: true } });
     if (!wf) {
@@ -52,8 +53,41 @@ class TriggerInstruction extends import_instructions.default {
       );
     }
     try {
+      let triggerData = input.result;
+      if (sourceArray && sourceArray.length > 0) {
+        let data = {};
+        switch (sourceArray.length) {
+          case 0: {
+            data = {};
+            break;
+          }
+          case 1: {
+            const keyName = sourceArray[0]["keyName"];
+            const sourcePath = sourceArray[0]["sourcePath"];
+            const rawData = processor.getParsedValue(sourcePath, node.id);
+            if (keyName) {
+              data = {
+                [keyName]: rawData
+              };
+            } else {
+              data = rawData;
+            }
+            break;
+          }
+          default: {
+            data = sourceArray.reduce(
+              (cookedData, { keyName, sourcePath }) => ({
+                ...cookedData,
+                [keyName]: processor.getParsedValue(sourcePath, node.id)
+              }),
+              {}
+            );
+          }
+        }
+        triggerData = data;
+      }
       if (wf.sync) {
-        const p = await this.workflow.trigger(wf, input.result, processor.options);
+        const p = await this.workflow.trigger(wf, triggerData, processor.options);
         if (!p) {
           return {
             status: import_constants.JOB_STATUS.FAILED,
@@ -67,12 +101,20 @@ class TriggerInstruction extends import_instructions.default {
             result: `Sub-workflow execution failed: ${lastSavedJob.result}`
           };
         }
+        let result = lastSavedJob == null ? void 0 : lastSavedJob.result;
+        if (typeof result === "object" && result && (model == null ? void 0 : model.length)) {
+          if (Array.isArray(result)) {
+            result = result.map((item) => this.mapModel(item, model));
+          } else {
+            result = this.mapModel(result, model);
+          }
+        }
         return {
           status: import_constants.JOB_STATUS.RESOLVED,
-          result: lastSavedJob == null ? void 0 : lastSavedJob.result
+          result
         };
       } else {
-        this.workflow.trigger(wf, input.result, {
+        this.workflow.trigger(wf, triggerData, {
           ...processor.options,
           parentNode: node.id,
           parent: processor.execution
@@ -89,8 +131,32 @@ class TriggerInstruction extends import_instructions.default {
       };
     }
   }
+  /**
+   * 将数据按照 model 配置进行字段映射
+   */
+  mapModel(data, model) {
+    if (typeof data !== "object" || data === null) {
+      throw new Error("Invalid data: data should be a non-null object");
+    }
+    const result = model.reduce((acc, { path, alias }) => {
+      const key = alias ?? path.replace(/\./g, "_");
+      const value = import_lodash.default.get(data, path);
+      acc[key] = value;
+      return acc;
+    }, {});
+    return result;
+  }
   async resume(node, prevJob, processor) {
-    prevJob.set("result", prevJob.result);
+    const { model } = node.config;
+    let result = prevJob.result;
+    if (typeof result === "object" && result && (model == null ? void 0 : model.length)) {
+      if (Array.isArray(result)) {
+        result = result.map((item) => this.mapModel(item, model));
+      } else {
+        result = this.mapModel(result, model);
+      }
+    }
+    prevJob.set("result", result);
     prevJob.set("status", prevJob.status);
     return prevJob;
   }

package/dist/server/instructions/SelectInstruction.d.ts

@@ -0,0 +1,13 @@
+import Instruction from '.';
+import type Processor from '../Processor';
+import type { FlowNodeModel } from '../types';
+export declare class SelectInstruction extends Instruction {
+    run(node: FlowNodeModel, input: any, processor: Processor): Promise<{
+        result: any;
+        status: -1;
+    } | {
+        result: any;
+        status: 1;
+    }>;
+}
+export default SelectInstruction;

package/dist/server/instructions/SelectInstruction.js

@@ -0,0 +1,126 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var SelectInstruction_exports = {};
+__export(SelectInstruction_exports, {
+  SelectInstruction: () => SelectInstruction,
+  default: () => SelectInstruction_default
+});
+module.exports = __toCommonJS(SelectInstruction_exports);
+var import_server = require("@tego/server");
+var import_lodash = require("lodash");
+var import__ = __toESM(require("."));
+var import_constants = require("../constants");
+var import_utils = require("../utils");
+class SelectInstruction extends import__.default {
+  async run(node, input, processor) {
+    var _a, _b, _c, _d;
+    const { collection, multiple, isTree, params = {}, failOnEmpty = false } = node.config;
+    const otherOptions = {};
+    if (isTree) {
+      otherOptions.tree = true;
+    }
+    const [dataSourceName, collectionName] = (0, import_server.parseCollectionName)(collection);
+    const { repository, fields } = this.workflow.app.dataSourceManager.dataSources.get(dataSourceName).collectionManager.getCollection(collectionName);
+    const { page, pageSize, sort = [], paginate = true, ...options } = processor.getParsedValue(params, node.id);
+    const appends = ((_a = options.summary) == null ? void 0 : _a.includes(".")) ? [options.summary] : [];
+    if (options.summary && !((_b = options.summary) == null ? void 0 : _b.includes("."))) {
+      if (["belongsTo", "hasOne", "hasMany", "belongsToMany"].includes((_c = fields.get(options.summary)) == null ? void 0 : _c.type)) {
+        appends.push(options.summary);
+      }
+    }
+    let pageArgs = paginate ? import_server.utils.pageArgsToLimitArgs(page, pageSize) : {};
+    const data = await (multiple ? repository.find : repository.findOne).call(repository, {
+      ...options,
+      ...otherOptions,
+      ...pageArgs,
+      sort: sort.filter((item) => item.field).map((item) => {
+        var _a2;
+        return `${((_a2 = item.direction) == null ? void 0 : _a2.toLowerCase()) === "desc" ? "-" : ""}${item.field}`;
+      }),
+      appends,
+      transaction: this.workflow.useDataSourceTransaction(dataSourceName, processor.transaction)
+    });
+    let result;
+    const summary = ((_d = options.summary) == null ? void 0 : _d.length) ? options.summary.split(".") : null;
+    if (summary) {
+      if ((0, import_lodash.isArray)(data)) {
+        result = [];
+        data.forEach((item) => {
+          const filteredValue = findField(item, summary[0], 0, summary, multiple, true);
+          const value = (0, import_lodash.isArray)(filteredValue) ? filteredValue : [filteredValue];
+          result.push(...value);
+        });
+      } else {
+        result = findField(data, summary[0], 0, summary, multiple, true);
+      }
+      result = (0, import_lodash.isArray)(result) ? multiple ? result : result[0] : result;
+    }
+    if (failOnEmpty && (multiple ? !data.length : !data)) {
+      return {
+        result: summary ? result : data,
+        status: import_constants.JOB_STATUS.FAILED
+      };
+    }
+    return {
+      result: (0, import_utils.toJSON)(summary ? result : data),
+      status: import_constants.JOB_STATUS.RESOLVED
+    };
+  }
+}
+var SelectInstruction_default = SelectInstruction;
+const findField = (record, field, index, summary, multiple, isOne) => {
+  if (record == null) {
+    return void 0;
+  }
+  if (!multiple && !isOne) {
+    return;
+  }
+  let isOneField = isOne;
+  const current = record[field];
+  if (index === summary.length - 1) {
+    if (!multiple && isOne) {
+      isOneField = false;
+    }
+    return current;
+  }
+  const nextField = summary[index + 1];
+  if (Array.isArray(current)) {
+    const results = [];
+    current.forEach((item) => {
+      const v = findField(item, nextField, index + 1, summary, multiple, isOneField);
+      if (v === void 0) return;
+      results.push(v);
+    });
+    return results;
+  }
+  return findField(current, nextField, index + 1, summary, multiple, isOneField);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SelectInstruction
+});

package/dist/server/services/remote-code-fetcher.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 远程代码获取服务（Workflow 模块专用）
+ * 支持从 CDN 和 Git 仓库获取代码
+ */
+export declare class WorkflowRemoteCodeFetcher {
+    private logger;
+    /**
+     * 从 CDN 获取代码
+     * @param url 代码 URL
+     * @param timeout 超时时间（毫秒）
+     * @param authType 认证类型: 'none' | 'token' | 'basic'
+     * @param authToken Bearer Token 或 Basic Auth 的密码
+     * @param authUsername Basic Auth 的用户名
+     */
+    private fetchFromCDN;
+    /**
+     * 检测 URL 是否已经是 Raw 文件 URL（可以直接访问）
+     */
+    private isRawFileUrl;
+    /**
+     * 从 URL 中解析分支和文件路径
+     */
+    private parseGitUrl;
+    /**
+     * 从 Git 仓库获取代码（通过 Raw 文件 URL）
+     */
+    private fetchFromGit;
+    /**
+     * 获取远程代码
+     * @param codeUrl 代码地址
+     * @param codeType 代码类型：'cdn' 或 'git'
+     * @param codeBranch Git 分支名称（仅 Git 类型需要）
+     * @param codePath Git 文件路径（仅 Git 类型需要）
+     * @param authType 认证类型: 'none' | 'token' | 'basic'
+     * @param authToken Bearer Token 或 Basic Auth 的密码
+     * @param authUsername Basic Auth 的用户名
+     */
+    fetchCode(codeUrl: string, codeType: 'cdn' | 'git', codeBranch?: string, codePath?: string, authType?: string, authToken?: string, authUsername?: string): Promise<string>;
+    /**
+     * 检查缓存是否有效（默认缓存 1 小时）
+     * @param cache 缓存对象，包含 content 和 timestamp
+     * @param maxAge 最大缓存时间（毫秒），默认 1 小时 (3600000ms)
+     */
+    isCacheValid(cache: {
+        content: string;
+        timestamp: number;
+    } | null, maxAge?: number): boolean;
+}