@svton/cli 1.2.2 → 1.2.4

package/templates/examples/oauth/README.md

@@ -1,192 +0,0 @@
-# OAuth 登录示例
-
-本示例展示如何使用 `@svton/nestjs-oauth` 模块实现微信登录。
-
-## 文件说明
-
-- `auth.service.ts` - 认证服务，处理 OAuth 流程
-- `auth.controller.ts` - 认证控制器，提供登录接口
-
-## 支持的登录方式
-
-### 1. 微信开放平台（PC 扫码登录）
-
-适用于网站应用，用户扫码登录。
-
-### 2. 微信公众号（网页授权）
-
-适用于公众号内网页，静默授权或用户授权。
-
-### 3. 微信小程序
-
-适用于小程序，使用 wx.login() 获取 code。
-
-## 使用方式
-
-### PC 扫码登录
-
-```typescript
-// 1. 获取授权 URL
-const url = this.authService.getWechatOpenAuthUrl('/dashboard');
-
-// 2. 重定向到微信授权页面
-// 用户扫码授权后，微信会回调到 callback 接口
-
-// 3. 处理回调
-const userInfo = await this.authService.handleWechatOpenCallback(code);
-```
-
-### 公众号网页授权
-
-```typescript
-// 1. 获取授权 URL
-const url = this.authService.getWechatMpAuthUrl('/profile');
-
-// 2. 重定向到微信授权页面
-// 用户授权后，微信会回调到 callback 接口
-
-// 3. 处理回调
-const userInfo = await this.authService.handleWechatMpCallback(code);
-```
-
-### 小程序登录
-
-```typescript
-// 小程序端
-wx.login({
-  success: (res) => {
-    // 将 code 发送到后端
-    wx.request({
-      url: 'https://api.example.com/examples/auth/wechat/miniprogram/login',
-      method: 'POST',
-      data: { code: res.code },
-    });
-  },
-});
-
-// 后端处理
-const result = await this.authService.miniprogramLogin(code);
-```
-
-### 小程序获取手机号
-
-```typescript
-// 小程序端
-<button open-type="getPhoneNumber" @getphonenumber="getPhoneNumber">
-  获取手机号
-</button>
-
-// 获取到 code 后发送到后端
-const result = await this.authService.getMiniprogramPhoneNumber(code);
-```
-
-## 测试接口
-
-### PC 扫码登录
-
-```bash
-# 1. 访问登录页面（会重定向到微信）
-curl http://localhost:3000/examples/auth/wechat/open/login
-
-# 2. 扫码授权后，微信会回调到：
-# http://localhost:3000/examples/auth/wechat/open/callback?code=xxx&state=/
-```
-
-### 小程序登录
-
-```bash
-curl -X POST http://localhost:3000/examples/auth/wechat/miniprogram/login \
-  -H "Content-Type: application/json" \
-  -d '{"code":"081234567890abcdef"}'
-```
-
-### 小程序获取手机号
-
-```bash
-curl -X POST http://localhost:3000/examples/auth/wechat/miniprogram/phone \
-  -H "Content-Type: application/json" \
-  -d '{"code":"081234567890abcdef"}'
-```
-
-## 环境变量配置
-
-在 `.env` 文件中配置：
-
-```env
-# 微信开放平台
-WECHAT_OPEN_APP_ID=wx1234567890abcdef
-WECHAT_OPEN_APP_SECRET=1234567890abcdef1234567890abcdef
-WECHAT_OPEN_CALLBACK_URL=https://yourdomain.com/examples/auth/wechat/open/callback
-
-# 微信公众号
-WECHAT_MP_APP_ID=wx1234567890abcdef
-WECHAT_MP_APP_SECRET=1234567890abcdef1234567890abcdef
-
-# 微信小程序
-WECHAT_MINI_APP_ID=wx1234567890abcdef
-WECHAT_MINI_APP_SECRET=1234567890abcdef1234567890abcdef
-```
-
-## 配置回调地址
-
-需要在微信后台配置回调地址：
-
-### 开放平台
-1. 登录微信开放平台
-2. 进入网站应用详情
-3. 配置授权回调域：`yourdomain.com`
-
-### 公众号
-1. 登录微信公众平台
-2. 设置与开发 -> 接口权限 -> 网页授权
-3. 配置授权回调域：`yourdomain.com`
-
-### 小程序
-1. 登录微信小程序后台
-2. 开发 -> 开发管理 -> 开发设置
-3. 配置服务器域名：`https://yourdomain.com`
-
-## 最佳实践
-
-1. **UnionID 机制**：使用 unionid 关联同一用户在不同应用的身份
-2. **Token 管理**：使用 JWT 生成 token，设置合理的过期时间
-3. **刷新机制**：实现 refresh_token 机制，避免频繁授权
-4. **错误处理**：妥善处理授权失败、token 过期等异常情况
-5. **安全性**：验证 state 参数，防止 CSRF 攻击
-
-## 常见场景
-
-### 网站登录
-
-```typescript
-// 1. 用户点击"微信登录"
-// 2. 重定向到微信授权页面
-// 3. 用户扫码授权
-// 4. 微信回调到后端
-// 5. 后端获取用户信息，生成 token
-// 6. 重定向到前端，携带 token
-```
-
-### 小程序登录
-
-```typescript
-// 1. 小程序调用 wx.login() 获取 code
-// 2. 将 code 发送到后端
-// 3. 后端调用 code2Session 获取 openid
-// 4. 查询或创建用户
-// 5. 返回 token 给小程序
-```
-
-### 绑定手机号
-
-```typescript
-// 1. 用户点击"获取手机号"按钮
-// 2. 小程序获取到 code
-// 3. 将 code 发送到后端
-// 4. 后端调用接口获取手机号
-// 5. 绑定手机号到用户账号
-```
-
-## 更多信息
-
-查看官方文档：https://751848178.github.io/svton/packages/nestjs-oauth

package/templates/examples/oauth/auth.controller.ts

@@ -1,99 +0,0 @@
-import { Controller, Get, Query, Redirect, Post, Body } from '@nestjs/common';
-import { AuthService } from './auth.service';
-
-@Controller('examples/auth')
-export class AuthController {
-  constructor(private readonly authService: AuthService) {}
-
-  /**
-   * 微信开放平台登录 - 获取授权 URL
-   */
-  @Get('wechat/open/login')
-  @Redirect()
-  wechatOpenLogin(@Query('redirect') redirect?: string) {
-    const state = redirect || '/';
-    const url = this.authService.getWechatOpenAuthUrl(state);
-
-    return { url };
-  }
-
-  /**
-   * 微信开放平台登录 - 回调处理
-   */
-  @Get('wechat/open/callback')
-  async wechatOpenCallback(
-    @Query('code') code: string,
-    @Query('state') state: string,
-  ) {
-    const userInfo = await this.authService.handleWechatOpenCallback(code);
-
-    // TODO: 生成 JWT token
-    // const token = await this.jwtService.sign({ userId: user.id });
-
-    return {
-      message: 'Login successful',
-      userInfo,
-      redirectUrl: state,
-      // token,
-    };
-  }
-
-  /**
-   * 微信公众号登录 - 获取授权 URL
-   */
-  @Get('wechat/mp/login')
-  @Redirect()
-  wechatMpLogin(@Query('redirect') redirect?: string) {
-    const state = redirect || '/';
-    const url = this.authService.getWechatMpAuthUrl(state);
-
-    return { url };
-  }
-
-  /**
-   * 微信公众号登录 - 回调处理
-   */
-  @Get('wechat/mp/callback')
-  async wechatMpCallback(
-    @Query('code') code: string,
-    @Query('state') state: string,
-  ) {
-    const userInfo = await this.authService.handleWechatMpCallback(code);
-
-    return {
-      message: 'Login successful',
-      userInfo,
-      redirectUrl: state,
-    };
-  }
-
-  /**
-   * 小程序登录
-   */
-  @Post('wechat/miniprogram/login')
-  async miniprogramLogin(@Body() body: { code: string }) {
-    const result = await this.authService.miniprogramLogin(body.code);
-
-    // TODO: 生成 JWT token
-    // const token = await this.jwtService.sign({ userId: user.id });
-
-    return {
-      message: 'Login successful',
-      ...result,
-      // token,
-    };
-  }
-
-  /**
-   * 小程序获取手机号
-   */
-  @Post('wechat/miniprogram/phone')
-  async getMiniprogramPhone(@Body() body: { code: string }) {
-    const result = await this.authService.getMiniprogramPhoneNumber(body.code);
-
-    return {
-      message: 'Phone number retrieved successfully',
-      ...result,
-    };
-  }
-}

package/templates/examples/oauth/auth.service.ts

@@ -1,97 +0,0 @@
-import { Injectable } from '@nestjs/common';
-import { OAuthService } from '@svton/nestjs-oauth';
-
-@Injectable()
-export class AuthService {
-  constructor(private readonly oauthService: OAuthService) {}
-
-  /**
-   * 获取微信开放平台授权 URL（PC 扫码登录）
-   */
-  getWechatOpenAuthUrl(state: string): string {
-    return this.oauthService.wechat.getAuthorizationUrl('open', state);
-  }
-
-  /**
-   * 获取微信公众号授权 URL（网页授权）
-   */
-  getWechatMpAuthUrl(state: string): string {
-    return this.oauthService.wechat.getAuthorizationUrl('mp', state);
-  }
-
-  /**
-   * 处理微信开放平台回调
-   */
-  async handleWechatOpenCallback(code: string) {
-    // 获取 access_token
-    const tokenResult = await this.oauthService.wechat.getAccessToken('open', code);
-
-    // 获取用户信息
-    const userInfo = await this.oauthService.wechat.getUserInfo(
-      'open',
-      tokenResult.access_token,
-      tokenResult.openid,
-    );
-
-    // TODO: 根据 openid 查询或创建用户
-    // const user = await this.userService.findOrCreateByWechatOpenId(userInfo.unionid);
-
-    return {
-      openid: userInfo.openid,
-      unionid: userInfo.unionid,
-      nickname: userInfo.nickname,
-      avatar: userInfo.headimgurl,
-    };
-  }
-
-  /**
-   * 处理微信公众号回调
-   */
-  async handleWechatMpCallback(code: string) {
-    const tokenResult = await this.oauthService.wechat.getAccessToken('mp', code);
-
-    const userInfo = await this.oauthService.wechat.getUserInfo(
-      'mp',
-      tokenResult.access_token,
-      tokenResult.openid,
-    );
-
-    // TODO: 根据 openid 查询或创建用户
-    // const user = await this.userService.findOrCreateByWechatMpOpenId(userInfo.openid);
-
-    return {
-      openid: userInfo.openid,
-      nickname: userInfo.nickname,
-      avatar: userInfo.headimgurl,
-    };
-  }
-
-  /**
-   * 小程序登录
-   */
-  async miniprogramLogin(code: string) {
-    const result = await this.oauthService.wechat.code2Session(code);
-
-    // TODO: 根据 openid 查询或创建用户
-    // const user = await this.userService.findOrCreateByWechatMiniOpenId(result.openid);
-
-    return {
-      openid: result.openid,
-      sessionKey: result.session_key,
-      unionid: result.unionid,
-    };
-  }
-
-  /**
-   * 小程序获取手机号
-   */
-  async getMiniprogramPhoneNumber(code: string) {
-    const result = await this.oauthService.wechat.getPhoneNumber(code);
-
-    return {
-      phoneNumber: result.phone_info.phoneNumber,
-      purePhoneNumber: result.phone_info.purePhoneNumber,
-      countryCode: result.phone_info.countryCode,
-    };
-  }
-}

package/templates/examples/payment/README.md

@@ -1,151 +0,0 @@
-# 支付功能示例
-
-本示例展示如何使用 `@svton/nestjs-payment` 模块集成微信支付和支付宝。
-
-## 文件说明
-
-- `order.service.ts` - 订单服务，创建支付订单
-- `order.controller.ts` - 订单控制器，提供支付接口
-- `webhook.controller.ts` - 支付回调处理
-
-## 支持的支付方式
-
-### 微信支付
-- JSAPI 支付（公众号/小程序）
-- Native 支付（扫码支付）
-- APP 支付
-- H5 支付
-- 小程序支付
-
-### 支付宝
-- 电脑网站支付（PC）
-- 手机网站支付（H5）
-- APP 支付
-
-## 使用方式
-
-### 1. 创建支付订单
-
-```typescript
-// 微信 JSAPI 支付
-const result = await this.paymentService.wechat.createOrder({
-  outTradeNo: orderId,
-  totalAmount: amount,
-  description: '商品购买',
-  userId: openid,
-}, 'jsapi');
-
-// 支付宝电脑网站支付
-const result = await this.paymentService.alipay.createOrder({
-  outTradeNo: orderId,
-  totalAmount: amount,
-  description: '商品购买',
-}, 'page');
-```
-
-### 2. 查询订单状态
-
-```typescript
-const status = await this.paymentService.wechat.queryOrder(outTradeNo);
-```
-
-### 3. 申请退款
-
-```typescript
-const refund = await this.paymentService.wechat.refund({
-  outTradeNo: orderId,
-  outRefundNo: refundId,
-  refundAmount: amount,
-  totalAmount: totalAmount,
-});
-```
-
-### 4. 处理支付回调
-
-```typescript
-@Post('webhook/wechat')
-async wechatWebhook(@Req() req: Request) {
-  const result = await this.paymentService.wechat.handleNotify(req);
-  // 处理支付成功逻辑
-  return { code: 'SUCCESS', message: '成功' };
-}
-```
-
-## 测试接口
-
-```bash
-# 创建微信 JSAPI 支付订单
-curl -X POST http://localhost:3000/examples/orders/wechat/jsapi \
-  -H "Content-Type: application/json" \
-  -d '{
-    "orderId": "ORDER_001",
-    "amount": 100,
-    "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
-  }'
-
-# 创建微信 Native 支付订单（扫码支付）
-curl -X POST http://localhost:3000/examples/orders/wechat/native \
-  -H "Content-Type: application/json" \
-  -d '{
-    "orderId": "ORDER_002",
-    "amount": 100
-  }'
-
-# 创建支付宝电脑网站支付订单
-curl -X POST http://localhost:3000/examples/orders/alipay/page \
-  -H "Content-Type: application/json" \
-  -d '{
-    "orderId": "ORDER_003",
-    "amount": 100
-  }'
-
-# 查询订单状态
-curl http://localhost:3000/examples/orders/ORDER_001/status
-
-# 申请退款
-curl -X POST http://localhost:3000/examples/orders/ORDER_001/refund \
-  -H "Content-Type: application/json" \
-  -d '{
-    "refundId": "REFUND_001",
-    "amount": 100,
-    "reason": "用户申请退款"
-  }'
-```
-
-## 环境变量配置
-
-在 `.env` 文件中配置：
-
-```env
-# 微信支付
-WECHAT_MCH_ID=商户号
-WECHAT_PRIVATE_KEY=./certs/apiclient_key.pem
-WECHAT_SERIAL_NO=证书序列号
-WECHAT_API_V3_KEY=APIv3密钥
-WECHAT_APP_ID=关联的AppID
-
-# 支付宝
-ALIPAY_APP_ID=应用ID
-ALIPAY_PRIVATE_KEY=./certs/alipay_private_key.pem
-ALIPAY_PUBLIC_KEY=./certs/alipay_public_key.pem
-```
-
-## 最佳实践
-
-1. **订单号唯一性**：确保 outTradeNo 全局唯一
-2. **金额单位**：统一使用分为单位
-3. **回调幂等性**：支付回调可能重复，需要幂等处理
-4. **异步通知**：优先使用异步通知，不依赖同步返回
-5. **安全验证**：验证回调签名，防止伪造
-6. **错误处理**：妥善处理支付失败、超时等异常情况
-
-## 回调地址配置
-
-需要在微信支付和支付宝后台配置回调地址：
-
-- 微信支付：`https://yourdomain.com/examples/webhooks/wechat`
-- 支付宝：`https://yourdomain.com/examples/webhooks/alipay`
-
-## 更多信息
-
-查看官方文档：https://751848178.github.io/svton/packages/nestjs-payment

package/templates/examples/payment/order.controller.ts

@@ -1,56 +0,0 @@
-import { Controller, Post, Get, Body, Param, Query } from '@nestjs/common';
-import { OrderService } from './order.service';
-
-@Controller('examples/orders')
-export class OrderController {
-  constructor(private readonly orderService: OrderService) {}
-
-  @Post('wechat/jsapi')
-  async createWechatJsapiOrder(
-    @Body() data: { orderId: string; amount: number; openid: string },
-  ) {
-    return this.orderService.createWechatJsapiOrder(
-      data.orderId,
-      data.amount,
-      data.openid,
-    );
-  }
-
-  @Post('wechat/native')
-  async createWechatNativeOrder(
-    @Body() data: { orderId: string; amount: number },
-  ) {
-    return this.orderService.createWechatNativeOrder(
-      data.orderId,
-      data.amount,
-    );
-  }
-
-  @Post('alipay/page')
-  async createAlipayPageOrder(
-    @Body() data: { orderId: string; amount: number },
-  ) {
-    return this.orderService.createAlipayPageOrder(
-      data.orderId,
-      data.amount,
-    );
-  }
-
-  @Get(':orderId/status')
-  async queryOrderStatus(@Param('orderId') orderId: string) {
-    return this.orderService.queryOrderStatus(orderId);
-  }
-
-  @Post(':orderId/refund')
-  async refundOrder(
-    @Param('orderId') orderId: string,
-    @Body() data: { refundId: string; amount: number; reason?: string },
-  ) {
-    return this.orderService.refundOrder(
-      orderId,
-      data.refundId,
-      data.amount,
-      data.reason,
-    );
-  }
-}