@skyroc/logger

                ┌──── ConsoleTransport（仅 isDev）
LogLayer ──────┤
                └──── StorageTransport ──→ IStorageAdapter ──→ IndexedDB / AsyncStorage

WhitelistManager  ──→ 周期请求接口，判断本设备是否在白名单
UploadManager     ──→ 命中白名单后分批 POST 上传，成功即删除已传记录
CleanupManager    ──→ 按 retentionDays 清理过期日志

import { createConsoleLogger } from '@skyroc/logger';

// 同步，无参数，直接返回 LogLayer 实例
const logger = createConsoleLogger();

logger.info('hello');

import { createLogger } from '@skyroc/logger';

// 异步：内部要先取设备 ID 并 init 存储适配器
const { logger, uploadLogs, cleanupLogs, dispose } = await createLogger({
  platform: 'web',
  isDev: false,
  retentionDays: 7,
  whitelistEndpoint: '/api/log/whitelist',
  uploadEndpoint: '/api/log/upload'
});

// LogLayer 链式 API
logger.info('Application started');
logger.withMetadata({ userId: '123' }).info('User action');
logger.withError(new Error('boom')).error('Operation failed');

// 应用退出
dispose();

interface LoggerConfig {
  /** 平台类型，默认 'web' */
  platform?: 'web' | 'react-native' | 'mini-program';
  /** 是否为开发模式，默认 true */
  isDev?: boolean;
  /** 日志保留天数，默认 7 */
  retentionDays?: number;
  /** 白名单检查端点 */
  whitelistEndpoint?: string;
  /** 日志上传端点 */
  uploadEndpoint?: string;
  /** 白名单检查间隔（ms），默认 5 分钟 */
  whitelistCheckInterval?: number;
  /** 批量上传大小，默认 100 条 */
  uploadBatchSize?: number;
  /** 自定义存储适配器，给了就不再按 platform 自动选 */
  storageAdapter?: IStorageAdapter;
  /** 日志刷盘间隔（ms），默认 5000 */
  flushInterval?: number;
  /** 是否在开发模式下也启用存储，默认 false */
  enableStorageInDev?: boolean;
}

应用启动
  └─ WhitelistManager 每 whitelistCheckInterval 请求一次 whitelistEndpoint
     ├─ 设备不在白名单 → 只写本地，不上传
     └─ 设备首次入白名单 → 触发历史日志全量上传，之后持续上传新增

UploadManager：
  - 从存储读出待传 LogRecord[]
  - 按 uploadBatchSize 分批 POST 到 uploadEndpoint
  - 成功后删除已传记录；失败留着下次再试

interface LogRecord {
  id: string;
  timestamp: number;
  level: LogLevel;
  message: string;
  /** 附加数据 */
  data?: Record<string, any>;
  /** 上下文数据 */
  context?: Record<string, any>;
  /** 序列化后的错误信息 */
  error?: Record<string, any>;
}