@geekron/hono 0.1.0 → 0.1.1

package/dist/core/lib/database/database.service.js

@@ -0,0 +1,108 @@
+import * as fs from 'node:fs';
+import { DATA_DIR } from './constants/database';
+import { Sqlite } from './managers/sqlite';
+import { InquiryRepository } from './repositories/inquiry.repository';
+import { VisitorRepository } from './repositories/visitor.repository';
+/**
+ * DatabaseService：聚合仓储，提供对外的业务友好 API。
+ */
+export class DatabaseService {
+    constructor() {
+        this.initialized = false;
+        this.manager = new Sqlite();
+        this.inquiryRepo = new InquiryRepository(this.manager);
+        this.visitorRepo = new VisitorRepository(this.manager);
+    }
+    /** 初始化数据目录及各表结构 */
+    async init() {
+        if (this.initialized)
+            return;
+        if (!fs.existsSync(DATA_DIR))
+            fs.mkdirSync(DATA_DIR, { recursive: true });
+        await this.inquiryRepo.initSchema();
+        await this.visitorRepo.initShardSchemas();
+        this.initialized = true;
+    }
+    /** 询盘：创建 */
+    addInquiry(data) {
+        return this.inquiryRepo.create(data);
+    }
+    /** 询盘：按 ID 查询 */
+    getInquiryById(id) {
+        return this.inquiryRepo.findById(id);
+    }
+    /** 询盘：列表 */
+    listInquiries(params = {}) {
+        return this.inquiryRepo.list(params);
+    }
+    /** 询盘：计数 */
+    countInquiries(params = {}) {
+        return this.inquiryRepo.count(params);
+    }
+    /** 询盘：统计未读数量 */
+    countUnreadInquiries() {
+        return this.inquiryRepo.countUnread();
+    }
+    /** 询盘：标记已读 */
+    markInquiryAsRead(id, operatorId) {
+        return this.inquiryRepo.markAsRead(id, operatorId);
+    }
+    /** 访客：写入 */
+    addVisitor(data) {
+        return this.visitorRepo.insert(data);
+    }
+    /** 访客：查询页面浏览记录 */
+    queryPageViews(filter = {}) {
+        return this.visitorRepo.findPageViews(filter);
+    }
+    /** 访客：查询访客会话 */
+    queryVisitorSessions(filter = {}) {
+        return this.visitorRepo.findVisitorSessions(filter);
+    }
+    /** 访客：计数（页面浏览数） */
+    countVisitors(filter = {}) {
+        return this.visitorRepo.count(filter);
+    }
+    /** 访客：统计（向后兼容） */
+    visitorStats(by, filter = {}) {
+        return this.visitorRepo.stats(by, filter);
+    }
+    /**
+     * 统计独立访客数（UV）
+     */
+    getUVStats(filter = {}, byDate = false) {
+        return this.visitorRepo.getUVStats(filter, byDate);
+    }
+    /**
+     * 统计页面总浏览量（PV）
+     */
+    getPVStats(filter = {}, groupBy) {
+        return this.visitorRepo.getPVStats(filter, groupBy);
+    }
+    /**
+     * 统计每个页面每日的访问次数
+     */
+    getDailyPageViewStats(filter = {}) {
+        return this.visitorRepo.getDailyPageViewStats(filter);
+    }
+    /**
+     * 基于 IP 的页面访问次数统计
+     */
+    getIpPageViewStats(filter = {}) {
+        return this.visitorRepo.getIpPageViewStats(filter);
+    }
+}
+/**
+ * 全局单例数据库服务
+ */
+let dbInstance = null;
+/**
+ * 获取数据库服务实例（单例）
+ */
+export async function getDatabase() {
+    if (!dbInstance) {
+        dbInstance = new DatabaseService();
+        await dbInstance.init();
+    }
+    return dbInstance;
+}

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

@@ -0,0 +1,8 @@
+/**
+ * 数据库模块导出
+ */
+export * from './constants/database';
+export * from './database.service';
+export * from './schemas/inquiry.schema';
+export * from './schemas/visitor.schema';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/database/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA"}

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

@@ -0,0 +1,7 @@
+/**
+ * 数据库模块导出
+ */
+export * from './constants/database';
+export * from './database.service';
+export * from './schemas/inquiry.schema';
+export * from './schemas/visitor.schema';

package/dist/core/lib/database/managers/sqlite.d.ts

@@ -0,0 +1,29 @@
+import { Database } from 'bun:sqlite';
+import type { BunSQLiteDatabase } from 'drizzle-orm/bun-sqlite';
+/**
+ * SQLite 连接管理器，负责按文件路径复用 bun:sqlite 实例并执行连接优化。
+ */
+export declare class Sqlite {
+    private readonly cache;
+    private readonly dbCache;
+    /**
+     * 获取指定数据库文件的 Drizzle 实例（如不存在则创建）。
+     */
+    get(dbPath: string): BunSQLiteDatabase;
+    /**
+     * 获取原始 Database 实例（用于 DDL 操作）
+     */
+    getRaw(dbPath: string): Database;
+    /**
+     * 连接后执行的优化配置（WAL、外键、超时等）。
+     */
+    private afterConnect;
+    /**
+     * 当前已打开的连接列表。
+     */
+    listOpen(): {
+        path: string;
+        db: BunSQLiteDatabase;
+    }[];
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/core/lib/database/managers/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../../../src/core/lib/database/managers/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAI/D;;GAEG;AACH,qBAAa,MAAM;IAClB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IAEtD;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAYtC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAGe,QAAQ;IAG5C;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,iBAAiB,CAAA;KAAE,EAAE;CAMrD"}

package/dist/core/lib/database/managers/sqlite.js

@@ -0,0 +1,55 @@
+import { Database } from 'bun:sqlite';
+import * as fs from 'node:fs';
+import { drizzle } from 'drizzle-orm/bun-sqlite';
+import { DATA_DIR } from '../../../../core/lib/database';
+/**
+ * SQLite 连接管理器，负责按文件路径复用 bun:sqlite 实例并执行连接优化。
+ */
+export class Sqlite {
+    constructor() {
+        this.cache = new Map();
+        this.dbCache = new Map();
+    }
+    /**
+     * 获取指定数据库文件的 Drizzle 实例（如不存在则创建）。
+     */
+    get(dbPath) {
+        const existing = this.cache.get(dbPath);
+        if (existing)
+            return existing;
+        if (!fs.existsSync(DATA_DIR))
+            fs.mkdirSync(DATA_DIR, { recursive: true });
+        const db = new Database(dbPath, { create: true });
+        this.afterConnect(db);
+        const drizzleDb = drizzle(db);
+        this.cache.set(dbPath, drizzleDb);
+        this.dbCache.set(dbPath, db);
+        return drizzleDb;
+    }
+    /**
+     * 获取原始 Database 实例（用于 DDL 操作）
+     */
+    getRaw(dbPath) {
+        // 确保 drizzle 实例已创建
+        this.get(dbPath);
+        return this.dbCache.get(dbPath);
+    }
+    /**
+     * 连接后执行的优化配置（WAL、外键、超时等）。
+     */
+    afterConnect(db) {
+        db.run('PRAGMA journal_mode = WAL');
+        db.run('PRAGMA synchronous = NORMAL');
+        db.run('PRAGMA foreign_keys = ON');
+        db.run('PRAGMA busy_timeout = 2000');
+    }
+    /**
+     * 当前已打开的连接列表。
+     */
+    listOpen() {
+        return Array.from(this.cache.entries()).map(([p, db]) => ({
+            path: p,
+            db: db,
+        }));
+    }
+}

package/dist/core/lib/database/managers/visitor-shard.d.ts

@@ -0,0 +1,29 @@
+import type { BunSQLiteDatabase } from 'drizzle-orm/bun-sqlite';
+import type { VisitorShardStrategy } from '../../../../core/lib/database';
+import type { Sqlite } from './sqlite';
+/**
+ * 访客分片管理器：按顺序或日期管理 SQLite 分片数据库文件，并提供对应的 Drizzle 实例。
+ */
+export declare class VisitorShard {
+    private readonly manager;
+    private strategy;
+    constructor(manager: Sqlite);
+    /** 切换分片策略 */
+    setStrategy(strategy: VisitorShardStrategy): void;
+    /** 当前写入分片文件路径（不足容量则复用，否则生成新分片）。 */
+    currentShardPath(): string;
+    /** 列出所有分片文件名 */
+    listShardFiles(): string[];
+    /** 列出所有分片绝对路径 */
+    allShardPaths(): string[];
+    /** 获取当前分片的 Drizzle 实例 */
+    getCurrentDb(): BunSQLiteDatabase;
+    /** 获取已存在的全部分片 Drizzle 实例（若无则创建当前分片） */
+    getAllDbs(): {
+        path: string;
+        db: BunSQLiteDatabase;
+    }[];
+    /** 到达容量上限时触发旋转（销毁旧连接，下一次写入自动落到新分片）。 */
+    rotateIfNeeded(shardPath: string): void;
+}
+//# sourceMappingURL=visitor-shard.d.ts.map

package/dist/core/lib/database/managers/visitor-shard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-shard.d.ts","sourceRoot":"","sources":["../../../../../src/core/lib/database/managers/visitor-shard.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC;;GAEG;AACH,qBAAa,YAAY;IAEZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IADpC,OAAO,CAAC,QAAQ,CAAmC;gBACtB,OAAO,EAAE,MAAM;IAE5C,aAAa;IACb,WAAW,CAAC,QAAQ,EAAE,oBAAoB;IAI1C,mCAAmC;IACnC,gBAAgB,IAAI,MAAM;IA+B1B,gBAAgB;IAChB,cAAc,IAAI,MAAM,EAAE;IAM1B,iBAAiB;IACjB,aAAa,IAAI,MAAM,EAAE;IAIzB,yBAAyB;IACzB,YAAY,IAAI,iBAAiB;IAKjC,uCAAuC;IACvC,SAAS,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,iBAAiB,CAAA;KAAE,EAAE;IAStD,uCAAuC;IACvC,cAAc,CAAC,SAAS,EAAE,MAAM;CAUhC"}

package/dist/core/lib/database/managers/visitor-shard.js

@@ -0,0 +1,83 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import dayjs from 'dayjs';
+import { DATA_DIR, MAX_DB_SIZE_BYTES } from '../../../../core/lib/database';
+/**
+ * 访客分片管理器：按顺序或日期管理 SQLite 分片数据库文件，并提供对应的 Drizzle 实例。
+ */
+export class VisitorShard {
+    constructor(manager) {
+        this.manager = manager;
+        this.strategy = 'sequence';
+    }
+    /** 切换分片策略 */
+    setStrategy(strategy) {
+        this.strategy = strategy;
+    }
+    /** 当前写入分片文件路径（不足容量则复用，否则生成新分片）。 */
+    currentShardPath() {
+        if (this.strategy === 'date') {
+            const base = `visitor_${dayjs().format('YYYYMMDD')}.db`;
+            const p = path.join(DATA_DIR, base);
+            if (fs.existsSync(p)) {
+                const s = fs.statSync(p).size;
+                if (s < MAX_DB_SIZE_BYTES)
+                    return p;
+            }
+        }
+        const files = this.listShardFiles();
+        const seqNumbers = files
+            .map((f) => {
+            const m = f.match(/^visitor_(\d{3})\.db$/);
+            return m ? parseInt(m[1], 10) : null;
+        })
+            .filter((n) => typeof n === 'number');
+        const last = seqNumbers.length ? Math.max(...seqNumbers) : 0;
+        const lastFile = last
+            ? path.join(DATA_DIR, `visitor_${String(last).padStart(3, '0')}.db`)
+            : null;
+        if (lastFile &&
+            fs.existsSync(lastFile) &&
+            fs.statSync(lastFile).size < MAX_DB_SIZE_BYTES) {
+            return lastFile;
+        }
+        const next = String(last + 1).padStart(3, '0');
+        return path.join(DATA_DIR, `visitor_${next}.db`);
+    }
+    /** 列出所有分片文件名 */
+    listShardFiles() {
+        if (!fs.existsSync(DATA_DIR))
+            return [];
+        const names = fs.readdirSync(DATA_DIR);
+        return names.filter((n) => n.startsWith('visitor_') && n.endsWith('.db'));
+    }
+    /** 列出所有分片绝对路径 */
+    allShardPaths() {
+        return this.listShardFiles().map((n) => path.join(DATA_DIR, n));
+    }
+    /** 获取当前分片的 Drizzle 实例 */
+    getCurrentDb() {
+        const p = this.currentShardPath();
+        return this.manager.get(p);
+    }
+    /** 获取已存在的全部分片 Drizzle 实例（若无则创建当前分片） */
+    getAllDbs() {
+        const paths = this.allShardPaths();
+        if (!paths.length) {
+            const db = this.getCurrentDb();
+            return [{ path: this.currentShardPath(), db }];
+        }
+        return paths.map((p) => ({ path: p, db: this.manager.get(p) }));
+    }
+    /** 到达容量上限时触发旋转（销毁旧连接，下一次写入自动落到新分片）。 */
+    rotateIfNeeded(shardPath) {
+        if (fs.existsSync(shardPath)) {
+            const size = fs.statSync(shardPath).size;
+            if (size >= MAX_DB_SIZE_BYTES) {
+                // 获取原始 Database 实例进行关闭
+                const db = this.manager.getRaw(shardPath);
+                db.close();
+            }
+        }
+    }
+}

package/dist/core/lib/database/repositories/inquiry.repository.d.ts

@@ -0,0 +1,33 @@
+import type { Inquiry, InquiryCreate, InquiryListParams } from '../../../../core/lib/database';
+import type { Sqlite } from '../managers/sqlite';
+/**
+ * 询盘仓储：封装对 SQLite 的 CRUD 操作。
+ */
+export declare class InquiryRepository {
+    private readonly manager;
+    constructor(manager: Sqlite);
+    /** 获取询盘数据库连接 */
+    private get db();
+    /** 获取原始 Database 实例 */
+    private get rawDb();
+    /** 初始化表结构（幂等） */
+    initSchema(): Promise<void>;
+    /** 创建询盘（事务） */
+    create(data: InquiryCreate): Promise<number>;
+    /** 根据 ID 查询询盘 */
+    findById(id: number): Promise<Inquiry | null>;
+    /** 列表查询 */
+    list(params?: InquiryListParams): Promise<Inquiry[]>;
+    count(params?: InquiryListParams): Promise<number>;
+    /**
+     * 统计未读询盘数量
+     */
+    countUnread(): Promise<number>;
+    /**
+     * 标记询盘为已读
+     * @param id 询盘 ID
+     * @param operatorId 操作人 ID
+     */
+    markAsRead(id: number, operatorId: number): Promise<boolean>;
+}
+//# sourceMappingURL=inquiry.repository.d.ts.map

package/dist/core/lib/database/repositories/inquiry.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inquiry.repository.d.ts","sourceRoot":"","sources":["../../../../../src/core/lib/database/repositories/inquiry.repository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,MAAM,qBAAqB,CAAA;AAM5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD;;GAEG;AACH,qBAAa,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAE5C,gBAAgB;IAChB,OAAO,KAAK,EAAE,GAEb;IAED,uBAAuB;IACvB,OAAO,KAAK,KAAK,GAEhB;IAED,iBAAiB;IACX,UAAU;IAIhB,eAAe;IACT,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BlD,iBAAiB;IACX,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IA2BnD,WAAW;IACL,IAAI,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA6DxD,KAAK,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB5D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IASpC;;;;OAIG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAalE"}

package/dist/core/lib/database/repositories/inquiry.repository.js

@@ -0,0 +1,173 @@
+import dayjs from 'dayjs';
+import { and, asc, count, desc, eq, gte, like, lt } from 'drizzle-orm';
+import { ensureInquirySchema, INQUIRY_DB_PATH, inquiries, } from '../../../../core/lib/database';
+/**
+ * 询盘仓储：封装对 SQLite 的 CRUD 操作。
+ */
+export class InquiryRepository {
+    constructor(manager) {
+        this.manager = manager;
+    }
+    /** 获取询盘数据库连接 */
+    get db() {
+        return this.manager.get(INQUIRY_DB_PATH);
+    }
+    /** 获取原始 Database 实例 */
+    get rawDb() {
+        return this.manager.getRaw(INQUIRY_DB_PATH);
+    }
+    /** 初始化表结构（幂等） */
+    async initSchema() {
+        ensureInquirySchema(this.rawDb);
+    }
+    /** 创建询盘（事务） */
+    async create(data) {
+        const createdAt = data.createdAt
+            ? dayjs(data.createdAt).toISOString()
+            : dayjs().toISOString();
+        const result = this.db
+            .insert(inquiries)
+            .values({
+            firstName: data.firstName,
+            lastName: data.lastName,
+            email: data.email,
+            phone: data.phone,
+            message: data.message,
+            userAgent: data.userAgent ?? null,
+            ip: data.ip ?? null,
+            data: data.data ? JSON.stringify(data.data) : null,
+            referer: data.referer ?? null,
+            geo: data.geo ? JSON.stringify(data.geo) : null,
+            createdAt,
+        })
+            .returning({ id: inquiries.id });
+        const rows = result.all();
+        return rows[0]?.id ?? 0;
+    }
+    /** 根据 ID 查询询盘 */
+    async findById(id) {
+        const row = this.db
+            .select()
+            .from(inquiries)
+            .where(eq(inquiries.id, id))
+            .get();
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            firstName: row.firstName,
+            lastName: row.lastName,
+            email: row.email,
+            phone: row.phone,
+            message: row.message,
+            userAgent: row.userAgent ?? null,
+            ip: row.ip ?? null,
+            data: row.data ? JSON.parse(row.data) : null,
+            referer: row.referer ?? null,
+            geo: row.geo ? JSON.parse(row.geo) : null,
+            isRead: row.isRead ?? false,
+            operatorId: row.operatorId ?? null,
+            createdAt: row.createdAt,
+        };
+    }
+    /** 列表查询 */
+    async list(params = {}) {
+        const conditions = [];
+        if (params.start) {
+            conditions.push(gte(inquiries.createdAt, dayjs(params.start).toISOString()));
+        }
+        if (params.end) {
+            conditions.push(lt(inquiries.createdAt, dayjs(params.end).toISOString()));
+        }
+        if (params.keyword) {
+            conditions.push(like(inquiries.message, `%${params.keyword}%`));
+        }
+        let query = this.db.select().from(inquiries).$dynamic();
+        if (conditions.length > 0) {
+            query = query.where(and(...conditions));
+        }
+        // 排序
+        if (params.sortBy === 'email') {
+            query =
+                params.order === 'asc'
+                    ? query.orderBy(asc(inquiries.email))
+                    : query.orderBy(desc(inquiries.email));
+        }
+        else {
+            query =
+                params.order === 'asc'
+                    ? query.orderBy(asc(inquiries.createdAt))
+                    : query.orderBy(desc(inquiries.createdAt));
+        }
+        // 分页
+        if (params.limit) {
+            query = query.limit(params.limit);
+        }
+        if (params.offset) {
+            query = query.offset(params.offset);
+        }
+        const rows = query.all();
+        return rows.map((row) => ({
+            id: row.id,
+            firstName: row.firstName,
+            lastName: row.lastName,
+            email: row.email,
+            phone: row.phone,
+            message: row.message,
+            userAgent: row.userAgent ?? null,
+            ip: row.ip ?? null,
+            data: row.data ? JSON.parse(row.data) : null,
+            referer: row.referer ?? null,
+            geo: row.geo ? JSON.parse(row.geo) : null,
+            isRead: row.isRead ?? false,
+            operatorId: row.operatorId ?? null,
+            createdAt: row.createdAt,
+        }));
+    }
+    async count(params = {}) {
+        const conditions = [];
+        if (params.start) {
+            conditions.push(gte(inquiries.createdAt, dayjs(params.start).toISOString()));
+        }
+        if (params.end) {
+            conditions.push(lt(inquiries.createdAt, dayjs(params.end).toISOString()));
+        }
+        if (params.keyword) {
+            conditions.push(like(inquiries.message, `%${params.keyword}%`));
+        }
+        let query = this.db.select({ c: count() }).from(inquiries);
+        if (conditions.length > 0) {
+            query = query.where(and(...conditions));
+        }
+        const result = query.get();
+        return result?.c ?? 0;
+    }
+    /**
+     * 统计未读询盘数量
+     */
+    async countUnread() {
+        const result = this.db
+            .select({ c: count() })
+            .from(inquiries)
+            .where(eq(inquiries.isRead, false))
+            .get();
+        return result?.c ?? 0;
+    }
+    /**
+     * 标记询盘为已读
+     * @param id 询盘 ID
+     * @param operatorId 操作人 ID
+     */
+    async markAsRead(id, operatorId) {
+        const result = this.db
+            .update(inquiries)
+            .set({
+            isRead: true,
+            operatorId,
+        })
+            .where(eq(inquiries.id, id))
+            .returning({ id: inquiries.id });
+        const rows = result.all();
+        return rows.length > 0;
+    }
+}

package/dist/core/lib/database/repositories/visitor.repository.d.ts

@@ -0,0 +1,51 @@
+import type { DailyPageViewStats, IpPageViewStats, PageView, PVStats, UVStats, VisitorCreate, VisitorQuery, VisitorSession, VisitorStatsBy } from '../../../../core/lib/database';
+import type { Sqlite } from '../managers/sqlite';
+/**
+ * 访客仓储：封装跨分片的读写与统计。
+ */
+export declare class VisitorRepository {
+    private readonly manager;
+    private readonly shardManager;
+    constructor(manager: Sqlite);
+    /** 初始化已有分片的表结构（幂等），若无分片则创建当前分片 */
+    initShardSchemas(): Promise<void>;
+    /**
+     * 写入访客记录（事务），并在必要时触发分片旋转。
+     */
+    insert(data: VisitorCreate): Promise<{
+        id: number;
+        shardPath: string;
+    }>;
+    /**
+     * 统计独立访客数（UV）
+     */
+    getUVStats(filter?: VisitorQuery, byDate?: boolean): Promise<UVStats>;
+    /**
+     * 统计页面总浏览量（PV）
+     */
+    getPVStats(filter?: VisitorQuery, groupBy?: 'page' | 'date'): Promise<PVStats>;
+    /**
+     * 统计每个页面每日的访问次数（从预聚合表查询）
+     */
+    getDailyPageViewStats(filter?: VisitorQuery): Promise<DailyPageViewStats[]>;
+    /**
+     * 统计基于 IP 的页面访问次数（从预聚合表查询）
+     */
+    getIpPageViewStats(filter?: VisitorQuery): Promise<IpPageViewStats[]>;
+    /**
+     * 跨分片查询页面浏览记录
+     */
+    findPageViews(filter?: VisitorQuery): Promise<PageView[]>;
+    /**
+     * 跨分片查询访客会话
+     */
+    findVisitorSessions(filter?: VisitorQuery): Promise<VisitorSession[]>;
+    /** 跨分片计数 */
+    count(filter?: VisitorQuery): Promise<number>;
+    /** 跨分片统计（向后兼容） */
+    stats(by: VisitorStatsBy, filter?: VisitorQuery): Promise<{
+        key: string;
+        count: number;
+    }[]>;
+}
+//# sourceMappingURL=visitor.repository.d.ts.map

package/dist/core/lib/database/repositories/visitor.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor.repository.d.ts","sourceRoot":"","sources":["../../../../../src/core/lib/database/repositories/visitor.repository.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,kBAAkB,EAClB,eAAe,EACf,QAAQ,EACR,OAAO,EACP,OAAO,EACP,aAAa,EACb,YAAY,EACZ,cAAc,EACd,cAAc,EACd,MAAM,qBAAqB,CAAA;AAS5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAGhD;;GAEG;AACH,qBAAa,iBAAiB;IAGjB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;gBAEd,OAAO,EAAE,MAAM;IAI5C,kCAAkC;IAC5B,gBAAgB;IAQtB;;OAEG;IACG,MAAM,CACX,IAAI,EAAE,aAAa,GACjB,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAkK7C;;OAEG;IACG,UAAU,CACf,MAAM,GAAE,YAAiB,EACzB,MAAM,UAAQ,GACZ,OAAO,CAAC,OAAO,CAAC;IA0FnB;;OAEG;IACG,UAAU,CACf,MAAM,GAAE,YAAiB,EACzB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC;IAqInB;;OAEG;IACG,qBAAqB,CAC1B,MAAM,GAAE,YAAiB,GACvB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAkDhC;;OAEG;IACG,kBAAkB,CACvB,MAAM,GAAE,YAAiB,GACvB,OAAO,CAAC,eAAe,EAAE,CAAC;IA6C7B;;OAEG;IACG,aAAa,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA+CnE;;OAEG;IACG,mBAAmB,CACxB,MAAM,GAAE,YAAiB,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC;IA6C5B,YAAY;IACN,KAAK,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiCvD,kBAAkB;IACZ,KAAK,CACV,EAAE,EAAE,cAAc,EAClB,MAAM,GAAE,YAAiB,GACvB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAwB5C"}