@longzai-intelligence/shared-kernel-mapper 0.1.0

package/README.md

@@ -0,0 +1,73 @@
+# @longzai-intelligence/shared-kernel-mapper
+
+Mapper 类型定义包，提供 ORM Mapper 和 Application Mapper 的统一接口类型。
+
+## 安装
+
+```bash
+bun add @longzai-intelligence/shared-kernel-mapper
+```
+
+## 使用
+
+### ORM Mapper 接口
+
+```typescript
+import type { OrmMapper } from '@longzai-intelligence/shared-kernel-mapper';
+
+type UserOrmMapper = OrmMapper<UserEntity, UserOrmEntity>;
+
+// 实现示例
+class UserOrmMapperImpl implements UserOrmMapper {
+  toDomain(orm: UserOrmEntity): UserEntity {
+    // 转换逻辑
+  }
+
+  toOrm(entity: UserEntity): UserOrmEntity {
+    // 转换逻辑
+  }
+}
+```
+
+### Application Mapper 接口
+
+```typescript
+import type { ApplicationMapper } from '@longzai-intelligence/shared-kernel-mapper';
+
+type UserMapper = ApplicationMapper<UserEntity, UserDTO>;
+
+// 实现示例
+class UserMapperImpl implements UserMapper {
+  toDTO(entity: UserEntity): UserDTO {
+    // 转换逻辑
+  }
+
+  toDTOList(entities: UserEntity[]): UserDTO[] {
+    return entities.map((entity) => this.toDTO(entity));
+  }
+}
+```
+
+## API
+
+### OrmMapper<TDomain, TOrm>
+
+ORM Mapper 接口类型，定义领域实体与 ORM 实体之间的双向转换契约。
+
+| 方法 | 签名 | 说明 |
+|------|------|------|
+| `toDomain` | `(orm: TOrm) => TDomain` | 将 ORM 实体转换为领域实体 |
+| `toOrm` | `(entity: TDomain) => TOrm` | 将领域实体转换为 ORM 实体 |
+
+### ApplicationMapper<TDomain, TDTO>
+
+Application Mapper 接口类型，定义领域实体与 DTO 之间的转换契约。
+
+| 方法 | 签名 | 说明 |
+|------|------|------|
+| `toDTO` | `(entity: TDomain) => TDTO` | 将领域实体转换为 DTO |
+| `toDTOList` | `(entities: TDomain[]) => TDTO[]` | 批量将领域实体转换为 DTO |
+
+## 相关文档
+
+- [Domain Mapper 实现规范](../../../docs/standards/domain/domain-mapper-standard.md)

package/dist/index.d.cts

@@ -0,0 +1,15 @@
+//#region src/mapper.types.d.ts
+type OrmMapper<TDomain, TOrm> = {
+  toDomain(orm: TOrm): TDomain;
+  toOrm(entity: TDomain): TOrm;
+};
+type ApplicationMapper<TDomain, TDTO> = {
+  toDTO(entity: TDomain): TDTO;
+  toDTOList(entities: TDomain[]): TDTO[];
+};
+type DomainMapper<TDomain, TPersistence> = {
+  toDomain(data: TPersistence): TDomain;
+  toPersistence(entity: TDomain): TPersistence;
+};
+//#endregion
+export { type ApplicationMapper, type DomainMapper, type OrmMapper };

package/dist/index.d.mts

@@ -0,0 +1,15 @@
+//#region src/mapper.types.d.ts
+type OrmMapper<TDomain, TOrm> = {
+  toDomain(orm: TOrm): TDomain;
+  toOrm(entity: TDomain): TOrm;
+};
+type ApplicationMapper<TDomain, TDTO> = {
+  toDTO(entity: TDomain): TDTO;
+  toDTOList(entities: TDomain[]): TDTO[];
+};
+type DomainMapper<TDomain, TPersistence> = {
+  toDomain(data: TPersistence): TDomain;
+  toPersistence(entity: TDomain): TPersistence;
+};
+//#endregion
+export { type ApplicationMapper, type DomainMapper, type OrmMapper };

package/dist/index.mjs

@@ -0,0 +1 @@
+export{};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@longzai-intelligence/shared-kernel-mapper",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.mts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "build:prod": "NODE_ENV=production tsdown",
+    "prepublishOnly": "bun run build:prod",
+    "dev": "tsdown --watch",
+    "clean": "rimraf dist tsconfig/.cache",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "tsc --noEmit -p tsconfig/app.json",
+    "typecheck:node": "tsc --noEmit -p tsconfig/node.json",
+    "typecheck:test": "tsc --noEmit -p tsconfig/test.json",
+    "upgrade-deps": "ncu -u"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.12",
+    "@types/node": "^25.6.0",
+    "eslint": "^10.2.1",
+    "rimraf": "^6.1.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.4",
+    "@longzai-intelligence/eslint-preset-library": "0.2.5",
+    "@longzai-intelligence/vitest-config": "0.0.9",
+    "@longzai-intelligence/typescript-config": "0.0.3",
+    "tsdown": "^0.21.9",
+    "@longzai-intelligence/tsdown-config": "0.0.1"
+  },
+  "keywords": [
+    "shared-kernel",
+    "mapper"
+  ],
+  "license": "UNLICENSED",
+  "module": "./dist/index.mjs"
+}