@contractspec/lib.feature-flags 0.0.0-canary-20260113162409

package/dist/events.js

@@ -0,0 +1,536 @@
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineEvent } from "@contractspec/lib.contracts";
+
+//#region src/events.ts
+const FlagCreatedPayload = defineSchemaModel({
+	name: "FlagCreatedEventPayload",
+	description: "Payload when a feature flag is created",
+	fields: {
+		flagId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		key: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		createdBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const FlagUpdatedPayload = defineSchemaModel({
+	name: "FlagUpdatedEventPayload",
+	description: "Payload when a feature flag is updated",
+	fields: {
+		flagId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		key: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		changes: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: false
+		},
+		updatedBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const FlagDeletedPayload = defineSchemaModel({
+	name: "FlagDeletedEventPayload",
+	description: "Payload when a feature flag is deleted",
+	fields: {
+		flagId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		key: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		deletedBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		deletedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const FlagToggledPayload = defineSchemaModel({
+	name: "FlagToggledEventPayload",
+	description: "Payload when a feature flag status is toggled",
+	fields: {
+		flagId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		key: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		previousStatus: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		newStatus: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		toggledBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		toggledAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const RuleCreatedPayload = defineSchemaModel({
+	name: "RuleCreatedEventPayload",
+	description: "Payload when a targeting rule is created",
+	fields: {
+		ruleId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		flagId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		flagKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		attribute: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		operator: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const RuleDeletedPayload = defineSchemaModel({
+	name: "RuleDeletedEventPayload",
+	description: "Payload when a targeting rule is deleted",
+	fields: {
+		ruleId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		flagId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		flagKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		deletedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const ExperimentCreatedPayload = defineSchemaModel({
+	name: "ExperimentCreatedEventPayload",
+	description: "Payload when an experiment is created",
+	fields: {
+		experimentId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		key: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		flagId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		variants: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: false
+		},
+		createdBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const ExperimentStartedPayload = defineSchemaModel({
+	name: "ExperimentStartedEventPayload",
+	description: "Payload when an experiment starts",
+	fields: {
+		experimentId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		key: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		flagId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		variants: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: false
+		},
+		audiencePercentage: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		startedBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		startedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const ExperimentStoppedPayload = defineSchemaModel({
+	name: "ExperimentStoppedEventPayload",
+	description: "Payload when an experiment stops",
+	fields: {
+		experimentId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		key: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		reason: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		winningVariant: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		stoppedBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		stoppedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const FlagEvaluatedPayload = defineSchemaModel({
+	name: "FlagEvaluatedEventPayload",
+	description: "Payload when a flag is evaluated (for analytics)",
+	fields: {
+		flagId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		flagKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		result: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		variant: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		reason: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		evaluatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const VariantAssignedPayload = defineSchemaModel({
+	name: "VariantAssignedEventPayload",
+	description: "Payload when a subject is assigned to an experiment variant",
+	fields: {
+		experimentId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		experimentKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		variant: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		bucket: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		assignedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Emitted when a feature flag is created.
+*/
+const FlagCreatedEvent = defineEvent({
+	meta: {
+		key: "flag.created",
+		version: "1.0.0",
+		description: "A feature flag has been created.",
+		stability: "stable",
+		owners: ["@platform.feature-flags"],
+		tags: ["feature-flags", "create"]
+	},
+	payload: FlagCreatedPayload
+});
+/**
+* Emitted when a feature flag is updated.
+*/
+const FlagUpdatedEvent = defineEvent({
+	meta: {
+		key: "flag.updated",
+		version: "1.0.0",
+		description: "A feature flag has been updated.",
+		stability: "stable",
+		owners: ["@platform.feature-flags"],
+		tags: ["feature-flags", "update"]
+	},
+	payload: FlagUpdatedPayload
+});
+/**
+* Emitted when a feature flag is deleted.
+*/
+const FlagDeletedEvent = defineEvent({
+	meta: {
+		key: "flag.deleted",
+		version: "1.0.0",
+		description: "A feature flag has been deleted.",
+		stability: "stable",
+		owners: ["@platform.feature-flags"],
+		tags: ["feature-flags", "delete"]
+	},
+	payload: FlagDeletedPayload
+});
+/**
+* Emitted when a feature flag status is toggled.
+*/
+const FlagToggledEvent = defineEvent({
+	meta: {
+		key: "flag.toggled",
+		version: "1.0.0",
+		description: "A feature flag status has been toggled.",
+		stability: "stable",
+		owners: ["@platform.feature-flags"],
+		tags: ["feature-flags", "toggle"]
+	},
+	payload: FlagToggledPayload
+});
+/**
+* Emitted when a targeting rule is created.
+*/
+const RuleCreatedEvent = defineEvent({
+	meta: {
+		key: "flag.rule_created",
+		version: "1.0.0",
+		description: "A targeting rule has been created.",
+		stability: "stable",
+		owners: ["@platform.feature-flags"],
+		tags: [
+			"feature-flags",
+			"rule",
+			"create"
+		]
+	},
+	payload: RuleCreatedPayload
+});
+/**
+* Emitted when a targeting rule is deleted.
+*/
+const RuleDeletedEvent = defineEvent({
+	meta: {
+		key: "flag.rule_deleted",
+		version: "1.0.0",
+		description: "A targeting rule has been deleted.",
+		stability: "stable",
+		owners: ["@platform.feature-flags"],
+		tags: [
+			"feature-flags",
+			"rule",
+			"delete"
+		]
+	},
+	payload: RuleDeletedPayload
+});
+/**
+* Emitted when an experiment is created.
+*/
+const ExperimentCreatedEvent = defineEvent({
+	meta: {
+		key: "experiment.created",
+		version: "1.0.0",
+		description: "An experiment has been created.",
+		stability: "stable",
+		owners: ["@platform.feature-flags"],
+		tags: [
+			"feature-flags",
+			"experiment",
+			"create"
+		]
+	},
+	payload: ExperimentCreatedPayload
+});
+/**
+* Emitted when an experiment starts.
+*/
+const ExperimentStartedEvent = defineEvent({
+	meta: {
+		key: "experiment.started",
+		version: "1.0.0",
+		description: "An experiment has started.",
+		stability: "stable",
+		owners: ["@platform.feature-flags"],
+		tags: [
+			"feature-flags",
+			"experiment",
+			"start"
+		]
+	},
+	payload: ExperimentStartedPayload
+});
+/**
+* Emitted when an experiment stops.
+*/
+const ExperimentStoppedEvent = defineEvent({
+	meta: {
+		key: "experiment.stopped",
+		version: "1.0.0",
+		description: "An experiment has stopped.",
+		stability: "stable",
+		owners: ["@platform.feature-flags"],
+		tags: [
+			"feature-flags",
+			"experiment",
+			"stop"
+		]
+	},
+	payload: ExperimentStoppedPayload
+});
+/**
+* Emitted when a flag is evaluated (for analytics).
+*/
+const FlagEvaluatedEvent = defineEvent({
+	meta: {
+		key: "flag.evaluated",
+		version: "1.0.0",
+		description: "A feature flag has been evaluated.",
+		stability: "stable",
+		owners: ["@platform.feature-flags"],
+		tags: ["feature-flags", "evaluate"]
+	},
+	payload: FlagEvaluatedPayload
+});
+/**
+* Emitted when a subject is assigned to an experiment variant.
+*/
+const VariantAssignedEvent = defineEvent({
+	meta: {
+		key: "experiment.variant_assigned",
+		version: "1.0.0",
+		description: "A subject has been assigned to an experiment variant.",
+		stability: "stable",
+		owners: ["@platform.feature-flags"],
+		tags: [
+			"feature-flags",
+			"experiment",
+			"variant"
+		]
+	},
+	payload: VariantAssignedPayload
+});
+/**
+* All feature flag events.
+*/
+const FeatureFlagEvents = {
+	FlagCreatedEvent,
+	FlagUpdatedEvent,
+	FlagDeletedEvent,
+	FlagToggledEvent,
+	RuleCreatedEvent,
+	RuleDeletedEvent,
+	ExperimentCreatedEvent,
+	ExperimentStartedEvent,
+	ExperimentStoppedEvent,
+	FlagEvaluatedEvent,
+	VariantAssignedEvent
+};
+
+//#endregion
+export { ExperimentCreatedEvent, ExperimentStartedEvent, ExperimentStoppedEvent, FeatureFlagEvents, FlagCreatedEvent, FlagDeletedEvent, FlagEvaluatedEvent, FlagToggledEvent, FlagUpdatedEvent, RuleCreatedEvent, RuleDeletedEvent, VariantAssignedEvent };
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../src/events.ts"],"sourcesContent":["import { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';\nimport { defineEvent } from '@contractspec/lib.contracts';\n\n// ============ Event Payloads ============\n\nconst FlagCreatedPayload = defineSchemaModel({\n  name: 'FlagCreatedEventPayload',\n  description: 'Payload when a feature flag is created',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst FlagUpdatedPayload = defineSchemaModel({\n  name: 'FlagUpdatedEventPayload',\n  description: 'Payload when a feature flag is updated',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    changes: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    updatedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst FlagDeletedPayload = defineSchemaModel({\n  name: 'FlagDeletedEventPayload',\n  description: 'Payload when a feature flag is deleted',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    deletedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    deletedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst FlagToggledPayload = defineSchemaModel({\n  name: 'FlagToggledEventPayload',\n  description: 'Payload when a feature flag status is toggled',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    previousStatus: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    newStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    toggledBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    toggledAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst RuleCreatedPayload = defineSchemaModel({\n  name: 'RuleCreatedEventPayload',\n  description: 'Payload when a targeting rule is created',\n  fields: {\n    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    attribute: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    operator: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst RuleDeletedPayload = defineSchemaModel({\n  name: 'RuleDeletedEventPayload',\n  description: 'Payload when a targeting rule is deleted',\n  fields: {\n    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    deletedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst ExperimentCreatedPayload = defineSchemaModel({\n  name: 'ExperimentCreatedEventPayload',\n  description: 'Payload when an experiment is created',\n  fields: {\n    experimentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    variants: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst ExperimentStartedPayload = defineSchemaModel({\n  name: 'ExperimentStartedEventPayload',\n  description: 'Payload when an experiment starts',\n  fields: {\n    experimentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    variants: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    audiencePercentage: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: false,\n    },\n    startedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst ExperimentStoppedPayload = defineSchemaModel({\n  name: 'ExperimentStoppedEventPayload',\n  description: 'Payload when an experiment stops',\n  fields: {\n    experimentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    winningVariant: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    stoppedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    stoppedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst FlagEvaluatedPayload = defineSchemaModel({\n  name: 'FlagEvaluatedEventPayload',\n  description: 'Payload when a flag is evaluated (for analytics)',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    subjectType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    subjectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    result: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    variant: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    evaluatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst VariantAssignedPayload = defineSchemaModel({\n  name: 'VariantAssignedEventPayload',\n  description: 'Payload when a subject is assigned to an experiment variant',\n  fields: {\n    experimentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    experimentKey: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    subjectType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    subjectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    variant: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    bucket: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    assignedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n// ============ Events ============\n\n/**\n * Emitted when a feature flag is created.\n */\nexport const FlagCreatedEvent = defineEvent({\n  meta: {\n    key: 'flag.created',\n    version: '1.0.0',\n    description: 'A feature flag has been created.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'create'],\n  },\n  payload: FlagCreatedPayload,\n});\n\n/**\n * Emitted when a feature flag is updated.\n */\nexport const FlagUpdatedEvent = defineEvent({\n  meta: {\n    key: 'flag.updated',\n    version: '1.0.0',\n    description: 'A feature flag has been updated.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'update'],\n  },\n  payload: FlagUpdatedPayload,\n});\n\n/**\n * Emitted when a feature flag is deleted.\n */\nexport const FlagDeletedEvent = defineEvent({\n  meta: {\n    key: 'flag.deleted',\n    version: '1.0.0',\n    description: 'A feature flag has been deleted.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'delete'],\n  },\n  payload: FlagDeletedPayload,\n});\n\n/**\n * Emitted when a feature flag status is toggled.\n */\nexport const FlagToggledEvent = defineEvent({\n  meta: {\n    key: 'flag.toggled',\n    version: '1.0.0',\n    description: 'A feature flag status has been toggled.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'toggle'],\n  },\n  payload: FlagToggledPayload,\n});\n\n/**\n * Emitted when a targeting rule is created.\n */\nexport const RuleCreatedEvent = defineEvent({\n  meta: {\n    key: 'flag.rule_created',\n    version: '1.0.0',\n    description: 'A targeting rule has been created.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'rule', 'create'],\n  },\n  payload: RuleCreatedPayload,\n});\n\n/**\n * Emitted when a targeting rule is deleted.\n */\nexport const RuleDeletedEvent = defineEvent({\n  meta: {\n    key: 'flag.rule_deleted',\n    version: '1.0.0',\n    description: 'A targeting rule has been deleted.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'rule', 'delete'],\n  },\n  payload: RuleDeletedPayload,\n});\n\n/**\n * Emitted when an experiment is created.\n */\nexport const ExperimentCreatedEvent = defineEvent({\n  meta: {\n    key: 'experiment.created',\n    version: '1.0.0',\n    description: 'An experiment has been created.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'experiment', 'create'],\n  },\n  payload: ExperimentCreatedPayload,\n});\n\n/**\n * Emitted when an experiment starts.\n */\nexport const ExperimentStartedEvent = defineEvent({\n  meta: {\n    key: 'experiment.started',\n    version: '1.0.0',\n    description: 'An experiment has started.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'experiment', 'start'],\n  },\n  payload: ExperimentStartedPayload,\n});\n\n/**\n * Emitted when an experiment stops.\n */\nexport const ExperimentStoppedEvent = defineEvent({\n  meta: {\n    key: 'experiment.stopped',\n    version: '1.0.0',\n    description: 'An experiment has stopped.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'experiment', 'stop'],\n  },\n  payload: ExperimentStoppedPayload,\n});\n\n/**\n * Emitted when a flag is evaluated (for analytics).\n */\nexport const FlagEvaluatedEvent = defineEvent({\n  meta: {\n    key: 'flag.evaluated',\n    version: '1.0.0',\n    description: 'A feature flag has been evaluated.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'evaluate'],\n  },\n  payload: FlagEvaluatedPayload,\n});\n\n/**\n * Emitted when a subject is assigned to an experiment variant.\n */\nexport const VariantAssignedEvent = defineEvent({\n  meta: {\n    key: 'experiment.variant_assigned',\n    version: '1.0.0',\n    description: 'A subject has been assigned to an experiment variant.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'experiment', 'variant'],\n  },\n  payload: VariantAssignedPayload,\n});\n\n/**\n * All feature flag events.\n */\nexport const FeatureFlagEvents = {\n  FlagCreatedEvent,\n  FlagUpdatedEvent,\n  FlagDeletedEvent,\n  FlagToggledEvent,\n  RuleCreatedEvent,\n  RuleDeletedEvent,\n  ExperimentCreatedEvent,\n  ExperimentStartedEvent,\n  ExperimentStoppedEvent,\n  FlagEvaluatedEvent,\n  VariantAssignedEvent,\n};\n"],"mappings":"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"}

package/dist/feature-flags.capability.d.ts

@@ -0,0 +1,9 @@
+import { CapabilitySpec } from "./contracts/src/capabilities/capabilities.js";
+import "./contracts/src/index.js";
+
+//#region src/feature-flags.capability.d.ts
+declare const FeatureFlagsCapability: CapabilitySpec;
+declare const ExperimentsCapability: CapabilitySpec;
+//#endregion
+export { ExperimentsCapability, FeatureFlagsCapability };
+//# sourceMappingURL=feature-flags.capability.d.ts.map

package/dist/feature-flags.capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.capability.d.ts","names":[],"sources":["../src/feature-flags.capability.ts"],"sourcesContent":[],"mappings":";;;;cAEa,wBAUX;cAEW,uBAUX"}

package/dist/feature-flags.capability.js

@@ -0,0 +1,25 @@
+import { StabilityEnum, defineCapability } from "@contractspec/lib.contracts";
+
+//#region src/feature-flags.capability.ts
+const FeatureFlagsCapability = defineCapability({ meta: {
+	key: "feature-flags",
+	version: "1.0.0",
+	kind: "api",
+	stability: StabilityEnum.Experimental,
+	description: "Feature flag management and evaluation",
+	owners: ["@platform.featureflags"],
+	tags: ["feature-flags", "configuration"]
+} });
+const ExperimentsCapability = defineCapability({ meta: {
+	key: "experiments",
+	version: "1.0.0",
+	kind: "api",
+	stability: StabilityEnum.Experimental,
+	description: "A/B testing and experimentation platform",
+	owners: ["@platform.featureflags"],
+	tags: ["experiments", "ab-testing"]
+} });
+
+//#endregion
+export { ExperimentsCapability, FeatureFlagsCapability };
+//# sourceMappingURL=feature-flags.capability.js.map

package/dist/feature-flags.capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.capability.js","names":[],"sources":["../src/feature-flags.capability.ts"],"sourcesContent":["import { defineCapability, StabilityEnum } from '@contractspec/lib.contracts';\n\nexport const FeatureFlagsCapability = defineCapability({\n  meta: {\n    key: 'feature-flags',\n    version: '1.0.0',\n    kind: 'api',\n    stability: StabilityEnum.Experimental,\n    description: 'Feature flag management and evaluation',\n    owners: ['@platform.featureflags'],\n    tags: ['feature-flags', 'configuration'],\n  },\n});\n\nexport const ExperimentsCapability = defineCapability({\n  meta: {\n    key: 'experiments',\n    version: '1.0.0',\n    kind: 'api',\n    stability: StabilityEnum.Experimental,\n    description: 'A/B testing and experimentation platform',\n    owners: ['@platform.featureflags'],\n    tags: ['experiments', 'ab-testing'],\n  },\n});\n"],"mappings":";;;AAEA,MAAa,yBAAyB,iBAAiB,EACrD,MAAM;CACJ,KAAK;CACL,SAAS;CACT,MAAM;CACN,WAAW,cAAc;CACzB,aAAa;CACb,QAAQ,CAAC,yBAAyB;CAClC,MAAM,CAAC,iBAAiB,gBAAgB;CACzC,EACF,CAAC;AAEF,MAAa,wBAAwB,iBAAiB,EACpD,MAAM;CACJ,KAAK;CACL,SAAS;CACT,MAAM;CACN,WAAW,cAAc;CACzB,aAAa;CACb,QAAQ,CAAC,yBAAyB;CAClC,MAAM,CAAC,eAAe,aAAa;CACpC,EACF,CAAC"}

package/dist/feature-flags.feature.d.ts

@@ -0,0 +1,12 @@
+import { FeatureModuleSpec } from "./contracts/src/features/types.js";
+import "./contracts/src/index.js";
+
+//#region src/feature-flags.feature.d.ts
+/**
+ * Feature Flags feature module that bundles flag management,
+ * targeting rules, and A/B experiment capabilities.
+ */
+declare const FeatureFlagsFeature: FeatureModuleSpec;
+//#endregion
+export { FeatureFlagsFeature };
+//# sourceMappingURL=feature-flags.feature.d.ts.map

package/dist/feature-flags.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.feature.d.ts","names":[],"sources":["../src/feature-flags.feature.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAWa,cAAA,mBAoEX,EAAA,iBAAA"}