@lssm/lib.contracts 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217072406

package/dist/app-config/runtime.js

@@ -1 +1,617 @@
-function e(e,t,m={}){let g=n(e.capabilities,t.capabilities),_=r(e.features,t.features),v=i(e.dataViews??{},t.dataViewOverrides),y=i(e.workflows??{},t.workflowOverrides),b=a(e.policies??[],t.additionalPolicies??[]),x=o(e.theme,t.themeOverride),S=s(e.telemetry,t.telemetryOverride),C=c(e.experiments,t.experiments),w=d(e.featureFlags??[],t.featureFlags??[]),T=f(e.routes??[],t.routeOverrides??[]),{resolved:E}=p(e.integrationSlots,t.integrations,m.integrationConnections,m.integrationSpecs),D=h(t.knowledge,m.knowledgeSpaces,m.knowledgeSources),O=l(e.branding,t),k=u(e.translationCatalog,t.locales,t.translationOverrides);return{appId:e.meta.appId,tenantId:t.meta.tenantId,environment:t.meta.environment,blueprintName:e.meta.name,blueprintVersion:e.meta.version,configVersion:t.meta.version,capabilities:g,features:_,dataViews:v,workflows:y,policies:b,theme:x,telemetry:S,experiments:C,featureFlags:w,routes:T,integrations:E,knowledge:D,translation:k,branding:O,notes:t.notes??e.notes}}function t(t,n,r,i={}){let a=e(t,n,r),o=[],s=p(t.integrationSlots,n.integrations,r.integrationConnections,r.integrationSpecs);a.integrations=s.resolved,o.push(...s.missing),o.push(...g(n.knowledge??[],r.knowledgeSpaces,r.knowledgeSources));let c=_(a.capabilities.enabled,r.capabilities,o),l=v(a.features.include,r.features,o),u=y(a.dataViews,r.dataViews,`dataView`,o),d=y(a.workflows,r.workflows,`workflow`,o),f=b(a.policies,r.policies,o),{theme:m,fallbacks:h,themeMissing:w}=x(a.theme,r.themes);o.push(...w);let{telemetry:T,telemetryMissing:E}=S(a.telemetry,r.telemetry);o.push(...E);let D=C(a.experiments,r.experiments,o);if(i.strict&&o.length>0){let e=o.map(e=>`${e.type}:${e.identifier}`).join(`, `);throw Error(`composeAppConfig: missing references -> ${e}`)}return{resolved:a,capabilities:c,features:l,dataViews:u,workflows:d,policies:f,theme:m,themeFallbacks:h,telemetry:T,experiments:D,integrations:a.integrations,knowledge:a.knowledge,missing:o}}function n(e,t){let n=k([...e?.enabled??[],...t?.enable??[]],w),r=k([...e?.disabled??[],...t?.disable??[]],w),i=new Set(r.map(w));return{enabled:n.filter(e=>!i.has(w(e))),disabled:r}}function r(e,t){let n=k([...e?.include??[],...t?.include??[]],T),r=k([...e?.exclude??[],...t?.exclude??[]],T),i=new Set(r.map(T));return{include:n.filter(e=>!i.has(T(e))),exclude:r}}function i(e,t){let n={...e};if(!t)return n;for(let e of t)e&&(e.pointer?n[e.slot]=e.pointer:delete n[e.slot]);return n}function a(e,t){return k([...e,...t],D)}function o(e,t){if(!e&&!t)return;let n=t?.primary??e?.primary;if(n)return{primary:n,fallbacks:t?.fallbacks??e?.fallbacks??[]}}function s(e,t){if(!e&&!t)return;let n={spec:e?.spec,disabledEvents:e?.disabledEvents?[...e.disabledEvents]:void 0,samplingOverrides:e?.samplingOverrides?{...e.samplingOverrides}:void 0};if(t?.spec!==void 0&&(n.spec=t.spec??void 0),t?.disabledEvents&&(n.disabledEvents=A([...n.disabledEvents??[],...t.disabledEvents])),t?.samplingOverrides&&(n.samplingOverrides={...n.samplingOverrides??{},...t.samplingOverrides}),!(!n.spec&&!n.disabledEvents?.length))return n}function c(e,t){let n=e?.active??[],r=e?.paused??[],i=t?.active,a=t?.paused,o=i&&i.length>0?i:n,s=a&&a.length>0?a:r,c=k(o,O),l=k(s,O),u=new Set(c.map(O));return l=l.filter(e=>!u.has(O(e))),{catalog:k([...n,...r,...i??[],...a??[]],O),active:c,paused:l}}function l(e,t){let n=t.branding,r=t.meta,i=`app.localhost`,a=n?.customDomain??(n?.subdomain?`${n.subdomain}.${i}`:`${r.tenantId}.${i}`),o=[];t.locales?.defaultLocale&&o.push(t.locales.defaultLocale),n?.appName&&o.push(`default`,`en`);let s;if(n?.appName){for(let e of o){let t=n.appName[e];if(t){s=t;break}}if(!s){let[,e]=Object.entries(n.appName)[0]??[];typeof e==`string`&&(s=e)}}s||=e?.appNameKey??r.appId;let c=new Map,l=e=>{if(e)for(let t of e)t?.type&&`url`in t&&t.url&&c.set(t.type,t.url)};l(e?.assets),l(n?.assets);let u={logo:c.get(`logo`),logoDark:c.get(`logo-dark`),favicon:c.get(`favicon`),ogImage:c.get(`og-image`)},d={primary:n?.colors?.primary??e?.colorTokens?.primary??`#1f2937`,secondary:n?.colors?.secondary??e?.colorTokens?.secondary??`#4b5563`};return{appName:s,assets:u,colors:d,domain:a}}function u(e,t,n){let r=t?.defaultLocale??`en`;return{defaultLocale:r,supportedLocales:A([r,...t?.enabledLocales??[]]),blueprintCatalog:e,tenantOverrides:n?.entries??[]}}function d(e,t){let n=new Map;for(let t of e)n.set(t.key,{...t});for(let e of t)n.set(e.key,{...e});return[...n.values()]}function f(e,t){let n=new Map;for(let t of e)n.set(t.path,{...t});for(let e of t){let t=n.get(e.path)??{path:e.path};e.label!==void 0&&(e.label===null?delete t.label:t.label=e.label),e.dataView!==void 0&&(e.dataView===null?delete t.dataView:t.dataView=e.dataView),e.workflow!==void 0&&(e.workflow===null?delete t.workflow:t.workflow=e.workflow),e.guard!==void 0&&(e.guard===null?delete t.guard:t.guard=e.guard),e.featureFlag!==void 0&&(e.featureFlag===null?delete t.featureFlag:t.featureFlag=e.featureFlag),e.experiment!==void 0&&(e.experiment===null?delete t.experiment:t.experiment=e.experiment),n.set(t.path,t)}return[...n.values()]}function p(e,t,n,r){let i=[],a=[],o=new Set,s=e=>{let t=`${e.type}:${e.identifier}`;o.has(t)||(o.add(t),a.push(e))},c=e??[],l=new Map;for(let e of c)l.set(e.slotId,e);let u=new Map;for(let e of t??[]){if(!l.get(e.slotId)){s({type:`integrationSlot`,identifier:`slot:${e.slotId}`});continue}let t=u.get(e.slotId);t?t.push(e):u.set(e.slotId,[e])}for(let e of c){let t=u.get(e.slotId)??[];e.required&&t.length===0&&s({type:`integrationSlot`,identifier:`slot:${e.slotId}`})}if(!n||!r)return{resolved:i,missing:a};let d=new Map;for(let e of n)d.set(e.meta.id,e);for(let e of c){let t=u.get(e.slotId)??[];if(t.length===0)continue;let n=[...t].sort((e,t)=>{let n=e.priority??2**53-1,r=t.priority??2**53-1;return n===r?0:n<r?-1:1}),a=!1;for(let t of n){let n=d.get(t.connectionId);if(!n){s({type:`integrationConnection`,identifier:`connection:${t.connectionId}`});continue}let o=r.get(n.meta.integrationKey,n.meta.integrationVersion);if(!o){s({type:`integrationSpec`,identifier:`spec:${n.meta.integrationKey}.v${n.meta.integrationVersion}`});continue}if(o.meta.category!==e.requiredCategory){s({type:`integrationSpec`,identifier:`spec:${o.meta.key}.category`});continue}if(!o.supportedModes.includes(n.ownershipMode)){s({type:`integrationSpec`,identifier:`spec:${o.meta.key}.mode:${n.ownershipMode}`});continue}if(e.allowedModes&&e.allowedModes.length>0&&!e.allowedModes.includes(n.ownershipMode)){s({type:`integrationConnection`,identifier:`connection:${n.meta.id}:mode`});continue}if(e.requiredCapabilities&&!e.requiredCapabilities.every(e=>m(o,e))){s({type:`integrationSpec`,identifier:`spec:${o.meta.key}.capabilities`});continue}i.push({slot:e,binding:t,connection:n,spec:o}),a=!0;break}!a&&e.required&&s({type:`integrationSlot`,identifier:`slot:${e.slotId}`})}return{resolved:i,missing:a}}function m(e,t){return e.capabilities.provides.some(e=>e.key===t.key?t.version==null?!0:e.version===t.version:!1)}function h(e,t,n){if(!e?.length||!t)return[];let r=n??[];return e.map(e=>{let n=t.get(e.spaceKey,e.spaceVersion);return n?{binding:e,space:n,sources:r.filter(t=>t.meta.spaceKey===e.spaceKey?e.spaceVersion==null?!0:t.meta.spaceVersion===e.spaceVersion:!1)}:null}).filter(e=>e!==null)}function g(e,t,n){if(!e.length||!t)return[];let r=[],i=n??[];for(let a of e){if(!t.get(a.spaceKey,a.spaceVersion)){r.push({type:`knowledgeSpace`,identifier:a.spaceVersion?`${a.spaceKey}@${a.spaceVersion}`:a.spaceKey});continue}n&&i.filter(e=>e.meta.spaceKey===a.spaceKey?a.spaceVersion==null?!0:e.meta.spaceVersion===a.spaceVersion:!1).length===0&&r.push({type:`knowledgeSource`,identifier:a.spaceVersion?`${a.spaceKey}@${a.spaceVersion}`:a.spaceKey})}return r}function _(e,t,n){if(!t){if(e.length>0)for(let t of e)n.push({type:`capability`,identifier:w(t)});return[]}let r=[];for(let i of e){let e=t.get(i.key,i.version);if(!e){n.push({type:`capability`,identifier:w(i)});continue}r.push(e)}return r}function v(e,t,n){if(!t){if(e.length>0)for(let t of e)n.push({type:`feature`,identifier:t.key});return[]}let r=[];for(let i of e){let e=t.get(i.key);if(!e){n.push({type:`feature`,identifier:i.key});continue}r.push(e)}return r}function y(e,t,n,r){if(!t){if(Object.keys(e).length>0)for(let[t,i]of Object.entries(e))r.push({type:n,identifier:`${t} -> ${E(i)}`});return{}}let i={};for(let[a,o]of Object.entries(e)){let e=t.get(o.name,o.version);if(!e){r.push({type:n,identifier:`${a} -> ${E(o)}`});continue}i[a]=e}return i}function b(e,t,n){if(!t){if(e.length>0)for(let t of e)n.push({type:`policy`,identifier:D(t)});return[]}let r=[];for(let i of e){let e=t.get(i.name,i.version);if(!e){n.push({type:`policy`,identifier:D(i)});continue}r.push(e)}return r}function x(e,t){let n=[];if(!e)return{theme:void 0,fallbacks:[],themeMissing:n};if(!t){n.push({type:`theme`,identifier:`${e.primary.name}.v${e.primary.version}`});for(let t of e.fallbacks??[])n.push({type:`theme`,identifier:`${t.name}.v${t.version}`});return{theme:void 0,fallbacks:[],themeMissing:n}}let r=t.get(e.primary.name,e.primary.version);r||n.push({type:`theme`,identifier:`${e.primary.name}.v${e.primary.version}`});let i=[];for(let r of e.fallbacks??[]){let e=t.get(r.name,r.version);if(!e){n.push({type:`theme`,identifier:`${r.name}.v${r.version}`});continue}i.push(e)}return{theme:r??void 0,fallbacks:i,themeMissing:n}}function S(e,t){let n=[];if(!e?.spec)return{telemetry:void 0,telemetryMissing:n};if(!t)return n.push({type:`telemetry`,identifier:E(e.spec)}),{telemetry:void 0,telemetryMissing:n};let r=t.get(e.spec.name,e.spec.version);return r||n.push({type:`telemetry`,identifier:E(e.spec)}),{telemetry:r??void 0,telemetryMissing:n}}function C(e,t,n){let r=e=>{if(e.length===0)return[];if(!t){for(let t of e)n.push({type:`experiment`,identifier:O(t)});return[]}let r=[];for(let i of e){let e=t.get(i.name,i.version);if(!e){n.push({type:`experiment`,identifier:O(i)});continue}r.push(e)}return r};return{active:r(e.active),paused:r(e.paused)}}function w(e){return`${e.key}${e.version?`.v${e.version}`:``}`}function T(e){return e.key}function E(e){return`${e.name}${e.version?`.v${e.version}`:``}`}function D(e){return`${e.name}${e.version?`.v${e.version}`:``}`}function O(e){return`${e.name}${e.version?`.v${e.version}`:``}`}function k(e,t){let n=new Map;for(let r of e)n.set(t(r),r);return[...n.values()]}function A(e){return[...new Set(e)]}export{t as composeAppConfig,e as resolveAppConfig};
+//#region src/app-config/runtime.ts
+function resolveAppConfig(blueprint, tenant, deps = {}) {
+	const capabilities = mergeCapabilities(blueprint.capabilities, tenant.capabilities);
+	const features = mergeFeatures(blueprint.features, tenant.features);
+	const dataViews = mergeMappings(blueprint.dataViews ?? {}, tenant.dataViewOverrides);
+	const workflows = mergeMappings(blueprint.workflows ?? {}, tenant.workflowOverrides);
+	const policies = mergePolicies(blueprint.policies ?? [], tenant.additionalPolicies ?? []);
+	const theme = mergeTheme(blueprint.theme, tenant.themeOverride);
+	const telemetry = mergeTelemetry(blueprint.telemetry, tenant.telemetryOverride);
+	const experiments = mergeExperiments(blueprint.experiments, tenant.experiments);
+	const featureFlags = mergeFeatureFlags(blueprint.featureFlags ?? [], tenant.featureFlags ?? []);
+	const routes = mergeRoutes(blueprint.routes ?? [], tenant.routeOverrides ?? []);
+	const { resolved: integrations } = evaluateIntegrationSlots(blueprint.integrationSlots, tenant.integrations, deps.integrationConnections, deps.integrationSpecs);
+	const knowledge = resolveKnowledgeBindings(tenant.knowledge, deps.knowledgeSpaces, deps.knowledgeSources);
+	const branding = resolveBranding(blueprint.branding, tenant);
+	const translation = resolveTranslation(blueprint.translationCatalog, tenant.locales, tenant.translationOverrides);
+	return {
+		appId: blueprint.meta.appId,
+		tenantId: tenant.meta.tenantId,
+		environment: tenant.meta.environment,
+		blueprintName: blueprint.meta.name,
+		blueprintVersion: blueprint.meta.version,
+		configVersion: tenant.meta.version,
+		capabilities,
+		features,
+		dataViews,
+		workflows,
+		policies,
+		theme,
+		telemetry,
+		experiments,
+		featureFlags,
+		routes,
+		integrations,
+		knowledge,
+		translation,
+		branding,
+		notes: tenant.notes ?? blueprint.notes
+	};
+}
+function composeAppConfig(blueprint, tenant, deps, options = {}) {
+	const resolved = resolveAppConfig(blueprint, tenant, deps);
+	const missing = [];
+	const integrationEvaluation = evaluateIntegrationSlots(blueprint.integrationSlots, tenant.integrations, deps.integrationConnections, deps.integrationSpecs);
+	resolved.integrations = integrationEvaluation.resolved;
+	missing.push(...integrationEvaluation.missing);
+	missing.push(...collectMissingKnowledge(tenant.knowledge ?? [], deps.knowledgeSpaces, deps.knowledgeSources));
+	const capabilities = resolveCapabilityRefs(resolved.capabilities.enabled, deps.capabilities, missing);
+	const features = resolveFeatureRefs(resolved.features.include, deps.features, missing);
+	const dataViews = resolvePointerRecord(resolved.dataViews, deps.dataViews, "dataView", missing);
+	const workflows = resolvePointerRecord(resolved.workflows, deps.workflows, "workflow", missing);
+	const policies = resolvePolicies(resolved.policies, deps.policies, missing);
+	const { theme, fallbacks, themeMissing } = resolveThemeBinding(resolved.theme, deps.themes);
+	missing.push(...themeMissing);
+	const { telemetry, telemetryMissing } = resolveTelemetryBinding(resolved.telemetry, deps.telemetry);
+	missing.push(...telemetryMissing);
+	const experiments = resolveExperimentsSpecs(resolved.experiments, deps.experiments, missing);
+	if (options.strict && missing.length > 0) {
+		const reasons = missing.map((item) => `${item.type}:${item.identifier}`).join(", ");
+		throw new Error(`composeAppConfig: missing references -> ${reasons}`);
+	}
+	return {
+		resolved,
+		capabilities,
+		features,
+		dataViews,
+		workflows,
+		policies,
+		theme,
+		themeFallbacks: fallbacks,
+		telemetry,
+		experiments,
+		integrations: resolved.integrations,
+		knowledge: resolved.knowledge,
+		missing
+	};
+}
+function mergeCapabilities(blueprint, tenant) {
+	const enabled = dedupeRefs([...blueprint?.enabled ?? [], ...tenant?.enable ?? []], capabilityKey);
+	const disabled = dedupeRefs([...blueprint?.disabled ?? [], ...tenant?.disable ?? []], capabilityKey);
+	const disabledKeys = new Set(disabled.map(capabilityKey));
+	return {
+		enabled: enabled.filter((ref) => !disabledKeys.has(capabilityKey(ref))),
+		disabled
+	};
+}
+function mergeFeatures(blueprint, tenant) {
+	const include = dedupeRefs([...blueprint?.include ?? [], ...tenant?.include ?? []], featureKey);
+	const exclude = dedupeRefs([...blueprint?.exclude ?? [], ...tenant?.exclude ?? []], featureKey);
+	const excludeSet = new Set(exclude.map(featureKey));
+	return {
+		include: include.filter((ref) => !excludeSet.has(featureKey(ref))),
+		exclude
+	};
+}
+function mergeMappings(blueprint, overrides) {
+	const merged = { ...blueprint };
+	if (!overrides) return merged;
+	for (const override of overrides) {
+		if (!override) continue;
+		if (!override.pointer) delete merged[override.slot];
+		else merged[override.slot] = override.pointer;
+	}
+	return merged;
+}
+function mergePolicies(blueprint, additional) {
+	return dedupeRefs([...blueprint, ...additional], policyKey);
+}
+function mergeTheme(blueprint, override) {
+	if (!blueprint && !override) return void 0;
+	const primary = override?.primary ?? blueprint?.primary;
+	if (!primary) return void 0;
+	return {
+		primary,
+		fallbacks: override?.fallbacks ?? blueprint?.fallbacks ?? []
+	};
+}
+function mergeTelemetry(blueprint, override) {
+	if (!blueprint && !override) return void 0;
+	const binding = {
+		spec: blueprint?.spec,
+		disabledEvents: blueprint?.disabledEvents ? [...blueprint.disabledEvents] : void 0,
+		samplingOverrides: blueprint?.samplingOverrides ? { ...blueprint.samplingOverrides } : void 0
+	};
+	if (override?.spec !== void 0) binding.spec = override.spec ?? void 0;
+	if (override?.disabledEvents) binding.disabledEvents = dedupeStrings([...binding.disabledEvents ?? [], ...override.disabledEvents]);
+	if (override?.samplingOverrides) binding.samplingOverrides = {
+		...binding.samplingOverrides ?? {},
+		...override.samplingOverrides
+	};
+	if (!binding.spec && !binding.disabledEvents?.length) return;
+	return binding;
+}
+function mergeExperiments(blueprint, tenant) {
+	const defaultActive = blueprint?.active ?? [];
+	const defaultPaused = blueprint?.paused ?? [];
+	const tenantActive = tenant?.active;
+	const tenantPaused = tenant?.paused;
+	const activeSource = tenantActive && tenantActive.length > 0 ? tenantActive : defaultActive;
+	const pausedSource = tenantPaused && tenantPaused.length > 0 ? tenantPaused : defaultPaused;
+	const active = dedupeRefs(activeSource, experimentKey);
+	let paused = dedupeRefs(pausedSource, experimentKey);
+	const activeKeys = new Set(active.map(experimentKey));
+	paused = paused.filter((ref) => !activeKeys.has(experimentKey(ref)));
+	return {
+		catalog: dedupeRefs([
+			...defaultActive,
+			...defaultPaused,
+			...tenantActive ?? [],
+			...tenantPaused ?? []
+		], experimentKey),
+		active,
+		paused
+	};
+}
+function resolveBranding(defaults, tenant) {
+	const override = tenant.branding;
+	const tenantMeta = tenant.meta;
+	const baseDomain = "app.localhost";
+	const domain = override?.customDomain ?? (override?.subdomain ? `${override.subdomain}.${baseDomain}` : `${tenantMeta.tenantId}.${baseDomain}`);
+	const localePreferenceOrder = [];
+	if (tenant.locales?.defaultLocale) localePreferenceOrder.push(tenant.locales.defaultLocale);
+	if (override?.appName) localePreferenceOrder.push("default", "en");
+	let appName;
+	if (override?.appName) {
+		for (const key of localePreferenceOrder) {
+			const candidate = override.appName[key];
+			if (candidate) {
+				appName = candidate;
+				break;
+			}
+		}
+		if (!appName) {
+			const [, firstValue] = Object.entries(override.appName)[0] ?? [];
+			if (typeof firstValue === "string") appName = firstValue;
+		}
+	}
+	if (!appName) appName = defaults?.appNameKey ?? tenantMeta.appId;
+	const assetEntries = /* @__PURE__ */ new Map();
+	const applyAssets = (assets$1) => {
+		if (!assets$1) return;
+		for (const asset of assets$1) {
+			if (!asset?.type) continue;
+			if ("url" in asset && asset.url) assetEntries.set(asset.type, asset.url);
+		}
+	};
+	applyAssets(defaults?.assets);
+	applyAssets(override?.assets);
+	const assets = {
+		logo: assetEntries.get("logo"),
+		logoDark: assetEntries.get("logo-dark"),
+		favicon: assetEntries.get("favicon"),
+		ogImage: assetEntries.get("og-image")
+	};
+	const colors = {
+		primary: override?.colors?.primary ?? defaults?.colorTokens?.primary ?? "#1f2937",
+		secondary: override?.colors?.secondary ?? defaults?.colorTokens?.secondary ?? "#4b5563"
+	};
+	return {
+		appName,
+		assets,
+		colors,
+		domain
+	};
+}
+function resolveTranslation(catalogPointer, locales, overrides) {
+	const defaultLocale = locales?.defaultLocale ?? "en";
+	return {
+		defaultLocale,
+		supportedLocales: dedupeStrings([defaultLocale, ...locales?.enabledLocales ?? []]),
+		blueprintCatalog: catalogPointer,
+		tenantOverrides: overrides?.entries ?? []
+	};
+}
+function mergeFeatureFlags(blueprint, overrides) {
+	const merged = /* @__PURE__ */ new Map();
+	for (const flag of blueprint) merged.set(flag.key, { ...flag });
+	for (const override of overrides) merged.set(override.key, { ...override });
+	return [...merged.values()];
+}
+function mergeRoutes(blueprint, overrides) {
+	const routes = /* @__PURE__ */ new Map();
+	for (const route of blueprint) routes.set(route.path, { ...route });
+	for (const override of overrides) {
+		const existing = routes.get(override.path) ?? { path: override.path };
+		if (override.label !== void 0) if (override.label === null) delete existing.label;
+		else existing.label = override.label;
+		if (override.dataView !== void 0) if (override.dataView === null) delete existing.dataView;
+		else existing.dataView = override.dataView;
+		if (override.workflow !== void 0) if (override.workflow === null) delete existing.workflow;
+		else existing.workflow = override.workflow;
+		if (override.guard !== void 0) if (override.guard === null) delete existing.guard;
+		else existing.guard = override.guard;
+		if (override.featureFlag !== void 0) if (override.featureFlag === null) delete existing.featureFlag;
+		else existing.featureFlag = override.featureFlag;
+		if (override.experiment !== void 0) if (override.experiment === null) delete existing.experiment;
+		else existing.experiment = override.experiment;
+		routes.set(existing.path, existing);
+	}
+	return [...routes.values()];
+}
+function evaluateIntegrationSlots(slots, bindings, connections, specs) {
+	const resolved = [];
+	const missing = [];
+	const missingKeys = /* @__PURE__ */ new Set();
+	const recordMissing = (entry) => {
+		const key = `${entry.type}:${entry.identifier}`;
+		if (missingKeys.has(key)) return;
+		missingKeys.add(key);
+		missing.push(entry);
+	};
+	const slotList = slots ?? [];
+	const slotById = /* @__PURE__ */ new Map();
+	for (const slot of slotList) slotById.set(slot.slotId, slot);
+	const bindingsBySlot = /* @__PURE__ */ new Map();
+	for (const binding of bindings ?? []) {
+		if (!slotById.get(binding.slotId)) {
+			recordMissing({
+				type: "integrationSlot",
+				identifier: `slot:${binding.slotId}`
+			});
+			continue;
+		}
+		const entries = bindingsBySlot.get(binding.slotId);
+		if (entries) entries.push(binding);
+		else bindingsBySlot.set(binding.slotId, [binding]);
+	}
+	for (const slot of slotList) {
+		const slotBindings = bindingsBySlot.get(slot.slotId) ?? [];
+		if (slot.required && slotBindings.length === 0) recordMissing({
+			type: "integrationSlot",
+			identifier: `slot:${slot.slotId}`
+		});
+	}
+	if (!connections || !specs) return {
+		resolved,
+		missing
+	};
+	const connectionById = /* @__PURE__ */ new Map();
+	for (const connection of connections) connectionById.set(connection.meta.id, connection);
+	for (const slot of slotList) {
+		const slotBindings = bindingsBySlot.get(slot.slotId) ?? [];
+		if (slotBindings.length === 0) continue;
+		const orderedBindings = [...slotBindings].sort((a, b) => {
+			const aPriority = a.priority ?? Number.MAX_SAFE_INTEGER;
+			const bPriority = b.priority ?? Number.MAX_SAFE_INTEGER;
+			if (aPriority === bPriority) return 0;
+			return aPriority < bPriority ? -1 : 1;
+		});
+		let slotResolved = false;
+		for (const binding of orderedBindings) {
+			const connection = connectionById.get(binding.connectionId);
+			if (!connection) {
+				recordMissing({
+					type: "integrationConnection",
+					identifier: `connection:${binding.connectionId}`
+				});
+				continue;
+			}
+			const spec = specs.get(connection.meta.integrationKey, connection.meta.integrationVersion);
+			if (!spec) {
+				recordMissing({
+					type: "integrationSpec",
+					identifier: `spec:${connection.meta.integrationKey}.v${connection.meta.integrationVersion}`
+				});
+				continue;
+			}
+			if (spec.meta.category !== slot.requiredCategory) {
+				recordMissing({
+					type: "integrationSpec",
+					identifier: `spec:${spec.meta.key}.category`
+				});
+				continue;
+			}
+			if (!spec.supportedModes.includes(connection.ownershipMode)) {
+				recordMissing({
+					type: "integrationSpec",
+					identifier: `spec:${spec.meta.key}.mode:${connection.ownershipMode}`
+				});
+				continue;
+			}
+			if (slot.allowedModes && slot.allowedModes.length > 0 && !slot.allowedModes.includes(connection.ownershipMode)) {
+				recordMissing({
+					type: "integrationConnection",
+					identifier: `connection:${connection.meta.id}:mode`
+				});
+				continue;
+			}
+			if (slot.requiredCapabilities && !slot.requiredCapabilities.every((requirement) => integrationProvidesCapability(spec, requirement))) {
+				recordMissing({
+					type: "integrationSpec",
+					identifier: `spec:${spec.meta.key}.capabilities`
+				});
+				continue;
+			}
+			resolved.push({
+				slot,
+				binding,
+				connection,
+				spec
+			});
+			slotResolved = true;
+			break;
+		}
+		if (!slotResolved && slot.required) recordMissing({
+			type: "integrationSlot",
+			identifier: `slot:${slot.slotId}`
+		});
+	}
+	return {
+		resolved,
+		missing
+	};
+}
+function integrationProvidesCapability(spec, required) {
+	return spec.capabilities.provides.some((capability) => {
+		if (capability.key !== required.key) return false;
+		if (required.version == null) return true;
+		return capability.version === required.version;
+	});
+}
+function resolveKnowledgeBindings(bindings, spaces, sources) {
+	if (!bindings?.length || !spaces) return [];
+	const sourceList = sources ?? [];
+	return bindings.map((binding) => {
+		const space = spaces.get(binding.spaceKey, binding.spaceVersion);
+		if (!space) return null;
+		return {
+			binding,
+			space,
+			sources: sourceList.filter((source) => {
+				if (source.meta.spaceKey !== binding.spaceKey) return false;
+				if (binding.spaceVersion != null) return source.meta.spaceVersion === binding.spaceVersion;
+				return true;
+			})
+		};
+	}).filter((entry) => entry !== null);
+}
+function collectMissingKnowledge(bindings, spaces, sources) {
+	if (!bindings.length || !spaces) return [];
+	const missing = [];
+	const sourceList = sources ?? [];
+	for (const binding of bindings) {
+		if (!spaces.get(binding.spaceKey, binding.spaceVersion)) {
+			missing.push({
+				type: "knowledgeSpace",
+				identifier: binding.spaceVersion ? `${binding.spaceKey}@${binding.spaceVersion}` : binding.spaceKey
+			});
+			continue;
+		}
+		if (sources) {
+			if (sourceList.filter((source) => {
+				if (source.meta.spaceKey !== binding.spaceKey) return false;
+				if (binding.spaceVersion != null) return source.meta.spaceVersion === binding.spaceVersion;
+				return true;
+			}).length === 0) missing.push({
+				type: "knowledgeSource",
+				identifier: binding.spaceVersion ? `${binding.spaceKey}@${binding.spaceVersion}` : binding.spaceKey
+			});
+		}
+	}
+	return missing;
+}
+function resolveCapabilityRefs(refs, registry, missing) {
+	if (!registry) {
+		if (refs.length > 0) for (const ref of refs) missing.push({
+			type: "capability",
+			identifier: capabilityKey(ref)
+		});
+		return [];
+	}
+	const resolved = [];
+	for (const ref of refs) {
+		const spec = registry.get(ref.key, ref.version);
+		if (!spec) {
+			missing.push({
+				type: "capability",
+				identifier: capabilityKey(ref)
+			});
+			continue;
+		}
+		resolved.push(spec);
+	}
+	return resolved;
+}
+function resolveFeatureRefs(refs, registry, missing) {
+	if (!registry) {
+		if (refs.length > 0) for (const ref of refs) missing.push({
+			type: "feature",
+			identifier: ref.key
+		});
+		return [];
+	}
+	const resolved = [];
+	for (const ref of refs) {
+		const spec = registry.get(ref.key);
+		if (!spec) {
+			missing.push({
+				type: "feature",
+				identifier: ref.key
+			});
+			continue;
+		}
+		resolved.push(spec);
+	}
+	return resolved;
+}
+function resolvePointerRecord(record, registry, type, missing) {
+	if (!registry) {
+		if (Object.keys(record).length > 0) for (const [slot, pointer] of Object.entries(record)) missing.push({
+			type,
+			identifier: `${slot} -> ${specPointerKey(pointer)}`
+		});
+		return {};
+	}
+	const resolved = {};
+	for (const [slot, pointer] of Object.entries(record)) {
+		const spec = registry.get(pointer.name, pointer.version);
+		if (!spec) {
+			missing.push({
+				type,
+				identifier: `${slot} -> ${specPointerKey(pointer)}`
+			});
+			continue;
+		}
+		resolved[slot] = spec;
+	}
+	return resolved;
+}
+function resolvePolicies(policies, registry, missing) {
+	if (!registry) {
+		if (policies.length > 0) for (const policy of policies) missing.push({
+			type: "policy",
+			identifier: policyKey(policy)
+		});
+		return [];
+	}
+	const resolved = [];
+	for (const policy of policies) {
+		const spec = registry.get(policy.name, policy.version);
+		if (!spec) {
+			missing.push({
+				type: "policy",
+				identifier: policyKey(policy)
+			});
+			continue;
+		}
+		resolved.push(spec);
+	}
+	return resolved;
+}
+function resolveThemeBinding(binding, registry) {
+	const themeMissing = [];
+	if (!binding) return {
+		theme: void 0,
+		fallbacks: [],
+		themeMissing
+	};
+	if (!registry) {
+		themeMissing.push({
+			type: "theme",
+			identifier: `${binding.primary.name}.v${binding.primary.version}`
+		});
+		for (const fallback of binding.fallbacks ?? []) themeMissing.push({
+			type: "theme",
+			identifier: `${fallback.name}.v${fallback.version}`
+		});
+		return {
+			theme: void 0,
+			fallbacks: [],
+			themeMissing
+		};
+	}
+	const theme = registry.get(binding.primary.name, binding.primary.version);
+	if (!theme) themeMissing.push({
+		type: "theme",
+		identifier: `${binding.primary.name}.v${binding.primary.version}`
+	});
+	const fallbacks = [];
+	for (const fallback of binding.fallbacks ?? []) {
+		const spec = registry.get(fallback.name, fallback.version);
+		if (!spec) {
+			themeMissing.push({
+				type: "theme",
+				identifier: `${fallback.name}.v${fallback.version}`
+			});
+			continue;
+		}
+		fallbacks.push(spec);
+	}
+	return {
+		theme: theme ?? void 0,
+		fallbacks,
+		themeMissing
+	};
+}
+function resolveTelemetryBinding(binding, registry) {
+	const telemetryMissing = [];
+	if (!binding?.spec) return {
+		telemetry: void 0,
+		telemetryMissing
+	};
+	if (!registry) {
+		telemetryMissing.push({
+			type: "telemetry",
+			identifier: specPointerKey(binding.spec)
+		});
+		return {
+			telemetry: void 0,
+			telemetryMissing
+		};
+	}
+	const telemetry = registry.get(binding.spec.name, binding.spec.version);
+	if (!telemetry) telemetryMissing.push({
+		type: "telemetry",
+		identifier: specPointerKey(binding.spec)
+	});
+	return {
+		telemetry: telemetry ?? void 0,
+		telemetryMissing
+	};
+}
+function resolveExperimentsSpecs(experiments, registry, missing) {
+	const resolveList = (refs) => {
+		if (refs.length === 0) return [];
+		if (!registry) {
+			for (const ref of refs) missing.push({
+				type: "experiment",
+				identifier: experimentKey(ref)
+			});
+			return [];
+		}
+		const resolved = [];
+		for (const ref of refs) {
+			const spec = registry.get(ref.name, ref.version);
+			if (!spec) {
+				missing.push({
+					type: "experiment",
+					identifier: experimentKey(ref)
+				});
+				continue;
+			}
+			resolved.push(spec);
+		}
+		return resolved;
+	};
+	return {
+		active: resolveList(experiments.active),
+		paused: resolveList(experiments.paused)
+	};
+}
+function capabilityKey(ref) {
+	return `${ref.key}${ref.version ? `.v${ref.version}` : ""}`;
+}
+function featureKey(ref) {
+	return ref.key;
+}
+function specPointerKey(pointer) {
+	return `${pointer.name}${pointer.version ? `.v${pointer.version}` : ""}`;
+}
+function policyKey(ref) {
+	return `${ref.name}${ref.version ? `.v${ref.version}` : ""}`;
+}
+function experimentKey(ref) {
+	return `${ref.name}${ref.version ? `.v${ref.version}` : ""}`;
+}
+function dedupeRefs(refs, keyFn) {
+	const map = /* @__PURE__ */ new Map();
+	for (const ref of refs) map.set(keyFn(ref), ref);
+	return [...map.values()];
+}
+function dedupeStrings(values) {
+	return [...new Set(values)];
+}
+
+//#endregion
+export { composeAppConfig, resolveAppConfig };

package/dist/app-config/spec.js

@@ -1 +1,36 @@
-const e=e=>`${e.name}.v${e.version}`;var t=class{items=new Map;register(t){let n=e(t.meta);if(this.items.has(n))throw Error(`Duplicate AppBlueprint ${n}`);return this.items.set(n,t),this}list(){return[...this.items.values()]}get(t,n){if(n!=null)return this.items.get(e({name:t,version:n}));let r,i=-1/0;for(let e of this.items.values())e.meta.name===t&&e.meta.version>i&&(i=e.meta.version,r=e);return r}};function n(t){return e(t)}export{t as AppBlueprintRegistry,n as makeAppBlueprintKey};
+//#region src/app-config/spec.ts
+const blueprintKey = (meta) => `${meta.name}.v${meta.version}`;
+var AppBlueprintRegistry = class {
+	items = /* @__PURE__ */ new Map();
+	register(spec) {
+		const key = blueprintKey(spec.meta);
+		if (this.items.has(key)) throw new Error(`Duplicate AppBlueprint ${key}`);
+		this.items.set(key, spec);
+		return this;
+	}
+	list() {
+		return [...this.items.values()];
+	}
+	get(name, version) {
+		if (version != null) return this.items.get(blueprintKey({
+			name,
+			version
+		}));
+		let latest;
+		let maxVersion = -Infinity;
+		for (const spec of this.items.values()) {
+			if (spec.meta.name !== name) continue;
+			if (spec.meta.version > maxVersion) {
+				maxVersion = spec.meta.version;
+				latest = spec;
+			}
+		}
+		return latest;
+	}
+};
+function makeAppBlueprintKey(meta) {
+	return blueprintKey(meta);
+}
+
+//#endregion
+export { AppBlueprintRegistry, makeAppBlueprintKey };