metal-orm 1.0.90 → 1.0.92

package/src/dto/filter-types.ts

@@ -1,193 +1,193 @@
-/**
- * Filter types for building type-safe query filters from JSON input.
- * Designed for REST API query parameters.
- */
-
-import type { TableDef } from '../schema/table.js';
-import type { ColumnDef } from '../schema/column-types.js';
-import type { EntityConstructor } from '../orm/entity-metadata.js';
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Entity support: Extract columns from entity constructor
-// ─────────────────────────────────────────────────────────────────────────────
-
-/**
- * Checks if a type is a TableDef.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type IsTableDef<T> = T extends { name: string; columns: any } ? true : false;
-
-/**
- * Maps TypeScript types to SQL column types for EntityConstructor columns.
- */
-type TsTypeToColumnType<T> =
-  T extends string ? 'VARCHAR' :
-  T extends number ? 'INT' :
-  T extends boolean ? 'BOOLEAN' :
-  T extends Date ? 'TIMESTAMP' :
-  'VARCHAR';
-
-/**
- * Extracts the column map from either a TableDef or EntityConstructor.
- * For EntityConstructor, infers column type from TypeScript property type.
- */
-type ExtractColumns<T> = IsTableDef<T> extends true
-  ? T extends TableDef<infer C> ? C : never
-  : T extends EntityConstructor<infer E>
-  ? {
-      [K in keyof E]: ColumnDef<TsTypeToColumnType<E[K]>, E[K]>;
-    }
-  : never;
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Scalar filter types per data type
-// ─────────────────────────────────────────────────────────────────────────────
-
-/**
- * Filter operators for string columns.
- */
-export interface StringFilter {
-  equals?: string;
-  not?: string;
-  in?: string[];
-  notIn?: string[];
-  contains?: string;
-  startsWith?: string;
-  endsWith?: string;
-  /** Case-insensitive matching (for contains, startsWith, endsWith) */
-  mode?: 'default' | 'insensitive';
-}
-
-/**
- * Filter operators for numeric columns (number, bigint).
- */
-export interface NumberFilter {
-  equals?: number;
-  not?: number;
-  in?: number[];
-  notIn?: number[];
-  lt?: number;
-  lte?: number;
-  gt?: number;
-  gte?: number;
-}
-
-/**
- * Filter operators for boolean columns.
- */
-export interface BooleanFilter {
-  equals?: boolean;
-  not?: boolean;
-}
-
-/**
- * Filter operators for date/datetime columns.
- * Accepts ISO date strings.
- */
-export interface DateFilter {
-  equals?: string;
-  not?: string;
-  in?: string[];
-  notIn?: string[];
-  lt?: string;
-  lte?: string;
-  gt?: string;
-  gte?: string;
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Type mapping: ColumnDef → appropriate filter type
-// ─────────────────────────────────────────────────────────────────────────────
-
-type NormalizedType<T extends ColumnDef> = Lowercase<T['type'] & string>;
-
-/**
- * Maps a column definition to its appropriate filter type.
- */
-export type FieldFilter<TCol extends ColumnDef> =
-  NormalizedType<TCol> extends 'int' | 'integer' | 'bigint' | 'decimal' | 'float' | 'double'
-    ? NumberFilter
-  : NormalizedType<TCol> extends 'boolean'
-    ? BooleanFilter
-  : NormalizedType<TCol> extends 'date' | 'datetime' | 'timestamp' | 'timestamptz'
-    ? DateFilter
-  : StringFilter; // default to string for varchar, text, uuid, etc.
-
-// ─────────────────────────────────────────────────────────────────────────────
-// SimpleWhereInput: field-only filters (no AND/OR/NOT logic)
-// ─────────────────────────────────────────────────────────────────────────────
-
-/**
- * Full where input with all columns filterable.
- * All conditions are implicitly AND-ed.
- * Works with both TableDef and EntityConstructor.
- *
- * @example
- * ```ts
- * // With TableDef
- * type UserFilter = WhereInput<typeof usersTable>;
- *
- * // With Entity class
- * type UserFilter = WhereInput<User>;
- * ```
- */
-export type WhereInput<T extends TableDef | EntityConstructor> = {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  [K in keyof ExtractColumns<T>]?: ExtractColumns<T>[K] extends ColumnDef<any, any>
-    ? FieldFilter<ExtractColumns<T>[K]>
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    : FieldFilter<ColumnDef<any, any>>;
-};
-
-/**
- * Restricted where input - only specified columns are filterable.
- * Use this to limit which fields can be filtered via API.
- *
- * Works with both TableDef and EntityConstructor.
- *
- * @example
- * ```ts
- * // With TableDef - only allow filtering by name and email
- * type UserFilter = SimpleWhereInput<typeof usersTable, 'name' | 'email'>;
- *
- * // With Entity class
- * type UserFilter = SimpleWhereInput<User, 'name' | 'email'>;
- *
- * // Request: { "name": { "contains": "john" }, "email": { "endsWith": "@gmail.com" } }
- * ```
- */
-export type SimpleWhereInput<
-  T extends TableDef | EntityConstructor,
-  K extends keyof ExtractColumns<T>
-> = {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  [P in K]?: ExtractColumns<T>[P] extends ColumnDef<any, any>
-    ? FieldFilter<ExtractColumns<T>[P]>
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    : FieldFilter<ColumnDef<any, any>>;
-};
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Filter operator value types (for runtime processing)
-// ─────────────────────────────────────────────────────────────────────────────
-
-/**
- * All possible filter operators.
- */
-export type FilterOperator =
-  | 'equals'
-  | 'not'
-  | 'in'
-  | 'notIn'
-  | 'lt'
-  | 'lte'
-  | 'gt'
-  | 'gte'
-  | 'contains'
-  | 'startsWith'
-  | 'endsWith';
-
-/**
- * Generic filter value that covers all operator types.
- */
-export type FilterValue = StringFilter | NumberFilter | BooleanFilter | DateFilter;
+/**
+ * Filter types for building type-safe query filters from JSON input.
+ * Designed for REST API query parameters.
+ */
+
+import type { TableDef } from '../schema/table.js';
+import type { ColumnDef } from '../schema/column-types.js';
+import type { EntityConstructor } from '../orm/entity-metadata.js';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Entity support: Extract columns from entity constructor
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Checks if a type is a TableDef.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type IsTableDef<T> = T extends { name: string; columns: any } ? true : false;
+
+/**
+ * Maps TypeScript types to SQL column types for EntityConstructor columns.
+ */
+type TsTypeToColumnType<T> =
+  T extends string ? 'VARCHAR' :
+  T extends number ? 'INT' :
+  T extends boolean ? 'BOOLEAN' :
+  T extends Date ? 'TIMESTAMP' :
+  'VARCHAR';
+
+/**
+ * Extracts the column map from either a TableDef or EntityConstructor.
+ * For EntityConstructor, infers column type from TypeScript property type.
+ */
+type ExtractColumns<T> = IsTableDef<T> extends true
+  ? T extends TableDef<infer C> ? C : never
+  : T extends EntityConstructor<infer E>
+  ? {
+      [K in keyof E]: ColumnDef<TsTypeToColumnType<E[K]>, E[K]>;
+    }
+  : never;
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Scalar filter types per data type
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Filter operators for string columns.
+ */
+export interface StringFilter {
+  equals?: string;
+  not?: string;
+  in?: string[];
+  notIn?: string[];
+  contains?: string;
+  startsWith?: string;
+  endsWith?: string;
+  /** Case-insensitive matching (for contains, startsWith, endsWith) */
+  mode?: 'default' | 'insensitive';
+}
+
+/**
+ * Filter operators for numeric columns (number, bigint).
+ */
+export interface NumberFilter {
+  equals?: number;
+  not?: number;
+  in?: number[];
+  notIn?: number[];
+  lt?: number;
+  lte?: number;
+  gt?: number;
+  gte?: number;
+}
+
+/**
+ * Filter operators for boolean columns.
+ */
+export interface BooleanFilter {
+  equals?: boolean;
+  not?: boolean;
+}
+
+/**
+ * Filter operators for date/datetime columns.
+ * Accepts ISO date strings.
+ */
+export interface DateFilter {
+  equals?: string;
+  not?: string;
+  in?: string[];
+  notIn?: string[];
+  lt?: string;
+  lte?: string;
+  gt?: string;
+  gte?: string;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Type mapping: ColumnDef → appropriate filter type
+// ─────────────────────────────────────────────────────────────────────────────
+
+type NormalizedType<T extends ColumnDef> = Lowercase<T['type'] & string>;
+
+/**
+ * Maps a column definition to its appropriate filter type.
+ */
+export type FieldFilter<TCol extends ColumnDef> =
+  NormalizedType<TCol> extends 'int' | 'integer' | 'bigint' | 'decimal' | 'float' | 'double'
+    ? NumberFilter
+  : NormalizedType<TCol> extends 'boolean'
+    ? BooleanFilter
+  : NormalizedType<TCol> extends 'date' | 'datetime' | 'timestamp' | 'timestamptz'
+    ? DateFilter
+  : StringFilter; // default to string for varchar, text, uuid, etc.
+
+// ─────────────────────────────────────────────────────────────────────────────
+// SimpleWhereInput: field-only filters (no AND/OR/NOT logic)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Full where input with all columns filterable.
+ * All conditions are implicitly AND-ed.
+ * Works with both TableDef and EntityConstructor.
+ *
+ * @example
+ * ```ts
+ * // With TableDef
+ * type UserFilter = WhereInput<typeof usersTable>;
+ *
+ * // With Entity class
+ * type UserFilter = WhereInput<User>;
+ * ```
+ */
+export type WhereInput<T extends TableDef | EntityConstructor> = {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  [K in keyof ExtractColumns<T>]?: ExtractColumns<T>[K] extends ColumnDef<any, any>
+    ? FieldFilter<ExtractColumns<T>[K]>
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    : FieldFilter<ColumnDef<any, any>>;
+};
+
+/**
+ * Restricted where input - only specified columns are filterable.
+ * Use this to limit which fields can be filtered via API.
+ *
+ * Works with both TableDef and EntityConstructor.
+ *
+ * @example
+ * ```ts
+ * // With TableDef - only allow filtering by name and email
+ * type UserFilter = SimpleWhereInput<typeof usersTable, 'name' | 'email'>;
+ *
+ * // With Entity class
+ * type UserFilter = SimpleWhereInput<User, 'name' | 'email'>;
+ *
+ * // Request: { "name": { "contains": "john" }, "email": { "endsWith": "@gmail.com" } }
+ * ```
+ */
+export type SimpleWhereInput<
+  T extends TableDef | EntityConstructor,
+  K extends keyof ExtractColumns<T>
+> = {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  [P in K]?: ExtractColumns<T>[P] extends ColumnDef<any, any>
+    ? FieldFilter<ExtractColumns<T>[P]>
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    : FieldFilter<ColumnDef<any, any>>;
+};
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Filter operator value types (for runtime processing)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * All possible filter operators.
+ */
+export type FilterOperator =
+  | 'equals'
+  | 'not'
+  | 'in'
+  | 'notIn'
+  | 'lt'
+  | 'lte'
+  | 'gt'
+  | 'gte'
+  | 'contains'
+  | 'startsWith'
+  | 'endsWith';
+
+/**
+ * Generic filter value that covers all operator types.
+ */
+export type FilterValue = StringFilter | NumberFilter | BooleanFilter | DateFilter;

package/src/dto/index.ts

@@ -1,97 +1,97 @@
-/**
- * DTO (Data Transfer Object) module for metal-orm.
- *
- * Provides type utilities and runtime helpers for building REST APIs
- * with automatic DTO generation from entity/table definitions.
- *
- * Supports both TableDef and Entity classes as type sources.
- *
- * @example
- * ```ts
- * import { Dto, WithRelations, CreateDto, UpdateDto, SimpleWhereInput, applyFilter, PagedResponse, toPagedResponse } from 'metal-orm/dto';
- *
- * // Using Entity classes
- * type UserResponse = Dto<User, 'passwordHash'>;
- * type PostResponse = Dto<Post, 'authorId'>;
- * type UserWithPosts = WithRelations<UserResponse, { posts: PostResponse[] }>;
- * type CreateUserDto = CreateDto<User>;
- * type UpdateUserDto = UpdateDto<User>;
- * type UserFilter = SimpleWhereInput<User, 'name' | 'email'>;
- *
- * // Enhanced pagination
- * type UsersPagedResponse = PagedResponse<UserResponse>;
- *
- * // Using TableDef directly
- * type UserResponse = Dto<typeof UserTable, 'passwordHash'>;
- * type PostResponse = Dto<typeof PostTable, 'authorId'>;
- * type UserWithPosts = WithRelations<UserResponse, { posts: PostResponse[] }>;
- * type CreateUserDto = CreateDto<typeof UserTable>;
- * type UpdateUserDto = UpdateDto<typeof UserTable>;
- * type UserFilter = SimpleWhereInput<typeof UserTable, 'name' | 'email'>;
- *
- * // Apply filter in controller
- * let query = selectFromEntity(User);
- * query = applyFilter(query, User, where);
- *
- * // Apply enhanced pagination
- * const basic = await qb.executePaged(session, { page: 2, pageSize: 20 });
- * const response = toPagedResponse(basic);
- * // → { items: [...], totalItems: 150, page: 2, pageSize: 20,
- * //     totalPages: 8, hasNextPage: true, hasPrevPage: true }
- * ```
- *
- * @packageDocumentation
- */
-
-// DTO type utilities
-export type {
-  Simplify,
-  Dto,
-  WithRelations,
-  CreateDto,
-  UpdateDto,
-  PagedResponse
-} from './dto-types.js';
-
-// Filter types
-export type {
-  StringFilter,
-  NumberFilter,
-  BooleanFilter,
-  DateFilter,
-  FieldFilter,
-  WhereInput,
-  SimpleWhereInput,
-  FilterOperator,
-  FilterValue
-} from './filter-types.js';
-
-// Runtime filter application
-export {
-  applyFilter,
-  buildFilterExpression
-} from './apply-filter.js';
-
-// Transformation utilities
-export {
-  toResponse,
-  toResponseBuilder,
-  withDefaults,
-  withDefaultsBuilder,
-  exclude,
-  pick,
-  mapFields
-} from './transform.js';
-
-// Pagination utilities
-export {
-  toPagedResponse,
-  toPagedResponseBuilder,
-  calculateTotalPages,
-  hasNextPage as hasNextPageMeta,
-  hasPrevPage as hasPrevPageMeta,
-  computePaginationMetadata
-} from './pagination-utils.js';
-
-// OpenAPI 3.1 Schema generation
-export * from './openapi/index.js';
+/**
+ * DTO (Data Transfer Object) module for metal-orm.
+ *
+ * Provides type utilities and runtime helpers for building REST APIs
+ * with automatic DTO generation from entity/table definitions.
+ *
+ * Supports both TableDef and Entity classes as type sources.
+ *
+ * @example
+ * ```ts
+ * import { Dto, WithRelations, CreateDto, UpdateDto, SimpleWhereInput, applyFilter, PagedResponse, toPagedResponse } from 'metal-orm/dto';
+ *
+ * // Using Entity classes
+ * type UserResponse = Dto<User, 'passwordHash'>;
+ * type PostResponse = Dto<Post, 'authorId'>;
+ * type UserWithPosts = WithRelations<UserResponse, { posts: PostResponse[] }>;
+ * type CreateUserDto = CreateDto<User>;
+ * type UpdateUserDto = UpdateDto<User>;
+ * type UserFilter = SimpleWhereInput<User, 'name' | 'email'>;
+ *
+ * // Enhanced pagination
+ * type UsersPagedResponse = PagedResponse<UserResponse>;
+ *
+ * // Using TableDef directly
+ * type UserResponse = Dto<typeof UserTable, 'passwordHash'>;
+ * type PostResponse = Dto<typeof PostTable, 'authorId'>;
+ * type UserWithPosts = WithRelations<UserResponse, { posts: PostResponse[] }>;
+ * type CreateUserDto = CreateDto<typeof UserTable>;
+ * type UpdateUserDto = UpdateDto<typeof UserTable>;
+ * type UserFilter = SimpleWhereInput<typeof UserTable, 'name' | 'email'>;
+ *
+ * // Apply filter in controller
+ * let query = selectFromEntity(User);
+ * query = applyFilter(query, User, where);
+ *
+ * // Apply enhanced pagination
+ * const basic = await qb.executePaged(session, { page: 2, pageSize: 20 });
+ * const response = toPagedResponse(basic);
+ * // → { items: [...], totalItems: 150, page: 2, pageSize: 20,
+ * //     totalPages: 8, hasNextPage: true, hasPrevPage: true }
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+// DTO type utilities
+export type {
+  Simplify,
+  Dto,
+  WithRelations,
+  CreateDto,
+  UpdateDto,
+  PagedResponse
+} from './dto-types.js';
+
+// Filter types
+export type {
+  StringFilter,
+  NumberFilter,
+  BooleanFilter,
+  DateFilter,
+  FieldFilter,
+  WhereInput,
+  SimpleWhereInput,
+  FilterOperator,
+  FilterValue
+} from './filter-types.js';
+
+// Runtime filter application
+export {
+  applyFilter,
+  buildFilterExpression
+} from './apply-filter.js';
+
+// Transformation utilities
+export {
+  toResponse,
+  toResponseBuilder,
+  withDefaults,
+  withDefaultsBuilder,
+  exclude,
+  pick,
+  mapFields
+} from './transform.js';
+
+// Pagination utilities
+export {
+  toPagedResponse,
+  toPagedResponseBuilder,
+  calculateTotalPages,
+  hasNextPage as hasNextPageMeta,
+  hasPrevPage as hasPrevPageMeta,
+  computePaginationMetadata
+} from './pagination-utils.js';
+
+// OpenAPI 3.1 Schema generation
+export * from './openapi/index.js';

package/src/dto/openapi/generators/base.ts

@@ -1,29 +1,29 @@
-import type { TableDef } from '../../../schema/table.js';
-import type { ColumnDef } from '../../../schema/column-types.js';
-import type { EntityConstructor } from '../../../orm/entity-metadata.js';
-import { getEntityMetadata } from '../../../orm/entity-metadata.js';
-
-export function isTableDef(target: TableDef | EntityConstructor): target is TableDef {
-  return 'columns' in target && 'name' in target;
-}
-
-export function getColumnMap(target: TableDef | EntityConstructor): Record<string, ColumnDef> {
-  if (isTableDef(target)) {
-    return target.columns;
-  }
-  const meta = getEntityMetadata(target);
-  if (meta && meta.columns) {
-    const columns: Record<string, ColumnDef> = {};
-    for (const [key, def] of Object.entries(meta.columns)) {
-      columns[key] = {
-        ...def as object,
-        name: key,
-        table: meta.tableName
-      } as ColumnDef;
-    }
-    return columns;
-  }
-  return {};
-}
-
-export type TargetType<T extends TableDef | EntityConstructor> = T;
+import type { TableDef } from '../../../schema/table.js';
+import type { ColumnDef } from '../../../schema/column-types.js';
+import type { EntityConstructor } from '../../../orm/entity-metadata.js';
+import { getEntityMetadata } from '../../../orm/entity-metadata.js';
+
+export function isTableDef(target: TableDef | EntityConstructor): target is TableDef {
+  return 'columns' in target && 'name' in target;
+}
+
+export function getColumnMap(target: TableDef | EntityConstructor): Record<string, ColumnDef> {
+  if (isTableDef(target)) {
+    return target.columns;
+  }
+  const meta = getEntityMetadata(target);
+  if (meta && meta.columns) {
+    const columns: Record<string, ColumnDef> = {};
+    for (const [key, def] of Object.entries(meta.columns)) {
+      columns[key] = {
+        ...def as object,
+        name: key,
+        table: meta.tableName
+      } as ColumnDef;
+    }
+    return columns;
+  }
+  return {};
+}
+
+export type TargetType<T extends TableDef | EntityConstructor> = T;