@equinor/fusion-framework-dev-server 2.0.19 → 2.1.0-next.2

package/CHANGELOG.md

@@ -1,10 +1,45 @@
 # @equinor/fusion-framework-dev-server
 
-## 2.0.19
+## 2.1.0-next.2
+
+### Minor Changes
+
+- 09a9bcc: Expose `DevServerOptions` as an interface so optional development tooling can add typed
+  configuration through TypeScript module augmentation.
+
+### Patch Changes
+
+- 09a9bcc: Proxy mock services advertised through `<service>.localhost` via plain `localhost` while preserving
+  the service-key path. This avoids `ENOTFOUND` failures on Linux runners without changing normal
+  upstream service proxying.
+- Updated dependencies [09a9bcc]
+- Updated dependencies [09a9bcc]
+  - @equinor/fusion-framework-vite-plugin-api-service@2.0.6-next.1
+  - @equinor/fusion-framework-vite-plugin-spa@4.1.0-next.2
+
+## 2.0.19-next.1
 
 ### Patch Changes
 
-- @equinor/fusion-framework-vite-plugin-spa@4.0.17
+- @equinor/fusion-framework-vite-plugin-spa@4.0.17-next.1
+
+## 2.0.19-next.0
+
+### Patch Changes
+
+- e8aae1f: Internal: publish every package on the `next` pre-release tag so the whole framework can be installed as a coherent set.
+
+  Packages without their own changes are bumped only to receive a `-next.N` version and the `next` dist-tag on npm. Install with:
+
+  ```bash
+  pnpm add @equinor/fusion-framework-react-app@next
+  ```
+
+- Updated dependencies [e8aae1f]
+- Updated dependencies [2836e0b]
+  - @equinor/fusion-framework-vite-plugin-api-service@2.0.6-next.0
+  - @equinor/fusion-framework-vite-plugin-spa@4.0.17-next.0
+  - @equinor/fusion-log@2.0.3-next.0
 
 ## 2.0.18
 

package/README.md

@@ -1,495 +1,105 @@
-# Fusion Framework Dev Server
+# @equinor/fusion-framework-dev-server
 
-A powerful development server for Fusion Framework applications, built on Vite with integrated service discovery, API proxying, and portal support.
+Development server primitives for Fusion Framework applications. The package combines Vite,
+React Fast Refresh, SPA environment injection, Fusion service discovery, and local API proxying.
 
-## Features
+> [!TIP]
+> Most application developers should start with `ffc app dev`. Use this package directly when you
+> are building framework tooling, a custom development command, or a Vite integration that needs
+> control over server creation.
 
-- 🚀 **Fast Development**: Powered by Vite for lightning-fast HMR and builds
-- 🔗 **Service Discovery**: Automatic API service discovery and proxying
-- 🏠 **Portal Support**: Built-in portal development with manifest loading
-- 🔧 **API Mocking**: Easy mocking and overriding of API responses
-- 📊 **Telemetry**: Integrated logging and debugging capabilities
-- ⚙️ **Flexible Configuration**: Extensive customization options
+## Choose your entry point
 
-## Quick Start
+| Goal | Start here |
+| --- | --- |
+| Run a Fusion application locally | `ffc app dev` from `@equinor/fusion-framework-cli` |
+| Create and start a configured Vite server | `createDevServer(options, overrides?)` |
+| Generate Vite configuration without starting a server | `createDevServerConfig(options, overrides?)` |
+| Customize service discovery proxy routes | `processServices(data, args)` |
+| Develop against local OpenAPI mocks | [`@equinor/fusion-framework-cli-plugin-mock-server`](../cli-plugins/mock-server/README.md) |
 
-Here's the minimal setup to get a Fusion Framework dev server running:
+## Quick start
 
-```typescript
-import { createDevServer } from '@equinor/fusion-framework-dev-server';
-
-const devServer = await createDevServer({
-  spa: {
-    templateEnv: {
-      portal: {
-        id: '@equinor/fusion-framework-dev-portal',
-      },
-      title: 'My Fusion App',
-      serviceDiscovery: {
-        url: 'https://service-discovery.example.com',
-        scopes: ['api://example.com/user_impersonation'],
-      },
-      msal: {
-        clientId: 'your-client-id',
-        tenantId: 'your-tenant-id',
-        redirectUri: '/authentication/login-callback',
-        requiresAuth: 'true',
-      },
-    },
-  },
-  api: {
-    serviceDiscoveryUrl: 'https://service-discovery.example.com',
-  },
-});
-
-await devServer.listen();
-devServer.printUrls();
-```
-
-If you only need the Vite configuration object without starting the server, use `createDevServerConfig(options, overrides?)` instead. This returns a `UserConfig` that you can pass to Vite directly or merge with other configurations.
-
-## Configuration
-
-The dev server accepts a configuration object with the following structure:
-
-### SPA Configuration
-
-Configure the Single Page Application environment and template generation:
-
-```typescript
-{
-  spa: {
-    templateEnv: {
-      // Portal configuration
-      portal: {
-        id: 'your-portal-id', // Portal identifier
-      },
-
-      // Application title
-      title: 'My Application',
-
-      // Service discovery settings (SPA-side — tells the browser where to find services)
-      // The API-side counterpart is `api.serviceDiscoveryUrl` which sets up server-side proxying.
-      // During development you can redirect individual services to local URLs by storing
-      // overrides in sessionStorage under the key "overriddenServiceDiscoveryUrls".
-      serviceDiscovery: {
-        url: 'https://service-discovery.example.com',
-        scopes: ['scope1', 'scope2'],
-      },
-
-      // Authentication configuration
-      msal: {
-        clientId: 'your-client-id',
-        tenantId: 'your-tenant-id',
-        redirectUri: '/authentication/login-callback',
-        requiresAuth: 'true', // or 'false'
-      },
-
-      // Optional telemetry configuration (browser console logging)
-      telemetry: {
-        consoleLevel: 1, // 0=Debug, 1=Information, 2=Warning, 3=Error, 4=Critical
-      },
-
-      // Optional service worker configuration
-      serviceWorker: {
-        resources: [
-          {
-            url: '/api',
-            rewrite: '/api-v1',
-            scopes: ['api://example.com/user_impersonation'],
-          },
-        ],
-      },
-    },
-  },
-}
-```
-
-### API Configuration
-
-Configure API proxying and service discovery:
-
-```typescript
-{
-  api: {
-    // Required: Service discovery endpoint
-    serviceDiscoveryUrl: 'https://service-discovery.example.com',
-
-    // Optional: Custom service processing
-    // Takes an array of FusionService objects ({ key, uri, name }) from discovery
-    // and returns { data: FusionService[], routes: ApiRoute[] } with proxy routes.
-    processServices: (services, route) => {
-      // Process and return services with routes
-      return processServices(services, route);
-    },
-
-    // Optional: Additional API routes
-    routes: [
-      {
-        match: '/api/custom/*',
-        middleware: (req, res) => {
-          // Custom middleware logic
-          res.end(JSON.stringify({ custom: 'response' }));
-        },
-      },
-    ],
-  },
-}
-```
-
-### Logging Configuration
-
-Configure CLI/server-side logging levels and custom loggers:
-
-```typescript
-{
-  log: {
-    // Optional: CLI log level (0=None, 1=Error, 2=Warning, 3=Info, 4=Debug)
-    level: 3, // Default is Info level
-
-    // Optional: Custom logger instance
-    logger: new ConsoleLogger('my-dev-server'),
-  },
-}
-```
-
-> [!NOTE]
-> **Telemetry vs CLI Logging**: The `telemetry.consoleLevel` controls logging output in the browser console (visible to end users), while `log.level` controls server-side logging in the terminal/command line (visible to developers). These use different logging systems with different level mappings.
-
-### Main Functions
-
-#### `createDevServer(options, overrides?)`
-
-Creates and configures a development server instance.
-
-**Parameters:**
-- `options` (`DevServerOptions`): Configuration object for the dev server
-- `overrides` (`UserConfig`): Optional Vite configuration overrides
-
-**Returns:** `Promise<ViteDevServer>` - Configured Vite development server
-
-**Example:**
-```typescript
-const devServer = await createDevServer(config);
-await devServer.listen();
-```
-
-#### `createDevServerConfig(options, overrides?)`
-
-Creates a Vite configuration object for the dev server.
-
-**Parameters:**
-- `options` (`DevServerOptions`): Configuration object for the dev server
-- `overrides` (`UserConfig`): Optional Vite configuration overrides
-
-**Returns:** `UserConfig` - Vite configuration object
-
-### Utility Functions
-
-#### `processServices(data, args)`
-
-Processes service discovery data and generates proxy routes.
-
-**Parameters:**
-- `data` (`FusionService[]`): Array of services from service discovery
-- `args.route` (`string`): Base route for proxying
-- `args.request` (`IncomingMessage`): HTTP request object
-
-**Returns:** Object with processed services and routes
-
-### Types
-
-#### `DevServerOptions<TEnv>`
-
-Configuration options for the development server.
-
-```typescript
-type DevServerOptions<TEnv extends Partial<FusionTemplateEnv>> = {
-  spa?: {
-    templateEnv: TEnv | TemplateEnvFn<TEnv>;
-  };
-  api: {
-    serviceDiscoveryUrl: string;
-    processServices?: ApiDataProcessor<FusionService[]>;
-    routes?: ApiRoute[];
-  };
-  log?: {
-    level?: number;
-    logger?: ConsoleLogger;
-  };
-};
+```sh
+pnpm add -D @equinor/fusion-framework-dev-server vite
 ```
 
-#### `FusionService`
-
-Represents a service in the Fusion ecosystem.
-
-```typescript
-type FusionService = {
-  key: string;    // Service identifier
-  uri: string;    // Service endpoint URL
-  name: string;   // Human-readable service name
-};
-```
-
-## Examples
-
-### Basic Portal Development
-
 ```typescript
 import { createDevServer } from '@equinor/fusion-framework-dev-server';
 
-const devServer = await createDevServer({
+const server = await createDevServer({
   spa: {
     templateEnv: {
       portal: { id: 'my-portal' },
-      title: 'My Portal',
+      title: 'My application',
       serviceDiscovery: {
         url: 'https://service-discovery.example.com',
         scopes: ['api://example.com/user_impersonation'],
       },
       msal: {
-        clientId: process.env.CLIENT_ID!,
-        tenantId: process.env.TENANT_ID!,
+        clientId: 'client-id',
+        tenantId: 'tenant-id',
         redirectUri: '/authentication/login-callback',
         requiresAuth: 'true',
       },
     },
   },
-  api: {
-    serviceDiscoveryUrl: 'https://service-discovery.example.com',
-  },
-});
-
-await devServer.listen();
-```
-
-### Adding Mock Services
-
-```typescript
-import { createDevServer, processServices } from '@equinor/fusion-framework-dev-server';
-
-const devServer = await createDevServer({
-  spa: { /* ... spa config ... */ },
-  api: {
-    serviceDiscoveryUrl: 'https://service-discovery.example.com',
-    processServices: (data, route) => {
-      const { data: services, routes } = processServices(data, route);
-
-      // Add mock services
-      return {
-        data: services.concat({
-          key: 'mock-api',
-          name: 'Mock API Service',
-          uri: '/mock-api',
-        }),
-        routes: routes.concat({
-          match: '/mock-api/*',
-          middleware: (req, res) => {
-            res.setHeader('Content-Type', 'application/json');
-            res.end(JSON.stringify({ mock: 'data' }));
-          },
-        }),
-      };
-    },
-  },
-});
-```
-
-### Custom Vite Configuration
-
-```typescript
-import { createDevServer } from '@equinor/fusion-framework-dev-server';
-import { defineConfig } from 'vite';
-
-const devServer = await createDevServer(
-  { /* ... dev server config ... */ },
-  defineConfig({
-    server: {
-      port: 3001,
-      host: '0.0.0.0',
-    },
-    define: {
-      __DEV__: true,
-    },
-  })
-);
-```
-
-
-## Troubleshooting
-
-### Common Issues
-
-#### "Cannot find module '@equinor/fusion-framework-dev-server'"
-
-**Solution:** Make sure the package is installed and you're using the correct import path.
-
-```bash
-pnpm add -D @equinor/fusion-framework-dev-server
-```
-
-#### Service Discovery Connection Failed
-
-**Problem:** The dev server can't connect to the service discovery endpoint.
-
-**Solutions:**
-1. Check that `serviceDiscoveryUrl` is correct and accessible
-2. Verify network connectivity to the service discovery endpoint
-3. Check for authentication requirements
-
-#### Portal Manifest Not Loading
-
-**Problem:** Portal configuration isn't loading properly.
-
-**Solutions:**
-1. Verify the portal ID is correct in the `spa.templateEnv.portal.id` field
-2. Check that the portal service is available and responding
-3. Ensure proper authentication is configured
-
-#### API Routes Not Working
-
-**Problem:** Custom API routes or service proxying isn't functioning.
-
-**Solutions:**
-1. Check the `routes` configuration in the `api` section
-2. Verify route patterns match the expected request paths
-3. Ensure middleware functions are properly implemented
-4. Check for conflicts with existing routes
-
-#### Authentication Issues
-
-**Problem:** MSAL authentication isn't working.
-
-**Solutions:**
-1. Verify `clientId` and `tenantId` are correct
-2. Check that `redirectUri` matches your application configuration
-3. Ensure the required scopes are properly configured
-4. Check browser console for authentication errors
-
-### Debug Logging
-
-Enable debug logging to troubleshoot issues:
-
-#### CLI/Server-Side Debug Logging
-```typescript
-const devServer = await createDevServer({
-  // ... config
-  log: {
-    level: 4, // Debug level (0=None, 1=Error, 2=Warning, 3=Info, 4=Debug)
-  },
+  api: { serviceDiscoveryUrl: 'https://service-discovery.example.com' },
 });
-```
 
-#### Browser Console Telemetry Logging
-```typescript
-{
-  spa: {
-    templateEnv: {
-      // ... other config
-      telemetry: {
-        consoleLevel: 0, // Debug level (0=Debug, 1=Information, 2=Warning, 3=Error, 4=Critical)
-      },
-    },
-  },
-}
+await server.listen();
+server.printUrls();
 ```
 
-## Advanced Usage
+The browser receives `spa.templateEnv`. The Node development server uses
+`api.serviceDiscoveryUrl` to fetch service definitions and create same-origin proxy routes. These
+two URLs often point to the same endpoint, but they serve different consumers.
 
-### Custom Service Processing
+Continue with [Getting started](docs/getting-started.md) for the complete mental model.
 
-For advanced service discovery manipulation:
+## Mock APIs locally
 
-```typescript
-import { createDevServer, processServices } from '@equinor/fusion-framework-dev-server';
+Install the optional mock-server plugin when a backend is unavailable, unstable, or needs
+deterministic responses:
 
-const devServer = await createDevServer({
-  api: {
-    serviceDiscoveryUrl: 'https://service-discovery.example.com',
-    processServices: (services, route) => {
-      const { data, routes } = processServices(services, route);
-
-      // Filter out development-only services in production
-      const filteredData = data.filter(service =>
-        process.env.NODE_ENV !== 'production' || !service.key.includes('dev')
-      );
-
-      // Add custom routes for specific services
-      const customRoutes = routes.map(route => ({
-        ...route,
-        // Add custom headers or modify proxy behavior
-      }));
-
-      return { data: filteredData, routes: customRoutes };
-    },
-  },
-});
-```
-
-### Integration with Build Tools
-
-The dev server works seamlessly with the Fusion Framework CLI:
-
-```bash
-# Use with CLI for automatic configuration
-npx @equinor/fusion-framework-cli app dev
-
-# Or portal development
-npx @equinor/fusion-framework-cli portal dev
+```sh
+pnpm add -D @equinor/fusion-framework-cli-plugin-mock-server
+ffc mock-server ./mocks --port 4010
 ```
 
-### Custom Plugins
+> [!IMPORTANT]
+> `ffc mock-server` is a standalone foreground process. Installing the plugin does not start it
+> with `ffc app dev`; the developer or test runner owns its lifecycle.
 
-Extend the dev server with custom Vite plugins:
-
-```typescript
-import { createDevServer } from '@equinor/fusion-framework-dev-server';
-import myCustomPlugin from 'my-custom-vite-plugin';
-
-const devServer = await createDevServer(
-  { /* ... config ... */ },
-  {
-    plugins: [myCustomPlugin()],
-  }
-);
-```
+The plugin adds typed `mockServer` settings to `DevServerOptions` only when its types are imported,
+keeping this base package independent of optional mocking tools.
 
-## Migration Guide
+See [Develop with mock services](docs/mocking.md) for normal development overlays, isolated
+`--mock` mode, direct-only services, and executable `<name>.mock.ts` modules.
 
-### From Direct Vite Usage
+## Learn in order
 
-If you're migrating from a direct Vite setup:
+1. [Getting started](docs/getting-started.md) explains the server lifecycle and smallest useful setup.
+2. [Configure the dev server](docs/configuration.md) covers SPA environment, API proxying, and logging.
+3. [Develop with mock services](docs/mocking.md) shows the recommended optional mocking workflow.
+4. [Advanced usage](docs/advanced.md) covers service processing, routes, Vite overrides, and extension interfaces.
+5. [Troubleshooting](docs/troubleshooting.md) maps common symptoms to the responsible configuration.
 
-1. Replace your Vite configuration with the dev server configuration
-2. Move service discovery logic to the `api.processServices` function
-3. Configure portal settings in `spa.templateEnv`
-4. Update your start script to use `createDevServer`
+## Public API
 
-**Before:**
-```typescript
-// vite.config.ts
-export default defineConfig({
-  plugins: [react(), /* other plugins */],
-  server: {
-    proxy: { /* proxy config */ },
-  },
-});
-```
-
-**After:**
-```typescript
-import { createDevServer } from '@equinor/fusion-framework-dev-server';
-
-const devServer = await createDevServer({
-  // Move your config here
-});
-```
+- `createDevServer` creates a configured `ViteDevServer`. Call `listen()` yourself.
+- `createDevServerConfig` returns a Vite `UserConfig` for another tool to consume.
+- `processServices` rewrites discovered service URIs through the local proxy and returns routes.
+- `DevServerOptions<TEnv>` configures SPA injection, API discovery, and logging. It is an interface so optional plugins can augment it.
+- `FusionService` describes a backend using `key`, `uri`, `name`, and optional OAuth `scopes`.
 
-## Contributing
+## Requirements and boundaries
 
-This package is part of the Fusion Framework monorepo. See the main [contributing guide](../../CONTRIBUTING.md) for details.
+- Vite 7 or 8 is required as a peer dependency.
+- `api.serviceDiscoveryUrl` is required by the low-level API.
+- The package configures development; it does not build or publish applications.
+- Mock-server installation and process lifecycle are optional and external to this package.
 
 ## License
 
-ISC
+ISC

package/dist/esm/process-services.js

@@ -69,14 +69,22 @@ export const processServices = (data, args) => {
         // and replace the path with the local proxy path
         const serviceUrl = new URL(`${route}/${service.key}`, request.headers.referer);
         apiServices.push({ ...service, uri: String(serviceUrl) });
-        // add the proxy route
+        // Add the proxy route for this service.
         const url = new URL(service.uri);
+        const usesLocalhostSubdomain = url.hostname.endsWith('.localhost');
+        // Node does not resolve localhost subdomains consistently across operating systems. The mock
+        // server also accepts /<service>/* on plain localhost, so proxy through that portable address.
+        if (usesLocalhostSubdomain) {
+            url.hostname = 'localhost';
+        }
         apiRoutes.push({
             match: `/${service.key}${url.pathname}*sub`,
-            proxy: {
-                target: url.origin,
-                rewrite: (path) => path.replace(`/${service.key}`, ''),
-            },
+            proxy: usesLocalhostSubdomain
+                ? { target: url.origin }
+                : {
+                    target: url.origin,
+                    rewrite: (path) => path.replace(`/${service.key}`, ''),
+                },
         });
     }
     return { data: apiServices, routes: apiRoutes };

package/dist/esm/process-services.js.map

@@ -1 +1 @@
-{"version":3,"file":"process-services.js","sourceRoot":"","sources":["../../src/process-services.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;IAC/E,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,MAAM,SAAS,GAAG,EAAgB,CAAC;IACnC,MAAM,WAAW,GAAG,EAAqB,CAAC;IAE1C,6EAA6E;IAC7E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,oDAAoD;IACpD,gCAAgC;IAChC,KAAK,MAAM,OAAO,IAAI,IAAuB,EAAE,CAAC;QAC9C,oDAAoD;QACpD,iDAAiD;QACjD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/E,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAE1D,sBAAsB;QACtB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,SAAS,CAAC,IAAI,CAAC;YACb,KAAK,EAAE,IAAI,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,QAAQ,MAAM;YAC3C,KAAK,EAAE;gBACL,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC;aACvD;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAClD,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"process-services.js","sourceRoot":"","sources":["../../src/process-services.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;IAC/E,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,MAAM,SAAS,GAAG,EAAgB,CAAC;IACnC,MAAM,WAAW,GAAG,EAAqB,CAAC;IAE1C,6EAA6E;IAC7E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,oDAAoD;IACpD,gCAAgC;IAChC,KAAK,MAAM,OAAO,IAAI,IAAuB,EAAE,CAAC;QAC9C,oDAAoD;QACpD,iDAAiD;QACjD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/E,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAE1D,wCAAwC;QACxC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,sBAAsB,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACnE,6FAA6F;QAC7F,+FAA+F;QAC/F,IAAI,sBAAsB,EAAE,CAAC;YAC3B,GAAG,CAAC,QAAQ,GAAG,WAAW,CAAC;QAC7B,CAAC;QACD,SAAS,CAAC,IAAI,CAAC;YACb,KAAK,EAAE,IAAI,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,QAAQ,MAAM;YAC3C,KAAK,EAAE,sBAAsB;gBAC3B,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE;gBACxB,CAAC,CAAC;oBACE,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC;iBACvD;SACN,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAClD,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/esm/process-services.test.js

@@ -0,0 +1,24 @@
+import { IncomingMessage } from 'node:http';
+import { Socket } from 'node:net';
+import { describe, expect, it } from 'vitest';
+import { processServices } from './process-services.js';
+const request = new IncomingMessage(new Socket());
+request.headers.referer = 'http://localhost:3000';
+describe('processServices', () => {
+    it('proxies localhost subdomains through the portable shared-host route', () => {
+        const result = processServices([{ key: 'people', name: 'People', uri: 'http://people.localhost:4010' }], { route: '/@fusion-api', request });
+        expect(result.routes).toEqual([
+            {
+                match: '/people/*sub',
+                proxy: { target: 'http://localhost:4010' },
+            },
+        ]);
+    });
+    it('preserves normal upstream proxy targets and path rewriting', () => {
+        const result = processServices([{ key: 'people', name: 'People', uri: 'https://people.example/api' }], { route: '/@fusion-api', request });
+        const [route] = result.routes ?? [];
+        expect(route?.proxy?.target).toBe('https://people.example');
+        expect(route?.proxy?.rewrite?.('/people/api/persons')).toBe('/api/persons');
+    });
+});
+//# sourceMappingURL=process-services.test.js.map

package/dist/esm/process-services.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-services.test.js","sourceRoot":"","sources":["../../src/process-services.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;AAClD,OAAO,CAAC,OAAO,CAAC,OAAO,GAAG,uBAAuB,CAAC;AAElD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,MAAM,GAAG,eAAe,CAC5B,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,8BAA8B,EAAE,CAAC,EACxE,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,CACnC,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YAC5B;gBACE,KAAK,EAAE,cAAc;gBACrB,KAAK,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE;aAC3C;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,MAAM,GAAG,eAAe,CAC5B,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,4BAA4B,EAAE,CAAC,EACtE,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,CACnC,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;QAEpC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '2.0.19';
+export const version = '2.1.0-next.2';
 //# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG,cAAc,CAAC"}