CodeVetter · Repo Unpack · System map

nestjs/nest

Scanned commit 35142c3eca dated 2026-10-02 — last upstream commit. Generated by codevetter codevetter 1.15.0 on 2026-10-02. Deep analysis by cli:codex via the codex CLI on 2026-10-02 (runtime not recorded). Source inspection; upstream code and tests were not executed.

The repository is a framework monorepo with independently published packages and application examples. Core owns module discovery, dependency construction, application lifecycle, and route execution. Platform packages provide native HTTP implementations, while optional packages supply messaging and sockets. npm scripts and CircleCI describe compilation and verification, with package publication handled through Lerna.

The root defines npm workspaces over packages/*, while common and core publish ESM index.js entrypoints and internal subpath exports.
package.json#L15-18 packages/common/package.json#L20-27 packages/core/package.json#L7-14
NestFactoryStatic exposes create, createMicroservice, and createApplicationContext for HTTP, transport, and standalone dependency-container runtimes.
packages/core/nest-factory.ts#L89-124 packages/core/nest-factory.ts#L135-165 packages/core/nest-factory.ts#L177-205
HTTP creation defaults to dynamically loading ExpressAdapter; callers can supply an AbstractHttpAdapter.
packages/core/nest-factory.ts#L89-100 packages/core/nest-factory.ts#L330-338
DependenciesScanner discovers module imports and binds global scope; InstanceLoader constructs providers, injectables, and controllers.
packages/core/scanner.ts#L84-102 packages/core/scanner.ts#L130-171 packages/core/injector/instance-loader.ts#L40-59
ServerFactory dispatches Redis, NATS, MQTT, gRPC, Kafka, and RabbitMQ transports, falling back to TCP.
packages/microservices/server/server-factory.ts#L20-41
The inspected persistence example delegates MySQL configuration and repository registration to @nestjs/typeorm rather than storing records in NestContainer.
sample/05-sql-typeorm/src/app.module.ts#L5-18 sample/05-sql-typeorm/src/users/users.module.ts#L7-12 sample/05-sql-typeorm/src/users/users.service.ts#L9-19
Root scripts compile TypeScript project references, relocate built packages, run Vitest, lint with oxlint, and publish through Lerna.
package.json#L20-46
Node.js >=20 is required; TypeScript targets ES2023 with Node16 module resolution and emitted legacy decorator metadata.
packages/core/package.json#L20-22 tsconfig.json#L2-18
CircleCI defines build, unit-test matrix, lint, Docker-backed integration, and sample-build jobs.
.circleci/config.yml#L153-176 .circleci/config.yml#L102-133