mirrors/egg

feat(bundler): inject manifest loader fs into worker (#5944)

Summary

add ManifestLoaderFS on top of the shared @eggjs/loader-fs contracts and export it through @eggjs/core
thread loaderFS through startEgg and EggCore into EggLoader, including manifest-backed package metadata reads
generate bundled worker entries that create a manifest-backed LoaderFS from the inline manifest store and pass it via loader options
update entry generator/runtime tests, loader tests, manifest coverage, and snapshots

Tests

pnpm install
pnpm exec vitest run packages/core/test/index.test.ts packages/core/test/egg.test.ts packages/core/test/loader/egg_loader.test.ts packages/core/test/loader/manifest_loader_fs.test.ts packages/core/test/loader/manifest_coverage.test.ts
pnpm exec vitest run test/EntryGenerator.test.ts from tools/egg-bundler
pnpm --filter @eggjs/core typecheck
pnpm --filter egg typecheck
pnpm --filter @eggjs/egg-bundler typecheck
pnpm exec oxlint --type-aware packages/core/src/index.ts packages/core/src/egg.ts packages/core/src/loader/egg_loader.ts packages/core/src/loader/loader_fs.ts packages/core/test/egg.test.ts packages/core/test/loader/egg_loader.test.ts packages/core/test/loader/manifest_loader_fs.test.ts packages/core/test/loader/manifest_coverage.test.ts packages/egg/src/lib/start.ts tools/egg-bundler/src/lib/EntryGenerator.ts tools/egg-bundler/test/EntryGenerator.test.ts (0 errors; existing warnings in untouched sections)
git diff --check origin/next..HEAD

Issue: EGG-97

Summary by CodeRabbit

New Features
Added a configurable loaderFS option and a manifest-backed filesystem to support bundled-app file resolution; bundler now wires this into startup.
Tests
Expanded test coverage for manifest-backed FS behavior, file discovery and resolve caching, loader precedence, and generated bundler runtime hooks.
Chores
Declared multimatch dependency to improve pattern matching for manifest-backed globs.

English | 简体中文

Features

Built-in Process Management
Plugin System
Framework Customization
Lots of plugins

Quickstart

Follow the commands listed below.

$ mkdir showcase && cd showcase
$ pnpm create egg@beta
$ pnpm install
$ pnpm run dev
$ open http://localhost:7001

Node.js >= 20.19.0 required, supports require(esm) by default.

Monorepo Structure

This project is structured as a pnpm monorepo with the following packages:

packages/egg - Main Eggjs framework
examples/helloworld-commonjs - CommonJS example application
examples/helloworld-typescript - TypeScript example application
site - Documentation website

The monorepo uses pnpm catalog mode for centralized dependency management, ensuring consistent versions across all packages.

Development Commands

# Install dependencies for all packages
pnpm install

# Build all packages
pnpm run build

# Test all packages
pnpm run test

# Run specific package commands
pnpm --filter=egg run test
pnpm --filter=@examples/helloworld-typescript run dev
pnpm --filter=site run dev

Local External Services

Some DAL, ORM, Redis, and ecosystem benchmark paths need local MySQL and Redis services. Start the repository-aligned Docker services before running those tests on a clean machine:

utoo run dev:services:start

This starts MySQL 8 and Redis 7, matching the main CI service versions, and creates the databases used by local DAL/ORM/e2e fixtures: test, apple, banana, test_runtime_datasource, test_runtime_dao, test_dal_plugin, test_dal_standalone, cnpmcore, and cnpmcore_unittest.

Useful commands:

utoo run dev:services:status
utoo run dev:services:stop
utoo run dev:services:reset

The default host ports are 127.0.0.1:3306 for MySQL and 127.0.0.1:6379 for Redis. If either port is already used, the start command stops before changing containers. Keep using the existing service if it is compatible with CI, or stop it and run the command again. You can change Docker host ports with EGG_DEV_SERVICES_MYSQL_PORT and EGG_DEV_SERVICES_REDIS_PORT; however, the full DAL/ORM/Redis local test path still expects the default host ports.

Image overrides are available for compatibility checks:

EGG_DEV_SERVICES_MYSQL_IMAGE=mysql:5.7 utoo run dev:services:start
EGG_DEV_SERVICES_REDIS_IMAGE=redis:7 utoo run dev:services:start

Run utoo run dev:services:reset before switching MySQL image families, for example between MySQL 8 and MySQL 5.7, because MySQL data directories are not downgrade-compatible across major versions.

Current hard-coded service assumptions:

Redis plugin fixtures under plugins/redis/test/fixtures/apps/**/config.* use 127.0.0.1:6379; skipped Redis plugin tests become runnable when that port is available.
Session Redis fixtures under plugins/session/test/fixtures/redis-session/config/config.default.js use 127.0.0.1:6379.
DAL runtime tests in tegg/core/dal-runtime/test/DataSource.test.ts and tegg/core/dal-runtime/test/DAO.test.ts use local MySQL on port 3306.
DAL module fixtures in tegg/plugin/dal/test/fixtures/apps/dal-app/modules/dal/module.yml and tegg/standalone/standalone/test/fixtures/dal-*/module.yml use local MySQL on port 3306.
ORM fixtures in tegg/plugin/orm/test/fixtures/prepare.js and tegg/plugin/orm/test/fixtures/apps/orm-app/config/config.default.ts use local MySQL on port 3306.

Documentations

Contributors

How to Contribute

Please let us know how can we help. Do check out issues for bug reports or suggestions first.

To become a contributor, please follow our contributing guide, and review the repository guidelines for day-to-day development tips.

Sponsors and Backers

License

MIT