@ai0x0/utils

AI0x0 shared utilities — backend CRUD factories for Next.js App Router + drizzle-orm, custom ESLint rules and presets.

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 |

See SKILL.md for detailed workflow, setup, and escape hatches.

ESLint Rules & Config

Plugin (eslint-rules/)

Custom ESLint 9 flat-config rules. All enabled via configs.recommended:

// eslint.config.js
import { ai0x0 } from "@ai0x0/utils/eslint-config/index.js";

export default [
  ai0x0.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 |

Shared restrictions (eslint-config/)

Pre-defined no-restricted-syntax selectors for antd + ahooks convention enforcement:

import {
  ai0x0,
  allRestrictions,
  allRestrictionsWithNetworking,
} from "@ai0x0/utils/eslint-config/index.js";

export default [
  ai0x0.configs.recommended,
  // ... Prettier + TypeScript configs ...
  // Backend code
  {
    files: ["app/(backend)/**/*.ts"],
    rules: { "no-restricted-syntax": ["error", ...allRestrictions] },
  },
  // Frontend code (also restricts fetch / WebSocket)
  {
    files: ["app/(frontend)/**/*.ts"],
    rules: {
      "no-restricted-syntax": ["error", ...allRestrictionsWithNetworking],
    },
  },
];

Restrictions cover: TryStatement, as (non-const), useState, useEffect, useMemo, useCallback, native div/span/p/h tags, hardcoded colors, fetch and new WebSocket().

Installation

pnpm add @ai0x0/utils

Peer dependencies: drizzle-orm ^0.45.x, drizzle-zod ^0.8.x, zod ^4.x.

Docs

• SKILL.md — full backend CRUD workflow and API reference