alepha 0.13.1 → 0.13.2

package/dist/orm/index.d.ts

@@ -1,5 +1,5 @@
 import * as alepha1 from "alepha";
-import { Alepha, AlephaError, Descriptor, KIND, Page, Page as Page$1, PageQuery, PageQuery as PageQuery$1, Service, Static, StaticEncode, TBigInt, TInteger, TNull, TNumber, TNumberOptions, TObject, TObjectOptions, TOptional, TPage, TSchema, TString, TStringOptions, TUnion, TUnsafe, pageQuerySchema, pageSchema } from "alepha";
+import { Alepha, AlephaError, KIND, Page, Page as Page$1, PageQuery, PageQuery as PageQuery$1, Primitive, Service, Static, StaticEncode, TBigInt, TInteger, TNull, TNumber, TNumberOptions, TObject, TObjectOptions, TOptional, TPage, TSchema, TString, TStringOptions, TUnion, TUnsafe, pageQuerySchema, pageSchema } from "alepha";
 import { DateTime, DateTimeProvider } from "alepha/datetime";
 import * as drizzle_orm0 from "drizzle-orm";
 import { BuildColumns, BuildExtraConfigColumns, SQL, SQLWrapper, sql } from "drizzle-orm";
@@ -48,9 +48,9 @@ declare const insertSchema: <T extends TObject>(obj: T) => TObjectInsert<T>;
 type TObjectUpdate<T extends TObject> = TObject<{ [K in keyof T["properties"]]: T["properties"][K] extends TOptional<infer U> ? TOptional<TUnion<[U, TNull]>> : T["properties"][K] }>;
 declare const updateSchema: <T extends TObject>(schema: T) => TObjectUpdate<T>;
 //#endregion
-//#region src/orm/descriptors/$entity.d.ts
+//#region src/orm/primitives/$entity.d.ts
 /**
- * Creates a database entity descriptor that defines table structure using TypeBox schemas.
+ * Creates a database entity primitive that defines table structure using TypeBox schemas.
  *
  * @example
  * ```ts
@@ -68,10 +68,10 @@ declare const updateSchema: <T extends TObject>(schema: T) => TObjectUpdate<T>;
  * ```
  */
 declare const $entity: {
-  <TSchema$1 extends TObject>(options: EntityDescriptorOptions<TSchema$1>): EntityDescriptor<TSchema$1>;
-  [KIND]: typeof EntityDescriptor;
+  <TSchema$1 extends TObject>(options: EntityPrimitiveOptions<TSchema$1>): EntityPrimitive<TSchema$1>;
+  [KIND]: typeof EntityPrimitive;
 };
-interface EntityDescriptorOptions<T extends TObject, Keys = keyof Static<T>> {
+interface EntityPrimitiveOptions<T extends TObject, Keys = keyof Static<T>> {
   /**
    * The database table name that will be created for this entity.
    * If not provided, name will be inferred from the $repository variable name.
@@ -183,9 +183,9 @@ interface EntityDescriptorOptions<T extends TObject, Keys = keyof Static<T>> {
    */
   config?: (self: BuildExtraConfigColumns<string, FromSchema<T>, "pg">) => PgTableExtraConfigValue[];
 }
-declare class EntityDescriptor<T extends TObject = TObject> {
-  readonly options: EntityDescriptorOptions<T>;
-  constructor(options: EntityDescriptorOptions<T>);
+declare class EntityPrimitive<T extends TObject = TObject> {
+  readonly options: EntityPrimitiveOptions<T>;
+  constructor(options: EntityPrimitiveOptions<T>);
   alias(alias: string): this;
   get cols(): EntityColumns<T>;
   get name(): string;
@@ -205,7 +205,7 @@ type SchemaToTableConfig<T extends TObject> = {
 };
 type EntityColumn<T extends TObject> = {
   name: string;
-  entity: EntityDescriptor<T>;
+  entity: EntityPrimitive<T>;
 };
 type EntityColumns<T extends TObject> = { [key in keyof T["properties"]]: EntityColumn<T> };
 //#endregion
@@ -254,7 +254,7 @@ interface PgEnumOptions {
 interface PgRefOptions {
   ref: () => {
     name: string;
-    entity: EntityDescriptor;
+    entity: EntityPrimitive;
   };
   actions?: {
     onUpdate?: UpdateDeleteAction;
@@ -268,37 +268,34 @@ declare class DbError extends AlephaError {
   constructor(message: string, cause?: unknown);
 }
 //#endregion
-//#region src/orm/helpers/pgAttr.d.ts
-/**
- * Decorates a typebox schema with a Postgres attribute.
- *
- * > It's just a fancy way to add Symbols to a field.
- *
- * @example
- * ```ts
- * import { t } from "alepha";
- * import { PG_UPDATED_AT } from "../constants/PG_SYMBOLS";
- *
- * export const updatedAtSchema = pgAttr(
- *   t.datetime(), PG_UPDATED_AT,
- * );
- * ```
- */
-declare const pgAttr: <T extends TSchema, Attr extends PgSymbolKeys>(type: T, attr: Attr, value?: PgSymbols[Attr]) => PgAttr<T, Attr>;
-/**
- * Retrieves the fields of a schema that have a specific attribute.
- */
-declare const getAttrFields: (schema: TObject, name: PgSymbolKeys) => PgAttrField[];
+//#region src/orm/errors/DbConflictError.d.ts
+declare class DbConflictError extends DbError {
+  readonly name = "DbConflictError";
+  readonly status = 409;
+}
+//#endregion
+//#region src/orm/errors/DbEntityNotFoundError.d.ts
+declare class DbEntityNotFoundError extends DbError {
+  readonly name = "DbEntityNotFoundError";
+  readonly status = 404;
+  constructor(entityName: string);
+}
+//#endregion
+//#region src/orm/errors/DbMigrationError.d.ts
+declare class DbMigrationError extends DbError {
+  readonly name = "DbMigrationError";
+  constructor(cause?: unknown);
+}
+//#endregion
+//#region src/orm/errors/DbVersionMismatchError.d.ts
 /**
- * Type representation.
+ * Error thrown when there is a version mismatch.
+ * It's thrown by {@link Repository#save} when the updated entity version does not match the one in the database.
+ * This is used for optimistic concurrency control.
  */
-type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & { [K in TAttr]: PgSymbols[K] };
-interface PgAttrField {
-  key: string;
-  type: TSchema;
-  data: any;
-  nested?: any[];
-  one?: boolean;
+declare class DbVersionMismatchError extends DbError {
+  readonly name = "DbVersionMismatchError";
+  constructor(table: string, id: any);
 }
 //#endregion
 //#region src/orm/interfaces/FilterOperators.d.ts
@@ -717,6 +714,55 @@ interface FilterOperators<TValue> {
   arrayOverlaps?: TValue;
 }
 //#endregion
+//#region src/orm/interfaces/PgQuery.d.ts
+/**
+ * Order direction for sorting
+ */
+type OrderDirection = "asc" | "desc";
+/**
+ * Single order by clause with column and direction
+ */
+interface OrderByClause<T> {
+  column: keyof T;
+  direction?: OrderDirection;
+}
+/**
+ * Order by parameter - supports 3 modes:
+ * 1. String: orderBy: "name" (defaults to ASC)
+ * 2. Single object: orderBy: { column: "name", direction: "desc" }
+ * 3. Array: orderBy: [{ column: "name", direction: "asc" }, { column: "age", direction: "desc" }]
+ */
+type OrderBy<T> = keyof T | OrderByClause<T> | Array<OrderByClause<T>>;
+/**
+ * Generic query interface for PostgreSQL entities
+ */
+interface PgQuery<T extends TObject = TObject> {
+  distinct?: (keyof Static<T>)[];
+  columns?: (keyof Static<T>)[];
+  where?: PgQueryWhereOrSQL<T>;
+  limit?: number;
+  offset?: number;
+  orderBy?: OrderBy<Static<T>>;
+  groupBy?: (keyof Static<T>)[];
+}
+type PgStatic<T extends TObject, Relations extends PgRelationMap<T>> = Static<T> & { [K in keyof Relations]: Static<Relations[K]["join"]["schema"]> & (Relations[K]["with"] extends PgRelationMap<TObject> ? PgStatic<Relations[K]["join"]["schema"], Relations[K]["with"]> : {}) };
+interface PgQueryRelations<T extends TObject = TObject, Relations extends PgRelationMap<T> | undefined = undefined> extends PgQuery<T> {
+  with?: Relations;
+  where?: PgQueryWhereOrSQL<T, Relations>;
+}
+type PgRelationMap<Base extends TObject> = Record<string, PgRelation<Base>>;
+type PgRelation<Base extends TObject> = {
+  type?: "left" | "inner" | "right";
+  join: {
+    schema: TObject;
+    name: string;
+  };
+  on: SQLWrapper | [keyof Static<Base>, {
+    name: string;
+  }];
+  with?: PgRelationMap<TObject>;
+};
+//#endregion
 //#region src/orm/interfaces/PgQueryWhere.d.ts
 type PgQueryWhere<T extends TObject, Relations extends PgRelationMap<TObject> | undefined = undefined> = (PgQueryWhereOperators<T> & PgQueryWhereConditions<T>) | (PgQueryWhereRelations<Relations> & PgQueryWhereOperators<T> & PgQueryWhereConditions<T, Relations>);
 type PgQueryWhereOrSQL<T extends TObject, Relations extends PgRelationMap<TObject> | undefined = undefined> = SQLWrapper | PgQueryWhere<T, Relations>;
@@ -796,71 +842,122 @@ type PgQueryWhereRelations<Relations extends PgRelationMap<TObject> | undefined
  */
 type NestedJsonbQuery<T> = T extends object ? T extends Array<infer U> ? U extends object ? { [K in keyof U]?: FilterOperators<U[K]> | U[K] } : FilterOperators<U> | U : { [K in keyof T]?: FilterOperators<T[K]> | T[K] | (T[K] extends object ? NestedJsonbQuery<T[K]> : never) } : FilterOperators<T> | T;
 //#endregion
-//#region src/orm/interfaces/PgQuery.d.ts
+//#region src/orm/helpers/parseQueryString.d.ts
 /**
- * Order direction for sorting
+ * Parse a string query into a PgQueryWhere object.
+ *
+ * Supported syntax:
+ * - Simple equality: "name=John"
+ * - Wildcard patterns: "name=John*" (startsWith), "name=*John" (endsWith), "name=*John*" (contains)
+ * - Operators: "age>18", "age>=18", "age<65", "age<=65", "status!=active"
+ * - NULL checks: "deletedAt=null", "email!=null"
+ * - IN arrays: "status=[pending,active]"
+ * - AND conditions: "name=John&age>18"
+ * - OR conditions: "name=John|email=john@example.com"
+ * - Nested AND/OR: "(name=John|name=Jane)&age>18"
+ * - JSONB nested: "profile.city=Paris"
+ *
+ * @example
+ * ```ts
+ * // Simple equality
+ * parseQueryString("name=John")
+ * // => { name: { eq: "John" } }
+ *
+ * // Wildcard patterns
+ * parseQueryString("name=John*")  // startsWith
+ * // => { name: { startsWith: "John" } }
+ * parseQueryString("name=*Smith")  // endsWith
+ * // => { name: { endsWith: "Smith" } }
+ * parseQueryString("name=*oh*")  // contains
+ * // => { name: { contains: "oh" } }
+ *
+ * // Multiple conditions
+ * parseQueryString("name=John&age>18")
+ * // => { and: [{ name: { eq: "John" } }, { age: { gt: 18 } }] }
+ *
+ * // OR conditions
+ * parseQueryString("status=active|status=pending")
+ * // => { or: [{ status: { eq: "active" } }, { status: { eq: "pending" } }] }
+ *
+ * // Complex nested
+ * parseQueryString("(name=John|name=Jane)&age>18&status!=archived")
+ * // => { and: [
+ * //      { or: [{ name: { eq: "John" } }, { name: { eq: "Jane" } }] },
+ * //      { age: { gt: 18 } },
+ * //      { status: { ne: "archived" } }
+ * //    ] }
+ *
+ * // JSONB nested query
+ * parseQueryString("profile.city=Paris&profile.age>25")
+ * // => { profile: { city: { eq: "Paris" }, age: { gt: 25 } } }
+ * ```
  */
-type OrderDirection = "asc" | "desc";
+declare function parseQueryString<T extends TObject>(query: string): PgQueryWhere<T>;
 /**
- * Single order by clause with column and direction
+ * Helper function to build query strings programmatically
+ *
+ * @example
+ * ```ts
+ * buildQueryString({
+ *   and: [
+ *     { name: "eq:John" },
+ *     { age: "gt:18" }
+ *   ]
+ * })
+ * // => "name=John&age>18"
+ * ```
  */
-interface OrderByClause<T> {
-  column: keyof T;
-  direction?: OrderDirection;
-}
+declare function buildQueryString(where: any): string;
+//#endregion
+//#region src/orm/helpers/pgAttr.d.ts
 /**
- * Order by parameter - supports 3 modes:
- * 1. String: orderBy: "name" (defaults to ASC)
- * 2. Single object: orderBy: { column: "name", direction: "desc" }
- * 3. Array: orderBy: [{ column: "name", direction: "asc" }, { column: "age", direction: "desc" }]
+ * Decorates a typebox schema with a Postgres attribute.
+ *
+ * > It's just a fancy way to add Symbols to a field.
+ *
+ * @example
+ * ```ts
+ * import { t } from "alepha";
+ * import { PG_UPDATED_AT } from "../constants/PG_SYMBOLS";
+ *
+ * export const updatedAtSchema = pgAttr(
+ *   t.datetime(), PG_UPDATED_AT,
+ * );
+ * ```
  */
-type OrderBy<T> = keyof T | OrderByClause<T> | Array<OrderByClause<T>>;
+declare const pgAttr: <T extends TSchema, Attr extends PgSymbolKeys>(type: T, attr: Attr, value?: PgSymbols[Attr]) => PgAttr<T, Attr>;
 /**
- * Generic query interface for PostgreSQL entities
+ * Retrieves the fields of a schema that have a specific attribute.
  */
-interface PgQuery<T extends TObject = TObject> {
-  distinct?: (keyof Static<T>)[];
-  columns?: (keyof Static<T>)[];
-  where?: PgQueryWhereOrSQL<T>;
-  limit?: number;
-  offset?: number;
-  orderBy?: OrderBy<Static<T>>;
-  groupBy?: (keyof Static<T>)[];
-}
-type PgStatic<T extends TObject, Relations extends PgRelationMap<T>> = Static<T> & { [K in keyof Relations]: Static<Relations[K]["join"]["schema"]> & (Relations[K]["with"] extends PgRelationMap<TObject> ? PgStatic<Relations[K]["join"]["schema"], Relations[K]["with"]> : {}) };
-interface PgQueryRelations<T extends TObject = TObject, Relations extends PgRelationMap<T> | undefined = undefined> extends PgQuery<T> {
-  with?: Relations;
-  where?: PgQueryWhereOrSQL<T, Relations>;
+declare const getAttrFields: (schema: TObject, name: PgSymbolKeys) => PgAttrField[];
+/**
+ * Type representation.
+ */
+type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & { [K in TAttr]: PgSymbols[K] };
+interface PgAttrField {
+  key: string;
+  type: TSchema;
+  data: any;
+  nested?: any[];
+  one?: boolean;
 }
-type PgRelationMap<Base extends TObject> = Record<string, PgRelation<Base>>;
-type PgRelation<Base extends TObject> = {
-  type?: "left" | "inner" | "right";
-  join: {
-    schema: TObject;
-    name: string;
-  };
-  on: SQLWrapper | [keyof Static<Base>, {
-    name: string;
-  }];
-  with?: PgRelationMap<TObject>;
-};
 //#endregion
-//#region src/orm/descriptors/$sequence.d.ts
+//#region src/orm/primitives/$sequence.d.ts
 /**
- * Creates a PostgreSQL sequence descriptor for generating unique numeric values.
+ * Creates a PostgreSQL sequence primitive for generating unique numeric values.
  */
 declare const $sequence: {
-  (options?: SequenceDescriptorOptions): SequenceDescriptor;
-  [KIND]: typeof SequenceDescriptor;
+  (options?: SequencePrimitiveOptions): SequencePrimitive;
+  [KIND]: typeof SequencePrimitive;
 };
-interface SequenceDescriptorOptions extends PgSequenceOptions {
+interface SequencePrimitiveOptions extends PgSequenceOptions {
   /**
    * The name of the sequence. If not provided, the property key will be used.
    */
   name?: string;
   provider?: DatabaseProvider;
 }
-declare class SequenceDescriptor extends Descriptor<SequenceDescriptorOptions> {
+declare class SequencePrimitive extends Primitive<SequencePrimitiveOptions> {
   readonly provider: DatabaseProvider;
   onInit(): void;
   get name(): string;
@@ -891,22 +988,22 @@ interface TableConfigBuilders<TConfig> {
   }) => TConfig;
 }
 /**
- * Abstract base class for transforming Alepha Descriptors (Entity, Sequence, etc...)
+ * Abstract base class for transforming Alepha Primitives (Entity, Sequence, etc...)
  * into drizzle models (tables, enums, sequences, etc...).
  */
 declare abstract class ModelBuilder {
   /**
-   * Build a table from an entity descriptor.
+   * Build a table from an entity primitive.
    */
-  abstract buildTable(entity: EntityDescriptor, options: {
+  abstract buildTable(entity: EntityPrimitive, options: {
     tables: Map<string, unknown>;
     enums: Map<string, unknown>;
     schema: string;
   }): void;
   /**
-   * Build a sequence from a sequence descriptor.
+   * Build a sequence from a sequence primitive.
    */
-  abstract buildSequence(sequence: SequenceDescriptor, options: {
+  abstract buildSequence(sequence: SequencePrimitive, options: {
     sequences: Map<string, unknown>;
     schema: string;
   }): void;
@@ -918,12 +1015,12 @@ declare abstract class ModelBuilder {
    * Build the table configuration function for any database.
    * This includes indexes, foreign keys, constraints, and custom config.
    *
-   * @param entity - The entity descriptor
+   * @param entity - The entity primitive
    * @param builders - Database-specific builder functions
    * @param tableResolver - Function to resolve entity references to table columns
    * @param customConfigHandler - Optional handler for custom config
    */
-  protected buildTableConfig<TConfig, TSelf>(entity: EntityDescriptor, builders: TableConfigBuilders<TConfig>, tableResolver?: (entityName: string) => any, customConfigHandler?: (config: any, self: TSelf) => TConfig[]): ((self: TSelf) => TConfig[]) | undefined;
+  protected buildTableConfig<TConfig, TSelf>(entity: EntityPrimitive, builders: TableConfigBuilders<TConfig>, tableResolver?: (entityName: string) => any, customConfigHandler?: (config: any, self: TSelf) => TConfig[]): ((self: TSelf) => TConfig[]) | undefined;
 }
 //#endregion
 //#region src/orm/providers/DrizzleKitProvider.d.ts
@@ -987,9 +1084,9 @@ declare abstract class DatabaseProvider {
   readonly sequences: Map<string, unknown>;
   get name(): string;
   get schema(): string;
-  table<T extends TObject>(entity: EntityDescriptor<T>): PgTableWithColumns<SchemaToTableConfig<T>>;
-  registerEntity(entity: EntityDescriptor): void;
-  registerSequence(sequence: SequenceDescriptor): void;
+  table<T extends TObject>(entity: EntityPrimitive<T>): PgTableWithColumns<SchemaToTableConfig<T>>;
+  registerEntity(entity: EntityPrimitive): void;
+  registerSequence(sequence: SequencePrimitive): void;
   abstract execute(statement: SQLLike): Promise<Record<string, unknown>[]>;
   run<T extends TObject>(statement: SQLLike, schema: T): Promise<Array<Static<T>>>;
   /**
@@ -1197,13 +1294,13 @@ declare class PgRelationManager {
 //#endregion
 //#region src/orm/services/Repository.d.ts
 declare abstract class Repository<T extends TObject> {
-  readonly entity: EntityDescriptor<T>;
+  readonly entity: EntityPrimitive<T>;
   readonly provider: DatabaseProvider;
   protected readonly relationManager: PgRelationManager;
   protected readonly queryManager: QueryManager;
   protected readonly dateTimeProvider: DateTimeProvider;
   protected readonly alepha: Alepha;
-  constructor(entity: EntityDescriptor<T>, provider?: typeof DatabaseProvider);
+  constructor(entity: EntityPrimitive<T>, provider?: typeof DatabaseProvider);
   /**
    * Represents the primary key of the table.
    * - Key is the name of the primary key column.
@@ -1469,17 +1566,17 @@ interface StatementOptions {
   now?: DateTime | string;
 }
 //#endregion
-//#region src/orm/descriptors/$repository.d.ts
+//#region src/orm/primitives/$repository.d.ts
 /**
  * Get the repository for the given entity.
  */
-declare const $repository: <T extends TObject>(entity: EntityDescriptor<T>) => Repository<T>;
+declare const $repository: <T extends TObject>(entity: EntityPrimitive<T>) => Repository<T>;
 //#endregion
-//#region src/orm/descriptors/$transaction.d.ts
+//#region src/orm/primitives/$transaction.d.ts
 /**
- * Creates a transaction descriptor for database operations requiring atomicity and consistency.
+ * Creates a transaction primitive for database operations requiring atomicity and consistency.
  *
- * This descriptor provides a convenient way to wrap database operations in PostgreSQL
+ * This primitive provides a convenient way to wrap database operations in PostgreSQL
  * transactions, ensuring ACID properties and automatic retry logic for version conflicts.
  * It integrates seamlessly with the repository pattern and provides built-in handling
  * for optimistic locking scenarios with automatic retry on version mismatches.
@@ -1491,8 +1588,8 @@ declare const $repository: <T extends TObject>(entity: EntityDescriptor<T>) => R
  * - Transactions are automatically rolled back on any unhandled error
  * - Use appropriate isolation levels based on your consistency requirements
  */
-declare const $transaction: <T extends any[], R>(opts: TransactionDescriptorOptions<T, R>) => alepha_retry0.RetryDescriptorFn<(...args: T) => Promise<R>>;
-interface TransactionDescriptorOptions<T extends any[], R> {
+declare const $transaction: <T extends any[], R>(opts: TransactionPrimitiveOptions<T, R>) => alepha_retry0.RetryPrimitiveFn<(...args: T) => Promise<R>>;
+interface TransactionPrimitiveOptions<T extends any[], R> {
   /**
    * Transaction handler function that contains all database operations to be executed atomically.
    *
@@ -1596,120 +1693,23 @@ interface TransactionDescriptorOptions<T extends any[], R> {
 }
 type TransactionContext = PgTransaction<any, any, any>;
 //#endregion
-//#region src/orm/errors/DbConflictError.d.ts
-declare class DbConflictError extends DbError {
-  readonly name = "DbConflictError";
-  readonly status = 409;
-}
-//#endregion
-//#region src/orm/errors/DbEntityNotFoundError.d.ts
-declare class DbEntityNotFoundError extends DbError {
-  readonly name = "DbEntityNotFoundError";
-  readonly status = 404;
-  constructor(entityName: string);
-}
-//#endregion
-//#region src/orm/errors/DbMigrationError.d.ts
-declare class DbMigrationError extends DbError {
-  readonly name = "DbMigrationError";
-  constructor(cause?: unknown);
-}
-//#endregion
-//#region src/orm/errors/DbVersionMismatchError.d.ts
-/**
- * Error thrown when there is a version mismatch.
- * It's thrown by {@link Repository#save} when the updated entity version does not match the one in the database.
- * This is used for optimistic concurrency control.
- */
-declare class DbVersionMismatchError extends DbError {
-  readonly name = "DbVersionMismatchError";
-  constructor(table: string, id: any);
-}
-//#endregion
-//#region src/orm/helpers/parseQueryString.d.ts
-/**
- * Parse a string query into a PgQueryWhere object.
- *
- * Supported syntax:
- * - Simple equality: "name=John"
- * - Wildcard patterns: "name=John*" (startsWith), "name=*John" (endsWith), "name=*John*" (contains)
- * - Operators: "age>18", "age>=18", "age<65", "age<=65", "status!=active"
- * - NULL checks: "deletedAt=null", "email!=null"
- * - IN arrays: "status=[pending,active]"
- * - AND conditions: "name=John&age>18"
- * - OR conditions: "name=John|email=john@example.com"
- * - Nested AND/OR: "(name=John|name=Jane)&age>18"
- * - JSONB nested: "profile.city=Paris"
- *
- * @example
- * ```ts
- * // Simple equality
- * parseQueryString("name=John")
- * // => { name: { eq: "John" } }
- *
- * // Wildcard patterns
- * parseQueryString("name=John*")  // startsWith
- * // => { name: { startsWith: "John" } }
- * parseQueryString("name=*Smith")  // endsWith
- * // => { name: { endsWith: "Smith" } }
- * parseQueryString("name=*oh*")  // contains
- * // => { name: { contains: "oh" } }
- *
- * // Multiple conditions
- * parseQueryString("name=John&age>18")
- * // => { and: [{ name: { eq: "John" } }, { age: { gt: 18 } }] }
- *
- * // OR conditions
- * parseQueryString("status=active|status=pending")
- * // => { or: [{ status: { eq: "active" } }, { status: { eq: "pending" } }] }
- *
- * // Complex nested
- * parseQueryString("(name=John|name=Jane)&age>18&status!=archived")
- * // => { and: [
- * //      { or: [{ name: { eq: "John" } }, { name: { eq: "Jane" } }] },
- * //      { age: { gt: 18 } },
- * //      { status: { ne: "archived" } }
- * //    ] }
- *
- * // JSONB nested query
- * parseQueryString("profile.city=Paris&profile.age>25")
- * // => { profile: { city: { eq: "Paris" }, age: { gt: 25 } } }
- * ```
- */
-declare function parseQueryString<T extends TObject>(query: string): PgQueryWhere<T>;
-/**
- * Helper function to build query strings programmatically
- *
- * @example
- * ```ts
- * buildQueryString({
- *   and: [
- *     { name: "eq:John" },
- *     { age: "gt:18" }
- *   ]
- * })
- * // => "name=John&age>18"
- * ```
- */
-declare function buildQueryString(where: any): string;
-//#endregion
 //#region src/orm/services/PostgresModelBuilder.d.ts
 declare class PostgresModelBuilder extends ModelBuilder {
   protected schemas: Map<string, drizzle_orm_pg_core0.PgSchema<string>>;
   protected getPgSchema(name: string): any;
-  buildTable(entity: EntityDescriptor<any>, options: {
+  buildTable(entity: EntityPrimitive<any>, options: {
     tables: Map<string, unknown>;
     enums: Map<string, unknown>;
     schema: string;
   }): void;
-  buildSequence(sequence: SequenceDescriptor, options: {
+  buildSequence(sequence: SequencePrimitive, options: {
     sequences: Map<string, unknown>;
     schema: string;
   }): void;
   /**
    * Get PostgreSQL-specific config builder for the table.
    */
-  protected getTableConfig(entity: EntityDescriptor, tables: Map<string, unknown>): ((self: BuildExtraConfigColumns<string, any, "pg">) => PgTableExtraConfigValue[]) | undefined;
+  protected getTableConfig(entity: EntityPrimitive, tables: Map<string, unknown>): ((self: BuildExtraConfigColumns<string, any, "pg">) => PgTableExtraConfigValue[]) | undefined;
   schemaToPgColumns: <T extends TObject>(tableName: string, schema: T, nsp: PgSchema, enums: Map<string, unknown>, tables: Map<string, unknown>) => FromSchema<T>;
   mapFieldToColumn: (tableName: string, fieldName: string, value: TSchema, nsp: PgSchema, enums: Map<string, any>) => any;
   /**
@@ -1779,11 +1779,11 @@ declare class NodePostgresProvider extends DatabaseProvider {
    */
   get db(): PostgresJsDatabase;
   protected executeMigrations(migrationsFolder: string): Promise<void>;
-  protected readonly onStart: alepha1.HookDescriptor<"start">;
-  protected readonly onStop: alepha1.HookDescriptor<"stop">;
+  protected readonly onStart: alepha1.HookPrimitive<"start">;
+  protected readonly onStop: alepha1.HookPrimitive<"stop">;
   connect(): Promise<void>;
   close(): Promise<void>;
-  protected migrate: alepha_lock0.LockDescriptor<() => Promise<void>>;
+  protected migrate: alepha_lock0.LockPrimitive<() => Promise<void>>;
   /**
    * Map the DATABASE_URL to postgres client options.
    */
@@ -1799,19 +1799,19 @@ declare class NodePostgresProvider extends DatabaseProvider {
 //#endregion
 //#region src/orm/services/SqliteModelBuilder.d.ts
 declare class SqliteModelBuilder extends ModelBuilder {
-  buildTable(entity: EntityDescriptor<any>, options: {
+  buildTable(entity: EntityPrimitive<any>, options: {
     tables: Map<string, unknown>;
     enums: Map<string, unknown>;
     schema: string;
   }): void;
-  buildSequence(sequence: SequenceDescriptor, options: {
+  buildSequence(sequence: SequencePrimitive, options: {
     sequences: Map<string, unknown>;
     schema: string;
   }): void;
   /**
    * Get SQLite-specific config builder for the table.
    */
-  protected getTableConfig(entity: EntityDescriptor, tables: Map<string, unknown>): ((self: BuildColumns<string, any, "sqlite">) => any) | undefined;
+  protected getTableConfig(entity: EntityPrimitive, tables: Map<string, unknown>): ((self: BuildColumns<string, any, "sqlite">) => any) | undefined;
   schemaToSqliteColumns: <T extends TObject>(tableName: string, schema: T, enums: Map<string, unknown>, tables: Map<string, unknown>) => SchemaToSqliteBuilder<T>;
   mapFieldToSqliteColumn: (tableName: string, fieldName: string, value: TSchema, enums: Map<string, any>) => pg$1.SQLiteIntegerBuilderInitial<string> | pg$1.SQLiteNumericBuilderInitial<string> | pg$1.SQLiteTextBuilderInitial<string, [string, ...string[]], number | undefined> | drizzle_orm0.$Type<pg$1.SQLiteCustomColumnBuilder<{
     name: string;
@@ -1986,7 +1986,7 @@ declare class NodeSqliteProvider extends DatabaseProvider {
   get url(): string;
   execute(query: SQLLike): Promise<Array<Record<string, unknown>>>;
   readonly db: PgDatabase<any>;
-  protected readonly onStart: alepha1.HookDescriptor<"start">;
+  protected readonly onStart: alepha1.HookPrimitive<"start">;
   protected executeMigrations(migrationsFolder: string): Promise<void>;
 }
 //#endregion
@@ -2026,9 +2026,9 @@ declare class PostgresTypeProvider {
    *
    * This is used to track the version of a row in the database.
    *
-   * You can use it for optimistic concurrency control (OCC) with {@link RepositoryDescriptor#save}.
+   * You can use it for optimistic concurrency control (OCC) with {@link RepositoryPrimitive#save}.
    *
-   * @see {@link RepositoryDescriptor#save}
+   * @see {@link RepositoryPrimitive#save}
    * @see {@link PgVersionMismatchError}
    */
   readonly version: (options?: TNumberOptions) => PgAttr<PgAttr<TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
@@ -2067,7 +2067,7 @@ declare class PostgresTypeProvider {
   }) => PgAttr<T, PgRef>;
   /**
    * Creates a page schema for a given object schema.
-   * It's used by {@link RepositoryDescriptor#paginate} method.
+   * It's used by {@link RepositoryPrimitive#paginate} method.
    */
   readonly page: <T extends TObject>(resource: T, options?: TObjectOptions) => TPage<T>;
 }
@@ -2076,10 +2076,10 @@ declare const pg: PostgresTypeProvider;
 //#region src/orm/providers/RepositoryProvider.d.ts
 declare class RepositoryProvider {
   protected readonly alepha: Alepha;
-  protected readonly registry: Map<EntityDescriptor<any>, Service<Repository<any>>>;
+  protected readonly registry: Map<EntityPrimitive<any>, Service<Repository<any>>>;
   getRepositories(provider?: DatabaseProvider): Repository<TObject<alepha1.TProperties>>[];
-  getRepository<T extends TObject>(entity: EntityDescriptor<T>): Repository<T>;
-  createClassRepository<T extends TObject>(entity: EntityDescriptor<T>): Service<Repository<T>>;
+  getRepository<T extends TObject>(entity: EntityPrimitive<T>): Repository<T>;
+  createClassRepository<T extends TObject>(entity: EntityPrimitive<T>): Service<Repository<T>>;
 }
 //#endregion
 //#region src/orm/schemas/legacyIdSchema.d.ts
@@ -2209,5 +2209,5 @@ declare module "alepha" {
  */
 declare const AlephaPostgres: alepha1.Service<alepha1.Module>;
 //#endregion
-export { $entity, $repository, $sequence, $transaction, AlephaPostgres, DatabaseProvider, DbConflictError, DbEntityNotFoundError, DbError, DbMigrationError, DbVersionMismatchError, DrizzleKitProvider, EntityColumn, EntityColumns, EntityDescriptor, EntityDescriptorOptions, FilterOperators, FromSchema, NodePostgresProvider, NodeSqliteProvider, NodeSqliteProviderOptions, OrderBy, OrderByClause, OrderDirection, PG_CREATED_AT, PG_DEFAULT, PG_DELETED_AT, PG_ENUM, PG_IDENTITY, PG_PRIMARY_KEY, PG_REF, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, type Page, type PageQuery, PgAttr, PgAttrField, PgDefault, PgEnumOptions, PgIdentityOptions, PgPrimaryKey, PgQuery, PgQueryRelations, PgQueryWhere, PgQueryWhereOrSQL, PgRef, PgRefOptions, PgRelation, PgRelationMap, PgStatic, PgSymbolKeys, PgSymbols, PostgresTypeProvider, Repository, RepositoryProvider, SQLLike, SchemaToTableConfig, SequenceDescriptor, SequenceDescriptorOptions, StatementOptions, TObjectInsert, TObjectUpdate, TransactionContext, TransactionDescriptorOptions, buildQueryString, drizzle_orm0 as drizzle, getAttrFields, insertSchema, legacyIdSchema, nodeSqliteOptions, pageQuerySchema, pageSchema, parseQueryString, pg, pgAttr, schema, sql, updateSchema };
+export { $entity, $repository, $sequence, $transaction, AlephaPostgres, DatabaseProvider, DbConflictError, DbEntityNotFoundError, DbError, DbMigrationError, DbVersionMismatchError, DrizzleKitProvider, EntityColumn, EntityColumns, EntityPrimitive, EntityPrimitiveOptions, FilterOperators, FromSchema, NodePostgresProvider, NodeSqliteProvider, NodeSqliteProviderOptions, OrderBy, OrderByClause, OrderDirection, PG_CREATED_AT, PG_DEFAULT, PG_DELETED_AT, PG_ENUM, PG_IDENTITY, PG_PRIMARY_KEY, PG_REF, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, type Page, type PageQuery, PgAttr, PgAttrField, PgDefault, PgEnumOptions, PgIdentityOptions, PgPrimaryKey, PgQuery, PgQueryRelations, PgQueryWhere, PgQueryWhereOrSQL, PgRef, PgRefOptions, PgRelation, PgRelationMap, PgStatic, PgSymbolKeys, PgSymbols, PostgresTypeProvider, Repository, RepositoryProvider, SQLLike, SchemaToTableConfig, SequencePrimitive, SequencePrimitiveOptions, StatementOptions, TObjectInsert, TObjectUpdate, TransactionContext, TransactionPrimitiveOptions, buildQueryString, drizzle_orm0 as drizzle, getAttrFields, insertSchema, legacyIdSchema, nodeSqliteOptions, pageQuerySchema, pageSchema, parseQueryString, pg, pgAttr, schema, sql, updateSchema };
 //# sourceMappingURL=index.d.ts.map