@lark-apaas/fullstack-presets 1.1.25 → 1.1.26-alpha.20260929135803

package/README.md

@@ -3,6 +3,26 @@
 
 ## ESLint 自定义规则
 
+### `require-number-wrapped-count`（已弃用）
+
+从本变更发布的新版 `@lark-apaas/fullstack-presets` 起，`eslintPresetsOfSimple.server` 不再默认启用 `@lark-apaas/require-number-wrapped-count`。公开规则 ID 仍可解析，但已标记 deprecated 且不再报告错误；这只是 **ID 的语法兼容，不是旧告警行为兼容**。旧包的精确锁定版本（如 1.1.25）不会因新包发布自动改变行为。
+
+Drizzle 0.44.6 中 `count()` 是 `SQL<number>`，已通过 `.mapWith(Number)` 映射读回结果，可直接作为 SQLWrapper 用于 select 字段及排序表达式：
+
+```typescript
+import { asc, count, desc } from 'drizzle-orm';
+
+db.select({ total: count() }).from(users);
+db.select().from(users).orderBy(desc(count()));
+db.select().from(users).orderBy(asc(count()));
+const expression = count(users.id);
+db.select({ total: expression }).from(users).orderBy(desc(expression));
+```
+
+不要为 SQL 排序写 `Number(count())`：这会在 JS 阶段转换 SQL 对象，而不是生成数据库的 `count(*) desc`。**只有读取已有原生 SQL 表达式的 driver 返回值时**（例如 ``sql`count(*)` ``），才依据字段类型、驱动和精度需求决定 `.mapWith(Number)`、BigInt 等映射；这不是用原生 SQL 替换 `count()` helper 的建议。
+
+**显式 opt-in 迁移**：若项目使用 Drizzle 0.44.6 且有 TypeScript 类型检查（例如 `tsc` / `type:check`），删除 ESLint 配置中显式的 `@lark-apaas/require-number-wrapped-count` 条目，而不是改成 warn 或依照旧报错把 count 强制包在 Number 中。非法的 `const n: number = count()`、`desc(Number(count()))` 等有类型的 JS 数值用法由现有 TypeScript 检查负责；`any` / JS 绕开类型系统时不保证被检测。使用其它未核实的 Drizzle 版本、或缺少类型守护的旧项目，先保留**当前旧精确包版本**，确认该版本的 count/驱动合同与可用检查，再决定升级/删除 opt-in；不能将新版空壳当作旧规则保护。未来若要删除公开 ID，需要另走弃用流程。
+
 ### `no-nested-styled-jsx`
 
 检测嵌套的 styled-jsx 标签，防止编译错误。https://nextjs.org/docs/messages/nested-styled-jsx-tags

package/lib/custom-eslint-rules/require-number-wrapped-count.d.ts

@@ -1,10 +1,8 @@
 /**
- * ESLint 规则：Drizzle count() 返回值必须用 Number(...) 包裹
- *
- * postgres-js 驱动下 Drizzle 的 count() 返回 string 而非 number，
- * 不包裹 Number() 会导致类型不符预期。
- *
- * 通过 import 追踪确认 count 来自 drizzle-orm，避免误匹配其他 count 函数。
+ * Deprecated compatibility shell for the published rule ID. In Drizzle 0.44.6,
+ * count() is a SQL<number> expression, not a JS value requiring Number(count()).
+ * Keep the ID registered so older explicit configurations remain parseable;
+ * it intentionally does not preserve the old diagnostics.
  */
 import type { Rule } from 'eslint';
 declare const rule: Rule.RuleModule;

package/lib/custom-eslint-rules/require-number-wrapped-count.js

@@ -2,66 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const rule = {
     meta: {
-        type: 'problem',
+        deprecated: true,
         docs: {
-            description: 'Require Drizzle count() to be wrapped with Number()',
-            category: 'Possible Errors',
-            recommended: true,
+            description: 'Deprecated compatibility rule ID; no longer reports violations',
+            recommended: false,
         },
         schema: [],
-        messages: {
-            unwrappedCount: 'Drizzle count() returns string in postgres-js. Wrap with Number(count(...)) to get a numeric value.',
-        },
     },
-    create(context) {
-        // 追踪从 drizzle-orm 导入的 count 标识符名
-        const drizzleCountNames = new Set();
-        return {
-            // 收集 import { count } from 'drizzle-orm' 或 import { count as x } from 'drizzle-orm'
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            ImportDeclaration(node) {
-                if (node.source.value !== 'drizzle-orm' &&
-                    !node.source.value.startsWith('drizzle-orm/')) {
-                    return;
-                }
-                for (const specifier of node.specifiers) {
-                    if (specifier.type === 'ImportSpecifier' &&
-                        specifier.imported.name === 'count') {
-                        drizzleCountNames.add(specifier.local.name);
-                    }
-                }
-            },
-            // 检查 count() 调用是否被 Number(...) 包裹
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            CallExpression(node) {
-                // 是否是 count(...) 调用
-                if (node.callee.type !== 'Identifier' ||
-                    !drizzleCountNames.has(node.callee.name)) {
-                    return;
-                }
-                // 检查父节点是否是 Number(count(...))
-                const parent = node.parent;
-                if (parent &&
-                    parent.type === 'CallExpression' &&
-                    parent.callee.type === 'Identifier' &&
-                    parent.callee.name === 'Number') {
-                    return; // 已包裹
-                }
-                // 检查是否在对象属性值位置且 key 是 count（如 { count: count() }）
-                // 这种场景下 count() 是 select 的字段定义，不是直接赋值，跳过
-                if (parent &&
-                    parent.type === 'Property' &&
-                    parent.value === node) {
-                    // 但如果整个 select result 后来被直接当 number 用，那是使用侧的问题
-                    // 这里只检查 count() 的直接调用位置
-                    return;
-                }
-                context.report({
-                    node,
-                    messageId: 'unwrappedCount',
-                });
-            },
-        };
+    create() {
+        return {};
     },
 };
 exports.default = rule;

package/lib/simple/recommend/eslint/eslint-server.d.ts

@@ -53,7 +53,6 @@ declare const _default: {
         '@darraghor/nestjs-typed/api-method-should-specify-api-operation': string;
         '@darraghor/nestjs-typed/api-enum-property-best-practices': string;
         '@darraghor/nestjs-typed/all-properties-are-whitelisted': string;
-        '@lark-apaas/require-number-wrapped-count': string;
         '@lark-apaas/require-shared-response-type': string;
         'no-restricted-syntax': (string | {
             selector: string;

package/lib/simple/recommend/eslint/eslint-server.js

@@ -52,7 +52,10 @@ exports.default = {
             {
                 patterns: [
                     {
-                        group: ['@lark-apaas/client-toolkit', '@lark-apaas/client-toolkit/*'],
+                        group: [
+                            '@lark-apaas/client-toolkit',
+                            '@lark-apaas/client-toolkit/*',
+                        ],
                         message: 'This toolkit is for client-side use only and must not be imported or used in server-side code.',
                     },
                 ],
@@ -63,7 +66,13 @@ exports.default = {
             {
                 src: ['./server/**/*.ts'],
                 // 此规则自行扫描文件，不遵循 ESLint ignores；保留默认过滤并排除独立 MCP UI 工程。
-                filterFromPaths: ['dist', 'node_modules', '.test.', '.spec.', 'server/mcp/ui/'],
+                filterFromPaths: [
+                    'dist',
+                    'node_modules',
+                    '.test.',
+                    '.spec.',
+                    'server/mcp/ui/',
+                ],
             },
         ],
         '@darraghor/nestjs-typed/api-property-returning-array-should-set-array': 'off',
@@ -75,15 +84,13 @@ exports.default = {
         '@darraghor/nestjs-typed/api-method-should-specify-api-operation': 'off',
         '@darraghor/nestjs-typed/api-enum-property-best-practices': 'off',
         '@darraghor/nestjs-typed/all-properties-are-whitelisted': 'off',
-        // 自定义规则：Drizzle count() 必须 Number() 包裹
-        '@lark-apaas/require-number-wrapped-count': 'error',
         // 自定义规则：Controller 返回类型必须定义在 shared/（默认关闭，需 y 位升级后对新应用开启）
         '@lark-apaas/require-shared-response-type': 'off',
         // Drizzle ORM 规则
         'no-restricted-syntax': [
             'error',
             {
-                selector: "CallExpression[callee.property.name=/^(values|set)$/] Property[key.name=/^(_created_at|_updated_at|_created_by|_updated_by)$/]",
+                selector: 'CallExpression[callee.property.name=/^(values|set)$/] Property[key.name=/^(_created_at|_updated_at|_created_by|_updated_by)$/]',
                 message: 'Audit columns (_created_at/_updated_at/_created_by/_updated_by) are auto-populated by the platform. Do not set them in .values() or .set() calls.',
             },
         ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-presets",
-  "version": "1.1.25",
+  "version": "1.1.26-alpha.20260929135803",
   "files": [
     "lib"
   ],