alepha 0.9.2 → 0.9.3

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "alepha",
-	"version": "0.9.2",
+	"version": "0.9.3",
 	"type": "module",
 	"engines": {
 		"node": ">=22.0.0"
@@ -15,50 +15,49 @@
 	"main": "./core.js",
 	"types": "./core.d.ts",
 	"dependencies": {
-		"@alepha/batch": "0.9.2",
-		"@alepha/bucket": "0.9.2",
-		"@alepha/cache": "0.9.2",
-		"@alepha/cache-redis": "0.9.2",
-		"@alepha/command": "0.9.2",
-		"@alepha/core": "0.9.2",
-		"@alepha/datetime": "0.9.2",
-		"@alepha/file": "0.9.2",
-		"@alepha/lock": "0.9.2",
-		"@alepha/lock-redis": "0.9.2",
-		"@alepha/postgres": "0.9.2",
-		"@alepha/queue": "0.9.2",
-		"@alepha/queue-redis": "0.9.2",
-		"@alepha/react": "0.9.2",
-		"@alepha/react-auth": "0.9.2",
-		"@alepha/react-form": "0.9.2",
-		"@alepha/react-head": "0.9.2",
-		"@alepha/react-i18n": "0.9.2",
-		"@alepha/redis": "0.9.2",
-		"@alepha/retry": "0.9.2",
-		"@alepha/router": "0.9.2",
-		"@alepha/scheduler": "0.9.2",
-		"@alepha/security": "0.9.2",
-		"@alepha/server": "0.9.2",
-		"@alepha/server-cache": "0.9.2",
-		"@alepha/server-compress": "0.9.2",
-		"@alepha/server-cookies": "0.9.2",
-		"@alepha/server-cors": "0.9.2",
-		"@alepha/server-health": "0.9.2",
-		"@alepha/server-helmet": "0.9.2",
-		"@alepha/server-links": "0.9.2",
-		"@alepha/server-metrics": "0.9.2",
-		"@alepha/server-multipart": "0.9.2",
-		"@alepha/server-proxy": "0.9.2",
-		"@alepha/server-security": "0.9.2",
-		"@alepha/server-static": "0.9.2",
-		"@alepha/server-swagger": "0.9.2",
-		"@alepha/testing": "0.9.2",
-		"@alepha/topic": "0.9.2",
-		"@alepha/topic-redis": "0.9.2",
-		"@alepha/vite": "0.9.2"
+		"@alepha/batch": "0.9.3",
+		"@alepha/bucket": "0.9.3",
+		"@alepha/cache": "0.9.3",
+		"@alepha/cache-redis": "0.9.3",
+		"@alepha/command": "0.9.3",
+		"@alepha/core": "0.9.3",
+		"@alepha/datetime": "0.9.3",
+		"@alepha/file": "0.9.3",
+		"@alepha/lock": "0.9.3",
+		"@alepha/lock-redis": "0.9.3",
+		"@alepha/postgres": "0.9.3",
+		"@alepha/queue": "0.9.3",
+		"@alepha/queue-redis": "0.9.3",
+		"@alepha/react": "0.9.3",
+		"@alepha/react-auth": "0.9.3",
+		"@alepha/react-form": "0.9.3",
+		"@alepha/react-head": "0.9.3",
+		"@alepha/react-i18n": "0.9.3",
+		"@alepha/redis": "0.9.3",
+		"@alepha/retry": "0.9.3",
+		"@alepha/router": "0.9.3",
+		"@alepha/scheduler": "0.9.3",
+		"@alepha/security": "0.9.3",
+		"@alepha/server": "0.9.3",
+		"@alepha/server-cache": "0.9.3",
+		"@alepha/server-compress": "0.9.3",
+		"@alepha/server-cookies": "0.9.3",
+		"@alepha/server-cors": "0.9.3",
+		"@alepha/server-health": "0.9.3",
+		"@alepha/server-helmet": "0.9.3",
+		"@alepha/server-links": "0.9.3",
+		"@alepha/server-metrics": "0.9.3",
+		"@alepha/server-multipart": "0.9.3",
+		"@alepha/server-proxy": "0.9.3",
+		"@alepha/server-security": "0.9.3",
+		"@alepha/server-static": "0.9.3",
+		"@alepha/server-swagger": "0.9.3",
+		"@alepha/topic": "0.9.3",
+		"@alepha/topic-redis": "0.9.3",
+		"@alepha/vite": "0.9.3"
 	},
 	"devDependencies": {
-		"tsdown": "^0.13.0"
+		"tsdown": "^0.13.2"
 	},
 	"scripts": {
 		"build": "node build.ts"
@@ -259,11 +258,6 @@
 			"require": "./server/swagger.cjs",
 			"types": "./server/swagger.d.ts"
 		},
-		"./testing": {
-			"import": "./testing.js",
-			"require": "./testing.cjs",
-			"types": "./testing.d.ts"
-		},
 		"./topic": {
 			"import": "./topic.js",
 			"require": "./topic.cjs",
@@ -319,7 +313,6 @@
 		"server-security",
 		"server-static",
 		"server-swagger",
-		"testing",
 		"topic",
 		"topic-redis",
 		"vite"

package/postgres.d.ts

@@ -1,29 +1,28 @@
-import * as _alepha_core24 from "alepha";
-import * as _alepha_core0$1 from "alepha";
+import * as _alepha_core13 from "alepha";
 import * as _alepha_core1 from "alepha";
+import * as _alepha_core2 from "alepha";
 import * as _alepha_core0 from "alepha";
-import { Alepha, Descriptor, KIND, Service, Static, TObject, TSchema as TSchema$1 } from "alepha";
-import * as drizzle_orm7 from "drizzle-orm";
-import * as drizzle_orm0$1 from "drizzle-orm";
+import { Alepha, AlephaError, Descriptor, KIND, Service, Static, TObject, TSchema as TSchema$1 } from "alepha";
 import * as drizzle_orm0 from "drizzle-orm";
+import * as drizzle_orm2 from "drizzle-orm";
+import * as drizzle_orm9 from "drizzle-orm";
 import * as drizzle from "drizzle-orm";
 import { BuildColumns, BuildExtraConfigColumns, SQL, SQLWrapper, TableConfig, sql } from "drizzle-orm";
 import * as pg$1 from "drizzle-orm/pg-core";
-import * as drizzle_orm_pg_core0$1 from "drizzle-orm/pg-core";
-import * as drizzle_orm_pg_core4 from "drizzle-orm/pg-core";
 import * as drizzle_orm_pg_core0 from "drizzle-orm/pg-core";
+import * as drizzle_orm_pg_core4 from "drizzle-orm/pg-core";
+import * as drizzle_orm_pg_core3 from "drizzle-orm/pg-core";
 import { AnyPgColumn, AnyPgTable, LockConfig, LockStrength, PgColumn, PgColumnBuilderBase, PgDatabase, PgInsertValue, PgSequenceOptions, PgTableExtraConfigValue, PgTableWithColumns, PgTransaction, PgTransactionConfig, TableConfig as TableConfig$1, UpdateDeleteAction } from "drizzle-orm/pg-core";
 import * as _alepha_lock0 from "alepha/lock";
 import { PostgresJsDatabase } from "drizzle-orm/postgres-js";
 import postgres from "postgres";
 import * as _alepha_retry0 from "alepha/retry";
+import * as _sinclair_typebox2 from "@sinclair/typebox";
 import * as _sinclair_typebox9 from "@sinclair/typebox";
-import * as _sinclair_typebox16 from "@sinclair/typebox";
-import * as _sinclair_typebox17 from "@sinclair/typebox";
-import * as _sinclair_typebox18 from "@sinclair/typebox";
-import * as _sinclair_typebox6 from "@sinclair/typebox";
+import * as _sinclair_typebox10 from "@sinclair/typebox";
+import * as _sinclair_typebox11 from "@sinclair/typebox";
 import * as _sinclair_typebox0 from "@sinclair/typebox";
-import { Evaluate, IntegerOptions, Kind, NumberOptions, ObjectOptions, OptionalKind, Static as Static$1, StringOptions, TAdditionalProperties, TArray, TBoolean, TInteger, TIntersect, TObject as TObject$1, TOptional, TOptionalWithFlag, TPick, TProperties, TReadonly, TRecord, TSchema as TSchema$2 } from "@sinclair/typebox";
+import { Evaluate, IntegerOptions, Kind, NumberOptions, ObjectOptions, OptionalKind, Static as Static$1, StringOptions, TAdditionalProperties, TArray, TBoolean, TInteger, TIntersect, TNumber, TObject as TObject$1, TOptional, TOptionalWithFlag, TPick, TProperties, TReadonly, TRecord, TSchema as TSchema$2, TString } from "@sinclair/typebox";
 import { PgTransactionConfig as PgTransactionConfig$1 } from "drizzle-orm/pg-core/session";
 import * as DrizzleKit from "drizzle-kit/api";
 import { MigrationConfig } from "drizzle-orm/migrator";
@@ -122,14 +121,14 @@ declare const schemaToPgColumns: <T extends TObject>(schema: T) => FromSchema<T>
  * @param value The value of the field.
  * @returns The PG column.
  */
-declare const mapFieldToColumn: (name: string, value: TSchema$1) => pg$1.PgSerialBuilderInitial<string> | pg$1.PgIntegerBuilderInitial<string> | drizzle_orm7.IsIdentity<pg$1.PgBigInt53BuilderInitial<"">, "always"> | pg$1.PgNumericBuilderInitial<string> | pg$1.PgTimestampBuilderInitial<string> | pg$1.PgUUIDBuilderInitial<string> | pg$1.PgCustomColumnBuilder<{
+declare const mapFieldToColumn: (name: string, value: TSchema$1) => pg$1.PgSerialBuilderInitial<string> | pg$1.PgIntegerBuilderInitial<string> | pg$1.PgBigInt53BuilderInitial<string> | pg$1.PgNumericBuilderInitial<string> | pg$1.PgTimestampBuilderInitial<string> | pg$1.PgUUIDBuilderInitial<string> | pg$1.PgCustomColumnBuilder<{
   name: string;
   dataType: "custom";
   columnType: "PgCustomColumn";
   data: Buffer<ArrayBufferLike>;
   driverParam: unknown;
   enumValues: undefined;
-}> | pg$1.PgTimestampStringBuilderInitial<string> | pg$1.PgDateStringBuilderInitial<string> | pg$1.PgTextBuilderInitial<string, [string, ...string[]]> | pg$1.PgBooleanBuilderInitial<string> | drizzle_orm7.$Type<pg$1.PgCustomColumnBuilder<{
+}> | pg$1.PgTimestampStringBuilderInitial<string> | pg$1.PgDateStringBuilderInitial<string> | pg$1.PgTextBuilderInitial<string, [string, ...string[]]> | pg$1.PgBooleanBuilderInitial<string> | drizzle_orm0.$Type<pg$1.PgCustomColumnBuilder<{
   name: string;
   dataType: "custom";
   columnType: "PgCustomColumn";
@@ -142,14 +141,14 @@ declare const mapFieldToColumn: (name: string, value: TSchema$1) => pg$1.PgSeria
 }>, {
   [x: string]: unknown;
   [x: number]: unknown;
-}> | drizzle_orm7.$Type<pg$1.PgCustomColumnBuilder<{
+}> | drizzle_orm0.$Type<pg$1.PgCustomColumnBuilder<{
   name: string;
   dataType: "custom";
   columnType: "PgCustomColumn";
   data: {};
   driverParam: string;
   enumValues: undefined;
-}>, {}> | drizzle_orm7.$Type<pg$1.PgCustomColumnBuilder<{
+}>, {}> | drizzle_orm0.$Type<pg$1.PgCustomColumnBuilder<{
   name: string;
   dataType: "custom";
   columnType: "PgCustomColumn";
@@ -283,7 +282,27 @@ interface TableLike<T extends TObject = TObject> {
 //#endregion
 //#region src/descriptors/$entity.d.ts
 /**
- * Creates a table descriptor for drizzle-orm.
+ * Declare a new entity in the database.
+ * This descriptor alone does not create the table, it only describes it.
+ * It must be used with `$repository` to create the table and perform operations on it.
+ *
+ * This is a convenience function to create a table with a json schema.
+ * For now, it creates a drizzle-orm table under the hood.
+ * ```ts
+ * import { $entity } from "alepha/postgres";
+ *
+ * const User = $entity({
+ *   name: "user",
+ *   schema: t.object({
+ *     id: pg.primaryKey(t.uuid()),
+ *     name: t.string(),
+ *     email: t.string(),
+ *   }),
+ *   indexes: ["email"],
+ * });
+ * ```
+ *
+ * @stability 2
  */
 declare const $entity: {
   <TTableName extends string, TSchema extends TObject$1, TColumnsMap extends FromSchema<TSchema>>(options: EntityDescriptorOptions<TTableName, TSchema>): PgTableWithColumnsAndSchema<PgTableConfig<TTableName, TSchema, TColumnsMap>, TSchema>;
@@ -321,11 +340,6 @@ interface EntityDescriptorOptions<TTableName extends string, T extends TObject$1
     unique?: boolean;
     name?: string;
   })[];
-  relations?: Record<string, {
-    type: "one" | "many";
-    table: () => any;
-    foreignColumn?: keyof Static$1<T>;
-  }>;
   foreignKeys?: Array<{
     name?: string;
     columns: Array<keyof Static$1<T>>;
@@ -365,6 +379,7 @@ type PgTableConfig<TTableName extends string, TSchema extends TObject$1, TColumn
 //#region src/helpers/nullToUndefined.d.ts
 /**
  * Replaces all null values in an object with undefined.
+ * We need this for converting all nulls from Drizzle outputs.
  *
  * @param value - The object to be processed.
  * @return A new object with all null values replaced with undefined.
@@ -860,15 +875,14 @@ declare abstract class PostgresProvider {
   abstract get schema(): string;
   abstract get dialect(): string;
   abstract execute<T extends TObject$1 = any>(query: SQLLike, schema?: T): Promise<Array<T extends TObject$1 ? Static$1<T> : any>>;
-  mapResult<T extends TObject$1 = any>(result: Array<any>, schema?: T): Array<T extends TObject$1 ? Static$1<T> : any>;
 }
 //# sourceMappingURL=PostgresProvider.d.ts.map
 //#endregion
 //#region src/schemas/pageQuerySchema.d.ts
-declare const pageQuerySchema: _sinclair_typebox9.TObject<{
-  page: _sinclair_typebox9.TOptional<_sinclair_typebox9.TNumber>;
-  size: _sinclair_typebox9.TOptional<_sinclair_typebox9.TNumber>;
-  sort: _sinclair_typebox9.TOptional<_sinclair_typebox9.TString>;
+declare const pageQuerySchema: _sinclair_typebox2.TObject<{
+  page: _sinclair_typebox2.TOptional<_sinclair_typebox2.TNumber>;
+  size: _sinclair_typebox2.TOptional<_sinclair_typebox2.TNumber>;
+  sort: _sinclair_typebox2.TOptional<_sinclair_typebox2.TString>;
 }>;
 type PageQuery = Static<typeof pageQuerySchema>;
 //# sourceMappingURL=pageQuerySchema.d.ts.map
@@ -913,7 +927,7 @@ type Page<T> = {
 //#endregion
 //#region src/descriptors/$repository.d.ts
 /**
- *
+ * @stability 3
  */
 declare const $repository: {
   <EntityTableConfig extends TableConfig, EntitySchema extends TObject$1>(optionsOrTable: RepositoryDescriptorOptions<EntityTableConfig, EntitySchema> | PgTableWithColumnsAndSchema<EntityTableConfig, EntitySchema>): RepositoryDescriptor<EntityTableConfig, EntitySchema>;
@@ -960,7 +974,7 @@ declare class RepositoryDescriptor<EntityTableConfig extends TableConfig, Entity
   /**
    * Getter for the database connection from the database provider.
    */
-  protected get db(): PgDatabase<any, Record<string, never>, drizzle_orm0$1.ExtractTablesWithRelations<Record<string, never>>>;
+  protected get db(): PgDatabase<any, Record<string, never>, drizzle_orm2.ExtractTablesWithRelations<Record<string, never>>>;
   protected organization(): PgColumn;
   /**
    * Execute a SQL query.
@@ -988,29 +1002,29 @@ declare class RepositoryDescriptor<EntityTableConfig extends TableConfig, Entity
    *
    * @returns The SELECT query builder.
    */
-  protected select(opts?: StatementOptions): drizzle_orm_pg_core0$1.PgSelectBase<string, Record<string, PgColumn<drizzle_orm0$1.ColumnBaseConfig<drizzle_orm0$1.ColumnDataType, string>, {}, {}>>, "single", Record<string, "not-null">, false, never, {
+  protected select(opts?: StatementOptions): drizzle_orm_pg_core0.PgSelectBase<string, Record<string, PgColumn<drizzle_orm2.ColumnBaseConfig<drizzle_orm2.ColumnDataType, string>, {}, {}>>, "single", Record<string, "not-null">, false, never, {
     [x: string]: unknown;
   }[], {
-    [x: string]: PgColumn<drizzle_orm0$1.ColumnBaseConfig<drizzle_orm0$1.ColumnDataType, string>, {}, {}>;
+    [x: string]: PgColumn<drizzle_orm2.ColumnBaseConfig<drizzle_orm2.ColumnDataType, string>, {}, {}>;
   }>;
   /**
    * Start an INSERT query on the table.
    *
    * @returns The INSERT query builder.
    */
-  protected insert(opts?: StatementOptions): drizzle_orm_pg_core0$1.PgInsertBuilder<PgTableWithColumns<EntityTableConfig>, any, false>;
+  protected insert(opts?: StatementOptions): drizzle_orm_pg_core0.PgInsertBuilder<PgTableWithColumns<EntityTableConfig>, any, false>;
   /**
    * Start an UPDATE query on the table.
    *
    * @returns The UPDATE query builder.
    */
-  protected update(opts?: StatementOptions): drizzle_orm_pg_core0$1.PgUpdateBuilder<PgTableWithColumns<EntityTableConfig>, any>;
+  protected update(opts?: StatementOptions): drizzle_orm_pg_core0.PgUpdateBuilder<PgTableWithColumns<EntityTableConfig>, any>;
   /**
    * Start a DELETE query on the table.
    *
    * @returns The DELETE query builder.
    */
-  protected delete(opts?: StatementOptions): drizzle_orm_pg_core0$1.PgDeleteBase<PgTableWithColumns<EntityTableConfig>, any, undefined, undefined, false, never>;
+  protected delete(opts?: StatementOptions): drizzle_orm_pg_core0.PgDeleteBase<PgTableWithColumns<EntityTableConfig>, any, undefined, undefined, false, never>;
   /**
    * Find entities.
    *
@@ -1072,7 +1086,7 @@ declare class RepositoryDescriptor<EntityTableConfig extends TableConfig, Entity
   updateOne(query: PgQueryWhere<Static$1<EntitySchema>>, data: Partial<NullifyIfOptional<Static$1<EntitySchema>>> | {
     $append: Partial<NullifyIfOptional<Static$1<EntitySchema>>>;
   }, opts?: StatementOptions): Promise<Static$1<EntitySchema>>;
-  save(data: InferInsert<EntitySchema>, opts?: StatementOptions): Promise<Static$1<EntitySchema>>;
+  save(data: Static$1<EntitySchema>, opts?: StatementOptions): Promise<Static$1<EntitySchema>>;
   /**
    * Update an entity by ID.
    *
@@ -1168,7 +1182,7 @@ declare class RepositoryDescriptor<EntityTableConfig extends TableConfig, Entity
    */
   protected getPrimaryKey(schema: TObject$1): {
     key: string;
-    col: PgColumn<drizzle_orm0$1.ColumnBaseConfig<drizzle_orm0$1.ColumnDataType, string>, {}, {}>;
+    col: PgColumn<drizzle_orm2.ColumnBaseConfig<drizzle_orm2.ColumnDataType, string>, {}, {}>;
     type: TSchema$2;
   };
 }
@@ -1205,6 +1219,9 @@ interface PgAttrField {
 //# sourceMappingURL=$repository.d.ts.map
 //#endregion
 //#region src/descriptors/$sequence.d.ts
+/**
+ * @stability 1
+ */
 declare const $sequence: {
   (options?: SequenceDescriptorOptions): SequenceDescriptor;
   [KIND]: typeof SequenceDescriptor;
@@ -1229,7 +1246,7 @@ declare class SequenceDescriptor extends Descriptor<SequenceDescriptorOptions> {
 //#endregion
 //#region src/descriptors/$transaction.d.ts
 /**
- *
+ * @stability 2
  */
 declare const $transaction: <T extends any[], R>(opts: TransactionDescriptorOptions<T, R>) => _alepha_retry0.RetryDescriptorFn<(...args: T) => Promise<R>>;
 interface TransactionDescriptorOptions<T extends any[], R> {
@@ -1239,17 +1256,17 @@ interface TransactionDescriptorOptions<T extends any[], R> {
 type TransactionContext = PgTransaction<any, any, any>;
 //# sourceMappingURL=$transaction.d.ts.map
 //#endregion
-//#region src/errors/EntityNotFoundError.d.ts
-declare class EntityNotFoundError extends Error {
-  readonly code = "ERR_RESOURCE_NOTFOUND";
+//#region src/errors/PgEntityNotFoundError.d.ts
+declare class PgEntityNotFoundError extends AlephaError {
+  readonly name = "EntityNotFoundError";
   readonly status = 404;
   constructor(entityName: string);
 }
-//# sourceMappingURL=EntityNotFoundError.d.ts.map
+//# sourceMappingURL=PgEntityNotFoundError.d.ts.map
 //#endregion
 //#region src/providers/RepositoryDescriptorProvider.d.ts
 declare class RepositoryDescriptorProvider {
-  protected readonly log: _alepha_core24.Logger;
+  protected readonly log: _alepha_core13.Logger;
   protected readonly alepha: Alepha;
   get repositories(): RepositoryDescriptor<TableConfig$1, TObject$1>[];
   constructor();
@@ -1275,10 +1292,11 @@ declare class RepositoryDescriptorProvider {
 //#endregion
 //#region src/providers/DrizzleKitProvider.d.ts
 declare class DrizzleKitProvider {
-  protected readonly log: _alepha_core0$1.Logger;
+  protected readonly log: _alepha_core1.Logger;
   protected readonly alepha: Alepha;
   protected readonly repositoryProvider: RepositoryDescriptorProvider;
   push(provider: PostgresProvider, schema?: string): Promise<void>;
+  setPgSchema(provider: PostgresProvider): Promise<void>;
   /**
    * Try to generate migrations from scratch based on the models.
    * Then, execute the migrations.
@@ -1314,81 +1332,98 @@ declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
 }
 declare const envSchema: TObject$1<{
-  PG_HOST: _alepha_core1.TOptional<_alepha_core1.TString>;
-  PG_USERNAME: _alepha_core1.TOptional<_alepha_core1.TString>;
-  PG_DATABASE: _alepha_core1.TOptional<_alepha_core1.TString>;
-  PG_PASSWORD: _alepha_core1.TOptional<_alepha_core1.TString>;
-  PG_PORT: _alepha_core1.TOptional<_alepha_core1.TNumber>;
-  DATABASE_URL: _alepha_core1.TOptional<_alepha_core1.TString>;
-  DATABASE_MIGRATIONS_FOLDER: _alepha_core1.TString;
   /**
-   * The schema to use.
-   * Accept a string.
+   * Main configuration for database connection.
+   * Accept a string in the format of a Postgres connection URL.
+   * Example: postgres://user:password@localhost:5432/database
+   * or
+   * Example: postgres://user:password@localhost:5432/database?sslmode=require
    */
-  POSTGRES_SCHEMA: _alepha_core1.TOptional<_alepha_core1.TString>;
+  DATABASE_URL: _alepha_core2.TOptional<_alepha_core2.TString>;
   /**
-   * Synchronize the database schema with the models.
-   * Accept a boolean or a postgres schema name.
+   * In addition to the DATABASE_URL, you can specify the postgres schema name.
    *
-   * @default false
+   * It will monkey patch drizzle tables.
    */
-  POSTGRES_SYNCHRONIZE: _alepha_core1.TOptional<_alepha_core1.TBoolean>;
+  POSTGRES_SCHEMA: _alepha_core2.TOptional<_alepha_core2.TString>;
   /**
-   * Push the schema to the database.
+   * Synchronize the database schema with the models.
+   * It uses a custom implementation, it's not related to `drizzle-kit push` command.
+   * It will generate the migration script and save it to the DB.
+   *
+   * This is recommended for development and testing purposes only.
    *
    * @default false
    */
-  POSTGRES_PUSH_SCHEMA: _alepha_core1.TOptional<_alepha_core1.TBoolean>;
+  POSTGRES_SYNCHRONIZE: _alepha_core2.TOptional<_alepha_core2.TBoolean>;
   /**
-   * Reject unauthorized SSL connections.
+   * Push the schema to the database.
+   * It's like `drizzle-kit push` command.
+   * It will introspect the models from DB and generate the SQL statements to create or update the tables.
    *
    * @default false
    */
-  POSTGRES_REJECT_UNAUTHORIZED: _alepha_core1.TBoolean;
+  POSTGRES_PUSH: _alepha_core2.TOptional<_alepha_core2.TBoolean>;
 }>;
-interface NodePostgresProviderState {
-  client: postgres.Sql;
-  db: PostgresJsDatabase;
+interface NodePostgresProviderOptions {
+  migrations: MigrationConfig;
+  connection: postgres.Options<any>;
 }
 declare class NodePostgresProvider extends PostgresProvider {
   readonly dialect = "postgres";
-  protected readonly log: _alepha_core1.Logger;
+  protected readonly sslModes: readonly ["require", "allow", "prefer", "verify-full"];
+  protected readonly log: _alepha_core2.Logger;
   protected readonly env: {
-    PG_HOST?: string | undefined;
-    PG_USERNAME?: string | undefined;
-    PG_DATABASE?: string | undefined;
-    PG_PASSWORD?: string | undefined;
-    PG_PORT?: number | undefined;
     DATABASE_URL?: string | undefined;
     POSTGRES_SCHEMA?: string | undefined;
     POSTGRES_SYNCHRONIZE?: boolean | undefined;
-    POSTGRES_PUSH_SCHEMA?: boolean | undefined;
-    DATABASE_MIGRATIONS_FOLDER: string;
-    POSTGRES_REJECT_UNAUTHORIZED: boolean;
+    POSTGRES_PUSH?: boolean | undefined;
   };
   protected readonly alepha: Alepha;
   protected readonly kit: DrizzleKitProvider;
-  protected state?: NodePostgresProviderState;
+  protected client?: postgres.Sql;
+  protected pg?: PostgresJsDatabase;
+  readonly options: NodePostgresProviderOptions;
   /**
    * In testing mode, the schema name will be generated and deleted after the test.
    */
-  protected testingSchemaName?: string;
-  get db(): PostgresJsDatabase;
-  protected readonly configure: _alepha_core1.HookDescriptor<"start">;
-  protected readonly stop: _alepha_core1.HookDescriptor<"stop">;
+  protected schemaForTesting?: string;
   /**
    * Get Postgres schema.
    */
   get schema(): string;
+  get db(): PostgresJsDatabase;
+  protected readonly configure: _alepha_core2.HookDescriptor<"start">;
+  protected readonly stop: _alepha_core2.HookDescriptor<"stop">;
   execute<T extends TObject$1 = any>(query: SQLLike, schema?: T): Promise<Array<T extends TObject$1 ? Static<T> : any>>;
   connect(): Promise<void>;
   close(): Promise<void>;
   protected migrate: _alepha_lock0.LockDescriptor<() => Promise<void>>;
-  protected createClient(): NodePostgresProviderState;
+  protected createClient(): {
+    client: postgres.Sql<{}>;
+    db: PostgresJsDatabase<Record<string, never>> & {
+      $client: postgres.Sql<{}>;
+    };
+  };
+  /**
+   * Generate a minimal migration configuration.
+   */
   protected getMigrationOptions(): MigrationConfig;
+  /**
+   * Map the DATABASE_URL to postgres client options.
+   */
   protected getClientOptions(): postgres.Options<any>;
-  protected sslModes: readonly ["require", "allow", "prefer", "verify-full"];
-  protected ssl(url: URL | undefined): "require" | "allow" | "prefer" | "verify-full" | undefined;
+  protected ssl(url: URL): "require" | "allow" | "prefer" | "verify-full" | undefined;
+  /**
+   * For testing purposes, generate a unique schema name.
+   * The schema name will be generated based on the current date and time.
+   * It will be in the format of `test_YYYYMMDD_HHMMSS_randomSuffix`.
+   *
+   * TODO: investigate for adding the test file name to the schema name if possible.
+   * TODO: options to skip deletion on failure, in order to inspect the schema?
+   */
+  protected generateTestSchemaName(): string;
+  protected mapResult<T extends TObject$1 = any>(result: Array<any>, schema?: T): Array<T extends TObject$1 ? Static<T> : any>;
 }
 //#endregion
 //#region src/helpers/pgAttr.d.ts
@@ -1398,7 +1433,7 @@ declare class NodePostgresProvider extends PostgresProvider {
 type PgAttr<T extends TSchema$1, TAttr extends PgSymbolKeys> = T & { [K in TAttr]: PgSymbols[K] };
 //#endregion
 //#region src/schemas/createdAtSchema.d.ts
-declare const createdAtSchema: PgAttr<PgAttr<_sinclair_typebox16.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+declare const createdAtSchema: PgAttr<PgAttr<_sinclair_typebox9.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
 //# sourceMappingURL=createdAtSchema.d.ts.map
 
 //#endregion
@@ -1406,11 +1441,11 @@ declare const createdAtSchema: PgAttr<PgAttr<_sinclair_typebox16.TString, typeof
 /**
  * @deprecated Use `pg.primaryKey()` instead.
  */
-declare const legacyIdSchema: PgAttr<PgAttr<PgAttr<_sinclair_typebox17.TInteger, typeof PG_PRIMARY_KEY>, typeof PG_SERIAL>, typeof PG_DEFAULT>;
+declare const legacyIdSchema: PgAttr<PgAttr<PgAttr<_sinclair_typebox10.TInteger, typeof PG_PRIMARY_KEY>, typeof PG_SERIAL>, typeof PG_DEFAULT>;
 //# sourceMappingURL=legacyIdSchema.d.ts.map
 //#endregion
 //#region src/schemas/updatedAtSchema.d.ts
-declare const updatedAtSchema: PgAttr<PgAttr<_sinclair_typebox18.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+declare const updatedAtSchema: PgAttr<PgAttr<_sinclair_typebox11.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
 //# sourceMappingURL=updatedAtSchema.d.ts.map
 
 //#endregion
@@ -1421,9 +1456,9 @@ declare const updatedAtSchema: PgAttr<PgAttr<_sinclair_typebox18.TString, typeof
  * Add some common SQL properties to an object.
  */
 declare const entitySchema: TObject$1<{
-  id: PgAttr<PgAttr<PgAttr<_sinclair_typebox6.TInteger, typeof PG_PRIMARY_KEY>, typeof PG_SERIAL>, typeof PG_DEFAULT>;
-  createdAt: PgAttr<PgAttr<_sinclair_typebox6.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-  updatedAt: PgAttr<PgAttr<_sinclair_typebox6.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+  id: PgAttr<PgAttr<PgAttr<_sinclair_typebox0.TInteger, typeof PG_PRIMARY_KEY>, typeof PG_SERIAL>, typeof PG_DEFAULT>;
+  createdAt: PgAttr<PgAttr<_sinclair_typebox0.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+  updatedAt: PgAttr<PgAttr<_sinclair_typebox0.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
 }>;
 /**
  * TypeBox Entity Type.
@@ -1458,19 +1493,21 @@ declare class PostgresTypeProvider {
   /**
    * Creates a primary key with an identity column.
    */
-  readonly identityPrimaryKey: (identity?: PgIdentityOptions, options?: IntegerOptions) => PgAttr<PgAttr<PgAttr<_sinclair_typebox0.TInteger, typeof PG_PRIMARY_KEY>, typeof PG_IDENTITY>, typeof PG_DEFAULT>;
+  readonly identityPrimaryKey: (identity?: PgIdentityOptions, options?: IntegerOptions) => PgAttr<PgAttr<PgAttr<TInteger, typeof PG_PRIMARY_KEY>, typeof PG_IDENTITY>, typeof PG_DEFAULT>;
   /**
    * Creates a primary key with a big identity column. (default)
    */
-  readonly bigIdentityPrimaryKey: (identity?: PgIdentityOptions, options?: NumberOptions) => PgAttr<PgAttr<PgAttr<_sinclair_typebox0.TNumber, typeof PG_PRIMARY_KEY>, typeof PG_IDENTITY>, typeof PG_DEFAULT>;
+  readonly bigIdentityPrimaryKey: (identity?: PgIdentityOptions, options?: NumberOptions) => PgAttr<PgAttr<PgAttr<TNumber, typeof PG_PRIMARY_KEY>, typeof PG_IDENTITY>, typeof PG_DEFAULT>;
   /**
    * Creates a primary key with a UUID column.
    */
-  readonly uuidPrimaryKey: () => PgAttr<PgAttr<_sinclair_typebox0.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+  readonly uuidPrimaryKey: () => PgAttr<PgAttr<TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
   /**
-   * @alias bigIdentityPrimaryKey
+   *
    */
-  readonly primaryKey: (identity?: PgIdentityOptions, options?: NumberOptions) => PgAttr<PgAttr<PgAttr<_sinclair_typebox0.TNumber, typeof PG_PRIMARY_KEY>, typeof PG_IDENTITY>, typeof PG_DEFAULT>;
+  primaryKey(type: TString): PgAttr<PgAttr<TString, PgPrimaryKey>, PgDefault>;
+  primaryKey(type: TInteger): PgAttr<PgAttr<TInteger, PgPrimaryKey>, PgDefault>;
+  primaryKey(type: TNumber): PgAttr<PgAttr<TNumber, PgPrimaryKey>, PgDefault>;
   /**
    * Wrap a schema with "default" attribute.
    * This is used to set a default value for a column in the database.
@@ -1481,15 +1518,15 @@ declare class PostgresTypeProvider {
    * This is used to track the version of a row in the database.
    * You can use it for optimistic concurrency control.
    */
-  readonly version: (options?: IntegerOptions) => PgAttr<PgAttr<_sinclair_typebox0.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+  readonly version: (options?: IntegerOptions) => PgAttr<PgAttr<TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
   /**
    * Creates a column Created At. So just a datetime column with a default value of the current timestamp.
    */
-  readonly createdAt: (options?: StringOptions) => PgAttr<PgAttr<_sinclair_typebox0.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+  readonly createdAt: (options?: StringOptions) => PgAttr<PgAttr<TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
   /**
    * Creates a column Updated At. Like createdAt, but it is updated on every update of the row.
    */
-  readonly updatedAt: (options?: StringOptions) => PgAttr<PgAttr<_sinclair_typebox0.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+  readonly updatedAt: (options?: StringOptions) => PgAttr<PgAttr<TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
   /**
    * @deprecated Build your own entity schema.
    */
@@ -1535,7 +1572,7 @@ declare const pg: PostgresTypeProvider;
 /**
  * Postgres schema type.
  */
-declare const schema: <TDocument extends TSchema$2>(name: string, document: TDocument) => drizzle_orm0.$Type<drizzle_orm_pg_core0.PgCustomColumnBuilder<{
+declare const schema: <TDocument extends TSchema$2>(name: string, document: TDocument) => drizzle_orm9.$Type<drizzle_orm_pg_core3.PgCustomColumnBuilder<{
   name: string;
   dataType: "custom";
   columnType: "PgCustomColumn";
@@ -1563,9 +1600,9 @@ declare const schema: <TDocument extends TSchema$2>(name: string, document: TDoc
  * @see {@link $transaction}
  * @module alepha.postgres
  */
-declare const AlephaPostgres: _alepha_core0.ModuleDescriptor;
+declare const AlephaPostgres: _alepha_core0.Service<_alepha_core0.Module>;
 //# sourceMappingURL=index.d.ts.map
 
 //#endregion
-export { $entity, $repository, $sequence, $transaction, AlephaPostgres, BaseEntity, BaseEntityKeys, DrizzleKitProvider, Entity, EntityDescriptorOptions, EntityNotFoundError, ExtractManyRelations, FilterOperators, FromSchema, NodePostgresProvider, NodePostgresProviderState, NullToUndefined, NullifyIfOptional, PG_CREATED_AT, PG_DEFAULT, PG_IDENTITY, PG_MANY, PG_ONE, PG_PRIMARY_KEY, PG_REF, PG_SCHEMA, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, Page, PageQuery, PgAttrField, PgDefault, PgIdentityOptions, PgMany, PgManyOptions, PgPrimaryKey, PgQuery, PgQueryResult, PgQueryWhere, PgQueryWhereWithMany, PgQueryWith, PgQueryWithMap, PgRef, PgRefOptions, PgSymbolKeys, PgSymbols, PgTableConfig, PgTableWithColumnsAndSchema, PostgresProvider, PostgresTypeProvider, RemoveManyRelations, RepositoryDescriptor, RepositoryDescriptorOptions, RepositoryDescriptorProvider, SQLLike, SequenceDescriptor, SequenceDescriptorOptions, StatementOptions, TEntity, TInsertObject, TPage, TableLike, TransactionContext, TransactionDescriptorOptions, camelToSnakeCase, drizzle, entityKeys, entitySchema, mapFieldToColumn, mapStringToColumn, nullToUndefined, pageQuerySchema, pageSchema, pg, pgTableSchema, schema, schemaToPgColumns, sql };
+export { $entity, $repository, $sequence, $transaction, AlephaPostgres, BaseEntity, BaseEntityKeys, DrizzleKitProvider, Entity, EntityDescriptorOptions, ExtractManyRelations, FilterOperators, FromSchema, NodePostgresProvider, NodePostgresProviderOptions, NullToUndefined, NullifyIfOptional, PG_CREATED_AT, PG_DEFAULT, PG_IDENTITY, PG_MANY, PG_ONE, PG_PRIMARY_KEY, PG_REF, PG_SCHEMA, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, Page, PageQuery, PgAttrField, PgDefault, PgEntityNotFoundError, PgIdentityOptions, PgMany, PgManyOptions, PgPrimaryKey, PgQuery, PgQueryResult, PgQueryWhere, PgQueryWhereWithMany, PgQueryWith, PgQueryWithMap, PgRef, PgRefOptions, PgSymbolKeys, PgSymbols, PgTableConfig, PgTableWithColumnsAndSchema, PostgresProvider, PostgresTypeProvider, RemoveManyRelations, RepositoryDescriptor, RepositoryDescriptorOptions, RepositoryDescriptorProvider, SQLLike, SequenceDescriptor, SequenceDescriptorOptions, StatementOptions, TEntity, TInsertObject, TPage, TableLike, TransactionContext, TransactionDescriptorOptions, camelToSnakeCase, drizzle, entityKeys, entitySchema, mapFieldToColumn, mapStringToColumn, nullToUndefined, pageQuerySchema, pageSchema, pg, pgTableSchema, schema, schemaToPgColumns, sql };
 //# sourceMappingURL=index.d.ts.map

package/queue/redis.d.ts

@@ -23,7 +23,7 @@ declare class RedisQueueProvider implements QueueProvider {
  * @see {@link RedisQueueProvider}
  * @module alepha.queue.redis
  */
-declare const AlephaQueueRedis: _alepha_core0.ModuleDescriptor;
+declare const AlephaQueueRedis: _alepha_core0.Service<_alepha_core0.Module>;
 //# sourceMappingURL=index.d.ts.map
 
 //#endregion