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

package/dist/feature-flags.feature.js

@@ -0,0 +1,148 @@
+import { defineFeature } from "@contractspec/lib.contracts";
+
+//#region src/feature-flags.feature.ts
+/**
+* Feature Flags Feature Module Specification
+*
+* Defines the feature module for feature flag and experiment management.
+*/
+/**
+* Feature Flags feature module that bundles flag management,
+* targeting rules, and A/B experiment capabilities.
+*/
+const 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-flags",
+			version: "1.0.0"
+		}, {
+			key: "experiments",
+			version: "1.0.0"
+		}],
+		requires: [{
+			key: "identity",
+			version: "1.0.0"
+		}]
+	}
+});
+
+//#endregion
+export { FeatureFlagsFeature };
+//# sourceMappingURL=feature-flags.feature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.feature.js","names":[],"sources":["../src/feature-flags.feature.ts"],"sourcesContent":["/**\n * Feature Flags Feature Module Specification\n *\n * Defines the feature module for feature flag and experiment management.\n */\nimport { defineFeature } from '@contractspec/lib.contracts';\n\n/**\n * Feature Flags feature module that bundles flag management,\n * targeting rules, and A/B experiment capabilities.\n */\nexport const FeatureFlagsFeature = defineFeature({\n  meta: {\n    key: 'feature-flags',\n    version: '1.0.0',\n    title: 'Feature Flags',\n    description:\n      'Feature flag management with targeting rules and A/B experiments',\n    domain: 'platform',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'experiments', 'targeting'],\n    stability: 'stable',\n  },\n\n  // All contract operations included in this feature\n  operations: [\n    // Flag CRUD operations\n    { key: 'flag.create', version: '1.0.0' },\n    { key: 'flag.update', version: '1.0.0' },\n    { key: 'flag.delete', version: '1.0.0' },\n    { key: 'flag.toggle', version: '1.0.0' },\n    { key: 'flag.get', version: '1.0.0' },\n    { key: 'flag.list', version: '1.0.0' },\n    { key: 'flag.evaluate', version: '1.0.0' },\n\n    // Targeting rule operations\n    { key: 'flag.rule.create', version: '1.0.0' },\n    { key: 'flag.rule.delete', version: '1.0.0' },\n\n    // Experiment operations\n    { key: 'experiment.create', version: '1.0.0' },\n    { key: 'experiment.start', version: '1.0.0' },\n    { key: 'experiment.stop', version: '1.0.0' },\n    { key: 'experiment.get', version: '1.0.0' },\n  ],\n\n  // Events emitted by this feature\n  events: [\n    // Flag events\n    { key: 'flag.created', version: '1.0.0' },\n    { key: 'flag.updated', version: '1.0.0' },\n    { key: 'flag.deleted', version: '1.0.0' },\n    { key: 'flag.toggled', version: '1.0.0' },\n    { key: 'flag.evaluated', version: '1.0.0' },\n\n    // Rule events\n    { key: 'flag.rule_created', version: '1.0.0' },\n    { key: 'flag.rule_deleted', version: '1.0.0' },\n\n    // Experiment events\n    { key: 'experiment.created', version: '1.0.0' },\n    { key: 'experiment.started', version: '1.0.0' },\n    { key: 'experiment.stopped', version: '1.0.0' },\n    { key: 'experiment.variant_assigned', version: '1.0.0' },\n  ],\n\n  // No presentations for this library feature\n  presentations: [],\n  opToPresentation: [],\n  presentationsTargets: [],\n\n  // Capability definitions\n  capabilities: {\n    provides: [\n      { key: 'feature-flags', version: '1.0.0' },\n      { key: 'experiments', version: '1.0.0' },\n    ],\n    requires: [{ key: 'identity', version: '1.0.0' }],\n  },\n});\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,sBAAsB,cAAc;CAC/C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,0BAA0B;EACnC,MAAM;GAAC;GAAiB;GAAe;GAAY;EACnD,WAAW;EACZ;CAGD,YAAY;EAEV;GAAE,KAAK;GAAe,SAAS;GAAS;EACxC;GAAE,KAAK;GAAe,SAAS;GAAS;EACxC;GAAE,KAAK;GAAe,SAAS;GAAS;EACxC;GAAE,KAAK;GAAe,SAAS;GAAS;EACxC;GAAE,KAAK;GAAY,SAAS;GAAS;EACrC;GAAE,KAAK;GAAa,SAAS;GAAS;EACtC;GAAE,KAAK;GAAiB,SAAS;GAAS;EAG1C;GAAE,KAAK;GAAoB,SAAS;GAAS;EAC7C;GAAE,KAAK;GAAoB,SAAS;GAAS;EAG7C;GAAE,KAAK;GAAqB,SAAS;GAAS;EAC9C;GAAE,KAAK;GAAoB,SAAS;GAAS;EAC7C;GAAE,KAAK;GAAmB,SAAS;GAAS;EAC5C;GAAE,KAAK;GAAkB,SAAS;GAAS;EAC5C;CAGD,QAAQ;EAEN;GAAE,KAAK;GAAgB,SAAS;GAAS;EACzC;GAAE,KAAK;GAAgB,SAAS;GAAS;EACzC;GAAE,KAAK;GAAgB,SAAS;GAAS;EACzC;GAAE,KAAK;GAAgB,SAAS;GAAS;EACzC;GAAE,KAAK;GAAkB,SAAS;GAAS;EAG3C;GAAE,KAAK;GAAqB,SAAS;GAAS;EAC9C;GAAE,KAAK;GAAqB,SAAS;GAAS;EAG9C;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAA+B,SAAS;GAAS;EACzD;CAGD,eAAe,EAAE;CACjB,kBAAkB,EAAE;CACpB,sBAAsB,EAAE;CAGxB,cAAc;EACZ,UAAU,CACR;GAAE,KAAK;GAAiB,SAAS;GAAS,EAC1C;GAAE,KAAK;GAAe,SAAS;GAAS,CACzC;EACD,UAAU,CAAC;GAAE,KAAK;GAAY,SAAS;GAAS,CAAC;EAClD;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { CreateExperimentContract, CreateFlagContract, CreateRuleContract, DeleteFlagContract, DeleteRuleContract, EvaluateFlagContract, EvaluationResultModel, ExperimentModel, FeatureFlagModel, GetExperimentContract, GetFlagContract, ListFlagsContract, StartExperimentContract, StopExperimentContract, TargetingRuleModel, ToggleFlagContract, UpdateFlagContract } from "./contracts/index.js";
+import { ExperimentAssignmentEntity, ExperimentEntity, ExperimentStatusEnum, FeatureFlagEntity, FlagEvaluationEntity, FlagStatusEnum, FlagTargetingRuleEntity, RuleOperatorEnum, featureFlagEntities, featureFlagsSchemaContribution } from "./entities/index.js";
+import { EvaluationContext, EvaluationLogger, EvaluationReason, EvaluationResult, Experiment, ExperimentVariant, FeatureFlag, FlagEvaluator, FlagEvaluatorOptions, FlagRepository, InMemoryFlagRepository, RuleOperator, TargetingRule, VariantConfig, evaluateRuleCondition, getSubjectId, hashToBucket } from "./evaluation/index.js";
+import { ExperimentCreatedEvent, ExperimentStartedEvent, ExperimentStoppedEvent, FeatureFlagEvents, FlagCreatedEvent, FlagDeletedEvent, FlagEvaluatedEvent, FlagToggledEvent, FlagUpdatedEvent, RuleCreatedEvent, RuleDeletedEvent, VariantAssignedEvent } from "./events.js";
+import { FeatureFlagsFeature } from "./feature-flags.feature.js";
+export { CreateExperimentContract, CreateFlagContract, CreateRuleContract, DeleteFlagContract, DeleteRuleContract, EvaluateFlagContract, EvaluationContext, EvaluationLogger, EvaluationReason, EvaluationResult, EvaluationResultModel, Experiment, ExperimentAssignmentEntity, ExperimentCreatedEvent, ExperimentEntity, ExperimentModel, ExperimentStartedEvent, ExperimentStatusEnum, ExperimentStoppedEvent, ExperimentVariant, FeatureFlag, FeatureFlagEntity, FeatureFlagEvents, FeatureFlagModel, FeatureFlagsFeature, FlagCreatedEvent, FlagDeletedEvent, FlagEvaluatedEvent, FlagEvaluationEntity, FlagEvaluator, FlagEvaluatorOptions, FlagRepository, FlagStatusEnum, FlagTargetingRuleEntity, FlagToggledEvent, FlagUpdatedEvent, GetExperimentContract, GetFlagContract, InMemoryFlagRepository, ListFlagsContract, RuleCreatedEvent, RuleDeletedEvent, RuleOperator, RuleOperatorEnum, StartExperimentContract, StopExperimentContract, TargetingRule, TargetingRuleModel, ToggleFlagContract, UpdateFlagContract, VariantAssignedEvent, VariantConfig, evaluateRuleCondition, featureFlagEntities, featureFlagsSchemaContribution, getSubjectId, hashToBucket };

package/dist/index.js

@@ -0,0 +1,8 @@
+import { ExperimentCreatedEvent, ExperimentStartedEvent, ExperimentStoppedEvent, FeatureFlagEvents, FlagCreatedEvent, FlagDeletedEvent, FlagEvaluatedEvent, FlagToggledEvent, FlagUpdatedEvent, RuleCreatedEvent, RuleDeletedEvent, VariantAssignedEvent } from "./events.js";
+import { FeatureFlagsFeature } from "./feature-flags.feature.js";
+import { ExperimentAssignmentEntity, ExperimentEntity, ExperimentStatusEnum, FeatureFlagEntity, FlagEvaluationEntity, FlagStatusEnum, FlagTargetingRuleEntity, RuleOperatorEnum, featureFlagEntities, featureFlagsSchemaContribution } from "./entities/index.js";
+import { CreateExperimentContract, CreateFlagContract, CreateRuleContract, DeleteFlagContract, DeleteRuleContract, EvaluateFlagContract, EvaluationResultModel, ExperimentModel, FeatureFlagModel, GetExperimentContract, GetFlagContract, ListFlagsContract, StartExperimentContract, StopExperimentContract, TargetingRuleModel, ToggleFlagContract, UpdateFlagContract } from "./contracts/index.js";
+import { FlagEvaluator, InMemoryFlagRepository, evaluateRuleCondition, getSubjectId, hashToBucket } from "./evaluation/index.js";
+import "./docs/index.js";
+
+export { CreateExperimentContract, CreateFlagContract, CreateRuleContract, DeleteFlagContract, DeleteRuleContract, EvaluateFlagContract, EvaluationResultModel, ExperimentAssignmentEntity, ExperimentCreatedEvent, ExperimentEntity, ExperimentModel, ExperimentStartedEvent, ExperimentStatusEnum, ExperimentStoppedEvent, FeatureFlagEntity, FeatureFlagEvents, FeatureFlagModel, FeatureFlagsFeature, FlagCreatedEvent, FlagDeletedEvent, FlagEvaluatedEvent, FlagEvaluationEntity, FlagEvaluator, FlagStatusEnum, FlagTargetingRuleEntity, FlagToggledEvent, FlagUpdatedEvent, GetExperimentContract, GetFlagContract, InMemoryFlagRepository, ListFlagsContract, RuleCreatedEvent, RuleDeletedEvent, RuleOperatorEnum, StartExperimentContract, StopExperimentContract, TargetingRuleModel, ToggleFlagContract, UpdateFlagContract, VariantAssignedEvent, evaluateRuleCondition, featureFlagEntities, featureFlagsSchemaContribution, getSubjectId, hashToBucket };

package/dist/schema/src/EnumType.d.ts

@@ -0,0 +1,36 @@
+import * as z from "zod";
+import { GraphQLEnumType } from "graphql";
+
+//#region ../schema/src/EnumType.d.ts
+
+/**
+ * Strongly-typed string enum wrapper with one source of truth for zod, GraphQL, and JSON Schema.
+ */
+declare class EnumType<T extends [string, ...string[]]> {
+  private readonly name;
+  private readonly values;
+  private readonly gqlEnum;
+  constructor(name: string, values: T);
+  /** Enum type name (used by GraphQL and JSON Schema). */
+  getName(): string;
+  /** Returns the literal tuple of allowed values. */
+  getEnumValues(): T;
+  /** GraphQL enum instance suitable for Pothos or vanilla GraphQL schemas. */
+  getPothos(): GraphQLEnumType;
+  /** zod schema representing this enum. */
+  getZod(): z.ZodEnum<{ [K in T[number]]: K }>;
+  /** Minimal JSON representation (alias of getJsonSchema). */
+  getJson(): {
+    type: 'string';
+    enum: T;
+  };
+  /** JSON Schema for this enum. */
+  getJsonSchema(): {
+    type: 'string';
+    enum: T;
+  };
+}
+type AnyEnumType = EnumType<[string, ...string[]]>;
+//#endregion
+export { AnyEnumType, EnumType };
+//# sourceMappingURL=EnumType.d.ts.map

package/dist/schema/src/EnumType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnumType.d.ts","names":[],"sources":["../../../../schema/src/EnumType.ts"],"sourcesContent":[],"mappings":";;;;;;;AAMA;AAKoC,cALvB,QAKuB,CAAA,UAAA,CAAA,MAAA,EAAA,GAAA,MAAA,EAAA,CAAA,CAAA,CAAA;EAejB,iBAAA,IAAA;EAMJ,iBAAA,MAAA;EAKe,iBAAA,OAAA;EAAY,WAAA,CAAA,IAAA,EAAA,MAAA,EAAA,MAAA,EA1BN,CA0BM;EAA5B;EAKuB,OAAA,CAAA,CAAA,EAAA,MAAA;EAKM;EAAC,aAAA,CAAA,CAAA,EArBzB,CAqByB;EAKhC;eApBG;;YAKH,CAAA,CAAE,gBAAgB,YAAY;;;;UAKL;;;;;UAKM;;;KAK/B,WAAA,GAAc"}

package/dist/schema/src/FieldType.d.ts

@@ -0,0 +1,30 @@
+import * as z from "zod";
+import { GraphQLScalarType, GraphQLScalarTypeConfig } from "graphql";
+
+//#region ../schema/src/FieldType.d.ts
+interface FieldTypeConfig<TInternal, TExternal = TInternal> extends GraphQLScalarTypeConfig<TInternal, TExternal> {
+  zod: z.ZodType<TInternal>;
+  jsonSchema: unknown | (() => unknown);
+}
+type AnyFieldType = FieldType<any, any>;
+/**
+ * GraphQL scalar wrapper that carries zod and JSON Schema metadata.
+ *
+ * TInternal is the runtime representation; TExternal is the GraphQL output.
+ */
+declare class FieldType<TInternal, TExternal = TInternal> extends GraphQLScalarType<TInternal, TExternal> {
+  private zodSchema;
+  private readonly jsonSchemaDef?;
+  constructor(config: FieldTypeConfig<TInternal, TExternal>);
+  /** Return the attached zod schema for validation. */
+  getZod(): z.ZodType<TInternal>;
+  /** GraphQL scalar instance usable by Pothos or vanilla GraphQL. */
+  getPothos(): GraphQLScalarType<TInternal, TExternal>;
+  /** Return the JSON Schema (evaluates factory if provided). */
+  getJson(): unknown;
+  getJsonSchemaDef(): unknown | (() => unknown);
+  getJsonSchema(): unknown;
+}
+//#endregion
+export { AnyFieldType, FieldType, FieldTypeConfig };
+//# sourceMappingURL=FieldType.d.ts.map

package/dist/schema/src/FieldType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldType.d.ts","names":[],"sources":["../../../../schema/src/FieldType.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,uCAEH,mBACJ,wBAAwB,WAAW;OACtC,CAAA,CAAE,QAAQ;EAJA,UAAA,EAAA,OAAe,GAAA,CAAA,GAAA,GAAA,OAAA,CAAA;;AAGE,KAMtB,YAAA,GAAe,SANO,CAAA,GAAA,EAAA,GAAA,CAAA;;;;;;AAMtB,cAOC,SAPW,CAAA,SAAG,EAAS,YAStB,SATsB,CAAA,SAU1B,iBAV0B,CAUR,SAVQ,EAUG,SAVH,CAAA,CAAA;EAOvB,QAAA,SAAS;EAER,iBAAA,aAAA;EACc,WAAA,CAAA,MAAA,EAIN,eAJM,CAIU,SAJV,EAIqB,SAJrB,CAAA;EAAW;EAID,MAAA,CAAA,CAAA,EAO1B,CAAA,CAAE,OAPwB,CAOhB,SAPgB,CAAA;EAAW;EAA3B,SAAA,CAAA,CAAA,EAYP,iBAZO,CAYW,SAZX,EAYsB,SAZtB,CAAA;EAOA;EAAR,OAAA,CAAA,CAAA,EAAA,OAAA;EAKmB,gBAAA,CAAA,CAAA,EAAA,OAAA,GAAA,CAAA,GAAA,GAAA,OAAA,CAAA;EAAW,aAAA,CAAA,CAAA,EAAA,OAAA"}

package/dist/schema/src/GraphQLSchemaType.d.ts

@@ -0,0 +1,2 @@
+import "./SchemaModelType.js";
+import "zod";

package/dist/schema/src/JsonSchemaType.d.ts

@@ -0,0 +1,2 @@
+import "./SchemaModelType.js";
+import "zod";

package/dist/schema/src/ScalarTypeEnum.d.ts

@@ -0,0 +1 @@
+import "./FieldType.js";

package/dist/schema/src/SchemaModel.d.ts

@@ -0,0 +1,70 @@
+import { AnyFieldType } from "./FieldType.js";
+import { AnyEnumType } from "./EnumType.js";
+import { SchemaModelType } from "./SchemaModelType.js";
+import * as z from "zod";
+import { Maybe } from "graphql/jsutils/Maybe";
+
+//#region ../schema/src/SchemaModel.d.ts
+
+/**
+ * All types that can be used as field types in a SchemaModel.
+ * Supports FieldType, EnumType, nested SchemaModel, or any SchemaType implementation.
+ */
+type FieldLike = AnyFieldType | AnyEnumType | AnySchemaModel | SchemaModelType;
+/** Field configuration for a SchemaModel property. */
+interface SchemaFieldConfig<Type extends FieldLike = FieldLike> {
+  type: Type;
+  isOptional: boolean;
+  /** When present and true, the field is an array */
+  isArray?: true;
+}
+type SchemaModelFieldsAnyConfig<Type extends FieldLike = FieldLike> = Record<string, SchemaFieldConfig<Type>>;
+/** Model definition: name and fields. */
+interface SchemaModelConfig<Fields extends SchemaModelFieldsAnyConfig> {
+  name: string;
+  description?: Maybe<string>;
+  fields: Fields;
+}
+/**
+ * Named object model built from FieldType/EnumType/SchemaModel fields.
+ * Provides zod and GraphQL input helpers, and supports arrays/optional fields.
+ */
+declare class SchemaModel<Fields extends SchemaModelFieldsAnyConfig> implements SchemaModelType {
+  readonly config: SchemaModelConfig<Fields>;
+  constructor(config: SchemaModelConfig<Fields>);
+  /**
+   * Build a typed ZodObject from the model fields, preserving each field's
+   * Zod schema and optionality at the type level when possible.
+   */
+  getZod(): TopLevelZodFromModel<Fields>;
+  /** Input object name for GraphQL builder adapters. */
+  getPothosInput(): string;
+}
+/**
+ * Union of all types that can serve as a schema model.
+ * This is the main type expected by OperationSpec, EventSpec, FormSpec, etc.
+ *
+ * Supports:
+ * - SchemaModel instances (native ContractSpec types)
+ * - Any SchemaType implementation (ZodSchemaType, JsonSchemaType, etc.)
+ */
+type AnySchemaModel = SchemaModel<SchemaModelFieldsAnyConfig> | SchemaModelType;
+type InferZodFromType<T> = T extends SchemaModel<SchemaModelFieldsAnyConfig> ? z.ZodObject<z.ZodRawShape> : T extends AnyFieldType ? ReturnType<T['getZod']> : T extends AnyEnumType ? ReturnType<T['getZod']> : T extends SchemaModelType ? ReturnType<T['getZod']> : z.ZodUnknown;
+type MaybeArray<Z extends z.ZodType, A> = A extends true ? z.ZodArray<Z> : Z;
+type MaybeOptional<Z extends z.ZodType, O> = O extends true ? z.ZodOptional<Z> : Z;
+/**
+ * Helper type: derive the Zod shape from the field config.
+ * Supports nested SchemaModel and arrays, preserving optionality and list-ness.
+ */
+type FieldIsArray<FC> = FC extends {
+  isArray: true;
+} ? true : false;
+type ZodShapeFromFields<F extends SchemaModelFieldsAnyConfig> = { [K in keyof F]: MaybeOptional<MaybeArray<InferZodFromType<F[K]['type']>, FieldIsArray<F[K]>>, F[K]['isOptional']> };
+/**
+ * The top-level Zod schema returned by getZod():
+ * either ZodObject<...> or ZodArray<ZodObject<...>> when config.isArray.
+ */
+type TopLevelZodFromModel<F extends SchemaModelFieldsAnyConfig> = z.ZodObject<ZodShapeFromFields<F>>;
+//#endregion
+export { AnySchemaModel, SchemaFieldConfig, SchemaModel, SchemaModelConfig, SchemaModelFieldsAnyConfig, TopLevelZodFromModel, ZodShapeFromFields };
+//# sourceMappingURL=SchemaModel.d.ts.map

package/dist/schema/src/SchemaModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaModel.d.ts","names":[],"sources":["../../../../schema/src/SchemaModel.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAImD;;KAM9C,SAAA,GAAY,YAAe,GAAA,WAAA,GAAc,cAAd,GAA+B,eAA/B;;AAA+B,UAG9C,iBAH8C,CAAA,aAGf,SAHe,GAGH,SAHG,CAAA,CAAA;EAAe,IAAA,EAItE,IAJsE;EAG7D,UAAA,EAAA,OAAA;EAA+B;EAAY,OAAA,CAAA,EAAA,IAAA;;AAChD,KAMA,0BANA,CAAA,aAMwC,SANxC,GAMoD,SANpD,CAAA,GAOV,MAPU,CAAA,MAAA,EAOK,iBAPL,CAOuB,IAPvB,CAAA,CAAA;AAMZ;AAAoD,UAInC,iBAJmC,CAAA,eAIF,0BAJE,CAAA,CAAA;EAAY,IAAA,EAAA,MAAA;EAC7B,WAAA,CAAA,EAKnB,KALmB,CAAA,MAAA,CAAA;EAAlB,MAAA,EAMP,MANO;;;AAGjB;;;AAGU,cAOG,WAPH,CAAA,eAQO,0BARP,CAAA,YASG,eATH,CAAA;EAAM,SAAA,MAAA,EAUsB,iBAVtB,CAUwC,MAVxC,CAAA;EAOH,WAAA,CAAA,MAAW,EAGc,iBAHd,CAGgC,MAHhC,CAAA;EACP;;;;EAEqB,MAAA,CAAA,CAAA,EAM1B,oBAN0B,CAML,MANK,CAAA;EAML;EAArB,cAAA,CAAA,CAAA,EAAA,MAAA;;;AAgCZ;;;;;AAkCE;;AAGsB,KArCZ,cAAA,GACR,WAoCoB,CApCR,0BAoCQ,CAAA,GAnCpB,eAmCoB;AAQA,KATnB,gBAWU,CAAA,CAAA,CAAA,GAVb,CAUa,SAVH,WAUG,CAVS,0BAUT,CAAA,GATT,CAAA,CAAE,SASO,CATG,CAAA,CAAE,WASL,CAAA,GART,CAQS,SARC,YAQD,GAPP,UAOO,CAPI,CAOJ,CAAA,QAAA,CAAA,CAAA,GANP,CAMO,SANG,WAMH,GALL,UAKK,CALM,CAKN,CAAA,QAAA,CAAA,CAAA,GAJL,CAIK,SAJK,eAIL,GAHH,UAGG,CAHQ,CAGR,CAAA,QAAA,CAAA,CAAA,GAFH,CAAA,CAAE,UAEC;KAAV,UAAuB,CAAA,UAAF,CAAA,CAAE,OAAA,EAAA,CAAA,CAAA,GAAc,CAAd,SAAA,IAAA,GAA+B,CAAA,CAAE,QAAjC,CAA0C,CAA1C,CAAA,GAA+C,CAA/C;KACvB,aADqC,CAAA,UACb,CAAA,CAAE,OADW,EAAA,CAAA,CAAA,GACG,CADH,SAAA,IAAA,GAEtC,CAAA,CAAE,WAFoC,CAExB,CAFwB,CAAA,GAGtC,CAHsC;;;;;AAAkC,KASvE,YARA,CAAA,EAAa,CAAA,GAQM,EARN,SAAA;EAAa,OAAA,EAAA,IAAA;CAAc,GAAA,IAAA,GAAA,KAAA;AAC3B,KASN,kBATM,CAAA,UASuB,0BATvB,CAAA,GAAA,QAAZ,MAUQ,CAVR,GAUY,aAVZ,CAWF,UAXE,CAWS,gBAXT,CAW0B,CAX1B,CAW4B,CAX5B,CAAA,CAAA,MAAA,CAAA,CAAA,EAWyC,YAXzC,CAWsD,CAXtD,CAWwD,CAXxD,CAAA,CAAA,CAAA,EAYF,CAZE,CAYA,CAZA,CAAA,CAAA,YAAA,CAAA,CAAA,EACF;;AAAC;AAQL;;AACc,KAUF,oBAVE,CAAA,UAU6B,0BAV7B,CAAA,GAWZ,CAAA,CAAE,SAXU,CAWA,kBAXA,CAWmB,CAXnB,CAAA,CAAA"}

package/dist/schema/src/SchemaModelType.d.ts

@@ -0,0 +1,38 @@
+import * as z from "zod";
+
+//#region ../schema/src/SchemaModelType.d.ts
+
+/**
+ * Unified interface for all schema-compatible types.
+ * Any type used in ContractSpec schemas must implement this interface.
+ *
+ * @template T - The TypeScript type this schema represents
+ *
+ * @example
+ * ```typescript
+ * // All of these implement SchemaType:
+ * const fieldType = ScalarTypeEnum.String_unsecure();
+ * const schemaModel = new SchemaModel({ name: 'User', fields: {...} });
+ * const zodWrapper = fromZod(z.object({ name: z.string() }));
+ * ```
+ */
+interface SchemaModelType<T = unknown> {
+  /**
+   * Return the Zod schema for runtime validation.
+   * This is the primary method - all schema types must provide Zod conversion.
+   */
+  getZod(): z.ZodType<T>;
+  /**
+   * Return GraphQL type info for Pothos/GraphQL integration.
+   * Optional - types without GraphQL representation return undefined.
+   */
+  getPothos?(): unknown;
+  /**
+   * Return JSON Schema representation.
+   * Optional - types without JSON Schema representation return undefined.
+   */
+  getJsonSchema?(): unknown;
+}
+//#endregion
+export { SchemaModelType };
+//# sourceMappingURL=SchemaModelType.d.ts.map

package/dist/schema/src/SchemaModelType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaModelType.d.ts","names":[],"sources":["../../../../schema/src/SchemaModelType.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;UA8BiB;;;;;YAKL,CAAA,CAAE,QAAQ"}

package/dist/schema/src/ZodSchemaType.d.ts

@@ -0,0 +1,2 @@
+import "./SchemaModelType.js";
+import "zod";

package/dist/schema/src/entity/defineEntity.d.ts

@@ -0,0 +1 @@
+import "./types.js";

package/dist/schema/src/entity/generator.d.ts

@@ -0,0 +1 @@
+import "./types.js";

package/dist/schema/src/entity/index.d.ts

@@ -0,0 +1,3 @@
+import { EntityEnumDef, EntityEnumField, EntityField, EntityIndex, EntityRelationField, EntityScalarField, EntitySpec, ModuleSchemaContribution, PrismaFieldModifiers, PrismaScalarType, RelationType } from "./types.js";
+import "./defineEntity.js";
+import "./generator.js";

package/dist/schema/src/entity/types.d.ts

@@ -0,0 +1,146 @@
+import * as z from "zod";
+
+//#region ../schema/src/entity/types.d.ts
+
+/**
+ * Prisma scalar types that can be used in entity field definitions.
+ */
+type PrismaScalarType = 'String' | 'Int' | 'Float' | 'Boolean' | 'DateTime' | 'Json' | 'BigInt' | 'Decimal' | 'Bytes';
+/**
+ * Prisma field modifiers.
+ */
+interface PrismaFieldModifiers {
+  /** Field is optional (nullable) */
+  isOptional?: boolean;
+  /** Field is an array */
+  isArray?: boolean;
+  /** Field is unique */
+  isUnique?: boolean;
+  /** Field is the primary key (use @id) */
+  isId?: boolean;
+  /** Default value expression (e.g., 'cuid()', 'now()', 'autoincrement()') */
+  default?: string | number | boolean;
+  /** Field is auto-updated on record update (e.g., @updatedAt) */
+  updatedAt?: boolean;
+  /** Database column name override */
+  map?: string;
+  /** Database column type override */
+  dbType?: string;
+}
+/**
+ * Scalar field definition for an entity.
+ */
+interface EntityScalarField extends PrismaFieldModifiers {
+  kind: 'scalar';
+  type: PrismaScalarType;
+  /** Zod schema for validation */
+  zod?: z.ZodType;
+  /** Human-readable description (becomes Prisma /// comment) */
+  description?: string;
+}
+/**
+ * Enum field definition for an entity.
+ */
+interface EntityEnumField extends PrismaFieldModifiers {
+  kind: 'enum';
+  /** Name of the enum type */
+  enumName: string;
+  /** Enum values (for inline enum definition) */
+  values?: readonly string[];
+  /** Zod schema for validation */
+  zod?: z.ZodType;
+  /** Human-readable description */
+  description?: string;
+}
+/**
+ * Relation types supported by Prisma.
+ */
+type RelationType = 'hasOne' | 'hasMany' | 'belongsTo';
+/**
+ * Relation field definition for an entity.
+ */
+interface EntityRelationField {
+  kind: 'relation';
+  type: RelationType;
+  /** Target entity name */
+  target: string;
+  /** Foreign key field(s) on this model (for belongsTo) */
+  fields?: string[];
+  /** Referenced field(s) on the target model */
+  references?: string[];
+  /** Relation name for disambiguation */
+  name?: string;
+  /** On delete action */
+  onDelete?: 'Cascade' | 'SetNull' | 'Restrict' | 'NoAction' | 'SetDefault';
+  /** On update action */
+  onUpdate?: 'Cascade' | 'SetNull' | 'Restrict' | 'NoAction' | 'SetDefault';
+  /** Human-readable description */
+  description?: string;
+}
+/**
+ * Union of all entity field types.
+ */
+type EntityField = EntityScalarField | EntityEnumField | EntityRelationField;
+/**
+ * Index definition for an entity.
+ */
+interface EntityIndex {
+  /** Fields included in the index */
+  fields: string[];
+  /** Index is unique constraint */
+  unique?: boolean;
+  /** Index name override */
+  name?: string;
+  /** Sort order per field */
+  sort?: Record<string, 'Asc' | 'Desc'>;
+  /** Index type */
+  type?: 'BTree' | 'Hash' | 'Gist' | 'Gin';
+}
+/**
+ * Enum definition that can be shared across entities.
+ */
+interface EntityEnumDef {
+  /** Enum name */
+  name: string;
+  /** Enum values */
+  values: readonly string[];
+  /** Postgres schema where the enum is defined */
+  schema?: string;
+  /** Human-readable description */
+  description?: string;
+}
+/**
+ * Complete entity specification for database-backed models.
+ */
+interface EntitySpec<TFields extends Record<string, EntityField> = Record<string, EntityField>> {
+  /** Entity/model name (PascalCase) */
+  name: string;
+  /** Human-readable description (becomes Prisma /// comment) */
+  description?: string;
+  /** Postgres schema name (default: 'public') */
+  schema?: string;
+  /** Database table name override */
+  map?: string;
+  /** Field definitions */
+  fields: TFields;
+  /** Index definitions */
+  indexes?: EntityIndex[];
+  /** Enum definitions used by this entity */
+  enums?: EntityEnumDef[];
+  /** Module/domain this entity belongs to (for schema composition) */
+  module?: string;
+}
+/**
+ * Module schema contribution for composition.
+ */
+interface ModuleSchemaContribution {
+  /** Module identifier (e.g., '@contractspec/lib.identity-rbac') */
+  moduleId: string;
+  /** Entity specs provided by this module */
+  entities: EntitySpec[];
+  /** Shared enum definitions */
+  enums?: EntityEnumDef[];
+}
+//#endregion
+export { EntityEnumDef, EntityEnumField, EntityField, EntityIndex, EntityRelationField, EntityScalarField, EntitySpec, ModuleSchemaContribution, PrismaFieldModifiers, PrismaScalarType, RelationType };
+//# sourceMappingURL=types.d.ts.map

package/dist/schema/src/entity/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../../schema/src/entity/types.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAciB,KAdL,gBAAA,GAcyB,QAAA,GAAA,KAAA,GAAA,OAAA,GAAA,SAAA,GAAA,UAAA,GAAA,MAAA,GAAA,QAAA,GAAA,SAAA,GAAA,OAAA;AAsBrC;;;AAA2C,UAtB1B,oBAAA,CAsB0B;EAAoB;EAY9C,UAAA,CAAA,EAAA,OAAgB;EAerB;EAKK,OAAA,CAAA,EAAA,OAAA;EAsBL;EACR,QAAA,CAAA,EAAA,OAAA;EACA;EACA,IAAA,CAAA,EAAA,OAAA;EAAmB;EAKN,OAAA,CAAA,EAAA,MAAW,GAAA,MAAA,GAQnB,OAAM;EAQE;EAcA,SAAA,CAAA,EAAA,OAAU;EACM;EAAf,GAAA,CAAA,EAAA,MAAA;EAA6C;EAAf,MAAA,CAAA,EAAA,MAAA;;;;;AAuB/B,UApHA,iBAAA,SAA0B,oBA0HjC,CAAA;;QAxHF;;QAEA,CAAA,CAAE;;;;;;;UAQO,eAAA,SAAwB;;;;;;;QAOjC,CAAA,CAAE;;;;;;;KAQE,YAAA;;;;UAKK,mBAAA;;QAET;;;;;;;;;;;;;;;;;;;KAoBI,WAAA,GACR,oBACA,kBACA;;;;UAKa,WAAA;;;;;;;;SAQR;;;;;;;UAQQ,aAAA;;;;;;;;;;;;;UAcA,2BACC,eAAe,eAAe,eAAe;;;;;;;;;;UAWrD;;YAEE;;UAEF;;;;;;;UAQO,wBAAA;;;;YAIL;;UAEF"}

package/dist/schema/src/index.d.ts

@@ -0,0 +1,10 @@
+import { AnyFieldType, FieldType, FieldTypeConfig } from "./FieldType.js";
+import "./ScalarTypeEnum.js";
+import { AnyEnumType, EnumType } from "./EnumType.js";
+import { SchemaModelType } from "./SchemaModelType.js";
+import { AnySchemaModel, SchemaFieldConfig, SchemaModel, SchemaModelConfig, SchemaModelFieldsAnyConfig, TopLevelZodFromModel, ZodShapeFromFields } from "./SchemaModel.js";
+import { EntityEnumDef, EntityEnumField, EntityField, EntityIndex, EntityRelationField, EntityScalarField, EntitySpec, ModuleSchemaContribution, PrismaFieldModifiers, PrismaScalarType, RelationType } from "./entity/types.js";
+import "./entity/index.js";
+import "./ZodSchemaType.js";
+import "./JsonSchemaType.js";
+import "./GraphQLSchemaType.js";

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@contractspec/lib.feature-flags",
+  "version": "0.0.0-canary-20260113162409",
+  "description": "Feature flags and experiments module for ContractSpec applications",
+  "keywords": [
+    "contractspec",
+    "feature-flags",
+    "experiments",
+    "toggles",
+    "typescript"
+  ],
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src"
+  },
+  "dependencies": {
+    "@contractspec/lib.schema": "0.0.0-canary-20260113162409",
+    "@contractspec/lib.contracts": "0.0.0-canary-20260113162409",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113162409",
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113162409",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./contracts": "./dist/contracts/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/feature-flags.docblock": "./dist/docs/feature-flags.docblock.js",
+    "./entities": "./dist/entities/index.js",
+    "./evaluation": "./dist/evaluation/index.js",
+    "./events": "./dist/events.js",
+    "./feature-flags.capability": "./dist/feature-flags.capability.js",
+    "./feature-flags.feature": "./dist/feature-flags.feature.js",
+    "./*": "./*"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./contracts": "./dist/contracts/index.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/feature-flags.docblock": "./dist/docs/feature-flags.docblock.js",
+      "./entities": "./dist/entities/index.js",
+      "./evaluation": "./dist/evaluation/index.js",
+      "./events": "./dist/events.js",
+      "./feature-flags.feature": "./dist/feature-flags.feature.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/libs/feature-flags"
+  },
+  "homepage": "https://contractspec.io"
+}