@ecopages/core 0.2.0-alpha.2 → 0.2.0-alpha.21

package/src/services/asset-processing-service/asset.factory.ts

@@ -1,105 +0,0 @@
-import { RESOLVED_ASSETS_DIR, RESOLVED_ASSETS_VENDORS_DIR } from '../../constants';
-import { deepMerge } from '../../utils/deep-merge';
-import type {
-	ContentScriptAsset,
-	ContentStylesheetAsset,
-	FileScriptAsset,
-	FileStylesheetAsset,
-	InlineContentScriptAsset,
-	InlineContentStylesheetAsset,
-	InlineFileScriptAsset,
-	JsonScriptAsset,
-	NodeModuleScriptAsset,
-} from './assets.types';
-
-type CreateAssetOptions<T> = Omit<T, 'kind' | 'source' | 'inline'>;
-
-export class AssetFactory {
-	static readonly RESOLVED_ASSETS_DIR = RESOLVED_ASSETS_DIR;
-	static readonly RESOLVED_ASSETS_VENDORS_DIR = RESOLVED_ASSETS_VENDORS_DIR;
-
-	static createContentScript(options: CreateAssetOptions<ContentScriptAsset>): ContentScriptAsset {
-		return {
-			kind: 'script',
-			source: 'content',
-			position: options.position || 'body',
-			...options,
-		};
-	}
-
-	static createInlineContentScript(options: CreateAssetOptions<InlineContentScriptAsset>): InlineContentScriptAsset {
-		return {
-			...AssetFactory.createContentScript(options),
-			inline: true,
-		};
-	}
-
-	static createFileScript(options: CreateAssetOptions<FileScriptAsset>): FileScriptAsset {
-		return {
-			kind: 'script',
-			source: 'file',
-			position: options.position || 'body',
-			...options,
-		};
-	}
-
-	static createInlineFileScript(options: CreateAssetOptions<InlineFileScriptAsset>): InlineFileScriptAsset {
-		return {
-			...AssetFactory.createFileScript(options),
-			inline: true,
-		};
-	}
-
-	static createNodeModuleScript(options: CreateAssetOptions<NodeModuleScriptAsset>): NodeModuleScriptAsset {
-		return {
-			kind: 'script',
-			source: 'node-module',
-			position: options.position || 'body',
-			...options,
-		};
-	}
-
-	static createInlineNodeModuleScript(options: CreateAssetOptions<NodeModuleScriptAsset>): NodeModuleScriptAsset {
-		return {
-			...AssetFactory.createNodeModuleScript(options),
-			inline: true,
-		};
-	}
-
-	static createJsonScript(options: CreateAssetOptions<JsonScriptAsset>): JsonScriptAsset {
-		return {
-			kind: 'script',
-			source: 'content',
-			attributes: deepMerge(options.attributes, { type: 'application/json' }),
-			position: options.position || 'body',
-			...options,
-		};
-	}
-
-	static createContentStylesheet(options: CreateAssetOptions<ContentStylesheetAsset>): ContentStylesheetAsset {
-		return {
-			kind: 'stylesheet',
-			source: 'content',
-			position: 'head',
-			...options,
-		};
-	}
-
-	static createInlineContentStylesheet(
-		options: CreateAssetOptions<InlineContentStylesheetAsset>,
-	): InlineContentStylesheetAsset {
-		return {
-			...AssetFactory.createContentStylesheet(options),
-			inline: true,
-		};
-	}
-
-	static createFileStylesheet(options: CreateAssetOptions<FileStylesheetAsset>): FileStylesheetAsset {
-		return {
-			kind: 'stylesheet',
-			source: 'file',
-			position: options.position || 'head',
-			...options,
-		};
-	}
-}

package/src/services/asset-processing-service/assets.types.ts

@@ -1,112 +0,0 @@
-import type { EcoBuildPlugin } from '../../build/build-types.ts';
-
-export type AssetSource = 'content' | 'file' | 'node-module';
-export type AssetKind = 'script' | 'stylesheet';
-export type AssetPosition = 'head' | 'body';
-
-export interface BaseAsset {
-	kind: AssetKind;
-	source: AssetSource;
-	attributes?: Record<string, string>;
-	position?: AssetPosition;
-}
-
-export interface ScriptAsset extends BaseAsset {
-	kind: 'script';
-	inline?: boolean;
-	bundle?: boolean;
-	bundleOptions?: {
-		minify?: boolean;
-		external?: string[];
-		naming?: string;
-		plugins?: EcoBuildPlugin[];
-	};
-	/**
-	 * Whether to exclude this asset from the HTML output.
-	 * @default false
-	 */
-	excludeFromHtml?: boolean;
-}
-
-export interface StylesheetAsset extends BaseAsset {
-	kind: 'stylesheet';
-	inline?: boolean;
-}
-
-export interface ContentScriptAsset extends ScriptAsset {
-	source: 'content';
-	content: string;
-	name?: string;
-}
-
-export interface InlineContentScriptAsset extends ContentScriptAsset {
-	inline: true;
-}
-
-export interface ContentStylesheetAsset extends StylesheetAsset {
-	source: 'content';
-	content: string;
-}
-
-export interface InlineContentStylesheetAsset extends ContentStylesheetAsset {
-	inline: true;
-}
-
-export interface FileScriptAsset extends ScriptAsset {
-	source: 'file';
-	filepath: string;
-	name?: string;
-}
-
-export interface InlineFileScriptAsset extends FileScriptAsset {
-	inline: true;
-}
-
-export interface FileStylesheetAsset extends StylesheetAsset {
-	source: 'file';
-	filepath: string;
-	name?: string;
-}
-
-export interface InlineFileStylesheetAsset extends FileStylesheetAsset {
-	inline: true;
-}
-
-export interface NodeModuleScriptAsset extends ScriptAsset {
-	kind: 'script';
-	source: 'node-module';
-	importPath: string;
-	name?: string;
-}
-
-export interface InlineNodeModuleScriptAsset extends NodeModuleScriptAsset {
-	inline: true;
-}
-
-export interface InlineNodeModuleScriptAsset extends NodeModuleScriptAsset {
-	inline: true;
-}
-
-export interface JsonScriptAsset extends ScriptAsset {
-	source: 'content';
-	content: string;
-}
-
-export type ProcessedAsset = {
-	filepath?: string;
-	srcUrl?: string;
-	content?: string;
-	kind: AssetKind;
-	position?: AssetPosition;
-	attributes?: Record<string, string>;
-	inline?: boolean;
-	excludeFromHtml?: boolean;
-};
-
-export type AssetDefinition =
-	| ContentScriptAsset
-	| FileScriptAsset
-	| NodeModuleScriptAsset
-	| JsonScriptAsset
-	| ContentStylesheetAsset
-	| FileStylesheetAsset;

package/src/services/asset-processing-service/index.d.ts

@@ -1,3 +0,0 @@
-export * from './asset.factory';
-export * from './asset-processing.service';
-export * from './assets.types';

package/src/services/asset-processing-service/index.js

@@ -1,3 +0,0 @@
-export * from "./asset.factory";
-export * from "./asset-processing.service";
-export * from "./assets.types";

package/src/services/asset-processing-service/index.ts

@@ -1,3 +0,0 @@
-export * from './asset.factory';
-export * from './asset-processing.service';
-export * from './assets.types';

package/src/services/asset-processing-service/processor.interface.ts

@@ -1,27 +0,0 @@
-import type { IHmrManager } from '../../internal-types';
-import type { AssetDefinition, ProcessedAsset } from './assets.types';
-
-/**
- * Base interface for asset processors.
- * Processors transform asset definitions into processed assets.
- */
-export interface AssetProcessor<T extends AssetDefinition = AssetDefinition> {
-	process(asset: T): Promise<ProcessedAsset>;
-}
-
-/**
- * Interface for processors that support HMR (Hot Module Replacement).
- * These processors can receive an HMR manager to enable hot reloading capabilities.
- */
-export interface HmrAwareProcessor extends AssetProcessor {
-	setHmrManager(hmrManager: IHmrManager): void;
-}
-
-/**
- * Type guard to check if a processor supports HMR.
- * @param processor - The processor to check
- * @returns True if the processor implements HmrAwareProcessor
- */
-export function isHmrAware(processor: AssetProcessor): processor is HmrAwareProcessor {
-	return 'setHmrManager' in processor && typeof (processor as HmrAwareProcessor).setHmrManager === 'function';
-}

package/src/services/asset-processing-service/processor.registry.ts

@@ -1,18 +0,0 @@
-import type { AssetKind, AssetSource } from './assets.types';
-import type { BaseProcessor } from './processors/base/base-processor';
-
-export class ProcessorRegistry {
-	private processors = new Map<`${AssetKind}-${AssetSource}`, BaseProcessor<any>>();
-
-	register(kind: AssetKind, variant: AssetSource, processor: BaseProcessor<any>) {
-		this.processors.set(`${kind}-${variant}`, processor);
-	}
-
-	getProcessor(kind: AssetKind, variant: AssetSource): BaseProcessor<any> | undefined {
-		return this.processors.get(`${kind}-${variant}`);
-	}
-
-	getAllProcessors(): Map<`${AssetKind}-${AssetSource}`, BaseProcessor<any>> {
-		return this.processors;
-	}
-}

package/src/services/asset-processing-service/processors/base/base-processor.ts

@@ -1,76 +0,0 @@
-import path from 'node:path';
-import { RESOLVED_ASSETS_DIR } from '../../../../constants.ts';
-import type { EcoPagesAppConfig } from '../../../../internal-types.ts';
-import { rapidhash } from '../../../../utils/hash.ts';
-import { isDevelopmentRuntime, isProductionRuntime } from '../../../../utils/runtime.ts';
-import type { BaseAsset, ProcessedAsset } from '../../assets.types.ts';
-
-export abstract class BaseProcessor<T extends BaseAsset> {
-	protected appConfig: EcoPagesAppConfig;
-	/**
-	 * Cache for processed assets to avoid reprocessing the same asset multiple times.
-	 * The cache key is a combination of the asset name and its hash.
-	 * The cache value is the processed asset.
-	 */
-	protected cache: Map<string, ProcessedAsset> = new Map();
-
-	constructor({ appConfig }: { appConfig: EcoPagesAppConfig }) {
-		this.appConfig = appConfig;
-	}
-
-	get isDevelopment(): boolean {
-		return isDevelopmentRuntime();
-	}
-
-	get isProduction(): boolean {
-		return isProductionRuntime();
-	}
-
-	abstract process(dep: T): Promise<ProcessedAsset>;
-
-	protected getAssetsDir(): string {
-		return path.join(this.appConfig.absolutePaths.distDir, RESOLVED_ASSETS_DIR);
-	}
-
-	protected writeCacheFile(key: string, path: ProcessedAsset): void {
-		this.cache.set(key, path);
-	}
-
-	protected getCacheFile(key: string): ProcessedAsset | undefined {
-		return this.cache.get(key);
-	}
-
-	protected hasCacheFile(key: string): boolean {
-		return this.cache.has(key);
-	}
-
-	protected generateHash(content: string): string {
-		return rapidhash(content).toString();
-	}
-
-	protected buildCacheKey(identifier: string, contentHash: string, dep: T): string {
-		const attrsHash = dep.attributes ? this.generateHash(JSON.stringify(dep.attributes)) : '';
-		const position = dep.position ?? '';
-		return `${identifier}:${contentHash}:${position}:${attrsHash}`;
-	}
-
-	protected getOrProcess(
-		cacheKey: string,
-		processFn: () => ProcessedAsset | Promise<ProcessedAsset>,
-	): Promise<ProcessedAsset> {
-		if (this.hasCacheFile(cacheKey)) {
-			return Promise.resolve(this.getCacheFile(cacheKey) as ProcessedAsset);
-		}
-
-		const result = processFn();
-		if (result instanceof Promise) {
-			return result.then((asset) => {
-				this.writeCacheFile(cacheKey, asset);
-				return asset;
-			});
-		}
-
-		this.writeCacheFile(cacheKey, result);
-		return Promise.resolve(result);
-	}
-}

package/src/services/asset-processing-service/processors/base/base-script-processor.ts

@@ -1,105 +0,0 @@
-import { appLogger } from '../../../../global/app-logger';
-import type { EcoPagesAppConfig } from '../../../../internal-types';
-import { defaultBuildAdapter } from '../../../../build/build-adapter.ts';
-import type { EcoBuildPlugin } from '../../../../build/build-types.ts';
-import { fileSystem } from '@ecopages/file-system';
-import path from 'node:path';
-import type { ScriptAsset } from '../../assets.types';
-import { BaseProcessor } from './base-processor';
-
-export abstract class BaseScriptProcessor<T extends ScriptAsset> extends BaseProcessor<T> {
-	constructor({ appConfig }: { appConfig: EcoPagesAppConfig }) {
-		super({ appConfig });
-	}
-
-	protected shouldBundle(dep: T): boolean {
-		return dep.bundle !== false;
-	}
-
-	protected getBundlerOptions(dep: T): Record<string, any> {
-		return dep.bundleOptions || {};
-	}
-
-	protected collectBuildPlugins(): EcoBuildPlugin[] {
-		const plugins: EcoBuildPlugin[] = [];
-
-		if (this.appConfig.processors?.size) {
-			for (const processor of this.appConfig.processors.values()) {
-				if (processor.buildPlugins) {
-					plugins.push(...processor.buildPlugins);
-				}
-			}
-		}
-
-		if (this.appConfig.loaders?.size) {
-			plugins.push(...this.appConfig.loaders.values());
-		}
-
-		return plugins;
-	}
-
-	protected async bundleScript({
-		entrypoint,
-		outdir,
-		plugins: additionalPlugins,
-		...rest
-	}: {
-		entrypoint: string;
-		outdir: string;
-	} & ScriptAsset['bundleOptions']): Promise<string> {
-		const buildPlugins = this.collectBuildPlugins();
-		const allPlugins = additionalPlugins ? [...additionalPlugins, ...buildPlugins] : buildPlugins;
-
-		const build = await defaultBuildAdapter.build({
-			entrypoints: [entrypoint],
-			outdir,
-			root: this.appConfig.rootDir,
-			...defaultBuildAdapter.getTranspileOptions('browser-script'),
-			splitting: true,
-			naming: '[name]-[hash].[ext]',
-			plugins: allPlugins,
-			...rest,
-		});
-
-		if (!build.success) {
-			for (const log of build.logs) {
-				appLogger.debug(log.message, log);
-			}
-		}
-
-		const entryBaseName = path.parse(entrypoint).name;
-		const entryOutput = build.outputs
-			.map((output) => output.path)
-			.find((outputPath) => path.basename(outputPath) === `${entryBaseName}.js`);
-
-		if (entryOutput) {
-			return entryOutput;
-		}
-
-		const nonVendorOutput = build.outputs
-			.map((output) => output.path)
-			.find((outputPath) => !path.basename(outputPath).startsWith('vendors'));
-
-		if (nonVendorOutput) {
-			return nonVendorOutput;
-		}
-
-		const primaryOutput = build.outputs[0]?.path;
-		if (primaryOutput) {
-			return primaryOutput;
-		}
-
-		const namedFallbackOutput = path.join(outdir, `${entryBaseName}.js`);
-		if (fileSystem.exists(namedFallbackOutput)) {
-			return namedFallbackOutput;
-		}
-
-		const fallbackOutput = path.join(outdir, 'entry_0.js');
-		if (fileSystem.exists(fallbackOutput)) {
-			return fallbackOutput;
-		}
-
-		const logMessage = build.logs.map((log) => log.message).join(' | ');
-		throw new Error(`No build output generated for ${entrypoint}${logMessage ? `: ${logMessage}` : ''}`);
-	}
-}

package/src/services/asset-processing-service/processors/index.d.ts

@@ -1,5 +0,0 @@
-export * from './script/content-script.processor';
-export * from './script/file-script.processor';
-export * from './script/node-module-script.processor';
-export * from './stylesheet/content-stylesheet.processor';
-export * from './stylesheet/file-stylesheet.processor';

package/src/services/asset-processing-service/processors/index.js

@@ -1,5 +0,0 @@
-export * from "./script/content-script.processor";
-export * from "./script/file-script.processor";
-export * from "./script/node-module-script.processor";
-export * from "./stylesheet/content-stylesheet.processor";
-export * from "./stylesheet/file-stylesheet.processor";

package/src/services/asset-processing-service/processors/index.ts

@@ -1,5 +0,0 @@
-export * from './script/content-script.processor';
-export * from './script/file-script.processor';
-export * from './script/node-module-script.processor';
-export * from './stylesheet/content-stylesheet.processor';
-export * from './stylesheet/file-stylesheet.processor';

package/src/services/asset-processing-service/processors/script/content-script.processor.ts

@@ -1,66 +0,0 @@
-import path from 'node:path';
-import { fileSystem } from '@ecopages/file-system';
-import type { ContentScriptAsset, ProcessedAsset } from '../../assets.types';
-import { BaseScriptProcessor } from '../base/base-script-processor';
-
-export class ContentScriptProcessor extends BaseScriptProcessor<ContentScriptAsset> {
-	async process(dep: ContentScriptAsset): Promise<ProcessedAsset> {
-		const hash = this.generateHash(dep.content);
-		const filename = dep.name ? `${dep.name}.js` : `script-${hash}.js`;
-		const shouldBundle = this.shouldBundle(dep);
-
-		const filepath = path.join(this.getAssetsDir(), 'scripts', filename);
-
-		if (!shouldBundle) {
-			if (!dep.inline) fileSystem.write(filepath, dep.content);
-			const unbundledProcessedAsset: ProcessedAsset = {
-				filepath,
-				content: dep.inline ? dep.content : undefined,
-				kind: 'script',
-				position: dep.position,
-				attributes: dep.attributes,
-				inline: dep.inline,
-				excludeFromHtml: dep.excludeFromHtml,
-			};
-
-			this.writeCacheFile(filename, unbundledProcessedAsset);
-			return unbundledProcessedAsset;
-		}
-
-		if (dep.content) {
-			const tempDir = this.appConfig.absolutePaths.distDir;
-			fileSystem.ensureDir(tempDir);
-			const tempFileName = path.join(
-				tempDir,
-				`${path.parse(filename).name}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp.js`,
-			);
-			fileSystem.write(tempFileName, dep.content);
-
-			const bundledFilePath = await this.bundleScript({
-				entrypoint: tempFileName,
-				outdir: this.getAssetsDir(),
-				minify: this.isProduction,
-				naming: `${path.parse(filename).name}-[hash].[ext]`,
-				...this.getBundlerOptions(dep),
-			});
-
-			const processedAsset: ProcessedAsset = {
-				filepath: bundledFilePath,
-				content: dep.inline ? fileSystem.readFileSync(bundledFilePath).toString() : undefined,
-				kind: 'script',
-				position: dep.position,
-				attributes: dep.attributes,
-				inline: dep.inline,
-				excludeFromHtml: dep.excludeFromHtml,
-			};
-
-			fileSystem.remove(tempFileName);
-
-			this.writeCacheFile(filename, processedAsset);
-
-			return processedAsset;
-		}
-
-		throw new Error('No content found for script asset');
-	}
-}

package/src/services/asset-processing-service/processors/script/file-script.processor.ts

@@ -1,88 +0,0 @@
-import path from 'node:path';
-import { RESOLVED_ASSETS_DIR } from '../../../../constants';
-import { fileSystem } from '@ecopages/file-system';
-import type { IHmrManager } from '../../../../internal-types';
-import type { FileScriptAsset, ProcessedAsset } from '../../assets.types';
-import { BaseScriptProcessor } from '../base/base-script-processor';
-
-export class FileScriptProcessor extends BaseScriptProcessor<FileScriptAsset> {
-	private hmrManager?: IHmrManager;
-
-	setHmrManager(hmrManager: IHmrManager) {
-		this.hmrManager = hmrManager;
-	}
-
-	async process(dep: FileScriptAsset): Promise<ProcessedAsset> {
-		/**
-		 * If HMR Manager is active, delegate build/watch to it.
-		 */
-		if (this.hmrManager?.isEnabled() && !dep.inline) {
-			const outputUrl = await this.hmrManager.registerEntrypoint(dep.filepath);
-			return {
-				filepath: dep.filepath,
-				srcUrl: outputUrl,
-				kind: 'script',
-				position: dep.position,
-				attributes: dep.attributes,
-				inline: false,
-				excludeFromHtml: dep.excludeFromHtml,
-			};
-		}
-
-		const content = fileSystem.readFileSync(dep.filepath);
-		const shouldBundle = this.shouldBundle(dep);
-		const configHash = this.generateHash(
-			JSON.stringify({
-				bundle: shouldBundle,
-				minify: shouldBundle && this.isProduction,
-				opts: dep.bundleOptions,
-			}),
-		);
-		const cachekey = `${this.buildCacheKey(dep.filepath, this.generateHash(content), dep)}:${configHash}`;
-
-		return this.getOrProcess(cachekey, async () => {
-			if (!shouldBundle) {
-				const outFilepath = path.relative(this.appConfig.absolutePaths.srcDir, dep.filepath);
-				let filepath: string | undefined;
-
-				if (!dep.inline) {
-					filepath = path.join(this.getAssetsDir(), outFilepath);
-					fileSystem.copyFile(dep.filepath, filepath);
-				}
-
-				return {
-					filepath,
-					content,
-					kind: 'script',
-					position: dep.position,
-					attributes: dep.attributes,
-					inline: dep.inline,
-					excludeFromHtml: dep.excludeFromHtml,
-				};
-			}
-
-			const relativeFilepath = path.relative(this.appConfig.absolutePaths.srcDir, dep.filepath);
-			const outdirPath = path.join(this.appConfig.absolutePaths.distDir, RESOLVED_ASSETS_DIR, relativeFilepath);
-			const outdirDirname = path.dirname(outdirPath);
-			const bundlerOptions = this.getBundlerOptions(dep);
-
-			const bundledFilePath = await this.bundleScript({
-				entrypoint: dep.filepath,
-				outdir: outdirDirname,
-				minify: this.isProduction,
-				...bundlerOptions,
-				plugins: bundlerOptions.plugins,
-			});
-
-			return {
-				filepath: bundledFilePath,
-				content: dep.inline ? fileSystem.readFileSync(bundledFilePath).toString() : undefined,
-				kind: 'script',
-				position: dep.position,
-				attributes: dep.attributes,
-				inline: dep.inline,
-				excludeFromHtml: dep.excludeFromHtml,
-			};
-		});
-	}
-}