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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/core",
-  "version": "0.2.0-alpha.23",
+  "version": "0.2.0-alpha.25",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -8,16 +8,23 @@
     "ssg"
   ],
   "license": "MIT",
-  "main": "./src/index.js",
+  "main": "./src/index.ts",
   "type": "module",
+  "files": [
+    "src"
+  ],
   "sideEffects": false,
   "repository": {
     "type": "git",
     "url": "https://github.com/ecopages/ecopages.git",
     "directory": "packages/core"
   },
+  "scripts": {
+    "typecheck": "bunx tsc --noEmit",
+    "release:jsr": "bunx jsr publish"
+  },
   "dependencies": {
-    "@ecopages/file-system": "0.2.0-alpha.23",
+    "@ecopages/file-system": "workspace:*",
     "@ecopages/logger": "^0.2.3",
     "@ecopages/scripts-injector": "^0.1.3",
     "@worker-tools/html-rewriter": "0.1.0-pre.19",
@@ -27,46 +34,54 @@
     "oxc-parser": "^0.124.0",
     "ws": "^8.18.0"
   },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/ws": "^8.5.14",
+    "arktype": "^2.1.29",
+    "tailwindcss": "^3.4.19",
+    "valibot": "^1.2.0",
+    "zod": "^4.3.6"
+  },
   "exports": {
     ".": {
-      "browser": "./src/index.browser.js",
-      "import": "./src/index.js",
-      "types": "./src/index.d.ts",
-      "default": "./src/index.js"
+      "browser": "./src/index.browser.ts",
+      "import": "./src/index.ts",
+      "require": "./src/index.ts",
+      "types": "./src/index.ts"
     },
     "./create-app": {
-      "import": "./src/adapters/create-app.js",
-      "types": "./src/adapters/create-app.d.ts",
-      "default": "./src/adapters/create-app.js"
+      "import": "./src/adapters/create-app.ts",
+      "types": "./src/adapters/create-app.ts",
+      "default": "./src/adapters/create-app.ts"
     },
     "./route-renderer/integration-renderer": {
-      "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
-      "default": "./src/route-renderer/orchestration/integration-renderer.js"
+      "types": "./src/route-renderer/orchestration/integration-renderer.ts",
+      "default": "./src/route-renderer/orchestration/integration-renderer.ts"
     },
     "./router/navigation-coordinator": {
-      "types": "./src/router/client/navigation-coordinator.d.ts",
-      "default": "./src/router/client/navigation-coordinator.js"
+      "types": "./src/router/client/navigation-coordinator.ts",
+      "default": "./src/router/client/navigation-coordinator.ts"
     },
     "./router/link-intent": {
-      "types": "./src/router/client/link-intent.d.ts",
-      "default": "./src/router/client/link-intent.js"
+      "types": "./src/router/client/link-intent.ts",
+      "default": "./src/router/client/link-intent.ts"
     },
     "./router/client/navigation-coordinator": {
-      "types": "./src/router/client/navigation-coordinator.d.ts",
-      "default": "./src/router/client/navigation-coordinator.js"
+      "types": "./src/router/client/navigation-coordinator.ts",
+      "default": "./src/router/client/navigation-coordinator.ts"
     },
     "./errors/locals-access-error": {
-      "types": "./src/errors/locals-access-error.d.ts",
-      "default": "./src/errors/locals-access-error.js"
+      "types": "./src/errors/locals-access-error.ts",
+      "default": "./src/errors/locals-access-error.ts"
     },
     "./eco": {
-      "browser": "./src/eco/eco.browser.js",
-      "types": "./src/eco/eco.d.ts",
-      "default": "./src/eco/eco.js"
+      "browser": "./src/eco/eco.browser.ts",
+      "types": "./src/eco/eco.ts",
+      "default": "./src/eco/eco.ts"
     },
     "./route-renderer/template-serialization": {
-      "types": "./src/route-renderer/orchestration/template-serialization.d.ts",
-      "default": "./src/route-renderer/orchestration/template-serialization.js"
+      "types": "./src/route-renderer/orchestration/template-serialization.ts",
+      "default": "./src/route-renderer/orchestration/template-serialization.ts"
     },
     "./declarations": {
       "types": "./src/declarations.d.ts"
@@ -75,255 +90,107 @@
       "types": "./src/env.d.ts"
     },
     "./config-builder": {
-      "types": "./src/config/config-builder.d.ts",
-      "default": "./src/config/config-builder.js"
+      "types": "./src/config/config-builder.ts",
+      "default": "./src/config/config-builder.ts"
     },
     "./constants": {
-      "types": "./src/config/constants.d.ts",
-      "default": "./src/config/constants.js"
+      "types": "./src/config/constants.ts",
+      "default": "./src/config/constants.ts"
     },
     "./bun": {
-      "types": "./src/adapters/bun/index.d.ts",
-      "default": "./src/adapters/bun/index.js"
+      "types": "./src/adapters/bun/index.ts",
+      "default": "./src/adapters/bun/index.ts"
     },
     "./bun/create-app": {
-      "types": "./src/adapters/bun/create-app.d.ts",
-      "default": "./src/adapters/bun/create-app.js"
+      "types": "./src/adapters/bun/create-app.ts",
+      "default": "./src/adapters/bun/create-app.ts"
     },
     "./hmr/hmr-strategy": {
-      "types": "./src/hmr/hmr-strategy.d.ts",
-      "default": "./src/hmr/hmr-strategy.js"
+      "types": "./src/hmr/hmr-strategy.ts",
+      "default": "./src/hmr/hmr-strategy.ts"
     },
     "./internal-types": {
-      "types": "./src/types/internal-types.d.ts"
+      "types": "./src/types/internal-types.ts"
     },
     "./services/asset-processing-service": {
-      "types": "./src/services/assets/asset-processing-service/index.d.ts",
-      "default": "./src/services/assets/asset-processing-service/index.js"
+      "types": "./src/services/assets/asset-processing-service/index.ts",
+      "default": "./src/services/assets/asset-processing-service/index.ts"
     },
     "./services/invalidation/development-invalidation.service": {
-      "types": "./src/services/invalidation/development-invalidation.service.d.ts",
-      "default": "./src/services/invalidation/development-invalidation.service.js"
+      "types": "./src/services/invalidation/development-invalidation.service.ts",
+      "default": "./src/services/invalidation/development-invalidation.service.ts"
     },
     "./services/module-loading/app-server-module-transpiler.service": {
-      "types": "./src/services/module-loading/app-server-module-transpiler.service.d.ts",
-      "default": "./src/services/module-loading/app-server-module-transpiler.service.js"
+      "types": "./src/services/module-loading/app-server-module-transpiler.service.ts",
+      "default": "./src/services/module-loading/app-server-module-transpiler.service.ts"
     },
     "./host-module-loader": {
-      "types": "./src/services/module-loading/host-module-loader-registry.d.ts",
-      "default": "./src/services/module-loading/host-module-loader-registry.js"
+      "types": "./src/services/module-loading/host-module-loader-registry.ts",
+      "default": "./src/services/module-loading/host-module-loader-registry.ts"
     },
     "./utils/deep-merge": {
-      "types": "./src/utils/deep-merge.d.ts",
-      "default": "./src/utils/deep-merge.js"
+      "types": "./src/utils/deep-merge.ts",
+      "default": "./src/utils/deep-merge.ts"
     },
     "./utils/invariant": {
-      "types": "./src/utils/invariant.d.ts",
-      "default": "./src/utils/invariant.js"
+      "types": "./src/utils/invariant.ts",
+      "default": "./src/utils/invariant.ts"
     },
     "./utils/parse-cli-args": {
-      "types": "./src/utils/parse-cli-args.d.ts",
-      "default": "./src/utils/parse-cli-args.js"
+      "types": "./src/utils/parse-cli-args.ts",
+      "default": "./src/utils/parse-cli-args.ts"
     },
     "./plugins/processor": {
-      "types": "./src/plugins/processor.d.ts",
-      "default": "./src/plugins/processor.js"
+      "types": "./src/plugins/processor.ts",
+      "default": "./src/plugins/processor.ts"
     },
     "./plugins/integration-plugin": {
-      "types": "./src/plugins/integration-plugin.d.ts",
-      "default": "./src/plugins/integration-plugin.js"
+      "types": "./src/plugins/integration-plugin.ts",
+      "default": "./src/plugins/integration-plugin.ts"
     },
     "./plugins/source-transform": {
-      "types": "./src/plugins/source-transform.d.ts",
-      "default": "./src/plugins/source-transform.js"
+      "types": "./src/plugins/source-transform.ts",
+      "default": "./src/plugins/source-transform.ts"
     },
     "./build/build-types": {
-      "types": "./src/build/build-types.d.ts",
-      "default": "./src/build/build-types.js"
+      "types": "./src/build/build-types.ts",
+      "default": "./src/build/build-types.ts"
     },
     "./build/build-adapter": {
-      "types": "./src/build/build-adapter.d.ts",
-      "default": "./src/build/build-adapter.js"
+      "types": "./src/build/build-adapter.ts",
+      "default": "./src/build/build-adapter.ts"
     },
     "./build/runtime-specifier-alias-plugin": {
-      "types": "./src/build/runtime-specifier-alias-plugin.d.ts",
-      "default": "./src/build/runtime-specifier-alias-plugin.js"
+      "types": "./src/build/runtime-specifier-alias-plugin.ts",
+      "default": "./src/build/runtime-specifier-alias-plugin.ts"
     },
     "./build/runtime-specifier-aliases": {
-      "types": "./src/build/runtime-specifier-aliases.d.ts",
-      "default": "./src/build/runtime-specifier-aliases.js"
+      "types": "./src/build/runtime-specifier-aliases.ts",
+      "default": "./src/build/runtime-specifier-aliases.ts"
     },
     "./plugins/foreign-jsx-override-plugin": {
-      "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
-      "default": "./src/plugins/foreign-jsx-override-plugin.js"
+      "types": "./src/plugins/foreign-jsx-override-plugin.ts",
+      "default": "./src/plugins/foreign-jsx-override-plugin.ts"
     },
     "./adapters/bun/client-bridge": {
-      "types": "./src/adapters/bun/client-bridge.d.ts",
-      "default": "./src/adapters/bun/client-bridge.js"
+      "types": "./src/adapters/bun/client-bridge.ts",
+      "default": "./src/adapters/bun/client-bridge.ts"
     },
     "./html": {
-      "import": "./src/utils/html.js",
-      "default": "./src/utils/html.js",
-      "types": "./src/utils/html.d.ts"
+      "import": "./src/utils/html.ts",
+      "require": "./src/utils/html.ts"
     },
     "./hash": {
-      "import": "./src/utils/hash.js",
-      "default": "./src/utils/hash.js",
-      "types": "./src/utils/hash.d.ts"
+      "import": "./src/utils/hash.ts",
+      "require": "./src/utils/hash.ts"
     },
     "./errors": {
-      "types": "./src/errors/index.d.ts",
-      "default": "./src/errors/index.js"
+      "types": "./src/errors/index.ts",
+      "default": "./src/errors/index.ts"
     },
     "./integrations/ghtml": {
-      "types": "./src/integrations/ghtml/ghtml.plugin.d.ts",
-      "default": "./src/integrations/ghtml/ghtml.plugin.js"
-    },
-    "./create-app.ts": {
-      "import": "./src/adapters/create-app.js",
-      "types": "./src/adapters/create-app.d.ts",
-      "default": "./src/adapters/create-app.js"
-    },
-    "./route-renderer/integration-renderer.ts": {
-      "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
-      "default": "./src/route-renderer/orchestration/integration-renderer.js"
-    },
-    "./router/navigation-coordinator.ts": {
-      "types": "./src/router/client/navigation-coordinator.d.ts",
-      "default": "./src/router/client/navigation-coordinator.js"
-    },
-    "./router/link-intent.ts": {
-      "types": "./src/router/client/link-intent.d.ts",
-      "default": "./src/router/client/link-intent.js"
-    },
-    "./router/client/navigation-coordinator.ts": {
-      "types": "./src/router/client/navigation-coordinator.d.ts",
-      "default": "./src/router/client/navigation-coordinator.js"
-    },
-    "./errors/locals-access-error.ts": {
-      "types": "./src/errors/locals-access-error.d.ts",
-      "default": "./src/errors/locals-access-error.js"
-    },
-    "./eco.ts": {
-      "browser": "./src/eco/eco.browser.js",
-      "types": "./src/eco/eco.d.ts",
-      "default": "./src/eco/eco.js"
-    },
-    "./route-renderer/template-serialization.ts": {
-      "types": "./src/route-renderer/orchestration/template-serialization.d.ts",
-      "default": "./src/route-renderer/orchestration/template-serialization.js"
-    },
-    "./declarations.ts": {
-      "types": "./src/declarations.d.ts"
-    },
-    "./env.ts": {
-      "types": "./src/env.d.ts"
-    },
-    "./config-builder.ts": {
-      "types": "./src/config/config-builder.d.ts",
-      "default": "./src/config/config-builder.js"
-    },
-    "./constants.ts": {
-      "types": "./src/config/constants.d.ts",
-      "default": "./src/config/constants.js"
-    },
-    "./bun.ts": {
-      "types": "./src/adapters/bun/index.d.ts",
-      "default": "./src/adapters/bun/index.js"
-    },
-    "./bun/create-app.ts": {
-      "types": "./src/adapters/bun/create-app.d.ts",
-      "default": "./src/adapters/bun/create-app.js"
-    },
-    "./hmr/hmr-strategy.ts": {
-      "types": "./src/hmr/hmr-strategy.d.ts",
-      "default": "./src/hmr/hmr-strategy.js"
-    },
-    "./internal-types.ts": {
-      "types": "./src/types/internal-types.d.ts"
-    },
-    "./services/asset-processing-service.ts": {
-      "types": "./src/services/assets/asset-processing-service/index.d.ts",
-      "default": "./src/services/assets/asset-processing-service/index.js"
-    },
-    "./services/invalidation/development-invalidation.service.ts": {
-      "types": "./src/services/invalidation/development-invalidation.service.d.ts",
-      "default": "./src/services/invalidation/development-invalidation.service.js"
-    },
-    "./services/module-loading/app-server-module-transpiler.service.ts": {
-      "types": "./src/services/module-loading/app-server-module-transpiler.service.d.ts",
-      "default": "./src/services/module-loading/app-server-module-transpiler.service.js"
-    },
-    "./host-module-loader.ts": {
-      "types": "./src/services/module-loading/host-module-loader-registry.d.ts",
-      "default": "./src/services/module-loading/host-module-loader-registry.js"
-    },
-    "./utils/deep-merge.ts": {
-      "types": "./src/utils/deep-merge.d.ts",
-      "default": "./src/utils/deep-merge.js"
-    },
-    "./utils/invariant.ts": {
-      "types": "./src/utils/invariant.d.ts",
-      "default": "./src/utils/invariant.js"
-    },
-    "./utils/parse-cli-args.ts": {
-      "types": "./src/utils/parse-cli-args.d.ts",
-      "default": "./src/utils/parse-cli-args.js"
-    },
-    "./plugins/processor.ts": {
-      "types": "./src/plugins/processor.d.ts",
-      "default": "./src/plugins/processor.js"
-    },
-    "./plugins/integration-plugin.ts": {
-      "types": "./src/plugins/integration-plugin.d.ts",
-      "default": "./src/plugins/integration-plugin.js"
-    },
-    "./plugins/source-transform.ts": {
-      "types": "./src/plugins/source-transform.d.ts",
-      "default": "./src/plugins/source-transform.js"
-    },
-    "./build/build-types.ts": {
-      "types": "./src/build/build-types.d.ts",
-      "default": "./src/build/build-types.js"
-    },
-    "./build/build-adapter.ts": {
-      "types": "./src/build/build-adapter.d.ts",
-      "default": "./src/build/build-adapter.js"
-    },
-    "./build/runtime-specifier-alias-plugin.ts": {
-      "types": "./src/build/runtime-specifier-alias-plugin.d.ts",
-      "default": "./src/build/runtime-specifier-alias-plugin.js"
-    },
-    "./build/runtime-specifier-aliases.ts": {
-      "types": "./src/build/runtime-specifier-aliases.d.ts",
-      "default": "./src/build/runtime-specifier-aliases.js"
-    },
-    "./plugins/foreign-jsx-override-plugin.ts": {
-      "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
-      "default": "./src/plugins/foreign-jsx-override-plugin.js"
-    },
-    "./adapters/bun/client-bridge.ts": {
-      "types": "./src/adapters/bun/client-bridge.d.ts",
-      "default": "./src/adapters/bun/client-bridge.js"
-    },
-    "./html.ts": {
-      "import": "./src/utils/html.js",
-      "default": "./src/utils/html.js",
-      "types": "./src/utils/html.d.ts"
-    },
-    "./hash.ts": {
-      "import": "./src/utils/hash.js",
-      "default": "./src/utils/hash.js",
-      "types": "./src/utils/hash.d.ts"
-    },
-    "./errors.ts": {
-      "types": "./src/errors/index.d.ts",
-      "default": "./src/errors/index.js"
-    },
-    "./integrations/ghtml.ts": {
-      "types": "./src/integrations/ghtml/ghtml.plugin.d.ts",
-      "default": "./src/integrations/ghtml/ghtml.plugin.js"
+      "types": "./src/integrations/ghtml/ghtml.plugin.ts",
+      "default": "./src/integrations/ghtml/ghtml.plugin.ts"
     }
-  },
-  "types": "./src/index.d.ts"
-}
+  }
+}

package/src/adapters/abstract/application-adapter.test.ts

@@ -0,0 +1,172 @@
+import assert from 'node:assert/strict';
+import { afterEach, describe, it } from 'vitest';
+import {
+	AbstractApplicationAdapter,
+	type ApplicationAdapterOptions,
+	type RouteHandler,
+	type RouteGroupDefinition,
+} from './application-adapter.ts';
+import type { ApiHandlerContext, ViewLoader } from '../../types/public-types.ts';
+import {
+	setHostModuleLoader,
+	clearHostModuleLoader,
+} from '../../services/module-loading/host-module-loader-registry.ts';
+
+class TestApplicationAdapter extends AbstractApplicationAdapter<ApplicationAdapterOptions, unknown, Request> {
+	public getCliArgsSnapshot() {
+		return this.cliArgs;
+	}
+
+	public getAppModuleLoader() {
+		return this.appConfig.runtime?.appModuleLoader;
+	}
+
+	public getHostModuleLoader() {
+		return this.appConfig.runtime?.hostModuleLoader;
+	}
+
+	get<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	post<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	put<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	delete<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	patch<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	options<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	head<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	route<P extends string>(_path: P, _method: 'GET', _handler: RouteHandler<Request, unknown>): this {
+		return this;
+	}
+
+	add(): this {
+		return this;
+	}
+
+	group(_prefix: string, _callback: (builder: unknown) => void): this;
+	group(_group: RouteGroupDefinition<Request, unknown>): this;
+	group(): this {
+		return this;
+	}
+
+	override static<P>(_path: string, _loader: ViewLoader<P>): this {
+		return this;
+	}
+
+	protected async initializeServerAdapter(): Promise<void> {
+		return;
+	}
+
+	async fetch(_request: Request): Promise<Response> {
+		return new Response(null, { status: 204 });
+	}
+
+	start(): Promise<void> {
+		return Promise.resolve();
+	}
+}
+
+afterEach(() => {
+	clearHostModuleLoader();
+	delete process.env.NODE_ENV;
+});
+
+describe('application adapter runtime bootstrap', () => {
+	it('derives embedded cli args from explicit runtime options', () => {
+		process.env.NODE_ENV = 'development';
+		const adapter = new TestApplicationAdapter({
+			appConfig: {
+				runtime: {},
+			} as ApplicationAdapterOptions['appConfig'],
+			runtime: {
+				embedded: true,
+			},
+		});
+
+		assert.deepEqual(adapter.getCliArgsSnapshot(), {
+			preview: false,
+			build: false,
+			start: false,
+			dev: true,
+			port: undefined,
+			hostname: undefined,
+			reactFastRefresh: undefined,
+		});
+		assert.equal(adapter.getAppModuleLoader()?.owner, 'bun');
+	});
+
+	it('auto-detects the host module loader in embedded mode from registry', async () => {
+		process.env.NODE_ENV = 'development';
+		let importedId: string | undefined;
+		const filePath = import.meta.filename;
+		setHostModuleLoader(async (id) => {
+			importedId = id;
+			return { id };
+		});
+
+		const adapter = new TestApplicationAdapter({
+			appConfig: {
+				runtime: {},
+			} as ApplicationAdapterOptions['appConfig'],
+			runtime: {
+				embedded: true,
+			},
+		});
+
+		const appModuleLoader = adapter.getAppModuleLoader();
+		const hostModuleLoader = adapter.getHostModuleLoader();
+
+		assert.ok(appModuleLoader);
+		assert.ok(hostModuleLoader);
+		assert.equal(appModuleLoader?.owner, 'host');
+		assert.deepEqual(await hostModuleLoader?.('/virtual:entry'), { id: '/virtual:entry' });
+		assert.deepEqual(
+			await appModuleLoader?.importModule({
+				filePath,
+				rootDir: '/app',
+				outdir: '/app/.eco/.server-modules',
+			}),
+			{ id: importedId },
+		);
+		assert.match(importedId ?? '', /application-adapter\.test\.ts\?update=/);
+	});
+});