vue-ssr-lite 0.1.14 → 0.2.3

package/README.md

@@ -37,15 +37,15 @@ It includes routing, browser hydration, production builds, a managed Node server
 
 | Import | Purpose |
 | --- | --- |
-| `vue-ssr-lite` | `defineSsrApplication`, `defineSsrRuntime`, request context, hydration helpers |
-| `vue-ssr-lite/client` | Browser hydration only |
-| `vue-ssr-lite/server` | Managed Node server, host matching, cookies, response cache |
+| `vue-ssr-lite` | `defineSsrConfig`, `defineSsrApplication`, `useSsrDomain`, request context |
+| `vue-ssr-lite/client` | Browser hydration and SPA mount |
+| `vue-ssr-lite/server` | Managed Node server, config compile, host matching, cookies |
 | `vue-ssr-lite/vite` | Vite plugin that wires HTML templates and virtual client entries |
 
-CLI binary:
+CLI binary (auto-discovers `ssr.config.ts|.mts|.js|.mjs` in the project root):
 
 ```bash
-vue-ssr-lite <dev|build|start> [--root .] [--runtime src/SsrRuntime.ts] [--server-output dist/server/SsrRuntime.js] [--hmr-port 31001]
+vue-ssr-lite <dev|build|start> [--root .] [--config ssr.config.ts] [--server-output dist/server/SsrRuntime.js] [--hmr-port 31001]
 ```
 
 Requires Node.js 20 or newer.
@@ -269,51 +269,63 @@ Create its HTML template:
 
 The SSR browser entry and hydration setup are added automatically.
 
-## 3. Create the Runtime
+## 3. Create `ssr.config.ts`
 
-The runtime tells the package which application should handle each host.
+Every application is one self-contained object: runtime, domain, GraphQL,
+cookies, endpoints, and roles. The library expands domains, matches hosts by
+specificity, and exposes context through `useSsrDomain()`.
 
 ```ts
-// src/SsrRuntime.ts
-import { defineSsrRuntime } from 'vue-ssr-lite'
+// ssr.config.ts
+import { defineSsrConfig } from 'vue-ssr-lite'
+import { websiteApplication } from './src/website/SsrApplication'
 
-import { websiteApplication } from './website/SsrApplication'
-
-export default defineSsrRuntime({
+export default defineSsrConfig({
 	name: 'my-platform',
-
-	entries: [
-		{
-			id: 'dashboard',
-			kind: 'spa',
-			template: 'index.html',
-			hosts: ['app.example.com', 'localhost'],
-		},
-		{
-			id: 'website',
-			kind: 'ssr',
-			template: 'site.html',
-			hosts: ['*'],
-			application: websiteApplication,
-		},
-	],
-
-	defaultEntryId: 'website',
-
+	runtime: process.env.APP_RUNTIME || 'unified',
 	server: {
 		host: '0.0.0.0',
 		port: Number(process.env.PORT || 4173),
-		role: process.env.APP_RUNTIME || 'unified',
-
-		publicConfig: {
-			apiUrl: process.env.PUBLIC_API_URL || 'http://localhost:4000',
+		trustProxy: true,
+	},
+	applications: {
+		dashboard: {
+			spa: true,
+			template: 'index.html',
+			roles: ['unified', 'dashboard'],
+			domain: {
+				development: 'localhost',
+				production: 'app.example.com',
+				mode: 'root-and-subdomains',
+				localAliases: true,
+				expose: { subdomainAs: 'workspace' },
+			},
+		},
+		website: {
+			ssr: websiteApplication,
+			template: 'site.html',
+			roles: ['unified', 'website'],
+			domain: {
+				development: 'shop.localhost',
+				production: 'shop.example.com',
+				mode: 'root-and-subdomains',
+				customDomains: true,
+				expose: { subdomainOrHostnameAs: 'storeDomain' },
+			},
 		},
 	},
 })
 ```
 
-The specific SPA hostname is checked first. The `*` SSR entry handles all remaining hosts.
-`defaultEntryId` is used when no host pattern matches.
+Host ownership is resolved by **specificity**, not application declaration order:
+
+1. Exact hostname
+2. Longest matching wildcard suffix (for example `*.shop.example.com` beats `*.example.com`)
+3. Shorter matching wildcard suffix
+4. Catch-all `*` (from `customDomains: true`)
+5. `defaultApplicationId` when no host pattern matches
+
+Overlapping wildcards are valid. Duplicate exact or identical wildcard patterns across applications are rejected at startup.
 
 When the server starts, the console prints a ready message with a clickable local URL and the active role:
 
@@ -372,8 +384,8 @@ Do not add SPA applications to the `applications` array.
 ```json
 {
 	"scripts": {
-		"dev": "vue-ssr-lite dev --runtime src/SsrRuntime.ts",
-		"build": "vue-ssr-lite build --runtime src/SsrRuntime.ts",
+		"dev": "vue-ssr-lite dev",
+		"build": "vue-ssr-lite build",
 		"start": "vue-ssr-lite start"
 	}
 }
@@ -397,21 +409,18 @@ npm run start
 For a project that only needs SSR:
 
 ```ts
-export default defineSsrRuntime({
+export default defineSsrConfig({
 	name: 'my-website',
-
-	entries: [
-		{
-			id: 'website',
-			kind: 'ssr',
+	applications: {
+		website: {
+			ssr: websiteApplication,
 			template: 'site.html',
-			hosts: ['*'],
-			application: websiteApplication,
+			domain: {
+				development: 'localhost',
+				production: 'example.com',
+				customDomains: true,
+			},
 		},
-	],
-
-	server: {
-		publicConfig: {},
 	},
 })
 ```
@@ -433,23 +442,21 @@ vueSsrLite({
 
 ## SPA-Only Application
 
-A runtime can also serve a normal SPA without an SSR application:
+A config can also serve a normal SPA without an SSR application:
 
 ```ts
-export default defineSsrRuntime({
+export default defineSsrConfig({
 	name: 'my-dashboard',
-
-	entries: [
-		{
-			id: 'dashboard',
-			kind: 'spa',
+	applications: {
+		dashboard: {
+			spa: true,
 			template: 'index.html',
-			hosts: ['*'],
+			domain: {
+				development: 'localhost',
+				production: 'app.example.com',
+				localAliases: true,
+			},
 		},
-	],
-
-	server: {
-		publicConfig: {},
 	},
 })
 ```
@@ -686,31 +693,75 @@ context.response.redirect = {
 
 ## Domain Routing
 
-Exact hostname:
+Domain configuration lives on each application. The library owns normalization
+(ports, trailing dots, IPv4/IPv6 aliases), proxy header handling, environment
+selection (`development` vs `production`), host specificity matching, custom
+domains, context serialization, and hydration.
 
 ```ts
-hosts: ['example.com']
-```
-
-Subdomains:
+import { defineSsrConfig, useSsrDomain } from 'vue-ssr-lite'
 
-```ts
-hosts: ['*.example.com']
+export default defineSsrConfig({
+	name: 'my-platform',
+	runtime: process.env.APP_RUNTIME || 'unified',
+	server: { trustProxy: true },
+	applications: {
+		admin: {
+			spa: true,
+			template: 'index.html',
+			domain: {
+				development: 'localhost',
+				production: process.env.VITE_ROOT_DOMAIN || 'app.example.com',
+				mode: 'root-and-subdomains',
+				localAliases: true,
+				expose: { subdomainAs: 'workspace' },
+			},
+		},
+		website: {
+			ssr: websiteApplication,
+			template: 'site.html',
+			domain: {
+				development: 'shop.localhost',
+				production: process.env.VITE_SHOP_BASE_DOMAIN || 'shop.example.com',
+				mode: 'root-and-subdomains',
+				customDomains: true,
+				expose: { subdomainOrHostnameAs: 'storeDomain' },
+			},
+		},
+	},
+})
 ```
 
-Exact hostname and subdomains:
+Consume the resolved context anywhere (SSR, SPA, endpoints, hydration):
 
 ```ts
-hosts: ['example.com', '*.example.com']
+const domain = useSsrDomain()
+
+domain.entry
+domain.hostname
+domain.baseDomain
+domain.subdomain
+domain.isCustomDomain
+domain.params.workspace
+domain.params.storeDomain
+domain.buildSubdomainUrl('acme', '/dashboard')
 ```
 
-Catch-all:
+### Precedence
 
-```ts
-hosts: ['*']
-```
+| Priority | Pattern | Example winner |
+| --- | --- | --- |
+| 1 | Exact hostname | `shop.localhost` over `*.localhost` |
+| 2 | Longer wildcard suffix | `*.shop.localhost` over `*.localhost` |
+| 3 | Shorter wildcard suffix | `*.localhost` over `*` |
+| 4 | Catch-all `*` | custom domains with no specific rule |
+| 5 | `defaultApplicationId` | only when no pattern matches |
 
-Do not include protocols or paths in host values.
+Overlapping roots such as `*.localhost` and `*.shop.localhost` are supported
+because the longer suffix wins. Duplicate exact/wildcard ownership and multiple
+catch-all (`*`) applications are rejected at startup.
+
+Do not include protocols, paths, query strings, or ports in domain values.
 
 Set `server.trustProxy` to `true` only when the Node process sits behind a trusted reverse proxy. Then `X-Forwarded-Host` and `X-Forwarded-Proto` are used for host matching and absolute URLs. Leave it `false` for direct local traffic.
 
@@ -718,95 +769,60 @@ Set `server.trustProxy` to `true` only when the Node process sits behind a trust
 
 Roles let one codebase and one Docker image run as different process modes.
 
-- Set `server.role` to the active mode for this process.
-- Set `roles` on each entry to list which modes may serve that entry.
-- Omit `roles` (or omit `server.role`) to keep an entry available in every mode.
+- Set top-level `runtime` to the active mode for this process.
+- Set `roles` on each application to list which modes may serve it.
+- Omit `roles` (or omit `runtime`) to keep an application available in every mode.
 
 Role names are application-defined strings. Common patterns:
 
 | Mode | Typical use |
 | --- | --- |
-| `unified` | Local development or a single process that serves every entry |
+| `unified` | Local development or a single process that serves every application |
 | A private role | SPA / admin / back-office only |
 | A public role | SSR website / marketing / storefront only |
 
 Example:
 
 ```ts
-export default defineSsrRuntime({
+export default defineSsrConfig({
 	name: 'my-platform',
-
-	entries: [
-		{
-			id: 'admin',
-			kind: 'spa',
+	runtime: process.env.APP_RUNTIME || 'unified',
+	applications: {
+		admin: {
+			spa: true,
 			template: 'index.html',
-			hosts: ['app.example.com', 'localhost'],
 			roles: ['unified', 'admin'],
+			domain: {
+				development: 'localhost',
+				production: 'app.example.com',
+				mode: 'root-and-subdomains',
+				localAliases: true,
+			},
 		},
-		{
-			id: 'website',
-			kind: 'ssr',
+		website: {
+			ssr: websiteApplication,
 			template: 'site.html',
-			hosts: ['*'],
 			roles: ['unified', 'website'],
-			application: websiteApplication,
+			domain: {
+				development: 'shop.localhost',
+				production: 'shop.example.com',
+				mode: 'root-and-subdomains',
+				customDomains: true,
+			},
 		},
-	],
-
-	server: {
-		role: process.env.APP_RUNTIME || 'unified',
-		publicConfig: {},
 	},
 })
 ```
 
 With that setup:
 
-- `APP_RUNTIME=unified` serves both entries (host routing still applies).
-- `APP_RUNTIME=admin` serves only the SPA entry.
-- `APP_RUNTIME=website` serves only the SSR entry.
+- `APP_RUNTIME=unified` serves both applications (host routing still applies).
+- `APP_RUNTIME=admin` serves only the SPA application.
+- `APP_RUNTIME=website` serves only the SSR application.
 
-If a host matches an entry that the current role does not allow, the server responds with `421`.
-
-You can also load role-specific code only when needed:
-
-```ts
-export default async () => {
-	const role = process.env.APP_RUNTIME || 'unified'
-	const websiteApplication =
-		role === 'admin'
-			? undefined
-			: (await import('./website/SsrApplication')).websiteApplication
-
-	return defineSsrRuntime({
-		name: 'my-platform',
-		entries: [
-			{
-				id: 'admin',
-				kind: 'spa',
-				template: 'index.html',
-				hosts: ['app.example.com'],
-				roles: ['unified', 'admin'],
-			},
-			{
-				id: 'website',
-				kind: 'ssr',
-				template: 'site.html',
-				hosts: ['*'],
-				roles: ['unified', 'website'],
-				application: websiteApplication,
-			},
-		],
-		server: {
-			role,
-			publicConfig: {},
-		},
-	})
-}
-```
+If a host matches an application that the current role does not allow, the server responds with `421`.
 
-`defineSsrRuntime` accepts either a plain object or an async factory function.
+`defineSsrConfig` accepts either a plain object or an async factory function.
 
 ## Custom Endpoints
 

package/dist/SsrApplicationRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SsrApplicationRuntime.d.ts","sourceRoot":"","sources":["../src/SsrApplicationRuntime.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,WAAW,2BAA2B,CAC1C,iBAAiB,EACjB,aAAa;IAEb,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;IACxC,cAAc,CAAC,EAAE,iBAAiB,CAAC,iBAAiB,EAAE,aAAa,CAAC,GAAG,IAAI,CAAA;IAC3E;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAA;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC5C;;;OAGG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAA;CACrC;AAED,eAAO,MAAM,oBAAoB,GAC/B,iBAAiB,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,aAAa,GAAG,OAAO,EACvB,UAAU,GAAG,OAAO,EAEpB,YAAY,wBAAwB,CAClC,iBAAiB,EACjB,aAAa,EACb,UAAU,CACX,EACD,SAAS,2BAA2B,CAAC,iBAAiB,EAAE,aAAa,CAAC,KACrE,OAAO,CAAC,qBAAqB,CAAC,iBAAiB,EAAE,aAAa,EAAE,UAAU,CAAC,CAqG7E,CAAA"}
+{"version":3,"file":"SsrApplicationRuntime.d.ts","sourceRoot":"","sources":["../src/SsrApplicationRuntime.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,WAAW,2BAA2B,CAC1C,iBAAiB,EACjB,aAAa;IAEb,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;IACxC,cAAc,CAAC,EAAE,iBAAiB,CAAC,iBAAiB,EAAE,aAAa,CAAC,GAAG,IAAI,CAAA;IAC3E;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAA;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC5C;;;OAGG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAA;CACrC;AAED,eAAO,MAAM,oBAAoB,GAC/B,iBAAiB,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,aAAa,GAAG,OAAO,EACvB,UAAU,GAAG,OAAO,EAEpB,YAAY,wBAAwB,CAClC,iBAAiB,EACjB,aAAa,EACb,UAAU,CACX,EACD,SAAS,2BAA2B,CAAC,iBAAiB,EAAE,aAAa,CAAC,KACrE,OAAO,CAAC,qBAAqB,CAAC,iBAAiB,EAAE,aAAa,EAAE,UAAU,CAAC,CAkH7E,CAAA"}

package/dist/SsrBrowserRuntime.d.ts

@@ -1,4 +1,5 @@
 import { App } from 'vue';
+import { SsrDomainContext } from './SsrConfigTypes';
 import { SsrApplicationDefinition } from './SsrRuntimeTypes';
 export interface SsrHydrateOptions {
     mountSelector?: string;
@@ -7,10 +8,12 @@ export interface SsrHydrateOptions {
 }
 export interface SsrSpaMountOptions<TPublicConfig = unknown> {
     mountSelector?: string;
-    /** Client-side public config. Defaults to `{}` for a self-contained SPA. */
+    /** Client-side public config. Defaults to injected SPA domain state. */
     publicConfig?: TPublicConfig;
     /** Initial URL to route to. Defaults to `window.location`. */
     url?: string;
+    /** Domain context. Defaults to `#vue-ssr-lite-domain` injection. */
+    domain?: SsrDomainContext;
 }
 export interface SsrMountedApplication {
     app: App;
@@ -19,11 +22,9 @@ export interface SsrMountedApplication {
 }
 export declare const hydrateSsrApplication: (definition: SsrApplicationDefinition<any, any, any>, options?: SsrHydrateOptions) => Promise<void>;
 /**
- * Mounts an {@link SsrApplicationDefinition} as a pure client-side SPA — the
- * third mode alongside server render and browser hydration. The SAME definition
- * (root component, routes, plugins, install hook, public config delivery) drives
- * all three, so a consumer's SPA entry and SSR entry cannot drift. No server
- * markup is required: Vue performs a full client render.
+ * Mounts an {@link SsrApplicationDefinition} as a pure client-side SPA.
+ * Domain context is restored from the server-injected `#vue-ssr-lite-domain`
+ * payload so SPA and SSR share the same library-owned resolution.
  */
 export declare const mountSpaApplication: <TApplicationState extends Record<string, any> = Record<string, unknown>, TPublicConfig = unknown, TExtension = unknown>(definition: SsrApplicationDefinition<TApplicationState, TPublicConfig, TExtension>, options?: SsrSpaMountOptions<TPublicConfig>) => Promise<SsrMountedApplication>;
 //# sourceMappingURL=SsrBrowserRuntime.d.ts.map

package/dist/SsrBrowserRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SsrBrowserRuntime.d.ts","sourceRoot":"","sources":["../src/SsrBrowserRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAG9B,OAAO,KAAK,EACV,wBAAwB,EAGzB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,kBAAkB,CAAC,aAAa,GAAG,OAAO;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,aAAa,CAAA;IAC5B,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,GAAG,CAAA;IACR,yDAAyD;IACzD,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAkBD,eAAO,MAAM,qBAAqB,GAChC,YAAY,wBAAwB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACnD,UAAS,iBAAsB,KAC9B,OAAO,CAAC,IAAI,CAkDd,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,iBAAiB,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,aAAa,GAAG,OAAO,EACvB,UAAU,GAAG,OAAO,EAEpB,YAAY,wBAAwB,CAClC,iBAAiB,EACjB,aAAa,EACb,UAAU,CACX,EACD,UAAS,kBAAkB,CAAC,aAAa,CAAM,KAC9C,OAAO,CAAC,qBAAqB,CA8C/B,CAAA"}
+{"version":3,"file":"SsrBrowserRuntime.d.ts","sourceRoot":"","sources":["../src/SsrBrowserRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD,OAAO,KAAK,EACV,wBAAwB,EAGzB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,kBAAkB,CAAC,aAAa,GAAG,OAAO;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,wEAAwE;IACxE,YAAY,CAAC,EAAE,aAAa,CAAA;IAC5B,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,GAAG,CAAA;IACR,yDAAyD;IACzD,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAsCD,eAAO,MAAM,qBAAqB,GAChC,YAAY,wBAAwB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACnD,UAAS,iBAAsB,KAC9B,OAAO,CAAC,IAAI,CAsDd,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,iBAAiB,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,aAAa,GAAG,OAAO,EACvB,UAAU,GAAG,OAAO,EAEpB,YAAY,wBAAwB,CAClC,iBAAiB,EACjB,aAAa,EACb,UAAU,CACX,EACD,UAAS,kBAAkB,CAAC,aAAa,CAAM,KAC9C,OAAO,CAAC,qBAAqB,CAyD/B,CAAA"}

package/dist/SsrConfigCompileRuntime.d.ts

@@ -0,0 +1,40 @@
+import { SsrApplicationDomainConfig, SsrDomainMode } from './SsrConfigTypes';
+import { defineSsrConfig } from './SsrConfigRuntime';
+import { SsrApplicationDefinition, SsrEndpointDefinition, SsrEntryKind, SsrReadinessProbe, SsrResponseCacheStrategy, SsrServerOptions } from './SsrRuntimeTypes';
+export { defineSsrConfig };
+export interface SsrCompiledApplication {
+    id: string;
+    kind: SsrEntryKind;
+    template: string;
+    hosts: string[];
+    roles?: string[];
+    application?: SsrApplicationDefinition<any, any, any>;
+    mountSelector?: string;
+    cacheControl?: string;
+    responseCache?: SsrResponseCacheStrategy<any>;
+    endpoints: SsrEndpointDefinition<any>[];
+    cookieAllowlist: string[];
+    cookieDenylist: string[];
+    publicConfig: Record<string, unknown>;
+    domain: {
+        development: string;
+        production: string;
+        mode: SsrDomainMode;
+        localAliases: boolean;
+        customDomains: boolean;
+        expose: SsrApplicationDomainConfig['expose'];
+    };
+}
+export interface SsrCompiledConfig {
+    name: string;
+    applications: SsrCompiledApplication[];
+    defaultApplicationId?: string;
+    server: SsrServerOptions<Record<string, unknown>>;
+    readiness?: SsrReadinessProbe[];
+    development: boolean;
+}
+export declare const resolveSsrConfigPath: (root: string, explicit?: string) => Promise<string>;
+export declare const compileSsrConfig: (loaded: unknown, options?: {
+    development?: boolean;
+}) => Promise<SsrCompiledConfig>;
+//# sourceMappingURL=SsrConfigCompileRuntime.d.ts.map

package/dist/SsrConfigCompileRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SsrConfigCompileRuntime.d.ts","sourceRoot":"","sources":["../src/SsrConfigCompileRuntime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,0BAA0B,EAI1B,aAAa,EACd,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,mBAAmB,CAAA;AAQ1B,OAAO,EAAE,eAAe,EAAE,CAAA;AAU1B,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,CAAC,EAAE,wBAAwB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;IACrD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAA;IAC7C,SAAS,EAAE,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAA;IACvC,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,EAAE,aAAa,CAAA;QACnB,YAAY,EAAE,OAAO,CAAA;QACrB,aAAa,EAAE,OAAO,CAAA;QACtB,MAAM,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAA;KAC7C,CAAA;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,sBAAsB,EAAE,CAAA;IACtC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC/B,WAAW,EAAE,OAAO,CAAA;CACrB;AA8FD,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EACZ,WAAW,MAAM,KAChB,OAAO,CAAC,MAAM,CAchB,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,OAAO,EACf,UAAS;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,KACtC,OAAO,CAAC,iBAAiB,CA8H3B,CAAA"}

package/dist/SsrConfigRuntime.d.ts

@@ -0,0 +1,4 @@
+import { SsrConfig } from './SsrConfigTypes';
+/** Identity helper for typed flat SSR configuration modules. */
+export declare const defineSsrConfig: <T extends SsrConfig>(config: T) => T;
+//# sourceMappingURL=SsrConfigRuntime.d.ts.map

package/dist/SsrConfigRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SsrConfigRuntime.d.ts","sourceRoot":"","sources":["../src/SsrConfigRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,gEAAgE;AAChE,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,SAAS,EAAE,QAAQ,CAAC,KAAG,CAAW,CAAA"}

package/dist/SsrConfigTypes.d.ts

@@ -0,0 +1,107 @@
+import { SsrApplicationDefinition, SsrEndpointDefinition, SsrLogger, SsrReadinessProbe, SsrResponseCacheStrategy } from './SsrRuntimeTypes';
+/** How an application owns its apex hostname and subdomains. */
+export type SsrDomainMode = 'root' | 'subdomains' | 'root-and-subdomains';
+export interface SsrApplicationDomainExpose {
+    /** Expose the last subdomain label under the app base (e.g. workspace). */
+    subdomainAs?: string;
+    /**
+     * Expose the remaining labels under the app base, or the full hostname for
+     * custom domains (e.g. storeDomain).
+     */
+    subdomainOrHostnameAs?: string;
+}
+export interface SsrApplicationDomainConfig {
+    /** Apex used while `NODE_ENV !== 'production'`. */
+    development: string;
+    /** Apex used in production. */
+    production: string;
+    /** Defaults to `root-and-subdomains`. */
+    mode?: SsrDomainMode;
+    /** Register loopback aliases in development. Defaults to false. */
+    localAliases?: boolean;
+    /** Own unmatched hosts via catch-all `*`. Defaults to false. */
+    customDomains?: boolean;
+    /** Extra exact hostnames owned by this application. */
+    additionalHosts?: readonly string[];
+    /** Map resolved subdomain/hostname values onto `useSsrDomain().params`. */
+    expose?: SsrApplicationDomainExpose;
+}
+export interface SsrApplicationGraphqlConfig {
+    endpoint: string;
+    timeout?: number;
+}
+export interface SsrApplicationCookiesConfig {
+    allow?: string | readonly string[];
+    deny?: readonly string[];
+}
+export type SsrApplicationLoader = SsrApplicationDefinition<any, any, any> | (() => SsrApplicationDefinition<any, any, any> | Promise<SsrApplicationDefinition<any, any, any>>);
+/**
+ * One self-contained SPA or SSR application: runtime, domain, security,
+ * endpoints, and public configuration live together.
+ */
+export interface SsrApplicationConfig {
+    /**
+     * SPA HTML shell. Use `true` (recommended) or a client-only loader reference.
+     * The Node server never executes SPA loaders — mount with
+     * `mountSpaApplication()` from a browser entry instead.
+     */
+    spa?: true | SsrApplicationLoader;
+    /** Server-rendered Vue application. */
+    ssr?: SsrApplicationLoader;
+    template: string;
+    roles?: readonly string[];
+    domain: SsrApplicationDomainConfig;
+    graphql?: SsrApplicationGraphqlConfig;
+    cookies?: SsrApplicationCookiesConfig;
+    endpoints?: SsrEndpointDefinition<any>[];
+    mountSelector?: string;
+    cacheControl?: string;
+    responseCache?: SsrResponseCacheStrategy<any>;
+    /** Merged into the request `publicConfig` for this application. */
+    publicConfig?: Record<string, unknown>;
+}
+export interface SsrConfigServerOptions {
+    root?: string;
+    host?: string;
+    port?: number;
+    trustProxy?: boolean;
+    clientOutDir?: string;
+    requestTimeoutMs?: number;
+    shutdownTimeoutMs?: number;
+    healthPath?: string;
+    readinessPath?: string;
+    maxResolutionPasses?: number;
+    resolutionDeadlineMs?: number;
+    diagnostics?: boolean;
+    logger?: SsrLogger;
+}
+/**
+ * Flat Vite/Nuxt-style SSR configuration.
+ * Everything about an application lives under `applications.<id>`.
+ */
+export interface SsrConfig {
+    name: string;
+    server?: SsrConfigServerOptions;
+    /** Active process role (`unified`, `erp`, `storefront`, …). */
+    runtime?: string;
+    applications: Record<string, SsrApplicationConfig>;
+    /** Used only when no application host pattern matches. */
+    defaultApplicationId?: string;
+    readiness?: SsrReadinessProbe[];
+}
+export type SsrConfigExport = SsrConfig | (() => SsrConfig | Promise<SsrConfig>);
+/** Serializable domain snapshot attached to every request and hydration state. */
+export interface SsrDomainContext {
+    /** Selected application id. */
+    entry: string;
+    hostname: string;
+    /** Active environment apex for the selected application. */
+    baseDomain: string;
+    /** Remaining labels under `baseDomain`, or null on the apex / custom host. */
+    subdomain: string | null;
+    isCustomDomain: boolean;
+    development: boolean;
+    /** Values declared via `domain.expose`. */
+    params: Record<string, string>;
+}
+//# sourceMappingURL=SsrConfigTypes.d.ts.map

package/dist/SsrConfigTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SsrConfigTypes.d.ts","sourceRoot":"","sources":["../src/SsrConfigTypes.ts"],"names":[],"mappings":"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"}

package/dist/SsrDomainRuntime.d.ts

@@ -0,0 +1,38 @@
+import { InjectionKey } from 'vue';
+import { SsrApplicationDomainConfig, SsrDomainContext, SsrDomainMode } from './SsrConfigTypes';
+export declare const SSR_DOMAIN_CONTEXT: InjectionKey<SsrDomainContext>;
+export interface SsrDomainApplicationRef {
+    id: string;
+    domain: {
+        development: string;
+        production: string;
+        mode: SsrDomainMode;
+        localAliases: boolean;
+        customDomains: boolean;
+        expose?: SsrApplicationDomainConfig['expose'];
+    };
+}
+export declare const resolveSsrDomainContext: (host: string, application: SsrDomainApplicationRef, development: boolean) => SsrDomainContext;
+export declare const buildSsrSubdomainUrl: (options: {
+    baseDomain: string;
+    subdomain: string;
+    path?: string;
+    protocol?: "http" | "https";
+    port?: string | number;
+    development?: boolean;
+}) => string;
+export interface SsrDomainApi extends SsrDomainContext {
+    buildSubdomainUrl: (subdomain: string, path?: string, options?: {
+        port?: string | number;
+        protocol?: 'http' | 'https';
+    }) => string;
+}
+export declare const installSsrDomainContext: (domain: SsrDomainContext) => (() => void);
+/**
+ * Domain context for the application selected for the current request.
+ * Works during SSR, SPA mounting, endpoint handling, route guards, and
+ * browser hydration.
+ */
+export declare const useSsrDomain: () => SsrDomainApi;
+export type { SsrDomainContext } from './SsrConfigTypes';
+//# sourceMappingURL=SsrDomainRuntime.d.ts.map

package/dist/SsrDomainRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SsrDomainRuntime.d.ts","sourceRoot":"","sources":["../src/SsrDomainRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,KAAK,CAAA;AAC/C,OAAO,KAAK,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,aAAa,EACd,MAAM,kBAAkB,CAAA;AAGzB,eAAO,MAAM,kBAAkB,EAE1B,YAAY,CAAC,gBAAgB,CAAC,CAAA;AAEnC,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,EAAE,aAAa,CAAA;QACnB,YAAY,EAAE,OAAO,CAAA;QACrB,aAAa,EAAE,OAAO,CAAA;QACtB,MAAM,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAA;KAC9C,CAAA;CACF;AAYD,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,aAAa,uBAAuB,EACpC,aAAa,OAAO,KACnB,gBAsDF,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,SAAS;IAC5C,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,KAAG,MA0BH,CAAA;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,iBAAiB,EAAE,CACjB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,KAC9D,MAAM,CAAA;CACZ;AAwBD,eAAO,MAAM,uBAAuB,GAClC,QAAQ,gBAAgB,KACvB,CAAC,MAAM,IAAI,CAKb,CAAA;AAgBD;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAO,YAiB/B,CAAA;AAED,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}