@lssm/lib.schema 0.0.0-canary-20251221193616 → 0.0.0-canary-20251223010757

package/dist/SchemaModel.d.ts

@@ -1,39 +1,41 @@
-import { type AnyFieldType } from './FieldType';
-import { type AnyEnumType } from './EnumType';
-import * as z from 'zod';
-import type { Maybe } from 'graphql/jsutils/Maybe';
+import { AnyEnumType } from "./EnumType.js";
+import { AnyFieldType } from "./FieldType.js";
+import * as z from "zod";
+import { Maybe } from "graphql/jsutils/Maybe";
+
+//#region src/SchemaModel.d.ts
 type FieldLike = AnyFieldType | AnyEnumType | AnySchemaModel;
 /** Field configuration for a SchemaModel property. */
-export interface SchemaFieldConfig<Type extends FieldLike = FieldLike> {
-    type: Type;
-    isOptional: boolean;
-    /** When present and true, the field is an array */
-    isArray?: true;
+interface SchemaFieldConfig<Type extends FieldLike = FieldLike> {
+  type: Type;
+  isOptional: boolean;
+  /** When present and true, the field is an array */
+  isArray?: true;
 }
-export type SchemaModelFieldsAnyConfig<Type extends FieldLike = FieldLike> = Record<string, SchemaFieldConfig<Type>>;
+type SchemaModelFieldsAnyConfig<Type extends FieldLike = FieldLike> = Record<string, SchemaFieldConfig<Type>>;
 /** Model definition: name and fields. */
-export interface SchemaModelConfig<Fields extends SchemaModelFieldsAnyConfig> {
-    name: string;
-    description?: Maybe<string>;
-    fields: 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.
  */
-export 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;
+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;
 }
-export type AnySchemaModel = SchemaModel<SchemaModelFieldsAnyConfig>;
-export type ZodSchemaModel<Field extends AnySchemaModel> = z.infer<ReturnType<Field['getZod']>>;
+type AnySchemaModel = SchemaModel<SchemaModelFieldsAnyConfig>;
+type ZodSchemaModel<Field extends AnySchemaModel> = z.infer<ReturnType<Field['getZod']>>;
 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;
@@ -42,20 +44,19 @@ type MaybeOptional<Z extends z.ZodType, O> = O extends true ? z.ZodOptional<Z> :
  * Supports nested SchemaModel and arrays, preserving optionality and list-ness.
  */
 type FieldIsArray<FC> = FC extends {
-    isArray: true;
+  isArray: true;
 } ? true : false;
-export type ZodShapeFromFields<F extends SchemaModelFieldsAnyConfig> = {
-    [K in keyof F]: MaybeOptional<MaybeArray<InferZodFromType<F[K]['type']>, FieldIsArray<F[K]>>, F[K]['isOptional']>;
-};
+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.
  */
-export type TopLevelZodFromModel<F extends SchemaModelFieldsAnyConfig> = z.ZodObject<ZodShapeFromFields<F>>;
+type TopLevelZodFromModel<F extends SchemaModelFieldsAnyConfig> = z.ZodObject<ZodShapeFromFields<F>>;
 /**
  * Helper to define a SchemaModel with type inference.
  * Equivalent to `new SchemaModel(config)` but with better ergonomics.
  */
-export declare const defineSchemaModel: <Fields extends SchemaModelFieldsAnyConfig>(config: SchemaModelConfig<Fields>) => SchemaModel<Fields>;
-export {};
+declare const defineSchemaModel: <Fields extends SchemaModelFieldsAnyConfig>(config: SchemaModelConfig<Fields>) => SchemaModel<Fields>;
+//#endregion
+export { AnySchemaModel, SchemaFieldConfig, SchemaModel, SchemaModelConfig, SchemaModelFieldsAnyConfig, TopLevelZodFromModel, ZodSchemaModel, ZodShapeFromFields, defineSchemaModel };
 //# sourceMappingURL=SchemaModel.d.ts.map

package/dist/SchemaModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaModel.d.ts","sourceRoot":"","sources":["../src/SchemaModel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SchemaModel.d.ts","names":[],"sources":["../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;AAArB,KA0BA,cA1BA,CAAA,cA0B6B,cA1B7B,CAAA,GA0B+C,CAAA,CAAE,KA1BjD,CA2BV,UA3BU,CA2BC,KA3BD,CAAA,QAAA,CAAA,CAAA,CAAA;KA8BP,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;AAExC,KAcK,aAdO,CAAA,UAciB,CAAA,CAAE,OAdL,EAAA,CAAA,CAAA,GAcmB,CAdnB,SAAA,IAAA,GAetB,CAAA,CAAE,WAfoB,CAeR,CAfQ,CAAA,GAgBtB,CAhBsB;;;;;KAsBrB,YAtB6D,CAAA,EAAA,CAAA,GAsB1C,EAtB0C,SAAA;EAI7D,OAAA,EAAA,IAAA;CACH,GAAA,IAAA,GAAA,KAAA;AAAsB,KAmBZ,kBAnBY,CAAA,UAmBiB,0BAnBjB,CAAA,GAAA,QAAZ,MAoBE,CApBF,GAoBM,aApBN,CAqBR,UArBQ,CAqBG,gBArBH,CAqBoB,CArBpB,CAqBsB,CArBtB,CAAA,CAAA,MAAA,CAAA,CAAA,EAqBmC,YArBnC,CAqBgD,CArBhD,CAqBkD,CArBlD,CAAA,CAAA,CAAA,EAsBR,CAtBQ,CAsBN,CAtBM,CAAA,CAAA,YAAA,CAAA,CAAA,EACM;;;;;AAEV,KA2BI,oBA3BJ,CAAA,UA2BmC,0BA3BnC,CAAA,GA4BN,CAAA,CAAE,SA5BI,CA4BM,kBA5BN,CA4ByB,CA5BzB,CAAA,CAAA;;;;;AAEY,cAgCP,iBAhCO,EAAA,CAAA,eAgC6B,0BAhC7B,CAAA,CAAA,MAAA,EAiCV,iBAjCU,CAiCQ,MAjCR,CAAA,EAAA,GAkCjB,WAlCiB,CAkCL,MAlCK,CAAA"}

package/dist/SchemaModel.js

@@ -0,0 +1,40 @@
+import "./EnumType.js";
+import "./FieldType.js";
+import * as z from "zod";
+
+//#region src/SchemaModel.ts
+/**
+* Named object model built from FieldType/EnumType/SchemaModel fields.
+* Provides zod and GraphQL input helpers, and supports arrays/optional fields.
+*/
+var SchemaModel = class {
+	constructor(config) {
+		this.config = config;
+	}
+	/**
+	* Build a typed ZodObject from the model fields, preserving each field's
+	* Zod schema and optionality at the type level when possible.
+	*/
+	getZod() {
+		const shape = Object.entries(this.config.fields).reduce((acc, [key, def]) => {
+			const base = def.type.getZod();
+			const withArray = def.isArray ? z.array(base) : base;
+			acc[key] = def.isOptional ? withArray.optional() : withArray;
+			return acc;
+		}, {});
+		return z.object(shape);
+	}
+	/** Input object name for GraphQL builder adapters. */
+	getPothosInput() {
+		return this.config.name;
+	}
+};
+/**
+* Helper to define a SchemaModel with type inference.
+* Equivalent to `new SchemaModel(config)` but with better ergonomics.
+*/
+const defineSchemaModel = (config) => new SchemaModel(config);
+
+//#endregion
+export { SchemaModel, defineSchemaModel };
+//# sourceMappingURL=SchemaModel.js.map

package/dist/SchemaModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaModel.js","names":["config: SchemaModelConfig<Fields>","base: z.ZodType"],"sources":["../src/SchemaModel.ts"],"sourcesContent":["import { type AnyFieldType } from './FieldType';\nimport { type AnyEnumType } from './EnumType';\nimport * as z from 'zod';\nimport type { Maybe } from 'graphql/jsutils/Maybe';\n\ntype FieldLike = AnyFieldType | AnyEnumType | AnySchemaModel;\n\n/** Field configuration for a SchemaModel property. */\nexport interface SchemaFieldConfig<Type extends FieldLike = FieldLike> {\n  type: Type;\n  isOptional: boolean;\n  /** When present and true, the field is an array */\n  isArray?: true;\n}\n\nexport type SchemaModelFieldsAnyConfig<Type extends FieldLike = FieldLike> =\n  Record<string, SchemaFieldConfig<Type>>;\n\n/** Model definition: name and fields. */\nexport interface SchemaModelConfig<Fields extends SchemaModelFieldsAnyConfig> {\n  name: string;\n  description?: Maybe<string>;\n  fields: Fields;\n}\n\n/**\n * Named object model built from FieldType/EnumType/SchemaModel fields.\n * Provides zod and GraphQL input helpers, and supports arrays/optional fields.\n */\nexport class SchemaModel<Fields extends SchemaModelFieldsAnyConfig> {\n  constructor(public readonly config: SchemaModelConfig<Fields>) {}\n\n  /**\n   * Build a typed ZodObject from the model fields, preserving each field's\n   * Zod schema and optionality at the type level when possible.\n   */\n  getZod(): TopLevelZodFromModel<Fields> {\n    const shape = Object.entries(this.config.fields).reduce(\n      (acc, [key, def]) => {\n        const base: z.ZodType = (\n          def.type as unknown as { getZod: () => z.ZodType }\n        ).getZod();\n        const withArray = def.isArray ? z.array(base) : base;\n        (acc as Record<string, z.ZodType>)[key] = def.isOptional\n          ? withArray.optional()\n          : withArray;\n        return acc;\n      },\n      {} as Record<string, z.ZodType>\n    ) as unknown as ZodShapeFromFields<Fields>;\n\n    return z.object(shape) as z.ZodObject<ZodShapeFromFields<Fields>>;\n  }\n\n  /** Input object name for GraphQL builder adapters. */\n  getPothosInput() {\n    return this.config.name;\n  }\n}\n\nexport type AnySchemaModel = SchemaModel<SchemaModelFieldsAnyConfig>;\n\nexport type ZodSchemaModel<Field extends AnySchemaModel> = z.infer<\n  ReturnType<Field['getZod']>\n>;\n\ntype InferZodFromType<T> =\n  T extends SchemaModel<SchemaModelFieldsAnyConfig>\n    ? z.ZodObject<z.ZodRawShape>\n    : T extends AnyFieldType\n      ? ReturnType<T['getZod']>\n      : T extends AnyEnumType\n        ? ReturnType<T['getZod']>\n        : never;\n\ntype MaybeArray<Z extends z.ZodType, A> = A extends true ? z.ZodArray<Z> : Z;\ntype MaybeOptional<Z extends z.ZodType, O> = O extends true\n  ? z.ZodOptional<Z>\n  : Z;\n\n/**\n * Helper type: derive the Zod shape from the field config.\n * Supports nested SchemaModel and arrays, preserving optionality and list-ness.\n */\ntype FieldIsArray<FC> = FC extends { isArray: true } ? true : false;\n\nexport type ZodShapeFromFields<F extends SchemaModelFieldsAnyConfig> = {\n  [K in keyof F]: MaybeOptional<\n    MaybeArray<InferZodFromType<F[K]['type']>, FieldIsArray<F[K]>>,\n    F[K]['isOptional']\n  >;\n};\n\n/**\n * The top-level Zod schema returned by getZod():\n * either ZodObject<...> or ZodArray<ZodObject<...>> when config.isArray.\n */\nexport type TopLevelZodFromModel<F extends SchemaModelFieldsAnyConfig> =\n  z.ZodObject<ZodShapeFromFields<F>>;\n\n/**\n * Helper to define a SchemaModel with type inference.\n * Equivalent to `new SchemaModel(config)` but with better ergonomics.\n */\nexport const defineSchemaModel = <Fields extends SchemaModelFieldsAnyConfig>(\n  config: SchemaModelConfig<Fields>\n): SchemaModel<Fields> => new SchemaModel(config);\n"],"mappings":";;;;;;;;;AA6BA,IAAa,cAAb,MAAoE;CAClE,YAAY,AAAgBA,QAAmC;EAAnC;;;;;;CAM5B,SAAuC;EACrC,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,OAAO,CAAC,QAC9C,KAAK,CAAC,KAAK,SAAS;GACnB,MAAMC,OACJ,IAAI,KACJ,QAAQ;GACV,MAAM,YAAY,IAAI,UAAU,EAAE,MAAM,KAAK,GAAG;AAChD,GAAC,IAAkC,OAAO,IAAI,aAC1C,UAAU,UAAU,GACpB;AACJ,UAAO;KAET,EAAE,CACH;AAED,SAAO,EAAE,OAAO,MAAM;;;CAIxB,iBAAiB;AACf,SAAO,KAAK,OAAO;;;;;;;AAgDvB,MAAa,qBACX,WACwB,IAAI,YAAY,OAAO"}

package/dist/entity/defineEntity.d.ts

@@ -1,4 +1,7 @@
-import type { EntityEnumDef, EntityEnumField, EntityField, EntityIndex, EntityRelationField, EntityScalarField, EntitySpec } from './types';
+import { EntityEnumDef, EntityEnumField, EntityField, EntityIndex, EntityRelationField, EntityScalarField, EntitySpec } from "./types.js";
+
+//#region src/entity/defineEntity.d.ts
+
 /**
  * Helper to define a database entity with full type safety.
  *
@@ -20,69 +23,71 @@ import type { EntityEnumDef, EntityEnumField, EntityField, EntityIndex, EntityRe
  * });
  * ```
  */
-export declare function defineEntity<TFields extends Record<string, EntityField>>(spec: EntitySpec<TFields>): EntitySpec<TFields>;
+declare function defineEntity<TFields extends Record<string, EntityField>>(spec: EntitySpec<TFields>): EntitySpec<TFields>;
 /**
  * Helper to define an enum that can be shared across entities.
  */
-export declare function defineEntityEnum(def: EntityEnumDef): EntityEnumDef;
+declare function defineEntityEnum(def: EntityEnumDef): EntityEnumDef;
 /**
  * Field builder helpers for common field patterns.
  */
-export declare const field: {
-    /** String field */
-    string(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
-    /** Integer field */
-    int(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
-    /** Float field */
-    float(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
-    /** Boolean field */
-    boolean(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
-    /** DateTime field */
-    dateTime(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
-    /** JSON field */
-    json(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
-    /** BigInt field */
-    bigInt(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
-    /** Decimal field */
-    decimal(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
-    /** Bytes field */
-    bytes(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
-    /** Primary key field with cuid() default */
-    id(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "isId">>): EntityScalarField;
-    /** Primary key field with uuid() default */
-    uuid(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "isId">>): EntityScalarField;
-    /** Auto-increment integer primary key */
-    autoIncrement(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "isId">>): EntityScalarField;
-    /** createdAt timestamp with now() default */
-    createdAt(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "default">>): EntityScalarField;
-    /** updatedAt timestamp with @updatedAt */
-    updatedAt(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "updatedAt">>): EntityScalarField;
-    /** Email field with validation */
-    email(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
-    /** URL field with validation */
-    url(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
-    /** Enum field */
-    enum(enumName: string, opts?: Partial<Omit<EntityEnumField, "kind" | "enumName">>): EntityEnumField;
-    /** Inline enum field with values */
-    inlineEnum(enumName: string, values: readonly string[], opts?: Partial<Omit<EntityEnumField, "kind" | "enumName" | "values">>): EntityEnumField;
-    /** Has one relation (1:1 inverse side) */
-    hasOne(target: string, opts?: Partial<Omit<EntityRelationField, "kind" | "type" | "target">>): EntityRelationField;
-    /** Has many relation (1:N inverse side) */
-    hasMany(target: string, opts?: Partial<Omit<EntityRelationField, "kind" | "type" | "target">>): EntityRelationField;
-    /** Belongs to relation (N:1 owning side with foreign key) */
-    belongsTo(target: string, fields: string[], references: string[], opts?: Partial<Omit<EntityRelationField, "kind" | "type" | "target" | "fields" | "references">>): EntityRelationField;
-    /** Foreign key field (string) - use with belongsTo */
-    foreignKey(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+declare const field: {
+  /** String field */
+  string(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Integer field */
+  int(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Float field */
+  float(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Boolean field */
+  boolean(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** DateTime field */
+  dateTime(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** JSON field */
+  json(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** BigInt field */
+  bigInt(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Decimal field */
+  decimal(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Bytes field */
+  bytes(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Primary key field with cuid() default */
+  id(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "isId">>): EntityScalarField;
+  /** Primary key field with uuid() default */
+  uuid(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "isId">>): EntityScalarField;
+  /** Auto-increment integer primary key */
+  autoIncrement(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "isId">>): EntityScalarField;
+  /** createdAt timestamp with now() default */
+  createdAt(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "default">>): EntityScalarField;
+  /** updatedAt timestamp with @updatedAt */
+  updatedAt(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "updatedAt">>): EntityScalarField;
+  /** Email field with validation */
+  email(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** URL field with validation */
+  url(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Enum field */
+  enum(enumName: string, opts?: Partial<Omit<EntityEnumField, "kind" | "enumName">>): EntityEnumField;
+  /** Inline enum field with values */
+  inlineEnum(enumName: string, values: readonly string[], opts?: Partial<Omit<EntityEnumField, "kind" | "enumName" | "values">>): EntityEnumField;
+  /** Has one relation (1:1 inverse side) */
+  hasOne(target: string, opts?: Partial<Omit<EntityRelationField, "kind" | "type" | "target">>): EntityRelationField;
+  /** Has many relation (1:N inverse side) */
+  hasMany(target: string, opts?: Partial<Omit<EntityRelationField, "kind" | "type" | "target">>): EntityRelationField;
+  /** Belongs to relation (N:1 owning side with foreign key) */
+  belongsTo(target: string, fields: string[], references: string[], opts?: Partial<Omit<EntityRelationField, "kind" | "type" | "target" | "fields" | "references">>): EntityRelationField;
+  /** Foreign key field (string) - use with belongsTo */
+  foreignKey(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
 };
 /**
  * Index builder helpers.
  */
-export declare const index: {
-    /** Create a regular index */
-    on(fields: string[], opts?: Partial<Omit<EntityIndex, "fields">>): EntityIndex;
-    /** Create a unique constraint index */
-    unique(fields: string[], opts?: Partial<Omit<EntityIndex, "fields" | "unique">>): EntityIndex;
-    /** Create a compound index with sort orders */
-    compound(fields: string[], sort: Record<string, "Asc" | "Desc">, opts?: Partial<Omit<EntityIndex, "fields" | "sort">>): EntityIndex;
+declare const index: {
+  /** Create a regular index */
+  on(fields: string[], opts?: Partial<Omit<EntityIndex, "fields">>): EntityIndex;
+  /** Create a unique constraint index */
+  unique(fields: string[], opts?: Partial<Omit<EntityIndex, "fields" | "unique">>): EntityIndex;
+  /** Create a compound index with sort orders */
+  compound(fields: string[], sort: Record<string, "Asc" | "Desc">, opts?: Partial<Omit<EntityIndex, "fields" | "sort">>): EntityIndex;
 };
+//#endregion
+export { defineEntity, defineEntityEnum, field, index };
 //# sourceMappingURL=defineEntity.d.ts.map

package/dist/entity/defineEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineEntity.d.ts","sourceRoot":"","sources":["../../src/entity/defineEntity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"defineEntity.d.ts","names":[],"sources":["../../src/entity/defineEntity.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/entity/defineEntity.js

@@ -0,0 +1,237 @@
+import * as z from "zod";
+
+//#region src/entity/defineEntity.ts
+/**
+* Helper to define a database entity with full type safety.
+*
+* @example
+* ```typescript
+* const UserEntity = defineEntity({
+*   name: 'User',
+*   schema: 'lssm_sigil',
+*   description: 'A user of the platform.',
+*   fields: {
+*     id: field.id(),
+*     email: field.string({ isUnique: true, zod: z.string().email() }),
+*     name: field.string({ isOptional: true }),
+*     createdAt: field.createdAt(),
+*     updatedAt: field.updatedAt(),
+*     memberships: field.hasMany('Member'),
+*   },
+*   indexes: [{ fields: ['email'], unique: true }],
+* });
+* ```
+*/
+function defineEntity(spec) {
+	return spec;
+}
+/**
+* Helper to define an enum that can be shared across entities.
+*/
+function defineEntityEnum(def) {
+	return def;
+}
+/**
+* Field builder helpers for common field patterns.
+*/
+const field = {
+	string(opts) {
+		return {
+			kind: "scalar",
+			type: "String",
+			...opts
+		};
+	},
+	int(opts) {
+		return {
+			kind: "scalar",
+			type: "Int",
+			...opts
+		};
+	},
+	float(opts) {
+		return {
+			kind: "scalar",
+			type: "Float",
+			...opts
+		};
+	},
+	boolean(opts) {
+		return {
+			kind: "scalar",
+			type: "Boolean",
+			...opts
+		};
+	},
+	dateTime(opts) {
+		return {
+			kind: "scalar",
+			type: "DateTime",
+			...opts
+		};
+	},
+	json(opts) {
+		return {
+			kind: "scalar",
+			type: "Json",
+			...opts
+		};
+	},
+	bigInt(opts) {
+		return {
+			kind: "scalar",
+			type: "BigInt",
+			...opts
+		};
+	},
+	decimal(opts) {
+		return {
+			kind: "scalar",
+			type: "Decimal",
+			...opts
+		};
+	},
+	bytes(opts) {
+		return {
+			kind: "scalar",
+			type: "Bytes",
+			...opts
+		};
+	},
+	id(opts) {
+		return {
+			kind: "scalar",
+			type: "String",
+			isId: true,
+			default: "cuid()",
+			...opts
+		};
+	},
+	uuid(opts) {
+		return {
+			kind: "scalar",
+			type: "String",
+			isId: true,
+			default: "uuid()",
+			...opts
+		};
+	},
+	autoIncrement(opts) {
+		return {
+			kind: "scalar",
+			type: "Int",
+			isId: true,
+			default: "autoincrement()",
+			...opts
+		};
+	},
+	createdAt(opts) {
+		return {
+			kind: "scalar",
+			type: "DateTime",
+			default: "now()",
+			...opts
+		};
+	},
+	updatedAt(opts) {
+		return {
+			kind: "scalar",
+			type: "DateTime",
+			updatedAt: true,
+			...opts
+		};
+	},
+	email(opts) {
+		return {
+			kind: "scalar",
+			type: "String",
+			zod: z.email(),
+			...opts
+		};
+	},
+	url(opts) {
+		return {
+			kind: "scalar",
+			type: "String",
+			zod: z.url(),
+			...opts
+		};
+	},
+	enum(enumName, opts) {
+		return {
+			kind: "enum",
+			enumName,
+			...opts
+		};
+	},
+	inlineEnum(enumName, values, opts) {
+		return {
+			kind: "enum",
+			enumName,
+			values,
+			...opts
+		};
+	},
+	hasOne(target, opts) {
+		return {
+			kind: "relation",
+			type: "hasOne",
+			target,
+			...opts
+		};
+	},
+	hasMany(target, opts) {
+		return {
+			kind: "relation",
+			type: "hasMany",
+			target,
+			...opts
+		};
+	},
+	belongsTo(target, fields, references, opts) {
+		return {
+			kind: "relation",
+			type: "belongsTo",
+			target,
+			fields,
+			references,
+			...opts
+		};
+	},
+	foreignKey(opts) {
+		return {
+			kind: "scalar",
+			type: "String",
+			...opts
+		};
+	}
+};
+/**
+* Index builder helpers.
+*/
+const index = {
+	on(fields, opts) {
+		return {
+			fields,
+			...opts
+		};
+	},
+	unique(fields, opts) {
+		return {
+			fields,
+			unique: true,
+			...opts
+		};
+	},
+	compound(fields, sort, opts) {
+		return {
+			fields,
+			sort,
+			...opts
+		};
+	}
+};
+
+//#endregion
+export { defineEntity, defineEntityEnum, field, index };
+//# sourceMappingURL=defineEntity.js.map

package/dist/entity/defineEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineEntity.js","names":[],"sources":["../../src/entity/defineEntity.ts"],"sourcesContent":["import * as z from 'zod';\nimport type {\n  EntityEnumDef,\n  EntityEnumField,\n  EntityField,\n  EntityIndex,\n  EntityRelationField,\n  EntityScalarField,\n  EntitySpec,\n} from './types';\n\n/**\n * Helper to define a database entity with full type safety.\n *\n * @example\n * ```typescript\n * const UserEntity = defineEntity({\n *   name: 'User',\n *   schema: 'lssm_sigil',\n *   description: 'A user of the platform.',\n *   fields: {\n *     id: field.id(),\n *     email: field.string({ isUnique: true, zod: z.string().email() }),\n *     name: field.string({ isOptional: true }),\n *     createdAt: field.createdAt(),\n *     updatedAt: field.updatedAt(),\n *     memberships: field.hasMany('Member'),\n *   },\n *   indexes: [{ fields: ['email'], unique: true }],\n * });\n * ```\n */\nexport function defineEntity<TFields extends Record<string, EntityField>>(\n  spec: EntitySpec<TFields>\n): EntitySpec<TFields> {\n  return spec;\n}\n\n/**\n * Helper to define an enum that can be shared across entities.\n */\nexport function defineEntityEnum(def: EntityEnumDef): EntityEnumDef {\n  return def;\n}\n\n/**\n * Field builder helpers for common field patterns.\n */\nexport const field = {\n  // ============ Scalar fields ============\n\n  /** String field */\n  string(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'String', ...opts };\n  },\n\n  /** Integer field */\n  int(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Int', ...opts };\n  },\n\n  /** Float field */\n  float(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Float', ...opts };\n  },\n\n  /** Boolean field */\n  boolean(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Boolean', ...opts };\n  },\n\n  /** DateTime field */\n  dateTime(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'DateTime', ...opts };\n  },\n\n  /** JSON field */\n  json(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Json', ...opts };\n  },\n\n  /** BigInt field */\n  bigInt(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'BigInt', ...opts };\n  },\n\n  /** Decimal field */\n  decimal(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Decimal', ...opts };\n  },\n\n  /** Bytes field */\n  bytes(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Bytes', ...opts };\n  },\n\n  // ============ Common patterns ============\n\n  /** Primary key field with cuid() default */\n  id(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'isId'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'String',\n      isId: true,\n      default: 'cuid()',\n      ...opts,\n    };\n  },\n\n  /** Primary key field with uuid() default */\n  uuid(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'isId'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'String',\n      isId: true,\n      default: 'uuid()',\n      ...opts,\n    };\n  },\n\n  /** Auto-increment integer primary key */\n  autoIncrement(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'isId'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'Int',\n      isId: true,\n      default: 'autoincrement()',\n      ...opts,\n    };\n  },\n\n  /** createdAt timestamp with now() default */\n  createdAt(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'default'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'DateTime', default: 'now()', ...opts };\n  },\n\n  /** updatedAt timestamp with @updatedAt */\n  updatedAt(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'updatedAt'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'DateTime', updatedAt: true, ...opts };\n  },\n\n  /** Email field with validation */\n  email(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'String',\n      zod: z.email(),\n      ...opts,\n    };\n  },\n\n  /** URL field with validation */\n  url(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'String',\n      zod: z.url(),\n      ...opts,\n    };\n  },\n\n  // ============ Enum fields ============\n\n  /** Enum field */\n  enum(\n    enumName: string,\n    opts?: Partial<Omit<EntityEnumField, 'kind' | 'enumName'>>\n  ): EntityEnumField {\n    return { kind: 'enum', enumName, ...opts };\n  },\n\n  /** Inline enum field with values */\n  inlineEnum(\n    enumName: string,\n    values: readonly string[],\n    opts?: Partial<Omit<EntityEnumField, 'kind' | 'enumName' | 'values'>>\n  ): EntityEnumField {\n    return { kind: 'enum', enumName, values, ...opts };\n  },\n\n  // ============ Relation fields ============\n\n  /** Has one relation (1:1 inverse side) */\n  hasOne(\n    target: string,\n    opts?: Partial<Omit<EntityRelationField, 'kind' | 'type' | 'target'>>\n  ): EntityRelationField {\n    return { kind: 'relation', type: 'hasOne', target, ...opts };\n  },\n\n  /** Has many relation (1:N inverse side) */\n  hasMany(\n    target: string,\n    opts?: Partial<Omit<EntityRelationField, 'kind' | 'type' | 'target'>>\n  ): EntityRelationField {\n    return { kind: 'relation', type: 'hasMany', target, ...opts };\n  },\n\n  /** Belongs to relation (N:1 owning side with foreign key) */\n  belongsTo(\n    target: string,\n    fields: string[],\n    references: string[],\n    opts?: Partial<\n      Omit<\n        EntityRelationField,\n        'kind' | 'type' | 'target' | 'fields' | 'references'\n      >\n    >\n  ): EntityRelationField {\n    return {\n      kind: 'relation',\n      type: 'belongsTo',\n      target,\n      fields,\n      references,\n      ...opts,\n    };\n  },\n\n  /** Foreign key field (string) - use with belongsTo */\n  foreignKey(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'String', ...opts };\n  },\n};\n\n/**\n * Index builder helpers.\n */\nexport const index = {\n  /** Create a regular index */\n  on(\n    fields: string[],\n    opts?: Partial<Omit<EntityIndex, 'fields'>>\n  ): EntityIndex {\n    return { fields, ...opts };\n  },\n\n  /** Create a unique constraint index */\n  unique(\n    fields: string[],\n    opts?: Partial<Omit<EntityIndex, 'fields' | 'unique'>>\n  ): EntityIndex {\n    return { fields, unique: true, ...opts };\n  },\n\n  /** Create a compound index with sort orders */\n  compound(\n    fields: string[],\n    sort: Record<string, 'Asc' | 'Desc'>,\n    opts?: Partial<Omit<EntityIndex, 'fields' | 'sort'>>\n  ): EntityIndex {\n    return { fields, sort, ...opts };\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,aACd,MACqB;AACrB,QAAO;;;;;AAMT,SAAgB,iBAAiB,KAAmC;AAClE,QAAO;;;;;AAMT,MAAa,QAAQ;CAInB,OACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAU,GAAG;GAAM;;CAIpD,IACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAO,GAAG;GAAM;;CAIjD,MACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAS,GAAG;GAAM;;CAInD,QACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAW,GAAG;GAAM;;CAIrD,SACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAY,GAAG;GAAM;;CAItD,KACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAQ,GAAG;GAAM;;CAIlD,OACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAU,GAAG;GAAM;;CAIpD,QACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAW,GAAG;GAAM;;CAIrD,MACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAS,GAAG;GAAM;;CAMnD,GACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,MAAM;GACN,SAAS;GACT,GAAG;GACJ;;CAIH,KACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,MAAM;GACN,SAAS;GACT,GAAG;GACJ;;CAIH,cACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,MAAM;GACN,SAAS;GACT,GAAG;GACJ;;CAIH,UACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAY,SAAS;GAAS,GAAG;GAAM;;CAIxE,UACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAY,WAAW;GAAM,GAAG;GAAM;;CAIvE,MACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,KAAK,EAAE,OAAO;GACd,GAAG;GACJ;;CAIH,IACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,KAAK,EAAE,KAAK;GACZ,GAAG;GACJ;;CAMH,KACE,UACA,MACiB;AACjB,SAAO;GAAE,MAAM;GAAQ;GAAU,GAAG;GAAM;;CAI5C,WACE,UACA,QACA,MACiB;AACjB,SAAO;GAAE,MAAM;GAAQ;GAAU;GAAQ,GAAG;GAAM;;CAMpD,OACE,QACA,MACqB;AACrB,SAAO;GAAE,MAAM;GAAY,MAAM;GAAU;GAAQ,GAAG;GAAM;;CAI9D,QACE,QACA,MACqB;AACrB,SAAO;GAAE,MAAM;GAAY,MAAM;GAAW;GAAQ,GAAG;GAAM;;CAI/D,UACE,QACA,QACA,YACA,MAMqB;AACrB,SAAO;GACL,MAAM;GACN,MAAM;GACN;GACA;GACA;GACA,GAAG;GACJ;;CAIH,WACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAU,GAAG;GAAM;;CAErD;;;;AAKD,MAAa,QAAQ;CAEnB,GACE,QACA,MACa;AACb,SAAO;GAAE;GAAQ,GAAG;GAAM;;CAI5B,OACE,QACA,MACa;AACb,SAAO;GAAE;GAAQ,QAAQ;GAAM,GAAG;GAAM;;CAI1C,SACE,QACA,MACA,MACa;AACb,SAAO;GAAE;GAAQ;GAAM,GAAG;GAAM;;CAEnC"}