@v-tilt/browser 1.6.0 → 1.7.2

package/lib/utils/event-utils.js

@@ -1,305 +0,0 @@
-"use strict";
-/**
- * Event utilities
- * Functions for extracting event properties, campaign parameters, and person info
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.COOKIE_CAMPAIGN_PARAMS = exports.MASKED = exports.EVENT_TO_PERSON_PROPERTIES = exports.CAMPAIGN_PARAMS = exports.PERSONAL_DATA_CAMPAIGN_PARAMS = void 0;
-exports.getCampaignParams = getCampaignParams;
-exports.getSearchInfo = getSearchInfo;
-exports.getBrowserLanguage = getBrowserLanguage;
-exports.getBrowserLanguagePrefix = getBrowserLanguagePrefix;
-exports.getReferrer = getReferrer;
-exports.getReferringDomain = getReferringDomain;
-exports.getReferrerInfo = getReferrerInfo;
-exports.getPersonInfo = getPersonInfo;
-exports.getPersonPropsFromInfo = getPersonPropsFromInfo;
-exports.getInitialPersonPropsFromInfo = getInitialPersonPropsFromInfo;
-exports.getTimezone = getTimezone;
-exports.getTimezoneOffset = getTimezoneOffset;
-exports.getEventProperties = getEventProperties;
-const request_utils_1 = require("./request-utils");
-const index_1 = require("./index");
-const globals_1 = require("./globals");
-const user_agent_utils_1 = require("./user-agent-utils");
-const constants_1 = require("../constants");
-const URL_REGEX_PREFIX = "https?://(.*)";
-// Campaign parameters that could be considered personal data (e.g., GDPR)
-// These can be masked in URLs and properties before being sent
-exports.PERSONAL_DATA_CAMPAIGN_PARAMS = [
-    "gclid", // google ads
-    "gclsrc", // google ads 360
-    "dclid", // google display ads
-    "gbraid", // google ads, web to app
-    "wbraid", // google ads, app to web
-    "fbclid", // facebook
-    "msclkid", // microsoft
-    "twclid", // twitter
-    "li_fat_id", // linkedin
-    "igshid", // instagram
-    "ttclid", // tiktok
-    "rdt_cid", // reddit
-    "epik", // pinterest
-    "qclid", // quora
-    "sccid", // snapchat
-    "irclid", // impact
-    "_kx", // klaviyo
-];
-exports.CAMPAIGN_PARAMS = (0, index_1.extendArray)([
-    "utm_source",
-    "utm_medium",
-    "utm_campaign",
-    "utm_content",
-    "utm_term",
-    "gad_source", // google ads source
-    "mc_cid", // mailchimp campaign id
-], exports.PERSONAL_DATA_CAMPAIGN_PARAMS);
-// Properties that should be automatically copied from events to person properties
-exports.EVENT_TO_PERSON_PROPERTIES = [
-    // Mobile app properties
-    "$app_build",
-    "$app_name",
-    "$app_namespace",
-    "$app_version",
-    // Web browser properties
-    "$browser",
-    "$browser_version",
-    "$device_type",
-    "$current_url",
-    "$pathname",
-    "$os",
-    "$os_name", // Special case: treated as alias of $os
-    "$os_version",
-    "$referring_domain",
-    "$referrer",
-    "$screen_height",
-    "$screen_width",
-    "$viewport_height",
-    "$viewport_width",
-    "$raw_user_agent",
-];
-exports.MASKED = "<masked>";
-// Campaign params that can be read from cookies (currently not implemented)
-exports.COOKIE_CAMPAIGN_PARAMS = [
-    "li_fat_id", // linkedin
-];
-/**
- * Get campaign parameters from URL
- * Extracts UTM and other campaign tracking parameters from current page URL
- * Masks personal data parameters if configured
- */
-function getCampaignParams(customTrackedParams, maskPersonalDataProperties, customPersonalDataProperties) {
-    if (!globals_1.document) {
-        return {};
-    }
-    const paramsToMask = maskPersonalDataProperties
-        ? (0, index_1.extendArray)([], exports.PERSONAL_DATA_CAMPAIGN_PARAMS, customPersonalDataProperties || [])
-        : [];
-    // Initially get campaign params from the URL
-    const urlCampaignParams = _getCampaignParamsFromUrl((0, request_utils_1.maskQueryParams)(globals_1.document.URL, paramsToMask, exports.MASKED), customTrackedParams);
-    // But we can also get some of them from the cookie store
-    // For now, we'll skip cookie-based campaign params (would need cookie store implementation)
-    const cookieCampaignParams = {};
-    // Prefer the values found in the urlCampaignParams if possible
-    // `extend` will override the values if found in the second argument
-    return (0, index_1.extend)(cookieCampaignParams, urlCampaignParams);
-}
-function _getCampaignParamsFromUrl(url, customParams) {
-    const campaign_keywords = exports.CAMPAIGN_PARAMS.concat(customParams || []);
-    const params = {};
-    (0, index_1.each)(campaign_keywords, function (kwkey) {
-        const kw = (0, request_utils_1.getQueryParam)(url, kwkey);
-        params[kwkey] = kw ? kw : null;
-    });
-    return params;
-}
-function _getSearchEngine(referrer) {
-    if (!referrer) {
-        return null;
-    }
-    else {
-        if (referrer.search(URL_REGEX_PREFIX + "google.([^/?]*)") === 0) {
-            return "google";
-        }
-        else if (referrer.search(URL_REGEX_PREFIX + "bing.com") === 0) {
-            return "bing";
-        }
-        else if (referrer.search(URL_REGEX_PREFIX + "yahoo.com") === 0) {
-            return "yahoo";
-        }
-        else if (referrer.search(URL_REGEX_PREFIX + "duckduckgo.com") === 0) {
-            return "duckduckgo";
-        }
-        else {
-            return null;
-        }
-    }
-}
-function _getSearchInfoFromReferrer(referrer) {
-    const search = _getSearchEngine(referrer);
-    const param = search !== "yahoo" ? "q" : "p";
-    const ret = {};
-    if (!(0, index_1.isNull)(search)) {
-        ret["$search_engine"] = search;
-        const keyword = globals_1.document ? (0, request_utils_1.getQueryParam)(globals_1.document.referrer, param) : "";
-        if (keyword.length) {
-            ret["ph_keyword"] = keyword;
-        }
-    }
-    return ret;
-}
-function getSearchInfo() {
-    const referrer = globals_1.document === null || globals_1.document === void 0 ? void 0 : globals_1.document.referrer;
-    if (!referrer) {
-        return {};
-    }
-    return _getSearchInfoFromReferrer(referrer);
-}
-function getBrowserLanguage() {
-    if (typeof navigator === "undefined") {
-        return undefined;
-    }
-    return (navigator.language || // Any modern browser
-        navigator.userLanguage // IE11
-    );
-}
-function getBrowserLanguagePrefix() {
-    const lang = getBrowserLanguage();
-    return typeof lang === "string" ? lang.split("-")[0] : undefined;
-}
-function getReferrer() {
-    return (globals_1.document === null || globals_1.document === void 0 ? void 0 : globals_1.document.referrer) || "$direct";
-}
-function getReferringDomain() {
-    var _a;
-    if (!(globals_1.document === null || globals_1.document === void 0 ? void 0 : globals_1.document.referrer)) {
-        return "$direct";
-    }
-    return ((_a = (0, request_utils_1.convertToURL)(globals_1.document.referrer)) === null || _a === void 0 ? void 0 : _a.host) || "$direct";
-}
-/**
- * Get referrer information
- * Returns current referrer and referring domain
- */
-function getReferrerInfo() {
-    return {
-        $referrer: getReferrer(),
-        $referring_domain: getReferringDomain(),
-    };
-}
-/**
- * Get person info for initial storage
- * Extracts referrer and URL info, masks personal data if configured
- * Returns compact format (r: referrer, u: url) for storage efficiency
- */
-function getPersonInfo(maskPersonalDataProperties, customPersonalDataProperties) {
-    const paramsToMask = maskPersonalDataProperties
-        ? (0, index_1.extendArray)([], exports.PERSONAL_DATA_CAMPAIGN_PARAMS, customPersonalDataProperties || [])
-        : [];
-    const url = globals_1.location === null || globals_1.location === void 0 ? void 0 : globals_1.location.href.substring(0, 1000);
-    // Compact format for storage efficiency (stored in localStorage)
-    return {
-        r: getReferrer().substring(0, 1000),
-        u: url ? (0, request_utils_1.maskQueryParams)(url, paramsToMask, exports.MASKED) : undefined,
-    };
-}
-/**
- * Convert person info to person properties
- * Extracts referrer, URL, campaign params, and search info from stored person info
- */
-function getPersonPropsFromInfo(info) {
-    var _a;
-    const { r: referrer, u: url } = info;
-    const referring_domain = referrer == null
-        ? undefined
-        : referrer === "$direct"
-            ? "$direct"
-            : (_a = (0, request_utils_1.convertToURL)(referrer)) === null || _a === void 0 ? void 0 : _a.host;
-    const props = {
-        $referrer: referrer,
-        $referring_domain: referring_domain,
-    };
-    if (url) {
-        props["$current_url"] = url;
-        const location = (0, request_utils_1.convertToURL)(url);
-        props["$host"] = location === null || location === void 0 ? void 0 : location.host;
-        props["$pathname"] = location === null || location === void 0 ? void 0 : location.pathname;
-        const campaignParams = _getCampaignParamsFromUrl(url);
-        (0, index_1.extend)(props, campaignParams);
-    }
-    if (referrer) {
-        const searchInfo = _getSearchInfoFromReferrer(referrer);
-        (0, index_1.extend)(props, searchInfo);
-    }
-    return props;
-}
-/**
- * Convert person info to initial person properties
- * Generates $initial_* properties from person info (preserves first values)
- */
-function getInitialPersonPropsFromInfo(info) {
-    const personProps = getPersonPropsFromInfo(info);
-    const props = {};
-    (0, index_1.each)(personProps, function (val, key) {
-        props[`$initial_${(0, index_1.stripLeadingDollar)(String(key))}`] = val;
-    });
-    return props;
-}
-function getTimezone() {
-    try {
-        return Intl.DateTimeFormat().resolvedOptions().timeZone;
-    }
-    catch (_a) {
-        return undefined;
-    }
-}
-function getTimezoneOffset() {
-    try {
-        return new Date().getTimezoneOffset();
-    }
-    catch (_a) {
-        return undefined;
-    }
-}
-/**
- * Get event properties that should be added to all events
- * Returns all event context properties (browser, device, URL, etc.) plus event metadata
- * Note: Only properties in EVENT_TO_PERSON_PROPERTIES are copied to person properties
- */
-function getEventProperties(maskPersonalDataProperties, customPersonalDataProperties) {
-    if (!globals_1.userAgent) {
-        return {};
-    }
-    const paramsToMask = maskPersonalDataProperties
-        ? (0, index_1.extendArray)([], exports.PERSONAL_DATA_CAMPAIGN_PARAMS, customPersonalDataProperties || [])
-        : [];
-    const [os_name, os_version] = (0, user_agent_utils_1.detectOS)(globals_1.userAgent);
-    return (0, index_1.extend)((0, index_1.stripEmptyProperties)({
-        $os: os_name,
-        $os_version: os_version,
-        $browser: (0, user_agent_utils_1.detectBrowser)(globals_1.userAgent, navigator.vendor),
-        $device: (0, user_agent_utils_1.detectDevice)(globals_1.userAgent),
-        $device_type: (0, user_agent_utils_1.detectDeviceType)(globals_1.userAgent),
-        $timezone: getTimezone(),
-        $timezone_offset: getTimezoneOffset(),
-    }), {
-        $current_url: (0, request_utils_1.maskQueryParams)(globals_1.location === null || globals_1.location === void 0 ? void 0 : globals_1.location.href, paramsToMask, exports.MASKED),
-        $host: globals_1.location === null || globals_1.location === void 0 ? void 0 : globals_1.location.host,
-        $pathname: globals_1.location === null || globals_1.location === void 0 ? void 0 : globals_1.location.pathname,
-        $raw_user_agent: globals_1.userAgent.length > 1000
-            ? globals_1.userAgent.substring(0, 997) + "..."
-            : globals_1.userAgent,
-        $browser_version: (0, user_agent_utils_1.detectBrowserVersion)(globals_1.userAgent, navigator.vendor),
-        $browser_language: getBrowserLanguage(),
-        $browser_language_prefix: getBrowserLanguagePrefix(),
-        $screen_height: globals_1.window === null || globals_1.window === void 0 ? void 0 : globals_1.window.screen.height,
-        $screen_width: globals_1.window === null || globals_1.window === void 0 ? void 0 : globals_1.window.screen.width,
-        $viewport_height: globals_1.window === null || globals_1.window === void 0 ? void 0 : globals_1.window.innerHeight,
-        $viewport_width: globals_1.window === null || globals_1.window === void 0 ? void 0 : globals_1.window.innerWidth,
-        $lib: "web",
-        $lib_version: constants_1.SDK_VERSION,
-        $insert_id: Math.random().toString(36).substring(2, 10) +
-            Math.random().toString(36).substring(2, 10),
-        $time: Date.now() / 1000, // epoch time in seconds
-    });
-}

package/lib/utils/globals.d.ts

@@ -1,235 +0,0 @@
-declare const win: (Window & typeof globalThis) | undefined;
-/**
- * Extension kinds that can be lazy loaded
- */
-export type VTiltExtensionKind = "recorder" | "web-vitals" | "chat";
-/**
- * Interface for lazy-loaded session recording (set by recorder.ts)
- * Matches LazyLoadedSessionRecordingInterface in session-recording-wrapper.ts
- */
-export interface LazyLoadedSessionRecordingInterface {
-    start: (startReason?: string) => void;
-    stop: () => void;
-    sessionId: string;
-    status: string;
-    isStarted: boolean;
-    onRemoteConfig?: (response: any) => void;
-    log: (message: string, level: "log" | "warn" | "error") => void;
-    updateConfig: (config: any) => void;
-}
-/**
- * Web Vitals metric callback type
- */
-export type WebVitalsMetricCallback = (metric: any) => void;
-/**
- * Options for web vitals callbacks
- */
-export interface WebVitalsCallbackOptions {
-    /** Report all changes (useful for CLS which updates over time) */
-    reportAllChanges?: boolean;
-}
-/**
- * Web Vitals callback function type (with optional options)
- */
-export type WebVitalsCallbackFn = (callback: WebVitalsMetricCallback, options?: WebVitalsCallbackOptions) => void;
-/**
- * Web Vitals callbacks interface (set by web-vitals.ts entrypoint)
- */
-export interface WebVitalsCallbacks {
-    onLCP: WebVitalsCallbackFn;
-    onCLS: WebVitalsCallbackFn;
-    onFCP: WebVitalsCallbackFn;
-    onINP: WebVitalsCallbackFn;
-    onTTFB?: WebVitalsCallbackFn;
-}
-/**
- * Chat message structure (matches PostgreSQL chat_messages table)
- * Note: Read status is determined by cursor comparison, not per-message
- */
-export interface ChatMessage {
-    id: string;
-    channel_id: string;
-    sender_type: "user" | "agent" | "ai" | "system";
-    sender_id: string | null;
-    sender_name: string | null;
-    sender_avatar_url: string | null;
-    content: string;
-    content_type: "text" | "html" | "attachment";
-    metadata: Record<string, unknown>;
-    created_at: string;
-}
-/**
- * Chat channel structure (maps 1:1 to Ably channel)
- */
-export interface ChatChannel {
-    id: string;
-    project_id: string;
-    person_id: string;
-    distinct_id: string;
-    status: "open" | "closed" | "snoozed";
-    ai_mode: boolean;
-    unread_count: number;
-    last_message_at: string | null;
-    last_message_preview: string | null;
-    last_message_sender: "user" | "agent" | "ai" | "system" | null;
-    user_last_read_at: string | null;
-    agent_last_read_at: string | null;
-    created_at: string;
-}
-/**
- * Lightweight channel summary for channel list view
- * Used to avoid loading full channel data until user selects one
- */
-export interface ChatChannelSummary {
-    id: string;
-    status: "open" | "closed" | "snoozed";
-    ai_mode: boolean;
-    last_message_at: string | null;
-    last_message_preview: string | null;
-    last_message_sender: "user" | "agent" | "ai" | "system" | null;
-    unread_count: number;
-    user_last_read_at: string | null;
-    created_at: string;
-}
-/**
- * Widget view state - determines what UI to show
- */
-export type ChatWidgetView = "list" | "conversation";
-/**
- * Chat widget configuration
- *
- * Settings can come from two sources:
- * 1. Dashboard (fetched from /api/chat/settings) - "snippet-only" mode
- * 2. Code config (passed to vt.init) - overrides dashboard settings
- *
- * This enables Intercom-like flexibility: just add snippet OR customize with code.
- */
-export interface ChatConfig {
-    /**
-     * Enable/disable chat widget.
-     * - undefined: Use dashboard setting (auto-fetch)
-     * - true: Enable (override dashboard)
-     * - false: Disable entirely
-     */
-    enabled?: boolean;
-    /**
-     * Auto-fetch settings from dashboard (default: true)
-     * When true, SDK fetches /api/chat/settings and uses those as base config.
-     * Code config always overrides fetched settings.
-     */
-    autoConfig?: boolean;
-    /** Widget position (default: 'bottom-right') */
-    position?: "bottom-right" | "bottom-left";
-    /** Widget header/greeting message */
-    greeting?: string;
-    /** Widget primary color */
-    color?: string;
-    /** Start in AI mode (default: true) */
-    aiMode?: boolean;
-    /** AI greeting message (first message from AI) */
-    aiGreeting?: string;
-    /** Preload widget script on idle vs on-demand */
-    preload?: boolean;
-    /** Custom theme */
-    theme?: ChatTheme;
-    /** Offline message shown when business is unavailable */
-    offlineMessage?: string;
-    /** Collect email when offline */
-    collectEmailOffline?: boolean;
-}
-/**
- * Chat theme customization
- */
-export interface ChatTheme {
-    primaryColor?: string;
-    fontFamily?: string;
-    borderRadius?: string;
-    headerBgColor?: string;
-    userBubbleColor?: string;
-    agentBubbleColor?: string;
-}
-/**
- * Interface for lazy-loaded chat widget (set by chat.ts entrypoint)
- */
-export interface LazyLoadedChatInterface {
-    readonly isOpen: boolean;
-    readonly isConnected: boolean;
-    readonly isLoading: boolean;
-    readonly unreadCount: number;
-    readonly channel: ChatChannel | null;
-    readonly channels: ChatChannelSummary[];
-    readonly currentView: ChatWidgetView;
-    open(): void;
-    close(): void;
-    toggle(): void;
-    show(): void;
-    hide(): void;
-    /** Fetch/refresh the list of user's channels */
-    getChannels(): Promise<void>;
-    /** Select a channel and load its messages */
-    selectChannel(channelId: string): Promise<void>;
-    /** Create a new channel and enter it */
-    createChannel(): Promise<void>;
-    /** Go back to channel list from conversation view */
-    goToChannelList(): void;
-    sendMessage(content: string): Promise<void>;
-    markAsRead(): void;
-    onMessage(callback: (message: ChatMessage) => void): () => void;
-    onTyping(callback: (isTyping: boolean, senderType: string) => void): () => void;
-    onConnectionChange(callback: (connected: boolean) => void): () => void;
-    destroy(): void;
-}
-/**
- * VTilt Extensions interface for dynamically loaded modules
- * This is the contract between lazily loaded extensions and the SDK
- */
-export interface VTiltExtensions {
-    /** Load an external dependency script */
-    loadExternalDependency?: (instance: any, // VTilt instance - using any to avoid circular imports
-    kind: VTiltExtensionKind, callback: (error?: string | Event, event?: Event) => void) => void;
-    /** rrweb record function (set by recorder.ts) */
-    rrweb?: {
-        record: any;
-        version?: string;
-    };
-    /** rrweb plugins (set by recorder.ts) */
-    rrwebPlugins?: {
-        getRecordConsolePlugin?: () => any;
-        getRecordNetworkPlugin?: (options: any) => any;
-    };
-    /** Factory to create LazyLoadedSessionRecording (set by recorder.ts) */
-    initSessionRecording?: (instance: any, config?: any) => LazyLoadedSessionRecordingInterface;
-    /** Web Vitals callbacks (set by web-vitals.ts entrypoint) */
-    webVitalsCallbacks?: WebVitalsCallbacks;
-    /** Factory to create LazyLoadedChat (set by chat.ts entrypoint) */
-    initChat?: (instance: any, config?: ChatConfig) => LazyLoadedChatInterface;
-}
-export type AssignableWindow = Window & typeof globalThis & {
-    /** Main VTilt instance */
-    vt: any;
-    /** VTilt Extensions for dynamically loaded modules */
-    __VTiltExtensions__?: VTiltExtensions;
-};
-export declare const ArrayProto: any[];
-export declare const nativeForEach: (callbackfn: (value: any, index: number, array: any[]) => void, thisArg?: any) => void;
-export declare const nativeIndexOf: (searchElement: any, fromIndex?: number) => number;
-export declare const navigator: Navigator | undefined;
-export declare const document: Document | undefined;
-export declare const location: Location | undefined;
-export declare const fetch: typeof globalThis.fetch | undefined;
-export declare const XMLHttpRequest: {
-    new (): XMLHttpRequest;
-    prototype: XMLHttpRequest;
-    readonly UNSENT: 0;
-    readonly OPENED: 1;
-    readonly HEADERS_RECEIVED: 2;
-    readonly LOADING: 3;
-    readonly DONE: 4;
-} | undefined;
-export declare const AbortController: {
-    new (): AbortController;
-    prototype: AbortController;
-} | undefined;
-export declare const userAgent: string | undefined;
-export declare const assignableWindow: AssignableWindow;
-export { win as window };

package/lib/utils/globals.js

@@ -1,30 +0,0 @@
-"use strict";
-/*
- * Global helpers to protect access to browser globals in a way that is safer for different targets
- * like DOM, SSR, Web workers etc.
- *
- * NOTE: Typically we want the "window" but globalThis works for both the typical browser context as
- * well as other contexts such as the web worker context. Window is still exported for any bits that explicitly require it.
- * If in doubt - export the global you need from this file and use that as an optional value. This way the code path is forced
- * to handle the case where the global is not available.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.window = exports.assignableWindow = exports.userAgent = exports.AbortController = exports.XMLHttpRequest = exports.fetch = exports.location = exports.document = exports.navigator = exports.nativeIndexOf = exports.nativeForEach = exports.ArrayProto = void 0;
-// Note: We use 'any' for VTilt to avoid circular imports
-// The actual type checking happens in the external-scripts-loader.ts
-const win = typeof window !== "undefined" ? window : undefined;
-exports.window = win;
-const global = typeof globalThis !== "undefined" ? globalThis : win;
-exports.ArrayProto = Array.prototype;
-exports.nativeForEach = exports.ArrayProto.forEach;
-exports.nativeIndexOf = exports.ArrayProto.indexOf;
-exports.navigator = global === null || global === void 0 ? void 0 : global.navigator;
-exports.document = global === null || global === void 0 ? void 0 : global.document;
-exports.location = global === null || global === void 0 ? void 0 : global.location;
-exports.fetch = global === null || global === void 0 ? void 0 : global.fetch;
-exports.XMLHttpRequest = (global === null || global === void 0 ? void 0 : global.XMLHttpRequest) && "withCredentials" in new global.XMLHttpRequest()
-    ? global.XMLHttpRequest
-    : undefined;
-exports.AbortController = global === null || global === void 0 ? void 0 : global.AbortController;
-exports.userAgent = exports.navigator === null || exports.navigator === void 0 ? void 0 : exports.navigator.userAgent;
-exports.assignableWindow = win !== null && win !== void 0 ? win : {};

package/lib/utils/index.d.ts

@@ -1,46 +0,0 @@
-/**
- * Generate uuid to identify the session. Random, not data-derived
- */
-export declare function uuidv4(): string;
-/**
- * Validate user agent string
- */
-export declare function isValidUserAgent(userAgent: string): boolean;
-/**
- * Validate payload string
- */
-export declare function isValidPayload(payloadStr: string): boolean;
-/**
- * Check if current environment is a test environment
- */
-export declare function isTestEnvironment(): boolean;
-/**
- * Iterate over an array or object
- */
-export declare function each<T>(obj: T[] | Record<string, T> | null | undefined, iterator: (value: T, key: string | number) => void, thisArg?: any): void;
-/**
- * Use this instead of element.addEventListener to avoid eslint errors
- * This properly implements the default options for passive event listeners
- */
-export declare function addEventListener(element: Window | Document | Element | undefined, event: string, callback: EventListener, options?: AddEventListenerOptions): void;
-/**
- * Extend object with properties from another object
- */
-export declare function extend<T extends Record<string, any>>(target: T, source: Record<string, any> | null | undefined): T;
-/**
- * Extend array with additional items
- * Mutates the base array and returns it (matches PostHog's behavior)
- */
-export declare function extendArray<T>(base: T[], ...additional: T[][]): T[];
-/**
- * Strip properties with empty values (null, undefined, empty string)
- */
-export declare function stripEmptyProperties<T extends Record<string, any>>(obj: T): Partial<T>;
-/**
- * Strip leading dollar sign from string
- */
-export declare function stripLeadingDollar(str: string): string;
-/**
- * Check if value is null
- */
-export declare function isNull(value: any): boolean;