init

runtime/types.ts

@@ -0,0 +1,85 @@
+import type { ReadableStream, WritableStream } from "node:stream/web";
+
+/**
+ * 显式定义 BodyInit 兼容类型，确保在没有 DOM 类型的环境下也能编译
+ * 涵盖了 string, Blob, ArrayBuffer, 以及 ReadableStream
+ */
+export type CompatibleBodyInit =
+    | string
+    | Blob
+    | ArrayBuffer
+    | Uint8Array
+    | ReadableStream<Uint8Array>;
+
+export interface SpawnOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    /**
+     * 参考 Unjs/Nitro 的设计：
+     * 'pipe': 走 Web Stream，适合自动化处理
+     * 'inherit': 走物理 TTY，适合交互式 CLI (如你的 drizzle-kit 报错场景)
+     */
+    stdio?: "pipe" | "inherit";
+}
+
+export interface FileStat {
+    size: number;
+    mtime: Date;
+    isDirectory: boolean;
+}
+
+export interface ProcHandle {
+    pid?: number;
+    exited: Promise<number | null>;
+    kill: (signal?: string) => void;
+    // 符合 WinterCG 的流定义
+    stdout?: ReadableStream<Uint8Array>;
+    stderr?: ReadableStream<Uint8Array>;
+    stdin?: WritableStream<Uint8Array>;
+}
+
+export interface RuntimeContext {
+    fs: {
+        // --- 基础接口
+        exists: (path: string) => Promise<boolean>;
+        read: (path: string) => Promise<Response>;
+        /** 使用我们定义的兼容类型 */
+        write: (path: string, data: CompatibleBodyInit) => Promise<void>;
+
+        /**
+         * 流式写入：适合导出大型 SQL 备份或持续写入日志
+         * 遵循 Web 文件系统规范命名习惯
+         * 返回 WritableStream，用于流式写入
+         * 流式写入句柄 (对齐 Web WritableStream 概念)
+         * 适合大文件写入或持续日志
+         */
+        openWritable: (path: string) => WritableStream<Uint8Array>;
+        /** 创建目录：recursive 选项是实现“一键初始化数据库项目”的关键 */
+        mkdir: (
+            path: string,
+            options?: { recursive?: boolean },
+        ) => Promise<void>;
+        /** 删除：支持递归删除整个数据库文件夹 */
+        remove: (path: string) => Promise<void>;
+        /** 软链接：这就是你实现 dbs/ 链接的核心能力 */
+        symlink: (target: string, path: string) => Promise<void>;
+        /** 读取目录下的文件列表 */
+        readdir: (
+            path: string,
+            options?: { recursive?: boolean },
+        ) => Promise<string[]>;
+
+        // --- 建议增加的增强接口 ---
+        /** 获取文件状态：用于判断配置文件是否被篡改或检查数据大小 */
+        stat: (path: string) => Promise<FileStat>;
+        /** 监听文件：如果 .env 或 schema 变了，管理程序可以自动重载或提醒 */
+        watch?: (
+            path: string,
+            callback: (event: "change" | "rename") => void,
+        ) => () => void;
+    };
+    proc: {
+        //test
+        spawn: (args: string[], options?: SpawnOptions) => ProcHandle;
+    };
+}