@laiye_packages/uci 1.0.0

package/dist/logger/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 日志模块，提供默认日志格式化、默认IndexDB存储
+ * 说明：
+ * 1. 在IndexDB不可用的时候，允许日志不记录或丢失情况，也无需降级处理
+ *    - IndexDB不可用场景：隐私模式、存储空间不足、浏览器不支持等
+ *    - 日志丢失影响：仅影响问题排查，不影响核心业务功能
+ * 2. 浏览器日志仅用于辅助分析问题，对于日志的健壮性要求不高，无需重试和备用策略
+ *    - 适用场景：开发调试、线上问题排查
+ *    - 不适用场景：业务审计、关键操作记录等
+ */
+export declare enum LYLogLevel {
+    NONE = 0,
+    ERROR = 1,
+    WARN = 2,
+    INFO = 3,
+    DEBUG = 4
+}
+export interface ILYLogFormatter {
+    format(level: string, namespace: string, args: unknown[]): string;
+}
+export interface ILYLogStorage {
+    printToConsole?: boolean;
+    write(level: string, message: string, meta?: any): Promise<void>;
+    download(filename: string): Promise<void>;
+}
+export interface ILYLogger {
+    readonly level: LYLogLevel;
+    setLevel(level: LYLogLevel): void;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    download(): Promise<void>;
+}
+export declare class LYDefaultLogFormatter implements ILYLogFormatter {
+    format(level: string, namespace: string, args: unknown[]): string;
+    private formatArgs;
+}
+export declare class LYIndexedDBLogStorage implements ILYLogStorage {
+    private _db;
+    private _maxLogs;
+    private _logBuffer;
+    private _bufferSize;
+    private _flushInterval;
+    private _isFlushing;
+    private _printToConsole;
+    constructor();
+    get printToConsole(): boolean;
+    set printToConsole(value: boolean);
+    private init;
+    private generateId;
+    private getMicroTimestamp;
+    write(level: string, message: string, meta?: any): Promise<void>;
+    private flushBuffer;
+    private cleanupOldLogs;
+    private getAllLogs;
+    download(filename: string): Promise<void>;
+}
+export declare function setFormatter(formatter: ILYLogFormatter): void;
+export declare function setStorage(storage: ILYLogStorage): void;
+export declare function setPrintToConsole(enabled: boolean): void;
+export declare class LYLogger implements ILYLogger {
+    private _level;
+    private _namespace;
+    constructor(namespace: string, level?: LYLogLevel);
+    get level(): LYLogLevel;
+    setLevel(level: LYLogLevel): void;
+    private log;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    download(): Promise<void>;
+}
+export declare const logger: LYLogger;

package/dist/object/index.d.ts

@@ -0,0 +1,57 @@
+import events from 'events';
+import { LYLogger } from '../logger';
+export type LYConstructor<T> = new (...args: any[]) => T;
+type LYClassDesc = {
+    name: string;
+    Construct: LYConstructor<LYObject>;
+};
+export declare class LYObject extends events.EventEmitter {
+    private _logger;
+    private static _instances;
+    static registerClass(name: string, Construct: LYConstructor<LYObject>): void;
+    protected static autoRegister(this: LYConstructor<LYObject>): void;
+    static getInstance<T extends LYObject>(obj: LYConstructor<T> | string, ...args: unknown[]): T;
+    static getClassName<T extends LYObject>(obj: T | LYConstructor<T>, def?: string): string;
+    static getClass<T extends LYObject>(name: string, def?: LYConstructor<T>): LYConstructor<T>;
+    static getDerivedClasses<T extends LYObject>(name: string | LYConstructor<T>): LYConstructor<T>[];
+    static get classes(): {
+        [key: string]: LYClassDesc;
+    };
+    constructor();
+    get className(): string;
+    is(className: string): boolean;
+    get logger(): LYLogger;
+}
+export declare function register(name: string): (Construct: LYConstructor<LYObject>) => void;
+type LYEventsDefinition = {
+    [event: string]: (...args: any[]) => void;
+};
+type LYAny<T> = {
+    [key: string]: T;
+};
+type LYValueType<T> = T extends LYAny<infer U> ? U : never;
+type LYUnionToIntersection<Union> = (Union extends any ? (argument: Union) => void : never) extends (argument: infer Intersection) => void ? Intersection : never;
+export type LYEventsWithoutAny<T extends {
+    [event: string]: (...args: any[]) => void;
+}> = {
+    on: LYUnionToIntersection<LYValueType<{
+        [K in keyof T]: (event: K, listener: T[K]) => any;
+    }>>;
+    emit: LYUnionToIntersection<LYValueType<{
+        [K in keyof T]: (event: K, ...args: Parameters<T[K]>) => boolean;
+    }>>;
+};
+export type LYEvents<T extends LYEventsDefinition> = LYEventsWithoutAny<T> & {
+    on(event: string, listener: (...args: any[]) => void): any;
+    emit(event: string, ...args: any[]): any;
+};
+export interface ILYEvents<T extends LYEventsDefinition> {
+    on: LYEventsWithoutAny<T>['on'];
+    off: LYEventsWithoutAny<T>['on'];
+    once: LYEventsWithoutAny<T>['on'];
+    addListener: LYEventsWithoutAny<T>['on'];
+    removeListener: LYEventsWithoutAny<T>['on'];
+    emit: LYEventsWithoutAny<T>['emit'];
+}
+export declare function wait(interval?: number): Promise<void>;
+export {};

package/dist/observable/index.d.ts

@@ -0,0 +1,14 @@
+import { LYSerializeable, SERIALIZE_CREATE, LYCtorInfo } from './serializeable';
+export declare class LYObservable extends LYSerializeable {
+}
+export declare class LYOwnerObservable<T> extends LYObservable {
+    private _owner;
+    protected static [SERIALIZE_CREATE](ctor: LYCtorInfo, ...args: any[]): LYSerializeable;
+    constructor(owner: T);
+    get owner(): T;
+    set owner(value: T);
+}
+export declare const observe: {
+    action: import("mobx").IActionFactory;
+    include(target: any, propertyOrContext: any): any;
+};

package/dist/observable/serializeable.d.ts

@@ -0,0 +1,86 @@
+import { EventEmitter } from 'events';
+import { type IObjectDidChange, type IArrayDidChange, type IMapDidChange } from 'mobx';
+import { LYObject, type LYEventsWithoutAny } from '../object';
+/**
+ * 序列化管理基类
+ * 已实现按所有key进行遍历进行序列化操作，不包含原型上的属性
+ * 不支持function、symbol的序列化
+ * 支持递归序列化，支持循环引用对象的序列化
+ * 考虑到构造函数的特异性，支持自定义构造方式
+ * 自定义构造：
+ * 1、重写getConstructorArguments实例方法，返回需要的构造函数参数数组
+ * 2、重写create静态方法，可获取构造函数、构造对象的所有者（数组对象的所有者不是数组本身，而是上层对象）、对应的所有者的属性名、构造函数的参数（由getConstructorArguments提供）
+ * 循环引用处理：
+ * 1、deserializeObjects用于存储此次已序列化的对象，当出现循环引用时，直接从中获取已反序列化的对象
+ * 2、addReentry、releaseReentry用于确定反序列化入口，releaseReentry过程中reentryCount为0时表示反序列化完成，此时清除deserializeObjects
+ * 自定义序列化：
+ * 1、可遵从规范重写doSerialize、doDeserialize方法
+ * 2、使用@serialize.include定义需序列化的属性
+ */
+export declare const UNIQUE_ID: unique symbol;
+declare const SERIALIZE_CACHE: unique symbol;
+declare const FREEZED_DATA: unique symbol;
+declare const BACKUP_DATA: unique symbol;
+declare const OBSERVABLE_DISPOSER: unique symbol;
+export declare const SERIALIZING: unique symbol;
+export declare const DESERIALIZING: unique symbol;
+export declare const SERIALIZE_DATA: unique symbol;
+export declare const SERIALIZE_CREATE: unique symbol;
+export declare const SERIALIZE_GET_CONSTRUCT_ARGS: unique symbol;
+export type LYCtorInfo = {
+    Construct: new (...args: any) => LYSerializeable;
+    owner: any;
+    property: string;
+};
+export type IChange = IObjectDidChange | IArrayDidChange | IMapDidChange;
+type LYSerializeableObserveEvents = {
+    ['before-serialize'](target: LYSerializeable): void;
+    ['before-deserialize'](target: LYSerializeable): void;
+    ['after-serialize'](target: LYSerializeable): void;
+    ['after-deserialize'](target: LYSerializeable): void;
+    ['property-change'](target: LYSerializeable, property?: string): void;
+};
+export declare class LYSerializeableObserve extends EventEmitter {
+    on: LYEventsWithoutAny<LYSerializeableObserveEvents>['on'];
+    off: LYEventsWithoutAny<LYSerializeableObserveEvents>['on'];
+    once: LYEventsWithoutAny<LYSerializeableObserveEvents>['on'];
+    addListener: LYEventsWithoutAny<LYSerializeableObserveEvents>['on'];
+    removeListener: LYEventsWithoutAny<LYSerializeableObserveEvents>['on'];
+    emit: LYEventsWithoutAny<LYSerializeableObserveEvents>['emit'];
+}
+export declare class LYSerializeable extends LYObject {
+    emit: LYEventsWithoutAny<any>['emit'];
+    protected static [SERIALIZE_CREATE](ctor: LYCtorInfo, ...args: any[]): LYSerializeable;
+    static get observe(): LYSerializeableObserve;
+    static serialize(value: any): any | any[];
+    static deserialize(data: any, owner?: any, property?: string): any | any[];
+    private [UNIQUE_ID];
+    private [SERIALIZING];
+    private [DESERIALIZING];
+    private [SERIALIZE_CACHE];
+    private [BACKUP_DATA];
+    private [FREEZED_DATA];
+    private [OBSERVABLE_DISPOSER];
+    protected [SERIALIZE_DATA]: any;
+    constructor();
+    protected [SERIALIZE_GET_CONSTRUCT_ARGS](): unknown[];
+    get isSerializing(): boolean;
+    get isDeserializing(): any;
+    get freezed(): boolean;
+    set freezed(value: boolean);
+    backup(): void;
+    restore(): void;
+    get serializeCached(): boolean;
+    clearSerializeCache(): void;
+    protected onDataChange(change: IChange, path: string): void;
+    protected onPropertyChange(property?: string): void;
+    protected doSerialize(): any;
+    serialize(): object;
+    protected doDeserialize(data: any): void;
+    deserialize(o: any): void;
+    hasOwnProperty(key: string): any;
+}
+export declare const serialize: {
+    include<T extends LYSerializeable>(target: T, property: string): void;
+};
+export {};

package/dist/permission/index.d.ts

@@ -0,0 +1,9 @@
+import { LYObject } from '../object';
+export type LYAction = 'none' | 'create' | 'read' | 'update' | 'delete' | 'execute';
+export declare class LYAppPermission extends LYObject {
+    private _app_name;
+    private _codes;
+    constructor(app_name: string, codes: Record<string, LYAction[]>);
+    get app_name(): string;
+    getActions(code: string): LYAction[];
+}

package/dist/session/index.d.ts

@@ -0,0 +1,74 @@
+import { LYObject } from '../object';
+import { type LYAction, LYAppPermission } from '../permission';
+type LYSessionType = 'web' | 'direct' | 'gateway' | 'redirect';
+export declare class LYSession extends LYObject {
+    private static _session?;
+    private _type;
+    private _authentication_name;
+    private _id;
+    private _token;
+    private _user_id;
+    private _user_name;
+    private _expires_in;
+    private _permissions;
+    private _created_at;
+    private static _refreshCallback?;
+    private static _refreshTimer?;
+    private static readonly _CHECK_INTERVAL;
+    private _is_first_login;
+    private _display_name;
+    private _email;
+    private _phone;
+    private _country_code;
+    static get(): LYSession | undefined;
+    static create(type: LYSessionType, authentication_name: string, id: string, token: string, user_id: string, user_name: string, expires_in: number, permissions: Record<string, Record<string, LYAction[]>>, is_first_login?: boolean, display_name?: string, email?: string, phone?: string, country_code?: string): LYSession;
+    static clear(): void;
+    constructor(type: LYSessionType, authentication_name: string, id: string, token: string, user_id: string, user_name: string, expires_in: number, permissions: Record<string, Record<string, LYAction[]>>, created_at: number, is_first_login?: boolean, display_name?: string, email?: string, phone?: string, country_code?: string);
+    get type(): LYSessionType;
+    get authentication_name(): string;
+    get id(): string;
+    get token(): string;
+    get user_id(): string;
+    get user_name(): string;
+    get expires_in(): number;
+    get permissions(): Record<string, LYAppPermission>;
+    get created_at(): number;
+    get is_first_login(): boolean | undefined;
+    get display_name(): string;
+    get email(): string;
+    get phone(): string;
+    get country_code(): string;
+    /**
+     * 检查session是否已过期
+     */
+    isExpired(): boolean;
+    /**
+     * 检查session是否即将过期（在过期前15秒）
+     */
+    isNearExpiration(): boolean;
+    /**
+     * 设置刷新回调函数
+     */
+    static setRefreshCallback(callback: (session: LYSession) => Promise<void>): void;
+    /**
+     * 获取有效的session，如果过期则尝试刷新
+     */
+    static getValid(): Promise<LYSession | undefined>;
+    /**
+     * 更新session信息
+     */
+    static update(id: string, token: string, user_id: string, user_name: string, expires_in: number, permissions: Record<string, Record<string, LYAction[]>>, display_name?: string, email?: string, phone?: string, country_code?: string): void;
+    /**
+     * 启动定时器监控session过期
+     */
+    private static _startRefreshTimer;
+    /**
+     * 停止定时器
+     */
+    private static _stopRefreshTimer;
+    /**
+     * 检查并刷新session
+     */
+    private static _checkAndRefreshSession;
+}
+export {};

package/dist/storage/index.d.ts

@@ -0,0 +1,98 @@
+import type { ILYEvents, LYEvents } from '../object';
+import { LYObject } from '../object';
+type LYStorageEvents = {
+    changed(event: {
+        key: string;
+        value: any;
+        isCrossWindow?: boolean;
+    }): void;
+};
+export interface ILYStorage extends ILYEvents<LYStorageEvents> {
+    init(): Promise<void>;
+    flush(): Promise<void>;
+    get<T>(key: string): Promise<T>;
+    set(key: string, value: any): Promise<void>;
+    has(key: string): Promise<boolean>;
+    update(key: string, func: (value: any) => Promise<any>): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    keys(): Promise<string[]>;
+    values(): Promise<any[]>;
+    entries(): Promise<[string, any][]>;
+}
+export interface ILYStorageSync extends ILYEvents<LYStorageEvents> {
+    initSync(): void;
+    flushSync(): void;
+    getSync<T>(key: string): T;
+    setSync(key: string, value: any): void;
+    hasSync(key: string): boolean;
+    updateSync(key: string, func: (value: any) => any): void;
+    removeSync(key: string): void;
+    clearSync(): void;
+    keysSync(): string[];
+    valuesSync(): any[];
+    entriesSync(): [string, any][];
+}
+declare class LYBaseLocalStorage extends LYObject implements ILYStorageSync {
+    on: LYEvents<LYStorageEvents>['on'];
+    off: LYEvents<LYStorageEvents>['on'];
+    once: LYEvents<LYStorageEvents>['on'];
+    emit: LYEvents<LYStorageEvents>['emit'];
+    protected _storage: Storage;
+    protected _prefix: string;
+    constructor(prefix: string, storage: Storage);
+    initSync(): void;
+    flushSync(): void;
+    getSync<T>(key: string): T;
+    setSync(key: string, value: any): void;
+    hasSync(key: string): boolean;
+    /**
+     * 为了更新原子化，譬如我要在原来的基础上+1，如果是先get，在set，而get和set是异步的话，那么get和set中间可能出现对这个值再进行了操作的情况，导致不符合预期
+     */
+    updateSync(key: string, func: (value: any) => any): void;
+    removeSync(key: string): boolean;
+    clearSync(): void;
+    keysSync(): string[];
+    valuesSync(): any[];
+    entriesSync(): [string, any][];
+}
+export declare class LYLocalStorage extends LYBaseLocalStorage implements ILYStorageSync {
+    constructor(prefix: string);
+}
+export declare class LYSessionStorage extends LYBaseLocalStorage implements ILYStorageSync {
+    constructor(prefix: string);
+}
+export interface ILYCloudStorage {
+    setValue(key: string, value: string): Promise<void>;
+    getValue(key: string): Promise<string>;
+    remove(keys: string[]): Promise<void>;
+    clear(prefix?: string): Promise<void>;
+    getAll(): Promise<Record<string, any>>;
+    getKeys(): Promise<string[]>;
+}
+export declare function setCloudStorageImpl(value: ILYCloudStorage): void;
+export declare class LYCloudStorage extends LYObject implements ILYStorage {
+    on: LYEvents<LYStorageEvents>['on'];
+    off: LYEvents<LYStorageEvents>['on'];
+    once: LYEvents<LYStorageEvents>['on'];
+    addListener: LYEvents<LYStorageEvents>['on'];
+    removeListener: LYEvents<LYStorageEvents>['on'];
+    emit: LYEvents<LYStorageEvents>['emit'];
+    protected _prefix: string;
+    constructor(prefix: string);
+    get keyValueImpl(): ILYCloudStorage;
+    init(): Promise<void>;
+    flush(): Promise<void>;
+    get<T>(key: string): Promise<T>;
+    set(key: string, value: any): Promise<void>;
+    has(key: string): Promise<boolean>;
+    update(key: string, func: (value: any) => Promise<any>): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    keys(): Promise<string[]>;
+    values(): Promise<any[]>;
+    entries(): Promise<[string, any][]>;
+}
+export declare const sharedLocalStorage: LYLocalStorage;
+export declare const sharedCloudStorage: LYCloudStorage;
+export {};

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@laiye_packages/uci",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "A comprehensive utility library for frontend applications with HTTP client, storage, i18n, crypto, logger, and OpenTelemetry support",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "watch": "rslib build --watch",
+    "build": "rslib build",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "test": "vitest run src/env/__tests__/env.test.ts"
+  },
+  "keywords": [
+    "utility",
+    "http",
+    "axios",
+    "storage",
+    "i18n",
+    "crypto",
+    "logger",
+    "opentelemetry",
+    "telemetry",
+    "observability",
+    "frontend",
+    "typescript",
+    "web"
+  ],
+  "author": "laiye",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://git.laiye.com/laiye-frontend-repos/uci.git"
+  },
+  "homepage": "https://git.laiye.com/laiye-frontend-repos/uci#readme",
+  "bugs": {
+    "url": "https://git.laiye.com/laiye-frontend-repos/uci/issues"
+  },
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.202.0",
+    "@opentelemetry/instrumentation": "^0.202.0",
+    "@opentelemetry/instrumentation-fetch": "^0.202.0",
+    "@opentelemetry/instrumentation-xml-http-request": "^0.202.0",
+    "@opentelemetry/resources": "^2.0.1",
+    "@opentelemetry/sdk-trace-web": "^2.0.1",
+    "axios": "^1.8.4",
+    "axios-retry": "^4.5.0",
+    "downloadjs": "^1.4.7",
+    "events": "^3.3.0",
+    "gm-crypto": "^0.1.12",
+    "i18next": "^25.0.1",
+    "idb": "^8.0.2",
+    "js-sha256": "^0.11.1",
+    "lodash": "^4.17.21",
+    "qs": "^6.14.0",
+    "sm-crypto": "^0.3.13"
+  },
+  "devDependencies": {
+    "@rslib/core": "^0.13.3",
+    "@types/downloadjs": "^1.4.6",
+    "@types/events": "^3.0.3",
+    "@types/gm": "^1.25.4",
+    "@types/lodash": "^4.17.16",
+    "@types/node": "^22.17.2",
+    "@types/qs": "^6.14.0",
+    "@types/sm-crypto": "^0.3.4",
+    "fake-indexeddb": "^6.0.1",
+    "jsdom": "^26.1.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  }
+}