@actiondock/core 2.0.0

package/src/server/types.ts

@@ -0,0 +1,42 @@
+import type { ServerRuntimeRegistry } from "./runtime-registry";
+
+/**
+ * 启动 ActionDock HTTP Runner 服务端的配置选项。
+ */
+export interface ServerOptions {
+  /** 监听端口号（默认 5177） */
+  port?: number;
+  /** 绑定监听的主机地址（默认 "127.0.0.1"） */
+  host?: string;
+  /** 用于 HTTP Bearer Token 鉴权的密钥令牌 */
+  token?: string;
+  /** 服务的项目根目录（可选，若未指定则自动向上查找或进入全局 Registry 模式） */
+  projectRoot?: string;
+  /** 自定义 ActionDock 用户家目录 */
+  customHome?: string;
+  /** 是否允许非回环地址（如 0.0.0.0）在未配置 Token 的情况下启动（不安全） */
+  allowInsecureNoAuth?: boolean;
+  /** 允许跨域请求的 CORS Origin 白名单列表 */
+  corsOrigins?: string[];
+  /** 最大允许的请求体字节限制（默认 1MB，防 DoS） */
+  maxBodyBytes?: number;
+  /** 是否在 health 和 info 接口中透传本地 projectRoot 等调试路径 */
+  exposeDebugInfo?: boolean;
+}
+
+/**
+ * 已启动的 ActionDock HTTP Runner 实例句柄。
+ */
+export interface ActionDockServerInstance {
+  /** 实际监听的端口号 */
+  port: number;
+  /** 实际绑定的主机地址 */
+  host: string;
+  /** 服务端可访问的基础 URL（如 "http://127.0.0.1:5177"） */
+  url: string;
+  /** 关联的 ServerRuntimeRegistry 运行时注册表 */
+  runtimeRegistry?: ServerRuntimeRegistry;
+  /** 优雅关闭服务端并释放所有存储连接 */
+  stop: () => Promise<void> | void;
+}
+

package/src/storage/index.ts

@@ -0,0 +1,64 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { SqliteRuntimeStorage } from "./sqlite";
+import type { RuntimeStorage, StorageOptions } from "./types";
+
+export * from "./mask";
+export * from "./sqlite";
+export * from "./types";
+
+/**
+ * 解析并计算目标 SQLite 数据库文件的绝对路径。
+ * 
+ * 优先级规则：
+ * 1. inMemory: true -> 返回 ":memory:"
+ * 2. 显式指定 dataDir -> 返回 `<dataDir>/<packageId>/runtime.db`
+ * 3. 显式指定 projectRoot（开发态项目） -> 返回 `<projectRoot>/.actiondock/runtime.db`
+ * 4. 默认独立二进制存储路径 -> 返回 `~/.actiondock/data/<packageId>/runtime.db`
+ * 
+ * @param packageId 所属 Package ID
+ * @param options 路径解析选项
+ */
+export function resolveDatabasePath(
+  packageId: string,
+  options: { projectRoot?: string; dataDir?: string; inMemory?: boolean } = {}
+): string {
+  if (options.inMemory) {
+    return ":memory:";
+  }
+  if (options.dataDir) {
+    return join(options.dataDir, packageId, "runtime.db");
+  }
+  if (options.projectRoot) {
+    return join(options.projectRoot, ".actiondock", "runtime.db");
+  }
+  // 独立执行二进制默认存储路径: ~/.actiondock/data/<package-id>/runtime.db
+  return join(homedir(), ".actiondock", "data", packageId, "runtime.db");
+}
+
+/**
+ * 工厂函数：为指定 Package 创建或连接 RuntimeStorage 实例。
+ * 
+ * @param packageId 目标 Package ID
+ * @param options 存储配置参数（支持 projectRoot, dataDir, inMemory）
+ */
+export function createStorage(
+  packageId: string,
+  options: { projectRoot?: string; dataDir?: string; inMemory?: boolean } = {}
+): RuntimeStorage {
+  const dbPath = resolveDatabasePath(packageId, options);
+  return new SqliteRuntimeStorage({ dbPath, packageId });
+}
+
+/**
+ * 工厂函数：创建或连接 ActionDock 全局共享数据库（~/.actiondock/global.db）。
+ * 用于跨 Package 共享的全局配置项存储。
+ * 
+ * @param customHome 自定义家目录路径（可选）
+ */
+export function createGlobalStorage(customHome?: string): RuntimeStorage {
+  const baseDir = customHome || process.env.ACTIONDOCK_HOME || homedir();
+  const dbPath = join(baseDir, ".actiondock", "global.db");
+  return new SqliteRuntimeStorage({ dbPath, packageId: "__global__" });
+}
+

package/src/storage/mask.ts

@@ -0,0 +1,34 @@
+import type { ConfigItemDefinition } from "../project/types";
+
+/**
+ * 检查指定配置项是否为敏感数据（密码、私钥、Token、密钥等）。
+ * 
+ * 判定逻辑：
+ * 1. 若 actiondock.json 中显式声明了 `secret: true`，直接判定为敏感。
+ * 2. 若未显式声明，使用正则探测包含 PASSWORD/SECRET/TOKEN/KEY/PASS/AUTH/CREDENTIAL/PRIVATE_KEY 的通用敏感命名特征。
+ * 
+ * @param key 配置键名
+ * @param declaredItem 项目中声明的配置元数据（可选）
+ */
+export function isSecretConfigKey(
+  key: string,
+  declaredItem?: ConfigItemDefinition
+): boolean {
+  if (declaredItem?.secret === true) {
+    return true;
+  }
+  // 匹配常见敏感词命名特征
+  return /^(.*_)?(PASSWORD|SECRET|TOKEN|KEY|PASS|AUTH|CREDENTIAL|PRIVATE_KEY)(_.*)?$/i.test(key);
+}
+
+/**
+ * 对敏感数据的值进行掩码脱敏处理（返回 "********"）。
+ * 
+ * @param value 原始数据值
+ * @returns 掩码脱敏后的安全展示字符串
+ */
+export function maskSecretValue(value: unknown): string {
+  if (value === undefined) return "undefined";
+  if (value === null) return "null";
+  return "********";
+}