@nocobase/app-server 0.11.1-alpha.5 → 2.0.0-beta.1

package/dist/node/server.js

@@ -0,0 +1,283 @@
+import { serve } from '@hono/node-server';
+import { acceptWebSocketUpgrade, createWebSocketUpgradeRequest, isWebSocketUpgrade, rejectWebSocketUpgrade, } from '@nocobase/app-websocket';
+export const DEFAULT_HTTP_DRAIN_TIMEOUT_MS = 30_000;
+export const DEFAULT_FORCE_EXIT_TIMEOUT_MS = 35_000;
+/**
+ * Total shutdown budget, when the host supplies one. A supervisor that kills
+ * the process after a fixed wait — `tsx watch` escalates to SIGKILL after five
+ * seconds — makes the 30 second default unreachable, and a hard kill during
+ * startup or shutdown leaves the migration lock held.
+ */
+export const SHUTDOWN_TIMEOUT_ENV = 'APP_SHUTDOWN_TIMEOUT_MS';
+/** How much of the budget is reserved for closing what the drain leaves. */
+const SHUTDOWN_FORCE_EXIT_MARGIN_MS = 1_000;
+const MIN_HTTP_DRAIN_TIMEOUT_MS = 250;
+const defaultLogger = {
+    error: (message, error) => {
+        if (error === undefined) {
+            console.error(message);
+            return;
+        }
+        console.error(message, error);
+    },
+};
+/**
+ * Reads the shutdown budget from the environment. An unset or unusable value
+ * keeps the defaults, which suit a deployment behind a load balancer.
+ */
+export function resolveNodeShutdownTimeouts(env) {
+    const budget = Number(env[SHUTDOWN_TIMEOUT_ENV]);
+    if (!Number.isFinite(budget) || budget <= 0)
+        return {};
+    return {
+        forceExitTimeoutMs: budget,
+        httpDrainTimeoutMs: Math.max(budget - SHUTDOWN_FORCE_EXIT_MARGIN_MS, MIN_HTTP_DRAIN_TIMEOUT_MS),
+    };
+}
+export function startNodeAppServer(app, options) {
+    const logger = options.logger ?? defaultLogger;
+    return new Promise((resolve, reject) => {
+        let listening = false;
+        let unregisterShutdownHandlers = () => undefined;
+        const server = serve({
+            fetch: app.fetch,
+            hostname: options.hostname,
+            port: options.port,
+        }, (info) => {
+            listening = true;
+            try {
+                options.onListen?.(info);
+                resolve(server);
+            }
+            catch (error) {
+                const listenError = toError(error);
+                unregisterShutdownHandlers();
+                closeNodeServer(server).then(() => reject(listenError), (closeError) => reject(new AggregateError([listenError, closeError], 'Node app server listen callback and cleanup failed', { cause: closeError })));
+            }
+        });
+        server.on('error', (error) => {
+            if (!listening) {
+                unregisterShutdownHandlers();
+                reject(toError(error));
+                return;
+            }
+            logger.error('Node app server failed after it started.', error);
+            process.exitCode = 1;
+        });
+        registerNodeWebSocketUpgradeHandler(app, server, { logger });
+        server.once('close', () => app.proxy?.close());
+        if (options.registerProcessSignals !== false) {
+            unregisterShutdownHandlers = registerNodeShutdownHandlers(app, server, options);
+        }
+    });
+}
+export function registerNodeWebSocketUpgradeHandler(app, server, options = {}) {
+    const logger = options.logger ?? defaultLogger;
+    server.on('upgrade', (req, socket, head) => {
+        const dispatchPromise = dispatchNodeWebSocket(req, socket, head, app);
+        dispatchPromise.catch((error) => {
+            logger.error('WebSocket upgrade dispatch failed.', error);
+            rejectWebSocketUpgrade(socket, 500);
+        });
+    });
+}
+export function registerNodeShutdownHandlers(app, server, options = {}) {
+    const logger = options.logger ?? defaultLogger;
+    let shuttingDown = false;
+    let shutdownPromise;
+    const handleShutdown = (signal) => {
+        if (shuttingDown) {
+            logger.error(`Received ${signal} during app server shutdown; forcing exit.`);
+            closeAllConnections(server);
+            process.exit(1);
+        }
+        shuttingDown = true;
+        shutdownPromise ??= shutdownNodeAppServer(app, server, signal, options);
+        void shutdownPromise
+            .catch((error) => {
+            logger.error('App server shutdown failed.', error);
+            process.exitCode = 1;
+        })
+            .finally(unregister);
+    };
+    const handleSigint = () => handleShutdown('SIGINT');
+    const handleSigterm = () => handleShutdown('SIGTERM');
+    const handleServerClose = () => {
+        if (!shuttingDown)
+            unregister();
+    };
+    const unregister = () => {
+        process.off('SIGINT', handleSigint);
+        process.off('SIGTERM', handleSigterm);
+        server.off('close', handleServerClose);
+    };
+    process.on('SIGINT', handleSigint);
+    process.on('SIGTERM', handleSigterm);
+    server.once('close', handleServerClose);
+    return unregister;
+}
+export const DEFAULT_STARTUP_SIGNALS = [
+    'SIGINT',
+    'SIGTERM',
+];
+/**
+ * Covers the window before the HTTP server owns the signals, which is where
+ * startup runs migrations and seeds. Node's default disposition terminates the
+ * process on SIGTERM, so without this the task lock is abandoned held and the
+ * next start has to wait it out. Recording the signal and letting startup
+ * finish releases the lock the ordinary way; the caller then shuts down
+ * instead of listening.
+ */
+export function watchStartupShutdownSignals(options = {}) {
+    const logger = options.logger ?? defaultLogger;
+    const emitter = options.emitter ?? process;
+    const forceExit = options.forceExit ?? ((code) => process.exit(code));
+    const signals = options.signals ?? DEFAULT_STARTUP_SIGNALS;
+    let received;
+    const listeners = new Map();
+    const dispose = () => {
+        for (const [signal, listener] of listeners) {
+            emitter.off(signal, listener);
+        }
+        listeners.clear();
+    };
+    for (const signal of signals) {
+        const listener = () => {
+            if (received) {
+                logger.error(`Received ${signal} again while the app server was still starting; forcing exit.`);
+                forceExit(1);
+                return;
+            }
+            received = signal;
+            logger.error(`Received ${signal} while the app server was starting; finishing startup tasks before shutting down.`);
+        };
+        listeners.set(signal, listener);
+        emitter.on(signal, listener);
+    }
+    return {
+        received: () => received,
+        dispose,
+    };
+}
+export async function shutdownNodeAppServer(app, server, signal, options = {}) {
+    const logger = options.logger ?? defaultLogger;
+    const forceExitTimeoutMs = options.forceExitTimeoutMs ?? DEFAULT_FORCE_EXIT_TIMEOUT_MS;
+    const forceExitTimer = setTimeout(() => {
+        logger.error(`App server shutdown after ${signal} exceeded ${forceExitTimeoutMs}ms; forcing exit.`);
+        closeAllConnections(server);
+        process.exit(1);
+    }, forceExitTimeoutMs);
+    forceExitTimer.unref();
+    try {
+        app.proxy?.closeWebSockets();
+        await closeNodeServerWithGracePeriod(server, options.httpDrainTimeoutMs ?? DEFAULT_HTTP_DRAIN_TIMEOUT_MS, logger);
+    }
+    finally {
+        try {
+            await app.close();
+        }
+        finally {
+            clearTimeout(forceExitTimer);
+        }
+    }
+}
+export async function closeNodeServerWithGracePeriod(server, timeoutMs, logger = defaultLogger) {
+    const closePromise = closeNodeServer(server);
+    let timeout;
+    let timedOut = false;
+    closeIdleConnections(server);
+    const timeoutPromise = new Promise((resolve) => {
+        timeout = setTimeout(() => {
+            timedOut = true;
+            logger.error(`HTTP server did not drain within ${timeoutMs}ms; closing active connections.`);
+            closeAllConnections(server);
+            resolve();
+        }, timeoutMs);
+        timeout.unref();
+    });
+    try {
+        await Promise.race([closePromise, timeoutPromise]);
+        if (timedOut) {
+            closePromise.catch((error) => {
+                logger.error('HTTP server close failed after the drain timeout.', error);
+            });
+        }
+    }
+    finally {
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+    }
+}
+export function closeNodeServer(server) {
+    return new Promise((resolve, reject) => {
+        server.close((error) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve();
+        });
+    });
+}
+export async function disposeAfterStartupFailure(dispose, startupError) {
+    try {
+        await dispose();
+    }
+    catch (disposeError) {
+        throw new AggregateError([startupError, disposeError], 'Failed to start server and dispose resources', { cause: disposeError });
+    }
+    throw startupError;
+}
+async function dispatchNodeWebSocket(req, socket, head, app) {
+    if (!isWebSocketUpgrade(req)) {
+        rejectWebSocketUpgrade(socket, 400);
+        return;
+    }
+    if (app.proxy?.matches(new URL(createWebSocketUpgradeRequest(req).url).pathname)) {
+        await app.proxy.upgrade(req, socket, head);
+        return;
+    }
+    const websocket = app.websocket;
+    if (!websocket) {
+        rejectWebSocketUpgrade(socket, 404);
+        return;
+    }
+    const signal = 'signal' in app && app.signal instanceof AbortSignal
+        ? app.signal
+        : undefined;
+    const request = createWebSocketUpgradeRequest(req, { signal });
+    const result = await websocket(request, { signal });
+    if (result instanceof Response) {
+        rejectWebSocketUpgrade(socket, result.status, result.headers);
+        return;
+    }
+    if (!result) {
+        rejectWebSocketUpgrade(socket, 404);
+        return;
+    }
+    acceptWebSocketUpgrade(req, socket, {
+        request,
+        events: result,
+        head,
+        signal,
+    });
+}
+function closeIdleConnections(server) {
+    if ('closeIdleConnections' in server &&
+        typeof server.closeIdleConnections === 'function') {
+        server.closeIdleConnections();
+    }
+}
+function closeAllConnections(server) {
+    if ('closeAllConnections' in server &&
+        typeof server.closeAllConnections === 'function') {
+        server.closeAllConnections();
+    }
+}
+function toError(value) {
+    return value instanceof Error
+        ? value
+        : new Error(String(value), { cause: value });
+}
+//# sourceMappingURL=server.js.map

package/dist/node/server.js.map

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

package/dist/plugins/define.d.ts

@@ -0,0 +1,4 @@
+import type { AppServerPlugin, AppServerPluginDefinition, AppServerPlugins } from './types.js';
+export declare function defineServerPlugin<TConfig = object>(definition: AppServerPluginDefinition<TConfig>): AppServerPlugin<TConfig>;
+export declare function defineServerPlugins(plugins: readonly AppServerPlugin[]): AppServerPlugins;
+//# sourceMappingURL=define.d.ts.map

package/dist/plugins/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/plugins/define.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAIpB,wBAAgB,kBAAkB,CAAC,OAAO,GAAG,MAAM,EACjD,UAAU,EAAE,yBAAyB,CAAC,OAAO,CAAC,GAC7C,eAAe,CAAC,OAAO,CAAC,CA8B1B;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,gBAAgB,CAYlB"}

package/dist/plugins/define.js

@@ -0,0 +1,45 @@
+import path from 'node:path';
+const PACKAGE_NAME_PATTERN = /^@[a-z0-9][a-z0-9-]*\/[a-z0-9][a-z0-9-]*$/;
+export function defineServerPlugin(definition) {
+    const packageName = normalizePackageName(definition.packageName);
+    if (typeof definition.baseDir !== 'string' ||
+        !path.isAbsolute(definition.baseDir)) {
+        throw new Error(`Server plugin "${packageName}" requires an absolute baseDir. Set baseDir relative to the declaring module with import.meta.dirname.`);
+    }
+    return Object.freeze({
+        packageName,
+        baseDir: path.normalize(definition.baseDir),
+        serviceProviders: Object.freeze([...(definition.serviceProviders ?? [])]),
+        routes: Object.freeze([...(definition.routes ?? [])]),
+        database: definition.database
+            ? Object.freeze({ ...definition.database })
+            : undefined,
+        queue: definition.queue
+            ? Object.freeze({
+                ...definition.queue,
+                jobs: definition.queue.jobs
+                    ? Object.freeze([...definition.queue.jobs])
+                    : undefined,
+            })
+            : undefined,
+        locales: definition.locales,
+    });
+}
+export function defineServerPlugins(plugins) {
+    const seen = new Set();
+    for (const plugin of plugins) {
+        if (seen.has(plugin.packageName)) {
+            throw new Error(`Server plugin "${plugin.packageName}" is registered more than once.`);
+        }
+        seen.add(plugin.packageName);
+    }
+    return Object.freeze({ plugins: Object.freeze([...plugins]) });
+}
+function normalizePackageName(packageName) {
+    const normalized = packageName.trim();
+    if (!PACKAGE_NAME_PATTERN.test(normalized)) {
+        throw new Error(`Server plugin package name "${packageName}" must be a valid scoped package name.`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=define.js.map

package/dist/plugins/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/plugins/define.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B,MAAM,oBAAoB,GAAG,2CAA2C,CAAC;AAEzE,MAAM,UAAU,kBAAkB,CAChC,UAA8C;IAE9C,MAAM,WAAW,GAAG,oBAAoB,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAEjE,IACE,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ;QACtC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,EACpC,CAAC;QACD,MAAM,IAAI,KAAK,CACb,kBAAkB,WAAW,wGAAwG,CACtI,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,WAAW;QACX,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC;QAC3C,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;QACrD,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC3B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC3C,CAAC,CAAC,SAAS;QACb,KAAK,EAAE,UAAU,CAAC,KAAK;YACrB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;gBACZ,GAAG,UAAU,CAAC,KAAK;gBACnB,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI;oBACzB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC3C,CAAC,CAAC,SAAS;aACd,CAAC;YACJ,CAAC,CAAC,SAAS;QACb,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAmC;IAEnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,CAAC,WAAW,iCAAiC,CACtE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,oBAAoB,CAAC,WAAmB;IAC/C,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,+BAA+B,WAAW,wCAAwC,CACnF,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,27 @@
+export { defineServerPlugin, defineServerPlugins } from './define.js';
+export { inspectResolvedAppServerPlugins, type AppServerDatabaseSnapshot, type AppServerInspectionIssue, type AppServerInspectionSnapshot, type AppServerJobsSnapshot, type AppServerPluginSnapshot, type AppServerProviderSnapshot, type AppServerRouteSnapshot, } from './inspect.js';
+export { createAppDatabaseTaskContributions, createPluginJobLocations, createPluginMigrationSources, createPluginSeedSources, resolveAppServerPlugins, type ResolveAppServerPluginsOptions, } from './resolve.js';
+export type * from './types.js';
+import type { Hono } from 'hono';
+import type { AppPaths } from '../config/types.js';
+export interface AppPluginRoutesContext<TDeps = unknown, TServices = unknown, TConfig = unknown> {
+    readonly app: Hono;
+    readonly config: TConfig;
+    readonly deps: TDeps;
+    readonly services: TServices;
+    readonly paths: AppPaths;
+}
+export type AppPluginDisposer = () => void | Promise<void>;
+export interface AppPluginLifecycle {
+    registerDisposer(name: string, dispose: AppPluginDisposer): void;
+}
+export interface AppPluginServerContext<TDeps = unknown, TServices = unknown, TConfig = unknown> {
+    readonly config: TConfig;
+    readonly deps: TDeps;
+    readonly services: TServices;
+    readonly lifecycle: AppPluginLifecycle;
+    readonly paths: AppPaths;
+}
+export type AppPluginBootstrap<TDeps = unknown, TServices = unknown, TConfig = unknown> = (context: AppPluginServerContext<TDeps, TServices, TConfig>) => void;
+export type AppPluginRoutesRegistrar<TDeps = unknown, TServices = unknown, TConfig = unknown> = (context: AppPluginRoutesContext<TDeps, TServices, TConfig>) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EACL,+BAA+B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,GAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kCAAkC,EAClC,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,8BAA8B,GACpC,MAAM,cAAc,CAAC;AACtB,mBAAmB,YAAY,CAAC;AAEhC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,sBAAsB,CACrC,KAAK,GAAG,OAAO,EACf,SAAS,GAAG,OAAO,EACnB,OAAO,GAAG,OAAO;IAEjB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,sBAAsB,CACrC,KAAK,GAAG,OAAO,EACf,SAAS,GAAG,OAAO,EACnB,OAAO,GAAG,OAAO;IAEjB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AAED,MAAM,MAAM,kBAAkB,CAC5B,KAAK,GAAG,OAAO,EACf,SAAS,GAAG,OAAO,EACnB,OAAO,GAAG,OAAO,IACf,CAAC,OAAO,EAAE,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAEzE,MAAM,MAAM,wBAAwB,CAClC,KAAK,GAAG,OAAO,EACf,SAAS,GAAG,OAAO,EACnB,OAAO,GAAG,OAAO,IACf,CAAC,OAAO,EAAE,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,4 @@
+export { defineServerPlugin, defineServerPlugins } from './define.js';
+export { inspectResolvedAppServerPlugins, } from './inspect.js';
+export { createAppDatabaseTaskContributions, createPluginJobLocations, createPluginMigrationSources, createPluginSeedSources, resolveAppServerPlugins, } from './resolve.js';
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EACL,+BAA+B,GAQhC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kCAAkC,EAClC,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,GAExB,MAAM,cAAc,CAAC"}

package/dist/plugins/inspect.d.ts

@@ -0,0 +1,79 @@
+import type { ResolvedAppServerPlugins } from './types.js';
+export interface AppServerInspectionIssue {
+    readonly code: 'SERVER_MIGRATIONS_DIRECTORY_MISSING' | 'SERVER_SEEDS_DIRECTORY_MISSING' | 'SERVER_QUEUE_JOBS_DEPRECATED';
+    readonly message: string;
+    readonly packageName: string;
+    /** Only errors make an inspection inconsistent. */
+    readonly severity: 'error' | 'warning';
+}
+export interface AppServerProviderSnapshot {
+    readonly order: number;
+    readonly pluginOrder: number;
+    readonly packageName: string;
+    readonly constructorName: string;
+}
+export interface AppServerRouteSnapshot {
+    readonly order: number;
+    readonly pluginOrder: number;
+    readonly contributionOrder: number;
+    readonly packageName: string;
+    readonly scope: 'api' | 'root';
+}
+export interface AppServerLocalesSnapshot {
+    readonly order: number;
+    readonly pluginOrder: number;
+    readonly packageName: string;
+}
+export interface AppServerDatabaseSnapshot {
+    readonly packageName: string;
+    readonly migrations?: {
+        readonly configured: string;
+        readonly resolved?: string;
+    };
+    readonly seeds?: {
+        readonly configured: string;
+        readonly resolved?: string;
+    };
+}
+/** A deprecated `queue.jobs` declaration, reported rather than resolved. */
+export interface AppServerJobsSnapshot {
+    readonly packageName: string;
+    readonly configuredLocations: readonly string[];
+}
+export interface AppServerPluginSnapshot {
+    readonly order: number;
+    readonly packageName: string;
+    readonly version: string;
+    readonly rootDir: string;
+    readonly baseDir: string;
+    readonly contributions: {
+        readonly serviceProviders: number;
+        readonly routes: number;
+        readonly locales: boolean;
+        readonly migrations: boolean;
+        readonly seeds: boolean;
+        /** Deprecated `queue.jobs` locations the plugin still declares; none is loaded. */
+        readonly jobLocations: number;
+    };
+}
+export interface AppServerInspectionSnapshot {
+    readonly app: {
+        readonly packageName: string;
+    };
+    readonly plugins: readonly AppServerPluginSnapshot[];
+    readonly serviceProviders: readonly AppServerProviderSnapshot[];
+    readonly routes: readonly AppServerRouteSnapshot[];
+    readonly locales: readonly AppServerLocalesSnapshot[];
+    readonly database: readonly AppServerDatabaseSnapshot[];
+    readonly jobs: readonly AppServerJobsSnapshot[];
+    readonly consistent: boolean;
+    readonly issues: readonly AppServerInspectionIssue[];
+    readonly suggestions: readonly string[];
+}
+/**
+ * Describes imported Server plugin declarations and resolved contribution locations without constructing Providers,
+ * running lifecycle code, executing Route factories, or loading locale resources.
+ * Importing the declarations remains the caller's responsibility and may execute module initialization code.
+ */
+export declare function inspectResolvedAppServerPlugins(resolved: ResolvedAppServerPlugins): AppServerInspectionSnapshot;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/plugins/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/plugins/inspect.ts"],"names":[],"mappings":"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"}

package/dist/plugins/inspect.js

@@ -0,0 +1,142 @@
+import path from 'node:path';
+/**
+ * Describes imported Server plugin declarations and resolved contribution locations without constructing Providers,
+ * running lifecycle code, executing Route factories, or loading locale resources.
+ * Importing the declarations remains the caller's responsibility and may execute module initialization code.
+ */
+export function inspectResolvedAppServerPlugins(resolved) {
+    const serviceProviders = [];
+    const routes = [];
+    const locales = [];
+    const database = [];
+    const jobs = [];
+    const issues = [];
+    let providerOrder = 0;
+    let routeOrder = 0;
+    const plugins = resolved.plugins.map((plugin, index) => {
+        const pluginOrder = index + 1;
+        if (plugin.definition.locales) {
+            locales.push({
+                order: locales.length + 1,
+                pluginOrder,
+                packageName: plugin.metadata.packageName,
+            });
+        }
+        plugin.definition.serviceProviders.forEach((Provider) => {
+            providerOrder += 1;
+            serviceProviders.push({
+                order: providerOrder,
+                pluginOrder,
+                packageName: plugin.metadata.packageName,
+                constructorName: Provider.name || '(anonymous)',
+            });
+        });
+        plugin.definition.routes.forEach((route, routeIndex) => {
+            routeOrder += 1;
+            routes.push({
+                order: routeOrder,
+                pluginOrder,
+                contributionOrder: routeIndex + 1,
+                packageName: plugin.metadata.packageName,
+                scope: route.scope,
+            });
+        });
+        const configuredMigrations = plugin.definition.database?.migrations;
+        const configuredSeeds = plugin.definition.database?.seeds;
+        if (configuredMigrations || configuredSeeds) {
+            database.push({
+                packageName: plugin.metadata.packageName,
+                ...(configuredMigrations
+                    ? {
+                        migrations: {
+                            configured: configuredMigrations,
+                            ...(plugin.metadata.migrationsDirectory
+                                ? { resolved: plugin.metadata.migrationsDirectory }
+                                : {}),
+                        },
+                    }
+                    : {}),
+                ...(configuredSeeds
+                    ? {
+                        seeds: {
+                            configured: configuredSeeds,
+                            ...(plugin.metadata.seedsDirectory
+                                ? { resolved: plugin.metadata.seedsDirectory }
+                                : {}),
+                        },
+                    }
+                    : {}),
+            });
+        }
+        if (configuredMigrations && !plugin.metadata.migrationsDirectory) {
+            issues.push({
+                code: 'SERVER_MIGRATIONS_DIRECTORY_MISSING',
+                severity: 'error',
+                packageName: plugin.metadata.packageName,
+                message: `${plugin.metadata.packageName} declares migrations at ${path.resolve(plugin.metadata.baseDir, configuredMigrations)}, but the directory could not be resolved.`,
+            });
+        }
+        if (configuredSeeds && !plugin.metadata.seedsDirectory) {
+            issues.push({
+                code: 'SERVER_SEEDS_DIRECTORY_MISSING',
+                severity: 'error',
+                packageName: plugin.metadata.packageName,
+                message: `${plugin.metadata.packageName} declares seeds at ${path.resolve(plugin.metadata.baseDir, configuredSeeds)}, but the directory could not be resolved.`,
+            });
+        }
+        const configuredJobs = plugin.definition.queue?.jobs ?? [];
+        if (plugin.definition.queue) {
+            jobs.push({
+                packageName: plugin.metadata.packageName,
+                configuredLocations: configuredJobs,
+            });
+            issues.push({
+                code: 'SERVER_QUEUE_JOBS_DEPRECATED',
+                severity: 'warning',
+                packageName: plugin.metadata.packageName,
+                message: `${plugin.metadata.packageName} declares queue.jobs, which is deprecated and ignored: Job modules are no longer discovered.`,
+            });
+        }
+        return {
+            order: pluginOrder,
+            packageName: plugin.metadata.packageName,
+            version: plugin.metadata.version,
+            rootDir: plugin.metadata.rootDir,
+            baseDir: plugin.metadata.baseDir,
+            contributions: {
+                serviceProviders: plugin.definition.serviceProviders.length,
+                routes: plugin.definition.routes.length,
+                locales: plugin.definition.locales !== undefined,
+                migrations: configuredMigrations !== undefined,
+                seeds: configuredSeeds !== undefined,
+                jobLocations: configuredJobs.length,
+            },
+        };
+    });
+    return {
+        app: { packageName: resolved.appPackageName },
+        plugins,
+        serviceProviders,
+        routes,
+        locales,
+        database,
+        jobs,
+        consistent: !issues.some((issue) => issue.severity === 'error'),
+        issues,
+        suggestions: suggestionsForIssues(issues),
+    };
+}
+function suggestionsForIssues(issues) {
+    const suggestions = new Set();
+    for (const issue of issues) {
+        if (issue.code === 'SERVER_MIGRATIONS_DIRECTORY_MISSING' ||
+            issue.code === 'SERVER_SEEDS_DIRECTORY_MISSING') {
+            suggestions.add('Check the plugin database declaration, package files, and resolved installation contents.');
+        }
+        else if (issue.code === 'SERVER_QUEUE_JOBS_DEPRECATED') {
+            suggestions.add("Remove queue from the plugin's defineServerPlugin call, and register queue handlers from a service provider's boot() through queueServiceToken, or move the work to @nocobase/jobs.");
+        }
+    }
+    return [...suggestions];
+}
+//# sourceMappingURL=inspect.js.map

package/dist/plugins/inspect.js.map

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

package/dist/plugins/resolve.d.ts

@@ -0,0 +1,14 @@
+import type { MigrationSource, SeedSource } from '@nocobase/db';
+import type { AppDatabaseTaskContributions } from '../database/index.js';
+import type { AppServerPlugins, ResolvedAppPlugin, ResolvedAppServerPlugins } from './types.js';
+export interface ResolveAppServerPluginsOptions {
+    readonly defaultAppPackageName?: string;
+}
+export declare function resolveAppServerPlugins(rootDir: string, serverPlugins: AppServerPlugins, options?: ResolveAppServerPluginsOptions): ResolvedAppServerPlugins;
+/** The application identity and plugin task sources that database planning needs. */
+export declare function createAppDatabaseTaskContributions(resolved: ResolvedAppServerPlugins): AppDatabaseTaskContributions;
+export declare function createPluginMigrationSources(plugins: readonly ResolvedAppPlugin[]): MigrationSource[];
+export declare function createPluginSeedSources(plugins: readonly ResolvedAppPlugin[]): SeedSource[];
+/** @deprecated Always returns an empty list: Job modules are no longer discovered. */
+export declare function createPluginJobLocations(plugins: readonly ResolvedAppPlugin[]): string[];
+//# sourceMappingURL=resolve.d.ts.map