@longzai-intelligence/pagination 0.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,22 @@
+$ 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:62059) 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 679ms
+ℹ [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 680ms

package/.turbo/turbo-lint.log

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

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

@@ -0,0 +1,36 @@
+$ vitest run --coverage
+
+ RUN  v4.1.3 /Volumes/JZAO/j-projects/workspaces/longzai/longzai-intelligence/longzai-intelligence/packages/pagination
+      Coverage enabled with v8
+
+ ✓ src/__tests__/pagination.util.test.ts (41 tests) 3ms
+ ✓ src/__tests__/index.test.ts (6 tests) 14ms
+ ✓ src/__tests__/validation.util.test.ts (12 tests) 3ms
+ ✓ src/__tests__/typeorm.adapter.test.ts (9 tests) 4ms
+
+ Test Files  4 passed (4)
+      Tests  68 passed (68)
+   Start at  01:27:15
+   Duration  162ms (transform 99ms, setup 0ms, import 126ms, tests 24ms, 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

@@ -0,0 +1,14 @@
+$ vitest run
+
+ RUN  v4.1.3 /Volumes/JZAO/j-projects/workspaces/longzai/longzai-intelligence/longzai-intelligence/packages/pagination
+
+ ✓ src/__tests__/validation.util.test.ts (12 tests) 4ms
+ ✓ src/__tests__/pagination.util.test.ts (41 tests) 6ms
+ ✓ src/__tests__/typeorm.adapter.test.ts (9 tests) 7ms
+ ✓ src/__tests__/index.test.ts (6 tests) 22ms
+
+ Test Files  4 passed (4)
+      Tests  68 passed (68)
+   Start at  01:27:13
+   Duration  162ms (transform 133ms, setup 0ms, import 153ms, tests 38ms, environment 0ms)
+

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+$ 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

@@ -0,0 +1,11 @@
+# Changelog
+
+## [0.0.1] - 2026-04-10
+
+### 功能
+
+- 分页类型定义：PaginationParams、OffsetPaginationParams、CursorPaginationParams
+- 排序类型定义：SortOrder、SortParams、MultiSortParams
+- 分页工具函数：normalizePagination、calculateOffset、hasNextPage 等
+- 校验工具函数：isValidPage、isValidPageSize、isValidOffset 等
+- TypeORM 适配器：paginateWithRepository、paginateWithQueryBuilder、createPaginationQueryBuilder

package/README.md

@@ -0,0 +1,218 @@
+# @longzai-intelligence/pagination
+
+统一的分页功能包，提供类型安全的分页参数、结果类型和工具函数。
+
+## 安装
+
+```bash
+bun add @longzai-intelligence/pagination
+```
+
+## 特性
+
+- 类型安全的分页参数定义
+- 支持 page/pageSize 和 limit/offset 两种分页风格
+- 支持游标分页
+- 提供参数验证工具
+- 提供 TypeORM 适配器（可选）
+
+## 快速开始
+
+### 基本使用
+
+```typescript
+import {
+  normalizePagination,
+  calculateOffset,
+  createPaginatedResult,
+  type PaginationParams,
+  type PaginatedResult,
+} from '@longzai-intelligence/pagination';
+
+// 规范化分页参数
+const params: PaginationParams = { page: 2, pageSize: 20 };
+const { page, pageSize } = normalizePagination(params);
+
+// 计算偏移量
+const offset = calculateOffset(page, pageSize);
+
+// 创建分页结果
+const result: PaginatedResult<User> = createPaginatedResult(
+  users,
+  total,
+  page,
+  pageSize,
+);
+```
+
+### 参数验证
+
+```typescript
+import {
+  isValidPage,
+  isValidPageSize,
+  isValidPagination,
+} from '@longzai-intelligence/pagination';
+
+if (isValidPagination(params)) {
+  // 参数有效
+}
+
+if (isValidPage(1) && isValidPageSize(20)) {
+  // 页码和页面大小有效
+}
+```
+
+### TypeORM 适配器
+
+```typescript
+import {
+  paginateWithRepository,
+  paginateWithQueryBuilder,
+} from '@longzai-intelligence/pagination';
+
+// 使用 Repository 分页
+const result = await paginateWithRepository(userRepository, {
+  page: 1,
+  pageSize: 20,
+}, {
+  where: { active: true },
+  order: { createdAt: 'DESC' },
+});
+
+// 使用 QueryBuilder 分页
+const qb = userRepository.createQueryBuilder('user');
+const result = await paginateWithQueryBuilder(qb, { page: 1, pageSize: 20 });
+```
+
+## API 文档
+
+### 类型
+
+#### PaginationParams
+
+```typescript
+interface PaginationParams {
+  page?: number;      // 页码，从 1 开始
+  pageSize?: number;  // 每页数量
+}
+```
+
+#### OffsetPaginationParams
+
+```typescript
+interface OffsetPaginationParams {
+  limit?: number;   // 每页数量
+  offset?: number;  // 偏移量
+}
+```
+
+#### PaginatedResult
+
+```typescript
+interface PaginatedResult<T> {
+  items: T[];           // 数据项
+  total: number;        // 总记录数
+  page: number;         // 当前页码
+  pageSize: number;     // 每页数量
+  totalPages: number;   // 总页数
+  hasNextPage: boolean;    // 是否有下一页
+  hasPreviousPage: boolean; // 是否有上一页
+}
+```
+
+#### SortParams
+
+```typescript
+interface SortParams<T extends string = string> {
+  sortBy?: T;                 // 排序字段
+  sortOrder?: 'asc' | 'desc'; // 排序方向
+}
+```
+
+### 常量
+
+#### PAGINATION_DEFAULTS
+
+```typescript
+const PAGINATION_DEFAULTS = {
+  page: 1,
+  pageSize: 20,
+  maxPageSize: 100,
+  minPageSize: 1,
+} as const;
+```
+
+### 工具函数
+
+#### normalizePagination(params?)
+
+规范化分页参数，确保参数在有效范围内。
+
+```typescript
+const { page, pageSize } = normalizePagination({ page: 2, pageSize: 50 });
+```
+
+#### calculateOffset(page, pageSize)
+
+计算偏移量。
+
+```typescript
+const offset = calculateOffset(2, 20); // 20
+```
+
+#### calculateTotalPages(total, pageSize)
+
+计算总页数。
+
+```typescript
+const totalPages = calculateTotalPages(100, 20); // 5
+```
+
+#### hasNextPage(page, totalPages) / hasPreviousPage(page)
+
+判断是否有下一页/上一页。
+
+```typescript
+hasNextPage(1, 5);     // true
+hasPreviousPage(1);    // false
+```
+
+#### offsetToPage(offset, limit) / pageToOffset(page, pageSize)
+
+分页风格转换。
+
+```typescript
+offsetToPage(20, 20);  // { page: 2, pageSize: 20 }
+pageToOffset(2, 20);   // { offset: 20, limit: 20 }
+```
+
+### 验证函数
+
+#### isValidPage(page)
+
+验证页码是否有效（正整数）。
+
+#### isValidPageSize(pageSize)
+
+验证每页数量是否有效（1-100 之间的整数）。
+
+#### isValidOffset(offset)
+
+验证偏移量是否有效（非负整数）。
+
+#### isValidLimit(limit)
+
+验证限制数量是否有效（1-100 之间的整数）。
+
+#### isValidPagination(params)
+
+验证分页参数对象是否有效。
+
+#### isValidOffsetPagination(params)
+
+验证 offset 分页参数对象是否有效。
+
+## 许可证
+
+MIT

package/coverage/base.css

@@ -0,0 +1,224 @@
+body, html {
+  margin:0; padding: 0;
+  height: 100%;
+}
+body {
+    font-family: Helvetica Neue, Helvetica, Arial;
+    font-size: 14px;
+    color:#333;
+}
+.small { font-size: 12px; }
+*, *:after, *:before {
+  -webkit-box-sizing:border-box;
+     -moz-box-sizing:border-box;
+          box-sizing:border-box;
+  }
+h1 { font-size: 20px; margin: 0;}
+h2 { font-size: 14px; }
+pre {
+    font: 12px/1.4 Consolas, "Liberation Mono", Menlo, Courier, monospace;
+    margin: 0;
+    padding: 0;
+    -moz-tab-size: 2;
+    -o-tab-size:  2;
+    tab-size: 2;
+}
+a { color:#0074D9; text-decoration:none; }
+a:hover { text-decoration:underline; }
+.strong { font-weight: bold; }
+.space-top1 { padding: 10px 0 0 0; }
+.pad2y { padding: 20px 0; }
+.pad1y { padding: 10px 0; }
+.pad2x { padding: 0 20px; }
+.pad2 { padding: 20px; }
+.pad1 { padding: 10px; }
+.space-left2 { padding-left:55px; }
+.space-right2 { padding-right:20px; }
+.center { text-align:center; }
+.clearfix { display:block; }
+.clearfix:after {
+  content:'';
+  display:block;
+  height:0;
+  clear:both;
+  visibility:hidden;
+  }
+.fl { float: left; }
+@media only screen and (max-width:640px) {
+  .col3 { width:100%; max-width:100%; }
+  .hide-mobile { display:none!important; }
+}
+
+.quiet {
+  color: #7f7f7f;
+  color: rgba(0,0,0,0.5);
+}
+.quiet a { opacity: 0.7; }
+
+.fraction {
+  font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace;
+  font-size: 10px;
+  color: #555;
+  background: #E8E8E8;
+  padding: 4px 5px;
+  border-radius: 3px;
+  vertical-align: middle;
+}
+
+div.path a:link, div.path a:visited { color: #333; }
+table.coverage {
+  border-collapse: collapse;
+  margin: 10px 0 0 0;
+  padding: 0;
+}
+
+table.coverage td {
+  margin: 0;
+  padding: 0;
+  vertical-align: top;
+}
+table.coverage td.line-count {
+    text-align: right;
+    padding: 0 5px 0 20px;
+}
+table.coverage td.line-coverage {
+    text-align: right;
+    padding-right: 10px;
+    min-width:20px;
+}
+
+table.coverage td span.cline-any {
+    display: inline-block;
+    padding: 0 5px;
+    width: 100%;
+}
+.missing-if-branch {
+    display: inline-block;
+    margin-right: 5px;
+    border-radius: 3px;
+    position: relative;
+    padding: 0 4px;
+    background: #333;
+    color: yellow;
+}
+
+.skip-if-branch {
+    display: none;
+    margin-right: 10px;
+    position: relative;
+    padding: 0 4px;
+    background: #ccc;
+    color: white;
+}
+.missing-if-branch .typ, .skip-if-branch .typ {
+    color: inherit !important;
+}
+.coverage-summary {
+  border-collapse: collapse;
+  width: 100%;
+}
+.coverage-summary tr { border-bottom: 1px solid #bbb; }
+.keyline-all { border: 1px solid #ddd; }
+.coverage-summary td, .coverage-summary th { padding: 10px; }
+.coverage-summary tbody { border: 1px solid #bbb; }
+.coverage-summary td { border-right: 1px solid #bbb; }
+.coverage-summary td:last-child { border-right: none; }
+.coverage-summary th {
+  text-align: left;
+  font-weight: normal;
+  white-space: nowrap;
+}
+.coverage-summary th.file { border-right: none !important; }
+.coverage-summary th.pct { }
+.coverage-summary th.pic,
+.coverage-summary th.abs,
+.coverage-summary td.pct,
+.coverage-summary td.abs { text-align: right; }
+.coverage-summary td.file { white-space: nowrap;  }
+.coverage-summary td.pic { min-width: 120px !important;  }
+.coverage-summary tfoot td { }
+
+.coverage-summary .sorter {
+    height: 10px;
+    width: 7px;
+    display: inline-block;
+    margin-left: 0.5em;
+    background: url(sort-arrow-sprite.png) no-repeat scroll 0 0 transparent;
+}
+.coverage-summary .sorted .sorter {
+    background-position: 0 -20px;
+}
+.coverage-summary .sorted-desc .sorter {
+    background-position: 0 -10px;
+}
+.status-line {  height: 10px; }
+/* yellow */
+.cbranch-no { background: yellow !important; color: #111; }
+/* dark red */
+.red.solid, .status-line.low, .low .cover-fill { background:#C21F39 }
+.low .chart { border:1px solid #C21F39 }
+.highlighted,
+.highlighted .cstat-no, .highlighted .fstat-no, .highlighted .cbranch-no{
+  background: #C21F39 !important;
+}
+/* medium red */
+.cstat-no, .fstat-no, .cbranch-no, .cbranch-no { background:#F6C6CE }
+/* light red */
+.low, .cline-no { background:#FCE1E5 }
+/* light green */
+.high, .cline-yes { background:rgb(230,245,208) }
+/* medium green */
+.cstat-yes { background:rgb(161,215,106) }
+/* dark green */
+.status-line.high, .high .cover-fill { background:rgb(77,146,33) }
+.high .chart { border:1px solid rgb(77,146,33) }
+/* dark yellow (gold) */
+.status-line.medium, .medium .cover-fill { background: #f9cd0b; }
+.medium .chart { border:1px solid #f9cd0b; }
+/* light yellow */
+.medium { background: #fff4c2; }
+
+.cstat-skip { background: #ddd; color: #111; }
+.fstat-skip { background: #ddd; color: #111 !important; }
+.cbranch-skip { background: #ddd !important; color: #111; }
+
+span.cline-neutral { background: #eaeaea; }
+
+.coverage-summary td.empty {
+    opacity: .5;
+    padding-top: 4px;
+    padding-bottom: 4px;
+    line-height: 1;
+    color: #888;
+}
+
+.cover-fill, .cover-empty {
+  display:inline-block;
+  height: 12px;
+}
+.chart {
+  line-height: 0;
+}
+.cover-empty {
+    background: white;
+}
+.cover-full {
+    border-right: none !important;
+}
+pre.prettyprint {
+    border: none !important;
+    padding: 0 !important;
+    margin: 0 !important;
+}
+.com { color: #999 !important; }
+.ignore-none { color: #999; font-weight: normal; }
+
+.wrapper {
+  min-height: 100%;
+  height: auto !important;
+  height: 100%;
+  margin: 0 auto -48px;
+}
+.footer, .push {
+  height: 48px;
+}

package/coverage/block-navigation.js

@@ -0,0 +1,87 @@
+/* eslint-disable */
+var jumpToCode = (function init() {
+    // Classes of code we would like to highlight in the file view
+    var missingCoverageClasses = ['.cbranch-no', '.cstat-no', '.fstat-no'];
+
+    // Elements to highlight in the file listing view
+    var fileListingElements = ['td.pct.low'];
+
+    // We don't want to select elements that are direct descendants of another match
+    var notSelector = ':not(' + missingCoverageClasses.join('):not(') + ') > '; // becomes `:not(a):not(b) > `
+
+    // Selector that finds elements on the page to which we can jump
+    var selector =
+        fileListingElements.join(', ') +
+        ', ' +
+        notSelector +
+        missingCoverageClasses.join(', ' + notSelector); // becomes `:not(a):not(b) > a, :not(a):not(b) > b`
+
+    // The NodeList of matching elements
+    var missingCoverageElements = document.querySelectorAll(selector);
+
+    var currentIndex;
+
+    function toggleClass(index) {
+        missingCoverageElements
+            .item(currentIndex)
+            .classList.remove('highlighted');
+        missingCoverageElements.item(index).classList.add('highlighted');
+    }
+
+    function makeCurrent(index) {
+        toggleClass(index);
+        currentIndex = index;
+        missingCoverageElements.item(index).scrollIntoView({
+            behavior: 'smooth',
+            block: 'center',
+            inline: 'center'
+        });
+    }
+
+    function goToPrevious() {
+        var nextIndex = 0;
+        if (typeof currentIndex !== 'number' || currentIndex === 0) {
+            nextIndex = missingCoverageElements.length - 1;
+        } else if (missingCoverageElements.length > 1) {
+            nextIndex = currentIndex - 1;
+        }
+
+        makeCurrent(nextIndex);
+    }
+
+    function goToNext() {
+        var nextIndex = 0;
+
+        if (
+            typeof currentIndex === 'number' &&
+            currentIndex < missingCoverageElements.length - 1
+        ) {
+            nextIndex = currentIndex + 1;
+        }
+
+        makeCurrent(nextIndex);
+    }
+
+    return function jump(event) {
+        if (
+            document.getElementById('fileSearch') === document.activeElement &&
+            document.activeElement != null
+        ) {
+            // if we're currently focused on the search input, we don't want to navigate
+            return;
+        }
+
+        switch (event.which) {
+            case 78: // n
+            case 74: // j
+                goToNext();
+                break;
+            case 66: // b
+            case 75: // k
+            case 80: // p
+                goToPrevious();
+                break;
+        }
+    };
+})();
+window.addEventListener('keydown', jumpToCode);