aprog 2.1.3 → 2.1.4

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.4",
   "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/general.js

@@ -98,7 +98,7 @@ const isHtmlElement = (value) => {
     });
 };
 
-export const isEmpty = (variable) => {
+export const isEmpty = (variable): boolean => {
     if (variable === undefined || variable === null) {
         return true;
     }
@@ -1261,7 +1261,7 @@ export const td = (attributes = {}) => {
     return td;
 };
 
-export const img = (attributes = {}) => {
+export const img = (attributes: Record<string, any> = {}): HTMLImageElement => {
     let img = document.createElement("img");
     img.alt = "img...";
     if (attributes) {
@@ -1350,21 +1350,21 @@ export const apFetch = async (url, params = {}) => {
     return [data, error, isLoading];
 };
 
-export const scrollToTop = () => {
+export const scrollToTop = (): void => {
     window.scrollTo({
         top: 0,
         behavior: "smooth",
     });
 };
 
-export const scrollToBottom = () => {
+export const scrollToBottom = (): void => {
     window.scrollTo({
         top: document.documentElement.scrollHeight,
         behavior: "smooth",
     });
 };
 
-export const _get = (name, defaulting = null) => {
+export const _get = (name: string, defaulting: any = null): string|number|null => {
     let url = new URL(window.location.href);
     let searchParams = new URLSearchParams(url.search);
     if (searchParams.has(name)) {
@@ -1375,7 +1375,7 @@ export const _get = (name, defaulting = null) => {
     return defaulting;
 };
 
-export const _getAll = () => {
+export const _getAll = (): Record<string, string> => {
     let url = new URL(window.location.href);
     let searchParams = new URLSearchParams(url.search);
     let params = {};
@@ -1385,7 +1385,7 @@ export const _getAll = () => {
     return params;
 };
 
-export const GUID = () => {
+export const GUID = (): string => {
     return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (char) {
         const random = Math.random() * 16 | 0;
         const value = char === 'x' ? random : (random & 0x3 | 0x8);

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 хвилина
+}): void => {
+    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,13 +1,13 @@
-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) {
+    get(name: string, defaulting: any = null): string|null {
         const cookies = document.cookie.split('; ');
         for (let cookie of cookies) {
             const index = cookie.indexOf('=');
@@ -24,10 +24,10 @@ export const cookie = {
     },
 
     /**
-     * Отримати всі cookie
+     * --- Отримати всі cookie ---
      * @return {{}}
      */
-    getAll() {
+    getAll(): Record<string, string> {
         return document.cookie.split('; ').reduce((acc, cookie) => {
             const [key, ...val] = cookie.split('=');
             acc[key] = decodeURIComponent(val.join('='));
@@ -36,12 +36,12 @@ export const cookie = {
     },
 
     /**
-     * Встановити cookie
+     * --- Встановити cookie ---
      * @param {string} name
      * @param {string} value
      * @param {number} days
      */
-    set(name, value, days = 7) {
+    set(name: string, value: string, days: number = 7): void {
         let expires = "";
         if (days) {
             const date = new Date();
@@ -56,32 +56,112 @@ export const cookie = {
      * Видалити cookie
      * @param {string} name
      */
-    delete(name) {
+    delete(name: string): void {
         document.cookie = `${name}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;`;
     }
 };
 
+/**
+ * --- Локальне сховище ---
+ */
 export const storage = {
-    get(key, defaulting = null) {
-        return JSON.parse(localStorage.getItem(key)) || defaulting;
+    /**
+     * --- Отримати елемент зі сховища ---
+     * @param {string} key
+     * @param {any|null} defaulting
+     * @return {any|null}
+     */
+    get(key: string, defaulting: any = null): any|null {
+        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;
+        }
     },
 
-    set(key, data) {
+    /**
+     * --- Додати елемент у сховище ---
+     * @param {string} key
+     * @param {any} data
+     */
+    set(key: string, data: any): void {
         localStorage.setItem(key, JSON.stringify(data));
     },
 
-    delete(key) {
+    /**
+     * --- Перевірка на існування елемента у сховищі ---
+     * @param {string} key
+     * @return {boolean}
+     */
+    check(key: string): boolean {
+        return !isEmpty(localStorage.getItem(key));
+    },
+
+    /**
+     * --- Видалити елемент зі сховища ---
+     * @param {string} key
+     */
+    delete(key: string): void {
         localStorage.removeItem(key);
     }
 };
 
+/**
+ * --- Сховище сесії ---
+ */
+export const session = {
+    /**
+     * --- Отримати елемент з сесії ---
+     * @param {string} key
+     * @param {any|null} defaulting
+     * @return {any|null}
+     */
+    get(key: string, defaulting: any = null): any|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: string, data: any): void {
+        sessionStorage.setItem(key, JSON.stringify(data));
+    },
+
+    /**
+     * --- Перевірка на існування елемента у сесії ---
+     * @param {string} key
+     * @return {boolean}
+     */
+    check(key: string): boolean {
+        return !isEmpty(sessionStorage.getItem(key));
+    },
+
+    /**
+     * --- Видалити елемент з сесії ---
+     * @param {string} key
+     */
+    delete(key: string): void {
+        sessionStorage.removeItem(key);
+    }
+};
+
 /**
  * --- Ключ для кешу на бекенді ---
  * @param {string} name - вводиться як абревіатура у верхньому регістрі
  * @param {boolean} create
  * @return {string}
  */
-export const cacheKey = (name, create = true) => {
+export const cacheKey = (name: string, create: boolean = true): string => {
     let key = cookie.get(`_key_${name}`);
 
     if (!create) return key;
@@ -90,19 +170,19 @@ 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;
-}
+};
 
 /**
  * --- Функція завантаження файлів ---
  * @param content
  * @param filename
  */
-export const downloadFile = (content, filename = "file.txt") => {
+export const downloadFile = (content: string | Blob | Uint8Array, filename = "file.txt"): void => {
     /** Мапа: розширення -> MIME-тип */
-    const extensionToMime = {
+    const extensionToMime: Record<string, string> = {
         "txt": "text/plain",
         "json": "application/json",
         "xml": "text/xml",
@@ -137,4 +217,4 @@ export const downloadFile = (content, filename = "file.txt") => {
     URL.revokeObjectURL(url);
 
     console.log(`✅ Файл "${filename}" (${mimeType}) завантажено.`);
-}
+};