qing-client 0.0.2

package/lib/client/BaseClient.d.ts

@@ -0,0 +1,21 @@
+import { AxiosInstance, RawAxiosRequestHeaders } from 'axios';
+import { UserContext, ClientConfig, RequestOptions, TokenStorage, PaginatedResponse } from '../types';
+export declare abstract class BaseClient {
+    protected config: ClientConfig;
+    protected serviceName: string;
+    protected axiosInstance: AxiosInstance;
+    protected userContext?: UserContext;
+    protected isFrontendMode: boolean;
+    protected serviceBasePath: string;
+    protected tokenStorage: TokenStorage;
+    constructor(config: ClientConfig, serviceName: string);
+    initUserContext(context: UserContext): RawAxiosRequestHeaders;
+    setUserContext(context: UserContext): this;
+    setTokenStorage(storage: TokenStorage): this;
+    private getBaseUrl;
+    setToken(token: string): Promise<void>;
+    clearToken(): Promise<void>;
+    protected request<T>(path: string, options?: RequestOptions): Promise<T>;
+    protected paginatedRequest<T>(path: string, options?: RequestOptions): Promise<PaginatedResponse<T>>;
+    private handleApiError;
+}

package/lib/client/BaseClient.js

@@ -0,0 +1,194 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+// 默认内存存储实现
+const memoryTokenStorage = {
+    token: undefined,
+    async getToken() {
+        return this.token;
+    },
+    async setToken(token) {
+        this.token = token;
+    },
+    async clearToken() {
+        this.token = undefined;
+    }
+};
+class BaseClient {
+    constructor(config, serviceName) {
+        this.config = config;
+        this.serviceName = serviceName;
+        this.isFrontendMode = !!config.gatewayUrl;
+        this.serviceBasePath = `/api/${serviceName}`;
+        // 设置令牌存储
+        this.tokenStorage = config.tokenStorage || memoryTokenStorage;
+        // 创建Axios实例
+        this.axiosInstance = axios_1.default.create({
+            baseURL: this.getBaseUrl(),
+            timeout: 30000,
+            headers: {
+                'Content-Type': 'application/json',
+                'Accept': 'application/json'
+            }
+        });
+        // 添加请求拦截器
+        this.axiosInstance.interceptors.request.use(async (config) => {
+            let headers = config.headers || {};
+            // 1. 注入用户上下文（后端模式）
+            if (!this.isFrontendMode && this.userContext)
+                headers = {
+                    ...headers,
+                    ...this.initUserContext(this.userContext)
+                };
+            // 2. 注入认证令牌
+            const token = await this.tokenStorage.getToken();
+            if (token) {
+                headers['Authorization'] = `Bearer ${token}`;
+            }
+            // 合并自定义头
+            if (config.headers) {
+                Object.assign(headers, config.headers);
+            }
+            return {
+                ...config,
+                headers
+            };
+        });
+    }
+    initUserContext(context) {
+        return {
+            'v-user-id': context.userId,
+            'v-user-role': context.role,
+            'v-project-id': context.projectId
+        };
+    }
+    // 设置用户上下文（后端模式使用）
+    setUserContext(context) {
+        this.userContext = context;
+        return this;
+    }
+    // 设置令牌存储（可在运行时更换存储策略）
+    setTokenStorage(storage) {
+        this.tokenStorage = storage;
+        return this;
+    }
+    // 确定请求基础URL
+    getBaseUrl() {
+        if (this.isFrontendMode) {
+            return this.config.gatewayUrl;
+        }
+        // 后端模式使用服务专属URL
+        switch (this.serviceName) {
+            case 'auth': return this.config.authServiceUrl;
+            case 'msg': return this.config.msgServiceUrl;
+            case 'users': return this.config.userServiceUrl;
+            case 'file': return this.config.fileServiceUrl;
+            case 'survey': return this.config.surveyServiceUrl;
+            case 'token': return this.config.tokenServiceUrl;
+            default: throw new Error(`Unsupported service: ${this.serviceName}`);
+        }
+    }
+    // 设置认证令牌
+    async setToken(token) {
+        await this.tokenStorage.setToken(token);
+    }
+    // 清除认证令牌
+    async clearToken() {
+        await this.tokenStorage.clearToken();
+    }
+    // 统一请求方法 - 处理标准API响应
+    async request(path, options = { method: 'GET' }) {
+        try {
+            const fullPath = this.isFrontendMode
+                ? `${this.serviceBasePath}${path}`
+                : path;
+            let headers = options.headers || {};
+            const context = options.userContext || this.userContext;
+            if (context) {
+                headers = { ...headers, ...this.initUserContext(context) };
+            }
+            const response = await this.axiosInstance.request({
+                url: fullPath,
+                method: options.method,
+                headers,
+                params: options.params,
+                data: options.body
+            });
+            console.log('Request URL:', this.getBaseUrl() + fullPath);
+            console.log('Request params:', options.params);
+            // 检查业务成功状态
+            if (!response.data.success) {
+                throw new Error(response.data.message || `业务请求失败`);
+            }
+            // 返回实际数据
+            return response.data.data;
+        }
+        catch (error) {
+            // 明确返回错误处理
+            return this.handleApiError(error, path);
+        }
+    }
+    // 分页请求方法 - 处理分页API响应
+    async paginatedRequest(path, options = { method: 'GET' }) {
+        try {
+            const fullPath = this.isFrontendMode
+                ? `${this.serviceBasePath}${path}`
+                : path;
+            const response = await this.axiosInstance.request({
+                url: fullPath,
+                method: options.method,
+                headers: options.headers,
+                params: options.params,
+                data: options.body
+            });
+            // 检查业务成功状态
+            if (!response.data.success) {
+                throw new Error(response.data.message || `业务请求失败`);
+            }
+            // 返回分页数据 - 直接返回整个data部分
+            return response.data;
+        }
+        catch (error) {
+            this.handleApiError(error, path);
+        }
+    }
+    // 统一错误处理方法
+    handleApiError(error, path) {
+        let errorMessage = `[${this.serviceName}服务] `;
+        if (error.response) {
+            const responseData = error.response.data;
+            // 尝试从响应体中提取错误信息
+            if (responseData?.message) {
+                errorMessage += responseData.message;
+            }
+            else if (responseData?.error) {
+                errorMessage += responseData.error;
+            }
+            else {
+                errorMessage += `请求失败，状态码: ${error.response.status}`;
+            }
+            // 添加详细错误信息（开发环境）
+            if (process.env.NODE_ENV === 'development') {
+                errorMessage += ` | 状态码: ${error.response.status}`;
+                if (error.response.headers?.['x-request-id']) {
+                    errorMessage += ` | 请求ID: ${error.response.headers['x-request-id']}`;
+                }
+            }
+        }
+        else if (error.request) {
+            errorMessage += '服务器未响应';
+        }
+        else {
+            errorMessage += error.message;
+        }
+        // 添加路径信息
+        errorMessage += ` (路径: ${path})`;
+        // 明确抛出错误
+        throw new Error(errorMessage);
+    }
+}
+exports.BaseClient = BaseClient;

package/lib/client/index.d.ts

@@ -0,0 +1,14 @@
+import { AuthService } from "../srvice/AuthService";
+import { MsgService } from "../srvice/MsgService";
+import { TokenService } from "../srvice/TokenService";
+import { UserService } from "../srvice/UserService";
+import { ClientConfig, UserContext } from "../types";
+export declare class Client {
+    protected config: ClientConfig;
+    readonly auth: AuthService;
+    readonly msg: MsgService;
+    readonly user: UserService;
+    readonly token: TokenService;
+    constructor(config: ClientConfig);
+    setUserContext(context: UserContext): this;
+}

package/lib/client/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Client = void 0;
+const AuthService_1 = require("../srvice/AuthService");
+const MsgService_1 = require("../srvice/MsgService");
+const TokenService_1 = require("../srvice/TokenService");
+const UserService_1 = require("../srvice/UserService");
+class Client {
+    constructor(config) {
+        this.config = config;
+        this.auth = new AuthService_1.AuthService(config);
+        this.msg = new MsgService_1.MsgService(config);
+        this.user = new UserService_1.UserService(config);
+        this.token = new TokenService_1.TokenService(config);
+    }
+    setUserContext(context) {
+        this.auth.setUserContext(context);
+        this.msg.setUserContext(context);
+        this.user.setUserContext(context);
+        this.token.setUserContext(context);
+        return this;
+    }
+}
+exports.Client = Client;

package/lib/index.js

@@ -0,0 +1 @@
+"use strict";

package/lib/srvice/AuthService.d.ts

@@ -0,0 +1,8 @@
+import { BaseClient } from "../client/BaseClient";
+import { ClientConfig, RequestOptions } from "../types";
+import { LoginResponse } from "../types/user";
+export declare class AuthService extends BaseClient {
+    constructor(config: ClientConfig);
+    login(identifier: string, password: string, projectId?: number, options?: RequestOptions): Promise<LoginResponse>;
+    logout(token: string, options?: RequestOptions): Promise<void>;
+}

package/lib/srvice/AuthService.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthService = void 0;
+const BaseClient_1 = require("../client/BaseClient");
+const qs_1 = __importDefault(require("qs"));
+class AuthService extends BaseClient_1.BaseClient {
+    constructor(config) {
+        super(config, 'auth');
+    }
+    // 用户登录 - 匹配后端请求格式
+    async login(identifier, password, projectId = 0, options) {
+        const body = qs_1.default.stringify({
+            grant_type: "password",
+            username: identifier,
+            password
+        });
+        return this.request('/login', {
+            ...options,
+            method: 'POST',
+            headers: {
+                ...options?.headers,
+                "Content-Type": "application/x-www-form-urlencoded"
+            },
+            params: {
+                project_id: projectId
+            },
+            body: body
+        });
+    }
+    // 用户登出 - 匹配后端请求格式
+    async logout(token, options) {
+        return this.request('/logout', {
+            ...options,
+            method: 'POST',
+            headers: {
+                ...options?.headers,
+                Authorization: `Bearer ${token}`
+            }
+        });
+    }
+}
+exports.AuthService = AuthService;

package/lib/srvice/MsgService.d.ts

@@ -0,0 +1,8 @@
+import { BaseClient } from "../client/BaseClient";
+import { ClientConfig, RequestOptions } from "../types";
+import { FeishuMessage, MailRequest } from "../types/msg";
+export declare class MsgService extends BaseClient {
+    constructor(config: ClientConfig);
+    sendMail(request: MailRequest, options?: RequestOptions): Promise<void>;
+    sendFeishuMessage(message: FeishuMessage, options?: RequestOptions): Promise<void>;
+}

package/lib/srvice/MsgService.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MsgService = void 0;
+const BaseClient_1 = require("../client/BaseClient");
+class MsgService extends BaseClient_1.BaseClient {
+    constructor(config) {
+        super(config, 'msg');
+    }
+    // 发送邮件 - 返回实际结果
+    async sendMail(request, options) {
+        return this.request('/mail/send', {
+            ...options,
+            method: 'POST',
+            body: request
+        });
+    }
+    // 发送飞书消息 - 返回实际结果
+    async sendFeishuMessage(message, options) {
+        return this.request('/webhook/feishu/send', {
+            ...options,
+            method: 'POST',
+            body: message
+        });
+    }
+}
+exports.MsgService = MsgService;

package/lib/srvice/TokenService.d.ts

@@ -0,0 +1,10 @@
+import { BaseClient } from "../client/BaseClient";
+import { ClientConfig, RequestOptions } from "../types";
+import { WxOfficialAccountTokenResponse, WxJsapiTicketResponse, WxSignatureRequest, WxSignatureResponse, WxMiniProgramTokenResponse } from "../types/token";
+export declare class TokenService extends BaseClient {
+    constructor(config: ClientConfig);
+    getWxOfficialAccountToken(appid: string, options?: RequestOptions): Promise<WxOfficialAccountTokenResponse>;
+    getWxJsapiTicket(appid: string, options?: RequestOptions): Promise<WxJsapiTicketResponse>;
+    getWxSignature(signatureRequest: WxSignatureRequest, options?: RequestOptions): Promise<WxSignatureResponse>;
+    getWxMiniProgramToken(appid: string, options?: RequestOptions): Promise<WxMiniProgramTokenResponse>;
+}

package/lib/srvice/TokenService.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenService = void 0;
+const BaseClient_1 = require("../client/BaseClient");
+class TokenService extends BaseClient_1.BaseClient {
+    constructor(config) {
+        super(config, 'token');
+    }
+    // 获取微信公众号access_token
+    async getWxOfficialAccountToken(appid, options) {
+        return this.request('/wxh5/accesstoken', {
+            ...options,
+            method: 'GET',
+            params: { appid }
+        });
+    }
+    // 获取微信公众号jsapi_ticket
+    async getWxJsapiTicket(appid, options) {
+        return this.request('/wxh5/jsapi_ticket', {
+            ...options,
+            method: 'GET',
+            params: { appid }
+        });
+    }
+    // 获取微信公众号签名
+    async getWxSignature(signatureRequest, options) {
+        return this.request('/wxh5/signature', {
+            ...options,
+            method: 'POST',
+            body: signatureRequest
+        });
+    }
+    // 获取微信小程序access_token
+    async getWxMiniProgramToken(appid, options) {
+        return this.request('/wxmp/accesstoken', {
+            ...options,
+            method: 'GET',
+            params: { appid }
+        });
+    }
+}
+exports.TokenService = TokenService;

package/lib/srvice/UserService.d.ts

@@ -0,0 +1,10 @@
+import { BaseClient } from "../client/BaseClient";
+import { ClientConfig, RequestOptions, PaginatedResponse } from "../types";
+import { User, UserCreateRequest, UserUpdateRequest } from "../types/user";
+export declare class UserService extends BaseClient {
+    constructor(config: ClientConfig);
+    getCurrentUser(options?: RequestOptions): Promise<User>;
+    createUser(userData: UserCreateRequest, options?: RequestOptions): Promise<User>;
+    updateUser(userId: number, updateData: UserUpdateRequest, options?: RequestOptions): Promise<User>;
+    listUsers(includeInactive?: boolean, page?: number, perPage?: number, options?: RequestOptions): Promise<PaginatedResponse<User>>;
+}

package/lib/srvice/UserService.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserService = void 0;
+const BaseClient_1 = require("../client/BaseClient");
+class UserService extends BaseClient_1.BaseClient {
+    constructor(config) {
+        super(config, 'users');
+    }
+    // 获取当前用户信息 - 返回完整响应
+    async getCurrentUser(options) {
+        return this.request('/me', {
+            ...options,
+            method: 'GET'
+        });
+    }
+    // 创建用户（管理员） - 匹配后端请求格式
+    async createUser(userData, options) {
+        return this.request('', {
+            ...options,
+            method: 'POST',
+            body: {
+                username: userData.username,
+                email: userData.email,
+                password: userData.password,
+                name: userData.name,
+                role: userData.role,
+                phone: userData.phone,
+                project_id: userData.project_id
+            }
+        });
+    }
+    // 更新用户信息 - 匹配后端请求格式
+    async updateUser(userId, updateData, options) {
+        return this.request(`/${userId}`, {
+            ...options,
+            method: 'PUT',
+            body: {
+                name: updateData.name,
+                avatar: updateData.avatar,
+                phone: updateData.phone,
+                role: updateData.role,
+                project_id: updateData.project_id
+            }
+        });
+    }
+    // 获取用户列表（管理员） - 返回分页数据
+    async listUsers(includeInactive = false, page = 1, perPage = 10, options) {
+        const response = await this.paginatedRequest('', {
+            ...options,
+            method: 'GET',
+            params: {
+                include_inactive: includeInactive,
+                page,
+                per_page: perPage
+            }
+        });
+        // 直接返回分页响应
+        return response;
+    }
+}
+exports.UserService = UserService;

package/lib/types/index.d.ts

@@ -0,0 +1,44 @@
+export interface ApiResponse<T = any> {
+    success: boolean;
+    message: string;
+    data: T;
+}
+export interface Pagination {
+    page: number;
+    per_page: number;
+    total: number;
+    total_pages: number;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    success: boolean;
+    message: string;
+    pagination: Pagination;
+}
+export interface TokenStorage {
+    getToken(): Promise<string | undefined>;
+    setToken(token: string): Promise<void>;
+    clearToken(): Promise<void>;
+}
+export interface ClientConfig {
+    gatewayUrl?: string;
+    authServiceUrl?: string;
+    msgServiceUrl?: string;
+    userServiceUrl?: string;
+    fileServiceUrl?: string;
+    surveyServiceUrl?: string;
+    tokenServiceUrl?: string;
+    tokenStorage?: TokenStorage;
+}
+export interface UserContext {
+    userId: string;
+    role: 'SUPER_ADMIN' | 'ADMIN' | 'STAFF' | 'USER' | 'SYSTEM';
+    projectId: string;
+}
+export interface RequestOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    headers?: Record<string, string>;
+    params?: Record<string, any>;
+    body?: any;
+    userContext?: UserContext;
+}

package/lib/types/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/msg.d.ts

@@ -0,0 +1,31 @@
+export interface MailRequest {
+    to: string[];
+    subject: string;
+    text?: string;
+    html?: string;
+    from?: string;
+    cc?: string[];
+    bcc?: string[];
+    attachments?: Array<{
+        filename: string;
+        content: string;
+        contentType?: string;
+    }>;
+}
+export interface FeishuMessage {
+    url: string;
+    title?: string;
+    bgColor?: string;
+    elements: Array<{
+        title: string;
+        text: string;
+        color?: string;
+    }>;
+    noticeUser?: Array<{
+        userId: string;
+    }>;
+    actions?: Array<{
+        text: string;
+        url: string;
+    }>;
+}

package/lib/types/msg.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/token.d.ts

@@ -0,0 +1,22 @@
+export interface WxOfficialAccountTokenResponse {
+    access_token: string;
+}
+export interface WxJsapiTicketResponse {
+    jsapi_ticket: string;
+}
+export interface WxSignatureRequest {
+    appid: string;
+    url: string;
+    imgUrl?: string;
+}
+export interface WxSignatureResponse {
+    appId: string;
+    timestamp: number;
+    nonceStr: string;
+    signature: string;
+    url: string;
+    imgUrl: string;
+}
+export interface WxMiniProgramTokenResponse {
+    access_token: string;
+}

package/lib/types/token.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/user.d.ts

@@ -0,0 +1,37 @@
+export interface User {
+    id: number;
+    username: string;
+    email: string;
+    name?: string;
+    avatar?: string;
+    phone?: string;
+    role: string;
+    project_id: number;
+    is_active: boolean;
+    last_login_ip?: string;
+    last_login?: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface UserCreateRequest {
+    username: string;
+    email: string;
+    password: string;
+    name?: string;
+    role?: string;
+    phone?: string;
+    project_id?: number;
+}
+export interface UserUpdateRequest {
+    name?: string;
+    avatar?: string;
+    phone?: string;
+    role?: string;
+    project_id?: number;
+}
+export interface LoginResponse {
+    access_token: string;
+    token_type: string;
+    expires_at: string;
+    project_id: number;
+}

package/lib/types/user.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });