@inso_web/els-react 0.4.1 → 0.5.0

package/README.md

@@ -5,73 +5,62 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
 [![license MIT](https://img.shields.io/npm/l/@inso_web/els-react.svg)](./LICENSE)
 
-React-обёртка для **Error Logs Service (ELS)**: `<ELSProvider>` для DI клиента, hook `useELS()`, готовый `<ErrorBoundary>` с автоматической отправкой ошибок render-фазы. React 17+.
+React bindings for the **Inso Error Logs Service (ELS)** — a managed SaaS for centralised event logging (debug → fatal) with AI-assisted error triage. Ships `<ELSProvider>` for DI, `useELS()` hook, a ready-made `<ELSErrorBoundary>` that auto-reports render-phase errors, and a `useGlobalErrorHandlers()` hook for `window` listeners. React 17+.
 
-## Что внутри
-
-- `<ELSProvider client={...}>` — кладёт клиент в контекст.
-- `useELS()` — hook возвращает logger.
-- `<ELSErrorBoundary>` — error boundary который ловит render-ошибки и шлёт в ELS со stack trace + componentStack.
-- `useGlobalErrorHandlers()` — hook для подписки на `window.error` и `unhandledrejection`.
+> 🇷🇺 [Русская версия → README_RU.md](README_RU.md)
 
 ---
 
-## UI: что вы получаете
-
-ELS из коробки даёт админ-панель — все события из вашего React приложения попадают в неё.
-
-### Список логов с фильтрами
-
-![Список логов](./docs/screenshots/01-error-logs-list.png)
-
-Виртуальная таблица всех событий: trace ID, приложение, источник (client/server), уровень, сообщение, страница, IP. Левый сайдбар — фасеты по приложению, окружению, **версии**, источнику, уровню, браузеру, языку, IP, категории ошибки.
-
-### Детальная карточка с метаданными
-
-![Детальная карточка](./docs/screenshots/02-event-detail-info.png)
-
-Время сервера/клиента, IP с гео, окружение, **версия приложения**, fingerprint, session ID. Карточки повторений и корреляция событий справа.
-
-### AI-диагностика ошибок
+## Table of contents
+
+- [What you get](#what-you-get)
+- [Install](#install)
+- [Quick Start](#quick-start)
+- [When to use what](#when-to-use-what)
+- [Core concepts](#core-concepts)
+- [Configuration](#configuration)
+- [Migration](#migration)
+  - [From @sentry/react](#from-sentryreact)
+  - [From LogRocket React SDK](#from-logrocket-react-sdk)
+- [Versioning](#versioning)
+- [Quick reference](#quick-reference)
+- [Why ELS](#why-els)
+- [API](#api)
+- [FAQ](#faq)
+- [Other ELS SDKs](#other-els-sdks)
+- [Pricing](#pricing)
+- [License](#license)
 
-![AI диагностика](./docs/screenshots/03-error-detail-ai.png)
-
-Stack trace с распарсенными фреймами + AI-анализ что именно сломалось и как чинить. Для React-ошибок дополнительно сохраняется `componentStack`.
-
-### Аналитика и регрессии по версиям
-
-![Аналитика](./docs/screenshots/04-analytics-dashboard.png)
-
-Total / critical+errors / warnings / error rate. AI-обзор слева, timeline в центре, donut'ы по приложению/источнику/уровню. **Виджет «Регрессии»**: какие fingerprint'ы появились впервые в свежей версии и какие пропали.
-
-### Управление API-ключами
-
-![API ключи](./docs/screenshots/05-api-keys.png)
-![Действия с ключом](./docs/screenshots/06-api-key-actions.png)
-
-Scoped-ключи (write/read/read-any), live/test environments, ротация без даунтайма.
+---
 
-### Избранные события
+## What you get
 
-![Избранные](./docs/screenshots/07-favorites.png)
+ELS ships with a built-in admin dashboard. Every event captured by this SDK lands there with full-text search, faceted filtering, AI-assisted diagnosis, and version-aware regression detection. React render-phase errors carry `componentStack` alongside the regular stack trace.
 
-Закладки на конкретные trace ID — для расследований, не теряются между сессиями.
+| | |
+|---|---|
+| ![Logs list](https://raw.githubusercontent.com/official-inso/els-go/main/docs/screenshots/01-error-logs-list.png) | ![Event detail](https://raw.githubusercontent.com/official-inso/els-go/main/docs/screenshots/02-event-detail-info.png) |
+| Virtual table with facet sidebar (app, env, **version**, source, level, browser, IP, category). Live mode auto-refreshes every 5s. | Full event metadata: timestamps, geo, env, **app version**, fingerprint, session, repetition cards, in-session correlation. |
+| ![AI diagnosis](https://raw.githubusercontent.com/official-inso/els-go/main/docs/screenshots/03-error-detail-ai.png) | ![Analytics](https://raw.githubusercontent.com/official-inso/els-go/main/docs/screenshots/04-analytics-dashboard.png) |
+| Parsed stack trace + AI-assisted diagnosis: what broke, where, how to fix. | Timeline, donuts, top URLs/IPs, hourly heatmap, **version-regression widget**. |
 
 ---
 
-## Установка
+## Install
 
 ```bash
 npm install @inso_web/els-client @inso_web/els-react
 ```
 
+**Requirements:** React 17+, Node.js 18+ at build time. Works with Vite, CRA, Webpack, Parcel.
+
 ---
 
 ## Quick Start
 
-### 1. Подключите Provider
+### 1. Wrap your app in `<ELSProvider>`
 
-`main.tsx` (Vite) или `index.tsx` (CRA):
+`main.tsx` (Vite) or `index.tsx` (CRA):
 
 ```tsx
 import { ELSClient } from '@inso_web/els-client';
@@ -95,7 +84,9 @@ ReactDOM.createRoot(document.getElementById('root')!).render(
 );
 ```
 
-### 2. Логируйте через `useELS()`
+Don't have an API key yet? **[Sign up at lk.insoweb.ru](https://lk.insoweb.ru)** — takes under a minute.
+
+### 2. Log via `useELS()`
 
 ```tsx
 import { useELS } from '@inso_web/els-react';
@@ -114,19 +105,19 @@ export function CheckoutButton() {
 }
 ```
 
-### 3. Оберните корень в `<ELSErrorBoundary>`
+### 3. Wrap the root in `<ELSErrorBoundary>`
 
 ```tsx
 import { ELSErrorBoundary } from '@inso_web/els-react';
 
-<ELSErrorBoundary fallback={<div>Что-то пошло не так</div>}>
+<ELSErrorBoundary fallback={<div>Something went wrong</div>}>
   <App />
 </ELSErrorBoundary>
 ```
 
-Render-ошибки автоматически пойдут в ELS с stack trace + componentStack.
+Render-phase errors are captured automatically with stack trace + `componentStack`.
 
-### 4. Глобальные обработчики (опционально)
+### 4. Global handlers (optional)
 
 ```tsx
 import { useGlobalErrorHandlers } from '@inso_web/els-react';
@@ -137,11 +128,200 @@ export function ErrorReporter() {
 }
 ```
 
+Mount `<ErrorReporter />` once inside the provider.
+
 ---
 
-## Версионирование
+## When to use what
+
+| Scenario | Use |
+|---|---|
+| Catch render-phase errors | Wrap a subtree in `<ELSErrorBoundary>` |
+| Handle async errors in event handlers | `useELS()` + `try/catch` |
+| Background `window.error` / `unhandledrejection` | Mount `<ErrorReporter />` with `useGlobalErrorHandlers()` |
+| Multiple sub-apps with different configs | Multiple `<ELSProvider>` instances (innermost wins) |
+| Outside React (utility module) | Import the `ELSClient` directly |
+| SSR (Next.js) | Use [`@inso_web/els-next`](https://github.com/official-inso/els-next) instead |
+
+---
+
+## Core concepts
+
+### `<ELSErrorBoundary>`
+
+A regular React error boundary that calls `client.error(err, ..., { meta: { componentStack } })` in `componentDidCatch`. Render-phase exceptions are captured; event-handler errors are not (React itself doesn't surface them to boundaries — wrap with `try/catch`).
 
-Прокидывайте версию через переменные сборки. Для Vite — `VITE_BUILD_VERSION` (Vite инлайнит на этапе build):
+### `useELS()`
+
+Returns the same `Logger` interface as the base client: `info`, `warn`, `error`, `debug`, `trace`, `fatal`, `child`, `flush`. The reference is stable across renders.
+
+### Bindings & child loggers
+
+```tsx
+const log = useELS();
+const userLog = log.child({ userId: 42, role: 'admin' });
+userLog.info('viewed profile');
+```
+
+`child` is cheap — create one per user, per workflow, per route as needed.
+
+---
+
+## Configuration
+
+`ELSConfig` matches the base client — see [@inso_web/els-client](https://github.com/official-inso/els-client). Key fields:
+
+| Option | Description |
+|---|---|
+| `endpoint` | ELS URL (required) |
+| `apiKey` | API key (required) |
+| `appSlug` | App slug (required) |
+| `serviceName` | Service / module name |
+| `deploymentEnv` | `DEV` / `STAGING` / `PRODUCTION` |
+| `appVersion` | Version (≤128 chars) |
+| `minLevel` | Minimum level to send |
+
+---
+
+## Migration
+
+### From @sentry/react
+
+**Before:**
+
+```tsx
+import * as Sentry from '@sentry/react';
+
+Sentry.init({
+  dsn: 'https://public@sentry.example.com/1',
+  environment: process.env.NODE_ENV,
+  release: import.meta.env.VITE_BUILD_VERSION,
+});
+
+const SentryRoute = Sentry.withSentryReactRouterV6Routing(Route);
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <Sentry.ErrorBoundary fallback={<p>Crashed</p>}>
+    <App />
+  </Sentry.ErrorBoundary>,
+);
+
+function MyButton() {
+  return (
+    <button onClick={() => {
+      Sentry.captureMessage('clicked');
+      doStuff().catch(Sentry.captureException);
+    }}>Click</button>
+  );
+}
+```
+
+**After:**
+
+```tsx
+import { ELSClient } from '@inso_web/els-client';
+import { ELSProvider, ELSErrorBoundary, useELS } from '@inso_web/els-react';
+
+const client = new ELSClient({
+  endpoint: import.meta.env.VITE_ELS_URL,
+  apiKey: import.meta.env.VITE_ELS_API_KEY,
+  appSlug: 'my-react-app',
+  deploymentEnv: import.meta.env.PROD ? 'PRODUCTION' : 'DEV',
+  appVersion: import.meta.env.VITE_BUILD_VERSION,
+});
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <ELSProvider client={client}>
+    <ELSErrorBoundary fallback={<p>Crashed</p>}>
+      <App />
+    </ELSErrorBoundary>
+  </ELSProvider>,
+);
+
+function MyButton() {
+  const log = useELS();
+  return (
+    <button onClick={() => {
+      log.info('clicked');
+      doStuff().catch((err) => log.error(err, 'click failed'));
+    }}>Click</button>
+  );
+}
+```
+
+| Sentry | ELS | Notes |
+|---|---|---|
+| `Sentry.init({ dsn })` | `new ELSClient({ endpoint, apiKey, appSlug })` | Three explicit fields |
+| `<Sentry.ErrorBoundary>` | `<ELSErrorBoundary>` | Same role, same API |
+| `Sentry.captureException(err)` | `log.error(err)` | Via `useELS()` |
+| `Sentry.captureMessage(msg, level)` | `log.<level>(msg)` | |
+| `Sentry.setUser({ id })` | `log.child({ user: { id } })` | Or via `loggerDefaults` |
+| `release` | `appVersion` | Any string ≤128 chars |
+| `environment` | `deploymentEnv` | Fixed enum |
+| `Sentry.withSentryReactRouterV6Routing` | Not provided | Routing telemetry stays in Sentry if needed |
+| Source maps upload | Not provided | Pair with another tool if critical |
+| Session replay | Not provided | LogRocket / Sentry Replay if needed |
+
+**Gotchas:**
+
+- React event-handler errors are not caught by error boundaries — wrap async logic in `try/catch` and call `log.error(...)` explicitly.
+- Sentry's `breadcrumbs` have no direct equivalent — use `log.child({ ... })` to carry context.
+
+---
+
+### From LogRocket React SDK
+
+**Before:**
+
+```tsx
+import LogRocket from 'logrocket';
+import setupLogRocketReact from 'logrocket-react';
+
+LogRocket.init('app/123');
+setupLogRocketReact(LogRocket);
+
+LogRocket.identify('user-42', { email: 'a@b.com' });
+LogRocket.captureException(new Error('boom'));
+```
+
+**After:**
+
+```tsx
+import { ELSClient } from '@inso_web/els-client';
+import { ELSProvider, ELSErrorBoundary, useELS } from '@inso_web/els-react';
+
+const client = new ELSClient({
+  endpoint: import.meta.env.VITE_ELS_URL,
+  apiKey: import.meta.env.VITE_ELS_API_KEY,
+  appSlug: 'my-react-app',
+});
+
+// usage
+const log = useELS();
+log.child({ user: { id: 'user-42', email: 'a@b.com' } }).info('identified');
+log.error(new Error('boom'));
+```
+
+| LogRocket | ELS | Notes |
+|---|---|---|
+| `LogRocket.init('app/123')` | `new ELSClient({ endpoint, apiKey, appSlug })` | Three explicit fields |
+| `LogRocket.identify(id, meta)` | `log.child({ user: { id, ...meta } })` | Bindings travel with the logger |
+| `LogRocket.captureException(err)` | `log.error(err)` | |
+| `LogRocket.log/info/warn/error` | `log.<level>(...)` | |
+| Session replay | Not provided | Stay on LogRocket if replay is critical |
+| Network request capture | Not provided | Log explicit `log.info({ url, status })` instead |
+| Redux integration | Not provided | Call `log.info(action.type, ...)` in middleware |
+
+**Gotchas:**
+
+- LogRocket records full DOM sessions; ELS only stores discrete events. If session replay is the reason you chose LogRocket, keep it.
+- LogRocket's request/response interception is opaque — replicate with explicit log calls in your fetch wrapper.
+
+---
+
+## Versioning
+
+Pass via build-time env. For Vite — `VITE_BUILD_VERSION` (Vite inlines at `npm run build`):
 
 ```Dockerfile
 ARG VITE_BUILD_VERSION=dev
@@ -159,7 +339,59 @@ RUN npm run build
 new ELSClient({ ..., appVersion: import.meta.env.VITE_BUILD_VERSION });
 ```
 
-ELS принимает любой формат до 128 символов: semver, CalVer, date-compact, git SHA, opaque. Парсер на стороне сервера автоматически распознаёт тип и сортирует timeline.
+ELS accepts any format ≤128 chars: semver, CalVer, date-compact, git SHA, opaque. The server auto-detects the format and sorts timelines.
+
+---
+
+## Quick reference
+
+| Need | Use |
+|---|---|
+| Logger in components | `const log = useELS()` |
+| Catch render crashes | `<ELSErrorBoundary>` |
+| Catch event-handler errors | `try/catch` + `log.error(err)` |
+| Global browser errors | Mount `<ErrorReporter />` with `useGlobalErrorHandlers()` |
+| Identify user | `log.child({ user: { id, email } })` |
+| Per-route context | `log.child({ route })` in a layout component |
+| Suppress noisy levels | `minLevel: 'warn'` |
+
+---
+
+## Why ELS
+
+ELS for Node.js is a focused logging SaaS, not a full observability suite. It optimises for capture speed, AI-driven triage, and a low integration cost.
+
+- **Lower weight.** ~3 KB gzip in the browser, no transitive deps.
+- **Zero external API calls.** Only `POST /errors[/batch]` and `GET /health`.
+- **AI-assisted diagnosis** on every stack trace — `componentStack` included for React render errors.
+- **5-minute integration.** Provider + boundary + hook, done.
+- **Predictable price.** Tariffs in the dashboard.
+
+### Detailed comparison
+
+| Category | ELS | Sentry | Datadog / New Relic | Grafana Loki | LogRocket / Logtail / BetterStack |
+|---|---|---|---|---|---|
+| Hosting model | Managed SaaS | SaaS or self-hosted | SaaS only | Self-hosted / Grafana Cloud | SaaS |
+| SDK runtime deps | Zero | Medium (sub-SDKs, integrations) | Heavy (agent + tracing) | Promtail / agent | Medium |
+| Typical integration time | ~5 min | 10–20 min | 30–60 min | Hours to days | 10–20 min |
+| AI-assisted triage | Built-in | Paid add-on | Paid add-on | None | None |
+| Error grouping / fingerprint | Yes | Yes | Yes | Manual via LogQL | Partial |
+| Source-map upload | No | Yes | Yes | n/a | Partial |
+| Session replay (frontend) | No | Paid | Paid | n/a | Yes (core) |
+| Distributed tracing / APM | No | Partial | Yes (core) | Yes with Tempo | No |
+| Infrastructure metrics | No | No | Yes (core) | Yes with Mimir | No |
+| Free tier log retention | 24 hours | 30 days (limited volume) | Trial only | Self-cost | 3–30 days |
+| Russian-language support / docs | Native | Community | Limited | Community | None |
+
+### When ELS is the wrong choice
+
+- You need a single vendor for **APM + logs + metrics** under one bill — go Datadog or New Relic.
+- Your frontend bug triage relies on **DOM session replay** — go LogRocket or Sentry Replay.
+- You ship a **public mobile app** and need crash symbolication + ANR detection — Firebase Crashlytics or Sentry Mobile.
+
+For everything else — backend errors, frontend JS errors, request logs, structured app events with version-aware analytics — ELS is built to be the cheapest path to a working dashboard.
+
+→ **Sign up at [lk.insoweb.ru](https://lk.insoweb.ru)** to grab an API key.
 
 ---
 
@@ -179,23 +411,52 @@ class ELSErrorBoundary extends React.Component<{
 function useGlobalErrorHandlers(opts?: { errors?: boolean; rejections?: boolean }): void;
 ```
 
+Full `ELSConfig` reference — see [@inso_web/els-client](https://github.com/official-inso/els-client).
+
 ---
 
 ## FAQ
 
-**Совместимо с React 18 / 19?** Да. Поддерживается React 17+.
+**React 18 / 19?** Yes. Supported on React 17+.
 
-**А `apiKey` для клиентского bundle — это безопасно?** Да. ELS-ключи scoped (только write для приложения), и они всё равно видны в bundle (как у Sentry public DSN).
+**Is the API key safe in the client bundle?** Yes. ELS keys are scoped — a write key cannot read events. Same model as Sentry public DSN. If you still want to hide it, run an internal `/api/log` proxy.
 
-**Что если `apiKey` пустой?** Если передать `apiKey: ''` в `new ELSClient({...})` — конструктор throw'нёт. Используйте guard в коде:
+**What if `apiKey` is empty?** `new ELSClient({ ..., apiKey: '' })` throws. Guard in the entry file:
 
 ```ts
 const client = apiKey
   ? new ELSClient({ ..., apiKey })
-  : { info: () => {}, warn: () => {}, error: () => {}, /* ... */ };
+  : ({ info: () => {}, warn: () => {}, error: () => {}, /* ... */ } as any);
 ```
 
-Либо используйте обёртки next/nest которые уже имеют такой guard.
+Or use [`@inso_web/els-next`](https://github.com/official-inso/els-next) which has the silent-no-op guard built-in.
+
+**SSR with Next.js?** Use [`@inso_web/els-next`](https://github.com/official-inso/els-next) — single config for server + client + edge.
+
+---
+
+## Other ELS SDKs
+
+Same wire format, same dashboard — pick by stack.
+
+**Node.js family**
+- [`@inso_web/els-client`](https://github.com/official-inso/els-client) — base TS / Node / browser client
+- [`@inso_web/els-express`](https://github.com/official-inso/els-express) — Express middleware
+- [`@inso_web/els-next`](https://github.com/official-inso/els-next) — Next.js helpers (App + Pages router)
+- [`@inso_web/els-nest`](https://github.com/official-inso/els-nest) — NestJS module
+- [`@inso_web/els-react`](https://github.com/official-inso/els-react) — React Provider, hooks, ErrorBoundary (this repo)
+- [`@inso_web/els-vue`](https://github.com/official-inso/els-vue) — Vue 3 plugin
+
+**Other stacks**
+- [`Inso.Els`](https://github.com/official-inso/els-csharp) — .NET (Core + ASP.NET Core + ILogger)
+- [`io.github.official-inso:els-core`](https://github.com/official-inso/els-java) — Java + Spring Boot starter + SLF4J
+- [`github.com/official-inso/els-go`](https://github.com/official-inso/els-go) — Go
+
+---
+
+## Pricing
+
+Free tier — **24-hour log retention**. See **[lk.insoweb.ru](https://lk.insoweb.ru)** for the full tariff matrix.
 
 ---
 

package/dist/index.cjs

@@ -62,10 +62,8 @@ var ELSProvider = ({
     const onError = (event) => {
       const entry = {
         message: event.message || "window.onerror",
-        url: typeof location !== "undefined" ? location.href : "",
         stack: event.error?.stack,
-        level: "error",
-        source: "client"
+        level: "error"
       };
       if (value.queue) value.queue.enqueue(entry);
       else void value.client.sendError(entry);
@@ -74,10 +72,8 @@ var ELSProvider = ({
       const reason = event.reason;
       const entry = {
         message: String(reason?.message ?? reason ?? "unhandledrejection"),
-        url: typeof location !== "undefined" ? location.href : "",
         stack: reason?.stack,
-        level: "error",
-        source: "client"
+        level: "error"
       };
       if (value.queue) value.queue.enqueue(entry);
       else void value.client.sendError(entry);
@@ -103,7 +99,7 @@ function useELS() {
   const ctx = React2.useContext(ELSContext);
   if (!ctx) {
     throw new Error(
-      "useELS: ELSProvider \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D. \u041E\u0431\u0435\u0440\u043D\u0438\u0442\u0435 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435 \u0432 <ELSProvider>."
+      "useELS: no ELSProvider found. Wrap your app in <ELSProvider>."
     );
   }
   return ctx;
@@ -119,9 +115,7 @@ function useErrorReporter() {
       const entry = {
         message: e?.message ?? String(err),
         stack: e?.stack,
-        url: typeof location !== "undefined" ? location.href : extra?.url ?? "",
         level: "error",
-        source: "client",
         ...extra
       };
       if (queue) queue.enqueue(entry);
@@ -149,9 +143,7 @@ var ELSErrorBoundary = class extends React4.Component {
       message: error.message,
       stack: error.stack,
       componentStack: info.componentStack ?? void 0,
-      url: typeof location !== "undefined" ? location.href : "",
-      level: "error",
-      source: "client"
+      level: "error"
     };
     if (ctx.queue) ctx.queue.enqueue(entry);
     else void ctx.client.sendError(entry);

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/ELSProvider.tsx","../src/useELS.ts","../src/useErrorReporter.ts","../src/ELSErrorBoundary.tsx","../src/withErrorReporting.tsx"],"sourcesContent":["export { ELSProvider, ELSContext } from \"./ELSProvider.js\";\nexport { useELS } from \"./useELS.js\";\nexport { useErrorReporter } from \"./useErrorReporter.js\";\nexport { ELSErrorBoundary } from \"./ELSErrorBoundary.js\";\nexport { withErrorReporting } from \"./withErrorReporting.js\";\nexport type { ELSProviderProps } from \"./ELSProvider.js\";\n","import * as React from \"react\";\nimport { ELSClient, ELSQueue } from \"@inso_web/els-client\";\nimport type { ELSConfig } from \"@inso_web/els-client\";\n\nexport interface ELSContextValue {\n  client: ELSClient;\n  queue: ELSQueue | null;\n}\n\nexport const ELSContext = React.createContext<ELSContextValue | null>(null);\n\nexport interface ELSProviderProps {\n  config: ELSConfig;\n  /** Включить очередь с батчингом. По умолчанию true. */\n  useQueue?: boolean;\n  /** Интервал авто‑флаша очереди в мс. */\n  flushIntervalMs?: number;\n  /** Максимальный размер батча. */\n  maxBatchSize?: number;\n  /** Авто‑подписка на window.onerror и unhandledrejection. По умолчанию true. */\n  captureGlobalErrors?: boolean;\n  children?: React.ReactNode;\n}\n\nexport const ELSProvider: React.FC<ELSProviderProps> = ({\n  config,\n  useQueue = true,\n  flushIntervalMs,\n  maxBatchSize,\n  captureGlobalErrors = true,\n  children,\n}) => {\n  const value = React.useMemo<ELSContextValue>(() => {\n    const client = new ELSClient(config);\n    const queue = useQueue\n      ? new ELSQueue(client, { flushIntervalMs, maxBatchSize })\n      : null;\n    return { client, queue };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  React.useEffect(() => {\n    if (!captureGlobalErrors || typeof window === \"undefined\") return;\n\n    const onError = (event: ErrorEvent) => {\n      const entry = {\n        message: event.message || \"window.onerror\",\n        url: typeof location !== \"undefined\" ? location.href : \"\",\n        stack: event.error?.stack,\n        level: \"error\" as const,\n        source: \"client\" as const,\n      };\n      if (value.queue) value.queue.enqueue(entry);\n      else void value.client.sendError(entry);\n    };\n\n    const onRejection = (event: PromiseRejectionEvent) => {\n      const reason = event.reason;\n      const entry = {\n        message: String(reason?.message ?? reason ?? \"unhandledrejection\"),\n        url: typeof location !== \"undefined\" ? location.href : \"\",\n        stack: reason?.stack,\n        level: \"error\" as const,\n        source: \"client\" as const,\n      };\n      if (value.queue) value.queue.enqueue(entry);\n      else void value.client.sendError(entry);\n    };\n\n    window.addEventListener(\"error\", onError);\n    window.addEventListener(\"unhandledrejection\", onRejection);\n    return () => {\n      window.removeEventListener(\"error\", onError);\n      window.removeEventListener(\"unhandledrejection\", onRejection);\n    };\n  }, [captureGlobalErrors, value]);\n\n  React.useEffect(() => {\n    return () => {\n      value.queue?.stop();\n    };\n  }, [value]);\n\n  return <ELSContext.Provider value={value}>{children}</ELSContext.Provider>;\n};\n","import * as React from \"react\";\nimport { ELSContext } from \"./ELSProvider.js\";\nimport type { ELSContextValue } from \"./ELSProvider.js\";\n\nexport function useELS(): ELSContextValue {\n  const ctx = React.useContext(ELSContext);\n  if (!ctx) {\n    throw new Error(\n      \"useELS: ELSProvider не найден. Оберните приложение в <ELSProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import * as React from \"react\";\nimport type { ErrorEntry } from \"@inso_web/els-client\";\nimport { useELS } from \"./useELS.js\";\n\nexport function useErrorReporter() {\n  const { client, queue } = useELS();\n\n  return React.useCallback(\n    (err: unknown, extra?: Partial<ErrorEntry>) => {\n      const e = err as Error | undefined;\n      const entry: ErrorEntry = {\n        message: e?.message ?? String(err),\n        stack: e?.stack,\n        url:\n          typeof location !== \"undefined\" ? location.href : extra?.url ?? \"\",\n        level: \"error\",\n        source: \"client\",\n        ...extra,\n      };\n      if (queue) queue.enqueue(entry);\n      else void client.sendError(entry);\n    },\n    [client, queue],\n  );\n}\n","import * as React from \"react\";\nimport { ELSContext } from \"./ELSProvider.js\";\n\nexport interface ELSErrorBoundaryProps {\n  fallback?: React.ReactNode | ((error: Error) => React.ReactNode);\n  onError?: (error: Error, info: React.ErrorInfo) => void;\n  children?: React.ReactNode;\n}\n\ninterface State {\n  error: Error | null;\n}\n\nexport class ELSErrorBoundary extends React.Component<\n  ELSErrorBoundaryProps,\n  State\n> {\n  static contextType = ELSContext;\n  declare context: React.ContextType<typeof ELSContext>;\n\n  state: State = { error: null };\n\n  static getDerivedStateFromError(error: Error): State {\n    return { error };\n  }\n\n  componentDidCatch(error: Error, info: React.ErrorInfo) {\n    this.props.onError?.(error, info);\n    const ctx = this.context;\n    if (!ctx) return;\n    const entry = {\n      message: error.message,\n      stack: error.stack,\n      componentStack: info.componentStack ?? undefined,\n      url: typeof location !== \"undefined\" ? location.href : \"\",\n      level: \"error\" as const,\n      source: \"client\" as const,\n    };\n    if (ctx.queue) ctx.queue.enqueue(entry);\n    else void ctx.client.sendError(entry);\n  }\n\n  render() {\n    if (this.state.error) {\n      const { fallback } = this.props;\n      if (typeof fallback === \"function\") return fallback(this.state.error);\n      return fallback ?? null;\n    }\n    return this.props.children;\n  }\n}\n","import * as React from \"react\";\nimport { ELSErrorBoundary } from \"./ELSErrorBoundary.js\";\nimport type { ELSErrorBoundaryProps } from \"./ELSErrorBoundary.js\";\n\nexport function withErrorReporting<P extends object>(\n  Component: React.ComponentType<P>,\n  boundaryProps?: Omit<ELSErrorBoundaryProps, \"children\">,\n): React.FC<P> {\n  const Wrapped: React.FC<P> = (props) => (\n    <ELSErrorBoundary {...boundaryProps}>\n      <Component {...props} />\n    </ELSErrorBoundary>\n  );\n  Wrapped.displayName = `withErrorReporting(${\n    Component.displayName ?? Component.name ?? \"Component\"\n  })`;\n  return Wrapped;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,YAAuB;AACvB,wBAAoC;AAkF3B;AA1EF,IAAM,aAAmB,oBAAsC,IAAI;AAenE,IAAM,cAA0C,CAAC;AAAA,EACtD;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA,sBAAsB;AAAA,EACtB;AACF,MAAM;AACJ,QAAM,QAAc,cAAyB,MAAM;AACjD,UAAM,SAAS,IAAI,4BAAU,MAAM;AACnC,UAAM,QAAQ,WACV,IAAI,2BAAS,QAAQ,EAAE,iBAAiB,aAAa,CAAC,IACtD;AACJ,WAAO,EAAE,QAAQ,MAAM;AAAA,EAEzB,GAAG,CAAC,CAAC;AAEL,EAAM,gBAAU,MAAM;AACpB,QAAI,CAAC,uBAAuB,OAAO,WAAW,YAAa;AAE3D,UAAM,UAAU,CAAC,UAAsB;AACrC,YAAM,QAAQ;AAAA,QACZ,SAAS,MAAM,WAAW;AAAA,QAC1B,KAAK,OAAO,aAAa,cAAc,SAAS,OAAO;AAAA,QACvD,OAAO,MAAM,OAAO;AAAA,QACpB,OAAO;AAAA,QACP,QAAQ;AAAA,MACV;AACA,UAAI,MAAM,MAAO,OAAM,MAAM,QAAQ,KAAK;AAAA,UACrC,MAAK,MAAM,OAAO,UAAU,KAAK;AAAA,IACxC;AAEA,UAAM,cAAc,CAAC,UAAiC;AACpD,YAAM,SAAS,MAAM;AACrB,YAAM,QAAQ;AAAA,QACZ,SAAS,OAAO,QAAQ,WAAW,UAAU,oBAAoB;AAAA,QACjE,KAAK,OAAO,aAAa,cAAc,SAAS,OAAO;AAAA,QACvD,OAAO,QAAQ;AAAA,QACf,OAAO;AAAA,QACP,QAAQ;AAAA,MACV;AACA,UAAI,MAAM,MAAO,OAAM,MAAM,QAAQ,KAAK;AAAA,UACrC,MAAK,MAAM,OAAO,UAAU,KAAK;AAAA,IACxC;AAEA,WAAO,iBAAiB,SAAS,OAAO;AACxC,WAAO,iBAAiB,sBAAsB,WAAW;AACzD,WAAO,MAAM;AACX,aAAO,oBAAoB,SAAS,OAAO;AAC3C,aAAO,oBAAoB,sBAAsB,WAAW;AAAA,IAC9D;AAAA,EACF,GAAG,CAAC,qBAAqB,KAAK,CAAC;AAE/B,EAAM,gBAAU,MAAM;AACpB,WAAO,MAAM;AACX,YAAM,OAAO,KAAK;AAAA,IACpB;AAAA,EACF,GAAG,CAAC,KAAK,CAAC;AAEV,SAAO,4CAAC,WAAW,UAAX,EAAoB,OAAe,UAAS;AACtD;;;ACpFA,IAAAA,SAAuB;AAIhB,SAAS,SAA0B;AACxC,QAAM,MAAY,kBAAW,UAAU;AACvC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;ACZA,IAAAC,SAAuB;AAIhB,SAAS,mBAAmB;AACjC,QAAM,EAAE,QAAQ,MAAM,IAAI,OAAO;AAEjC,SAAa;AAAA,IACX,CAAC,KAAc,UAAgC;AAC7C,YAAM,IAAI;AACV,YAAM,QAAoB;AAAA,QACxB,SAAS,GAAG,WAAW,OAAO,GAAG;AAAA,QACjC,OAAO,GAAG;AAAA,QACV,KACE,OAAO,aAAa,cAAc,SAAS,OAAO,OAAO,OAAO;AAAA,QAClE,OAAO;AAAA,QACP,QAAQ;AAAA,QACR,GAAG;AAAA,MACL;AACA,UAAI,MAAO,OAAM,QAAQ,KAAK;AAAA,UACzB,MAAK,OAAO,UAAU,KAAK;AAAA,IAClC;AAAA,IACA,CAAC,QAAQ,KAAK;AAAA,EAChB;AACF;;;ACxBA,IAAAC,SAAuB;AAahB,IAAM,mBAAN,cAAqC,iBAG1C;AAAA,EAHK;AAAA;AAOL,iBAAe,EAAE,OAAO,KAAK;AAAA;AAAA,EAE7B,OAAO,yBAAyB,OAAqB;AACnD,WAAO,EAAE,MAAM;AAAA,EACjB;AAAA,EAEA,kBAAkB,OAAc,MAAuB;AACrD,SAAK,MAAM,UAAU,OAAO,IAAI;AAChC,UAAM,MAAM,KAAK;AACjB,QAAI,CAAC,IAAK;AACV,UAAM,QAAQ;AAAA,MACZ,SAAS,MAAM;AAAA,MACf,OAAO,MAAM;AAAA,MACb,gBAAgB,KAAK,kBAAkB;AAAA,MACvC,KAAK,OAAO,aAAa,cAAc,SAAS,OAAO;AAAA,MACvD,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AACA,QAAI,IAAI,MAAO,KAAI,MAAM,QAAQ,KAAK;AAAA,QACjC,MAAK,IAAI,OAAO,UAAU,KAAK;AAAA,EACtC;AAAA,EAEA,SAAS;AACP,QAAI,KAAK,MAAM,OAAO;AACpB,YAAM,EAAE,SAAS,IAAI,KAAK;AAC1B,UAAI,OAAO,aAAa,WAAY,QAAO,SAAS,KAAK,MAAM,KAAK;AACpE,aAAO,YAAY;AAAA,IACrB;AACA,WAAO,KAAK,MAAM;AAAA,EACpB;AACF;AArCa,iBAIJ,cAAc;;;ACPjB,IAAAC,sBAAA;AANC,SAAS,mBACdC,YACA,eACa;AACb,QAAM,UAAuB,CAAC,UAC5B,6CAAC,oBAAkB,GAAG,eACpB,uDAACA,YAAA,EAAW,GAAG,OAAO,GACxB;AAEF,UAAQ,cAAc,sBACpBA,WAAU,eAAeA,WAAU,QAAQ,WAC7C;AACA,SAAO;AACT;","names":["React","React","React","import_jsx_runtime","Component"]}
+{"version":3,"sources":["../src/index.ts","../src/ELSProvider.tsx","../src/useELS.ts","../src/useErrorReporter.ts","../src/ELSErrorBoundary.tsx","../src/withErrorReporting.tsx"],"sourcesContent":["export { ELSProvider, ELSContext } from \"./ELSProvider.js\";\nexport { useELS } from \"./useELS.js\";\nexport { useErrorReporter } from \"./useErrorReporter.js\";\nexport { ELSErrorBoundary } from \"./ELSErrorBoundary.js\";\nexport { withErrorReporting } from \"./withErrorReporting.js\";\nexport type { ELSProviderProps } from \"./ELSProvider.js\";\n","import * as React from \"react\";\nimport { ELSClient, ELSQueue } from \"@inso_web/els-client\";\nimport type { ELSConfig } from \"@inso_web/els-client\";\n\n/** Value provided by {@link ELSProvider} and read via {@link useELS}. */\nexport interface ELSContextValue {\n  /** The shared ELS client. */\n  client: ELSClient;\n  /** The batching queue, or `null` when `useQueue` is disabled. */\n  queue: ELSQueue | null;\n}\n\n/** React context holding the ELS client/queue. Prefer the {@link useELS} hook. */\nexport const ELSContext = React.createContext<ELSContextValue | null>(null);\n\n/** Props for {@link ELSProvider}. */\nexport interface ELSProviderProps {\n  /** ELS client configuration (only `apiKey` + `appSlug` are required). */\n  config: ELSConfig;\n  /** Use a batching queue. Default: `true`. */\n  useQueue?: boolean;\n  /** Queue auto-flush interval, in ms. */\n  flushIntervalMs?: number;\n  /** Max entries buffered before an early flush. */\n  maxBatchSize?: number;\n  /** Auto-subscribe to `window.onerror` and `unhandledrejection`. Default: `true`. */\n  captureGlobalErrors?: boolean;\n  children?: React.ReactNode;\n}\n\n/**\n * Provides a single ELS client (and optional queue) to the React tree and, by\n * default, captures uncaught errors and unhandled promise rejections. Wrap your\n * app once near the root.\n *\n * @example\n * <ELSProvider config={{ apiKey: \"els_live_…\", appSlug: \"web\" }}>\n *   <App />\n * </ELSProvider>\n */\nexport const ELSProvider: React.FC<ELSProviderProps> = ({\n  config,\n  useQueue = true,\n  flushIntervalMs,\n  maxBatchSize,\n  captureGlobalErrors = true,\n  children,\n}) => {\n  const value = React.useMemo<ELSContextValue>(() => {\n    const client = new ELSClient(config);\n    const queue = useQueue\n      ? new ELSQueue(client, { flushIntervalMs, maxBatchSize })\n      : null;\n    return { client, queue };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  React.useEffect(() => {\n    if (!captureGlobalErrors || typeof window === \"undefined\") return;\n\n    const onError = (event: ErrorEvent) => {\n      const entry = {\n        message: event.message || \"window.onerror\",\n        stack: event.error?.stack,\n        level: \"error\" as const,\n      };\n      if (value.queue) value.queue.enqueue(entry);\n      else void value.client.sendError(entry);\n    };\n\n    const onRejection = (event: PromiseRejectionEvent) => {\n      const reason = event.reason;\n      const entry = {\n        message: String(reason?.message ?? reason ?? \"unhandledrejection\"),\n        stack: reason?.stack,\n        level: \"error\" as const,\n      };\n      if (value.queue) value.queue.enqueue(entry);\n      else void value.client.sendError(entry);\n    };\n\n    window.addEventListener(\"error\", onError);\n    window.addEventListener(\"unhandledrejection\", onRejection);\n    return () => {\n      window.removeEventListener(\"error\", onError);\n      window.removeEventListener(\"unhandledrejection\", onRejection);\n    };\n  }, [captureGlobalErrors, value]);\n\n  React.useEffect(() => {\n    return () => {\n      value.queue?.stop();\n    };\n  }, [value]);\n\n  return <ELSContext.Provider value={value}>{children}</ELSContext.Provider>;\n};\n","import * as React from \"react\";\nimport { ELSContext } from \"./ELSProvider.js\";\nimport type { ELSContextValue } from \"./ELSProvider.js\";\n\n/**\n * Returns the ELS `client` and `queue` from the nearest {@link ELSProvider}.\n * Throws if no provider is present.\n *\n * @example\n * const { client } = useELS();\n * client.info(\"dashboard opened\");\n */\nexport function useELS(): ELSContextValue {\n  const ctx = React.useContext(ELSContext);\n  if (!ctx) {\n    throw new Error(\n      \"useELS: no ELSProvider found. Wrap your app in <ELSProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import * as React from \"react\";\nimport type { ErrorEntry } from \"@inso_web/els-client\";\nimport { useELS } from \"./useELS.js\";\n\n/**\n * Returns a stable `report(error, extra?)` callback that sends an error to ELS\n * (through the provider's queue when enabled). Use it for handled/caught errors.\n *\n * @example\n * const report = useErrorReporter();\n * try { await save(); } catch (e) { report(e, { url: \"/save\" }); }\n */\nexport function useErrorReporter() {\n  const { client, queue } = useELS();\n\n  return React.useCallback(\n    (err: unknown, extra?: Partial<ErrorEntry>) => {\n      const e = err as Error | undefined;\n      const entry: ErrorEntry = {\n        message: e?.message ?? String(err),\n        stack: e?.stack,\n        level: \"error\",\n        ...extra,\n      };\n      if (queue) queue.enqueue(entry);\n      else void client.sendError(entry);\n    },\n    [client, queue],\n  );\n}\n","import * as React from \"react\";\nimport { ELSContext } from \"./ELSProvider.js\";\n\n/** Props for {@link ELSErrorBoundary}. */\nexport interface ELSErrorBoundaryProps {\n  /** Rendered when a child throws. A function receives the caught error. */\n  fallback?: React.ReactNode | ((error: Error) => React.ReactNode);\n  /** Called in addition to reporting, e.g. for custom logging. */\n  onError?: (error: Error, info: React.ErrorInfo) => void;\n  children?: React.ReactNode;\n}\n\ninterface State {\n  error: Error | null;\n}\n\n/**\n * Error boundary that reports render errors (with component stack) to ELS via\n * the surrounding {@link ELSProvider} and shows an optional `fallback`.\n *\n * @example\n * <ELSErrorBoundary fallback={<p>Something went wrong</p>}>\n *   <Dashboard />\n * </ELSErrorBoundary>\n */\nexport class ELSErrorBoundary extends React.Component<\n  ELSErrorBoundaryProps,\n  State\n> {\n  static contextType = ELSContext;\n  declare context: React.ContextType<typeof ELSContext>;\n\n  state: State = { error: null };\n\n  static getDerivedStateFromError(error: Error): State {\n    return { error };\n  }\n\n  componentDidCatch(error: Error, info: React.ErrorInfo) {\n    this.props.onError?.(error, info);\n    const ctx = this.context;\n    if (!ctx) return;\n    const entry = {\n      message: error.message,\n      stack: error.stack,\n      componentStack: info.componentStack ?? undefined,\n      level: \"error\" as const,\n    };\n    if (ctx.queue) ctx.queue.enqueue(entry);\n    else void ctx.client.sendError(entry);\n  }\n\n  render() {\n    if (this.state.error) {\n      const { fallback } = this.props;\n      if (typeof fallback === \"function\") return fallback(this.state.error);\n      return fallback ?? null;\n    }\n    return this.props.children;\n  }\n}\n","import * as React from \"react\";\nimport { ELSErrorBoundary } from \"./ELSErrorBoundary.js\";\nimport type { ELSErrorBoundaryProps } from \"./ELSErrorBoundary.js\";\n\n/**\n * HOC that wraps a component in an {@link ELSErrorBoundary}.\n *\n * @example\n * export default withErrorReporting(Dashboard, { fallback: <ErrorPage /> });\n */\nexport function withErrorReporting<P extends object>(\n  Component: React.ComponentType<P>,\n  boundaryProps?: Omit<ELSErrorBoundaryProps, \"children\">,\n): React.FC<P> {\n  const Wrapped: React.FC<P> = (props) => (\n    <ELSErrorBoundary {...boundaryProps}>\n      <Component {...props} />\n    </ELSErrorBoundary>\n  );\n  Wrapped.displayName = `withErrorReporting(${\n    Component.displayName ?? Component.name ?? \"Component\"\n  })`;\n  return Wrapped;\n}\n"],"mappings":"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","names":["React","React","React","import_jsx_runtime","Component"]}

package/dist/index.d.cts

@@ -1,37 +1,81 @@
 import * as React from 'react';
 import { ELSClient, ELSQueue, ELSConfig, ErrorEntry } from '@inso_web/els-client';
 
+/** Value provided by {@link ELSProvider} and read via {@link useELS}. */
 interface ELSContextValue {
+    /** The shared ELS client. */
     client: ELSClient;
+    /** The batching queue, or `null` when `useQueue` is disabled. */
     queue: ELSQueue | null;
 }
+/** React context holding the ELS client/queue. Prefer the {@link useELS} hook. */
 declare const ELSContext: React.Context<ELSContextValue | null>;
+/** Props for {@link ELSProvider}. */
 interface ELSProviderProps {
+    /** ELS client configuration (only `apiKey` + `appSlug` are required). */
     config: ELSConfig;
-    /** Включить очередь с батчингом. По умолчанию true. */
+    /** Use a batching queue. Default: `true`. */
     useQueue?: boolean;
-    /** Интервал авто‑флаша очереди в мс. */
+    /** Queue auto-flush interval, in ms. */
     flushIntervalMs?: number;
-    /** Максимальный размер батча. */
+    /** Max entries buffered before an early flush. */
     maxBatchSize?: number;
-    /** Авто‑подписка на window.onerror и unhandledrejection. По умолчанию true. */
+    /** Auto-subscribe to `window.onerror` and `unhandledrejection`. Default: `true`. */
     captureGlobalErrors?: boolean;
     children?: React.ReactNode;
 }
+/**
+ * Provides a single ELS client (and optional queue) to the React tree and, by
+ * default, captures uncaught errors and unhandled promise rejections. Wrap your
+ * app once near the root.
+ *
+ * @example
+ * <ELSProvider config={{ apiKey: "els_live_…", appSlug: "web" }}>
+ *   <App />
+ * </ELSProvider>
+ */
 declare const ELSProvider: React.FC<ELSProviderProps>;
 
+/**
+ * Returns the ELS `client` and `queue` from the nearest {@link ELSProvider}.
+ * Throws if no provider is present.
+ *
+ * @example
+ * const { client } = useELS();
+ * client.info("dashboard opened");
+ */
 declare function useELS(): ELSContextValue;
 
+/**
+ * Returns a stable `report(error, extra?)` callback that sends an error to ELS
+ * (through the provider's queue when enabled). Use it for handled/caught errors.
+ *
+ * @example
+ * const report = useErrorReporter();
+ * try { await save(); } catch (e) { report(e, { url: "/save" }); }
+ */
 declare function useErrorReporter(): (err: unknown, extra?: Partial<ErrorEntry>) => void;
 
+/** Props for {@link ELSErrorBoundary}. */
 interface ELSErrorBoundaryProps {
+    /** Rendered when a child throws. A function receives the caught error. */
     fallback?: React.ReactNode | ((error: Error) => React.ReactNode);
+    /** Called in addition to reporting, e.g. for custom logging. */
     onError?: (error: Error, info: React.ErrorInfo) => void;
     children?: React.ReactNode;
 }
 interface State {
     error: Error | null;
 }
+/**
+ * Error boundary that reports render errors (with component stack) to ELS via
+ * the surrounding {@link ELSProvider} and shows an optional `fallback`.
+ *
+ * @example
+ * <ELSErrorBoundary fallback={<p>Something went wrong</p>}>
+ *   <Dashboard />
+ * </ELSErrorBoundary>
+ */
 declare class ELSErrorBoundary extends React.Component<ELSErrorBoundaryProps, State> {
     static contextType: React.Context<ELSContextValue | null>;
     context: React.ContextType<typeof ELSContext>;
@@ -41,6 +85,12 @@ declare class ELSErrorBoundary extends React.Component<ELSErrorBoundaryProps, St
     render(): React.ReactNode;
 }
 
+/**
+ * HOC that wraps a component in an {@link ELSErrorBoundary}.
+ *
+ * @example
+ * export default withErrorReporting(Dashboard, { fallback: <ErrorPage /> });
+ */
 declare function withErrorReporting<P extends object>(Component: React.ComponentType<P>, boundaryProps?: Omit<ELSErrorBoundaryProps, "children">): React.FC<P>;
 
 export { ELSContext, ELSErrorBoundary, ELSProvider, type ELSProviderProps, useELS, useErrorReporter, withErrorReporting };

package/dist/index.d.ts

@@ -1,37 +1,81 @@
 import * as React from 'react';
 import { ELSClient, ELSQueue, ELSConfig, ErrorEntry } from '@inso_web/els-client';
 
+/** Value provided by {@link ELSProvider} and read via {@link useELS}. */
 interface ELSContextValue {
+    /** The shared ELS client. */
     client: ELSClient;
+    /** The batching queue, or `null` when `useQueue` is disabled. */
     queue: ELSQueue | null;
 }
+/** React context holding the ELS client/queue. Prefer the {@link useELS} hook. */
 declare const ELSContext: React.Context<ELSContextValue | null>;
+/** Props for {@link ELSProvider}. */
 interface ELSProviderProps {
+    /** ELS client configuration (only `apiKey` + `appSlug` are required). */
     config: ELSConfig;
-    /** Включить очередь с батчингом. По умолчанию true. */
+    /** Use a batching queue. Default: `true`. */
     useQueue?: boolean;
-    /** Интервал авто‑флаша очереди в мс. */
+    /** Queue auto-flush interval, in ms. */
     flushIntervalMs?: number;
-    /** Максимальный размер батча. */
+    /** Max entries buffered before an early flush. */
     maxBatchSize?: number;
-    /** Авто‑подписка на window.onerror и unhandledrejection. По умолчанию true. */
+    /** Auto-subscribe to `window.onerror` and `unhandledrejection`. Default: `true`. */
     captureGlobalErrors?: boolean;
     children?: React.ReactNode;
 }
+/**
+ * Provides a single ELS client (and optional queue) to the React tree and, by
+ * default, captures uncaught errors and unhandled promise rejections. Wrap your
+ * app once near the root.
+ *
+ * @example
+ * <ELSProvider config={{ apiKey: "els_live_…", appSlug: "web" }}>
+ *   <App />
+ * </ELSProvider>
+ */
 declare const ELSProvider: React.FC<ELSProviderProps>;
 
+/**
+ * Returns the ELS `client` and `queue` from the nearest {@link ELSProvider}.
+ * Throws if no provider is present.
+ *
+ * @example
+ * const { client } = useELS();
+ * client.info("dashboard opened");
+ */
 declare function useELS(): ELSContextValue;
 
+/**
+ * Returns a stable `report(error, extra?)` callback that sends an error to ELS
+ * (through the provider's queue when enabled). Use it for handled/caught errors.
+ *
+ * @example
+ * const report = useErrorReporter();
+ * try { await save(); } catch (e) { report(e, { url: "/save" }); }
+ */
 declare function useErrorReporter(): (err: unknown, extra?: Partial<ErrorEntry>) => void;
 
+/** Props for {@link ELSErrorBoundary}. */
 interface ELSErrorBoundaryProps {
+    /** Rendered when a child throws. A function receives the caught error. */
     fallback?: React.ReactNode | ((error: Error) => React.ReactNode);
+    /** Called in addition to reporting, e.g. for custom logging. */
     onError?: (error: Error, info: React.ErrorInfo) => void;
     children?: React.ReactNode;
 }
 interface State {
     error: Error | null;
 }
+/**
+ * Error boundary that reports render errors (with component stack) to ELS via
+ * the surrounding {@link ELSProvider} and shows an optional `fallback`.
+ *
+ * @example
+ * <ELSErrorBoundary fallback={<p>Something went wrong</p>}>
+ *   <Dashboard />
+ * </ELSErrorBoundary>
+ */
 declare class ELSErrorBoundary extends React.Component<ELSErrorBoundaryProps, State> {
     static contextType: React.Context<ELSContextValue | null>;
     context: React.ContextType<typeof ELSContext>;
@@ -41,6 +85,12 @@ declare class ELSErrorBoundary extends React.Component<ELSErrorBoundaryProps, St
     render(): React.ReactNode;
 }
 
+/**
+ * HOC that wraps a component in an {@link ELSErrorBoundary}.
+ *
+ * @example
+ * export default withErrorReporting(Dashboard, { fallback: <ErrorPage /> });
+ */
 declare function withErrorReporting<P extends object>(Component: React.ComponentType<P>, boundaryProps?: Omit<ELSErrorBoundaryProps, "children">): React.FC<P>;
 
 export { ELSContext, ELSErrorBoundary, ELSProvider, type ELSProviderProps, useELS, useErrorReporter, withErrorReporting };

package/dist/index.js

@@ -21,10 +21,8 @@ var ELSProvider = ({
     const onError = (event) => {
       const entry = {
         message: event.message || "window.onerror",
-        url: typeof location !== "undefined" ? location.href : "",
         stack: event.error?.stack,
-        level: "error",
-        source: "client"
+        level: "error"
       };
       if (value.queue) value.queue.enqueue(entry);
       else void value.client.sendError(entry);
@@ -33,10 +31,8 @@ var ELSProvider = ({
       const reason = event.reason;
       const entry = {
         message: String(reason?.message ?? reason ?? "unhandledrejection"),
-        url: typeof location !== "undefined" ? location.href : "",
         stack: reason?.stack,
-        level: "error",
-        source: "client"
+        level: "error"
       };
       if (value.queue) value.queue.enqueue(entry);
       else void value.client.sendError(entry);
@@ -62,7 +58,7 @@ function useELS() {
   const ctx = React2.useContext(ELSContext);
   if (!ctx) {
     throw new Error(
-      "useELS: ELSProvider \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D. \u041E\u0431\u0435\u0440\u043D\u0438\u0442\u0435 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435 \u0432 <ELSProvider>."
+      "useELS: no ELSProvider found. Wrap your app in <ELSProvider>."
     );
   }
   return ctx;
@@ -78,9 +74,7 @@ function useErrorReporter() {
       const entry = {
         message: e?.message ?? String(err),
         stack: e?.stack,
-        url: typeof location !== "undefined" ? location.href : extra?.url ?? "",
         level: "error",
-        source: "client",
         ...extra
       };
       if (queue) queue.enqueue(entry);
@@ -108,9 +102,7 @@ var ELSErrorBoundary = class extends React4.Component {
       message: error.message,
       stack: error.stack,
       componentStack: info.componentStack ?? void 0,
-      url: typeof location !== "undefined" ? location.href : "",
-      level: "error",
-      source: "client"
+      level: "error"
     };
     if (ctx.queue) ctx.queue.enqueue(entry);
     else void ctx.client.sendError(entry);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ELSProvider.tsx","../src/useELS.ts","../src/useErrorReporter.ts","../src/ELSErrorBoundary.tsx","../src/withErrorReporting.tsx"],"sourcesContent":["import * as React from \"react\";\nimport { ELSClient, ELSQueue } from \"@inso_web/els-client\";\nimport type { ELSConfig } from \"@inso_web/els-client\";\n\nexport interface ELSContextValue {\n  client: ELSClient;\n  queue: ELSQueue | null;\n}\n\nexport const ELSContext = React.createContext<ELSContextValue | null>(null);\n\nexport interface ELSProviderProps {\n  config: ELSConfig;\n  /** Включить очередь с батчингом. По умолчанию true. */\n  useQueue?: boolean;\n  /** Интервал авто‑флаша очереди в мс. */\n  flushIntervalMs?: number;\n  /** Максимальный размер батча. */\n  maxBatchSize?: number;\n  /** Авто‑подписка на window.onerror и unhandledrejection. По умолчанию true. */\n  captureGlobalErrors?: boolean;\n  children?: React.ReactNode;\n}\n\nexport const ELSProvider: React.FC<ELSProviderProps> = ({\n  config,\n  useQueue = true,\n  flushIntervalMs,\n  maxBatchSize,\n  captureGlobalErrors = true,\n  children,\n}) => {\n  const value = React.useMemo<ELSContextValue>(() => {\n    const client = new ELSClient(config);\n    const queue = useQueue\n      ? new ELSQueue(client, { flushIntervalMs, maxBatchSize })\n      : null;\n    return { client, queue };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  React.useEffect(() => {\n    if (!captureGlobalErrors || typeof window === \"undefined\") return;\n\n    const onError = (event: ErrorEvent) => {\n      const entry = {\n        message: event.message || \"window.onerror\",\n        url: typeof location !== \"undefined\" ? location.href : \"\",\n        stack: event.error?.stack,\n        level: \"error\" as const,\n        source: \"client\" as const,\n      };\n      if (value.queue) value.queue.enqueue(entry);\n      else void value.client.sendError(entry);\n    };\n\n    const onRejection = (event: PromiseRejectionEvent) => {\n      const reason = event.reason;\n      const entry = {\n        message: String(reason?.message ?? reason ?? \"unhandledrejection\"),\n        url: typeof location !== \"undefined\" ? location.href : \"\",\n        stack: reason?.stack,\n        level: \"error\" as const,\n        source: \"client\" as const,\n      };\n      if (value.queue) value.queue.enqueue(entry);\n      else void value.client.sendError(entry);\n    };\n\n    window.addEventListener(\"error\", onError);\n    window.addEventListener(\"unhandledrejection\", onRejection);\n    return () => {\n      window.removeEventListener(\"error\", onError);\n      window.removeEventListener(\"unhandledrejection\", onRejection);\n    };\n  }, [captureGlobalErrors, value]);\n\n  React.useEffect(() => {\n    return () => {\n      value.queue?.stop();\n    };\n  }, [value]);\n\n  return <ELSContext.Provider value={value}>{children}</ELSContext.Provider>;\n};\n","import * as React from \"react\";\nimport { ELSContext } from \"./ELSProvider.js\";\nimport type { ELSContextValue } from \"./ELSProvider.js\";\n\nexport function useELS(): ELSContextValue {\n  const ctx = React.useContext(ELSContext);\n  if (!ctx) {\n    throw new Error(\n      \"useELS: ELSProvider не найден. Оберните приложение в <ELSProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import * as React from \"react\";\nimport type { ErrorEntry } from \"@inso_web/els-client\";\nimport { useELS } from \"./useELS.js\";\n\nexport function useErrorReporter() {\n  const { client, queue } = useELS();\n\n  return React.useCallback(\n    (err: unknown, extra?: Partial<ErrorEntry>) => {\n      const e = err as Error | undefined;\n      const entry: ErrorEntry = {\n        message: e?.message ?? String(err),\n        stack: e?.stack,\n        url:\n          typeof location !== \"undefined\" ? location.href : extra?.url ?? \"\",\n        level: \"error\",\n        source: \"client\",\n        ...extra,\n      };\n      if (queue) queue.enqueue(entry);\n      else void client.sendError(entry);\n    },\n    [client, queue],\n  );\n}\n","import * as React from \"react\";\nimport { ELSContext } from \"./ELSProvider.js\";\n\nexport interface ELSErrorBoundaryProps {\n  fallback?: React.ReactNode | ((error: Error) => React.ReactNode);\n  onError?: (error: Error, info: React.ErrorInfo) => void;\n  children?: React.ReactNode;\n}\n\ninterface State {\n  error: Error | null;\n}\n\nexport class ELSErrorBoundary extends React.Component<\n  ELSErrorBoundaryProps,\n  State\n> {\n  static contextType = ELSContext;\n  declare context: React.ContextType<typeof ELSContext>;\n\n  state: State = { error: null };\n\n  static getDerivedStateFromError(error: Error): State {\n    return { error };\n  }\n\n  componentDidCatch(error: Error, info: React.ErrorInfo) {\n    this.props.onError?.(error, info);\n    const ctx = this.context;\n    if (!ctx) return;\n    const entry = {\n      message: error.message,\n      stack: error.stack,\n      componentStack: info.componentStack ?? undefined,\n      url: typeof location !== \"undefined\" ? location.href : \"\",\n      level: \"error\" as const,\n      source: \"client\" as const,\n    };\n    if (ctx.queue) ctx.queue.enqueue(entry);\n    else void ctx.client.sendError(entry);\n  }\n\n  render() {\n    if (this.state.error) {\n      const { fallback } = this.props;\n      if (typeof fallback === \"function\") return fallback(this.state.error);\n      return fallback ?? null;\n    }\n    return this.props.children;\n  }\n}\n","import * as React from \"react\";\nimport { ELSErrorBoundary } from \"./ELSErrorBoundary.js\";\nimport type { ELSErrorBoundaryProps } from \"./ELSErrorBoundary.js\";\n\nexport function withErrorReporting<P extends object>(\n  Component: React.ComponentType<P>,\n  boundaryProps?: Omit<ELSErrorBoundaryProps, \"children\">,\n): React.FC<P> {\n  const Wrapped: React.FC<P> = (props) => (\n    <ELSErrorBoundary {...boundaryProps}>\n      <Component {...props} />\n    </ELSErrorBoundary>\n  );\n  Wrapped.displayName = `withErrorReporting(${\n    Component.displayName ?? Component.name ?? \"Component\"\n  })`;\n  return Wrapped;\n}\n"],"mappings":";AAAA,YAAY,WAAW;AACvB,SAAS,WAAW,gBAAgB;AAkF3B;AA1EF,IAAM,aAAmB,oBAAsC,IAAI;AAenE,IAAM,cAA0C,CAAC;AAAA,EACtD;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA,sBAAsB;AAAA,EACtB;AACF,MAAM;AACJ,QAAM,QAAc,cAAyB,MAAM;AACjD,UAAM,SAAS,IAAI,UAAU,MAAM;AACnC,UAAM,QAAQ,WACV,IAAI,SAAS,QAAQ,EAAE,iBAAiB,aAAa,CAAC,IACtD;AACJ,WAAO,EAAE,QAAQ,MAAM;AAAA,EAEzB,GAAG,CAAC,CAAC;AAEL,EAAM,gBAAU,MAAM;AACpB,QAAI,CAAC,uBAAuB,OAAO,WAAW,YAAa;AAE3D,UAAM,UAAU,CAAC,UAAsB;AACrC,YAAM,QAAQ;AAAA,QACZ,SAAS,MAAM,WAAW;AAAA,QAC1B,KAAK,OAAO,aAAa,cAAc,SAAS,OAAO;AAAA,QACvD,OAAO,MAAM,OAAO;AAAA,QACpB,OAAO;AAAA,QACP,QAAQ;AAAA,MACV;AACA,UAAI,MAAM,MAAO,OAAM,MAAM,QAAQ,KAAK;AAAA,UACrC,MAAK,MAAM,OAAO,UAAU,KAAK;AAAA,IACxC;AAEA,UAAM,cAAc,CAAC,UAAiC;AACpD,YAAM,SAAS,MAAM;AACrB,YAAM,QAAQ;AAAA,QACZ,SAAS,OAAO,QAAQ,WAAW,UAAU,oBAAoB;AAAA,QACjE,KAAK,OAAO,aAAa,cAAc,SAAS,OAAO;AAAA,QACvD,OAAO,QAAQ;AAAA,QACf,OAAO;AAAA,QACP,QAAQ;AAAA,MACV;AACA,UAAI,MAAM,MAAO,OAAM,MAAM,QAAQ,KAAK;AAAA,UACrC,MAAK,MAAM,OAAO,UAAU,KAAK;AAAA,IACxC;AAEA,WAAO,iBAAiB,SAAS,OAAO;AACxC,WAAO,iBAAiB,sBAAsB,WAAW;AACzD,WAAO,MAAM;AACX,aAAO,oBAAoB,SAAS,OAAO;AAC3C,aAAO,oBAAoB,sBAAsB,WAAW;AAAA,IAC9D;AAAA,EACF,GAAG,CAAC,qBAAqB,KAAK,CAAC;AAE/B,EAAM,gBAAU,MAAM;AACpB,WAAO,MAAM;AACX,YAAM,OAAO,KAAK;AAAA,IACpB;AAAA,EACF,GAAG,CAAC,KAAK,CAAC;AAEV,SAAO,oBAAC,WAAW,UAAX,EAAoB,OAAe,UAAS;AACtD;;;ACpFA,YAAYA,YAAW;AAIhB,SAAS,SAA0B;AACxC,QAAM,MAAY,kBAAW,UAAU;AACvC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;ACZA,YAAYC,YAAW;AAIhB,SAAS,mBAAmB;AACjC,QAAM,EAAE,QAAQ,MAAM,IAAI,OAAO;AAEjC,SAAa;AAAA,IACX,CAAC,KAAc,UAAgC;AAC7C,YAAM,IAAI;AACV,YAAM,QAAoB;AAAA,QACxB,SAAS,GAAG,WAAW,OAAO,GAAG;AAAA,QACjC,OAAO,GAAG;AAAA,QACV,KACE,OAAO,aAAa,cAAc,SAAS,OAAO,OAAO,OAAO;AAAA,QAClE,OAAO;AAAA,QACP,QAAQ;AAAA,QACR,GAAG;AAAA,MACL;AACA,UAAI,MAAO,OAAM,QAAQ,KAAK;AAAA,UACzB,MAAK,OAAO,UAAU,KAAK;AAAA,IAClC;AAAA,IACA,CAAC,QAAQ,KAAK;AAAA,EAChB;AACF;;;ACxBA,YAAYC,YAAW;AAahB,IAAM,mBAAN,cAAqC,iBAG1C;AAAA,EAHK;AAAA;AAOL,iBAAe,EAAE,OAAO,KAAK;AAAA;AAAA,EAE7B,OAAO,yBAAyB,OAAqB;AACnD,WAAO,EAAE,MAAM;AAAA,EACjB;AAAA,EAEA,kBAAkB,OAAc,MAAuB;AACrD,SAAK,MAAM,UAAU,OAAO,IAAI;AAChC,UAAM,MAAM,KAAK;AACjB,QAAI,CAAC,IAAK;AACV,UAAM,QAAQ;AAAA,MACZ,SAAS,MAAM;AAAA,MACf,OAAO,MAAM;AAAA,MACb,gBAAgB,KAAK,kBAAkB;AAAA,MACvC,KAAK,OAAO,aAAa,cAAc,SAAS,OAAO;AAAA,MACvD,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AACA,QAAI,IAAI,MAAO,KAAI,MAAM,QAAQ,KAAK;AAAA,QACjC,MAAK,IAAI,OAAO,UAAU,KAAK;AAAA,EACtC;AAAA,EAEA,SAAS;AACP,QAAI,KAAK,MAAM,OAAO;AACpB,YAAM,EAAE,SAAS,IAAI,KAAK;AAC1B,UAAI,OAAO,aAAa,WAAY,QAAO,SAAS,KAAK,MAAM,KAAK;AACpE,aAAO,YAAY;AAAA,IACrB;AACA,WAAO,KAAK,MAAM;AAAA,EACpB;AACF;AArCa,iBAIJ,cAAc;;;ACPjB,gBAAAC,YAAA;AANC,SAAS,mBACdC,YACA,eACa;AACb,QAAM,UAAuB,CAAC,UAC5B,gBAAAD,KAAC,oBAAkB,GAAG,eACpB,0BAAAA,KAACC,YAAA,EAAW,GAAG,OAAO,GACxB;AAEF,UAAQ,cAAc,sBACpBA,WAAU,eAAeA,WAAU,QAAQ,WAC7C;AACA,SAAO;AACT;","names":["React","React","React","jsx","Component"]}
+{"version":3,"sources":["../src/ELSProvider.tsx","../src/useELS.ts","../src/useErrorReporter.ts","../src/ELSErrorBoundary.tsx","../src/withErrorReporting.tsx"],"sourcesContent":["import * as React from \"react\";\nimport { ELSClient, ELSQueue } from \"@inso_web/els-client\";\nimport type { ELSConfig } from \"@inso_web/els-client\";\n\n/** Value provided by {@link ELSProvider} and read via {@link useELS}. */\nexport interface ELSContextValue {\n  /** The shared ELS client. */\n  client: ELSClient;\n  /** The batching queue, or `null` when `useQueue` is disabled. */\n  queue: ELSQueue | null;\n}\n\n/** React context holding the ELS client/queue. Prefer the {@link useELS} hook. */\nexport const ELSContext = React.createContext<ELSContextValue | null>(null);\n\n/** Props for {@link ELSProvider}. */\nexport interface ELSProviderProps {\n  /** ELS client configuration (only `apiKey` + `appSlug` are required). */\n  config: ELSConfig;\n  /** Use a batching queue. Default: `true`. */\n  useQueue?: boolean;\n  /** Queue auto-flush interval, in ms. */\n  flushIntervalMs?: number;\n  /** Max entries buffered before an early flush. */\n  maxBatchSize?: number;\n  /** Auto-subscribe to `window.onerror` and `unhandledrejection`. Default: `true`. */\n  captureGlobalErrors?: boolean;\n  children?: React.ReactNode;\n}\n\n/**\n * Provides a single ELS client (and optional queue) to the React tree and, by\n * default, captures uncaught errors and unhandled promise rejections. Wrap your\n * app once near the root.\n *\n * @example\n * <ELSProvider config={{ apiKey: \"els_live_…\", appSlug: \"web\" }}>\n *   <App />\n * </ELSProvider>\n */\nexport const ELSProvider: React.FC<ELSProviderProps> = ({\n  config,\n  useQueue = true,\n  flushIntervalMs,\n  maxBatchSize,\n  captureGlobalErrors = true,\n  children,\n}) => {\n  const value = React.useMemo<ELSContextValue>(() => {\n    const client = new ELSClient(config);\n    const queue = useQueue\n      ? new ELSQueue(client, { flushIntervalMs, maxBatchSize })\n      : null;\n    return { client, queue };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  React.useEffect(() => {\n    if (!captureGlobalErrors || typeof window === \"undefined\") return;\n\n    const onError = (event: ErrorEvent) => {\n      const entry = {\n        message: event.message || \"window.onerror\",\n        stack: event.error?.stack,\n        level: \"error\" as const,\n      };\n      if (value.queue) value.queue.enqueue(entry);\n      else void value.client.sendError(entry);\n    };\n\n    const onRejection = (event: PromiseRejectionEvent) => {\n      const reason = event.reason;\n      const entry = {\n        message: String(reason?.message ?? reason ?? \"unhandledrejection\"),\n        stack: reason?.stack,\n        level: \"error\" as const,\n      };\n      if (value.queue) value.queue.enqueue(entry);\n      else void value.client.sendError(entry);\n    };\n\n    window.addEventListener(\"error\", onError);\n    window.addEventListener(\"unhandledrejection\", onRejection);\n    return () => {\n      window.removeEventListener(\"error\", onError);\n      window.removeEventListener(\"unhandledrejection\", onRejection);\n    };\n  }, [captureGlobalErrors, value]);\n\n  React.useEffect(() => {\n    return () => {\n      value.queue?.stop();\n    };\n  }, [value]);\n\n  return <ELSContext.Provider value={value}>{children}</ELSContext.Provider>;\n};\n","import * as React from \"react\";\nimport { ELSContext } from \"./ELSProvider.js\";\nimport type { ELSContextValue } from \"./ELSProvider.js\";\n\n/**\n * Returns the ELS `client` and `queue` from the nearest {@link ELSProvider}.\n * Throws if no provider is present.\n *\n * @example\n * const { client } = useELS();\n * client.info(\"dashboard opened\");\n */\nexport function useELS(): ELSContextValue {\n  const ctx = React.useContext(ELSContext);\n  if (!ctx) {\n    throw new Error(\n      \"useELS: no ELSProvider found. Wrap your app in <ELSProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import * as React from \"react\";\nimport type { ErrorEntry } from \"@inso_web/els-client\";\nimport { useELS } from \"./useELS.js\";\n\n/**\n * Returns a stable `report(error, extra?)` callback that sends an error to ELS\n * (through the provider's queue when enabled). Use it for handled/caught errors.\n *\n * @example\n * const report = useErrorReporter();\n * try { await save(); } catch (e) { report(e, { url: \"/save\" }); }\n */\nexport function useErrorReporter() {\n  const { client, queue } = useELS();\n\n  return React.useCallback(\n    (err: unknown, extra?: Partial<ErrorEntry>) => {\n      const e = err as Error | undefined;\n      const entry: ErrorEntry = {\n        message: e?.message ?? String(err),\n        stack: e?.stack,\n        level: \"error\",\n        ...extra,\n      };\n      if (queue) queue.enqueue(entry);\n      else void client.sendError(entry);\n    },\n    [client, queue],\n  );\n}\n","import * as React from \"react\";\nimport { ELSContext } from \"./ELSProvider.js\";\n\n/** Props for {@link ELSErrorBoundary}. */\nexport interface ELSErrorBoundaryProps {\n  /** Rendered when a child throws. A function receives the caught error. */\n  fallback?: React.ReactNode | ((error: Error) => React.ReactNode);\n  /** Called in addition to reporting, e.g. for custom logging. */\n  onError?: (error: Error, info: React.ErrorInfo) => void;\n  children?: React.ReactNode;\n}\n\ninterface State {\n  error: Error | null;\n}\n\n/**\n * Error boundary that reports render errors (with component stack) to ELS via\n * the surrounding {@link ELSProvider} and shows an optional `fallback`.\n *\n * @example\n * <ELSErrorBoundary fallback={<p>Something went wrong</p>}>\n *   <Dashboard />\n * </ELSErrorBoundary>\n */\nexport class ELSErrorBoundary extends React.Component<\n  ELSErrorBoundaryProps,\n  State\n> {\n  static contextType = ELSContext;\n  declare context: React.ContextType<typeof ELSContext>;\n\n  state: State = { error: null };\n\n  static getDerivedStateFromError(error: Error): State {\n    return { error };\n  }\n\n  componentDidCatch(error: Error, info: React.ErrorInfo) {\n    this.props.onError?.(error, info);\n    const ctx = this.context;\n    if (!ctx) return;\n    const entry = {\n      message: error.message,\n      stack: error.stack,\n      componentStack: info.componentStack ?? undefined,\n      level: \"error\" as const,\n    };\n    if (ctx.queue) ctx.queue.enqueue(entry);\n    else void ctx.client.sendError(entry);\n  }\n\n  render() {\n    if (this.state.error) {\n      const { fallback } = this.props;\n      if (typeof fallback === \"function\") return fallback(this.state.error);\n      return fallback ?? null;\n    }\n    return this.props.children;\n  }\n}\n","import * as React from \"react\";\nimport { ELSErrorBoundary } from \"./ELSErrorBoundary.js\";\nimport type { ELSErrorBoundaryProps } from \"./ELSErrorBoundary.js\";\n\n/**\n * HOC that wraps a component in an {@link ELSErrorBoundary}.\n *\n * @example\n * export default withErrorReporting(Dashboard, { fallback: <ErrorPage /> });\n */\nexport function withErrorReporting<P extends object>(\n  Component: React.ComponentType<P>,\n  boundaryProps?: Omit<ELSErrorBoundaryProps, \"children\">,\n): React.FC<P> {\n  const Wrapped: React.FC<P> = (props) => (\n    <ELSErrorBoundary {...boundaryProps}>\n      <Component {...props} />\n    </ELSErrorBoundary>\n  );\n  Wrapped.displayName = `withErrorReporting(${\n    Component.displayName ?? Component.name ?? \"Component\"\n  })`;\n  return Wrapped;\n}\n"],"mappings":"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","names":["React","React","React","jsx","Component"]}

package/examples/vite-react/src/main.tsx

@@ -8,7 +8,6 @@ ReactDOM.createRoot(document.getElementById('root')!).render(
   <React.StrictMode>
     <ELSProvider
       config={{
-        endpoint: import.meta.env.VITE_ELS_URL || 'https://api.insoweb.ru/els',
         apiKey: import.meta.env.VITE_ELS_API_KEY || 'els_live_xxxxxxxx',
         appSlug: 'examples',
         deploymentEnv: 'DEV',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inso_web/els-react",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "React‑обёртка для Error Logs Service (ELS): Provider, hooks, ErrorBoundary и HOC для автоматического репорта ошибок компонентов.",
   "homepage": "https://api.insoweb.ru/els",
   "author": "INSOWEB",
@@ -51,7 +51,7 @@
     "react": ">=17.0.0"
   },
   "dependencies": {
-    "@inso_web/els-client": "^0.4.1"
+    "@inso_web/els-client": "^0.5.0"
   },
   "devDependencies": {
     "@testing-library/react": "^14.1.2",