@ecopages/core 0.2.0-alpha.25 → 0.2.0-alpha.27

package/src/router/server/fs-router.test.ts

@@ -1,214 +0,0 @@
-import { describe, expect, test, vi } from 'vitest';
-import { FIXTURE_APP_PROJECT_DIR } from '../../../__fixtures__/constants.js';
-import { ConfigBuilder } from '../../config/config-builder.js';
-import type { Route, Routes } from '../../types/internal-types.js';
-import { FSRouter } from './fs-router.ts';
-import { FSRouterScanner } from './fs-router-scanner.ts';
-
-const {
-	templatesExt,
-	absolutePaths: { pagesDir, distDir },
-} = await new ConfigBuilder().setRootDir(FIXTURE_APP_PROJECT_DIR).build();
-
-const scanner = new FSRouterScanner({
-	dir: pagesDir,
-	appConfig: {
-		absolutePaths: {
-			distDir,
-		},
-	} as any,
-	origin: 'http://localhost:3000',
-	templatesExt,
-	options: {
-		buildMode: false,
-	},
-});
-
-const router = new FSRouter({
-	origin: 'http://localhost:3000',
-	assetPrefix: distDir,
-	scanner,
-});
-
-await router.init();
-
-describe('FSRouter', async () => {
-	describe('init', async () => {
-		test('should scan and return routes', async () => {
-			expect(Object.keys(router.routes).sort()).toEqual([
-				'http://localhost:3000/',
-				'http://localhost:3000/404',
-				'http://localhost:3000/catch-all/[...path]',
-				'http://localhost:3000/dynamic/another-blog-post',
-				'http://localhost:3000/dynamic/blog-post',
-				'http://localhost:3000/postcss-hmr',
-			]);
-		});
-	});
-
-	describe('getDynamicParams', async () => {
-		test.each([
-			['/products/[id]', '/products/123', { id: '123' }],
-			['/products/[id]', '/products/123/456', { id: '123' }],
-			['/products/[id]', '/products/123/456/789', { id: '123' }],
-		])(
-			'dynamic route %p with URL %p should have dynamic params %p',
-			async (dynamicPathname, pathname, expected) => {
-				const route: Route = {
-					filePath: '',
-					kind: 'dynamic',
-					pathname: dynamicPathname,
-				};
-				const params = router.getDynamicParams(route, pathname);
-
-				expect(params).toEqual(expected);
-			},
-		);
-
-		test.each([
-			['/products/[...id]', '/products/123/456/789', { id: ['123', '456', '789'] }],
-			['/products/[...id]', '/products/123', { id: ['123'] }],
-			['/products/[...id]', '/products', { id: [] }],
-		])(
-			'catch-all route %p with URL %p should have dynamic params %p',
-			async (catchAllRoute, pathname, expected) => {
-				const route: Route = {
-					filePath: '',
-					kind: 'dynamic',
-					pathname: catchAllRoute,
-				};
-				const params = router.getDynamicParams(route, pathname);
-
-				expect(params).toEqual(expected);
-			},
-		);
-	});
-
-	describe('getSearchParams', () => {
-		test('should extract query parameters from URL', () => {
-			const url = new URL('http://localhost:3000/page?foo=bar&baz=qux');
-			const params = router.getSearchParams(url);
-
-			expect(params).toEqual({ foo: 'bar', baz: 'qux' });
-		});
-
-		test('should return empty object for URL without query params', () => {
-			const url = new URL('http://localhost:3000/page');
-			const params = router.getSearchParams(url);
-
-			expect(params).toEqual({});
-		});
-	});
-
-	describe('match', () => {
-		const createRouterWithRoutes = (routes: Routes) => {
-			const Scanner = { scan: async () => routes } as unknown as FSRouterScanner;
-			const testRouter = new FSRouter({
-				origin: 'http://localhost:3000',
-				assetPrefix: '/dist',
-				scanner: Scanner,
-			});
-			testRouter.routes = routes;
-			return testRouter;
-		};
-
-		test('should match exact route', () => {
-			const testRouter = createRouterWithRoutes({
-				'/about': { filePath: '/pages/about.ts', kind: 'exact', pathname: '/about' },
-			});
-
-			const result = testRouter.match('http://localhost:3000/about');
-
-			expect(result).not.toBeNull();
-			expect(result?.kind).toBe('exact');
-			expect(result?.pathname).toBe('/about');
-		});
-
-		test('should match exact route with trailing slash', () => {
-			const testRouter = createRouterWithRoutes({
-				'/about': { filePath: '/pages/about.ts', kind: 'exact', pathname: '/about' },
-			});
-
-			const result = testRouter.match('http://localhost:3000/about/');
-
-			expect(result).not.toBeNull();
-			expect(result?.kind).toBe('exact');
-		});
-
-		test('should match dynamic route', () => {
-			const testRouter = createRouterWithRoutes({
-				'/dynamic/[id]': { filePath: '/pages/dynamic/[id].ts', kind: 'dynamic', pathname: '/dynamic/[id]' },
-			});
-
-			const result = testRouter.match('http://localhost:3000/dynamic/123');
-
-			expect(result).not.toBeNull();
-			expect(result?.kind).toBe('dynamic');
-			expect(result?.params).toEqual({ id: '123' });
-		});
-
-		test('should match catch-all route', () => {
-			const testRouter = createRouterWithRoutes({
-				'/catch-all/[...slug]': {
-					filePath: '/pages/catch-all/[...slug].ts',
-					kind: 'catch-all',
-					pathname: '/catch-all/[...slug]',
-				},
-			});
-
-			const result = testRouter.match('http://localhost:3000/catch-all/a/b/c');
-
-			expect(result).not.toBeNull();
-			expect(result?.kind).toBe('catch-all');
-			expect(result?.params).toEqual({ slug: ['a', 'b', 'c'] });
-		});
-
-		test('should include query params in match result', () => {
-			const testRouter = createRouterWithRoutes({
-				'/page': { filePath: '/pages/page.ts', kind: 'exact', pathname: '/page' },
-			});
-
-			const result = testRouter.match('http://localhost:3000/page?sort=asc&page=2');
-
-			expect(result?.query).toEqual({ sort: 'asc', page: '2' });
-		});
-
-		test('should return null for non-matching route', () => {
-			const testRouter = createRouterWithRoutes({
-				'/about': { filePath: '/pages/about.ts', kind: 'exact', pathname: '/about' },
-			});
-
-			const result = testRouter.match('http://localhost:3000/contact');
-
-			expect(result).toBeNull();
-		});
-
-		test('should prefer exact match over dynamic', () => {
-			const testRouter = createRouterWithRoutes({
-				'/blog/latest': { filePath: '/pages/blog/latest.ts', kind: 'exact', pathname: '/blog/latest' },
-				'/blog/[slug]': { filePath: '/pages/blog/[slug].ts', kind: 'dynamic', pathname: '/blog/[slug]' },
-			});
-
-			const result = testRouter.match('http://localhost:3000/blog/latest');
-
-			expect(result?.kind).toBe('exact');
-		});
-	});
-
-	describe('setOnReload and reload', () => {
-		test('should set and call onReload callback', async () => {
-			const Scanner = { scan: async () => ({}) } as unknown as FSRouterScanner;
-			const testRouter = new FSRouter({
-				origin: 'http://localhost:3000',
-				assetPrefix: '/dist',
-				scanner: Scanner,
-			});
-
-			const callback = vi.fn(() => {});
-			testRouter.setOnReload(callback);
-			testRouter.reload();
-
-			expect(callback).toHaveBeenCalledTimes(1);
-		});
-	});
-});

package/src/router/server/fs-router.ts

@@ -1,122 +0,0 @@
-import { appLogger } from '../../global/app-logger.ts';
-import type { MatchResult, Route, Routes } from '../../types/internal-types.ts';
-import type { FSRouterScanner } from './fs-router-scanner.ts';
-
-/**
- * A class that manages the routes of the file system.
- * It scans the file system for files with the specified extensions and creates a map of routes.
- * It also provides a method to match a request to a route.
- * It can be used to reload the routes when the file system changes.
- */
-export class FSRouter {
-	origin: string;
-	assetPrefix: string;
-	routes: Routes = {};
-	scanner: FSRouterScanner;
-	onReload?: () => void;
-
-	constructor({ origin, assetPrefix, scanner }: { origin: string; assetPrefix: string; scanner: FSRouterScanner }) {
-		this.origin = origin;
-		this.assetPrefix = assetPrefix;
-		this.scanner = scanner;
-	}
-
-	async init() {
-		this.routes = await this.scanner.scan();
-		appLogger.debug('FSRouter initialized', this.routes);
-	}
-
-	getDynamicParams(route: Route, pathname: string): Record<string, string | string[]> {
-		const params: Record<string, string | string[]> = {};
-		const routeParts = route.pathname.split('/');
-		const pathnameParts = pathname.split('/');
-
-		for (let i = 0; i < routeParts.length; i++) {
-			const part = routeParts[i];
-			if (part.startsWith('[') && part.endsWith(']')) {
-				if (part.startsWith('[...')) {
-					const param = part.slice(4, -1);
-					params[param] = pathnameParts.slice(i);
-					break;
-				}
-				const param = part.slice(1, -1);
-				params[param] = pathnameParts[i];
-			}
-		}
-		return params;
-	}
-
-	getSearchParams(url: URL): Record<string, string> {
-		const query: Record<string, string> = {};
-		for (const [key, value] of url.searchParams) {
-			query[key] = value;
-		}
-		return query;
-	}
-
-	match(requestUrl: string): MatchResult | null {
-		const url = new URL(requestUrl);
-		const pathname = url.pathname.replace(this.origin, '');
-
-		const routeValues = Object.values(this.routes);
-
-		for (const route of routeValues) {
-			if (route.kind === 'exact' && (pathname === route.pathname || pathname === `${route.pathname}/`)) {
-				return {
-					filePath: route.filePath,
-					kind: 'exact',
-					pathname: route.pathname,
-					query: this.getSearchParams(url),
-				};
-			}
-		}
-
-		for (const route of routeValues) {
-			const cleanPathname = route.pathname.replace(/\[.*?\]/g, '');
-			const isValidDynamicRoute = pathname.includes(cleanPathname);
-
-			if (route.kind === 'dynamic' && isValidDynamicRoute) {
-				const routeParts = route.pathname.split('/');
-				const pathnameParts = pathname.split('/');
-
-				if (routeParts.length === pathnameParts.length) {
-					return {
-						filePath: route.filePath,
-						kind: 'dynamic',
-						pathname: pathname,
-						query: this.getSearchParams(url),
-						params: this.getDynamicParams(route, pathname),
-					};
-				}
-			}
-		}
-
-		for (const route of routeValues) {
-			const cleanPathname = route.pathname.replace(/\[.*?\]/g, '');
-			const isValidCatchAllRoute = pathname.includes(cleanPathname);
-
-			if (route.kind === 'catch-all' && isValidCatchAllRoute) {
-				return {
-					filePath: route.filePath,
-					kind: 'catch-all',
-					pathname: pathname,
-					query: this.getSearchParams(url),
-					params: this.getDynamicParams(route, pathname),
-				};
-			}
-		}
-
-		return null;
-	}
-
-	setOnReload(cb: () => void) {
-		this.onReload = cb;
-	}
-
-	reload() {
-		this.init();
-		if (this.onReload) {
-			this.onReload();
-		}
-	}
-}

package/src/services/runtime-state/runtime-specifier-registry.service.ts

@@ -1,96 +0,0 @@
-import type { EcoPagesAppConfig } from '../../types/internal-types.ts';
-
-/**
- * Stores runtime-visible bare-specifier mappings for one app instance.
- *
- * @remarks
- * Integrations populate this registry during runtime setup when they expose
- * browser runtime modules through stable bare imports. Build and HMR code later
- * consume the collected map to create aliasing and bootstrap behavior without
- * forcing integrations to own global registry state.
- */
-export interface RuntimeSpecifierRegistry {
-	/**
-	 * Merges a new batch of specifier mappings into the registry.
-	 *
-	 * @remarks
-	 * Later registrations replace earlier URLs for the same specifier. This keeps
-	 * runtime setup deterministic while still allowing an integration to refresh
-	 * its own declarations during one app session.
-	 */
-	register(map: Record<string, string>): void;
-
-	/**
-	 * Returns the current registry contents.
-	 *
-	 * @remarks
-	 * The returned map is the live backing map for the registry implementation, so
-	 * callers should treat it as read-only unless they intentionally own registry
-	 * mutation semantics.
-	 */
-	getAll(): Map<string, string>;
-
-	/**
-	 * Removes all registered specifiers for the current app/runtime instance.
-	 */
-	clear(): void;
-}
-
-/**
- * Default in-memory runtime specifier registry used by core.
- *
- * @remarks
- * Runtime specifier maps are app-local bootstrap metadata, not durable build
- * artifacts, so the default implementation stays intentionally small.
- */
-export class InMemoryRuntimeSpecifierRegistry implements RuntimeSpecifierRegistry {
-	private readonly specifierMap = new Map<string, string>();
-
-	/**
-	 * Merges one integration-provided mapping set into the app registry.
-	 */
-	register(map: Record<string, string>): void {
-		for (const [specifier, url] of Object.entries(map)) {
-			this.specifierMap.set(specifier, url);
-		}
-	}
-
-	/**
-	 * Returns the live app-owned mapping table.
-	 */
-	getAll(): Map<string, string> {
-		return this.specifierMap;
-	}
-
-	/**
-	 * Clears all mappings for the current runtime session.
-	 */
-	clear(): void {
-		this.specifierMap.clear();
-	}
-}
-
-/**
- * Returns the runtime specifier registry owned by one app instance.
- *
- * @remarks
- * Older tests and helpers may not seed runtime state explicitly yet, so this
- * helper still provides an in-memory fallback when the app runtime has not been
- * initialized.
- */
-export function getAppRuntimeSpecifierRegistry(appConfig: EcoPagesAppConfig): RuntimeSpecifierRegistry {
-	return appConfig.runtime?.runtimeSpecifierRegistry ?? new InMemoryRuntimeSpecifierRegistry();
-}
-
-/**
- * Installs the runtime specifier registry that should back one app instance.
- */
-export function setAppRuntimeSpecifierRegistry(
-	appConfig: EcoPagesAppConfig,
-	runtimeSpecifierRegistry: RuntimeSpecifierRegistry,
-): void {
-	appConfig.runtime = {
-		...(appConfig.runtime ?? {}),
-		runtimeSpecifierRegistry,
-	};
-}