@lark-apaas/coding-steering 0.1.55 → 0.1.57

package/package.json

@@ -1,14 +1,11 @@
 {
   "name": "@lark-apaas/coding-steering",
-  "version": "0.1.55",
+  "version": "0.1.57",
   "description": "Stack-specific steering content for miaoda-coding templates",
   "type": "module",
   "files": [
     "steering"
   ],
-  "scripts": {
-    "lint:md": "markdownlint 'steering/**/*.md' --ignore 'steering/**/skills/**' --ignore 'steering/**/skills_common/**' --ignore 'steering/**/skills_local/**'"
-  },
   "devDependencies": {
     "markdownlint-cli": "^0.47.0"
   },
@@ -20,5 +17,8 @@
     "miaoda",
     "coding-steering"
   ],
-  "license": "MIT"
-}
+  "license": "MIT",
+  "scripts": {
+    "lint:md": "markdownlint 'steering/**/*.md' --ignore 'steering/**/skills/**' --ignore 'steering/**/skills_common/**' --ignore 'steering/**/skills_local/**'"
+  }
+}

package/steering/nestjs-react-fullstack/skills/coding-guide/SKILL.md

@@ -359,7 +359,15 @@ await db.select().from(users).where(eq(users.adminUser, userId));
   | 按月 / 按天筛 date、timestamptz | 半开区间 `and(gte(col, "2026-08-01"), lt(col, "2026-09-01"))`；日期列不能用 `like(col, "2026-08%")` |
   | 数字列过滤（`@Query` 取到的是 string） | 先 `Number(q)` 再进 `eq` |
 
-- **`count()` 返回 string**（PostgreSQL bigint）。
+- **区分 Drizzle helper 与原生 SQL `COUNT()`**：当前模板的 `drizzle-orm@0.44.6` 中，`count()` helper 返回 `number`；原生 SQL `COUNT()` 返回 PostgreSQL `bigint`，驱动结果可能是 `string`。需要保留超过 `Number.MAX_SAFE_INTEGER` 的精确值时，使用 `BigInt` 或保留字符串，不要转成 `Number`。
+
+  ```typescript
+  const [{ total }] = await db.select({ total: count() }).from(users); // total: number
+
+  const rawTotal = '9007199254740993';
+  const exactTotal = BigInt(rawTotal); // ✅ 9007199254740993n
+  const unsafeTotal = Number(rawTotal); // ❌ 9007199254740992，精度丢失
+  ```
 
 - **UUID 多值过滤不要直接插值数组到 `ANY(...::uuid[])`**：在 sql 模板中直接插入 ids 这类 JS 数组，可能被展开成 `($1, $2, ...)::uuid[]`，运行时报 `42846: cannot cast type record to uuid[]`。
 

package/steering/nestjs-react-fullstack/skills_local/coding-guide/SKILL.md

@@ -316,7 +316,15 @@ await db.select().from(users).where(eq(users.adminUser, userId));
 
 ### 使用侧边界陷阱
 
-- **`count()` 返回 string**（PostgreSQL bigint）。
+- **区分 Drizzle helper 与原生 SQL `COUNT()`**：当前模板的 `drizzle-orm@0.44.6` 中，`count()` helper 返回 `number`；原生 SQL `COUNT()` 返回 PostgreSQL `bigint`，驱动结果可能是 `string`。需要保留超过 `Number.MAX_SAFE_INTEGER` 的精确值时，使用 `BigInt` 或保留字符串，不要转成 `Number`。
+
+  ```typescript
+  const [{ total }] = await db.select({ total: count() }).from(users); // total: number
+
+  const rawTotal = '9007199254740993';
+  const exactTotal = BigInt(rawTotal); // ✅ 9007199254740993n
+  const unsafeTotal = Number(rawTotal); // ❌ 9007199254740992，精度丢失
+  ```
 
 - **UUID 列 `inArray` 必须显式 `::uuid[]`**：标准 `inArray(col, ids)` 会运行时报 `42809: op ANY/ALL (array) requires array on right side`。