@simplysm/core-node 14.0.6 → 14.0.8

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * as cpx from "./utils/cp";
 export * as fsx from "./utils/fs";
 export * as pathx from "./utils/path";
 export * from "./features/fs-watcher";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 // 유틸리티
+export * as cpx from "./utils/cp.js";
 export * as fsx from "./utils/fs.js";
 export * as pathx from "./utils/path.js";
 // 기능

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,KAAK;AACL,cAAc,uBAAuB,CAAC;AAEtC,KAAK;AACL,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,KAAK;AACL,cAAc,uBAAuB,CAAC;AAEtC,KAAK;AACL,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}

package/dist/utils/cp.d.ts

@@ -0,0 +1,30 @@
+import type { ChildProcess } from "child_process";
+export declare function codePageToEncoding(codePage: number): string;
+export declare function resetEncodingCache(): void;
+export declare function getSystemEncoding(): string;
+export interface ExecOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    stdio?: "pipe" | "inherit";
+    shell?: boolean;
+    reject?: boolean;
+}
+export type ExecSyncOptions = Omit<ExecOptions, "reject">;
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare function decodeBytes(raw: Uint8Array, systemEncoding?: string): string;
+export declare class ExecProcess implements PromiseLike<ExecResult> {
+    private readonly _process;
+    private readonly _promise;
+    constructor(cp: ChildProcess, promise: Promise<ExecResult>);
+    get pid(): number | undefined;
+    then<TResult1 = ExecResult, TResult2 = never>(onfulfilled?: ((value: ExecResult) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<ExecResult | TResult>;
+    kill(signal?: NodeJS.Signals | number): boolean;
+}
+export declare function exec(cmd: string, args: string[], options?: ExecOptions): ExecProcess;
+export declare function execSync(cmd: string, args: string[], options?: ExecSyncOptions): ExecResult;
+//# sourceMappingURL=cp.d.ts.map

package/dist/utils/cp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cp.d.ts","sourceRoot":"","sources":["..\\..\\src\\utils\\cp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAkBlD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CA2B1C;AAID,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5E;AAMD,qBAAa,WAAY,YAAW,WAAW,CAAC,UAAU,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAEnC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC;IAK1D,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAED,IAAI,CAAC,QAAQ,GAAG,UAAU,EAAE,QAAQ,GAAG,KAAK,EAC1C,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EAC9E,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAC1E,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAI/B,KAAK,CAAC,OAAO,GAAG,KAAK,EACnB,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GACxE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC;IAIhC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,GAAG,OAAO;CAGhD;AAMD,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,CAiDpF;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,UAAU,CAkB3F"}

package/dist/utils/cp.js

@@ -0,0 +1,149 @@
+import { execSync as cpExecSync, spawn as cpSpawn, spawnSync as cpSpawnSync } from "child_process";
+import { bytes } from "@simplysm/core-common";
+const CODE_PAGE_MAP = {
+    65001: "utf-8",
+    949: "euc-kr",
+    932: "shift-jis",
+    936: "gbk",
+    950: "big5",
+    1252: "windows-1252",
+    1251: "windows-1251",
+    1250: "windows-1250",
+    874: "windows-874",
+};
+let _cachedEncoding;
+export function codePageToEncoding(codePage) {
+    return CODE_PAGE_MAP[codePage] ?? "utf-8";
+}
+export function resetEncodingCache() {
+    _cachedEncoding = undefined;
+}
+export function getSystemEncoding() {
+    if (_cachedEncoding != null)
+        return _cachedEncoding;
+    try {
+        if (process.platform === "win32") {
+            const output = cpExecSync("chcp", { encoding: "utf-8" });
+            const match = output.match(/\d+/);
+            if (match) {
+                _cachedEncoding = codePageToEncoding(Number(match[0]));
+                return _cachedEncoding;
+            }
+        }
+        else {
+            const lang = process.env["LANG"] ?? process.env["LC_ALL"] ?? "";
+            const dotIndex = lang.indexOf(".");
+            if (dotIndex >= 0) {
+                let encoding = lang.slice(dotIndex + 1).split("@")[0].toLowerCase();
+                if (encoding === "utf8")
+                    encoding = "utf-8";
+                _cachedEncoding = encoding;
+                return _cachedEncoding;
+            }
+        }
+    }
+    catch {
+        // 감지 실패 시 fallback
+    }
+    _cachedEncoding = "utf-8";
+    return _cachedEncoding;
+}
+//#endregion
+//#region decodeBytes
+export function decodeBytes(raw, systemEncoding) {
+    const encoding = systemEncoding ?? getSystemEncoding();
+    if (encoding === "utf-8") {
+        return new TextDecoder("utf-8").decode(raw);
+    }
+    try {
+        return new TextDecoder("utf-8", { fatal: true }).decode(raw);
+    }
+    catch {
+        return new TextDecoder(encoding).decode(raw);
+    }
+}
+//#endregion
+//#region ExecProcess
+export class ExecProcess {
+    _process;
+    _promise;
+    constructor(cp, promise) {
+        this._process = cp;
+        this._promise = promise;
+    }
+    get pid() {
+        return this._process.pid;
+    }
+    then(onfulfilled, onrejected) {
+        return this._promise.then(onfulfilled, onrejected);
+    }
+    catch(onrejected) {
+        return this._promise.catch(onrejected);
+    }
+    kill(signal) {
+        return this._process.kill(signal);
+    }
+}
+//#endregion
+//#region exec / execSync
+export function exec(cmd, args, options) {
+    const isInherit = options?.stdio === "inherit";
+    const cp = cpSpawn(cmd, args, {
+        cwd: options?.cwd,
+        env: options?.env != null ? { ...process.env, ...options.env } : undefined,
+        stdio: isInherit ? "inherit" : "pipe",
+        shell: options?.shell ?? false,
+    });
+    const promise = new Promise((resolve, reject) => {
+        cp.on("error", (err) => {
+            reject(Object.assign(err, { stdout: "", stderr: "", exitCode: 1 }));
+        });
+        if (isInherit) {
+            cp.on("close", (code, signal) => {
+                const exitCode = code ?? (signal != null ? 1 : 0);
+                const result = { stdout: "", stderr: "", exitCode };
+                if (exitCode !== 0 && options.reject !== false) {
+                    reject(Object.assign(new Error(`Command failed: ${cmd} ${args.join(" ")}`), result));
+                }
+                else {
+                    resolve(result);
+                }
+            });
+            return;
+        }
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        cp.stdout.on("data", (chunk) => stdoutChunks.push(chunk));
+        cp.stderr.on("data", (chunk) => stderrChunks.push(chunk));
+        cp.on("close", (code, signal) => {
+            const exitCode = code ?? (signal != null ? 1 : 0);
+            const stdout = decodeBytes(bytes.concat(stdoutChunks));
+            const stderr = decodeBytes(bytes.concat(stderrChunks));
+            const result = { stdout, stderr, exitCode };
+            if (exitCode !== 0 && options?.reject !== false) {
+                reject(Object.assign(new Error(`Command failed: ${cmd} ${args.join(" ")}`), result));
+            }
+            else {
+                resolve(result);
+            }
+        });
+    });
+    return new ExecProcess(cp, promise);
+}
+export function execSync(cmd, args, options) {
+    const isInherit = options?.stdio === "inherit";
+    const result = cpSpawnSync(cmd, args, {
+        cwd: options?.cwd,
+        env: options?.env != null ? { ...process.env, ...options.env } : undefined,
+        stdio: isInherit ? "inherit" : "pipe",
+        shell: options?.shell ?? false,
+    });
+    if (isInherit) {
+        return { stdout: "", stderr: "", exitCode: result.status ?? 0 };
+    }
+    const stdout = decodeBytes(result.stdout);
+    const stderr = decodeBytes(result.stderr);
+    return { stdout, stderr, exitCode: result.status ?? 0 };
+}
+//#endregion
+//# sourceMappingURL=cp.js.map

package/dist/utils/cp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cp.js","sourceRoot":"","sources":["..\\..\\src\\utils\\cp.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/core-node",
-  "version": "14.0.6",
+  "version": "14.0.8",
   "description": "심플리즘 패키지 - 코어 (node)",
   "author": "심플리즘",
   "license": "Apache-2.0",
@@ -25,7 +25,7 @@
     "glob": "^13.0.6",
     "minimatch": "^10.2.4",
     "tsx": "^4.21.0",
-    "@simplysm/core-common": "14.0.6"
+    "@simplysm/core-common": "14.0.8"
   },
   "devDependencies": {
     "@types/node": "^20.19.37"

package/src/index.ts

@@ -1,4 +1,5 @@
 // 유틸리티
+export * as cpx from "./utils/cp";
 export * as fsx from "./utils/fs";
 export * as pathx from "./utils/path";
 

package/src/utils/cp.ts

@@ -0,0 +1,202 @@
+import type { ChildProcess } from "child_process";
+import { execSync as cpExecSync, spawn as cpSpawn, spawnSync as cpSpawnSync } from "child_process";
+import { bytes } from "@simplysm/core-common";
+
+const CODE_PAGE_MAP: Record<number, string> = {
+  65001: "utf-8",
+  949: "euc-kr",
+  932: "shift-jis",
+  936: "gbk",
+  950: "big5",
+  1252: "windows-1252",
+  1251: "windows-1251",
+  1250: "windows-1250",
+  874: "windows-874",
+};
+
+let _cachedEncoding: string | undefined;
+
+export function codePageToEncoding(codePage: number): string {
+  return CODE_PAGE_MAP[codePage] ?? "utf-8";
+}
+
+export function resetEncodingCache(): void {
+  _cachedEncoding = undefined;
+}
+
+export function getSystemEncoding(): string {
+  if (_cachedEncoding != null) return _cachedEncoding;
+
+  try {
+    if (process.platform === "win32") {
+      const output = cpExecSync("chcp", { encoding: "utf-8" });
+      const match = output.match(/\d+/);
+      if (match) {
+        _cachedEncoding = codePageToEncoding(Number(match[0]));
+        return _cachedEncoding;
+      }
+    } else {
+      const lang = process.env["LANG"] ?? process.env["LC_ALL"] ?? "";
+      const dotIndex = lang.indexOf(".");
+      if (dotIndex >= 0) {
+        let encoding = lang.slice(dotIndex + 1).split("@")[0].toLowerCase();
+        if (encoding === "utf8") encoding = "utf-8";
+        _cachedEncoding = encoding;
+        return _cachedEncoding;
+      }
+    }
+  } catch {
+    // 감지 실패 시 fallback
+  }
+
+  _cachedEncoding = "utf-8";
+  return _cachedEncoding;
+}
+
+//#region exec types
+
+export interface ExecOptions {
+  cwd?: string;
+  env?: Record<string, string>;
+  stdio?: "pipe" | "inherit";
+  shell?: boolean;
+  reject?: boolean;
+}
+
+export type ExecSyncOptions = Omit<ExecOptions, "reject">;
+
+export interface ExecResult {
+  stdout: string;
+  stderr: string;
+  exitCode: number;
+}
+
+//#endregion
+
+//#region decodeBytes
+
+export function decodeBytes(raw: Uint8Array, systemEncoding?: string): string {
+  const encoding = systemEncoding ?? getSystemEncoding();
+
+  if (encoding === "utf-8") {
+    return new TextDecoder("utf-8").decode(raw);
+  }
+
+  try {
+    return new TextDecoder("utf-8", { fatal: true }).decode(raw);
+  } catch {
+    return new TextDecoder(encoding).decode(raw);
+  }
+}
+
+//#endregion
+
+//#region ExecProcess
+
+export class ExecProcess implements PromiseLike<ExecResult> {
+  private readonly _process: ChildProcess;
+  private readonly _promise: Promise<ExecResult>;
+
+  constructor(cp: ChildProcess, promise: Promise<ExecResult>) {
+    this._process = cp;
+    this._promise = promise;
+  }
+
+  get pid(): number | undefined {
+    return this._process.pid;
+  }
+
+  then<TResult1 = ExecResult, TResult2 = never>(
+    onfulfilled?: ((value: ExecResult) => TResult1 | PromiseLike<TResult1>) | null,
+    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,
+  ): Promise<TResult1 | TResult2> {
+    return this._promise.then(onfulfilled, onrejected);
+  }
+
+  catch<TResult = never>(
+    onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null,
+  ): Promise<ExecResult | TResult> {
+    return this._promise.catch(onrejected);
+  }
+
+  kill(signal?: NodeJS.Signals | number): boolean {
+    return this._process.kill(signal);
+  }
+}
+
+//#endregion
+
+//#region exec / execSync
+
+export function exec(cmd: string, args: string[], options?: ExecOptions): ExecProcess {
+  const isInherit = options?.stdio === "inherit";
+
+  const cp = cpSpawn(cmd, args, {
+    cwd: options?.cwd,
+    env: options?.env != null ? { ...process.env, ...options.env } : undefined,
+    stdio: isInherit ? "inherit" : "pipe",
+    shell: options?.shell ?? false,
+  });
+
+  const promise = new Promise<ExecResult>((resolve, reject) => {
+    cp.on("error", (err) => {
+      reject(Object.assign(err, { stdout: "", stderr: "", exitCode: 1 }));
+    });
+
+    if (isInherit) {
+      cp.on("close", (code, signal) => {
+        const exitCode = code ?? (signal != null ? 1 : 0);
+        const result: ExecResult = { stdout: "", stderr: "", exitCode };
+        if (exitCode !== 0 && options.reject !== false) {
+          reject(Object.assign(new Error(`Command failed: ${cmd} ${args.join(" ")}`), result));
+        } else {
+          resolve(result);
+        }
+      });
+      return;
+    }
+
+    const stdoutChunks: Uint8Array[] = [];
+    const stderrChunks: Uint8Array[] = [];
+
+    cp.stdout!.on("data", (chunk: Uint8Array) => stdoutChunks.push(chunk));
+    cp.stderr!.on("data", (chunk: Uint8Array) => stderrChunks.push(chunk));
+
+    cp.on("close", (code, signal) => {
+      const exitCode = code ?? (signal != null ? 1 : 0);
+      const stdout = decodeBytes(bytes.concat(stdoutChunks));
+      const stderr = decodeBytes(bytes.concat(stderrChunks));
+      const result: ExecResult = { stdout, stderr, exitCode };
+
+      if (exitCode !== 0 && options?.reject !== false) {
+        reject(Object.assign(new Error(`Command failed: ${cmd} ${args.join(" ")}`), result));
+      } else {
+        resolve(result);
+      }
+    });
+  });
+
+  return new ExecProcess(cp, promise);
+}
+
+export function execSync(cmd: string, args: string[], options?: ExecSyncOptions): ExecResult {
+  const isInherit = options?.stdio === "inherit";
+
+  const result = cpSpawnSync(cmd, args, {
+    cwd: options?.cwd,
+    env: options?.env != null ? { ...process.env, ...options.env } : undefined,
+    stdio: isInherit ? "inherit" : "pipe",
+    shell: options?.shell ?? false,
+  });
+
+  if (isInherit) {
+    return { stdout: "", stderr: "", exitCode: result.status ?? 0 };
+  }
+
+  const stdout = decodeBytes(result.stdout as Uint8Array);
+  const stderr = decodeBytes(result.stderr as Uint8Array);
+
+  return { stdout, stderr, exitCode: result.status ?? 0 };
+}
+
+//#endregion