@jay-framework/stack-server-runtime 0.16.0 → 0.16.2

package/dist/index.d.ts

@@ -205,6 +205,8 @@ interface RegisteredActionBase {
     /** Optional metadata from .jay-action file (description, input/output schemas).
      *  Actions with metadata are exposed to AI agents; those without are not. */
     metadata?: ActionMetadata;
+    /** Whether this action accepts file uploads (DL#131) */
+    acceptsFiles?: boolean;
 }
 /**
  * Registered request-response action entry.
@@ -895,17 +897,17 @@ declare class SlowRenderCache {
      * Get a cached pre-rendered jay-html entry by reading from disk.
      * Returns undefined if the cache file doesn't exist or has no metadata tag.
      */
-    get(jayHtmlPath: string, params: Record<string, string>): Promise<SlowRenderCacheEntry | undefined>;
+    get(jayHtmlPath: string, params: Record<string, string>, routeDir?: string): Promise<SlowRenderCacheEntry | undefined>;
     /**
      * Store a pre-rendered jay-html entry.
      * Embeds metadata as a <script> tag and writes to disk.
      * Returns the full cache entry with stripped content.
      */
-    set(jayHtmlPath: string, params: Record<string, string>, preRenderedJayHtml: string, slowViewState: object, carryForward: object): Promise<SlowRenderCacheEntry>;
+    set(jayHtmlPath: string, params: Record<string, string>, preRenderedJayHtml: string, slowViewState: object, carryForward: object, routeDir?: string): Promise<SlowRenderCacheEntry>;
     /**
      * Check if a pre-rendered entry exists for the given path and params
      */
-    has(jayHtmlPath: string, params: Record<string, string>): Promise<boolean>;
+    has(jayHtmlPath: string, params: Record<string, string>, routeDir?: string): Promise<boolean>;
     /**
      * Invalidate all cached entries for a given jay-html source path.
      * Deletes cached files from disk.

package/dist/index.js

@@ -204,6 +204,7 @@ new JayAtomicType("string");
 new JayAtomicType("number");
 new JayAtomicType("boolean");
 new JayAtomicType("Date");
+new JayAtomicType("file");
 new JayAtomicType("Unknown");
 class JayObjectType {
   constructor(name, props) {
@@ -247,6 +248,9 @@ function jayTypeToJsonSchema(type) {
     if (name === "string" || name === "number" || name === "boolean") {
       return { type: name };
     }
+    if (name === "file") {
+      return { type: "string", description: "Binary file upload (JayFile)" };
+    }
     return { type: "string" };
   }
   if (isEnumType(type)) {
@@ -649,6 +653,17 @@ function buildFreezeScript(routePattern) {
             __jayDoFreeze();
           }
         });
+      }
+
+      // Targeted page reload: only reload if this page matches the changed route prefix
+      if (import.meta.hot) {
+        import.meta.hot.on('jay:page-reload', (data) => {
+          const prefix = data.routePrefix;
+          const pathname = window.location.pathname;
+          if (pathname === prefix || pathname.startsWith(prefix + '/')) {
+            window.location.reload();
+          }
+        });
       }`;
 }
 function buildAutomationWrap(options, mode) {
@@ -1114,11 +1129,12 @@ async function loadPageParts(vite, route, pagesBase, projectBase, jayRollupConfi
   const exists = await fs$2.access(route.compPath, fs$2.constants.F_OK).then(() => true).catch(() => false);
   const parts = [];
   if (exists) {
-    const pageComponent = (await vite.ssrLoadModule(route.compPath)).page;
+    const exportName = route.componentExport || "page";
+    const pageComponent = (await vite.ssrLoadModule(route.compPath))[exportName];
     parts.push({
       compDefinition: pageComponent,
-      clientImport: `import {page} from '${route.compPath}'`,
-      clientPart: `{comp: page.comp, contextMarkers: page.contexts || []}`
+      clientImport: `import {${exportName}} from '${route.compPath}'`,
+      clientPart: `{comp: ${exportName}.comp, contextMarkers: ${exportName}.contexts || []}`
     });
   }
   const jayHtmlFilePath = options?.preRenderedPath ?? route.jayHtmlPath;
@@ -1295,7 +1311,8 @@ class ActionRegistry {
       method: action.method,
       cacheOptions: action.cacheOptions,
       services: action.services,
-      handler: action.handler
+      handler: action.handler,
+      ...action.acceptsFiles && { acceptsFiles: true }
     };
     this.actions.set(action.actionName, entry);
   }
@@ -1452,7 +1469,8 @@ class ActionRegistry {
       method: "POST",
       isStreaming: true,
       services: action.services,
-      handler: action.handler
+      handler: action.handler,
+      ...action.acceptsFiles && { acceptsFiles: true }
     };
     this.actions.set(action.actionName, entry);
   }
@@ -2192,8 +2210,8 @@ class SlowRenderCache {
    * Get a cached pre-rendered jay-html entry by reading from disk.
    * Returns undefined if the cache file doesn't exist or has no metadata tag.
    */
-  async get(jayHtmlPath, params) {
-    const preRenderedPath = this.computeCachePath(jayHtmlPath, params);
+  async get(jayHtmlPath, params, routeDir) {
+    const preRenderedPath = this.computeCachePath(jayHtmlPath, params, routeDir);
     let fileContent;
     try {
       fileContent = await fs$2.readFile(preRenderedPath, "utf-8");
@@ -2217,8 +2235,8 @@ class SlowRenderCache {
    * Embeds metadata as a <script> tag and writes to disk.
    * Returns the full cache entry with stripped content.
    */
-  async set(jayHtmlPath, params, preRenderedJayHtml, slowViewState, carryForward) {
-    const preRenderedPath = this.computeCachePath(jayHtmlPath, params);
+  async set(jayHtmlPath, params, preRenderedJayHtml, slowViewState, carryForward, routeDir) {
+    const preRenderedPath = this.computeCachePath(jayHtmlPath, params, routeDir);
     const fileContent = embedCacheMetadata(
       preRenderedJayHtml,
       slowViewState,
@@ -2239,8 +2257,8 @@ class SlowRenderCache {
   /**
    * Check if a pre-rendered entry exists for the given path and params
    */
-  async has(jayHtmlPath, params) {
-    const preRenderedPath = this.computeCachePath(jayHtmlPath, params);
+  async has(jayHtmlPath, params, routeDir) {
+    const preRenderedPath = this.computeCachePath(jayHtmlPath, params, routeDir);
     try {
       await fs$2.access(preRenderedPath);
       return true;
@@ -2314,10 +2332,18 @@ class SlowRenderCache {
   /**
    * Compute the cache file path for a given jay-html path and params.
    */
-  computeCachePath(jayHtmlPath, params) {
-    const relativePath = path__default.relative(this.pagesRoot, jayHtmlPath);
-    const dir = path__default.dirname(relativePath);
-    const basename = path__default.basename(relativePath, ".jay-html");
+  computeCachePath(jayHtmlPath, params, routeDir) {
+    let dir;
+    if (routeDir) {
+      dir = routeDir;
+    } else {
+      const relativePath = path__default.relative(this.pagesRoot, jayHtmlPath);
+      dir = relativePath.startsWith("..") ? path__default.join(
+        "_plugins",
+        crypto.createHash("md5").update(jayHtmlPath).digest("hex").slice(0, 12)
+      ) : path__default.dirname(relativePath);
+    }
+    const basename = path__default.basename(jayHtmlPath, ".jay-html");
     const paramsHash = hashParams(params);
     const cacheFileName = `${basename}${paramsHash}.jay-html`;
     return path__default.join(this.cacheDir, dir, cacheFileName);
@@ -2337,8 +2363,11 @@ class SlowRenderCache {
    */
   async scanAndDeleteCacheFiles(jayHtmlPath) {
     const relativePath = path__default.relative(this.pagesRoot, jayHtmlPath);
-    const dir = path__default.dirname(relativePath);
-    const basename = path__default.basename(relativePath, ".jay-html");
+    const dir = relativePath.startsWith("..") ? path__default.join(
+      "_plugins",
+      crypto.createHash("md5").update(jayHtmlPath).digest("hex").slice(0, 12)
+    ) : path__default.dirname(relativePath);
+    const basename = path__default.basename(jayHtmlPath, ".jay-html");
     const cacheSubDir = path__default.join(this.cacheDir, dir);
     try {
       const files = await fs$2.readdir(cacheSubDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/stack-server-runtime",
-  "version": "0.16.0",
+  "version": "0.16.2",
   "license": "Apache-2.0",
   "main": "dist/index.js",
   "types": "dist/index.d.mts",
@@ -26,21 +26,21 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/compiler-jay-html": "^0.16.0",
-    "@jay-framework/compiler-shared": "^0.16.0",
-    "@jay-framework/component": "^0.16.0",
-    "@jay-framework/fullstack-component": "^0.16.0",
-    "@jay-framework/logger": "^0.16.0",
-    "@jay-framework/runtime": "^0.16.0",
-    "@jay-framework/ssr-runtime": "^0.16.0",
-    "@jay-framework/stack-route-scanner": "^0.16.0",
-    "@jay-framework/view-state-merge": "^0.16.0",
+    "@jay-framework/compiler-jay-html": "^0.16.2",
+    "@jay-framework/compiler-shared": "^0.16.2",
+    "@jay-framework/component": "^0.16.2",
+    "@jay-framework/fullstack-component": "^0.16.2",
+    "@jay-framework/logger": "^0.16.2",
+    "@jay-framework/runtime": "^0.16.2",
+    "@jay-framework/ssr-runtime": "^0.16.2",
+    "@jay-framework/stack-route-scanner": "^0.16.2",
+    "@jay-framework/view-state-merge": "^0.16.2",
     "yaml": "^2.3.4"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.16.0",
-    "@jay-framework/jay-cli": "^0.16.0",
-    "@jay-framework/stack-client-runtime": "^0.16.0",
+    "@jay-framework/dev-environment": "^0.16.2",
+    "@jay-framework/jay-cli": "^0.16.2",
+    "@jay-framework/stack-client-runtime": "^0.16.2",
     "@types/express": "^5.0.2",
     "@types/node": "^22.15.21",
     "nodemon": "^3.0.3",