@pmate/log-sdk 0.2.0 → 0.2.2

package/README.md

@@ -53,3 +53,26 @@ Use authenticatedProfile from server authentication, never a client body/header.
 
 ## Counting
 The envelope `id` is the event deduplication key. PV counts pv events; sessions deduplicate `(appId, accessId)`; Profile UV deduplicates `(appId, profileId)` in a defined time window/topic. Missing identifiers are reported separately. Never count HTTP requests or vitals as page views, or infer first-ever visits from a limited retention window.
+
+## Error and crash diagnostics
+
+Caught exceptions need explicit reporting; a global rejection listener cannot see
+an exception already handled by application code. Use `log.captureError(error,
+{ operation: 'chat.send' })` on browser, React and Node loggers. Error records use
+the `error` topic and include bounded message/stack diagnostics with URL queries
+removed. Applications must redact domain-specific sensitive strings before
+calling this method.
+
+Inside `LogProvider`, wrap the application in `LogErrorBoundary` with a `fallback`
+React node. It reports descendant render/lifecycle failures with component stacks.
+Event handlers, asynchronous operations and errors above the boundary require
+separate reporting. Explicitly allowlisted `log.fetch` requests report non-2xx and
+network failures without bodies or request URLs.
+
+Node exports `installCrashReporter({ directory, send })`. Install it before
+starting the service. It monitors fatal exceptions without suppressing Node's
+fatal exit, persists up to 20 records, and exposes `replay()` for startup recovery.
+The `send(entry)` callback must resolve only after server acknowledgement, retain
+entry ID/time, and route records to the service's `crash` topic. Failed uploads
+remain on disk. Use a service-specific private persistent directory. It cannot
+capture SIGKILL, OOM kills, native faults, or failures before installation.

package/dist/browser.js

@@ -97,7 +97,15 @@ export function createLogger(options) {
                 if (!validId(headers.get(REQUEST_HEADER)))
                     headers.set(REQUEST_HEADER, crypto.randomUUID());
                 // Refuse redirects so correlation headers cannot leak to another origin.
-                return fetch(input, { ...init, headers, redirect: "error" });
+                return fetch(input, { ...init, headers, redirect: "error" }).then(response => {
+                    if (!response.ok)
+                        transport.append("error", { data: { event: "http.client.failed", origin: url.origin, status: response.status, clientRequestId: headers.get(REQUEST_HEADER), serverRequestId: response.headers.get(REQUEST_HEADER) } });
+                    return response;
+                }, error => {
+                    const failure = errorInput(error, { operation: "http.fetch" });
+                    transport.append("error", { data: { ...failure.data, origin: url.origin, clientRequestId: headers.get(REQUEST_HEADER) } });
+                    throw error;
+                });
             }
             return fetch(input, init);
         },

package/dist/node.d.ts

@@ -33,3 +33,4 @@ export declare function createLogger(options: NodeLoggerOptions): {
     close(): Promise<void>;
 };
 export { installCrashReporter } from "./crash.js";
+export { errorInput } from "./errors.js";

package/dist/node.js

@@ -131,3 +131,4 @@ export function createLogger(options) {
     };
 }
 export { installCrashReporter } from "./crash.js";
+export { errorInput } from "./errors.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/log-sdk",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "PMate browser, React and Node logs with access and profile context",
   "type": "module",
   "sideEffects": false,