mm_api 1.1.0 → 1.1.2

package/tests/index.test.js

@@ -0,0 +1,45 @@
+'use strict';
+
+/**
+ * index.js 导出与工厂函数测试
+ * @description 覆盖模块入口的全部导出与 apiAdmin / admin 分支
+ */
+
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const mod = require('../index.js');
+
+test('导出结构', () => {
+  assert.ok(mod.Manager, '应导出 Manager');
+  assert.ok(mod.admin, '应导出 admin');
+  assert.strictEqual(typeof mod.apiAdmin, 'function', '应导出 apiAdmin 函数');
+});
+
+test('apiAdmin 无参时使用 os 作用域', () => {
+  const inst = mod.apiAdmin();
+  assert.ok(inst instanceof mod.Manager, '应返回 Manager 实例');
+  assert.strictEqual(inst.config.name, 'os');
+});
+
+test('apiAdmin 指定作用域创建实例', () => {
+  const inst = mod.apiAdmin('test_scope');
+  assert.ok(inst instanceof mod.Manager, '应返回 Manager 实例');
+  assert.strictEqual(inst.config.name, 'test_scope');
+});
+
+test('apiAdmin 同作用域返回缓存实例', () => {
+  const first = mod.apiAdmin('cached_scope');
+  assert.strictEqual(mod.apiAdmin('cached_scope'), first, '同作用域应返回同一实例');
+});
+
+test('apiAdmin 传入配置可覆盖标题', () => {
+  const inst = mod.apiAdmin('title_scope', { title: '自定义标题' });
+  assert.strictEqual(inst.config.name, 'title_scope');
+  assert.strictEqual(inst.config.title, '自定义标题');
+});
+
+test('admin.get 返回 Manager 实例', () => {
+  const inst = mod.admin.get('admin_scope');
+  assert.ok(inst instanceof mod.Manager, 'admin.get 应返回 Manager 实例');
+  assert.strictEqual(inst.config.name, 'admin_scope');
+});

package/tests/manager.test.js

@@ -0,0 +1,184 @@
+'use strict';
+
+/**
+ * ApiManager 管理器测试
+ * @description 覆盖接口驱动的注册、注销、路径匹配、排序与路由执行
+ */
+
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const { Manager, apiAdmin } = require('../index.js');
+const { makeCtx, makeOptions } = require('./helper.js');
+
+test('add 注册接口驱动', () => {
+  const mgr = apiAdmin('mgr_add');
+  const drive = mgr.add({
+    name: 'hello',
+    path: '/hello',
+    method: 'ALL',
+    dir: __dirname,
+    main: './fixtures/hello.js'
+  });
+  assert.ok(drive, 'add 应返回驱动实例');
+  assert.ok(mgr.has('hello'), '注册后应能查到驱动');
+  assert.strictEqual(mgr.size(), 1);
+});
+
+test('get 获取接口驱动', () => {
+  const mgr = apiAdmin('mgr_get');
+  mgr.add({
+    name: 'hello',
+    path: '/hello',
+    method: 'ALL',
+    dir: __dirname,
+    main: './fixtures/hello.js'
+  });
+  const drive = mgr.get('hello');
+  assert.ok(drive, 'get 应返回驱动实例');
+  assert.strictEqual(drive.config.name, 'hello');
+  assert.strictEqual(drive.config.path, '/hello');
+});
+
+test('del 注销接口驱动', async () => {
+  const mgr = apiAdmin('mgr_del');
+  mgr.add({
+    name: 'hello',
+    path: '/hello',
+    method: 'ALL',
+    dir: __dirname,
+    main: './fixtures/hello.js'
+  });
+  const bl = await mgr.del('hello');
+  assert.strictEqual(bl, true, 'del 应返回 true');
+  assert.strictEqual(mgr.has('hello'), false, '注销后驱动应不存在');
+});
+
+test('isMatch 路径匹配', () => {
+  const mgr = new Manager({ name: 'isMatch' });
+  // 精确匹配
+  assert.strictEqual(mgr.isMatch('/hello', '/hello'), true);
+  // 尾通配：/api/* 匹配 /api/hello
+  assert.strictEqual(mgr.isMatch('/api/hello', '/api/*'), true);
+  // 头通配：*hello 匹配 /hello
+  assert.strictEqual(mgr.isMatch('/hello', '*hello'), true);
+  // 头尾通配：*hello* 包含匹配
+  assert.strictEqual(mgr.isMatch('/api/hello', '*hello*'), true);
+  // 不匹配
+  assert.strictEqual(mgr.isMatch('/other', '/hello'), false);
+});
+
+test('_sortedDrives 按路径长度降序排序', () => {
+  const mgr = apiAdmin('mgr_sort');
+  mgr.add({
+    name: 'short',
+    path: '/a',
+    method: 'ALL',
+    state: 1,
+    sort: 1,
+    dir: __dirname,
+    main: './fixtures/hello.js'
+  });
+  mgr.add({
+    name: 'long',
+    path: '/a/b',
+    method: 'ALL',
+    state: 1,
+    sort: 1,
+    dir: __dirname,
+    main: './fixtures/hello.js'
+  });
+  const drives = mgr._sortedDrives();
+  assert.strictEqual(drives[0].config.name, 'long', '路径长的应优先');
+  assert.strictEqual(drives[1].config.name, 'short');
+});
+
+test('_sortedDrives 过滤未启用驱动', () => {
+  const mgr = apiAdmin('mgr_state');
+  mgr.add({
+    name: 'disabled',
+    path: '/a',
+    method: 'ALL',
+    state: 0,
+    dir: __dirname,
+    main: './fixtures/hello.js'
+  });
+  mgr.add({
+    name: 'enabled',
+    path: '/b',
+    method: 'ALL',
+    state: 1,
+    dir: __dirname,
+    main: './fixtures/hello.js'
+  });
+  const drives = mgr._sortedDrives();
+  assert.strictEqual(drives.length, 1);
+  assert.strictEqual(drives[0].config.name, 'enabled');
+});
+
+test('run 匹配路由并返回脚本结果', async () => {
+  const mgr = apiAdmin('mgr_run');
+  mgr.add({
+    name: 'hello',
+    path: '/hello',
+    method: 'ALL',
+    dir: __dirname,
+    main: './fixtures/hello.js'
+  });
+  const ctx = makeCtx({ path: '/hello', method: 'GET' });
+  const options = makeOptions();
+  const ret = await mgr.run(ctx, options);
+  assert.ok(ret, 'run 应返回结果');
+  assert.deepStrictEqual(JSON.parse(ret), {
+    code: 0,
+    message: '成功',
+    data: { hello: 'world' }
+  });
+  assert.strictEqual(options.ret, ret, '结果应写入数据管理器 ret');
+});
+
+test('run 方法不匹配时返回 null', async () => {
+  const mgr = apiAdmin('mgr_method');
+  mgr.add({
+    name: 'hello',
+    path: '/hello',
+    method: 'POST',
+    dir: __dirname,
+    main: './fixtures/hello.js'
+  });
+  const ctx = makeCtx({ path: '/hello', method: 'GET' });
+  const ret = await mgr.run(ctx, makeOptions());
+  assert.strictEqual(ret, null);
+});
+
+test('run 路径不匹配时返回 null', async () => {
+  const mgr = apiAdmin('mgr_path');
+  mgr.add({
+    name: 'hello',
+    path: '/hello',
+    method: 'ALL',
+    dir: __dirname,
+    main: './fixtures/hello.js'
+  });
+  const ctx = makeCtx({ path: '/other', method: 'GET' });
+  const ret = await mgr.run(ctx, makeOptions());
+  assert.strictEqual(ret, null);
+});
+
+test('reload 重启接口驱动', async () => {
+  const mgr = apiAdmin('mgr_reload');
+  mgr.add({
+    name: 'hello',
+    path: '/hello',
+    method: 'ALL',
+    dir: __dirname,
+    main: './fixtures/hello.js'
+  });
+  const bl = await mgr.reload('hello');
+  assert.strictEqual(bl, true, 'reload 应返回 true');
+});
+
+test('reload 不存在的驱动返回 false', async () => {
+  const mgr = apiAdmin('mgr_reload_miss');
+  const bl = await mgr.reload('not_exist');
+  assert.strictEqual(bl, false);
+});

package/tests/oauth.test.js

@@ -0,0 +1,107 @@
+'use strict';
+
+/**
+ * Oauth 身份验证测试
+ * @description 覆盖免登录、登录校验与权限级别校验
+ */
+
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const Oauth = require('../lib/oauth.js');
+const { makeCtx } = require('./helper.js');
+
+test('无需登录时 check 返回 null', async () => {
+  const oauth = new Oauth({ sign_in: false });
+  const ctx = makeCtx({ path: '/hello', method: 'GET' });
+  const ret = await oauth.check(ctx);
+  assert.strictEqual(ret, null);
+});
+
+test('需登录但未登录时返回 60000', async () => {
+  const oauth = new Oauth({ sign_in: true });
+  const ctx = makeCtx({ path: '/hello', method: 'GET' });
+  const ret = await oauth.check(ctx);
+  assert.ok(ret, '应返回错误对象');
+  assert.strictEqual(ret.code, 60000);
+  assert.strictEqual(ret.message, '账户未登录!');
+});
+
+test('已登录且权限足够时返回 null', async () => {
+  const oauth = new Oauth({
+    sign_in: true,
+    vip: 1,
+    gm: 1,
+    mc: 1,
+    user_group: [],
+    user_admin: []
+  });
+  const ctx = makeCtx({ path: '/hello', method: 'GET' });
+  ctx.session.user = {
+    user_id: 1,
+    vip: 9,
+    gm: 9,
+    mc: 9,
+    user_group: '',
+    user_admin: ''
+  };
+  const ret = await oauth.check(ctx);
+  assert.strictEqual(ret, null, '权限足够时应通过');
+});
+
+test('权限不足返回 70000', async () => {
+  const oauth = new Oauth({
+    sign_in: true,
+    gm: 5
+  });
+  const ctx = makeCtx({ path: '/hello', method: 'GET' });
+  ctx.session.user = {
+    user_id: 1,
+    vip: 9,
+    gm: 1,
+    mc: 9,
+    user_group: '',
+    user_admin: ''
+  };
+  const ret = await oauth.check(ctx);
+  assert.ok(ret, '应返回错误对象');
+  assert.strictEqual(ret.code, 70000);
+  assert.strictEqual(ret.message, '没有访问权限');
+});
+
+test('用户组不匹配返回 70000', async () => {
+  const oauth = new Oauth({
+    sign_in: true,
+    user_group: ['1', '5']
+  });
+  const ctx = makeCtx({ path: '/hello', method: 'GET' });
+  ctx.session.user = {
+    user_id: 1,
+    vip: 9,
+    gm: 9,
+    mc: 9,
+    user_group: '2,3',
+    user_admin: ''
+  };
+  const ret = await oauth.check(ctx);
+  assert.ok(ret, '应返回错误对象');
+  assert.strictEqual(ret.code, 70000);
+});
+
+test('管理组不匹配返回 70000', async () => {
+  const oauth = new Oauth({
+    sign_in: true,
+    user_admin: ['1', '5']
+  });
+  const ctx = makeCtx({ path: '/hello', method: 'GET' });
+  ctx.session.user = {
+    user_id: 1,
+    vip: 9,
+    gm: 9,
+    mc: 9,
+    user_group: '',
+    user_admin: '2,3'
+  };
+  const ret = await oauth.check(ctx);
+  assert.ok(ret, '应返回错误对象');
+  assert.strictEqual(ret.code, 70000);
+});