@notix-hub/sdk 0.2.0 → 0.3.0

package/README.md

@@ -7,7 +7,7 @@ JavaScript SDK для **Notix (Нотикс)** — сервиса агрегац
 ### npm
 
 ```bash
-npm install @notix/sdk
+npm install @notix-hub/sdk
 ```
 
 ```js
@@ -34,7 +34,7 @@ await notix.notify({
 Без своего домена — через jsdelivr:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/@notix/sdk/dist/notify.min.js" data-token="ntx_..."></script>
+<script src="https://cdn.jsdelivr.net/npm/@notix-hub/sdk/dist/notify.min.js" data-token="ntx_..."></script>
 ```
 
 ## API

package/dist/errors.d.ts

@@ -0,0 +1,18 @@
+interface ErrorEntry {
+    message: string;
+    file: string;
+    line: number;
+    col: number;
+    stack: string;
+    ts: string;
+}
+export declare class ErrorBatcher {
+    private sendFn;
+    private errors;
+    private timer;
+    constructor(sendFn: (errors: ErrorEntry[]) => void);
+    private bindGlobal;
+    private startTimer;
+    flush(): void;
+}
+export {};

package/dist/index.cjs

@@ -224,6 +224,68 @@ class MetrikaTracker {
     }
 }
 
+const BATCH_SIZE = 10;
+const FLUSH_INTERVAL = 60000;
+class ErrorBatcher {
+    constructor(sendFn) {
+        this.sendFn = sendFn;
+        this.errors = [];
+        this.timer = null;
+        this.bindGlobal();
+    }
+    bindGlobal() {
+        if (typeof window === 'undefined')
+            return;
+        const collect = (ev) => {
+            this.errors.push({
+                message: ev.message || 'Unknown error',
+                file: ev.filename || '',
+                line: ev.lineno || 0,
+                col: ev.colno || 0,
+                stack: ev.error?.stack || '',
+                ts: new Date().toISOString(),
+            });
+            if (this.errors.length >= BATCH_SIZE)
+                this.flush();
+            this.startTimer();
+        };
+        window.addEventListener('error', collect);
+        window.addEventListener('unhandledrejection', (ev) => {
+            this.errors.push({
+                message: ev.reason?.message || String(ev.reason),
+                file: '',
+                line: 0,
+                col: 0,
+                stack: ev.reason?.stack || '',
+                ts: new Date().toISOString(),
+            });
+            if (this.errors.length >= BATCH_SIZE)
+                this.flush();
+            this.startTimer();
+        });
+        window.addEventListener('beforeunload', () => this.flush());
+        document.addEventListener('visibilitychange', () => {
+            if (document.visibilityState === 'hidden')
+                this.flush();
+        });
+    }
+    startTimer() {
+        if (this.timer)
+            return;
+        this.timer = setTimeout(() => this.flush(), FLUSH_INTERVAL);
+    }
+    flush() {
+        if (this.errors.length === 0)
+            return;
+        this.sendFn([...this.errors]);
+        this.errors = [];
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+}
+
 const DEFAULT_ENDPOINT = 'https://notix-hub.ru/api/v1/webhook';
 class Notix {
     constructor(config) {
@@ -239,6 +301,7 @@ class Notix {
         if (config.autoCapture !== false) {
             this.capture();
         }
+        this.trackErrors();
     }
     async notify(payload) {
         if (!payload.title) {
@@ -274,12 +337,57 @@ class Notix {
         this.captureActive = false;
         this.log('Notix destroyed');
     }
+    sendPageview(page, referrer) {
+        const visitorId = getOrCreateVisitorId();
+        const payload = {
+            title: 'Посетитель на сайте',
+            type: 'metric',
+            payload: {
+                event_type: 'pageview',
+                visitor_id: visitorId,
+                page: page || location.pathname,
+                referrer: referrer || document.referrer || undefined,
+                value: 1,
+            },
+        };
+        this.notify(payload).catch(() => { });
+        this.log('Pageview sent:', page || location.pathname);
+    }
+    trackErrors() {
+        if (typeof window === 'undefined')
+            return;
+        new ErrorBatcher((errors) => {
+            this.notify({
+                title: `Ошибки на странице (${errors.length})`,
+                type: 'error_batch',
+                payload: { errors },
+            }).catch(() => { });
+        });
+        this.log('Error tracking activated');
+    }
+    static getVisitorId() {
+        return getOrCreateVisitorId();
+    }
     log(...args) {
         if (this.debug) {
             console.log('[Notix]', ...args);
         }
     }
 }
+const VISITOR_KEY = 'notix_vid';
+function getOrCreateVisitorId() {
+    try {
+        let vid = localStorage.getItem(VISITOR_KEY);
+        if (!vid) {
+            vid = crypto.randomUUID();
+            localStorage.setItem(VISITOR_KEY, vid);
+        }
+        return vid;
+    }
+    catch {
+        return 'unknown';
+    }
+}
 
 if (typeof document !== 'undefined') {
     const thisScript = document.currentScript;

package/dist/index.mjs

@@ -222,6 +222,68 @@ class MetrikaTracker {
     }
 }
 
+const BATCH_SIZE = 10;
+const FLUSH_INTERVAL = 60000;
+class ErrorBatcher {
+    constructor(sendFn) {
+        this.sendFn = sendFn;
+        this.errors = [];
+        this.timer = null;
+        this.bindGlobal();
+    }
+    bindGlobal() {
+        if (typeof window === 'undefined')
+            return;
+        const collect = (ev) => {
+            this.errors.push({
+                message: ev.message || 'Unknown error',
+                file: ev.filename || '',
+                line: ev.lineno || 0,
+                col: ev.colno || 0,
+                stack: ev.error?.stack || '',
+                ts: new Date().toISOString(),
+            });
+            if (this.errors.length >= BATCH_SIZE)
+                this.flush();
+            this.startTimer();
+        };
+        window.addEventListener('error', collect);
+        window.addEventListener('unhandledrejection', (ev) => {
+            this.errors.push({
+                message: ev.reason?.message || String(ev.reason),
+                file: '',
+                line: 0,
+                col: 0,
+                stack: ev.reason?.stack || '',
+                ts: new Date().toISOString(),
+            });
+            if (this.errors.length >= BATCH_SIZE)
+                this.flush();
+            this.startTimer();
+        });
+        window.addEventListener('beforeunload', () => this.flush());
+        document.addEventListener('visibilitychange', () => {
+            if (document.visibilityState === 'hidden')
+                this.flush();
+        });
+    }
+    startTimer() {
+        if (this.timer)
+            return;
+        this.timer = setTimeout(() => this.flush(), FLUSH_INTERVAL);
+    }
+    flush() {
+        if (this.errors.length === 0)
+            return;
+        this.sendFn([...this.errors]);
+        this.errors = [];
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+}
+
 const DEFAULT_ENDPOINT = 'https://notix-hub.ru/api/v1/webhook';
 class Notix {
     constructor(config) {
@@ -237,6 +299,7 @@ class Notix {
         if (config.autoCapture !== false) {
             this.capture();
         }
+        this.trackErrors();
     }
     async notify(payload) {
         if (!payload.title) {
@@ -272,12 +335,57 @@ class Notix {
         this.captureActive = false;
         this.log('Notix destroyed');
     }
+    sendPageview(page, referrer) {
+        const visitorId = getOrCreateVisitorId();
+        const payload = {
+            title: 'Посетитель на сайте',
+            type: 'metric',
+            payload: {
+                event_type: 'pageview',
+                visitor_id: visitorId,
+                page: page || location.pathname,
+                referrer: referrer || document.referrer || undefined,
+                value: 1,
+            },
+        };
+        this.notify(payload).catch(() => { });
+        this.log('Pageview sent:', page || location.pathname);
+    }
+    trackErrors() {
+        if (typeof window === 'undefined')
+            return;
+        new ErrorBatcher((errors) => {
+            this.notify({
+                title: `Ошибки на странице (${errors.length})`,
+                type: 'error_batch',
+                payload: { errors },
+            }).catch(() => { });
+        });
+        this.log('Error tracking activated');
+    }
+    static getVisitorId() {
+        return getOrCreateVisitorId();
+    }
     log(...args) {
         if (this.debug) {
             console.log('[Notix]', ...args);
         }
     }
 }
+const VISITOR_KEY = 'notix_vid';
+function getOrCreateVisitorId() {
+    try {
+        let vid = localStorage.getItem(VISITOR_KEY);
+        if (!vid) {
+            vid = crypto.randomUUID();
+            localStorage.setItem(VISITOR_KEY, vid);
+        }
+        return vid;
+    }
+    catch {
+        return 'unknown';
+    }
+}
 
 if (typeof document !== 'undefined') {
     const thisScript = document.currentScript;

package/dist/notify.min.js

@@ -3,4 +3,4 @@
  * @version <%= pkg.version %>
  * @license MIT
  */
-var Notix=function(t){"use strict";function e(t,e,o,i=1e4){const n={title:o.title,...void 0!==o.body&&{body:o.body},...void 0!==o.type&&{notification_type:o.type},...void 0!==o.priority&&{priority:o.priority},...void 0!==o.tag&&{tag:o.tag},...void 0!==o.payload&&{payload:o.payload}},r=new AbortController,a=setTimeout(()=>r.abort(),i);return"undefined"!=typeof fetch?fetch(t,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json",Accept:"application/json"},body:JSON.stringify(n),signal:r.signal}).then(async t=>{clearTimeout(a);const e=await t.json();if(!t.ok)throw new Error(e.error||e.message||`HTTP ${t.status}`);return e}).catch(t=>{throw clearTimeout(a),t}):function(t,e,o,i){return new Promise((n,r)=>{const a=new XMLHttpRequest;a.open("POST",t,!0),a.setRequestHeader("Authorization",`Bearer ${e}`),a.setRequestHeader("Content-Type","application/json"),a.setRequestHeader("Accept","application/json"),a.timeout=i,a.onload=()=>{try{const t=JSON.parse(a.responseText);a.status>=200&&a.status<300?n(t):r(new Error(t.error||t.message||`HTTP ${a.status}`))}catch{r(new Error("Invalid response"))}},a.onerror=()=>r(new Error("Network error")),a.ontimeout=()=>r(new Error("Request timeout")),a.send(JSON.stringify(o))})}(t,e,n,i)}const o=new WeakMap;function i(t,e,i){e.querySelectorAll("form[data-notify]").forEach(e=>{e.dataset.notixBound||(e.dataset.notixBound="1",e.addEventListener("submit",n=>{const r=Date.now();if(r-(o.get(e)??0)<500)n.preventDefault();else{o.set(e,r);try{const o=function(t){const e=t.dataset.notifyTitle??t.dataset.notify_title??document.title,o=t.dataset.notifyType??t.dataset.notify_type,i=t.dataset.notifyTag??t.dataset.notify_tag,n=t.dataset.notifyPriority??t.dataset.notify_priority,r=t.dataset.notifyBody??t.dataset.notify_body,a=t.dataset.notifyTemplate??t.dataset.notify_template,s=(t.dataset.notifyFields??t.dataset.notify_fields)?.split(",").map(t=>t.trim()).filter(Boolean);if(r)return{title:e,body:r,...o&&{type:o},...i&&{tag:i},...n&&{priority:n}};const d=t.querySelectorAll("input[name], textarea[name], select[name]"),c=new Map;let u;d.forEach(t=>{if(!t.name)return;if(("checkbox"===t.type||"radio"===t.type)&&!t.checked)return;if(s&&!s.includes(t.name))return;const e=t.hasAttribute("data-notify-field");if(s||e||!s&&!a){const e=t.getAttribute("data-notify-label")??t.name;c.set(e,t.value||"")}}),a?u=a.replace(/\{(\w+)\}/g,(e,o)=>{if(c.has(o))return c.get(o);const i=t.elements.namedItem(o);return i?.value||`{${o}}`}):c.size>0&&(u=Array.from(c,([t,e])=>`${t}: ${e}`).join("\n"));return{title:e,...u&&{body:u},...o&&{type:o},...i&&{tag:i},...n&&{priority:n}}}(e);i&&console.log("[Notix] Form captured:",o.title),t(o,{title:o.title,fieldsCount:Object.keys(e.elements).length})}catch(t){i&&console.warn("[Notix] Form capture failed:",t)}}}))})}function n(t){if(!1===t?.enabled)return null;const e="undefined"!=typeof window&&"function"==typeof window.ym;if(!e&&!t?.enabled)return null;let o=t?.counterId;return!o&&e&&(o=function(){for(const t of Object.keys(window))if(t.startsWith("yaCounter")){const e=parseInt(t.replace("yaCounter",""),10);if(!isNaN(e))return e}return}()),o?new r(o,t?.prefix??"notix"):null}class r{constructor(t,e){this.counterId=t,this.prefix=e}trackSent(t){this.reachGoal(`${this.prefix}_sent`,{id:t.id,message:t.message})}trackError(t){this.reachGoal(`${this.prefix}_error`,{error:t.message})}trackFormCaptured(t,e){this.reachGoal(`${this.prefix}_form_captured`,{title:t,fields:e})}trackGoal(t){this.reachGoal(t,{})}reachGoal(t,e){"function"==typeof window.ym&&window.ym(this.counterId,"reachGoal",t,e)}}class a{constructor(t){if(this.captureActive=!1,!t.token||!t.token.startsWith("ntx_"))throw new Error('Notix: token must start with "ntx_"');this.token=t.token,this.endpoint=t.endpoint??"https://notix-hub.ru/api/v1/webhook",this.timeout=t.timeout??1e4,this.debug=t.debug??!1,this.metrika=n(t.metrika),!1!==t.autoCapture&&this.capture()}async notify(t){if(!t.title)throw new Error("Notix: title is required");this.log("Sending notification:",t.title);try{const o=await e(this.endpoint,this.token,t,this.timeout);return this.log("Notification sent:",o.id),this.metrika?.trackSent(o),o}catch(t){const e=t instanceof Error?t:new Error(String(t));throw this.log("Error sending notification:",e.message),this.metrika?.trackError(e),e}}capture(t=document){this.captureActive||(i((t,e)=>{this.notify(t).then(()=>{this.metrika?.trackFormCaptured(e.title??t.title,e.fieldsCount)}).catch(()=>{})},t,this.debug),this.captureActive=!0,this.log("Form capture activated"))}destroy(){document.querySelectorAll("form[data-notix-bound]").forEach(t=>{delete t.dataset.notixBound}),this.captureActive=!1,this.log("Notix destroyed")}log(...t){this.debug&&console.log("[Notix]",...t)}}if("undefined"!=typeof document){const t=document.currentScript;if(t){const e=t.dataset.token;if(e){const o=t.dataset.endpoint,i="false"!==t.dataset.autoCapture,n="true"===t.dataset.debug,r=t.dataset.timeout?parseInt(t.dataset.timeout,10):void 0,s=()=>{const t=new a({token:e,...o&&{endpoint:o},autoCapture:i,debug:n,...r&&{timeout:r}});window.notix=t};"loading"!==document.readyState?s():document.addEventListener("DOMContentLoaded",s)}else"true"===t.dataset.debug&&console.warn("[Notix] data-token attribute is required on script tag")}}return t.Notix=a,t}({});
+var Notix=function(t){"use strict";function e(t,e,i,r=1e4){const o={title:i.title,...void 0!==i.body&&{body:i.body},...void 0!==i.type&&{notification_type:i.type},...void 0!==i.priority&&{priority:i.priority},...void 0!==i.tag&&{tag:i.tag},...void 0!==i.payload&&{payload:i.payload}},n=new AbortController,a=setTimeout(()=>n.abort(),r);return"undefined"!=typeof fetch?fetch(t,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json",Accept:"application/json"},body:JSON.stringify(o),signal:n.signal}).then(async t=>{clearTimeout(a);const e=await t.json();if(!t.ok)throw new Error(e.error||e.message||`HTTP ${t.status}`);return e}).catch(t=>{throw clearTimeout(a),t}):function(t,e,i,r){return new Promise((o,n)=>{const a=new XMLHttpRequest;a.open("POST",t,!0),a.setRequestHeader("Authorization",`Bearer ${e}`),a.setRequestHeader("Content-Type","application/json"),a.setRequestHeader("Accept","application/json"),a.timeout=r,a.onload=()=>{try{const t=JSON.parse(a.responseText);a.status>=200&&a.status<300?o(t):n(new Error(t.error||t.message||`HTTP ${a.status}`))}catch{n(new Error("Invalid response"))}},a.onerror=()=>n(new Error("Network error")),a.ontimeout=()=>n(new Error("Request timeout")),a.send(JSON.stringify(i))})}(t,e,o,r)}const i=new WeakMap;function r(t,e,r){e.querySelectorAll("form[data-notify]").forEach(e=>{e.dataset.notixBound||(e.dataset.notixBound="1",e.addEventListener("submit",o=>{const n=Date.now();if(n-(i.get(e)??0)<500)o.preventDefault();else{i.set(e,n);try{const i=function(t){const e=t.dataset.notifyTitle??t.dataset.notify_title??document.title,i=t.dataset.notifyType??t.dataset.notify_type,r=t.dataset.notifyTag??t.dataset.notify_tag,o=t.dataset.notifyPriority??t.dataset.notify_priority,n=t.dataset.notifyBody??t.dataset.notify_body,a=t.dataset.notifyTemplate??t.dataset.notify_template,s=(t.dataset.notifyFields??t.dataset.notify_fields)?.split(",").map(t=>t.trim()).filter(Boolean);if(n)return{title:e,body:n,...i&&{type:i},...r&&{tag:r},...o&&{priority:o}};const d=t.querySelectorAll("input[name], textarea[name], select[name]"),c=new Map;let u;d.forEach(t=>{if(!t.name)return;if(("checkbox"===t.type||"radio"===t.type)&&!t.checked)return;if(s&&!s.includes(t.name))return;const e=t.hasAttribute("data-notify-field");if(s||e||!s&&!a){const e=t.getAttribute("data-notify-label")??t.name;c.set(e,t.value||"")}}),a?u=a.replace(/\{(\w+)\}/g,(e,i)=>{if(c.has(i))return c.get(i);const r=t.elements.namedItem(i);return r?.value||`{${i}}`}):c.size>0&&(u=Array.from(c,([t,e])=>`${t}: ${e}`).join("\n"));return{title:e,...u&&{body:u},...i&&{type:i},...r&&{tag:r},...o&&{priority:o}}}(e);r&&console.log("[Notix] Form captured:",i.title),t(i,{title:i.title,fieldsCount:Object.keys(e.elements).length})}catch(t){r&&console.warn("[Notix] Form capture failed:",t)}}}))})}function o(t){if(!1===t?.enabled)return null;const e="undefined"!=typeof window&&"function"==typeof window.ym;if(!e&&!t?.enabled)return null;let i=t?.counterId;return!i&&e&&(i=function(){for(const t of Object.keys(window))if(t.startsWith("yaCounter")){const e=parseInt(t.replace("yaCounter",""),10);if(!isNaN(e))return e}return}()),i?new n(i,t?.prefix??"notix"):null}class n{constructor(t,e){this.counterId=t,this.prefix=e}trackSent(t){this.reachGoal(`${this.prefix}_sent`,{id:t.id,message:t.message})}trackError(t){this.reachGoal(`${this.prefix}_error`,{error:t.message})}trackFormCaptured(t,e){this.reachGoal(`${this.prefix}_form_captured`,{title:t,fields:e})}trackGoal(t){this.reachGoal(t,{})}reachGoal(t,e){"function"==typeof window.ym&&window.ym(this.counterId,"reachGoal",t,e)}}class a{constructor(t){this.sendFn=t,this.errors=[],this.timer=null,this.bindGlobal()}bindGlobal(){if("undefined"==typeof window)return;window.addEventListener("error",t=>{this.errors.push({message:t.message||"Unknown error",file:t.filename||"",line:t.lineno||0,col:t.colno||0,stack:t.error?.stack||"",ts:(new Date).toISOString()}),this.errors.length>=10&&this.flush(),this.startTimer()}),window.addEventListener("unhandledrejection",t=>{this.errors.push({message:t.reason?.message||String(t.reason),file:"",line:0,col:0,stack:t.reason?.stack||"",ts:(new Date).toISOString()}),this.errors.length>=10&&this.flush(),this.startTimer()}),window.addEventListener("beforeunload",()=>this.flush()),document.addEventListener("visibilitychange",()=>{"hidden"===document.visibilityState&&this.flush()})}startTimer(){this.timer||(this.timer=setTimeout(()=>this.flush(),6e4))}flush(){0!==this.errors.length&&(this.sendFn([...this.errors]),this.errors=[],this.timer&&(clearTimeout(this.timer),this.timer=null))}}class s{constructor(t){if(this.captureActive=!1,!t.token||!t.token.startsWith("ntx_"))throw new Error('Notix: token must start with "ntx_"');this.token=t.token,this.endpoint=t.endpoint??"https://notix-hub.ru/api/v1/webhook",this.timeout=t.timeout??1e4,this.debug=t.debug??!1,this.metrika=o(t.metrika),!1!==t.autoCapture&&this.capture(),this.trackErrors()}async notify(t){if(!t.title)throw new Error("Notix: title is required");this.log("Sending notification:",t.title);try{const i=await e(this.endpoint,this.token,t,this.timeout);return this.log("Notification sent:",i.id),this.metrika?.trackSent(i),i}catch(t){const e=t instanceof Error?t:new Error(String(t));throw this.log("Error sending notification:",e.message),this.metrika?.trackError(e),e}}capture(t=document){this.captureActive||(r((t,e)=>{this.notify(t).then(()=>{this.metrika?.trackFormCaptured(e.title??t.title,e.fieldsCount)}).catch(()=>{})},t,this.debug),this.captureActive=!0,this.log("Form capture activated"))}destroy(){document.querySelectorAll("form[data-notix-bound]").forEach(t=>{delete t.dataset.notixBound}),this.captureActive=!1,this.log("Notix destroyed")}sendPageview(t,e){const i={title:"Посетитель на сайте",type:"metric",payload:{event_type:"pageview",visitor_id:c(),page:t||location.pathname,referrer:e||document.referrer||void 0,value:1}};this.notify(i).catch(()=>{}),this.log("Pageview sent:",t||location.pathname)}trackErrors(){"undefined"!=typeof window&&(new a(t=>{this.notify({title:`Ошибки на странице (${t.length})`,type:"error_batch",payload:{errors:t}}).catch(()=>{})}),this.log("Error tracking activated"))}static getVisitorId(){return c()}log(...t){this.debug&&console.log("[Notix]",...t)}}const d="notix_vid";function c(){try{let t=localStorage.getItem(d);return t||(t=crypto.randomUUID(),localStorage.setItem(d,t)),t}catch{return"unknown"}}if("undefined"!=typeof document){const t=document.currentScript;if(t){const e=t.dataset.token;if(e){const i=t.dataset.endpoint,r="false"!==t.dataset.autoCapture,o="true"===t.dataset.debug,n=t.dataset.timeout?parseInt(t.dataset.timeout,10):void 0,a=()=>{const t=new s({token:e,...i&&{endpoint:i},autoCapture:r,debug:o,...n&&{timeout:n}});window.notix=t};"loading"!==document.readyState?a():document.addEventListener("DOMContentLoaded",a)}else"true"===t.dataset.debug&&console.warn("[Notix] data-token attribute is required on script tag")}}return t.Notix=s,t}({});

package/dist/notix.d.ts

@@ -13,5 +13,8 @@ export declare class Notix {
     }>;
     capture(root?: Element | Document): void;
     destroy(): void;
+    sendPageview(page?: string, referrer?: string): void;
+    trackErrors(): void;
+    static getVisitorId(): string;
     private log;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@notix-hub/sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "JavaScript SDK for Notix (Нотикс) — notification aggregation service",
   "type": "module",
   "main": "./dist/index.cjs",