@alexsab-ru/scripts 0.13.0 → 0.15.0

package/lib/nobounce/nobounce.js

@@ -0,0 +1,336 @@
+import { reachGoal } from '../analytics';
+
+/**
+ * Настройки для NoBounce модуля
+ */
+const defaultOptions = {
+    /**
+     * Задержка в секундах перед отправкой цели NoBounce
+     * @default 15
+     */
+    delay: 15,
+
+    /**
+     * Название цели для отправки в аналитику
+     * @default 'NoBounce'
+     */
+    goalName: 'NoBounce',
+
+    /**
+     * Дополнительные параметры для отправки с целью
+     * @default {}
+     */
+    goalParams: {},
+
+    /**
+     * Автоматически запускать при инициализации
+     * @default true
+     */
+    autoStart: true,
+
+    /**
+     * Отправлять цель только один раз за сессию
+     * @default true
+     */
+    oncePerSession: true,
+
+    /**
+     * Проверять видимость страницы (Page Visibility API)
+     * Если страница скрыта, таймер останавливается
+     * @default true
+     */
+    checkVisibility: true,
+
+    /**
+     * Логировать отправку цели в консоль
+     * @default false
+     */
+    debug: false
+};
+
+/**
+ * Класс для управления NoBounce целью
+ */
+class NoBounceManager {
+    constructor(options = {}) {
+        this.config = { ...defaultOptions, ...options };
+        this.timerId = null;
+        this.isGoalSent = false;
+        this.startTime = Date.now();
+        this.visibilityTime = 0; // Время, проведенное на видимой странице
+        this.lastVisibilityChange = Date.now();
+        
+        // Проверяем сессионное хранилище
+        if (this.config.oncePerSession) {
+            const sessionKey = `nobounce_sent_${this.config.goalName}`;
+            this.isGoalSent = sessionStorage.getItem(sessionKey) === 'true';
+        }
+
+        if (this.config.autoStart && !this.isGoalSent) {
+            this.start();
+        }
+
+        this._bindVisibilityEvents();
+    }
+
+    /**
+     * Запускает таймер для отправки NoBounce цели
+     */
+    start() {
+        if (this.isGoalSent) {
+            if (this.config.debug) {
+                console.log('NoBounce: цель уже была отправлена в этой сессии');
+            }
+            return;
+        }
+
+        if (this.timerId) {
+            this.stop();
+        }
+
+        const delayMs = this.config.delay * 1000;
+
+        if (this.config.debug) {
+            console.log(`NoBounce: запущен таймер на ${this.config.delay} секунд`);
+        }
+
+        this.timerId = setTimeout(() => {
+            this._sendGoal();
+        }, delayMs);
+    }
+
+    /**
+     * Останавливает таймер
+     */
+    stop() {
+        if (this.timerId) {
+            clearTimeout(this.timerId);
+            this.timerId = null;
+            
+            if (this.config.debug) {
+                console.log('NoBounce: таймер остановлен');
+            }
+        }
+    }
+
+    /**
+     * Принудительно отправляет цель NoBounce
+     */
+    sendGoalNow() {
+        this.stop();
+        this._sendGoal();
+    }
+
+    /**
+     * Сбрасывает состояние (для тестирования или повторного использования)
+     */
+    reset() {
+        this.stop();
+        this.isGoalSent = false;
+        this.startTime = Date.now();
+        this.visibilityTime = 0;
+        this.lastVisibilityChange = Date.now();
+        
+        if (this.config.oncePerSession) {
+            const sessionKey = `nobounce_sent_${this.config.goalName}`;
+            sessionStorage.removeItem(sessionKey);
+        }
+    }
+
+    /**
+     * Получает статистику времени на странице
+     */
+    getTimeStats() {
+        const now = Date.now();
+        const totalTime = Math.floor((now - this.startTime) / 1000);
+        const visibleTime = Math.floor((this.visibilityTime + (document.hidden ? 0 : now - this.lastVisibilityChange)) / 1000);
+        
+        return {
+            totalTime,
+            visibleTime,
+            hiddenTime: totalTime - visibleTime,
+            goalSent: this.isGoalSent
+        };
+    }
+
+    /**
+     * Отправляет цель в аналитику
+     * @private
+     */
+    _sendGoal() {
+        if (this.isGoalSent) {
+            return;
+        }
+
+        const stats = this.getTimeStats();
+        const goalParams = {
+            ...this.config.goalParams,
+            timeOnPage: stats.totalTime,
+            visibleTime: stats.visibleTime,
+            timestamp: new Date().toISOString()
+        };
+
+        try {
+            reachGoal(this.config.goalName, goalParams);
+            this.isGoalSent = true;
+
+            // Сохраняем в sessionStorage
+            if (this.config.oncePerSession) {
+                const sessionKey = `nobounce_sent_${this.config.goalName}`;
+                sessionStorage.setItem(sessionKey, 'true');
+            }
+
+            if (this.config.debug) {
+                console.log('NoBounce: цель отправлена', {
+                    goal: this.config.goalName,
+                    params: goalParams,
+                    stats
+                });
+            }
+
+        } catch (error) {
+            console.error('NoBounce: ошибка при отправке цели', error);
+        }
+    }
+
+    /**
+     * Привязывает события видимости страницы
+     * @private
+     */
+    _bindVisibilityEvents() {
+        if (!this.config.checkVisibility || typeof document.hidden === 'undefined') {
+            return;
+        }
+
+        const handleVisibilityChange = () => {
+            const now = Date.now();
+            
+            if (document.hidden) {
+                // Страница скрыта - останавливаем таймер и сохраняем время
+                this.visibilityTime += now - this.lastVisibilityChange;
+                this.stop();
+                
+                if (this.config.debug) {
+                    console.log('NoBounce: страница скрыта, таймер остановлен');
+                }
+            } else {
+                // Страница показана - возобновляем таймер если цель не отправлена
+                this.lastVisibilityChange = now;
+                
+                if (!this.isGoalSent && !this.timerId) {
+                    const remainingTime = Math.max(0, this.config.delay - Math.floor(this.visibilityTime / 1000));
+                    
+                    if (remainingTime > 0) {
+                        if (this.config.debug) {
+                            console.log(`NoBounce: страница показана, возобновляем таймер на ${remainingTime} секунд`);
+                        }
+                        
+                        this.timerId = setTimeout(() => {
+                            this._sendGoal();
+                        }, remainingTime * 1000);
+                    } else {
+                        this._sendGoal();
+                    }
+                }
+            }
+        };
+
+        document.addEventListener('visibilitychange', handleVisibilityChange);
+        
+        // Сохраняем время начала как видимое
+        if (!document.hidden) {
+            this.lastVisibilityChange = this.startTime;
+        }
+    }
+}
+
+// Глобальный экземпляр
+let globalNoBounceManager = null;
+
+/**
+ * Инициализирует NoBounce модуль
+ * @param {Object} options - Настройки модуля
+ * @returns {NoBounceManager} - Экземпляр менеджера
+ */
+export function initNoBounce(options = {}) {
+    if (globalNoBounceManager) {
+        console.warn('NoBounce: модуль уже инициализирован');
+        return globalNoBounceManager;
+    }
+
+    globalNoBounceManager = new NoBounceManager(options);
+    return globalNoBounceManager;
+}
+
+/**
+ * Получает текущий экземпляр NoBounce менеджера
+ * @returns {NoBounceManager|null}
+ */
+export function getNoBounceManager() {
+    return globalNoBounceManager;
+}
+
+/**
+ * Быстрый способ запуска NoBounce с настройками по умолчанию
+ * @param {number} delay - Задержка в секундах (по умолчанию 15)
+ * @param {string} goalName - Название цели (по умолчанию 'NoBounce')
+ */
+export function startNoBounce(delay = 15, goalName = 'NoBounce') {
+    return initNoBounce({
+        delay,
+        goalName,
+        debug: false
+    });
+}
+
+/**
+ * Останавливает текущий NoBounce таймер
+ */
+export function stopNoBounce() {
+    if (globalNoBounceManager) {
+        globalNoBounceManager.stop();
+    }
+}
+
+/**
+ * Принудительно отправляет NoBounce цель
+ */
+export function sendNoBounceNow() {
+    if (globalNoBounceManager) {
+        globalNoBounceManager.sendGoalNow();
+    }
+}
+
+/**
+ * Получает статистику времени на странице
+ */
+export function getNoBounceStats() {
+    if (globalNoBounceManager) {
+        return globalNoBounceManager.getTimeStats();
+    }
+    return null;
+}
+
+/**
+ * Сбрасывает NoBounce состояние
+ */
+export function resetNoBounce() {
+    if (globalNoBounceManager) {
+        globalNoBounceManager.reset();
+    }
+}
+
+// Экспорт класса для продвинутого использования
+export { NoBounceManager };
+
+// Экспорт по умолчанию
+export default {
+    initNoBounce,
+    startNoBounce,
+    stopNoBounce,
+    sendNoBounceNow,
+    getNoBounceStats,
+    resetNoBounce,
+    getNoBounceManager,
+    NoBounceManager
+};

package/lib/nobounce/types.d.ts

@@ -0,0 +1,255 @@
+// TypeScript определения для nobounce модуля
+
+/**
+ * Настройки для NoBounce модуля
+ */
+export interface NoBounceOptions {
+    /**
+     * Задержка в секундах перед отправкой цели NoBounce
+     * @default 15
+     */
+    delay?: number;
+
+    /**
+     * Название цели для отправки в аналитику
+     * @default 'NoBounce'
+     */
+    goalName?: string;
+
+    /**
+     * Дополнительные параметры для отправки с целью
+     * @default {}
+     */
+    goalParams?: Record<string, any>;
+
+    /**
+     * Автоматически запускать при инициализации
+     * @default true
+     */
+    autoStart?: boolean;
+
+    /**
+     * Отправлять цель только один раз за сессию
+     * @default true
+     */
+    oncePerSession?: boolean;
+
+    /**
+     * Проверять видимость страницы (Page Visibility API)
+     * Если страница скрыта, таймер останавливается
+     * @default true
+     */
+    checkVisibility?: boolean;
+
+    /**
+     * Логировать отправку цели в консоль
+     * @default false
+     */
+    debug?: boolean;
+}
+
+/**
+ * Статистика времени проведенного на странице
+ */
+export interface TimeStats {
+    /**
+     * Общее время на странице в секундах
+     */
+    totalTime: number;
+
+    /**
+     * Время когда страница была видима в секундах
+     */
+    visibleTime: number;
+
+    /**
+     * Время когда страница была скрыта в секундах
+     */
+    hiddenTime: number;
+
+    /**
+     * Была ли отправлена цель NoBounce
+     */
+    goalSent: boolean;
+}
+
+/**
+ * Менеджер для управления NoBounce целью
+ */
+export declare class NoBounceManager {
+    /**
+     * Конфигурация менеджера
+     */
+    readonly config: Required<NoBounceOptions>;
+
+    /**
+     * Была ли цель уже отправлена
+     */
+    readonly isGoalSent: boolean;
+
+    /**
+     * Создает новый экземпляр NoBounceManager
+     * @param options - Настройки менеджера
+     */
+    constructor(options?: NoBounceOptions);
+
+    /**
+     * Запускает таймер для отправки NoBounce цели
+     */
+    start(): void;
+
+    /**
+     * Останавливает таймер
+     */
+    stop(): void;
+
+    /**
+     * Принудительно отправляет цель NoBounce
+     */
+    sendGoalNow(): void;
+
+    /**
+     * Сбрасывает состояние (для тестирования или повторного использования)
+     */
+    reset(): void;
+
+    /**
+     * Получает статистику времени на странице
+     */
+    getTimeStats(): TimeStats;
+}
+
+/**
+ * Инициализирует NoBounce модуль
+ * @param options - Настройки модуля
+ * @returns Экземпляр менеджера
+ */
+export function initNoBounce(options?: NoBounceOptions): NoBounceManager;
+
+/**
+ * Получает текущий экземпляр NoBounce менеджера
+ * @returns Экземпляр менеджера или null если не инициализирован
+ */
+export function getNoBounceManager(): NoBounceManager | null;
+
+/**
+ * Быстрый способ запуска NoBounce с настройками по умолчанию
+ * @param delay - Задержка в секундах (по умолчанию 15)
+ * @param goalName - Название цели (по умолчанию 'NoBounce')
+ * @returns Экземпляр менеджера
+ */
+export function startNoBounce(delay?: number, goalName?: string): NoBounceManager;
+
+/**
+ * Останавливает текущий NoBounce таймер
+ */
+export function stopNoBounce(): void;
+
+/**
+ * Принудительно отправляет NoBounce цель
+ */
+export function sendNoBounceNow(): void;
+
+/**
+ * Получает статистику времени на странице
+ * @returns Статистика или null если менеджер не инициализирован
+ */
+export function getNoBounceStats(): TimeStats | null;
+
+/**
+ * Сбрасывает NoBounce состояние
+ */
+export function resetNoBounce(): void;
+
+/**
+ * Объект с экспортированными функциями по умолчанию
+ */
+declare const _default: {
+    initNoBounce: typeof initNoBounce;
+    startNoBounce: typeof startNoBounce;
+    stopNoBounce: typeof stopNoBounce;
+    sendNoBounceNow: typeof sendNoBounceNow;
+    getNoBounceStats: typeof getNoBounceStats;
+    resetNoBounce: typeof resetNoBounce;
+    getNoBounceManager: typeof getNoBounceManager;
+    NoBounceManager: typeof NoBounceManager;
+};
+
+export default _default;
+
+/**
+ * React Hook для использования NoBounce
+ */
+export interface UseNoBounceHook {
+    /**
+     * Менеджер NoBounce
+     */
+    manager: NoBounceManager | null;
+
+    /**
+     * Статистика времени на странице
+     */
+    stats: TimeStats | null;
+
+    /**
+     * Была ли цель отправлена
+     */
+    goalSent: boolean;
+
+    /**
+     * Принудительно отправить цель
+     */
+    sendNow: () => void;
+
+    /**
+     * Остановить таймер
+     */
+    stop: () => void;
+}
+
+/**
+ * Vue композабл для NoBounce
+ */
+export interface VueNoBounceComposable {
+    /**
+     * Реактивный менеджер NoBounce
+     */
+    manager: Ref<NoBounceManager | null>;
+
+    /**
+     * Реактивная статистика
+     */
+    stats: Ref<TimeStats | null>;
+
+    /**
+     * Статус инициализации
+     */
+    isInitialized: Ref<boolean>;
+
+    /**
+     * Функция инициализации с кастомными опциями
+     */
+    init: (options?: NoBounceOptions) => void;
+}
+
+// Расширение глобального объекта Window для отладки
+declare global {
+    interface Window {
+        /**
+         * Отладочные функции NoBounce
+         */
+        noBounceDebug?: {
+            getStats: () => TimeStats | null;
+            sendNow: () => void;
+            stop: () => void;
+            reset: () => void;
+        };
+
+        /**
+         * Флаги для предотвращения повторной отправки целей
+         */
+        oneMinuteSent?: boolean;
+        fiveMinutesSent?: boolean;
+        deepScrollSent?: boolean;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexsab-ru/scripts",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "common libs for websites",
   "main": "index.js",
   "scripts": {
@@ -25,5 +25,24 @@
   "publishConfig": {
     "access": "public"
   },
+  "exports": {
+    ".": "./index.js",
+    "./analytics": "./lib/analytics.js",
+    "./calltouch": "./lib/calltouch.js",
+    "./campaign": "./lib/campaign/index.js",
+    "./campaign/persist": "./lib/campaign/persist-campaign-data.js",
+    "./cookie": "./lib/cookie.js",
+    "./form": "./lib/form.js"
+  },
+  "typesVersions": {
+    "*": {
+      "campaign": [
+        "./lib/campaign/types.d.ts"
+      ],
+      "campaign/persist": [
+        "./lib/campaign/types.d.ts"
+      ]
+    }
+  },
   "homepage": "https://github.com/alexsab-ru/scripts#readme"
 }