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

package/dist/node/runtime.d.ts

@@ -0,0 +1,45 @@
+import type { Application } from '../application/index.js';
+import { type NodeServerProxyOptions } from './proxy.js';
+import { type AppRuntimeDefinition, type ResolvedAppRuntime } from '../runtime/definition.js';
+import type { AppScope } from '../runtime/types.js';
+import { type CreateStandaloneScopeOptions, type StandaloneAppScope } from './scope.js';
+import { type ClosableNodeAppServer, type NodeShutdownOptions } from './server.js';
+export type CreateStandaloneRuntimeScopeOptions = CreateStandaloneScopeOptions;
+export interface StandaloneServerListenOptions {
+    readonly hostname: string;
+    readonly port: number;
+    readonly startLog: boolean;
+}
+export interface StandaloneServer extends ClosableNodeAppServer {
+    readonly application: Application;
+    readonly listenOptions: StandaloneServerListenOptions;
+    /** Shutdown budget resolved from the environment; empty keeps the defaults. */
+    readonly shutdownOptions: NodeShutdownOptions;
+    readonly signal: AbortSignal;
+}
+export type StandaloneServerFactory = (scope: AppScope) => Promise<Application>;
+export interface StandaloneApplicationDefinition {
+    readonly rootDir: string;
+    readonly appRuntime: AppRuntimeDefinition;
+    readonly createServer: StandaloneServerFactory;
+    /** Configure listener-level forwarding after the application has started. */
+    readonly proxy?: (context: {
+        readonly application: Application;
+    }) => NodeServerProxyOptions;
+}
+export type StandaloneServerOptions = CreateStandaloneRuntimeScopeOptions & {
+    readonly viteDevUrl?: string | false;
+};
+export type CreateStandaloneServerOptions = StandaloneApplicationDefinition & StandaloneServerOptions;
+export interface DefinedStandaloneServer {
+    readonly create: (options?: StandaloneServerOptions) => Promise<StandaloneServer>;
+    readonly start: (options?: StandaloneServerOptions) => void;
+}
+export declare function createStandaloneServer(options: CreateStandaloneServerOptions): Promise<StandaloneServer>;
+export declare function startServer(options: CreateStandaloneServerOptions): void;
+export declare function defineStandaloneServer(definition: StandaloneApplicationDefinition): DefinedStandaloneServer;
+export declare function createStandaloneRuntimeScope(options: CreateStandaloneRuntimeScopeOptions): StandaloneAppScope;
+export declare function resolveStandaloneAppRuntime(definition: AppRuntimeDefinition, options: CreateStandaloneRuntimeScopeOptions): Promise<ResolvedAppRuntime & {
+    readonly scope: StandaloneAppScope;
+}>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/node/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/node/runtime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EAIzB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,mCAAmC,GAAG,4BAA4B,CAAC;AAE/E,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAiB,SAAQ,qBAAqB;IAC7D,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,6BAA6B,CAAC;IACtD,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAEhF,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAC/C,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE;QACzB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;KACnC,KAAK,sBAAsB,CAAC;CAC9B;AAED,MAAM,MAAM,uBAAuB,GAAG,mCAAmC,GAAG;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,+BAA+B,GACzE,uBAAuB,CAAC;AAE1B,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,CACf,OAAO,CAAC,EAAE,uBAAuB,KAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAC7D;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,gBAAgB,CAAC,CAsD3B;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAwBxE;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,+BAA+B,GAC1C,uBAAuB,CAkBzB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,kBAAkB,CAEpB;AAED,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,oBAAoB,EAChC,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,kBAAkB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAYtE"}

package/dist/node/runtime.js

@@ -0,0 +1,176 @@
+import { findApplicationNotConfigured } from '../config/not-configured.js';
+import { findAppConfigInvalid } from '../config/validation.js';
+import { formatNotConfigured } from './not-configured-message.js';
+import { loggingToken } from '../logging/token.js';
+import { NodeServerProxy } from './proxy.js';
+import { resolveAppRuntime, } from '../runtime/definition.js';
+import { createPublicBasePathAdapter } from '../runtime/mount.js';
+import { createStandaloneScope, } from './scope.js';
+import { resolveNodeShutdownTimeouts, disposeAfterStartupFailure, startNodeAppServer, watchStartupShutdownSignals, } from './server.js';
+export async function createStandaloneServer(options) {
+    const { appRuntime, createServer, proxy: configureProxy, ...serverOptions } = options;
+    const scope = createStandaloneRuntimeScope(resolveStandaloneServerScopeOptions({
+        ...serverOptions,
+        deploymentRootDir: serverOptions.deploymentRootDir ?? appRuntime.deploymentRootDir,
+    }));
+    try {
+        const application = await createServer(scope);
+        const mounted = createPublicBasePathAdapter(application, application.publicBasePath);
+        const proxy = configureProxy
+            ? new NodeServerProxy(configureProxy({ application }))
+            : undefined;
+        if (proxy)
+            scope.registerDisposer('standalone-proxy', () => proxy.close());
+        const serverConfigValue = application.config.get('server') ?? { host: '127.0.0.1', port: 13000, startLog: true };
+        const listenOptions = {
+            hostname: serverConfigValue.host,
+            port: serverConfigValue.port,
+            startLog: serverConfigValue.startLog,
+        };
+        const server = {
+            application,
+            shutdownOptions: resolveNodeShutdownTimeouts(scope.env),
+            close: () => scope.destroy(),
+            fetch: (request, env, executionContext) => proxy?.matches(new URL(request.url).pathname)
+                ? proxy.fetch(request)
+                : mounted.fetch(request, env, executionContext),
+            proxy,
+            listenOptions,
+            signal: scope.signal,
+        };
+        if (mounted.websocket) {
+            server.websocket = mounted.websocket;
+        }
+        return server;
+    }
+    catch (error) {
+        return disposeAfterStartupFailure(() => scope.destroy(), error);
+    }
+}
+export function startServer(options) {
+    const strictStartup = createStandaloneRuntimeScope({
+        ...options,
+        deploymentRootDir: options.deploymentRootDir ?? options.appRuntime.deploymentRootDir,
+    }).env.NOCOBASE_STRICT_STARTUP === 'true';
+    const startPromise = startStandaloneServer(options);
+    startPromise.catch((error) => {
+        // An unconfigured or misconfigured application gets its instruction without a stack trace; anything else is
+        // printed whole.
+        const notConfigured = findApplicationNotConfigured(error);
+        const invalid = notConfigured ? undefined : findAppConfigInvalid(error);
+        console.error(notConfigured
+            ? formatNotConfigured(notConfigured)
+            : invalid
+                ? invalid.message
+                : error);
+        process.exitCode = 1;
+        // Startup has already disposed the scope. Do not retain leaked handles.
+        if (strictStartup)
+            process.exit(1);
+    });
+}
+export function defineStandaloneServer(definition) {
+    return {
+        create: (options = {}) => createStandaloneServer({
+            ...options,
+            ...definition,
+            rootDir: options.rootDir ?? definition.rootDir,
+        }),
+        start: (options = {}) => {
+            startServer({
+                ...options,
+                ...definition,
+                rootDir: options.rootDir ?? definition.rootDir,
+            });
+        },
+    };
+}
+export function createStandaloneRuntimeScope(options) {
+    return createStandaloneScope(options);
+}
+export async function resolveStandaloneAppRuntime(definition, options) {
+    const scope = createStandaloneRuntimeScope({
+        ...options,
+        deploymentRootDir: options.deploymentRootDir ?? definition.deploymentRootDir,
+    });
+    try {
+        const runtime = await resolveAppRuntime(definition, scope);
+        return Object.assign(runtime, { scope });
+    }
+    catch (error) {
+        return disposeAfterStartupFailure(() => scope.destroy(), error);
+    }
+}
+async function startStandaloneServer(options) {
+    // Startup runs migrations and seeds under a task lock before the HTTP server
+    // registers its own handlers, so the signals are watched from here until it
+    // does. A restart that arrives mid-startup then shuts down cleanly instead
+    // of leaving the lock held by a process that no longer exists.
+    const startupSignals = watchStartupShutdownSignals();
+    let app;
+    try {
+        app = await createStandaloneServer(options);
+    }
+    catch (error) {
+        startupSignals.dispose();
+        throw error;
+    }
+    const logger = app.application.container.has(loggingToken)
+        ? app.application.container.resolve(loggingToken).getLogger('server')
+        : undefined;
+    const startupSignal = startupSignals.received();
+    if (startupSignal) {
+        startupSignals.dispose();
+        const message = `Startup completed after ${startupSignal}; shutting down without listening.`;
+        if (logger)
+            logger.info(message);
+        else
+            console.log(message);
+        await app.close();
+        return;
+    }
+    try {
+        await startNodeAppServer(app, {
+            ...(logger
+                ? {
+                    logger: {
+                        error: (message, err) => logger.error({ err }, message),
+                    },
+                }
+                : {}),
+            ...app.shutdownOptions,
+            hostname: app.listenOptions.hostname,
+            port: app.listenOptions.port,
+            onListen: (info) => {
+                if (!app.listenOptions.startLog) {
+                    return;
+                }
+                const message = `App server listening on http://${info.address}:${info.port}`;
+                if (logger)
+                    logger.info(message);
+                else
+                    console.log(message);
+            },
+        });
+    }
+    catch (error) {
+        await disposeAfterStartupFailure(() => app.close(), error);
+    }
+    finally {
+        startupSignals.dispose();
+    }
+}
+function resolveStandaloneServerScopeOptions(options) {
+    const { viteDevUrl, ...scopeOptions } = options;
+    if (viteDevUrl === undefined) {
+        return scopeOptions;
+    }
+    return {
+        ...scopeOptions,
+        env: {
+            ...scopeOptions.env,
+            APP_VITE_DEV_URL: viteDevUrl === false ? 'false' : viteDevUrl,
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/node/runtime.js.map

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

package/dist/node/scope.d.ts

@@ -0,0 +1,55 @@
+import { type EnvMap } from '../config/index.js';
+import { AppScopeLifecycle } from '../runtime/lifecycle.js';
+import type { AppPathOptions, AppScope } from '../runtime/types.js';
+export interface LoadStandaloneAppEnvOptions {
+    readonly rootDir: string;
+    readonly files?: readonly string[];
+    readonly baseEnv?: EnvMap;
+    readonly overrides?: EnvMap;
+}
+export declare function loadStandaloneAppEnv(options: LoadStandaloneAppEnvOptions): EnvMap;
+export interface StandaloneAppScopeOptions {
+    readonly id?: string;
+    readonly appName: string;
+    readonly basePath: string;
+    readonly paths: AppPathOptions;
+    readonly configPath?: string;
+    readonly env: EnvMap;
+    readonly abortReason?: unknown;
+    readonly consoleLogStream?: 'stdout' | 'stderr';
+}
+export interface CreateStandaloneScopeOptions {
+    readonly rootDir?: string;
+    readonly deploymentRootDir?: string;
+    readonly paths?: AppPathOptions;
+    readonly appName?: string;
+    readonly basePath?: string;
+    readonly configPath?: string;
+    /** Final environment overrides applied after dotenv files and process.env. */
+    readonly env?: EnvMap;
+    readonly abortReason?: unknown;
+    /** See {@link AppScope.consoleLogStream}. */
+    readonly consoleLogStream?: 'stdout' | 'stderr';
+}
+export interface ResolveStandaloneAppPathsOptions {
+    readonly rootDir?: string;
+    readonly deploymentRootDir?: string;
+    readonly paths?: AppPathOptions;
+}
+export declare class StandaloneAppScope extends AppScopeLifecycle implements AppScope {
+    readonly mode: "standalone";
+    readonly id: string;
+    readonly appName: string;
+    readonly basePath: string;
+    readonly paths: AppPathOptions;
+    readonly rootDir: string;
+    readonly dataDir: string | undefined;
+    readonly clientDir: string | undefined;
+    readonly configPath: string | undefined;
+    readonly env: EnvMap;
+    readonly consoleLogStream: 'stdout' | 'stderr' | undefined;
+    constructor(options: StandaloneAppScopeOptions);
+}
+export declare function createStandaloneScope(options: CreateStandaloneScopeOptions): StandaloneAppScope;
+export declare function resolveStandaloneAppPaths(options: ResolveStandaloneAppPathsOptions): AppPathOptions;
+//# sourceMappingURL=scope.d.ts.map

package/dist/node/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/node/scope.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAMjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,MAAM,CAWR;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACjD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACjD;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,qBAAa,kBAAmB,SAAQ,iBAAkB,YAAW,QAAQ;IAC3E,SAAgB,IAAI,EAAG,YAAY,CAAU;IAC7C,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,KAAK,EAAE,cAAc,CAAC;IACtC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,SAAgB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,gBAAgB,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;gBAE/C,OAAO,EAAE,yBAAyB;CAatD;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,kBAAkB,CAkCpB;AAoCD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,cAAc,CAyBhB"}

package/dist/node/scope.js

@@ -0,0 +1,115 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { dotenvParser } from '@nocobase/config/parsers/dotenv';
+import { DEFAULT_APP_BASE_PATH, normalizeBasePath, resolveAppNameFromBasePath, } from '../support/index.js';
+import { AppScopeLifecycle } from '../runtime/lifecycle.js';
+export function loadStandaloneAppEnv(options) {
+    const baseEnv = options.baseEnv ?? process.env;
+    const files = options.files ?? [
+        path.join(options.rootDir, '.env'),
+        path.join(options.rootDir, '.env.local'),
+    ];
+    return {
+        ...readDotenvFiles(files, baseEnv),
+        ...baseEnv,
+        ...options.overrides,
+    };
+}
+export class StandaloneAppScope extends AppScopeLifecycle {
+    mode = 'standalone';
+    id;
+    appName;
+    basePath;
+    paths;
+    rootDir;
+    dataDir;
+    clientDir;
+    configPath;
+    env;
+    consoleLogStream;
+    constructor(options) {
+        super({ abortReason: options.abortReason });
+        this.id = options.id ?? options.appName;
+        this.appName = options.appName;
+        this.basePath = options.basePath;
+        this.paths = options.paths;
+        this.rootDir = options.paths.rootDir;
+        this.dataDir = options.paths.storageDir;
+        this.clientDir = options.paths.clientDir;
+        this.configPath = options.configPath;
+        this.env = options.env;
+        this.consoleLogStream = options.consoleLogStream;
+    }
+}
+export function createStandaloneScope(options) {
+    const paths = resolveStandaloneAppPaths(options);
+    const deploymentRootDir = path.resolve(paths.rootDir, paths.deploymentRootDir ?? '.');
+    const env = loadStandaloneAppEnv({
+        rootDir: deploymentRootDir,
+        files: [
+            ...(path.resolve(paths.rootDir) === deploymentRootDir
+                ? []
+                : [path.join(paths.rootDir, '.env')]),
+            path.join(deploymentRootDir, '.env'),
+            path.join(deploymentRootDir, '.env.local'),
+        ],
+        overrides: options.env,
+    });
+    const defaultAppName = 'main';
+    const basePath = normalizeBasePath(options.basePath ?? env.APP_BASE_PATH ?? DEFAULT_APP_BASE_PATH);
+    const appName = options.appName ?? resolveAppNameFromBasePath(basePath, defaultAppName);
+    return new StandaloneAppScope({
+        appName,
+        basePath,
+        paths,
+        configPath: options.configPath,
+        env,
+        abortReason: options.abortReason ?? new Error('Standalone application closed.'),
+        consoleLogStream: options.consoleLogStream,
+    });
+}
+function readDotenvFiles(files, baseEnv) {
+    const parser = dotenvParser();
+    const environment = {};
+    for (const filePath of files) {
+        if (!existsSync(filePath))
+            continue;
+        const parsed = parser.parse(readFileSync(filePath));
+        for (const [key, value] of Object.entries(parsed)) {
+            if (typeof value === 'string')
+                environment[key] = value;
+        }
+    }
+    const expansionEnvironment = { ...baseEnv, ...environment };
+    for (const [key, value] of Object.entries(environment)) {
+        environment[key] = expandEnvironmentValue(value, expansionEnvironment);
+        expansionEnvironment[key] = environment[key];
+    }
+    return environment;
+}
+function expandEnvironmentValue(value, env) {
+    return value.replace(/\\?\${?([A-Za-z_][A-Za-z0-9_]*)}?/g, (match, key) => {
+        if (match.startsWith('\\'))
+            return match.slice(1);
+        return env[key] ?? '';
+    });
+}
+export function resolveStandaloneAppPaths(options) {
+    if (options.paths) {
+        return options.paths;
+    }
+    if (!options.rootDir) {
+        throw new Error('Standalone scope requires options.rootDir or options.paths.');
+    }
+    const rootDir = path.resolve(options.rootDir);
+    const deploymentRootDir = path.resolve(rootDir, options.deploymentRootDir ?? '.');
+    const built = rootDir !== deploymentRootDir;
+    return {
+        rootDir,
+        serverDir: path.join(rootDir, 'server'),
+        databaseDir: path.join(rootDir, 'database'),
+        clientDir: path.join(rootDir, built ? 'client' : 'dist/client'),
+        deploymentRootDir,
+    };
+}
+//# sourceMappingURL=scope.js.map

package/dist/node/scope.js.map

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

package/dist/node/server.d.ts

@@ -0,0 +1,80 @@
+import { type ServerType } from '@hono/node-server';
+import type { AddressInfo } from 'node:net';
+import type { AppServer } from '../runtime/index.js';
+import type { NodeServerProxy } from './proxy.js';
+export declare const DEFAULT_HTTP_DRAIN_TIMEOUT_MS: number;
+export declare const DEFAULT_FORCE_EXIT_TIMEOUT_MS: number;
+/**
+ * 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 declare const SHUTDOWN_TIMEOUT_ENV = "APP_SHUTDOWN_TIMEOUT_MS";
+export type NodeAppHttpServer = ServerType;
+export interface ClosableNodeAppServer extends AppServer {
+    readonly signal?: AbortSignal;
+    readonly proxy?: NodeServerProxy;
+    close(): Promise<void>;
+}
+export interface NodeAppServerLogger {
+    error(message: string, error?: unknown): void;
+}
+export interface StartNodeAppServerOptions {
+    readonly hostname: string;
+    readonly port: number;
+    readonly onListen?: (info: AddressInfo) => void;
+    readonly logger?: NodeAppServerLogger;
+    readonly registerProcessSignals?: boolean;
+    readonly httpDrainTimeoutMs?: number;
+    readonly forceExitTimeoutMs?: number;
+}
+export interface NodeShutdownOptions {
+    readonly logger?: NodeAppServerLogger;
+    readonly httpDrainTimeoutMs?: number;
+    readonly forceExitTimeoutMs?: number;
+}
+/**
+ * Reads the shutdown budget from the environment. An unset or unusable value
+ * keeps the defaults, which suit a deployment behind a load balancer.
+ */
+export declare function resolveNodeShutdownTimeouts(env: Readonly<Record<string, string | undefined>>): NodeShutdownOptions;
+export declare function startNodeAppServer(app: ClosableNodeAppServer, options: StartNodeAppServerOptions): Promise<NodeAppHttpServer>;
+export declare function registerNodeWebSocketUpgradeHandler(app: AppServer & {
+    readonly proxy?: NodeServerProxy;
+}, server: NodeAppHttpServer, options?: {
+    readonly logger?: NodeAppServerLogger;
+}): void;
+export declare function registerNodeShutdownHandlers(app: ClosableNodeAppServer, server: NodeAppHttpServer, options?: NodeShutdownOptions): () => void;
+export interface StartupSignalWatchOptions {
+    readonly logger?: NodeAppServerLogger;
+    readonly signals?: readonly NodeJS.Signals[];
+    /** Signal source; defaults to the process. Injected by tests. */
+    readonly emitter?: StartupSignalEmitter;
+    /** Escalation for a repeated signal; defaults to process.exit. */
+    readonly forceExit?: (code: number) => void;
+}
+export interface StartupSignalEmitter {
+    on(event: string, listener: () => void): unknown;
+    off(event: string, listener: () => void): unknown;
+}
+export interface StartupSignalWatch {
+    /** The first signal received while starting, if any. */
+    received(): NodeJS.Signals | undefined;
+    dispose(): void;
+}
+export declare const DEFAULT_STARTUP_SIGNALS: readonly NodeJS.Signals[];
+/**
+ * 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 declare function watchStartupShutdownSignals(options?: StartupSignalWatchOptions): StartupSignalWatch;
+export declare function shutdownNodeAppServer(app: ClosableNodeAppServer, server: NodeAppHttpServer, signal: NodeJS.Signals, options?: NodeShutdownOptions): Promise<void>;
+export declare function closeNodeServerWithGracePeriod(server: NodeAppHttpServer, timeoutMs: number, logger?: NodeAppServerLogger): Promise<void>;
+export declare function closeNodeServer(server: NodeAppHttpServer): Promise<void>;
+export declare function disposeAfterStartupFailure(dispose: () => void | Promise<void>, startupError: unknown): Promise<never>;
+//# sourceMappingURL=server.d.ts.map

package/dist/node/server.d.ts.map

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