@xgsd/workers 0.1.0-beta.0 → 0.1.0-beta.1

package/dist/{chunk-QLD3WJX5.js → chunk-XFMQAJZM.js}

@@ -5,6 +5,16 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
+// src/types.ts
+var WorkerErrorCode = /* @__PURE__ */ ((WorkerErrorCode2) => {
+  WorkerErrorCode2["CODE_WORKER_GUARD"] = "CODE_WORKER_GUARD";
+  WorkerErrorCode2["CODE_INVALID_ENTRY_FILE"] = "CODE_INVALID_ENTRY_FILE";
+  WorkerErrorCode2["CODE_INVALID_DEFAULT_FUNCTION"] = "CODE_INVALID_DEFAULT_FUNCTION";
+  WorkerErrorCode2["CODE_INVALID_MIDDLEWARE_FUNCTION"] = "CODE_INVALID_MIDDLEWARE_FUNCTION";
+  WorkerErrorCode2["CODE_BUNDLE_ERROR"] = "CODE_BUNDLE_ERROR";
+  return WorkerErrorCode2;
+})(WorkerErrorCode || {});
+
 // src/util/fs.ts
 import { readFileSync, writeFileSync, mkdirSync } from "fs";
 import { writeFile, readFile, constants, access, mkdir } from "fs/promises";
@@ -36,10 +46,11 @@ function pathExistsSync(path) {
 }
 
 export {
+  WorkerErrorCode,
   pathExists,
   ensureDir,
   readJsonSync,
   writeJsonSync,
   pathExistsSync
 };
-//# sourceMappingURL=chunk-QLD3WJX5.js.map
+//# sourceMappingURL=chunk-XFMQAJZM.js.map

package/dist/chunk-XFMQAJZM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/util/fs.ts"],"sourcesContent":["export enum WorkerErrorCode {\n  // thrown when limits exceeded (ttl/memory)\n  CODE_WORKER_GUARD = 'CODE_WORKER_GUARD',\n\n  // thrown when entry file is invalid/cannot be parsed\n  CODE_INVALID_ENTRY_FILE = 'CODE_INVALID_ENTRY_FILE',\n\n  // thrown when default is not a function\n  CODE_INVALID_DEFAULT_FUNCTION = 'CODE_INVALID_DEFAULT_FUNCTION',\n\n  CODE_INVALID_MIDDLEWARE_FUNCTION = 'CODE_INVALID_MIDDLEWARE_FUNCTION',\n\n  // thrown when bundling fails\n  CODE_BUNDLE_ERROR = 'CODE_BUNDLE_ERROR',\n}\n\nexport type WorkerErrorType = 'user' | 'system' | 'unknown'\nexport type WorkerError = {\n  code?: WorkerErrorCode\n  message?: string\n  type?: WorkerErrorType\n}\n\nexport type WorkerResult<T> =\n  | {\n      version: 'v1'\n      ok: true\n      code?: number\n      result: T\n      error: null\n      duration: number\n    }\n  | {\n      version: 'v1'\n      ok: false\n      code?: number\n      result: null\n      error: WorkerError\n      duration: number\n    }\n\nexport type WorkerConfig = {\n  entry: string\n  dist?: string\n  bundler?: {\n    enabled?: boolean\n    cache?: {\n      strategy: 'never'\n    }\n  }\n  http?: {\n    enabled?: boolean\n  }\n  limits?: {\n    ttl?: number\n    memory?: number\n  }\n}\n\nexport type WorkerContext<T = unknown> = WorkerConfig & {\n  id?: string\n  data: T\n  cwd: string\n  result?: any\n  error?: any\n  code?: number\n  env?: Record<string, any>\n  pid?: number\n}\n","import {readFileSync, writeFileSync, mkdirSync} from 'fs'\nimport {writeFile, readFile, constants, access, mkdir} from 'fs/promises'\nimport {dirname} from 'path'\n\nexport async function pathExists(path: string): Promise<boolean> {\n  try {\n    await access(path, constants.F_OK)\n    return true\n  } catch {\n    return false\n  }\n}\n\n// ensureDir\nexport async function ensureDir(path: string): Promise<void> {\n  await mkdir(path, {recursive: true})\n}\n\n// ensureDirSync\nexport function ensureDirSync(path: string): void {\n  mkdirSync(path, {recursive: true})\n}\n\n// ensurePath\n// Ensures parent directory exists for a file path\nexport async function ensurePath(path: string): Promise<void> {\n  await mkdir(dirname(path), {recursive: true})\n}\n\n// ensurePathSync\nexport function ensurePathSync(path: string): void {\n  mkdirSync(dirname(path), {recursive: true})\n}\n\nexport async function readJson<T = any>(path: string): Promise<T> {\n  const content = await readFile(path, 'utf8')\n  return JSON.parse(content)\n}\n\nexport function readJsonSync<T = any>(path: string): T {\n  return JSON.parse(readFileSync(path, 'utf8'))\n}\n\nexport async function writeJson(path: string, data: unknown, pretty = true): Promise<void> {\n  const json = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data)\n\n  await writeFile(path, json, 'utf8')\n}\n\nexport function writeJsonSync(path: string, data: unknown, pretty = true): void {\n  const json = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data)\n\n  writeFileSync(path, json, 'utf8')\n}\n\nexport function pathExistsSync(path: string): boolean {\n  try {\n    require('fs').accessSync(path, constants.F_OK)\n    return true\n  } catch {\n    return false\n  }\n}\n"],"mappings":";;;;;;;;AAAO,IAAK,kBAAL,kBAAKA,qBAAL;AAEL,EAAAA,iBAAA,uBAAoB;AAGpB,EAAAA,iBAAA,6BAA0B;AAG1B,EAAAA,iBAAA,mCAAgC;AAEhC,EAAAA,iBAAA,sCAAmC;AAGnC,EAAAA,iBAAA,uBAAoB;AAbV,SAAAA;AAAA,GAAA;;;ACAZ,SAAQ,cAAc,eAAe,iBAAgB;AACrD,SAAQ,WAAW,UAAU,WAAW,QAAQ,aAAY;AAG5D,eAAsB,WAAW,MAAgC;AAC/D,MAAI;AACF,UAAM,OAAO,MAAM,UAAU,IAAI;AACjC,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,eAAsB,UAAU,MAA6B;AAC3D,QAAM,MAAM,MAAM,EAAC,WAAW,KAAI,CAAC;AACrC;AAuBO,SAAS,aAAsB,MAAiB;AACrD,SAAO,KAAK,MAAM,aAAa,MAAM,MAAM,CAAC;AAC9C;AAQO,SAAS,cAAc,MAAc,MAAe,SAAS,MAAY;AAC9E,QAAM,OAAO,SAAS,KAAK,UAAU,MAAM,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI;AAEzE,gBAAc,MAAM,MAAM,MAAM;AAClC;AAEO,SAAS,eAAe,MAAuB;AACpD,MAAI;AACF,cAAQ,IAAI,EAAE,WAAW,MAAM,UAAU,IAAI;AAC7C,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":["WorkerErrorCode"]}

package/dist/index.cjs

@@ -20,13 +20,27 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  createHandler: () => createHandler
+  WorkerErrorCode: () => WorkerErrorCode,
+  createHandler: () => createHandler,
+  runWorker: () => runWorker
 });
 module.exports = __toCommonJS(src_exports);
 
 // src/worker.ts
 var import_child_process = require("child_process");
 var import_path = require("path");
+
+// src/types.ts
+var WorkerErrorCode = /* @__PURE__ */ ((WorkerErrorCode2) => {
+  WorkerErrorCode2["CODE_WORKER_GUARD"] = "CODE_WORKER_GUARD";
+  WorkerErrorCode2["CODE_INVALID_ENTRY_FILE"] = "CODE_INVALID_ENTRY_FILE";
+  WorkerErrorCode2["CODE_INVALID_DEFAULT_FUNCTION"] = "CODE_INVALID_DEFAULT_FUNCTION";
+  WorkerErrorCode2["CODE_INVALID_MIDDLEWARE_FUNCTION"] = "CODE_INVALID_MIDDLEWARE_FUNCTION";
+  WorkerErrorCode2["CODE_BUNDLE_ERROR"] = "CODE_BUNDLE_ERROR";
+  return WorkerErrorCode2;
+})(WorkerErrorCode || {});
+
+// src/worker.ts
 var import_fs = require("fs");
 
 // src/util/fs.ts
@@ -206,6 +220,8 @@ function createHandler(config) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createHandler
+  WorkerErrorCode,
+  createHandler,
+  runWorker
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/worker.ts","../src/util/fs.ts"],"sourcesContent":["import {WorkerResult, WorkerConfig} from './types'\nimport {runWorker} from './worker'\n\nexport type Activation<T = unknown> = {\n  id?: string\n  data?: T\n  env?: Record<string, unknown>\n  cwd: string\n}\n\nexport type ActivationHandler = <T = unknown>(activation: Activation<T>) => Promise<WorkerResult<T>>\n\nexport function createHandler(config: WorkerConfig): ActivationHandler {\n  return async function handler(activation) {\n    return runWorker({\n      ...config,\n      id: activation.id,\n      cwd: activation.cwd,\n      data: activation.data,\n      env: activation.env,\n    })\n  }\n}\n","import {fork} from 'child_process'\nimport {join} from 'path'\nimport {WorkerContext, WorkerError, WorkerErrorCode, WorkerResult} from './types.js'\nimport {createWriteStream, appendFileSync} from 'fs'\nimport {ensureDir} from './util/fs.js'\nimport {randomUUID} from 'crypto'\n\nexport function startWorkerGuard(\n  child: any,\n  opts: {\n    ttl?: number\n    memory?: number\n  },\n  suspended?: (reason: string) => void,\n) {\n  const {ttl = 5000, memory = 128} = opts\n\n  let ttlTimer: NodeJS.Timeout | null = null\n  let killed = false\n\n  const kill = (reason: string) => {\n    if (killed) return\n    killed = true\n\n    if (ttlTimer) clearTimeout(ttlTimer)\n\n    child.kill('SIGKILL')\n    suspended?.(reason)\n  }\n\n  // TTL watchdog\n  ttlTimer = setTimeout(() => {\n    kill(`ttl exceeded limit (limit: ${ttl.toFixed(2)}ms)`)\n  }, ttl)\n\n  child.on('message', (msg: any) => {\n    if (msg.type !== 'ALIVE') {\n      return\n    }\n\n    // (v0.1.0) this isn't set in stone\n    // may be worth using RSS\n    const heapUsed = msg.memory?.heapUsed ?? 0\n    const memMB = heapUsed / 1024 / 1024\n\n    if (memMB > memory) {\n      kill(`memory limit exceeded: ${memMB.toFixed(2)}MB/${memory.toFixed(2)}MB`)\n    }\n  })\n\n  child.on('exit', () => {\n    if (ttlTimer) clearTimeout(ttlTimer)\n  })\n}\n\ntype ChildMessage<T> =\n  | {type: 'ALIVE'; error: undefined; result: undefined}\n  | {type: 'DONE'; result: WorkerResult<T>; error: undefined | null}\n  | {type: 'ERROR'; result: undefined | null; error: WorkerError}\n\nexport function normaliseKeys(value: any): any {\n  if (Array.isArray(value)) {\n    return value.map(normaliseKeys)\n  }\n\n  if (value && typeof value === 'object' && value.constructor === Object) {\n    const sorted: Record<string, any> = {}\n\n    for (const key of Object.keys(value).sort()) {\n      sorted[key] = normaliseKeys(value[key])\n    }\n\n    return sorted\n  }\n\n  return value\n}\n\nexport function formatWorkerResult(opts: {result?: any; error?: any; duration: number}): WorkerResult<any> {\n  return {\n    version: 'v1',\n    ok: !opts.error,\n    result: opts.result ?? null,\n    error: opts.error ?? null,\n    duration: opts.duration,\n  }\n}\n\nexport async function runWorker<T>(context: WorkerContext): Promise<WorkerResult<T>> {\n  return new Promise(async (resolve, reject) => {\n    const id = randomUUID()\n\n    const ctx = {...context, id}\n    const start = performance.now()\n\n    const path = join(ctx.cwd!, ctx.dist ?? '.xgsd')\n    await ensureDir(path)\n\n    let started = false\n    let completed = false\n    let res: WorkerResult<unknown>\n\n    const contextStr = JSON.stringify(ctx)\n\n    // TODO: remove hardcoded worker path\n    const child = fork(join(__dirname, 'process', 'workers.process.js'), {\n      stdio: ['inherit', 'pipe', 'pipe', 'ipc'],\n      //execArgv: [`--max-old-space-size=${ctx.limits?.memory ?? 128}`],\n      env: {\n        ...ctx.env,\n        XGSD_CTX: contextStr,\n      },\n    })\n\n    const events = createWriteStream(join(path, 'events.jsonl'), {flags: 'a'})\n\n    const startGuard = () => {\n      startWorkerGuard(child, ctx.limits ?? {}, (reason: string) => {\n        if (completed) return\n\n        // normalise system/watch dog error\n        // then *reject*\n        const err: WorkerError = {\n          code: WorkerErrorCode.CODE_WORKER_GUARD,\n          message: `${reason}`,\n          type: 'system',\n        }\n\n        console.warn(`[guard] worker suspended (reason: ${reason})`)\n\n        writeEvent({\n          type: 'error',\n          message: err.message,\n          guard: true,\n          timestamp: Date.now(),\n        })\n\n        cleanup()\n\n        resolve(formatWorkerResult({error: err, duration: performance.now() - start}))\n      })\n    }\n\n    const cleanup = () => {\n      if (child.connected) {\n        child.removeAllListeners('message')\n\n        child.disconnect()\n      }\n    }\n\n    const writeEvent = (data: any) => {\n      const normalised = normaliseKeys(data)\n      events.write(JSON.stringify({...normalised, id}) + '\\n')\n    }\n\n    child.stdout?.on('data', (chunk) => {\n      const lines = chunk.toString().split('\\n').filter(Boolean)\n\n      for (const line of lines) {\n        // log child process messages (typically from usercode)\n        console.log(`${line}`)\n\n        try {\n          writeEvent(JSON.parse(line))\n        } catch {\n          // optionally fallback for non-json logs\n          writeEvent({\n            type: 'log',\n            message: line,\n            timestamp: Date.now(),\n          })\n        }\n      }\n    })\n\n    child.stderr?.on('data', (chunk) => {\n      const e = {type: 'error', message: chunk.toString(), timestamp: Date.now()}\n      console.error(e.message)\n      writeEvent(e)\n    })\n\n    child.on('message', (msg: ChildMessage<unknown>) => {\n      if (msg.type !== 'ALIVE' && msg.type !== 'DONE' && msg.type !== 'ERROR') return\n\n      if (msg.type === 'ALIVE') {\n        if (!started) {\n          started = true\n          startGuard()\n        }\n        return\n      }\n\n      if (msg.type === 'ERROR') {\n        const {error} = msg\n\n        res = formatWorkerResult({error, duration: performance.now() - start})\n      }\n\n      if (msg.type === 'DONE') {\n        // do something with result\n        res = msg.result\n      }\n\n      res.duration = performance.now() - start\n\n      // log activation\n      appendFileSync(\n        join(path, 'activations.jsonl'),\n        JSON.stringify({\n          id,\n          ok: res.ok,\n          code: res.code,\n          duration: res.duration,\n          error: res.error?.code ?? res.error?.message,\n          result: res.result !== null,\n          timestamp: new Date().toISOString(),\n        }) + '\\n',\n      )\n\n      completed = true\n\n      resolve(res as any)\n      cleanup()\n    })\n  })\n}\n","import {readFileSync, writeFileSync, mkdirSync} from 'fs'\nimport {writeFile, readFile, constants, access, mkdir} from 'fs/promises'\nimport {dirname} from 'path'\n\nexport async function pathExists(path: string): Promise<boolean> {\n  try {\n    await access(path, constants.F_OK)\n    return true\n  } catch {\n    return false\n  }\n}\n\n// ensureDir\nexport async function ensureDir(path: string): Promise<void> {\n  await mkdir(path, {recursive: true})\n}\n\n// ensureDirSync\nexport function ensureDirSync(path: string): void {\n  mkdirSync(path, {recursive: true})\n}\n\n// ensurePath\n// Ensures parent directory exists for a file path\nexport async function ensurePath(path: string): Promise<void> {\n  await mkdir(dirname(path), {recursive: true})\n}\n\n// ensurePathSync\nexport function ensurePathSync(path: string): void {\n  mkdirSync(dirname(path), {recursive: true})\n}\n\nexport async function readJson<T = any>(path: string): Promise<T> {\n  const content = await readFile(path, 'utf8')\n  return JSON.parse(content)\n}\n\nexport function readJsonSync<T = any>(path: string): T {\n  return JSON.parse(readFileSync(path, 'utf8'))\n}\n\nexport async function writeJson(path: string, data: unknown, pretty = true): Promise<void> {\n  const json = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data)\n\n  await writeFile(path, json, 'utf8')\n}\n\nexport function writeJsonSync(path: string, data: unknown, pretty = true): void {\n  const json = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data)\n\n  writeFileSync(path, json, 'utf8')\n}\n\nexport function pathExistsSync(path: string): boolean {\n  try {\n    require('fs').accessSync(path, constants.F_OK)\n    return true\n  } catch {\n    return false\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/worker.ts","../src/types.ts","../src/util/fs.ts"],"sourcesContent":["import {WorkerResult, WorkerConfig} from './types.js'\nimport {runWorker} from './worker.js'\n\nexport {runWorker}\nexport * from './types.js'\n\nexport type Activation<T = unknown> = {\n  id?: string\n  data?: T\n  env?: Record<string, unknown>\n  cwd: string\n}\n\nexport type ActivationHandler = <T = unknown>(activation: Activation<T>) => Promise<WorkerResult<T>>\n\nexport function createHandler(config: WorkerConfig): ActivationHandler {\n  return async function handler(activation) {\n    return runWorker({\n      ...config,\n      id: activation.id,\n      cwd: activation.cwd,\n      data: activation.data,\n      env: activation.env,\n    })\n  }\n}\n","import {fork} from 'child_process'\nimport {join} from 'path'\nimport {WorkerContext, WorkerError, WorkerErrorCode, WorkerResult} from './types.js'\nimport {createWriteStream, appendFileSync} from 'fs'\nimport {ensureDir} from './util/fs.js'\nimport {randomUUID} from 'crypto'\n\nexport function startWorkerGuard(\n  child: any,\n  opts: {\n    ttl?: number\n    memory?: number\n  },\n  suspended?: (reason: string) => void,\n) {\n  const {ttl = 5000, memory = 128} = opts\n\n  let ttlTimer: NodeJS.Timeout | null = null\n  let killed = false\n\n  const kill = (reason: string) => {\n    if (killed) return\n    killed = true\n\n    if (ttlTimer) clearTimeout(ttlTimer)\n\n    child.kill('SIGKILL')\n    suspended?.(reason)\n  }\n\n  // TTL watchdog\n  ttlTimer = setTimeout(() => {\n    kill(`ttl exceeded limit (limit: ${ttl.toFixed(2)}ms)`)\n  }, ttl)\n\n  child.on('message', (msg: any) => {\n    if (msg.type !== 'ALIVE') {\n      return\n    }\n\n    // (v0.1.0) this isn't set in stone\n    // may be worth using RSS\n    const heapUsed = msg.memory?.heapUsed ?? 0\n    const memMB = heapUsed / 1024 / 1024\n\n    if (memMB > memory) {\n      kill(`memory limit exceeded: ${memMB.toFixed(2)}MB/${memory.toFixed(2)}MB`)\n    }\n  })\n\n  child.on('exit', () => {\n    if (ttlTimer) clearTimeout(ttlTimer)\n  })\n}\n\ntype ChildMessage<T> =\n  | {type: 'ALIVE'; error: undefined; result: undefined}\n  | {type: 'DONE'; result: WorkerResult<T>; error: undefined | null}\n  | {type: 'ERROR'; result: undefined | null; error: WorkerError}\n\nexport function normaliseKeys(value: any): any {\n  if (Array.isArray(value)) {\n    return value.map(normaliseKeys)\n  }\n\n  if (value && typeof value === 'object' && value.constructor === Object) {\n    const sorted: Record<string, any> = {}\n\n    for (const key of Object.keys(value).sort()) {\n      sorted[key] = normaliseKeys(value[key])\n    }\n\n    return sorted\n  }\n\n  return value\n}\n\nexport function formatWorkerResult(opts: {result?: any; error?: any; duration: number}): WorkerResult<any> {\n  return {\n    version: 'v1',\n    ok: !opts.error,\n    result: opts.result ?? null,\n    error: opts.error ?? null,\n    duration: opts.duration,\n  }\n}\n\nexport async function runWorker<T>(context: WorkerContext): Promise<WorkerResult<T>> {\n  return new Promise(async (resolve, reject) => {\n    const id = randomUUID()\n\n    const ctx = {...context, id}\n    const start = performance.now()\n\n    const path = join(ctx.cwd!, ctx.dist ?? '.xgsd')\n    await ensureDir(path)\n\n    let started = false\n    let completed = false\n    let res: WorkerResult<unknown>\n\n    const contextStr = JSON.stringify(ctx)\n\n    // TODO: remove hardcoded worker path\n    const child = fork(join(__dirname, 'process', 'workers.process.js'), {\n      stdio: ['inherit', 'pipe', 'pipe', 'ipc'],\n      //execArgv: [`--max-old-space-size=${ctx.limits?.memory ?? 128}`],\n      env: {\n        ...ctx.env,\n        XGSD_CTX: contextStr,\n      },\n    })\n\n    const events = createWriteStream(join(path, 'events.jsonl'), {flags: 'a'})\n\n    const startGuard = () => {\n      startWorkerGuard(child, ctx.limits ?? {}, (reason: string) => {\n        if (completed) return\n\n        // normalise system/watch dog error\n        // then *reject*\n        const err: WorkerError = {\n          code: WorkerErrorCode.CODE_WORKER_GUARD,\n          message: `${reason}`,\n          type: 'system',\n        }\n\n        console.warn(`[guard] worker suspended (reason: ${reason})`)\n\n        writeEvent({\n          type: 'error',\n          message: err.message,\n          guard: true,\n          timestamp: Date.now(),\n        })\n\n        cleanup()\n\n        resolve(formatWorkerResult({error: err, duration: performance.now() - start}))\n      })\n    }\n\n    const cleanup = () => {\n      if (child.connected) {\n        child.removeAllListeners('message')\n\n        child.disconnect()\n      }\n    }\n\n    const writeEvent = (data: any) => {\n      const normalised = normaliseKeys(data)\n      events.write(JSON.stringify({...normalised, id}) + '\\n')\n    }\n\n    child.stdout?.on('data', (chunk) => {\n      const lines = chunk.toString().split('\\n').filter(Boolean)\n\n      for (const line of lines) {\n        // log child process messages (typically from usercode)\n        console.log(`${line}`)\n\n        try {\n          writeEvent(JSON.parse(line))\n        } catch {\n          // optionally fallback for non-json logs\n          writeEvent({\n            type: 'log',\n            message: line,\n            timestamp: Date.now(),\n          })\n        }\n      }\n    })\n\n    child.stderr?.on('data', (chunk) => {\n      const e = {type: 'error', message: chunk.toString(), timestamp: Date.now()}\n      console.error(e.message)\n      writeEvent(e)\n    })\n\n    child.on('message', (msg: ChildMessage<unknown>) => {\n      if (msg.type !== 'ALIVE' && msg.type !== 'DONE' && msg.type !== 'ERROR') return\n\n      if (msg.type === 'ALIVE') {\n        if (!started) {\n          started = true\n          startGuard()\n        }\n        return\n      }\n\n      if (msg.type === 'ERROR') {\n        const {error} = msg\n\n        res = formatWorkerResult({error, duration: performance.now() - start})\n      }\n\n      if (msg.type === 'DONE') {\n        // do something with result\n        res = msg.result\n      }\n\n      res.duration = performance.now() - start\n\n      // log activation\n      appendFileSync(\n        join(path, 'activations.jsonl'),\n        JSON.stringify({\n          id,\n          ok: res.ok,\n          code: res.code,\n          duration: res.duration,\n          error: res.error?.code ?? res.error?.message,\n          result: res.result !== null,\n          timestamp: new Date().toISOString(),\n        }) + '\\n',\n      )\n\n      completed = true\n\n      resolve(res as any)\n      cleanup()\n    })\n  })\n}\n","export enum WorkerErrorCode {\n  // thrown when limits exceeded (ttl/memory)\n  CODE_WORKER_GUARD = 'CODE_WORKER_GUARD',\n\n  // thrown when entry file is invalid/cannot be parsed\n  CODE_INVALID_ENTRY_FILE = 'CODE_INVALID_ENTRY_FILE',\n\n  // thrown when default is not a function\n  CODE_INVALID_DEFAULT_FUNCTION = 'CODE_INVALID_DEFAULT_FUNCTION',\n\n  CODE_INVALID_MIDDLEWARE_FUNCTION = 'CODE_INVALID_MIDDLEWARE_FUNCTION',\n\n  // thrown when bundling fails\n  CODE_BUNDLE_ERROR = 'CODE_BUNDLE_ERROR',\n}\n\nexport type WorkerErrorType = 'user' | 'system' | 'unknown'\nexport type WorkerError = {\n  code?: WorkerErrorCode\n  message?: string\n  type?: WorkerErrorType\n}\n\nexport type WorkerResult<T> =\n  | {\n      version: 'v1'\n      ok: true\n      code?: number\n      result: T\n      error: null\n      duration: number\n    }\n  | {\n      version: 'v1'\n      ok: false\n      code?: number\n      result: null\n      error: WorkerError\n      duration: number\n    }\n\nexport type WorkerConfig = {\n  entry: string\n  dist?: string\n  bundler?: {\n    enabled?: boolean\n    cache?: {\n      strategy: 'never'\n    }\n  }\n  http?: {\n    enabled?: boolean\n  }\n  limits?: {\n    ttl?: number\n    memory?: number\n  }\n}\n\nexport type WorkerContext<T = unknown> = WorkerConfig & {\n  id?: string\n  data: T\n  cwd: string\n  result?: any\n  error?: any\n  code?: number\n  env?: Record<string, any>\n  pid?: number\n}\n","import {readFileSync, writeFileSync, mkdirSync} from 'fs'\nimport {writeFile, readFile, constants, access, mkdir} from 'fs/promises'\nimport {dirname} from 'path'\n\nexport async function pathExists(path: string): Promise<boolean> {\n  try {\n    await access(path, constants.F_OK)\n    return true\n  } catch {\n    return false\n  }\n}\n\n// ensureDir\nexport async function ensureDir(path: string): Promise<void> {\n  await mkdir(path, {recursive: true})\n}\n\n// ensureDirSync\nexport function ensureDirSync(path: string): void {\n  mkdirSync(path, {recursive: true})\n}\n\n// ensurePath\n// Ensures parent directory exists for a file path\nexport async function ensurePath(path: string): Promise<void> {\n  await mkdir(dirname(path), {recursive: true})\n}\n\n// ensurePathSync\nexport function ensurePathSync(path: string): void {\n  mkdirSync(dirname(path), {recursive: true})\n}\n\nexport async function readJson<T = any>(path: string): Promise<T> {\n  const content = await readFile(path, 'utf8')\n  return JSON.parse(content)\n}\n\nexport function readJsonSync<T = any>(path: string): T {\n  return JSON.parse(readFileSync(path, 'utf8'))\n}\n\nexport async function writeJson(path: string, data: unknown, pretty = true): Promise<void> {\n  const json = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data)\n\n  await writeFile(path, json, 'utf8')\n}\n\nexport function writeJsonSync(path: string, data: unknown, pretty = true): void {\n  const json = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data)\n\n  writeFileSync(path, json, 'utf8')\n}\n\nexport function pathExistsSync(path: string): boolean {\n  try {\n    require('fs').accessSync(path, constants.F_OK)\n    return true\n  } catch {\n    return false\n  }\n}\n"],"mappings":"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","names":["WorkerErrorCode"]}

package/dist/index.d.cts

@@ -1,4 +1,7 @@
-import { W as WorkerResult, a as WorkerConfig } from './types-Buhg0r3s.cjs';
+import { W as WorkerContext, a as WorkerResult, b as WorkerConfig } from './types-DL5DfJ18.cjs';
+export { c as WorkerError, d as WorkerErrorCode, e as WorkerErrorType } from './types-DL5DfJ18.cjs';
+
+declare function runWorker<T>(context: WorkerContext): Promise<WorkerResult<T>>;
 
 type Activation<T = unknown> = {
     id?: string;
@@ -9,4 +12,4 @@ type Activation<T = unknown> = {
 type ActivationHandler = <T = unknown>(activation: Activation<T>) => Promise<WorkerResult<T>>;
 declare function createHandler(config: WorkerConfig): ActivationHandler;
 
-export { type Activation, type ActivationHandler, createHandler };
+export { type Activation, type ActivationHandler, WorkerConfig, WorkerContext, WorkerResult, createHandler, runWorker };

package/dist/index.d.ts

@@ -1,4 +1,7 @@
-import { W as WorkerResult, a as WorkerConfig } from './types-Buhg0r3s.js';
+import { W as WorkerContext, a as WorkerResult, b as WorkerConfig } from './types-DL5DfJ18.js';
+export { c as WorkerError, d as WorkerErrorCode, e as WorkerErrorType } from './types-DL5DfJ18.js';
+
+declare function runWorker<T>(context: WorkerContext): Promise<WorkerResult<T>>;
 
 type Activation<T = unknown> = {
     id?: string;
@@ -9,4 +12,4 @@ type Activation<T = unknown> = {
 type ActivationHandler = <T = unknown>(activation: Activation<T>) => Promise<WorkerResult<T>>;
 declare function createHandler(config: WorkerConfig): ActivationHandler;
 
-export { type Activation, type ActivationHandler, createHandler };
+export { type Activation, type ActivationHandler, WorkerConfig, WorkerContext, WorkerResult, createHandler, runWorker };

package/dist/index.js

@@ -1,6 +1,7 @@
 import {
+  WorkerErrorCode,
   ensureDir
-} from "./chunk-QLD3WJX5.js";
+} from "./chunk-XFMQAJZM.js";
 
 // src/worker.ts
 import { fork } from "child_process";
@@ -175,6 +176,8 @@ function createHandler(config) {
   };
 }
 export {
-  createHandler
+  WorkerErrorCode,
+  createHandler,
+  runWorker
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/worker.ts","../src/index.ts"],"sourcesContent":["import {fork} from 'child_process'\nimport {join} from 'path'\nimport {WorkerContext, WorkerError, WorkerErrorCode, WorkerResult} from './types.js'\nimport {createWriteStream, appendFileSync} from 'fs'\nimport {ensureDir} from './util/fs.js'\nimport {randomUUID} from 'crypto'\n\nexport function startWorkerGuard(\n  child: any,\n  opts: {\n    ttl?: number\n    memory?: number\n  },\n  suspended?: (reason: string) => void,\n) {\n  const {ttl = 5000, memory = 128} = opts\n\n  let ttlTimer: NodeJS.Timeout | null = null\n  let killed = false\n\n  const kill = (reason: string) => {\n    if (killed) return\n    killed = true\n\n    if (ttlTimer) clearTimeout(ttlTimer)\n\n    child.kill('SIGKILL')\n    suspended?.(reason)\n  }\n\n  // TTL watchdog\n  ttlTimer = setTimeout(() => {\n    kill(`ttl exceeded limit (limit: ${ttl.toFixed(2)}ms)`)\n  }, ttl)\n\n  child.on('message', (msg: any) => {\n    if (msg.type !== 'ALIVE') {\n      return\n    }\n\n    // (v0.1.0) this isn't set in stone\n    // may be worth using RSS\n    const heapUsed = msg.memory?.heapUsed ?? 0\n    const memMB = heapUsed / 1024 / 1024\n\n    if (memMB > memory) {\n      kill(`memory limit exceeded: ${memMB.toFixed(2)}MB/${memory.toFixed(2)}MB`)\n    }\n  })\n\n  child.on('exit', () => {\n    if (ttlTimer) clearTimeout(ttlTimer)\n  })\n}\n\ntype ChildMessage<T> =\n  | {type: 'ALIVE'; error: undefined; result: undefined}\n  | {type: 'DONE'; result: WorkerResult<T>; error: undefined | null}\n  | {type: 'ERROR'; result: undefined | null; error: WorkerError}\n\nexport function normaliseKeys(value: any): any {\n  if (Array.isArray(value)) {\n    return value.map(normaliseKeys)\n  }\n\n  if (value && typeof value === 'object' && value.constructor === Object) {\n    const sorted: Record<string, any> = {}\n\n    for (const key of Object.keys(value).sort()) {\n      sorted[key] = normaliseKeys(value[key])\n    }\n\n    return sorted\n  }\n\n  return value\n}\n\nexport function formatWorkerResult(opts: {result?: any; error?: any; duration: number}): WorkerResult<any> {\n  return {\n    version: 'v1',\n    ok: !opts.error,\n    result: opts.result ?? null,\n    error: opts.error ?? null,\n    duration: opts.duration,\n  }\n}\n\nexport async function runWorker<T>(context: WorkerContext): Promise<WorkerResult<T>> {\n  return new Promise(async (resolve, reject) => {\n    const id = randomUUID()\n\n    const ctx = {...context, id}\n    const start = performance.now()\n\n    const path = join(ctx.cwd!, ctx.dist ?? '.xgsd')\n    await ensureDir(path)\n\n    let started = false\n    let completed = false\n    let res: WorkerResult<unknown>\n\n    const contextStr = JSON.stringify(ctx)\n\n    // TODO: remove hardcoded worker path\n    const child = fork(join(__dirname, 'process', 'workers.process.js'), {\n      stdio: ['inherit', 'pipe', 'pipe', 'ipc'],\n      //execArgv: [`--max-old-space-size=${ctx.limits?.memory ?? 128}`],\n      env: {\n        ...ctx.env,\n        XGSD_CTX: contextStr,\n      },\n    })\n\n    const events = createWriteStream(join(path, 'events.jsonl'), {flags: 'a'})\n\n    const startGuard = () => {\n      startWorkerGuard(child, ctx.limits ?? {}, (reason: string) => {\n        if (completed) return\n\n        // normalise system/watch dog error\n        // then *reject*\n        const err: WorkerError = {\n          code: WorkerErrorCode.CODE_WORKER_GUARD,\n          message: `${reason}`,\n          type: 'system',\n        }\n\n        console.warn(`[guard] worker suspended (reason: ${reason})`)\n\n        writeEvent({\n          type: 'error',\n          message: err.message,\n          guard: true,\n          timestamp: Date.now(),\n        })\n\n        cleanup()\n\n        resolve(formatWorkerResult({error: err, duration: performance.now() - start}))\n      })\n    }\n\n    const cleanup = () => {\n      if (child.connected) {\n        child.removeAllListeners('message')\n\n        child.disconnect()\n      }\n    }\n\n    const writeEvent = (data: any) => {\n      const normalised = normaliseKeys(data)\n      events.write(JSON.stringify({...normalised, id}) + '\\n')\n    }\n\n    child.stdout?.on('data', (chunk) => {\n      const lines = chunk.toString().split('\\n').filter(Boolean)\n\n      for (const line of lines) {\n        // log child process messages (typically from usercode)\n        console.log(`${line}`)\n\n        try {\n          writeEvent(JSON.parse(line))\n        } catch {\n          // optionally fallback for non-json logs\n          writeEvent({\n            type: 'log',\n            message: line,\n            timestamp: Date.now(),\n          })\n        }\n      }\n    })\n\n    child.stderr?.on('data', (chunk) => {\n      const e = {type: 'error', message: chunk.toString(), timestamp: Date.now()}\n      console.error(e.message)\n      writeEvent(e)\n    })\n\n    child.on('message', (msg: ChildMessage<unknown>) => {\n      if (msg.type !== 'ALIVE' && msg.type !== 'DONE' && msg.type !== 'ERROR') return\n\n      if (msg.type === 'ALIVE') {\n        if (!started) {\n          started = true\n          startGuard()\n        }\n        return\n      }\n\n      if (msg.type === 'ERROR') {\n        const {error} = msg\n\n        res = formatWorkerResult({error, duration: performance.now() - start})\n      }\n\n      if (msg.type === 'DONE') {\n        // do something with result\n        res = msg.result\n      }\n\n      res.duration = performance.now() - start\n\n      // log activation\n      appendFileSync(\n        join(path, 'activations.jsonl'),\n        JSON.stringify({\n          id,\n          ok: res.ok,\n          code: res.code,\n          duration: res.duration,\n          error: res.error?.code ?? res.error?.message,\n          result: res.result !== null,\n          timestamp: new Date().toISOString(),\n        }) + '\\n',\n      )\n\n      completed = true\n\n      resolve(res as any)\n      cleanup()\n    })\n  })\n}\n","import {WorkerResult, WorkerConfig} from './types'\nimport {runWorker} from './worker'\n\nexport type Activation<T = unknown> = {\n  id?: string\n  data?: T\n  env?: Record<string, unknown>\n  cwd: string\n}\n\nexport type ActivationHandler = <T = unknown>(activation: Activation<T>) => Promise<WorkerResult<T>>\n\nexport function createHandler(config: WorkerConfig): ActivationHandler {\n  return async function handler(activation) {\n    return runWorker({\n      ...config,\n      id: activation.id,\n      cwd: activation.cwd,\n      data: activation.data,\n      env: activation.env,\n    })\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/worker.ts","../src/index.ts"],"sourcesContent":["import {fork} from 'child_process'\nimport {join} from 'path'\nimport {WorkerContext, WorkerError, WorkerErrorCode, WorkerResult} from './types.js'\nimport {createWriteStream, appendFileSync} from 'fs'\nimport {ensureDir} from './util/fs.js'\nimport {randomUUID} from 'crypto'\n\nexport function startWorkerGuard(\n  child: any,\n  opts: {\n    ttl?: number\n    memory?: number\n  },\n  suspended?: (reason: string) => void,\n) {\n  const {ttl = 5000, memory = 128} = opts\n\n  let ttlTimer: NodeJS.Timeout | null = null\n  let killed = false\n\n  const kill = (reason: string) => {\n    if (killed) return\n    killed = true\n\n    if (ttlTimer) clearTimeout(ttlTimer)\n\n    child.kill('SIGKILL')\n    suspended?.(reason)\n  }\n\n  // TTL watchdog\n  ttlTimer = setTimeout(() => {\n    kill(`ttl exceeded limit (limit: ${ttl.toFixed(2)}ms)`)\n  }, ttl)\n\n  child.on('message', (msg: any) => {\n    if (msg.type !== 'ALIVE') {\n      return\n    }\n\n    // (v0.1.0) this isn't set in stone\n    // may be worth using RSS\n    const heapUsed = msg.memory?.heapUsed ?? 0\n    const memMB = heapUsed / 1024 / 1024\n\n    if (memMB > memory) {\n      kill(`memory limit exceeded: ${memMB.toFixed(2)}MB/${memory.toFixed(2)}MB`)\n    }\n  })\n\n  child.on('exit', () => {\n    if (ttlTimer) clearTimeout(ttlTimer)\n  })\n}\n\ntype ChildMessage<T> =\n  | {type: 'ALIVE'; error: undefined; result: undefined}\n  | {type: 'DONE'; result: WorkerResult<T>; error: undefined | null}\n  | {type: 'ERROR'; result: undefined | null; error: WorkerError}\n\nexport function normaliseKeys(value: any): any {\n  if (Array.isArray(value)) {\n    return value.map(normaliseKeys)\n  }\n\n  if (value && typeof value === 'object' && value.constructor === Object) {\n    const sorted: Record<string, any> = {}\n\n    for (const key of Object.keys(value).sort()) {\n      sorted[key] = normaliseKeys(value[key])\n    }\n\n    return sorted\n  }\n\n  return value\n}\n\nexport function formatWorkerResult(opts: {result?: any; error?: any; duration: number}): WorkerResult<any> {\n  return {\n    version: 'v1',\n    ok: !opts.error,\n    result: opts.result ?? null,\n    error: opts.error ?? null,\n    duration: opts.duration,\n  }\n}\n\nexport async function runWorker<T>(context: WorkerContext): Promise<WorkerResult<T>> {\n  return new Promise(async (resolve, reject) => {\n    const id = randomUUID()\n\n    const ctx = {...context, id}\n    const start = performance.now()\n\n    const path = join(ctx.cwd!, ctx.dist ?? '.xgsd')\n    await ensureDir(path)\n\n    let started = false\n    let completed = false\n    let res: WorkerResult<unknown>\n\n    const contextStr = JSON.stringify(ctx)\n\n    // TODO: remove hardcoded worker path\n    const child = fork(join(__dirname, 'process', 'workers.process.js'), {\n      stdio: ['inherit', 'pipe', 'pipe', 'ipc'],\n      //execArgv: [`--max-old-space-size=${ctx.limits?.memory ?? 128}`],\n      env: {\n        ...ctx.env,\n        XGSD_CTX: contextStr,\n      },\n    })\n\n    const events = createWriteStream(join(path, 'events.jsonl'), {flags: 'a'})\n\n    const startGuard = () => {\n      startWorkerGuard(child, ctx.limits ?? {}, (reason: string) => {\n        if (completed) return\n\n        // normalise system/watch dog error\n        // then *reject*\n        const err: WorkerError = {\n          code: WorkerErrorCode.CODE_WORKER_GUARD,\n          message: `${reason}`,\n          type: 'system',\n        }\n\n        console.warn(`[guard] worker suspended (reason: ${reason})`)\n\n        writeEvent({\n          type: 'error',\n          message: err.message,\n          guard: true,\n          timestamp: Date.now(),\n        })\n\n        cleanup()\n\n        resolve(formatWorkerResult({error: err, duration: performance.now() - start}))\n      })\n    }\n\n    const cleanup = () => {\n      if (child.connected) {\n        child.removeAllListeners('message')\n\n        child.disconnect()\n      }\n    }\n\n    const writeEvent = (data: any) => {\n      const normalised = normaliseKeys(data)\n      events.write(JSON.stringify({...normalised, id}) + '\\n')\n    }\n\n    child.stdout?.on('data', (chunk) => {\n      const lines = chunk.toString().split('\\n').filter(Boolean)\n\n      for (const line of lines) {\n        // log child process messages (typically from usercode)\n        console.log(`${line}`)\n\n        try {\n          writeEvent(JSON.parse(line))\n        } catch {\n          // optionally fallback for non-json logs\n          writeEvent({\n            type: 'log',\n            message: line,\n            timestamp: Date.now(),\n          })\n        }\n      }\n    })\n\n    child.stderr?.on('data', (chunk) => {\n      const e = {type: 'error', message: chunk.toString(), timestamp: Date.now()}\n      console.error(e.message)\n      writeEvent(e)\n    })\n\n    child.on('message', (msg: ChildMessage<unknown>) => {\n      if (msg.type !== 'ALIVE' && msg.type !== 'DONE' && msg.type !== 'ERROR') return\n\n      if (msg.type === 'ALIVE') {\n        if (!started) {\n          started = true\n          startGuard()\n        }\n        return\n      }\n\n      if (msg.type === 'ERROR') {\n        const {error} = msg\n\n        res = formatWorkerResult({error, duration: performance.now() - start})\n      }\n\n      if (msg.type === 'DONE') {\n        // do something with result\n        res = msg.result\n      }\n\n      res.duration = performance.now() - start\n\n      // log activation\n      appendFileSync(\n        join(path, 'activations.jsonl'),\n        JSON.stringify({\n          id,\n          ok: res.ok,\n          code: res.code,\n          duration: res.duration,\n          error: res.error?.code ?? res.error?.message,\n          result: res.result !== null,\n          timestamp: new Date().toISOString(),\n        }) + '\\n',\n      )\n\n      completed = true\n\n      resolve(res as any)\n      cleanup()\n    })\n  })\n}\n","import {WorkerResult, WorkerConfig} from './types.js'\nimport {runWorker} from './worker.js'\n\nexport {runWorker}\nexport * from './types.js'\n\nexport type Activation<T = unknown> = {\n  id?: string\n  data?: T\n  env?: Record<string, unknown>\n  cwd: string\n}\n\nexport type ActivationHandler = <T = unknown>(activation: Activation<T>) => Promise<WorkerResult<T>>\n\nexport function createHandler(config: WorkerConfig): ActivationHandler {\n  return async function handler(activation) {\n    return runWorker({\n      ...config,\n      id: activation.id,\n      cwd: activation.cwd,\n      data: activation.data,\n      env: activation.env,\n    })\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/process/workers.process.d.cts

@@ -1,4 +1,4 @@
-import { b as WorkerContext } from '../types-Buhg0r3s.cjs';
+import { W as WorkerContext } from '../types-DL5DfJ18.cjs';
 
 type Next = () => Promise<void>;
 

package/dist/process/workers.process.d.ts

@@ -1,4 +1,4 @@
-import { b as WorkerContext } from '../types-Buhg0r3s.js';
+import { W as WorkerContext } from '../types-DL5DfJ18.js';
 
 type Next = () => Promise<void>;
 

package/dist/process/workers.process.js

@@ -3,7 +3,7 @@ import {
   pathExistsSync,
   readJsonSync,
   writeJsonSync
-} from "../chunk-QLD3WJX5.js";
+} from "../chunk-XFMQAJZM.js";
 
 // src/process/workers.process.ts
 import { join as join2 } from "path";

package/dist/{types-Buhg0r3s.d.cts → types-DL5DfJ18.d.cts}

@@ -54,4 +54,4 @@ type WorkerContext<T = unknown> = WorkerConfig & {
     pid?: number;
 };
 
-export type { WorkerResult as W, WorkerConfig as a, WorkerContext as b };
+export { type WorkerContext as W, type WorkerResult as a, type WorkerConfig as b, type WorkerError as c, WorkerErrorCode as d, type WorkerErrorType as e };

package/dist/{types-Buhg0r3s.d.ts → types-DL5DfJ18.d.ts}

@@ -54,4 +54,4 @@ type WorkerContext<T = unknown> = WorkerConfig & {
     pid?: number;
 };
 
-export type { WorkerResult as W, WorkerConfig as a, WorkerContext as b };
+export { type WorkerContext as W, type WorkerResult as a, type WorkerConfig as b, type WorkerError as c, WorkerErrorCode as d, type WorkerErrorType as e };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xgsd/workers",
   "description": "Super lightweight alternative to standard xGSD runtime. Optimised for queues/serverless vs project orchestration.",
-  "version": "0.1.0-beta.0",
+  "version": "0.1.0-beta.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -38,8 +38,8 @@
     "typescript": "^5.x"
   },
   "peerDependencies": {
-    "esbuild": "^0.28.0",
-    "@xgsd/engine": "^1.0.0-stable"
+    "@xgsd/engine": "^1.0.0-stable",
+    "esbuild": "^0.28.0"
   },
   "peerDependenciesMeta": {
     "esbuild": {

package/dist/chunk-QLD3WJX5.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/util/fs.ts"],"sourcesContent":["import {readFileSync, writeFileSync, mkdirSync} from 'fs'\nimport {writeFile, readFile, constants, access, mkdir} from 'fs/promises'\nimport {dirname} from 'path'\n\nexport async function pathExists(path: string): Promise<boolean> {\n  try {\n    await access(path, constants.F_OK)\n    return true\n  } catch {\n    return false\n  }\n}\n\n// ensureDir\nexport async function ensureDir(path: string): Promise<void> {\n  await mkdir(path, {recursive: true})\n}\n\n// ensureDirSync\nexport function ensureDirSync(path: string): void {\n  mkdirSync(path, {recursive: true})\n}\n\n// ensurePath\n// Ensures parent directory exists for a file path\nexport async function ensurePath(path: string): Promise<void> {\n  await mkdir(dirname(path), {recursive: true})\n}\n\n// ensurePathSync\nexport function ensurePathSync(path: string): void {\n  mkdirSync(dirname(path), {recursive: true})\n}\n\nexport async function readJson<T = any>(path: string): Promise<T> {\n  const content = await readFile(path, 'utf8')\n  return JSON.parse(content)\n}\n\nexport function readJsonSync<T = any>(path: string): T {\n  return JSON.parse(readFileSync(path, 'utf8'))\n}\n\nexport async function writeJson(path: string, data: unknown, pretty = true): Promise<void> {\n  const json = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data)\n\n  await writeFile(path, json, 'utf8')\n}\n\nexport function writeJsonSync(path: string, data: unknown, pretty = true): void {\n  const json = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data)\n\n  writeFileSync(path, json, 'utf8')\n}\n\nexport function pathExistsSync(path: string): boolean {\n  try {\n    require('fs').accessSync(path, constants.F_OK)\n    return true\n  } catch {\n    return false\n  }\n}\n"],"mappings":";;;;;;;;AAAA,SAAQ,cAAc,eAAe,iBAAgB;AACrD,SAAQ,WAAW,UAAU,WAAW,QAAQ,aAAY;AAG5D,eAAsB,WAAW,MAAgC;AAC/D,MAAI;AACF,UAAM,OAAO,MAAM,UAAU,IAAI;AACjC,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,eAAsB,UAAU,MAA6B;AAC3D,QAAM,MAAM,MAAM,EAAC,WAAW,KAAI,CAAC;AACrC;AAuBO,SAAS,aAAsB,MAAiB;AACrD,SAAO,KAAK,MAAM,aAAa,MAAM,MAAM,CAAC;AAC9C;AAQO,SAAS,cAAc,MAAc,MAAe,SAAS,MAAY;AAC9E,QAAM,OAAO,SAAS,KAAK,UAAU,MAAM,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI;AAEzE,gBAAc,MAAM,MAAM,MAAM;AAClC;AAEO,SAAS,eAAe,MAAuB;AACpD,MAAI;AACF,cAAQ,IAAI,EAAE,WAAW,MAAM,UAAU,IAAI;AAC7C,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}