akanjs 3.0.0-beta.24 → 3.0.0-beta.26
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/common/hmrPhase.ts +2 -0
- package/package.json +1 -1
- package/server/SSR_MEMORY_DIAGNOSIS.md +2 -2
- package/server/akanApp.ts +1 -0
- package/server/akanServer.ts +7 -1
- package/server/artifact/builderRpc.ts +13 -2
- package/server/artifact/devBuildRecovery.ts +12 -0
- package/server/artifact/index.ts +1 -0
- package/server/artifact/ipcTypes.ts +46 -3
- package/server/artifact/routeClientCache.ts +128 -29
- package/server/di/diLifecycle.ts +1 -1
- package/server/hmr/clientScript.ts +148 -86
- package/server/hmr/csrDevManifest.ts +17 -0
- package/server/hmr/csrDevRuntime.ts +238 -18
- package/server/hmr/csrDevShell.ts +90 -10
- package/server/hmr/devArtifactPruner.ts +77 -0
- package/server/hmr/devHmrController.ts +233 -137
- package/server/hmr/ssrDevShim.ts +112 -0
- package/server/hmr/ssrUpdateQueue.ts +111 -0
- package/server/hmr/wsHub.ts +19 -4
- package/server/routing/apiRouter.ts +12 -0
- package/server/rscWorker.tsx +11 -1
- package/server/rscWorkerHost.ts +223 -59
- package/server/systemPageDocument.tsx +6 -0
- package/server/types.tsx +4 -0
- package/server/webRouter.ts +57 -22
- package/types/common/hmrPhase.d.ts +2 -0
- package/types/server/artifact/builderRpc.d.ts +3 -2
- package/types/server/artifact/devBuildRecovery.d.ts +4 -0
- package/types/server/artifact/index.d.ts +1 -0
- package/types/server/artifact/ipcTypes.d.ts +47 -2
- package/types/server/artifact/routeClientCache.d.ts +9 -2
- package/types/server/hmr/csrDevManifest.d.ts +15 -0
- package/types/server/hmr/csrDevRuntime.d.ts +34 -0
- package/types/server/hmr/csrDevShell.d.ts +9 -1
- package/types/server/hmr/devArtifactPruner.d.ts +9 -0
- package/types/server/hmr/devHmrController.d.ts +8 -5
- package/types/server/hmr/ssrDevShim.d.ts +7 -0
- package/types/server/hmr/ssrUpdateQueue.d.ts +23 -0
- package/types/server/hmr/wsHub.d.ts +16 -7
- package/types/server/routing/apiRouter.d.ts +8 -0
- package/types/server/rscWorkerHost.d.ts +14 -2
- package/types/server/systemPageDocument.d.ts +2 -0
- package/types/server/types.d.ts +4 -0
- package/types/server/webRouter.d.ts +8 -2
|
@@ -64,9 +64,20 @@ export interface RscWorkerReloadInput {
|
|
|
64
64
|
clientManifest: ClientManifest;
|
|
65
65
|
cssAssets?: Record<string, CssAsset>;
|
|
66
66
|
buildId: number;
|
|
67
|
-
/** Undefined keeps the
|
|
67
|
+
/** Undefined keeps the latest bundle a reload named (e.g. a client-manifest-only reload after a lazy route build). */
|
|
68
68
|
pagesBundlePath?: string;
|
|
69
69
|
}
|
|
70
|
+
export interface RscAdoptedBundle {
|
|
71
|
+
pagesBundlePath: string;
|
|
72
|
+
buildId: number;
|
|
73
|
+
}
|
|
74
|
+
/** A reload the worker did not take: what it runs instead, and whether a later reload failed in this one's place. */
|
|
75
|
+
export interface RscReloadFailure extends Error {
|
|
76
|
+
/** What the worker runs now. */
|
|
77
|
+
adopted: RscAdoptedBundle;
|
|
78
|
+
/** The latest state it was asked to take, which a later reload may have moved past the caller's own. */
|
|
79
|
+
failed: RscAdoptedBundle;
|
|
80
|
+
}
|
|
70
81
|
export declare class RscWorker {
|
|
71
82
|
#private;
|
|
72
83
|
readonly ready: Promise<void>;
|
|
@@ -86,5 +97,6 @@ export declare class RscWorker {
|
|
|
86
97
|
getMetrics(): AkanMetricsReport;
|
|
87
98
|
restartWhenIdle(reason: string): boolean;
|
|
88
99
|
updateCssAssets(cssAssets: Record<string, CssAsset>): void;
|
|
89
|
-
reload
|
|
100
|
+
/** Resolves with the pages bundle the worker runs once it has taken this reload, or a later one. */
|
|
101
|
+
reload(input: RscWorkerReloadInput): Promise<RscAdoptedBundle>;
|
|
90
102
|
}
|
|
@@ -9,6 +9,8 @@ export interface SystemPageOptions {
|
|
|
9
9
|
stylesheetHref?: string | null;
|
|
10
10
|
showDetails?: boolean;
|
|
11
11
|
error?: unknown;
|
|
12
|
+
/** Dev only: the HMR client, so a page that failed to render reloads once a later build fixes it. */
|
|
13
|
+
script?: string;
|
|
12
14
|
}
|
|
13
15
|
export interface SystemPageHomeHrefOptions {
|
|
14
16
|
pathname: string;
|
package/types/server/types.d.ts
CHANGED
|
@@ -87,4 +87,8 @@ export interface RenderState {
|
|
|
87
87
|
cssBytesByUrl: Record<string, Uint8Array>;
|
|
88
88
|
/** The newest CSR dev bundle generation; a CSR tab whose own generation differs has missed an update. */
|
|
89
89
|
csrGeneration?: number;
|
|
90
|
+
/** The newest SSR dev registry generation sent to the tabs; a tab whose registry differs has missed an update. */
|
|
91
|
+
ssrGeneration?: number;
|
|
92
|
+
/** When the SSR dev registry was last built whole; a tab booted from an earlier one reloads. */
|
|
93
|
+
ssrEpoch?: number;
|
|
90
94
|
}
|
|
@@ -3,7 +3,7 @@ import { type AkanI18nConfig, type LogRecord } from "akanjs/common";
|
|
|
3
3
|
import { type AkanRequestStore } from "akanjs/fetch";
|
|
4
4
|
import type { AkanMetricsReport } from "akanjs/service";
|
|
5
5
|
import type { PagePromptSource } from "../signal/mcp/pagePrompt.d.ts";
|
|
6
|
-
import { type BuilderRpc, type RouteSeedIndex } from "./artifact.d.ts";
|
|
6
|
+
import { type BuilderRpc, type RouteSeedIndex, type RoutesManifest } from "./artifact.d.ts";
|
|
7
7
|
import { type RouteCacheInvalidation, type RouteCacheRenderState } from "./cachePolicy.d.ts";
|
|
8
8
|
import type { HmrWsData, HmrWsHub } from "./hmr/wsHub.d.ts";
|
|
9
9
|
import { type RscRedirectMethod, type RscRedirectStatus, type RscRenderResult, RscWorker } from "./rscWorkerHost.d.ts";
|
|
@@ -49,18 +49,24 @@ interface WebRouterOptions {
|
|
|
49
49
|
rsc: RscWorker;
|
|
50
50
|
seedIndex: RouteSeedIndex;
|
|
51
51
|
upgradeHmrWs: (req: Request, data: HmrWsData) => boolean;
|
|
52
|
+
/** The production build's route manifest, which the worker was already handed at boot. */
|
|
53
|
+
prebuilt?: RoutesManifest | null;
|
|
52
54
|
}
|
|
53
55
|
export declare class WebRouter {
|
|
54
56
|
#private;
|
|
55
57
|
renderState: RenderState;
|
|
56
58
|
/** What this router actually mounts, already intersected with what the artifact carries. */
|
|
57
59
|
readonly web: AkanWebConfig;
|
|
58
|
-
constructor({ artifact, web, cssBytesByUrl, rsc, seedIndex, upgradeHmrWs }: WebRouterOptions);
|
|
60
|
+
constructor({ artifact, web, cssBytesByUrl, rsc, seedIndex, upgradeHmrWs, prebuilt }: WebRouterOptions);
|
|
59
61
|
initializeRoute(): Promise<{
|
|
60
62
|
renderEnvRoutes: Bun.Serve.Routes<unknown, string> | Bun.Serve.RoutesWithUpgrade<unknown, string>;
|
|
61
63
|
hmrHub: HmrWsHub | null;
|
|
62
64
|
builderRpc: BuilderRpc | null;
|
|
63
65
|
}>;
|
|
66
|
+
refreshHmrState(): void;
|
|
67
|
+
hmrBuildErrors(): {
|
|
68
|
+
phase: string;
|
|
69
|
+
}[];
|
|
64
70
|
dispose(): void;
|
|
65
71
|
setLogLevel(minSev: number | null): void;
|
|
66
72
|
pagePrompts(): PagePromptSource;
|