@jay-framework/jay-stack-cli 0.15.1 → 0.15.3

package/agent-kit-template/routing.md

@@ -142,3 +142,20 @@ jay-stack params wix-stores/product-page
 ```
 
 Params are always strings (URL params).
+
+## Query Parameters
+
+URL query parameters (`?page=2&sort=price`) are available in the **fast render phase only** via `props.query`:
+
+```typescript
+.withFastRender(async (props, carryForward, dbService) => {
+    const page = parseInt(props.query.page || '1');
+    const sort = props.query.sort || 'name';
+    const products = await dbService.getProducts({ page, sort });
+    return phaseOutput({ products, currentPage: page }, {});
+})
+```
+
+- `props.query` is `Record<string, string>` — empty `{}` when no query string
+- Not available in the slow phase (compile error) — slow results are cached by path params only
+- In the interactive phase, use `new URLSearchParams(window.location.search)` directly

package/dist/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import express from "express";
+import http from "node:http";
 import { mkDevServer, createViteForCli } from "@jay-framework/dev-server";
 import { createEditorServer } from "@jay-framework/editor-server";
 import getPort from "get-port";
@@ -2406,6 +2407,7 @@ async function startDevServer(options = {}) {
     outputDir: "build"
   };
   const app = express();
+  const httpServer = http.createServer(app);
   const devServerPort = await getPort({ port: resolvedConfig.devServer.portRange });
   const log = getLogger();
   const editorServer = createEditorServer({
@@ -2443,7 +2445,8 @@ async function startDevServer(options = {}) {
     projectRootFolder: process.cwd(),
     publicBaseUrlPath: "/",
     jayRollupConfig: jayOptions,
-    logLevel: options.logLevel
+    logLevel: options.logLevel,
+    httpServer
   });
   app.use(server);
   const publicPath = path.resolve(resolvedConfig.devServer.publicFolder);
@@ -2456,7 +2459,7 @@ async function startDevServer(options = {}) {
     app.get(route.path, route.handler);
   });
   generatePageDefinitionFiles(routes, jayOptions.tsConfigFilePath, process.cwd());
-  const expressServer = app.listen(devServerPort, () => {
+  httpServer.listen(devServerPort, () => {
     log.important(`🚀 Jay Stack dev server started successfully!`);
     log.important(`📱 Dev Server: http://localhost:${devServerPort}`);
     log.important(`🎨 Editor Server: http://localhost:${editorPort} (ID: ${editorId})`);
@@ -2478,8 +2481,8 @@ async function startDevServer(options = {}) {
   const shutdown = async () => {
     log.important("\n🛑 Shutting down servers...");
     await editorServer.stop();
-    expressServer.closeAllConnections();
-    await new Promise((resolve) => expressServer.close(resolve));
+    httpServer.closeAllConnections();
+    await new Promise((resolve) => httpServer.close(resolve));
     process.exit(0);
   };
   if (options.testMode) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/jay-stack-cli",
-  "version": "0.15.1",
+  "version": "0.15.3",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -24,14 +24,14 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/compiler-jay-html": "^0.15.1",
-    "@jay-framework/compiler-shared": "^0.15.1",
-    "@jay-framework/dev-server": "^0.15.1",
-    "@jay-framework/editor-server": "^0.15.1",
-    "@jay-framework/fullstack-component": "^0.15.1",
-    "@jay-framework/logger": "^0.15.1",
-    "@jay-framework/plugin-validator": "^0.15.1",
-    "@jay-framework/stack-server-runtime": "^0.15.1",
+    "@jay-framework/compiler-jay-html": "^0.15.3",
+    "@jay-framework/compiler-shared": "^0.15.3",
+    "@jay-framework/dev-server": "^0.15.3",
+    "@jay-framework/editor-server": "^0.15.3",
+    "@jay-framework/fullstack-component": "^0.15.3",
+    "@jay-framework/logger": "^0.15.3",
+    "@jay-framework/plugin-validator": "^0.15.3",
+    "@jay-framework/stack-server-runtime": "^0.15.3",
     "chalk": "^4.1.2",
     "commander": "^14.0.0",
     "express": "^5.0.1",
@@ -42,7 +42,7 @@
     "yaml": "^2.3.4"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.15.1",
+    "@jay-framework/dev-environment": "^0.15.3",
     "@types/express": "^5.0.2",
     "@types/node": "^22.15.21",
     "nodemon": "^3.0.3",