@lssm/lib.contracts 0.0.0-canary-20251217083314 → 0.0.0-canary-20251219202229

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/app-config/app-config.feature.d.ts

@@ -8,4 +8,5 @@ import { FeatureModuleSpec } from "../features.js";
  */
 declare const AppConfigFeature: FeatureModuleSpec;
 //#endregion
-export { AppConfigFeature };
+export { AppConfigFeature };
+//# sourceMappingURL=app-config.feature.d.ts.map

package/dist/app-config/app-config.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.feature.d.ts","names":[],"sources":["../../src/app-config/app-config.feature.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAWa,kBAAkB"}

package/dist/app-config/app-config.feature.js

@@ -50,4 +50,5 @@ const AppConfigFeature = {
 };
 
 //#endregion
-export { AppConfigFeature };
+export { AppConfigFeature };
+//# sourceMappingURL=app-config.feature.js.map

package/dist/app-config/app-config.feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.feature.js","names":["AppConfigFeature: FeatureModuleSpec"],"sources":["../../src/app-config/app-config.feature.ts"],"sourcesContent":["/**\n * App Config Feature Module Specification\n *\n * Defines the feature module for tenant app configuration lifecycle.\n */\nimport type { FeatureModuleSpec } from '../features';\n\n/**\n * App Config feature module that bundles tenant configuration\n * lifecycle events for draft, preview, publish, and rollback stages.\n */\nexport const AppConfigFeature: FeatureModuleSpec = {\n  meta: {\n    key: 'app-config',\n    title: 'App Configuration',\n    description:\n      'Tenant app configuration lifecycle management with draft, preview, and publish stages',\n    domain: 'platform',\n    owners: ['@platform.sigil'],\n    tags: ['app-config', 'lifecycle', 'configuration', 'tenant'],\n    stability: 'beta',\n  },\n\n  // No operations for this feature - it's events-only\n  operations: [],\n\n  // Events emitted by this feature\n  events: [\n    { name: 'app_config.draft_created', version: 1 },\n    { name: 'app_config.promoted_to_preview', version: 1 },\n    { name: 'app_config.published', version: 1 },\n    { name: 'app_config.rolled_back', version: 1 },\n  ],\n\n  // No presentations for this library feature\n  presentations: [],\n  opToPresentation: [],\n  presentationsTargets: [],\n\n  // Capability definitions\n  capabilities: {\n    provides: [{ key: 'app-config', version: 1 }],\n    requires: [],\n  },\n};\n"],"mappings":";;;;;AAWA,MAAaA,mBAAsC;CACjD,MAAM;EACJ,KAAK;EACL,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,kBAAkB;EAC3B,MAAM;GAAC;GAAc;GAAa;GAAiB;GAAS;EAC5D,WAAW;EACZ;CAGD,YAAY,EAAE;CAGd,QAAQ;EACN;GAAE,MAAM;GAA4B,SAAS;GAAG;EAChD;GAAE,MAAM;GAAkC,SAAS;GAAG;EACtD;GAAE,MAAM;GAAwB,SAAS;GAAG;EAC5C;GAAE,MAAM;GAA0B,SAAS;GAAG;EAC/C;CAGD,eAAe,EAAE;CACjB,kBAAkB,EAAE;CACpB,sBAAsB,EAAE;CAGxB,cAAc;EACZ,UAAU,CAAC;GAAE,KAAK;GAAc,SAAS;GAAG,CAAC;EAC7C,UAAU,EAAE;EACb;CACF"}

package/dist/app-config/branding.d.ts

@@ -52,4 +52,5 @@ interface ResolvedBranding {
   domain: string;
 }
 //#endregion
-export { BrandingAssetRef, BrandingDefaults, ResolvedBranding, TenantBrandingAsset, TenantBrandingConfig };
+export { BrandingAssetRef, BrandingDefaults, ResolvedBranding, TenantBrandingAsset, TenantBrandingConfig };
+//# sourceMappingURL=branding.d.ts.map

package/dist/app-config/branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.d.ts","names":[],"sources":["../../src/app-config/branding.ts"],"sourcesContent":[],"mappings":";UAAiB,gBAAA;EAAA,IAAA,EAAA,MAAA,GAAA,WAAgB,GAAA,SAAA,GAAA,UAAA;EAMhB,GAAA,CAAA,EAAA,MAAA;EASA,UAAA,CAAA,EAAA;IAUA,KAAA,EAAA,MAAA;IAWA,MAAA,EAAA,MAAA;;;UA9BA,gBAAA;;WAEN;;;;;;UAOM,mBAAA;;;;;;;;;;;;UAUA,oBAAA;YACL;WACD;;;;;;;;UASM,gBAAA"}

package/dist/app-config/contracts.d.ts

@@ -241,4 +241,5 @@ declare const ResolveMessageQuery: ContractSpec<SchemaModel<{
 declare const appConfigContracts: Record<string, ContractSpec<any, any>>;
 declare function registerAppConfigContracts(registry: SpecRegistry): SpecRegistry;
 //#endregion
-export { GetResolvedBrandingQuery, ResolveMessageQuery, UpdateBlueprintTranslationCatalogCommand, UpdateTenantBrandingCommand, UpdateTenantTranslationOverridesCommand, VerifyCustomDomainCommand, appConfigContracts, registerAppConfigContracts };
+export { GetResolvedBrandingQuery, ResolveMessageQuery, UpdateBlueprintTranslationCatalogCommand, UpdateTenantBrandingCommand, UpdateTenantTranslationOverridesCommand, VerifyCustomDomainCommand, appConfigContracts, registerAppConfigContracts };
+//# sourceMappingURL=contracts.d.ts.map

package/dist/app-config/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","names":[],"sources":["../../src/app-config/contracts.ts"],"sourcesContent":[],"mappings":";;;;;;cAmIa,6BAA2B,aAAA;;UAoBtC,kBAAA,CAAA;IApBW,UAAA,EAAA,KAAA;EAoBX,CAAA;;;;;;;;;;;;;;;MApBsC,IAAA,EAAA;QAAA,IAAA,8BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;QAAA,IAAA,8BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;QAAA,UAAA,EAAA,KAAA;MAsB3B,CAAA;MAoBX,QAAA,EAAA;;;MApBoC,CAAA;IAAA,CAAA,CAAA;;;EAAA,CAAA;EAAA,MAAA,EAAA;IAsBzB,IAAA,8BAoBX,OAAA,CAAA,MAAA,EAAA,OAAA,CAAA,QAAA,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;IAAA,UAAA,EAAA,IAAA;;;;;;;;;;;EApBmD,OAAA,EAAA;IAAA,IAAA,EA5Cb,kBAAA,CAAA,SA4Ca,CAAA,OAAA,EAAA,OAAA,CAAA;;;;IAAA,IAAA,8BAAA,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAsBxC,CAAA;CAoBX,CAAA,EAAA,SAAA,CAAA;cAhEW,2BAAyB,aAAA;;UAoBpC,kBAAA,CAAA;;;;;;EAwBkD,CAAA;EAAA,MAAA,EAAA;;;;CAAA,CAAA,aAAA,CAAA;EAAA,MAAA,EAAA;IAsBvC,IAAA,EAlEyB,kBAAA,CAAA,SAqGpC,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;IAnCmC,IAAA,8BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;cA5CxB,0CAAwC,aAAA;EA4ChB,aAAA,EAAA;IAAA,IAAA,EAxBnC,kBAAA,CAAA,SAwBmC,CAAA,MAAA,EAAA,MAAA,CAAA;IAqCxB,UAAA,EAAA,KAAA;EAqBX,CAAA;;;;EArB8B,CAAA;EAAA,WAAA,EAAA;;;EAAA,CAAA;EAAA,cAAA,EAAA;IAuBnB,IAAA,8BAAmC,CAAA,MAAf,EAAM,MAAA,CAAA;IASvB,UAAA,EAAA,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAjHqC,kBAAA,CAAA;;;;;;;;cAsBxC,yCAAuC,aAAA;;UAoBlD,kBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UApBkD,kBAAA,CAAA;;;;;;;;cAsBvC,0BAAwB,aAAA;;UAmCnC,kBAAA,CAAA;;;;;;;;;;;;;;;;;cAEW,qBAAmB,aAAA;;UAqB9B,kBAAA,CAAA;;;;;;;;;;;;;;;;;UArB8B,kBAAA,CAAA;;;;;;;;cAuBnB,oBAAoB,eAAe;iBAShC,0BAAA,WAAqC,eAAY"}

package/dist/app-config/contracts.js

@@ -1,44 +1,42 @@
-import { ScalarTypeEnum } from "../schema/dist/ScalarTypeEnum.js";
-import { SchemaModel } from "../schema/dist/SchemaModel.js";
-import "../schema/dist/index.js";
+import { E5, x8 } from "../schema/dist/index.js";
 import { defineCommand, defineQuery } from "../spec.js";
 import { OwnersEnum, StabilityEnum, TagsEnum } from "../ownership.js";
 
 //#region src/app-config/contracts.ts
-const BrandingAssetInput = new SchemaModel({
+const BrandingAssetInput = new x8({
 	name: "BrandingAssetInput",
 	fields: {
 		type: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		url: {
-			type: ScalarTypeEnum.URL(),
+			type: E5.URL(),
 			isOptional: false
 		},
 		mimeType: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		}
 	}
 });
-const UpdateTenantBrandingInput = new SchemaModel({
+const UpdateTenantBrandingInput = new x8({
 	name: "UpdateTenantBrandingInput",
 	fields: {
 		tenantId: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		appId: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		environment: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		appName: {
-			type: ScalarTypeEnum.JSONObject(),
+			type: E5.JSONObject(),
 			isOptional: true
 		},
 		assets: {
@@ -47,108 +45,108 @@ const UpdateTenantBrandingInput = new SchemaModel({
 			isArray: true
 		},
 		colors: {
-			type: ScalarTypeEnum.JSONObject(),
+			type: E5.JSONObject(),
 			isOptional: true
 		},
 		customDomain: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		subdomain: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		}
 	}
 });
-const UpdateTenantBrandingOutput = new SchemaModel({
+const UpdateTenantBrandingOutput = new x8({
 	name: "UpdateTenantBrandingOutput",
 	fields: {
 		success: {
-			type: ScalarTypeEnum.Boolean(),
+			type: E5.Boolean(),
 			isOptional: false
 		},
 		updatedAt: {
-			type: ScalarTypeEnum.DateTime(),
+			type: E5.DateTime(),
 			isOptional: false
 		}
 	}
 });
-const VerifyCustomDomainInput = new SchemaModel({
+const VerifyCustomDomainInput = new x8({
 	name: "VerifyCustomDomainInput",
 	fields: {
 		tenantId: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		appId: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		domain: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		}
 	}
 });
-const VerifyCustomDomainOutput = new SchemaModel({
+const VerifyCustomDomainOutput = new x8({
 	name: "VerifyCustomDomainOutput",
 	fields: {
 		status: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		message: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		}
 	}
 });
-const TranslationEntryInput = new SchemaModel({
+const TranslationEntryInput = new x8({
 	name: "TranslationEntryInput",
 	fields: {
 		key: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		locale: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		value: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		context: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		}
 	}
 });
-const UpdateBlueprintTranslationInput = new SchemaModel({
+const UpdateBlueprintTranslationInput = new x8({
 	name: "UpdateBlueprintTranslationInput",
 	fields: {
 		blueprintName: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		blueprintVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: E5.Int_unsecure(),
 			isOptional: false
 		},
 		catalogName: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		catalogVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: E5.Int_unsecure(),
 			isOptional: false
 		},
 		defaultLocale: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		supportedLocales: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false,
 			isArray: true
 		},
@@ -159,15 +157,15 @@ const UpdateBlueprintTranslationInput = new SchemaModel({
 		}
 	}
 });
-const UpdateTenantTranslationInput = new SchemaModel({
+const UpdateTenantTranslationInput = new x8({
 	name: "UpdateTenantTranslationInput",
 	fields: {
 		tenantId: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		appId: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		entries: {
@@ -176,46 +174,46 @@ const UpdateTenantTranslationInput = new SchemaModel({
 			isArray: true
 		},
 		defaultLocale: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		enabledLocales: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true,
 			isArray: true
 		}
 	}
 });
-const MessageResolutionInput = new SchemaModel({
+const MessageResolutionInput = new x8({
 	name: "MessageResolutionInput",
 	fields: {
 		tenantId: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		appId: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		locale: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		key: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		}
 	}
 });
-const MessageResolutionOutput = new SchemaModel({
+const MessageResolutionOutput = new x8({
 	name: "MessageResolutionOutput",
 	fields: {
 		value: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		source: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		}
 	}
@@ -324,27 +322,27 @@ const GetResolvedBrandingQuery = defineQuery({
 		context: "Used by runtime surfaces to fetch brand assets prior to rendering tenant-specific experiences."
 	},
 	io: {
-		input: new SchemaModel({
+		input: new x8({
 			name: "GetResolvedBrandingInput",
 			fields: {
 				tenantId: {
-					type: ScalarTypeEnum.ID(),
+					type: E5.ID(),
 					isOptional: false
 				},
 				appId: {
-					type: ScalarTypeEnum.ID(),
+					type: E5.ID(),
 					isOptional: false
 				},
 				environment: {
-					type: ScalarTypeEnum.String_unsecure(),
+					type: E5.String_unsecure(),
 					isOptional: true
 				}
 			}
 		}),
-		output: new SchemaModel({
+		output: new x8({
 			name: "GetResolvedBrandingOutput",
 			fields: { branding: {
-				type: ScalarTypeEnum.JSONObject(),
+				type: E5.JSONObject(),
 				isOptional: false
 			} }
 		})
@@ -393,4 +391,5 @@ function registerAppConfigContracts(registry) {
 }
 
 //#endregion
-export { GetResolvedBrandingQuery, ResolveMessageQuery, UpdateBlueprintTranslationCatalogCommand, UpdateTenantBrandingCommand, UpdateTenantTranslationOverridesCommand, VerifyCustomDomainCommand, appConfigContracts, registerAppConfigContracts };
+export { GetResolvedBrandingQuery, ResolveMessageQuery, UpdateBlueprintTranslationCatalogCommand, UpdateTenantBrandingCommand, UpdateTenantTranslationOverridesCommand, VerifyCustomDomainCommand, appConfigContracts, registerAppConfigContracts };
+//# sourceMappingURL=contracts.js.map

package/dist/app-config/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","names":["SchemaModel","ScalarTypeEnum","appConfigContracts: Record<string, ContractSpec<any, any>>"],"sources":["../../src/app-config/contracts.ts"],"sourcesContent":["import { ScalarTypeEnum, SchemaModel } from '@lssm/lib.schema';\nimport { defineCommand, defineQuery } from '../spec';\nimport { OwnersEnum, StabilityEnum, TagsEnum } from '../ownership';\nimport type { ContractSpec } from '../spec';\nimport type { SpecRegistry } from '../registry';\n\nconst BrandingAssetInput = new SchemaModel({\n  name: 'BrandingAssetInput',\n  fields: {\n    type: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    url: { type: ScalarTypeEnum.URL(), isOptional: false },\n    mimeType: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nconst UpdateTenantBrandingInput = new SchemaModel({\n  name: 'UpdateTenantBrandingInput',\n  fields: {\n    tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    appId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    environment: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    appName: { type: ScalarTypeEnum.JSONObject(), isOptional: true },\n    assets: { type: BrandingAssetInput, isOptional: true, isArray: true },\n    colors: { type: ScalarTypeEnum.JSONObject(), isOptional: true },\n    customDomain: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    subdomain: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nconst UpdateTenantBrandingOutput = new SchemaModel({\n  name: 'UpdateTenantBrandingOutput',\n  fields: {\n    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst VerifyCustomDomainInput = new SchemaModel({\n  name: 'VerifyCustomDomainInput',\n  fields: {\n    tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    appId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    domain: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst VerifyCustomDomainOutput = new SchemaModel({\n  name: 'VerifyCustomDomainOutput',\n  fields: {\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    message: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nconst TranslationEntryInput = new SchemaModel({\n  name: 'TranslationEntryInput',\n  fields: {\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    value: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    context: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nconst UpdateBlueprintTranslationInput = new SchemaModel({\n  name: 'UpdateBlueprintTranslationInput',\n  fields: {\n    blueprintName: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    blueprintVersion: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: false,\n    },\n    catalogName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    catalogVersion: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    defaultLocale: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    supportedLocales: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n      isArray: true,\n    },\n    entries: {\n      type: TranslationEntryInput,\n      isOptional: false,\n      isArray: true,\n    },\n  },\n});\n\nconst UpdateTenantTranslationInput = new SchemaModel({\n  name: 'UpdateTenantTranslationInput',\n  fields: {\n    tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    appId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    entries: {\n      type: TranslationEntryInput,\n      isOptional: false,\n      isArray: true,\n    },\n    defaultLocale: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    enabledLocales: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n      isArray: true,\n    },\n  },\n});\n\nconst MessageResolutionInput = new SchemaModel({\n  name: 'MessageResolutionInput',\n  fields: {\n    tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    appId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst MessageResolutionOutput = new SchemaModel({\n  name: 'MessageResolutionOutput',\n  fields: {\n    value: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    source: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nexport const UpdateTenantBrandingCommand = defineCommand({\n  meta: {\n    name: 'appConfig.updateTenantBranding',\n    version: 1,\n    description: 'Applies tenant branding overrides (names, assets, domains).',\n    owners: [OwnersEnum.PlatformSigil],\n    tags: ['branding'],\n    stability: StabilityEnum.Beta,\n    goal: 'Maintain tenant-specific branding assets and domains.',\n    context:\n      'Invoked by the Studio or automation when a tenant updates branding settings.',\n  },\n  io: {\n    input: UpdateTenantBrandingInput,\n    output: UpdateTenantBrandingOutput,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.app-config.manage', version: 1 }],\n  },\n});\n\nexport const VerifyCustomDomainCommand = defineCommand({\n  meta: {\n    name: 'appConfig.verifyCustomDomain',\n    version: 1,\n    description: 'Validates DNS ownership for tenant custom domains.',\n    owners: [OwnersEnum.PlatformSigil],\n    tags: ['branding'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Confirm tenant-provided domains before activation.',\n    context:\n      'Triggered after the tenant adds DNS records to verify domain ownership.',\n  },\n  io: {\n    input: VerifyCustomDomainInput,\n    output: VerifyCustomDomainOutput,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.app-config.manage', version: 1 }],\n  },\n});\n\nexport const UpdateBlueprintTranslationCatalogCommand = defineCommand({\n  meta: {\n    name: 'appConfig.updateBlueprintTranslationCatalog',\n    version: 1,\n    description: 'Registers or updates translation entries for a blueprint.',\n    owners: [OwnersEnum.PlatformSigil],\n    tags: [TagsEnum.I18n],\n    stability: StabilityEnum.Beta,\n    goal: 'Keep blueprint translation catalogs in sync with shipped copy.',\n    context:\n      'Executed by platform automation or CI when committing updated translation catalogs.',\n  },\n  io: {\n    input: UpdateBlueprintTranslationInput,\n    output: UpdateTenantBrandingOutput,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.app-config.manage', version: 1 }],\n  },\n});\n\nexport const UpdateTenantTranslationOverridesCommand = defineCommand({\n  meta: {\n    name: 'appConfig.updateTenantTranslations',\n    version: 1,\n    description: 'Applies tenant-specific translation entries.',\n    owners: [OwnersEnum.PlatformSigil],\n    tags: [TagsEnum.I18n],\n    stability: StabilityEnum.Beta,\n    goal: 'Allow tenants to override selected message keys.',\n    context:\n      'Called by the Studio when a tenant customizes labels or copy for their locale.',\n  },\n  io: {\n    input: UpdateTenantTranslationInput,\n    output: UpdateTenantBrandingOutput,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.app-config.manage', version: 1 }],\n  },\n});\n\nexport const GetResolvedBrandingQuery = defineQuery({\n  meta: {\n    name: 'appConfig.getResolvedBranding',\n    version: 1,\n    description: 'Returns the resolved branding for a tenant/app/environment.',\n    owners: [OwnersEnum.PlatformSigil],\n    tags: ['branding'],\n    stability: StabilityEnum.Beta,\n    goal: 'Expose hydrated branding assets for rendering UI/email experiences.',\n    context:\n      'Used by runtime surfaces to fetch brand assets prior to rendering tenant-specific experiences.',\n  },\n  io: {\n    input: new SchemaModel({\n      name: 'GetResolvedBrandingInput',\n      fields: {\n        tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n        appId: { type: ScalarTypeEnum.ID(), isOptional: false },\n        environment: {\n          type: ScalarTypeEnum.String_unsecure(),\n          isOptional: true,\n        },\n      },\n    }),\n    output: new SchemaModel({\n      name: 'GetResolvedBrandingOutput',\n      fields: {\n        branding: { type: ScalarTypeEnum.JSONObject(), isOptional: false },\n      },\n    }),\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.app-config.read', version: 1 }],\n  },\n});\n\nexport const ResolveMessageQuery = defineQuery({\n  meta: {\n    name: 'appConfig.resolveMessage',\n    version: 1,\n    description:\n      'Resolves a translation key for a tenant in the requested locale.',\n    owners: [OwnersEnum.PlatformSigil],\n    tags: [TagsEnum.I18n],\n    stability: StabilityEnum.Experimental,\n    goal: 'Expose a server-side API for resolving message keys on demand.',\n    context:\n      'Used by backend services or scripts that need translated copy outside the front-end runtime.',\n  },\n  io: {\n    input: MessageResolutionInput,\n    output: MessageResolutionOutput,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.app-config.read', version: 1 }],\n  },\n});\n\nexport const appConfigContracts: Record<string, ContractSpec<any, any>> = {\n  UpdateTenantBrandingCommand,\n  VerifyCustomDomainCommand,\n  UpdateBlueprintTranslationCatalogCommand,\n  UpdateTenantTranslationOverridesCommand,\n  GetResolvedBrandingQuery,\n  ResolveMessageQuery,\n};\n\nexport function registerAppConfigContracts(registry: SpecRegistry) {\n  return registry\n    .register(UpdateTenantBrandingCommand)\n    .register(VerifyCustomDomainCommand)\n    .register(UpdateBlueprintTranslationCatalogCommand)\n    .register(UpdateTenantTranslationOverridesCommand)\n    .register(GetResolvedBrandingQuery)\n    .register(ResolveMessageQuery);\n}\n"],"mappings":";;;;;AAMA,MAAM,qBAAqB,IAAIA,GAAY;CACzC,MAAM;CACN,QAAQ;EACN,MAAM;GAAE,MAAMC,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACnE,KAAK;GAAE,MAAMA,GAAe,KAAK;GAAE,YAAY;GAAO;EACtD,UAAU;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACvE;CACF,CAAC;AAEF,MAAM,4BAA4B,IAAID,GAAY;CAChD,MAAM;CACN,QAAQ;EACN,UAAU;GAAE,MAAMC,GAAe,IAAI;GAAE,YAAY;GAAO;EAC1D,OAAO;GAAE,MAAMA,GAAe,IAAI;GAAE,YAAY;GAAO;EACvD,aAAa;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACzE,SAAS;GAAE,MAAMA,GAAe,YAAY;GAAE,YAAY;GAAM;EAChE,QAAQ;GAAE,MAAM;GAAoB,YAAY;GAAM,SAAS;GAAM;EACrE,QAAQ;GAAE,MAAMA,GAAe,YAAY;GAAE,YAAY;GAAM;EAC/D,cAAc;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EAC1E,WAAW;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACxE;CACF,CAAC;AAEF,MAAM,6BAA6B,IAAID,GAAY;CACjD,MAAM;CACN,QAAQ;EACN,SAAS;GAAE,MAAMC,GAAe,SAAS;GAAE,YAAY;GAAO;EAC9D,WAAW;GAAE,MAAMA,GAAe,UAAU;GAAE,YAAY;GAAO;EAClE;CACF,CAAC;AAEF,MAAM,0BAA0B,IAAID,GAAY;CAC9C,MAAM;CACN,QAAQ;EACN,UAAU;GAAE,MAAMC,GAAe,IAAI;GAAE,YAAY;GAAO;EAC1D,OAAO;GAAE,MAAMA,GAAe,IAAI;GAAE,YAAY;GAAO;EACvD,QAAQ;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE;CACF,CAAC;AAEF,MAAM,2BAA2B,IAAID,GAAY;CAC/C,MAAM;CACN,QAAQ;EACN,QAAQ;GAAE,MAAMC,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACrE,SAAS;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACtE;CACF,CAAC;AAEF,MAAM,wBAAwB,IAAID,GAAY;CAC5C,MAAM;CACN,QAAQ;EACN,KAAK;GAAE,MAAMC,GAAe,iBAAiB;GAAE,YAAY;GAAO;EAClE,QAAQ;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACrE,OAAO;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE,SAAS;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACtE;CACF,CAAC;AAEF,MAAM,kCAAkC,IAAID,GAAY;CACtD,MAAM;CACN,QAAQ;EACN,eAAe;GACb,MAAMC,GAAe,iBAAiB;GACtC,YAAY;GACb;EACD,kBAAkB;GAChB,MAAMA,GAAe,cAAc;GACnC,YAAY;GACb;EACD,aAAa;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAO;EAC1E,gBAAgB;GAAE,MAAMA,GAAe,cAAc;GAAE,YAAY;GAAO;EAC1E,eAAe;GACb,MAAMA,GAAe,iBAAiB;GACtC,YAAY;GACb;EACD,kBAAkB;GAChB,MAAMA,GAAe,iBAAiB;GACtC,YAAY;GACZ,SAAS;GACV;EACD,SAAS;GACP,MAAM;GACN,YAAY;GACZ,SAAS;GACV;EACF;CACF,CAAC;AAEF,MAAM,+BAA+B,IAAID,GAAY;CACnD,MAAM;CACN,QAAQ;EACN,UAAU;GAAE,MAAMC,GAAe,IAAI;GAAE,YAAY;GAAO;EAC1D,OAAO;GAAE,MAAMA,GAAe,IAAI;GAAE,YAAY;GAAO;EACvD,SAAS;GACP,MAAM;GACN,YAAY;GACZ,SAAS;GACV;EACD,eAAe;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EAC3E,gBAAgB;GACd,MAAMA,GAAe,iBAAiB;GACtC,YAAY;GACZ,SAAS;GACV;EACF;CACF,CAAC;AAEF,MAAM,yBAAyB,IAAID,GAAY;CAC7C,MAAM;CACN,QAAQ;EACN,UAAU;GAAE,MAAMC,GAAe,IAAI;GAAE,YAAY;GAAO;EAC1D,OAAO;GAAE,MAAMA,GAAe,IAAI;GAAE,YAAY;GAAO;EACvD,QAAQ;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACrE,KAAK;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACnE;CACF,CAAC;AAEF,MAAM,0BAA0B,IAAID,GAAY;CAC9C,MAAM;CACN,QAAQ;EACN,OAAO;GAAE,MAAMC,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACnE,QAAQ;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACrE;CACF,CAAC;AAEF,MAAa,8BAA8B,cAAc;CACvD,MAAM;EACJ,MAAM;EACN,SAAS;EACT,aAAa;EACb,QAAQ,CAAC,WAAW,cAAc;EAClC,MAAM,CAAC,WAAW;EAClB,WAAW,cAAc;EACzB,MAAM;EACN,SACE;EACH;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ;EACN,MAAM;EACN,UAAU,CAAC;GAAE,MAAM;GAA8B,SAAS;GAAG,CAAC;EAC/D;CACF,CAAC;AAEF,MAAa,4BAA4B,cAAc;CACrD,MAAM;EACJ,MAAM;EACN,SAAS;EACT,aAAa;EACb,QAAQ,CAAC,WAAW,cAAc;EAClC,MAAM,CAAC,WAAW;EAClB,WAAW,cAAc;EACzB,MAAM;EACN,SACE;EACH;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ;EACN,MAAM;EACN,UAAU,CAAC;GAAE,MAAM;GAA8B,SAAS;GAAG,CAAC;EAC/D;CACF,CAAC;AAEF,MAAa,2CAA2C,cAAc;CACpE,MAAM;EACJ,MAAM;EACN,SAAS;EACT,aAAa;EACb,QAAQ,CAAC,WAAW,cAAc;EAClC,MAAM,CAAC,SAAS,KAAK;EACrB,WAAW,cAAc;EACzB,MAAM;EACN,SACE;EACH;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ;EACN,MAAM;EACN,UAAU,CAAC;GAAE,MAAM;GAA8B,SAAS;GAAG,CAAC;EAC/D;CACF,CAAC;AAEF,MAAa,0CAA0C,cAAc;CACnE,MAAM;EACJ,MAAM;EACN,SAAS;EACT,aAAa;EACb,QAAQ,CAAC,WAAW,cAAc;EAClC,MAAM,CAAC,SAAS,KAAK;EACrB,WAAW,cAAc;EACzB,MAAM;EACN,SACE;EACH;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ;EACN,MAAM;EACN,UAAU,CAAC;GAAE,MAAM;GAA8B,SAAS;GAAG,CAAC;EAC/D;CACF,CAAC;AAEF,MAAa,2BAA2B,YAAY;CAClD,MAAM;EACJ,MAAM;EACN,SAAS;EACT,aAAa;EACb,QAAQ,CAAC,WAAW,cAAc;EAClC,MAAM,CAAC,WAAW;EAClB,WAAW,cAAc;EACzB,MAAM;EACN,SACE;EACH;CACD,IAAI;EACF,OAAO,IAAID,GAAY;GACrB,MAAM;GACN,QAAQ;IACN,UAAU;KAAE,MAAMC,GAAe,IAAI;KAAE,YAAY;KAAO;IAC1D,OAAO;KAAE,MAAMA,GAAe,IAAI;KAAE,YAAY;KAAO;IACvD,aAAa;KACX,MAAMA,GAAe,iBAAiB;KACtC,YAAY;KACb;IACF;GACF,CAAC;EACF,QAAQ,IAAID,GAAY;GACtB,MAAM;GACN,QAAQ,EACN,UAAU;IAAE,MAAMC,GAAe,YAAY;IAAE,YAAY;IAAO,EACnE;GACF,CAAC;EACH;CACD,QAAQ;EACN,MAAM;EACN,UAAU,CAAC;GAAE,MAAM;GAA4B,SAAS;GAAG,CAAC;EAC7D;CACF,CAAC;AAEF,MAAa,sBAAsB,YAAY;CAC7C,MAAM;EACJ,MAAM;EACN,SAAS;EACT,aACE;EACF,QAAQ,CAAC,WAAW,cAAc;EAClC,MAAM,CAAC,SAAS,KAAK;EACrB,WAAW,cAAc;EACzB,MAAM;EACN,SACE;EACH;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ;EACN,MAAM;EACN,UAAU,CAAC;GAAE,MAAM;GAA4B,SAAS;GAAG,CAAC;EAC7D;CACF,CAAC;AAEF,MAAaC,qBAA6D;CACxE;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAAgB,2BAA2B,UAAwB;AACjE,QAAO,SACJ,SAAS,4BAA4B,CACrC,SAAS,0BAA0B,CACnC,SAAS,yCAAyC,CAClD,SAAS,wCAAwC,CACjD,SAAS,yBAAyB,CAClC,SAAS,oBAAoB"}

package/dist/app-config/docs/app-config.docblock.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "@lssm/lib.contracts/docs";
 //#region src/app-config/docs/app-config.docblock.d.ts
 declare const tech_contracts_app_config_DocBlocks: DocBlock[];
 //#endregion
-export { tech_contracts_app_config_DocBlocks };
+export { tech_contracts_app_config_DocBlocks };
+//# sourceMappingURL=app-config.docblock.d.ts.map

package/dist/app-config/docs/app-config.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.docblock.d.ts","names":[],"sources":["../../../src/app-config/docs/app-config.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,qCAAqC"}

package/dist/app-config/docs/app-config.docblock.js

@@ -19,4 +19,5 @@ const tech_contracts_app_config_DocBlocks = [{
 registerDocBlocks(tech_contracts_app_config_DocBlocks);
 
 //#endregion
-export { tech_contracts_app_config_DocBlocks };
+export { tech_contracts_app_config_DocBlocks };
+//# sourceMappingURL=app-config.docblock.js.map

package/dist/app-config/docs/app-config.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.docblock.js","names":["tech_contracts_app_config_DocBlocks: DocBlock[]"],"sources":["../../../src/app-config/docs/app-config.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '../../registry';\n\nexport const tech_contracts_app_config_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.tech.contracts.app-config',\n    title: 'App Configuration Layers',\n    summary: 'App orchestration is split into three explicit layers:',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/tech/contracts/app-config',\n    tags: ['tech', 'contracts', 'app-config'],\n    body: \"## App Configuration Layers\\n\\nApp orchestration is split into three explicit layers:\\n\\n1. **AppBlueprintSpec** \\u2013 global, versioned description of what an app can look like. Stored in Git, no tenant/environment data.\\n2. **TenantAppConfig** \\u2013 tenant/environment overrides that the future Studio edits. Stored per tenant (DB/contract), mutable at runtime.\\n3. **ResolvedAppConfig** \\u2013 pure, merged view consumed by the runtime. Derived in-memory from a blueprint + tenant config.\\n\\n- Types & registry: `packages/libs/contracts/src/app-config/spec.ts`\\n- Resolution helpers: `packages/libs/contracts/src/app-config/runtime.ts`\\n- CLI wizard (blueprint scaffolding): `contractspec create app-config`\\n\\n### 1. AppBlueprintSpec\\n\\n```ts\\nexport interface AppBlueprintSpec {\\n  meta: AppBlueprintMeta;          // { name, version, appId, ownership }\\n  capabilities?: { enabled?: CapabilityRef[]; disabled?: CapabilityRef[] };\\n  features?: { include?: FeatureRef[]; exclude?: FeatureRef[] };\\n  integrationSlots?: AppIntegrationSlot[];\\n  branding?: BrandingDefaults;\\n  dataViews?: Record<string, SpecPointer>;\\n  workflows?: Record<string, SpecPointer>;\\n  policies?: PolicyRef[];\\n  theme?: AppThemeBinding;\\n  telemetry?: TelemetryBinding;\\n  experiments?: { active?: ExperimentRef[]; paused?: ExperimentRef[] };\\n  featureFlags?: FeatureFlagState[];\\n  routes?: AppRouteConfig[];\\n  notes?: string;\\n}\\n```\\n\\nRegister blueprints with `AppBlueprintRegistry`. Blueprints only capture the default/global experience.\\n\\n- **Integration slots** declare the categories and capability requirements an app expects (e.g. `\\\"primary-payments\\\"` must be a payments provider that supports managed or BYOK credentials). Slots never include secrets; tenants bind concrete connections later.\\n- **Branding defaults** provide message-key based names, placeholder assets, and theme token references that downstream tenants can override.\\n\\n### 2. TenantAppConfig\\n\\n```ts\\nexport interface TenantAppConfig {\\n  meta: TenantAppConfigMeta;  // { id, tenantId, appId, blueprintName/version, environment?, version, timestamps }\\n  capabilities?: { enable?: CapabilityRef[]; disable?: CapabilityRef[] };\\n  features?: { include?: FeatureRef[]; exclude?: FeatureRef[] };\\n  dataViewOverrides?: TenantSpecOverride[];\\n  workflowOverrides?: TenantSpecOverride[];\\n  additionalPolicies?: PolicyRef[];\\n  themeOverride?: { primary?: ThemeRef | null; fallbacks?: ThemeRef[] };\\n  telemetryOverride?: { spec?: SpecPointer | null; disabledEvents?: string[] };\\n  experiments?: { active?: ExperimentRef[]; paused?: ExperimentRef[] };\\n  featureFlags?: FeatureFlagState[];\\n  routeOverrides?: TenantRouteOverride[];\\n  integrations?: AppIntegrationBinding[];\\n  knowledge?: AppKnowledgeBinding[];\\n  branding?: TenantBrandingConfig;\\n  notes?: string;\\n}\\n```\\n\\nThis object represents what a tenant edits via the Studio (stored in DB/contracts later).\\n\\n- **AppIntegrationBinding** now maps `slotId` \\u2192 `connectionId` (plus optional workflow scopes). It no longer carries capability lists; those are defined once in the slot.\\n- **TenantBrandingConfig** allows per-tenant names, assets, and domain overrides while keeping secrets and large files out of blueprints.\\n\\n### 3. ResolvedAppConfig\\n\\n```ts\\nexport interface ResolvedAppConfig {\\n  appId: string;\\n  tenantId: string;\\n  environment?: string;\\n  blueprintName: string;\\n  blueprintVersion: number;\\n  configVersion: number;\\n  capabilities: { enabled: CapabilityRef[]; disabled: CapabilityRef[] };\\n  features: { include: FeatureRef[]; exclude: FeatureRef[] };\\n  dataViews: Record<string, SpecPointer>;\\n  workflows: Record<string, SpecPointer>;\\n  policies: PolicyRef[];\\n  theme?: AppThemeBinding;\\n  telemetry?: TelemetryBinding;\\n  experiments: { catalog: ExperimentRef[]; active: ExperimentRef[]; paused: ExperimentRef[] };\\n  featureFlags: FeatureFlagState[];\\n  routes: AppRouteConfig[];\\n  integrations: ResolvedIntegration[];\\n  knowledge: ResolvedKnowledge[];\\n  branding: ResolvedBranding;\\n  notes?: string;\\n}\\n```\\n\\nUse `resolveAppConfig(blueprint, tenant)` to produce this merged view. No IO, no registry lookups\\u2014pure data merge.\\n\\n- `resolveAppConfig` validates slot/category/mode constraints when `integrationConnections` and `integrationSpecs` are provided.\\n- `branding` merges blueprint defaults with tenant overrides, producing a runtime-friendly shape (resolved asset URLs, color values, and effective domain).\\n\\n### Materializing specs\\n\\n`composeAppConfig(blueprint, tenant, registries, { strict })`:\\n\\n1. Calls `resolveAppConfig` to build the merged pointers.\\n2. Looks up referenced specs in the provided registries.\\n3. Returns:\\n   - `resolved` \\u2013 the merged pointer view\\n   - `capabilities`, `features`, `dataViews`, `workflows`, `policies`, `theme`, `telemetry`, `experiments`\\n   - `missing` \\u2013 unresolved references (strict mode throws).\\n\\n```ts\\nconst blueprint = blueprintRegistry.get('core.app', 1)!;\\nconst tenant = loadTenantConfigFromDB();\\n\\nconst composition = composeAppConfig(blueprint, tenant, {\\n  capabilities,\\n  features,\\n  dataViews,\\n  workflows,\\n  policies,\\n  themes,\\n  telemetry,\\n  experiments,\\n});\\n\\nif (composition.missing.length) {\\n  console.warn('Unresolved references', composition.missing);\\n}\\n```\\n\\n### CLI workflow\\n\\n```\\ncontractspec create app-config\\n```\\n\\nGenerates an `AppBlueprintSpec`. A separate flow will later scaffold tenant configs.\\n\\n### Best practices\\n\\n1. Keep blueprint and tenant versions monotonic; bump when referenced spec versions change.\\n2. Favor stable slot keys (e.g. `dataViews.dashboard`) to align with Studio UX.\\n3. Reference telemetry and experiments declared in their respective specs to maintain observability.\\n4. Run `resolveAppConfig` in pure unit tests and `composeAppConfig(..., { strict: true })` in CI to catch drift early.\\n5. Pair resolved configs with `TestSpec` scenarios to guard tenant experiences end-to-end.\\n\\n### Static validation\\n\\nUse the validation helpers in `@lssm/lib.contracts/app-config/validation` to keep blueprints and tenant configs safe before publish time.\\n\\n```ts\\nimport {\\n  validateConfig,\\n  validateBlueprint,\\n  validateTenantConfig,\\n  validateResolvedConfig,\\n} from '@lssm/lib.contracts/app-config/validation';\\n\\nconst context = {\\n  integrationSpecs,\\n  tenantConnections,\\n  knowledgeSpaces,\\n  knowledgeSources,\\n  translationCatalogs: {\\n    blueprint: blueprintCatalog,\\n    platform: platformCatalog,\\n  },\\n  existingConfigs,\\n};\\n\\nconst blueprintReport = validateBlueprint(blueprint, context);\\nconst tenantReport = validateTenantConfig(blueprint, tenant, context);\\nconst publishReport = validateConfig(blueprint, tenant, context);\\n```\\n\\n- `ValidationResult` exposes `valid`, plus structured `errors`, `warnings`, and `info`.\\n- Core rules cover capability references, integration slot bindings (category/ownership/capabilities), knowledge bindings, branding constraints (domains + assets), and translation coverage.\\n- Call `validateBlueprint` in CI when committing new specs, and `validateConfig` before promoting/publishing a tenant config.\\n- `validateResolvedConfig` can be used as a runtime pre-flight check when composing full configs for workflows.\\n- CLI usage example (blueprint + tenant):\\n\\n```\\npnpm contractspec validate \\\\\\n  packages/examples/integration-stripe/blueprint.ts \\\\\\n  --blueprint packages/examples/integration-stripe/blueprint.ts \\\\\\n  --tenant-config packages/examples/integration-stripe/tenant.ts\\n```\\n- Repository script:\\n\\n```\\nbun run validate:blueprints\\n```\\n\\nRuns the static validator for the sample blueprints/tenants and is wired into CI.\\n\\n\\n### Lifecycle types & events\\n\\nTo model multi-step configuration changes, use the lifecycle helpers exported from `@lssm/lib.contracts/app-config`:\\n\\n```ts\\nimport type {\\n  ConfigStatus,\\n  TenantAppConfigVersion,\\n  ConfigTransition,\\n} from '@lssm/lib.contracts/app-config';\\nimport {\\n  ConfigDraftCreatedEvent,\\n  ConfigPromotedToPreviewEvent,\\n  ConfigPublishedEvent,\\n  ConfigRolledBackEvent,\\n} from '@lssm/lib.contracts/app-config';\\n```\\n\\n- `ConfigStatus` enumerates the canonical states: `draft`, `preview`, `published`, `archived`, `superseded`.\\n- `TenantAppConfigMeta` now includes lifecycle metadata (`status`, `createdBy`, `publishedBy`, `publishedAt`, `rolledBackFrom`, `rolledBackTo`, `changeSummary`).\\n- `TenantAppConfigVersion` couples the lifecycle-aware metadata with the `TenantAppConfig` payload for history views.\\n- `ConfigTransition` captures state changes with actor, timestamp, and optional reason.\\n- Lifecycle events (`app_config.draft_created`, `app_config.promoted_to_preview`, `app_config.published`, `app_config.rolled_back`) standardize observability across services.\\n- Lifecycle contract specs (`appConfig.lifecycle.*`) expose typed commands/queries for create \\u2192 preview \\u2192 publish \\u2192 rollback flows.\\n\\n\",\n  },\n];\nregisterDocBlocks(tech_contracts_app_config_DocBlocks);\n"],"mappings":";;;;AAGA,MAAaA,sCAAkD,CAC7D;CACE,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAQ;EAAa;EAAa;CACzC,MAAM;CACP,CACF;AACD,kBAAkB,oCAAoC"}

package/dist/app-config/events.d.ts

@@ -1,122 +1,123 @@
 import { EventSpec } from "../events.js";
 import "../index.js";
-import * as _lssm_lib_schema258 from "@lssm/lib.schema";
+import * as _lssm_lib_schema92 from "@lssm/lib.schema";
 import { SchemaModel } from "@lssm/lib.schema";
 
 //#region src/app-config/events.d.ts
 declare const ConfigDraftCreatedEvent: EventSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _lssm_lib_schema258.FieldType<number, number>;
+    type: _lssm_lib_schema92.FieldType<number, number>;
     isOptional: false;
   };
   blueprintName: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   blueprintVersion: {
-    type: _lssm_lib_schema258.FieldType<number, number>;
+    type: _lssm_lib_schema92.FieldType<number, number>;
     isOptional: false;
   };
   createdBy: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   clonedFrom: {
-    type: _lssm_lib_schema258.FieldType<number, number>;
+    type: _lssm_lib_schema92.FieldType<number, number>;
     isOptional: true;
   };
 }>>;
 declare const ConfigPromotedToPreviewEvent: EventSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _lssm_lib_schema258.FieldType<number, number>;
+    type: _lssm_lib_schema92.FieldType<number, number>;
     isOptional: false;
   };
   promotedBy: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   warnings: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: true;
     isArray: true;
   };
 }>>;
 declare const ConfigPublishedEvent: EventSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _lssm_lib_schema258.FieldType<number, number>;
+    type: _lssm_lib_schema92.FieldType<number, number>;
     isOptional: false;
   };
   previousVersion: {
-    type: _lssm_lib_schema258.FieldType<number, number>;
+    type: _lssm_lib_schema92.FieldType<number, number>;
     isOptional: true;
   };
   publishedBy: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   changeSummary: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: true;
   };
   changedSections: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: true;
     isArray: true;
   };
 }>>;
 declare const ConfigRolledBackEvent: EventSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   newVersion: {
-    type: _lssm_lib_schema258.FieldType<number, number>;
+    type: _lssm_lib_schema92.FieldType<number, number>;
     isOptional: false;
   };
   rolledBackFrom: {
-    type: _lssm_lib_schema258.FieldType<number, number>;
+    type: _lssm_lib_schema92.FieldType<number, number>;
     isOptional: false;
   };
   rolledBackTo: {
-    type: _lssm_lib_schema258.FieldType<number, number>;
+    type: _lssm_lib_schema92.FieldType<number, number>;
     isOptional: false;
   };
   rolledBackBy: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
   reason: {
-    type: _lssm_lib_schema258.FieldType<string, string>;
+    type: _lssm_lib_schema92.FieldType<string, string>;
     isOptional: false;
   };
 }>>;
 //#endregion
-export { ConfigDraftCreatedEvent, ConfigPromotedToPreviewEvent, ConfigPublishedEvent, ConfigRolledBackEvent };
+export { ConfigDraftCreatedEvent, ConfigPromotedToPreviewEvent, ConfigPublishedEvent, ConfigRolledBackEvent };
+//# sourceMappingURL=events.d.ts.map

package/dist/app-config/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","names":[],"sources":["../../src/app-config/events.ts"],"sourcesContent":[],"mappings":";;;;;;cAca,yBAAuB,UAAA;;UAuBlC,kBAAA,CAAA;;;EAvBW,KAAA,EAAA;IAuBX,IAAA,8BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;EAvBkC,aAAA,EAAA;IAAA,IAAA,8BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAyBvB,CAAA;EAmBX,gBAAA,EAAA;;;;;IAnBuC,IAAA,8BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;EAqB5B,UAAA,EAAA;IA8BX,IAAA,8BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;cAnDW,8BAA4B,UAAA;;UAmBvC,kBAAA,CAAA;IAE+B,UAAA,EAAA,KAAA;EAAA,CAAA;EAAA,KAAA,EAAA;IAgCpB,IAAA,8BA0BX,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;IA1BgC,IAAA,8BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;;;;;;;cAhCrB,sBAAoB,UAAA;;UA8B/B,kBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAEW,uBAAqB,UAAA;;UA0BhC,kBAAA,CAAA"}