/** * 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') }) })