@ecopages/core 0.2.0-alpha.1 → 0.2.0-alpha.10

package/src/dev/sc-server.ts

@@ -1,143 +0,0 @@
-import { extname, join } from 'node:path';
-import { STATUS_MESSAGE } from '../constants.ts';
-import { fileSystem } from '@ecopages/file-system';
-import { ServerUtils } from '../utils/server-utils.module.ts';
-import type { Server } from 'bun';
-import type { EcoPagesAppConfig } from '../internal-types.ts';
-import { getRequiredBunRuntime } from '../utils/runtime.ts';
-
-type StaticContentServerOptions = {
-	port?: number;
-};
-
-/**
- * Static content server for production builds.
- * Serves pre-built static files from the dist directory with gzip compression support.
- */
-export class StaticContentServer {
-	server: Server<unknown> | null = null;
-	private appConfig: EcoPagesAppConfig;
-	private options: StaticContentServerOptions = { port: 3000 };
-
-	constructor({ appConfig, options }: { appConfig: EcoPagesAppConfig; options?: StaticContentServerOptions }) {
-		this.appConfig = appConfig;
-		if (options) this.options = options;
-		this.startServer();
-	}
-
-	private shouldServeGzip(contentType: ReturnType<typeof ServerUtils.getContentType>) {
-		return ['text/javascript', 'text/css'].includes(contentType);
-	}
-
-	private isHtml(contentType: string) {
-		return contentType === 'text/html';
-	}
-
-	private async sendNotFoundPage() {
-		const error404TemplatePath = `${this.appConfig.absolutePaths.distDir}/404.html`;
-
-		try {
-			fileSystem.exists(error404TemplatePath);
-		} catch {
-			return new Response(STATUS_MESSAGE[404], {
-				status: 404,
-			});
-		}
-
-		const response = new Response(fileSystem.readFileAsBuffer(error404TemplatePath) as BodyInit, {
-			headers: { 'Content-Type': 'text/html' },
-		});
-
-		return response;
-	}
-
-	private async serveFromDir({ path, request }: { path: string; request: Request }): Promise<Response> {
-		const { absolutePaths } = this.appConfig;
-		const basePath = join(absolutePaths.distDir, path);
-		const contentType = ServerUtils.getContentType(extname(basePath));
-		const acceptsGzip = request.headers.get('Accept-Encoding')?.includes('gzip');
-
-		try {
-			if (acceptsGzip && this.shouldServeGzip(contentType)) {
-				const gzipPath = `${basePath}.gz`;
-				if (fileSystem.exists(gzipPath)) {
-					const file = fileSystem.readFileAsBuffer(gzipPath) as BodyInit;
-					return new Response(file, {
-						headers: {
-							'Content-Type': contentType,
-							'Content-Encoding': 'gzip',
-							Vary: 'Accept-Encoding',
-						},
-					});
-				}
-			}
-
-			if (path.includes('.') && fileSystem.exists(basePath)) {
-				const file = fileSystem.readFileAsBuffer(basePath) as BodyInit;
-				return new Response(file, {
-					headers: { 'Content-Type': contentType },
-				});
-			}
-
-			const htmlCandidates = [`${basePath}.html`, `${basePath}/index.html`];
-
-			for (const candidate of htmlCandidates) {
-				if (fileSystem.exists(candidate)) {
-					const file = fileSystem.readFileAsBuffer(candidate) as BodyInit;
-					return new Response(file, {
-						headers: {
-							'Content-Type': ServerUtils.getContentType(extname(candidate)),
-						},
-					});
-				}
-			}
-
-			return this.sendNotFoundPage();
-		} catch {
-			return this.sendNotFoundPage();
-		}
-	}
-
-	async fetch(request: Request) {
-		let reqPath = new URL(request.url).pathname;
-
-		if (reqPath === '/') reqPath = '/index.html';
-
-		const response = this.serveFromDir({
-			path: reqPath,
-			request,
-		});
-
-		if (response) return response;
-
-		return new Response(STATUS_MESSAGE[404], {
-			status: 404,
-		});
-	}
-
-	private startServer() {
-		this.server = getRequiredBunRuntime().serve({
-			fetch: this.fetch.bind(this),
-			port: this.options.port,
-		});
-	}
-
-	stop() {
-		if (this.server) {
-			this.server.stop(true);
-		}
-	}
-
-	static createServer({
-		appConfig,
-		options,
-	}: {
-		appConfig: EcoPagesAppConfig;
-		options?: StaticContentServerOptions;
-	}) {
-		return new StaticContentServer({
-			appConfig: appConfig,
-			options,
-		});
-	}
-}

package/src/eco/component-render-context.ts

@@ -1,202 +0,0 @@
-import type { EcoComponent } from '../public-types.ts';
-import type { MarkerNodeId } from '../route-renderer/component-marker.ts';
-
-/**
- * Outcome returned by boundary policy during one component render pass.
- *
- * - `inline`: render the target component immediately in the current pass
- * - `defer`: emit an `eco-marker` and resolve it during the marker graph phase
- */
-export type BoundaryRenderMode = 'inline' | 'defer';
-
-/**
- * Input provided to boundary policy when a component boundary is reached.
- *
- * This keeps `eco.component()` decoupled from concrete integration/plugin
- * objects while still giving policy enough information to decide whether the
- * boundary should render immediately or be deferred.
- */
-export type BoundaryRenderDecisionInput = {
-	currentIntegration: string;
-	targetIntegration?: string;
-	component: EcoComponent;
-};
-
-/**
- * Narrow render-pass facade used by `eco.component()` for boundary decisions.
- *
- * The boundary context is intentionally small so component rendering can remain
- * unaware of integration registries, plugin instances, or renderer lifecycles.
- */
-export type ComponentRenderBoundaryContext = {
-	/**
-	 * Decides whether the next component boundary should render inline or defer to
-	 * the marker graph stage.
-	 *
-	 * @param input Boundary metadata for the current render pass.
-	 * @returns Boundary rendering mode for the target component.
-	 */
-	decideBoundaryRender(input: BoundaryRenderDecisionInput): BoundaryRenderMode;
-};
-
-/**
- * Per-render mutable state used while collecting marker graph references.
- *
- * Counters generate deterministic ids within one render execution.
- */
-type ComponentRenderContext = {
-	currentIntegration: string;
-	boundaryContext: ComponentRenderBoundaryContext;
-	nextNodeId: number;
-	nextPropsRefId: number;
-	nextSlotRefId: number;
-	propsByRef: Record<string, Record<string, unknown>>;
-	slotChildrenByRef: Record<string, MarkerNodeId[]>;
-};
-
-/**
- * Serializable graph context captured from one render execution.
- *
- * This payload is merged with explicit page-module graph context before marker
- * resolution in the route renderer.
- */
-export type ComponentGraphContext = {
-	propsByRef: Record<string, Record<string, unknown>>;
-	slotChildrenByRef: Record<string, MarkerNodeId[]>;
-};
-
-type ContextStorage = {
-	getStore(): ComponentRenderContext | undefined;
-	run<T>(store: ComponentRenderContext, callback: () => Promise<T>): Promise<T>;
-};
-
-const contextStack: ComponentRenderContext[] = [];
-let nodeContextStorage: ContextStorage | null = null;
-let nodeContextStorageLoader: Promise<ContextStorage | null> | null = null;
-
-/**
- * Lazily initializes async context storage for Node runtimes.
- *
- * Falls back to in-memory stack mode when async_hooks is unavailable.
- *
- * @returns Async context storage when available; otherwise `null`.
- */
-async function getContextStorage(): Promise<ContextStorage | null> {
-	if (nodeContextStorage) {
-		return nodeContextStorage;
-	}
-
-	if (nodeContextStorageLoader) {
-		return nodeContextStorageLoader;
-	}
-
-	nodeContextStorageLoader = import('node:async_hooks')
-		.then((module) => {
-			const storage = new module.AsyncLocalStorage<ComponentRenderContext>();
-			nodeContextStorage = {
-				getStore: () => storage.getStore(),
-				run: (store, callback) => storage.run(store, callback),
-			};
-			return nodeContextStorage;
-		})
-		.catch(() => {
-			nodeContextStorage = null;
-			return null;
-		})
-		.finally(() => {
-			nodeContextStorageLoader = null;
-		});
-
-	return nodeContextStorageLoader;
-}
-
-/**
- * Returns the current component render context, if one is active.
- *
- * @returns Active render context or `undefined` outside render execution.
- */
-export function getComponentRenderContext(): ComponentRenderContext | undefined {
-	return nodeContextStorage?.getStore() ?? contextStack[contextStack.length - 1];
-}
-
-/**
- * Allocates the next marker node id in the active render context.
- *
- * @param context Active render context.
- * @returns Stable marker node id for this render pass.
- */
-export function createNodeId(context: ComponentRenderContext): MarkerNodeId {
-	context.nextNodeId += 1;
-	return `n_${context.nextNodeId}`;
-}
-
-/**
- * Allocates the next props reference id in the active render context.
- *
- * @param context Active render context.
- * @returns Props reference key.
- */
-export function createPropsRef(context: ComponentRenderContext): string {
-	context.nextPropsRefId += 1;
-	return `p_${context.nextPropsRefId}`;
-}
-
-/**
- * Allocates the next slot reference id in the active render context.
- *
- * @param context Active render context.
- * @returns Slot reference key.
- */
-export function createSlotRef(context: ComponentRenderContext): string {
-	context.nextSlotRefId += 1;
-	return `s_${context.nextSlotRefId}`;
-}
-
-/**
- * Runs render work under a fresh component render context and returns both:
- * - the render result value
- * - captured graph reference maps for downstream marker resolution
- *
- * @param input Execution metadata for current integration and boundary policy.
- * @param render Async render function to execute inside the context.
- * @returns Render result and captured graph context maps.
- */
-export async function runWithComponentRenderContext<T>(
-	input: {
-		currentIntegration: string;
-		boundaryContext: ComponentRenderBoundaryContext;
-	},
-	render: () => Promise<T>,
-): Promise<{ value: T; graphContext: ComponentGraphContext }> {
-	const context: ComponentRenderContext = {
-		currentIntegration: input.currentIntegration,
-		boundaryContext: input.boundaryContext,
-		nextNodeId: 0,
-		nextPropsRefId: 0,
-		nextSlotRefId: 0,
-		propsByRef: {},
-		slotChildrenByRef: {},
-	};
-
-	const storage = await getContextStorage();
-
-	let value: T;
-	if (storage) {
-		value = await storage.run(context, render);
-	} else {
-		contextStack.push(context);
-		try {
-			value = await render();
-		} finally {
-			contextStack.pop();
-		}
-	}
-
-	return {
-		value,
-		graphContext: {
-			propsByRef: context.propsByRef,
-			slotChildrenByRef: context.slotChildrenByRef,
-		},
-	};
-}

package/src/eco/eco.ts

@@ -1,221 +0,0 @@
-/**
- * The eco namespace - unified component and page factory API
- * @module
- */
-
-import type {
-	EcoComponent,
-	EcoPagesElement,
-	EcoPageComponent,
-	GetMetadata,
-	GetStaticPaths,
-	GetStaticProps,
-	Middleware,
-	RequestLocals,
-	RequestPageContext,
-} from '../public-types.ts';
-import type { CacheStrategy } from '../services/cache/cache.types.ts';
-import type {
-	ComponentOptions,
-	Eco,
-	PageOptions,
-	PageOptionsBase,
-	PagePropsFor,
-	PagePropsForWithLocals,
-	PageRequires,
-} from './eco.types.ts';
-import { createNodeId, createPropsRef, createSlotRef, getComponentRenderContext } from './component-render-context.ts';
-import { createComponentMarker, parseComponentMarkers } from '../route-renderer/component-marker.ts';
-import { addTriggerAttribute, isThenable, wrapWithScriptsInjector } from './eco.utils.ts';
-
-/**
- * Creates a component factory with lazy-trigger support and deferred-boundary
- * marker emission.
- *
- * Behavior:
- * - In normal render flow, returns `options.render(props)` with optional lazy
- *   trigger/script wrapping.
- * - When rendering under component graph context and the active boundary policy
- *   decides the target boundary should defer, emits an `eco-marker` token
- *   instead of rendering the component immediately.
- *
- * @param options Component options for rendering and dependency declaration.
- * @returns Configured eco component.
- */
-function createComponentFactory<P, E>(options: ComponentOptions<P, E>): EcoComponent<P, E> {
-	const integrationName = options.integration ?? options.__eco?.integration;
-	const comp: EcoComponent<P, E> = ((props: P) => {
-		const renderContext = getComponentRenderContext();
-		const shouldEmitMarker =
-			renderContext !== undefined &&
-			renderContext.boundaryContext.decideBoundaryRender({
-				currentIntegration: renderContext.currentIntegration,
-				targetIntegration: integrationName,
-				component: comp,
-			}) === 'defer';
-
-		if (shouldEmitMarker && renderContext) {
-			const nodeId = createNodeId(renderContext);
-			const propsRef = createPropsRef(renderContext);
-			const componentRef = comp.config?.__eco?.id ?? comp.config?.__eco?.file;
-
-			if (!componentRef) {
-				throw new Error(
-					'[ecopages] Missing component reference metadata for cross-integration marker emission.',
-				);
-			}
-
-			const componentProps = (props ?? {}) as Record<string, unknown>;
-			renderContext.propsByRef[propsRef] = componentProps;
-
-			let slotRef: string | undefined;
-			const children = componentProps.children;
-			if (typeof children === 'string' && children.includes('<eco-marker')) {
-				const childMarkers = parseComponentMarkers(children);
-				if (childMarkers.length > 0) {
-					slotRef = createSlotRef(renderContext);
-					renderContext.slotChildrenByRef[slotRef] = childMarkers.map((marker) => marker.nodeId);
-				}
-			}
-
-			return createComponentMarker({
-				nodeId,
-				integration: integrationName as string,
-				componentRef,
-				propsRef,
-				slotRef,
-			}) as E;
-		}
-
-		const content = options.render(props);
-
-		const lazyTriggers = comp.config?._resolvedLazyTriggers;
-		if (lazyTriggers && lazyTriggers.length > 0) {
-			const triggerId = lazyTriggers[0].triggerId;
-			if (isThenable(content)) {
-				return content.then((resolvedContent) => addTriggerAttribute(resolvedContent, triggerId));
-			}
-			return addTriggerAttribute(content, triggerId);
-		}
-
-		const lazyGroups = comp.config?._resolvedLazyScripts;
-
-		if (lazyGroups && lazyGroups.length > 0) {
-			if (isThenable(content)) {
-				return content.then((resolvedContent) => wrapWithScriptsInjector(resolvedContent, lazyGroups));
-			}
-			return wrapWithScriptsInjector(content, lazyGroups);
-		}
-
-		return content;
-	}) as EcoComponent<P, E>;
-
-	comp.config = {
-		__eco: options.__eco,
-		integration: options.integration,
-		dependencies: options.dependencies,
-	};
-
-	return comp;
-}
-
-/**
- * Creates a reusable component with optional dependencies.
- *
- * @param options Component definition options.
- * @returns Eco component function.
- */
-function component<P = {}, E = EcoPagesElement>(options: ComponentOptions<P, E>): EcoComponent<P, E> {
-	return createComponentFactory(options);
-}
-
-/**
- * Creates a page component with typed props and optional static helpers.
- */
-function page<T = {}, E = EcoPagesElement>(options: PageOptions<T, E> & { requires?: undefined }): EcoPageComponent<T>;
-function page<T = {}, E = EcoPagesElement, const K extends keyof RequestLocals = keyof RequestLocals>(
-	options: Omit<PageOptions<T, E>, 'render' | 'requires'> & {
-		requires: PageRequires<K>;
-		render: (props: PagePropsForWithLocals<T, K>) => E | Promise<E>;
-	},
-): EcoPageComponent<T>;
-
-/**
- * Creates a page component and attaches optional static APIs.
- *
- * @param options Page options.
- * @returns Eco page component.
- */
-function page<T, E>(
-	options: PageOptionsBase<T, E> & { cache?: CacheStrategy; middleware?: Middleware[] },
-): EcoPageComponent<T> {
-	const { layout, dependencies, render, staticPaths, staticProps, metadata, cache, requires, middleware } = options;
-
-	const componentOptions: ComponentOptions<PagePropsFor<T> & Partial<RequestPageContext>, E> = {
-		__eco: options.__eco,
-		integration: options.integration,
-		dependencies: layout
-			? {
-					...dependencies,
-					components: [...(dependencies?.components || []), layout],
-				}
-			: dependencies,
-		render,
-	};
-
-	const pageComponent = createComponentFactory(componentOptions) as EcoPageComponent<T>;
-
-	if (layout && pageComponent.config) {
-		pageComponent.config.layout = layout;
-	}
-
-	if (staticPaths) pageComponent.staticPaths = staticPaths;
-	if (staticProps) pageComponent.staticProps = staticProps;
-	if (metadata) pageComponent.metadata = metadata;
-	if (cache) pageComponent.cache = cache;
-	if (requires) pageComponent.requires = requires;
-	if (middleware) pageComponent.middleware = middleware;
-
-	return pageComponent;
-}
-
-/**
- * Type-safe wrapper for metadata functions.
- *
- * @param fn Metadata factory function.
- * @returns The same function.
- */
-function metadata<P = {}>(fn: GetMetadata<P>): GetMetadata<P> {
-	return fn;
-}
-
-/**
- * Type-safe wrapper for static paths functions.
- *
- * @param fn Static paths function.
- * @returns The same function.
- */
-function staticPaths(fn: GetStaticPaths): GetStaticPaths {
-	return fn;
-}
-
-/**
- * Type-safe wrapper for static props functions.
- *
- * @param fn Static props function.
- * @returns The same function.
- */
-function staticProps<P>(fn: GetStaticProps<P>): GetStaticProps<P> {
-	return fn;
-}
-
-/**
- * The eco namespace - provides factories for components and pages
- */
-export const eco: Eco = {
-	component,
-	page,
-	metadata,
-	staticPaths,
-	staticProps,
-};