aprog 2.1.3 → 2.1.5

package/README.md

@@ -173,6 +173,8 @@ node node_modules/aprog/publish.js --force
 
 - *saveItem("id", data), loadItem("id")*
 
+- *uniquePage({key: "default", callbackTrue: () => {"empty"}, callbackFalse: () => {"empty"}, timer: "default")*
+
 ### Info
 
 - Додано безплатний чат із `Gemini`

package/index.js

@@ -11,7 +11,7 @@ export { router, navigateTo, navi } from './src/router.js';
 export { encrypt, decrypt } from './src/shifrator.js';
 export { gemini } from './src/OpenAI.js';
 export { mathInput, autoPPI } from './src/math.js';
-export { cookie, storage, cacheKey, downloadFile } from './src/storage.js';
+export { cookie, storage, session, cacheKey, downloadFile } from './src/storage.js';
 export { paginate, parseData, __paginate, __counter } from './src/paginate.js';
 export { saveItem, loadItem, setSecretKey } from './src/secretStorage.js';
 export {
@@ -21,3 +21,4 @@ export {
     repeatHTMLElementPrototype
 } from './src/html.js';
 export { prism } from "./src/prism.js";
+export { uniquePage } from "./src/pages.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aprog",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "description": "Допоміжна JavaScript-бібліотека для проєктів",
   "main": "index.js",
   "exports": {
@@ -17,7 +17,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/uaproger/aprog-js.git"
+    "url": "git+https://github.com/uaproger/aprog-js.git"
   },
   "keywords": [
     "aprog",
@@ -44,5 +44,8 @@
   },
   "dependencies": {
     "crypto-js": "^4.2.0"
+  },
+  "bin": {
+    "aprog": "bin/cli.js"
   }
 }

package/src/pages.js

@@ -0,0 +1,61 @@
+import {GUID} from "./general.js";
+import {session, storage} from "./storage.js";
+
+export const uniquePage = ({
+    key = "guid",
+    callbackTrue = () => {},
+    callbackFalse = () => {},
+    timer = 60000 // таймер 1 хвилина
+}) => {
+    const setSession = () => {
+        // Якщо немає ні сесії, ні лс, то додаємо
+        if (!session.check(key) && !storage.check(key)) {
+            const id = GUID();
+            session.set(key, id);
+            storage.set(key, id);
+            callbackTrue();
+        }
+
+        setTimeout(() => {
+            console.log("session: ", session.get(key));
+            console.log("local: ", storage.get(key));
+        }, 0);
+    };
+
+    const checkingLocalStorage = () => {
+        // Якщо сесія є, але немає лс, то в лс додаємо значення сесії
+        if (session.check(key) && !storage.check(key)) {
+            storage.set(key, session.get(key));
+        }
+    };
+
+    // Запускаємо сесію
+    setSession();
+    // Запускаємо першу перевірку на наявність лс
+    checkingLocalStorage();
+
+    // Встановлюємо перевірку наявності лс за таймером
+    setInterval(() => {
+        checkingLocalStorage();
+    }, timer);
+
+    // Якщо немає сесії, або сесія не дорівнює лс, то виконуємо callback
+    if (!session.check(key) || session.get(key) !== storage.get(key)) {
+        const isTimer = setInterval(() => {
+            if (!storage.check(key)) {
+                // Попередня вкладка була закрита — перехоплюємо керування
+                setSession();
+                clearInterval(isTimer); // зупиняємо таймер
+            }
+        }, timer);
+
+        setTimeout(callbackFalse, 0);
+    }
+
+    // Якщо вкладка оновлюється, або закривається і сесія дорівнює лс, видаляємо лс
+    window.addEventListener('beforeunload', () => {
+        if (session.get(key) === storage.get(key)) {
+            storage.delete(key);
+        }
+    });
+};

package/src/storage.js

@@ -1,10 +1,10 @@
-import {GUID} from "./general.js";
+import {GUID, isEmpty} from "./general.js";
 
 export const cookie = {
     /**
-     * Отримати значення cookie за ім'ям
+     * --- Отримати значення cookie за ім'ям ---
      * @param {string} name
-     * @param defaulting
+     * @param {any|null} defaulting
      * @returns {string|null}
      */
     get(name, defaulting = null) {
@@ -24,7 +24,7 @@ export const cookie = {
     },
 
     /**
-     * Отримати всі cookie
+     * --- Отримати всі cookie ---
      * @return {{}}
      */
     getAll() {
@@ -36,7 +36,7 @@ export const cookie = {
     },
 
     /**
-     * Встановити cookie
+     * --- Встановити cookie ---
      * @param {string} name
      * @param {string} value
      * @param {number} days
@@ -61,20 +61,100 @@ export const cookie = {
     }
 };
 
+/**
+ * --- Локальне сховище ---
+ */
 export const storage = {
+    /**
+     * --- Отримати елемент зі сховища ---
+     * @param {string} key
+     * @param {any|null} defaulting
+     * @return {any|null}
+     */
     get(key, defaulting = null) {
-        return JSON.parse(localStorage.getItem(key)) || defaulting;
+        try {
+            const item = localStorage.getItem(key);
+            return item ? JSON.parse(item) : defaulting;
+        } catch (e) {
+            console.warn(`storage.get: invalid JSON for key "${key}"`, e);
+            return defaulting;
+        }
     },
 
+    /**
+     * --- Додати елемент у сховище ---
+     * @param {string} key
+     * @param {any} data
+     */
     set(key, data) {
         localStorage.setItem(key, JSON.stringify(data));
     },
 
+    /**
+     * --- Перевірка на існування елемента у сховищі ---
+     * @param {string} key
+     * @return {boolean}
+     */
+    check(key) {
+        return !isEmpty(localStorage.getItem(key));
+    },
+
+    /**
+     * --- Видалити елемент зі сховища ---
+     * @param {string} key
+     */
     delete(key) {
         localStorage.removeItem(key);
     }
 };
 
+/**
+ * --- Сховище сесії ---
+ */
+export const session = {
+    /**
+     * --- Отримати елемент з сесії ---
+     * @param {string} key
+     * @param {any|null} defaulting
+     * @return {any|null}
+     */
+    get(key, defaulting = null) {
+        try {
+            const item = sessionStorage.getItem(key);
+            return item ? JSON.parse(item) : defaulting;
+        } catch (e) {
+            console.warn(`session.get: invalid JSON for key "${key}"`, e);
+            return defaulting;
+        }
+    },
+
+    /**
+     * --- Додати елемент до сесії ---
+     * @param {string} key
+     * @param {any} data
+     */
+    set(key, data) {
+        sessionStorage.setItem(key, JSON.stringify(data));
+    },
+
+    /**
+     * --- Перевірка на існування елемента у сесії ---
+     * @param {string} key
+     * @return {boolean}
+     */
+    check(key) {
+        return !isEmpty(sessionStorage.getItem(key));
+    },
+
+    /**
+     * --- Видалити елемент з сесії ---
+     * @param {string} key
+     */
+    delete(key) {
+        sessionStorage.removeItem(key);
+    }
+};
+
 /**
  * --- Ключ для кешу на бекенді ---
  * @param {string} name - вводиться як абревіатура у верхньому регістрі
@@ -90,10 +170,10 @@ export const cacheKey = (name, create = true) => {
         key = GUID();
         cookie.set(`_key_${name}`, key, 30);
     } else {
-        console.warn("load_by_cache");
+        console.warn("load by cache");
     }
     return key;
-}
+};
 
 /**
  * --- Функція завантаження файлів ---
@@ -137,4 +217,4 @@ export const downloadFile = (content, filename = "file.txt") => {
     URL.revokeObjectURL(url);
 
     console.log(`✅ Файл "${filename}" (${mimeType}) завантажено.`);
-}
+};