@longzai-intelligence/pagination 0.0.2 → 0.0.3

package/dist/index.d.mts

@@ -1,4 +1,6 @@
-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";
+import { A as createPaginationSchema, C as CursorPaginationParamsSchema, D as PaginationDefaultsSchema, E as PaginationDefaults, O as PaginationParams, S as CursorPaginationParams, T as OffsetPaginationParamsSchema, _ as createCursorPaginatedResultSchema, a as SortOrder, b as createResultSchema, c as SortParamsSchema, d as createSortParamsSchema, f as CompactPaginatedResult, g as createCompactPaginatedResultSchema, h as PaginatedResult, i as SortItemSchema, k as PaginationParamsSchema, l as createMultiSortParamsSchema, m as OffsetPaginatedResult, n as MultiSortParamsSchema, o as SortOrderSchema, p as CursorPaginatedResult, r as SortItem, s as SortParams, t as MultiSortParams, u as createSortItemSchema, v as createOffsetPaginatedResultSchema, w as OffsetPaginationParams, x as PAGINATION_DEFAULTS, y as createPaginatedResultSchema } from "./index-C4IwIpFc.mjs";
+import * as _$zod from "zod";
+import { z } from "zod";
 
 //#region src/utils/pagination.util.d.ts
 type OffsetPaginationResult = {
@@ -18,6 +20,20 @@ declare function hasPreviousPage(page: number): boolean;
 declare function offsetToPage(offset: number, limit: number): OffsetPaginationResult;
 declare function pageToOffset(page: number, pageSize: number): PagePaginationResult;
 declare function createPaginatedResult<T>(items: T[], total: number, page: number, pageSize: number): PaginatedResult<T>;
+type PaginationDefaultsOverrides = {
+  page?: number;
+  pageSize?: number;
+  maxPageSize?: number;
+  minPageSize?: number;
+};
+declare function createPaginationDefaults(overrides?: PaginationDefaultsOverrides): {
+  normalize(params?: PaginationParams): Required<PaginationParams>;
+  normalizeOffset(params?: OffsetPaginationParams): Required<OffsetPaginationParams>;
+  page: number;
+  pageSize: number;
+  maxPageSize: number;
+  minPageSize: number;
+};
 //#endregion
 //#region src/utils/validation.util.d.ts
 type PaginationValidationResult = {
@@ -35,4 +51,66 @@ 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
-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 };
+//#region src/presets/types.d.ts
+type PaginationPreset<Q, R> = {
+  querySchema: _$zod.ZodTypeAny;
+  resultSchema: _$zod.ZodTypeAny;
+  parseQuery(query: Record<string, string | undefined>): Q;
+  buildResult(...args: unknown[]): R;
+};
+type TablePresetConfig = {
+  pageSizeField?: 'pageSize' | 'limit';
+  defaultPageSize?: number;
+  maxPageSize?: number;
+  sortFields?: readonly [string, ...string[]];
+  businessFields?: Record<string, _$zod.ZodTypeAny>;
+};
+type TablePreset<Q = Record<string, unknown>> = PaginationPreset<Q, PaginatedResult<unknown>> & {
+  defaults: ReturnType<typeof createPaginationDefaults>;
+  normalize(params?: Record<string, unknown>): {
+    page: number;
+    pageSize: number;
+  };
+};
+type InfiniteScrollPresetConfig = {
+  cursorField?: string;
+  defaultPageSize?: number;
+  businessFields?: Record<string, _$zod.ZodTypeAny>;
+};
+type InfiniteScrollPreset<Q = Record<string, unknown>> = PaginationPreset<Q, CursorPaginatedResult<unknown>>;
+type TimelinePresetConfig = {
+  defaultLimit?: number;
+  maxLimit?: number;
+  businessFields?: Record<string, _$zod.ZodTypeAny>;
+};
+type TimelinePreset<Q = Record<string, unknown>> = PaginationPreset<Q, CompactPaginatedResult<unknown>>;
+type CompactListPresetConfig = {
+  mode?: 'page' | 'offset';
+  pageSizeField?: string;
+  defaultPageSize?: number;
+  businessFields?: Record<string, _$zod.ZodTypeAny>;
+};
+type CompactListPreset<Q = Record<string, unknown>> = PaginationPreset<Q, CompactPaginatedResult<unknown>>;
+//#endregion
+//#region src/presets/table.preset.d.ts
+declare function createTablePreset<TSort extends readonly [string, ...string[]], TBusiness extends Record<string, z.ZodTypeAny>>(config?: TablePresetConfig & {
+  sortFields?: TSort;
+  businessFields?: TBusiness;
+}): TablePreset;
+//#endregion
+//#region src/presets/infinite-scroll.preset.d.ts
+declare function createInfiniteScrollPreset<TBusiness extends Record<string, z.ZodTypeAny>>(config?: InfiniteScrollPresetConfig & {
+  businessFields?: TBusiness;
+}): InfiniteScrollPreset;
+//#endregion
+//#region src/presets/timeline.preset.d.ts
+declare function createTimelinePreset<TBusiness extends Record<string, z.ZodTypeAny>>(config?: TimelinePresetConfig & {
+  businessFields?: TBusiness;
+}): TimelinePreset;
+//#endregion
+//#region src/presets/compact-list.preset.d.ts
+declare function createCompactListPreset<TBusiness extends Record<string, z.ZodTypeAny>>(config?: CompactListPresetConfig & {
+  businessFields?: TBusiness;
+}): CompactListPreset;
+//#endregion
+export { type CompactListPreset, type CompactListPresetConfig, type CompactPaginatedResult, type CursorPaginatedResult, type CursorPaginationParams, CursorPaginationParamsSchema, type InfiniteScrollPreset, type InfiniteScrollPresetConfig, 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 PaginationPreset, type PaginationValidationResult, type SortItem, SortItemSchema, type SortOrder, SortOrderSchema, type SortParams, SortParamsSchema, type TablePreset, type TablePresetConfig, type TimelinePreset, type TimelinePresetConfig, calculateOffset, calculateTotalPages, createCompactListPreset, createCompactPaginatedResultSchema, createCursorPaginatedResultSchema, createInfiniteScrollPreset, createMultiSortParamsSchema, createOffsetPaginatedResultSchema, createPaginatedResult, createPaginatedResultSchema, createPaginationDefaults, createPaginationSchema, createResultSchema, createSortItemSchema, createSortParamsSchema, createTablePreset, createTimelinePreset, hasNextPage, hasPreviousPage, isValidLimit, isValidOffset, isValidOffsetPagination, isValidPage, isValidPageSize, isValidPagination, normalizeOffsetPagination, normalizePagination, offsetToPage, pageToOffset };

package/dist/index.mjs

@@ -1 +1 @@
-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};
+import{A as e,C as t,D as n,E as r,M as i,N as a,O as o,P as s,S as c,T as l,_ as u,a as d,b as f,c as p,d as m,f as h,g,h as _,i as v,j as y,k as b,l as x,m as S,n as C,o as w,p as T,r as E,s as D,t as O,u as k,v as A,w as j,x as M,y as N}from"./utils-DsM7-PZL.mjs";import{z as P}from"zod";function F(e){if(e===void 0)return;let t=Number(e);return Number.isNaN(t)?void 0:t}function I(e){let n=e?.pageSizeField??`pageSize`,r=k({pageSize:e?.defaultPageSize,maxPageSize:e?.maxPageSize}),i=s({mode:`page`,pageSizeField:n}),a=e?.sortFields?t([...e.sortFields]):P.object({}),c=i.merge(a).extend(e?.businessFields??{});return{querySchema:c,resultSchema:o(P.unknown(),{mode:`page`,pageSizeField:n}),defaults:r,normalize(e){return r.normalize({page:e?.page,pageSize:e?.[n]})},parseQuery(t){let r={};if(t.page!==void 0&&(r.page=F(t.page)),t[n]!==void 0&&(r[n]=F(t[n])),t.sortBy!==void 0&&(r.sortBy=t.sortBy),t.sortOrder!==void 0&&(r.sortOrder=t.sortOrder),e?.businessFields)for(let n of Object.keys(e.businessFields))t[n]!==void 0&&(r[n]=t[n]);return c.parse(r)},buildResult(e,t,n,r){return x(e,t,n,r)}}}function L(e){if(e===void 0)return;let t=Number(e);return Number.isNaN(t)?void 0:t}function R(e){let t=e?.cursorField??`cursor`,n=s({mode:`cursor`,cursorField:t}).extend(e?.businessFields??{});return{querySchema:n,resultSchema:o(P.unknown(),{mode:`cursor`}),parseQuery(r){let i={};if(r[t]!==void 0&&(i[t]=r[t]),r.limit!==void 0&&(i.limit=L(r.limit)),e?.businessFields)for(let t of Object.keys(e.businessFields))r[t]!==void 0&&(i[t]=r[t]);return n.parse(i)},buildResult(e,t,n){return{items:e,nextCursor:t,previousCursor:null,hasMore:n}}}}function z(e){if(e===void 0)return;let t=Number(e);return Number.isNaN(t)?void 0:t}function B(e){let t=s({mode:`offset`,fields:{limit:!0,offset:!1}}).extend(e?.businessFields??{});return{querySchema:t,resultSchema:o(P.unknown(),{mode:`compact`}),parseQuery(n){let r={};if(n.limit!==void 0&&(r.limit=z(n.limit)),e?.businessFields)for(let t of Object.keys(e.businessFields))n[t]!==void 0&&(r[t]=n[t]);return t.parse(r)},buildResult(e,t,n){return{items:e,total:t,hasMore:n}}}}function V(e){if(e===void 0)return;let t=Number(e);return Number.isNaN(t)?void 0:t}function H(e){let t=e?.mode??`page`,n=e?.pageSizeField??`pageSize`,r=s({mode:t,pageSizeField:n}).extend(e?.businessFields??{});return{querySchema:r,resultSchema:o(P.unknown(),{mode:`compact`}),parseQuery(i){let a={};if(t===`page`?(i.page!==void 0&&(a.page=V(i.page)),i[n]!==void 0&&(a[n]=V(i[n]))):(i.limit!==void 0&&(a.limit=V(i.limit)),i.offset!==void 0&&(a.offset=V(i.offset))),e?.businessFields)for(let t of Object.keys(e.businessFields))i[t]!==void 0&&(a[t]=i[t]);return r.parse(a)},buildResult(e,t,n){return{items:e,total:t,hasMore:n}}}}export{e as CursorPaginationParamsSchema,u as MultiSortParamsSchema,y as OffsetPaginationParamsSchema,b as PAGINATION_DEFAULTS,i as PaginationDefaultsSchema,a as PaginationParamsSchema,A as SortItemSchema,N as SortOrderSchema,f as SortParamsSchema,D as calculateOffset,p as calculateTotalPages,H as createCompactListPreset,j as createCompactPaginatedResultSchema,l as createCursorPaginatedResultSchema,R as createInfiniteScrollPreset,M as createMultiSortParamsSchema,r as createOffsetPaginatedResultSchema,x as createPaginatedResult,n as createPaginatedResultSchema,k as createPaginationDefaults,s as createPaginationSchema,o as createResultSchema,c as createSortItemSchema,t as createSortParamsSchema,I as createTablePreset,B as createTimelinePreset,m as hasNextPage,h as hasPreviousPage,O as isValidLimit,C as isValidOffset,E as isValidOffsetPagination,v as isValidPage,d as isValidPageSize,w as isValidPagination,T as normalizeOffsetPagination,S as normalizePagination,_ as offsetToPage,g as pageToOffset};

package/dist/typeorm.cjs

@@ -1,129 +1 @@
-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
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./utils-B200OLT-.cjs`);function t(e){return e!==void 0&&`mapper`in e}function n(t,n,r,i){let a=e.c(n,i);return{items:t,total:n,page:r,pageSize:i,totalPages:a,hasNextPage:e.d(r,a),hasPreviousPage:e.f(r)}}async function r(r,i,a){let{page:o,pageSize:s}=e.m(i),c={skip:e.s(o,s),take:s,where:a?.where,relations:a?.relations,select:a?.select,order:a?.order??{createdAt:`DESC`}},[l,u]=await r.findAndCount(c);return t(a)?n(await Promise.all(l.map(a.mapper)),u,o,s):n(l,u,o,s)}async function i(t,r,i){let{page:a,pageSize:o}=e.m(r),s=e.s(a,o);t.skip(s).take(o);let[c,l]=await t.getManyAndCount();return n(i?await Promise.all(c.map(i)):c,l,a,o)}function a(e,t){return e.createQueryBuilder(t??e.metadata.name.toLowerCase())}exports.createPaginationQueryBuilder=a,exports.paginateWithQueryBuilder=i,exports.paginateWithRepository=r;

package/dist/typeorm.d.cts

@@ -1,4 +1,4 @@
-import { T as PaginationParams, m as PaginatedResult } from "./index-CMiyhlfm.cjs";
+import { O as PaginationParams, h as PaginatedResult } from "./index-DpbbjAwO.cjs";
 import { FindManyOptions, FindOptionsOrder, ObjectLiteral, Repository, SelectQueryBuilder } from "typeorm";
 
 //#region src/adapters/typeorm/types.d.ts

package/dist/typeorm.d.mts

@@ -1,4 +1,4 @@
-import { T as PaginationParams, m as PaginatedResult } from "./index-C8FaNzej.mjs";
+import { O as PaginationParams, h as PaginatedResult } from "./index-C4IwIpFc.mjs";
 import { FindManyOptions, FindOptionsOrder, ObjectLiteral, Repository, SelectQueryBuilder } from "typeorm";
 
 //#region src/adapters/typeorm/types.d.ts

package/dist/typeorm.mjs

@@ -1 +1 @@
-import{c as e,d as t,p as n,s as r,u as i}from"./utils-CV6Ovku6.mjs";function a(e){return e!==void 0&&`mapper`in e}function o(n,r,a,o){let s=e(r,o);return{items:n,total:r,page:a,pageSize:o,totalPages:s,hasNextPage:i(a,s),hasPreviousPage:t(a)}}async function s(e,t,i){let{page:s,pageSize:c}=n(t),l={skip:r(s,c),take:c,where:i?.where,relations:i?.relations,select:i?.select,order:i?.order??{createdAt:`DESC`}},[u,d]=await e.findAndCount(l);return a(i)?o(await Promise.all(u.map(i.mapper)),d,s,c):o(u,d,s,c)}async function c(e,t,i){let{page:a,pageSize:s}=n(t),c=r(a,s);e.skip(c).take(s);let[l,u]=await e.getManyAndCount();return o(i?await Promise.all(l.map(i)):l,u,a,s)}function l(e,t){return e.createQueryBuilder(t??e.metadata.name.toLowerCase())}export{l as createPaginationQueryBuilder,c as paginateWithQueryBuilder,s as paginateWithRepository};
+import{c as e,d as t,f as n,m as r,s as i}from"./utils-DsM7-PZL.mjs";function a(e){return e!==void 0&&`mapper`in e}function o(r,i,a,o){let s=e(i,o);return{items:r,total:i,page:a,pageSize:o,totalPages:s,hasNextPage:t(a,s),hasPreviousPage:n(a)}}async function s(e,t,n){let{page:s,pageSize:c}=r(t),l={skip:i(s,c),take:c,where:n?.where,relations:n?.relations,select:n?.select,order:n?.order??{createdAt:`DESC`}},[u,d]=await e.findAndCount(l);return a(n)?o(await Promise.all(u.map(n.mapper)),d,s,c):o(u,d,s,c)}async function c(e,t,n){let{page:a,pageSize:s}=r(t),c=i(a,s);e.skip(c).take(s);let[l,u]=await e.getManyAndCount();return o(n?await Promise.all(l.map(n)):l,u,a,s)}function l(e,t){return e.createQueryBuilder(t??e.metadata.name.toLowerCase())}export{l as createPaginationQueryBuilder,c as paginateWithQueryBuilder,s as paginateWithRepository};

package/dist/utils-B200OLT-.cjs

@@ -0,0 +1 @@
+let e=require(`zod`);const t=e.z.object({page:e.z.literal(1),pageSize:e.z.literal(20),maxPageSize:e.z.literal(100),minPageSize:e.z.literal(1)}),n=e.z.object({page:e.z.number().int().positive().optional(),pageSize:e.z.number().int().positive().optional()}),r=e.z.object({limit:e.z.number().int().positive().optional(),offset:e.z.number().int().nonnegative().optional()}),i=e.z.object({cursor:e.z.string().optional(),limit:e.z.number().int().positive().optional()});function a(t){let{mode:n,pageSizeField:r=`pageSize`,cursorField:i=`cursor`,fields:a}=t;if(n===`page`){let t=a?.page===!1?{}:{page:e.z.number().int().positive().optional()},n=a?.pageSize===!1?{}:{[r]:e.z.number().int().positive().optional()};return e.z.object({...t,...n})}if(n===`offset`){let t=a?.limit===!1?{}:{limit:e.z.number().int().positive().optional()},n=a?.offset===!1?{}:{offset:e.z.number().int().nonnegative().optional()};return e.z.object({...t,...n})}if(n===`cursor`){let t=a?.cursor===!1?{}:{[i]:e.z.string().optional()},n=a?.limit===!1?{}:{limit:e.z.number().int().positive().optional()};return e.z.object({...t,...n})}throw Error(`不支持的分页模式: ${n}`)}const o={page:1,pageSize:20,maxPageSize:100,minPageSize:1};function s(t){return e.z.object({items:e.z.array(t),total:e.z.number().int().nonnegative(),page:e.z.number().int().positive(),pageSize:e.z.number().int().positive(),totalPages:e.z.number().int().nonnegative(),hasNextPage:e.z.boolean(),hasPreviousPage:e.z.boolean()})}function c(t){return e.z.object({items:e.z.array(t),total:e.z.number().int().nonnegative(),limit:e.z.number().int().nonnegative(),offset:e.z.number().int().nonnegative(),hasMore:e.z.boolean()})}function l(t){return e.z.object({items:e.z.array(t),nextCursor:e.z.string().nullable(),previousCursor:e.z.string().nullable(),hasMore:e.z.boolean()})}function u(t){return e.z.object({items:e.z.array(t),total:e.z.number().int().nonnegative(),hasMore:e.z.boolean()})}function d(t,n){let{mode:r,pageSizeField:i=`pageSize`}=n;if(r===`page`)return e.z.object({items:e.z.array(t),total:e.z.number().int().nonnegative(),page:e.z.number().int().positive(),[i]:e.z.number().int().positive(),totalPages:e.z.number().int().nonnegative(),hasNextPage:e.z.boolean(),hasPreviousPage:e.z.boolean()});if(r===`offset`)return e.z.object({items:e.z.array(t),total:e.z.number().int().nonnegative(),limit:e.z.number().int().nonnegative(),offset:e.z.number().int().nonnegative(),hasMore:e.z.boolean()});if(r===`cursor`)return e.z.object({items:e.z.array(t),nextCursor:e.z.string().nullable(),previousCursor:e.z.string().nullable(),hasMore:e.z.boolean()});if(r===`compact`)return e.z.object({items:e.z.array(t),total:e.z.number().int().nonnegative(),hasMore:e.z.boolean()});throw Error(`不支持的结果模式: ${r}`)}const f=e.z.enum([`asc`,`desc`]);function p(t){return e.z.object({sortBy:e.z.enum(t).optional(),sortOrder:f.optional()})}const m=e.z.object({sortBy:e.z.string().optional(),sortOrder:f.optional()});function h(t){return e.z.object({field:e.z.enum(t),order:f})}const g=e.z.object({field:e.z.string(),order:f});function _(t){return e.z.object({sort:e.z.array(h(t)).optional()})}const v=e.z.object({sort:e.z.array(g).optional()});function y(e){return{page:Math.max(1,Math.floor(e?.page??o.page)),pageSize:Math.min(o.maxPageSize,Math.max(o.minPageSize,Math.floor(e?.pageSize??o.pageSize)))}}function b(e){return{limit:Math.min(o.maxPageSize,Math.max(o.minPageSize,Math.floor(e?.limit??o.pageSize))),offset:Math.max(0,Math.floor(e?.offset??0))}}function x(e,t){return(e-1)*t}function S(e,t){return t<=0?0:Math.ceil(e/t)}function C(e,t){return e<t}function w(e){return e>1}function T(e,t){let n=Math.max(1,t);return{page:Math.floor(e/n)+1,pageSize:n}}function E(e,t){let n=Math.max(1,e),r=Math.max(1,t);return{offset:(n-1)*r,limit:r}}function D(e,t,n,r){let i=S(t,r);return{items:e,total:t,page:n,pageSize:r,totalPages:i,hasNextPage:C(n,i),hasPreviousPage:w(n)}}function O(e){let t={page:e?.page??o.page,pageSize:e?.pageSize??o.pageSize,maxPageSize:e?.maxPageSize??o.maxPageSize,minPageSize:e?.minPageSize??o.minPageSize};return{...t,normalize(e){return{page:Math.max(1,Math.floor(e?.page??t.page)),pageSize:Math.min(t.maxPageSize,Math.max(t.minPageSize,Math.floor(e?.pageSize??t.pageSize)))}},normalizeOffset(e){return{limit:Math.min(t.maxPageSize,Math.max(t.minPageSize,Math.floor(e?.limit??t.pageSize))),offset:Math.max(0,Math.floor(e?.offset??0))}}}}function k(e){return typeof e==`object`&&!!e}function A(e){return typeof e==`number`&&Number.isInteger(e)&&e>=1}function j(e){return typeof e==`number`&&Number.isInteger(e)&&e>=o.minPageSize&&e<=o.maxPageSize}function M(e){return typeof e==`number`&&Number.isInteger(e)&&e>=0}function N(e){return typeof e==`number`&&Number.isInteger(e)&&e>=o.minPageSize&&e<=o.maxPageSize}function P(e){if(!k(e))return!1;let t=e.page,n=e.pageSize;return(t===void 0||A(t))&&(n===void 0||j(n))}function F(e){if(!k(e))return!1;let t=e.limit,n=e.offset;return(t===void 0||N(t))&&(n===void 0||M(n))}Object.defineProperty(exports,`A`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`C`,{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,`D`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`E`,{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,`M`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`N`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`O`,{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,`P`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`S`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`T`,{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,`_`,{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return j}}),Object.defineProperty(exports,`b`,{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,`d`,{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,`f`,{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,`g`,{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,`h`,{enumerable:!0,get:function(){return T}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,`j`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`k`,{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return D}}),Object.defineProperty(exports,`m`,{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return M}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return P}}),Object.defineProperty(exports,`p`,{enumerable:!0,get:function(){return b}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return F}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return x}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return N}}),Object.defineProperty(exports,`u`,{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,`v`,{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,`w`,{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,`x`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`y`,{enumerable:!0,get:function(){return f}});

package/dist/utils-DsM7-PZL.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";const t=e.object({page:e.literal(1),pageSize:e.literal(20),maxPageSize:e.literal(100),minPageSize:e.literal(1)}),n=e.object({page:e.number().int().positive().optional(),pageSize:e.number().int().positive().optional()}),r=e.object({limit:e.number().int().positive().optional(),offset:e.number().int().nonnegative().optional()}),i=e.object({cursor:e.string().optional(),limit:e.number().int().positive().optional()});function a(t){let{mode:n,pageSizeField:r=`pageSize`,cursorField:i=`cursor`,fields:a}=t;if(n===`page`){let t=a?.page===!1?{}:{page:e.number().int().positive().optional()},n=a?.pageSize===!1?{}:{[r]:e.number().int().positive().optional()};return e.object({...t,...n})}if(n===`offset`){let t=a?.limit===!1?{}:{limit:e.number().int().positive().optional()},n=a?.offset===!1?{}:{offset:e.number().int().nonnegative().optional()};return e.object({...t,...n})}if(n===`cursor`){let t=a?.cursor===!1?{}:{[i]:e.string().optional()},n=a?.limit===!1?{}:{limit:e.number().int().positive().optional()};return e.object({...t,...n})}throw Error(`不支持的分页模式: ${n}`)}const o={page:1,pageSize:20,maxPageSize:100,minPageSize:1};function s(t){return e.object({items:e.array(t),total:e.number().int().nonnegative(),page:e.number().int().positive(),pageSize:e.number().int().positive(),totalPages:e.number().int().nonnegative(),hasNextPage:e.boolean(),hasPreviousPage:e.boolean()})}function c(t){return e.object({items:e.array(t),total:e.number().int().nonnegative(),limit:e.number().int().nonnegative(),offset:e.number().int().nonnegative(),hasMore:e.boolean()})}function l(t){return e.object({items:e.array(t),nextCursor:e.string().nullable(),previousCursor:e.string().nullable(),hasMore:e.boolean()})}function u(t){return e.object({items:e.array(t),total:e.number().int().nonnegative(),hasMore:e.boolean()})}function d(t,n){let{mode:r,pageSizeField:i=`pageSize`}=n;if(r===`page`)return e.object({items:e.array(t),total:e.number().int().nonnegative(),page:e.number().int().positive(),[i]:e.number().int().positive(),totalPages:e.number().int().nonnegative(),hasNextPage:e.boolean(),hasPreviousPage:e.boolean()});if(r===`offset`)return e.object({items:e.array(t),total:e.number().int().nonnegative(),limit:e.number().int().nonnegative(),offset:e.number().int().nonnegative(),hasMore:e.boolean()});if(r===`cursor`)return e.object({items:e.array(t),nextCursor:e.string().nullable(),previousCursor:e.string().nullable(),hasMore:e.boolean()});if(r===`compact`)return e.object({items:e.array(t),total:e.number().int().nonnegative(),hasMore:e.boolean()});throw Error(`不支持的结果模式: ${r}`)}const f=e.enum([`asc`,`desc`]);function p(t){return e.object({sortBy:e.enum(t).optional(),sortOrder:f.optional()})}const m=e.object({sortBy:e.string().optional(),sortOrder:f.optional()});function h(t){return e.object({field:e.enum(t),order:f})}const g=e.object({field:e.string(),order:f});function _(t){return e.object({sort:e.array(h(t)).optional()})}const v=e.object({sort:e.array(g).optional()});function y(e){return{page:Math.max(1,Math.floor(e?.page??o.page)),pageSize:Math.min(o.maxPageSize,Math.max(o.minPageSize,Math.floor(e?.pageSize??o.pageSize)))}}function b(e){return{limit:Math.min(o.maxPageSize,Math.max(o.minPageSize,Math.floor(e?.limit??o.pageSize))),offset:Math.max(0,Math.floor(e?.offset??0))}}function x(e,t){return(e-1)*t}function S(e,t){return t<=0?0:Math.ceil(e/t)}function C(e,t){return e<t}function w(e){return e>1}function T(e,t){let n=Math.max(1,t);return{page:Math.floor(e/n)+1,pageSize:n}}function E(e,t){let n=Math.max(1,e),r=Math.max(1,t);return{offset:(n-1)*r,limit:r}}function D(e,t,n,r){let i=S(t,r);return{items:e,total:t,page:n,pageSize:r,totalPages:i,hasNextPage:C(n,i),hasPreviousPage:w(n)}}function O(e){let t={page:e?.page??o.page,pageSize:e?.pageSize??o.pageSize,maxPageSize:e?.maxPageSize??o.maxPageSize,minPageSize:e?.minPageSize??o.minPageSize};return{...t,normalize(e){return{page:Math.max(1,Math.floor(e?.page??t.page)),pageSize:Math.min(t.maxPageSize,Math.max(t.minPageSize,Math.floor(e?.pageSize??t.pageSize)))}},normalizeOffset(e){return{limit:Math.min(t.maxPageSize,Math.max(t.minPageSize,Math.floor(e?.limit??t.pageSize))),offset:Math.max(0,Math.floor(e?.offset??0))}}}}function k(e){return typeof e==`object`&&!!e}function A(e){return typeof e==`number`&&Number.isInteger(e)&&e>=1}function j(e){return typeof e==`number`&&Number.isInteger(e)&&e>=o.minPageSize&&e<=o.maxPageSize}function M(e){return typeof e==`number`&&Number.isInteger(e)&&e>=0}function N(e){return typeof e==`number`&&Number.isInteger(e)&&e>=o.minPageSize&&e<=o.maxPageSize}function P(e){if(!k(e))return!1;let t=e.page,n=e.pageSize;return(t===void 0||A(t))&&(n===void 0||j(n))}function F(e){if(!k(e))return!1;let t=e.limit,n=e.offset;return(t===void 0||N(t))&&(n===void 0||M(n))}export{i as A,p as C,s as D,c as E,t as M,n as N,d as O,a as P,h as S,l as T,v as _,j as a,m as b,S as c,C as d,w as f,E as g,T as h,A as i,r as j,o as k,D as l,y as m,M as n,P as o,b as p,F as r,x as s,N as t,O as u,g as v,u as w,_ as x,f as y};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longzai-intelligence/pagination",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "main": "./dist/index.cjs",
   "types": "./dist/index.d.mts",
@@ -14,14 +14,22 @@
       "require": "./dist/index.cjs"
     },
     "./typeorm": {
-      "types": {
-        "import": "./dist/typeorm.d.mts",
-        "require": "./dist/typeorm.d.cts"
-      },
+      "types": "./dist/typeorm.d.mts",
       "import": "./dist/typeorm.mjs",
       "require": "./dist/typeorm.cjs"
+    },
+    "./hono": {
+      "types": {
+        "import": "./dist/hono.d.mts",
+        "require": "./dist/hono.d.cts"
+      },
+      "import": "./dist/hono.mjs",
+      "require": "./dist/hono.cjs"
     }
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsdown",
     "build:prod": "NODE_ENV=production tsdown",
@@ -40,10 +48,14 @@
     "upgrade-deps": "ncu -u"
   },
   "peerDependencies": {
+    "hono": "^4.0.0",
     "typeorm": "^0.3.0",
     "zod": "^4.0.0"
   },
   "peerDependenciesMeta": {
+    "hono": {
+      "optional": true
+    },
     "typeorm": {
       "optional": true
     },
@@ -52,13 +64,13 @@
     }
   },
   "devDependencies": {
-    "@types/bun": "1.3.11",
+    "@types/bun": "1.3.12",
     "@types/node": "^25.6.0",
     "eslint": "^10.2.0",
     "rimraf": "^6.1.3",
     "typescript": "^6.0.2",
     "vitest": "^4.1.4",
-    "@longzai-intelligence/eslint-preset-library": "0.0.5",
+    "@longzai-intelligence/eslint-preset-library": "0.0.6",
     "@longzai-intelligence/vitest-config": "0.0.7",
     "@longzai-intelligence/typescript-config": "0.0.3",
     "tsdown": "^0.21.7",

package/.turbo/turbo-build.log

@@ -1,22 +0,0 @@
-$ tsdown
-ℹ tsdown v0.21.7 powered by rolldown v1.0.0-rc.12
-ℹ config file: /Volumes/JZAO/j-projects/workspaces/longzai/longzai-intelligence/longzai-intelligence/packages/pagination/tsdown.config.ts 
-(node:10081) ExperimentalWarning: Type Stripping is an experimental feature and might change at any time
-(Use `node --trace-warnings ...` to show where the warning was created)
-ℹ entry: src/index.ts
-ℹ tsconfig: tsconfig/app.json
-ℹ Build start
-ℹ Cleaning 8 files
-ℹ [CJS] dist/index.cjs       9.63 kB │ gzip: 2.45 kB
-ℹ [CJS] dist/index.cjs.map  19.04 kB │ gzip: 4.55 kB
-ℹ [CJS] 2 files, total: 28.66 kB
-ℹ [CJS] dist/index.d.cts.map  2.74 kB │ gzip: 0.82 kB
-ℹ [CJS] dist/index.d.cts      5.36 kB │ gzip: 1.21 kB
-ℹ [CJS] 2 files, total: 8.10 kB
-✔ Build complete in 647ms
-ℹ [ESM] dist/index.mjs         9.02 kB │ gzip: 2.33 kB
-ℹ [ESM] dist/index.mjs.map    19.04 kB │ gzip: 4.55 kB
-ℹ [ESM] dist/index.d.mts.map   2.74 kB │ gzip: 0.82 kB
-ℹ [ESM] dist/index.d.mts       5.36 kB │ gzip: 1.21 kB
-ℹ [ESM] 4 files, total: 36.16 kB
-✔ Build complete in 648ms

package/.turbo/turbo-lint.log

@@ -1 +0,0 @@
-$ eslint .

package/.turbo/turbo-test$colon$coverage.log

@@ -1,36 +0,0 @@
-$ vitest run --coverage
-
- RUN  v4.1.4 /Volumes/JZAO/j-projects/workspaces/longzai/longzai-intelligence/longzai-intelligence/packages/pagination
-      Coverage enabled with v8
-
- ✓ src/__tests__/validation.util.test.ts (12 tests) 3ms
- ✓ src/__tests__/pagination.util.test.ts (41 tests) 5ms
- ✓ src/__tests__/index.test.ts (6 tests) 30ms
- ✓ src/__tests__/typeorm.adapter.test.ts (9 tests) 7ms
-
- Test Files  4 passed (4)
-      Tests  68 passed (68)
-   Start at  10:06:41
-   Duration  196ms (transform 144ms, setup 0ms, import 171ms, tests 46ms, environment 0ms)
-
- % Coverage report from v8
--------------------|---------|----------|---------|---------|-------------------
-File               | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s 
--------------------|---------|----------|---------|---------|-------------------
-All files          |     100 |      100 |     100 |     100 |                   
- src               |       0 |        0 |       0 |       0 |                   
-  index.ts         |       0 |        0 |       0 |       0 |                   
- src/adapters      |     100 |      100 |     100 |     100 |                   
-  index.ts         |       0 |        0 |       0 |       0 |                   
-  ...rm.adapter.ts |     100 |      100 |     100 |     100 |                   
- src/types         |     100 |      100 |     100 |     100 |                   
-  index.ts         |       0 |        0 |       0 |       0 |                   
-  ...tion.types.ts |     100 |      100 |     100 |     100 |                   
-  result.types.ts  |       0 |        0 |       0 |       0 |                   
-  sort.types.ts    |       0 |        0 |       0 |       0 |                   
-  typeorm.d.ts     |       0 |        0 |       0 |       0 |                   
- src/utils         |     100 |      100 |     100 |     100 |                   
-  index.ts         |       0 |        0 |       0 |       0 |                   
-  ...ation.util.ts |     100 |      100 |     100 |     100 |                   
-  ...ation.util.ts |     100 |      100 |     100 |     100 |                   
--------------------|---------|----------|---------|---------|-------------------

package/.turbo/turbo-test.log

@@ -1,14 +0,0 @@
-$ vitest run
-
- RUN  v4.1.4 /Volumes/JZAO/j-projects/workspaces/longzai/longzai-intelligence/longzai-intelligence/packages/pagination
-
- ✓ src/__tests__/validation.util.test.ts (12 tests) 3ms
- ✓ src/__tests__/pagination.util.test.ts (41 tests) 3ms
- ✓ src/__tests__/typeorm.adapter.test.ts (9 tests) 4ms
- ✓ src/__tests__/index.test.ts (6 tests) 16ms
-
- Test Files  4 passed (4)
-      Tests  68 passed (68)
-   Start at  10:06:38
-   Duration  136ms (transform 101ms, setup 0ms, import 121ms, tests 26ms, environment 0ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-$ bun run typecheck:app && bun run typecheck:node && bun run typecheck:test
-$ tsc --noEmit -p tsconfig/app.json
-$ tsc --noEmit -p tsconfig/node.json
-$ tsc --noEmit -p tsconfig/test.json

package/CHANGELOG.md

@@ -1,18 +0,0 @@
-# Changelog
-
-## [0.0.2] - 2026-04-13
-
-### 新增功能
-
-- 添加 Zod schemas 用于分页和排序验证
-- 添加 TypeORM 适配器子路径导出
-
-## [0.0.1] - 2026-04-10
-
-### 功能
-
-- 分页类型定义：PaginationParams、OffsetPaginationParams、CursorPaginationParams
-- 排序类型定义：SortOrder、SortParams、MultiSortParams
-- 分页工具函数：normalizePagination、calculateOffset、hasNextPage 等
-- 校验工具函数：isValidPage、isValidPageSize、isValidOffset 等
-- TypeORM 适配器：paginateWithRepository、paginateWithQueryBuilder、createPaginationQueryBuilder