@lssm/lib.contracts 0.0.0-canary-20251120170226

package/README.md

@@ -0,0 +1,98 @@
+# @lssm/lib.contracts
+
+Unified specifications for Operations, Events, Presentations, and Features.
+
+## Purpose
+
+To provide a single, typed source of truth for backend operations (`ContractSpec`), events (`EventSpec`), and UI/data presentations. This enables **runtime adapters** (REST, GraphQL, MCP, UI) to automatically generate endpoints, schemas, and user interfaces without code duplication.
+
+## Installation
+
+```bash
+npm install @lssm/lib.contracts @lssm/lib.schema
+# or
+bun add @lssm/lib.contracts @lssm/lib.schema
+```
+
+## Key Concepts
+
+- **Spec-First, TypeScript-First**: Define operations in pure TypeScript (no YAML).
+- **Runtime Adapters**: The `SpecRegistry` is passed to adapters (e.g., `makeNextAppHandler`) to serve APIs dynamically. There is no intermediate "compile" step to generate code; the spec _is_ the code.
+- **Capabilities**: `defineCommand` (writes) and `defineQuery` (reads) with Zod-backed I/O.
+- **Events**: `defineEvent` for type-safe side effects.
+- **Presentations**: (V2) Describe how data is rendered (Web Components, Markdown, Data) for automated UI generation.
+
+## Exports
+
+- **Core**: `SpecRegistry`, `defineCommand`, `defineQuery`, `defineEvent`.
+- **Adapters**:
+  - `server/rest-next-app`: Next.js App Router adapter.
+  - `server/provider-mcp`: Model Context Protocol (MCP) adapter for AI agents.
+  - `server/graphql-pothos`: GraphQL schema generator.
+- **Docs**: `markdown` utilities to generate human-readable documentation from specs.
+
+## Usage
+
+### 1. Define a Spec
+
+```ts
+import { defineCommand, defineQuery } from '@lssm/lib.contracts';
+import { z } from 'zod';
+import { SchemaModel, ScalarTypeEnum } from '@lssm/lib.schema';
+
+const UserInput = new SchemaModel({
+  name: 'UserInput',
+  fields: {
+    email: { type: ScalarTypeEnum.Email(), isOptional: false },
+  },
+});
+
+export const CreateUser = defineCommand({
+  meta: {
+    name: 'user.create',
+    version: 1,
+    description: 'Register a new user',
+    owners: ['team-auth'],
+    tags: ['auth'],
+    goal: 'Onboard users',
+    context: 'Public registration',
+    stability: 'stable',
+  },
+  io: {
+    input: UserInput,
+    output: new SchemaModel({
+      name: 'UserOutput',
+      fields: {
+        id: { type: ScalarTypeEnum.String(), isOptional: false },
+      },
+    }),
+  },
+  policy: {
+    auth: 'anonymous',
+  },
+});
+```
+
+### 2. Register and Implement
+
+```ts
+import { SpecRegistry, installOp } from '@lssm/lib.contracts';
+
+const reg = new SpecRegistry();
+
+installOp(reg, CreateUser, async (ctx, input) => {
+  // Implementation logic here
+  return { id: '123' };
+});
+```
+
+### 3. Serve (Next.js Adapter)
+
+```ts
+// app/api/[...route]/route.ts
+import { makeNextAppHandler } from '@lssm/lib.contracts/server/rest-next-app';
+
+const handler = makeNextAppHandler(reg, (req) => ({ actor: 'anonymous' }));
+
+export { handler as GET, handler as POST };
+```

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

@@ -0,0 +1,56 @@
+//#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 };
+//# 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

@@ -0,0 +1,245 @@
+import { ContractSpec } from "../spec.js";
+import { SpecRegistry } from "../registry.js";
+import * as _lssm_lib_schema471 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_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  environment: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: true;
+  };
+  appName: {
+    type: _lssm_lib_schema471.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+  assets: {
+    type: SchemaModel<{
+      type: {
+        type: _lssm_lib_schema471.FieldType<string, string>;
+        isOptional: false;
+      };
+      url: {
+        type: _lssm_lib_schema471.FieldType<string, string>;
+        isOptional: false;
+      };
+      mimeType: {
+        type: _lssm_lib_schema471.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isOptional: true;
+    isArray: true;
+  };
+  colors: {
+    type: _lssm_lib_schema471.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+  customDomain: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: true;
+  };
+  subdomain: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, SchemaModel<{
+  success: {
+    type: _lssm_lib_schema471.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  updatedAt: {
+    type: _lssm_lib_schema471.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const VerifyCustomDomainCommand: ContractSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  domain: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, SchemaModel<{
+  status: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  message: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+declare const UpdateBlueprintTranslationCatalogCommand: ContractSpec<SchemaModel<{
+  blueprintName: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  blueprintVersion: {
+    type: _lssm_lib_schema471.FieldType<number, number>;
+    isOptional: false;
+  };
+  catalogName: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  catalogVersion: {
+    type: _lssm_lib_schema471.FieldType<number, number>;
+    isOptional: false;
+  };
+  defaultLocale: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  supportedLocales: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+    isArray: true;
+  };
+  entries: {
+    type: SchemaModel<{
+      key: {
+        type: _lssm_lib_schema471.FieldType<string, string>;
+        isOptional: false;
+      };
+      locale: {
+        type: _lssm_lib_schema471.FieldType<string, string>;
+        isOptional: false;
+      };
+      value: {
+        type: _lssm_lib_schema471.FieldType<string, string>;
+        isOptional: false;
+      };
+      context: {
+        type: _lssm_lib_schema471.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isOptional: false;
+    isArray: true;
+  };
+}>, SchemaModel<{
+  success: {
+    type: _lssm_lib_schema471.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  updatedAt: {
+    type: _lssm_lib_schema471.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const UpdateTenantTranslationOverridesCommand: ContractSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  entries: {
+    type: SchemaModel<{
+      key: {
+        type: _lssm_lib_schema471.FieldType<string, string>;
+        isOptional: false;
+      };
+      locale: {
+        type: _lssm_lib_schema471.FieldType<string, string>;
+        isOptional: false;
+      };
+      value: {
+        type: _lssm_lib_schema471.FieldType<string, string>;
+        isOptional: false;
+      };
+      context: {
+        type: _lssm_lib_schema471.FieldType<string, string>;
+        isOptional: true;
+      };
+    }>;
+    isOptional: false;
+    isArray: true;
+  };
+  defaultLocale: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: true;
+  };
+  enabledLocales: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: true;
+    isArray: true;
+  };
+}>, SchemaModel<{
+  success: {
+    type: _lssm_lib_schema471.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  updatedAt: {
+    type: _lssm_lib_schema471.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const GetResolvedBrandingQuery: ContractSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  environment: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, SchemaModel<{
+  branding: {
+    type: _lssm_lib_schema471.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const ResolveMessageQuery: ContractSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  locale: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+  key: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, SchemaModel<{
+  value: {
+    type: _lssm_lib_schema471.FieldType<string, string>;
+    isOptional: true;
+  };
+  source: {
+    type: _lssm_lib_schema471.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 };
+//# 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":";;;;;;cAgIa,6BAA2B,aAAA;;UAoBtC,mBAAA,CAAA;IApBW,UAAA,EAAA,KAAA;EAoBX,CAAA;;;;;;;;;;;;;;;MApBsC,IAAA,EAAA;QAAA,IAAA,+BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;QAAA,IAAA,+BAAA,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,+BAoBX,OAAA,CAAA,MAAA,EAAA,OAAA,CAAA,QAAA,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;IAAA,UAAA,EAAA,IAAA;;;;;;;;;;;EApBmD,OAAA,EAAA;IAAA,IAAA,EA5Cb,mBAAA,CAAA,SA4Ca,CAAA,OAAA,EAAA,OAAA,CAAA;;;;IAAA,IAAA,+BAAA,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAsBxC,CAAA;CAoBX,CAAA,EAAA,SAAA,CAAA;cAhEW,2BAAyB,aAAA;;UAoBpC,mBAAA,CAAA;;;;;;EAwBkD,CAAA;EAAA,MAAA,EAAA;;;;CAAA,CAAA,aAAA,CAAA;EAAA,MAAA,EAAA;IAsBvC,IAAA,EAlEyB,mBAAA,CAAA,SAkGpC,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;IAhCmC,IAAA,+BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;cA5CxB,0CAAwC,aAAA;EA4ChB,aAAA,EAAA;IAAA,IAAA,EAxBnC,mBAAA,CAAA,SAwBmC,CAAA,MAAA,EAAA,MAAA,CAAA;IAkCxB,UAAA,EAAA,KAAA;EAqBX,CAAA;;;;EArB8B,CAAA;EAAA,WAAA,EAAA;;;EAAA,CAAA;EAAA,cAAA,EAAA;IAuBnB,IAAA,+BAAmC,CAAA,MAAf,EAAM,MAAA,CAAA;IASvB,UAAA,EAAA,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA9GqC,mBAAA,CAAA;;;;;;;;cAsBxC,yCAAuC,aAAA;;UAoBlD,mBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UApBkD,mBAAA,CAAA;;;;;;;;cAsBvC,0BAAwB,aAAA;;UAgCnC,mBAAA,CAAA;;;;;;;;;;;;;;;;;cAEW,qBAAmB,aAAA;;UAqB9B,mBAAA,CAAA;;;;;;;;;;;;;;;;;UArB8B,mBAAA,CAAA;;;;;;;;cAuBnB,oBAAoB,eAAe;iBAShC,0BAAA,WAAqC,eAAY"}

package/dist/app-config/contracts.js

@@ -0,0 +1,2 @@
+import{l as e}from"../schema/dist/ScalarTypeEnum.js";import{t}from"../schema/dist/SchemaModel.js";import"../schema/dist/index.js";import{defineCommand as n,defineQuery as r}from"../spec.js";import{OwnersEnum as i,StabilityEnum as a,TagsEnum as o}from"../ownership.js";const s=new t({name:`BrandingAssetInput`,fields:{type:{type:e.String_unsecure(),isOptional:!1},url:{type:e.URL(),isOptional:!1},mimeType:{type:e.String_unsecure(),isOptional:!0}}}),c=new t({name:`UpdateTenantBrandingInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},environment:{type:e.String_unsecure(),isOptional:!0},appName:{type:e.JSONObject(),isOptional:!0},assets:{type:s,isOptional:!0,isArray:!0},colors:{type:e.JSONObject(),isOptional:!0},customDomain:{type:e.String_unsecure(),isOptional:!0},subdomain:{type:e.String_unsecure(),isOptional:!0}}}),l=new t({name:`UpdateTenantBrandingOutput`,fields:{success:{type:e.Boolean(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),u=new t({name:`VerifyCustomDomainInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},domain:{type:e.String_unsecure(),isOptional:!1}}}),d=new t({name:`VerifyCustomDomainOutput`,fields:{status:{type:e.String_unsecure(),isOptional:!1},message:{type:e.String_unsecure(),isOptional:!0}}}),f=new t({name:`TranslationEntryInput`,fields:{key:{type:e.String_unsecure(),isOptional:!1},locale:{type:e.String_unsecure(),isOptional:!1},value:{type:e.String_unsecure(),isOptional:!1},context:{type:e.String_unsecure(),isOptional:!0}}}),p=new t({name:`UpdateBlueprintTranslationInput`,fields:{blueprintName:{type:e.String_unsecure(),isOptional:!1},blueprintVersion:{type:e.Int_unsecure(),isOptional:!1},catalogName:{type:e.String_unsecure(),isOptional:!1},catalogVersion:{type:e.Int_unsecure(),isOptional:!1},defaultLocale:{type:e.String_unsecure(),isOptional:!1},supportedLocales:{type:e.String_unsecure(),isOptional:!1,isArray:!0},entries:{type:f,isOptional:!1,isArray:!0}}}),m=new t({name:`UpdateTenantTranslationInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},entries:{type:f,isOptional:!1,isArray:!0},defaultLocale:{type:e.String_unsecure(),isOptional:!0},enabledLocales:{type:e.String_unsecure(),isOptional:!0,isArray:!0}}}),h=new t({name:`MessageResolutionInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},locale:{type:e.String_unsecure(),isOptional:!1},key:{type:e.String_unsecure(),isOptional:!1}}}),g=new t({name:`MessageResolutionOutput`,fields:{value:{type:e.String_unsecure(),isOptional:!0},source:{type:e.String_unsecure(),isOptional:!0}}}),_=n({meta:{name:`appConfig.updateTenantBranding`,version:1,description:`Applies tenant branding overrides (names, assets, domains).`,owners:[i.PlatformSigil],tags:[`branding`],stability:a.Beta,goal:`Maintain tenant-specific branding assets and domains.`,context:`Invoked by the Studio or automation when a tenant updates branding settings.`},io:{input:c,output:l},policy:{auth:`admin`,policies:[{name:`platform.app-config.manage`,version:1}]}}),v=n({meta:{name:`appConfig.verifyCustomDomain`,version:1,description:`Validates DNS ownership for tenant custom domains.`,owners:[i.PlatformSigil],tags:[`branding`],stability:a.Experimental,goal:`Confirm tenant-provided domains before activation.`,context:`Triggered after the tenant adds DNS records to verify domain ownership.`},io:{input:u,output:d},policy:{auth:`admin`,policies:[{name:`platform.app-config.manage`,version:1}]}}),y=n({meta:{name:`appConfig.updateBlueprintTranslationCatalog`,version:1,description:`Registers or updates translation entries for a blueprint.`,owners:[i.PlatformSigil],tags:[o.I18n],stability:a.Beta,goal:`Keep blueprint translation catalogs in sync with shipped copy.`,context:`Executed by platform automation or CI when committing updated translation catalogs.`},io:{input:p,output:l},policy:{auth:`admin`,policies:[{name:`platform.app-config.manage`,version:1}]}}),b=n({meta:{name:`appConfig.updateTenantTranslations`,version:1,description:`Applies tenant-specific translation entries.`,owners:[i.PlatformSigil],tags:[o.I18n],stability:a.Beta,goal:`Allow tenants to override selected message keys.`,context:`Called by the Studio when a tenant customizes labels or copy for their locale.`},io:{input:m,output:l},policy:{auth:`admin`,policies:[{name:`platform.app-config.manage`,version:1}]}}),x=r({meta:{name:`appConfig.getResolvedBranding`,version:1,description:`Returns the resolved branding for a tenant/app/environment.`,owners:[i.PlatformSigil],tags:[`branding`],stability:a.Beta,goal:`Expose hydrated branding assets for rendering UI/email experiences.`,context:`Used by runtime surfaces to fetch brand assets prior to rendering tenant-specific experiences.`},io:{input:new t({name:`GetResolvedBrandingInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},environment:{type:e.String_unsecure(),isOptional:!0}}}),output:new t({name:`GetResolvedBrandingOutput`,fields:{branding:{type:e.JSONObject(),isOptional:!1}}})},policy:{auth:`admin`,policies:[{name:`platform.app-config.read`,version:1}]}}),S=r({meta:{name:`appConfig.resolveMessage`,version:1,description:`Resolves a translation key for a tenant in the requested locale.`,owners:[i.PlatformSigil],tags:[o.I18n],stability:a.Experimental,goal:`Expose a server-side API for resolving message keys on demand.`,context:`Used by backend services or scripts that need translated copy outside the front-end runtime.`},io:{input:h,output:g},policy:{auth:`admin`,policies:[{name:`platform.app-config.read`,version:1}]}}),C={UpdateTenantBrandingCommand:_,VerifyCustomDomainCommand:v,UpdateBlueprintTranslationCatalogCommand:y,UpdateTenantTranslationOverridesCommand:b,GetResolvedBrandingQuery:x,ResolveMessageQuery:S};function w(e){return e.register(_).register(v).register(y).register(b).register(x).register(S)}export{x as GetResolvedBrandingQuery,S as ResolveMessageQuery,y as UpdateBlueprintTranslationCatalogCommand,_ as UpdateTenantBrandingCommand,b as UpdateTenantTranslationOverridesCommand,v as VerifyCustomDomainCommand,C as appConfigContracts,w as 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 {\n  ScalarTypeEnum,\n  SchemaModel,\n} from '@lssm/lib.schema';\nimport {\n  defineCommand,\n  defineQuery,\n} 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: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    blueprintVersion: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    catalogName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    catalogVersion: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    defaultLocale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\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: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\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\n"],"mappings":"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"}

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

@@ -0,0 +1,123 @@
+import { EventSpec } from "../events.js";
+import "../index.js";
+import * as _lssm_lib_schema520 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_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _lssm_lib_schema520.FieldType<number, number>;
+    isOptional: false;
+  };
+  blueprintName: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  blueprintVersion: {
+    type: _lssm_lib_schema520.FieldType<number, number>;
+    isOptional: false;
+  };
+  createdBy: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  clonedFrom: {
+    type: _lssm_lib_schema520.FieldType<number, number>;
+    isOptional: true;
+  };
+}>>;
+declare const ConfigPromotedToPreviewEvent: EventSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _lssm_lib_schema520.FieldType<number, number>;
+    isOptional: false;
+  };
+  promotedBy: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  warnings: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: true;
+    isArray: true;
+  };
+}>>;
+declare const ConfigPublishedEvent: EventSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _lssm_lib_schema520.FieldType<number, number>;
+    isOptional: false;
+  };
+  previousVersion: {
+    type: _lssm_lib_schema520.FieldType<number, number>;
+    isOptional: true;
+  };
+  publishedBy: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  changeSummary: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: true;
+  };
+  changedSections: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: true;
+    isArray: true;
+  };
+}>>;
+declare const ConfigRolledBackEvent: EventSpec<SchemaModel<{
+  tenantId: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  appId: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  newVersion: {
+    type: _lssm_lib_schema520.FieldType<number, number>;
+    isOptional: false;
+  };
+  rolledBackFrom: {
+    type: _lssm_lib_schema520.FieldType<number, number>;
+    isOptional: false;
+  };
+  rolledBackTo: {
+    type: _lssm_lib_schema520.FieldType<number, number>;
+    isOptional: false;
+  };
+  rolledBackBy: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+  reason: {
+    type: _lssm_lib_schema520.FieldType<string, string>;
+    isOptional: false;
+  };
+}>>;
+//#endregion
+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;;UAoBlC,mBAAA,CAAA;;;EApBW,KAAA,EAAA;IAoBX,IAAA,+BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;EApBkC,aAAA,EAAA;IAAA,IAAA,+BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAsBvB,CAAA;EAmBX,gBAAA,EAAA;;;;;IAnBuC,IAAA,+BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;EAqB5B,UAAA,EAAA;IA8BX,IAAA,+BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;cAnDW,8BAA4B,UAAA;;UAmBvC,mBAAA,CAAA;IAE+B,UAAA,EAAA,KAAA;EAAA,CAAA;EAAA,KAAA,EAAA;IAgCpB,IAAA,+BA0BX,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;IA1BgC,IAAA,+BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;;;;;;;cAhCrB,sBAAoB,UAAA;;UA8B/B,mBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAEW,uBAAqB,UAAA;;UA0BhC,mBAAA,CAAA"}

package/dist/app-config/events.js

@@ -0,0 +1,2 @@
+import{l as e}from"../schema/dist/ScalarTypeEnum.js";import{t}from"../schema/dist/SchemaModel.js";import"../schema/dist/index.js";import{defineEvent as n}from"../events.js";import{OwnersEnum as r,StabilityEnum as i,TagsEnum as a}from"../ownership.js";const o={title:`Tenant App Config Lifecycle`,description:`Events emitted when tenant app configurations move through lifecycle stages.`,domain:`app-config.lifecycle`,owners:[r.PlatformSigil],tags:[a.Hygiene],stability:i.Beta},s=n({name:`app_config.draft_created`,version:1,description:`A new tenant config draft was created.`,ownership:o,payload:new t({name:`ConfigDraftCreatedPayload`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},version:{type:e.Int_unsecure(),isOptional:!1},blueprintName:{type:e.String_unsecure(),isOptional:!1},blueprintVersion:{type:e.Int_unsecure(),isOptional:!1},createdBy:{type:e.String_unsecure(),isOptional:!1},clonedFrom:{type:e.Int_unsecure(),isOptional:!0}}})}),c=n({name:`app_config.promoted_to_preview`,version:1,description:`A tenant config draft was promoted to preview.`,ownership:o,payload:new t({name:`ConfigPromotedToPreviewPayload`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},version:{type:e.Int_unsecure(),isOptional:!1},promotedBy:{type:e.String_unsecure(),isOptional:!1},warnings:{type:e.String_unsecure(),isOptional:!0,isArray:!0}}})}),l=n({name:`app_config.published`,version:1,description:`A tenant config version was published to production.`,ownership:o,payload:new t({name:`ConfigPublishedPayload`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},version:{type:e.Int_unsecure(),isOptional:!1},previousVersion:{type:e.Int_unsecure(),isOptional:!0},publishedBy:{type:e.String_unsecure(),isOptional:!1},changeSummary:{type:e.String_unsecure(),isOptional:!0},changedSections:{type:e.String_unsecure(),isOptional:!0,isArray:!0}}})}),u=n({name:`app_config.rolled_back`,version:1,description:`A tenant config was rolled back to a previous version.`,ownership:o,payload:new t({name:`ConfigRolledBackPayload`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},newVersion:{type:e.Int_unsecure(),isOptional:!1},rolledBackFrom:{type:e.Int_unsecure(),isOptional:!1},rolledBackTo:{type:e.Int_unsecure(),isOptional:!1},rolledBackBy:{type:e.String_unsecure(),isOptional:!1},reason:{type:e.String_unsecure(),isOptional:!1}}})});export{s as ConfigDraftCreatedEvent,c as ConfigPromotedToPreviewEvent,l as ConfigPublishedEvent,u as ConfigRolledBackEvent};
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":["SchemaModel","ScalarTypeEnum"],"sources":["../../src/app-config/events.ts"],"sourcesContent":["import { SchemaModel, ScalarTypeEnum } from '@lssm/lib.schema';\nimport { defineEvent } from '../events';\nimport { OwnersEnum, StabilityEnum, TagsEnum } from '../ownership';\n\nconst lifecycleOwnership = {\n  title: 'Tenant App Config Lifecycle',\n  description:\n    'Events emitted when tenant app configurations move through lifecycle stages.',\n  domain: 'app-config.lifecycle',\n  owners: [OwnersEnum.PlatformSigil],\n  tags: [TagsEnum.Hygiene],\n  stability: StabilityEnum.Beta,\n};\n\nexport const ConfigDraftCreatedEvent = defineEvent({\n  name: 'app_config.draft_created',\n  version: 1,\n  description: 'A new tenant config draft was created.',\n  ownership: lifecycleOwnership,\n  payload: new SchemaModel({\n    name: 'ConfigDraftCreatedPayload',\n    fields: {\n      tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n      appId: { type: ScalarTypeEnum.ID(), isOptional: false },\n      version: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n      blueprintName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n      blueprintVersion: {\n        type: ScalarTypeEnum.Int_unsecure(),\n        isOptional: false,\n      },\n      createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n      clonedFrom: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    },\n  }),\n});\n\nexport const ConfigPromotedToPreviewEvent = defineEvent({\n  name: 'app_config.promoted_to_preview',\n  version: 1,\n  description: 'A tenant config draft was promoted to preview.',\n  ownership: lifecycleOwnership,\n  payload: new SchemaModel({\n    name: 'ConfigPromotedToPreviewPayload',\n    fields: {\n      tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n      appId: { type: ScalarTypeEnum.ID(), isOptional: false },\n      version: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n      promotedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n      warnings: {\n        type: ScalarTypeEnum.String_unsecure(),\n        isOptional: true,\n        isArray: true,\n      },\n    },\n  }),\n});\n\nexport const ConfigPublishedEvent = defineEvent({\n  name: 'app_config.published',\n  version: 1,\n  description: 'A tenant config version was published to production.',\n  ownership: lifecycleOwnership,\n  payload: new SchemaModel({\n    name: 'ConfigPublishedPayload',\n    fields: {\n      tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n      appId: { type: ScalarTypeEnum.ID(), isOptional: false },\n      version: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n      previousVersion: {\n        type: ScalarTypeEnum.Int_unsecure(),\n        isOptional: true,\n      },\n      publishedBy: {\n        type: ScalarTypeEnum.String_unsecure(),\n        isOptional: false,\n      },\n      changeSummary: {\n        type: ScalarTypeEnum.String_unsecure(),\n        isOptional: true,\n      },\n      changedSections: {\n        type: ScalarTypeEnum.String_unsecure(),\n        isOptional: true,\n        isArray: true,\n      },\n    },\n  }),\n});\n\nexport const ConfigRolledBackEvent = defineEvent({\n  name: 'app_config.rolled_back',\n  version: 1,\n  description: 'A tenant config was rolled back to a previous version.',\n  ownership: lifecycleOwnership,\n  payload: new SchemaModel({\n    name: 'ConfigRolledBackPayload',\n    fields: {\n      tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n      appId: { type: ScalarTypeEnum.ID(), isOptional: false },\n      newVersion: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n      rolledBackFrom: {\n        type: ScalarTypeEnum.Int_unsecure(),\n        isOptional: false,\n      },\n      rolledBackTo: {\n        type: ScalarTypeEnum.Int_unsecure(),\n        isOptional: false,\n      },\n      rolledBackBy: {\n        type: ScalarTypeEnum.String_unsecure(),\n        isOptional: false,\n      },\n      reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    },\n  }),\n});\n\n\n\n\n\n\n\n\n"],"mappings":"2PAIA,MAAM,EAAqB,CACzB,MAAO,8BACP,YACE,+EACF,OAAQ,uBACR,OAAQ,CAAC,EAAW,cAAc,CAClC,KAAM,CAAC,EAAS,QAAQ,CACxB,UAAW,EAAc,KAC1B,CAEY,EAA0B,EAAY,CACjD,KAAM,2BACN,QAAS,EACT,YAAa,yCACb,UAAW,EACX,QAAS,IAAIA,EAAY,CACvB,KAAM,4BACN,OAAQ,CACN,SAAU,CAAE,KAAMC,EAAe,IAAI,CAAE,WAAY,GAAO,CAC1D,MAAO,CAAE,KAAMA,EAAe,IAAI,CAAE,WAAY,GAAO,CACvD,QAAS,CAAE,KAAMA,EAAe,cAAc,CAAE,WAAY,GAAO,CACnE,cAAe,CAAE,KAAMA,EAAe,iBAAiB,CAAE,WAAY,GAAO,CAC5E,iBAAkB,CAChB,KAAMA,EAAe,cAAc,CACnC,WAAY,GACb,CACD,UAAW,CAAE,KAAMA,EAAe,iBAAiB,CAAE,WAAY,GAAO,CACxE,WAAY,CAAE,KAAMA,EAAe,cAAc,CAAE,WAAY,GAAM,CACtE,CACF,CAAC,CACH,CAAC,CAEW,EAA+B,EAAY,CACtD,KAAM,iCACN,QAAS,EACT,YAAa,iDACb,UAAW,EACX,QAAS,IAAID,EAAY,CACvB,KAAM,iCACN,OAAQ,CACN,SAAU,CAAE,KAAMC,EAAe,IAAI,CAAE,WAAY,GAAO,CAC1D,MAAO,CAAE,KAAMA,EAAe,IAAI,CAAE,WAAY,GAAO,CACvD,QAAS,CAAE,KAAMA,EAAe,cAAc,CAAE,WAAY,GAAO,CACnE,WAAY,CAAE,KAAMA,EAAe,iBAAiB,CAAE,WAAY,GAAO,CACzE,SAAU,CACR,KAAMA,EAAe,iBAAiB,CACtC,WAAY,GACZ,QAAS,GACV,CACF,CACF,CAAC,CACH,CAAC,CAEW,EAAuB,EAAY,CAC9C,KAAM,uBACN,QAAS,EACT,YAAa,uDACb,UAAW,EACX,QAAS,IAAID,EAAY,CACvB,KAAM,yBACN,OAAQ,CACN,SAAU,CAAE,KAAMC,EAAe,IAAI,CAAE,WAAY,GAAO,CAC1D,MAAO,CAAE,KAAMA,EAAe,IAAI,CAAE,WAAY,GAAO,CACvD,QAAS,CAAE,KAAMA,EAAe,cAAc,CAAE,WAAY,GAAO,CACnE,gBAAiB,CACf,KAAMA,EAAe,cAAc,CACnC,WAAY,GACb,CACD,YAAa,CACX,KAAMA,EAAe,iBAAiB,CACtC,WAAY,GACb,CACD,cAAe,CACb,KAAMA,EAAe,iBAAiB,CACtC,WAAY,GACb,CACD,gBAAiB,CACf,KAAMA,EAAe,iBAAiB,CACtC,WAAY,GACZ,QAAS,GACV,CACF,CACF,CAAC,CACH,CAAC,CAEW,EAAwB,EAAY,CAC/C,KAAM,yBACN,QAAS,EACT,YAAa,yDACb,UAAW,EACX,QAAS,IAAID,EAAY,CACvB,KAAM,0BACN,OAAQ,CACN,SAAU,CAAE,KAAMC,EAAe,IAAI,CAAE,WAAY,GAAO,CAC1D,MAAO,CAAE,KAAMA,EAAe,IAAI,CAAE,WAAY,GAAO,CACvD,WAAY,CAAE,KAAMA,EAAe,cAAc,CAAE,WAAY,GAAO,CACtE,eAAgB,CACd,KAAMA,EAAe,cAAc,CACnC,WAAY,GACb,CACD,aAAc,CACZ,KAAMA,EAAe,cAAc,CACnC,WAAY,GACb,CACD,aAAc,CACZ,KAAMA,EAAe,iBAAiB,CACtC,WAAY,GACb,CACD,OAAQ,CAAE,KAAMA,EAAe,iBAAiB,CAAE,WAAY,GAAO,CACtE,CACF,CAAC,CACH,CAAC"}

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

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

package/dist/app-config/index.js

@@ -0,0 +1 @@
+import{AppBlueprintRegistry as e,makeAppBlueprintKey as t}from"./spec.js";import{composeAppConfig as n,resolveAppConfig as r}from"./runtime.js";import{ConfigDraftCreatedEvent as i,ConfigPromotedToPreviewEvent as a,ConfigPublishedEvent as o,ConfigRolledBackEvent as s}from"./events.js";import{validateBlueprint as c,validateConfig as l,validateResolvedConfig as u,validateTenantConfig as d}from"./validation.js";import{CreateTenantConfigDraftCommand as f,GetTenantConfigVersionQuery as p,ListTenantConfigVersionsQuery as m,PromoteTenantConfigToPreviewCommand as h,PublishTenantConfigCommand as g,RollbackTenantConfigCommand as _,lifecycleContracts as v,registerAppConfigLifecycleContracts as y}from"./lifecycle-contracts.js";export{e as AppBlueprintRegistry,i as ConfigDraftCreatedEvent,a as ConfigPromotedToPreviewEvent,o as ConfigPublishedEvent,s as ConfigRolledBackEvent,f as CreateTenantConfigDraftCommand,p as GetTenantConfigVersionQuery,m as ListTenantConfigVersionsQuery,h as PromoteTenantConfigToPreviewCommand,g as PublishTenantConfigCommand,_ as RollbackTenantConfigCommand,n as composeAppConfig,v as lifecycleContracts,t as makeAppBlueprintKey,y as registerAppConfigLifecycleContracts,r as resolveAppConfig,c as validateBlueprint,l as validateConfig,u as validateResolvedConfig,d as validateTenantConfig};