@morojs/moro 1.8.2 → 1.8.3

package/dist/core/utilities/package-utils.js

@@ -4,6 +4,7 @@ import { createRequire } from 'module';
 import { dirname, join } from 'path';
 import { existsSync, realpathSync } from 'fs';
 import { pathToFileURL } from 'url';
+import { selfRequire } from './self-require.js';
 /**
  * Check if a package is available in the user's node_modules
  * Uses ESM-compatible module resolution from the user's working directory
@@ -119,6 +120,12 @@ let engineLoadErrors = [];
  * Inside the framework repo itself (tests, examples) cwd is the framework dir.
  */
 function findFrameworkAnchor() {
+    // Primary: anchor to moro's OWN compiled location, so moro's `@morojs/engine`
+    // dependency resolves relative to where moro is installed regardless of
+    // `process.cwd()` (Docker WORKDIR, supervisord, pm2, a subdirectory, …). The
+    // cwd-based walk below is a defensive fallback for exotic layouts.
+    if (selfRequire)
+        return selfRequire;
     try {
         const cwdPackageJson = join(process.cwd(), 'package.json');
         if (existsSync(cwdPackageJson)) {

package/dist/core/utilities/package-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-utils.js","sourceRoot":"","sources":["../../../src/core/utilities/package-utils.ts"],"names":[],"mappings":"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","sourcesContent":["// Package and Module Resolution Utilities\n// ESM-compatible helpers for detecting and resolving optional dependencies\n\nimport { createRequire } from 'module';\nimport { dirname, join } from 'path';\nimport { existsSync, realpathSync } from 'fs';\nimport { pathToFileURL } from 'url';\n\n/**\n * Check if a package is available in the user's node_modules\n * Uses ESM-compatible module resolution from the user's working directory\n *\n * @param packageName - The name of the package to check (e.g., 'socket.io', 'zod')\n * @returns true if the package is installed, false otherwise\n *\n * @example\n * if (isPackageAvailable('socket.io')) {\n *   // socket.io is installed, safe to import\n *   const { Server } = await import('socket.io');\n * }\n */\nexport function isPackageAvailable(packageName: string): boolean {\n  try {\n    const userRequire = createRequire(join(process.cwd(), 'package.json'));\n    userRequire.resolve(packageName);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Resolve a package path from the user's node_modules\n * Uses ESM-compatible module resolution from the user's working directory\n *\n * @param packageName - The name of the package to resolve\n * @returns The resolved package path\n * @throws Error if the package is not found\n *\n * @example\n * const socketIOPath = resolveUserPackage('socket.io');\n * const { Server } = await import(socketIOPath);\n */\nexport function resolveUserPackage(packageName: string): string {\n  const userRequire = createRequire(join(process.cwd(), 'package.json'));\n  return userRequire.resolve(packageName);\n}\n\n/**\n * Create a require function for the user's working directory\n * Useful for resolving packages installed by the user, not in Moro's dependencies\n *\n * @returns A require function scoped to the user's working directory\n *\n * @example\n * const userRequire = createUserRequire();\n * const packagePath = userRequire.resolve('some-package');\n */\nexport function createUserRequire() {\n  return createRequire(join(process.cwd(), 'package.json'));\n}\n\n// ---------------------------------------------------------------------------\n// Native HTTP engine loading\n// ---------------------------------------------------------------------------\n\n/**\n * Package names probed for the native HTTP engine, in priority order.\n * '@morojs/engine' is Moro's own engine (installed as an optionalDependency of\n * the framework); 'uWebSockets.js' is honored as a legacy user-installed peer.\n */\nexport const NATIVE_ENGINE_PACKAGES = ['@morojs/engine', 'uWebSockets.js'] as const;\n\nconst FRAMEWORK_PACKAGE_NAME = '@morojs/moro';\n\n/** Feature flags the framework gates option-passing on, so it never hands a\n *  serve() option to an engine build that predates it. Everything defaults\n *  false, so an older engine behaves exactly as it did before these existed. */\nexport interface EngineCapabilities {\n  /** The full serve() limit surface is parsed (engine >= 1.1.0). */\n  limits: boolean;\n  /** In-process TLS termination via options.ssl (engine >= 1.2.0). */\n  tls: boolean;\n  /** ALPN HTTP/2 via options.http2 (engine >= 1.4.0). */\n  http2: boolean;\n  /** WebSocket permessage-deflate via options.wsDeflate (engine >= 1.5.0). */\n  wsDeflate: boolean;\n}\n\nexport interface NativeEngineLoadResult {\n  /** The loaded engine module (CJS namespace: App, SSLApp, ...) */\n  module: any;\n  /** Which package satisfied the load */\n  source: string;\n  /** The engine package's version, when its package.json is resolvable */\n  version?: string;\n  /** Feature flags (Moro-shaped engine only; all-false for uWS or an\n   *  engine too old to advertise them). */\n  capabilities?: EngineCapabilities;\n}\n\nconst NO_CAPABILITIES: EngineCapabilities = {\n  limits: false,\n  tls: false,\n  http2: false,\n  wsDeflate: false,\n};\n\nconst capabilitiesCache = new WeakMap<object, EngineCapabilities>();\n\n/**\n * Feature-detect a loaded engine module. Reads probe().capabilities when the\n * engine exposes it (>= 1.1.0); otherwise everything is false so the framework\n * passes only the options an older engine understood. uWS-style modules (no\n * probe/serve) report all-false — their SSL/limits go through the uWS-specific\n * paths, not these flags.\n */\nexport function getEngineCapabilities(module: any): EngineCapabilities {\n  const surface = module?.default || module;\n  if (!surface || typeof surface !== 'object') return NO_CAPABILITIES;\n  const cached = capabilitiesCache.get(surface);\n  if (cached) return cached;\n\n  let caps: EngineCapabilities = NO_CAPABILITIES;\n  try {\n    if (typeof surface.probe === 'function') {\n      const probe = surface.probe();\n      const c = probe?.capabilities;\n      if (c && typeof c === 'object') {\n        caps = {\n          limits: c.limits === true,\n          tls: c.tls === true,\n          http2: c.http2 === true,\n          wsDeflate: c.wsDeflate === true,\n        };\n      }\n    }\n  } catch {\n    caps = NO_CAPABILITIES;\n  }\n  capabilitiesCache.set(surface, caps);\n  return caps;\n}\n\n// undefined = never attempted, null = attempted and failed\nlet cachedEngine: NativeEngineLoadResult | null | undefined;\nlet engineLoadErrors: string[] = [];\n\n/**\n * Locate the installed framework package directory so the engine (a dependency\n * of moro, not of the user's app) resolves under strict layouts like pnpm's.\n * Walks up from cwd looking for node_modules/@morojs/moro, resolving symlinks\n * so pnpm's store-linked layout anchors requires next to moro's own deps.\n * Inside the framework repo itself (tests, examples) cwd is the framework dir.\n */\nfunction findFrameworkAnchor(): ReturnType<typeof createRequire> | null {\n  try {\n    const cwdPackageJson = join(process.cwd(), 'package.json');\n    if (existsSync(cwdPackageJson)) {\n      const require = createRequire(cwdPackageJson);\n      const name = require(cwdPackageJson)?.name;\n      if (name === FRAMEWORK_PACKAGE_NAME) {\n        return require;\n      }\n    }\n  } catch {\n    // fall through to the node_modules walk\n  }\n\n  let dir = process.cwd();\n  for (;;) {\n    const packageJson = join(dir, 'node_modules', '@morojs', 'moro', 'package.json');\n    try {\n      if (existsSync(packageJson)) {\n        return createRequire(join(realpathSync(dirname(packageJson)), 'package.json'));\n      }\n    } catch {\n      // unreadable/broken link - keep walking up\n    }\n    const parent = dirname(dir);\n    if (parent === dir) return null;\n    dir = parent;\n  }\n}\n\n/**\n * Synchronously load the native HTTP engine, trying '@morojs/engine' first and\n * falling back to a user-installed 'uWebSockets.js'. Loading is require-based\n * (both packages are CJS at their core - .node addon loading is require-based),\n * so the instance is shared with any later import() via the CJS module cache.\n *\n * The default call is memoized: the engine either loads once per process or it\n * doesn't. Failure details are retained for logging via\n * getNativeEngineLoadErrors().\n *\n * @param options.candidates - Override the probed package names (testing).\n *   When provided, the call bypasses the cache.\n * @returns The loaded engine and its source package, or null if none loads\n */\nexport function loadNativeEngine(options?: {\n  candidates?: readonly string[];\n  /** When provided, every per-attempt failure message is appended here, so a\n   *  candidate-override caller (which bypasses the memoized diagnostics) can\n   *  still report exactly WHY the engine didn't load — not just \"not installed\". */\n  collectErrors?: string[];\n}): NativeEngineLoadResult | null {\n  const useCache = !options?.candidates;\n  if (useCache && cachedEngine !== undefined) {\n    if (options?.collectErrors && !cachedEngine) {\n      options.collectErrors.push(...engineLoadErrors);\n    }\n    return cachedEngine;\n  }\n\n  const candidates = options?.candidates ?? NATIVE_ENGINE_PACKAGES;\n  const errors: string[] = [];\n  let result: NativeEngineLoadResult | null = null;\n\n  const frameworkRequire = findFrameworkAnchor();\n  const userRequire = createUserRequire();\n\n  for (const candidate of candidates) {\n    // Moro's own engine lives in moro's dependencies (framework anchor first);\n    // the legacy uWS peer dep lives in the user's node_modules (cwd first).\n    const anchors =\n      candidate === 'uWebSockets.js'\n        ? [userRequire, frameworkRequire]\n        : [frameworkRequire, userRequire];\n\n    for (const anchor of anchors) {\n      if (!anchor) continue;\n      try {\n        const module = anchor(candidate);\n        // Capability check: the HTTP server needs either a uWS-style App()\n        // factory or the Moro-shaped engine surface (serve()/respond()).\n        // A package that loads but can't serve (e.g. a pre-M1 @morojs/engine\n        // that only exposes probe()) must not shadow a usable alternative.\n        const surface = module?.default || module;\n        const uwsStyle = typeof surface?.App === 'function';\n        const moroStyle =\n          !uwsStyle &&\n          typeof surface?.serve === 'function' &&\n          typeof surface?.respond === 'function';\n        if (!uwsStyle && !moroStyle) {\n          errors.push(\n            `${candidate}: loaded but provides neither App() nor serve()/respond() - not a usable HTTP engine`\n          );\n          continue;\n        }\n        let version: string | undefined;\n        try {\n          // May be blocked by the package's exports map - version is optional\n          version = anchor(`${candidate}/package.json`)?.version;\n        } catch {\n          version = undefined;\n        }\n        result = {\n          module,\n          source: candidate,\n          ...(version !== undefined ? { version } : {}),\n          capabilities: moroStyle ? getEngineCapabilities(module) : NO_CAPABILITIES,\n        };\n        break;\n      } catch (error) {\n        const message = error instanceof Error ? error.message.split('\\n')[0] : String(error);\n        errors.push(`${candidate}: ${message}`);\n      }\n    }\n    if (result) break;\n  }\n\n  // Candidate-override probes (e.g. the clustering worker's uWS-only check)\n  // must not clobber the diagnostics of the real default load, which\n  // framework startup logging reads via getNativeEngineLoadErrors().\n  if (useCache) {\n    engineLoadErrors = result ? [] : [...new Set(errors)];\n    cachedEngine = result;\n  }\n  // Hand this specific call's failure detail back to a caller that asked for it,\n  // regardless of caching (so 'moro'/'uws' fallback reasons are precise).\n  if (options?.collectErrors && !result) {\n    options.collectErrors.push(...new Set(errors));\n  }\n  return result;\n}\n\n/**\n * Failure details from the most recent unsuccessful loadNativeEngine() call,\n * one entry per package/anchor attempt. Empty after a successful load.\n */\nexport function getNativeEngineLoadErrors(): readonly string[] {\n  return engineLoadErrors;\n}\n\n/**\n * Clear the memoized engine load result. Testing only.\n */\nexport function resetNativeEngineLoaderForTesting(): void {\n  cachedEngine = undefined;\n  engineLoadErrors = [];\n}\n\n/**\n * Convert a file path to a file URL for ESM dynamic imports\n * This is required on Windows where absolute paths like C:\\path\\to\\module\n * need to be converted to file:/// URLs for dynamic import() to work\n *\n * @param filePath - The file path to convert (absolute or relative)\n * @returns A proper URL string for ESM import() that works cross-platform\n *\n * @example\n * const modulePath = 'C:\\\\Users\\\\project\\\\module.js';\n * const module = await import(filePathToImportURL(modulePath));\n */\nexport function filePathToImportURL(filePath: string): string {\n  if (!filePath) {\n    return filePath;\n  }\n\n  // If it's already a URL (starts with file:// or http(s)://), return as-is\n  if (\n    filePath.startsWith('file://') ||\n    filePath.startsWith('http://') ||\n    filePath.startsWith('https://')\n  ) {\n    return filePath;\n  }\n\n  // Check if it's a Windows absolute path (C:\\ or C:/)\n  const windowsAbsolutePathRegex = /^[A-Za-z]:[\\\\//]/;\n  const isWindowsAbsolute = windowsAbsolutePathRegex.test(filePath);\n\n  // Check if it's a Unix absolute path (starts with /)\n  const isUnixAbsolute = filePath.startsWith('/');\n\n  // Check if it's a Windows UNC path (\\\\server\\share)\n  const isWindowsUNC = filePath.startsWith('\\\\\\\\');\n\n  // Convert absolute paths to file URLs\n  if (isWindowsAbsolute || isUnixAbsolute || isWindowsUNC) {\n    return pathToFileURL(filePath).href;\n  }\n\n  // For relative paths, return as-is (they work in import())\n  return filePath;\n}\n"]}
+{"version":3,"file":"package-utils.js","sourceRoot":"","sources":["../../../src/core/utilities/package-utils.ts"],"names":[],"mappings":"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","sourcesContent":["// Package and Module Resolution Utilities\n// ESM-compatible helpers for detecting and resolving optional dependencies\n\nimport { createRequire } from 'module';\nimport { dirname, join } from 'path';\nimport { existsSync, realpathSync } from 'fs';\nimport { pathToFileURL } from 'url';\nimport { selfRequire } from './self-require.js';\n\n/**\n * Check if a package is available in the user's node_modules\n * Uses ESM-compatible module resolution from the user's working directory\n *\n * @param packageName - The name of the package to check (e.g., 'socket.io', 'zod')\n * @returns true if the package is installed, false otherwise\n *\n * @example\n * if (isPackageAvailable('socket.io')) {\n *   // socket.io is installed, safe to import\n *   const { Server } = await import('socket.io');\n * }\n */\nexport function isPackageAvailable(packageName: string): boolean {\n  try {\n    const userRequire = createRequire(join(process.cwd(), 'package.json'));\n    userRequire.resolve(packageName);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Resolve a package path from the user's node_modules\n * Uses ESM-compatible module resolution from the user's working directory\n *\n * @param packageName - The name of the package to resolve\n * @returns The resolved package path\n * @throws Error if the package is not found\n *\n * @example\n * const socketIOPath = resolveUserPackage('socket.io');\n * const { Server } = await import(socketIOPath);\n */\nexport function resolveUserPackage(packageName: string): string {\n  const userRequire = createRequire(join(process.cwd(), 'package.json'));\n  return userRequire.resolve(packageName);\n}\n\n/**\n * Create a require function for the user's working directory\n * Useful for resolving packages installed by the user, not in Moro's dependencies\n *\n * @returns A require function scoped to the user's working directory\n *\n * @example\n * const userRequire = createUserRequire();\n * const packagePath = userRequire.resolve('some-package');\n */\nexport function createUserRequire() {\n  return createRequire(join(process.cwd(), 'package.json'));\n}\n\n// ---------------------------------------------------------------------------\n// Native HTTP engine loading\n// ---------------------------------------------------------------------------\n\n/**\n * Package names probed for the native HTTP engine, in priority order.\n * '@morojs/engine' is Moro's own engine (installed as an optionalDependency of\n * the framework); 'uWebSockets.js' is honored as a legacy user-installed peer.\n */\nexport const NATIVE_ENGINE_PACKAGES = ['@morojs/engine', 'uWebSockets.js'] as const;\n\nconst FRAMEWORK_PACKAGE_NAME = '@morojs/moro';\n\n/** Feature flags the framework gates option-passing on, so it never hands a\n *  serve() option to an engine build that predates it. Everything defaults\n *  false, so an older engine behaves exactly as it did before these existed. */\nexport interface EngineCapabilities {\n  /** The full serve() limit surface is parsed (engine >= 1.1.0). */\n  limits: boolean;\n  /** In-process TLS termination via options.ssl (engine >= 1.2.0). */\n  tls: boolean;\n  /** ALPN HTTP/2 via options.http2 (engine >= 1.4.0). */\n  http2: boolean;\n  /** WebSocket permessage-deflate via options.wsDeflate (engine >= 1.5.0). */\n  wsDeflate: boolean;\n}\n\nexport interface NativeEngineLoadResult {\n  /** The loaded engine module (CJS namespace: App, SSLApp, ...) */\n  module: any;\n  /** Which package satisfied the load */\n  source: string;\n  /** The engine package's version, when its package.json is resolvable */\n  version?: string;\n  /** Feature flags (Moro-shaped engine only; all-false for uWS or an\n   *  engine too old to advertise them). */\n  capabilities?: EngineCapabilities;\n}\n\nconst NO_CAPABILITIES: EngineCapabilities = {\n  limits: false,\n  tls: false,\n  http2: false,\n  wsDeflate: false,\n};\n\nconst capabilitiesCache = new WeakMap<object, EngineCapabilities>();\n\n/**\n * Feature-detect a loaded engine module. Reads probe().capabilities when the\n * engine exposes it (>= 1.1.0); otherwise everything is false so the framework\n * passes only the options an older engine understood. uWS-style modules (no\n * probe/serve) report all-false — their SSL/limits go through the uWS-specific\n * paths, not these flags.\n */\nexport function getEngineCapabilities(module: any): EngineCapabilities {\n  const surface = module?.default || module;\n  if (!surface || typeof surface !== 'object') return NO_CAPABILITIES;\n  const cached = capabilitiesCache.get(surface);\n  if (cached) return cached;\n\n  let caps: EngineCapabilities = NO_CAPABILITIES;\n  try {\n    if (typeof surface.probe === 'function') {\n      const probe = surface.probe();\n      const c = probe?.capabilities;\n      if (c && typeof c === 'object') {\n        caps = {\n          limits: c.limits === true,\n          tls: c.tls === true,\n          http2: c.http2 === true,\n          wsDeflate: c.wsDeflate === true,\n        };\n      }\n    }\n  } catch {\n    caps = NO_CAPABILITIES;\n  }\n  capabilitiesCache.set(surface, caps);\n  return caps;\n}\n\n// undefined = never attempted, null = attempted and failed\nlet cachedEngine: NativeEngineLoadResult | null | undefined;\nlet engineLoadErrors: string[] = [];\n\n/**\n * Locate the installed framework package directory so the engine (a dependency\n * of moro, not of the user's app) resolves under strict layouts like pnpm's.\n * Walks up from cwd looking for node_modules/@morojs/moro, resolving symlinks\n * so pnpm's store-linked layout anchors requires next to moro's own deps.\n * Inside the framework repo itself (tests, examples) cwd is the framework dir.\n */\nfunction findFrameworkAnchor(): ReturnType<typeof createRequire> | null {\n  // Primary: anchor to moro's OWN compiled location, so moro's `@morojs/engine`\n  // dependency resolves relative to where moro is installed regardless of\n  // `process.cwd()` (Docker WORKDIR, supervisord, pm2, a subdirectory, …). The\n  // cwd-based walk below is a defensive fallback for exotic layouts.\n  if (selfRequire) return selfRequire;\n\n  try {\n    const cwdPackageJson = join(process.cwd(), 'package.json');\n    if (existsSync(cwdPackageJson)) {\n      const require = createRequire(cwdPackageJson);\n      const name = require(cwdPackageJson)?.name;\n      if (name === FRAMEWORK_PACKAGE_NAME) {\n        return require;\n      }\n    }\n  } catch {\n    // fall through to the node_modules walk\n  }\n\n  let dir = process.cwd();\n  for (;;) {\n    const packageJson = join(dir, 'node_modules', '@morojs', 'moro', 'package.json');\n    try {\n      if (existsSync(packageJson)) {\n        return createRequire(join(realpathSync(dirname(packageJson)), 'package.json'));\n      }\n    } catch {\n      // unreadable/broken link - keep walking up\n    }\n    const parent = dirname(dir);\n    if (parent === dir) return null;\n    dir = parent;\n  }\n}\n\n/**\n * Synchronously load the native HTTP engine, trying '@morojs/engine' first and\n * falling back to a user-installed 'uWebSockets.js'. Loading is require-based\n * (both packages are CJS at their core - .node addon loading is require-based),\n * so the instance is shared with any later import() via the CJS module cache.\n *\n * The default call is memoized: the engine either loads once per process or it\n * doesn't. Failure details are retained for logging via\n * getNativeEngineLoadErrors().\n *\n * @param options.candidates - Override the probed package names (testing).\n *   When provided, the call bypasses the cache.\n * @returns The loaded engine and its source package, or null if none loads\n */\nexport function loadNativeEngine(options?: {\n  candidates?: readonly string[];\n  /** When provided, every per-attempt failure message is appended here, so a\n   *  candidate-override caller (which bypasses the memoized diagnostics) can\n   *  still report exactly WHY the engine didn't load — not just \"not installed\". */\n  collectErrors?: string[];\n}): NativeEngineLoadResult | null {\n  const useCache = !options?.candidates;\n  if (useCache && cachedEngine !== undefined) {\n    if (options?.collectErrors && !cachedEngine) {\n      options.collectErrors.push(...engineLoadErrors);\n    }\n    return cachedEngine;\n  }\n\n  const candidates = options?.candidates ?? NATIVE_ENGINE_PACKAGES;\n  const errors: string[] = [];\n  let result: NativeEngineLoadResult | null = null;\n\n  const frameworkRequire = findFrameworkAnchor();\n  const userRequire = createUserRequire();\n\n  for (const candidate of candidates) {\n    // Moro's own engine lives in moro's dependencies (framework anchor first);\n    // the legacy uWS peer dep lives in the user's node_modules (cwd first).\n    const anchors =\n      candidate === 'uWebSockets.js'\n        ? [userRequire, frameworkRequire]\n        : [frameworkRequire, userRequire];\n\n    for (const anchor of anchors) {\n      if (!anchor) continue;\n      try {\n        const module = anchor(candidate);\n        // Capability check: the HTTP server needs either a uWS-style App()\n        // factory or the Moro-shaped engine surface (serve()/respond()).\n        // A package that loads but can't serve (e.g. a pre-M1 @morojs/engine\n        // that only exposes probe()) must not shadow a usable alternative.\n        const surface = module?.default || module;\n        const uwsStyle = typeof surface?.App === 'function';\n        const moroStyle =\n          !uwsStyle &&\n          typeof surface?.serve === 'function' &&\n          typeof surface?.respond === 'function';\n        if (!uwsStyle && !moroStyle) {\n          errors.push(\n            `${candidate}: loaded but provides neither App() nor serve()/respond() - not a usable HTTP engine`\n          );\n          continue;\n        }\n        let version: string | undefined;\n        try {\n          // May be blocked by the package's exports map - version is optional\n          version = anchor(`${candidate}/package.json`)?.version;\n        } catch {\n          version = undefined;\n        }\n        result = {\n          module,\n          source: candidate,\n          ...(version !== undefined ? { version } : {}),\n          capabilities: moroStyle ? getEngineCapabilities(module) : NO_CAPABILITIES,\n        };\n        break;\n      } catch (error) {\n        const message = error instanceof Error ? error.message.split('\\n')[0] : String(error);\n        errors.push(`${candidate}: ${message}`);\n      }\n    }\n    if (result) break;\n  }\n\n  // Candidate-override probes (e.g. the clustering worker's uWS-only check)\n  // must not clobber the diagnostics of the real default load, which\n  // framework startup logging reads via getNativeEngineLoadErrors().\n  if (useCache) {\n    engineLoadErrors = result ? [] : [...new Set(errors)];\n    cachedEngine = result;\n  }\n  // Hand this specific call's failure detail back to a caller that asked for it,\n  // regardless of caching (so 'moro'/'uws' fallback reasons are precise).\n  if (options?.collectErrors && !result) {\n    options.collectErrors.push(...new Set(errors));\n  }\n  return result;\n}\n\n/**\n * Failure details from the most recent unsuccessful loadNativeEngine() call,\n * one entry per package/anchor attempt. Empty after a successful load.\n */\nexport function getNativeEngineLoadErrors(): readonly string[] {\n  return engineLoadErrors;\n}\n\n/**\n * Clear the memoized engine load result. Testing only.\n */\nexport function resetNativeEngineLoaderForTesting(): void {\n  cachedEngine = undefined;\n  engineLoadErrors = [];\n}\n\n/**\n * Convert a file path to a file URL for ESM dynamic imports\n * This is required on Windows where absolute paths like C:\\path\\to\\module\n * need to be converted to file:/// URLs for dynamic import() to work\n *\n * @param filePath - The file path to convert (absolute or relative)\n * @returns A proper URL string for ESM import() that works cross-platform\n *\n * @example\n * const modulePath = 'C:\\\\Users\\\\project\\\\module.js';\n * const module = await import(filePathToImportURL(modulePath));\n */\nexport function filePathToImportURL(filePath: string): string {\n  if (!filePath) {\n    return filePath;\n  }\n\n  // If it's already a URL (starts with file:// or http(s)://), return as-is\n  if (\n    filePath.startsWith('file://') ||\n    filePath.startsWith('http://') ||\n    filePath.startsWith('https://')\n  ) {\n    return filePath;\n  }\n\n  // Check if it's a Windows absolute path (C:\\ or C:/)\n  const windowsAbsolutePathRegex = /^[A-Za-z]:[\\\\//]/;\n  const isWindowsAbsolute = windowsAbsolutePathRegex.test(filePath);\n\n  // Check if it's a Unix absolute path (starts with /)\n  const isUnixAbsolute = filePath.startsWith('/');\n\n  // Check if it's a Windows UNC path (\\\\server\\share)\n  const isWindowsUNC = filePath.startsWith('\\\\\\\\');\n\n  // Convert absolute paths to file URLs\n  if (isWindowsAbsolute || isUnixAbsolute || isWindowsUNC) {\n    return pathToFileURL(filePath).href;\n  }\n\n  // For relative paths, return as-is (they work in import())\n  return filePath;\n}\n"]}

package/dist/core/utilities/self-require.d.ts

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module';
+export declare const selfRequire: ReturnType<typeof createRequire>;

package/dist/core/utilities/self-require.js

@@ -0,0 +1,13 @@
+// This file exists solely to isolate the ESM-only `import.meta` token (like
+// worker-entry.ts): ts-jest transpiles to CommonJS, where `import.meta` is a
+// load-time SyntaxError, so jest.config maps this module to a stub.
+//
+// `selfRequire` resolves modules relative to moro's OWN compiled location, so
+// moro's `@morojs/engine` dependency loads regardless of `process.cwd()`. Without
+// this, the engine silently falls back to the Node http server whenever the
+// process runs from a directory other than the app root (Docker WORKDIR,
+// supervisord, pm2, a subdirectory, …) — because the resolver walked up from
+// the cwd instead of from where moro is installed.
+import { createRequire } from 'node:module';
+export const selfRequire = createRequire(import.meta.url);
+//# sourceMappingURL=self-require.js.map

package/dist/core/utilities/self-require.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-require.js","sourceRoot":"","sources":["../../../src/core/utilities/self-require.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,oEAAoE;AACpE,EAAE;AACF,8EAA8E;AAC9E,kFAAkF;AAClF,4EAA4E;AAC5E,yEAAyE;AACzE,6EAA6E;AAC7E,mDAAmD;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,WAAW,GAAqC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC","sourcesContent":["// This file exists solely to isolate the ESM-only `import.meta` token (like\n// worker-entry.ts): ts-jest transpiles to CommonJS, where `import.meta` is a\n// load-time SyntaxError, so jest.config maps this module to a stub.\n//\n// `selfRequire` resolves modules relative to moro's OWN compiled location, so\n// moro's `@morojs/engine` dependency loads regardless of `process.cwd()`. Without\n// this, the engine silently falls back to the Node http server whenever the\n// process runs from a directory other than the app root (Docker WORKDIR,\n// supervisord, pm2, a subdirectory, …) — because the resolver walked up from\n// the cwd instead of from where moro is installed.\nimport { createRequire } from 'node:module';\n\nexport const selfRequire: ReturnType<typeof createRequire> = createRequire(import.meta.url);\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morojs/moro",
-  "version": "1.8.2",
+  "version": "1.8.3",
   "description": "High-performance Node.js framework with intelligent routing, automatic middleware ordering, enterprise authentication (Better Auth), type-safe validation, and functional architecture",
   "type": "module",
   "main": "dist/index.js",