@notix-hub/sdk 0.1.0

package/README.md

@@ -0,0 +1,137 @@
+# @notix-hub/sdk
+
+JavaScript SDK для **Notix (Нотикс)** — сервиса агрегации уведомлений.
+
+## Установка
+
+### npm
+
+```bash
+npm install @notix/sdk
+```
+
+```js
+import { Notix } from '@notix-hub/sdk';
+
+const notix = new Notix({ token: 'ntx_xxxxxxxxxx' });
+
+await notix.notify({
+  title: 'Новый заказ',
+  body: 'Клиент оформил заказ на 12 000 ₽',
+  type: 'order',
+  priority: 'high',
+});
+```
+
+### CDN
+
+```html
+<script src="https://notix-hub.ru/js/notify.js" data-token="ntx_..."></script>
+```
+
+Скрипт автоматически инициализирует `window.notix` и включает захват форм.
+
+Без своего домена — через jsdelivr:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/@notix/sdk/dist/notify.min.js" data-token="ntx_..."></script>
+```
+
+## API
+
+### `new Notix(config)`
+
+| Параметр | Тип | По умолчанию | Описание |
+|----------|-----|-------------|----------|
+| `token` | `string` | — | API-токен (префикс `ntx_`) |
+| `endpoint` | `string` | `https://notix-hub.ru/api/v1/webhook` | URL вебхука |
+| `autoCapture` | `boolean` | `true` | Автозахват форм при создании |
+| `timeout` | `number` | `10000` | Таймаут запроса (мс) |
+| `debug` | `boolean` | `false` | Логирование в консоль |
+| `metrika` | `MetrikaConfig` | `{ enabled: auto }` | Настройки Яндекс.Метрики |
+
+### `notix.notify(payload)`
+
+Отправляет уведомление. Возвращает `Promise<{ message, id }>`.
+
+| Поле | Тип | Обязательно | Описание |
+|------|-----|------------|----------|
+| `title` | `string` | Да | Заголовок |
+| `body` | `string` | Нет | Текст |
+| `type` | `string` | Нет | Slug типа уведомления (lead, order, message...) |
+| `priority` | `string` | Нет | `low`, `normal`, `high`, `urgent` |
+| `payload` | `object` | Нет | Произвольный JSON |
+
+### `notix.capture(root?)`
+
+Вручную активирует захват форм. `root` — элемент, в котором искать формы (по умолчанию `document`).
+
+### `notix.destroy()`
+
+Отключает захват форм.
+
+## Автозахват форм
+
+Добавьте `data-notify` к форме, и SDK перехватит `submit`:
+
+```html
+<form data-notify data-notify-title="Заявка с лендинга">
+  <input name="name" data-notify-field="body">
+  <input name="phone">
+  <button type="submit">Отправить</button>
+</form>
+```
+
+Атрибуты:
+
+| Атрибут | Описание |
+|---------|----------|
+| `data-notify` | Включает захват формы |
+| `data-notify-title` | Заголовок уведомления (по умолчанию `document.title`) |
+| `data-notify-body` | Статичный текст уведомления |
+| `data-notify-type` | Тип уведомления |
+| `data-notify-priority` | Приоритет |
+| `data-notify-fields` | Имена полей через запятую (какие включить) |
+| `data-notify-field` | Пометить поле (собирается как `name: value`) |
+
+## Яндекс.Метрика
+
+SDK автоматически определяет наличие `window.ym` и отправляет события:
+
+- `notix_sent` — уведомление отправлено
+- `notix_error` — ошибка отправки
+- `notix_form_captured` — захвачена форма
+
+Отключить:
+
+```js
+new Notix({ token: '...', metrika: { enabled: false } });
+```
+
+## Разработка
+
+```bash
+npm install
+npm run build    # сборка в dist/
+npm run typecheck # проверка типов
+```
+
+## Публикация
+
+1. Создать `.env` с токеном npm:
+   ```
+   NPM_TOKEN=npm_xxxxxxxxxxxxxxxxxxxx
+   ```
+
+2. Опубликовать:
+   ```bash
+   source .env && npm publish --access public
+   ```
+
+После публикации пакет доступен:
+- **npm**: `npm install @notix-hub/sdk`
+- **jsdelivr (CDN)**: `https://cdn.jsdelivr.net/npm/@notix-hub/sdk/dist/notify.min.js`
+
+## Лицензия
+
+MIT

package/dist/capture.d.ts

@@ -0,0 +1,9 @@
+import type { NotifyPayload } from './types';
+interface FormMeta {
+    title?: string;
+    fieldsCount: number;
+}
+type OnSubmit = (payload: NotifyPayload, meta: FormMeta) => void;
+export declare function initFormCapture(onSubmit: OnSubmit, root: Element | Document, debug: boolean): void;
+export declare function destroyFormCapture(): void;
+export {};

package/dist/http.d.ts

@@ -0,0 +1,2 @@
+import type { NotifyPayload, NotixResponse } from './types';
+export declare function sendWebhook(endpoint: string, token: string, payload: NotifyPayload, timeout?: number): Promise<NotixResponse>;

package/dist/index.cjs

@@ -0,0 +1,286 @@
+/**
+ * @notix-hub/sdk — Notix (Нотикс) JavaScript SDK
+ * @version <%= pkg.version %>
+ * @license MIT
+ */
+'use strict';
+
+const DEFAULT_TIMEOUT = 10000;
+function sendWebhook(endpoint, token, payload, timeout = DEFAULT_TIMEOUT) {
+    const body = {
+        title: payload.title,
+        ...(payload.body !== undefined && { body: payload.body }),
+        ...(payload.type !== undefined && { notification_type: payload.type }),
+        ...(payload.priority !== undefined && { priority: payload.priority }),
+    };
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    if (typeof fetch !== 'undefined') {
+        return fetch(endpoint, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Content-Type': 'application/json',
+                'Accept': 'application/json',
+            },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        })
+            .then(async (res) => {
+            clearTimeout(timer);
+            const json = await res.json();
+            if (!res.ok) {
+                throw new Error(json.error || json.message || `HTTP ${res.status}`);
+            }
+            return json;
+        })
+            .catch((err) => {
+            clearTimeout(timer);
+            throw err;
+        });
+    }
+    return xhrSend(endpoint, token, body, timeout);
+}
+function xhrSend(endpoint, token, body, timeout) {
+    return new Promise((resolve, reject) => {
+        const xhr = new XMLHttpRequest();
+        xhr.open('POST', endpoint, true);
+        xhr.setRequestHeader('Authorization', `Bearer ${token}`);
+        xhr.setRequestHeader('Content-Type', 'application/json');
+        xhr.setRequestHeader('Accept', 'application/json');
+        xhr.timeout = timeout;
+        xhr.onload = () => {
+            try {
+                const json = JSON.parse(xhr.responseText);
+                if (xhr.status >= 200 && xhr.status < 300) {
+                    resolve(json);
+                }
+                else {
+                    reject(new Error(json.error || json.message || `HTTP ${xhr.status}`));
+                }
+            }
+            catch {
+                reject(new Error('Invalid response'));
+            }
+        };
+        xhr.onerror = () => reject(new Error('Network error'));
+        xhr.ontimeout = () => reject(new Error('Request timeout'));
+        xhr.send(JSON.stringify(body));
+    });
+}
+
+const SUBMIT_DEBOUNCE_MS = 500;
+const pendingForms = new WeakMap();
+function initFormCapture(onSubmit, root, debug) {
+    const forms = root.querySelectorAll('form[data-notify]');
+    forms.forEach((form) => {
+        if (form.dataset.notixBound)
+            return;
+        form.dataset.notixBound = '1';
+        form.addEventListener('submit', (e) => {
+            const now = Date.now();
+            const last = pendingForms.get(form) ?? 0;
+            if (now - last < SUBMIT_DEBOUNCE_MS) {
+                e.preventDefault();
+                return;
+            }
+            pendingForms.set(form, now);
+            try {
+                const payload = extractPayload(form);
+                if (debug) {
+                    console.log('[Notix] Form captured:', payload.title);
+                }
+                onSubmit(payload, { title: payload.title, fieldsCount: Object.keys(form.elements).length });
+            }
+            catch (err) {
+                // don't block form submission
+                if (debug) {
+                    console.warn('[Notix] Form capture failed:', err);
+                }
+            }
+        });
+    });
+}
+function destroyFormCapture() {
+    document.querySelectorAll('form[data-notix-bound]').forEach((form) => {
+        delete form.dataset.notixBound;
+        // listeners are removed by page navigation; for SPA use Notix.destroy() before unmount
+    });
+}
+function extractPayload(form) {
+    const title = form.dataset.notifyTitle ?? form.dataset.notify_title ?? document.title;
+    const type = form.dataset.notifyType ?? form.dataset.notify_type;
+    const priority = form.dataset.notifyPriority ?? form.dataset.notify_priority;
+    const staticBody = form.dataset.notifyBody ?? form.dataset.notify_body;
+    const specifiedFields = (form.dataset.notifyFields ?? form.dataset.notify_fields)
+        ?.split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+    if (staticBody) {
+        return {
+            title,
+            body: staticBody,
+            ...(type && { type }),
+            ...(priority && { priority: priority }),
+        };
+    }
+    const fieldEntries = [];
+    const elements = form.querySelectorAll('input[name], textarea[name], select[name]');
+    elements.forEach((el) => {
+        if (!el.name)
+            return;
+        if (specifiedFields && !specifiedFields.includes(el.name))
+            return;
+        const isMarked = el.hasAttribute('data-notify-field');
+        if (specifiedFields || isMarked) {
+            fieldEntries.push(`${el.name}: ${el.value || ''}`);
+        }
+    });
+    const body = fieldEntries.length > 0 ? fieldEntries.join('\n') : undefined;
+    return {
+        title,
+        ...(body && { body }),
+        ...(type && { type }),
+        ...(priority && { priority: priority }),
+    };
+}
+
+const DEFAULT_PREFIX = 'notix';
+function createMetrikaTracker(config) {
+    if (config?.enabled === false)
+        return null;
+    const hasYm = typeof window !== 'undefined' && typeof window.ym === 'function';
+    if (!hasYm && !config?.enabled)
+        return null;
+    let counterId = config?.counterId;
+    if (!counterId && hasYm) {
+        counterId = detectCounterId();
+    }
+    if (!counterId)
+        return null;
+    return new MetrikaTracker(counterId, config?.prefix ?? DEFAULT_PREFIX);
+}
+function detectCounterId() {
+    for (const key of Object.keys(window)) {
+        if (key.startsWith('yaCounter')) {
+            const num = parseInt(key.replace('yaCounter', ''), 10);
+            if (!isNaN(num))
+                return num;
+        }
+    }
+    return undefined;
+}
+class MetrikaTracker {
+    constructor(counterId, prefix) {
+        this.counterId = counterId;
+        this.prefix = prefix;
+    }
+    trackSent(response) {
+        this.reachGoal(`${this.prefix}_sent`, {
+            id: response.id,
+            message: response.message,
+        });
+    }
+    trackError(error) {
+        this.reachGoal(`${this.prefix}_error`, {
+            error: error.message,
+        });
+    }
+    trackFormCaptured(title, fieldsCount) {
+        this.reachGoal(`${this.prefix}_form_captured`, {
+            title,
+            fields: fieldsCount,
+        });
+    }
+    trackGoal(name) {
+        this.reachGoal(name, {});
+    }
+    reachGoal(target, params) {
+        if (typeof window.ym === 'function') {
+            window.ym(this.counterId, 'reachGoal', target, params);
+        }
+    }
+}
+
+const DEFAULT_ENDPOINT = 'https://notix-hub.ru/api/v1/webhook';
+class Notix {
+    constructor(config) {
+        this.captureActive = false;
+        if (!config.token || !config.token.startsWith('ntx_')) {
+            throw new Error('Notix: token must start with "ntx_"');
+        }
+        this.token = config.token;
+        this.endpoint = config.endpoint ?? DEFAULT_ENDPOINT;
+        this.timeout = config.timeout ?? 10000;
+        this.debug = config.debug ?? false;
+        this.metrika = createMetrikaTracker(config.metrika);
+        if (config.autoCapture !== false) {
+            this.capture();
+        }
+    }
+    async notify(payload) {
+        if (!payload.title) {
+            throw new Error('Notix: title is required');
+        }
+        this.log('Sending notification:', payload.title);
+        try {
+            const response = await sendWebhook(this.endpoint, this.token, payload, this.timeout);
+            this.log('Notification sent:', response.id);
+            this.metrika?.trackSent(response);
+            return response;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.log('Error sending notification:', err.message);
+            this.metrika?.trackError(err);
+            throw err;
+        }
+    }
+    capture(root = document) {
+        if (this.captureActive)
+            return;
+        initFormCapture((payload, meta) => {
+            this.notify(payload).then(() => {
+                this.metrika?.trackFormCaptured(meta.title ?? payload.title, meta.fieldsCount);
+            }).catch(() => { });
+        }, root, this.debug);
+        this.captureActive = true;
+        this.log('Form capture activated');
+    }
+    destroy() {
+        destroyFormCapture();
+        this.captureActive = false;
+        this.log('Notix destroyed');
+    }
+    log(...args) {
+        if (this.debug) {
+            console.log('[Notix]', ...args);
+        }
+    }
+}
+
+if (typeof document !== 'undefined') {
+    const thisScript = document.currentScript;
+    if (thisScript) {
+        const token = thisScript.dataset.token;
+        if (token) {
+            const endpoint = thisScript.dataset.endpoint;
+            const autoCapture = thisScript.dataset.autoCapture !== 'false';
+            const debug = thisScript.dataset.debug === 'true';
+            const timeout = thisScript.dataset.timeout ? parseInt(thisScript.dataset.timeout, 10) : undefined;
+            const notix = new Notix({
+                token,
+                ...(endpoint && { endpoint }),
+                autoCapture,
+                debug,
+                ...(timeout && { timeout }),
+            });
+            window.notix = notix;
+        }
+        else if (thisScript.dataset.debug === 'true') {
+            console.warn('[Notix] data-token attribute is required on script tag');
+        }
+    }
+}
+
+exports.Notix = Notix;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { Notix } from './notix';
+export { Notix };
+export type { NotixConfig, NotifyPayload, NotixResponse, MetrikaConfig } from './types';

package/dist/index.mjs

@@ -0,0 +1,284 @@
+/**
+ * @notix-hub/sdk — Notix (Нотикс) JavaScript SDK
+ * @version <%= pkg.version %>
+ * @license MIT
+ */
+const DEFAULT_TIMEOUT = 10000;
+function sendWebhook(endpoint, token, payload, timeout = DEFAULT_TIMEOUT) {
+    const body = {
+        title: payload.title,
+        ...(payload.body !== undefined && { body: payload.body }),
+        ...(payload.type !== undefined && { notification_type: payload.type }),
+        ...(payload.priority !== undefined && { priority: payload.priority }),
+    };
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    if (typeof fetch !== 'undefined') {
+        return fetch(endpoint, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Content-Type': 'application/json',
+                'Accept': 'application/json',
+            },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        })
+            .then(async (res) => {
+            clearTimeout(timer);
+            const json = await res.json();
+            if (!res.ok) {
+                throw new Error(json.error || json.message || `HTTP ${res.status}`);
+            }
+            return json;
+        })
+            .catch((err) => {
+            clearTimeout(timer);
+            throw err;
+        });
+    }
+    return xhrSend(endpoint, token, body, timeout);
+}
+function xhrSend(endpoint, token, body, timeout) {
+    return new Promise((resolve, reject) => {
+        const xhr = new XMLHttpRequest();
+        xhr.open('POST', endpoint, true);
+        xhr.setRequestHeader('Authorization', `Bearer ${token}`);
+        xhr.setRequestHeader('Content-Type', 'application/json');
+        xhr.setRequestHeader('Accept', 'application/json');
+        xhr.timeout = timeout;
+        xhr.onload = () => {
+            try {
+                const json = JSON.parse(xhr.responseText);
+                if (xhr.status >= 200 && xhr.status < 300) {
+                    resolve(json);
+                }
+                else {
+                    reject(new Error(json.error || json.message || `HTTP ${xhr.status}`));
+                }
+            }
+            catch {
+                reject(new Error('Invalid response'));
+            }
+        };
+        xhr.onerror = () => reject(new Error('Network error'));
+        xhr.ontimeout = () => reject(new Error('Request timeout'));
+        xhr.send(JSON.stringify(body));
+    });
+}
+
+const SUBMIT_DEBOUNCE_MS = 500;
+const pendingForms = new WeakMap();
+function initFormCapture(onSubmit, root, debug) {
+    const forms = root.querySelectorAll('form[data-notify]');
+    forms.forEach((form) => {
+        if (form.dataset.notixBound)
+            return;
+        form.dataset.notixBound = '1';
+        form.addEventListener('submit', (e) => {
+            const now = Date.now();
+            const last = pendingForms.get(form) ?? 0;
+            if (now - last < SUBMIT_DEBOUNCE_MS) {
+                e.preventDefault();
+                return;
+            }
+            pendingForms.set(form, now);
+            try {
+                const payload = extractPayload(form);
+                if (debug) {
+                    console.log('[Notix] Form captured:', payload.title);
+                }
+                onSubmit(payload, { title: payload.title, fieldsCount: Object.keys(form.elements).length });
+            }
+            catch (err) {
+                // don't block form submission
+                if (debug) {
+                    console.warn('[Notix] Form capture failed:', err);
+                }
+            }
+        });
+    });
+}
+function destroyFormCapture() {
+    document.querySelectorAll('form[data-notix-bound]').forEach((form) => {
+        delete form.dataset.notixBound;
+        // listeners are removed by page navigation; for SPA use Notix.destroy() before unmount
+    });
+}
+function extractPayload(form) {
+    const title = form.dataset.notifyTitle ?? form.dataset.notify_title ?? document.title;
+    const type = form.dataset.notifyType ?? form.dataset.notify_type;
+    const priority = form.dataset.notifyPriority ?? form.dataset.notify_priority;
+    const staticBody = form.dataset.notifyBody ?? form.dataset.notify_body;
+    const specifiedFields = (form.dataset.notifyFields ?? form.dataset.notify_fields)
+        ?.split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+    if (staticBody) {
+        return {
+            title,
+            body: staticBody,
+            ...(type && { type }),
+            ...(priority && { priority: priority }),
+        };
+    }
+    const fieldEntries = [];
+    const elements = form.querySelectorAll('input[name], textarea[name], select[name]');
+    elements.forEach((el) => {
+        if (!el.name)
+            return;
+        if (specifiedFields && !specifiedFields.includes(el.name))
+            return;
+        const isMarked = el.hasAttribute('data-notify-field');
+        if (specifiedFields || isMarked) {
+            fieldEntries.push(`${el.name}: ${el.value || ''}`);
+        }
+    });
+    const body = fieldEntries.length > 0 ? fieldEntries.join('\n') : undefined;
+    return {
+        title,
+        ...(body && { body }),
+        ...(type && { type }),
+        ...(priority && { priority: priority }),
+    };
+}
+
+const DEFAULT_PREFIX = 'notix';
+function createMetrikaTracker(config) {
+    if (config?.enabled === false)
+        return null;
+    const hasYm = typeof window !== 'undefined' && typeof window.ym === 'function';
+    if (!hasYm && !config?.enabled)
+        return null;
+    let counterId = config?.counterId;
+    if (!counterId && hasYm) {
+        counterId = detectCounterId();
+    }
+    if (!counterId)
+        return null;
+    return new MetrikaTracker(counterId, config?.prefix ?? DEFAULT_PREFIX);
+}
+function detectCounterId() {
+    for (const key of Object.keys(window)) {
+        if (key.startsWith('yaCounter')) {
+            const num = parseInt(key.replace('yaCounter', ''), 10);
+            if (!isNaN(num))
+                return num;
+        }
+    }
+    return undefined;
+}
+class MetrikaTracker {
+    constructor(counterId, prefix) {
+        this.counterId = counterId;
+        this.prefix = prefix;
+    }
+    trackSent(response) {
+        this.reachGoal(`${this.prefix}_sent`, {
+            id: response.id,
+            message: response.message,
+        });
+    }
+    trackError(error) {
+        this.reachGoal(`${this.prefix}_error`, {
+            error: error.message,
+        });
+    }
+    trackFormCaptured(title, fieldsCount) {
+        this.reachGoal(`${this.prefix}_form_captured`, {
+            title,
+            fields: fieldsCount,
+        });
+    }
+    trackGoal(name) {
+        this.reachGoal(name, {});
+    }
+    reachGoal(target, params) {
+        if (typeof window.ym === 'function') {
+            window.ym(this.counterId, 'reachGoal', target, params);
+        }
+    }
+}
+
+const DEFAULT_ENDPOINT = 'https://notix-hub.ru/api/v1/webhook';
+class Notix {
+    constructor(config) {
+        this.captureActive = false;
+        if (!config.token || !config.token.startsWith('ntx_')) {
+            throw new Error('Notix: token must start with "ntx_"');
+        }
+        this.token = config.token;
+        this.endpoint = config.endpoint ?? DEFAULT_ENDPOINT;
+        this.timeout = config.timeout ?? 10000;
+        this.debug = config.debug ?? false;
+        this.metrika = createMetrikaTracker(config.metrika);
+        if (config.autoCapture !== false) {
+            this.capture();
+        }
+    }
+    async notify(payload) {
+        if (!payload.title) {
+            throw new Error('Notix: title is required');
+        }
+        this.log('Sending notification:', payload.title);
+        try {
+            const response = await sendWebhook(this.endpoint, this.token, payload, this.timeout);
+            this.log('Notification sent:', response.id);
+            this.metrika?.trackSent(response);
+            return response;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.log('Error sending notification:', err.message);
+            this.metrika?.trackError(err);
+            throw err;
+        }
+    }
+    capture(root = document) {
+        if (this.captureActive)
+            return;
+        initFormCapture((payload, meta) => {
+            this.notify(payload).then(() => {
+                this.metrika?.trackFormCaptured(meta.title ?? payload.title, meta.fieldsCount);
+            }).catch(() => { });
+        }, root, this.debug);
+        this.captureActive = true;
+        this.log('Form capture activated');
+    }
+    destroy() {
+        destroyFormCapture();
+        this.captureActive = false;
+        this.log('Notix destroyed');
+    }
+    log(...args) {
+        if (this.debug) {
+            console.log('[Notix]', ...args);
+        }
+    }
+}
+
+if (typeof document !== 'undefined') {
+    const thisScript = document.currentScript;
+    if (thisScript) {
+        const token = thisScript.dataset.token;
+        if (token) {
+            const endpoint = thisScript.dataset.endpoint;
+            const autoCapture = thisScript.dataset.autoCapture !== 'false';
+            const debug = thisScript.dataset.debug === 'true';
+            const timeout = thisScript.dataset.timeout ? parseInt(thisScript.dataset.timeout, 10) : undefined;
+            const notix = new Notix({
+                token,
+                ...(endpoint && { endpoint }),
+                autoCapture,
+                debug,
+                ...(timeout && { timeout }),
+            });
+            window.notix = notix;
+        }
+        else if (thisScript.dataset.debug === 'true') {
+            console.warn('[Notix] data-token attribute is required on script tag');
+        }
+    }
+}
+
+export { Notix };

package/dist/metrika.d.ts

@@ -0,0 +1,24 @@
+import type { MetrikaConfig, NotixResponse } from './types';
+declare global {
+    interface Window {
+        ym?: (counterId: number, event: string, target: string, params?: Record<string, unknown>) => void;
+        Ya?: {
+            Metrika?: {
+                counterById?: Map<number, {
+                    hit: (url: string, params?: Record<string, unknown>) => void;
+                }>;
+            };
+        };
+    }
+}
+export declare function createMetrikaTracker(config?: MetrikaConfig): MetrikaTracker | null;
+export declare class MetrikaTracker {
+    private counterId;
+    private prefix;
+    constructor(counterId: number, prefix: string);
+    trackSent(response: NotixResponse): void;
+    trackError(error: Error): void;
+    trackFormCaptured(title: string, fieldsCount: number): void;
+    trackGoal(name: string): void;
+    private reachGoal;
+}

package/dist/notify.min.js

@@ -0,0 +1,6 @@
+/**
+ * @notix-hub/sdk — Notix (Нотикс) JavaScript SDK
+ * @version <%= pkg.version %>
+ * @license MIT
+ */
+var Notix=function(t){"use strict";function e(t,e,o,i=1e4){const r={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}},n=new AbortController,a=setTimeout(()=>n.abort(),i);return"undefined"!=typeof fetch?fetch(t,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json",Accept:"application/json"},body:JSON.stringify(r),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,o,i){return new Promise((r,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=i,a.onload=()=>{try{const t=JSON.parse(a.responseText);a.status>=200&&a.status<300?r(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(o))})}(t,e,r,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",r=>{const n=Date.now();if(n-(o.get(e)??0)<500)r.preventDefault();else{o.set(e,n);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.notifyPriority??t.dataset.notify_priority,r=t.dataset.notifyBody??t.dataset.notify_body,n=(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&&{priority:i}};const a=[],s=t.querySelectorAll("input[name], textarea[name], select[name]");s.forEach(t=>{if(!t.name)return;if(n&&!n.includes(t.name))return;const e=t.hasAttribute("data-notify-field");(n||e)&&a.push(`${t.name}: ${t.value||""}`)});const c=a.length>0?a.join("\n"):void 0;return{title:e,...c&&{body:c},...o&&{type:o},...i&&{priority:i}}}(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 r(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 n(o,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){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=r(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,r="true"===t.dataset.debug,n=t.dataset.timeout?parseInt(t.dataset.timeout,10):void 0,s=new a({token:e,...o&&{endpoint:o},autoCapture:i,debug:r,...n&&{timeout:n}});window.notix=s}else"true"===t.dataset.debug&&console.warn("[Notix] data-token attribute is required on script tag")}}return t.Notix=a,t}({});

package/dist/notix.d.ts

@@ -0,0 +1,17 @@
+import type { NotixConfig, NotifyPayload } from './types';
+export declare class Notix {
+    private token;
+    private endpoint;
+    private timeout;
+    private debug;
+    private metrika;
+    private captureActive;
+    constructor(config: NotixConfig);
+    notify(payload: NotifyPayload): Promise<{
+        message: string;
+        id: string;
+    }>;
+    capture(root?: Element | Document): void;
+    destroy(): void;
+    private log;
+}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+export type NotificationPriority = 'low' | 'normal' | 'high' | 'urgent';
+export interface NotifyPayload {
+    title: string;
+    body?: string;
+    type?: string;
+    priority?: NotificationPriority;
+    payload?: Record<string, unknown>;
+}
+export interface NotifyRequestBody extends NotifyPayload {
+    notification_type?: string;
+}
+export interface NotixResponse {
+    message: string;
+    id: string;
+}
+export interface MetrikaConfig {
+    enabled?: boolean;
+    counterId?: number;
+    prefix?: string;
+}
+export interface NotixConfig {
+    token: string;
+    endpoint?: string;
+    autoCapture?: boolean;
+    metrika?: MetrikaConfig;
+    timeout?: number;
+    debug?: boolean;
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@notix-hub/sdk",
+  "version": "0.1.0",
+  "description": "JavaScript SDK for Notix (Нотикс) — notification aggregation service",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "notix",
+    "notifications",
+    "webhook",
+    "notify"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@rollup/plugin-typescript": "^12.0.0",
+    "@rollup/plugin-terser": "^0.4.0",
+    "rollup": "^4.0.0",
+    "tslib": "^2.0.0",
+    "typescript": "^5.0.0"
+  }
+}