@buenojs/bueno 0.8.3 → 0.8.5

package/src/frontend/islands.ts

@@ -8,16 +8,16 @@
  * - State serialization for islands
  */
 
-import { createLogger, type Logger } from "../logger/index.js";
+import { type Logger, createLogger } from "../logger/index.js";
 import type {
+	FrontendFramework,
 	IslandConfig,
 	IslandDefinition,
+	IslandHydrationScript,
 	IslandHydrationStrategy,
 	IslandRegistry,
 	IslandRenderResult,
 	IslandState,
-	IslandHydrationScript,
-	FrontendFramework,
 	SSRElement,
 } from "./types.js";
 
@@ -74,7 +74,7 @@ export class IslandManager {
 	 * Register multiple islands
 	 */
 	registerAll(definitions: IslandDefinition[]): string[] {
-		return definitions.map(def => this.register(def));
+		return definitions.map((def) => this.register(def));
 	}
 
 	/**
@@ -104,7 +104,7 @@ export class IslandManager {
 	renderIsland(
 		componentName: string,
 		props: Record<string, unknown> = {},
-		options: Partial<IslandConfig> = {}
+		options: Partial<IslandConfig> = {},
 	): IslandRenderResult {
 		const id = options.id || `island-${++this.islandCounter}`;
 		const strategy = options.strategy || "lazy";
@@ -139,7 +139,8 @@ export class IslandManager {
 			.join(" ");
 
 		// Generate placeholder or SSR content
-		const placeholder = options.placeholder || this.generatePlaceholder(componentName, props);
+		const placeholder =
+			options.placeholder || this.generatePlaceholder(componentName, props);
 
 		const html = `<div ${attrString}>${placeholder}</div>`;
 
@@ -160,7 +161,7 @@ export class IslandManager {
 		componentName: string,
 		ssrContent: string,
 		props: Record<string, unknown> = {},
-		options: Partial<IslandConfig> = {}
+		options: Partial<IslandConfig> = {},
 	): IslandRenderResult {
 		const id = options.id || `island-${++this.islandCounter}`;
 		const strategy = options.strategy || "lazy";
@@ -196,7 +197,9 @@ export class IslandManager {
 	/**
 	 * Find island by component name
 	 */
-	private findIslandByComponent(componentName: string): IslandDefinition | undefined {
+	private findIslandByComponent(
+		componentName: string,
+	): IslandDefinition | undefined {
 		for (const island of this.registry.values()) {
 			if (island.component === componentName) {
 				return island;
@@ -210,7 +213,7 @@ export class IslandManager {
 	 */
 	private generatePlaceholder(
 		componentName: string,
-		props: Record<string, unknown>
+		props: Record<string, unknown>,
 	): string {
 		// Generate a simple placeholder based on component type
 		if (props.children && typeof props.children === "string") {
@@ -229,7 +232,7 @@ export class IslandManager {
 			.replace(/&/g, "&")
 			.replace(/</g, "<")
 			.replace(/>/g, ">")
-			.replace(/"/g, "\"")
+			.replace(/"/g, '"')
 			.replace(/'/g, "'");
 	}
 
@@ -240,7 +243,7 @@ export class IslandManager {
 		const islands = this.getAllIslands();
 		const framework = this.framework;
 
-		const islandData = islands.map(island => ({
+		const islandData = islands.map((island) => ({
 			id: island.id,
 			component: island.component,
 			entry: island.entry,
@@ -417,7 +420,9 @@ hydrator.init();
 /**
  * Create an island manager
  */
-export function createIslandManager(framework: FrontendFramework): IslandManager {
+export function createIslandManager(
+	framework: FrontendFramework,
+): IslandManager {
 	return new IslandManager(framework);
 }
 
@@ -429,7 +434,7 @@ export function createIslandManager(framework: FrontendFramework): IslandManager
 export function defineIsland(
 	component: string,
 	entry: string,
-	options: Partial<IslandDefinition> = {}
+	options: Partial<IslandDefinition> = {},
 ): IslandDefinition {
 	return {
 		id: options.id || `island-${component}`,
@@ -467,7 +472,9 @@ export function getIslandData(element: ElementLike): IslandState | null {
 		id: element.getAttribute(ISLAND_ID) || "",
 		component: element.getAttribute(ISLAND_COMPONENT) || "",
 		props: JSON.parse(element.getAttribute(ISLAND_PROPS) || "{}"),
-		strategy: (element.getAttribute(ISLAND_STRATEGY) as IslandHydrationStrategy) || "lazy",
+		strategy:
+			(element.getAttribute(ISLAND_STRATEGY) as IslandHydrationStrategy) ||
+			"lazy",
 		hydrated: false,
 	};
 }
@@ -479,7 +486,7 @@ export function getIslandAttributes(
 	id: string,
 	component: string,
 	props: Record<string, unknown>,
-	strategy: IslandHydrationStrategy = "lazy"
+	strategy: IslandHydrationStrategy = "lazy",
 ): Record<string, string> {
 	return {
 		[ISLAND_MARKER]: "true",
@@ -498,7 +505,7 @@ export function createIslandElement(
 	component: string,
 	props: Record<string, unknown>,
 	strategy: IslandHydrationStrategy = "lazy",
-	children?: SSRElement[]
+	children?: SSRElement[],
 ): SSRElement {
 	return {
 		tag: "div",
@@ -512,14 +519,21 @@ export function createIslandElement(
  */
 export function parseIslandsFromHTML(html: string): IslandState[] {
 	const islands: IslandState[] = [];
-	const regex = /data-island-id="([^"]+)"[^>]*data-island-component="([^"]+)"[^>]*data-island-props="([^"]+)"[^>]*data-island-strategy="([^"]+)"/g;
+	const regex =
+		/data-island-id="([^"]+)"[^>]*data-island-component="([^"]+)"[^>]*data-island-props="([^"]+)"[^>]*data-island-strategy="([^"]+)"/g;
 
 	let match;
 	while ((match = regex.exec(html)) !== null) {
 		islands.push({
 			id: match[1],
 			component: match[2],
-			props: JSON.parse(match[3].replace(/"/g, '"').replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>')),
+			props: JSON.parse(
+				match[3]
+					.replace(/"/g, '"')
+					.replace(/&/g, "&")
+					.replace(/</g, "<")
+					.replace(/>/g, ">"),
+			),
 			strategy: match[4] as IslandHydrationStrategy,
 			hydrated: false,
 		});
@@ -531,7 +545,9 @@ export function parseIslandsFromHTML(html: string): IslandState[] {
 /**
  * Get hydration priority
  */
-export function getHydrationPriority(strategy: IslandHydrationStrategy): number {
+export function getHydrationPriority(
+	strategy: IslandHydrationStrategy,
+): number {
 	const priorities: Record<IslandHydrationStrategy, number> = {
 		eager: 1,
 		visible: 2,
@@ -545,8 +561,11 @@ export function getHydrationPriority(strategy: IslandHydrationStrategy): number
 /**
  * Sort islands by hydration priority
  */
-export function sortIslandsByPriority(islands: IslandDefinition[]): IslandDefinition[] {
+export function sortIslandsByPriority(
+	islands: IslandDefinition[],
+): IslandDefinition[] {
 	return [...islands].sort(
-		(a, b) => getHydrationPriority(a.strategy) - getHydrationPriority(b.strategy)
+		(a, b) =>
+			getHydrationPriority(a.strategy) - getHydrationPriority(b.strategy),
 	);
-}
+}

package/src/frontend/isr.ts

@@ -8,18 +8,18 @@
  * - Distributed cache support via Bun.redis
  */
 
-import { createLogger, type Logger } from "../logger/index.js";
+import { type Logger, createLogger } from "../logger/index.js";
+import { type SSRRenderer, createSSRContext } from "./ssr.js";
 import type {
-	ISRConfig,
-	PartialISRConfig,
 	ISRCacheEntry,
+	ISRConfig,
 	ISRPageConfig,
 	ISRRevalidationResult,
 	ISRStats,
+	PartialISRConfig,
 	SSRRenderOptions,
 } from "./types.js";
-import { SSRRenderer, createSSRContext } from "./ssr.js";
-import type { SSRContext, RenderResult } from "./types.js";
+import type { RenderResult, SSRContext } from "./types.js";
 
 // ============= Constants =============
 
@@ -31,7 +31,7 @@ const DEFAULT_STALE_WHILE_REVALIDATE = 60; // 1 minute
 
 /**
  * ISR Manager handles incremental static regeneration
- * 
+ *
  * Features:
  * - Time-based revalidation with configurable TTL
  * - Stale-while-revalidate for instant responses
@@ -42,7 +42,8 @@ export class ISRManager {
 	private config: ISRConfig;
 	private logger: Logger;
 	private cache: Map<string, ISRCacheEntry> = new Map();
-	private pendingRegenerations: Map<string, Promise<ISRRevalidationResult>> = new Map();
+	private pendingRegenerations: Map<string, Promise<ISRRevalidationResult>> =
+		new Map();
 	private ssrRenderer: SSRRenderer | null = null;
 	private stats = {
 		hits: 0,
@@ -67,7 +68,8 @@ export class ISRManager {
 		return {
 			cacheDir: config.cacheDir ?? DEFAULT_CACHE_DIR,
 			defaultRevalidate: config.defaultRevalidate ?? DEFAULT_REVALIDATE,
-			staleWhileRevalidate: config.staleWhileRevalidate ?? DEFAULT_STALE_WHILE_REVALIDATE,
+			staleWhileRevalidate:
+				config.staleWhileRevalidate ?? DEFAULT_STALE_WHILE_REVALIDATE,
 			maxCacheSize: config.maxCacheSize ?? 1000,
 			redis: config.redis,
 			redisKeyPrefix: config.redisKeyPrefix ?? "bueno:isr:",
@@ -88,7 +90,7 @@ export class ISRManager {
 	async getPage(
 		url: string,
 		request: Request,
-		pageConfig?: ISRPageConfig
+		pageConfig?: ISRPageConfig,
 	): Promise<RenderResult> {
 		if (!this.config.enabled) {
 			return this.renderPage(url, request);
@@ -100,8 +102,10 @@ export class ISRManager {
 		if (entry) {
 			const now = Date.now();
 			const age = (now - entry.timestamp) / 1000;
-			const revalidate = pageConfig?.revalidate ?? this.config.defaultRevalidate;
-			const staleWhileRevalidate = pageConfig?.staleWhileRevalidate ?? this.config.staleWhileRevalidate;
+			const revalidate =
+				pageConfig?.revalidate ?? this.config.defaultRevalidate;
+			const staleWhileRevalidate =
+				pageConfig?.staleWhileRevalidate ?? this.config.staleWhileRevalidate;
 
 			// Cache hit - check if stale
 			if (age < revalidate) {
@@ -114,7 +118,9 @@ export class ISRManager {
 			// Stale but within stale-while-revalidate window
 			if (age < revalidate + staleWhileRevalidate) {
 				this.stats.staleHits++;
-				this.logger.debug(`Cache hit (stale): ${url}, revalidating in background`);
+				this.logger.debug(
+					`Cache hit (stale): ${url}, revalidating in background`,
+				);
 
 				// Trigger background revalidation
 				this.triggerBackgroundRevalidation(url, request, pageConfig);
@@ -137,7 +143,10 @@ export class ISRManager {
 	/**
 	 * Render a page using SSR
 	 */
-	private async renderPage(url: string, request: Request): Promise<RenderResult> {
+	private async renderPage(
+		url: string,
+		request: Request,
+	): Promise<RenderResult> {
 		if (!this.ssrRenderer) {
 			throw new Error("SSR renderer not configured");
 		}
@@ -159,7 +168,7 @@ export class ISRManager {
 	private triggerBackgroundRevalidation(
 		url: string,
 		request: Request,
-		pageConfig?: ISRPageConfig
+		pageConfig?: ISRPageConfig,
 	): void {
 		const cacheKey = this.getCacheKey(url);
 
@@ -168,10 +177,11 @@ export class ISRManager {
 			return;
 		}
 
-		const promise = this.revalidatePage(url, request, pageConfig)
-			.finally(() => {
+		const promise = this.revalidatePage(url, request, pageConfig).finally(
+			() => {
 				this.pendingRegenerations.delete(cacheKey);
-			});
+			},
+		);
 
 		this.pendingRegenerations.set(cacheKey, promise);
 	}
@@ -182,7 +192,7 @@ export class ISRManager {
 	async revalidatePage(
 		url: string,
 		request: Request,
-		pageConfig?: ISRPageConfig
+		pageConfig?: ISRPageConfig,
 	): Promise<ISRRevalidationResult> {
 		const cacheKey = this.getCacheKey(url);
 		const startTime = Date.now();
@@ -205,7 +215,8 @@ export class ISRManager {
 			};
 		} catch (error) {
 			const duration = Date.now() - startTime;
-			const errorMessage = error instanceof Error ? error.message : "Unknown error";
+			const errorMessage =
+				error instanceof Error ? error.message : "Unknown error";
 			this.logger.error(`Revalidation failed: ${url}`, error);
 
 			return {
@@ -258,7 +269,9 @@ export class ISRManager {
 		// Invalidate Redis cache if available
 		if (this.config.redis) {
 			try {
-				const keys = await this.config.redis.keys(`${this.config.redisKeyPrefix}*`);
+				const keys = await this.config.redis.keys(
+					`${this.config.redisKeyPrefix}*`,
+				);
 				for (const key of keys) {
 					const cacheKey = key.replace(this.config.redisKeyPrefix, "");
 					if (regex.test(cacheKey)) {
@@ -284,7 +297,9 @@ export class ISRManager {
 
 		if (this.config.redis) {
 			try {
-				const keys = await this.config.redis.keys(`${this.config.redisKeyPrefix}*`);
+				const keys = await this.config.redis.keys(
+					`${this.config.redisKeyPrefix}*`,
+				);
 				if (keys.length > 0) {
 					await this.config.redis.del(...keys);
 				}
@@ -309,7 +324,9 @@ export class ISRManager {
 		// Check Redis if available
 		if (this.config.redis) {
 			try {
-				const data = await this.config.redis.get(`${this.config.redisKeyPrefix}${key}`);
+				const data = await this.config.redis.get(
+					`${this.config.redisKeyPrefix}${key}`,
+				);
 				if (data) {
 					const entry = JSON.parse(data) as ISRCacheEntry;
 					// Cache locally for faster access
@@ -330,7 +347,7 @@ export class ISRManager {
 	private async setCacheEntry(
 		key: string,
 		result: RenderResult,
-		pageConfig?: ISRPageConfig
+		pageConfig?: ISRPageConfig,
 	): Promise<void> {
 		const entry: ISRCacheEntry = {
 			result,
@@ -354,7 +371,7 @@ export class ISRManager {
 				await this.config.redis.set(
 					`${this.config.redisKeyPrefix}${key}`,
 					JSON.stringify(entry),
-					{ EX: ttl }
+					{ EX: ttl },
 				);
 			} catch (error) {
 				this.logger.error("Failed to set Redis cache entry", error);
@@ -366,10 +383,14 @@ export class ISRManager {
 	 * Evict oldest entries when cache is full
 	 */
 	private evictOldestEntries(): void {
-		const entries = Array.from(this.cache.entries())
-			.sort((a, b) => a[1].timestamp - b[1].timestamp);
-
-		const toEvict = entries.slice(0, Math.floor(this.config.maxCacheSize * 0.1));
+		const entries = Array.from(this.cache.entries()).sort(
+			(a, b) => a[1].timestamp - b[1].timestamp,
+		);
+
+		const toEvict = entries.slice(
+			0,
+			Math.floor(this.config.maxCacheSize * 0.1),
+		);
 		for (const [key] of toEvict) {
 			this.cache.delete(key);
 		}
@@ -398,9 +419,10 @@ export class ISRManager {
 			...this.stats,
 			cacheSize: this.cache.size,
 			pendingRevalidations: this.pendingRegenerations.size,
-			hitRate: this.stats.hits + this.stats.misses > 0
-				? this.stats.hits / (this.stats.hits + this.stats.misses)
-				: 0,
+			hitRate:
+				this.stats.hits + this.stats.misses > 0
+					? this.stats.hits / (this.stats.hits + this.stats.misses)
+					: 0,
 		};
 	}
 
@@ -517,15 +539,15 @@ export function parseRevalidateHeader(header: string): {
 	revalidate: number;
 	staleWhileRevalidate: number;
 } {
-	const parts = header.split(",").map(p => p.trim());
+	const parts = header.split(",").map((p) => p.trim());
 	let revalidate = DEFAULT_REVALIDATE;
 	let staleWhileRevalidate = DEFAULT_STALE_WHILE_REVALIDATE;
 
 	for (const part of parts) {
 		if (part.includes("stale-while-revalidate=")) {
-			staleWhileRevalidate = parseInt(part.split("=")[1], 10);
+			staleWhileRevalidate = Number.parseInt(part.split("=")[1], 10);
 		} else {
-			revalidate = parseInt(part, 10);
+			revalidate = Number.parseInt(part, 10);
 		}
 	}
 
@@ -537,7 +559,7 @@ export function parseRevalidateHeader(header: string): {
  */
 export function generateCacheControlHeader(
 	revalidate: number,
-	staleWhileRevalidate: number
+	staleWhileRevalidate: number,
 ): string {
 	return `public, max-age=0, s-maxage=${revalidate}, stale-while-revalidate=${staleWhileRevalidate}`;
 }
@@ -548,8 +570,8 @@ export function generateCacheControlHeader(
 export function shouldRegenerate(
 	entry: ISRCacheEntry,
 	revalidate: number,
-	staleWhileRevalidate: number
+	staleWhileRevalidate: number,
 ): boolean {
 	const age = (Date.now() - entry.timestamp) / 1000;
 	return age > revalidate && age <= revalidate + staleWhileRevalidate;
-}
+}

package/src/frontend/layout.ts

@@ -8,20 +8,20 @@
  * - Per-segment layouts
  */
 
-import { createLogger, type Logger } from "../logger/index.js";
+import { type Logger, createLogger } from "../logger/index.js";
 import type {
+	LayoutConfig,
 	LayoutDefinition,
+	LayoutMiddleware,
 	LayoutNode,
-	LayoutTree,
 	LayoutProps,
-	LayoutRenderer,
-	LayoutMiddleware,
-	LayoutConfig,
-	PartialLayoutConfig,
 	LayoutRenderResult,
+	LayoutRenderer,
 	LayoutSegment,
+	LayoutTree,
+	PartialLayoutConfig,
 } from "./types.js";
-import type { SSRContext, SSRElement, RenderResult } from "./types.js";
+import type { RenderResult, SSRContext, SSRElement } from "./types.js";
 
 // ============= Constants =============
 
@@ -70,7 +70,9 @@ export class LayoutManager {
 	 * Initialize the layout manager by scanning for layout files
 	 */
 	async init(): Promise<void> {
-		this.logger.info(`Initializing layout manager from: ${this.config.pagesDir}`);
+		this.logger.info(
+			`Initializing layout manager from: ${this.config.pagesDir}`,
+		);
 		await this.scanLayoutFiles();
 		this.buildLayoutTree();
 		this.logger.info(`Loaded ${this.layouts.size} layouts`);
@@ -81,7 +83,9 @@ export class LayoutManager {
 	 */
 	private async scanLayoutFiles(): Promise<void> {
 		const pagesPath = this.config.pagesDir;
-		const glob = new Bun.Glob(`**/${LAYOUT_FILE}{${this.config.extensions.join(",")}}`);
+		const glob = new Bun.Glob(
+			`**/${LAYOUT_FILE}{${this.config.extensions.join(",")}}`,
+		);
 
 		try {
 			for await (const file of glob.scan(pagesPath)) {
@@ -95,7 +99,10 @@ export class LayoutManager {
 	/**
 	 * Process a single layout file
 	 */
-	private async processLayoutFile(filePath: string, basePath: string): Promise<void> {
+	private async processLayoutFile(
+		filePath: string,
+		basePath: string,
+	): Promise<void> {
 		const fullPath = `${basePath}/${filePath}`;
 		const segment = this.getLayoutSegment(filePath);
 
@@ -115,7 +122,10 @@ export class LayoutManager {
 	 */
 	private getLayoutSegment(filePath: string): string {
 		// Remove _layout.tsx from path
-		const segment = filePath.replace(new RegExp(`/${LAYOUT_FILE}\\.(tsx?|jsx?)$`), "");
+		const segment = filePath.replace(
+			new RegExp(`/${LAYOUT_FILE}\\.(tsx?|jsx?)$`),
+			"",
+		);
 		return segment === "" ? "/" : `/${segment}`;
 	}
 
@@ -153,7 +163,10 @@ export class LayoutManager {
 	/**
 	 * Build a layout tree node
 	 */
-	private buildTreeNode(layout: LayoutDefinition, parent: LayoutNode | null): LayoutNode {
+	private buildTreeNode(
+		layout: LayoutDefinition,
+		parent: LayoutNode | null,
+	): LayoutNode {
 		const node: LayoutNode = {
 			layout,
 			parent,
@@ -224,7 +237,9 @@ export class LayoutManager {
 	/**
 	 * Load layout module
 	 */
-	private async loadLayoutModule(filePath: string): Promise<LayoutRenderer | null> {
+	private async loadLayoutModule(
+		filePath: string,
+	): Promise<LayoutRenderer | null> {
 		try {
 			const module = await import(filePath);
 			return module.default || module;
@@ -240,7 +255,7 @@ export class LayoutManager {
 	async renderLayouts(
 		routePath: string,
 		content: string,
-		context: SSRContext
+		context: SSRContext,
 	): Promise<LayoutRenderResult> {
 		const chain = this.getLayoutChain(routePath);
 
@@ -361,7 +376,9 @@ export class LayoutManager {
 /**
  * Create a layout manager
  */
-export function createLayoutManager(config: PartialLayoutConfig = {}): LayoutManager {
+export function createLayoutManager(
+	config: PartialLayoutConfig = {},
+): LayoutManager {
 	return new LayoutManager(config);
 }
 
@@ -394,7 +411,7 @@ export function getLayoutSegmentFromPath(filePath: string): string {
  */
 export function buildLayoutProps(
 	children: string,
-	context: SSRContext
+	context: SSRContext,
 ): LayoutProps {
 	return {
 		children,
@@ -409,7 +426,7 @@ export function buildLayoutProps(
  */
 export function createLayoutSegment(
 	path: string,
-	params: Record<string, string> = {}
+	params: Record<string, string> = {},
 ): LayoutSegment {
 	return {
 		path,
@@ -421,9 +438,7 @@ export function createLayoutSegment(
 /**
  * Merge layout head elements
  */
-export function mergeLayoutHead(
-	...heads: SSRElement[][]
-): SSRElement[] {
+export function mergeLayoutHead(...heads: SSRElement[][]): SSRElement[] {
 	const merged: SSRElement[] = [];
 	const seen = new Set<string>();
 
@@ -472,4 +487,4 @@ export function layoutTreeToString(node: LayoutNode, indent = 0): string {
 	}
 
 	return result;
-}
+}