@geekron/hono 0.1.0 → 0.1.2

package/dist/core/lib/services/mailer.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailer.service.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/services/mailer.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAwC3D;;;;GAIG;AACH,wBAAsB,gBAAgB,CACrC,aAAa,EAAE,kBAAkB,GAC/B,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAK5E;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC,CAU/D"}

package/dist/core/lib/services/mailer.service.js

@@ -0,0 +1,96 @@
+/**
+ * 邮件发送服务
+ * 使用 nodemailer 发送邮件
+ */
+import { MAIL_FROM, MAIL_HOST, MAIL_PASS, MAIL_PORT, MAIL_SECURE, MAIL_TO, MAIL_USER, } from '../../../contract';
+import { InquiryEmailTemplate } from '../../../core/components';
+import { getSite } from '../../../strapi';
+/**
+ * 邮件配置
+ * 从环境变量中读取配置
+ */
+const MAIL_CONFIG = {
+    host: MAIL_HOST,
+    port: MAIL_PORT,
+    secure: MAIL_SECURE,
+    auth: {
+        user: MAIL_USER,
+        pass: MAIL_PASS,
+    },
+};
+/**
+ * 延迟加载 nodemailer
+ */
+let transporter = null;
+async function getTransporter() {
+    if (!transporter) {
+        const nodemailer = await import('nodemailer');
+        transporter = nodemailer.default.createTransport(MAIL_CONFIG);
+    }
+    return transporter;
+}
+/**
+ * 将 JSX 组件渲染为 HTML 字符串
+ * Hono 的 JSX 运行时会自动处理
+ */
+function renderToString(component) {
+    // Hono JSX 组件可以直接转换为字符串
+    return String(component);
+}
+/**
+ * 发送询盘邮件
+ * @param inquiryValues - 询盘数据
+ * @returns Promise<boolean> - 发送成功返回 true，失败返回 false
+ */
+export async function sendInquiryEmail(inquiryValues) {
+    try {
+        console.log('[Mailer] Preparing to send inquiry email, ID:', inquiryValues.id);
+        // 渲染邮件模板
+        const emailTemplate = InquiryEmailTemplate({ values: inquiryValues });
+        const htmlContent = renderToString(emailTemplate);
+        const site = getSite();
+        // 邮件选项
+        const mailOptions = {
+            from: MAIL_FROM,
+            to: site?.inquiryEmail || MAIL_TO,
+            subject: `[询盘通知] 新询盘 #${inquiryValues.id} - ${inquiryValues.firstName} ${inquiryValues.lastName}`,
+            html: htmlContent,
+        };
+        // 发送邮件
+        const mailer = await getTransporter();
+        const info = await mailer.sendMail(mailOptions);
+        console.log('[Mailer] Email sent successfully:', info.messageId);
+        return true;
+    }
+    catch (error) {
+        console.error('[Mailer] Failed to send email:', error);
+        return false;
+    }
+}
+/**
+ * 异步发送询盘邮件(非阻塞)
+ * 使用 Promise 但不等待结果,避免阻塞主流程
+ * @param inquiryValue - 询盘数据
+ */
+export function sendInquiryEmailAsync(inquiryValue) {
+    // 异步发送,不等待结果
+    sendInquiryEmail(inquiryValue).catch((error) => {
+        console.error('[Mailer] Async email sending failed:', error);
+    });
+}
+/**
+ * 验证邮件服务连接
+ * @returns Promise<boolean> - 连接成功返回 true
+ */
+export async function verifyMailerConnection() {
+    try {
+        const mailer = await getTransporter();
+        await mailer.verify();
+        console.log('[Mailer] Connection verified successfully');
+        return true;
+    }
+    catch (error) {
+        console.error('[Mailer] Connection verification failed:', error);
+        return false;
+    }
+}

package/dist/core/lib/types/inquiry.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 询盘列表查询参数
+ */
+export interface InquiryListQueryDto {
+    /** 页码 */
+    page?: number;
+    /** 每页条数 */
+    pageSize?: number;
+    /** 搜索关键词 */
+    keyword?: string;
+    /** 开始时间 */
+    start?: string;
+    /** 结束时间 */
+    end?: string;
+    /** 排序字段 */
+    sortBy?: 'createdAt' | 'email';
+    /** 排序方向 */
+    order?: 'asc' | 'desc';
+}
+/**
+ * 询盘提交数据
+ */
+export interface InquiryCreateDto {
+    /** hCaptcha token */
+    hcaptcha_token: string;
+    /** hCaptcha sitekey */
+    hcaptcha_sitekey: string;
+    /** 邮箱 */
+    email: string;
+    /** 名 */
+    first_name: string;
+    /** 姓 */
+    last_name: string;
+    /** 消息内容 */
+    message: string;
+    /** 电话 */
+    phone?: string;
+    /** 来源页面 */
+    referer?: string;
+    /** 其他扩展数据 */
+    [key: string]: any;
+}
+/**
+ * API 响应格式
+ */
+export interface ApiResponse<T = any> {
+    /** 业务状态码 */
+    code: number;
+    /** 响应消息 */
+    message: string;
+    /** 响应数据 */
+    data: T;
+    /** 时间戳 */
+    timestamp: string;
+}
+/**
+ * 分页信息
+ */
+export interface PaginationMeta {
+    /** 当前页码 */
+    page: number;
+    /** 每页条数 */
+    pageSize: number;
+    /** 总记录数 */
+    total: number;
+}
+/**
+ * 分页列表响应数据
+ */
+export interface PagedListData<T> {
+    /** 数据列表 */
+    items: T[];
+    /** 分页信息 */
+    pagination: PaginationMeta;
+}
+/**
+ * 询盘详情
+ */
+export interface Inquiry {
+    id: number;
+    firstName: string;
+    lastName: string;
+    email: string;
+    phone: string;
+    message: string;
+    userAgent: string | null;
+    ip: string | null;
+    data: Record<string, any> | null;
+    referer: string | null;
+    geo: Record<string, any> | null;
+    isRead: boolean;
+    operatorId: number | null;
+    createdAt: string;
+}
+//# sourceMappingURL=inquiry.d.ts.map

package/dist/core/lib/types/inquiry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inquiry.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/types/inquiry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAA;IAC9B,WAAW;IACX,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,qBAAqB;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,uBAAuB;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS;IACT,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ;IACR,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ;IACR,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW;IACX,OAAO,EAAE,MAAM,CAAA;IACf,SAAS;IACT,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IACnC,YAAY;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,OAAO,EAAE,MAAM,CAAA;IACf,WAAW;IACX,IAAI,EAAE,CAAC,CAAA;IACP,UAAU;IACV,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,WAAW;IACX,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,WAAW;IACX,UAAU,EAAE,cAAc,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;IAC/B,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;CACjB"}

package/dist/core/lib/types/inquiry.js

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

package/dist/core/lib/types/visitor.d.ts

@@ -0,0 +1,135 @@
+/**
+ * 访客统计查询参数
+ */
+export interface VisitorStatsQueryDto {
+    /** 开始时间 (ISO 8601 格式) */
+    start?: string;
+    /** 结束时间 (ISO 8601 格式) */
+    end?: string;
+    /** 按日期分组 */
+    byDate?: boolean;
+}
+/**
+ * 页面浏览统计查询参数
+ */
+export interface PageViewStatsQueryDto {
+    /** 开始时间 (ISO 8601 格式) */
+    start?: string;
+    /** 结束时间 (ISO 8601 格式) */
+    end?: string;
+    /** 分组方式: page（按页面）, date（按日期） */
+    groupBy?: 'page' | 'date';
+    /** 页面路径过滤 */
+    page?: string;
+    /** IP 过滤 */
+    ip?: string;
+}
+/**
+ * 每日页面访问统计查询参数
+ */
+export interface DailyPageStatsQueryDto {
+    /** 开始日期 (YYYY-MM-DD) */
+    start?: string;
+    /** 结束日期 (YYYY-MM-DD) */
+    end?: string;
+    /** 页面路径过滤 */
+    page?: string;
+}
+/**
+ * IP 页面访问统计查询参数
+ */
+export interface IpPageStatsQueryDto {
+    /** IP 地址过滤 */
+    ip?: string;
+    /** 页面路径过滤 */
+    page?: string;
+}
+/**
+ * 访客记录查询参数
+ */
+export interface VisitorQueryDto {
+    /** 开始时间 (ISO 8601 格式) */
+    start?: string;
+    /** 结束时间 (ISO 8601 格式) */
+    end?: string;
+    /** IP 地址过滤 */
+    ip?: string;
+    /** 页面路径过滤 */
+    page?: string;
+    /** 每页条数 */
+    limit?: number;
+    /** 偏移量 */
+    offset?: number;
+}
+/**
+ * UV 统计响应接口
+ */
+export interface UVStatsResponse {
+    /** 总独立访客数 */
+    total: number;
+    /** 按日期分组的统计（可选）*/
+    byDate?: Array<{
+        date: string;
+        count: number;
+    }>;
+}
+/**
+ * PV 统计响应接口
+ */
+export interface PVStatsResponse {
+    /** 总页面浏览量 */
+    total: number;
+    /** 按页面分组的统计（可选）*/
+    byPage?: Array<{
+        page: string;
+        count: number;
+    }>;
+    /** 按日期分组的统计（可选）*/
+    byDate?: Array<{
+        date: string;
+        count: number;
+    }>;
+}
+/**
+ * 每日页面访问统计响应接口
+ */
+export interface DailyPageStatsResponse {
+    date: string;
+    page: string;
+    viewCount: number;
+    uniqueVisitors: number;
+}
+/**
+ * IP 页面访问统计响应接口
+ */
+export interface IpPageStatsResponse {
+    ip: string;
+    page: string;
+    viewCount: number;
+    firstVisitAt: string;
+    lastVisitAt: string;
+}
+/**
+ * 页面浏览记录接口
+ */
+export interface PageViewResponse {
+    id: number;
+    sessionId: string;
+    ip: string;
+    page: string;
+    referrer: string | null;
+    visitedAt: string;
+}
+/**
+ * 访客会话记录接口
+ */
+export interface VisitorSessionResponse {
+    id: number;
+    sessionId: string;
+    ip: string;
+    userAgent: string | null;
+    firstVisitAt: string;
+    lastVisitAt: string;
+    visitCount: number;
+}
+//# sourceMappingURL=visitor.d.ts.map

package/dist/core/lib/types/visitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/types/visitor.ts"],"names":[],"mappings":"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"}

package/dist/core/lib/types/visitor.js

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

package/dist/core/lib/utils/api.d.ts

@@ -0,0 +1,25 @@
+import type { ApiResponse } from '../types/inquiry';
+/**
+ * 构建成功响应
+ */
+export declare function successResponse<T>(data: T): ApiResponse<T>;
+/**
+ * 构建错误响应
+ */
+export declare function errorResponse(code: number, message: string): ApiResponse<null>;
+/**
+ * 解析查询参数为数字
+ */
+export declare function parseNumberParam(value: string | null | undefined, defaultValue: number): number;
+/**
+ * 解析查询参数为布尔值
+ */
+export declare function parseBooleanParam(value: string | null | undefined, defaultValue?: boolean): boolean;
+/**
+ * 验证 ID 的有效性
+ */
+export declare function validateId(id: number): {
+    valid: boolean;
+    error?: string;
+};
+//# sourceMappingURL=api.d.ts.map

package/dist/core/lib/utils/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/utils/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAO1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACb,WAAW,CAAC,IAAI,CAAC,CAOnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,YAAY,EAAE,MAAM,GAClB,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,YAAY,GAAE,OAAe,GAC3B,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAKzE"}

package/dist/core/lib/utils/api.js

@@ -0,0 +1,48 @@
+/**
+ * 构建成功响应
+ */
+export function successResponse(data) {
+    return {
+        code: 200,
+        message: 'ok',
+        data,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * 构建错误响应
+ */
+export function errorResponse(code, message) {
+    return {
+        code,
+        message,
+        data: null,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * 解析查询参数为数字
+ */
+export function parseNumberParam(value, defaultValue) {
+    if (!value)
+        return defaultValue;
+    const parsed = parseInt(value, 10);
+    return Number.isNaN(parsed) ? defaultValue : parsed;
+}
+/**
+ * 解析查询参数为布尔值
+ */
+export function parseBooleanParam(value, defaultValue = false) {
+    if (!value)
+        return defaultValue;
+    return value === 'true' || value === '1';
+}
+/**
+ * 验证 ID 的有效性
+ */
+export function validateId(id) {
+    if (!Number.isFinite(id) || id <= 0) {
+        return { valid: false, error: 'invalid id' };
+    }
+    return { valid: true };
+}

package/dist/core/lib/utils/request.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 请求处理工具函数
+ */
+import type { Context } from 'hono';
+/**
+ * 获取客户端 IP 地址
+ * 支持从 Request 或 clientAddress 获取
+ */
+export declare function getClientIp(c: Context): string;
+/**
+ * 提取请求上下文信息
+ */
+export declare function requestInfo(c: Context): {
+    userAgent: string;
+    clientIp: string;
+    referer: string;
+};
+//# sourceMappingURL=request.d.ts.map

package/dist/core/lib/utils/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/utils/request.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAS9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CACf,CAMA"}

package/dist/core/lib/utils/request.js

@@ -0,0 +1,25 @@
+/**
+ * 请求处理工具函数
+ */
+/**
+ * 获取客户端 IP 地址
+ * 支持从 Request 或 clientAddress 获取
+ */
+export function getClientIp(c) {
+    // fallback
+    return (c.req.header('x-forwarded-for')?.split(',')[0]?.trim() ||
+        c.req.header('x-real-ip') ||
+        c.req.header('cf-connecting-ip') || // Cloudflare
+        c.req.header('true-client-ip') || // Akamai, Cloudflare Enterprise
+        '127.0.0.1');
+}
+/**
+ * 提取请求上下文信息
+ */
+export function requestInfo(c) {
+    return {
+        clientIp: getClientIp(c),
+        userAgent: c.req.header('User-Agent') || '',
+        referer: c.req.header('Referer') || '',
+    };
+}

package/dist/core/middlewares/api-guard.d.ts

@@ -0,0 +1,39 @@
+import type { Context, MiddlewareHandler } from 'hono';
+/**
+ * API 守卫配置
+ */
+interface ApiGuardConfig {
+    /** API Token 环境变量名 */
+    tokenEnvKey?: string;
+    /** 排除认证的路径模式列表 */
+    excludePatterns?: (string | RegExp)[];
+    /** 自定义 Token 提取函数 */
+    extractToken?: (c: Context) => string | null;
+    /** 自定义错误响应 */
+    onUnauthorized?: (c: Context) => Response | Promise<Response>;
+    /** Token 验证缓存时间（毫秒），默认 5 分钟 */
+    throttleInterval?: number;
+}
+/**
+ * 清空所有缓存（用于测试）
+ */
+export declare function clearTokenCache(): void;
+/**
+ * 创建 API 守卫中间件
+ *
+ * @example
+ * ```ts
+ * // 基础使用
+ * app.use('/api/*', createApiGuard())
+ *
+ * // 自定义配置
+ * app.use('/api/*', createApiGuard({
+ *   tokenEnvKey: 'MY_API_TOKEN',
+ *   excludePatterns: ['/api/public/*', /^\/api\/health/],
+ *   throttleInterval: 10 * 60 * 1000, // 10 分钟
+ * }))
+ * ```
+ */
+export declare function createApiGuard(config?: ApiGuardConfig): MiddlewareHandler;
+export {};
+//# sourceMappingURL=api-guard.d.ts.map

package/dist/core/middlewares/api-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-guard.d.ts","sourceRoot":"","sources":["../../../src/core/middlewares/api-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAQ,MAAM,MAAM,CAAA;AAG5D;;GAEG;AACH,UAAU,cAAc;IACvB,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kBAAkB;IAClB,eAAe,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IACrC,qBAAqB;IACrB,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAA;IAC5C,cAAc;IACd,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC7D,+BAA+B;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACzB;AA8HD;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,cAAmB,GAAG,iBAAiB,CAwC7E"}

package/dist/core/middlewares/api-guard.js

@@ -0,0 +1,154 @@
+import { strapi } from '@strapi/client';
+import { CMS_URL } from '../../contract';
+/**
+ * 默认配置
+ */
+const DEFAULT_CONFIG = {
+    tokenEnvKey: 'CMS_TOKEN',
+    excludePatterns: [],
+    extractToken: (c) => {
+        // 从 Authorization header 提取 Bearer token
+        const authHeader = c.req.header('Authorization');
+        if (authHeader?.startsWith('Bearer ')) {
+            return authHeader.slice(7);
+        }
+        // 从 X-API-Token header 提取
+        const apiToken = c.req.header('X-API-Token');
+        if (apiToken) {
+            return apiToken;
+        }
+        // 从 query 参数提取
+        const queryToken = c.req.query('token');
+        if (queryToken) {
+            return queryToken;
+        }
+        return null;
+    },
+    onUnauthorized: (c) => {
+        return c.json({
+            error: 'Unauthorized',
+            message: 'Invalid or missing API token',
+        }, 401);
+    },
+    throttleInterval: 5 * 60 * 1000, // 5 分钟
+};
+/**
+ * Token 验证缓存
+ * key: token, value: { valid: boolean, timestamp: number }
+ */
+const tokenCache = new Map();
+/**
+ * 检查路径是否匹配排除模式
+ */
+function isPathExcluded(path, patterns) {
+    return patterns.some((pattern) => {
+        if (typeof pattern === 'string') {
+            // 支持通配符匹配
+            if (pattern.includes('*')) {
+                const regexPattern = pattern
+                    .replace(/[.+?^${}()|[\]\\]/g, '\\$&') // 转义特殊字符
+                    .replace(/\*/g, '.*'); // 替换 * 为 .*
+                return new RegExp(`^${regexPattern}$`).test(path);
+            }
+            // 精确匹配
+            return path === pattern;
+        }
+        // RegExp 匹配
+        return pattern.test(path);
+    });
+}
+/**
+ * 通过 Strapi CMS 验证 Token
+ * @param token - 要验证的 token
+ * @param throttleInterval - 节流间隔时间（毫秒）
+ * @returns 是否有效
+ */
+async function validateTokenWithCMS(token, throttleInterval) {
+    // 检查缓存
+    const cached = tokenCache.get(token);
+    const now = Date.now();
+    // 如果缓存有效且未过期，直接返回缓存结果
+    if (cached && now - cached.timestamp < throttleInterval) {
+        return cached.valid;
+    }
+    // 使用提供的 token 创建 CMS 客户端并验证
+    try {
+        const cms = strapi({ baseURL: `${CMS_URL}/api`, auth: token });
+        // 尝试请求 site 接口来验证权限
+        await cms
+            .single('site', {
+            plugin: { name: 'website' },
+        })
+            .find();
+        // 验证成功，更新缓存
+        tokenCache.set(token, { valid: true, timestamp: now });
+        return true;
+    }
+    catch (e) {
+        console.error(e);
+        // 验证失败，缓存失败结果（避免频繁请求无效 token）
+        tokenCache.set(token, { valid: false, timestamp: now });
+        return false;
+    }
+}
+/**
+ * 清理过期的缓存项
+ * @param throttleInterval - 节流间隔时间（毫秒）
+ */
+function cleanExpiredCache(throttleInterval) {
+    const now = Date.now();
+    for (const [token, item] of Array.from(tokenCache.entries())) {
+        if (now - item.timestamp >= throttleInterval) {
+            tokenCache.delete(token);
+        }
+    }
+}
+/**
+ * 清空所有缓存（用于测试）
+ */
+export function clearTokenCache() {
+    tokenCache.clear();
+}
+/**
+ * 创建 API 守卫中间件
+ *
+ * @example
+ * ```ts
+ * // 基础使用
+ * app.use('/api/*', createApiGuard())
+ *
+ * // 自定义配置
+ * app.use('/api/*', createApiGuard({
+ *   tokenEnvKey: 'MY_API_TOKEN',
+ *   excludePatterns: ['/api/public/*', /^\/api\/health/],
+ *   throttleInterval: 10 * 60 * 1000, // 10 分钟
+ * }))
+ * ```
+ */
+export function createApiGuard(config = {}) {
+    const finalConfig = { ...DEFAULT_CONFIG, ...config };
+    // 定期清理过期缓存（每 10 分钟）
+    setInterval(() => {
+        cleanExpiredCache(finalConfig.throttleInterval);
+    }, 10 * 60 * 1000);
+    return async (c, next) => {
+        const path = c.req.path;
+        // 检查是否在排除列表中
+        if (isPathExcluded(path, finalConfig.excludePatterns)) {
+            return next();
+        }
+        // 提取请求中的 token
+        const providedToken = finalConfig.extractToken(c);
+        // 如果没有提供 token
+        if (!providedToken) {
+            return finalConfig.onUnauthorized(c);
+        }
+        // 通过 CMS 验证 token
+        const isValid = await validateTokenWithCMS(providedToken, finalConfig.throttleInterval);
+        if (!isValid) {
+            return finalConfig.onUnauthorized(c);
+        }
+        // Token 验证通过，继续处理请求
+        return next();
+    };
+}