@robot-admin/request-core

项目定位

Robot Request Core 是实例化请求编排与 Vue 3 Headless CRUD 工具，以 @robot-admin/request-core 发布。基于 Axios，统一处理并发、缓存、取消、重试、Token 恢复与数据列表生命周期。

当前仓库版本 0.6.1。每个 Client 隔离运行状态；Vue 层不绑定表格或 UI 组件，Naive UI 通过单独兼容适配层接入。

能力地图

入口选择

快速开始

bun add @robot-admin/request-core axios@^1.7.0

Vue 能力另需 Vue ^3.4，Naive UI 适配另需 Naive UI ^2.38；两者均声明为可选 peer。

创建应用 Client

import { createRequestClient } from "@robot-admin/request-core/axios";

interface User {
  id: number;
  name: string;
}

const request = createRequestClient({
  request: { baseURL: "/api", timeout: 10_000 },
});

export function searchUsers(keyword: string) {
  return request.get<User[]>("/users", {
    params: { keyword },
    concurrency: "takeLatest",
    scope: "users-page",
  });
}

此例假设接口直接返回 User[]。若后端返回 { code, data, message }，通过 response 适配器定义成功判定、数据解包与错误消息，见完整接入。

给列表接入数据源

在 Vue 组件的 setup 中使用 /vue，HTTP 数据源复用同一个 Client：

import { useTableCrud } from "@robot-admin/request-core/vue";

const table = useTableCrud({
  client: request,
  source: { list: "/users" },
  autoLoad: "mounted",
  createNewRow: () => ({ id: 0, name: "" }),
});

此处 request 沿用上例创建的 Client。列表响应的字段映射按服务端协议配置；CRUD 不提供后端实现，也不要求使用特定表格。createMemoryTableSource() 可接入演示数据，createTableCrud() 可统一项目默认约定。

默认行为与边界

raw() 返回完整 Axios 响应，其他方法返回适配后的数据。取消、HTTP、网络、超时、业务与配置错误可通过 RequestError 分类处理。

文档与维护

本包的 bun run verify 覆盖类型、测试、构建和发布产物；工作区完整门禁使用根目录的同名命令。

许可证

MIT License · Robot Packages

UI column contracts

CRUD transparently passes column configuration to the rendering component. From 0.6.3, component-owned columns can be supplied directly, including numeric keys and native multiple-sorter/filter definitions. The minimal structural boundary preserves the business row type in render without importing a UI component package or requiring application-level conversion functions. Use the component library's column helper to validate its presentation options and business field names.