@nestbridge/webpack 2.1.4 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @nestbridge/webpack
 
+## 2.2.0
+
+### Minor Changes
+
+- 98349c7: One client can now use controllers from several NestJS apps. `nestBridge()` accepts an array of options, one entry per app, and each entry takes its own `name`, `root`, `controllers`, `resolvers`, `baseURL`, `bootstrap`, `globalPrefix` and `versioning`. A named app writes its declarations to `<outputDir>/<name>/`, detects its own response wrapper and error body from its own bootstrap file, and tags every generated request with its `name` as the `service`. A single object still works as before.
+  
+  The runtime picks each request's origin from `configureNestBridge({ services })`, then the origin the plugin registered for that app with the new `setNestBridgeServiceBaseURL(name, baseURL)`, then the global `setNestBridgeBaseURL()` value. `graphqlEndpoint` also accepts a record with one endpoint per app.
+  
+  `@Controller({ path, version })` and `@Version(...)` are now read, and the global prefix (`setGlobalPrefix`, including `exclude`) and URI versioning (`enableVersioning`) are detected from the bootstrap file and composed into every request path with the new `detectGlobalPrefix`, `detectVersioning` and `applyApplicationRouting` from `@nestbridge/core`. A prefix or versioning setup that cannot be read statically is reported as an `unsupported-global-prefix` or `unsupported-versioning` diagnostic; the `globalPrefix` and `versioning` plugin options state the value explicitly, and `false` ignores it.
+  
+  Upgrading: the global prefix and URI versioning are now part of every URL, so a prefix that was written into `baseURL` as a workaround would now be repeated. Keep `baseURL` to the origin, or set `globalPrefix: false` / `versioning: false`. A relative `root` now resolves against the bundler's root instead of `process.cwd()`. See `MIGRATION.md`.
+
+### Patch Changes
+
+- Updated dependencies [98349c7]
+  - @nestbridge/unplugin@2.2.0
+
 ## 2.1.4
 
 ### Patch Changes

package/README.md

@@ -79,24 +79,75 @@ the project root automatically, so it defaults to `process.cwd()`. Pass an
 explicit `root` if `webpack.config.js` runs from somewhere other than the
 directory your `controllers`/`resolvers` globs are relative to.
 
+## Several server apps
+
+To use controllers from more than one NestJS app, pass an array — one entry per
+app. Each entry needs a `name`, and its `root` should be that app's folder:
+
+```js
+nestBridge([
+  {
+    name: 'identity',
+    root: '../identity',
+    controllers: 'src/**/*.controller.ts',
+    baseURL: 'https://identity.example.com',
+  },
+  {
+    name: 'store',
+    root: '../store',
+    controllers: 'src/**/*.controller.ts',
+    baseURL: 'https://store.example.com',
+  },
+]);
+```
+
+A relative `root` resolves against `process.cwd()`. Declarations land in
+`<outputDir>/<name>/`, so add one `resolve.alias` and one `paths` entry per app
+(`"@identity/*": ["./.nestbridge/identity/src/*"]`), and each app keeps its own
+`baseURL`, bootstrap file, global prefix and versioning. See
+[Several server apps](../../README.md#several-server-apps) in the repository
+README, and [`MIGRATION.md`](../../MIGRATION.md) when upgrading from 2.1.
+
 ## `NestBridgeOptions`
 
 ```ts
 interface NestBridgeOptions {
-  controllers: string | string[]; // glob(s), resolved relative to `root`
-  resolvers?: string | string[];   // glob(s) for GraphQL resolvers; defaults to none
-  baseURL?: string;                // prefix for REST requests and the default GraphQL endpoint; applied to the runtime automatically
-  debug?: boolean;                 // logs discovery/analysis/watch activity
+  name?: string;                    // names the server app; required, and unique, when you pass several apps
+  controllers: string | string[];   // glob(s), resolved relative to `root`
+  resolvers?: string | string[];    // glob(s) for GraphQL resolvers; defaults to none
+  baseURL?: string;                 // origin (or mount path) for this app's REST requests and its default GraphQL endpoint; applied to the runtime automatically
+  bootstrap?: string;               // the app's bootstrap file, relative to `root`; skips the `main.ts` search
+  globalPrefix?: string | GlobalPrefixOption | false; // replaces the prefix read from `setGlobalPrefix()`; `false` ignores it
+  versioning?: VersioningOption | false;              // replaces the versioning read from `enableVersioning()`; `false` ignores it
+  debug?: boolean;                  // logs discovery/analysis/watch activity
   outputDir?: string;               // defaults to ".nestbridge", resolved from webpack's `context` — independent of `root`
-  root?: string;                    // defaults to process.cwd()
+  root?: string;                    // base for discovering controllers/resolvers and the bootstrap file; relative paths resolve against process.cwd(), which is also the default
+}
+
+interface GlobalPrefixOption {
+  prefix: string;
+  exclude?: (string | { path: string; httpMethod?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' })[];
+}
+
+interface VersioningOption {
+  prefix?: string;                  // defaults to "v"; use "" for none
+  defaultVersion?: string;          // version of routes that state none
 }
 ```
 
+`nestBridge()` takes a `NestBridgeOptions` object, or an array of them
+(`NestBridgePluginOptions`). All of these types are exported.
+
 `baseURL` needs no extra runtime code: the plugin generates a module that
-calls `setNestBridgeBaseURL(baseURL)` from `nestbridge`, and every generated
-controller and resolver module imports it. Use `configureNestBridge` from
-`nestbridge` only for headers, a custom `fetch`, or an explicit
-`graphqlEndpoint`.
+calls `setNestBridgeBaseURL(baseURL)` from `nestbridge` (or
+`setNestBridgeServiceBaseURL(name, baseURL)` for a named app), and every
+generated controller and resolver module imports it. Use `configureNestBridge`
+from `nestbridge` only for headers, a custom `fetch`, an explicit
+`graphqlEndpoint`, or per-environment `services` origins.
+
+The global prefix and URI versioning that the app's bootstrap file sets are
+read statically and added to every request path, so keep `baseURL` to the
+origin — see [Global prefix and URI versioning](../../README.md#global-prefix-and-uri-versioning).
 
 ## License
 

package/build/nestbridge.webpack.d.ts

@@ -1,10 +1,10 @@
-import { NestBridgeOptions, NestBridgeOptions as NestBridgeOptions$1 } from "@nestbridge/unplugin";
+import { GlobalPrefixOption, NestBridgeOptions, NestBridgePluginOptions, NestBridgePluginOptions as NestBridgePluginOptions$1, VersioningOption } from "@nestbridge/unplugin";
 import { WebpackPluginInstance } from "webpack";
 //#region src/version.d.ts
 export declare const VERSION: string;
 //#endregion
 //#region src/main.d.ts
-export declare const nestBridge: (options: NestBridgeOptions$1) => WebpackPluginInstance;
+export declare const nestBridge: (options: NestBridgePluginOptions$1) => WebpackPluginInstance;
 //#endregion
-export type { NestBridgeOptions };
+export type { GlobalPrefixOption, NestBridgeOptions, NestBridgePluginOptions, VersioningOption };
 //# sourceMappingURL=nestbridge.webpack.d.ts.map

package/build/nestbridge.webpack.js

@@ -1,7 +1,7 @@
 import { nestBridgeUnplugin } from "@nestbridge/unplugin";
 //#endregion
 //#region src/version.ts
-var VERSION = "2.1.4";
+var VERSION = "2.2.0";
 //#endregion
 //#region src/main.ts
 var nestBridge = nestBridgeUnplugin.webpack;

package/build/nestbridge.webpack.js.map

@@ -1 +1 @@
-{"version":3,"file":"nestbridge.webpack.js","names":[],"sources":["../package.json","../src/version.ts","../src/main.ts"],"sourcesContent":["{\n  \"name\": \"@nestbridge/webpack\",\n  \"version\": \"2.1.4\",\n  \"type\": \"module\",\n  \"license\": \"MIT\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/MDReal32/nestbridge.git\",\n    \"directory\": \"packages/webpack\"\n  },\n  \"main\": \"./build/nestbridge.webpack.js\",\n  \"types\": \"./build/nestbridge.webpack.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./build/nestbridge.webpack.d.ts\",\n      \"import\": \"./build/nestbridge.webpack.js\"\n    }\n  },\n  \"files\": [\n    \"build\"\n  ],\n  \"scripts\": {\n    \"build\": \"vite build\",\n    \"test\": \"vitest run\",\n    \"typecheck\": \"tsc -p tsconfig.json --noEmit\",\n    \"lint\": \"biome check .\"\n  },\n  \"dependencies\": {\n    \"@nestbridge/unplugin\": \"workspace:*\"\n  },\n  \"devDependencies\": {\n    \"@types/node\": \"^26.4.1\",\n    \"esbuild-loader\": \"^4.5.0\",\n    \"rolldown-plugin-dts\": \"^0.28.5\",\n    \"typescript\": \"^7.0.2\",\n    \"vite\": \"^8.2.2\",\n    \"vitest\": \"^5.0.0\",\n    \"webpack\": \"^5.110.3\"\n  },\n  \"peerDependencies\": {\n    \"webpack\": \"^5.110.3\"\n  }\n}\n","import { version } from '../package.json';\n\nexport const VERSION: string = version;\n","import { type NestBridgeOptions, nestBridgeUnplugin } from '@nestbridge/unplugin';\nimport type { WebpackPluginInstance } from 'webpack';\n\nexport type { NestBridgeOptions } from '@nestbridge/unplugin';\nexport const nestBridge: (options: NestBridgeOptions) => WebpackPluginInstance =\n  nestBridgeUnplugin.webpack;\nexport { VERSION } from './version';\n"],"mappings":";;;ACEA,IAAa,UAAkB;;;ACE/B,IAAa,aACX,mBAAmB"}
+{"version":3,"file":"nestbridge.webpack.js","names":[],"sources":["../package.json","../src/version.ts","../src/main.ts"],"sourcesContent":["{\n  \"name\": \"@nestbridge/webpack\",\n  \"version\": \"2.2.0\",\n  \"type\": \"module\",\n  \"license\": \"MIT\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/MDReal32/nestbridge.git\",\n    \"directory\": \"packages/webpack\"\n  },\n  \"main\": \"./build/nestbridge.webpack.js\",\n  \"types\": \"./build/nestbridge.webpack.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./build/nestbridge.webpack.d.ts\",\n      \"import\": \"./build/nestbridge.webpack.js\"\n    }\n  },\n  \"files\": [\n    \"build\"\n  ],\n  \"scripts\": {\n    \"build\": \"vite build\",\n    \"test\": \"vitest run\",\n    \"typecheck\": \"tsc -p tsconfig.json --noEmit\",\n    \"lint\": \"biome check .\"\n  },\n  \"dependencies\": {\n    \"@nestbridge/unplugin\": \"workspace:*\"\n  },\n  \"devDependencies\": {\n    \"@types/node\": \"^26.4.1\",\n    \"esbuild-loader\": \"^4.5.0\",\n    \"rolldown-plugin-dts\": \"^0.28.5\",\n    \"typescript\": \"^7.0.2\",\n    \"vite\": \"^8.2.2\",\n    \"vitest\": \"^5.0.0\",\n    \"webpack\": \"^5.110.3\"\n  },\n  \"peerDependencies\": {\n    \"webpack\": \"^5.110.3\"\n  }\n}\n","import { version } from '../package.json';\n\nexport const VERSION: string = version;\n","import { type NestBridgePluginOptions, nestBridgeUnplugin } from '@nestbridge/unplugin';\nimport type { WebpackPluginInstance } from 'webpack';\n\nexport type {\n  GlobalPrefixOption,\n  NestBridgeOptions,\n  NestBridgePluginOptions,\n  VersioningOption,\n} from '@nestbridge/unplugin';\nexport const nestBridge: (options: NestBridgePluginOptions) => WebpackPluginInstance =\n  nestBridgeUnplugin.webpack;\nexport { VERSION } from './version';\n"],"mappings":";;;ACEA,IAAa,UAAkB;;;ACO/B,IAAa,aACX,mBAAmB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestbridge/webpack",
-  "version": "2.1.4",
+  "version": "2.2.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -26,7 +26,7 @@
     "lint": "biome check ."
   },
   "dependencies": {
-    "@nestbridge/unplugin": "2.1.4"
+    "@nestbridge/unplugin": "2.2.0"
   },
   "devDependencies": {
     "@types/node": "^26.4.1",