@longzai-intelligence/pagination 0.0.1 → 0.0.2

package/dist/index-C8FaNzej.d.mts

@@ -0,0 +1,145 @@
+import { z } from "zod";
+
+//#region src/schemas/pagination.schemas.d.ts
+declare const PaginationDefaultsSchema: z.ZodObject<{
+  page: z.ZodLiteral<1>;
+  pageSize: z.ZodLiteral<20>;
+  maxPageSize: z.ZodLiteral<100>;
+  minPageSize: z.ZodLiteral<1>;
+}, z.core.$strip>;
+type PaginationDefaults = z.infer<typeof PaginationDefaultsSchema>;
+declare const PaginationParamsSchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodNumber>;
+  pageSize: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type PaginationParams = z.infer<typeof PaginationParamsSchema>;
+declare const OffsetPaginationParamsSchema: z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type OffsetPaginationParams = z.infer<typeof OffsetPaginationParamsSchema>;
+declare const CursorPaginationParamsSchema: z.ZodObject<{
+  cursor: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type CursorPaginationParams = z.infer<typeof CursorPaginationParamsSchema>;
+//#endregion
+//#region src/types/pagination.types.d.ts
+declare const PAGINATION_DEFAULTS: {
+  readonly page: 1;
+  readonly pageSize: 20;
+  readonly maxPageSize: 100;
+  readonly minPageSize: 1;
+};
+//#endregion
+//#region src/schemas/result.schemas.d.ts
+declare function createPaginatedResultSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+  items: z.ZodArray<T>;
+  total: z.ZodNumber;
+  page: z.ZodNumber;
+  pageSize: z.ZodNumber;
+  totalPages: z.ZodNumber;
+  hasNextPage: z.ZodBoolean;
+  hasPreviousPage: z.ZodBoolean;
+}, z.core.$strip>;
+type PaginatedResult<T> = {
+  items: T[];
+  total: number;
+  page: number;
+  pageSize: number;
+  totalPages: number;
+  hasNextPage: boolean;
+  hasPreviousPage: boolean;
+};
+declare function createOffsetPaginatedResultSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+  items: z.ZodArray<T>;
+  total: z.ZodNumber;
+  limit: z.ZodNumber;
+  offset: z.ZodNumber;
+  hasMore: z.ZodBoolean;
+}, z.core.$strip>;
+type OffsetPaginatedResult<T> = {
+  items: T[];
+  total: number;
+  limit: number;
+  offset: number;
+  hasMore: boolean;
+};
+declare function createCursorPaginatedResultSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+  items: z.ZodArray<T>;
+  nextCursor: z.ZodNullable<z.ZodString>;
+  previousCursor: z.ZodNullable<z.ZodString>;
+  hasMore: z.ZodBoolean;
+}, z.core.$strip>;
+type CursorPaginatedResult<T> = {
+  items: T[];
+  nextCursor: string | null;
+  previousCursor: string | null;
+  hasMore: boolean;
+};
+//#endregion
+//#region src/schemas/sort.schemas.d.ts
+declare const SortOrderSchema: z.ZodEnum<{
+  asc: "asc";
+  desc: "desc";
+}>;
+type SortOrder = z.infer<typeof SortOrderSchema>;
+type SortParams<T extends string = string> = {
+  sortBy?: T;
+  sortOrder?: SortOrder;
+};
+declare function createSortParamsSchema<T extends [string, ...string[]]>(fields: T): z.ZodObject<{
+  sortBy: z.ZodOptional<z.ZodEnum<{ [k_1 in T[number]]: k_1 } extends infer T_1 ? { [k in keyof T_1]: T_1[k] } : never>>;
+  sortOrder: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+}, z.core.$strip>;
+declare const SortParamsSchema: z.ZodObject<{
+  sortBy: z.ZodOptional<z.ZodString>;
+  sortOrder: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+}, z.core.$strip>;
+type SortItem<T extends string = string> = {
+  field: T;
+  order: SortOrder;
+};
+declare function createSortItemSchema<T extends [string, ...string[]]>(fields: T): z.ZodObject<{
+  field: z.ZodEnum<{ [k_1 in T[number]]: k_1 } extends infer T_1 ? { [k in keyof T_1]: T_1[k] } : never>;
+  order: z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>;
+}, z.core.$strip>;
+declare const SortItemSchema: z.ZodObject<{
+  field: z.ZodString;
+  order: z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>;
+}, z.core.$strip>;
+type MultiSortParams<T extends string = string> = {
+  sort?: SortItem<T>[];
+};
+declare function createMultiSortParamsSchema<T extends [string, ...string[]]>(fields: T): z.ZodObject<{
+  sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    field: z.ZodEnum<{ [k_1 in T[number]]: k_1 } extends infer T_1 ? { [k in keyof T_1]: T_1[k] } : never>;
+    order: z.ZodEnum<{
+      asc: "asc";
+      desc: "desc";
+    }>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const MultiSortParamsSchema: z.ZodObject<{
+  sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    field: z.ZodString;
+    order: z.ZodEnum<{
+      asc: "asc";
+      desc: "desc";
+    }>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+//#endregion
+export { PaginationDefaults as C, PaginationParamsSchema as E, OffsetPaginationParamsSchema as S, PaginationParams as T, createPaginatedResultSchema as _, SortOrder as a, CursorPaginationParamsSchema as b, SortParamsSchema as c, createSortParamsSchema as d, CursorPaginatedResult as f, createOffsetPaginatedResultSchema as g, createCursorPaginatedResultSchema as h, SortItemSchema as i, createMultiSortParamsSchema as l, PaginatedResult as m, MultiSortParamsSchema as n, SortOrderSchema as o, OffsetPaginatedResult as p, SortItem as r, SortParams as s, MultiSortParams as t, createSortItemSchema as u, PAGINATION_DEFAULTS as v, PaginationDefaultsSchema as w, OffsetPaginationParams as x, CursorPaginationParams as y };

package/dist/index-CMiyhlfm.d.cts

@@ -0,0 +1,145 @@
+import { z } from "zod";
+
+//#region src/schemas/pagination.schemas.d.ts
+declare const PaginationDefaultsSchema: z.ZodObject<{
+  page: z.ZodLiteral<1>;
+  pageSize: z.ZodLiteral<20>;
+  maxPageSize: z.ZodLiteral<100>;
+  minPageSize: z.ZodLiteral<1>;
+}, z.core.$strip>;
+type PaginationDefaults = z.infer<typeof PaginationDefaultsSchema>;
+declare const PaginationParamsSchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodNumber>;
+  pageSize: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type PaginationParams = z.infer<typeof PaginationParamsSchema>;
+declare const OffsetPaginationParamsSchema: z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type OffsetPaginationParams = z.infer<typeof OffsetPaginationParamsSchema>;
+declare const CursorPaginationParamsSchema: z.ZodObject<{
+  cursor: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type CursorPaginationParams = z.infer<typeof CursorPaginationParamsSchema>;
+//#endregion
+//#region src/types/pagination.types.d.ts
+declare const PAGINATION_DEFAULTS: {
+  readonly page: 1;
+  readonly pageSize: 20;
+  readonly maxPageSize: 100;
+  readonly minPageSize: 1;
+};
+//#endregion
+//#region src/schemas/result.schemas.d.ts
+declare function createPaginatedResultSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+  items: z.ZodArray<T>;
+  total: z.ZodNumber;
+  page: z.ZodNumber;
+  pageSize: z.ZodNumber;
+  totalPages: z.ZodNumber;
+  hasNextPage: z.ZodBoolean;
+  hasPreviousPage: z.ZodBoolean;
+}, z.core.$strip>;
+type PaginatedResult<T> = {
+  items: T[];
+  total: number;
+  page: number;
+  pageSize: number;
+  totalPages: number;
+  hasNextPage: boolean;
+  hasPreviousPage: boolean;
+};
+declare function createOffsetPaginatedResultSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+  items: z.ZodArray<T>;
+  total: z.ZodNumber;
+  limit: z.ZodNumber;
+  offset: z.ZodNumber;
+  hasMore: z.ZodBoolean;
+}, z.core.$strip>;
+type OffsetPaginatedResult<T> = {
+  items: T[];
+  total: number;
+  limit: number;
+  offset: number;
+  hasMore: boolean;
+};
+declare function createCursorPaginatedResultSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+  items: z.ZodArray<T>;
+  nextCursor: z.ZodNullable<z.ZodString>;
+  previousCursor: z.ZodNullable<z.ZodString>;
+  hasMore: z.ZodBoolean;
+}, z.core.$strip>;
+type CursorPaginatedResult<T> = {
+  items: T[];
+  nextCursor: string | null;
+  previousCursor: string | null;
+  hasMore: boolean;
+};
+//#endregion
+//#region src/schemas/sort.schemas.d.ts
+declare const SortOrderSchema: z.ZodEnum<{
+  asc: "asc";
+  desc: "desc";
+}>;
+type SortOrder = z.infer<typeof SortOrderSchema>;
+type SortParams<T extends string = string> = {
+  sortBy?: T;
+  sortOrder?: SortOrder;
+};
+declare function createSortParamsSchema<T extends [string, ...string[]]>(fields: T): z.ZodObject<{
+  sortBy: z.ZodOptional<z.ZodEnum<{ [k_1 in T[number]]: k_1 } extends infer T_1 ? { [k in keyof T_1]: T_1[k] } : never>>;
+  sortOrder: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+}, z.core.$strip>;
+declare const SortParamsSchema: z.ZodObject<{
+  sortBy: z.ZodOptional<z.ZodString>;
+  sortOrder: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+}, z.core.$strip>;
+type SortItem<T extends string = string> = {
+  field: T;
+  order: SortOrder;
+};
+declare function createSortItemSchema<T extends [string, ...string[]]>(fields: T): z.ZodObject<{
+  field: z.ZodEnum<{ [k_1 in T[number]]: k_1 } extends infer T_1 ? { [k in keyof T_1]: T_1[k] } : never>;
+  order: z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>;
+}, z.core.$strip>;
+declare const SortItemSchema: z.ZodObject<{
+  field: z.ZodString;
+  order: z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>;
+}, z.core.$strip>;
+type MultiSortParams<T extends string = string> = {
+  sort?: SortItem<T>[];
+};
+declare function createMultiSortParamsSchema<T extends [string, ...string[]]>(fields: T): z.ZodObject<{
+  sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    field: z.ZodEnum<{ [k_1 in T[number]]: k_1 } extends infer T_1 ? { [k in keyof T_1]: T_1[k] } : never>;
+    order: z.ZodEnum<{
+      asc: "asc";
+      desc: "desc";
+    }>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const MultiSortParamsSchema: z.ZodObject<{
+  sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    field: z.ZodString;
+    order: z.ZodEnum<{
+      asc: "asc";
+      desc: "desc";
+    }>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+//#endregion
+export { PaginationDefaults as C, PaginationParamsSchema as E, OffsetPaginationParamsSchema as S, PaginationParams as T, createPaginatedResultSchema as _, SortOrder as a, CursorPaginationParamsSchema as b, SortParamsSchema as c, createSortParamsSchema as d, CursorPaginatedResult as f, createOffsetPaginatedResultSchema as g, createCursorPaginatedResultSchema as h, SortItemSchema as i, createMultiSortParamsSchema as l, PaginatedResult as m, MultiSortParamsSchema as n, SortOrderSchema as o, OffsetPaginatedResult as p, SortItem as r, SortParams as s, MultiSortParams as t, createSortItemSchema as u, PAGINATION_DEFAULTS as v, PaginationDefaultsSchema as w, OffsetPaginationParams as x, CursorPaginationParams as y };

package/dist/index.cjs

@@ -1 +1,33 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e={page:1,pageSize:20,maxPageSize:100,minPageSize:1};function t(t){return{page:Math.max(1,Math.floor(t?.page??e.page)),pageSize:Math.min(e.maxPageSize,Math.max(e.minPageSize,Math.floor(t?.pageSize??e.pageSize)))}}function n(t){return{limit:Math.min(e.maxPageSize,Math.max(e.minPageSize,Math.floor(t?.limit??e.pageSize))),offset:Math.max(0,Math.floor(t?.offset??0))}}function r(e,t){return(e-1)*t}function i(e,t){return t<=0?0:Math.ceil(e/t)}function a(e,t){return e<t}function o(e){return e>1}function s(e,t){let n=Math.max(1,t);return{page:Math.floor(e/n)+1,pageSize:n}}function c(e,t){let n=Math.max(1,e),r=Math.max(1,t);return{offset:(n-1)*r,limit:r}}function l(e,t,n,r){let s=i(t,r);return{items:e,total:t,page:n,pageSize:r,totalPages:s,hasNextPage:a(n,s),hasPreviousPage:o(n)}}function u(e){return typeof e==`object`&&!!e}function d(e){return typeof e==`number`&&Number.isInteger(e)&&e>=1}function f(t){return typeof t==`number`&&Number.isInteger(t)&&t>=e.minPageSize&&t<=e.maxPageSize}function p(e){return typeof e==`number`&&Number.isInteger(e)&&e>=0}function m(t){return typeof t==`number`&&Number.isInteger(t)&&t>=e.minPageSize&&t<=e.maxPageSize}function h(e){if(!u(e))return!1;let t=e.page,n=e.pageSize;return(t===void 0||d(t))&&(n===void 0||f(n))}function g(e){if(!u(e))return!1;let t=e.limit,n=e.offset;return(t===void 0||m(t))&&(n===void 0||p(n))}function _(e){return e!==void 0&&`mapper`in e}function v(e,t,n,r){let s=i(t,r);return{items:e,total:t,page:n,pageSize:r,totalPages:s,hasNextPage:a(n,s),hasPreviousPage:o(n)}}async function y(e,n,i){let{page:a,pageSize:o}=t(n),s={skip:r(a,o),take:o,where:i?.where,relations:i?.relations,select:i?.select,order:i?.order??{createdAt:`DESC`}},[c,l]=await e.findAndCount(s);return _(i)?v(await Promise.all(c.map(i.mapper)),l,a,o):v(c,l,a,o)}async function b(e,n,i){let{page:a,pageSize:o}=t(n),s=r(a,o);e.skip(s).take(o);let[c,l]=await e.getManyAndCount();return v(i?await Promise.all(c.map(i)):c,l,a,o)}function x(e,t){return e.createQueryBuilder(t??e.metadata.name.toLowerCase())}exports.PAGINATION_DEFAULTS=e,exports.calculateOffset=r,exports.calculateTotalPages=i,exports.createPaginatedResult=l,exports.createPaginationQueryBuilder=x,exports.hasNextPage=a,exports.hasPreviousPage=o,exports.isValidLimit=m,exports.isValidOffset=p,exports.isValidOffsetPagination=g,exports.isValidPage=d,exports.isValidPageSize=f,exports.isValidPagination=h,exports.normalizeOffsetPagination=n,exports.normalizePagination=t,exports.offsetToPage=s,exports.pageToOffset=c,exports.paginateWithQueryBuilder=b,exports.paginateWithRepository=y;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_utils = require('./utils-DazsDMMu.cjs');
+
+exports.CursorPaginationParamsSchema = require_utils.CursorPaginationParamsSchema;
+exports.MultiSortParamsSchema = require_utils.MultiSortParamsSchema;
+exports.OffsetPaginationParamsSchema = require_utils.OffsetPaginationParamsSchema;
+exports.PAGINATION_DEFAULTS = require_utils.PAGINATION_DEFAULTS;
+exports.PaginationDefaultsSchema = require_utils.PaginationDefaultsSchema;
+exports.PaginationParamsSchema = require_utils.PaginationParamsSchema;
+exports.SortItemSchema = require_utils.SortItemSchema;
+exports.SortOrderSchema = require_utils.SortOrderSchema;
+exports.SortParamsSchema = require_utils.SortParamsSchema;
+exports.calculateOffset = require_utils.calculateOffset;
+exports.calculateTotalPages = require_utils.calculateTotalPages;
+exports.createCursorPaginatedResultSchema = require_utils.createCursorPaginatedResultSchema;
+exports.createMultiSortParamsSchema = require_utils.createMultiSortParamsSchema;
+exports.createOffsetPaginatedResultSchema = require_utils.createOffsetPaginatedResultSchema;
+exports.createPaginatedResult = require_utils.createPaginatedResult;
+exports.createPaginatedResultSchema = require_utils.createPaginatedResultSchema;
+exports.createSortItemSchema = require_utils.createSortItemSchema;
+exports.createSortParamsSchema = require_utils.createSortParamsSchema;
+exports.hasNextPage = require_utils.hasNextPage;
+exports.hasPreviousPage = require_utils.hasPreviousPage;
+exports.isValidLimit = require_utils.isValidLimit;
+exports.isValidOffset = require_utils.isValidOffset;
+exports.isValidOffsetPagination = require_utils.isValidOffsetPagination;
+exports.isValidPage = require_utils.isValidPage;
+exports.isValidPageSize = require_utils.isValidPageSize;
+exports.isValidPagination = require_utils.isValidPagination;
+exports.normalizeOffsetPagination = require_utils.normalizeOffsetPagination;
+exports.normalizePagination = require_utils.normalizePagination;
+exports.offsetToPage = require_utils.offsetToPage;
+exports.pageToOffset = require_utils.pageToOffset;

package/dist/index.d.cts

@@ -1,64 +1,5 @@
-import { FindManyOptions, FindOptionsOrder, ObjectLiteral, Repository, SelectQueryBuilder } from "typeorm";
+import { C as PaginationDefaults, E as PaginationParamsSchema, S as OffsetPaginationParamsSchema, T as PaginationParams, _ as createPaginatedResultSchema, a as SortOrder, b as CursorPaginationParamsSchema, c as SortParamsSchema, d as createSortParamsSchema, f as CursorPaginatedResult, g as createOffsetPaginatedResultSchema, h as createCursorPaginatedResultSchema, i as SortItemSchema, l as createMultiSortParamsSchema, m as PaginatedResult, n as MultiSortParamsSchema, o as SortOrderSchema, p as OffsetPaginatedResult, r as SortItem, s as SortParams, t as MultiSortParams, u as createSortItemSchema, v as PAGINATION_DEFAULTS, w as PaginationDefaultsSchema, x as OffsetPaginationParams, y as CursorPaginationParams } from "./index-CMiyhlfm.cjs";
 
-//#region src/types/pagination.types.d.ts
-type PaginationParams = {
-  page?: number;
-  pageSize?: number;
-};
-type OffsetPaginationParams = {
-  limit?: number;
-  offset?: number;
-};
-type CursorPaginationParams = {
-  cursor?: string;
-  limit?: number;
-};
-declare const PAGINATION_DEFAULTS: {
-  readonly page: 1;
-  readonly pageSize: 20;
-  readonly maxPageSize: 100;
-  readonly minPageSize: 1;
-};
-type PaginationDefaults = typeof PAGINATION_DEFAULTS;
-//#endregion
-//#region src/types/result.types.d.ts
-type PaginatedResult<T> = {
-  items: T[];
-  total: number;
-  page: number;
-  pageSize: number;
-  totalPages: number;
-  hasNextPage: boolean;
-  hasPreviousPage: boolean;
-};
-type OffsetPaginatedResult<T> = {
-  items: T[];
-  total: number;
-  limit: number;
-  offset: number;
-  hasMore: boolean;
-};
-type CursorPaginatedResult<T> = {
-  items: T[];
-  nextCursor: string | null;
-  previousCursor: string | null;
-  hasMore: boolean;
-};
-//#endregion
-//#region src/types/sort.types.d.ts
-type SortOrder = 'asc' | 'desc';
-type SortParams<T extends string = string> = {
-  sortBy?: T;
-  sortOrder?: SortOrder;
-};
-type SortItem<T extends string = string> = {
-  field: T;
-  order: SortOrder;
-};
-type MultiSortParams<T extends string = string> = {
-  sort?: SortItem<T>[];
-};
-//#endregion
 //#region src/utils/pagination.util.d.ts
 type OffsetPaginationResult = {
   page: number;
@@ -94,24 +35,4 @@ declare function isValidLimit(limit: unknown): limit is number;
 declare function isValidPagination(params: unknown): params is PaginationValidationResult;
 declare function isValidOffsetPagination(params: unknown): params is OffsetPaginationValidationResult;
 //#endregion
-//#region src/adapters/typeorm.adapter.d.ts
-type EntityMapper<TEntity, TDto> = (entity: TEntity) => TDto | Promise<TDto>;
-type TypeOrmPaginateOptionsWithMapper<TEntity extends ObjectLiteral, TDto> = {
-  mapper: EntityMapper<TEntity, TDto>;
-  order?: FindOptionsOrder<TEntity>;
-  where?: FindManyOptions<TEntity>['where'];
-  relations?: FindManyOptions<TEntity>['relations'];
-  select?: FindManyOptions<TEntity>['select'];
-};
-type TypeOrmPaginateOptionsNoMapper<TEntity extends ObjectLiteral> = {
-  order?: FindOptionsOrder<TEntity>;
-  where?: FindManyOptions<TEntity>['where'];
-  relations?: FindManyOptions<TEntity>['relations'];
-  select?: FindManyOptions<TEntity>['select'];
-};
-type TypeOrmPaginateOptions<TEntity extends ObjectLiteral, TDto = TEntity> = TypeOrmPaginateOptionsWithMapper<TEntity, TDto> | TypeOrmPaginateOptionsNoMapper<TEntity>;
-declare function paginateWithRepository<TEntity extends ObjectLiteral, TDto = TEntity>(repository: Repository<TEntity>, params: PaginationParams, options?: TypeOrmPaginateOptions<TEntity, TDto>): Promise<PaginatedResult<TEntity | TDto>>;
-declare function paginateWithQueryBuilder<TEntity extends ObjectLiteral, TDto = TEntity>(queryBuilder: SelectQueryBuilder<TEntity>, params: PaginationParams, mapper?: EntityMapper<TEntity, TDto>): Promise<PaginatedResult<TEntity | TDto>>;
-declare function createPaginationQueryBuilder<TEntity extends ObjectLiteral>(repository: Repository<TEntity>, alias?: string): SelectQueryBuilder<TEntity>;
-//#endregion
-export { type CursorPaginatedResult, type CursorPaginationParams, type EntityMapper, type MultiSortParams, type OffsetPaginatedResult, type OffsetPaginationParams, type OffsetPaginationResult, type OffsetPaginationValidationResult, PAGINATION_DEFAULTS, type PagePaginationResult, type PaginatedResult, type PaginationDefaults, type PaginationParams, type PaginationValidationResult, type SortItem, type SortOrder, type SortParams, type TypeOrmPaginateOptions, calculateOffset, calculateTotalPages, createPaginatedResult, createPaginationQueryBuilder, hasNextPage, hasPreviousPage, isValidLimit, isValidOffset, isValidOffsetPagination, isValidPage, isValidPageSize, isValidPagination, normalizeOffsetPagination, normalizePagination, offsetToPage, pageToOffset, paginateWithQueryBuilder, paginateWithRepository };
+export { type CursorPaginatedResult, type CursorPaginationParams, CursorPaginationParamsSchema, type MultiSortParams, MultiSortParamsSchema, type OffsetPaginatedResult, type OffsetPaginationParams, OffsetPaginationParamsSchema, type OffsetPaginationResult, type OffsetPaginationValidationResult, PAGINATION_DEFAULTS, type PagePaginationResult, type PaginatedResult, type PaginationDefaults, PaginationDefaultsSchema, type PaginationParams, PaginationParamsSchema, type PaginationValidationResult, type SortItem, SortItemSchema, type SortOrder, SortOrderSchema, type SortParams, SortParamsSchema, calculateOffset, calculateTotalPages, createCursorPaginatedResultSchema, createMultiSortParamsSchema, createOffsetPaginatedResultSchema, createPaginatedResult, createPaginatedResultSchema, createSortItemSchema, createSortParamsSchema, hasNextPage, hasPreviousPage, isValidLimit, isValidOffset, isValidOffsetPagination, isValidPage, isValidPageSize, isValidPagination, normalizeOffsetPagination, normalizePagination, offsetToPage, pageToOffset };

package/dist/index.d.mts

@@ -1,64 +1,5 @@
-import { FindManyOptions, FindOptionsOrder, ObjectLiteral, Repository, SelectQueryBuilder } from "typeorm";
+import { C as PaginationDefaults, E as PaginationParamsSchema, S as OffsetPaginationParamsSchema, T as PaginationParams, _ as createPaginatedResultSchema, a as SortOrder, b as CursorPaginationParamsSchema, c as SortParamsSchema, d as createSortParamsSchema, f as CursorPaginatedResult, g as createOffsetPaginatedResultSchema, h as createCursorPaginatedResultSchema, i as SortItemSchema, l as createMultiSortParamsSchema, m as PaginatedResult, n as MultiSortParamsSchema, o as SortOrderSchema, p as OffsetPaginatedResult, r as SortItem, s as SortParams, t as MultiSortParams, u as createSortItemSchema, v as PAGINATION_DEFAULTS, w as PaginationDefaultsSchema, x as OffsetPaginationParams, y as CursorPaginationParams } from "./index-C8FaNzej.mjs";
 
-//#region src/types/pagination.types.d.ts
-type PaginationParams = {
-  page?: number;
-  pageSize?: number;
-};
-type OffsetPaginationParams = {
-  limit?: number;
-  offset?: number;
-};
-type CursorPaginationParams = {
-  cursor?: string;
-  limit?: number;
-};
-declare const PAGINATION_DEFAULTS: {
-  readonly page: 1;
-  readonly pageSize: 20;
-  readonly maxPageSize: 100;
-  readonly minPageSize: 1;
-};
-type PaginationDefaults = typeof PAGINATION_DEFAULTS;
-//#endregion
-//#region src/types/result.types.d.ts
-type PaginatedResult<T> = {
-  items: T[];
-  total: number;
-  page: number;
-  pageSize: number;
-  totalPages: number;
-  hasNextPage: boolean;
-  hasPreviousPage: boolean;
-};
-type OffsetPaginatedResult<T> = {
-  items: T[];
-  total: number;
-  limit: number;
-  offset: number;
-  hasMore: boolean;
-};
-type CursorPaginatedResult<T> = {
-  items: T[];
-  nextCursor: string | null;
-  previousCursor: string | null;
-  hasMore: boolean;
-};
-//#endregion
-//#region src/types/sort.types.d.ts
-type SortOrder = 'asc' | 'desc';
-type SortParams<T extends string = string> = {
-  sortBy?: T;
-  sortOrder?: SortOrder;
-};
-type SortItem<T extends string = string> = {
-  field: T;
-  order: SortOrder;
-};
-type MultiSortParams<T extends string = string> = {
-  sort?: SortItem<T>[];
-};
-//#endregion
 //#region src/utils/pagination.util.d.ts
 type OffsetPaginationResult = {
   page: number;
@@ -94,24 +35,4 @@ declare function isValidLimit(limit: unknown): limit is number;
 declare function isValidPagination(params: unknown): params is PaginationValidationResult;
 declare function isValidOffsetPagination(params: unknown): params is OffsetPaginationValidationResult;
 //#endregion
-//#region src/adapters/typeorm.adapter.d.ts
-type EntityMapper<TEntity, TDto> = (entity: TEntity) => TDto | Promise<TDto>;
-type TypeOrmPaginateOptionsWithMapper<TEntity extends ObjectLiteral, TDto> = {
-  mapper: EntityMapper<TEntity, TDto>;
-  order?: FindOptionsOrder<TEntity>;
-  where?: FindManyOptions<TEntity>['where'];
-  relations?: FindManyOptions<TEntity>['relations'];
-  select?: FindManyOptions<TEntity>['select'];
-};
-type TypeOrmPaginateOptionsNoMapper<TEntity extends ObjectLiteral> = {
-  order?: FindOptionsOrder<TEntity>;
-  where?: FindManyOptions<TEntity>['where'];
-  relations?: FindManyOptions<TEntity>['relations'];
-  select?: FindManyOptions<TEntity>['select'];
-};
-type TypeOrmPaginateOptions<TEntity extends ObjectLiteral, TDto = TEntity> = TypeOrmPaginateOptionsWithMapper<TEntity, TDto> | TypeOrmPaginateOptionsNoMapper<TEntity>;
-declare function paginateWithRepository<TEntity extends ObjectLiteral, TDto = TEntity>(repository: Repository<TEntity>, params: PaginationParams, options?: TypeOrmPaginateOptions<TEntity, TDto>): Promise<PaginatedResult<TEntity | TDto>>;
-declare function paginateWithQueryBuilder<TEntity extends ObjectLiteral, TDto = TEntity>(queryBuilder: SelectQueryBuilder<TEntity>, params: PaginationParams, mapper?: EntityMapper<TEntity, TDto>): Promise<PaginatedResult<TEntity | TDto>>;
-declare function createPaginationQueryBuilder<TEntity extends ObjectLiteral>(repository: Repository<TEntity>, alias?: string): SelectQueryBuilder<TEntity>;
-//#endregion
-export { type CursorPaginatedResult, type CursorPaginationParams, type EntityMapper, type MultiSortParams, type OffsetPaginatedResult, type OffsetPaginationParams, type OffsetPaginationResult, type OffsetPaginationValidationResult, PAGINATION_DEFAULTS, type PagePaginationResult, type PaginatedResult, type PaginationDefaults, type PaginationParams, type PaginationValidationResult, type SortItem, type SortOrder, type SortParams, type TypeOrmPaginateOptions, calculateOffset, calculateTotalPages, createPaginatedResult, createPaginationQueryBuilder, hasNextPage, hasPreviousPage, isValidLimit, isValidOffset, isValidOffsetPagination, isValidPage, isValidPageSize, isValidPagination, normalizeOffsetPagination, normalizePagination, offsetToPage, pageToOffset, paginateWithQueryBuilder, paginateWithRepository };
+export { type CursorPaginatedResult, type CursorPaginationParams, CursorPaginationParamsSchema, type MultiSortParams, MultiSortParamsSchema, type OffsetPaginatedResult, type OffsetPaginationParams, OffsetPaginationParamsSchema, type OffsetPaginationResult, type OffsetPaginationValidationResult, PAGINATION_DEFAULTS, type PagePaginationResult, type PaginatedResult, type PaginationDefaults, PaginationDefaultsSchema, type PaginationParams, PaginationParamsSchema, type PaginationValidationResult, type SortItem, SortItemSchema, type SortOrder, SortOrderSchema, type SortParams, SortParamsSchema, calculateOffset, calculateTotalPages, createCursorPaginatedResultSchema, createMultiSortParamsSchema, createOffsetPaginatedResultSchema, createPaginatedResult, createPaginatedResultSchema, createSortItemSchema, createSortParamsSchema, hasNextPage, hasPreviousPage, isValidLimit, isValidOffset, isValidOffsetPagination, isValidPage, isValidPageSize, isValidPagination, normalizeOffsetPagination, normalizePagination, offsetToPage, pageToOffset };

package/dist/index.mjs

@@ -1 +1 @@
-const e={page:1,pageSize:20,maxPageSize:100,minPageSize:1};function t(t){return{page:Math.max(1,Math.floor(t?.page??e.page)),pageSize:Math.min(e.maxPageSize,Math.max(e.minPageSize,Math.floor(t?.pageSize??e.pageSize)))}}function n(t){return{limit:Math.min(e.maxPageSize,Math.max(e.minPageSize,Math.floor(t?.limit??e.pageSize))),offset:Math.max(0,Math.floor(t?.offset??0))}}function r(e,t){return(e-1)*t}function i(e,t){return t<=0?0:Math.ceil(e/t)}function a(e,t){return e<t}function o(e){return e>1}function s(e,t){let n=Math.max(1,t);return{page:Math.floor(e/n)+1,pageSize:n}}function c(e,t){let n=Math.max(1,e),r=Math.max(1,t);return{offset:(n-1)*r,limit:r}}function l(e,t,n,r){let s=i(t,r);return{items:e,total:t,page:n,pageSize:r,totalPages:s,hasNextPage:a(n,s),hasPreviousPage:o(n)}}function u(e){return typeof e==`object`&&!!e}function d(e){return typeof e==`number`&&Number.isInteger(e)&&e>=1}function f(t){return typeof t==`number`&&Number.isInteger(t)&&t>=e.minPageSize&&t<=e.maxPageSize}function p(e){return typeof e==`number`&&Number.isInteger(e)&&e>=0}function m(t){return typeof t==`number`&&Number.isInteger(t)&&t>=e.minPageSize&&t<=e.maxPageSize}function h(e){if(!u(e))return!1;let t=e.page,n=e.pageSize;return(t===void 0||d(t))&&(n===void 0||f(n))}function g(e){if(!u(e))return!1;let t=e.limit,n=e.offset;return(t===void 0||m(t))&&(n===void 0||p(n))}function _(e){return e!==void 0&&`mapper`in e}function v(e,t,n,r){let s=i(t,r);return{items:e,total:t,page:n,pageSize:r,totalPages:s,hasNextPage:a(n,s),hasPreviousPage:o(n)}}async function y(e,n,i){let{page:a,pageSize:o}=t(n),s={skip:r(a,o),take:o,where:i?.where,relations:i?.relations,select:i?.select,order:i?.order??{createdAt:`DESC`}},[c,l]=await e.findAndCount(s);return _(i)?v(await Promise.all(c.map(i.mapper)),l,a,o):v(c,l,a,o)}async function b(e,n,i){let{page:a,pageSize:o}=t(n),s=r(a,o);e.skip(s).take(o);let[c,l]=await e.getManyAndCount();return v(i?await Promise.all(c.map(i)):c,l,a,o)}function x(e,t){return e.createQueryBuilder(t??e.metadata.name.toLowerCase())}export{e as PAGINATION_DEFAULTS,r as calculateOffset,i as calculateTotalPages,l as createPaginatedResult,x as createPaginationQueryBuilder,a as hasNextPage,o as hasPreviousPage,m as isValidLimit,p as isValidOffset,g as isValidOffsetPagination,d as isValidPage,f as isValidPageSize,h as isValidPagination,n as normalizeOffsetPagination,t as normalizePagination,s as offsetToPage,c as pageToOffset,b as paginateWithQueryBuilder,y as paginateWithRepository};
+import{A as e,C as t,D as n,E as r,O as i,S as a,T as o,_ as s,a as c,b as l,c as u,d,f,g as p,h as m,i as h,k as g,l as _,m as v,n as y,o as b,p as x,r as S,s as C,t as w,u as T,v as E,w as D,x as O,y as k}from"./utils-CV6Ovku6.mjs";export{n as CursorPaginationParamsSchema,p as MultiSortParamsSchema,i as OffsetPaginationParamsSchema,r as PAGINATION_DEFAULTS,g as PaginationDefaultsSchema,e as PaginationParamsSchema,s as SortItemSchema,E as SortOrderSchema,k as SortParamsSchema,C as calculateOffset,u as calculateTotalPages,t as createCursorPaginatedResultSchema,l as createMultiSortParamsSchema,D as createOffsetPaginatedResultSchema,_ as createPaginatedResult,o as createPaginatedResultSchema,O as createSortItemSchema,a as createSortParamsSchema,T as hasNextPage,d as hasPreviousPage,w as isValidLimit,y as isValidOffset,S as isValidOffsetPagination,h as isValidPage,c as isValidPageSize,b as isValidPagination,f as normalizeOffsetPagination,x as normalizePagination,v as offsetToPage,m as pageToOffset};

package/dist/typeorm.cjs

@@ -0,0 +1,129 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_utils = require('./utils-DazsDMMu.cjs');
+
+//#region src/adapters/typeorm/adapter.ts
+/**
+* 类型守卫：检查选项是否包含映射器
+*
+* @typeParam TEntity - 实体类型
+* @typeParam TDto - DTO 类型
+* @param options - 查询选项
+* @returns 是否包含映射器
+*/
+function hasMapper(options) {
+	return options !== void 0 && "mapper" in options;
+}
+/**
+* 构建分页结果
+*
+* 内部辅助函数，构建分页结果对象
+*
+* @typeParam TDto - DTO 类型
+* @param items - 数据项数组
+* @param total - 总数
+* @param page - 当前页
+* @param pageSize - 每页大小
+* @returns 分页结果
+*/
+function buildPaginatedResult(items, total, page, pageSize) {
+	/**
+	* 计算得到的总页数
+	*/
+	const totalPages = require_utils.calculateTotalPages(total, pageSize);
+	return {
+		items,
+		total,
+		page,
+		pageSize,
+		totalPages,
+		hasNextPage: require_utils.hasNextPage(page, totalPages),
+		hasPreviousPage: require_utils.hasPreviousPage(page)
+	};
+}
+/**
+* 使用 Repository 进行分页查询
+*
+* 通过 TypeORM Repository 进行分页查询，支持实体到 DTO 的映射
+*
+* 当提供 mapper 时返回映射后的 DTO，否则返回原始实体
+*
+* @typeParam TEntity - 实体类型
+* @typeParam TDto - DTO 类型
+* @param repository - TypeORM 仓库
+* @param params - 分页参数
+* @param options - 查询选项
+* @returns 分页结果
+*/
+async function paginateWithRepository(repository, params, options) {
+	/**
+	* 规范化后的分页参数
+	*/
+	const { page, pageSize } = require_utils.normalizePagination(params);
+	/**
+	* TypeORM 查询选项配置
+	*/
+	const findOptions = {
+		skip: require_utils.calculateOffset(page, pageSize),
+		take: pageSize,
+		where: options?.where,
+		relations: options?.relations,
+		select: options?.select,
+		order: options?.order ?? { createdAt: "DESC" }
+	};
+	/**
+	* 查询结果：实体数组和总数
+	*/
+	const [entities, total] = await repository.findAndCount(findOptions);
+	if (hasMapper(options)) return buildPaginatedResult(await Promise.all(entities.map(options.mapper)), total, page, pageSize);
+	return buildPaginatedResult(entities, total, page, pageSize);
+}
+/**
+* 使用 QueryBuilder 进行分页查询
+*
+* 通过 TypeORM QueryBuilder 进行分页查询，支持实体到 DTO 的映射
+*
+* 当提供 mapper 时返回映射后的 DTO，否则返回原始实体
+*
+* @typeParam TEntity - 实体类型
+* @typeParam TDto - DTO 类型
+* @param queryBuilder - TypeORM QueryBuilder
+* @param params - 分页参数
+* @param mapper - 实体到 DTO 的映射函数（可选）
+* @returns 分页结果
+*/
+async function paginateWithQueryBuilder(queryBuilder, params, mapper) {
+	/**
+	* 规范化后的分页参数
+	*/
+	const { page, pageSize } = require_utils.normalizePagination(params);
+	/**
+	* 计算得到的偏移量
+	*/
+	const offset = require_utils.calculateOffset(page, pageSize);
+	queryBuilder.skip(offset).take(pageSize);
+	/**
+	* 查询结果：实体数组和总数
+	*/
+	const [entities, total] = await queryBuilder.getManyAndCount();
+	if (mapper) return buildPaginatedResult(await Promise.all(entities.map(mapper)), total, page, pageSize);
+	return buildPaginatedResult(entities, total, page, pageSize);
+}
+/**
+* 创建分页查询构建器
+*
+* 创建一个用于分页查询的 TypeORM QueryBuilder
+*
+* @typeParam TEntity - 实体类型
+* @param repository - TypeORM 仓库
+* @param alias - 查询别名
+* @returns QueryBuilder
+*/
+function createPaginationQueryBuilder(repository, alias) {
+	return repository.createQueryBuilder(alias ?? repository.metadata.name.toLowerCase());
+}
+
+//#endregion
+exports.createPaginationQueryBuilder = createPaginationQueryBuilder;
+exports.paginateWithQueryBuilder = paginateWithQueryBuilder;
+exports.paginateWithRepository = paginateWithRepository;
+//# sourceMappingURL=typeorm.cjs.map