@lssm/lib.contracts 0.0.0-canary-20251217052941 → 0.0.0-canary-20251217060433

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

@@ -0,0 +1,11 @@
+import { FeatureModuleSpec } from "../features.js";
+
+//#region src/app-config/app-config.feature.d.ts
+
+/**
+ * App Config feature module that bundles tenant configuration
+ * lifecycle events for draft, preview, publish, and rollback stages.
+ */
+declare const AppConfigFeature: FeatureModuleSpec;
+//#endregion
+export { AppConfigFeature };

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

@@ -0,0 +1,55 @@
+//#region src/app-config/branding.d.ts
+interface BrandingAssetRef {
+  type: 'logo' | 'logo-dark' | 'favicon' | 'og-image';
+  url?: string;
+  dimensions?: {
+    width: number;
+    height: number;
+  };
+}
+interface BrandingDefaults {
+  appNameKey: string;
+  assets?: BrandingAssetRef[];
+  colorTokens?: {
+    primary?: string;
+    secondary?: string;
+  };
+}
+interface TenantBrandingAsset {
+  type: 'logo' | 'logo-dark' | 'favicon' | 'og-image';
+  url: string;
+  metadata?: {
+    mimeType?: string;
+    sizeBytes?: number;
+    dimensions?: {
+      width: number;
+      height: number;
+    };
+  };
+}
+interface TenantBrandingConfig {
+  appName?: Record<string, string>;
+  assets?: TenantBrandingAsset[];
+  colors?: {
+    primary?: string;
+    secondary?: string;
+  };
+  customDomain?: string;
+  subdomain?: string;
+}
+interface ResolvedBranding {
+  appName: string;
+  assets: {
+    logo?: string;
+    logoDark?: string;
+    favicon?: string;
+    ogImage?: string;
+  };
+  colors: {
+    primary: string;
+    secondary: string;
+  };
+  domain: string;
+}
+//#endregion
+export { BrandingAssetRef, BrandingDefaults, ResolvedBranding, TenantBrandingAsset, TenantBrandingConfig };

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

@@ -0,0 +1,244 @@
+import { ContractSpec } from "../spec.js";
+import { SpecRegistry } from "../registry.js";
+import * as _lssm_lib_schema69 from "@lssm/lib.schema";
+import { SchemaModel } from "@lssm/lib.schema";
+
+//#region src/app-config/contracts.d.ts
+declare const UpdateTenantBrandingCommand: ContractSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  environment: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: true;
+  };
+  appName: {
+    type: _lssm_lib_schema69.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+  assets: {
+    type: SchemaModel<{
+      type: {
+        type: _lssm_lib_schema69.FieldType<string, string>;
+        isOptional: false;
+      };
+      url: {
+        type: _lssm_lib_schema69.FieldType<string, string>;
+        isOptional: false;
+      };
+      mimeType: {
+        type: _lssm_lib_schema69.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isOptional: true;
+    isArray: true;
+  };
+  colors: {
+    type: _lssm_lib_schema69.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+  customDomain: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: true;
+  };
+  subdomain: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, SchemaModel<{
+  success: {
+    type: _lssm_lib_schema69.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  updatedAt: {
+    type: _lssm_lib_schema69.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const VerifyCustomDomainCommand: ContractSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  domain: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, SchemaModel<{
+  status: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  message: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+declare const UpdateBlueprintTranslationCatalogCommand: ContractSpec<SchemaModel<{
+  blueprintName: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  blueprintVersion: {
+    type: _lssm_lib_schema69.FieldType<number, number>;
+    isOptional: false;
+  };
+  catalogName: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  catalogVersion: {
+    type: _lssm_lib_schema69.FieldType<number, number>;
+    isOptional: false;
+  };
+  defaultLocale: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  supportedLocales: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+    isArray: true;
+  };
+  entries: {
+    type: SchemaModel<{
+      key: {
+        type: _lssm_lib_schema69.FieldType<string, string>;
+        isOptional: false;
+      };
+      locale: {
+        type: _lssm_lib_schema69.FieldType<string, string>;
+        isOptional: false;
+      };
+      value: {
+        type: _lssm_lib_schema69.FieldType<string, string>;
+        isOptional: false;
+      };
+      context: {
+        type: _lssm_lib_schema69.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isOptional: false;
+    isArray: true;
+  };
+}>, SchemaModel<{
+  success: {
+    type: _lssm_lib_schema69.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  updatedAt: {
+    type: _lssm_lib_schema69.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const UpdateTenantTranslationOverridesCommand: ContractSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  entries: {
+    type: SchemaModel<{
+      key: {
+        type: _lssm_lib_schema69.FieldType<string, string>;
+        isOptional: false;
+      };
+      locale: {
+        type: _lssm_lib_schema69.FieldType<string, string>;
+        isOptional: false;
+      };
+      value: {
+        type: _lssm_lib_schema69.FieldType<string, string>;
+        isOptional: false;
+      };
+      context: {
+        type: _lssm_lib_schema69.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isOptional: false;
+    isArray: true;
+  };
+  defaultLocale: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: true;
+  };
+  enabledLocales: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: true;
+    isArray: true;
+  };
+}>, SchemaModel<{
+  success: {
+    type: _lssm_lib_schema69.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  updatedAt: {
+    type: _lssm_lib_schema69.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const GetResolvedBrandingQuery: ContractSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  environment: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, SchemaModel<{
+  branding: {
+    type: _lssm_lib_schema69.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const ResolveMessageQuery: ContractSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  locale: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+  key: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, SchemaModel<{
+  value: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: true;
+  };
+  source: {
+    type: _lssm_lib_schema69.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+declare const appConfigContracts: Record<string, ContractSpec<any, any>>;
+declare function registerAppConfigContracts(registry: SpecRegistry): SpecRegistry;
+//#endregion
+export { GetResolvedBrandingQuery, ResolveMessageQuery, UpdateBlueprintTranslationCatalogCommand, UpdateTenantBrandingCommand, UpdateTenantTranslationOverridesCommand, VerifyCustomDomainCommand, appConfigContracts, registerAppConfigContracts };

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

@@ -0,0 +1,6 @@
+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 };

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

@@ -0,0 +1,122 @@
+import { EventSpec } from "../events.js";
+import "../index.js";
+import * as _lssm_lib_schema43 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_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _lssm_lib_schema43.FieldType<number, number>;
+    isOptional: false;
+  };
+  blueprintName: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  blueprintVersion: {
+    type: _lssm_lib_schema43.FieldType<number, number>;
+    isOptional: false;
+  };
+  createdBy: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  clonedFrom: {
+    type: _lssm_lib_schema43.FieldType<number, number>;
+    isOptional: true;
+  };
+}>>;
+declare const ConfigPromotedToPreviewEvent: EventSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _lssm_lib_schema43.FieldType<number, number>;
+    isOptional: false;
+  };
+  promotedBy: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  warnings: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: true;
+    isArray: true;
+  };
+}>>;
+declare const ConfigPublishedEvent: EventSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _lssm_lib_schema43.FieldType<number, number>;
+    isOptional: false;
+  };
+  previousVersion: {
+    type: _lssm_lib_schema43.FieldType<number, number>;
+    isOptional: true;
+  };
+  publishedBy: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  changeSummary: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: true;
+  };
+  changedSections: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: true;
+    isArray: true;
+  };
+}>>;
+declare const ConfigRolledBackEvent: EventSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  newVersion: {
+    type: _lssm_lib_schema43.FieldType<number, number>;
+    isOptional: false;
+  };
+  rolledBackFrom: {
+    type: _lssm_lib_schema43.FieldType<number, number>;
+    isOptional: false;
+  };
+  rolledBackTo: {
+    type: _lssm_lib_schema43.FieldType<number, number>;
+    isOptional: false;
+  };
+  rolledBackBy: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+  reason: {
+    type: _lssm_lib_schema43.FieldType<string, string>;
+    isOptional: false;
+  };
+}>>;
+//#endregion
+export { ConfigDraftCreatedEvent, ConfigPromotedToPreviewEvent, ConfigPublishedEvent, ConfigRolledBackEvent };

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

@@ -0,0 +1,9 @@
+import { BrandingAssetRef, BrandingDefaults, ResolvedBranding, TenantBrandingAsset, TenantBrandingConfig } from "./branding.js";
+import { ConfigStatus, ConfigTransition, ConfigVersionHistory, TenantAppConfigVersion } from "./lifecycle.js";
+import { AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, FeatureFlagState, SpecPointer, TelemetryBinding, TenantAppConfig, TenantAppConfigMeta, TenantRouteOverride, TenantSpecOverride, TranslationCatalogPointer, makeAppBlueprintKey } from "./spec.js";
+import { AppComposition, AppCompositionDeps, ComposeOptions, MissingReference, ResolveAppConfigDeps, ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, composeAppConfig, resolveAppConfig } from "./runtime.js";
+import { AppConfigFeature } from "./app-config.feature.js";
+import { ConfigDraftCreatedEvent, ConfigPromotedToPreviewEvent, ConfigPublishedEvent, ConfigRolledBackEvent } from "./events.js";
+import { ValidationContext, ValidationIssue, ValidationResult, ValidationSeverity, validateBlueprint, validateConfig, validateResolvedConfig, validateTenantConfig } from "./validation.js";
+import { CreateTenantConfigDraftCommand, GetTenantConfigVersionQuery, ListTenantConfigVersionsQuery, PromoteTenantConfigToPreviewCommand, PublishTenantConfigCommand, RollbackTenantConfigCommand, lifecycleContracts, registerAppConfigLifecycleContracts } from "./lifecycle-contracts.js";
+export { AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppComposition, AppCompositionDeps, AppConfigFeature, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, BrandingAssetRef, BrandingDefaults, ComposeOptions, ConfigDraftCreatedEvent, ConfigPromotedToPreviewEvent, ConfigPublishedEvent, ConfigRolledBackEvent, ConfigStatus, ConfigTransition, ConfigVersionHistory, CreateTenantConfigDraftCommand, FeatureFlagState, GetTenantConfigVersionQuery, ListTenantConfigVersionsQuery, MissingReference, PromoteTenantConfigToPreviewCommand, PublishTenantConfigCommand, ResolveAppConfigDeps, ResolvedAppConfig, ResolvedBranding, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, RollbackTenantConfigCommand, SpecPointer, TelemetryBinding, TenantAppConfig, TenantAppConfigMeta, TenantAppConfigVersion, TenantBrandingAsset, TenantBrandingConfig, TenantRouteOverride, TenantSpecOverride, TranslationCatalogPointer, ValidationContext, ValidationIssue, ValidationResult, ValidationSeverity, composeAppConfig, lifecycleContracts, makeAppBlueprintKey, registerAppConfigLifecycleContracts, resolveAppConfig, validateBlueprint, validateConfig, validateResolvedConfig, validateTenantConfig };