@jay-framework/production-server 0.25.5 → 0.26.0

package/dist/serve-index-C28bP6tW.d.ts

@@ -1,260 +0,0 @@
-import * as _jay_framework_ssr_runtime from '@jay-framework/ssr-runtime';
-import { JayHtmlHeadMeta, JayHtmlScript, DevServerPagePart, HeadlessInstanceComponent, ForEachHeadlessInstance, ActionRegistry } from '@jay-framework/stack-server-runtime';
-import { HeadTag } from '@jay-framework/fullstack-component';
-
-interface RouteManifest {
-    version: string;
-    projectRoot: string;
-    sharedManifest: Record<string, string>;
-    routes: RouteEntry[];
-    actions: ActionEntry[];
-    plugins: PluginEntry[];
-    /**
-     * Site-level JSON-LD (Organization + WebSite) head tags, generated once at build from
-     * `.jay` `site` config and injected into every served page's `<head>` (DL#213). Empty/absent
-     * when `site.name` is not configured.
-     */
-    siteHeadTags?: HeadTag[];
-    /**
-     * Compiled error pages keyed by status token (`"404"`, `"502"`, `"5xx"`, …) (DL#218).
-     * Resolved by status (exact → family), never by URL — kept out of `routes[]` so they are
-     * non-navigable and excluded from sitemap/llms.txt/robots/internal-link validation.
-     */
-    errorPages?: Record<string, ErrorPageEntry>;
-}
-/**
- * A compiled error page (DL#218). Mirrors the per-route compiled refs of a single-instance
- * route, minus URL/param machinery: an error page is resolved by status, not by matching a URL.
- */
-interface ErrorPageEntry {
-    /** Status token this page serves — exact (`"404"`, `"502"`) or family (`"4xx"`, `"5xx"`). */
-    token: string;
-    /** Per-page server element path (relative to backend dir). */
-    serverElementPath: string;
-    /** Per-page CSS file path (relative to frontend dir). */
-    routeCssPath?: string;
-    /** Per-page hydrate script path (relative to frontend dir). */
-    routeHydratePath?: string;
-    /** Per-page client bundle path (relative to frontend dir). */
-    routeClientBundlePath?: string;
-    /** External @import URLs extracted from CSS at build time. */
-    cssImports?: string[];
-    /** Head metadata from the error page's jay-html <head>. */
-    headMeta?: JayHtmlHeadMeta;
-    /** Passthrough `<script jay-script="allow">` tags from the template. */
-    scripts?: JayHtmlScript[];
-    /** Shared chunk package names this page's hydrate/client bundle imports (DL#177). */
-    sharedDeps?: string[];
-    /** trackBy map threaded to the client hydration entry. */
-    trackByMap?: Record<string, string>;
-    /**
-     * Optional pre-rendered slow (static chrome) ViewState. Unused in v1 — an error page is a
-     * pass-through of the injected `error` ViewState (DL#218 Q6); its static chrome renders
-     * from the template without slow data. The renderer merges `slowCache?.slowViewState ?? {}`.
-     */
-    slowCache?: CacheEntry;
-}
-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;
-    /** External @import URLs extracted from CSS at build time (DL#146). Used for preload hints. */
-    cssImports?: string[];
-    /** Head metadata from jay-html <head> (title, meta tags). */
-    headMeta?: JayHtmlHeadMeta;
-    /** Passthrough `<script jay-script="allow">` tags from the jay-html template (DL#149 Phase 2). */
-    scripts?: JayHtmlScript[];
-    /** True when page has static <meta name="robots" content="noindex"> */
-    noIndex?: boolean;
-    instances: InstanceEntry[];
-    isPlugin?: boolean;
-    pluginName?: string;
-    /** Shared chunk package names this route's hydrate script imports (DL#177). */
-    sharedDeps?: string[];
-    /** When true, dev-server tooling route (future: excluded from production builds). */
-    devOnly?: boolean;
-}
-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;
-    /** Site base URL for sitemap generation (e.g. "https://example.com"). */
-    siteBaseUrl?: string;
-    /** Site identity for Organization + WebSite JSON-LD generation (DL#213). */
-    site?: {
-        name?: string;
-        baseUrl?: string;
-        logo?: string;
-        description?: string;
-        sameAs?: string[];
-    };
-}
-interface ServerElementModule {
-    renderToStream: (vs: object, ctx: _jay_framework_ssr_runtime.ServerRenderContext) => void;
-}
-interface PageModule {
-    [key: string]: any;
-}
-
-interface PagePartsConfigEntry {
-    modulePath: string;
-    exportName: string;
-    source: 'local' | 'npm';
-    structural?: boolean;
-}
-interface PagePartsConfig {
-    parts: Array<PagePartsConfigEntry & {
-        key?: string;
-        contractInfo?: {
-            contractName: string;
-            metadata?: Record<string, unknown>;
-        };
-        headlessProps?: Record<string, string>;
-    }>;
-    instanceComponents: Array<PagePartsConfigEntry & {
-        contractName: string;
-        propNames: string[];
-        structuralTags?: Array<{
-            name: string;
-            phase?: string;
-        }>;
-    }>;
-    forEachInstances: Array<{
-        contractName: string;
-        forEachPath: string;
-        trackBy: string;
-        propBindings: Record<string, string>;
-        coordinateSuffix: string;
-    }>;
-}
-interface ProductionPageParts {
-    parts: DevServerPagePart[];
-    headlessContracts: any[];
-    headlessInstanceComponents: HeadlessInstanceComponent[];
-    discoveredInstances: any[];
-    forEachInstances: ForEachHeadlessInstance[];
-    keyedPartModules: any[];
-    headlessModuleInfos: any[];
-}
-declare function loadPagePartsFromConfig(configPath: string, artifacts: ArtifactStore): Promise<ProductionPageParts>;
-
-/**
- * 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 ArtifactStore as A, type BuildMetadata as B, type CacheEntry as C, type ErrorPageEntry as E, FilesystemArtifactStore as F, type InstanceEntry as I, type MatchResult as M, type PageModule as P, type RouteManifest as R, type ServerElementModule as S, type RouteEntry as a, type ActionEntry as b, type BuildOptions as c, type PluginEntry as d, type PreImportedPlugin as e, type RouteSegment as f, fetchActionRequest as g, fetchPageRequest as h, fetchStaticFile as i, initializeServices as j, initializeServicesFromModules as k, isActionRequest as l, loadPagePartsFromConfig as m, matchRequest as n, registerActionsFromModules as o, registerActionsFromManifest as r };