@geekron/hono 0.1.0 → 0.1.1

package/dist/core/lib/database/schemas/visitor.schema.js

@@ -0,0 +1,162 @@
+import { createHash } from 'node:crypto';
+import { index, integer, sqliteTable, text, unique, } from 'drizzle-orm/sqlite-core';
+/**
+ * 表名定义
+ */
+export const VISITOR_SESSIONS_TABLE = 'visitor_sessions'; // 访客会话表（UV）
+export const PAGE_VIEWS_TABLE = 'page_views'; // 页面浏览表（PV）
+export const DAILY_PAGE_STATS_TABLE = 'daily_page_stats'; // 每日页面统计表
+export const IP_PAGE_STATS_TABLE = 'ip_page_stats'; // IP 页面统计表
+/**
+ * Drizzle ORM 访客会话表定义
+ */
+export const visitorSessions = sqliteTable(VISITOR_SESSIONS_TABLE, {
+    id: integer('id').primaryKey({ autoIncrement: true }),
+    sessionId: text('session_id', { length: 32 }).notNull().unique(),
+    ip: text('ip', { length: 64 }).notNull(),
+    userAgent: text('user_agent', { length: 512 }),
+    firstVisitAt: text('first_visit_at').notNull(),
+    lastVisitAt: text('last_visit_at').notNull(),
+    visitCount: integer('visit_count').notNull().default(1),
+}, (table) => ({
+    sessionIdIdx: index('visitor_sessions_session_id_idx').on(table.sessionId),
+    ipIdx: index('visitor_sessions_ip_idx').on(table.ip),
+    firstVisitAtIdx: index('visitor_sessions_first_visit_at_idx').on(table.firstVisitAt),
+}));
+/**
+ * Drizzle ORM 页面浏览表定义
+ */
+export const pageViews = sqliteTable(PAGE_VIEWS_TABLE, {
+    id: integer('id').primaryKey({ autoIncrement: true }),
+    sessionId: text('session_id', { length: 32 }).notNull(),
+    ip: text('ip', { length: 64 }).notNull(),
+    page: text('page', { length: 512 }).notNull(),
+    referrer: text('referrer', { length: 512 }),
+    visitedAt: text('visited_at').notNull(),
+}, (table) => ({
+    sessionIdIdx: index('page_views_session_id_idx').on(table.sessionId),
+    ipIdx: index('page_views_ip_idx').on(table.ip),
+    pageIdx: index('page_views_page_idx').on(table.page),
+    visitedAtIdx: index('page_views_visited_at_idx').on(table.visitedAt),
+    ipPageIdx: index('page_views_ip_page_idx').on(table.ip, table.page),
+}));
+/**
+ * Drizzle ORM 每日页面统计表定义
+ */
+export const dailyPageStats = sqliteTable(DAILY_PAGE_STATS_TABLE, {
+    id: integer('id').primaryKey({ autoIncrement: true }),
+    date: text('date', { length: 10 }).notNull(), // YYYY-MM-DD
+    page: text('page', { length: 512 }).notNull(),
+    viewCount: integer('view_count').notNull().default(0),
+    uniqueVisitors: integer('unique_visitors').notNull().default(0),
+}, (table) => ({
+    datePageUnique: unique('daily_page_stats_date_page_unique').on(table.date, table.page),
+    dateIdx: index('daily_page_stats_date_idx').on(table.date),
+    pageIdx: index('daily_page_stats_page_idx').on(table.page),
+}));
+/**
+ * Drizzle ORM IP 页面统计表定义
+ */
+export const ipPageStats = sqliteTable(IP_PAGE_STATS_TABLE, {
+    id: integer('id').primaryKey({ autoIncrement: true }),
+    ip: text('ip', { length: 64 }).notNull(),
+    page: text('page', { length: 512 }).notNull(),
+    viewCount: integer('view_count').notNull().default(0),
+    firstVisitAt: text('first_visit_at').notNull(),
+    lastVisitAt: text('last_visit_at').notNull(),
+}, (table) => ({
+    ipPageUnique: unique('ip_page_stats_ip_page_unique').on(table.ip, table.page),
+    ipIdx: index('ip_page_stats_ip_idx').on(table.ip),
+    pageIdx: index('ip_page_stats_page_idx').on(table.page),
+}));
+/**
+ * 生成会话标识（基于 IP 和 User Agent）
+ */
+export function generateSessionId(ip, userAgent) {
+    const hash = createHash('sha256');
+    hash.update(`${ip}::${userAgent}`);
+    return hash.digest('hex').substring(0, 32);
+}
+/**
+ * 初始化访客会话表（幂等）
+ */
+export function ensureVisitorSessionSchema(db) {
+    db.run(`
+		CREATE TABLE IF NOT EXISTS ${VISITOR_SESSIONS_TABLE} (
+			id INTEGER PRIMARY KEY AUTOINCREMENT,
+			session_id TEXT NOT NULL UNIQUE,
+			ip TEXT NOT NULL,
+			user_agent TEXT,
+			first_visit_at TEXT NOT NULL,
+			last_visit_at TEXT NOT NULL,
+			visit_count INTEGER NOT NULL DEFAULT 1
+		)
+	`);
+    db.run(`CREATE INDEX IF NOT EXISTS visitor_sessions_session_id_idx ON ${VISITOR_SESSIONS_TABLE}(session_id)`);
+    db.run(`CREATE INDEX IF NOT EXISTS visitor_sessions_ip_idx ON ${VISITOR_SESSIONS_TABLE}(ip)`);
+    db.run(`CREATE INDEX IF NOT EXISTS visitor_sessions_first_visit_at_idx ON ${VISITOR_SESSIONS_TABLE}(first_visit_at)`);
+}
+/**
+ * 初始化页面浏览表（幂等）
+ */
+export function ensurePageViewSchema(db) {
+    db.run(`
+		CREATE TABLE IF NOT EXISTS ${PAGE_VIEWS_TABLE} (
+			id INTEGER PRIMARY KEY AUTOINCREMENT,
+			session_id TEXT NOT NULL,
+			ip TEXT NOT NULL,
+			page TEXT NOT NULL,
+			referrer TEXT,
+			visited_at TEXT NOT NULL
+		)
+	`);
+    db.run(`CREATE INDEX IF NOT EXISTS page_views_session_id_idx ON ${PAGE_VIEWS_TABLE}(session_id)`);
+    db.run(`CREATE INDEX IF NOT EXISTS page_views_ip_idx ON ${PAGE_VIEWS_TABLE}(ip)`);
+    db.run(`CREATE INDEX IF NOT EXISTS page_views_page_idx ON ${PAGE_VIEWS_TABLE}(page)`);
+    db.run(`CREATE INDEX IF NOT EXISTS page_views_visited_at_idx ON ${PAGE_VIEWS_TABLE}(visited_at)`);
+    db.run(`CREATE INDEX IF NOT EXISTS page_views_ip_page_idx ON ${PAGE_VIEWS_TABLE}(ip, page)`);
+}
+/**
+ * 初始化每日页面统计表（幂等）
+ */
+export function ensureDailyPageStatsSchema(db) {
+    db.run(`
+		CREATE TABLE IF NOT EXISTS ${DAILY_PAGE_STATS_TABLE} (
+			id INTEGER PRIMARY KEY AUTOINCREMENT,
+			date TEXT NOT NULL,
+			page TEXT NOT NULL,
+			view_count INTEGER NOT NULL DEFAULT 0,
+			unique_visitors INTEGER NOT NULL DEFAULT 0,
+			UNIQUE(date, page)
+		)
+	`);
+    db.run(`CREATE INDEX IF NOT EXISTS daily_page_stats_date_idx ON ${DAILY_PAGE_STATS_TABLE}(date)`);
+    db.run(`CREATE INDEX IF NOT EXISTS daily_page_stats_page_idx ON ${DAILY_PAGE_STATS_TABLE}(page)`);
+}
+/**
+ * 初始化 IP 页面统计表（幂等）
+ */
+export function ensureIpPageStatsSchema(db) {
+    db.run(`
+		CREATE TABLE IF NOT EXISTS ${IP_PAGE_STATS_TABLE} (
+			id INTEGER PRIMARY KEY AUTOINCREMENT,
+			ip TEXT NOT NULL,
+			page TEXT NOT NULL,
+			view_count INTEGER NOT NULL DEFAULT 0,
+			first_visit_at TEXT NOT NULL,
+			last_visit_at TEXT NOT NULL,
+			UNIQUE(ip, page)
+		)
+	`);
+    db.run(`CREATE INDEX IF NOT EXISTS ip_page_stats_ip_idx ON ${IP_PAGE_STATS_TABLE}(ip)`);
+    db.run(`CREATE INDEX IF NOT EXISTS ip_page_stats_page_idx ON ${IP_PAGE_STATS_TABLE}(page)`);
+}
+/**
+ * 初始化所有访客相关表（幂等）
+ */
+export function ensureVisitorSchema(db) {
+    ensureVisitorSessionSchema(db);
+    ensurePageViewSchema(db);
+    ensureDailyPageStatsSchema(db);
+    ensureIpPageStatsSchema(db);
+}

package/dist/core/lib/services/captcha.service.d.ts

@@ -0,0 +1,13 @@
+/**
+ * hCaptcha 验证服务
+ * 提供人机验证相关功能
+ */
+/**
+ * 验证 hCaptcha token
+ * @param token - hCaptcha 返回的 token
+ * @param sitekey - 站点密钥
+ * @param clientIp - 客户端 IP 地址(可选)
+ * @returns 验证是否成功
+ */
+export declare function verifyHCaptcha(token: string, sitekey: string, clientIp?: string): Promise<boolean>;
+//# sourceMappingURL=captcha.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"captcha.service.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/services/captcha.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;GAMG;AACH,wBAAsB,cAAc,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CA+BlB"}

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

@@ -0,0 +1,40 @@
+/**
+ * hCaptcha 验证服务
+ * 提供人机验证相关功能
+ */
+const HCAPTCHA_VERIFY_URL = 'https://hcaptcha.com/siteverify';
+/**
+ * 验证 hCaptcha token
+ * @param token - hCaptcha 返回的 token
+ * @param sitekey - 站点密钥
+ * @param clientIp - 客户端 IP 地址(可选)
+ * @returns 验证是否成功
+ */
+export async function verifyHCaptcha(token, sitekey, clientIp) {
+    const HCAPTCHA_SECRET = import.meta.env.HCAPTCHA_SECRET_KEY || '';
+    // 开发环境跳过验证（如果没有配置 secret key）
+    if (!HCAPTCHA_SECRET || HCAPTCHA_SECRET === '') {
+        console.warn('[hCaptcha] No secret key configured, skipping verification in development');
+        return true;
+    }
+    const formData = new URLSearchParams();
+    formData.append('secret', HCAPTCHA_SECRET);
+    formData.append('sitekey', sitekey);
+    formData.append('response', token);
+    if (clientIp)
+        formData.append('remoteip', clientIp);
+    try {
+        const response = await fetch(HCAPTCHA_VERIFY_URL, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: formData.toString(),
+        });
+        const data = await response.json();
+        console.log('[hCaptcha] Verification response:', data);
+        return data.success === true;
+    }
+    catch (error) {
+        console.error('[hCaptcha] Verification failed:', error);
+        return false;
+    }
+}

package/dist/core/lib/services/geoip.service.d.ts

@@ -0,0 +1,79 @@
+/**
+ * IP 地理位置信息解析服务
+ * 使用 MaxMind GeoLite2 City 数据库解析 IP 地址的地理位置信息
+ */
+/**
+ * GeoIP 信息接口
+ */
+export interface GeoInfo {
+    /** 国家代码 (ISO 3166-1 alpha-2) */
+    countryCode?: string;
+    /** 国家名称 */
+    country?: string;
+    /** 城市名称 */
+    city?: string;
+    /** 纬度 */
+    latitude?: number;
+    /** 经度 */
+    longitude?: number;
+    /** 时区 */
+    timezone?: string;
+    /** 邮政编码 */
+    postalCode?: string;
+    /** 大陆/洲 */
+    continent?: string;
+    /** 省份/州 */
+    subdivision?: string;
+}
+/**
+ * GeoIP 服务类
+ */
+declare class GeoIPService {
+    private reader;
+    private dbPath;
+    private initialized;
+    private initPromise;
+    constructor();
+    /**
+     * 初始化 GeoIP Reader
+     */
+    private initialize;
+    /**
+     * 确保服务已初始化
+     */
+    private ensureInitialized;
+    /**
+     * 查询 IP 地址的地理位置信息
+     * @param ip - IP 地址
+     * @returns GeoInfo 对象，如果查询失败则返回空对象
+     */
+    lookup(ip: string): Promise<GeoInfo>;
+    /**
+     * 批量查询 IP 地址
+     * @param ips - IP 地址数组
+     * @returns GeoInfo 对象数组
+     */
+    batchLookup(ips: string[]): Promise<GeoInfo[]>;
+    /**
+     * 关闭 GeoIP Reader
+     */
+    close(): Promise<void>;
+}
+/**
+ * 获取 GeoIP 服务实例（单例模式）
+ */
+export declare function getGeoIPService(): GeoIPService;
+/**
+ * 便捷函数：查询 IP 地址的地理位置信息
+ * @param ip - IP 地址
+ * @returns GeoInfo 对象
+ */
+export declare function lookupIP(ip: string): Promise<GeoInfo>;
+/**
+ * 便捷函数：批量查询 IP 地址
+ * @param ips - IP 地址数组
+ * @returns GeoInfo 对象数组
+ */
+export declare function batchLookupIPs(ips: string[]): Promise<GeoInfo[]>;
+export {};
+//# sourceMappingURL=geoip.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geoip.service.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/services/geoip.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,OAAO;IACvB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS;IACT,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS;IACT,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS;IACT,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW;IACX,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,cAAM,YAAY;IACjB,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,WAAW,CAA6B;;IAUhD;;OAEG;YACW,UAAU;IAyBxB;;OAEG;YACW,iBAAiB;IAM/B;;;;OAIG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2C1C;;;;OAIG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIpD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAS5B;AAOD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG3D;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAGtE"}

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

@@ -0,0 +1,144 @@
+/**
+ * IP 地理位置信息解析服务
+ * 使用 MaxMind GeoLite2 City 数据库解析 IP 地址的地理位置信息
+ */
+import path from 'node:path';
+import * as maxmind from 'maxmind';
+/**
+ * GeoIP 服务类
+ */
+class GeoIPService {
+    constructor() {
+        this.reader = null;
+        this.initialized = false;
+        this.initPromise = null;
+        // 数据库文件路径
+        this.dbPath = path.resolve(process.cwd(), 'src/core/lib/geo/geolite2-city-ipv4.mmdb');
+    }
+    /**
+     * 初始化 GeoIP Reader
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        // 如果正在初始化，等待初始化完成
+        if (this.initPromise) {
+            return this.initPromise;
+        }
+        this.initPromise = (async () => {
+            try {
+                console.log(`[GeoIP Service] Loading database from: ${this.dbPath}`);
+                this.reader = await maxmind.open(this.dbPath);
+                this.initialized = true;
+                console.log('[GeoIP Service] Database loaded successfully');
+            }
+            catch (error) {
+                console.error('[GeoIP Service] Failed to load database:', error);
+                throw new Error(`Failed to initialize GeoIP service: ${error}`);
+            }
+        })();
+        return this.initPromise;
+    }
+    /**
+     * 确保服务已初始化
+     */
+    async ensureInitialized() {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+    }
+    /**
+     * 查询 IP 地址的地理位置信息
+     * @param ip - IP 地址
+     * @returns GeoInfo 对象，如果查询失败则返回空对象
+     */
+    async lookup(ip) {
+        try {
+            // 如果 IP 为空或无效，返回空对象
+            if (!ip || ip === 'unknown' || ip === '::1' || ip === '127.0.0.1') {
+                return {};
+            }
+            // 确保服务已初始化
+            await this.ensureInitialized();
+            if (!this.reader) {
+                console.warn('[GeoIP Service] Reader not initialized');
+                return {};
+            }
+            // 查询 IP 地址
+            const response = this.reader.get(ip);
+            // 如果没有查询结果，返回空对象
+            if (!response) {
+                return {};
+            }
+            // 提取地理信息（适配自定义的 city ipv4 数据库格式）
+            const geoInfo = {
+                countryCode: response.country_code,
+                country: response.country_code, // 这个数据库只有国家代码，没有完整名称
+                city: response.city || undefined,
+                latitude: response.latitude,
+                longitude: response.longitude,
+                timezone: response.timezone,
+                postalCode: response.postcode || undefined,
+                subdivision: response.state1 || response.state2 || undefined,
+            };
+            return geoInfo;
+        }
+        catch (error) {
+            // 查询失败时记录错误但不抛出异常
+            console.error(`[GeoIP Service] Failed to lookup IP ${ip}:`, error);
+            return {};
+        }
+    }
+    /**
+     * 批量查询 IP 地址
+     * @param ips - IP 地址数组
+     * @returns GeoInfo 对象数组
+     */
+    async batchLookup(ips) {
+        return Promise.all(ips.map((ip) => this.lookup(ip)));
+    }
+    /**
+     * 关闭 GeoIP Reader
+     */
+    async close() {
+        if (this.reader) {
+            // @maxmind/geoip2-node 不需要显式关闭
+            this.reader = null;
+            this.initialized = false;
+            this.initPromise = null;
+            console.log('[GeoIP Service] Reader closed');
+        }
+    }
+}
+/**
+ * 全局 GeoIP 服务实例
+ */
+let geoIPServiceInstance = null;
+/**
+ * 获取 GeoIP 服务实例（单例模式）
+ */
+export function getGeoIPService() {
+    if (!geoIPServiceInstance) {
+        geoIPServiceInstance = new GeoIPService();
+    }
+    return geoIPServiceInstance;
+}
+/**
+ * 便捷函数：查询 IP 地址的地理位置信息
+ * @param ip - IP 地址
+ * @returns GeoInfo 对象
+ */
+export async function lookupIP(ip) {
+    const service = getGeoIPService();
+    return service.lookup(ip);
+}
+/**
+ * 便捷函数：批量查询 IP 地址
+ * @param ips - IP 地址数组
+ * @returns GeoInfo 对象数组
+ */
+export async function batchLookupIPs(ips) {
+    const service = getGeoIPService();
+    return service.batchLookup(ips);
+}

package/dist/core/lib/services/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 服务模块导出
+ * 统一导出所有服务模块,方便导入使用
+ */
+export * from './captcha.service';
+export * from './geoip.service';
+export * from './inquiry.service';
+export * from './mailer.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/lib/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA"}

package/dist/core/lib/services/index.js

@@ -0,0 +1,8 @@
+/**
+ * 服务模块导出
+ * 统一导出所有服务模块,方便导入使用
+ */
+export * from './captcha.service';
+export * from './geoip.service';
+export * from './inquiry.service';
+export * from './mailer.service';

package/dist/core/lib/services/inquiry.service.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 询盘服务
+ * 提供询盘提交的核心业务逻辑
+ */
+import type { InquiryCreate } from '../../../core/lib/database/schemas/inquiry.schema';
+/**
+ * 询盘表单数据接口
+ */
+export interface InquiryFormData {
+    email: string;
+    first_name: string;
+    last_name: string;
+    message: string;
+    phone?: string;
+    hcaptcha_token: string;
+    hcaptcha_sitekey: string;
+    referer?: string;
+    [key: string]: any;
+}
+/**
+ * 询盘验证结果
+ */
+export interface InquiryValidationResult {
+    valid: boolean;
+    error?: string;
+    errorCode?: string;
+}
+/**
+ * 询盘提交上下文
+ */
+export interface InquirySubmitContext {
+    userAgent?: string;
+    clientIp?: string;
+    referer?: string;
+}
+/**
+ * 验证询盘表单必填字段
+ */
+export declare function validateInquiryFields(data: Partial<InquiryFormData>): InquiryValidationResult;
+/**
+ * 验证 hCaptcha 参数
+ */
+export declare function validateCaptchaParams(data: Partial<InquiryFormData>): InquiryValidationResult;
+/**
+ * 转换表单数据为数据库实体
+ */
+export declare function transformInquiryData(formData: InquiryFormData, context: InquirySubmitContext): Promise<InquiryCreate>;
+/**
+ * 提交询盘（完整流程）
+ * @param formData - 表单数据
+ * @param context - 提交上下文
+ * @returns 询盘 ID
+ * @throws 验证失败或数据库错误时抛出异常
+ */
+export declare function submitInquiry(formData: InquiryFormData, context: InquirySubmitContext): Promise<number>;
+//# sourceMappingURL=inquiry.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inquiry.service.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/services/inquiry.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAA;AAK/E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,GAC5B,uBAAuB,CAYzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,GAC5B,uBAAuB,CAYzB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACzC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA+CxB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAClC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA4DjB"}

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

@@ -0,0 +1,129 @@
+/**
+ * 询盘服务
+ * 提供询盘提交的核心业务逻辑
+ */
+import dayjs from 'dayjs';
+import { getDatabase } from '../../../core/lib/database/database.service';
+import { verifyHCaptcha } from './captcha.service';
+import { lookupIP } from './geoip.service';
+import { sendInquiryEmailAsync } from './mailer.service';
+/**
+ * 验证询盘表单必填字段
+ */
+export function validateInquiryFields(data) {
+    const { email, first_name, last_name, message } = data;
+    if (!email || !first_name || !last_name || !message) {
+        return {
+            valid: false,
+            error: 'Missing required fields',
+            errorCode: 'MISSING_REQUIRED_FIELDS',
+        };
+    }
+    return { valid: true };
+}
+/**
+ * 验证 hCaptcha 参数
+ */
+export function validateCaptchaParams(data) {
+    const { hcaptcha_token, hcaptcha_sitekey } = data;
+    if (!hcaptcha_token || !hcaptcha_sitekey) {
+        return {
+            valid: false,
+            error: 'Captcha params is missing',
+            errorCode: 'MISSING_CAPTCHA_PARAMS',
+        };
+    }
+    return { valid: true };
+}
+/**
+ * 转换表单数据为数据库实体
+ */
+export async function transformInquiryData(formData, context) {
+    const { first_name, last_name, email, phone = '', message, referer: formReferer, } = formData;
+    // 提取额外数据
+    const data = {};
+    // 过滤掉系统字段
+    const systemFields = [
+        'hcaptcha_token',
+        'hcaptcha_sitekey',
+        'first_name',
+        'last_name',
+        'email',
+        'phone',
+        'message',
+        'referer',
+    ];
+    for (const [key, value] of Object.entries(formData)) {
+        if (!systemFields.includes(key)) {
+            data[key] = value;
+        }
+    }
+    // 解析 IP 地理位置信息
+    const clientIp = String(context.clientIp || '');
+    const geoInfo = clientIp ? await lookupIP(clientIp) : {};
+    return {
+        firstName: String(first_name || ''),
+        lastName: String(last_name || ''),
+        email: String(email || ''),
+        phone: String(phone || ''),
+        message: String(message || ''),
+        userAgent: String(context.userAgent || ''),
+        ip: clientIp,
+        data,
+        referer: String(context.referer || formReferer || ''),
+        geo: geoInfo,
+    };
+}
+/**
+ * 提交询盘（完整流程）
+ * @param formData - 表单数据
+ * @param context - 提交上下文
+ * @returns 询盘 ID
+ * @throws 验证失败或数据库错误时抛出异常
+ */
+export async function submitInquiry(formData, context) {
+    // 1. 验证必填字段
+    const fieldsValidation = validateInquiryFields(formData);
+    if (!fieldsValidation.valid) {
+        throw new Error(fieldsValidation.error);
+    }
+    // 2. 验证 hCaptcha 参数
+    const captchaParamsValidation = validateCaptchaParams(formData);
+    if (!captchaParamsValidation.valid) {
+        throw new Error(captchaParamsValidation.error);
+    }
+    // 3. 验证 hCaptcha
+    const isValidCaptcha = await verifyHCaptcha(formData.hcaptcha_token, formData.hcaptcha_sitekey, context.clientIp);
+    if (!isValidCaptcha) {
+        throw new Error('Captcha verification failed');
+    }
+    // 4. 转换数据并保存到数据库
+    const inquiryData = await transformInquiryData(formData, context);
+    const db = await getDatabase();
+    const id = await db.addInquiry(inquiryData);
+    // 5. 异步发送邮件通知(非阻塞)
+    try {
+        const emailData = {
+            id,
+            firstName: inquiryData.firstName,
+            lastName: inquiryData.lastName,
+            email: inquiryData.email,
+            phone: inquiryData.phone,
+            message: inquiryData.message,
+            referer: inquiryData.referer,
+            ip: inquiryData.ip,
+            userAgent: inquiryData.userAgent,
+            geo: JSON.stringify(inquiryData.geo || {}),
+            data: inquiryData.data || {},
+            createdAt: dayjs(inquiryData.createdAt).format('YYYY-MM-DD HH:mm:ss'),
+        };
+        // 异步发送，不阻塞主流程
+        sendInquiryEmailAsync(emailData);
+        console.log('[Inquiry Service] Email notification queued for inquiry ID:', id);
+    }
+    catch (emailError) {
+        // 邮件发送失败不影响询盘提交
+        console.error('[Inquiry Service] Failed to queue email notification:', emailError);
+    }
+    return id;
+}

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

@@ -0,0 +1,23 @@
+/**
+ * 邮件发送服务
+ * 使用 nodemailer 发送邮件
+ */
+import type { InquiryEmailValues } from '../../../core/components';
+/**
+ * 发送询盘邮件
+ * @param inquiryValues - 询盘数据
+ * @returns Promise<boolean> - 发送成功返回 true，失败返回 false
+ */
+export declare function sendInquiryEmail(inquiryValues: InquiryEmailValues): Promise<boolean>;
+/**
+ * 异步发送询盘邮件(非阻塞)
+ * 使用 Promise 但不等待结果,避免阻塞主流程
+ * @param inquiryValue - 询盘数据
+ */
+export declare function sendInquiryEmailAsync(inquiryValue: InquiryEmailValues): void;
+/**
+ * 验证邮件服务连接
+ * @returns Promise<boolean> - 连接成功返回 true
+ */
+export declare function verifyMailerConnection(): Promise<boolean>;
+//# sourceMappingURL=mailer.service.d.ts.map