@dofe/infra-shared-services 0.1.1

package/dist/ip-info/ip-info.service.js

@@ -0,0 +1,177 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IpInfoService = void 0;
+/**
+ * IP Info Service
+ *
+ * 职责：提供 IP 信息查询服务
+ * - IP 地址信息查询（通过 IpInfoClient）
+ * - 国家/地区查询
+ * - 大洲查询（依赖 CountryCodeService）
+ * - 时区查询
+ * - 缓存管理
+ * - 业务逻辑处理（默认值、特殊地区处理等）
+ *
+ * 架构：
+ * - 使用 IpInfoClient 进行 HTTP 调用（符合架构规范）
+ * - 依赖 CountryCodeService（domain 层），因此放置在 infra/shared-services
+ */
+const common_1 = require("@nestjs/common");
+const nest_winston_1 = require("nest-winston");
+const winston_1 = require("winston");
+const config_1 = require("@nestjs/config");
+const infra_redis_1 = require("@dofe/infra-redis");
+const ip_util_1 = __importDefault(require("@dofe/infra-utils/ip.util"));
+const validate_util_1 = __importDefault(require("@dofe/infra-utils/validate.util"));
+const environment_util_1 = __importDefault(require("@dofe/infra-utils/environment.util"));
+const infra_shared_db_1 = require("@dofe/infra-shared-db");
+const ip_info_client_1 = require("./ip-info.client");
+let IpInfoService = class IpInfoService {
+    config;
+    redis;
+    countryCodeService;
+    ipInfoClient;
+    logger;
+    ipInfoConfig;
+    ipinfoRedisKey = 'ipinfo';
+    constructor(config, redis, countryCodeService, ipInfoClient, logger) {
+        this.config = config;
+        this.redis = redis;
+        this.countryCodeService = countryCodeService;
+        this.ipInfoClient = ipInfoClient;
+        this.logger = logger;
+        this.ipInfoConfig = config.getOrThrow('ipinfo');
+    }
+    /**
+     * 从请求中提取 IP 地址
+     */
+    extractIp(req) {
+        return ip_util_1.default.extractIp(req);
+    }
+    /**
+     * 获取 IP 信息
+     *
+     * 业务逻辑：
+     * 1. CN 环境返回默认值
+     * 2. 本地 IP 返回默认值
+     * 3. 检查 Redis 缓存
+     * 4. 调用 ipinfo.io API（通过 IpInfoClient）
+     * 5. CN IP 替换为 SG（业务需求）
+     * 6. 失败时返回默认值
+     */
+    async getIpInfo(ip) {
+        // 1. CN 环境默认值
+        if (environment_util_1.default.getBaseZone() === 'cn') {
+            return this.getDefaultIpInfo(ip, 'CN', 'Beijing', 'Asia/Shanghai');
+        }
+        // 2. 本地 IP 默认值
+        if (validate_util_1.default.isBlank(ip) || ip === '127.0.0.1') {
+            return this.getDefaultIpInfo(ip, 'SG', 'Singapore', 'Asia/Singapore');
+        }
+        // 3. 检查缓存
+        const cached = await this.redis.getData(this.ipinfoRedisKey, ip);
+        if (cached) {
+            this.logger.debug('[IpInfoService] Cache hit', { ip });
+            return cached;
+        }
+        // 4. 调用 API（通过 Client）
+        try {
+            const apiResponse = await this.ipInfoClient.fetchIpInfo(ip, this.ipInfoConfig.token, this.ipInfoConfig.url);
+            let ipInfoData = {
+                ip: apiResponse.ip,
+                country: apiResponse.country,
+                region: apiResponse.region,
+                city: apiResponse.city,
+                loc: apiResponse.loc,
+                timezone: apiResponse.timezone,
+                org: apiResponse.org,
+            };
+            this.logger.info('[IpInfoService] IP info fetched', { ipInfoData });
+            // 5. 缓存结果
+            await this.redis.saveData(this.ipinfoRedisKey, ip, ipInfoData);
+            // 6. CN IP 替换为 SG（业务需求）
+            if (ipInfoData.country === 'CN') {
+                ipInfoData = this.getDefaultIpInfo(ip, 'SG', 'Singapore', 'Asia/Singapore');
+            }
+            return ipInfoData;
+        }
+        catch (error) {
+            // 7. 失败时返回默认值
+            this.logger.error('[IpInfoService] Failed to fetch IP info', {
+                ip,
+                error: error.message,
+            });
+            return this.getDefaultIpInfo(ip, 'SG', 'Singapore', 'Asia/Singapore');
+        }
+    }
+    /**
+     * 获取 IP 所属国家
+     */
+    async getIpCountry(ip) {
+        const ipInfo = await this.getIpInfo(ip);
+        return ipInfo.country;
+    }
+    /**
+     * 获取 IP 所属大洲
+     */
+    async getContinent(ip) {
+        const countryCode = await this.getIpCountry(ip);
+        const relations = await this.countryCodeService.loadRelations();
+        for (const [continent, countries] of Object.entries(relations)) {
+            if (countries.includes(countryCode)) {
+                return continent;
+            }
+        }
+        this.logger.error('[IpInfoService] Failed to fetch IP continent', {
+            ip,
+            countryCode,
+        });
+        return environment_util_1.default.getBaseZone();
+    }
+    /**
+     * 获取 IP 时区
+     */
+    async getTimeZone(ip) {
+        const ipInfo = await this.getIpInfo(ip);
+        return ipInfo.timezone;
+    }
+    /**
+     * 生成默认 IP 信息
+     */
+    getDefaultIpInfo(ip, country, city, timezone) {
+        return {
+            ip,
+            country,
+            region: city,
+            city,
+            loc: country === 'CN' ? '39.9042,116.4074' : '1.2897,103.8501',
+            timezone,
+        };
+    }
+};
+exports.IpInfoService = IpInfoService;
+exports.IpInfoService = IpInfoService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(4, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [config_1.ConfigService,
+        infra_redis_1.RedisService,
+        infra_shared_db_1.CountryCodeService,
+        ip_info_client_1.IpInfoClient,
+        winston_1.Logger])
+], IpInfoService);
+//# sourceMappingURL=ip-info.service.js.map

package/dist/ip-info/ip-info.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-info.service.js","sourceRoot":"","sources":["../../src/ip-info/ip-info.service.ts"],"names":[],"mappings":"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"}

package/dist/ocr/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview OCR 服务导出
+ *
+ * 本模块提供 OCR 文本提取能力的统一封装。
+ *
+ * @module ocr
+ *
+ * @example
+ * ```typescript
+ * // 导入模块
+ * import { OcrModule, OcrService } from '@app/shared-services/ocr';
+ *
+ * // 在 NestJS 模块中使用
+ * @Module({
+ *   imports: [OcrModule],
+ * })
+ * export class MyModule {}
+ *
+ * // 在服务中注入使用
+ * @Injectable()
+ * class MyService {
+ *   constructor(private readonly ocrService: OcrService) {}
+ *
+ *   async extractText(fileUrl: string) {
+ *     const result = await this.ocrService.extractText(fileUrl, 'pdf');
+ *     return result.text;
+ *   }
+ * }
+ * ```
+ */
+export { OcrModule } from './ocr.module';
+export * from './ocr.service';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ocr/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,cAAc,eAAe,CAAC"}

package/dist/ocr/index.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * @fileoverview OCR 服务导出
+ *
+ * 本模块提供 OCR 文本提取能力的统一封装。
+ *
+ * @module ocr
+ *
+ * @example
+ * ```typescript
+ * // 导入模块
+ * import { OcrModule, OcrService } from '@app/shared-services/ocr';
+ *
+ * // 在 NestJS 模块中使用
+ * @Module({
+ *   imports: [OcrModule],
+ * })
+ * export class MyModule {}
+ *
+ * // 在服务中注入使用
+ * @Injectable()
+ * class MyService {
+ *   constructor(private readonly ocrService: OcrService) {}
+ *
+ *   async extractText(fileUrl: string) {
+ *     const result = await this.ocrService.extractText(fileUrl, 'pdf');
+ *     return result.text;
+ *   }
+ * }
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OcrModule = void 0;
+// 模块导出
+var ocr_module_1 = require("./ocr.module");
+Object.defineProperty(exports, "OcrModule", { enumerable: true, get: function () { return ocr_module_1.OcrModule; } });
+// 服务导出
+__exportStar(require("./ocr.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/ocr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ocr/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;;;;;;;;;;;;;;;AAEH,OAAO;AACP,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAElB,OAAO;AACP,gDAA8B"}

package/dist/ocr/ocr.module.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview OCR 服务模块
+ *
+ * 本模块提供 OCR 文本提取服务的 NestJS 模块配置
+ *
+ * @module ocr/module
+ */
+/**
+ * OCR 服务模块
+ *
+ * @description 提供文件 OCR 文本提取服务的依赖注入配置。
+ *
+ * 导出服务：
+ * - `OcrService`: OCR 文本提取服务
+ *
+ * 依赖模块：
+ * - `AgentXClientModule`: AgentX 任务客户端模块
+ *
+ * @example
+ * ```typescript
+ * // 在其他模块中导入
+ * @Module({
+ *   imports: [OcrModule],
+ * })
+ * export class MyModule {}
+ *
+ * // 在服务中使用
+ * @Injectable()
+ * class MyService {
+ *   constructor(private readonly ocrService: OcrService) {}
+ *
+ *   async extractText(fileUrl: string) {
+ *     const result = await this.ocrService.extractText(fileUrl, 'pdf');
+ *     return result.text;
+ *   }
+ * }
+ * ```
+ */
+export declare class OcrModule {
+}
+//# sourceMappingURL=ocr.module.d.ts.map

package/dist/ocr/ocr.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr.module.d.ts","sourceRoot":"","sources":["../../src/ocr/ocr.module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAKa,SAAS;CAAG"}

package/dist/ocr/ocr.module.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * @fileoverview OCR 服务模块
+ *
+ * 本模块提供 OCR 文本提取服务的 NestJS 模块配置
+ *
+ * @module ocr/module
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OcrModule = void 0;
+const common_1 = require("@nestjs/common");
+const infra_clients_1 = require("@dofe/infra-clients");
+const ocr_service_1 = require("./ocr.service");
+/**
+ * OCR 服务模块
+ *
+ * @description 提供文件 OCR 文本提取服务的依赖注入配置。
+ *
+ * 导出服务：
+ * - `OcrService`: OCR 文本提取服务
+ *
+ * 依赖模块：
+ * - `AgentXClientModule`: AgentX 任务客户端模块
+ *
+ * @example
+ * ```typescript
+ * // 在其他模块中导入
+ * @Module({
+ *   imports: [OcrModule],
+ * })
+ * export class MyModule {}
+ *
+ * // 在服务中使用
+ * @Injectable()
+ * class MyService {
+ *   constructor(private readonly ocrService: OcrService) {}
+ *
+ *   async extractText(fileUrl: string) {
+ *     const result = await this.ocrService.extractText(fileUrl, 'pdf');
+ *     return result.text;
+ *   }
+ * }
+ * ```
+ */
+let OcrModule = class OcrModule {
+};
+exports.OcrModule = OcrModule;
+exports.OcrModule = OcrModule = __decorate([
+    (0, common_1.Module)({
+        imports: [infra_clients_1.AgentXClientModule],
+        providers: [ocr_service_1.OcrService],
+        exports: [ocr_service_1.OcrService],
+    })
+], OcrModule);
+//# sourceMappingURL=ocr.module.js.map

package/dist/ocr/ocr.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr.module.js","sourceRoot":"","sources":["../../src/ocr/ocr.module.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;AAEH,2CAAwC;AACxC,uDAAyD;AACzD,+CAA2C;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAMI,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IALrB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,kCAAkB,CAAC;QAC7B,SAAS,EAAE,CAAC,wBAAU,CAAC;QACvB,OAAO,EAAE,CAAC,wBAAU,CAAC;KACtB,CAAC;GACW,SAAS,CAAG"}

package/dist/ocr/ocr.service.d.ts

@@ -0,0 +1,111 @@
+import { Logger } from 'winston';
+import { AgentXClient } from '@dofe/infra-clients';
+/**
+ * OCR 任务请求参数
+ */
+export interface OcrTaskParams {
+    file_url: string;
+    mode?: 'basic' | 'advanced' | 'table' | 'handwriting';
+    custom_prompt?: string;
+    enable_cache?: boolean;
+}
+/**
+ * OCR 批量任务请求参数
+ */
+export interface OcrBatchTaskParams {
+    file_urls: string[];
+    mode?: 'basic' | 'advanced' | 'table' | 'handwriting';
+    custom_prompt?: string;
+    enable_cache?: boolean;
+    max_parallel?: number;
+}
+/**
+ * OCR 任务结果
+ */
+export interface OcrTaskResult {
+    raw_text?: string;
+    text?: string;
+    confidence: number;
+    pages?: Array<{
+        pageNumber: number;
+        text: string;
+    }>;
+    file_type?: string;
+    processing_time?: number;
+}
+/**
+ * OCR 结果（对外接口）
+ */
+export interface OcrResult {
+    text: string;
+    confidence: number;
+    pages?: Array<{
+        pageNumber: number;
+        text: string;
+    }>;
+    fileType?: string;
+    processingTime?: number;
+}
+/**
+ * OCR 服务
+ *
+ * 封装与 Python OCR 服务的交互，通过 AgentX 任务队列执行
+ *
+ * @example
+ * ```typescript
+ * // 注入服务
+ * @Injectable()
+ * class MyService {
+ *   constructor(private readonly ocrService: OcrService) {}
+ *
+ *   async extractText(fileUrl: string) {
+ *     const result = await this.ocrService.extractText(fileUrl, 'pdf');
+ *     return result.text;
+ *   }
+ * }
+ * ```
+ */
+export declare class OcrService {
+    private readonly logger;
+    private readonly agentxClient;
+    constructor(logger: Logger, agentxClient: AgentXClient);
+    /**
+     * 提取文件文本内容
+     *
+     * 流程：
+     * 1. 创建 OCR 任务
+     * 2. 等待任务完成（使用 SSE 或轮询）
+     * 3. 返回提取的文本
+     *
+     * @param fileUrl 文件 URL (必须是可访问的 URL)
+     * @param fileType 文件类型 (pdf, docx, doc, png, jpg, jpeg, etc.)
+     * @param options 可选参数
+     */
+    extractText(fileUrl: string, fileType: string, options?: {
+        mode?: 'basic' | 'advanced' | 'table' | 'handwriting';
+        custom_prompt?: string;
+        enable_cache?: boolean;
+        extractPages?: boolean;
+    }): Promise<OcrResult>;
+    /**
+     * 批量提取文件文本
+     *
+     * @param files 文件列表
+     * @param options 可选参数
+     */
+    extractTextBatch(files: Array<{
+        fileUrl: string;
+        fileType: string;
+    }>, options?: {
+        mode?: 'basic' | 'advanced';
+        max_parallel?: number;
+    }): Promise<Array<OcrResult | {
+        error: string;
+        fileUrl: string;
+    }>>;
+    /**
+     * 检查 OCR 服务健康状态
+     */
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=ocr.service.d.ts.map

package/dist/ocr/ocr.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr.service.d.ts","sourceRoot":"","sources":["../../src/ocr/ocr.service.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,aAAa,CAAC;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,aAAa,CAAC;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,UAAU;IAEc,OAAO,CAAC,QAAQ,CAAC,MAAM;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADqB,MAAM,EAAE,MAAM,EAC/C,YAAY,EAAE,YAAY;IAG7C;;;;;;;;;;;OAWG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,aAAa,CAAC;QACtD,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GACA,OAAO,CAAC,SAAS,CAAC;IA0ErB;;;;;OAKG;IACG,gBAAgB,CACpB,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EACnD,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;QAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA2EjE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}