alepha 0.11.3 → 0.11.5

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "alepha",
-	"version": "0.11.3",
+	"version": "0.11.5",
 	"type": "module",
 	"engines": {
 		"node": ">=22.0.0"
@@ -15,54 +15,56 @@
 	"main": "./core.js",
 	"types": "./core.d.ts",
 	"dependencies": {
-		"@alepha/api-files": "0.11.3",
-		"@alepha/api-jobs": "0.11.3",
-		"@alepha/api-notifications": "0.11.3",
-		"@alepha/api-users": "0.11.3",
-		"@alepha/api-verifications": "0.11.3",
-		"@alepha/batch": "0.11.3",
-		"@alepha/bucket": "0.11.3",
-		"@alepha/cache": "0.11.3",
-		"@alepha/cache-redis": "0.11.3",
-		"@alepha/command": "0.11.3",
-		"@alepha/core": "0.11.3",
-		"@alepha/datetime": "0.11.3",
-		"@alepha/devtools": "0.11.3",
-		"@alepha/email": "0.11.3",
-		"@alepha/file": "0.11.3",
-		"@alepha/lock": "0.11.3",
-		"@alepha/lock-redis": "0.11.3",
-		"@alepha/logger": "0.11.3",
-		"@alepha/postgres": "0.11.3",
-		"@alepha/queue": "0.11.3",
-		"@alepha/queue-redis": "0.11.3",
-		"@alepha/react": "0.11.3",
-		"@alepha/react-auth": "0.11.3",
-		"@alepha/react-form": "0.11.3",
-		"@alepha/react-head": "0.11.3",
-		"@alepha/react-i18n": "0.11.3",
-		"@alepha/redis": "0.11.3",
-		"@alepha/retry": "0.11.3",
-		"@alepha/router": "0.11.3",
-		"@alepha/scheduler": "0.11.3",
-		"@alepha/security": "0.11.3",
-		"@alepha/server": "0.11.3",
-		"@alepha/server-cache": "0.11.3",
-		"@alepha/server-compress": "0.11.3",
-		"@alepha/server-cookies": "0.11.3",
-		"@alepha/server-cors": "0.11.3",
-		"@alepha/server-health": "0.11.3",
-		"@alepha/server-helmet": "0.11.3",
-		"@alepha/server-links": "0.11.3",
-		"@alepha/server-metrics": "0.11.3",
-		"@alepha/server-multipart": "0.11.3",
-		"@alepha/server-proxy": "0.11.3",
-		"@alepha/server-security": "0.11.3",
-		"@alepha/server-static": "0.11.3",
-		"@alepha/server-swagger": "0.11.3",
-		"@alepha/topic": "0.11.3",
-		"@alepha/topic-redis": "0.11.3",
-		"@alepha/vite": "0.11.3",
+		"@alepha/api-files": "0.11.5",
+		"@alepha/api-jobs": "0.11.5",
+		"@alepha/api-notifications": "0.11.5",
+		"@alepha/api-users": "0.11.5",
+		"@alepha/api-verifications": "0.11.5",
+		"@alepha/batch": "0.11.5",
+		"@alepha/bucket": "0.11.5",
+		"@alepha/cache": "0.11.5",
+		"@alepha/cache-redis": "0.11.5",
+		"@alepha/command": "0.11.5",
+		"@alepha/core": "0.11.5",
+		"@alepha/datetime": "0.11.5",
+		"@alepha/devtools": "0.11.5",
+		"@alepha/email": "0.11.5",
+		"@alepha/fake": "0.11.5",
+		"@alepha/file": "0.11.5",
+		"@alepha/lock": "0.11.5",
+		"@alepha/lock-redis": "0.11.5",
+		"@alepha/logger": "0.11.5",
+		"@alepha/postgres": "0.11.5",
+		"@alepha/queue": "0.11.5",
+		"@alepha/queue-redis": "0.11.5",
+		"@alepha/react": "0.11.5",
+		"@alepha/react-auth": "0.11.5",
+		"@alepha/react-form": "0.11.5",
+		"@alepha/react-head": "0.11.5",
+		"@alepha/react-i18n": "0.11.5",
+		"@alepha/redis": "0.11.5",
+		"@alepha/retry": "0.11.5",
+		"@alepha/router": "0.11.5",
+		"@alepha/scheduler": "0.11.5",
+		"@alepha/security": "0.11.5",
+		"@alepha/server": "0.11.5",
+		"@alepha/server-cache": "0.11.5",
+		"@alepha/server-compress": "0.11.5",
+		"@alepha/server-cookies": "0.11.5",
+		"@alepha/server-cors": "0.11.5",
+		"@alepha/server-health": "0.11.5",
+		"@alepha/server-helmet": "0.11.5",
+		"@alepha/server-links": "0.11.5",
+		"@alepha/server-metrics": "0.11.5",
+		"@alepha/server-multipart": "0.11.5",
+		"@alepha/server-proxy": "0.11.5",
+		"@alepha/server-security": "0.11.5",
+		"@alepha/server-static": "0.11.5",
+		"@alepha/server-swagger": "0.11.5",
+		"@alepha/topic": "0.11.5",
+		"@alepha/topic-redis": "0.11.5",
+		"@alepha/ui": "0.11.5",
+		"@alepha/vite": "0.11.5",
 		"react": "^19.2.0",
 		"react-dom": "^19.2.0"
 	},
@@ -150,6 +152,11 @@
 			"require": "./email.cjs",
 			"types": "./email.d.ts"
 		},
+		"./fake": {
+			"import": "./fake.js",
+			"require": "./fake.cjs",
+			"types": "./fake.d.ts"
+		},
 		"./file": {
 			"import": "./file.js",
 			"require": "./file.cjs",
@@ -315,6 +322,11 @@
 			"require": "./topic/redis.cjs",
 			"types": "./topic/redis.d.ts"
 		},
+		"./ui": {
+			"import": "./ui.js",
+			"require": "./ui.cjs",
+			"types": "./ui.d.ts"
+		},
 		"./vite": {
 			"import": "./vite.js",
 			"require": "./vite.cjs",
@@ -337,6 +349,7 @@
 		"datetime",
 		"devtools",
 		"email",
+		"fake",
 		"file",
 		"lock",
 		"lock-redis",
@@ -370,6 +383,7 @@
 		"server-swagger",
 		"topic",
 		"topic-redis",
+		"ui",
 		"vite"
 	]
 }

package/postgres.d.ts

@@ -1,5 +1,5 @@
-import * as _alepha_core1 from "alepha";
-import { Alepha, AlephaError, Descriptor, DescriptorArgs, KIND, Static, StaticEncode, TArray, TBigInt, TBoolean, TInteger, TNull, TNumber, TNumberOptions, TObject, TObjectOptions, TOptional, TOptionalAdd, TRecord, TSchema, TString, TStringOptions, TUnion, TUnsafe } from "alepha";
+import * as _alepha_core10 from "alepha";
+import { Alepha, AlephaError, Descriptor, DescriptorArgs, KIND, Page, Static, StaticEncode, TBigInt, TInteger, TNull, TNumber, TNumberOptions, TObject, TObjectOptions, TOptional, TPage, TSchema, TString, TStringOptions, TUnion, TUnsafe, pageSchema } from "alepha";
 import { DateTime, DateTimeProvider } from "alepha/datetime";
 import * as drizzle_orm0 from "drizzle-orm";
 import { BuildExtraConfigColumns, SQL, SQLWrapper, sql } from "drizzle-orm";
@@ -10,7 +10,7 @@ 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 typebox8 from "typebox";
+import * as typebox11 from "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";
@@ -883,90 +883,13 @@ declare abstract class DatabaseProvider {
 }
 //#endregion
 //#region src/schemas/pageQuerySchema.d.ts
-declare const pageQuerySchema: typebox8.TObject<{
-  page: typebox8.TOptional<typebox8.TInteger>;
-  size: typebox8.TOptional<typebox8.TInteger>;
-  sort: typebox8.TOptional<typebox8.TString>;
+declare const pageQuerySchema: typebox11.TObject<{
+  page: typebox11.TOptional<typebox11.TInteger>;
+  size: typebox11.TOptional<typebox11.TInteger>;
+  sort: typebox11.TOptional<typebox11.TString>;
 }>;
 type PageQuery = Static<typeof pageQuerySchema>;
 //#endregion
-//#region src/schemas/pageSchema.d.ts
-/**
- * Create a pagination schema for the given object schema.
- *
- * > use `pg.page` directly.
- *
- * @example
- * ```ts
- * const userSchema = t.object({ id: t.int(), name: t.text() });
- * const userPageSchema = pageSchema(userSchema);
- * ```
- *
- * @see {@link $repository#paginate}
- */
-declare const pageSchema: <T extends TObject | TRecord>(objectSchema: T, options?: TObjectOptions) => TPage<T>;
-type TPage<T extends TObject | TRecord> = TObject<{
-  content: TArray<T>;
-  can: TObject<{
-    next: TBoolean;
-    previous: TBoolean;
-  }>;
-  page: TObject<{
-    number: TInteger;
-    size: TInteger;
-    totalElements: TOptionalAdd<TInteger>;
-  }>;
-}>;
-/**
- * Opinionated type definition for a paginated response.
- *
- * @example
- * ```ts
- * const page = {
- *   content: [ ... ]
- *   can: {
- *     next: true,
- *     previous: false
- *   },
- *   page: {
- *     number: 0,
- *     size: 10,
- *     totalElements: 1200
- *   }
- * }
- * ```
- */
-type Page<T> = {
-  /**
-   * Array of items on the current page.
-   */
-  content: T[];
-  can: {
-    /**
-     * Indicates if there is a next page.
-     */
-    next: boolean;
-    /**
-     * Indicates if there is a previous page.
-     */
-    previous: boolean;
-  };
-  page: {
-    /**
-     * Page number, starting from 0.
-     */
-    number: number;
-    /**
-     * Number of items per page.
-     */
-    size: number;
-    /**
-     * Requires `count: true` in the paginate options.
-     */
-    totalElements?: number;
-  };
-};
-//#endregion
 //#region src/services/PgJsonQueryManager.d.ts
 /**
  * Manages JSONB query generation for nested object and array queries in PostgreSQL.
@@ -1081,11 +1004,18 @@ declare class PgQueryManager {
   /**
    * Create a pagination object.
    *
+   * @deprecated Use `createPagination` from @alepha/core instead.
+   * This method now delegates to the framework-level helper.
+   *
    * @param entities The entities to paginate.
    * @param limit The limit of the pagination.
    * @param offset The offset of the pagination.
+   * @param sort Optional sort metadata to include in response.
    */
-  createPagination<T>(entities: T[], limit?: number, offset?: number): Page<T>;
+  createPagination<T>(entities: T[], limit?: number, offset?: number, sort?: Array<{
+    column: string;
+    direction: "asc" | "desc";
+  }>): _alepha_core10.Page<T>;
 }
 interface PgJoin {
   table: string;
@@ -1661,11 +1591,11 @@ declare class DrizzleKitProvider {
    */
   protected importDrizzleKit(): typeof DrizzleKit;
 }
-declare const devMigrationsSchema: typebox8.TObject<{
-  id: typebox8.TNumber;
-  name: typebox8.TString;
-  snapshot: typebox8.TString;
-  created_at: typebox8.TString;
+declare const devMigrationsSchema: typebox11.TObject<{
+  id: typebox11.TNumber;
+  name: typebox11.TString;
+  snapshot: typebox11.TString;
+  created_at: typebox11.TString;
 }>;
 type DevMigrations = Static<typeof devMigrationsSchema>;
 //#endregion
@@ -1708,7 +1638,7 @@ declare class PostgresModelBuilder extends ModelBuilder {
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
 }
-declare const envSchema: _alepha_core1.TObject<{
+declare const envSchema: _alepha_core10.TObject<{
   /**
    * Main configuration for database connection.
    * Accept a string in the format of a Postgres connection URL.
@@ -1716,13 +1646,13 @@ declare const envSchema: _alepha_core1.TObject<{
    * or
    * Example: postgres://user:password@localhost:5432/database?sslmode=require
    */
-  DATABASE_URL: _alepha_core1.TOptional<_alepha_core1.TString>;
+  DATABASE_URL: _alepha_core10.TOptional<_alepha_core10.TString>;
   /**
    * In addition to the DATABASE_URL, you can specify the postgres schema name.
    *
    * It will monkey patch drizzle tables.
    */
-  POSTGRES_SCHEMA: _alepha_core1.TOptional<_alepha_core1.TString>;
+  POSTGRES_SCHEMA: _alepha_core10.TOptional<_alepha_core10.TString>;
   /**
    * Synchronize the database schema with the models.
    * It uses a custom implementation, it's not related to `drizzle-kit push` command.
@@ -1730,7 +1660,7 @@ declare const envSchema: _alepha_core1.TObject<{
    *
    * This is recommended for development and testing purposes only.
    */
-  POSTGRES_SYNCHRONIZE: _alepha_core1.TOptional<_alepha_core1.TBoolean>;
+  POSTGRES_SYNCHRONIZE: _alepha_core10.TOptional<_alepha_core10.TBoolean>;
 }>;
 interface NodePostgresProviderOptions {
   migrations: MigrationConfig;
@@ -1761,8 +1691,8 @@ declare class NodePostgresProvider extends DatabaseProvider {
    */
   get schema(): string;
   get db(): PostgresJsDatabase;
-  protected readonly onStart: _alepha_core1.HookDescriptor<"start">;
-  protected readonly onStop: _alepha_core1.HookDescriptor<"stop">;
+  protected readonly onStart: _alepha_core10.HookDescriptor<"start">;
+  protected readonly onStop: _alepha_core10.HookDescriptor<"stop">;
   connect(): Promise<void>;
   close(): Promise<void>;
   protected migrate: _alepha_lock0.LockDescriptor<() => Promise<void>>;
@@ -1828,17 +1758,17 @@ declare class PostgresTypeProvider {
   /**
    * Creates a column Created At. So just a datetime column with a default value of the current timestamp.
    */
-  readonly createdAt: (options?: TStringOptions) => PgAttr<PgAttr<typebox8.TCodec<TString, dayjs0.Dayjs>, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+  readonly createdAt: (options?: TStringOptions) => PgAttr<PgAttr<typebox11.TCodec<TString, dayjs0.Dayjs>, 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?: TStringOptions) => PgAttr<PgAttr<typebox8.TCodec<TString, dayjs0.Dayjs>, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+  readonly updatedAt: (options?: TStringOptions) => PgAttr<PgAttr<typebox11.TCodec<TString, dayjs0.Dayjs>, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
   /**
    * Creates a column Deleted At for soft delete functionality.
    * This is used to mark rows as deleted without actually removing them from the database.
    * The column is nullable - NULL means not deleted, timestamp means deleted.
    */
-  readonly deletedAt: (options?: TStringOptions) => PgAttr<typebox8.TOptional<typebox8.TCodec<TString, dayjs0.Dayjs>>, typeof PG_DELETED_AT>;
+  readonly deletedAt: (options?: TStringOptions) => PgAttr<typebox11.TOptional<typebox11.TCodec<TString, dayjs0.Dayjs>>, typeof PG_DELETED_AT>;
   /**
    * Creates a Postgres ENUM type.
    *
@@ -1870,7 +1800,7 @@ declare const pg: PostgresTypeProvider;
 /**
  * @deprecated Use `pg.primaryKey()` instead.
  */
-declare const legacyIdSchema: PgAttr<PgAttr<PgAttr<typebox8.TInteger, typeof PG_PRIMARY_KEY>, typeof PG_SERIAL>, typeof PG_DEFAULT>;
+declare const legacyIdSchema: PgAttr<PgAttr<PgAttr<typebox11.TInteger, typeof PG_PRIMARY_KEY>, typeof PG_SERIAL>, typeof PG_DEFAULT>;
 //#endregion
 //#region src/types/schema.d.ts
 /**
@@ -1880,10 +1810,10 @@ declare const schema: <TDocument extends TSchema>(name: string, document: TDocum
   name: string;
   dataType: "custom";
   columnType: "PgCustomColumn";
-  data: Static<TDocument>;
+  data: typebox11.StaticType<[], "Decode", {}, {}, TDocument>;
   driverParam: string;
   enumValues: undefined;
-}>, Static<TDocument>>;
+}>, typebox11.StaticType<[], "Decode", {}, {}, TDocument>>;
 //#endregion
 //#region src/index.d.ts
 /**
@@ -1925,7 +1855,7 @@ declare const schema: <TDocument extends TSchema>(name: string, document: TDocum
  * @see {@link $transaction}
  * @module alepha.postgres
  */
-declare const AlephaPostgres: _alepha_core1.Service<_alepha_core1.Module<{}>>;
+declare const AlephaPostgres: _alepha_core10.Service<_alepha_core10.Module<{}>>;
 //#endregion
-export { $entity, $repository, $sequence, $transaction, AlephaPostgres, DatabaseProvider, DrizzleKitProvider, EntityColumn, EntityColumns, EntityDescriptor, EntityDescriptorOptions, FilterOperators, FromSchema, NodePostgresProvider, NodePostgresProviderOptions, 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, Page, PageQuery, PgAttr, PgAttrField, PgConflictError, PgDefault, PgEntityNotFoundError, PgEnumOptions, PgError, PgIdentityOptions, PgMigrationError, PgPrimaryKey, PgQuery, PgQueryRelations, PgQueryWhere, PgQueryWhereOrSQL, PgRef, PgRefOptions, PgRelation, PgRelationMap, PgStatic, PgSymbolKeys, PgSymbols, PgVersionMismatchError, PostgresTypeProvider, RepositoryDescriptor, RepositoryDescriptorOptions, SQLLike, SchemaToTableConfig, SequenceDescriptor, SequenceDescriptorOptions, StatementOptions, TObjectInsert, TObjectUpdate, TPage, TransactionContext, TransactionDescriptorOptions, drizzle_orm0 as drizzle, getAttrFields, insertSchema, legacyIdSchema, pageQuerySchema, pageSchema, pg, pgAttr, schema, sql, updateSchema };
+export { $entity, $repository, $sequence, $transaction, AlephaPostgres, DatabaseProvider, DrizzleKitProvider, EntityColumn, EntityColumns, EntityDescriptor, EntityDescriptorOptions, FilterOperators, FromSchema, NodePostgresProvider, NodePostgresProviderOptions, 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, PageQuery, PgAttr, PgAttrField, PgConflictError, PgDefault, PgEntityNotFoundError, PgEnumOptions, PgError, PgIdentityOptions, PgMigrationError, PgPrimaryKey, PgQuery, PgQueryRelations, PgQueryWhere, PgQueryWhereOrSQL, PgRef, PgRefOptions, PgRelation, PgRelationMap, PgStatic, PgSymbolKeys, PgSymbols, PgVersionMismatchError, PostgresTypeProvider, RepositoryDescriptor, RepositoryDescriptorOptions, SQLLike, SchemaToTableConfig, SequenceDescriptor, SequenceDescriptorOptions, StatementOptions, TObjectInsert, TObjectUpdate, type TPage, TransactionContext, TransactionDescriptorOptions, drizzle_orm0 as drizzle, getAttrFields, insertSchema, legacyIdSchema, pageQuerySchema, pageSchema, pg, pgAttr, schema, sql, updateSchema };
 //# sourceMappingURL=index.d.ts.map

package/react/i18n.d.ts

@@ -69,12 +69,37 @@ declare class I18nProvider<S extends object, K$1 extends keyof ServiceDictionary
   protected readonly mutate: _alepha_core1.HookDescriptor<"state:mutate">;
   get lang(): string;
   translate: (key: string, args?: string[]) => string;
+  readonly l: (value: I18nLocalizeType, options?: I18nLocalizeOptions) => string;
   readonly tr: (key: keyof ServiceDictionary<S>[K$1], options?: {
     args?: string[];
     default?: string;
   }) => string;
   protected render(item: string, args: string[]): string;
 }
+type I18nLocalizeType = string | number | Date | DateTime | TypeBoxError;
+interface I18nLocalizeOptions {
+  /**
+   * Options for number formatting (when value is a number)
+   * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat
+   */
+  number?: Intl.NumberFormatOptions;
+  /**
+   * Options for date formatting (when value is a Date or DateTime)
+   * Can be:
+   * - A dayjs format string (e.g., "LLL", "YYYY-MM-DD", "dddd, MMMM D YYYY")
+   * - "fromNow" for relative time (e.g., "2 hours ago")
+   * - Intl.DateTimeFormatOptions for native formatting
+   * @see https://day.js.org/docs/en/display/format
+   * @see https://day.js.org/docs/en/display/from-now
+   */
+  date?: string | "fromNow" | Intl.DateTimeFormatOptions;
+  /**
+   * Timezone to display dates in (when value is a Date or DateTime)
+   * Uses IANA timezone names (e.g., "America/New_York", "Europe/Paris", "Asia/Tokyo")
+   * @see https://day.js.org/docs/en/timezone/timezone
+   */
+  timezone?: string;
+}
 //#endregion
 //#region src/descriptors/$dictionary.d.ts
 /**
@@ -139,5 +164,5 @@ declare module "alepha" {
  */
 declare const AlephaReactI18n: _alepha_core1.Service<_alepha_core1.Module<{}>>;
 //#endregion
-export { $dictionary, AlephaReactI18n, DictionaryDescriptor, DictionaryDescriptorOptions, I18nProvider, Localize, type LocalizeProps, ServiceDictionary, useI18n };
+export { $dictionary, AlephaReactI18n, DictionaryDescriptor, DictionaryDescriptorOptions, I18nLocalizeOptions, I18nLocalizeType, I18nProvider, Localize, type LocalizeProps, ServiceDictionary, useI18n };
 //# sourceMappingURL=index.d.ts.map