@jay-framework/production-server 0.17.4 → 0.18.0

package/dist/serve-index-9aAW1pbg.d.ts

@@ -0,0 +1,179 @@
+import * as _jay_framework_ssr_runtime from '@jay-framework/ssr-runtime';
+import { ActionRegistry } from '@jay-framework/stack-server-runtime';
+
+interface RouteManifest {
+    version: string;
+    buildTimestamp: string;
+    sourceHash: string;
+    projectRoot: string;
+    sharedManifest: Record<string, string>;
+    routes: RouteEntry[];
+    actions: ActionEntry[];
+    plugins: PluginEntry[];
+}
+interface RouteSegment {
+    type: 'static' | 'param' | 'optional' | 'catchAll' | 'optionalCatchAll';
+    value: string;
+}
+interface RouteEntry {
+    pattern: string;
+    segments: RouteSegment[];
+    serverModule: string;
+    trackByMap?: Record<string, string>;
+    contracts?: string[];
+    componentExport?: string;
+    /** Per-route server element path (DL#144). Shared across all instances. */
+    serverElementPath?: string;
+    /** Per-route CSS file path (DL#144). Extracted from route-level server element compilation. */
+    routeCssPath?: string;
+    /** Per-route hydrate script path (DL#144). Shared across all instances. */
+    routeHydratePath?: string;
+    /** Per-route client bundle path (DL#144). Entry that imports route hydrate script. */
+    routeClientBundlePath?: string;
+    instances: InstanceEntry[];
+    isPlugin?: boolean;
+    pluginName?: string;
+}
+interface InstanceEntry {
+    params: Record<string, string>;
+    cachePath: string;
+    serverElementPath: string;
+    clientBundlePath: string;
+    clientCssPath?: string;
+}
+interface CacheEntry {
+    slowViewState: object;
+    carryForward: object;
+}
+interface ActionEntry {
+    serverModule: string;
+    packageName?: string;
+    isPlugin: boolean;
+    actionNames: string[];
+}
+interface PluginEntry {
+    name: string;
+    packageName: string;
+}
+interface BuildMetadata {
+    version: string;
+    sourceHash: string;
+    buildTimestamp: string;
+    nodeVersion: string;
+    instanceCount: number;
+}
+interface BuildOptions {
+    version: string;
+    projectRoot: string;
+    pagesRoot: string;
+    buildRoot: string;
+    concurrency: number;
+    tsConfigFilePath: string;
+    minify?: boolean;
+}
+interface ServerElementModule {
+    renderToStream: (vs: object, ctx: _jay_framework_ssr_runtime.ServerRenderContext) => void;
+}
+interface PageModule {
+    [key: string]: any;
+}
+
+interface PagePartsConfigEntry {
+    modulePath: string;
+    exportName: string;
+    source: 'npm' | 'local';
+}
+interface PagePartsConfig {
+    parts: Array<PagePartsConfigEntry & {
+        key?: string;
+        contractInfo?: {
+            contractName: string;
+            metadata?: Record<string, unknown>;
+        };
+    }>;
+    instanceComponents: Array<PagePartsConfigEntry & {
+        contractName: string;
+        propNames: string[];
+    }>;
+    forEachInstances: Array<{
+        contractName: string;
+        forEachPath: string;
+        trackBy: string;
+        propBindings: Record<string, string>;
+        coordinateSuffix: string;
+    }>;
+}
+
+/**
+ * Interface for reading build artifacts at serve time (DL#143).
+ * FilesystemArtifactStore is the default implementation.
+ * BaaS deployments provide a custom implementation that fetches from cloud storage.
+ */
+interface ArtifactStore {
+    readManifest(): Promise<RouteManifest>;
+    readCacheData(relativePath: string): Promise<CacheEntry>;
+    readPagePartsConfig(relativePath: string): Promise<PagePartsConfig>;
+    loadServerElement(relativePath: string): Promise<ServerElementModule>;
+    loadModule(modulePath: string, local?: boolean): Promise<any>;
+    getAssetPath(relativePath: string): string;
+    getBuildDir(): string;
+}
+declare class FilesystemArtifactStore implements ArtifactStore {
+    private basePath;
+    private manifestCache?;
+    private metadataMtime?;
+    private moduleCache;
+    constructor(basePath: string);
+    readManifest(): Promise<RouteManifest>;
+    readCacheData(relativePath: string): Promise<CacheEntry>;
+    readPagePartsConfig(relativePath: string): Promise<PagePartsConfig>;
+    loadServerElement(relativePath: string): Promise<ServerElementModule>;
+    getAssetPath(relativePath: string): string;
+    getBuildDir(): string;
+    loadModule(modulePath: string, local?: boolean): Promise<any>;
+}
+
+interface MatchResult {
+    route: RouteEntry;
+    instance: InstanceEntry;
+    params: Record<string, string>;
+    pathname: string;
+}
+declare function matchRequest(manifest: RouteManifest, pathname: string): MatchResult | undefined;
+
+declare function fetchPageRequest(match: MatchResult, manifest: RouteManifest, requestUrl: URL, artifacts: ArtifactStore, staticBaseUrl: string, cookies?: Record<string, string>): Promise<Response>;
+
+declare function isActionRequest(pathname: string): boolean;
+declare function fetchActionRequest(request: Request, registry?: ActionRegistry): Promise<Response>;
+declare function registerActionsFromManifest(actions: Array<{
+    serverModule: string;
+    isPlugin: boolean;
+    actionNames: string[];
+    packageName?: string;
+}>, buildDir: string, registry?: ActionRegistry): Promise<void>;
+/**
+ * Register actions from pre-imported modules (DL#143).
+ * Used by BaaS entry.mjs where action modules are bundled by esbuild.
+ */
+declare function registerActionsFromModules(modules: Array<{
+    module: Record<string, unknown>;
+    name: string;
+}>, registry?: ActionRegistry): Promise<void>;
+
+declare function fetchStaticFile(pathname: string, frontendDir: string): Promise<Response | null>;
+
+interface PreImportedPlugin {
+    name: string;
+    init: {
+        _serverInit: () => Promise<any>;
+    };
+}
+/**
+ * Initialize services from pre-imported plugin modules (DL#143).
+ * Used by BaaS entry.mjs where plugins are bundled by esbuild
+ * and cannot be discovered from the filesystem at runtime.
+ */
+declare function initializeServicesFromModules(plugins: PreImportedPlugin[], label: string): Promise<void>;
+declare function initializeServices(buildDir: string, projectRoot: string, label: string): Promise<void>;
+
+export { type ActionEntry as A, type BuildOptions as B, type CacheEntry as C, FilesystemArtifactStore as F, type InstanceEntry as I, type MatchResult as M, type PluginEntry as P, type RouteManifest as R, type ServerElementModule as S, type RouteEntry as a, type RouteSegment as b, type BuildMetadata as c, type PageModule as d, type ArtifactStore as e, fetchPageRequest as f, fetchActionRequest as g, registerActionsFromModules as h, isActionRequest as i, fetchStaticFile as j, initializeServices as k, initializeServicesFromModules as l, matchRequest as m, type PreImportedPlugin as n, registerActionsFromManifest as r };

package/dist/serve-index.d.ts

@@ -0,0 +1,3 @@
+export { e as ArtifactStore, C as CacheEntry, F as FilesystemArtifactStore, I as InstanceEntry, M as MatchResult, n as PreImportedPlugin, a as RouteEntry, R as RouteManifest, S as ServerElementModule, g as fetchActionRequest, f as fetchPageRequest, j as fetchStaticFile, k as initializeServices, l as initializeServicesFromModules, i as isActionRequest, m as matchRequest, r as registerActionsFromManifest, h as registerActionsFromModules } from './serve-index-9aAW1pbg.js';
+import '@jay-framework/ssr-runtime';
+import '@jay-framework/stack-server-runtime';

package/dist/serve-index.js

@@ -0,0 +1,23 @@
+import { F, a, f, c, d, e, i, m, r, b } from "./init-services-BKVwxzYb.js";
+import "node:fs/promises";
+import "node:path";
+import "@jay-framework/stack-server-runtime";
+import "@jay-framework/view-state-merge";
+import "@jay-framework/ssr-runtime";
+import "node:module";
+import "@jay-framework/logger";
+import "@jay-framework/compiler-jay-html";
+import "@jay-framework/compiler-shared";
+import "@jay-framework/fullstack-component";
+export {
+  F as FilesystemArtifactStore,
+  a as fetchActionRequest,
+  f as fetchPageRequest,
+  c as fetchStaticFile,
+  d as initializeServices,
+  e as initializeServicesFromModules,
+  i as isActionRequest,
+  m as matchRequest,
+  r as registerActionsFromManifest,
+  b as registerActionsFromModules
+};

package/package.json

@@ -1,9 +1,20 @@
 {
   "name": "@jay-framework/production-server",
-  "version": "0.17.4",
+  "version": "0.18.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./serve": {
+      "types": "./dist/serve-index.d.ts",
+      "default": "./dist/serve-index.js"
+    }
+  },
   "files": [
     "dist"
   ],
@@ -11,7 +22,7 @@
     "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:types": "tsup lib/index.ts lib/serve-index.ts --dts-only --format esm",
     "build:check-types": "tsc",
     "clean": "rimraf dist",
     "confirm": "npm run clean && npm run build && npm run build:check-types && npm run test",
@@ -19,20 +30,20 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/compiler-jay-html": "^0.17.4",
-    "@jay-framework/compiler-jay-stack": "^0.17.4",
-    "@jay-framework/compiler-shared": "^0.17.4",
-    "@jay-framework/fullstack-component": "^0.17.4",
-    "@jay-framework/logger": "^0.17.4",
-    "@jay-framework/ssr-runtime": "^0.17.4",
-    "@jay-framework/stack-route-scanner": "^0.17.4",
-    "@jay-framework/stack-server-runtime": "^0.17.4",
-    "@jay-framework/view-state-merge": "^0.17.4",
-    "@jay-framework/vite-plugin": "^0.17.4",
+    "@jay-framework/compiler-jay-html": "^0.18.0",
+    "@jay-framework/compiler-jay-stack": "^0.18.0",
+    "@jay-framework/compiler-shared": "^0.18.0",
+    "@jay-framework/fullstack-component": "^0.18.0",
+    "@jay-framework/logger": "^0.18.0",
+    "@jay-framework/ssr-runtime": "^0.18.0",
+    "@jay-framework/stack-route-scanner": "^0.18.0",
+    "@jay-framework/stack-server-runtime": "^0.18.0",
+    "@jay-framework/view-state-merge": "^0.18.0",
+    "@jay-framework/vite-plugin": "^0.18.0",
     "vite": "^5.0.11"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.17.4",
+    "@jay-framework/dev-environment": "^0.18.0",
     "@types/node": "^22.15.21",
     "rimraf": "^5.0.5",
     "tsup": "^8.0.1",