@jay-framework/stack-server-runtime 0.5.0

package/dist/index.d.mts

@@ -0,0 +1,31 @@
+import { AnyJayStackComponentDefinition, PageProps, AnySlowlyRenderResult, UrlParams, JayStackComponentDefinition, AnyFastRenderResult } from '@jay-framework/fullstack-component';
+import { JayComponentCore } from '@jay-framework/component';
+import { ViteDevServer } from 'vite';
+import { JayRoute } from '@jay-framework/stack-route-scanner';
+import { WithValidations } from '@jay-framework/compiler-shared';
+import { JayRollupConfig } from '@jay-framework/rollup-plugin';
+
+interface DevServerPagePart {
+    compDefinition: AnyJayStackComponentDefinition;
+    key?: string;
+    clientImport: string;
+    clientPart: string;
+}
+declare function loadPageParts(vite: ViteDevServer, route: JayRoute, pagesBase: string, jayRollupConfig: JayRollupConfig): Promise<WithValidations<DevServerPagePart[]>>;
+
+interface SlowlyChangingPhase {
+    runSlowlyForPage(pageParams: object, pageProps: PageProps, parts: Array<DevServerPagePart>): Promise<AnySlowlyRenderResult>;
+}
+declare class DevSlowlyChangingPhase implements SlowlyChangingPhase {
+    private dontCacheSlowly;
+    constructor(dontCacheSlowly: boolean);
+    runSlowlyForPage(pageParams: UrlParams, pageProps: PageProps, parts: Array<DevServerPagePart>): Promise<AnySlowlyRenderResult>;
+}
+declare function runLoadParams<StaticViewState extends object, ViewState extends object, Refs extends object, ServerContexts extends Array<any>, ClientContexts extends Array<any>, PropsT extends object, Params extends UrlParams, CompCore extends JayComponentCore<PropsT, ViewState>>(compDefinition: JayStackComponentDefinition<StaticViewState, ViewState, Refs, ServerContexts, ClientContexts, PropsT, Params, CompCore>, serverContexts: ServerContexts): Promise<void>;
+declare function runSlowlyChangingRender<StaticViewState extends object, ViewState extends object, Refs extends object, ServerContexts extends Array<any>, ClientContexts extends Array<any>, PropsT extends object, Params extends UrlParams, CompCore extends JayComponentCore<PropsT, ViewState>>(compDefinition: JayStackComponentDefinition<StaticViewState, ViewState, Refs, ServerContexts, ClientContexts, PropsT, Params, CompCore>): void;
+
+declare function renderFastChangingData(pageParams: object, pageProps: PageProps, carryForward: object, parts: Array<DevServerPagePart>): Promise<AnyFastRenderResult>;
+
+declare function generateClientScript(defaultViewState: object, fastCarryForward: object, parts: DevServerPagePart[], jayHtmlPath: string): string;
+
+export { DevSlowlyChangingPhase, type SlowlyChangingPhase, generateClientScript, loadPageParts, renderFastChangingData, runLoadParams, runSlowlyChangingRender };

package/dist/index.js

@@ -0,0 +1,186 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const fullstackComponent = require("@jay-framework/fullstack-component");
+const fs = require("node:fs/promises");
+const path = require("node:path");
+const compilerJayHtml = require("@jay-framework/compiler-jay-html");
+function isLeftSideParamsSubsetOfRightSideParams(left, right) {
+  return Object.keys(left).reduce((prev, curr) => prev && left[curr] === right[curr], true);
+}
+async function findMatchingParams(search, searchTarget) {
+  for await (const paramsArray of searchTarget) {
+    if (paramsArray.find((params) => isLeftSideParamsSubsetOfRightSideParams(search, params)))
+      return true;
+  }
+  return false;
+}
+class DevSlowlyChangingPhase {
+  constructor(dontCacheSlowly) {
+    this.dontCacheSlowly = dontCacheSlowly;
+  }
+  async runSlowlyForPage(pageParams, pageProps, parts) {
+    for (const part of parts) {
+      const { compDefinition } = part;
+      if (compDefinition.loadParams) {
+        const compParams = compDefinition.loadParams([]);
+        if (!await findMatchingParams(pageParams, compParams))
+          return fullstackComponent.notFound();
+      }
+    }
+    let slowlyViewState = {};
+    let carryForward = {};
+    for (const part of parts) {
+      const { compDefinition, key } = part;
+      if (compDefinition.slowlyRender) {
+        const slowlyRenderedPart = await compDefinition.slowlyRender(
+          { ...pageProps, ...pageParams },
+          []
+        );
+        if (slowlyRenderedPart.kind === "PartialRender") {
+          if (!key) {
+            slowlyViewState = { ...slowlyViewState, ...slowlyRenderedPart.rendered };
+            carryForward = { ...carryForward, ...slowlyRenderedPart.carryForward };
+          } else {
+            slowlyViewState[key] = slowlyRenderedPart.rendered;
+            carryForward[key] = slowlyRenderedPart.carryForward;
+          }
+        } else
+          return slowlyRenderedPart;
+      }
+    }
+    return fullstackComponent.partialRender(slowlyViewState, carryForward);
+  }
+}
+async function runLoadParams(compDefinition, serverContexts) {
+  compDefinition.loadParams(serverContexts);
+}
+function runSlowlyChangingRender(compDefinition) {
+}
+async function renderFastChangingData(pageParams, pageProps, carryForward, parts) {
+  let fastViewState = {};
+  let fastCarryForward = {};
+  for (const part of parts) {
+    const { compDefinition, key } = part;
+    if (compDefinition.fastRender) {
+      const partSlowlyCarryForward = key ? carryForward[key] : carryForward;
+      const fastRenderedPart = await compDefinition.fastRender(
+        { ...pageProps, ...pageParams },
+        ...[partSlowlyCarryForward]
+      );
+      if (fastRenderedPart.kind === "PartialRender") {
+        if (!key) {
+          fastViewState = { ...fastViewState, ...fastRenderedPart.rendered };
+          fastCarryForward = { ...fastCarryForward, ...fastRenderedPart.carryForward };
+        } else {
+          fastViewState[key] = fastRenderedPart.rendered;
+          fastCarryForward[key] = fastRenderedPart.carryForward;
+        }
+      } else
+        return fastRenderedPart;
+    }
+  }
+  return Promise.resolve(fullstackComponent.partialRender(fastViewState, fastCarryForward));
+}
+function generateClientScript(defaultViewState, fastCarryForward, parts, jayHtmlPath) {
+  const imports = parts.length > 1 ? parts.map((part) => part.clientImport).join("\n") + "\n" : "";
+  const compositeParts = parts.length > 1 ? `[
+${parts.map((part) => "        " + part.clientPart).join(",\n")}
+        ]` : "[]";
+  return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Vite + TS</title>
+  </head>
+  <body>
+    <div id="target"></div>
+    <script type="module">
+      import {makeCompositeJayComponent} from "@jay-framework/stack-client-runtime";
+      import { render } from '${jayHtmlPath}';
+      ${imports}
+      const viewState = ${JSON.stringify(defaultViewState)};
+      const fastCarryForward = ${JSON.stringify(fastCarryForward)};
+
+      const target = document.getElementById('target');
+      const pageComp = makeCompositeJayComponent(render, viewState, fastCarryForward, ${compositeParts})
+
+      const instance = pageComp({...viewState, ...fastCarryForward})
+      target.appendChild(instance.element.dom);
+    <\/script>
+  </body>
+</html>`;
+}
+async function loadPageParts(vite, route, pagesBase, jayRollupConfig) {
+  const exists = await fs.access(route.compPath, fs.constants.F_OK).then(() => true).catch(() => false);
+  const parts = [];
+  const pageCode = path.resolve(pagesBase, "./page.ts");
+  if (exists) {
+    const pageComponent = (await vite.ssrLoadModule(route.compPath)).page;
+    parts.push({
+      compDefinition: pageComponent,
+      clientImport: `import {page} from '${pageCode}'`,
+      clientPart: `{comp: page.comp, contextMarkers: []}`
+    });
+  }
+  const jayHtmlSource = (await fs.readFile(route.jayHtmlPath)).toString();
+  const fileName = path.basename(route.jayHtmlPath);
+  const dirName = path.dirname(route.jayHtmlPath);
+  const module2 = await import("@jay-framework/compiler-jay-html");
+  const JAY_IMPORT_RESOLVER = module2.JAY_IMPORT_RESOLVER;
+  const jayHtmlWithValidations = await compilerJayHtml.parseJayFile(
+    jayHtmlSource,
+    fileName,
+    dirName,
+    {
+      relativePath: jayRollupConfig.tsConfigFilePath
+    },
+    JAY_IMPORT_RESOLVER
+  );
+  return jayHtmlWithValidations.mapAsync(async (jayHtml) => {
+    for await (const headlessImport of jayHtml.headlessImports) {
+      const module22 = headlessImport.codeLink.module;
+      const name = headlessImport.codeLink.names[0].name;
+      const modulePath = module22[0] === "." ? path.resolve(dirName, module22) : require.resolve(module22, { paths: require.resolve.paths(dirName) });
+      const compDefinition = (await vite.ssrLoadModule(modulePath))[name];
+      const moduleImport = module22.startsWith("./") ? path.resolve(pagesBase, module22) : module22;
+      const key = headlessImport.key;
+      const part = {
+        key,
+        compDefinition,
+        clientImport: `import {${name}} from '${moduleImport}'`,
+        clientPart: `{comp: ${name}.comp, contextMarkers: [], key: '${headlessImport.key}'}`
+      };
+      parts.push(part);
+    }
+    return parts;
+  });
+}
+exports.DevSlowlyChangingPhase = DevSlowlyChangingPhase;
+exports.generateClientScript = generateClientScript;
+exports.loadPageParts = loadPageParts;
+exports.renderFastChangingData = renderFastChangingData;
+exports.runLoadParams = runLoadParams;
+exports.runSlowlyChangingRender = runSlowlyChangingRender;

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@jay-framework/stack-server-runtime",
+  "version": "0.5.0",
+  "license": "Apache-2.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.mts",
+  "directories": {
+    "lib": "lib"
+  },
+  "files": [
+    "dist",
+    "readme.md"
+  ],
+  "scripts": {
+    "build": "npm run build:js && npm run build:types",
+    "build:watch": "npm run build:js -- --watch & npm run build:types -- --watch",
+    "build:js": "vite build",
+    "build:types": "tsup lib/index.ts --dts-only --format esm",
+    "build:check-types": "tsc",
+    "test-definitions": "jay-cli definitions test",
+    "test-runtime": "jay-cli runtime test",
+    "clean": "rimraf dist",
+    "confirm": "npm run clean && npm run build && npm run build:check-types && npm run test",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@jay-framework/compiler-jay-html": "workspace:^",
+    "@jay-framework/component": "workspace:^",
+    "@jay-framework/fullstack-component": "workspace:^",
+    "@jay-framework/runtime": "workspace:^",
+    "@jay-framework/stack-route-scanner": "workspace:^"
+  },
+  "devDependencies": {
+    "@jay-framework/dev-environment": "workspace:^",
+    "@jay-framework/jay-cli": "workspace:^",
+    "@jay-framework/stack-client-runtime": "workspace:^",
+    "@types/express": "^5.0.2",
+    "@types/node": "^22.15.21",
+    "nodemon": "^3.0.3",
+    "replace-in-file": "^7.1.0",
+    "rimraf": "^5.0.5",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.11",
+    "vitest": "^1.2.1"
+  }
+}