@jay-framework/stack-server-build 0.24.3 → 0.24.4

package/dist/index.d.ts

@@ -58,6 +58,17 @@ interface LoadedPageParts {
     /** Script tags with jay-script="allow" to include in SSR output */
     scripts?: JayHtmlScript[];
 }
+/**
+ * Resolve the browser hydration import path for a route (DL#182).
+ *
+ * SSR loads `route.compPath` (which is `./tools` for devOnly plugin routes, `.` otherwise); the
+ * browser must never load those server bundles. Prefer the explicit `clientCompPath` resolved from
+ * the plugin's `./client` export. Fall back to the legacy `index.js`→`index.client.js` rewrite only
+ * for NPM plugin routes (`componentExport` set) that carry no `clientCompPath` — note this rewrite
+ * silently no-ops for a devOnly `compPath` ending in `tools.js`, which is the bug DL#182 fixes.
+ * Local (project) components hydrate directly from `compPath`.
+ */
+declare function resolveClientImportPath(route: JayRoute): string;
 interface LoadPagePartsOptions {
     /**
      * Path to pre-rendered jay-html file to use instead of the original.
@@ -669,4 +680,4 @@ declare class SlowRenderCache {
     private scanAndDeleteCacheFiles;
 }
 
-export { type ActionDiscoveryOptions, type ActionDiscoveryResult, type ActionIndexEntry, type ActionMetadata, type ActionSchema, type CommandFlag, type CommandIndexEntry, type CommandMetadata, type ContextIndexEntry, type DevServerPagePart, type DiscoveredCommand, type GenerateClientScriptOptions, type HeadlessInstanceComponent, type LoadPagePartsOptions, type LoadedPageParts, type MaterializeContractsOptions, type MaterializeResult, type PluginActionDiscoveryOptions, type PluginContractEntry, type PluginWithAgentKit, type PluginWithSetup, type PluginsIndex, type PluginsIndexEntry, type ProjectClientInitInfo, type RouteIndexEntry, type ScriptFragments, type ServiceIndexEntry, SetupNeedsAnswerError, SlowRenderCache, type SlowRenderCacheEntry, type ViteSSRLoader, buildAutomationWrap, buildPageReloadHmrScript, buildScriptFragments, clearServerElementCache, commandSchemaToFlags, discoverAllPluginActions, discoverAndRegisterActions, discoverPluginActions, discoverPluginCommands, discoverPluginsWithAgentKit, discoverPluginsWithSetup, executePluginAgentKit, executePluginCommand, executePluginSetup, generateClientScript, generateFrozenPageHtml, generatePromiseReconstruction, generateSSRPageHtml, headMetaToHeadTags, invalidateServerElementCache, listContracts, loadActionMetadata, loadPageParts, materializeContracts, parseActionMetadata, parseInputFromFlags, resolveActionMetadataPath, resolveViewStatePromises };
+export { type ActionDiscoveryOptions, type ActionDiscoveryResult, type ActionIndexEntry, type ActionMetadata, type ActionSchema, type CommandFlag, type CommandIndexEntry, type CommandMetadata, type ContextIndexEntry, type DevServerPagePart, type DiscoveredCommand, type GenerateClientScriptOptions, type HeadlessInstanceComponent, type LoadPagePartsOptions, type LoadedPageParts, type MaterializeContractsOptions, type MaterializeResult, type PluginActionDiscoveryOptions, type PluginContractEntry, type PluginWithAgentKit, type PluginWithSetup, type PluginsIndex, type PluginsIndexEntry, type ProjectClientInitInfo, type RouteIndexEntry, type ScriptFragments, type ServiceIndexEntry, SetupNeedsAnswerError, SlowRenderCache, type SlowRenderCacheEntry, type ViteSSRLoader, buildAutomationWrap, buildPageReloadHmrScript, buildScriptFragments, clearServerElementCache, commandSchemaToFlags, discoverAllPluginActions, discoverAndRegisterActions, discoverPluginActions, discoverPluginCommands, discoverPluginsWithAgentKit, discoverPluginsWithSetup, executePluginAgentKit, executePluginCommand, executePluginSetup, generateClientScript, generateFrozenPageHtml, generatePromiseReconstruction, generateSSRPageHtml, headMetaToHeadTags, invalidateServerElementCache, listContracts, loadActionMetadata, loadPageParts, materializeContracts, parseActionMetadata, parseInputFromFlags, resolveActionMetadataPath, resolveClientImportPath, resolveViewStatePromises };

package/dist/index.js

@@ -18,6 +18,11 @@ import * as fs from "node:fs";
 import { createRequire as createRequire$1 } from "node:module";
 import { isJayAction, isJayStreamAction, isJayCliCommand } from "@jay-framework/fullstack-component";
 const require$3 = createRequire(import.meta.url);
+function resolveClientImportPath(route) {
+  if (route.clientCompPath) return route.clientCompPath;
+  if (route.componentExport) return route.compPath.replace(/index\.js$/, "index.client.js");
+  return route.compPath;
+}
 async function loadPageParts(vite, route, pagesBase, projectBase, jayRollupConfig, options) {
   const exists = await fs$1.access(route.compPath, fs$1.constants.F_OK).then(() => true).catch(() => false);
   const parts = [];
@@ -30,7 +35,7 @@ async function loadPageParts(vite, route, pagesBase, projectBase, jayRollupConfi
         `${route.compPath} does not export "${exportName}". The file exists but the expected export is missing — remove the file or add the export.`
       );
     } else {
-      const clientImportPath = route.componentExport ? route.compPath.replace(/index\.js$/, "index.client.js") : route.compPath;
+      const clientImportPath = resolveClientImportPath(route);
       parts.push({
         compDefinition: pageComponent,
         clientImport: `import {${exportName}} from '${clientImportPath}'`,
@@ -2329,5 +2334,6 @@ export {
   parseActionMetadata,
   parseInputFromFlags,
   resolveActionMetadataPath,
+  resolveClientImportPath,
   resolveViewStatePromises
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/stack-server-build",
-  "version": "0.24.3",
+  "version": "0.24.4",
   "license": "Apache-2.0",
   "main": "dist/index.js",
   "types": "dist/index.d.mts",
@@ -24,21 +24,21 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/compiler-jay-html": "^0.24.3",
-    "@jay-framework/compiler-shared": "^0.24.3",
-    "@jay-framework/component": "^0.24.3",
-    "@jay-framework/fullstack-component": "^0.24.3",
-    "@jay-framework/logger": "^0.24.3",
-    "@jay-framework/runtime": "^0.24.3",
-    "@jay-framework/ssr-runtime": "^0.24.3",
-    "@jay-framework/stack-route-scanner": "^0.24.3",
-    "@jay-framework/stack-server-runtime": "^0.24.3",
-    "@jay-framework/view-state-merge": "^0.24.3",
+    "@jay-framework/compiler-jay-html": "^0.24.4",
+    "@jay-framework/compiler-shared": "^0.24.4",
+    "@jay-framework/component": "^0.24.4",
+    "@jay-framework/fullstack-component": "^0.24.4",
+    "@jay-framework/logger": "^0.24.4",
+    "@jay-framework/runtime": "^0.24.4",
+    "@jay-framework/ssr-runtime": "^0.24.4",
+    "@jay-framework/stack-route-scanner": "^0.24.4",
+    "@jay-framework/stack-server-runtime": "^0.24.4",
+    "@jay-framework/view-state-merge": "^0.24.4",
     "yaml": "^2.3.4"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.24.3",
-    "@jay-framework/rollup-plugin": "^0.24.3",
+    "@jay-framework/dev-environment": "^0.24.4",
+    "@jay-framework/rollup-plugin": "^0.24.4",
     "@types/node": "^22.15.21",
     "rimraf": "^5.0.5",
     "tsup": "^8.0.1",