@ai0x0/utils 0.0.25 → 0.0.26

package/README.md

@@ -0,0 +1,59 @@
+# @ai0x0/utils
+
+AI0x0 shared utilities — backend CRUD factories for Next.js App Router + drizzle-orm, and custom ESLint rules.
+
+## Backend (`src/backend/`)
+
+Declarative CRUD factories on top of `next-rest-framework`, `drizzle-orm/pg-core`, `drizzle-zod`, and `zod`. Each factory returns a `RouteOperationDefinition` that plugs directly into `route({ … })`.
+
+| Export                   | HTTP   | Description                              |
+| ------------------------ | ------ | ---------------------------------------- |
+| `createPostOperation`    | POST   | Create a record                          |
+| `createGetOperation`     | GET    | Get one record by filters                |
+| `createGetListOperation` | GET    | Paginated list with filters, sort, joins |
+| `createPutOperation`     | PUT    | Update a record                          |
+| `createDeleteOperation`  | DELETE | Delete a record                          |
+| `createTableSchema`      | —      | Generate pg table + 5 Zod schemas        |
+
+**Built-in conventions:** base fields (`id`, `creatorId`, `editorId`, `createdAt`, `updatedAt`, `accessedAt`), ownership checks via `byCreator`, automatic date coercion, pagination (`current`/`pageSize`/`orderBy`/`orderDir`), list filtering with `ILIKE`, `IN`, `jsonb` array matching, and relation joins.
+
+See [SKILL.md](./SKILL.md) for detailed workflow, setup, and escape hatches.
+
+## ESLint Rules (`eslint-rules/`)
+
+Custom ESLint 9 flat-config rules ported from production projects. All enabled via `configs.recommended`:
+
+```js
+// eslint.config.js
+import localPlugin from "./eslint-rules/index.js";
+
+export default [
+  localPlugin.configs.recommended,
+  // ... other config
+];
+```
+
+| Rule                      | Description                             |
+| ------------------------- | --------------------------------------- |
+| `no-hardcoded-style`      | Forbid hardcoded style values           |
+| `no-one-letter-vars`      | Forbid single-letter variable names     |
+| `no-then`                 | Prefer `async/await` over `.then()`     |
+| `no-antd-space`           | Use `<Flex>` instead of `<Space>`       |
+| `require-pro-components`  | Require ProComponents usage             |
+| `require-section-divider` | Large files need `===` comment dividers |
+| `no-consecutive-setstate` | Merge consecutive `setState` calls      |
+| `no-use-request-run`      | Forbid `useRequest.run()`               |
+| `require-use-form`        | Use `useForm()` for form state          |
+| `require-form-convention` | Form naming conventions                 |
+
+## Installation
+
+```bash
+pnpm add @ai0x0/utils
+```
+
+Peer dependencies: `drizzle-orm ^0.45.x`, `drizzle-zod ^0.8.x`, `zod ^4.x`.
+
+## Docs
+
+- [SKILL.md](./SKILL.md) — full backend CRUD workflow and API reference

package/es/backend/actions/get-list-query.js

@@ -84,8 +84,8 @@ export function getListQuery(_ref) {
     }).map(function (_ref6) {
       var table = _ref6.table;
       return table;
-    })) || []).find(function (t) {
-      return t[key];
+    })) || []).find(function (table) {
+      return table[key];
     })) === null || _concat$find === void 0 ? void 0 : _concat$find[key];
   }
 
@@ -96,8 +96,8 @@ export function getListQuery(_ref) {
     if (typeof value === "string") {
       if (value.includes(",")) {
         // 处理多值
-        var values = value.split(",").map(function (v) {
-          return v.trim();
+        var values = value.split(",").map(function (val) {
+          return val.trim();
         }).filter(Boolean);
         if (values.length > 0) {
           if (isJsonArray) {
@@ -106,8 +106,8 @@ export function getListQuery(_ref) {
           } else if (isIdField) {
             conditions.push(inArray(targetColumn, values));
           } else {
-            conditions.push(or.apply(void 0, _toConsumableArray(values.map(function (v) {
-              return ilike(targetColumn, "%".concat(v, "%"));
+            conditions.push(or.apply(void 0, _toConsumableArray(values.map(function (val) {
+              return ilike(targetColumn, "%".concat(val, "%"));
             }))));
           }
         }

package/lib/backend/actions/get-list-query.js

@@ -58,14 +58,14 @@ function getListQuery({
     var _a;
     return (_a = [table2].concat(
       (relations2 == null ? void 0 : relations2.filter(({ table: table3 }) => table3).map(({ table: table3 }) => table3)) || []
-    ).find((t) => t[key])) == null ? void 0 : _a[key];
+    ).find((table3) => table3[key])) == null ? void 0 : _a[key];
   }
   function addCondition(conditions2, key, value, targetColumn) {
     const isIdField = /id/i.test(key);
     const isJsonArray = jsonArrayFields == null ? void 0 : jsonArrayFields.includes(key);
     if (typeof value === "string") {
       if (value.includes(",")) {
-        const values = value.split(",").map((v) => v.trim()).filter(Boolean);
+        const values = value.split(",").map((val) => val.trim()).filter(Boolean);
         if (values.length > 0) {
           if (isJsonArray) {
             conditions2.push(
@@ -81,7 +81,7 @@ function getListQuery({
           } else {
             conditions2.push(
               (0, import_drizzle_orm.or)(
-                ...values.map((v) => (0, import_drizzle_orm.ilike)(targetColumn, `%${v}%`))
+                ...values.map((val) => (0, import_drizzle_orm.ilike)(targetColumn, `%${val}%`))
               )
             );
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai0x0/utils",
-  "version": "0.0.25",
+  "version": "0.0.26",
   "description": "AI0x0 utils",
   "keywords": [
     "ai0x0"