quidproquo-webserver 0.1.19 → 0.1.21

package/lib/esm/domain/logic/host/resolveHostForRequestHost.js

@@ -0,0 +1,16 @@
+import { findRootDomainForHost } from './findRootDomainForHost';
+import { resolveHostForRoot } from './resolveHostForRoot';
+import { resolveHosts } from './resolveHosts';
+/**
+ * The target's host on the root a request arrived on. Only a declared root counts (the Host
+ * header is attacker-controlled); a request on no declared root gets the primary's host, and
+ * null means the service declares no domain at all.
+ */
+export const resolveHostForRequestHost = (qpqConfig, requestHost, target = {}, resolver) => {
+    const rootDomain = requestHost ? findRootDomainForHost(qpqConfig, requestHost) : null;
+    if (rootDomain) {
+        return resolveHostForRoot(qpqConfig, rootDomain, target, resolver);
+    }
+    return resolveHosts(qpqConfig, target, resolver)[0] ?? null;
+};
+//# sourceMappingURL=resolveHostForRequestHost.js.map

package/lib/esm/domain/logic/host/resolveHostForRequestHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveHostForRequestHost.js","sourceRoot":"","sources":["../../../../../src/domain/logic/host/resolveHostForRequestHost.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,SAAoB,EACpB,WAA+B,EAC/B,SAAuB,EAAE,EACzB,QAAyB,EACP,EAAE;IACpB,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,qBAAqB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEtF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,kBAAkB,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC9D,CAAC,CAAC","sourcesContent":["import { Nullable, QPQConfig } from 'quidproquo-core';\n\nimport { DomainResolver } from '../../../domain/types/DomainResolver';\nimport { DomainTarget } from '../../../domain/types/DomainTarget';\nimport { findRootDomainForHost } from './findRootDomainForHost';\nimport { resolveHostForRoot } from './resolveHostForRoot';\nimport { resolveHosts } from './resolveHosts';\n\n/**\n * The target's host on the root a request arrived on. Only a declared root counts (the Host\n * header is attacker-controlled); a request on no declared root gets the primary's host, and\n * null means the service declares no domain at all.\n */\nexport const resolveHostForRequestHost = (\n  qpqConfig: QPQConfig,\n  requestHost: string | undefined,\n  target: DomainTarget = {},\n  resolver?: DomainResolver,\n): Nullable<string> => {\n  const rootDomain = requestHost ? findRootDomainForHost(qpqConfig, requestHost) : null;\n\n  if (rootDomain) {\n    return resolveHostForRoot(qpqConfig, rootDomain, target, resolver);\n  }\n\n  return resolveHosts(qpqConfig, target, resolver)[0] ?? null;\n};\n"]}

package/lib/esm/domain/logic/host/resolveHostForRoot.d.ts

@@ -0,0 +1,5 @@
+import { QPQConfig } from 'quidproquo-core';
+import { DomainResolver } from '../../../domain/types/DomainResolver';
+import { DomainTarget } from '../../../domain/types/DomainTarget';
+/** The target's host on one specific declared root. Throws when the root is not declared. */
+export declare const resolveHostForRoot: (qpqConfig: QPQConfig, rootDomain: string, target: DomainTarget, resolver?: DomainResolver) => string;

package/lib/esm/domain/logic/host/resolveHostForRoot.js

@@ -0,0 +1,11 @@
+import { getRootDomains } from '../../../configUtils/dns/getRootDomains';
+import { resolveHosts } from './resolveHosts';
+/** The target's host on one specific declared root. Throws when the root is not declared. */
+export const resolveHostForRoot = (qpqConfig, rootDomain, target, resolver) => {
+    const index = getRootDomains(qpqConfig).indexOf(rootDomain);
+    if (index < 0) {
+        throw new Error(`Root domain [${rootDomain}] is not declared in defineDns`);
+    }
+    return resolveHosts(qpqConfig, target, resolver)[index];
+};
+//# sourceMappingURL=resolveHostForRoot.js.map

package/lib/esm/domain/logic/host/resolveHostForRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveHostForRoot.js","sourceRoot":"","sources":["../../../../../src/domain/logic/host/resolveHostForRoot.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAoB,EAAE,UAAkB,EAAE,MAAoB,EAAE,QAAyB,EAAU,EAAE;IACtI,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAE5D,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,gBAAgB,UAAU,gCAAgC,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC,CAAC","sourcesContent":["import { QPQConfig } from 'quidproquo-core';\n\nimport { getRootDomains } from '../../../configUtils/dns/getRootDomains';\nimport { DomainResolver } from '../../../domain/types/DomainResolver';\nimport { DomainTarget } from '../../../domain/types/DomainTarget';\nimport { resolveHosts } from './resolveHosts';\n\n/** The target's host on one specific declared root. Throws when the root is not declared. */\nexport const resolveHostForRoot = (qpqConfig: QPQConfig, rootDomain: string, target: DomainTarget, resolver?: DomainResolver): string => {\n  const index = getRootDomains(qpqConfig).indexOf(rootDomain);\n\n  if (index < 0) {\n    throw new Error(`Root domain [${rootDomain}] is not declared in defineDns`);\n  }\n\n  return resolveHosts(qpqConfig, target, resolver)[index];\n};\n"]}

package/lib/esm/domain/logic/host/resolveHosts.d.ts

@@ -0,0 +1,9 @@
+import { QPQConfig } from 'quidproquo-core';
+import { DomainResolver } from '../../../domain/types/DomainResolver';
+import { DomainTarget } from '../../../domain/types/DomainTarget';
+/**
+ * One host per declared root, primary first; empty when the service has no domain. Runs the
+ * resolver given (the app's, obtained with `requireDomainResolver` at synth and build time or
+ * `loadDomainResolver` at runtime), else the localhost or default built-in.
+ */
+export declare const resolveHosts: (qpqConfig: QPQConfig, target: DomainTarget, resolver?: DomainResolver) => string[];

package/lib/esm/domain/logic/host/resolveHosts.js

@@ -0,0 +1,23 @@
+import { qpqCoreUtils } from 'quidproquo-core';
+import { getDnsConfig } from '../../../configUtils/dns/getDnsConfig';
+import { getDomainResolver } from '../resolver/getDomainResolver';
+import { validateResolvedHost } from '../resolver/validateResolvedHost';
+/**
+ * One host per declared root, primary first; empty when the service has no domain. Runs the
+ * resolver given (the app's, obtained with `requireDomainResolver` at synth and build time or
+ * `loadDomainResolver` at runtime), else the localhost or default built-in.
+ */
+export const resolveHosts = (qpqConfig, target, resolver) => {
+    const dns = getDnsConfig(qpqConfig);
+    if (!dns) {
+        return [];
+    }
+    const activeResolver = getDomainResolver(qpqConfig, resolver);
+    const environment = qpqCoreUtils.getApplicationModuleEnvironment(qpqConfig);
+    const feature = qpqCoreUtils.getApplicationModuleFeature(qpqConfig);
+    return dns.rootDomains.map((rootDomain) => {
+        const scope = { rootDomain, environment, feature, service: target.service, subdomain: target.subdomain };
+        return validateResolvedHost(activeResolver.resolveHost(scope), scope);
+    });
+};
+//# sourceMappingURL=resolveHosts.js.map

package/lib/esm/domain/logic/host/resolveHosts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveHosts.js","sourceRoot":"","sources":["../../../../../src/domain/logic/host/resolveHosts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAoB,EAAE,MAAoB,EAAE,QAAyB,EAAY,EAAE;IAC9G,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,cAAc,GAAG,iBAAiB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,YAAY,CAAC,+BAA+B,CAAC,SAAS,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,YAAY,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAEpE,OAAO,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAEzG,OAAO,oBAAoB,CAAC,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { QPQConfig, qpqCoreUtils } from 'quidproquo-core';\n\nimport { getDnsConfig } from '../../../configUtils/dns/getDnsConfig';\nimport { DomainResolver } from '../../../domain/types/DomainResolver';\nimport { DomainTarget } from '../../../domain/types/DomainTarget';\nimport { getDomainResolver } from '../resolver/getDomainResolver';\nimport { validateResolvedHost } from '../resolver/validateResolvedHost';\n\n/**\n * One host per declared root, primary first; empty when the service has no domain. Runs the\n * resolver given (the app's, obtained with `requireDomainResolver` at synth and build time or\n * `loadDomainResolver` at runtime), else the localhost or default built-in.\n */\nexport const resolveHosts = (qpqConfig: QPQConfig, target: DomainTarget, resolver?: DomainResolver): string[] => {\n  const dns = getDnsConfig(qpqConfig);\n  if (!dns) {\n    return [];\n  }\n\n  const activeResolver = getDomainResolver(qpqConfig, resolver);\n  const environment = qpqCoreUtils.getApplicationModuleEnvironment(qpqConfig);\n  const feature = qpqCoreUtils.getApplicationModuleFeature(qpqConfig);\n\n  return dns.rootDomains.map((rootDomain) => {\n    const scope = { rootDomain, environment, feature, service: target.service, subdomain: target.subdomain };\n\n    return validateResolvedHost(activeResolver.resolveHost(scope), scope);\n  });\n};\n"]}

package/lib/esm/domain/logic/host/resolvePrimaryHost.d.ts

@@ -0,0 +1,5 @@
+import { QPQConfig } from 'quidproquo-core';
+import { DomainResolver } from '../../../domain/types/DomainResolver';
+import { DomainTarget } from '../../../domain/types/DomainTarget';
+/** The host on the primary root, for anything that must bake exactly one absolute URL. Throws without a domain. */
+export declare const resolvePrimaryHost: (qpqConfig: QPQConfig, target: DomainTarget, resolver?: DomainResolver) => string;

package/lib/esm/domain/logic/host/resolvePrimaryHost.js

@@ -0,0 +1,10 @@
+import { resolveHosts } from './resolveHosts';
+/** The host on the primary root, for anything that must bake exactly one absolute URL. Throws without a domain. */
+export const resolvePrimaryHost = (qpqConfig, target, resolver) => {
+    const [primary] = resolveHosts(qpqConfig, target, resolver);
+    if (!primary) {
+        throw new Error('resolvePrimaryHost: the service declares no domain (defineDns)');
+    }
+    return primary;
+};
+//# sourceMappingURL=resolvePrimaryHost.js.map

package/lib/esm/domain/logic/host/resolvePrimaryHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePrimaryHost.js","sourceRoot":"","sources":["../../../../../src/domain/logic/host/resolvePrimaryHost.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,mHAAmH;AACnH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAoB,EAAE,MAAoB,EAAE,QAAyB,EAAU,EAAE;IAClH,MAAM,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE5D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["import { QPQConfig } from 'quidproquo-core';\n\nimport { DomainResolver } from '../../../domain/types/DomainResolver';\nimport { DomainTarget } from '../../../domain/types/DomainTarget';\nimport { resolveHosts } from './resolveHosts';\n\n/** The host on the primary root, for anything that must bake exactly one absolute URL. Throws without a domain. */\nexport const resolvePrimaryHost = (qpqConfig: QPQConfig, target: DomainTarget, resolver?: DomainResolver): string => {\n  const [primary] = resolveHosts(qpqConfig, target, resolver);\n\n  if (!primary) {\n    throw new Error('resolvePrimaryHost: the service declares no domain (defineDns)');\n  }\n\n  return primary;\n};\n"]}

package/lib/esm/domain/logic/index.d.ts

@@ -0,0 +1,3 @@
+export * from './host';
+export * from './origin';
+export * from './resolver';

package/lib/esm/domain/logic/index.js

@@ -0,0 +1,4 @@
+export * from './host';
+export * from './origin';
+export * from './resolver';
+//# sourceMappingURL=index.js.map

package/lib/esm/domain/logic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain/logic/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC","sourcesContent":["export * from './host';\nexport * from './origin';\nexport * from './resolver';\n"]}

package/lib/esm/domain/logic/origin/getStorageDriveCorsAllowedOrigins.d.ts

@@ -0,0 +1,4 @@
+import { QPQConfig } from 'quidproquo-core';
+import { DomainResolver } from '../../../domain/types/DomainResolver';
+/** Origins allowed on a storage drive's objects: `defineStorageDriveCorsSettings` wins, else the service-scoped default. */
+export declare const getStorageDriveCorsAllowedOrigins: (qpqConfig: QPQConfig, storageDriveName: string, resolver?: DomainResolver) => string[];

package/lib/esm/domain/logic/origin/getStorageDriveCorsAllowedOrigins.js

@@ -0,0 +1,5 @@
+import { getStorageDriveCorsSettingsByName } from '../../../configUtils/storageDrive/getStorageDriveCorsSettingsByName';
+import { resolveServiceScopedCorsAllowedOrigins } from './resolveServiceScopedCorsAllowedOrigins';
+/** Origins allowed on a storage drive's objects: `defineStorageDriveCorsSettings` wins, else the service-scoped default. */
+export const getStorageDriveCorsAllowedOrigins = (qpqConfig, storageDriveName, resolver) => resolveServiceScopedCorsAllowedOrigins(qpqConfig, getStorageDriveCorsSettingsByName(qpqConfig, storageDriveName)?.allowedOrigins, resolver);
+//# sourceMappingURL=getStorageDriveCorsAllowedOrigins.js.map

package/lib/esm/domain/logic/origin/getStorageDriveCorsAllowedOrigins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getStorageDriveCorsAllowedOrigins.js","sourceRoot":"","sources":["../../../../../src/domain/logic/origin/getStorageDriveCorsAllowedOrigins.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iCAAiC,EAAE,MAAM,qEAAqE,CAAC;AAExH,OAAO,EAAE,sCAAsC,EAAE,MAAM,0CAA0C,CAAC;AAElG,4HAA4H;AAC5H,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,SAAoB,EAAE,gBAAwB,EAAE,QAAyB,EAAY,EAAE,CACvI,sCAAsC,CAAC,SAAS,EAAE,iCAAiC,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC","sourcesContent":["import { QPQConfig } from 'quidproquo-core';\n\nimport { getStorageDriveCorsSettingsByName } from '../../../configUtils/storageDrive/getStorageDriveCorsSettingsByName';\nimport { DomainResolver } from '../../../domain/types/DomainResolver';\nimport { resolveServiceScopedCorsAllowedOrigins } from './resolveServiceScopedCorsAllowedOrigins';\n\n/** Origins allowed on a storage drive's objects: `defineStorageDriveCorsSettings` wins, else the service-scoped default. */\nexport const getStorageDriveCorsAllowedOrigins = (qpqConfig: QPQConfig, storageDriveName: string, resolver?: DomainResolver): string[] =>\n  resolveServiceScopedCorsAllowedOrigins(qpqConfig, getStorageDriveCorsSettingsByName(qpqConfig, storageDriveName)?.allowedOrigins, resolver);\n"]}

package/lib/esm/domain/logic/origin/index.d.ts

@@ -0,0 +1,4 @@
+export * from './getStorageDriveCorsAllowedOrigins';
+export * from './resolveContentSecurityPolicyEntry';
+export * from './resolveOrigins';
+export * from './resolveServiceScopedCorsAllowedOrigins';

package/lib/esm/domain/logic/origin/index.js

@@ -0,0 +1,5 @@
+export * from './getStorageDriveCorsAllowedOrigins';
+export * from './resolveContentSecurityPolicyEntry';
+export * from './resolveOrigins';
+export * from './resolveServiceScopedCorsAllowedOrigins';
+//# sourceMappingURL=index.js.map

package/lib/esm/domain/logic/origin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/domain/logic/origin/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,kBAAkB,CAAC;AACjC,cAAc,0CAA0C,CAAC","sourcesContent":["export * from './getStorageDriveCorsAllowedOrigins';\nexport * from './resolveContentSecurityPolicyEntry';\nexport * from './resolveOrigins';\nexport * from './resolveServiceScopedCorsAllowedOrigins';\n"]}

package/lib/esm/domain/logic/origin/resolveContentSecurityPolicyEntry.d.ts

@@ -0,0 +1,9 @@
+import { QPQConfig } from 'quidproquo-core';
+import { ContentSecurityPolicyEntry } from '../../../config/types/ResponseSecurityHeaders';
+import { DomainResolver } from '../../../domain/types/DomainResolver';
+/**
+ * CSP source values for an entry: a string passes through, a service entry becomes one
+ * host per root (or the pinned `domain`'s), prefixed with the protocol only when given,
+ * since CSP accepts bare hosts.
+ */
+export declare const resolveContentSecurityPolicyEntry: (qpqConfig: QPQConfig, entry: ContentSecurityPolicyEntry, resolver?: DomainResolver) => string[];

package/lib/esm/domain/logic/origin/resolveContentSecurityPolicyEntry.js

@@ -0,0 +1,16 @@
+import { resolveHostForRoot } from '../host/resolveHostForRoot';
+import { resolveHosts } from '../host/resolveHosts';
+/**
+ * CSP source values for an entry: a string passes through, a service entry becomes one
+ * host per root (or the pinned `domain`'s), prefixed with the protocol only when given,
+ * since CSP accepts bare hosts.
+ */
+export const resolveContentSecurityPolicyEntry = (qpqConfig, entry, resolver) => {
+    if (typeof entry === 'string') {
+        return [entry];
+    }
+    const target = { subdomain: entry.api, service: entry.service };
+    const hosts = entry.domain ? [resolveHostForRoot(qpqConfig, entry.domain, target, resolver)] : resolveHosts(qpqConfig, target, resolver);
+    return hosts.map((host) => (entry.protocol ? `${entry.protocol}://${host}` : host));
+};
+//# sourceMappingURL=resolveContentSecurityPolicyEntry.js.map

package/lib/esm/domain/logic/origin/resolveContentSecurityPolicyEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveContentSecurityPolicyEntry.js","sourceRoot":"","sources":["../../../../../src/domain/logic/origin/resolveContentSecurityPolicyEntry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,SAAoB,EAAE,KAAiC,EAAE,QAAyB,EAAY,EAAE;IAChJ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAChE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEzI,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACtF,CAAC,CAAC","sourcesContent":["import { QPQConfig } from 'quidproquo-core';\n\nimport { ContentSecurityPolicyEntry } from '../../../config/types/ResponseSecurityHeaders';\nimport { DomainResolver } from '../../../domain/types/DomainResolver';\nimport { resolveHostForRoot } from '../host/resolveHostForRoot';\nimport { resolveHosts } from '../host/resolveHosts';\n\n/**\n * CSP source values for an entry: a string passes through, a service entry becomes one\n * host per root (or the pinned `domain`'s), prefixed with the protocol only when given,\n * since CSP accepts bare hosts.\n */\nexport const resolveContentSecurityPolicyEntry = (qpqConfig: QPQConfig, entry: ContentSecurityPolicyEntry, resolver?: DomainResolver): string[] => {\n  if (typeof entry === 'string') {\n    return [entry];\n  }\n\n  const target = { subdomain: entry.api, service: entry.service };\n  const hosts = entry.domain ? [resolveHostForRoot(qpqConfig, entry.domain, target, resolver)] : resolveHosts(qpqConfig, target, resolver);\n\n  return hosts.map((host) => (entry.protocol ? `${entry.protocol}://${host}` : host));\n};\n"]}

package/lib/esm/domain/logic/origin/resolveOrigins.d.ts

@@ -0,0 +1,8 @@
+import { QPQConfig } from 'quidproquo-core';
+import { ServiceAllowedOrigin } from '../../../config/settings/route';
+import { DomainResolver } from '../../../domain/types/DomainResolver';
+/**
+ * Browser origins for a CORS / CSP entry: a string passes through, a service entry becomes
+ * `${protocol}://host` once per root, or once for the pinned `domain` when it names one.
+ */
+export declare const resolveOrigins: (qpqConfig: QPQConfig, entry: string | ServiceAllowedOrigin, resolver?: DomainResolver) => string[];

package/lib/esm/domain/logic/origin/resolveOrigins.js

@@ -0,0 +1,16 @@
+import { resolveHostForRoot } from '../host/resolveHostForRoot';
+import { resolveHosts } from '../host/resolveHosts';
+/**
+ * Browser origins for a CORS / CSP entry: a string passes through, a service entry becomes
+ * `${protocol}://host` once per root, or once for the pinned `domain` when it names one.
+ */
+export const resolveOrigins = (qpqConfig, entry, resolver) => {
+    if (typeof entry === 'string') {
+        return [entry];
+    }
+    const protocol = entry.protocol || 'https';
+    const target = { subdomain: entry.api, service: entry.service };
+    const hosts = entry.domain ? [resolveHostForRoot(qpqConfig, entry.domain, target, resolver)] : resolveHosts(qpqConfig, target, resolver);
+    return hosts.map((host) => `${protocol}://${host}`);
+};
+//# sourceMappingURL=resolveOrigins.js.map

package/lib/esm/domain/logic/origin/resolveOrigins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOrigins.js","sourceRoot":"","sources":["../../../../../src/domain/logic/origin/resolveOrigins.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAoB,EAAE,KAAoC,EAAE,QAAyB,EAAY,EAAE;IAChI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC;IAC3C,MAAM,MAAM,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAEhE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEzI,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,QAAQ,MAAM,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC,CAAC","sourcesContent":["import { QPQConfig } from 'quidproquo-core';\n\nimport { ServiceAllowedOrigin } from '../../../config/settings/route';\nimport { DomainResolver } from '../../../domain/types/DomainResolver';\nimport { resolveHostForRoot } from '../host/resolveHostForRoot';\nimport { resolveHosts } from '../host/resolveHosts';\n\n/**\n * Browser origins for a CORS / CSP entry: a string passes through, a service entry becomes\n * `${protocol}://host` once per root, or once for the pinned `domain` when it names one.\n */\nexport const resolveOrigins = (qpqConfig: QPQConfig, entry: string | ServiceAllowedOrigin, resolver?: DomainResolver): string[] => {\n  if (typeof entry === 'string') {\n    return [entry];\n  }\n\n  const protocol = entry.protocol || 'https';\n  const target = { subdomain: entry.api, service: entry.service };\n\n  const hosts = entry.domain ? [resolveHostForRoot(qpqConfig, entry.domain, target, resolver)] : resolveHosts(qpqConfig, target, resolver);\n\n  return hosts.map((host) => `${protocol}://${host}`);\n};\n"]}

package/lib/esm/domain/logic/origin/resolveServiceScopedCorsAllowedOrigins.d.ts

@@ -0,0 +1,8 @@
+import { QPQConfig } from 'quidproquo-core';
+import { DomainResolver } from '../../../domain/types/DomainResolver';
+/**
+ * CORS origins for a service resource: an explicit list wins; otherwise the site root plus a
+ * one-level subdomain wildcard on every root (S3 and CloudFront both accept that form).
+ * '*' only when the service declares no domain at all (nothing browser-facing).
+ */
+export declare const resolveServiceScopedCorsAllowedOrigins: (qpqConfig: QPQConfig, explicitOrigins?: string[], resolver?: DomainResolver) => string[];

package/lib/esm/domain/logic/origin/resolveServiceScopedCorsAllowedOrigins.js

@@ -0,0 +1,17 @@
+import { resolveHosts } from '../host/resolveHosts';
+/**
+ * CORS origins for a service resource: an explicit list wins; otherwise the site root plus a
+ * one-level subdomain wildcard on every root (S3 and CloudFront both accept that form).
+ * '*' only when the service declares no domain at all (nothing browser-facing).
+ */
+export const resolveServiceScopedCorsAllowedOrigins = (qpqConfig, explicitOrigins, resolver) => {
+    if (explicitOrigins) {
+        return explicitOrigins;
+    }
+    const hosts = resolveHosts(qpqConfig, {}, resolver);
+    if (hosts.length === 0) {
+        return ['*'];
+    }
+    return hosts.flatMap((host) => [`https://${host}`, `https://*.${host}`]);
+};
+//# sourceMappingURL=resolveServiceScopedCorsAllowedOrigins.js.map

package/lib/esm/domain/logic/origin/resolveServiceScopedCorsAllowedOrigins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveServiceScopedCorsAllowedOrigins.js","sourceRoot":"","sources":["../../../../../src/domain/logic/origin/resolveServiceScopedCorsAllowedOrigins.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,SAAoB,EAAE,eAA0B,EAAE,QAAyB,EAAY,EAAE;IAC9I,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3E,CAAC,CAAC","sourcesContent":["import { QPQConfig } from 'quidproquo-core';\n\nimport { DomainResolver } from '../../../domain/types/DomainResolver';\nimport { resolveHosts } from '../host/resolveHosts';\n\n/**\n * CORS origins for a service resource: an explicit list wins; otherwise the site root plus a\n * one-level subdomain wildcard on every root (S3 and CloudFront both accept that form).\n * '*' only when the service declares no domain at all (nothing browser-facing).\n */\nexport const resolveServiceScopedCorsAllowedOrigins = (qpqConfig: QPQConfig, explicitOrigins?: string[], resolver?: DomainResolver): string[] => {\n  if (explicitOrigins) {\n    return explicitOrigins;\n  }\n\n  const hosts = resolveHosts(qpqConfig, {}, resolver);\n  if (hosts.length === 0) {\n    return ['*'];\n  }\n\n  return hosts.flatMap((host) => [`https://${host}`, `https://*.${host}`]);\n};\n"]}

package/lib/esm/domain/logic/resolver/getDomainResolver.d.ts

@@ -0,0 +1,4 @@
+import { QPQConfig } from 'quidproquo-core';
+import { DomainResolver } from '../../../domain/types/DomainResolver';
+/** The resolver to run: the one the tooling was given, else localhost under the dev server, else the default shape. */
+export declare const getDomainResolver: (qpqConfig: QPQConfig, resolver?: DomainResolver) => DomainResolver;

package/lib/esm/domain/logic/resolver/getDomainResolver.js

@@ -0,0 +1,16 @@
+import { getPrimaryRootDomain } from '../../../configUtils/dns/getPrimaryRootDomain';
+import { defaultDomainResolver } from '../../resolvers/defaultDomainResolver';
+import { localhostDomainResolver } from '../../resolvers/localhostDomainResolver';
+import { isLocalhostRootDomain } from './isLocalhostRootDomain';
+/** The resolver to run: the one the tooling was given, else localhost under the dev server, else the default shape. */
+export const getDomainResolver = (qpqConfig, resolver) => {
+    if (resolver) {
+        return resolver;
+    }
+    const primary = getPrimaryRootDomain(qpqConfig);
+    if (primary && isLocalhostRootDomain(primary)) {
+        return localhostDomainResolver;
+    }
+    return defaultDomainResolver;
+};
+//# sourceMappingURL=getDomainResolver.js.map

package/lib/esm/domain/logic/resolver/getDomainResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDomainResolver.js","sourceRoot":"","sources":["../../../../../src/domain/logic/resolver/getDomainResolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAErF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,uHAAuH;AACvH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAoB,EAAE,QAAyB,EAAkB,EAAE;IACnG,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,OAAO,IAAI,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,OAAO,qBAAqB,CAAC;AAC/B,CAAC,CAAC","sourcesContent":["import { QPQConfig } from 'quidproquo-core';\n\nimport { getPrimaryRootDomain } from '../../../configUtils/dns/getPrimaryRootDomain';\nimport { DomainResolver } from '../../../domain/types/DomainResolver';\nimport { defaultDomainResolver } from '../../resolvers/defaultDomainResolver';\nimport { localhostDomainResolver } from '../../resolvers/localhostDomainResolver';\nimport { isLocalhostRootDomain } from './isLocalhostRootDomain';\n\n/** The resolver to run: the one the tooling was given, else localhost under the dev server, else the default shape. */\nexport const getDomainResolver = (qpqConfig: QPQConfig, resolver?: DomainResolver): DomainResolver => {\n  if (resolver) {\n    return resolver;\n  }\n\n  const primary = getPrimaryRootDomain(qpqConfig);\n  if (primary && isLocalhostRootDomain(primary)) {\n    return localhostDomainResolver;\n  }\n\n  return defaultDomainResolver;\n};\n"]}

package/lib/esm/domain/logic/resolver/index.d.ts

@@ -0,0 +1,4 @@
+export * from './getDomainResolver';
+export * from './isLocalhostRootDomain';
+export * from './loadDomainResolver';
+export * from './validateResolvedHost';

package/lib/esm/domain/logic/resolver/index.js

@@ -0,0 +1,5 @@
+export * from './getDomainResolver';
+export * from './isLocalhostRootDomain';
+export * from './loadDomainResolver';
+export * from './validateResolvedHost';
+//# sourceMappingURL=index.js.map

package/lib/esm/domain/logic/resolver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/domain/logic/resolver/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC","sourcesContent":["export * from './getDomainResolver';\nexport * from './isLocalhostRootDomain';\nexport * from './loadDomainResolver';\nexport * from './validateResolvedHost';\n"]}

package/lib/esm/domain/logic/resolver/isLocalhostRootDomain.d.ts

@@ -0,0 +1,2 @@
+/** `localhost` with or without a port; the dev server rewrites roots to this. */
+export declare const isLocalhostRootDomain: (rootDomain: string) => boolean;

package/lib/esm/domain/logic/resolver/isLocalhostRootDomain.js

@@ -0,0 +1,3 @@
+/** `localhost` with or without a port; the dev server rewrites roots to this. */
+export const isLocalhostRootDomain = (rootDomain) => rootDomain.split(':')[0].toLowerCase() === 'localhost';
+//# sourceMappingURL=isLocalhostRootDomain.js.map

package/lib/esm/domain/logic/resolver/isLocalhostRootDomain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isLocalhostRootDomain.js","sourceRoot":"","sources":["../../../../../src/domain/logic/resolver/isLocalhostRootDomain.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,UAAkB,EAAW,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC","sourcesContent":["/** `localhost` with or without a port; the dev server rewrites roots to this. */\nexport const isLocalhostRootDomain = (rootDomain: string): boolean => rootDomain.split(':')[0].toLowerCase() === 'localhost';\n"]}

package/lib/esm/domain/logic/resolver/loadDomainResolver.d.ts

@@ -0,0 +1,8 @@
+import { DynamicModuleLoader, QPQConfig } from 'quidproquo-core';
+import { DomainResolver } from '../../../domain/types/DomainResolver';
+/**
+ * The resolver a runtime should use: the Dns setting's pointer loaded through the dynamic
+ * module loader (the pointer is a src entry, so the bundler includes it), else the
+ * localhost or default built-in. Processor factories call this once and close over it.
+ */
+export declare const loadDomainResolver: (qpqConfig: QPQConfig, dynamicModuleLoader: DynamicModuleLoader) => Promise<DomainResolver>;

package/lib/esm/domain/logic/resolver/loadDomainResolver.js

@@ -0,0 +1,19 @@
+import { getDnsConfig } from '../../../configUtils/dns/getDnsConfig';
+import { getDomainResolver } from './getDomainResolver';
+/**
+ * The resolver a runtime should use: the Dns setting's pointer loaded through the dynamic
+ * module loader (the pointer is a src entry, so the bundler includes it), else the
+ * localhost or default built-in. Processor factories call this once and close over it.
+ */
+export const loadDomainResolver = async (qpqConfig, dynamicModuleLoader) => {
+    const pointer = getDnsConfig(qpqConfig)?.resolver;
+    if (!pointer) {
+        return getDomainResolver(qpqConfig);
+    }
+    const resolver = (await dynamicModuleLoader(pointer));
+    if (typeof resolver?.resolveHost !== 'function') {
+        throw new Error(`Domain resolver [${pointer.functionName}] in [${pointer.basePath}/${pointer.relativePath}] must be a DomainResolver ({ resolveHost })`);
+    }
+    return resolver;
+};
+//# sourceMappingURL=loadDomainResolver.js.map

package/lib/esm/domain/logic/resolver/loadDomainResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadDomainResolver.js","sourceRoot":"","sources":["../../../../../src/domain/logic/resolver/loadDomainResolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,SAAoB,EAAE,mBAAwC,EAA2B,EAAE;IAClI,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAA0B,CAAC;IAC/E,IAAI,OAAO,QAAQ,EAAE,WAAW,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,oBAAoB,OAAO,CAAC,YAAY,SAAS,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,YAAY,8CAA8C,CACxI,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC","sourcesContent":["import { DynamicModuleLoader, QPQConfig } from 'quidproquo-core';\n\nimport { getDnsConfig } from '../../../configUtils/dns/getDnsConfig';\nimport { DomainResolver } from '../../../domain/types/DomainResolver';\nimport { getDomainResolver } from './getDomainResolver';\n\n/**\n * The resolver a runtime should use: the Dns setting's pointer loaded through the dynamic\n * module loader (the pointer is a src entry, so the bundler includes it), else the\n * localhost or default built-in. Processor factories call this once and close over it.\n */\nexport const loadDomainResolver = async (qpqConfig: QPQConfig, dynamicModuleLoader: DynamicModuleLoader): Promise<DomainResolver> => {\n  const pointer = getDnsConfig(qpqConfig)?.resolver;\n  if (!pointer) {\n    return getDomainResolver(qpqConfig);\n  }\n\n  const resolver = (await dynamicModuleLoader(pointer)) as DomainResolver | null;\n  if (typeof resolver?.resolveHost !== 'function') {\n    throw new Error(\n      `Domain resolver [${pointer.functionName}] in [${pointer.basePath}/${pointer.relativePath}] must be a DomainResolver ({ resolveHost })`,\n    );\n  }\n\n  return resolver;\n};\n"]}

package/lib/esm/domain/logic/resolver/validateResolvedHost.d.ts

@@ -0,0 +1,3 @@
+import { DomainScope } from '../../../domain/types/DomainScope';
+/** A resolver may shape labels under the root but never invent another apex. */
+export declare const validateResolvedHost: (host: string, scope: DomainScope) => string;

package/lib/esm/domain/logic/resolver/validateResolvedHost.js

@@ -0,0 +1,9 @@
+/** A resolver may shape labels under the root but never invent another apex. */
+export const validateResolvedHost = (host, scope) => {
+    const isUnderRoot = host === scope.rootDomain || host.endsWith(`.${scope.rootDomain}`);
+    if (!host || !isUnderRoot) {
+        throw new Error(`Domain resolver returned [${host}] for root [${scope.rootDomain}]; hosts must be the root or end with .${scope.rootDomain}`);
+    }
+    return host;
+};
+//# sourceMappingURL=validateResolvedHost.js.map

package/lib/esm/domain/logic/resolver/validateResolvedHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateResolvedHost.js","sourceRoot":"","sources":["../../../../../src/domain/logic/resolver/validateResolvedHost.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAE,KAAkB,EAAU,EAAE;IAC/E,MAAM,WAAW,GAAG,IAAI,KAAK,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAEvF,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,eAAe,KAAK,CAAC,UAAU,0CAA0C,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAChJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC","sourcesContent":["import { DomainScope } from '../../../domain/types/DomainScope';\n\n/** A resolver may shape labels under the root but never invent another apex. */\nexport const validateResolvedHost = (host: string, scope: DomainScope): string => {\n  const isUnderRoot = host === scope.rootDomain || host.endsWith(`.${scope.rootDomain}`);\n\n  if (!host || !isUnderRoot) {\n    throw new Error(`Domain resolver returned [${host}] for root [${scope.rootDomain}]; hosts must be the root or end with .${scope.rootDomain}`);\n  }\n\n  return host;\n};\n"]}

package/lib/esm/domain/resolvers/defaultDomainResolver.d.ts

@@ -0,0 +1,3 @@
+import { DomainResolver } from '../../domain/types/DomainResolver';
+/** `[subdomain.][service.][feature.][environment.]root`, with no environment label in production. */
+export declare const defaultDomainResolver: DomainResolver;

package/lib/esm/domain/resolvers/defaultDomainResolver.js

@@ -0,0 +1,8 @@
+/** `[subdomain.][service.][feature.][environment.]root`, with no environment label in production. */
+export const defaultDomainResolver = {
+    resolveHost: ({ rootDomain, environment, feature, service, subdomain }) => {
+        const environmentLabel = environment === 'production' ? undefined : environment;
+        return [subdomain, service, feature, environmentLabel, rootDomain].filter(Boolean).join('.');
+    },
+};
+//# sourceMappingURL=defaultDomainResolver.js.map

package/lib/esm/domain/resolvers/defaultDomainResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultDomainResolver.js","sourceRoot":"","sources":["../../../../src/domain/resolvers/defaultDomainResolver.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;QACxE,MAAM,gBAAgB,GAAG,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;QAEhF,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/F,CAAC;CACF,CAAC","sourcesContent":["import { DomainResolver } from '../../domain/types/DomainResolver';\n\n/** `[subdomain.][service.][feature.][environment.]root`, with no environment label in production. */\nexport const defaultDomainResolver: DomainResolver = {\n  resolveHost: ({ rootDomain, environment, feature, service, subdomain }) => {\n    const environmentLabel = environment === 'production' ? undefined : environment;\n\n    return [subdomain, service, feature, environmentLabel, rootDomain].filter(Boolean).join('.');\n  },\n};\n"]}

package/lib/esm/domain/resolvers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './defaultDomainResolver';
+export * from './localhostDomainResolver';

package/lib/esm/domain/resolvers/index.js

@@ -0,0 +1,3 @@
+export * from './defaultDomainResolver';
+export * from './localhostDomainResolver';
+//# sourceMappingURL=index.js.map

package/lib/esm/domain/resolvers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain/resolvers/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC","sourcesContent":["export * from './defaultDomainResolver';\nexport * from './localhostDomainResolver';\n"]}

package/lib/esm/domain/resolvers/localhostDomainResolver.d.ts

@@ -0,0 +1,3 @@
+import { DomainResolver } from '../../domain/types/DomainResolver';
+/** Every scope is the root itself (`localhost:3080`): the dev server serves everything from one host. */
+export declare const localhostDomainResolver: DomainResolver;

package/lib/esm/domain/resolvers/localhostDomainResolver.js

@@ -0,0 +1,5 @@
+/** Every scope is the root itself (`localhost:3080`): the dev server serves everything from one host. */
+export const localhostDomainResolver = {
+    resolveHost: ({ rootDomain }) => rootDomain,
+};
+//# sourceMappingURL=localhostDomainResolver.js.map

package/lib/esm/domain/resolvers/localhostDomainResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localhostDomainResolver.js","sourceRoot":"","sources":["../../../../src/domain/resolvers/localhostDomainResolver.ts"],"names":[],"mappings":"AAEA,yGAAyG;AACzG,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU;CAC5C,CAAC","sourcesContent":["import { DomainResolver } from '../../domain/types/DomainResolver';\n\n/** Every scope is the root itself (`localhost:3080`): the dev server serves everything from one host. */\nexport const localhostDomainResolver: DomainResolver = {\n  resolveHost: ({ rootDomain }) => rootDomain,\n};\n"]}

package/lib/esm/domain/types/DomainResolver.d.ts

@@ -0,0 +1,10 @@
+import { DomainScope } from './DomainScope';
+/**
+ * App-authored hostname shape, handed to the deploy tooling (never placed on config). Must be
+ * pure and deterministic: it runs at synth and build time only, and its output is
+ * materialised into config for the runtime. The returned host must be `scope.rootDomain` or
+ * end with `.${scope.rootDomain}`.
+ */
+export type DomainResolver = {
+    resolveHost: (scope: DomainScope) => string;
+};

package/lib/esm/domain/types/DomainResolver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DomainResolver.js.map

package/lib/esm/domain/types/DomainResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainResolver.js","sourceRoot":"","sources":["../../../../src/domain/types/DomainResolver.ts"],"names":[],"mappings":"","sourcesContent":["import { DomainScope } from './DomainScope';\n\n/**\n * App-authored hostname shape, handed to the deploy tooling (never placed on config). Must be\n * pure and deterministic: it runs at synth and build time only, and its output is\n * materialised into config for the runtime. The returned host must be `scope.rootDomain` or\n * end with `.${scope.rootDomain}`.\n */\nexport type DomainResolver = {\n  resolveHost: (scope: DomainScope) => string;\n};\n"]}

package/lib/esm/domain/types/DomainScope.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Everything a domain resolver is told when asked for one hostname: which root, which
+ * deploy, and which part of the app the host is for. `service` is set for hosts scoped to
+ * one service (a websocket or web entry that is not on the root domain); `subdomain` is the
+ * app-level label (`api`, `views`, `ws`); both absent means the site root itself.
+ */
+export type DomainScope = {
+    rootDomain: string;
+    environment: string;
+    feature?: string;
+    service?: string;
+    subdomain?: string;
+};

package/lib/esm/domain/types/DomainScope.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DomainScope.js.map

package/lib/esm/domain/types/DomainScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainScope.js","sourceRoot":"","sources":["../../../../src/domain/types/DomainScope.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Everything a domain resolver is told when asked for one hostname: which root, which\n * deploy, and which part of the app the host is for. `service` is set for hosts scoped to\n * one service (a websocket or web entry that is not on the root domain); `subdomain` is the\n * app-level label (`api`, `views`, `ws`); both absent means the site root itself.\n */\nexport type DomainScope = {\n  rootDomain: string;\n  environment: string;\n  feature?: string;\n  service?: string;\n  subdomain?: string;\n};\n"]}

package/lib/esm/domain/types/DomainTarget.d.ts

@@ -0,0 +1,5 @@
+/** The part of a DomainScope a caller chooses; root, environment and feature come from config. */
+export type DomainTarget = {
+    service?: string;
+    subdomain?: string;
+};

package/lib/esm/domain/types/DomainTarget.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DomainTarget.js.map

package/lib/esm/domain/types/DomainTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainTarget.js","sourceRoot":"","sources":["../../../../src/domain/types/DomainTarget.ts"],"names":[],"mappings":"","sourcesContent":["/** The part of a DomainScope a caller chooses; root, environment and feature come from config. */\nexport type DomainTarget = {\n  service?: string;\n  subdomain?: string;\n};\n"]}

package/lib/esm/domain/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './DomainResolver';
+export * from './DomainScope';
+export * from './DomainTarget';

package/lib/esm/domain/types/index.js

@@ -0,0 +1,4 @@
+export * from './DomainResolver';
+export * from './DomainScope';
+export * from './DomainTarget';
+//# sourceMappingURL=index.js.map

package/lib/esm/domain/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC","sourcesContent":["export * from './DomainResolver';\nexport * from './DomainScope';\nexport * from './DomainTarget';\n"]}

package/lib/esm/index.d.ts

@@ -1,6 +1,7 @@
 export * from './actionProcessor';
 export * from './actions';
 export * from './config';
+export * from './domain';
 export * from './qpqWebServerUtils';
 export * from './services';
 export * from './stories';

package/lib/esm/index.js

@@ -1,6 +1,7 @@
 export * from './actionProcessor';
 export * from './actions';
 export * from './config';
+export * from './domain';
 export * from './qpqWebServerUtils';
 export * from './services';
 export * from './stories';

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC","sourcesContent":["export * from './actionProcessor';\nexport * from './actions';\nexport * from './config';\nexport * from './qpqWebServerUtils';\nexport * from './services';\nexport * from './stories';\nexport * from './types';\nexport * from './utils';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC","sourcesContent":["export * from './actionProcessor';\nexport * from './actions';\nexport * from './config';\nexport * from './domain';\nexport * from './qpqWebServerUtils';\nexport * from './services';\nexport * from './stories';\nexport * from './types';\nexport * from './utils';\n"]}

package/lib/esm/stories/index.d.ts

@@ -1,3 +1,2 @@
-export * from './askGetDomainRoot';
 export * from './askGetHttpApiEventStorySession';
 export * from './askValidateRouteAuth';

package/lib/esm/stories/index.js

@@ -1,4 +1,3 @@
-export * from './askGetDomainRoot';
 export * from './askGetHttpApiEventStorySession';
 export * from './askValidateRouteAuth';
 //# sourceMappingURL=index.js.map

package/lib/esm/stories/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stories/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC","sourcesContent":["export * from './askGetDomainRoot';\nexport * from './askGetHttpApiEventStorySession';\nexport * from './askValidateRouteAuth';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stories/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC","sourcesContent":["export * from './askGetHttpApiEventStorySession';\nexport * from './askValidateRouteAuth';\n"]}