@dofe/infra-shared-services 0.1.1

package/dist/file-storage/index.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * @fileoverview 文件存储服务导出
+ *
+ * 本模块提供多云存储供应商文件存储能力的统一封装。
+ *
+ * 支持的存储供应商：
+ * - AWS S3 兼容存储
+ * - 阿里云 OSS
+ * - 火山引擎 TOS
+ * - UCloud US3
+ * - Google Cloud Storage
+ * - 七牛云存储
+ *
+ * @module file-storage
+ *
+ * @example
+ * ```typescript
+ * // 导入模块
+ * import {
+ *   FileStorageServiceModule,
+ *   FileStorageService,
+ * } from '@dofe/infra-shared-services';
+ *
+ * // 在 NestJS 模块中使用
+ * @Module({
+ *   imports: [FileStorageServiceModule],
+ * })
+ * export class MyModule {}
+ *
+ * // 在服务中注入使用
+ * @Injectable()
+ * class MyService {
+ *   constructor(private readonly fileStorage: FileStorageService) {}
+ * }
+ * ```
+ */
+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.FileStorageServiceModule = void 0;
+// 模块导出
+var file_storage_module_1 = require("./file-storage.module");
+Object.defineProperty(exports, "FileStorageServiceModule", { enumerable: true, get: function () { return file_storage_module_1.FileStorageServiceModule; } });
+// 服务导出
+__exportStar(require("./file-storage.service"), exports);
+// 工厂导出
+__exportStar(require("./file-storage.factory"), exports);
+// 存储桶解析器导出
+__exportStar(require("./bucket-resolver"), exports);
+// 类型导出
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/file-storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/file-storage/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;;;;;;;;;;;;;;;;;AAEH,OAAO;AACP,6DAAiE;AAAxD,+HAAA,wBAAwB,OAAA;AAEjC,OAAO;AACP,yDAAuC;AAEvC,OAAO;AACP,yDAAuC;AAEvC,WAAW;AACX,oDAAkC;AAElC,OAAO;AACP,0CAAwB"}

package/dist/file-storage/types.d.ts

@@ -0,0 +1,187 @@
+/**
+ * @fileoverview 文件存储服务类型定义
+ *
+ * 本文件定义了文件存储服务层的核心类型和接口。
+ *
+ * @module file-storage/types
+ */
+import { FileBucketVendor } from '@prisma/client';
+import { PardxUploader } from '@dofe/infra-clients';
+/**
+ * 文件位置标识
+ *
+ * @description 唯一标识一个存储桶中的文件
+ * @interface FileLocation
+ */
+export interface FileLocation {
+    /** 存储供应商 */
+    vendor: FileBucketVendor;
+    /** 存储桶名称 */
+    bucket: string;
+    /** 文件键（路径） */
+    key: string;
+}
+/**
+ * 存储桶标识
+ *
+ * @description 唯一标识一个存储桶
+ * @interface BucketIdentifier
+ */
+export interface BucketIdentifier {
+    /** 存储供应商 */
+    vendor: FileBucketVendor;
+    /** 存储桶名称 */
+    bucket: string;
+}
+/**
+ * 存储桶查询选项
+ *
+ * @description 用于查找存储桶的选项参数
+ * @interface BucketLookupOptions
+ */
+export interface BucketLookupOptions {
+    /** 存储桶名称（可选） */
+    bucket?: string;
+    /** 客户端 IP（用于区域感知） */
+    ip?: string;
+    /** 是否公开存储桶 */
+    isPublic?: boolean;
+    /** 区域设置 */
+    locale?: string;
+    /** 存储供应商 */
+    vendor?: FileBucketVendor;
+}
+/**
+ * 文件上传选项
+ *
+ * @interface UploadOptions
+ */
+export interface UploadOptions {
+    /** 内容类型 */
+    contentType?: string;
+    /** 访问控制 */
+    acl?: 'public-read' | 'public-read-write' | 'private';
+    /** 自定义元数据 */
+    metadata?: Record<string, string>;
+}
+/**
+ * 分片上传部分信息
+ *
+ * @interface MultipartPart
+ */
+export interface MultipartPart {
+    /** ETag 标识 */
+    ETag: string;
+    /** 分片序号 */
+    PartNumber: number;
+}
+/**
+ * 预签名 URL 选项
+ *
+ * @interface PresignedUrlOptions
+ */
+export interface PresignedUrlOptions {
+    /** 上传 ID（用于分片上传） */
+    uploadId?: string;
+    /** 文件键 */
+    key?: string;
+    /** 分片序号 */
+    partNumber?: number;
+}
+/**
+ * 文件列表查询选项
+ *
+ * @interface ListFilesOptions
+ */
+export interface ListFilesOptions {
+    /** 前缀过滤 */
+    prefix?: string;
+    /** 返回数量限制 */
+    limit?: number;
+    /** 分隔符 */
+    delimiter?: string;
+    /** 附加选项 */
+    extras?: Record<string, any>;
+}
+/**
+ * 视频截图选项
+ *
+ * @interface SnapshotOptions
+ */
+export interface SnapshotOptions {
+    /** 截图时间点（秒） */
+    time?: number;
+    /** 截图宽度 */
+    width?: number;
+    /** 截图高度 */
+    height?: number;
+    /** 输出格式 */
+    format?: string;
+    /** 是否使用内部端点 */
+    internal?: boolean;
+}
+/**
+ * 私有下载 URL 选项
+ *
+ * @interface PrivateDownloadOptions
+ */
+export interface PrivateDownloadOptions {
+    /** 过期时间（秒） */
+    expire?: number;
+    /** 是否使用内部端点 */
+    internal?: boolean;
+}
+/**
+ * 存储客户端缓存键
+ *
+ * @description 用于唯一标识一个存储客户端实例
+ */
+export type StorageClientKey = `${FileBucketVendor}:${string}`;
+/**
+ * 构建存储客户端缓存键
+ *
+ * @param vendor - 存储供应商
+ * @param bucket - 存储桶名称
+ * @returns 缓存键
+ */
+export declare function buildStorageClientKey(vendor: FileBucketVendor, bucket: string): StorageClientKey;
+/**
+ * 文件复制参数
+ *
+ * @interface CopyFileParams
+ */
+export interface CopyFileParams {
+    /** 源文件位置 */
+    source: FileLocation;
+    /** 目标文件位置 */
+    destination: FileLocation;
+}
+/**
+ * 回调上传令牌选项
+ *
+ * @interface CallbackUploadTokenOptions
+ */
+export interface CallbackUploadTokenOptions {
+    /** 回调验证密钥 */
+    callbackAuthKey: string;
+    /** 是否需要分片上传 */
+    needSplitPart?: boolean;
+    /** 附加选项 */
+    extras?: Record<string, any>;
+}
+/**
+ * 存储供应商类型到客户端类的映射
+ */
+export type VendorClientMapping = Record<FileBucketVendor, new (...args: any[]) => any>;
+/**
+ * 存储凭证配置映射
+ */
+export interface StorageCredentialsMap {
+    gcs?: PardxUploader.FileApiKey;
+    us3?: PardxUploader.FileApiKey;
+    oss?: PardxUploader.FileApiKey;
+    tos?: PardxUploader.FileApiKey;
+    qiniu?: PardxUploader.FileApiKey;
+    s3?: PardxUploader.FileApiKey;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/file-storage/types.d.ts.map

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

package/dist/file-storage/types.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * @fileoverview 文件存储服务类型定义
+ *
+ * 本文件定义了文件存储服务层的核心类型和接口。
+ *
+ * @module file-storage/types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildStorageClientKey = buildStorageClientKey;
+/**
+ * 构建存储客户端缓存键
+ *
+ * @param vendor - 存储供应商
+ * @param bucket - 存储桶名称
+ * @returns 缓存键
+ */
+function buildStorageClientKey(vendor, bucket) {
+    return `${vendor}:${bucket}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/file-storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/file-storage/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAwJH,sDAKC;AAZD;;;;;;GAMG;AACH,SAAgB,qBAAqB,CACnC,MAAwB,EACxB,MAAc;IAEd,OAAO,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAC/B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export * from './email/email.module';
+export * from './email/email.service';
+export * from './file-storage/file-storage.module';
+export * from './file-storage/file-storage.service';
+export { PardxUploader } from './file-storage/index';
+export * from './ip-geo/ip-geo.module';
+export * from './ip-geo/ip-geo.service';
+export * from './ip-info/ip-info.module';
+export * from './ip-info/ip-info.service';
+export * from './ocr/ocr.module';
+export * from './ocr/ocr.service';
+export * from './sms/sms.module';
+export * from './sms/sms.service';
+export * from './streaming-asr/streaming-asr.module';
+export * from './streaming-asr/streaming-asr.service';
+export * from './system-health/system-health.module';
+export * from './system-health/system-health.service';
+export * from './uploader/uploader.module';
+export * from './uploader/uploader.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+"use strict";
+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 });
+__exportStar(require("./email/email.module"), exports);
+__exportStar(require("./email/email.service"), exports);
+__exportStar(require("./file-storage/file-storage.module"), exports);
+__exportStar(require("./file-storage/file-storage.service"), exports);
+__exportStar(require("./ip-geo/ip-geo.module"), exports);
+__exportStar(require("./ip-geo/ip-geo.service"), exports);
+__exportStar(require("./ip-info/ip-info.module"), exports);
+__exportStar(require("./ip-info/ip-info.service"), exports);
+__exportStar(require("./ocr/ocr.module"), exports);
+__exportStar(require("./ocr/ocr.service"), exports);
+__exportStar(require("./sms/sms.module"), exports);
+__exportStar(require("./sms/sms.service"), exports);
+__exportStar(require("./streaming-asr/streaming-asr.module"), exports);
+__exportStar(require("./streaming-asr/streaming-asr.service"), exports);
+__exportStar(require("./system-health/system-health.module"), exports);
+__exportStar(require("./system-health/system-health.service"), exports);
+__exportStar(require("./uploader/uploader.module"), exports);
+__exportStar(require("./uploader/uploader.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,wDAAsC;AACtC,qEAAmD;AACnD,sEAAoD;AAEpD,yDAAuC;AACvC,0DAAwC;AACxC,2DAAyC;AACzC,4DAA0C;AAC1C,mDAAiC;AACjC,oDAAkC;AAClC,mDAAiC;AACjC,oDAAkC;AAClC,uEAAqD;AACrD,wEAAsD;AACtD,uEAAqD;AACrD,wEAAsD;AACtD,6DAA2C;AAC3C,8DAA4C"}

package/dist/ip-geo/continent-mapping.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview 国家代码到大洲的静态映射
+ *
+ * 本文件提供纯静态的国家代码到大洲映射，不依赖数据库。
+ * 用于 infra 层的 IP 地理位置服务，避免 infra 依赖 domain。
+ *
+ * @module ip-geo/continent-mapping
+ */
+/**
+ * 大洲类型
+ */
+export type Continent = 'as' | 'eu' | 'na' | 'sa' | 'af' | 'oc' | 'an';
+/**
+ * 大洲到国家代码的映射
+ *
+ * 数据来源：ISO 3166-1 alpha-2 国家代码
+ */
+export declare const CONTINENT_COUNTRIES: Record<Continent, string[]>;
+/**
+ * 国家代码到大洲的反向映射（运行时生成）
+ */
+export declare const COUNTRY_TO_CONTINENT: Record<string, Continent>;
+/**
+ * 根据国家代码获取大洲
+ *
+ * @param countryCode - ISO 3166-1 alpha-2 国家代码
+ * @param defaultContinent - 默认大洲（找不到时返回）
+ * @returns 大洲代码
+ */
+export declare function getContinentByCountry(countryCode: string, defaultContinent?: Continent): Continent;
+//# sourceMappingURL=continent-mapping.d.ts.map

package/dist/ip-geo/continent-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continent-mapping.d.ts","sourceRoot":"","sources":["../../src/ip-geo/continent-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CA+M3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAM,CAAC;AASlE;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,gBAAgB,GAAE,SAAgB,GACjC,SAAS,CAEX"}

package/dist/ip-geo/continent-mapping.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * @fileoverview 国家代码到大洲的静态映射
+ *
+ * 本文件提供纯静态的国家代码到大洲映射，不依赖数据库。
+ * 用于 infra 层的 IP 地理位置服务，避免 infra 依赖 domain。
+ *
+ * @module ip-geo/continent-mapping
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COUNTRY_TO_CONTINENT = exports.CONTINENT_COUNTRIES = void 0;
+exports.getContinentByCountry = getContinentByCountry;
+/**
+ * 大洲到国家代码的映射
+ *
+ * 数据来源：ISO 3166-1 alpha-2 国家代码
+ */
+exports.CONTINENT_COUNTRIES = {
+    // 亚洲 (Asia)
+    as: [
+        'AF',
+        'AM',
+        'AZ',
+        'BH',
+        'BD',
+        'BT',
+        'BN',
+        'KH',
+        'CN',
+        'CY',
+        'GE',
+        'HK',
+        'IN',
+        'ID',
+        'IR',
+        'IQ',
+        'IL',
+        'JP',
+        'JO',
+        'KZ',
+        'KW',
+        'KG',
+        'LA',
+        'LB',
+        'MO',
+        'MY',
+        'MV',
+        'MN',
+        'MM',
+        'NP',
+        'KP',
+        'OM',
+        'PK',
+        'PS',
+        'PH',
+        'QA',
+        'SA',
+        'SG',
+        'KR',
+        'LK',
+        'SY',
+        'TW',
+        'TJ',
+        'TH',
+        'TL',
+        'TR',
+        'TM',
+        'AE',
+        'UZ',
+        'VN',
+        'YE',
+    ],
+    // 欧洲 (Europe)
+    eu: [
+        'AL',
+        'AD',
+        'AT',
+        'BY',
+        'BE',
+        'BA',
+        'BG',
+        'HR',
+        'CZ',
+        'DK',
+        'EE',
+        'FI',
+        'FR',
+        'DE',
+        'GR',
+        'HU',
+        'IS',
+        'IE',
+        'IT',
+        'XK',
+        'LV',
+        'LI',
+        'LT',
+        'LU',
+        'MT',
+        'MD',
+        'MC',
+        'ME',
+        'NL',
+        'MK',
+        'NO',
+        'PL',
+        'PT',
+        'RO',
+        'RU',
+        'SM',
+        'RS',
+        'SK',
+        'SI',
+        'ES',
+        'SE',
+        'CH',
+        'UA',
+        'GB',
+        'VA',
+    ],
+    // 北美洲 (North America)
+    na: [
+        'AG',
+        'BS',
+        'BB',
+        'BZ',
+        'CA',
+        'CR',
+        'CU',
+        'DM',
+        'DO',
+        'SV',
+        'GD',
+        'GT',
+        'HT',
+        'HN',
+        'JM',
+        'MX',
+        'NI',
+        'PA',
+        'KN',
+        'LC',
+        'VC',
+        'TT',
+        'US',
+    ],
+    // 南美洲 (South America)
+    sa: ['AR', 'BO', 'BR', 'CL', 'CO', 'EC', 'GY', 'PY', 'PE', 'SR', 'UY', 'VE'],
+    // 非洲 (Africa)
+    af: [
+        'DZ',
+        'AO',
+        'BJ',
+        'BW',
+        'BF',
+        'BI',
+        'CV',
+        'CM',
+        'CF',
+        'TD',
+        'KM',
+        'CG',
+        'CD',
+        'DJ',
+        'EG',
+        'GQ',
+        'ER',
+        'SZ',
+        'ET',
+        'GA',
+        'GM',
+        'GH',
+        'GN',
+        'GW',
+        'CI',
+        'KE',
+        'LS',
+        'LR',
+        'LY',
+        'MG',
+        'MW',
+        'ML',
+        'MR',
+        'MU',
+        'MA',
+        'MZ',
+        'NA',
+        'NE',
+        'NG',
+        'RW',
+        'ST',
+        'SN',
+        'SC',
+        'SL',
+        'SO',
+        'ZA',
+        'SS',
+        'SD',
+        'TZ',
+        'TG',
+        'TN',
+        'UG',
+        'ZM',
+        'ZW',
+    ],
+    // 大洋洲 (Oceania)
+    oc: [
+        'AU',
+        'FJ',
+        'KI',
+        'MH',
+        'FM',
+        'NR',
+        'NZ',
+        'PW',
+        'PG',
+        'WS',
+        'SB',
+        'TO',
+        'TV',
+        'VU',
+    ],
+    // 南极洲 (Antarctica) - 通常无常住人口
+    an: ['AQ'],
+};
+/**
+ * 国家代码到大洲的反向映射（运行时生成）
+ */
+exports.COUNTRY_TO_CONTINENT = {};
+// 构建反向映射
+for (const [continent, countries] of Object.entries(exports.CONTINENT_COUNTRIES)) {
+    for (const country of countries) {
+        exports.COUNTRY_TO_CONTINENT[country] = continent;
+    }
+}
+/**
+ * 根据国家代码获取大洲
+ *
+ * @param countryCode - ISO 3166-1 alpha-2 国家代码
+ * @param defaultContinent - 默认大洲（找不到时返回）
+ * @returns 大洲代码
+ */
+function getContinentByCountry(countryCode, defaultContinent = 'as') {
+    return exports.COUNTRY_TO_CONTINENT[countryCode?.toUpperCase()] ?? defaultContinent;
+}
+//# sourceMappingURL=continent-mapping.js.map

package/dist/ip-geo/continent-mapping.js.map

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

package/dist/ip-geo/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview IP 地理位置服务导出入口（Infra 层）
+ *
+ * 本模块提供纯 infra 层的 IP 地理位置服务：
+ * - IpGeoService: IP 地理位置查询服务
+ * - IpGeoModule: NestJS 模块
+ * - getContinentByCountry: 静态大洲映射函数
+ *
+ * @example
+ * ```typescript
+ * import { IpGeoModule, IpGeoService } from '@dofe/infra-shared-services';
+ *
+ * @Module({
+ *   imports: [IpGeoModule],
+ * })
+ * export class MyModule {}
+ *
+ * @Injectable()
+ * class MyService {
+ *   constructor(private readonly ipGeo: IpGeoService) {}
+ *
+ *   async getRegion(ip: string) {
+ *     return await this.ipGeo.getContinent(ip);
+ *   }
+ * }
+ * ```
+ *
+ * @module ip-geo
+ */
+export { IpGeoModule } from './ip-geo.module';
+export { IpGeoService } from './ip-geo.service';
+export { getContinentByCountry, Continent, CONTINENT_COUNTRIES, COUNTRY_TO_CONTINENT, } from './continent-mapping';
+//# sourceMappingURL=index.d.ts.map

package/dist/ip-geo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ip-geo/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}