@dofe/sso-contracts 0.1.2 → 0.1.4

package/README.md

@@ -82,11 +82,7 @@ throw ApiExceptionV2.fromCode(TeamErrorCode.TeamNotFound);
 ### 前端错误处理
 
 ```typescript
-import {
-  TeamErrorCode,
-  handleApiError,
-  createErrorHandler,
-} from '@repo/contracts/errors';
+import { TeamErrorCode, handleApiError, createErrorHandler } from '@repo/contracts/errors';
 
 // 创建类型安全的错误处理器
 const teamErrorHandler = createErrorHandler({
@@ -211,43 +207,56 @@ pnpm --filter @repo/contracts build
 本包在 workspace 内使用名称 `@repo/contracts`，发布到 npmjs 时使用名称 `@dofe/sso-contracts`。
 
 发布脚本会自动处理名称转换：
+
 - `prepack` - 发布前将名称改为 `@dofe/sso-contracts`
 - `postpack` - 发布后恢复为 `@repo/contracts`
 
 ### 发布命令
 
+#### 从根目录发布（推荐）
+
 ```bash
-# 进入 contracts 目录
-cd sso.dofe.ai/packages/contracts
+# 在 sso.dofe.ai 根目录执行
 
-# 发布 patch 版本 (0.1.0 → 0.1.1)
-pnpm release:patch
+# 发布单个包
+pnpm release:contracts          # 发布 @dofe/sso-contracts
+pnpm release:contracts:otp      # 带 OTP 发布
+
+# 批量发布所有包
+pnpm release:all                # 发布 contracts、hooks、ui
+pnpm release:all:otp            # 带 OTP 批量发布
+```
 
-# 发布 minor 版本 (0.1.0 → 0.2.0)
-pnpm release:minor
+#### 从包目录发布
 
-# 发布 major 版本 (0.1.0 → 1.0.0)
-pnpm release:major
+```bash
+# 进入 contracts 目录
+cd sso.dofe.ai/packages/contracts
 
-# 带 OTP 发布（如果启用了 2FA）
-npm publish --access public --otp=<你的OTP码>
+# 手动发布流程
+pnpm build
+node scripts/prepack.mjs
+npm publish --access public --ignore-scripts --otp=<你的OTP码>
+node scripts/postpack.mjs
 ```
 
-### 发布流程详解
+### 从根目录发布流程详解
 
 ```bash
-pnpm release:patch
+pnpm release:contracts:otp
 ```
 
 执行步骤：
-1. `npm version patch` - 升级版本号
-2. `pnpm run prepack` - 将 package.json 名称改为 `@dofe/sso-contracts`
-3. `npm publish --access public` - 发布到 npmjs
-4. `pnpm run postpack` - 恢复 package.json 名称为 `@repo/contracts`
+
+1. 进入 `packages/contracts` 目录
+2. 运行 `prepack` 修改 package.json（名称改为 `@dofe/sso-contracts`）
+3. 执行 `npm publish --access public --ignore-scripts --otp`
+4. 运行 `postpack` 恢复 package.json 原始状态
 
 ### 前置条件
 
 1. npm 账户登录：
+
    ```bash
    npm login
    ```
@@ -276,14 +285,14 @@ import { internalContract } from '@dofe/sso-contracts/api';
 
 ### 可用导出
 
-| 导出路径 | 内容 |
-|---------|------|
-| `@dofe/sso-contracts` | 所有 schemas、contracts、errors |
-| `@dofe/sso-contracts/api` | API contracts |
-| `@dofe/sso-contracts/schemas` | Zod schemas |
+| 导出路径                               | 内容                               |
+| -------------------------------------- | ---------------------------------- |
+| `@dofe/sso-contracts`                  | 所有 schemas、contracts、errors    |
+| `@dofe/sso-contracts/api`              | API contracts                      |
+| `@dofe/sso-contracts/schemas`          | Zod schemas                        |
 | `@dofe/sso-contracts/schemas/internal` | Internal API schemas (Tenant/Team) |
-| `@dofe/sso-contracts/errors` | Error codes |
-| `@dofe/sso-contracts/base` | Base utilities (createApiResponse) |
+| `@dofe/sso-contracts/errors`           | Error codes                        |
+| `@dofe/sso-contracts/base`             | Base utilities (createApiResponse) |
 
 ### 常见问题
 
@@ -294,6 +303,7 @@ A: 确保 npm 账户有权限发布 `@dofe` scope 包。需要先在 npmjs 创
 **Q: 发布失败 "Package already exists"**
 
 A: 版本号已存在，需要升级版本：
+
 ```bash
 pnpm release:patch
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dofe/sso-contracts",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "SSO API contracts and schemas for DofeAI platform",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",