@modern-js/server-core 2.49.1 → 2.49.3-alpha.0

package/dist/types/base/middlewares/renderHandler/render.d.ts

@@ -1,12 +1,19 @@
-import { ServerRoute } from '@modern-js/types';
+import { Logger, Metrics, Reporter, ServerRoute } from '@modern-js/types';
+import type { FallbackReason } from '../../../core/plugin';
 import { Render } from '../../../core/render';
+export type OnFallback = (reason: FallbackReason, utils: {
+    logger: Logger;
+    metrics?: Metrics;
+    reporter?: Reporter;
+}, error?: unknown) => Promise<void>;
 interface CreateRenderOptions {
     routes: ServerRoute[];
     pwd: string;
     staticGenerate?: boolean;
+    onFallback?: OnFallback;
     metaName?: string;
     forceCSR?: boolean;
     nonce?: string;
 }
-export declare function createRender({ routes, pwd, metaName, staticGenerate, forceCSR, nonce, }: CreateRenderOptions): Promise<Render>;
+export declare function createRender({ routes, pwd, metaName, staticGenerate, forceCSR, nonce, onFallback: onFallbackFn, }: CreateRenderOptions): Promise<Render>;
 export {};

package/dist/types/base/utils/error.d.ts

@@ -1 +1,8 @@
+import type { Logger } from '@modern-js/types';
 export declare const createErrorHtml: (status: number) => string;
+export declare enum ErrorDigest {
+    ENOTF = "Page could not be found",
+    EINTER = "Internal server error",
+    ERENDER = "SSR render failed"
+}
+export declare function onError(logger: Logger, digest: ErrorDigest, error: Error | string, req?: Request): void;

package/dist/types/core/plugin.d.ts

@@ -1,14 +1,13 @@
 /// <reference types="node" />
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import { CommonAPI, ToThreads, AsyncSetup, PluginOptions, ToRunners } from '@modern-js/plugin';
-import type { ModernServerContext, AfterMatchContext, AfterRenderContext, MiddlewareContext, ISAppContext, HttpMethodDecider, ServerInitHookContext, AfterStreamingRenderContext } from '@modern-js/types';
+import type { ModernServerContext, AfterMatchContext, AfterRenderContext, MiddlewareContext, ISAppContext, HttpMethodDecider, ServerInitHookContext, AfterStreamingRenderContext, Logger, Metrics, Reporter } from '@modern-js/types';
 import { MiddlewareHandler as Middleware } from 'hono';
 import type { BffUserConfig, UserConfig } from '../types/config';
 import { Render } from './render';
 export type WebAdapter = (ctx: MiddlewareContext) => void | Promise<void>;
 export type NodeRequest = IncomingMessage;
 export type NodeResponse = ServerResponse;
-export type Adapter = (req: NodeRequest, res: NodeResponse) => void | Promise<void>;
 export type WebServerStartInput = {
     pwd: string;
     config: Record<string, any>;
@@ -27,6 +26,7 @@ type Change = {
     filename: string;
     event: 'add' | 'change' | 'unlink';
 };
+export type FallbackReason = 'error' | 'header' | 'query';
 export type Route = Record<string, unknown>;
 export type RequestResult = {
     isfinish: boolean;
@@ -56,6 +56,13 @@ declare const serverHooks: {
     }, unknown>;
     config: import("@modern-js/plugin").Waterfall<ServerConfig>;
     prepare: import("@modern-js/plugin").Waterfall<void>;
+    fallback: import("@modern-js/plugin").ParallelWorkflow<{
+        reason: FallbackReason;
+        error: unknown;
+        logger: Logger;
+        metrics?: Metrics | undefined;
+        reporter?: Reporter | undefined;
+    }, unknown>;
     prepareWebServer: import("@modern-js/plugin").AsyncPipeline<WebServerStartInput, WebAdapter | null>;
     prepareApiServer: import("@modern-js/plugin").AsyncPipeline<APIServerStartInput, Middleware>;
     repack: import("@modern-js/plugin").Waterfall<void>;
@@ -81,6 +88,13 @@ export declare const createServerManager: () => import("@modern-js/plugin").Asyn
     }, unknown>;
     config: import("@modern-js/plugin").Waterfall<ServerConfig>;
     prepare: import("@modern-js/plugin").Waterfall<void>;
+    fallback: import("@modern-js/plugin").ParallelWorkflow<{
+        reason: FallbackReason;
+        error: unknown;
+        logger: Logger;
+        metrics?: Metrics | undefined;
+        reporter?: Reporter | undefined;
+    }, unknown>;
     prepareWebServer: import("@modern-js/plugin").AsyncPipeline<WebServerStartInput, WebAdapter | null>;
     prepareApiServer: import("@modern-js/plugin").AsyncPipeline<APIServerStartInput, Middleware>;
     repack: import("@modern-js/plugin").Waterfall<void>;
@@ -102,6 +116,13 @@ export declare const serverManager: import("@modern-js/plugin").AsyncManager<{
     }, unknown>;
     config: import("@modern-js/plugin").Waterfall<ServerConfig>;
     prepare: import("@modern-js/plugin").Waterfall<void>;
+    fallback: import("@modern-js/plugin").ParallelWorkflow<{
+        reason: FallbackReason;
+        error: unknown;
+        logger: Logger;
+        metrics?: Metrics | undefined;
+        reporter?: Reporter | undefined;
+    }, unknown>;
     prepareWebServer: import("@modern-js/plugin").AsyncPipeline<WebServerStartInput, WebAdapter | null>;
     prepareApiServer: import("@modern-js/plugin").AsyncPipeline<APIServerStartInput, Middleware>;
     repack: import("@modern-js/plugin").Waterfall<void>;
@@ -129,6 +150,13 @@ export declare const createPlugin: (setup?: AsyncSetup<{
     }, unknown>;
     config: import("@modern-js/plugin").Waterfall<ServerConfig>;
     prepare: import("@modern-js/plugin").Waterfall<void>;
+    fallback: import("@modern-js/plugin").ParallelWorkflow<{
+        reason: FallbackReason;
+        error: unknown;
+        logger: Logger;
+        metrics?: Metrics | undefined;
+        reporter?: Reporter | undefined;
+    }, unknown>;
     prepareWebServer: import("@modern-js/plugin").AsyncPipeline<WebServerStartInput, WebAdapter | null>;
     prepareApiServer: import("@modern-js/plugin").AsyncPipeline<APIServerStartInput, Middleware>;
     repack: import("@modern-js/plugin").Waterfall<void>;
@@ -149,6 +177,13 @@ export declare const createPlugin: (setup?: AsyncSetup<{
     }, unknown>;
     config: import("@modern-js/plugin").Waterfall<ServerConfig>;
     prepare: import("@modern-js/plugin").Waterfall<void>;
+    fallback: import("@modern-js/plugin").ParallelWorkflow<{
+        reason: FallbackReason;
+        error: unknown;
+        logger: Logger;
+        metrics?: Metrics | undefined;
+        reporter?: Reporter | undefined;
+    }, unknown>;
     prepareWebServer: import("@modern-js/plugin").AsyncPipeline<WebServerStartInput, WebAdapter | null>;
     prepareApiServer: import("@modern-js/plugin").AsyncPipeline<APIServerStartInput, Middleware>;
     repack: import("@modern-js/plugin").Waterfall<void>;
@@ -165,6 +200,13 @@ export declare const createPlugin: (setup?: AsyncSetup<{
     }, unknown>;
     config: import("@modern-js/plugin").Waterfall<ServerConfig>;
     prepare: import("@modern-js/plugin").Waterfall<void>;
+    fallback: import("@modern-js/plugin").ParallelWorkflow<{
+        reason: FallbackReason;
+        error: unknown;
+        logger: Logger;
+        metrics?: Metrics | undefined;
+        reporter?: Reporter | undefined;
+    }, unknown>;
     prepareWebServer: import("@modern-js/plugin").AsyncPipeline<WebServerStartInput, WebAdapter | null>;
     prepareApiServer: import("@modern-js/plugin").AsyncPipeline<APIServerStartInput, Middleware>;
     repack: import("@modern-js/plugin").Waterfall<void>;
@@ -185,6 +227,13 @@ export declare const createPlugin: (setup?: AsyncSetup<{
     }, unknown>;
     config: import("@modern-js/plugin").Waterfall<ServerConfig>;
     prepare: import("@modern-js/plugin").Waterfall<void>;
+    fallback: import("@modern-js/plugin").ParallelWorkflow<{
+        reason: FallbackReason;
+        error: unknown;
+        logger: Logger;
+        metrics?: Metrics | undefined;
+        reporter?: Reporter | undefined;
+    }, unknown>;
     prepareWebServer: import("@modern-js/plugin").AsyncPipeline<WebServerStartInput, WebAdapter | null>;
     prepareApiServer: import("@modern-js/plugin").AsyncPipeline<APIServerStartInput, Middleware>;
     repack: import("@modern-js/plugin").Waterfall<void>;

package/package.json

@@ -15,7 +15,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "2.49.1",
+  "version": "2.49.3-alpha.0",
   "jsnext:source": "./src/index.ts",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/cjs/index.js",
@@ -69,9 +69,9 @@
     "hono": "^3.12.2",
     "isbot": "3.8.0",
     "merge-deep": "^3.0.3",
-    "@modern-js/plugin": "2.49.1",
-    "@modern-js/runtime-utils": "2.49.1",
-    "@modern-js/utils": "2.49.1"
+    "@modern-js/runtime-utils": "2.49.2",
+    "@modern-js/utils": "2.49.2",
+    "@modern-js/plugin": "2.49.2"
   },
   "devDependencies": {
     "@types/jest": "^29",
@@ -81,9 +81,9 @@
     "jest": "^29",
     "ts-jest": "^29.1.0",
     "typescript": "^5",
-    "@modern-js/types": "2.49.1",
-    "@scripts/jest-config": "2.49.1",
-    "@scripts/build": "2.49.1"
+    "@scripts/build": "2.49.2",
+    "@modern-js/types": "2.49.2",
+    "@scripts/jest-config": "2.49.2"
   },
   "sideEffects": false,
   "publishConfig": {