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.
 *
 * @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 }],
 * });
 * ```
 */
declare function defineEntity<TFields extends Record<string, EntityField>>(spec: EntitySpec<TFields>): EntitySpec<TFields>;
/**
 * Helper to define an enum that can be shared across entities.
 */
declare function defineEntityEnum(def: EntityEnumDef): EntityEnumDef;
/**
 * Field builder helpers for common field patterns.
 */
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.
 */
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