@rjgfny/utils 0.1.0

package/README.md

@@ -0,0 +1,83 @@
+# rjgfNY Utils
+
+以 `D:\rjgfCode\rjgfNYUtils` 为根目录的通用工具库，聚焦：
+
+- HTTP 请求封装
+- 浏览器存储封装
+- 权限能力封装
+- 视频/图表/地图领域封装
+- WebSocket 通信封装（重连 + 心跳）
+
+## 安装
+
+```bash
+pnpm install
+```
+
+## 构建
+
+```bash
+pnpm run build
+```
+
+## 测试
+
+```bash
+pnpm run test
+```
+
+## HTTP（axios 适配器）
+
+```ts
+import { createAxiosAdapter, createHttpClient } from "@rjgfny/utils";
+import axios from "axios";
+
+const axiosInstance = axios.create({ baseURL: "/api", timeout: 10000 });
+const adapter = createAxiosAdapter({
+  axiosInstance,
+  requestHooks: [
+    (config) => {
+      config.headers.Authorization = "Bearer token";
+      return config;
+    },
+  ],
+  responseHooks: [
+    (payload: any) => ({ ...payload, hooked: true }),
+  ],
+  business: {
+    successCode: 0,
+    getCode: (res: any) => res.code,
+    getMessage: (res: any) => res.message,
+  },
+});
+
+const http = createHttpClient({}, adapter);
+```
+
+## WebSocket
+
+```ts
+import { createWebSocketClient } from "@rjgfny/utils";
+
+const ws = createWebSocketClient({
+  url: "wss://echo.websocket.events",
+  reconnect: true,
+  heartbeatInterval: 10000,
+});
+ws.onMessage((event) => console.log("ws message:", event.data));
+ws.connect();
+```
+
+## 用法
+
+```ts
+import {
+  createHttpClient,
+  createTokenStorage,
+  createPermissionGuard,
+  createVideoSourceResolver,
+  createChartThemeManager,
+  createMapLayerManager,
+} from "@rjgfny/utils";
+```
+

package/dist/index.cjs

@@ -0,0 +1,373 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  buildEChartsBaseOption: () => buildEChartsBaseOption,
+  createAxiosAdapter: () => createAxiosAdapter,
+  createChartThemeManager: () => createChartThemeManager,
+  createHttpClient: () => createHttpClient,
+  createHttpError: () => createHttpError,
+  createJSONStorage: () => createJSONStorage,
+  createMapLayerManager: () => createMapLayerManager,
+  createPermissionGuard: () => createPermissionGuard,
+  createTokenStorage: () => createTokenStorage,
+  createVideoSourceResolver: () => createVideoSourceResolver,
+  createWebSocketClient: () => createWebSocketClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/http/client.ts
+function buildQuery(params) {
+  if (!params) return "";
+  const query = new URLSearchParams();
+  Object.entries(params).forEach(([key, value]) => {
+    if (value !== void 0 && value !== null) query.append(key, String(value));
+  });
+  const text = query.toString();
+  return text ? `?${text}` : "";
+}
+function createFetchAdapter(config = {}) {
+  return {
+    async request(options) {
+      const { method, url, params, data } = options;
+      const finalUrl = `${config.baseURL ?? ""}${url}${buildQuery(params)}`;
+      const res = await fetch(finalUrl, {
+        method,
+        headers: {
+          "Content-Type": "application/json",
+          ...config.headers ?? {}
+        },
+        body: data === void 0 ? void 0 : JSON.stringify(data)
+      });
+      if (!res.ok) {
+        throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+      }
+      return await res.json();
+    }
+  };
+}
+function createHttpError(message, payload) {
+  const err = new Error(message);
+  err.code = payload?.code;
+  err.status = payload?.status;
+  err.raw = payload?.raw;
+  return err;
+}
+function normalizeBusinessResponse(response, business) {
+  if (!business || !business.getCode) return response;
+  const successCode = business.successCode ?? 0;
+  const code = business.getCode(response);
+  if (code !== void 0 && code !== successCode) {
+    throw createHttpError(
+      business.getMessage?.(response) ?? "Business code is not success",
+      { code, raw: response }
+    );
+  }
+  return response;
+}
+function createHttpClient(config = {}, adapter, business) {
+  const realAdapter = adapter ?? createFetchAdapter(config);
+  return {
+    get: async (url, params) => normalizeBusinessResponse(
+      await realAdapter.request({ method: "GET", url, params }),
+      business
+    ),
+    post: async (url, data) => normalizeBusinessResponse(
+      await realAdapter.request({ method: "POST", url, data }),
+      business
+    ),
+    put: async (url, data) => normalizeBusinessResponse(
+      await realAdapter.request({ method: "PUT", url, data }),
+      business
+    ),
+    delete: async (url) => normalizeBusinessResponse(
+      await realAdapter.request({ method: "DELETE", url }),
+      business
+    )
+  };
+}
+
+// src/http/axios-adapter.ts
+var import_axios = __toESM(require("axios"), 1);
+function createAxiosAdapter(options = {}) {
+  const instance = options.axiosInstance ?? import_axios.default.create(options.axiosConfig ?? {});
+  instance.interceptors.request.use(async (config) => {
+    let next = config;
+    for (const hook of options.requestHooks ?? []) {
+      next = await hook(next);
+    }
+    return next;
+  });
+  instance.interceptors.response.use(
+    (response) => response,
+    async (error) => {
+      for (const hook of options.errorHooks ?? []) {
+        await hook(error);
+      }
+      const status = error.response?.status;
+      const msg = error.message || "Network request failed";
+      return Promise.reject(
+        createHttpError(msg, {
+          status,
+          raw: error.response?.data ?? error
+        })
+      );
+    }
+  );
+  return {
+    async request(requestOptions) {
+      const { method, url, params, data } = requestOptions;
+      const response = await instance.request({
+        method,
+        url,
+        params,
+        data
+      });
+      let payload = options.unwrapData ?? true ? response.data : response;
+      for (const hook of options.responseHooks ?? []) {
+        payload = await hook(
+          payload,
+          response
+        );
+      }
+      if (options.business?.getCode) {
+        const businessPayload = payload;
+        const code = options.business.getCode(businessPayload);
+        const successCode = options.business.successCode ?? 0;
+        if (code !== void 0 && code !== successCode) {
+          throw createHttpError(
+            options.business.getMessage?.(businessPayload) ?? "Business code is not success",
+            { code, raw: businessPayload }
+          );
+        }
+      }
+      return payload;
+    }
+  };
+}
+
+// src/storage/index.ts
+function createTokenStorage(key = "access_token", storage = localStorage) {
+  return {
+    getToken: () => storage.getItem(key),
+    setToken: (token) => storage.setItem(key, token),
+    clearToken: () => storage.removeItem(key)
+  };
+}
+function createJSONStorage(storage = localStorage) {
+  return {
+    set(key, value) {
+      storage.setItem(key, JSON.stringify(value));
+    },
+    get(key) {
+      const raw = storage.getItem(key);
+      if (!raw) return null;
+      try {
+        return JSON.parse(raw);
+      } catch {
+        return null;
+      }
+    },
+    remove(key) {
+      storage.removeItem(key);
+    }
+  };
+}
+
+// src/auth/index.ts
+function createPermissionGuard(state) {
+  return {
+    hasRole(role) {
+      return state.roles.includes(role);
+    },
+    hasPermission(permission) {
+      return state.permissions.includes(permission);
+    },
+    canAny(permissions) {
+      return permissions.some((p) => state.permissions.includes(p));
+    },
+    canAll(permissions) {
+      return permissions.every((p) => state.permissions.includes(p));
+    }
+  };
+}
+
+// src/video/index.ts
+function createVideoSourceResolver() {
+  return {
+    resolve(url) {
+      const lower = url.toLowerCase();
+      if (lower.endsWith(".flv")) return { url, protocol: "flv" };
+      if (lower.endsWith(".m3u8")) return { url, protocol: "hls" };
+      return { url, protocol: "mp4" };
+    }
+  };
+}
+
+// src/chart/index.ts
+function createChartThemeManager(initial = "light") {
+  let current = initial;
+  return {
+    getTheme() {
+      return current;
+    },
+    setTheme(theme) {
+      current = theme;
+    },
+    toggleTheme() {
+      current = current === "light" ? "dark" : "light";
+      return current;
+    }
+  };
+}
+function buildEChartsBaseOption(title) {
+  return {
+    title: { text: title },
+    tooltip: { trigger: "axis" },
+    grid: { left: 12, right: 12, top: 48, bottom: 16, containLabel: true }
+  };
+}
+
+// src/map/index.ts
+function createMapLayerManager(initialLayers = []) {
+  const layers = [...initialLayers];
+  return {
+    list() {
+      return [...layers];
+    },
+    add(layer) {
+      if (layers.some((item) => item.id === layer.id)) return;
+      layers.push(layer);
+    },
+    remove(layerId) {
+      const idx = layers.findIndex((item) => item.id === layerId);
+      if (idx >= 0) layers.splice(idx, 1);
+    },
+    setVisible(layerId, visible) {
+      const target = layers.find((item) => item.id === layerId);
+      if (target) target.visible = visible;
+    }
+  };
+}
+
+// src/websocket/index.ts
+function createWebSocketClient(options) {
+  let ws = null;
+  let reconnectAttempts = 0;
+  let reconnectTimer = null;
+  let heartbeatTimer = null;
+  const onOpenHandlers = [];
+  const onMessageHandlers = [];
+  const onErrorHandlers = [];
+  const onCloseHandlers = [];
+  const clearTimers = () => {
+    if (reconnectTimer) clearTimeout(reconnectTimer);
+    if (heartbeatTimer) clearInterval(heartbeatTimer);
+    reconnectTimer = null;
+    heartbeatTimer = null;
+  };
+  const startHeartbeat = () => {
+    const interval = options.heartbeatInterval ?? 0;
+    if (interval <= 0) return;
+    heartbeatTimer = setInterval(() => {
+      if (ws && ws.readyState === WebSocket.OPEN) {
+        ws.send(options.heartbeatMessage ?? "ping");
+      }
+    }, interval);
+  };
+  const connect = () => {
+    clearTimers();
+    ws = options.createSocket ? options.createSocket(options.url, options.protocols) : new WebSocket(options.url, options.protocols);
+    ws.onopen = () => {
+      reconnectAttempts = 0;
+      startHeartbeat();
+      onOpenHandlers.forEach((fn) => fn());
+    };
+    ws.onmessage = (event) => onMessageHandlers.forEach((fn) => fn(event));
+    ws.onerror = (event) => onErrorHandlers.forEach((fn) => fn(event));
+    ws.onclose = (event) => {
+      clearTimers();
+      onCloseHandlers.forEach((fn) => fn(event));
+      const shouldReconnect = options.reconnect ?? true;
+      const max = options.maxReconnectAttempts ?? 5;
+      if (shouldReconnect && reconnectAttempts < max) {
+        reconnectAttempts += 1;
+        reconnectTimer = setTimeout(
+          connect,
+          options.reconnectInterval ?? 3e3
+        );
+      }
+    };
+  };
+  return {
+    connect,
+    disconnect(code = 1e3, reason = "manual close") {
+      clearTimers();
+      ws?.close(code, reason);
+      ws = null;
+    },
+    send(data) {
+      if (!ws || ws.readyState !== WebSocket.OPEN) {
+        throw new Error("WebSocket is not open");
+      }
+      ws.send(data);
+    },
+    getStatus() {
+      return ws?.readyState ?? WebSocket.CLOSED;
+    },
+    onOpen(handler) {
+      onOpenHandlers.push(handler);
+    },
+    onMessage(handler) {
+      onMessageHandlers.push(handler);
+    },
+    onError(handler) {
+      onErrorHandlers.push(handler);
+    },
+    onClose(handler) {
+      onCloseHandlers.push(handler);
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildEChartsBaseOption,
+  createAxiosAdapter,
+  createChartThemeManager,
+  createHttpClient,
+  createHttpError,
+  createJSONStorage,
+  createMapLayerManager,
+  createPermissionGuard,
+  createTokenStorage,
+  createVideoSourceResolver,
+  createWebSocketClient
+});

package/dist/index.d.cts

@@ -0,0 +1,149 @@
+import { AxiosInstance, AxiosRequestConfig, InternalAxiosRequestConfig, AxiosResponse, AxiosError } from 'axios';
+export { AxiosInstance, AxiosRequestConfig } from 'axios';
+
+interface HttpRequestConfig {
+    baseURL?: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+interface HttpBusinessConfig<T = unknown> {
+    successCode?: number | string;
+    getCode?: (response: T) => number | string | undefined;
+    getMessage?: (response: T) => string | undefined;
+}
+interface HttpError extends Error {
+    code?: number | string;
+    status?: number;
+    raw?: unknown;
+}
+interface HttpClient {
+    get<T = unknown>(url: string, params?: Record<string, unknown>): Promise<T>;
+    post<T = unknown>(url: string, data?: unknown): Promise<T>;
+    put<T = unknown>(url: string, data?: unknown): Promise<T>;
+    delete<T = unknown>(url: string): Promise<T>;
+}
+interface HttpRequestOptions {
+    method: "GET" | "POST" | "PUT" | "DELETE";
+    url: string;
+    params?: Record<string, unknown>;
+    data?: unknown;
+}
+interface HttpAdapter {
+    request<T = unknown>(options: HttpRequestOptions): Promise<T>;
+}
+
+declare function createHttpError(message: string, payload?: {
+    code?: number | string;
+    status?: number;
+    raw?: unknown;
+}): HttpError;
+declare function createHttpClient(config?: HttpRequestConfig, adapter?: HttpAdapter, business?: HttpBusinessConfig): HttpClient;
+
+type AxiosRequestHook = (config: InternalAxiosRequestConfig) => InternalAxiosRequestConfig | Promise<InternalAxiosRequestConfig>;
+type AxiosResponseHook<T = unknown> = (payload: T, response: AxiosResponse<T>) => T | Promise<T>;
+type AxiosErrorHook = (error: AxiosError | Error) => void | Promise<void>;
+interface AxiosAdapterOptions<T = unknown> {
+    axiosInstance?: AxiosInstance;
+    axiosConfig?: AxiosRequestConfig;
+    business?: HttpBusinessConfig<T>;
+    unwrapData?: boolean;
+    requestHooks?: AxiosRequestHook[];
+    responseHooks?: AxiosResponseHook<T>[];
+    errorHooks?: AxiosErrorHook[];
+}
+declare function createAxiosAdapter<T = unknown>(options?: AxiosAdapterOptions<T>): HttpAdapter;
+
+interface StorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+interface TokenStorage {
+    getToken(): string | null;
+    setToken(token: string): void;
+    clearToken(): void;
+}
+declare function createTokenStorage(key?: string, storage?: StorageLike): TokenStorage;
+declare function createJSONStorage(storage?: StorageLike): {
+    set<T>(key: string, value: T): void;
+    get<T>(key: string): T | null;
+    remove(key: string): void;
+};
+
+interface UserPermissionState {
+    roles: string[];
+    permissions: string[];
+}
+declare function createPermissionGuard(state: UserPermissionState): {
+    hasRole(role: string): boolean;
+    hasPermission(permission: string): boolean;
+    canAny(permissions: string[]): boolean;
+    canAll(permissions: string[]): boolean;
+};
+
+type VideoProtocol = "flv" | "hls" | "mp4";
+interface VideoSource {
+    url: string;
+    protocol: VideoProtocol;
+}
+declare function createVideoSourceResolver(): {
+    resolve(url: string): VideoSource;
+};
+
+type ChartTheme = "light" | "dark";
+declare function createChartThemeManager(initial?: ChartTheme): {
+    getTheme(): ChartTheme;
+    setTheme(theme: ChartTheme): void;
+    toggleTheme(): ChartTheme;
+};
+declare function buildEChartsBaseOption(title: string): {
+    title: {
+        text: string;
+    };
+    tooltip: {
+        trigger: string;
+    };
+    grid: {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+        containLabel: boolean;
+    };
+};
+
+interface MapLayer {
+    id: string;
+    type: string;
+    visible?: boolean;
+}
+declare function createMapLayerManager(initialLayers?: MapLayer[]): {
+    list(): MapLayer[];
+    add(layer: MapLayer): void;
+    remove(layerId: string): void;
+    setVisible(layerId: string, visible: boolean): void;
+};
+
+interface WebSocketClientOptions {
+    url: string;
+    protocols?: string | string[];
+    reconnect?: boolean;
+    reconnectInterval?: number;
+    maxReconnectAttempts?: number;
+    heartbeatInterval?: number;
+    heartbeatMessage?: string;
+    createSocket?: (url: string, protocols?: string | string[]) => WebSocket;
+}
+interface WebSocketClient {
+    connect(): void;
+    disconnect(code?: number, reason?: string): void;
+    send(data: string): void;
+    getStatus(): number;
+    onOpen(handler: () => void): void;
+    onMessage(handler: (event: MessageEvent) => void): void;
+    onError(handler: (event: Event) => void): void;
+    onClose(handler: (event: CloseEvent) => void): void;
+}
+declare function createWebSocketClient(options: WebSocketClientOptions): WebSocketClient;
+
+export { type AxiosAdapterOptions, type AxiosErrorHook, type AxiosRequestHook, type AxiosResponseHook, type ChartTheme, type HttpAdapter, type HttpBusinessConfig, type HttpClient, type HttpError, type HttpRequestConfig, type HttpRequestOptions, type MapLayer, type StorageLike, type TokenStorage, type UserPermissionState, type VideoProtocol, type VideoSource, type WebSocketClient, type WebSocketClientOptions, buildEChartsBaseOption, createAxiosAdapter, createChartThemeManager, createHttpClient, createHttpError, createJSONStorage, createMapLayerManager, createPermissionGuard, createTokenStorage, createVideoSourceResolver, createWebSocketClient };

package/dist/index.d.ts

@@ -0,0 +1,149 @@
+import { AxiosInstance, AxiosRequestConfig, InternalAxiosRequestConfig, AxiosResponse, AxiosError } from 'axios';
+export { AxiosInstance, AxiosRequestConfig } from 'axios';
+
+interface HttpRequestConfig {
+    baseURL?: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+interface HttpBusinessConfig<T = unknown> {
+    successCode?: number | string;
+    getCode?: (response: T) => number | string | undefined;
+    getMessage?: (response: T) => string | undefined;
+}
+interface HttpError extends Error {
+    code?: number | string;
+    status?: number;
+    raw?: unknown;
+}
+interface HttpClient {
+    get<T = unknown>(url: string, params?: Record<string, unknown>): Promise<T>;
+    post<T = unknown>(url: string, data?: unknown): Promise<T>;
+    put<T = unknown>(url: string, data?: unknown): Promise<T>;
+    delete<T = unknown>(url: string): Promise<T>;
+}
+interface HttpRequestOptions {
+    method: "GET" | "POST" | "PUT" | "DELETE";
+    url: string;
+    params?: Record<string, unknown>;
+    data?: unknown;
+}
+interface HttpAdapter {
+    request<T = unknown>(options: HttpRequestOptions): Promise<T>;
+}
+
+declare function createHttpError(message: string, payload?: {
+    code?: number | string;
+    status?: number;
+    raw?: unknown;
+}): HttpError;
+declare function createHttpClient(config?: HttpRequestConfig, adapter?: HttpAdapter, business?: HttpBusinessConfig): HttpClient;
+
+type AxiosRequestHook = (config: InternalAxiosRequestConfig) => InternalAxiosRequestConfig | Promise<InternalAxiosRequestConfig>;
+type AxiosResponseHook<T = unknown> = (payload: T, response: AxiosResponse<T>) => T | Promise<T>;
+type AxiosErrorHook = (error: AxiosError | Error) => void | Promise<void>;
+interface AxiosAdapterOptions<T = unknown> {
+    axiosInstance?: AxiosInstance;
+    axiosConfig?: AxiosRequestConfig;
+    business?: HttpBusinessConfig<T>;
+    unwrapData?: boolean;
+    requestHooks?: AxiosRequestHook[];
+    responseHooks?: AxiosResponseHook<T>[];
+    errorHooks?: AxiosErrorHook[];
+}
+declare function createAxiosAdapter<T = unknown>(options?: AxiosAdapterOptions<T>): HttpAdapter;
+
+interface StorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+interface TokenStorage {
+    getToken(): string | null;
+    setToken(token: string): void;
+    clearToken(): void;
+}
+declare function createTokenStorage(key?: string, storage?: StorageLike): TokenStorage;
+declare function createJSONStorage(storage?: StorageLike): {
+    set<T>(key: string, value: T): void;
+    get<T>(key: string): T | null;
+    remove(key: string): void;
+};
+
+interface UserPermissionState {
+    roles: string[];
+    permissions: string[];
+}
+declare function createPermissionGuard(state: UserPermissionState): {
+    hasRole(role: string): boolean;
+    hasPermission(permission: string): boolean;
+    canAny(permissions: string[]): boolean;
+    canAll(permissions: string[]): boolean;
+};
+
+type VideoProtocol = "flv" | "hls" | "mp4";
+interface VideoSource {
+    url: string;
+    protocol: VideoProtocol;
+}
+declare function createVideoSourceResolver(): {
+    resolve(url: string): VideoSource;
+};
+
+type ChartTheme = "light" | "dark";
+declare function createChartThemeManager(initial?: ChartTheme): {
+    getTheme(): ChartTheme;
+    setTheme(theme: ChartTheme): void;
+    toggleTheme(): ChartTheme;
+};
+declare function buildEChartsBaseOption(title: string): {
+    title: {
+        text: string;
+    };
+    tooltip: {
+        trigger: string;
+    };
+    grid: {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+        containLabel: boolean;
+    };
+};
+
+interface MapLayer {
+    id: string;
+    type: string;
+    visible?: boolean;
+}
+declare function createMapLayerManager(initialLayers?: MapLayer[]): {
+    list(): MapLayer[];
+    add(layer: MapLayer): void;
+    remove(layerId: string): void;
+    setVisible(layerId: string, visible: boolean): void;
+};
+
+interface WebSocketClientOptions {
+    url: string;
+    protocols?: string | string[];
+    reconnect?: boolean;
+    reconnectInterval?: number;
+    maxReconnectAttempts?: number;
+    heartbeatInterval?: number;
+    heartbeatMessage?: string;
+    createSocket?: (url: string, protocols?: string | string[]) => WebSocket;
+}
+interface WebSocketClient {
+    connect(): void;
+    disconnect(code?: number, reason?: string): void;
+    send(data: string): void;
+    getStatus(): number;
+    onOpen(handler: () => void): void;
+    onMessage(handler: (event: MessageEvent) => void): void;
+    onError(handler: (event: Event) => void): void;
+    onClose(handler: (event: CloseEvent) => void): void;
+}
+declare function createWebSocketClient(options: WebSocketClientOptions): WebSocketClient;
+
+export { type AxiosAdapterOptions, type AxiosErrorHook, type AxiosRequestHook, type AxiosResponseHook, type ChartTheme, type HttpAdapter, type HttpBusinessConfig, type HttpClient, type HttpError, type HttpRequestConfig, type HttpRequestOptions, type MapLayer, type StorageLike, type TokenStorage, type UserPermissionState, type VideoProtocol, type VideoSource, type WebSocketClient, type WebSocketClientOptions, buildEChartsBaseOption, createAxiosAdapter, createChartThemeManager, createHttpClient, createHttpError, createJSONStorage, createMapLayerManager, createPermissionGuard, createTokenStorage, createVideoSourceResolver, createWebSocketClient };

package/dist/index.js

@@ -0,0 +1,326 @@
+// src/http/client.ts
+function buildQuery(params) {
+  if (!params) return "";
+  const query = new URLSearchParams();
+  Object.entries(params).forEach(([key, value]) => {
+    if (value !== void 0 && value !== null) query.append(key, String(value));
+  });
+  const text = query.toString();
+  return text ? `?${text}` : "";
+}
+function createFetchAdapter(config = {}) {
+  return {
+    async request(options) {
+      const { method, url, params, data } = options;
+      const finalUrl = `${config.baseURL ?? ""}${url}${buildQuery(params)}`;
+      const res = await fetch(finalUrl, {
+        method,
+        headers: {
+          "Content-Type": "application/json",
+          ...config.headers ?? {}
+        },
+        body: data === void 0 ? void 0 : JSON.stringify(data)
+      });
+      if (!res.ok) {
+        throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+      }
+      return await res.json();
+    }
+  };
+}
+function createHttpError(message, payload) {
+  const err = new Error(message);
+  err.code = payload?.code;
+  err.status = payload?.status;
+  err.raw = payload?.raw;
+  return err;
+}
+function normalizeBusinessResponse(response, business) {
+  if (!business || !business.getCode) return response;
+  const successCode = business.successCode ?? 0;
+  const code = business.getCode(response);
+  if (code !== void 0 && code !== successCode) {
+    throw createHttpError(
+      business.getMessage?.(response) ?? "Business code is not success",
+      { code, raw: response }
+    );
+  }
+  return response;
+}
+function createHttpClient(config = {}, adapter, business) {
+  const realAdapter = adapter ?? createFetchAdapter(config);
+  return {
+    get: async (url, params) => normalizeBusinessResponse(
+      await realAdapter.request({ method: "GET", url, params }),
+      business
+    ),
+    post: async (url, data) => normalizeBusinessResponse(
+      await realAdapter.request({ method: "POST", url, data }),
+      business
+    ),
+    put: async (url, data) => normalizeBusinessResponse(
+      await realAdapter.request({ method: "PUT", url, data }),
+      business
+    ),
+    delete: async (url) => normalizeBusinessResponse(
+      await realAdapter.request({ method: "DELETE", url }),
+      business
+    )
+  };
+}
+
+// src/http/axios-adapter.ts
+import axios from "axios";
+function createAxiosAdapter(options = {}) {
+  const instance = options.axiosInstance ?? axios.create(options.axiosConfig ?? {});
+  instance.interceptors.request.use(async (config) => {
+    let next = config;
+    for (const hook of options.requestHooks ?? []) {
+      next = await hook(next);
+    }
+    return next;
+  });
+  instance.interceptors.response.use(
+    (response) => response,
+    async (error) => {
+      for (const hook of options.errorHooks ?? []) {
+        await hook(error);
+      }
+      const status = error.response?.status;
+      const msg = error.message || "Network request failed";
+      return Promise.reject(
+        createHttpError(msg, {
+          status,
+          raw: error.response?.data ?? error
+        })
+      );
+    }
+  );
+  return {
+    async request(requestOptions) {
+      const { method, url, params, data } = requestOptions;
+      const response = await instance.request({
+        method,
+        url,
+        params,
+        data
+      });
+      let payload = options.unwrapData ?? true ? response.data : response;
+      for (const hook of options.responseHooks ?? []) {
+        payload = await hook(
+          payload,
+          response
+        );
+      }
+      if (options.business?.getCode) {
+        const businessPayload = payload;
+        const code = options.business.getCode(businessPayload);
+        const successCode = options.business.successCode ?? 0;
+        if (code !== void 0 && code !== successCode) {
+          throw createHttpError(
+            options.business.getMessage?.(businessPayload) ?? "Business code is not success",
+            { code, raw: businessPayload }
+          );
+        }
+      }
+      return payload;
+    }
+  };
+}
+
+// src/storage/index.ts
+function createTokenStorage(key = "access_token", storage = localStorage) {
+  return {
+    getToken: () => storage.getItem(key),
+    setToken: (token) => storage.setItem(key, token),
+    clearToken: () => storage.removeItem(key)
+  };
+}
+function createJSONStorage(storage = localStorage) {
+  return {
+    set(key, value) {
+      storage.setItem(key, JSON.stringify(value));
+    },
+    get(key) {
+      const raw = storage.getItem(key);
+      if (!raw) return null;
+      try {
+        return JSON.parse(raw);
+      } catch {
+        return null;
+      }
+    },
+    remove(key) {
+      storage.removeItem(key);
+    }
+  };
+}
+
+// src/auth/index.ts
+function createPermissionGuard(state) {
+  return {
+    hasRole(role) {
+      return state.roles.includes(role);
+    },
+    hasPermission(permission) {
+      return state.permissions.includes(permission);
+    },
+    canAny(permissions) {
+      return permissions.some((p) => state.permissions.includes(p));
+    },
+    canAll(permissions) {
+      return permissions.every((p) => state.permissions.includes(p));
+    }
+  };
+}
+
+// src/video/index.ts
+function createVideoSourceResolver() {
+  return {
+    resolve(url) {
+      const lower = url.toLowerCase();
+      if (lower.endsWith(".flv")) return { url, protocol: "flv" };
+      if (lower.endsWith(".m3u8")) return { url, protocol: "hls" };
+      return { url, protocol: "mp4" };
+    }
+  };
+}
+
+// src/chart/index.ts
+function createChartThemeManager(initial = "light") {
+  let current = initial;
+  return {
+    getTheme() {
+      return current;
+    },
+    setTheme(theme) {
+      current = theme;
+    },
+    toggleTheme() {
+      current = current === "light" ? "dark" : "light";
+      return current;
+    }
+  };
+}
+function buildEChartsBaseOption(title) {
+  return {
+    title: { text: title },
+    tooltip: { trigger: "axis" },
+    grid: { left: 12, right: 12, top: 48, bottom: 16, containLabel: true }
+  };
+}
+
+// src/map/index.ts
+function createMapLayerManager(initialLayers = []) {
+  const layers = [...initialLayers];
+  return {
+    list() {
+      return [...layers];
+    },
+    add(layer) {
+      if (layers.some((item) => item.id === layer.id)) return;
+      layers.push(layer);
+    },
+    remove(layerId) {
+      const idx = layers.findIndex((item) => item.id === layerId);
+      if (idx >= 0) layers.splice(idx, 1);
+    },
+    setVisible(layerId, visible) {
+      const target = layers.find((item) => item.id === layerId);
+      if (target) target.visible = visible;
+    }
+  };
+}
+
+// src/websocket/index.ts
+function createWebSocketClient(options) {
+  let ws = null;
+  let reconnectAttempts = 0;
+  let reconnectTimer = null;
+  let heartbeatTimer = null;
+  const onOpenHandlers = [];
+  const onMessageHandlers = [];
+  const onErrorHandlers = [];
+  const onCloseHandlers = [];
+  const clearTimers = () => {
+    if (reconnectTimer) clearTimeout(reconnectTimer);
+    if (heartbeatTimer) clearInterval(heartbeatTimer);
+    reconnectTimer = null;
+    heartbeatTimer = null;
+  };
+  const startHeartbeat = () => {
+    const interval = options.heartbeatInterval ?? 0;
+    if (interval <= 0) return;
+    heartbeatTimer = setInterval(() => {
+      if (ws && ws.readyState === WebSocket.OPEN) {
+        ws.send(options.heartbeatMessage ?? "ping");
+      }
+    }, interval);
+  };
+  const connect = () => {
+    clearTimers();
+    ws = options.createSocket ? options.createSocket(options.url, options.protocols) : new WebSocket(options.url, options.protocols);
+    ws.onopen = () => {
+      reconnectAttempts = 0;
+      startHeartbeat();
+      onOpenHandlers.forEach((fn) => fn());
+    };
+    ws.onmessage = (event) => onMessageHandlers.forEach((fn) => fn(event));
+    ws.onerror = (event) => onErrorHandlers.forEach((fn) => fn(event));
+    ws.onclose = (event) => {
+      clearTimers();
+      onCloseHandlers.forEach((fn) => fn(event));
+      const shouldReconnect = options.reconnect ?? true;
+      const max = options.maxReconnectAttempts ?? 5;
+      if (shouldReconnect && reconnectAttempts < max) {
+        reconnectAttempts += 1;
+        reconnectTimer = setTimeout(
+          connect,
+          options.reconnectInterval ?? 3e3
+        );
+      }
+    };
+  };
+  return {
+    connect,
+    disconnect(code = 1e3, reason = "manual close") {
+      clearTimers();
+      ws?.close(code, reason);
+      ws = null;
+    },
+    send(data) {
+      if (!ws || ws.readyState !== WebSocket.OPEN) {
+        throw new Error("WebSocket is not open");
+      }
+      ws.send(data);
+    },
+    getStatus() {
+      return ws?.readyState ?? WebSocket.CLOSED;
+    },
+    onOpen(handler) {
+      onOpenHandlers.push(handler);
+    },
+    onMessage(handler) {
+      onMessageHandlers.push(handler);
+    },
+    onError(handler) {
+      onErrorHandlers.push(handler);
+    },
+    onClose(handler) {
+      onCloseHandlers.push(handler);
+    }
+  };
+}
+export {
+  buildEChartsBaseOption,
+  createAxiosAdapter,
+  createChartThemeManager,
+  createHttpClient,
+  createHttpError,
+  createJSONStorage,
+  createMapLayerManager,
+  createPermissionGuard,
+  createTokenStorage,
+  createVideoSourceResolver,
+  createWebSocketClient
+};

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@rjgfny/utils",
+  "version": "0.1.0",
+  "description": "rjgfNY 通用工具库（HTTP、存储、权限、视频/图表/地图）",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "pnpm run build && pnpm run test"
+  },
+  "keywords": [
+    "utils",
+    "http",
+    "storage",
+    "auth",
+    "video",
+    "chart",
+    "map"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "tsup": "^8.2.4",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8"
+  },
+  "dependencies": {
+    "axios": "^1.8.2"
+  },
+  "peerDependencies": {
+    "echarts": ">=5.5.0",
+    "video.js": ">=8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "echarts": {
+      "optional": true
+    },
+    "video.js": {
+      "optional": true
+    }
+  }
+}