chore: crush git history - reborn from consolidation on 2026-03-10

src/cli/core/app-loader.ts

@@ -0,0 +1,101 @@
+/**
+ * App loader utility for CLI commands.
+ * Handles various app export patterns and module systems.
+ */
+
+import { resolve } from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+export interface LoadedApp {
+  fastify: unknown
+  source: 'default' | 'named' | 'commonjs'
+}
+
+/**
+ * Load a Fastify app from app.js in the given directory.
+ * Supports:
+ * - ESM default export: export default fastifyInstance
+ * - ESM named export: export const createApp = () => fastifyInstance
+ * - CommonJS: module.exports = fastifyInstance
+ * - CommonJS named: exports.createApp = () => fastifyInstance
+ */
+export async function loadApp(cwd: string): Promise<LoadedApp> {
+  const appPath = resolve(cwd, 'app.js')
+  const appUrl = pathToFileURL(appPath).href + '?t=' + Date.now()
+
+  let appModule: Record<string, unknown>
+  try {
+    appModule = await import(appUrl) as Record<string, unknown>
+  } catch (err) {
+    throw new AppLoadError(
+      `Cannot load app.js: ${err instanceof Error ? err.message : String(err)}`,
+      'import_failed',
+    )
+  }
+
+  // Try default export first
+  if (appModule.default && isFastifyInstance(appModule.default)) {
+    return { fastify: appModule.default, source: 'default' }
+  }
+
+  // Try named exports that look like Fastify instances or factory functions
+  for (const [key, value] of Object.entries(appModule)) {
+    if (key === 'default') continue
+
+    if (isFastifyInstance(value)) {
+      return { fastify: value, source: 'named' }
+    }
+
+    // Try calling factory functions
+    if (typeof value === 'function' && !isClass(value)) {
+      try {
+        const result = await value()
+        if (isFastifyInstance(result)) {
+          return { fastify: result, source: 'named' }
+        }
+      } catch {
+        // Factory function failed, try next
+      }
+    }
+  }
+
+  // If module itself is a Fastify instance (CommonJS)
+  if (isFastifyInstance(appModule)) {
+    return { fastify: appModule, source: 'commonjs' }
+  }
+
+  throw new AppLoadError(
+    'No Fastify instance found in app.js. Ensure app.js exports a Fastify instance or a factory function.',
+    'no_fastify',
+  )
+}
+
+/**
+ * Check if a value looks like a Fastify instance.
+ */
+function isFastifyInstance(value: unknown): boolean {
+  return value !== null &&
+    typeof value === 'object' &&
+    typeof (value as Record<string, unknown>).ready === 'function'
+}
+
+/**
+ * Check if a function is a class constructor.
+ */
+function isClass(fn: unknown): boolean {
+  return typeof fn === 'function' &&
+    fn.toString().startsWith('class ')
+}
+
+/**
+ * Error type for app loading failures.
+ */
+export class AppLoadError extends Error {
+  constructor(
+    message: string,
+    public readonly code: 'import_failed' | 'no_fastify',
+  ) {
+    super(message)
+    this.name = 'AppLoadError'
+  }
+}