@contractspec/lib.contracts 1.44.1 → 1.45.0

package/README.md

@@ -61,7 +61,7 @@ const UserInput = new SchemaModel({
 export const CreateUser = defineCommand({
   meta: {
     name: 'user.create',
-    version: 1,
+    version: '1.0.0',
     description: 'Register a new user',
     owners: ['team-auth'],
     tags: ['auth'],

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

@@ -6,7 +6,7 @@
 const AppConfigFeature = {
 	meta: {
 		key: "app-config",
-		version: 1,
+		version: "1.0.0",
 		title: "App Configuration",
 		description: "Tenant app configuration lifecycle management with draft, preview, and publish stages",
 		domain: "platform",
@@ -23,19 +23,19 @@ const AppConfigFeature = {
 	events: [
 		{
 			key: "app_config.draft_created",
-			version: 1
+			version: "1.0.0"
 		},
 		{
 			key: "app_config.promoted_to_preview",
-			version: 1
+			version: "1.0.0"
 		},
 		{
 			key: "app_config.published",
-			version: 1
+			version: "1.0.0"
 		},
 		{
 			key: "app_config.rolled_back",
-			version: 1
+			version: "1.0.0"
 		}
 	],
 	presentations: [],
@@ -44,7 +44,7 @@ const AppConfigFeature = {
 	capabilities: {
 		provides: [{
 			key: "app-config",
-			version: 1
+			version: "1.0.0"
 		}],
 		requires: []
 	}

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

@@ -99,7 +99,7 @@ declare const UpdateBlueprintTranslationCatalogCommand: OperationSpec<SchemaMode
     isOptional: false;
   };
   catalogVersion: {
-    type: _contractspec_lib_schema392.FieldType<number, number>;
+    type: _contractspec_lib_schema392.FieldType<string, string>;
     isOptional: false;
   };
   defaultLocale: {

package/dist/app-config/contracts.js

@@ -139,7 +139,7 @@ const UpdateBlueprintTranslationInput = new SchemaModel({
 			isOptional: false
 		},
 		catalogVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		defaultLocale: {
@@ -222,7 +222,7 @@ const MessageResolutionOutput = new SchemaModel({
 const UpdateTenantBrandingCommand = defineCommand({
 	meta: {
 		key: "appConfig.updateTenantBranding",
-		version: 1,
+		version: "1.0.0",
 		description: "Applies tenant branding overrides (names, assets, domains).",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: ["branding"],
@@ -238,14 +238,14 @@ const UpdateTenantBrandingCommand = defineCommand({
 		auth: "admin",
 		policies: [{
 			key: "platform.app-config.manage",
-			version: 1
+			version: "1.0.0"
 		}]
 	}
 });
 const VerifyCustomDomainCommand = defineCommand({
 	meta: {
 		key: "appConfig.verifyCustomDomain",
-		version: 1,
+		version: "1.0.0",
 		description: "Validates DNS ownership for tenant custom domains.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: ["branding"],
@@ -261,14 +261,14 @@ const VerifyCustomDomainCommand = defineCommand({
 		auth: "admin",
 		policies: [{
 			key: "platform.app-config.manage",
-			version: 1
+			version: "1.0.0"
 		}]
 	}
 });
 const UpdateBlueprintTranslationCatalogCommand = defineCommand({
 	meta: {
 		key: "appConfig.updateBlueprintTranslationCatalog",
-		version: 1,
+		version: "1.0.0",
 		description: "Registers or updates translation entries for a blueprint.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: [TagsEnum.I18n],
@@ -284,14 +284,14 @@ const UpdateBlueprintTranslationCatalogCommand = defineCommand({
 		auth: "admin",
 		policies: [{
 			key: "platform.app-config.manage",
-			version: 1
+			version: "1.0.0"
 		}]
 	}
 });
 const UpdateTenantTranslationOverridesCommand = defineCommand({
 	meta: {
 		key: "appConfig.updateTenantTranslations",
-		version: 1,
+		version: "1.0.0",
 		description: "Applies tenant-specific translation entries.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: [TagsEnum.I18n],
@@ -307,14 +307,14 @@ const UpdateTenantTranslationOverridesCommand = defineCommand({
 		auth: "admin",
 		policies: [{
 			key: "platform.app-config.manage",
-			version: 1
+			version: "1.0.0"
 		}]
 	}
 });
 const GetResolvedBrandingQuery = defineQuery({
 	meta: {
 		key: "appConfig.getResolvedBranding",
-		version: 1,
+		version: "1.0.0",
 		description: "Returns the resolved branding for a tenant/app/environment.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: ["branding"],
@@ -352,14 +352,14 @@ const GetResolvedBrandingQuery = defineQuery({
 		auth: "admin",
 		policies: [{
 			key: "platform.app-config.read",
-			version: 1
+			version: "1.0.0"
 		}]
 	}
 });
 const ResolveMessageQuery = defineQuery({
 	meta: {
 		key: "appConfig.resolveMessage",
-		version: 1,
+		version: "1.0.0",
 		description: "Resolves a translation key for a tenant in the requested locale.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: [TagsEnum.I18n],
@@ -375,7 +375,7 @@ const ResolveMessageQuery = defineQuery({
 		auth: "admin",
 		policies: [{
 			key: "platform.app-config.read",
-			version: 1
+			version: "1.0.0"
 		}]
 	}
 });

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

@@ -14,7 +14,7 @@ declare const ConfigDraftCreatedEvent: EventSpec<SchemaModel<{
     isOptional: false;
   };
   version: {
-    type: _contractspec_lib_schema441.FieldType<number, number>;
+    type: _contractspec_lib_schema441.FieldType<string, string>;
     isOptional: false;
   };
   blueprintName: {
@@ -22,7 +22,7 @@ declare const ConfigDraftCreatedEvent: EventSpec<SchemaModel<{
     isOptional: false;
   };
   blueprintVersion: {
-    type: _contractspec_lib_schema441.FieldType<number, number>;
+    type: _contractspec_lib_schema441.FieldType<string, string>;
     isOptional: false;
   };
   createdBy: {
@@ -44,7 +44,7 @@ declare const ConfigPromotedToPreviewEvent: EventSpec<SchemaModel<{
     isOptional: false;
   };
   version: {
-    type: _contractspec_lib_schema441.FieldType<number, number>;
+    type: _contractspec_lib_schema441.FieldType<string, string>;
     isOptional: false;
   };
   promotedBy: {
@@ -67,11 +67,11 @@ declare const ConfigPublishedEvent: EventSpec<SchemaModel<{
     isOptional: false;
   };
   version: {
-    type: _contractspec_lib_schema441.FieldType<number, number>;
+    type: _contractspec_lib_schema441.FieldType<string, string>;
     isOptional: false;
   };
   previousVersion: {
-    type: _contractspec_lib_schema441.FieldType<number, number>;
+    type: _contractspec_lib_schema441.FieldType<string, string>;
     isOptional: true;
   };
   publishedBy: {
@@ -98,15 +98,15 @@ declare const ConfigRolledBackEvent: EventSpec<SchemaModel<{
     isOptional: false;
   };
   newVersion: {
-    type: _contractspec_lib_schema441.FieldType<number, number>;
+    type: _contractspec_lib_schema441.FieldType<string, string>;
     isOptional: false;
   };
   rolledBackFrom: {
-    type: _contractspec_lib_schema441.FieldType<number, number>;
+    type: _contractspec_lib_schema441.FieldType<string, string>;
     isOptional: false;
   };
   rolledBackTo: {
-    type: _contractspec_lib_schema441.FieldType<number, number>;
+    type: _contractspec_lib_schema441.FieldType<string, string>;
     isOptional: false;
   };
   rolledBackBy: {

package/dist/app-config/events.js

@@ -15,7 +15,7 @@ const ConfigDraftCreatedEvent = defineEvent({
 	meta: {
 		...lifecycleOwnership,
 		key: "app_config.draft_created",
-		version: 1,
+		version: "1.0.0",
 		description: "A new tenant config draft was created."
 	},
 	payload: new SchemaModel({
@@ -30,7 +30,7 @@ const ConfigDraftCreatedEvent = defineEvent({
 				isOptional: false
 			},
 			version: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			blueprintName: {
@@ -38,7 +38,7 @@ const ConfigDraftCreatedEvent = defineEvent({
 				isOptional: false
 			},
 			blueprintVersion: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			createdBy: {
@@ -56,7 +56,7 @@ const ConfigPromotedToPreviewEvent = defineEvent({
 	meta: {
 		...lifecycleOwnership,
 		key: "app_config.promoted_to_preview",
-		version: 1,
+		version: "1.0.0",
 		description: "A tenant config draft was promoted to preview."
 	},
 	payload: new SchemaModel({
@@ -71,7 +71,7 @@ const ConfigPromotedToPreviewEvent = defineEvent({
 				isOptional: false
 			},
 			version: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			promotedBy: {
@@ -90,7 +90,7 @@ const ConfigPublishedEvent = defineEvent({
 	meta: {
 		...lifecycleOwnership,
 		key: "app_config.published",
-		version: 1,
+		version: "1.0.0",
 		description: "A tenant config version was published to production."
 	},
 	payload: new SchemaModel({
@@ -105,11 +105,11 @@ const ConfigPublishedEvent = defineEvent({
 				isOptional: false
 			},
 			version: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			previousVersion: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: true
 			},
 			publishedBy: {
@@ -132,7 +132,7 @@ const ConfigRolledBackEvent = defineEvent({
 	meta: {
 		...lifecycleOwnership,
 		key: "app_config.rolled_back",
-		version: 1,
+		version: "1.0.0",
 		description: "A tenant config was rolled back to a previous version."
 	},
 	payload: new SchemaModel({
@@ -147,15 +147,15 @@ const ConfigRolledBackEvent = defineEvent({
 				isOptional: false
 			},
 			newVersion: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			rolledBackFrom: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			rolledBackTo: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			rolledBackBy: {

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

@@ -29,7 +29,7 @@ declare const CreateTenantConfigDraftCommand: OperationSpec<SchemaModel<{
     isOptional: true;
   };
   fromVersion: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema467.FieldType<string, string>;
     isOptional: true;
   };
   createdBy: {
@@ -38,7 +38,7 @@ declare const CreateTenantConfigDraftCommand: OperationSpec<SchemaModel<{
   };
 }>, SchemaModel<{
   version: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema467.FieldType<string, string>;
     isOptional: false;
   };
   status: {
@@ -63,7 +63,7 @@ declare const PromoteTenantConfigToPreviewCommand: OperationSpec<SchemaModel<{
     isOptional: false;
   };
   version: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema467.FieldType<string, string>;
     isOptional: false;
   };
   promotedBy: {
@@ -72,7 +72,7 @@ declare const PromoteTenantConfigToPreviewCommand: OperationSpec<SchemaModel<{
   };
 }>, SchemaModel<{
   version: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema467.FieldType<string, string>;
     isOptional: false;
   };
   status: {
@@ -98,7 +98,7 @@ declare const PublishTenantConfigCommand: OperationSpec<SchemaModel<{
     isOptional: false;
   };
   version: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema467.FieldType<string, string>;
     isOptional: false;
   };
   environment: {
@@ -115,7 +115,7 @@ declare const PublishTenantConfigCommand: OperationSpec<SchemaModel<{
   };
 }>, SchemaModel<{
   version: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema467.FieldType<string, string>;
     isOptional: false;
   };
   status: {
@@ -123,7 +123,7 @@ declare const PublishTenantConfigCommand: OperationSpec<SchemaModel<{
     isOptional: false;
   };
   previousVersion: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema467.FieldType<string, string>;
     isOptional: true;
   };
   publishedAt: {
@@ -144,7 +144,7 @@ declare const RollbackTenantConfigCommand: OperationSpec<SchemaModel<{
     isOptional: false;
   };
   toVersion: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema467.FieldType<string, string>;
     isOptional: false;
   };
   environment: {
@@ -161,7 +161,7 @@ declare const RollbackTenantConfigCommand: OperationSpec<SchemaModel<{
   };
 }>, SchemaModel<{
   newVersion: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema467.FieldType<string, string>;
     isOptional: false;
   };
   status: {
@@ -219,7 +219,7 @@ declare const ListTenantConfigVersionsQuery: OperationSpec<SchemaModel<{
         isOptional: false;
       };
       version: {
-        type: _contractspec_lib_schema467.FieldType<number, number>;
+        type: _contractspec_lib_schema467.FieldType<string, string>;
         isOptional: false;
       };
       timestamp: {
@@ -249,7 +249,7 @@ declare const GetTenantConfigVersionQuery: OperationSpec<SchemaModel<{
     isOptional: false;
   };
   version: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema467.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{

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

@@ -9,14 +9,14 @@ const LifecyclePolicy = {
 	auth: "admin",
 	policies: [{
 		key: "platform.app-config.manage",
-		version: 1
+		version: "1.0.0"
 	}]
 };
 const LifecycleReadPolicy = {
 	auth: "admin",
 	policies: [{
 		key: "platform.app-config.read",
-		version: 1
+		version: "1.0.0"
 	}]
 };
 const ConfigVersionRecord = new SchemaModel({
@@ -52,7 +52,7 @@ const ConfigTransitionRecord = new SchemaModel({
 			isOptional: false
 		},
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		timestamp: {
@@ -93,7 +93,7 @@ const CreateDraftInput = new SchemaModel({
 			isOptional: true
 		},
 		fromVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: true
 		},
 		createdBy: {
@@ -106,7 +106,7 @@ const CreateDraftOutput = new SchemaModel({
 	name: "CreateTenantConfigDraftOutput",
 	fields: {
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		status: {
@@ -122,7 +122,7 @@ const CreateDraftOutput = new SchemaModel({
 const CreateTenantConfigDraftCommand = defineCommand({
 	meta: {
 		key: "appConfig.lifecycle.createDraft",
-		version: 1,
+		version: "1.0.0",
 		description: "Creates a new draft tenant config version.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: [TagsEnum.Hygiene, "app-config"],
@@ -152,7 +152,7 @@ const PromotePreviewInput = new SchemaModel({
 			isOptional: false
 		},
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		promotedBy: {
@@ -165,7 +165,7 @@ const PromotePreviewOutput = new SchemaModel({
 	name: "PromoteTenantConfigPreviewOutput",
 	fields: {
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		status: {
@@ -182,7 +182,7 @@ const PromotePreviewOutput = new SchemaModel({
 const PromoteTenantConfigToPreviewCommand = defineCommand({
 	meta: {
 		key: "appConfig.lifecycle.promoteToPreview",
-		version: 1,
+		version: "1.0.0",
 		description: "Promotes a draft tenant config to preview/testing state.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: [TagsEnum.Hygiene, "app-config"],
@@ -212,7 +212,7 @@ const PublishConfigInput = new SchemaModel({
 			isOptional: false
 		},
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		environment: {
@@ -233,7 +233,7 @@ const PublishConfigOutput = new SchemaModel({
 	name: "PublishTenantConfigOutput",
 	fields: {
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		status: {
@@ -241,7 +241,7 @@ const PublishConfigOutput = new SchemaModel({
 			isOptional: false
 		},
 		previousVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: true
 		},
 		publishedAt: {
@@ -253,7 +253,7 @@ const PublishConfigOutput = new SchemaModel({
 const PublishTenantConfigCommand = defineCommand({
 	meta: {
 		key: "appConfig.lifecycle.publish",
-		version: 1,
+		version: "1.0.0",
 		description: "Publishes a preview tenant config to production.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: [TagsEnum.Hygiene, "app-config"],
@@ -283,7 +283,7 @@ const RollbackConfigInput = new SchemaModel({
 			isOptional: false
 		},
 		toVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		environment: {
@@ -304,7 +304,7 @@ const RollbackConfigOutput = new SchemaModel({
 	name: "RollbackTenantConfigOutput",
 	fields: {
 		newVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		status: {
@@ -320,7 +320,7 @@ const RollbackConfigOutput = new SchemaModel({
 const RollbackTenantConfigCommand = defineCommand({
 	meta: {
 		key: "appConfig.lifecycle.rollback",
-		version: 1,
+		version: "1.0.0",
 		description: "Rolls back to a previously published tenant config version.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: [TagsEnum.Hygiene, "app-config"],
@@ -369,7 +369,7 @@ const ListVersionsOutput = new SchemaModel({
 const ListTenantConfigVersionsQuery = defineQuery({
 	meta: {
 		key: "appConfig.lifecycle.listVersions",
-		version: 1,
+		version: "1.0.0",
 		description: "Lists all versions of a tenant configuration.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: ["app-config", TagsEnum.Hygiene],
@@ -395,7 +395,7 @@ const GetVersionInput = new SchemaModel({
 			isOptional: false
 		},
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		}
 	}
@@ -410,7 +410,7 @@ const GetVersionOutput = new SchemaModel({
 const GetTenantConfigVersionQuery = defineQuery({
 	meta: {
 		key: "appConfig.lifecycle.getVersion",
-		version: 1,
+		version: "1.0.0",
 		description: "Fetches a single tenant config version by id.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: ["app-config", TagsEnum.Hygiene],

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

@@ -11,7 +11,7 @@ interface ConfigTransition {
   appId: string;
   fromStatus: ConfigStatus;
   toStatus: ConfigStatus;
-  version: number;
+  version: string;
   timestamp: string | Date;
   actor: string;
   reason?: string;
@@ -21,7 +21,7 @@ interface ConfigVersionHistory {
   appId: string;
   versions: TenantAppConfigVersion[];
   transitions: ConfigTransition[];
-  currentPublished?: number;
+  currentPublished?: string;
 }
 //#endregion
 export { ConfigStatus, ConfigTransition, ConfigVersionHistory, TenantAppConfigVersion };

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

@@ -2,7 +2,6 @@ import { CapabilityRef, CapabilityRegistry, CapabilitySpec } from "../capabiliti
 import "../capabilities/index.js";
 import { PolicyRef, PolicySpec } from "../policy/spec.js";
 import { TelemetryRegistry, TelemetrySpec } from "../telemetry/spec.js";
-import { ExperimentRef, ExperimentRegistry, ExperimentSpec } from "../experiments/spec.js";
 import { DataViewSpec } from "../data-views/spec.js";
 import { DataViewRegistry } from "../data-views/registry.js";
 import "../data-views/index.js";
@@ -18,6 +17,7 @@ import { AppKnowledgeBinding } from "../knowledge/binding.js";
 import { ResolvedBranding } from "./branding.js";
 import { Locale, TranslationEntry } from "../translations/catalog.js";
 import { AppBlueprintSpec, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, FeatureFlagState, SpecPointer, TelemetryBinding, TenantAppConfig, TranslationCatalogPointer } from "./spec.js";
+import { ExperimentRef, ExperimentRegistry, ExperimentSpec } from "../experiments/spec.js";
 import { FeatureModuleSpec, FeatureRef } from "../features/types.js";
 import { FeatureRegistry } from "../features/registry.js";
 import "../features/index.js";
@@ -45,8 +45,8 @@ interface ResolvedAppConfig {
   tenantId: string;
   environment?: string;
   blueprintName: string;
-  blueprintVersion: number;
-  configVersion: number;
+  blueprintVersion: string;
+  configVersion: string;
   capabilities: {
     enabled: CapabilityRef[];
     disabled: CapabilityRef[];