Files
dacli/tests/unit/dm_table_name.test.ts
T
2026-07-22 16:51:06 +08:00

164 lines
6.8 KiB
TypeScript

/**
* tests/unit/dm_table_name.test.ts
*
* 覆盖 src/commands/dm/_table_name.ts normalizeDmTableName (2026-07-22 eventhub 阻断修复)
*
* 测试目标:
* - dm 表名规范化保留 snake_case, 不走 enCode strip (避免 `event_signup` 被改成 `eventsignup`)
* - 默认去 `${appCode}_` 前缀
* - 全 lowercase 适配 BS-111 (MySQL lower_case_table_names=2)
* - 非法字符 (dash / 中文) **不** 做静默改写, 由调用方 step machine 拒绝
*
* 关联:
* - docs/decisions/0016-eventhub-blocker-fixes-design.md §3.1
* - tests/unit/auto_fix.test.ts 中关于 `dm-with-dash → dmwithdash` 的旧契约已废弃 (现在 dm
* table 不走 enCode strip helper)
*/
import { describe, it, expect } from 'vitest'
import { normalizeDmTableName } from '../../src/commands/dm/_table_name.ts'
describe('normalizeDmTableName — snake_case 保留 (eventhub blocker 修复核心)', () => {
it('snake_case 表名保持不变 (event_signup → event_signup)', () => {
const r = normalizeDmTableName({ raw: 'event_signup', appCode: 'eventhub' })
expect(r.table).toBe('event_signup')
expect(r.original).toBe('event_signup')
expect(r.strippedAppCode).toBe(false)
expect(r.lowered).toBe(false)
})
it('含下划线的 snake_case 保持不变 (my_audit_record → my_audit_record)', () => {
const r = normalizeDmTableName({ raw: 'my_audit_record', appCode: 'audit' })
expect(r.table).toBe('my_audit_record')
expect(r.strippedAppCode).toBe(false)
expect(r.lowered).toBe(false)
})
it('关键对照: `event_signup` 不被改成 `eventsignup` (旧 enCode strip 行为已禁用)', () => {
// 反向断言: 这一点是事件稿 blocker 的根因, 修复后 dm 不再调 autoStripEnCode, 必须是 `event_signup` 而不是 `eventsignup`
const r = normalizeDmTableName({ raw: 'event_signup', appCode: 'eventhub' })
expect(r.table).not.toBe('eventsignup')
expect(r.table).toBe('event_signup')
})
})
describe('normalizeDmTableName — appCode 前缀去除 (默认 stripAppCode=true)', () => {
it('`eventhub_event_signup` → `event_signup` (前缀匹配)', () => {
const r = normalizeDmTableName({ raw: 'eventhub_event_signup', appCode: 'eventhub' })
expect(r.table).toBe('event_signup')
expect(r.strippedAppCode).toBe(true)
})
it('appCode=`event` 前缀整段匹配 `event_`: `event_signup` → `signup`', () => {
// 规则严格按 `${appCode}_` 整段匹配前缀, `event_signup` 确实以 `event_` 开头 → 整段去除
// 这是预期行为: 与 web 端 ssw.event.entity 包名一致, 业务表不重复 appCode 前缀
const r = normalizeDmTableName({ raw: 'event_signup', appCode: 'event' })
expect(r.table).toBe('signup')
expect(r.strippedAppCode).toBe(true)
})
it('appCode=`evt` 与 `event_` 不匹配 → 不动', () => {
// raw 以 `event_` 开头, 但 prefix 是 `evt_` → 字符串不匹配 (raw[3] 是 'n' 不是 '_')
const r = normalizeDmTableName({ raw: 'event_signup', appCode: 'evt' })
expect(r.table).toBe('event_signup')
expect(r.strippedAppCode).toBe(false)
})
it('无 appCode → 不去前缀 (兜底)', () => {
const r = normalizeDmTableName({ raw: 'eventhub_event_signup' })
expect(r.table).toBe('eventhub_event_signup')
expect(r.strippedAppCode).toBe(false)
})
it('stripAppCode=false → 保留 `appCode_xxx` 前缀', () => {
const r = normalizeDmTableName({
raw: 'eventhub_event_signup',
appCode: 'eventhub',
stripAppCode: false,
})
expect(r.table).toBe('eventhub_event_signup')
expect(r.strippedAppCode).toBe(false)
})
it('stripAppCode=true 但 raw 不含前缀 → 不动', () => {
const r = normalizeDmTableName({
raw: 'simple_signup',
appCode: 'eventhub',
stripAppCode: true,
})
expect(r.table).toBe('simple_signup')
expect(r.strippedAppCode).toBe(false)
})
})
describe('normalizeDmTableName — lowercase (BS-111 MySQL lower_case_table_names=2)', () => {
it('`Event_Signup` → `event_signup`', () => {
const r = normalizeDmTableName({ raw: 'Event_Signup', appCode: 'eventhub' })
expect(r.table).toBe('event_signup')
expect(r.lowered).toBe(true)
})
it('`EVENT_SIGNUP` → `event_signup`', () => {
const r = normalizeDmTableName({ raw: 'EVENT_SIGNUP', appCode: 'eventhub' })
expect(r.table).toBe('event_signup')
expect(r.lowered).toBe(true)
})
it('已全是 lowercase → lowered=false', () => {
const r = normalizeDmTableName({ raw: 'event_signup', appCode: 'eventhub' })
expect(r.lowered).toBe(false)
})
it('appCode 前缀去除 + lowercase 同时触发', () => {
const r = normalizeDmTableName({ raw: 'EventHub_Event_Signup', appCode: 'eventhub' })
// prefix 匹配是 `${appCode}_` 即 `eventhub_`, 但 raw 是 `EventHub_...` (大小写敏感) → 不匹配
// 然后整体 lowercase → `eventhub_event_signup`
expect(r.table).toBe('eventhub_event_signup')
expect(r.strippedAppCode).toBe(false)
expect(r.lowered).toBe(true)
})
})
describe('normalizeDmTableName — 不静默改写非法字符 (留给 dm step machine 拒绝)', () => {
it('含 dash 保持原样 (event-signup 不被改成 eventsignup)', () => {
// 与 §"snake_case 保留" 形成对照: dash 不是合法字符, 但也不应被静默 strip
// 由 dm/_validate.ts validateBasicInfo 的 NEWTABLE_REGEXP 检查返回错误
const r = normalizeDmTableName({ raw: 'event-signup', appCode: 'eventhub' })
expect(r.table).toBe('event-signup')
expect(r.lowered).toBe(false)
expect(r.strippedAppCode).toBe(false)
})
it('含中文保持原样', () => {
const r = normalizeDmTableName({ raw: '事件', appCode: 'eventhub' })
expect(r.table).toBe('事件')
})
it('含空格保持原样 (trim 只去前后空白, 内部空格不删)', () => {
const r = normalizeDmTableName({ raw: 'event signup' })
expect(r.table).toBe('event signup')
})
it('空字符串原样保留 (调用方另作处理)', () => {
const r = normalizeDmTableName({ raw: '', appCode: 'eventhub' })
expect(r.table).toBe('')
expect(r.original).toBe('')
expect(r.strippedAppCode).toBe(false)
expect(r.lowered).toBe(false)
})
it('前后空白 trim 掉 (中间留)', () => {
const r = normalizeDmTableName({ raw: ' event_signup ' })
expect(r.table).toBe('event_signup')
expect(r.original).toBe(' event_signup ')
})
})
describe('normalizeDmTableName — 字段同步去前缀辅助 (供调用方决定是否同步处理字段)', () => {
// 字段前缀去除 (f_xxx 中含 `${appCode}_` 的) 由调用方 (dm/create.ts) 在
// userFields.map 阶段独立处理, normalizeDmTableName 自身只负责 table 名字.
it('返回值不修改字段语义', () => {
const r = normalizeDmTableName({ raw: 'eventhub_event_signup', appCode: 'eventhub' })
expect(r.table).toBe('event_signup')
})
})