@usertour/helpers 0.0.1

package/README.md

@@ -0,0 +1,68 @@
+# @usertour/helpers
+
+Utility functions and helpers shared across the UserTour project.
+
+## Installation
+
+```bash
+npm install @usertour/helpers
+```
+
+## Usage
+
+```typescript
+import { generateId, mergeDeep, formatColor } from '@usertour/helpers';
+
+// Generate unique IDs
+const id = generateId();
+
+// Deep merge objects
+const merged = mergeDeep(obj1, obj2);
+
+// Format colors
+const formattedColor = formatColor('#ff0000');
+```
+
+## Available Utilities
+
+This package provides various utility functions for the UserTour project:
+
+- **ID Generation**: Unique ID generation with cuid2
+- **Object Utilities**: Deep merging, equality checking
+- **Color Utilities**: Color formatting and manipulation with chroma-js
+- **Class Utilities**: Class name merging with clsx and tailwind-merge
+- **Type Utilities**: Type-safe utility functions
+- **Validation**: Input validation helpers
+- **Formatting**: Data formatting utilities
+
+## Dependencies
+
+This package depends on:
+- `@usertour-packages/types` - TypeScript type definitions
+- `fast-deep-equal` - Deep equality checking
+- `chroma-js` - Color manipulation
+- `deepmerge-ts` - Type-safe deep merging
+- `@paralleldrive/cuid2` - Unique ID generation
+- `class-variance-authority` - Class name variants
+- `clsx` - Conditional class names
+- `tailwind-merge` - Tailwind class merging
+- `uuid` - UUID generation
+
+## Development
+
+This package is part of the UserTour monorepo. For development:
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build the package
+pnpm build
+
+# Watch for changes
+pnpm dev
+```
+
+## License
+
+AGPL-3.0 

package/dist/auth.cjs

@@ -0,0 +1,161 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+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);
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+
+// src/auth.ts
+var auth_exports = {};
+__export(auth_exports, {
+  getAuthToken: () => getAuthToken,
+  removeAuthToken: () => removeAuthToken,
+  setAuthToken: () => setAuthToken,
+  storage: () => storage
+});
+module.exports = __toCommonJS(auth_exports);
+
+// src/globals.ts
+var win = typeof window !== "undefined" ? window : void 0;
+var global = typeof globalThis !== "undefined" ? globalThis : win;
+var ArrayProto = Array.prototype;
+var nativeForEach = ArrayProto.forEach;
+var nativeIndexOf = ArrayProto.indexOf;
+var navigator = global == null ? void 0 : global.navigator;
+var document = global == null ? void 0 : global.document;
+var location = global == null ? void 0 : global.location;
+var fetch = global == null ? void 0 : global.fetch;
+var XMLHttpRequest = (global == null ? void 0 : global.XMLHttpRequest) && "withCredentials" in new global.XMLHttpRequest() ? global.XMLHttpRequest : void 0;
+var AbortController = global == null ? void 0 : global.AbortController;
+var userAgent = navigator == null ? void 0 : navigator.userAgent;
+var assignableWindow = win != null ? win : {};
+
+// src/storage.ts
+var AppStorage = class {
+  constructor(prefix, defaultExpire) {
+    __publicField(this, "prefix", "USERTOUR@0.0.1");
+    __publicField(this, "defaultExpire", 5);
+    __publicField(this, "setStorage", (type, key, inputValue, inputExpire = -1) => {
+      var _a, _b;
+      const value = inputValue === "" || inputValue === void 0 ? null : inputValue;
+      const expire = Number.isNaN(inputExpire) ? this.defaultExpire : inputExpire;
+      const data = {
+        value,
+        time: Date.now(),
+        expire
+      };
+      try {
+        const stringifyData = JSON.stringify(data);
+        (_b = (_a = win) == null ? void 0 : _a[type]) == null ? void 0 : _b.setItem(this.autoAddPrefix(key), stringifyData);
+      } catch (e) {
+        console.error(`[APP_STORAGE] setStorage error: ${e}`);
+      }
+    });
+    __publicField(this, "getStorage", (type, key) => {
+      var _a, _b, _c, _d;
+      const prefixKey = this.autoAddPrefix(key);
+      if (!((_b = (_a = win) == null ? void 0 : _a[type]) == null ? void 0 : _b.getItem(prefixKey))) {
+        return void 0;
+      }
+      let storage2 = void 0;
+      try {
+        const stringifyData = (_d = (_c = win) == null ? void 0 : _c[type]) == null ? void 0 : _d.getItem(prefixKey);
+        if (stringifyData === null || stringifyData === void 0) {
+          return void 0;
+        }
+        storage2 = JSON.parse(stringifyData);
+      } catch (e) {
+        console.error(`[APP_STORAGE] getStorage error: ${e}`);
+        return void 0;
+      }
+      const nowTime = Date.now();
+      if (storage2 === void 0) {
+        return void 0;
+      }
+      if (storage2.expire > -1 && storage2.expire * 60 * 1e3 < nowTime - storage2.time) {
+        this.removeStorage(type, key);
+        return void 0;
+      }
+      this.setStorage(type, key, storage2.value, storage2.expire);
+      return storage2.value;
+    });
+    __publicField(this, "clearStorage", (type) => {
+      var _a, _b;
+      (_b = (_a = win) == null ? void 0 : _a[type]) == null ? void 0 : _b.clear();
+    });
+    __publicField(this, "removeStorage", (type, key) => {
+      var _a, _b;
+      (_b = (_a = win) == null ? void 0 : _a[type]) == null ? void 0 : _b.removeItem(this.autoAddPrefix(key));
+    });
+    __publicField(this, "setLocalStorage", (key, value, expire) => {
+      this.setStorage("localStorage", key, value, expire);
+    });
+    __publicField(this, "getLocalStorage", (key) => {
+      return this.getStorage("localStorage", key);
+    });
+    __publicField(this, "clearLocalStorage", () => {
+      this.clearStorage("localStorage");
+    });
+    __publicField(this, "removeLocalStorage", (key) => {
+      this.removeStorage("localStorage", key);
+    });
+    __publicField(this, "setSessionStorage", (key, value, expire) => {
+      this.setStorage("sessionStorage", key, value, expire);
+    });
+    __publicField(this, "getSessionStorage", (key) => {
+      return this.getStorage("sessionStorage", key);
+    });
+    __publicField(this, "clearSessionStorage", () => {
+      this.clearStorage("sessionStorage");
+    });
+    __publicField(this, "removeSessionStorage", (key) => {
+      this.removeStorage("sessionStorage", key);
+    });
+    if (prefix !== void 0) {
+      this.prefix = prefix;
+    }
+    if (defaultExpire !== void 0) {
+      this.defaultExpire = defaultExpire;
+    }
+  }
+  autoAddPrefix(key) {
+    return `${this.prefix}/${key}`;
+  }
+};
+
+// src/auth.ts
+var storage = new AppStorage("USERTOUR@0.0.1", 5);
+var TOKEN_NAME = "token";
+var getAuthToken = () => {
+  return storage.getLocalStorage(TOKEN_NAME);
+};
+var removeAuthToken = () => {
+  return storage.removeLocalStorage(TOKEN_NAME);
+};
+var setAuthToken = (token, expire) => {
+  storage.setLocalStorage(TOKEN_NAME, token, expire);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getAuthToken,
+  removeAuthToken,
+  setAuthToken,
+  storage
+});

package/dist/auth.d.cts

@@ -0,0 +1,8 @@
+import { AppStorage } from './storage.cjs';
+
+declare const storage: AppStorage;
+declare const getAuthToken: () => string;
+declare const removeAuthToken: () => void;
+declare const setAuthToken: (token: string, expire: number) => void;
+
+export { getAuthToken, removeAuthToken, setAuthToken, storage };

package/dist/auth.d.ts

@@ -0,0 +1,8 @@
+import { AppStorage } from './storage.js';
+
+declare const storage: AppStorage;
+declare const getAuthToken: () => string;
+declare const removeAuthToken: () => void;
+declare const setAuthToken: (token: string, expire: number) => void;
+
+export { getAuthToken, removeAuthToken, setAuthToken, storage };

package/dist/auth.js

@@ -0,0 +1,15 @@
+import {
+  getAuthToken,
+  removeAuthToken,
+  setAuthToken,
+  storage
+} from "./chunk-FGFMTWFT.js";
+import "./chunk-3ZGH3NRU.js";
+import "./chunk-H7VA3ML2.js";
+import "./chunk-XEO3YXBM.js";
+export {
+  getAuthToken,
+  removeAuthToken,
+  setAuthToken,
+  storage
+};

package/dist/chunk-2AEGAICC.js

@@ -0,0 +1,13 @@
+// src/utils.ts
+var deepClone = (obj) => {
+  try {
+    return structuredClone(obj);
+  } catch (error) {
+    console.warn("structuredClone failed, falling back to JSON method:", error);
+    return JSON.parse(JSON.stringify(obj));
+  }
+};
+
+export {
+  deepClone
+};

package/dist/chunk-3KG2HTZ3.js

@@ -0,0 +1,79 @@
+// src/helper.ts
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+import { v4 } from "uuid";
+import { createId } from "@paralleldrive/cuid2";
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+var cuid = () => {
+  return createId();
+};
+function formatDate(input) {
+  const date = new Date(input);
+  return date.toLocaleDateString("en-US", {
+    month: "long",
+    day: "numeric",
+    year: "numeric"
+  });
+}
+function absoluteUrl(path) {
+  return `${path}`;
+}
+var uuidV4 = () => {
+  return v4();
+};
+function hexToRgb(hex) {
+  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+  return result ? {
+    r: Number.parseInt(result[1], 16),
+    g: Number.parseInt(result[2], 16),
+    b: Number.parseInt(result[3], 16)
+  } : null;
+}
+var isDark = (hex) => {
+  const rgb = hexToRgb(hex);
+  if (!rgb) {
+    return null;
+  }
+  const { r, g, b } = rgb;
+  if (r * 0.299 + g * 0.587 + b * 0.114 > 186) {
+    return true;
+  }
+  return false;
+};
+var evalCode = (code) => {
+  try {
+    return eval(code);
+  } catch (error) {
+    console.error("Usertour.js: Error evaluating code:", error);
+    return null;
+  }
+};
+var getRandomColor = () => {
+  const colors = [
+    "bg-red-500",
+    "bg-orange-500",
+    "bg-yellow-500",
+    "bg-green-500",
+    "bg-teal-500",
+    "bg-blue-500",
+    "bg-indigo-500",
+    "bg-purple-500",
+    "bg-pink-500",
+    "bg-rose-500"
+  ];
+  return colors[Math.floor(Math.random() * colors.length)];
+};
+
+export {
+  cn,
+  cuid,
+  formatDate,
+  absoluteUrl,
+  uuidV4,
+  hexToRgb,
+  isDark,
+  evalCode,
+  getRandomColor
+};

package/dist/chunk-3ZGH3NRU.js

@@ -0,0 +1,103 @@
+import {
+  win
+} from "./chunk-H7VA3ML2.js";
+import {
+  __publicField
+} from "./chunk-XEO3YXBM.js";
+
+// src/storage.ts
+var AppStorage = class {
+  constructor(prefix, defaultExpire) {
+    __publicField(this, "prefix", "USERTOUR@0.0.1");
+    __publicField(this, "defaultExpire", 5);
+    __publicField(this, "setStorage", (type, key, inputValue, inputExpire = -1) => {
+      var _a, _b;
+      const value = inputValue === "" || inputValue === void 0 ? null : inputValue;
+      const expire = Number.isNaN(inputExpire) ? this.defaultExpire : inputExpire;
+      const data = {
+        value,
+        time: Date.now(),
+        expire
+      };
+      try {
+        const stringifyData = JSON.stringify(data);
+        (_b = (_a = win) == null ? void 0 : _a[type]) == null ? void 0 : _b.setItem(this.autoAddPrefix(key), stringifyData);
+      } catch (e) {
+        console.error(`[APP_STORAGE] setStorage error: ${e}`);
+      }
+    });
+    __publicField(this, "getStorage", (type, key) => {
+      var _a, _b, _c, _d;
+      const prefixKey = this.autoAddPrefix(key);
+      if (!((_b = (_a = win) == null ? void 0 : _a[type]) == null ? void 0 : _b.getItem(prefixKey))) {
+        return void 0;
+      }
+      let storage = void 0;
+      try {
+        const stringifyData = (_d = (_c = win) == null ? void 0 : _c[type]) == null ? void 0 : _d.getItem(prefixKey);
+        if (stringifyData === null || stringifyData === void 0) {
+          return void 0;
+        }
+        storage = JSON.parse(stringifyData);
+      } catch (e) {
+        console.error(`[APP_STORAGE] getStorage error: ${e}`);
+        return void 0;
+      }
+      const nowTime = Date.now();
+      if (storage === void 0) {
+        return void 0;
+      }
+      if (storage.expire > -1 && storage.expire * 60 * 1e3 < nowTime - storage.time) {
+        this.removeStorage(type, key);
+        return void 0;
+      }
+      this.setStorage(type, key, storage.value, storage.expire);
+      return storage.value;
+    });
+    __publicField(this, "clearStorage", (type) => {
+      var _a, _b;
+      (_b = (_a = win) == null ? void 0 : _a[type]) == null ? void 0 : _b.clear();
+    });
+    __publicField(this, "removeStorage", (type, key) => {
+      var _a, _b;
+      (_b = (_a = win) == null ? void 0 : _a[type]) == null ? void 0 : _b.removeItem(this.autoAddPrefix(key));
+    });
+    __publicField(this, "setLocalStorage", (key, value, expire) => {
+      this.setStorage("localStorage", key, value, expire);
+    });
+    __publicField(this, "getLocalStorage", (key) => {
+      return this.getStorage("localStorage", key);
+    });
+    __publicField(this, "clearLocalStorage", () => {
+      this.clearStorage("localStorage");
+    });
+    __publicField(this, "removeLocalStorage", (key) => {
+      this.removeStorage("localStorage", key);
+    });
+    __publicField(this, "setSessionStorage", (key, value, expire) => {
+      this.setStorage("sessionStorage", key, value, expire);
+    });
+    __publicField(this, "getSessionStorage", (key) => {
+      return this.getStorage("sessionStorage", key);
+    });
+    __publicField(this, "clearSessionStorage", () => {
+      this.clearStorage("sessionStorage");
+    });
+    __publicField(this, "removeSessionStorage", (key) => {
+      this.removeStorage("sessionStorage", key);
+    });
+    if (prefix !== void 0) {
+      this.prefix = prefix;
+    }
+    if (defaultExpire !== void 0) {
+      this.defaultExpire = defaultExpire;
+    }
+  }
+  autoAddPrefix(key) {
+    return `${this.prefix}/${key}`;
+  }
+};
+
+export {
+  AppStorage
+};

package/dist/chunk-64BFWPHJ.js

@@ -0,0 +1,50 @@
+// src/content-settings.ts
+import { ContentPriority } from "@usertour/types";
+import { deepmerge } from "deepmerge-ts";
+var rulesSetting = {
+  // frequency: {
+  //   frequency: Frequency.ONCE,
+  //   every: { duration: 0, times: 1, unit: FrequencyUnits.MINUTES },
+  //   atLeast: { duration: 0, unit: FrequencyUnits.MINUTES },
+  // },
+  startIfNotComplete: false,
+  priority: ContentPriority.MEDIUM,
+  wait: 0
+};
+var hideRulesSetting = {};
+var defaultContentConfig = {
+  enabledAutoStartRules: false,
+  enabledHideRules: false,
+  autoStartRules: [],
+  hideRules: [],
+  autoStartRulesSetting: rulesSetting,
+  hideRulesSetting
+};
+var autoStartConditions = {
+  ...defaultContentConfig,
+  enabledAutoStartRules: true,
+  autoStartRules: [
+    {
+      data: { excludes: [], includes: ["/*"] },
+      type: "current-page",
+      operators: "and"
+    }
+  ]
+};
+var buildConfig = (config) => {
+  return {
+    ...defaultContentConfig,
+    ...config,
+    autoStartRulesSetting: deepmerge(
+      defaultContentConfig.autoStartRulesSetting,
+      (config == null ? void 0 : config.autoStartRulesSetting) || {}
+    ),
+    hideRulesSetting: (config == null ? void 0 : config.hideRulesSetting) || {}
+  };
+};
+
+export {
+  defaultContentConfig,
+  autoStartConditions,
+  buildConfig
+};

package/dist/chunk-BBPZYUJR.js

@@ -0,0 +1,28 @@
+// src/content.ts
+var isPublishedInAllEnvironments = (content, environmentList, version) => {
+  const isPublishedInAllEnvironments2 = environmentList == null ? void 0 : environmentList.every(
+    (env) => {
+      var _a;
+      return (_a = content == null ? void 0 : content.contentOnEnvironments) == null ? void 0 : _a.find(
+        (item) => item.published && item.publishedVersionId === (version == null ? void 0 : version.id) && item.environment.id === env.id
+      );
+    }
+  );
+  const isPublishedInOneEnvironment = (content == null ? void 0 : content.published) && (content == null ? void 0 : content.publishedVersionId) === (version == null ? void 0 : version.id) && environmentList && (environmentList == null ? void 0 : environmentList.length) === 1;
+  return (content == null ? void 0 : content.contentOnEnvironments) && (content == null ? void 0 : content.contentOnEnvironments.length) > 0 ? Boolean(isPublishedInAllEnvironments2) : Boolean(isPublishedInOneEnvironment);
+};
+var isPublishedAtLeastOneEnvironment = (content) => {
+  var _a;
+  if ((content == null ? void 0 : content.contentOnEnvironments) && ((_a = content == null ? void 0 : content.contentOnEnvironments) == null ? void 0 : _a.length) > 0) {
+    return true;
+  }
+  if ((content == null ? void 0 : content.published) && (content == null ? void 0 : content.publishedVersionId)) {
+    return true;
+  }
+  return false;
+};
+
+export {
+  isPublishedInAllEnvironments,
+  isPublishedAtLeastOneEnvironment
+};

package/dist/chunk-FGFMTWFT.js

@@ -0,0 +1,23 @@
+import {
+  AppStorage
+} from "./chunk-3ZGH3NRU.js";
+
+// src/auth.ts
+var storage = new AppStorage("USERTOUR@0.0.1", 5);
+var TOKEN_NAME = "token";
+var getAuthToken = () => {
+  return storage.getLocalStorage(TOKEN_NAME);
+};
+var removeAuthToken = () => {
+  return storage.removeLocalStorage(TOKEN_NAME);
+};
+var setAuthToken = (token, expire) => {
+  storage.setLocalStorage(TOKEN_NAME, token, expire);
+};
+
+export {
+  storage,
+  getAuthToken,
+  removeAuthToken,
+  setAuthToken
+};

package/dist/chunk-FNQIIEWK.js

@@ -0,0 +1,121 @@
+// src/condition.ts
+import isEqual from "fast-deep-equal";
+var parseUrl = (url) => {
+  const urlPatterns = url.match(/^(([a-z\d]+):\/\/)?([^/?#]+)?(\/[^?#]*)?(\?([^#]*))?(#.*)?$/i);
+  if (!urlPatterns) {
+    return null;
+  }
+  const [, , scheme = "", domain = "", path = "", , query = "", fragment = ""] = urlPatterns;
+  return { scheme, domain, path, query, fragment };
+};
+var replaceWildcard = (input, s1, s2) => {
+  const withSpecialWords = replaceSpecialWords(input);
+  const withWildcard = withSpecialWords.replace(/\\\*/g, `${s1}*`);
+  if (!s2) {
+    return withWildcard;
+  }
+  return withWildcard.replace(/:[a-z0-9_]+/g, `[^${s2}]+`);
+};
+var replaceSpecialWords = (str) => {
+  return str.replace(/[-/\\^$*+?.()|[\]{}]/g, "\\$&");
+};
+var parsePattern = (pattern) => {
+  if (!pattern || !pattern.trim()) {
+    return null;
+  }
+  const _pattern = parseUrl(pattern);
+  if (!_pattern) {
+    console.error("Invalid URL pattern:", pattern);
+    return null;
+  }
+  const { scheme, domain, path, query, fragment } = _pattern;
+  const _scheme = scheme ? replaceSpecialWords(scheme) : "[a-z\\d]+";
+  const _domain = domain ? replaceWildcard(domain, "[^/]", ".") : "[^/]*";
+  const _fragment = fragment ? replaceWildcard(fragment, ".", "/") : "(#.*)?";
+  const _path = path ? replaceWildcard(path, "[^?#]", "/") : "/[^?#]*";
+  let _query = "(\\?[^#]*)?";
+  if (query) {
+    new URLSearchParams(query).forEach((value, key) => {
+      const _str = value === "" ? "=?" : value === "*" ? "(=[^&#]*)?" : `=${replaceWildcard(value, "[^#]")}`;
+      _query += `(?=.*[?&]${replaceSpecialWords(key)}${_str}([&#]|$))`;
+    });
+    _query += "\\?[^#]*";
+  }
+  return new RegExp(`^${_scheme}://${_domain}(:\\d+)?${_path}${_query}${_fragment}$`);
+};
+var isMatchUrlPattern = (_url, includes, excludes) => {
+  const isMatchIncludesConditions = includes.length > 0 ? includes.some((_include) => {
+    const reg = parsePattern(_include);
+    if (reg) {
+      return reg.test(_url);
+    }
+    return false;
+  }) : true;
+  const isMatchExcludesConditions = excludes.length > 0 ? excludes.some((_exclude) => {
+    const reg = parsePattern(_exclude);
+    if (reg) {
+      return reg.test(_url);
+    }
+    return false;
+  }) : false;
+  return isMatchIncludesConditions && !isMatchExcludesConditions;
+};
+var compareConditionsItem = (item1, item2) => {
+  const { data = {}, ...others1 } = item1;
+  const { data: data2 = {}, ...others2 } = item2;
+  if (!isEqual(others2, others1)) {
+    return false;
+  }
+  for (const key in data) {
+    if (!isEqual(data[key], data2[key])) {
+      return false;
+    }
+  }
+  return true;
+};
+var conditionsIsSame = (rr1, rr2) => {
+  const r1 = [...rr1];
+  const r2 = [...rr2];
+  if (r1.length === 0 && r2.length === 0) {
+    return true;
+  }
+  if (r1.length !== r2.length) {
+    return false;
+  }
+  const group1 = r1.filter((item) => item.type === "group");
+  const group2 = r2.filter((item) => item.type === "group");
+  if (group1.length !== group2.length) {
+    return false;
+  }
+  for (let index = 0; index < r1.length; index++) {
+    const item1 = r1[index];
+    const item2 = r2[index];
+    if (!item1 || !item2) {
+      return false;
+    }
+    if (item1.type === "group") {
+      if (!item2.conditions) {
+        return false;
+      }
+      const c1 = item1.conditions;
+      const c2 = item2.conditions;
+      if (item1.operators !== item2.operators) {
+        return false;
+      }
+      if (!conditionsIsSame(c1, c2)) {
+        return false;
+      }
+    } else {
+      if (!compareConditionsItem(item1, item2)) {
+        return false;
+      }
+    }
+  }
+  return true;
+};
+
+export {
+  isEqual,
+  isMatchUrlPattern,
+  conditionsIsSame
+};