hile-typeorm（希尔类型）

@hile/typeorm SKILL

本文档规范 @hile/typeorm 的使用方式，确保 DataSource 生命周期与事务行为一致。

1. 架构概览

@hile/typeorm 提供：

• 默认导出：Hile 服务化的 TypeORM DataSource
• transaction：事务封装，支持失败时 LIFO 执行补偿回调

依赖：@hile/core、typeorm。

2. 环境变量

行为：

• synchronize: true
• NODE_ENV === 'development' 时 logging: true
• 未设置 TYPEORM_ENTITIES 时实体为空数组

3. 标准模板

3.1 加载默认 DataSource 服务

import { loadService } from '@hile/core'
import typeormService from '@hile/typeorm'

const ds = await loadService(typeormService)

3.2 事务执行与补偿

import { transaction } from '@hile/typeorm'

const result = await transaction(ds, async (runner, rollback) => {
  rollback(async () => {
    // 事务失败时执行的补偿逻辑
  })

  // 使用 runner 执行写操作
  return value
})

4. 强制规则

1. 统一通过 loadService(typeormService) 获取 DataSource。
2. 不在多个模块里自行 new 全局 DataSource 与本包混用。
3. 需要失败补偿时，使用 rollback(fn) 注册，不在事务外分散处理。
4. 依赖 DataSource 的服务在函数内部 loadService，不要模块顶层缓存。

5. API 速查