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

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

@@ -1 +1,441 @@
-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";import{ConfigDraftCreatedEvent as s,ConfigPromotedToPreviewEvent as c,ConfigPublishedEvent as l,ConfigRolledBackEvent as u}from"./events.js";const d={auth:`admin`,policies:[{name:`platform.app-config.manage`,version:1}]},f={auth:`admin`,policies:[{name:`platform.app-config.read`,version:1}]},p=new t({name:`ConfigVersionRecord`,fields:{meta:{type:e.JSONObject(),isOptional:!1},config:{type:e.JSONObject(),isOptional:!1}}}),m=new t({name:`ConfigTransitionRecord`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},fromStatus:{type:e.String_unsecure(),isOptional:!1},toStatus:{type:e.String_unsecure(),isOptional:!1},version:{type:e.Int_unsecure(),isOptional:!1},timestamp:{type:e.DateTime(),isOptional:!1},actor:{type:e.String_unsecure(),isOptional:!1},reason:{type:e.String_unsecure(),isOptional:!0}}}),h=new t({name:`CreateTenantConfigDraftInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},blueprintName:{type:e.String_unsecure(),isOptional:!1},blueprintVersion:{type:e.Int_unsecure(),isOptional:!1},environment:{type:e.String_unsecure(),isOptional:!0},fromVersion:{type:e.Int_unsecure(),isOptional:!0},createdBy:{type:e.String_unsecure(),isOptional:!1}}}),g=new t({name:`CreateTenantConfigDraftOutput`,fields:{version:{type:e.Int_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),_=n({meta:{name:`appConfig.lifecycle.createDraft`,version:1,description:`Creates a new draft tenant config version.`,owners:[i.PlatformSigil],tags:[o.Hygiene,`app-config`],stability:a.Experimental,goal:`Allow operators to start editing a new tenant config version.`,context:`Invoked by the Studio or automation when starting a new configuration run.`},io:{input:h,output:g},policy:d,sideEffects:{emits:[{ref:s,when:`after successful draft creation`}]}}),v=new t({name:`PromoteTenantConfigPreviewInput`,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}}}),y=new t({name:`PromoteTenantConfigPreviewOutput`,fields:{version:{type:e.Int_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},warnings:{type:e.String_unsecure(),isOptional:!0,isArray:!0}}}),b=n({meta:{name:`appConfig.lifecycle.promoteToPreview`,version:1,description:`Promotes a draft tenant config to preview/testing state.`,owners:[i.PlatformSigil],tags:[o.Hygiene,`app-config`],stability:a.Experimental,goal:`Enable validation and testing of draft configurations.`,context:`Called when a draft passes initial checks and should be exposed to preview environments.`},io:{input:v,output:y},policy:d,sideEffects:{emits:[{ref:c,when:`after promotion to preview`}]}}),x=new t({name:`PublishTenantConfigInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},version:{type:e.Int_unsecure(),isOptional:!1},environment:{type:e.String_unsecure(),isOptional:!0},publishedBy:{type:e.String_unsecure(),isOptional:!1},changeSummary:{type:e.String_unsecure(),isOptional:!0}}}),S=new t({name:`PublishTenantConfigOutput`,fields:{version:{type:e.Int_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},previousVersion:{type:e.Int_unsecure(),isOptional:!0},publishedAt:{type:e.DateTime(),isOptional:!1}}}),C=n({meta:{name:`appConfig.lifecycle.publish`,version:1,description:`Publishes a preview tenant config to production.`,owners:[i.PlatformSigil],tags:[o.Hygiene,`app-config`],stability:a.Experimental,goal:`Promote tested configurations to production safely.`,context:`Triggered after validation passes and change management approvals are complete.`},io:{input:x,output:S},policy:d,sideEffects:{emits:[{ref:l,when:`after publish succeeds`}]}}),w=new t({name:`RollbackTenantConfigInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},toVersion:{type:e.Int_unsecure(),isOptional:!1},environment:{type:e.String_unsecure(),isOptional:!0},rolledBackBy:{type:e.String_unsecure(),isOptional:!1},reason:{type:e.String_unsecure(),isOptional:!1}}}),T=new t({name:`RollbackTenantConfigOutput`,fields:{newVersion:{type:e.Int_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},rolledBackFrom:{type:e.Int_unsecure(),isOptional:!1}}}),E=n({meta:{name:`appConfig.lifecycle.rollback`,version:1,description:`Rolls back to a previously published tenant config version.`,owners:[i.PlatformSigil],tags:[o.Hygiene,`app-config`],stability:a.Experimental,goal:`Provide rapid recovery when new configs regress production.`,context:`Called manually or automatically when monitoring detects regression and a rollback is required.`},io:{input:w,output:T},policy:d,sideEffects:{emits:[{ref:u,when:`after rollback completes`}]}}),D=new t({name:`ListTenantConfigVersionsInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1}}}),O=new t({name:`ListTenantConfigVersionsOutput`,fields:{versions:{type:p,isOptional:!1,isArray:!0},transitions:{type:m,isOptional:!0,isArray:!0}}}),k=r({meta:{name:`appConfig.lifecycle.listVersions`,version:1,description:`Lists all versions of a tenant configuration.`,owners:[i.PlatformSigil],tags:[`app-config`,o.Hygiene],stability:a.Experimental,goal:`Support lifecycle views and change audit tooling.`,context:`Used by the Studio to render history timelines and by automation for change tracking.`},io:{input:D,output:O},policy:f}),A=new t({name:`GetTenantConfigVersionInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},appId:{type:e.ID(),isOptional:!1},version:{type:e.Int_unsecure(),isOptional:!1}}}),j=new t({name:`GetTenantConfigVersionOutput`,fields:{version:{type:p,isOptional:!1}}}),M=r({meta:{name:`appConfig.lifecycle.getVersion`,version:1,description:`Fetches a single tenant config version by id.`,owners:[i.PlatformSigil],tags:[`app-config`,o.Hygiene],stability:a.Experimental,goal:`Allow detail drill-down for lifecycle entries.`,context:`Used by automation to fetch config payloads for comparison or export.`},io:{input:A,output:j},policy:f}),N={CreateTenantConfigDraftCommand:_,PromoteTenantConfigToPreviewCommand:b,PublishTenantConfigCommand:C,RollbackTenantConfigCommand:E,ListTenantConfigVersionsQuery:k,GetTenantConfigVersionQuery:M};function P(e){return e.register(_).register(b).register(C).register(E).register(k).register(M)}export{_ as CreateTenantConfigDraftCommand,M as GetTenantConfigVersionQuery,k as ListTenantConfigVersionsQuery,b as PromoteTenantConfigToPreviewCommand,C as PublishTenantConfigCommand,E as RollbackTenantConfigCommand,N as lifecycleContracts,P as registerAppConfigLifecycleContracts};
+import { ScalarTypeEnum } from "../schema/dist/ScalarTypeEnum.js";
+import { SchemaModel } from "../schema/dist/SchemaModel.js";
+import "../schema/dist/index.js";
+import { defineCommand, defineQuery } from "../spec.js";
+import { OwnersEnum, StabilityEnum, TagsEnum } from "../ownership.js";
+import { ConfigDraftCreatedEvent, ConfigPromotedToPreviewEvent, ConfigPublishedEvent, ConfigRolledBackEvent } from "./events.js";
+
+//#region src/app-config/lifecycle-contracts.ts
+const LifecyclePolicy = {
+	auth: "admin",
+	policies: [{
+		name: "platform.app-config.manage",
+		version: 1
+	}]
+};
+const LifecycleReadPolicy = {
+	auth: "admin",
+	policies: [{
+		name: "platform.app-config.read",
+		version: 1
+	}]
+};
+const ConfigVersionRecord = new SchemaModel({
+	name: "ConfigVersionRecord",
+	fields: {
+		meta: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: false
+		},
+		config: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: false
+		}
+	}
+});
+const ConfigTransitionRecord = new SchemaModel({
+	name: "ConfigTransitionRecord",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		appId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		fromStatus: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		toStatus: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		version: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		actor: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		reason: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const CreateDraftInput = new SchemaModel({
+	name: "CreateTenantConfigDraftInput",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		appId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		blueprintName: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		blueprintVersion: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		environment: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		fromVersion: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		createdBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const CreateDraftOutput = new SchemaModel({
+	name: "CreateTenantConfigDraftOutput",
+	fields: {
+		version: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const CreateTenantConfigDraftCommand = defineCommand({
+	meta: {
+		name: "appConfig.lifecycle.createDraft",
+		version: 1,
+		description: "Creates a new draft tenant config version.",
+		owners: [OwnersEnum.PlatformSigil],
+		tags: [TagsEnum.Hygiene, "app-config"],
+		stability: StabilityEnum.Experimental,
+		goal: "Allow operators to start editing a new tenant config version.",
+		context: "Invoked by the Studio or automation when starting a new configuration run."
+	},
+	io: {
+		input: CreateDraftInput,
+		output: CreateDraftOutput
+	},
+	policy: LifecyclePolicy,
+	sideEffects: { emits: [{
+		ref: ConfigDraftCreatedEvent,
+		when: "after successful draft creation"
+	}] }
+});
+const PromotePreviewInput = new SchemaModel({
+	name: "PromoteTenantConfigPreviewInput",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		appId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		version: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		promotedBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const PromotePreviewOutput = new SchemaModel({
+	name: "PromoteTenantConfigPreviewOutput",
+	fields: {
+		version: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		warnings: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true,
+			isArray: true
+		}
+	}
+});
+const PromoteTenantConfigToPreviewCommand = defineCommand({
+	meta: {
+		name: "appConfig.lifecycle.promoteToPreview",
+		version: 1,
+		description: "Promotes a draft tenant config to preview/testing state.",
+		owners: [OwnersEnum.PlatformSigil],
+		tags: [TagsEnum.Hygiene, "app-config"],
+		stability: StabilityEnum.Experimental,
+		goal: "Enable validation and testing of draft configurations.",
+		context: "Called when a draft passes initial checks and should be exposed to preview environments."
+	},
+	io: {
+		input: PromotePreviewInput,
+		output: PromotePreviewOutput
+	},
+	policy: LifecyclePolicy,
+	sideEffects: { emits: [{
+		ref: ConfigPromotedToPreviewEvent,
+		when: "after promotion to preview"
+	}] }
+});
+const PublishConfigInput = new SchemaModel({
+	name: "PublishTenantConfigInput",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		appId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		version: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		environment: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		publishedBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		changeSummary: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const PublishConfigOutput = new SchemaModel({
+	name: "PublishTenantConfigOutput",
+	fields: {
+		version: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		previousVersion: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		publishedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const PublishTenantConfigCommand = defineCommand({
+	meta: {
+		name: "appConfig.lifecycle.publish",
+		version: 1,
+		description: "Publishes a preview tenant config to production.",
+		owners: [OwnersEnum.PlatformSigil],
+		tags: [TagsEnum.Hygiene, "app-config"],
+		stability: StabilityEnum.Experimental,
+		goal: "Promote tested configurations to production safely.",
+		context: "Triggered after validation passes and change management approvals are complete."
+	},
+	io: {
+		input: PublishConfigInput,
+		output: PublishConfigOutput
+	},
+	policy: LifecyclePolicy,
+	sideEffects: { emits: [{
+		ref: ConfigPublishedEvent,
+		when: "after publish succeeds"
+	}] }
+});
+const RollbackConfigInput = new SchemaModel({
+	name: "RollbackTenantConfigInput",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		appId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		toVersion: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		environment: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		rolledBackBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		reason: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const RollbackConfigOutput = new SchemaModel({
+	name: "RollbackTenantConfigOutput",
+	fields: {
+		newVersion: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		rolledBackFrom: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const RollbackTenantConfigCommand = defineCommand({
+	meta: {
+		name: "appConfig.lifecycle.rollback",
+		version: 1,
+		description: "Rolls back to a previously published tenant config version.",
+		owners: [OwnersEnum.PlatformSigil],
+		tags: [TagsEnum.Hygiene, "app-config"],
+		stability: StabilityEnum.Experimental,
+		goal: "Provide rapid recovery when new configs regress production.",
+		context: "Called manually or automatically when monitoring detects regression and a rollback is required."
+	},
+	io: {
+		input: RollbackConfigInput,
+		output: RollbackConfigOutput
+	},
+	policy: LifecyclePolicy,
+	sideEffects: { emits: [{
+		ref: ConfigRolledBackEvent,
+		when: "after rollback completes"
+	}] }
+});
+const ListVersionsInput = new SchemaModel({
+	name: "ListTenantConfigVersionsInput",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		appId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		}
+	}
+});
+const ListVersionsOutput = new SchemaModel({
+	name: "ListTenantConfigVersionsOutput",
+	fields: {
+		versions: {
+			type: ConfigVersionRecord,
+			isOptional: false,
+			isArray: true
+		},
+		transitions: {
+			type: ConfigTransitionRecord,
+			isOptional: true,
+			isArray: true
+		}
+	}
+});
+const ListTenantConfigVersionsQuery = defineQuery({
+	meta: {
+		name: "appConfig.lifecycle.listVersions",
+		version: 1,
+		description: "Lists all versions of a tenant configuration.",
+		owners: [OwnersEnum.PlatformSigil],
+		tags: ["app-config", TagsEnum.Hygiene],
+		stability: StabilityEnum.Experimental,
+		goal: "Support lifecycle views and change audit tooling.",
+		context: "Used by the Studio to render history timelines and by automation for change tracking."
+	},
+	io: {
+		input: ListVersionsInput,
+		output: ListVersionsOutput
+	},
+	policy: LifecycleReadPolicy
+});
+const GetVersionInput = new SchemaModel({
+	name: "GetTenantConfigVersionInput",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		appId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		version: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const GetVersionOutput = new SchemaModel({
+	name: "GetTenantConfigVersionOutput",
+	fields: { version: {
+		type: ConfigVersionRecord,
+		isOptional: false
+	} }
+});
+const GetTenantConfigVersionQuery = defineQuery({
+	meta: {
+		name: "appConfig.lifecycle.getVersion",
+		version: 1,
+		description: "Fetches a single tenant config version by id.",
+		owners: [OwnersEnum.PlatformSigil],
+		tags: ["app-config", TagsEnum.Hygiene],
+		stability: StabilityEnum.Experimental,
+		goal: "Allow detail drill-down for lifecycle entries.",
+		context: "Used by automation to fetch config payloads for comparison or export."
+	},
+	io: {
+		input: GetVersionInput,
+		output: GetVersionOutput
+	},
+	policy: LifecycleReadPolicy
+});
+const lifecycleContracts = {
+	CreateTenantConfigDraftCommand,
+	PromoteTenantConfigToPreviewCommand,
+	PublishTenantConfigCommand,
+	RollbackTenantConfigCommand,
+	ListTenantConfigVersionsQuery,
+	GetTenantConfigVersionQuery
+};
+function registerAppConfigLifecycleContracts(registry) {
+	return registry.register(CreateTenantConfigDraftCommand).register(PromoteTenantConfigToPreviewCommand).register(PublishTenantConfigCommand).register(RollbackTenantConfigCommand).register(ListTenantConfigVersionsQuery).register(GetTenantConfigVersionQuery);
+}
+
+//#endregion
+export { CreateTenantConfigDraftCommand, GetTenantConfigVersionQuery, ListTenantConfigVersionsQuery, PromoteTenantConfigToPreviewCommand, PublishTenantConfigCommand, RollbackTenantConfigCommand, lifecycleContracts, registerAppConfigLifecycleContracts };