@simplysm/core-node 13.0.0-beta.1

package/dist/features/fs-watcher.js

@@ -0,0 +1,100 @@
+import { DebounceQueue } from "@simplysm/core-common";
+import * as chokidar from "chokidar";
+import { createConsola } from "consola";
+import { pathNorm } from "../utils/path";
+const FS_WATCHER_EVENTS = ["add", "addDir", "change", "unlink", "unlinkDir"];
+class FsWatcher {
+  /**
+   * 파일 감시 시작 (비동기).
+   * ready 이벤트가 발생할 때까지 대기.
+   *
+   * @param paths - 감시할 파일/디렉토리 경로 또는 glob 패턴 배열
+   * @param options - chokidar 옵션
+   */
+  static async watch(paths, options) {
+    return new Promise((resolve, reject) => {
+      const watcher = new FsWatcher(paths, options);
+      watcher._watcher.on("ready", () => {
+        resolve(watcher);
+      });
+      watcher._watcher.on("error", reject);
+    });
+  }
+  _watcher;
+  _ignoreInitial = true;
+  _debounceQueues = [];
+  _logger = createConsola().withTag("sd-fs-watcher");
+  constructor(paths, options) {
+    this._watcher = chokidar.watch(paths, {
+      persistent: true,
+      ...options,
+      ignoreInitial: true
+    });
+    this._ignoreInitial = options?.ignoreInitial ?? this._ignoreInitial;
+    this._watcher.on("error", (err) => {
+      this._logger.error("FsWatcher error:", err);
+    });
+  }
+  /**
+   * 파일 변경 이벤트 핸들러 등록.
+   * 지정된 delay 시간 동안 이벤트를 모아서 한 번에 콜백 호출.
+   *
+   * @param opt.delay - 이벤트 병합 대기 시간 (ms)
+   * @param cb - 변경 이벤트 콜백
+   */
+  onChange(opt, cb) {
+    const fnQ = new DebounceQueue(opt.delay);
+    this._debounceQueues.push(fnQ);
+    let changeInfoMap = /* @__PURE__ */ new Map();
+    if (!this._ignoreInitial) {
+      fnQ.run(async () => {
+        await cb([]);
+      });
+    }
+    this._watcher.on("all", (event, filePath) => {
+      if (!FS_WATCHER_EVENTS.includes(event)) return;
+      if (!changeInfoMap.has(filePath)) {
+        changeInfoMap.set(filePath, event);
+      }
+      const prevEvent = changeInfoMap.get(filePath);
+      if (prevEvent === "add" && event === "change") {
+        changeInfoMap.set(filePath, "add");
+      } else if (prevEvent === "add" && event === "unlink" || prevEvent === "addDir" && event === "unlinkDir") {
+        changeInfoMap.delete(filePath);
+      } else if (prevEvent === "unlink" && (event === "add" || event === "change")) {
+        changeInfoMap.set(filePath, "add");
+      } else if (prevEvent === "unlinkDir" && event === "addDir") {
+        changeInfoMap.set(filePath, "addDir");
+      } else {
+        changeInfoMap.set(filePath, event);
+      }
+      fnQ.run(async () => {
+        if (changeInfoMap.size === 0) return;
+        const currChangeInfoMap = changeInfoMap;
+        changeInfoMap = /* @__PURE__ */ new Map();
+        const changeInfos = Array.from(currChangeInfoMap.entries()).map(
+          ([path, evt]) => ({
+            path: pathNorm(path),
+            event: evt
+          })
+        );
+        await cb(changeInfos);
+      });
+    });
+    return this;
+  }
+  /**
+   * 파일 감시 종료.
+   */
+  async close() {
+    for (const q of this._debounceQueues) {
+      q.dispose();
+    }
+    this._debounceQueues.length = 0;
+    await this._watcher.close();
+  }
+}
+export {
+  FsWatcher
+};
+//# sourceMappingURL=fs-watcher.js.map

package/dist/features/fs-watcher.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/features/fs-watcher.ts"],
+  "sourcesContent": ["import { DebounceQueue } from \"@simplysm/core-common\";\nimport * as chokidar from \"chokidar\";\nimport { createConsola } from \"consola\";\nimport type { EventName } from \"chokidar/handler.js\";\nimport { type NormPath, pathNorm } from \"../utils/path\";\n\n//#region Types\n\n/**\n * \uC9C0\uC6D0\uD558\uB294 \uD30C\uC77C \uBCC0\uACBD \uC774\uBCA4\uD2B8 \uD0C0\uC785 \uBAA9\uB85D.\n */\nconst FS_WATCHER_EVENTS = [\"add\", \"addDir\", \"change\", \"unlink\", \"unlinkDir\"] as const;\n\n/**\n * \uD30C\uC77C \uBCC0\uACBD \uC774\uBCA4\uD2B8 \uD0C0\uC785.\n */\nexport type FsWatcherEvent = (typeof FS_WATCHER_EVENTS)[number];\n\n/**\n * \uD30C\uC77C \uBCC0\uACBD \uC815\uBCF4.\n */\nexport interface FsWatcherChangeInfo {\n  /** \uBCC0\uACBD \uC774\uBCA4\uD2B8 \uD0C0\uC785 */\n  event: FsWatcherEvent;\n  /** \uBCC0\uACBD\uB41C \uD30C\uC77C/\uB514\uB809\uD1A0\uB9AC \uACBD\uB85C (\uC815\uADDC\uD654\uB428) */\n  path: NormPath;\n}\n\n//#endregion\n\n//#region FsWatcher\n\n/**\n * chokidar \uAE30\uBC18 \uD30C\uC77C \uC2DC\uC2A4\uD15C \uAC10\uC2DC \uB798\uD37C.\n * \uC9E7\uC740 \uC2DC\uAC04 \uB0B4 \uBC1C\uC0DD\uD55C \uC774\uBCA4\uD2B8\uB97C \uBCD1\uD569\uD558\uC5EC \uCF5C\uBC31 \uD638\uCD9C.\n *\n * **\uC8FC\uC758**: chokidar\uC758 `ignoreInitial` \uC635\uC158\uC740 \uB0B4\uBD80\uC801\uC73C\uB85C \uD56D\uC0C1 `true`\uB85C \uC124\uC815\uB41C\uB2E4.\n * `options.ignoreInitial: false`\uB97C \uC804\uB2EC\uD558\uBA74 `onChange` \uCCAB \uD638\uCD9C \uC2DC \uBE48 \uBC30\uC5F4\uB85C\n * \uCF5C\uBC31\uC774 \uD638\uCD9C\uB418\uC9C0\uB9CC, \uC2E4\uC81C \uCD08\uAE30 \uD30C\uC77C \uBAA9\uB85D\uC740 \uD3EC\uD568\uB418\uC9C0 \uC54A\uB294\uB2E4.\n * \uC774\uB294 \uC774\uBCA4\uD2B8 \uBCD1\uD569 \uB85C\uC9C1\uACFC\uC758 \uCDA9\uB3CC\uC744 \uBC29\uC9C0\uD558\uAE30 \uC704\uD55C \uC758\uB3C4\uB41C \uB3D9\uC791\uC774\uB2E4.\n *\n * @example\n * const watcher = await FsWatcher.watch([\"src/**\\/*.ts\"]);\n * watcher.onChange({ delay: 300 }, (changes) => {\n *   for (const { path, event } of changes) {\n *     console.log(`${event}: ${path}`);\n *   }\n * });\n *\n * // \uC885\uB8CC\n * await watcher.close();\n */\nexport class FsWatcher {\n  /**\n   * \uD30C\uC77C \uAC10\uC2DC \uC2DC\uC791 (\uBE44\uB3D9\uAE30).\n   * ready \uC774\uBCA4\uD2B8\uAC00 \uBC1C\uC0DD\uD560 \uB54C\uAE4C\uC9C0 \uB300\uAE30.\n   *\n   * @param paths - \uAC10\uC2DC\uD560 \uD30C\uC77C/\uB514\uB809\uD1A0\uB9AC \uACBD\uB85C \uB610\uB294 glob \uD328\uD134 \uBC30\uC5F4\n   * @param options - chokidar \uC635\uC158\n   */\n  static async watch(paths: string[], options?: chokidar.ChokidarOptions): Promise<FsWatcher> {\n    return new Promise<FsWatcher>((resolve, reject) => {\n      const watcher = new FsWatcher(paths, options);\n      watcher._watcher.on(\"ready\", () => {\n        resolve(watcher);\n      });\n      watcher._watcher.on(\"error\", reject);\n    });\n  }\n\n  private readonly _watcher: chokidar.FSWatcher;\n  private readonly _ignoreInitial: boolean = true;\n  private readonly _debounceQueues: DebounceQueue[] = [];\n\n  private readonly _logger = createConsola().withTag(\"sd-fs-watcher\");\n\n  private constructor(paths: string[], options?: chokidar.ChokidarOptions) {\n    this._watcher = chokidar.watch(paths, {\n      persistent: true,\n      ...options,\n      ignoreInitial: true,\n    });\n    this._ignoreInitial = options?.ignoreInitial ?? this._ignoreInitial;\n\n    // \uAC10\uC2DC \uC911 \uBC1C\uC0DD\uD558\uB294 \uC5D0\uB7EC \uB85C\uAE45\n    this._watcher.on(\"error\", (err) => {\n      this._logger.error(\"FsWatcher error:\", err);\n    });\n  }\n\n  /**\n   * \uD30C\uC77C \uBCC0\uACBD \uC774\uBCA4\uD2B8 \uD578\uB4E4\uB7EC \uB4F1\uB85D.\n   * \uC9C0\uC815\uB41C delay \uC2DC\uAC04 \uB3D9\uC548 \uC774\uBCA4\uD2B8\uB97C \uBAA8\uC544\uC11C \uD55C \uBC88\uC5D0 \uCF5C\uBC31 \uD638\uCD9C.\n   *\n   * @param opt.delay - \uC774\uBCA4\uD2B8 \uBCD1\uD569 \uB300\uAE30 \uC2DC\uAC04 (ms)\n   * @param cb - \uBCC0\uACBD \uC774\uBCA4\uD2B8 \uCF5C\uBC31\n   */\n  onChange(opt: { delay?: number }, cb: (changeInfos: FsWatcherChangeInfo[]) => void | Promise<void>): this {\n    const fnQ = new DebounceQueue(opt.delay);\n    this._debounceQueues.push(fnQ);\n\n    let changeInfoMap = new Map<string, EventName>();\n\n    // ignoreInitial\uC774 false\uBA74 \uCD08\uAE30\uC5D0 \uBE48 \uBC30\uC5F4\uB85C \uCF5C\uBC31 \uD638\uCD9C\n    if (!this._ignoreInitial) {\n      fnQ.run(async () => {\n        await cb([]);\n      });\n    }\n\n    this._watcher.on(\"all\", (event, filePath) => {\n      // \uC9C0\uC6D0\uD558\uB294 \uC774\uBCA4\uD2B8\uB9CC \uCC98\uB9AC\n      if (!FS_WATCHER_EVENTS.includes(event as FsWatcherEvent)) return;\n\n      /*\n       * \uC774\uBCA4\uD2B8 \uBCD1\uD569 \uC804\uB7B5:\n       * \uC9E7\uC740 \uC2DC\uAC04 \uB0B4 \uAC19\uC740 \uD30C\uC77C\uC5D0 \uB300\uD574 \uC5EC\uB7EC \uC774\uBCA4\uD2B8\uAC00 \uBC1C\uC0DD\uD558\uBA74 \uCD5C\uC885 \uC0C1\uD0DC\uB9CC \uC804\uB2EC\uD55C\uB2E4.\n       * - add + change \u2192 add (\uC0DD\uC131 \uC9C1\uD6C4 \uC218\uC815\uC740 \uC0DD\uC131\uC73C\uB85C \uAC04\uC8FC)\n       * - add + unlink \u2192 \uC0AD\uC81C (\uC0DD\uC131 \uD6C4 \uC989\uC2DC \uC0AD\uC81C\uB294 \uBCC0\uACBD \uC5C6\uC74C)\n       * - unlink + add \u2192 add (\uC0AD\uC81C \uD6C4 \uC7AC\uC0DD\uC131\uC740 \uC0DD\uC131\uC73C\uB85C \uAC04\uC8FC)\n       * - \uADF8 \uC678 \u2192 \uCD5C\uC2E0 \uC774\uBCA4\uD2B8\uB85C \uB36E\uC5B4\uC500\n       */\n      if (!changeInfoMap.has(filePath)) {\n        changeInfoMap.set(filePath, event);\n      }\n      const prevEvent = changeInfoMap.get(filePath)!;\n\n      if (prevEvent === \"add\" && event === \"change\") {\n        // add \uD6C4 change \u2192 add \uC720\uC9C0\n        changeInfoMap.set(filePath, \"add\");\n      } else if ((prevEvent === \"add\" && event === \"unlink\") || (prevEvent === \"addDir\" && event === \"unlinkDir\")) {\n        // add \uD6C4 unlink \u2192 \uBCC0\uACBD \uC5C6\uC74C (\uC0AD\uC81C)\n        changeInfoMap.delete(filePath);\n      } else if (prevEvent === \"unlink\" && (event === \"add\" || event === \"change\")) {\n        // unlink \uD6C4 add/change \u2192 add (\uD30C\uC77C \uC7AC\uC0DD\uC131)\n        changeInfoMap.set(filePath, \"add\");\n      } else if (prevEvent === \"unlinkDir\" && event === \"addDir\") {\n        // unlinkDir \uD6C4 addDir \u2192 addDir (\uB514\uB809\uD1A0\uB9AC \uC7AC\uC0DD\uC131)\n        changeInfoMap.set(filePath, \"addDir\");\n      } else {\n        changeInfoMap.set(filePath, event);\n      }\n\n      fnQ.run(async () => {\n        if (changeInfoMap.size === 0) return;\n\n        const currChangeInfoMap = changeInfoMap;\n        changeInfoMap = new Map<string, EventName>();\n\n        const changeInfos = Array.from(currChangeInfoMap.entries()).map(\n          ([path, evt]): FsWatcherChangeInfo => ({\n            path: pathNorm(path),\n            event: evt as FsWatcherEvent,\n          }),\n        );\n\n        await cb(changeInfos);\n      });\n    });\n\n    return this;\n  }\n\n  /**\n   * \uD30C\uC77C \uAC10\uC2DC \uC885\uB8CC.\n   */\n  async close(): Promise<void> {\n    for (const q of this._debounceQueues) {\n      q.dispose();\n    }\n    this._debounceQueues.length = 0;\n    await this._watcher.close();\n  }\n}\n\n//#endregion\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAC9B,YAAY,cAAc;AAC1B,SAAS,qBAAqB;AAE9B,SAAwB,gBAAgB;AAOxC,MAAM,oBAAoB,CAAC,OAAO,UAAU,UAAU,UAAU,WAAW;AAyCpE,MAAM,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQrB,aAAa,MAAM,OAAiB,SAAwD;AAC1F,WAAO,IAAI,QAAmB,CAAC,SAAS,WAAW;AACjD,YAAM,UAAU,IAAI,UAAU,OAAO,OAAO;AAC5C,cAAQ,SAAS,GAAG,SAAS,MAAM;AACjC,gBAAQ,OAAO;AAAA,MACjB,CAAC;AACD,cAAQ,SAAS,GAAG,SAAS,MAAM;AAAA,IACrC,CAAC;AAAA,EACH;AAAA,EAEiB;AAAA,EACA,iBAA0B;AAAA,EAC1B,kBAAmC,CAAC;AAAA,EAEpC,UAAU,cAAc,EAAE,QAAQ,eAAe;AAAA,EAE1D,YAAY,OAAiB,SAAoC;AACvE,SAAK,WAAW,SAAS,MAAM,OAAO;AAAA,MACpC,YAAY;AAAA,MACZ,GAAG;AAAA,MACH,eAAe;AAAA,IACjB,CAAC;AACD,SAAK,iBAAiB,SAAS,iBAAiB,KAAK;AAGrD,SAAK,SAAS,GAAG,SAAS,CAAC,QAAQ;AACjC,WAAK,QAAQ,MAAM,oBAAoB,GAAG;AAAA,IAC5C,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,SAAS,KAAyB,IAAwE;AACxG,UAAM,MAAM,IAAI,cAAc,IAAI,KAAK;AACvC,SAAK,gBAAgB,KAAK,GAAG;AAE7B,QAAI,gBAAgB,oBAAI,IAAuB;AAG/C,QAAI,CAAC,KAAK,gBAAgB;AACxB,UAAI,IAAI,YAAY;AAClB,cAAM,GAAG,CAAC,CAAC;AAAA,MACb,CAAC;AAAA,IACH;AAEA,SAAK,SAAS,GAAG,OAAO,CAAC,OAAO,aAAa;AAE3C,UAAI,CAAC,kBAAkB,SAAS,KAAuB,EAAG;AAU1D,UAAI,CAAC,cAAc,IAAI,QAAQ,GAAG;AAChC,sBAAc,IAAI,UAAU,KAAK;AAAA,MACnC;AACA,YAAM,YAAY,cAAc,IAAI,QAAQ;AAE5C,UAAI,cAAc,SAAS,UAAU,UAAU;AAE7C,sBAAc,IAAI,UAAU,KAAK;AAAA,MACnC,WAAY,cAAc,SAAS,UAAU,YAAc,cAAc,YAAY,UAAU,aAAc;AAE3G,sBAAc,OAAO,QAAQ;AAAA,MAC/B,WAAW,cAAc,aAAa,UAAU,SAAS,UAAU,WAAW;AAE5E,sBAAc,IAAI,UAAU,KAAK;AAAA,MACnC,WAAW,cAAc,eAAe,UAAU,UAAU;AAE1D,sBAAc,IAAI,UAAU,QAAQ;AAAA,MACtC,OAAO;AACL,sBAAc,IAAI,UAAU,KAAK;AAAA,MACnC;AAEA,UAAI,IAAI,YAAY;AAClB,YAAI,cAAc,SAAS,EAAG;AAE9B,cAAM,oBAAoB;AAC1B,wBAAgB,oBAAI,IAAuB;AAE3C,cAAM,cAAc,MAAM,KAAK,kBAAkB,QAAQ,CAAC,EAAE;AAAA,UAC1D,CAAC,CAAC,MAAM,GAAG,OAA4B;AAAA,YACrC,MAAM,SAAS,IAAI;AAAA,YACnB,OAAO;AAAA,UACT;AAAA,QACF;AAEA,cAAM,GAAG,WAAW;AAAA,MACtB,CAAC;AAAA,IACH,CAAC;AAED,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAuB;AAC3B,eAAW,KAAK,KAAK,iBAAiB;AACpC,QAAE,QAAQ;AAAA,IACZ;AACA,SAAK,gBAAgB,SAAS;AAC9B,UAAM,KAAK,SAAS,MAAM;AAAA,EAC5B;AACF;",
+  "names": []
+}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./utils/fs";
+export * from "./utils/path";
+export * from "./features/fs-watcher";
+export * from "./worker/types";
+export * from "./worker/worker";
+export * from "./worker/create-worker";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["// Utils\nexport * from \"./utils/fs\";\nexport * from \"./utils/path\";\n\n// Features\nexport * from \"./features/fs-watcher\";\n\n// Worker\nexport * from \"./worker/types\";\nexport * from \"./worker/worker\";\nexport * from \"./worker/create-worker\";\n"],
+  "mappings": "AACA,cAAc;AACd,cAAc;AAGd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/utils/fs.js

@@ -0,0 +1,305 @@
+import path from "path";
+import fs from "fs";
+import os from "os";
+import { glob as globRaw, globSync as globRawSync } from "glob";
+import { jsonParse, jsonStringify, SdError } from "@simplysm/core-common";
+import "@simplysm/core-common";
+function fsExistsSync(targetPath) {
+  return fs.existsSync(targetPath);
+}
+async function fsExists(targetPath) {
+  try {
+    await fs.promises.access(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function fsMkdirSync(targetPath) {
+  try {
+    fs.mkdirSync(targetPath, { recursive: true });
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+async function fsMkdir(targetPath) {
+  try {
+    await fs.promises.mkdir(targetPath, { recursive: true });
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+function fsRmSync(targetPath) {
+  try {
+    fs.rmSync(targetPath, { recursive: true, force: true });
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+async function fsRm(targetPath) {
+  try {
+    await fs.promises.rm(targetPath, {
+      recursive: true,
+      force: true,
+      retryDelay: 500,
+      maxRetries: 6
+    });
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+function fsCopySync(sourcePath, targetPath, filter) {
+  if (!fsExistsSync(sourcePath)) {
+    return;
+  }
+  let stats;
+  try {
+    stats = fs.lstatSync(sourcePath);
+  } catch (err) {
+    throw new SdError(err, sourcePath);
+  }
+  if (stats.isDirectory()) {
+    fsMkdirSync(targetPath);
+    const children = fsGlobSync(path.resolve(sourcePath, "*"), { dot: true });
+    for (const childPath of children) {
+      if (filter !== void 0 && !filter(childPath)) {
+        continue;
+      }
+      const relativeChildPath = path.relative(sourcePath, childPath);
+      const childTargetPath = path.resolve(targetPath, relativeChildPath);
+      fsCopySync(childPath, childTargetPath, filter);
+    }
+  } else {
+    fsMkdirSync(path.dirname(targetPath));
+    try {
+      fs.copyFileSync(sourcePath, targetPath);
+    } catch (err) {
+      throw new SdError(err, targetPath);
+    }
+  }
+}
+async function fsCopy(sourcePath, targetPath, filter) {
+  if (!await fsExists(sourcePath)) {
+    return;
+  }
+  let stats;
+  try {
+    stats = await fs.promises.lstat(sourcePath);
+  } catch (err) {
+    throw new SdError(err, sourcePath);
+  }
+  if (stats.isDirectory()) {
+    await fsMkdir(targetPath);
+    const children = await fsGlob(path.resolve(sourcePath, "*"), { dot: true });
+    await children.parallelAsync(async (childPath) => {
+      if (filter !== void 0 && !filter(childPath)) {
+        return;
+      }
+      const relativeChildPath = path.relative(sourcePath, childPath);
+      const childTargetPath = path.resolve(targetPath, relativeChildPath);
+      await fsCopy(childPath, childTargetPath, filter);
+    });
+  } else {
+    await fsMkdir(path.dirname(targetPath));
+    try {
+      await fs.promises.copyFile(sourcePath, targetPath);
+    } catch (err) {
+      throw new SdError(err, targetPath);
+    }
+  }
+}
+function fsReadSync(targetPath) {
+  try {
+    return fs.readFileSync(targetPath, "utf-8");
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+async function fsRead(targetPath) {
+  try {
+    return await fs.promises.readFile(targetPath, "utf-8");
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+function fsReadBufferSync(targetPath) {
+  try {
+    return fs.readFileSync(targetPath);
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+async function fsReadBuffer(targetPath) {
+  try {
+    return await fs.promises.readFile(targetPath);
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+function fsReadJsonSync(targetPath) {
+  const contents = fsReadSync(targetPath);
+  try {
+    return jsonParse(contents);
+  } catch (err) {
+    const preview = contents.length > 500 ? contents.slice(0, 500) + "...(truncated)" : contents;
+    throw new SdError(err, targetPath + os.EOL + preview);
+  }
+}
+async function fsReadJson(targetPath) {
+  const contents = await fsRead(targetPath);
+  try {
+    return jsonParse(contents);
+  } catch (err) {
+    const preview = contents.length > 500 ? contents.slice(0, 500) + "...(truncated)" : contents;
+    throw new SdError(err, targetPath + os.EOL + preview);
+  }
+}
+function fsWriteSync(targetPath, data) {
+  fsMkdirSync(path.dirname(targetPath));
+  try {
+    fs.writeFileSync(targetPath, data, { flush: true });
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+async function fsWrite(targetPath, data) {
+  await fsMkdir(path.dirname(targetPath));
+  try {
+    await fs.promises.writeFile(targetPath, data, { flush: true });
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+function fsWriteJsonSync(targetPath, data, options) {
+  const json = jsonStringify(data, options);
+  fsWriteSync(targetPath, json);
+}
+async function fsWriteJson(targetPath, data, options) {
+  const json = jsonStringify(data, options);
+  await fsWrite(targetPath, json);
+}
+function fsReaddirSync(targetPath) {
+  try {
+    return fs.readdirSync(targetPath);
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+async function fsReaddir(targetPath) {
+  try {
+    return await fs.promises.readdir(targetPath);
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+function fsStatSync(targetPath) {
+  try {
+    return fs.statSync(targetPath);
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+async function fsStat(targetPath) {
+  try {
+    return await fs.promises.stat(targetPath);
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+function fsLstatSync(targetPath) {
+  try {
+    return fs.lstatSync(targetPath);
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+async function fsLstat(targetPath) {
+  try {
+    return await fs.promises.lstat(targetPath);
+  } catch (err) {
+    throw new SdError(err, targetPath);
+  }
+}
+function fsGlobSync(pattern, options) {
+  return globRawSync(pattern.replace(/\\/g, "/"), options ?? {}).map((item) => path.resolve(item.toString()));
+}
+async function fsGlob(pattern, options) {
+  return (await globRaw(pattern.replace(/\\/g, "/"), options ?? {})).map((item) => path.resolve(item.toString()));
+}
+async function fsClearEmptyDirectory(dirPath) {
+  if (!await fsExists(dirPath)) return;
+  const childNames = await fsReaddir(dirPath);
+  let hasFiles = false;
+  for (const childName of childNames) {
+    const childPath = path.resolve(dirPath, childName);
+    if ((await fsLstat(childPath)).isDirectory()) {
+      await fsClearEmptyDirectory(childPath);
+    } else {
+      hasFiles = true;
+    }
+  }
+  if (hasFiles) return;
+  if ((await fsReaddir(dirPath)).length === 0) {
+    await fsRm(dirPath);
+  }
+}
+function fsFindAllParentChildPathsSync(childGlob, fromPath, rootPath) {
+  const resultPaths = [];
+  let current = fromPath;
+  while (current) {
+    const potential = path.resolve(current, childGlob);
+    const globResults = fsGlobSync(potential);
+    resultPaths.push(...globResults);
+    if (current === rootPath) break;
+    const next = path.dirname(current);
+    if (next === current) break;
+    current = next;
+  }
+  return resultPaths;
+}
+async function fsFindAllParentChildPaths(childGlob, fromPath, rootPath) {
+  const resultPaths = [];
+  let current = fromPath;
+  while (current) {
+    const potential = path.resolve(current, childGlob);
+    const globResults = await fsGlob(potential);
+    resultPaths.push(...globResults);
+    if (current === rootPath) break;
+    const next = path.dirname(current);
+    if (next === current) break;
+    current = next;
+  }
+  return resultPaths;
+}
+export {
+  fsClearEmptyDirectory,
+  fsCopy,
+  fsCopySync,
+  fsExists,
+  fsExistsSync,
+  fsFindAllParentChildPaths,
+  fsFindAllParentChildPathsSync,
+  fsGlob,
+  fsGlobSync,
+  fsLstat,
+  fsLstatSync,
+  fsMkdir,
+  fsMkdirSync,
+  fsRead,
+  fsReadBuffer,
+  fsReadBufferSync,
+  fsReadJson,
+  fsReadJsonSync,
+  fsReadSync,
+  fsReaddir,
+  fsReaddirSync,
+  fsRm,
+  fsRmSync,
+  fsStat,
+  fsStatSync,
+  fsWrite,
+  fsWriteJson,
+  fsWriteJsonSync,
+  fsWriteSync
+};
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/fs.ts"],
+  "sourcesContent": ["import path from \"path\";\nimport fs from \"fs\";\nimport os from \"os\";\nimport { glob as globRaw, type GlobOptions, globSync as globRawSync } from \"glob\";\nimport { jsonParse, jsonStringify, SdError } from \"@simplysm/core-common\";\nimport \"@simplysm/core-common\";\n\n//#region \uC874\uC7AC \uD655\uC778\n\n/**\n * \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC \uD655\uC778 (\uB3D9\uAE30).\n * @param targetPath - \uD655\uC778\uD560 \uACBD\uB85C\n */\nexport function fsExistsSync(targetPath: string): boolean {\n  return fs.existsSync(targetPath);\n}\n\n/**\n * \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC \uD655\uC778 (\uBE44\uB3D9\uAE30).\n * @param targetPath - \uD655\uC778\uD560 \uACBD\uB85C\n */\nexport async function fsExists(targetPath: string): Promise<boolean> {\n  try {\n    await fs.promises.access(targetPath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n//#endregion\n\n//#region \uB514\uB809\uD1A0\uB9AC \uC0DD\uC131\n\n/**\n * \uB514\uB809\uD1A0\uB9AC \uC0DD\uC131 (recursive).\n * @param targetPath - \uC0DD\uC131\uD560 \uB514\uB809\uD1A0\uB9AC \uACBD\uB85C\n */\nexport function fsMkdirSync(targetPath: string): void {\n  try {\n    fs.mkdirSync(targetPath, { recursive: true });\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n/**\n * \uB514\uB809\uD1A0\uB9AC \uC0DD\uC131 (recursive, \uBE44\uB3D9\uAE30).\n * @param targetPath - \uC0DD\uC131\uD560 \uB514\uB809\uD1A0\uB9AC \uACBD\uB85C\n */\nexport async function fsMkdir(targetPath: string): Promise<void> {\n  try {\n    await fs.promises.mkdir(targetPath, { recursive: true });\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n//#endregion\n\n//#region \uC0AD\uC81C\n\n/**\n * \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC \uC0AD\uC81C.\n * @param targetPath - \uC0AD\uC81C\uD560 \uACBD\uB85C\n * @remarks \uB3D9\uAE30 \uBC84\uC804\uC740 \uC7AC\uC2DC\uB3C4 \uC5C6\uC774 \uC989\uC2DC \uC2E4\uD328\uD568. \uD30C\uC77C \uC7A0\uAE08 \uB4F1 \uC77C\uC2DC\uC801 \uC624\uB958 \uAC00\uB2A5\uC131\uC774 \uC788\uB294 \uACBD\uC6B0 fsRm \uC0AC\uC6A9\uC744 \uAD8C\uC7A5\uD568.\n */\nexport function fsRmSync(targetPath: string): void {\n  try {\n    fs.rmSync(targetPath, { recursive: true, force: true });\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n/**\n * \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC \uC0AD\uC81C (\uBE44\uB3D9\uAE30).\n * @param targetPath - \uC0AD\uC81C\uD560 \uACBD\uB85C\n * @remarks \uBE44\uB3D9\uAE30 \uBC84\uC804\uC740 \uD30C\uC77C \uC7A0\uAE08 \uB4F1\uC758 \uC77C\uC2DC\uC801 \uC624\uB958\uC5D0 \uB300\uD574 \uCD5C\uB300 6\uD68C(500ms \uAC04\uACA9) \uC7AC\uC2DC\uB3C4\uD568.\n */\nexport async function fsRm(targetPath: string): Promise<void> {\n  try {\n    await fs.promises.rm(targetPath, {\n      recursive: true,\n      force: true,\n      retryDelay: 500,\n      maxRetries: 6,\n    });\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n//#endregion\n\n//#region \uBCF5\uC0AC\n\n/**\n * \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC \uBCF5\uC0AC.\n *\n * sourcePath\uAC00 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC73C\uBA74 \uC544\uBB34 \uC791\uC5C5\uB3C4 \uC218\uD589\uD558\uC9C0 \uC54A\uACE0 \uBC18\uD658\uD55C\uB2E4.\n *\n * @param sourcePath \uBCF5\uC0AC\uD560 \uC6D0\uBCF8 \uACBD\uB85C\n * @param targetPath \uBCF5\uC0AC \uB300\uC0C1 \uACBD\uB85C\n * @param filter \uBCF5\uC0AC \uC5EC\uBD80\uB97C \uACB0\uC815\uD558\uB294 \uD544\uD130 \uD568\uC218.\n *               \uAC01 \uD30C\uC77C/\uB514\uB809\uD1A0\uB9AC\uC758 **\uC808\uB300 \uACBD\uB85C**\uAC00 \uC804\uB2EC\uB418\uBA70,\n *               true\uB97C \uBC18\uD658\uD558\uBA74 \uBCF5\uC0AC, false\uBA74 \uC81C\uC678.\n *               **\uC8FC\uC758**: \uCD5C\uC0C1\uC704 sourcePath\uB294 \uD544\uD130 \uB300\uC0C1\uC774 \uC544\uB2C8\uBA70,\n *               \uBAA8\uB4E0 \uD558\uC704 \uD56D\uBAA9(\uC790\uC2DD, \uC190\uC790 \uB4F1)\uC5D0 \uC7AC\uADC0\uC801\uC73C\uB85C filter \uD568\uC218\uAC00 \uC801\uC6A9\uB41C\uB2E4.\n *               \uB514\uB809\uD1A0\uB9AC\uC5D0 false\uB97C \uBC18\uD658\uD558\uBA74 \uD574\uB2F9 \uB514\uB809\uD1A0\uB9AC\uC640 \uBAA8\uB4E0 \uD558\uC704 \uD56D\uBAA9\uC774 \uAC74\uB108\uB6F0\uC5B4\uC9D0.\n */\nexport function fsCopySync(sourcePath: string, targetPath: string, filter?: (absolutePath: string) => boolean): void {\n  if (!fsExistsSync(sourcePath)) {\n    return;\n  }\n\n  let stats: fs.Stats;\n  try {\n    stats = fs.lstatSync(sourcePath);\n  } catch (err) {\n    throw new SdError(err, sourcePath);\n  }\n\n  if (stats.isDirectory()) {\n    fsMkdirSync(targetPath);\n\n    const children = fsGlobSync(path.resolve(sourcePath, \"*\"), { dot: true });\n\n    for (const childPath of children) {\n      if (filter !== undefined && !filter(childPath)) {\n        continue;\n      }\n\n      const relativeChildPath = path.relative(sourcePath, childPath);\n      const childTargetPath = path.resolve(targetPath, relativeChildPath);\n      fsCopySync(childPath, childTargetPath, filter);\n    }\n  } else {\n    fsMkdirSync(path.dirname(targetPath));\n\n    try {\n      fs.copyFileSync(sourcePath, targetPath);\n    } catch (err) {\n      throw new SdError(err, targetPath);\n    }\n  }\n}\n\n/**\n * \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC \uBCF5\uC0AC (\uBE44\uB3D9\uAE30).\n *\n * sourcePath\uAC00 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC73C\uBA74 \uC544\uBB34 \uC791\uC5C5\uB3C4 \uC218\uD589\uD558\uC9C0 \uC54A\uACE0 \uBC18\uD658\uD55C\uB2E4.\n *\n * @param sourcePath \uBCF5\uC0AC\uD560 \uC6D0\uBCF8 \uACBD\uB85C\n * @param targetPath \uBCF5\uC0AC \uB300\uC0C1 \uACBD\uB85C\n * @param filter \uBCF5\uC0AC \uC5EC\uBD80\uB97C \uACB0\uC815\uD558\uB294 \uD544\uD130 \uD568\uC218.\n *               \uAC01 \uD30C\uC77C/\uB514\uB809\uD1A0\uB9AC\uC758 **\uC808\uB300 \uACBD\uB85C**\uAC00 \uC804\uB2EC\uB418\uBA70,\n *               true\uB97C \uBC18\uD658\uD558\uBA74 \uBCF5\uC0AC, false\uBA74 \uC81C\uC678.\n *               **\uC8FC\uC758**: \uCD5C\uC0C1\uC704 sourcePath\uB294 \uD544\uD130 \uB300\uC0C1\uC774 \uC544\uB2C8\uBA70,\n *               \uBAA8\uB4E0 \uD558\uC704 \uD56D\uBAA9(\uC790\uC2DD, \uC190\uC790 \uB4F1)\uC5D0 \uC7AC\uADC0\uC801\uC73C\uB85C filter \uD568\uC218\uAC00 \uC801\uC6A9\uB41C\uB2E4.\n *               \uB514\uB809\uD1A0\uB9AC\uC5D0 false\uB97C \uBC18\uD658\uD558\uBA74 \uD574\uB2F9 \uB514\uB809\uD1A0\uB9AC\uC640 \uBAA8\uB4E0 \uD558\uC704 \uD56D\uBAA9\uC774 \uAC74\uB108\uB6F0\uC5B4\uC9D0.\n */\nexport async function fsCopy(\n  sourcePath: string,\n  targetPath: string,\n  filter?: (absolutePath: string) => boolean,\n): Promise<void> {\n  if (!(await fsExists(sourcePath))) {\n    return;\n  }\n\n  let stats: fs.Stats;\n  try {\n    stats = await fs.promises.lstat(sourcePath);\n  } catch (err) {\n    throw new SdError(err, sourcePath);\n  }\n\n  if (stats.isDirectory()) {\n    await fsMkdir(targetPath);\n\n    const children = await fsGlob(path.resolve(sourcePath, \"*\"), { dot: true });\n\n    await children.parallelAsync(async (childPath) => {\n      if (filter !== undefined && !filter(childPath)) {\n        return;\n      }\n\n      const relativeChildPath = path.relative(sourcePath, childPath);\n      const childTargetPath = path.resolve(targetPath, relativeChildPath);\n      await fsCopy(childPath, childTargetPath, filter);\n    });\n  } else {\n    await fsMkdir(path.dirname(targetPath));\n\n    try {\n      await fs.promises.copyFile(sourcePath, targetPath);\n    } catch (err) {\n      throw new SdError(err, targetPath);\n    }\n  }\n}\n\n//#endregion\n\n//#region \uD30C\uC77C \uC77D\uAE30\n\n/**\n * \uD30C\uC77C \uC77D\uAE30 (UTF-8 \uBB38\uC790\uC5F4).\n * @param targetPath - \uC77D\uC744 \uD30C\uC77C \uACBD\uB85C\n */\nexport function fsReadSync(targetPath: string): string {\n  try {\n    return fs.readFileSync(targetPath, \"utf-8\");\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n/**\n * \uD30C\uC77C \uC77D\uAE30 (UTF-8 \uBB38\uC790\uC5F4, \uBE44\uB3D9\uAE30).\n * @param targetPath - \uC77D\uC744 \uD30C\uC77C \uACBD\uB85C\n */\nexport async function fsRead(targetPath: string): Promise<string> {\n  try {\n    return await fs.promises.readFile(targetPath, \"utf-8\");\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n/**\n * \uD30C\uC77C \uC77D\uAE30 (Buffer).\n * @param targetPath - \uC77D\uC744 \uD30C\uC77C \uACBD\uB85C\n */\nexport function fsReadBufferSync(targetPath: string): Buffer {\n  try {\n    return fs.readFileSync(targetPath);\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n/**\n * \uD30C\uC77C \uC77D\uAE30 (Buffer, \uBE44\uB3D9\uAE30).\n * @param targetPath - \uC77D\uC744 \uD30C\uC77C \uACBD\uB85C\n */\nexport async function fsReadBuffer(targetPath: string): Promise<Buffer> {\n  try {\n    return await fs.promises.readFile(targetPath);\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n/**\n * JSON \uD30C\uC77C \uC77D\uAE30 (JsonConvert \uC0AC\uC6A9).\n * @param targetPath - \uC77D\uC744 JSON \uD30C\uC77C \uACBD\uB85C\n */\nexport function fsReadJsonSync<T = unknown>(targetPath: string): T {\n  const contents = fsReadSync(targetPath);\n  try {\n    return jsonParse(contents);\n  } catch (err) {\n    const preview = contents.length > 500 ? contents.slice(0, 500) + \"...(truncated)\" : contents;\n    throw new SdError(err, targetPath + os.EOL + preview);\n  }\n}\n\n/**\n * JSON \uD30C\uC77C \uC77D\uAE30 (JsonConvert \uC0AC\uC6A9, \uBE44\uB3D9\uAE30).\n * @param targetPath - \uC77D\uC744 JSON \uD30C\uC77C \uACBD\uB85C\n */\nexport async function fsReadJson<T = unknown>(targetPath: string): Promise<T> {\n  const contents = await fsRead(targetPath);\n  try {\n    return jsonParse<T>(contents);\n  } catch (err) {\n    const preview = contents.length > 500 ? contents.slice(0, 500) + \"...(truncated)\" : contents;\n    throw new SdError(err, targetPath + os.EOL + preview);\n  }\n}\n\n//#endregion\n\n//#region \uD30C\uC77C \uC4F0\uAE30\n\n/**\n * \uD30C\uC77C \uC4F0\uAE30 (\uBD80\uBAA8 \uB514\uB809\uD1A0\uB9AC \uC790\uB3D9 \uC0DD\uC131).\n * @param targetPath - \uC4F8 \uD30C\uC77C \uACBD\uB85C\n * @param data - \uC4F8 \uB370\uC774\uD130 (\uBB38\uC790\uC5F4 \uB610\uB294 \uBC14\uC774\uB108\uB9AC)\n */\nexport function fsWriteSync(targetPath: string, data: string | Uint8Array): void {\n  fsMkdirSync(path.dirname(targetPath));\n\n  try {\n    fs.writeFileSync(targetPath, data, { flush: true });\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n/**\n * \uD30C\uC77C \uC4F0\uAE30 (\uBD80\uBAA8 \uB514\uB809\uD1A0\uB9AC \uC790\uB3D9 \uC0DD\uC131, \uBE44\uB3D9\uAE30).\n * @param targetPath - \uC4F8 \uD30C\uC77C \uACBD\uB85C\n * @param data - \uC4F8 \uB370\uC774\uD130 (\uBB38\uC790\uC5F4 \uB610\uB294 \uBC14\uC774\uB108\uB9AC)\n */\nexport async function fsWrite(targetPath: string, data: string | Uint8Array): Promise<void> {\n  await fsMkdir(path.dirname(targetPath));\n\n  try {\n    await fs.promises.writeFile(targetPath, data, { flush: true });\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n/**\n * JSON \uD30C\uC77C \uC4F0\uAE30 (JsonConvert \uC0AC\uC6A9).\n * @param targetPath - \uC4F8 JSON \uD30C\uC77C \uACBD\uB85C\n * @param data - \uC4F8 \uB370\uC774\uD130\n * @param options - JSON \uC9C1\uB82C\uD654 \uC635\uC158\n */\nexport function fsWriteJsonSync(\n  targetPath: string,\n  data: unknown,\n  options?: {\n    replacer?: (this: unknown, key: string | undefined, value: unknown) => unknown;\n    space?: string | number;\n  },\n): void {\n  const json = jsonStringify(data, options);\n  fsWriteSync(targetPath, json);\n}\n\n/**\n * JSON \uD30C\uC77C \uC4F0\uAE30 (JsonConvert \uC0AC\uC6A9, \uBE44\uB3D9\uAE30).\n * @param targetPath - \uC4F8 JSON \uD30C\uC77C \uACBD\uB85C\n * @param data - \uC4F8 \uB370\uC774\uD130\n * @param options - JSON \uC9C1\uB82C\uD654 \uC635\uC158\n */\nexport async function fsWriteJson(\n  targetPath: string,\n  data: unknown,\n  options?: {\n    replacer?: (this: unknown, key: string | undefined, value: unknown) => unknown;\n    space?: string | number;\n  },\n): Promise<void> {\n  const json = jsonStringify(data, options);\n  await fsWrite(targetPath, json);\n}\n\n//#endregion\n\n//#region \uB514\uB809\uD1A0\uB9AC \uC77D\uAE30\n\n/**\n * \uB514\uB809\uD1A0\uB9AC \uB0B4\uC6A9 \uC77D\uAE30.\n * @param targetPath - \uC77D\uC744 \uB514\uB809\uD1A0\uB9AC \uACBD\uB85C\n */\nexport function fsReaddirSync(targetPath: string): string[] {\n  try {\n    return fs.readdirSync(targetPath);\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n/**\n * \uB514\uB809\uD1A0\uB9AC \uB0B4\uC6A9 \uC77D\uAE30 (\uBE44\uB3D9\uAE30).\n * @param targetPath - \uC77D\uC744 \uB514\uB809\uD1A0\uB9AC \uACBD\uB85C\n */\nexport async function fsReaddir(targetPath: string): Promise<string[]> {\n  try {\n    return await fs.promises.readdir(targetPath);\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n//#endregion\n\n//#region \uD30C\uC77C \uC815\uBCF4\n\n/**\n * \uD30C\uC77C/\uB514\uB809\uD1A0\uB9AC \uC815\uBCF4 (\uC2EC\uBCFC\uB9AD \uB9C1\uD06C \uB530\uB77C\uAC10).\n * @param targetPath - \uC815\uBCF4\uB97C \uC870\uD68C\uD560 \uACBD\uB85C\n */\nexport function fsStatSync(targetPath: string): fs.Stats {\n  try {\n    return fs.statSync(targetPath);\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n/**\n * \uD30C\uC77C/\uB514\uB809\uD1A0\uB9AC \uC815\uBCF4 (\uC2EC\uBCFC\uB9AD \uB9C1\uD06C \uB530\uB77C\uAC10, \uBE44\uB3D9\uAE30).\n * @param targetPath - \uC815\uBCF4\uB97C \uC870\uD68C\uD560 \uACBD\uB85C\n */\nexport async function fsStat(targetPath: string): Promise<fs.Stats> {\n  try {\n    return await fs.promises.stat(targetPath);\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n/**\n * \uD30C\uC77C/\uB514\uB809\uD1A0\uB9AC \uC815\uBCF4 (\uC2EC\uBCFC\uB9AD \uB9C1\uD06C \uB530\uB77C\uAC00\uC9C0 \uC54A\uC74C).\n * @param targetPath - \uC815\uBCF4\uB97C \uC870\uD68C\uD560 \uACBD\uB85C\n */\nexport function fsLstatSync(targetPath: string): fs.Stats {\n  try {\n    return fs.lstatSync(targetPath);\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n/**\n * \uD30C\uC77C/\uB514\uB809\uD1A0\uB9AC \uC815\uBCF4 (\uC2EC\uBCFC\uB9AD \uB9C1\uD06C \uB530\uB77C\uAC00\uC9C0 \uC54A\uC74C, \uBE44\uB3D9\uAE30).\n * @param targetPath - \uC815\uBCF4\uB97C \uC870\uD68C\uD560 \uACBD\uB85C\n */\nexport async function fsLstat(targetPath: string): Promise<fs.Stats> {\n  try {\n    return await fs.promises.lstat(targetPath);\n  } catch (err) {\n    throw new SdError(err, targetPath);\n  }\n}\n\n//#endregion\n\n//#region \uAE00\uB85C\uBE0C\n\n/**\n * \uAE00\uB85C\uBE0C \uD328\uD134\uC73C\uB85C \uD30C\uC77C \uAC80\uC0C9.\n * @param pattern - \uAE00\uB85C\uBE0C \uD328\uD134 (\uC608: \"**\\/*.ts\")\n * @param options - glob \uC635\uC158\n * @returns \uB9E4\uCE6D\uB41C \uD30C\uC77C\uB4E4\uC758 \uC808\uB300 \uACBD\uB85C \uBC30\uC5F4\n */\nexport function fsGlobSync(pattern: string, options?: GlobOptions): string[] {\n  return globRawSync(pattern.replace(/\\\\/g, \"/\"), options ?? {}).map((item) => path.resolve(item.toString()));\n}\n\n/**\n * \uAE00\uB85C\uBE0C \uD328\uD134\uC73C\uB85C \uD30C\uC77C \uAC80\uC0C9 (\uBE44\uB3D9\uAE30).\n * @param pattern - \uAE00\uB85C\uBE0C \uD328\uD134 (\uC608: \"**\\/*.ts\")\n * @param options - glob \uC635\uC158\n * @returns \uB9E4\uCE6D\uB41C \uD30C\uC77C\uB4E4\uC758 \uC808\uB300 \uACBD\uB85C \uBC30\uC5F4\n */\nexport async function fsGlob(pattern: string, options?: GlobOptions): Promise<string[]> {\n  return (await globRaw(pattern.replace(/\\\\/g, \"/\"), options ?? {})).map((item) => path.resolve(item.toString()));\n}\n\n//#endregion\n\n//#region \uC720\uD2F8\uB9AC\uD2F0\n\n/**\n * \uC9C0\uC815 \uB514\uB809\uD1A0\uB9AC \uD558\uC704\uC758 \uBE48 \uB514\uB809\uD1A0\uB9AC\uB97C \uC7AC\uADC0\uC801\uC73C\uB85C \uD0D0\uC0C9\uD558\uC5EC \uC0AD\uC81C.\n * \uD558\uC704 \uB514\uB809\uD1A0\uB9AC\uAC00 \uBAA8\uB450 \uC0AD\uC81C\uB418\uC5B4 \uBE48 \uB514\uB809\uD1A0\uB9AC\uAC00 \uB41C \uACBD\uC6B0, \uD574\uB2F9 \uB514\uB809\uD1A0\uB9AC\uB3C4 \uC0AD\uC81C \uB300\uC0C1\uC774 \uB428.\n */\nexport async function fsClearEmptyDirectory(dirPath: string): Promise<void> {\n  if (!(await fsExists(dirPath))) return;\n\n  const childNames = await fsReaddir(dirPath);\n  let hasFiles = false;\n\n  for (const childName of childNames) {\n    const childPath = path.resolve(dirPath, childName);\n    if ((await fsLstat(childPath)).isDirectory()) {\n      await fsClearEmptyDirectory(childPath);\n    } else {\n      hasFiles = true;\n    }\n  }\n\n  // \uD30C\uC77C\uC774 \uC788\uC5C8\uB2E4\uBA74 \uC0AD\uC81C \uBD88\uAC00\n  if (hasFiles) return;\n\n  // \uD30C\uC77C\uC774 \uC5C6\uC5C8\uB358 \uACBD\uC6B0\uC5D0\uB9CC \uC7AC\uD655\uC778 (\uD558\uC704 \uB514\uB809\uD1A0\uB9AC\uAC00 \uC0AD\uC81C\uB418\uC5C8\uC744 \uC218 \uC788\uC74C)\n  if ((await fsReaddir(dirPath)).length === 0) {\n    await fsRm(dirPath);\n  }\n}\n\n/**\n * \uC2DC\uC791 \uACBD\uB85C\uBD80\uD130 \uB8E8\uD2B8 \uBC29\uD5A5\uC73C\uB85C \uC0C1\uC704 \uB514\uB809\uD1A0\uB9AC\uB97C \uC21C\uD68C\uD558\uBA70 glob \uD328\uD134 \uAC80\uC0C9.\n * \uAC01 \uB514\uB809\uD1A0\uB9AC\uC5D0\uC11C childGlob \uD328\uD134\uC5D0 \uB9E4\uCE6D\uB418\uB294 \uBAA8\uB4E0 \uD30C\uC77C \uACBD\uB85C\uB97C \uC218\uC9D1.\n * @param childGlob - \uAC01 \uB514\uB809\uD1A0\uB9AC\uC5D0\uC11C \uAC80\uC0C9\uD560 glob \uD328\uD134\n * @param fromPath - \uAC80\uC0C9 \uC2DC\uC791 \uACBD\uB85C\n * @param rootPath - \uAC80\uC0C9 \uC885\uB8CC \uACBD\uB85C (\uBBF8\uC9C0\uC815 \uC2DC \uD30C\uC77C\uC2DC\uC2A4\uD15C \uB8E8\uD2B8\uAE4C\uC9C0).\n *                   **\uC8FC\uC758**: fromPath\uAC00 rootPath\uC758 \uC790\uC2DD \uACBD\uB85C\uC5EC\uC57C \uD568.\n *                   \uADF8\uB807\uC9C0 \uC54A\uC73C\uBA74 \uD30C\uC77C\uC2DC\uC2A4\uD15C \uB8E8\uD2B8\uAE4C\uC9C0 \uAC80\uC0C9\uD568.\n */\nexport function fsFindAllParentChildPathsSync(childGlob: string, fromPath: string, rootPath?: string): string[] {\n  const resultPaths: string[] = [];\n\n  let current = fromPath;\n  while (current) {\n    const potential = path.resolve(current, childGlob);\n    const globResults = fsGlobSync(potential);\n    resultPaths.push(...globResults);\n\n    if (current === rootPath) break;\n\n    const next = path.dirname(current);\n    if (next === current) break;\n    current = next;\n  }\n\n  return resultPaths;\n}\n\n/**\n * \uC2DC\uC791 \uACBD\uB85C\uBD80\uD130 \uB8E8\uD2B8 \uBC29\uD5A5\uC73C\uB85C \uC0C1\uC704 \uB514\uB809\uD1A0\uB9AC\uB97C \uC21C\uD68C\uD558\uBA70 glob \uD328\uD134 \uAC80\uC0C9 (\uBE44\uB3D9\uAE30).\n * \uAC01 \uB514\uB809\uD1A0\uB9AC\uC5D0\uC11C childGlob \uD328\uD134\uC5D0 \uB9E4\uCE6D\uB418\uB294 \uBAA8\uB4E0 \uD30C\uC77C \uACBD\uB85C\uB97C \uC218\uC9D1.\n * @param childGlob - \uAC01 \uB514\uB809\uD1A0\uB9AC\uC5D0\uC11C \uAC80\uC0C9\uD560 glob \uD328\uD134\n * @param fromPath - \uAC80\uC0C9 \uC2DC\uC791 \uACBD\uB85C\n * @param rootPath - \uAC80\uC0C9 \uC885\uB8CC \uACBD\uB85C (\uBBF8\uC9C0\uC815 \uC2DC \uD30C\uC77C\uC2DC\uC2A4\uD15C \uB8E8\uD2B8\uAE4C\uC9C0).\n *                   **\uC8FC\uC758**: fromPath\uAC00 rootPath\uC758 \uC790\uC2DD \uACBD\uB85C\uC5EC\uC57C \uD568.\n *                   \uADF8\uB807\uC9C0 \uC54A\uC73C\uBA74 \uD30C\uC77C\uC2DC\uC2A4\uD15C \uB8E8\uD2B8\uAE4C\uC9C0 \uAC80\uC0C9\uD568.\n */\nexport async function fsFindAllParentChildPaths(\n  childGlob: string,\n  fromPath: string,\n  rootPath?: string,\n): Promise<string[]> {\n  const resultPaths: string[] = [];\n\n  let current = fromPath;\n  while (current) {\n    const potential = path.resolve(current, childGlob);\n    const globResults = await fsGlob(potential);\n    resultPaths.push(...globResults);\n\n    if (current === rootPath) break;\n\n    const next = path.dirname(current);\n    if (next === current) break;\n    current = next;\n  }\n\n  return resultPaths;\n}\n\n//#endregion\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/utils/path.js

@@ -0,0 +1,48 @@
+import path from "path";
+import { ArgumentError } from "@simplysm/core-common";
+const NORM = /* @__PURE__ */ Symbol("NormPath");
+function pathPosix(...args) {
+  const resolvedPath = path.join(...args);
+  return resolvedPath.replace(/\\/g, "/");
+}
+function pathChangeFileDirectory(filePath, fromDirectory, toDirectory) {
+  if (filePath === fromDirectory) {
+    return toDirectory;
+  }
+  if (!pathIsChildPath(filePath, fromDirectory)) {
+    throw new ArgumentError(`'${filePath}'\uAC00 ${fromDirectory} \uC548\uC5D0 \uC5C6\uC2B5\uB2C8\uB2E4.`, { filePath, fromDirectory });
+  }
+  return path.resolve(toDirectory, path.relative(fromDirectory, filePath));
+}
+function pathGetBasenameWithoutExt(filePath) {
+  return path.basename(filePath, path.extname(filePath));
+}
+function pathIsChildPath(childPath, parentPath) {
+  const normalizedChild = pathNorm(childPath);
+  const normalizedParent = pathNorm(parentPath);
+  if (normalizedChild === normalizedParent) {
+    return false;
+  }
+  const parentWithSep = normalizedParent.endsWith(path.sep) ? normalizedParent : normalizedParent + path.sep;
+  return normalizedChild.startsWith(parentWithSep);
+}
+function pathNorm(...paths) {
+  return path.resolve(...paths);
+}
+function pathFilterByTargets(files, targets, cwd) {
+  if (targets.length === 0) return files;
+  const normalizedTargets = targets.map((t) => pathPosix(t));
+  return files.filter((file) => {
+    const relativePath = pathPosix(path.relative(cwd, file));
+    return normalizedTargets.some((target) => relativePath === target || relativePath.startsWith(target + "/"));
+  });
+}
+export {
+  pathChangeFileDirectory,
+  pathFilterByTargets,
+  pathGetBasenameWithoutExt,
+  pathIsChildPath,
+  pathNorm,
+  pathPosix
+};
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/path.ts"],
+  "sourcesContent": ["import path from \"path\";\nimport { ArgumentError } from \"@simplysm/core-common\";\n\n//#region Types\n\nconst NORM = Symbol(\"NormPath\");\n\n/**\n * \uC815\uADDC\uD654\uB41C \uACBD\uB85C\uB97C \uB098\uD0C0\uB0B4\uB294 \uBE0C\uB79C\uB4DC \uD0C0\uC785.\n * pathNorm()\uC744 \uD1B5\uD574\uC11C\uB9CC \uC0DD\uC131 \uAC00\uB2A5.\n */\nexport type NormPath = string & {\n  [NORM]: never;\n};\n\n//#endregion\n\n//#region \uD568\uC218\n\n/**\n * POSIX \uC2A4\uD0C0\uC77C \uACBD\uB85C\uB85C \uBCC0\uD658 (\uBC31\uC2AC\uB798\uC2DC \u2192 \uC2AC\uB798\uC2DC).\n *\n * @example\n * pathPosix(\"C:\\\\Users\\\\test\"); // \"C:/Users/test\"\n * pathPosix(\"src\", \"index.ts\"); // \"src/index.ts\"\n */\nexport function pathPosix(...args: string[]): string {\n  const resolvedPath = path.join(...args);\n  return resolvedPath.replace(/\\\\/g, \"/\");\n}\n\n/**\n * \uD30C\uC77C \uACBD\uB85C\uC758 \uB514\uB809\uD1A0\uB9AC\uB97C \uBCC0\uACBD.\n *\n * @example\n * pathChangeFileDirectory(\"/a/b/c.txt\", \"/a\", \"/x\");\n * // \u2192 \"/x/b/c.txt\"\n *\n * @throws \uD30C\uC77C\uC774 fromDirectory \uC548\uC5D0 \uC5C6\uC73C\uBA74 \uC5D0\uB7EC\n */\nexport function pathChangeFileDirectory(filePath: string, fromDirectory: string, toDirectory: string): string {\n  if (filePath === fromDirectory) {\n    return toDirectory;\n  }\n\n  if (!pathIsChildPath(filePath, fromDirectory)) {\n    throw new ArgumentError(`'${filePath}'\uAC00 ${fromDirectory} \uC548\uC5D0 \uC5C6\uC2B5\uB2C8\uB2E4.`, { filePath, fromDirectory });\n  }\n\n  return path.resolve(toDirectory, path.relative(fromDirectory, filePath));\n}\n\n/**\n * \uD655\uC7A5\uC790\uB97C \uC81C\uAC70\uD55C \uD30C\uC77C\uBA85(basename)\uC744 \uBC18\uD658.\n *\n * @example\n * pathGetBasenameWithoutExt(\"file.txt\"); // \"file\"\n * pathGetBasenameWithoutExt(\"/path/to/file.spec.ts\"); // \"file.spec\"\n */\nexport function pathGetBasenameWithoutExt(filePath: string): string {\n  return path.basename(filePath, path.extname(filePath));\n}\n\n/**\n * childPath\uAC00 parentPath\uC758 \uC790\uC2DD \uACBD\uB85C\uC778\uC9C0 \uD655\uC778.\n * \uAC19\uC740 \uACBD\uB85C\uB294 false \uBC18\uD658.\n *\n * \uACBD\uB85C\uB294 \uB0B4\uBD80\uC801\uC73C\uB85C `pathNorm()`\uC73C\uB85C \uC815\uADDC\uD654\uB41C \uD6C4 \uBE44\uAD50\uB418\uBA70,\n * \uD50C\uB7AB\uD3FC\uBCC4 \uACBD\uB85C \uAD6C\uBD84\uC790(Windows: `\\`, Unix: `/`)\uB97C \uC0AC\uC6A9\uD55C\uB2E4.\n *\n * @example\n * pathIsChildPath(\"/a/b/c\", \"/a/b\"); // true\n * pathIsChildPath(\"/a/b\", \"/a/b/c\"); // false\n * pathIsChildPath(\"/a/b\", \"/a/b\"); // false (\uAC19\uC740 \uACBD\uB85C)\n */\nexport function pathIsChildPath(childPath: string, parentPath: string): boolean {\n  const normalizedChild = pathNorm(childPath);\n  const normalizedParent = pathNorm(parentPath);\n\n  // \uAC19\uC740 \uACBD\uB85C\uBA74 false\n  if (normalizedChild === normalizedParent) {\n    return false;\n  }\n\n  // \uBD80\uBAA8 \uACBD\uB85C + \uAD6C\uBD84\uC790\uB85C \uC2DC\uC791\uD558\uB294\uC9C0 \uD655\uC778\n  const parentWithSep = normalizedParent.endsWith(path.sep) ? normalizedParent : normalizedParent + path.sep;\n\n  return normalizedChild.startsWith(parentWithSep);\n}\n\n/**\n * \uACBD\uB85C\uB97C \uC815\uADDC\uD654\uD558\uC5EC NormPath\uB85C \uBC18\uD658.\n * \uC808\uB300 \uACBD\uB85C\uB85C \uBCC0\uD658\uB418\uBA70, \uD50C\uB7AB\uD3FC\uBCC4 \uAD6C\uBD84\uC790\uB85C \uC815\uADDC\uD654\uB428.\n *\n * @example\n * pathNorm(\"/some/path\"); // NormPath\n * pathNorm(\"relative\", \"path\"); // NormPath (\uC808\uB300 \uACBD\uB85C\uB85C \uBCC0\uD658)\n */\nexport function pathNorm(...paths: string[]): NormPath {\n  return path.resolve(...paths) as NormPath;\n}\n\n/**\n * \uD0C0\uAC9F \uACBD\uB85C \uBAA9\uB85D\uC744 \uAE30\uC900\uC73C\uB85C \uD30C\uC77C\uC744 \uD544\uD130\uB9C1.\n * \uD30C\uC77C\uC774 \uD0C0\uAC9F \uACBD\uB85C\uC640 \uAC19\uAC70\uB098 \uD0C0\uAC9F\uC758 \uC790\uC2DD \uACBD\uB85C\uC77C \uB54C \uD3EC\uD568.\n *\n * @param files - \uD544\uD130\uB9C1\uD560 \uD30C\uC77C \uACBD\uB85C \uBAA9\uB85D.\n *                **\uC8FC\uC758**: cwd \uD558\uC704\uC758 \uC808\uB300 \uACBD\uB85C\uC5EC\uC57C \uD568.\n *                cwd \uC678\uBD80 \uACBD\uB85C\uB294 \uC0C1\uB300 \uACBD\uB85C(../ \uD615\uD0DC)\uB85C \uBCC0\uD658\uB418\uC5B4 \uCC98\uB9AC\uB428.\n * @param targets - \uD0C0\uAC9F \uACBD\uB85C \uBAA9\uB85D (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C, POSIX \uC2A4\uD0C0\uC77C \uAD8C\uC7A5)\n * @param cwd - \uD604\uC7AC \uC791\uC5C5 \uB514\uB809\uD1A0\uB9AC (\uC808\uB300 \uACBD\uB85C)\n * @returns targets\uAC00 \uBE48 \uBC30\uC5F4\uC774\uBA74 files \uADF8\uB300\uB85C, \uC544\uB2C8\uBA74 \uD0C0\uAC9F \uACBD\uB85C \uD558\uC704 \uD30C\uC77C\uB9CC\n *\n * @example\n * const files = [\"/proj/src/a.ts\", \"/proj/src/b.ts\", \"/proj/tests/c.ts\"];\n * pathFilterByTargets(files, [\"src\"], \"/proj\");\n * // \u2192 [\"/proj/src/a.ts\", \"/proj/src/b.ts\"]\n */\nexport function pathFilterByTargets(files: string[], targets: string[], cwd: string): string[] {\n  if (targets.length === 0) return files;\n  const normalizedTargets = targets.map((t) => pathPosix(t));\n  return files.filter((file) => {\n    const relativePath = pathPosix(path.relative(cwd, file));\n    return normalizedTargets.some((target) => relativePath === target || relativePath.startsWith(target + \"/\"));\n  });\n}\n\n//#endregion\n"],
+  "mappings": "AAAA,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAI9B,MAAM,OAAO,uBAAO,UAAU;AAqBvB,SAAS,aAAa,MAAwB;AACnD,QAAM,eAAe,KAAK,KAAK,GAAG,IAAI;AACtC,SAAO,aAAa,QAAQ,OAAO,GAAG;AACxC;AAWO,SAAS,wBAAwB,UAAkB,eAAuB,aAA6B;AAC5G,MAAI,aAAa,eAAe;AAC9B,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,gBAAgB,UAAU,aAAa,GAAG;AAC7C,UAAM,IAAI,cAAc,IAAI,QAAQ,WAAM,aAAa,2CAAa,EAAE,UAAU,cAAc,CAAC;AAAA,EACjG;AAEA,SAAO,KAAK,QAAQ,aAAa,KAAK,SAAS,eAAe,QAAQ,CAAC;AACzE;AASO,SAAS,0BAA0B,UAA0B;AAClE,SAAO,KAAK,SAAS,UAAU,KAAK,QAAQ,QAAQ,CAAC;AACvD;AAcO,SAAS,gBAAgB,WAAmB,YAA6B;AAC9E,QAAM,kBAAkB,SAAS,SAAS;AAC1C,QAAM,mBAAmB,SAAS,UAAU;AAG5C,MAAI,oBAAoB,kBAAkB;AACxC,WAAO;AAAA,EACT;AAGA,QAAM,gBAAgB,iBAAiB,SAAS,KAAK,GAAG,IAAI,mBAAmB,mBAAmB,KAAK;AAEvG,SAAO,gBAAgB,WAAW,aAAa;AACjD;AAUO,SAAS,YAAY,OAA2B;AACrD,SAAO,KAAK,QAAQ,GAAG,KAAK;AAC9B;AAkBO,SAAS,oBAAoB,OAAiB,SAAmB,KAAuB;AAC7F,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,oBAAoB,QAAQ,IAAI,CAAC,MAAM,UAAU,CAAC,CAAC;AACzD,SAAO,MAAM,OAAO,CAAC,SAAS;AAC5B,UAAM,eAAe,UAAU,KAAK,SAAS,KAAK,IAAI,CAAC;AACvD,WAAO,kBAAkB,KAAK,CAAC,WAAW,iBAAiB,UAAU,aAAa,WAAW,SAAS,GAAG,CAAC;AAAA,EAC5G,CAAC;AACH;",
+  "names": []
+}

package/dist/worker/create-worker.js

@@ -0,0 +1,85 @@
+import { parentPort } from "worker_threads";
+import { SdError, transferableDecode, transferableEncode } from "@simplysm/core-common";
+function createWorker(methods) {
+  if (parentPort === null) {
+    throw new SdError("\uC774 \uC2A4\uD06C\uB9BD\uD2B8\uB294 \uC6CC\uCEE4 \uC2A4\uB808\uB4DC\uC5D0\uC11C \uC2E4\uD589\uB418\uC5B4\uC57C \uD569\uB2C8\uB2E4 (parentPort \uD544\uC694).");
+  }
+  const port = parentPort;
+  process.stdout.write = (chunk, encodingOrCallback, callback) => {
+    const body = typeof chunk === "string" ? chunk : new TextDecoder().decode(chunk);
+    const response = { type: "log", body };
+    const serialized = transferableEncode(response);
+    port.postMessage(serialized.result, serialized.transferList);
+    const cb = typeof encodingOrCallback === "function" ? encodingOrCallback : callback;
+    if (cb) {
+      queueMicrotask(() => cb());
+    }
+    return true;
+  };
+  port.on("message", async (serializedRequest) => {
+    const decoded = transferableDecode(serializedRequest);
+    if (decoded == null || typeof decoded !== "object" || !("id" in decoded) || !("method" in decoded) || !("params" in decoded)) {
+      let decodedStr;
+      try {
+        decodedStr = JSON.stringify(decoded);
+      } catch {
+        decodedStr = String(decoded);
+      }
+      const errorResponse = {
+        type: "error",
+        request: { id: "unknown", method: "unknown", params: [] },
+        body: new SdError(`\uD615\uC2DD\uC774 \uC798\uBABB\uB41C \uC6CC\uCEE4 \uC694\uCCAD: ${decodedStr}`)
+      };
+      const serialized = transferableEncode(errorResponse);
+      port.postMessage(serialized.result, serialized.transferList);
+      return;
+    }
+    const request = decoded;
+    const methodFn = methods[request.method];
+    if (methodFn == null) {
+      const response = {
+        request,
+        type: "error",
+        body: new SdError(`\uC54C \uC218 \uC5C6\uB294 \uBA54\uC11C\uB4DC: ${request.method}`)
+      };
+      const serialized = transferableEncode(response);
+      port.postMessage(serialized.result, serialized.transferList);
+      return;
+    }
+    try {
+      const result = await methodFn(...request.params);
+      const response = {
+        request,
+        type: "return",
+        body: result
+      };
+      const serialized = transferableEncode(response);
+      port.postMessage(serialized.result, serialized.transferList);
+    } catch (err) {
+      const response = {
+        request,
+        type: "error",
+        body: err instanceof Error ? err : new Error(String(err))
+      };
+      const serialized = transferableEncode(response);
+      port.postMessage(serialized.result, serialized.transferList);
+    }
+  });
+  return {
+    __methods: methods,
+    __events: {},
+    send(event, data) {
+      const response = {
+        type: "event",
+        event,
+        body: data
+      };
+      const serialized = transferableEncode(response);
+      port.postMessage(serialized.result, serialized.transferList);
+    }
+  };
+}
+export {
+  createWorker
+};
+//# sourceMappingURL=create-worker.js.map