@contractspec/lib.feature-flags 1.56.1 → 1.58.0

package/dist/node/events.js

@@ -0,0 +1,296 @@
+// src/events.ts
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineEvent } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var 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 }
+  }
+});
+var 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 }
+  }
+});
+var 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 }
+  }
+});
+var 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 }
+  }
+});
+var 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 }
+  }
+});
+var 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 }
+  }
+});
+var 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 }
+  }
+});
+var 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 }
+  }
+});
+var 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 }
+  }
+});
+var 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 }
+  }
+});
+var 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
+});
+var 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
+});
+var 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
+});
+var 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
+});
+var 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
+});
+var 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
+});
+var 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
+});
+var 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
+});
+var 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
+});
+var 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
+});
+var 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
+});
+var FeatureFlagEvents = {
+  FlagCreatedEvent,
+  FlagUpdatedEvent,
+  FlagDeletedEvent,
+  FlagToggledEvent,
+  RuleCreatedEvent,
+  RuleDeletedEvent,
+  ExperimentCreatedEvent,
+  ExperimentStartedEvent,
+  ExperimentStoppedEvent,
+  FlagEvaluatedEvent,
+  VariantAssignedEvent
+};
+export {
+  VariantAssignedEvent,
+  RuleDeletedEvent,
+  RuleCreatedEvent,
+  FlagUpdatedEvent,
+  FlagToggledEvent,
+  FlagEvaluatedEvent,
+  FlagDeletedEvent,
+  FlagCreatedEvent,
+  FeatureFlagEvents,
+  ExperimentStoppedEvent,
+  ExperimentStartedEvent,
+  ExperimentCreatedEvent
+};

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

@@ -0,0 +1,28 @@
+// src/feature-flags.capability.ts
+import { defineCapability, StabilityEnum } from "@contractspec/lib.contracts";
+var FeatureFlagsCapability = defineCapability({
+  meta: {
+    key: "feature-flag",
+    version: "1.0.0",
+    kind: "api",
+    stability: StabilityEnum.Experimental,
+    description: "Feature flag management and evaluation",
+    owners: ["@platform.featureflags"],
+    tags: ["feature-flags", "configuration"]
+  }
+});
+var 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"]
+  }
+});
+export {
+  FeatureFlagsCapability,
+  ExperimentsCapability
+};

package/dist/node/feature-flags.feature.js

@@ -0,0 +1,55 @@
+// src/feature-flags.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts";
+var FeatureFlagsFeature = defineFeature({
+  meta: {
+    key: "feature-flags",
+    version: "1.0.0",
+    title: "Feature Flags",
+    description: "Feature flag management with targeting rules and A/B experiments",
+    domain: "platform",
+    owners: ["@platform.feature-flags"],
+    tags: ["feature-flags", "experiments", "targeting"],
+    stability: "stable"
+  },
+  operations: [
+    { key: "flag.create", version: "1.0.0" },
+    { key: "flag.update", version: "1.0.0" },
+    { key: "flag.delete", version: "1.0.0" },
+    { key: "flag.toggle", version: "1.0.0" },
+    { key: "flag.get", version: "1.0.0" },
+    { key: "flag.list", version: "1.0.0" },
+    { key: "flag.evaluate", version: "1.0.0" },
+    { key: "flag.rule.create", version: "1.0.0" },
+    { key: "flag.rule.delete", version: "1.0.0" },
+    { key: "experiment.create", version: "1.0.0" },
+    { key: "experiment.start", version: "1.0.0" },
+    { key: "experiment.stop", version: "1.0.0" },
+    { key: "experiment.get", version: "1.0.0" }
+  ],
+  events: [
+    { key: "flag.created", version: "1.0.0" },
+    { key: "flag.updated", version: "1.0.0" },
+    { key: "flag.deleted", version: "1.0.0" },
+    { key: "flag.toggled", version: "1.0.0" },
+    { key: "flag.evaluated", version: "1.0.0" },
+    { key: "flag.rule_created", version: "1.0.0" },
+    { key: "flag.rule_deleted", version: "1.0.0" },
+    { key: "experiment.created", version: "1.0.0" },
+    { key: "experiment.started", version: "1.0.0" },
+    { key: "experiment.stopped", version: "1.0.0" },
+    { key: "experiment.variant_assigned", version: "1.0.0" }
+  ],
+  presentations: [],
+  opToPresentation: [],
+  presentationsTargets: [],
+  capabilities: {
+    provides: [
+      { key: "feature-flag", version: "1.0.0" },
+      { key: "experiments", version: "1.0.0" }
+    ],
+    requires: [{ key: "identity", version: "1.0.0" }]
+  }
+});
+export {
+  FeatureFlagsFeature
+};