@chaja/sdk-node 0.1.0 → 0.2.1

package/README.md

@@ -16,4 +16,5 @@ app.use(expressErrorHandler());
 
 Uncaught exceptions and unhandled rejections are reported with source context. Events that cannot be delivered can be kept on
 disk (`offlineDirectory`) and resent on the next start. For Hono, Next.js route handlers and other Fetch-API servers, use
-`captureRequestError(error, request)`. All options: [docs/sdk.md](https://github.com/emiliodominguez/chaja/blob/main/docs/sdk.md).
+`captureRequestError(error, request)`. A desktop app's main process passes `sessionId` for its run, and events or errors
+recorded while offline keep their time with `timestamp`. All options: [docs/sdk.md](https://github.com/emiliodominguez/chaja/blob/main/docs/sdk.md).

package/dist/index.d.mts

@@ -31,6 +31,12 @@ export interface NodeOptions extends ClientOptions$1 {
    * HTTP client (tests inject one). Defaults to global fetch.
    */
   fetch?: typeof fetch;
+  /**
+   * Session of this process's run, for apps where one run is one session (a desktop app's main process). Events carry it
+   * and errors carry it as `session.id`, so release health counts sessions and crashes. Servers acting for many people
+   * leave it unset.
+   */
+  sessionId?: string;
 }
 export interface NodeClient extends Client$1 {
   close(timeoutMs?: number): Promise<boolean>;
@@ -114,6 +120,14 @@ export interface ServerEvent {
    * Person properties to set only when the person does not have them yet.
    */
   setOnce?: Attributes;
+  /**
+   * When it happened, in epoch milliseconds, if earlier than now.
+   */
+  timestamp?: number;
+  /**
+   * The session it belongs to.
+   */
+  sessionId?: string;
 }
 /**
  * Record a product analytics event for a person with the client from `init`. Servers act for many people, so every event

package/dist/index.mjs

@@ -120,6 +120,7 @@ function init(options) {
 		},
 		now: Date.now,
 		random: Math.random,
+		...options.sessionId === void 0 ? {} : { session: runSession(options.sessionId) },
 		schedule(callback, delayMs) {
 			const handle = setTimeout(callback, delayMs);
 			handle.unref();
@@ -202,6 +203,20 @@ function init(options) {
 	return instance;
 }
 /**
+* A session that lasts the whole run: `reset` (sign-out) keeps it, since the run goes on.
+*
+* @param id - Session id.
+* @returns The platform's session hooks.
+*/
+function runSession(id) {
+	return {
+		current() {
+			return id;
+		},
+		reset() {}
+	};
+}
+/**
 * Persist undeliverable envelopes as files.
 *
 * @param directory - Offline directory.
@@ -226,11 +241,17 @@ function replay(directory, transport) {
 	(async function resend() {
 		for (const name of readdirSync(directory).filter(isEnvelopeFile).toSorted()) {
 			const path = join(directory, name);
-			const result = await transport.send(readFileSync(path, "utf8"));
+			let body;
+			try {
+				body = readFileSync(path, "utf8");
+			} catch {
+				continue;
+			}
+			const result = await transport.send(body);
 			if (result.status === 0 || result.status === 429 || result.status >= 500) return;
 			rmSync(path, { force: true });
 		}
-	})();
+	})().catch(function ignore() {});
 }
 /**
 * Whether a file name looks like a saved envelope.
@@ -334,7 +355,9 @@ function capture(event) {
 	return current?.capture(event.name, event.properties, {
 		distinctId: event.distinctId,
 		...event.set ? { set: event.set } : {},
-		...event.setOnce ? { setOnce: event.setOnce } : {}
+		...event.setOnce ? { setOnce: event.setOnce } : {},
+		...event.timestamp === void 0 ? {} : { timestamp: event.timestamp },
+		...event.sessionId === void 0 ? {} : { sessionId: event.sessionId }
 	});
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chaja/sdk-node",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Chajá error tracking for Node.js: process handlers, source context, offline buffer, Express and Fetch helpers.",
   "keywords": [
     "chaja",
@@ -38,7 +38,7 @@
     "tsdown": "0.23.0"
   },
   "dependencies": {
-    "@chaja/sdk-core": "0.1.0"
+    "@chaja/sdk-core": "0.2.1"
   },
   "engines": {
     "node": ">=22"