@actiondock/core 2.0.11 → 2.2.0

package/src/storage/driver.ts

@@ -1,126 +0,0 @@
-import { createRequire } from "node:module";
-import type { SqliteDriver } from "./types";
-
-export type SqliteDriverFactory = (dbPath: string) => SqliteDriver;
-
-/** ESM 环境下可用的 CommonJS require，用于动态加载 node:sqlite / bun:sqlite */
-const cjsRequire = createRequire(import.meta.url);
-
-let customDriverFactory: SqliteDriverFactory | undefined;
-
-/**
- * 注册全局默认 SQLite 驱动工厂。
- */
-export function setSqliteDriverFactory(factory: SqliteDriverFactory): void {
-  customDriverFactory = factory;
-}
-
-/**
- * 创建默认 SQLite 驱动实例。
- * 优先使用外部注册的工厂，其次根据当前运行时环境自动适配。
- */
-export function createDefaultSqliteDriver(dbPath: string): SqliteDriver {
-  if (customDriverFactory) {
-    return customDriverFactory(dbPath);
-  }
-
-  // 检查是否在 Bun 运行时环境
-  if (typeof (globalThis as any).Bun !== "undefined") {
-    try {
-      const { Database } = (globalThis as any).Bun.sqlite || cjsRequire("bun:sqlite");
-      const db = new Database(dbPath);
-      // bun:sqlite 的 statement 未 finalize 时会一直持有数据库文件句柄，
-      // Windows 下导致 db.close() 后文件仍被锁（EBUSY 无法删除）。
-      // 跟踪全部 prepared statement，close() 时统一 finalize 释放句柄。
-      const openStatements = new Set<any>();
-      return {
-        exec(sql: string) {
-          db.exec(sql);
-        },
-        prepare(sql: string) {
-          const stmt = db.prepare(sql);
-          openStatements.add(stmt);
-          return {
-            run(...args: any[]) {
-              const params = args.length === 1 && Array.isArray(args[0]) ? args[0] : args;
-              const res = stmt.run(...params);
-              return { changes: res.changes, lastInsertRowid: res.lastInsertRowid };
-            },
-            get<T>(...args: any[]): T | undefined {
-              const params = args.length === 1 && Array.isArray(args[0]) ? args[0] : args;
-              return stmt.get(...params) as T | undefined;
-            },
-            all<T>(...args: any[]): T[] {
-              const params = args.length === 1 && Array.isArray(args[0]) ? args[0] : args;
-              return stmt.all(...params) as T[];
-            },
-          };
-        },
-        transaction<T>(fn: () => T extends PromiseLike<unknown> ? never : T): T {
-          return db.transaction(fn)() as T;
-        },
-        close() {
-          for (const stmt of openStatements) {
-            try {
-              stmt.finalize();
-            } catch {
-              // 已 finalize 或重复释放时忽略
-            }
-          }
-          openStatements.clear();
-          db.close();
-        },
-      };
-    } catch {
-      // 若在 Bun 下获取 bun:sqlite 失败，回退到标准 Node 驱动尝试
-    }
-  }
-
-  // 在 Node.js 环境下使用 node:sqlite
-  try {
-    const { DatabaseSync } = cjsRequire("node:sqlite");
-    const db = new DatabaseSync(dbPath);
-    return {
-      exec(sql: string) {
-        db.exec(sql);
-      },
-      prepare(sql: string) {
-        const stmt = db.prepare(sql);
-        return {
-          run(...args: any[]) {
-            const params = args.length === 1 && Array.isArray(args[0]) ? args[0] : args;
-            const res = stmt.run(...params);
-            return { changes: res.changes, lastInsertRowid: res.lastInsertRowid };
-          },
-          get<T>(...args: any[]): T | undefined {
-            const params = args.length === 1 && Array.isArray(args[0]) ? args[0] : args;
-            return stmt.get(...params) as T | undefined;
-          },
-          all<T>(...args: any[]): T[] {
-            const params = args.length === 1 && Array.isArray(args[0]) ? args[0] : args;
-            return stmt.all(...params) as T[];
-          },
-        };
-      },
-      transaction<T>(fn: () => T extends PromiseLike<unknown> ? never : T): T {
-        db.exec("BEGIN");
-        try {
-          const res = fn();
-          if (res && typeof (res as any).then === "function") {
-            throw new Error("Async transactions are not allowed in SQLite");
-          }
-          db.exec("COMMIT");
-          return res;
-        } catch (e) {
-          db.exec("ROLLBACK");
-          throw e;
-        }
-      },
-      close() {
-        db.close();
-      },
-    };
-  } catch (err: any) {
-    throw new Error(`Failed to initialize SQLite driver: ${err?.message || String(err)}`);
-  }
-}

package/src/storage/index.ts

@@ -1,81 +0,0 @@
-import { join } from "node:path";
-import { getActionDockHome } from "../utils";
-import { SqliteRuntimeStorage } from "./sqlite";
-import type { RuntimeStorage, StorageOptions } from "./types";
-
-export * from "./driver";
-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(getActionDockHome(), ".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 customHomeOrOptions 自定义家目录路径或配置对象（可选）
- * @param dataDirArg 自定义数据存储目录（可选）
- */
-export function createGlobalStorage(
-  customHomeOrOptions?: string | { customHome?: string; dataDir?: string },
-  dataDirArg?: string
-): RuntimeStorage {
-  let customHome: string | undefined;
-  let dataDir: string | undefined;
-
-  if (typeof customHomeOrOptions === "object" && customHomeOrOptions !== null) {
-    customHome = customHomeOrOptions.customHome;
-    dataDir = customHomeOrOptions.dataDir;
-  } else {
-    customHome = customHomeOrOptions;
-    dataDir = dataDirArg;
-  }
-
-  const dbPath = dataDir
-    ? join(dataDir, "global.db")
-    : join(getActionDockHome(customHome), ".actiondock", "global.db");
-  return new SqliteRuntimeStorage({ dbPath, packageId: "__global__" });
-}
-

package/src/storage/mask.ts

@@ -1,34 +0,0 @@
-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 "********";
-}