@lssm/lib.feature-flags 1.41.1 → 1.42.2

package/dist/feature-flags.feature.js

@@ -1 +1,141 @@
-const e={meta:{key:`feature-flags`,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:[{name:`flag.create`,version:1},{name:`flag.update`,version:1},{name:`flag.delete`,version:1},{name:`flag.toggle`,version:1},{name:`flag.get`,version:1},{name:`flag.list`,version:1},{name:`flag.evaluate`,version:1},{name:`flag.rule.create`,version:1},{name:`flag.rule.delete`,version:1},{name:`experiment.create`,version:1},{name:`experiment.start`,version:1},{name:`experiment.stop`,version:1},{name:`experiment.get`,version:1}],events:[{name:`flag.created`,version:1},{name:`flag.updated`,version:1},{name:`flag.deleted`,version:1},{name:`flag.toggled`,version:1},{name:`flag.evaluated`,version:1},{name:`flag.rule_created`,version:1},{name:`flag.rule_deleted`,version:1},{name:`experiment.created`,version:1},{name:`experiment.started`,version:1},{name:`experiment.stopped`,version:1},{name:`experiment.variant_assigned`,version:1}],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{provides:[{key:`feature-flags`,version:1},{key:`experiments`,version:1}],requires:[{key:`identity`,version:1}]}};export{e as FeatureFlagsFeature};
+//#region src/feature-flags.feature.ts
+/**
+* Feature Flags feature module that bundles flag management,
+* targeting rules, and A/B experiment capabilities.
+*/
+const FeatureFlagsFeature = {
+	meta: {
+		key: "feature-flags",
+		version: 1,
+		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
+		},
+		{
+			key: "flag.update",
+			version: 1
+		},
+		{
+			key: "flag.delete",
+			version: 1
+		},
+		{
+			key: "flag.toggle",
+			version: 1
+		},
+		{
+			key: "flag.get",
+			version: 1
+		},
+		{
+			key: "flag.list",
+			version: 1
+		},
+		{
+			key: "flag.evaluate",
+			version: 1
+		},
+		{
+			key: "flag.rule.create",
+			version: 1
+		},
+		{
+			key: "flag.rule.delete",
+			version: 1
+		},
+		{
+			key: "experiment.create",
+			version: 1
+		},
+		{
+			key: "experiment.start",
+			version: 1
+		},
+		{
+			key: "experiment.stop",
+			version: 1
+		},
+		{
+			key: "experiment.get",
+			version: 1
+		}
+	],
+	events: [
+		{
+			key: "flag.created",
+			version: 1
+		},
+		{
+			key: "flag.updated",
+			version: 1
+		},
+		{
+			key: "flag.deleted",
+			version: 1
+		},
+		{
+			key: "flag.toggled",
+			version: 1
+		},
+		{
+			key: "flag.evaluated",
+			version: 1
+		},
+		{
+			key: "flag.rule_created",
+			version: 1
+		},
+		{
+			key: "flag.rule_deleted",
+			version: 1
+		},
+		{
+			key: "experiment.created",
+			version: 1
+		},
+		{
+			key: "experiment.started",
+			version: 1
+		},
+		{
+			key: "experiment.stopped",
+			version: 1
+		},
+		{
+			key: "experiment.variant_assigned",
+			version: 1
+		}
+	],
+	presentations: [],
+	opToPresentation: [],
+	presentationsTargets: [],
+	capabilities: {
+		provides: [{
+			key: "feature-flags",
+			version: 1
+		}, {
+			key: "experiments",
+			version: 1
+		}],
+		requires: [{
+			key: "identity",
+			version: 1
+		}]
+	}
+};
+
+//#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":["FeatureFlagsFeature: FeatureModuleSpec"],"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 type { FeatureModuleSpec } from '@lssm/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: FeatureModuleSpec = {\n  meta: {\n    key: 'feature-flags',\n    version: 1,\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 },\n    { key: 'flag.update', version: 1 },\n    { key: 'flag.delete', version: 1 },\n    { key: 'flag.toggle', version: 1 },\n    { key: 'flag.get', version: 1 },\n    { key: 'flag.list', version: 1 },\n    { key: 'flag.evaluate', version: 1 },\n\n    // Targeting rule operations\n    { key: 'flag.rule.create', version: 1 },\n    { key: 'flag.rule.delete', version: 1 },\n\n    // Experiment operations\n    { key: 'experiment.create', version: 1 },\n    { key: 'experiment.start', version: 1 },\n    { key: 'experiment.stop', version: 1 },\n    { key: 'experiment.get', version: 1 },\n  ],\n\n  // Events emitted by this feature\n  events: [\n    // Flag events\n    { key: 'flag.created', version: 1 },\n    { key: 'flag.updated', version: 1 },\n    { key: 'flag.deleted', version: 1 },\n    { key: 'flag.toggled', version: 1 },\n    { key: 'flag.evaluated', version: 1 },\n\n    // Rule events\n    { key: 'flag.rule_created', version: 1 },\n    { key: 'flag.rule_deleted', version: 1 },\n\n    // Experiment events\n    { key: 'experiment.created', version: 1 },\n    { key: 'experiment.started', version: 1 },\n    { key: 'experiment.stopped', version: 1 },\n    { key: 'experiment.variant_assigned', version: 1 },\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 },\n      { key: 'experiments', version: 1 },\n    ],\n    requires: [{ key: 'identity', version: 1 }],\n  },\n};\n"],"mappings":";;;;;AAWA,MAAaA,sBAAyC;CACpD,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;GAAG;EAClC;GAAE,KAAK;GAAe,SAAS;GAAG;EAClC;GAAE,KAAK;GAAe,SAAS;GAAG;EAClC;GAAE,KAAK;GAAe,SAAS;GAAG;EAClC;GAAE,KAAK;GAAY,SAAS;GAAG;EAC/B;GAAE,KAAK;GAAa,SAAS;GAAG;EAChC;GAAE,KAAK;GAAiB,SAAS;GAAG;EAGpC;GAAE,KAAK;GAAoB,SAAS;GAAG;EACvC;GAAE,KAAK;GAAoB,SAAS;GAAG;EAGvC;GAAE,KAAK;GAAqB,SAAS;GAAG;EACxC;GAAE,KAAK;GAAoB,SAAS;GAAG;EACvC;GAAE,KAAK;GAAmB,SAAS;GAAG;EACtC;GAAE,KAAK;GAAkB,SAAS;GAAG;EACtC;CAGD,QAAQ;EAEN;GAAE,KAAK;GAAgB,SAAS;GAAG;EACnC;GAAE,KAAK;GAAgB,SAAS;GAAG;EACnC;GAAE,KAAK;GAAgB,SAAS;GAAG;EACnC;GAAE,KAAK;GAAgB,SAAS;GAAG;EACnC;GAAE,KAAK;GAAkB,SAAS;GAAG;EAGrC;GAAE,KAAK;GAAqB,SAAS;GAAG;EACxC;GAAE,KAAK;GAAqB,SAAS;GAAG;EAGxC;GAAE,KAAK;GAAsB,SAAS;GAAG;EACzC;GAAE,KAAK;GAAsB,SAAS;GAAG;EACzC;GAAE,KAAK;GAAsB,SAAS;GAAG;EACzC;GAAE,KAAK;GAA+B,SAAS;GAAG;EACnD;CAGD,eAAe,EAAE;CACjB,kBAAkB,EAAE;CACpB,sBAAsB,EAAE;CAGxB,cAAc;EACZ,UAAU,CACR;GAAE,KAAK;GAAiB,SAAS;GAAG,EACpC;GAAE,KAAK;GAAe,SAAS;GAAG,CACnC;EACD,UAAU,CAAC;GAAE,KAAK;GAAY,SAAS;GAAG,CAAC;EAC5C;CACF"}

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

@@ -1 +1,8 @@
-import{ExperimentCreatedEvent as e,ExperimentStartedEvent as t,ExperimentStoppedEvent as n,FeatureFlagEvents as r,FlagCreatedEvent as i,FlagDeletedEvent as a,FlagEvaluatedEvent as o,FlagToggledEvent as s,FlagUpdatedEvent as c,RuleCreatedEvent as l,RuleDeletedEvent as u,VariantAssignedEvent as d}from"./events.js";import{FeatureFlagsFeature as f}from"./feature-flags.feature.js";import{ExperimentAssignmentEntity as p,ExperimentEntity as m,ExperimentStatusEnum as h,FeatureFlagEntity as g,FlagEvaluationEntity as _,FlagStatusEnum as v,FlagTargetingRuleEntity as y,RuleOperatorEnum as b,featureFlagEntities as x,featureFlagsSchemaContribution as S}from"./entities/index.js";import{CreateExperimentContract as C,CreateFlagContract as w,CreateRuleContract as T,DeleteFlagContract as E,DeleteRuleContract as D,EvaluateFlagContract as O,EvaluationResultModel as k,ExperimentModel as A,FeatureFlagModel as j,GetExperimentContract as M,GetFlagContract as N,ListFlagsContract as P,StartExperimentContract as F,StopExperimentContract as I,TargetingRuleModel as L,ToggleFlagContract as R,UpdateFlagContract as z}from"./contracts/index.js";import{FlagEvaluator as B,InMemoryFlagRepository as V,evaluateRuleCondition as H,getSubjectId as U,hashToBucket as W}from"./evaluation/index.js";import"./docs/index.js";export{C as CreateExperimentContract,w as CreateFlagContract,T as CreateRuleContract,E as DeleteFlagContract,D as DeleteRuleContract,O as EvaluateFlagContract,k as EvaluationResultModel,p as ExperimentAssignmentEntity,e as ExperimentCreatedEvent,m as ExperimentEntity,A as ExperimentModel,t as ExperimentStartedEvent,h as ExperimentStatusEnum,n as ExperimentStoppedEvent,g as FeatureFlagEntity,r as FeatureFlagEvents,j as FeatureFlagModel,f as FeatureFlagsFeature,i as FlagCreatedEvent,a as FlagDeletedEvent,o as FlagEvaluatedEvent,_ as FlagEvaluationEntity,B as FlagEvaluator,v as FlagStatusEnum,y as FlagTargetingRuleEntity,s as FlagToggledEvent,c as FlagUpdatedEvent,M as GetExperimentContract,N as GetFlagContract,V as InMemoryFlagRepository,P as ListFlagsContract,l as RuleCreatedEvent,u as RuleDeletedEvent,b as RuleOperatorEnum,F as StartExperimentContract,I as StopExperimentContract,L as TargetingRuleModel,R as ToggleFlagContract,z as UpdateFlagContract,d as VariantAssignedEvent,H as evaluateRuleCondition,x as featureFlagEntities,S as featureFlagsSchemaContribution,U as getSubjectId,W as hashToBucket};
+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,CAAG,SAAA,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/ScalarTypeEnum.d.ts

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

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

@@ -0,0 +1,56 @@
+import { AnyFieldType } from "./FieldType.js";
+import { AnyEnumType } from "./EnumType.js";
+import * as z from "zod";
+import { Maybe } from "graphql/jsutils/Maybe";
+
+//#region ../schema/src/SchemaModel.d.ts
+type FieldLike = AnyFieldType | AnyEnumType | AnySchemaModel;
+/** 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> {
+  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;
+}
+type AnySchemaModel = SchemaModel<SchemaModelFieldsAnyConfig>;
+type InferZodFromType<T> = T extends SchemaModel<SchemaModelFieldsAnyConfig> ? z.ZodObject<z.ZodRawShape> : T extends AnyFieldType ? ReturnType<T['getZod']> : T extends AnyEnumType ? ReturnType<T['getZod']> : never;
+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":";;;;;;KAKK,SAAA,GAAY,eAAe,cAAc;;AAAzC,UAGY,iBAHH,CAAA,aAGkC,SAHlC,GAG8C,SAH9C,CAAA,CAAA;EAAG,IAAA,EAIT,IAJS;EAAe,UAAA,EAAA,OAAA;EAAc;EAAc,OAAA,CAAA,EAAA,IAAA;AAG5D;AAAgD,KAOpC,0BAPoC,CAAA,aAOI,SAPJ,GAOgB,SAPhB,CAAA,GAQ9C,MAR8C,CAAA,MAAA,EAQ/B,iBAR+B,CAQb,IARa,CAAA,CAAA;;AACxC,UAUS,iBAVT,CAAA,eAU0C,0BAV1C,CAAA,CAAA;EAAI,IAAA,EAAA,MAAA;EAMA,WAAA,CAAA,EAMI,KANJ,CAAA,MAAA,CAAA;EAAwC,MAAA,EAO1C,MAP0C;;;;;;AAInC,cAUJ,WAVqB,CAAA,eAUM,0BAVN,CAAA,CAAA;EAAgB,SAAA,MAAA,EAWZ,iBAXY,CAWM,MAXN,CAAA;EAElC,WAAA,CAAA,MAAA,EASsB,iBATtB,CASwC,MATxC,CAAA;EACN;;AAOV;;EACwD,MAAA,CAAA,CAAA,EAM5C,oBAN4C,CAMvB,MANuB,CAAA;EAAlB;EAAkB,cAAA,CAAA,CAAA,EAAA,MAAA;;AAMvB,KAwBrB,cAAA,GAAiB,WAxBI,CAwBQ,0BAxBR,CAAA;KA8B5B,gBA9B2B,CAAA,CAAA,CAAA,GA+B9B,CA/B8B,SA+BpB,WA/BoB,CA+BR,0BA/BQ,CAAA,GAgC1B,CAAA,CAAE,SAhCwB,CAgCd,CAAA,CAAE,WAhCY,CAAA,GAiC1B,CAjC0B,SAiChB,YAjCgB,GAkCxB,UAlCwB,CAkCb,CAlCa,CAAA,QAAA,CAAA,CAAA,GAmCxB,CAnCwB,SAmCd,WAnCc,GAoCtB,UApCsB,CAoCX,CApCW,CAAA,QAAA,CAAA,CAAA,GAAA,KAAA;AAwBhC,KAeK,UAfO,CAAA,UAec,CAAA,CAAE,OAfa,EAAA,CAAA,CAAA,GAeC,CAfD,SAAA,IAAA,GAekB,CAAA,CAAE,QAfhC,CAeyC,CAfzC,CAAA,GAe8C,CAfnC;AAItC,KAYG,aAVA,CAAA,UAUwB,CAAA,CAAE,OAVV,EAAA,CAAA,CAAA,GAUwB,CAVxB,SAAA,IAAA,GAWjB,CAAA,CAAE,WAXe,CAWH,CAXG,CAAA,GAYjB,CAZiB;;;;;KAkBhB,YAhBG,CAAA,EAAA,CAAA,GAgBgB,EAhBhB,SAAA;EACF,OAAA,EAAA,IAAA;CAAU,GAAA,IAAA,GAAA,KAAA;AACG,KAgBP,kBAhBO,CAAA,UAgBsB,0BAhBtB,CAAA,GAAA,QAAX,MAiBM,CAjBN,GAiBU,aAjBV,CAkBJ,UAlBI,CAkBO,gBAlBP,CAkBwB,CAlBxB,CAkB0B,CAlB1B,CAAA,CAAA,MAAA,CAAA,CAAA,EAkBuC,YAlBvC,CAkBoD,CAlBpD,CAkBsD,CAlBtD,CAAA,CAAA,CAAA,EAmBJ,CAnBI,CAmBF,CAnBE,CAAA,CAAA,YAAA,CAAA,CAAA,EACA;;;;;AAIH,KAsBO,oBAtBG,CAAA,UAsB4B,0BAtB5B,CAAA,GAuBb,CAAA,CAAE,SAvBW,CAuBD,kBAvBC,CAuBkB,CAvBlB,CAAA,CAAA"}

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., '@lssm/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,6 @@
+import { AnyFieldType, FieldType, FieldTypeConfig } from "./FieldType.js";
+import "./ScalarTypeEnum.js";
+import { AnyEnumType, EnumType } from "./EnumType.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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.feature-flags",
-  "version": "1.41.1",
+  "version": "1.42.2",
   "description": "Feature flags and experiments module for ContractSpec applications",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -8,7 +8,7 @@
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:bundle && bun build:types",
+    "build": "bun build:types && bun build:bundle",
     "build:bundle": "tsdown",
     "build:types": "tsc --noEmit",
     "dev": "bun build:bundle --watch",
@@ -18,24 +18,24 @@
     "lint:check": "eslint src"
   },
   "dependencies": {
-    "@lssm/lib.schema": "1.41.1",
-    "@lssm/lib.contracts": "1.41.1",
+    "@lssm/lib.schema": "1.42.2",
+    "@lssm/lib.contracts": "1.42.2",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.typescript": "1.41.1",
-    "@lssm/tool.tsdown": "1.41.1",
+    "@lssm/tool.typescript": "1.42.2",
+    "@lssm/tool.tsdown": "1.42.2",
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./src/index.ts",
-    "./contracts": "./src/contracts/index.ts",
-    "./docs": "./src/docs/index.ts",
-    "./docs/feature-flags.docblock": "./src/docs/feature-flags.docblock.ts",
-    "./entities": "./src/entities/index.ts",
-    "./evaluation": "./src/evaluation/index.ts",
-    "./events": "./src/events.ts",
-    "./feature-flags.feature": "./src/feature-flags.feature.ts",
+    ".": "./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",
     "./*": "./*"
   },
   "module": "./dist/index.js",
@@ -55,6 +55,13 @@
       "./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"
   }
 }