Files
dacli/tests/unit/dbLinkId.test.ts
T
sswandClaude 5a40afbb2e v0.11: 修复 BS-48 dbLinkId=default 别名解析
根因: dacli create 命令把 --dbLinkId=default 当字面量传给后端 URL
(/system/DataModel/default/Table), 后端查 dbLinkEntity=null 抛 NPE.
BS-48 guard 旧判定 !id || id==='0' || id==='', 不拦截 'default' 字符串.

web 行为参照: formDesign Form.vue 选 '默认' 自动用当前 app 业务库,
不应暴露 'default' 字面量到 URL.

修复:
- 新增 core/dbLinkId.ts: resolveDbLinkId() 统一别名解析
  (空/default/DEFAULT/主库/业务库 → token.dbLinkId)
- core/client.ts: JnpfClient.resolveDbLinkId() 委托给 core util
- 7 个 create 命令迁移到 c.resolveDbLinkId() 入口
  (dm create/drop/fields/list + form create/codegen/import)
- _blindspot_guards.ts BS-48: 增加 /^default$/i.test 拦截

实测:
- dacli dm create --dbLinkId=default → URL 走 2068901937849257984, 建表成功
- 单测 14/14 (dbLinkId) + 38/38 (blindspot_guards, 1 预存 BS-51 失败无关)
- TS 编译 src/ 0 差错

应用影响: docs/jxcj/design-jnpf.html 56 个 dm/form 命令全部用
--dbLinkId=default, 现在可直接 dispatch 不需改 design.

Co-Authored-By: Claude <[email protected]>
2026-06-22 21:51:25 +08:00

91 lines
3.0 KiB
TypeScript

/**
* unit/dbLinkId.test.ts — resolveDbLinkId 别名解析单测
*
* 覆盖场景:
* - 'default' (小写) → ctx.dbLinkId
* - 'DEFAULT' (大写, case-insensitive) → ctx.dbLinkId
* - 'Default' (混合大小写) → ctx.dbLinkId
* - '主库' (中文别名) → ctx.dbLinkId
* - '业务库' (中文别名) → ctx.dbLinkId
* - undefined / '' (空) → ctx.dbLinkId
* - '0' (主库标识) → ctx.dbLinkId
* - 显式数字 id (如 '2068901937849257984') → 原值透传
* - ctx 缺失时 → '0' 兜底
* - ctx 缺失 + 有 input (显式 id) → 原值透传
*/
import { describe, it, expect } from 'vitest'
import { resolveDbLinkId } from '../../src/core/dbLinkId.ts'
import type { AppContext } from '../../src/core/types.ts'
const baseCtx: AppContext = {
appCode: 'jxcj',
dbLinkId: '2068901937849257984',
tokenStatus: 'valid',
existingEnCodes: [],
unreleasedForms: [],
releasedForms: [],
existingTables: [],
menus: [],
currentVersion: '0.11',
warnings: [],
}
describe('resolveDbLinkId', () => {
it("'default' 小写别名 → ctx.dbLinkId", () => {
expect(resolveDbLinkId('default', baseCtx)).toBe('2068901937849257984')
})
it("'DEFAULT' 大写别名 (case-insensitive) → ctx.dbLinkId", () => {
expect(resolveDbLinkId('DEFAULT', baseCtx)).toBe('2068901937849257984')
})
it("'Default' 混合大小写 → ctx.dbLinkId", () => {
expect(resolveDbLinkId('Default', baseCtx)).toBe('2068901937849257984')
})
it("'主库' 中文别名 → ctx.dbLinkId", () => {
expect(resolveDbLinkId('主库', baseCtx)).toBe('2068901937849257984')
})
it("'业务库' 中文别名 → ctx.dbLinkId", () => {
expect(resolveDbLinkId('业务库', baseCtx)).toBe('2068901937849257984')
})
it('undefined 输入 → ctx.dbLinkId', () => {
expect(resolveDbLinkId(undefined, baseCtx)).toBe('2068901937849257984')
})
it("'' 空字符串 → ctx.dbLinkId", () => {
expect(resolveDbLinkId('', baseCtx)).toBe('2068901937849257984')
})
it("'0' 主库标识 → 原值透传 (BS-1 由 guard 拦截)", () => {
// '0' 不是别名, 是合法的"主库"标识, 由 BS-1 guard 在业务表场景拦截
expect(resolveDbLinkId('0', baseCtx)).toBe('0')
})
it('显式数字 id → 原值透传 (向后兼容)', () => {
expect(resolveDbLinkId('664077319056394183', baseCtx)).toBe('664077319056394183')
})
it('ctx=null + 无 input → 兜底 "0"', () => {
expect(resolveDbLinkId(undefined, null)).toBe('0')
})
it('ctx=null + "default" → 兜底 "0"', () => {
expect(resolveDbLinkId('default', null)).toBe('0')
})
it('ctx=null + 显式 id → 原值透传', () => {
expect(resolveDbLinkId('664077319056394183', null)).toBe('664077319056394183')
})
it('ctx=undefined (缺省) + "default" → 兜底 "0"', () => {
expect(resolveDbLinkId('default', undefined)).toBe('0')
})
it('null 输入 (旧客户端代码) → ctx.dbLinkId', () => {
expect(resolveDbLinkId(null, baseCtx)).toBe('2068901937849257984')
})
})