js-lite-rest纯前端 RESTful 风格增删改查库

// 引入 js-lite-rest (如果通过 CDN 引入，则为全局变量 JsLiteRest)
import JsLiteRest from 'js-lite-rest/browser';

// 创建 store 实例，注意必须使用 Store.create() 方法
const store = await JsLiteRest.create({
  users: [
    { id: 'user1', name: 'Alice', email: 'alice@example.com' },
    { id: 'user2', name: 'Bob', email: 'bob@example.com' }
  ]
});

// 获取所有用户
const users = await store.get('users');
console.log('所有用户:', users);

// 添加新用户（ID 会自动生成）
const newUser = await store.post('users', { name: 'Charlie', email: 'charlie@example.com' });
console.log('新用户:', newUser);

// 查询用户
const filteredUsers = await store.get('users', { name_like: 'A' });
console.log('名字包含A的用户:', filteredUsers);

// Node.js 环境
import JsLiteRest from 'js-lite-rest';
// 或者显式指定 Node.js 版本
import JsLiteRest from 'js-lite-rest/node';

// 浏览器环境 (ES Module)
import JsLiteRest from 'js-lite-rest/browser';

// 浏览器环境 (CommonJS，如果支持)
const JsLiteRest = require('js-lite-rest');

// 创建 store - 注意必须使用异步的 create() 方法
const store = await JsLiteRest.create();

// CRUD 操作
await store.post('users', { name: 'Alice' });         // 创建，ID 自动生成
const users = await store.get('users');               // 读取所有
const user = await store.get('users/abc123');         // 读取单个
await store.put('users/abc123', { name: 'Bob' });     // 完全更新
await store.patch('users/abc123', { age: 25 });       // 部分更新
await store.delete('users/abc123');                   // 删除

// 过滤查询
await store.get('users', { age_gte: 18, city: '北京' });

// 排序分页
await store.get('users', { 
  _sort: 'age', 
  _order: 'desc', 
  _page: 1, 
  _limit: 10 
});

// 全文搜索
await store.get('users', { _q: '张三' });

// 复杂查询组合
await store.get('users', {
  age_gte: 18,
  city_like: '北京',
  _sort: 'createdAt',
  _order: 'desc'
});

// 嵌套资源
await store.get('posts/1/comments');
await store.post('posts/1/comments', { content: '很好的文章！' });

// 关联嵌入
await store.get('posts', { _embed: 'comments' });
await store.get('comments', { _expand: 'post' });

// 添加日志中间件
store.use(async (args, next, opt) => {
  const [method, path, data] = args;
  console.log(`请求: ${method.toUpperCase()} ${path}`, data);
  
  const result = await next();
  
  console.log('响应:', result);
  return result;
});

// 添加验证中间件
store.use(async (args, next, opt) => {
  const [method, path, data] = args;
  
  if (method === 'post' && path === 'users') {
    if (!data.name) {
      throw { code: 400, success: false, message: 'name 是必填字段' };
    }
    if (!data.email) {
      throw { code: 400, success: false, message: 'email 是必填字段' };
    }
  }
  
  return next();
});

// 添加时间戳中间件
store.use(async (args, next, opt) => {
  const [method, path, data] = args;
  
  if (method === 'post' && data) {
    data.createdAt = new Date().toISOString();
  }
  if (method === 'put' && data) {
    data.updatedAt = new Date().toISOString();
  }
  
  return next();
});

// 批量创建
const users = await store.post('users', [
  { name: 'Alice', email: 'alice@example.com' },
  { name: 'Bob', email: 'bob@example.com' },
  { name: 'Charlie', email: 'charlie@example.com' }
]);

// 批量更新
await store.put('users', [
  { id: 'user1', name: 'Alice Updated' },
  { id: 'user2', name: 'Bob Updated' }
]);

// 批量删除
await store.delete('users', ['user1', 'user2']);

// 部分成功处理
try {
  await store.post('users', [
    { name: 'Valid User' },
    { /* 缺少必填字段 */ }
  ]);
} catch (error) {
  // error.data 包含成功的记录
  // error.error 包含失败的记录和错误信息
}

// 浏览器环境 - 自动使用 IndexedDB/localStorage
const browserStore = await JsLiteRest.create(initialData, {
  savePath: 'my-app-data'  // 数据库名称
});

// Node.js 环境 - 自动使用文件系统
const nodeStore = await JsLiteRest.create(initialData, {
  savePath: 'my-app-data.json'  // 文件路径
});

// 内存模式 - 不持久化
const memoryStore = await JsLiteRest.create(initialData, {
  adapter: 'memory'
});