@geekron/hono 0.0.10 → 0.1.1

package/dist/core/components/Seo.js

@@ -0,0 +1,365 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
+import { fullUrl } from '../../core/utils';
+export const Seo = (props) => {
+    const baseUrl = props.site.url;
+    // 处理关键词
+    const processedKeywords = props.keywords
+        ? Array.isArray(props.keywords)
+            ? props.keywords.filter(Boolean).join(', ')
+            : props.keywords
+        : '';
+    // 动态决定OG类型和Twitter Card类型
+    const ogType = props.type === 'article'
+        ? 'article'
+        : props.type === 'product'
+            ? 'product'
+            : props.type === 'organization' || props.type === 'local-business'
+                ? 'website'
+                : 'website';
+    const twitterCardType = props.image?.src && props.image.width > 300
+        ? 'summary_large_image'
+        : 'summary';
+    // 构建核心结构化数据
+    const createMainEntity = () => {
+        switch (props.type) {
+            case 'article':
+                return {
+                    '@context': 'https://schema.org',
+                    '@type': 'Article',
+                    headline: props.article?.headline || props.title,
+                    description: props.description,
+                    image: props.image.src,
+                    datePublished: props.published?.toISOString(),
+                    dateModified: props.modified?.toISOString(),
+                    author: props.author
+                        ? {
+                            '@type': 'Person',
+                            name: props.author.name,
+                            url: fullUrl(baseUrl, props.author.url),
+                            email: props.author.email,
+                        }
+                        : undefined,
+                    publisher: {
+                        '@type': 'Organization',
+                        name: props.site.name,
+                        logo: {
+                            '@type': 'ImageObject',
+                            url: props.site.logo,
+                        },
+                    },
+                    mainEntityOfPage: {
+                        '@type': 'WebPage',
+                        '@id': props.url,
+                    },
+                    articleSection: props.article?.section,
+                    articleBody: props.description, // 在实际应用中应使用完整文章内容
+                    wordCount: props.article?.wordCount,
+                    about: props.article?.tag,
+                };
+            case 'product':
+                return {
+                    '@context': 'https://schema.org',
+                    '@type': 'Product',
+                    name: props.title,
+                    description: props.description,
+                    image: props.image.src,
+                    offers: {
+                        '@type': 'Offer',
+                        price: props.product?.price,
+                        priceCurrency: props.product?.priceCurrency,
+                        availability: `https://schema.org/${props.product?.availability || 'InStock'}`,
+                        url: props.url,
+                    },
+                    brand: props.product?.brand
+                        ? {
+                            '@type': 'Brand',
+                            name: props.product.brand,
+                        }
+                        : undefined,
+                    category: props.product?.category,
+                    review: props.product?.reviews?.map((review) => ({
+                        '@type': 'Review',
+                        author: {
+                            '@type': 'Person',
+                            name: review.author,
+                        },
+                        reviewRating: {
+                            '@type': 'Rating',
+                            ratingValue: review.ratingValue,
+                        },
+                        reviewBody: review.reviewBody,
+                        datePublished: review.datePublished?.toISOString(),
+                    })) || undefined,
+                    mainEntityOfPage: {
+                        '@type': 'WebPage',
+                        '@id': props.url,
+                    },
+                };
+            case 'local-business':
+                return {
+                    '@context': 'https://schema.org',
+                    '@type': 'LocalBusiness',
+                    name: props.localBusiness?.name || props.title,
+                    description: props.description,
+                    image: props.image.src,
+                    url: props.url,
+                    telephone: props.localBusiness?.telephone,
+                    address: {
+                        '@type': 'PostalAddress',
+                        streetAddress: props.localBusiness?.address.streetAddress,
+                        addressLocality: props.localBusiness?.address.addressLocality,
+                        addressRegion: props.localBusiness?.address.addressRegion,
+                        postalCode: props.localBusiness?.address.postalCode,
+                        addressCountry: props.localBusiness?.address.addressCountry,
+                    },
+                    geo: props.localBusiness?.geo
+                        ? {
+                            '@type': 'GeoCoordinates',
+                            latitude: props.localBusiness.geo.latitude,
+                            longitude: props.localBusiness.geo.longitude,
+                        }
+                        : undefined,
+                    openingHoursSpecification: props.localBusiness?.openingHours?.map((hours) => ({
+                        '@type': 'OpeningHoursSpecification',
+                        dayOfWeek: hours.dayOfWeek,
+                        opens: hours.hours.split('-')[0],
+                        closes: hours.hours.split('-')[1],
+                    })) || undefined,
+                    mainEntityOfPage: {
+                        '@type': 'WebPage',
+                        '@id': props.url,
+                    },
+                };
+            case 'organization':
+                return {
+                    '@context': 'https://schema.org',
+                    '@type': 'Organization',
+                    name: props.title,
+                    description: props.description,
+                    image: props.image.src,
+                    url: props.url,
+                    logo: props.site.logo,
+                    foundingDate: props.organization?.foundingDate?.toISOString(),
+                    memberOf: props.organization?.memberOf
+                        ? {
+                            '@type': 'Organization',
+                            name: props.organization.memberOf,
+                        }
+                        : undefined,
+                    numberOfEmployees: props.organization?.numberOfEmployees
+                        ? {
+                            '@type': 'QuantitativeValue',
+                            value: props.organization.numberOfEmployees,
+                        }
+                        : undefined,
+                    mainEntityOfPage: {
+                        '@type': 'WebPage',
+                        '@id': props.url,
+                    },
+                };
+            default: // website
+                return {
+                    '@context': 'https://schema.org',
+                    '@type': 'WebPage',
+                    name: props.title,
+                    description: props.description,
+                    url: props.url,
+                    image: props.image.src,
+                    dateModified: props.modified?.toISOString(),
+                    publisher: {
+                        '@type': 'Organization',
+                        name: props.site.name,
+                        logo: {
+                            '@type': 'ImageObject',
+                            url: props.site.logo,
+                        },
+                    },
+                    mainEntityOfPage: {
+                        '@type': 'WebPage',
+                        '@id': props.url,
+                    },
+                };
+        }
+    };
+    const baseTags = [
+        { name: 'viewport', content: 'width=device-width, initial-scale=1' },
+        { name: 'description', content: props.description },
+        { name: 'keywords', content: processedKeywords },
+        { name: 'generator', content: 'Geekron' },
+    ];
+    if (props.indexing) {
+        baseTags.push({ name: 'robots', content: 'index, follow' });
+    }
+    else {
+        baseTags.push({ name: 'robots', content: 'noindex, follow' });
+    }
+    // 添加文章特定标签
+    if (props.type === 'article') {
+        if (props.published) {
+            baseTags.push({
+                name: 'article:published_time',
+                content: props.published.toISOString(),
+            });
+        }
+        if (props.modified) {
+            baseTags.push({
+                name: 'article:modified_time',
+                content: props.modified.toISOString(),
+            });
+        }
+        if (props.author) {
+            baseTags.push({ name: 'article:author', content: props.author.name });
+            if (props.author.url) {
+                baseTags.push({
+                    name: 'article:author',
+                    content: fullUrl(baseUrl, props.author.url),
+                });
+            }
+        }
+        if (props.article?.section) {
+            baseTags.push({
+                name: 'article:section',
+                content: props.article.section,
+            });
+        }
+        if (props.article?.tag && Array.isArray(props.article.tag)) {
+            props.article.tag.forEach((tag) => {
+                baseTags.push({
+                    name: 'article:tag',
+                    content: tag,
+                });
+            });
+        }
+    }
+    // 添加产品特定标签
+    if (props.type === 'product') {
+        if (props.product?.price) {
+            baseTags.push({
+                name: 'product:price:amount',
+                content: String(props.product.price),
+            });
+        }
+        if (props.product?.priceCurrency) {
+            baseTags.push({
+                name: 'product:price:currency',
+                content: props.product.priceCurrency,
+            });
+        }
+    }
+    const ogTags = [
+        { property: 'og:url', content: props.url },
+        { property: 'og:type', content: ogType },
+        { property: 'og:title', content: props.title },
+        { property: 'og:description', content: props.description },
+        { property: 'og:image', content: props.image.src },
+        { property: 'og:image:alt', content: props.image.alt || props.title },
+        { property: 'og:image:width', content: String(props.image.width) },
+        { property: 'og:image:height', content: String(props.image.height) },
+        { property: 'og:locale', content: props.site.locale },
+        { property: 'og:site_name', content: props.site.name },
+    ];
+    // 添加产品特定OG标签
+    if (props.type === 'product') {
+        ogTags.push({
+            property: 'product:price:amount',
+            content: String(props.product?.price || ''),
+        }, {
+            property: 'product:price:currency',
+            content: props.product?.priceCurrency || '',
+        }, {
+            property: 'product:availability',
+            content: props.product?.availability || 'in_stock',
+        });
+    }
+    const twitterTags = [
+        { name: 'twitter:card', content: props.twitter?.card || twitterCardType },
+        {
+            name: 'twitter:site',
+            content: props.twitter?.site || `@${props.site.name.replace(/\s+/g, '')}`,
+        },
+        {
+            name: 'twitter:creator',
+            content: props.twitter?.creator ||
+                (props.author?.name ? `@${props.author.name.replace(/\s+/g, '')}` : ''),
+        },
+        { name: 'twitter:title', content: props.title },
+        { name: 'twitter:description', content: props.description },
+        { name: 'twitter:image', content: props.image.src },
+        { name: 'twitter:image:alt', content: props.image.alt || props.title },
+    ];
+    const metaTags = [...baseTags, ...ogTags, ...twitterTags]
+        .map((meta) => props.metaHandler?.(meta) || meta)
+        .filter(Boolean);
+    // 构建结构化数据数组
+    const structuredData = [
+        createMainEntity(),
+        {
+            '@context': 'https://schema.org',
+            '@type': 'BreadcrumbList',
+            itemListElement: props.breadcrumbs.map((item, index) => ({
+                '@type': 'ListItem',
+                position: index + 1,
+                name: item.title,
+                item: fullUrl(baseUrl, item.url),
+            })),
+        },
+        // 添加网站组织信息
+        {
+            '@context': 'https://schema.org',
+            '@type': 'Organization',
+            name: props.site.name,
+            url: props.site.url,
+            logo: props.site.logo,
+            contactPoint: props.site.contactPoint
+                ? {
+                    '@type': 'ContactPoint',
+                    telephone: props.site.contactPoint.telephone,
+                    contactType: props.site.contactPoint.contactType,
+                    areaServed: props.site.contactPoint.areaServed,
+                    availableLanguage: props.site.contactPoint.availableLanguage,
+                }
+                : undefined,
+        },
+    ].filter((item) => item !== null);
+    // 构建网站图标链接标签
+    const iconLinks = [
+        // 基本favicon
+        { rel: 'icon', type: 'image/x-icon', href: props.site.icon },
+        // 不同尺寸的favicon
+        { rel: 'icon', type: 'image/png', sizes: '32x32', href: props.site.icon },
+        { rel: 'icon', type: 'image/png', sizes: '16x16', href: props.site.icon },
+        // Apple触控图标
+        props.site.appleTouchIcon && {
+            rel: 'apple-touch-icon',
+            sizes: '180x180',
+            href: props.site.appleTouchIcon,
+        },
+        // Android Chrome图标
+        { rel: 'icon', type: 'image/png', sizes: '192x192', href: props.site.icon },
+        { rel: 'icon', type: 'image/png', sizes: '512x512', href: props.site.icon },
+        // Web App Manifest
+        props.site.manifest && {
+            rel: 'manifest',
+            href: props.site.manifest,
+        },
+        // Safari固定标签页图标
+        props.site.safariPinnedTab && {
+            rel: 'mask-icon',
+            href: props.site.safariPinnedTab,
+            color: props.site.msApplicationTileColor || '#5bbad5',
+        },
+        // MS Application
+        props.site.msApplicationTileImage && {
+            name: 'msapplication-TileImage',
+            content: props.site.msApplicationTileImage,
+        },
+        // 主题色
+        props.site.themeColor && {
+            name: 'theme-color',
+            content: props.site.themeColor,
+        },
+    ].filter(Boolean);
+    return (_jsxs(_Fragment, { children: [_jsx("title", { children: props.title }), _jsx("link", { rel: "canonical", href: props.url }), iconLinks.map((link, index) => (_jsx("link", { ...link }, `icon-${index}`))), metaTags.map((tag, index) => (_jsx("meta", { ...tag }, index))), _jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: {
+                    __html: JSON.stringify(structuredData).replace(/undefined/g, 'null'),
+                } })] }));
+};

package/dist/core/components/index.d.ts

@@ -0,0 +1,3 @@
+export * from './InquiryEmailTemplate';
+export * from './Seo';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/components/index.tsx"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,OAAO,CAAA"}

package/dist/core/components/index.js

@@ -0,0 +1,2 @@
+export * from './InquiryEmailTemplate';
+export * from './Seo';

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export * from './middlewares';
+export * from './template';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,3 @@
+export * from './middlewares';
+export * from './template';
+export * from './utils';

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

@@ -0,0 +1,52 @@
+/**
+ * 默认分页配置
+ */
+export declare const PAGINATION_DEFAULTS: {
+    /** 默认页码 */
+    readonly PAGE: 1;
+    /** 默认每页条数 */
+    readonly PAGE_SIZE: 20;
+    /** 最大每页条数 */
+    readonly MAX_PAGE_SIZE: 100;
+};
+/**
+ * 默认排序配置
+ */
+export declare const SORT_DEFAULTS: {
+    /** 默认排序字段 */
+    readonly SORT_BY: "createdAt";
+    /** 默认排序方向 */
+    readonly ORDER: "desc";
+};
+/**
+ * 缓存配置
+ */
+export declare const CACHE_CONFIG: {
+    /** 列表缓存 key 前缀 */
+    readonly LIST_PREFIX: "inquiries:list";
+    /** 详情缓存 key 前缀 */
+    readonly DETAIL_PREFIX: "inquiries:detail";
+};
+/**
+ * 错误码定义
+ */
+export declare const ERROR_CODES: {
+    /** 无效的 ID */
+    readonly INVALID_ID: 10001;
+    /** 记录不存在 */
+    readonly NOT_FOUND: 10002;
+    /** 无效的参数 */
+    readonly INVALID_PARAMS: 10003;
+    /** 服务器内部错误 */
+    readonly INTERNAL_ERROR: 10000;
+};
+/**
+ * HTTP 状态码
+ */
+export declare const HTTP_STATUS: {
+    readonly OK: 200;
+    readonly BAD_REQUEST: 400;
+    readonly NOT_FOUND: 404;
+    readonly INTERNAL_ERROR: 500;
+};
+//# sourceMappingURL=inquiry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inquiry.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/constants/inquiry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC/B,WAAW;;IAEX,aAAa;;IAEb,aAAa;;CAEJ,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,aAAa;IACzB,aAAa;;IAEb,aAAa;;CAEJ,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,YAAY;IACxB,kBAAkB;;IAElB,kBAAkB;;CAET,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,WAAW;IACvB,aAAa;;IAEb,YAAY;;IAEZ,YAAY;;IAEZ,cAAc;;CAEL,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAA"}

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

@@ -0,0 +1,51 @@
+/**
+ * 默认分页配置
+ */
+export const PAGINATION_DEFAULTS = {
+    /** 默认页码 */
+    PAGE: 1,
+    /** 默认每页条数 */
+    PAGE_SIZE: 20,
+    /** 最大每页条数 */
+    MAX_PAGE_SIZE: 100,
+};
+/**
+ * 默认排序配置
+ */
+export const SORT_DEFAULTS = {
+    /** 默认排序字段 */
+    SORT_BY: 'createdAt',
+    /** 默认排序方向 */
+    ORDER: 'desc',
+};
+/**
+ * 缓存配置
+ */
+export const CACHE_CONFIG = {
+    /** 列表缓存 key 前缀 */
+    LIST_PREFIX: 'inquiries:list',
+    /** 详情缓存 key 前缀 */
+    DETAIL_PREFIX: 'inquiries:detail',
+};
+/**
+ * 错误码定义
+ */
+export const ERROR_CODES = {
+    /** 无效的 ID */
+    INVALID_ID: 10001,
+    /** 记录不存在 */
+    NOT_FOUND: 10002,
+    /** 无效的参数 */
+    INVALID_PARAMS: 10003,
+    /** 服务器内部错误 */
+    INTERNAL_ERROR: 10000,
+};
+/**
+ * HTTP 状态码
+ */
+export const HTTP_STATUS = {
+    OK: 200,
+    BAD_REQUEST: 400,
+    NOT_FOUND: 404,
+    INTERNAL_ERROR: 500,
+};

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

@@ -0,0 +1,29 @@
+/**
+ * 默认查询配置
+ */
+export declare const QUERY_DEFAULTS: {
+    /** 默认查询条数限制 */
+    readonly LIMIT: 100;
+    /** 最大查询条数限制 */
+    readonly MAX_LIMIT: 1000;
+};
+/**
+ * 错误码定义
+ */
+export declare const ERROR_CODES: {
+    /** 无效的查询参数 */
+    readonly INVALID_QUERY: 20001;
+    /** 查询失败 */
+    readonly QUERY_FAILED: 20002;
+    /** 服务器内部错误 */
+    readonly INTERNAL_ERROR: 20000;
+};
+/**
+ * HTTP 状态码
+ */
+export declare const HTTP_STATUS: {
+    readonly OK: 200;
+    readonly BAD_REQUEST: 400;
+    readonly INTERNAL_ERROR: 500;
+};
+//# sourceMappingURL=visitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visitor.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/constants/visitor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc;IAC1B,eAAe;;IAEf,eAAe;;CAEN,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,WAAW;IACvB,cAAc;;IAEd,WAAW;;IAEX,cAAc;;CAEL,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAA"}

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

@@ -0,0 +1,28 @@
+/**
+ * 默认查询配置
+ */
+export const QUERY_DEFAULTS = {
+    /** 默认查询条数限制 */
+    LIMIT: 100,
+    /** 最大查询条数限制 */
+    MAX_LIMIT: 1000,
+};
+/**
+ * 错误码定义
+ */
+export const ERROR_CODES = {
+    /** 无效的查询参数 */
+    INVALID_QUERY: 20001,
+    /** 查询失败 */
+    QUERY_FAILED: 20002,
+    /** 服务器内部错误 */
+    INTERNAL_ERROR: 20000,
+};
+/**
+ * HTTP 状态码
+ */
+export const HTTP_STATUS = {
+    OK: 200,
+    BAD_REQUEST: 400,
+    INTERNAL_ERROR: 500,
+};

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

@@ -0,0 +1,15 @@
+/**
+ * 数据文件根目录（可通过环境变量覆盖）
+ */
+export declare const DATA_DIR: string;
+/**
+ * 询盘数据库文件路径
+ */
+export declare const INQUIRY_DB_PATH: string;
+/**
+ * 单个访客分片数据库最大容量（字节）
+ */
+export declare const MAX_DB_SIZE_BYTES: number;
+/** 访客分片策略 */
+export type VisitorShardStrategy = 'sequence' | 'date';
+//# sourceMappingURL=database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../../../src/core/lib/database/constants/database.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,QAAQ,QAAuD,CAAA;AAE5E;;GAEG;AACH,eAAO,MAAM,eAAe,QAAoC,CAAA;AAEhE;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAoB,CAAA;AAElD,aAAa;AACb,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,MAAM,CAAA"}

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

@@ -0,0 +1,14 @@
+import * as path from 'node:path';
+import { WEBSITE_DATA_DIR } from '../../../../contract';
+/**
+ * 数据文件根目录（可通过环境变量覆盖）
+ */
+export const DATA_DIR = WEBSITE_DATA_DIR || path.join(process.cwd(), 'data');
+/**
+ * 询盘数据库文件路径
+ */
+export const INQUIRY_DB_PATH = path.join(DATA_DIR, 'inquiry.db');
+/**
+ * 单个访客分片数据库最大容量（字节）
+ */
+export const MAX_DB_SIZE_BYTES = 100 * 1024 * 1024;

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

@@ -0,0 +1,63 @@
+import type { Inquiry, InquiryCreate, InquiryListParams } from './schemas/inquiry.schema';
+import type { DailyPageViewStats, IpPageViewStats, PageView, PVStats, UVStats, VisitorCreate, VisitorQuery, VisitorSession, VisitorStatsBy } from './schemas/visitor.schema';
+/**
+ * DatabaseService：聚合仓储，提供对外的业务友好 API。
+ */
+export declare class DatabaseService {
+    private manager;
+    private inquiryRepo;
+    private visitorRepo;
+    private initialized;
+    constructor();
+    /** 初始化数据目录及各表结构 */
+    init(): Promise<void>;
+    /** 询盘：创建 */
+    addInquiry(data: InquiryCreate): Promise<number>;
+    /** 询盘：按 ID 查询 */
+    getInquiryById(id: number): Promise<Inquiry | null>;
+    /** 询盘：列表 */
+    listInquiries(params?: InquiryListParams): Promise<Inquiry[]>;
+    /** 询盘：计数 */
+    countInquiries(params?: InquiryListParams): Promise<number>;
+    /** 询盘：统计未读数量 */
+    countUnreadInquiries(): Promise<number>;
+    /** 询盘：标记已读 */
+    markInquiryAsRead(id: number, operatorId: number): Promise<boolean>;
+    /** 访客：写入 */
+    addVisitor(data: VisitorCreate): Promise<{
+        id: number;
+        shardPath: string;
+    }>;
+    /** 访客：查询页面浏览记录 */
+    queryPageViews(filter?: VisitorQuery): Promise<PageView[]>;
+    /** 访客：查询访客会话 */
+    queryVisitorSessions(filter?: VisitorQuery): Promise<VisitorSession[]>;
+    /** 访客：计数（页面浏览数） */
+    countVisitors(filter?: VisitorQuery): Promise<number>;
+    /** 访客：统计（向后兼容） */
+    visitorStats(by: VisitorStatsBy, filter?: VisitorQuery): Promise<{
+        key: string;
+        count: number;
+    }[]>;
+    /**
+     * 统计独立访客数（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[]>;
+}
+/**
+ * 获取数据库服务实例（单例）
+ */
+export declare function getDatabase(): Promise<DatabaseService>;
+//# sourceMappingURL=database.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database.service.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/database/database.service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACX,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EACX,kBAAkB,EAClB,eAAe,EACf,QAAQ,EACR,OAAO,EACP,OAAO,EACP,aAAa,EACb,YAAY,EACZ,cAAc,EACd,cAAc,EACd,MAAM,0BAA0B,CAAA;AAEjC;;GAEG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,WAAW,CAAQ;;IAQ3B,mBAAmB;IACb,IAAI;IAQV,YAAY;IACZ,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhD,iBAAiB;IACjB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAInD,YAAY;IACZ,aAAa,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIjE,YAAY;IACZ,cAAc,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/D,gBAAgB;IAChB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvC,cAAc;IACd,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInE,YAAY;IACZ,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3E,kBAAkB;IAClB,cAAc,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI9D,gBAAgB;IAChB,oBAAoB,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAI1E,mBAAmB;IACnB,aAAa,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzD,kBAAkB;IAClB,YAAY,CACX,EAAE,EAAE,cAAc,EAClB,MAAM,GAAE,YAAiB,GACvB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAI5C;;OAEG;IACH,UAAU,CAAC,MAAM,GAAE,YAAiB,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvE;;OAEG;IACH,UAAU,CACT,MAAM,GAAE,YAAiB,EACzB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC;IAInB;;OAEG;IACH,qBAAqB,CACpB,MAAM,GAAE,YAAiB,GACvB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIhC;;OAEG;IACH,kBAAkB,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAGzE;AAOD;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC,CAM5D"}