@heyhru/web-util-ua 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,115 @@
+/**
+ * 浏览器类型枚举
+ */
+export declare enum BrowserType {
+    Chrome = "Chrome",
+    OurTool = "OurTool",
+    Other = "Other"
+}
+/**
+ * 操作系统类型
+ */
+export type OSType = "Windows" | "macOS" | "Linux" | "Android" | "iOS" | "Unknown";
+/**
+ * 存储适配器接口（用于 getMockDeviceId）
+ */
+export interface StorageAdapter {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+}
+/**
+ * 获取模拟设备 ID
+ * @param storageAdapter 可选的存储适配器，默认使用 localStorage
+ * @param storageKey 存储键名，默认为 "mock_device_id"
+ */
+export declare function getMockDeviceId(storageAdapter?: StorageAdapter, storageKey?: string): Promise<string>;
+/**
+ * 获取浏览器语言设置（仅返回语言代码，如 "en"、"zh"）
+ */
+export declare function getLocale(): string;
+/**
+ * 获取完整的语言设置（�� "en-US"、"zh-CN"）
+ */
+export declare function getFullLocale(): string;
+/**
+ * 获取操作系统类型
+ */
+export declare function getOs(): OSType;
+/**
+ * 获取浏览器类型
+ * @param customAppBridge 自定义的 App Bridge 对象名称，默认检查 window.pwaBridge
+ */
+export declare function getBrowserType(customAppBridge?: string): BrowserType;
+/**
+ * 是否在 App 中（检测是否有 App Bridge）
+ * @param customAppBridge 自定义的 App Bridge 对象名称，默认检查 window.pwaBridge
+ */
+export declare function isApp(customAppBridge?: string): boolean;
+/**
+ * 是否为 Chrome 浏览器
+ */
+export declare function isChrome(): boolean;
+/**
+ * 是否为 PC 设备
+ */
+export declare function isPc(): boolean;
+/**
+ * 是否为移动设备
+ */
+export declare function isMobile(): boolean;
+/**
+ * 是否为 iOS 设备
+ */
+export declare function isIOS(): boolean;
+/**
+ * 是否为 Android 设备
+ */
+export declare function isAndroid(): boolean;
+/**
+ * 是否为 Safari 浏览器
+ */
+export declare function isSafari(): boolean;
+/**
+ * 是否为 Firefox 浏览器
+ */
+export declare function isFirefox(): boolean;
+/**
+ * 获取浏览器信息摘要
+ */
+export declare function getBrowserInfo(): {
+    os: OSType;
+    locale: string;
+    fullLocale: string;
+    browserType: BrowserType;
+    isMobile: boolean;
+    isPc: boolean;
+    isApp: boolean;
+    isChrome: boolean;
+    isSafari: boolean;
+    isFirefox: boolean;
+    isIOS: boolean;
+    isAndroid: boolean;
+    userAgent: string;
+};
+/**
+ * 默认导出（兼容原 DeviceUtil 的使用方式）
+ */
+declare const _default: {
+    getMockDeviceId: typeof getMockDeviceId;
+    getLocale: typeof getLocale;
+    getFullLocale: typeof getFullLocale;
+    getOs: typeof getOs;
+    getBrowserType: typeof getBrowserType;
+    isApp: typeof isApp;
+    isChrome: typeof isChrome;
+    isSafari: typeof isSafari;
+    isFirefox: typeof isFirefox;
+    isPc: typeof isPc;
+    isMobile: typeof isMobile;
+    isIOS: typeof isIOS;
+    isAndroid: typeof isAndroid;
+    getBrowserInfo: typeof getBrowserInfo;
+    BrowserType: typeof BrowserType;
+};
+export default _default;
+//# 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;;GAEG;AACH,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAsBD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,cAAc,GAAE,cAAsC,EACtD,UAAU,SAAmB,GAC5B,OAAO,CAAC,MAAM,CAAC,CASjB;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAQlC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAOtC;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAkC9B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,WAAW,CAcpE;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAQvD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAOlC;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAE9B;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAGlC;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAOlC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;GAEG;AACH,wBAAgB,cAAc;;;;;;;;;;;;;;EAgB7B;AAED;;GAEG;;;;;;;;;;;;;;;;;;AACH,wBAgBE"}

package/dist/index.js

@@ -0,0 +1,216 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BrowserType: () => BrowserType,
+  default: () => index_default,
+  getBrowserInfo: () => getBrowserInfo,
+  getBrowserType: () => getBrowserType,
+  getFullLocale: () => getFullLocale,
+  getLocale: () => getLocale,
+  getMockDeviceId: () => getMockDeviceId,
+  getOs: () => getOs,
+  isAndroid: () => isAndroid,
+  isApp: () => isApp,
+  isChrome: () => isChrome,
+  isFirefox: () => isFirefox,
+  isIOS: () => isIOS,
+  isMobile: () => isMobile,
+  isPc: () => isPc,
+  isSafari: () => isSafari
+});
+module.exports = __toCommonJS(index_exports);
+var BrowserType = /* @__PURE__ */ ((BrowserType2) => {
+  BrowserType2["Chrome"] = "Chrome";
+  BrowserType2["OurTool"] = "OurTool";
+  BrowserType2["Other"] = "Other";
+  return BrowserType2;
+})(BrowserType || {});
+var LocalStorageAdapter = class {
+  async get(key) {
+    if (typeof window === "undefined" || !window.localStorage) {
+      return null;
+    }
+    return window.localStorage.getItem(key);
+  }
+  async set(key, value) {
+    if (typeof window !== "undefined" && window.localStorage) {
+      window.localStorage.setItem(key, value);
+    }
+  }
+};
+var defaultStorageAdapter = new LocalStorageAdapter();
+async function getMockDeviceId(storageAdapter = defaultStorageAdapter, storageKey = "mock_device_id") {
+  let mockId = await storageAdapter.get(storageKey);
+  if (mockId) {
+    return mockId;
+  }
+  mockId = `mock-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+  await storageAdapter.set(storageKey, mockId);
+  return mockId;
+}
+function getLocale() {
+  if (typeof window === "undefined" || !window.navigator) {
+    return "en";
+  }
+  const locale = window.navigator.language || window.navigator.userLanguage;
+  return locale.split("-")[0];
+}
+function getFullLocale() {
+  if (typeof window === "undefined" || !window.navigator) {
+    return "en-US";
+  }
+  return window.navigator.language || window.navigator.userLanguage || "en-US";
+}
+function getOs() {
+  if (typeof window === "undefined" || !window.navigator) {
+    return "Unknown";
+  }
+  const userAgent = window.navigator.userAgent;
+  const platform = window.navigator.platform || window.navigator.userAgentData?.platform;
+  let os = "Unknown";
+  if (platform) {
+    if (/Windows/.test(platform)) {
+      os = "Windows";
+    } else if (/Mac/.test(platform)) {
+      os = "macOS";
+    } else if (/Linux arm/.test(platform) && /Android/.test(userAgent)) {
+      os = "Android";
+    } else if (/Linux/.test(platform)) {
+      os = "Linux";
+    } else if (/Android/.test(platform)) {
+      os = "Android";
+    } else if (/iPhone|iPad|iPod/.test(userAgent)) {
+      os = "iOS";
+    }
+  } else {
+    if (/Android/.test(userAgent)) {
+      os = "Android";
+    } else if (/iPhone|iPad|iPod/.test(userAgent)) {
+      os = "iOS";
+    }
+  }
+  return os;
+}
+function getBrowserType(customAppBridge) {
+  if (typeof window === "undefined") {
+    return "Other" /* Other */;
+  }
+  const bridgeName = customAppBridge || "pwaBridge";
+  if (window[bridgeName]) {
+    return "OurTool" /* OurTool */;
+  } else if (isChrome()) {
+    return "Chrome" /* Chrome */;
+  } else {
+    return "Other" /* Other */;
+  }
+}
+function isApp(customAppBridge) {
+  if (typeof window === "undefined") {
+    return false;
+  }
+  const bridgeName = customAppBridge || "pwaBridge";
+  return window[bridgeName] !== void 0 && window[bridgeName] !== null;
+}
+function isChrome() {
+  if (typeof window === "undefined" || !window.navigator) {
+    return false;
+  }
+  return window.chrome && /Chrome/.test(window.navigator.userAgent);
+}
+function isPc() {
+  return !isMobile();
+}
+function isMobile() {
+  const os = getOs();
+  return os === "Android" || os === "iOS";
+}
+function isIOS() {
+  return getOs() === "iOS";
+}
+function isAndroid() {
+  return getOs() === "Android";
+}
+function isSafari() {
+  if (typeof window === "undefined" || !window.navigator) {
+    return false;
+  }
+  const userAgent = window.navigator.userAgent;
+  return /Safari/.test(userAgent) && !/Chrome/.test(userAgent);
+}
+function isFirefox() {
+  if (typeof window === "undefined" || !window.navigator) {
+    return false;
+  }
+  return /Firefox/.test(window.navigator.userAgent);
+}
+function getBrowserInfo() {
+  return {
+    os: getOs(),
+    locale: getLocale(),
+    fullLocale: getFullLocale(),
+    browserType: getBrowserType(),
+    isMobile: isMobile(),
+    isPc: isPc(),
+    isApp: isApp(),
+    isChrome: isChrome(),
+    isSafari: isSafari(),
+    isFirefox: isFirefox(),
+    isIOS: isIOS(),
+    isAndroid: isAndroid(),
+    userAgent: typeof window !== "undefined" ? window.navigator?.userAgent : ""
+  };
+}
+var index_default = {
+  getMockDeviceId,
+  getLocale,
+  getFullLocale,
+  getOs,
+  getBrowserType,
+  isApp,
+  isChrome,
+  isSafari,
+  isFirefox,
+  isPc,
+  isMobile,
+  isIOS,
+  isAndroid,
+  getBrowserInfo,
+  BrowserType
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BrowserType,
+  getBrowserInfo,
+  getBrowserType,
+  getFullLocale,
+  getLocale,
+  getMockDeviceId,
+  getOs,
+  isAndroid,
+  isApp,
+  isChrome,
+  isFirefox,
+  isIOS,
+  isMobile,
+  isPc,
+  isSafari
+});

package/dist/index.mjs

@@ -0,0 +1,177 @@
+// src/index.ts
+var BrowserType = /* @__PURE__ */ ((BrowserType2) => {
+  BrowserType2["Chrome"] = "Chrome";
+  BrowserType2["OurTool"] = "OurTool";
+  BrowserType2["Other"] = "Other";
+  return BrowserType2;
+})(BrowserType || {});
+var LocalStorageAdapter = class {
+  async get(key) {
+    if (typeof window === "undefined" || !window.localStorage) {
+      return null;
+    }
+    return window.localStorage.getItem(key);
+  }
+  async set(key, value) {
+    if (typeof window !== "undefined" && window.localStorage) {
+      window.localStorage.setItem(key, value);
+    }
+  }
+};
+var defaultStorageAdapter = new LocalStorageAdapter();
+async function getMockDeviceId(storageAdapter = defaultStorageAdapter, storageKey = "mock_device_id") {
+  let mockId = await storageAdapter.get(storageKey);
+  if (mockId) {
+    return mockId;
+  }
+  mockId = `mock-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+  await storageAdapter.set(storageKey, mockId);
+  return mockId;
+}
+function getLocale() {
+  if (typeof window === "undefined" || !window.navigator) {
+    return "en";
+  }
+  const locale = window.navigator.language || window.navigator.userLanguage;
+  return locale.split("-")[0];
+}
+function getFullLocale() {
+  if (typeof window === "undefined" || !window.navigator) {
+    return "en-US";
+  }
+  return window.navigator.language || window.navigator.userLanguage || "en-US";
+}
+function getOs() {
+  if (typeof window === "undefined" || !window.navigator) {
+    return "Unknown";
+  }
+  const userAgent = window.navigator.userAgent;
+  const platform = window.navigator.platform || window.navigator.userAgentData?.platform;
+  let os = "Unknown";
+  if (platform) {
+    if (/Windows/.test(platform)) {
+      os = "Windows";
+    } else if (/Mac/.test(platform)) {
+      os = "macOS";
+    } else if (/Linux arm/.test(platform) && /Android/.test(userAgent)) {
+      os = "Android";
+    } else if (/Linux/.test(platform)) {
+      os = "Linux";
+    } else if (/Android/.test(platform)) {
+      os = "Android";
+    } else if (/iPhone|iPad|iPod/.test(userAgent)) {
+      os = "iOS";
+    }
+  } else {
+    if (/Android/.test(userAgent)) {
+      os = "Android";
+    } else if (/iPhone|iPad|iPod/.test(userAgent)) {
+      os = "iOS";
+    }
+  }
+  return os;
+}
+function getBrowserType(customAppBridge) {
+  if (typeof window === "undefined") {
+    return "Other" /* Other */;
+  }
+  const bridgeName = customAppBridge || "pwaBridge";
+  if (window[bridgeName]) {
+    return "OurTool" /* OurTool */;
+  } else if (isChrome()) {
+    return "Chrome" /* Chrome */;
+  } else {
+    return "Other" /* Other */;
+  }
+}
+function isApp(customAppBridge) {
+  if (typeof window === "undefined") {
+    return false;
+  }
+  const bridgeName = customAppBridge || "pwaBridge";
+  return window[bridgeName] !== void 0 && window[bridgeName] !== null;
+}
+function isChrome() {
+  if (typeof window === "undefined" || !window.navigator) {
+    return false;
+  }
+  return window.chrome && /Chrome/.test(window.navigator.userAgent);
+}
+function isPc() {
+  return !isMobile();
+}
+function isMobile() {
+  const os = getOs();
+  return os === "Android" || os === "iOS";
+}
+function isIOS() {
+  return getOs() === "iOS";
+}
+function isAndroid() {
+  return getOs() === "Android";
+}
+function isSafari() {
+  if (typeof window === "undefined" || !window.navigator) {
+    return false;
+  }
+  const userAgent = window.navigator.userAgent;
+  return /Safari/.test(userAgent) && !/Chrome/.test(userAgent);
+}
+function isFirefox() {
+  if (typeof window === "undefined" || !window.navigator) {
+    return false;
+  }
+  return /Firefox/.test(window.navigator.userAgent);
+}
+function getBrowserInfo() {
+  return {
+    os: getOs(),
+    locale: getLocale(),
+    fullLocale: getFullLocale(),
+    browserType: getBrowserType(),
+    isMobile: isMobile(),
+    isPc: isPc(),
+    isApp: isApp(),
+    isChrome: isChrome(),
+    isSafari: isSafari(),
+    isFirefox: isFirefox(),
+    isIOS: isIOS(),
+    isAndroid: isAndroid(),
+    userAgent: typeof window !== "undefined" ? window.navigator?.userAgent : ""
+  };
+}
+var index_default = {
+  getMockDeviceId,
+  getLocale,
+  getFullLocale,
+  getOs,
+  getBrowserType,
+  isApp,
+  isChrome,
+  isSafari,
+  isFirefox,
+  isPc,
+  isMobile,
+  isIOS,
+  isAndroid,
+  getBrowserInfo,
+  BrowserType
+};
+export {
+  BrowserType,
+  index_default as default,
+  getBrowserInfo,
+  getBrowserType,
+  getFullLocale,
+  getLocale,
+  getMockDeviceId,
+  getOs,
+  isAndroid,
+  isApp,
+  isChrome,
+  isFirefox,
+  isIOS,
+  isMobile,
+  isPc,
+  isSafari
+};

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@heyhru/web-util-ua",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.1.1",
+  "description": "User agent detection: device, browser, OS detection for web",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly",
+    "dev": "tsup --watch",
+    "lint1": "eslint src",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2"
+  },
+  "gitHead": "bea932bfa6fd932a7a27a305d74b4b01c2e4ebe3"
+}