@nwire/cli 0.12.1 → 0.13.0

package/dist/cache-runner.js

@@ -1,206 +0,0 @@
-// Cache runner — invoked by `nwire cache`. Imports the consumer's apps
-// registry (resolved via nwire.config.ts or fallback paths), builds the
-// cache, writes .nwire/.
-//
-// User code follows the bundler-style extensionless-import convention
-// (e.g. `import { x } from './foo'` resolving `./foo.ts`), so we load
-// it through jiti rather than Node's strict ESM loader — jiti gives us
-// TS-on-the-fly + the same resolution semantics the dev server uses.
-import { resolve } from "node:path";
-import { createJiti } from "jiti";
-import { buildCache, writeCache } from "@nwire/scan";
-import { loadConfig, resolveAppsEntry } from "./load-config.js";
-async function main() {
-    const cwd = process.cwd();
-    const config = await loadConfig(cwd);
-    const appsPath = resolveAppsEntry(cwd, config);
-    const jiti = createJiti(cwd, {
-        fsCache: false,
-        moduleCache: false,
-        interopDefault: true,
-    });
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const mod = await jiti.import(appsPath);
-    // Resolve apps registry in this order:
-    //   1. named export `allApps: App[]`
-    //   2. named export `apps: App[]`
-    //   3. default export — either App[] or a single App
-    //   4. named export `app: App`
-    //   5. any single exported App the module declares
-    //
-    // "App" means either:
-    //   - `AppDefinition` (legacy `defineApp(name, { modules })`)
-    //   - bootable `App` (modern `createApp({ modules })`)
-    // `createApp` returns an App marked with `$nwireApp: true`.
-    // Recognized export names:
-    //   - allApps: App[] | apps: App[]
-    //   - default: App | App[]
-    //   - app: App
-    //   - buildApp(): App | Promise<App>          ← factory pattern
-    //   - bootstrap(): { app: App, ... }          ← test-bootstrap pattern
-    //   - bootstrap(opts): { app: App, ... }
-    //
-    // Factory results that boot the App themselves (bootstrap functions
-    // that call .start() and run an endpoint) are also accepted — we
-    // pull the App handle off the return value and skip the start/stop
-    // dance.
-    let apps = [];
-    let appsAlreadyBooted = false;
-    if (Array.isArray(mod.allApps))
-        apps = mod.allApps;
-    else if (Array.isArray(mod.apps))
-        apps = mod.apps;
-    else if (Array.isArray(mod.default))
-        apps = mod.default;
-    else if (isAppLike(mod.default))
-        apps = [mod.default];
-    else if (isAppLike(mod.app))
-        apps = [mod.app];
-    else if (typeof mod.buildApp === "function") {
-        const built = await mod.buildApp();
-        const candidate = isAppLike(built) ? built : findAppInResult(built);
-        if (isAppLike(candidate))
-            apps = [candidate];
-    }
-    else if (typeof mod.bootstrap === "function") {
-        // Bootstrap usually starts the App and runs an endpoint. We try
-        // common signatures: `bootstrap({port,test})`, `bootstrap(port?)`.
-        // Returned shape is anything from { app, running } to { nest, nwireApp }
-        // to a bare App — we duck-find the first $nwireApp value in the result.
-        //
-        // 10s watchdog: some bootstrap functions never resolve (e.g. they
-        // wait on Nest's signal-driven lifecycle). The scanner falls back to
-        // "no apps found" rather than hanging the build pipeline.
-        const callWithTimeout = async (fn) => {
-            return await Promise.race([
-                fn(),
-                new Promise((_, reject) => setTimeout(() => reject(new Error("bootstrap watchdog (10s)")), 10_000)),
-            ]);
-        };
-        let result;
-        try {
-            result = await callWithTimeout(() => mod.bootstrap({ port: 0, test: true }));
-        }
-        catch {
-            try {
-                result = await callWithTimeout(() => mod.bootstrap(0));
-            }
-            catch {
-                /* unscannable — leave apps empty */
-            }
-        }
-        const candidate = isAppLike(result) ? result : findAppInResult(result);
-        if (isAppLike(candidate)) {
-            apps = [candidate];
-            appsAlreadyBooted = true;
-            // Tear down the endpoint the bootstrap opened — we only need the
-            // App's runtime state for the scan.
-            const r = result;
-            if (typeof r?.running?.shutdown === "function") {
-                try {
-                    await r.running.shutdown("scan");
-                }
-                catch {
-                    /* ignore */
-                }
-            }
-        }
-    }
-    if (apps.length === 0) {
-        apps = Object.values(mod).filter(isAppLike);
-    }
-    if (apps.length === 0) {
-        console.error(`nwire cache: no apps found in ${appsPath}.\n` +
-            `Expected one of: exported \`app\`, \`apps\`, \`allApps\`, or a \`buildApp()\` factory returning an App from createApp.\n` +
-            `Optional: nwire.config.ts with { appsEntry: "..." } to point at a custom location.`);
-        process.exit(1);
-    }
-    // The forge plugin registers handlers/actors/projections/queries on the
-    // dispatcher during the AppBooting hook — so the dispatcher is only
-    // populated AFTER `app.start()`. Boot each app for the scan (unless the
-    // bootstrap factory already did), then stop it.
-    if (!appsAlreadyBooted) {
-        for (const a of apps) {
-            const app = a;
-            if (app.$nwireApp && typeof app.start === "function") {
-                await app.start();
-            }
-        }
-    }
-    const normalized = apps.map(toAppDefinitionShape);
-    const cache = buildCache(normalized);
-    for (const a of apps) {
-        const app = a;
-        if (app.$nwireApp && typeof app.stop === "function") {
-            try {
-                await app.stop();
-            }
-            catch {
-                /* ignore — the bootstrap may have already torn things down */
-            }
-        }
-    }
-    const outDir = resolve(cwd, config.cacheDir ?? ".nwire");
-    await writeCache(cache, outDir);
-    // eslint-disable-next-line no-console
-    console.log(`nwire cache: wrote ${cache.apps.length} apps, ${cache.plugins.length} plugins, ` +
-        `${cache.actions.length} actions, ${cache.events.length} events, ` +
-        `${cache.hooks.length} hooks, ${cache.sinks.length} sinks, ` +
-        `${cache.resolvers.length} resolvers to ${outDir}/`);
-    // Some bootstrap functions leave foreign-framework servers (Nest,
-    // Fastify) listening even after we tear down the Nwire side. Force
-    // process exit so the scan doesn't hang the CI pipeline.
-    process.exit(0);
-}
-function isAppLike(x) {
-    if (typeof x !== "object" || x === null)
-        return false;
-    const a = x;
-    return a.$kind === "app-definition" || a.$nwireApp === true;
-}
-/**
- * Bootstrap/factory functions return wrapper objects in many shapes —
- * `{ app, running }`, `{ nest, nwireApp }`, `{ app, close }`, etc.
- * Find the first property whose value is App-like.
- */
-function findAppInResult(result) {
-    if (typeof result !== "object" || result === null)
-        return undefined;
-    for (const value of Object.values(result)) {
-        if (isAppLike(value))
-            return value;
-    }
-    return undefined;
-}
-/**
- * Normalize either flavor of "app" into the AppDefinition shape the
- * scanner reads. `createApp` returns an `App` with `appName` + the
- * bootable runtime; `defineApp` returns `AppDefinition` with `name` +
- * static metadata. Both expose `modules`, which is all we need.
- */
-function toAppDefinitionShape(x) {
-    const a = x;
-    const name = a.appName ?? a.name ?? "app";
-    return {
-        // Forward both fields — the scanner reads `appName`; legacy
-        // consumers may still read `name`.
-        name,
-        appName: name,
-        description: a.description,
-        plugins: a.plugins ?? [],
-        // Forward operator commands defensively. Consumers who attach a
-        // `commands: defineCommand[]` to their app flow it through to the
-        // scan emitter so `.nwire/commands.json` reflects ops surface.
-        commands: a.commands ?? [],
-        tenantModel: a.tenantModel,
-        tenantKey: a.tenantKey,
-        // Forward the container so the scanner can walk `container.list()`,
-        // resolve the forge dispatcher, and emit DI bindings.
-        container: a.container ?? a.runtime?.container,
-        runtime: a.runtime,
-    };
-}
-main().catch((err) => {
-    console.error(err);
-    process.exit(1);
-});