alepha 0.20.2 → 0.20.4

package/dist/orm/core/index.d.ts

@@ -1,5 +1,5 @@
 import * as _$alepha from "alepha";
-import { Alepha, AlephaError, KIND, Middleware, 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, pageQuerySchema, pageSchema } from "alepha";
+import { Alepha, AlephaError, KIND, Middleware, Page, Page as Page$1, PageQuery, PageQuery as PageQuery$1, Primitive, SchemaValidator, Service, Static, StaticEncode, TBigInt, TInteger, TNull, TNumber, TNumberOptions, TObject, TObjectOptions, TOptional, TPage, TSchema, TString, TStringOptions, TUnion, pageQuerySchema, pageSchema } from "alepha";
 import { DateTime, DateTimeProvider } from "alepha/datetime";
 import * as _$alepha_logger0 from "alepha/logger";
 import * as _$drizzle_orm0 from "drizzle-orm";
@@ -323,69 +323,6 @@ type EntityColumn<T extends TObject> = {
 };
 type EntityColumns<T extends TObject> = { [key in keyof T["properties"]]: EntityColumn<T> };
 //#endregion
-//#region ../../src/orm/core/primitives/$view.d.ts
-/**
- * Creates a database view primitive from a TypeBox schema and SQL query.
- *
- * Views are read-only: Repository blocks all write operations.
- *
- * @example
- * ```ts
- * import { t } from "alepha";
- * import { $view } from "alepha/orm";
- * import { sql } from "drizzle-orm";
- *
- * const userSummary = $view({
- *   name: "user_summary",
- *   schema: t.object({
- *     id: t.uuid(),
- *     fullName: t.text(),
- *     orderCount: t.integer(),
- *   }),
- *   query: sql`SELECT u.id, u.first_name || ' ' || u.last_name AS full_name, COUNT(o.id) AS order_count FROM users u LEFT JOIN orders o ON o.user_id = u.id GROUP BY u.id`,
- * });
- *
- * // Materialized view (PostgreSQL only)
- * const monthlyStats = $view({
- *   name: "monthly_stats",
- *   schema: t.object({ ... }),
- *   query: sql`...`,
- *   materialized: true,
- * });
- * ```
- */
-declare const $view: {
-  <TSchema extends TObject>(options: ViewPrimitiveOptions<TSchema>): ViewPrimitive<TSchema>;
-  [KIND]: typeof ViewPrimitive;
-};
-interface ViewPrimitiveOptions<T extends TObject> {
-  /**
-   * The database view name.
-   */
-  name: string;
-  /**
-   * TypeBox schema defining the view's columns.
-   */
-  schema: T;
-  /**
-   * SQL query that defines the view.
-   */
-  query: SQL;
-  /**
-   * Whether this is a materialized view (PostgreSQL only).
-   * Materialized views store results on disk and can be refreshed.
-   */
-  materialized?: boolean;
-}
-declare class ViewPrimitive<T extends TObject = TObject> {
-  readonly options: ViewPrimitiveOptions<T>;
-  readonly isView = true;
-  constructor(options: ViewPrimitiveOptions<T>);
-  get name(): string;
-  get schema(): T;
-  get materialized(): boolean;
-}
-//#endregion
 //#region ../../src/orm/core/services/ModelBuilder.d.ts
 /**
  * Database-specific table configuration functions
@@ -421,13 +358,6 @@ declare abstract class ModelBuilder {
     schemas: Map<string, unknown>;
     schema: string;
   }): void;
-  /**
-   * Build a view from a view primitive.
-   */
-  abstract buildView(view: ViewPrimitive, options: {
-    tables: Map<string, unknown>;
-    schema: string;
-  }): void;
   /**
    * Build a sequence from a sequence primitive.
    */
@@ -5450,7 +5380,6 @@ declare abstract class DatabaseProvider {
   protected parseOperation(sql: string): string;
   table<T extends TObject>(entity: EntityPrimitive<T>): PgTableWithColumns<SchemaToTableConfig<T>>;
   registerEntity(entity: EntityPrimitive): void;
-  registerView(view: ViewPrimitive): void;
   registerSequence(sequence: SequencePrimitive): void;
   /**
    * Rebuild all models into fresh maps using a different schema.
@@ -5535,10 +5464,6 @@ declare class SqliteModelBuilder extends ModelBuilder {
     schemas: Map<string, unknown>;
     schema: string;
   }): void;
-  buildView(view: ViewPrimitive, options: {
-    tables: Map<string, unknown>;
-    schema: string;
-  }): void;
   buildSequence(sequence: SequencePrimitive, options: {
     sequences: Map<string, unknown>;
     schema: string;
@@ -5588,10 +5513,10 @@ declare class SqliteModelBuilder extends ModelBuilder {
     name: string;
     dataType: "custom";
     columnType: "SQLiteCustomColumn";
-    data: _$typebox.StaticRecord<[], "Decode", {}, {}, string, TSchema>;
+    data: Record<string, unknown>;
     driverParam: string;
     enumValues: undefined;
-  }>, _$typebox.StaticRecord<[], "Decode", {}, {}, string, TSchema>> | _$drizzle_orm0.$Type<pg.SQLiteCustomColumnBuilder<{
+  }>, Record<string, unknown>> | _$drizzle_orm0.$Type<pg.SQLiteCustomColumnBuilder<{
     name: string;
     dataType: "custom";
     columnType: "SQLiteCustomColumn";
@@ -5971,6 +5896,39 @@ declare class DbTableNotFoundError extends DbError {
   static fromDatabaseError(error: Error): DbTableNotFoundError;
 }
 //#endregion
+//#region ../../src/orm/core/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[];
+/**
+ * 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;
+}
+//#endregion
 //#region ../../src/orm/core/interfaces/FilterOperators.d.ts
 interface FilterOperators<TValue> {
   /**
@@ -6517,106 +6475,6 @@ type PgQueryWhereConditions<T extends TObject, Relations extends PgRelationMap<T
 };
 type PgQueryWhereRelations<Relations extends PgRelationMap<TObject> | undefined = undefined> = Relations extends PgRelationMap<TObject> ? { [K in keyof Relations]?: PgQueryWhere<Relations[K]["join"]["schema"], Relations[K]["with"]> } : {};
 //#endregion
-//#region ../../src/orm/core/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/core/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[];
-/**
- * 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;
-}
-//#endregion
 //#region ../../src/orm/core/interfaces/AggregateQuery.d.ts
 type AggregateOp = "count" | "sum" | "avg" | "min" | "max";
 /**
@@ -6897,6 +6755,7 @@ interface PgJoin {
 //#endregion
 //#region ../../src/orm/core/services/PgRelationManager.d.ts
 declare class PgRelationManager {
+  protected readonly schemaValidator: SchemaValidator;
   /**
    * Recursively build joins for the query builder based on the relations map
    */
@@ -6947,10 +6806,6 @@ declare abstract class Repository<T extends TObject> {
    * Get SQL table name. (from Drizzle table object)
    */
   get tableName(): string;
-  /**
-   * Whether this repository is backed by a view (read-only).
-   */
-  get isReadOnly(): boolean;
   /**
    * Getter for the database connection from the database provider.
    *
@@ -7225,14 +7080,6 @@ declare abstract class Repository<T extends TObject> {
    * Clean a row with joins recursively
    */
   protected cleanWithJoins<T extends TObject>(row: Record<string, unknown>, schema: T, joins: PgJoin[], parentPath?: string): Static<T>;
-  /**
-   * Throw if this repository is read-only (backed by a view).
-   */
-  protected assertWritable(): void;
-  /**
-   * Refresh a materialized view. PostgreSQL only.
-   */
-  refresh(): Promise<void>;
   /**
    * Build a cache key from method name and query parameters.
    */
@@ -7310,9 +7157,9 @@ type WithSQL<T> = { [P in keyof T]?: T[P] | SQL };
 //#endregion
 //#region ../../src/orm/core/primitives/$repository.d.ts
 /**
- * Get the repository for the given entity or view.
+ * Get the repository for the given entity.
  */
-declare const $repository: <T extends TObject>(entity: EntityPrimitive<T> | ViewPrimitive<T>) => Repository<T>;
+declare const $repository: <T extends TObject>(entity: EntityPrimitive<T>) => Repository<T>;
 //#endregion
 //#region ../../src/orm/core/primitives/$seed.d.ts
 interface SeedOptions {
@@ -7586,7 +7433,7 @@ declare class BunSqliteProvider extends DatabaseProvider {
   protected executeMigrations(migrationsFolder: string): Promise<void>;
 }
 declare namespace index_d_exports {
-  export { $entity, $repository, $seed, $sequence, $transactional, $view, AggregateColumnResult, AggregateColumnSelect, AggregateHaving, AggregateOp, AggregateQuery, AggregateResult, AggregateSelect, AlephaOrm, BunSqliteProvider, BunSqliteProviderOptions, CloudflareD1Provider, D1Database$1 as D1Database, D1ExecResult, D1PreparedStatement, D1Result, DatabaseProvider, DatabaseTypeProvider, DbCacheProvider, DbColumnNotFoundError, DbConflictError, DbConnectionError, DbDeadlockError, DbEntityNotFoundError, DbError, DbForeignKeyError, DbMigrationError, DbMigrationMode, DbNotNullError, DbTableNotFoundError, DbVersionMismatchError, DrizzleKitProvider, EntityColumn, EntityColumns, EntityPrimitive, EntityPrimitiveOptions, FilterOperators, FromSchema, ModelBuilder, NodeSqliteProvider, NodeSqliteProviderOptions, OrderBy, OrderByClause, OrderDirection, PG_CREATED_AT, PG_DEFAULT, PG_DELETED_AT, PG_ENUM, PG_GENERATED, PG_IDENTITY, PG_ORGANIZATION, PG_PRIMARY_KEY, PG_REF, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, Page, PageQuery, PgAttr, PgAttrField, PgDefault, PgEnumOptions, PgGeneratedOptions, PgIdentityOptions, PgPrimaryKey, PgQuery, PgQueryRelations, PgQueryWhere, PgQueryWhereOrSQL, PgRef, PgRefOptions, PgRelation, PgRelationMap, PgStatic, PgSymbolKeys, PgSymbols, Repository, RepositoryProvider, SQLLike, SchemaToTableConfig, SeedOptions, SequencePrimitive, SequencePrimitiveOptions, SqliteProvider, StatementOptions, TObjectInsert, TObjectUpdate, TableConfigBuilders, TransactionalOptions, ViewPrimitive, ViewPrimitiveOptions, buildQueryString, bunSqliteOptions, databaseEnvSchema, db, _$drizzle_orm0 as drizzle, getAttrFields, insertSchema, legacyIdSchema, nodeSqliteOptions, pageQuerySchema, pageSchema, parseQueryString, pgAttr, schema, sql, updateSchema };
+  export { $entity, $repository, $seed, $sequence, $transactional, AggregateColumnResult, AggregateColumnSelect, AggregateHaving, AggregateOp, AggregateQuery, AggregateResult, AggregateSelect, AlephaOrm, BunSqliteProvider, BunSqliteProviderOptions, CloudflareD1Provider, D1Database$1 as D1Database, D1ExecResult, D1PreparedStatement, D1Result, DatabaseProvider, DatabaseTypeProvider, DbCacheProvider, DbColumnNotFoundError, DbConflictError, DbConnectionError, DbDeadlockError, DbEntityNotFoundError, DbError, DbForeignKeyError, DbMigrationError, DbMigrationMode, DbNotNullError, DbTableNotFoundError, DbVersionMismatchError, DrizzleKitProvider, EntityColumn, EntityColumns, EntityPrimitive, EntityPrimitiveOptions, FilterOperators, FromSchema, ModelBuilder, NodeSqliteProvider, NodeSqliteProviderOptions, OrderBy, OrderByClause, OrderDirection, PG_CREATED_AT, PG_DEFAULT, PG_DELETED_AT, PG_ENUM, PG_GENERATED, PG_IDENTITY, PG_ORGANIZATION, PG_PRIMARY_KEY, PG_REF, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, Page, PageQuery, PgAttr, PgAttrField, PgDefault, PgEnumOptions, PgGeneratedOptions, PgIdentityOptions, PgPrimaryKey, PgQuery, PgQueryRelations, PgQueryWhere, PgQueryWhereOrSQL, PgRef, PgRefOptions, PgRelation, PgRelationMap, PgStatic, PgSymbolKeys, PgSymbols, Repository, RepositoryProvider, SQLLike, SchemaToTableConfig, SeedOptions, SequencePrimitive, SequencePrimitiveOptions, SqliteProvider, StatementOptions, TObjectInsert, TObjectUpdate, TableConfigBuilders, TransactionalOptions, bunSqliteOptions, databaseEnvSchema, db, _$drizzle_orm0 as drizzle, getAttrFields, insertSchema, legacyIdSchema, nodeSqliteOptions, pageQuerySchema, pageSchema, pgAttr, schema, sql, updateSchema };
 }
 declare module "alepha" {
   interface State {
@@ -7660,5 +7507,5 @@ declare module "alepha" {
 declare const SqliteProvider: typeof NodeSqliteProvider;
 declare const AlephaOrm: _$alepha.Service<_$alepha.Module>;
 //#endregion
-export { $entity, $repository, $seed, $sequence, $transactional, $view, AggregateColumnResult, AggregateColumnSelect, AggregateHaving, AggregateOp, AggregateQuery, AggregateResult, AggregateSelect, AlephaOrm, BunSqliteProvider, BunSqliteProviderOptions, CloudflareD1Provider, D1Database$1 as D1Database, D1ExecResult, D1PreparedStatement, D1Result, DatabaseProvider, DatabaseTypeProvider, DbCacheProvider, DbColumnNotFoundError, DbConflictError, DbConnectionError, DbDeadlockError, DbEntityNotFoundError, DbError, DbForeignKeyError, DbMigrationError, DbMigrationMode, DbNotNullError, DbTableNotFoundError, DbVersionMismatchError, DrizzleKitProvider, EntityColumn, EntityColumns, EntityPrimitive, EntityPrimitiveOptions, FilterOperators, FromSchema, ModelBuilder, NodeSqliteProvider, NodeSqliteProviderOptions, OrderBy, OrderByClause, OrderDirection, PG_CREATED_AT, PG_DEFAULT, PG_DELETED_AT, PG_ENUM, PG_GENERATED, PG_IDENTITY, PG_ORGANIZATION, PG_PRIMARY_KEY, PG_REF, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, type Page, type PageQuery, PgAttr, PgAttrField, PgDefault, PgEnumOptions, PgGeneratedOptions, PgIdentityOptions, PgPrimaryKey, PgQuery, PgQueryRelations, PgQueryWhere, PgQueryWhereOrSQL, PgRef, PgRefOptions, PgRelation, PgRelationMap, PgStatic, PgSymbolKeys, PgSymbols, Repository, RepositoryProvider, SQLLike, SchemaToTableConfig, SeedOptions, SequencePrimitive, SequencePrimitiveOptions, SqliteProvider, StatementOptions, TObjectInsert, TObjectUpdate, TableConfigBuilders, TransactionalOptions, ViewPrimitive, ViewPrimitiveOptions, buildQueryString, bunSqliteOptions, databaseEnvSchema, db, _$drizzle_orm0 as drizzle, getAttrFields, insertSchema, legacyIdSchema, nodeSqliteOptions, pageQuerySchema, pageSchema, parseQueryString, pgAttr, schema, sql, updateSchema };
+export { $entity, $repository, $seed, $sequence, $transactional, AggregateColumnResult, AggregateColumnSelect, AggregateHaving, AggregateOp, AggregateQuery, AggregateResult, AggregateSelect, AlephaOrm, BunSqliteProvider, BunSqliteProviderOptions, CloudflareD1Provider, D1Database$1 as D1Database, D1ExecResult, D1PreparedStatement, D1Result, DatabaseProvider, DatabaseTypeProvider, DbCacheProvider, DbColumnNotFoundError, DbConflictError, DbConnectionError, DbDeadlockError, DbEntityNotFoundError, DbError, DbForeignKeyError, DbMigrationError, DbMigrationMode, DbNotNullError, DbTableNotFoundError, DbVersionMismatchError, DrizzleKitProvider, EntityColumn, EntityColumns, EntityPrimitive, EntityPrimitiveOptions, FilterOperators, FromSchema, ModelBuilder, NodeSqliteProvider, NodeSqliteProviderOptions, OrderBy, OrderByClause, OrderDirection, PG_CREATED_AT, PG_DEFAULT, PG_DELETED_AT, PG_ENUM, PG_GENERATED, PG_IDENTITY, PG_ORGANIZATION, PG_PRIMARY_KEY, PG_REF, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, type Page, type PageQuery, PgAttr, PgAttrField, PgDefault, PgEnumOptions, PgGeneratedOptions, PgIdentityOptions, PgPrimaryKey, PgQuery, PgQueryRelations, PgQueryWhere, PgQueryWhereOrSQL, PgRef, PgRefOptions, PgRelation, PgRelationMap, PgStatic, PgSymbolKeys, PgSymbols, Repository, RepositoryProvider, SQLLike, SchemaToTableConfig, SeedOptions, SequencePrimitive, SequencePrimitiveOptions, SqliteProvider, StatementOptions, TObjectInsert, TObjectUpdate, TableConfigBuilders, TransactionalOptions, bunSqliteOptions, databaseEnvSchema, db, _$drizzle_orm0 as drizzle, getAttrFields, insertSchema, legacyIdSchema, nodeSqliteOptions, pageQuerySchema, pageSchema, pgAttr, schema, sql, updateSchema };
 //# sourceMappingURL=index.d.ts.map