@chaja/sdk-core 0.1.0 → 0.2.1

package/dist/index.d.mts

@@ -125,7 +125,8 @@ interface QueueOptions {
   schedule: (callback: () => void, delayMs: number) => unknown;
   cancel: (handle: unknown) => void;
   /**
-   * Called with envelopes that exhausted their retries on network failures (Node persists them to disk).
+   * Called with envelopes that exhausted their retries on network failures or server back-pressure (429, 5xx), so a long
+   * outage or a restarting server does not lose them (Node persists them to disk). Permanent rejections (4xx) are not passed.
    */
   onUndeliverable?: (body: string) => void;
   debug?: (event: string, fields: Record<string, unknown>) => void;
@@ -221,6 +222,14 @@ interface CaptureOptions {
    * Person properties to set only when the person does not have them yet.
    */
   setOnce?: Attributes;
+  /**
+   * When it happened, in epoch milliseconds, for events recorded earlier and sent later (a client that was offline). Default now.
+   */
+  timestamp?: number;
+  /**
+   * The session it belongs to, instead of the platform's current one.
+   */
+  sessionId?: string;
 }
 interface Platform {
   sdk: SdkInfo;
@@ -265,6 +274,10 @@ interface CaptureContext {
   mechanism?: Mechanism;
   request?: RequestInfo;
   trace?: TraceContext;
+  /**
+   * When it happened, in epoch milliseconds, for errors recorded earlier and sent later. Default now.
+   */
+  timestamp?: number;
 }
 interface BreadcrumbInput {
   category: string;
@@ -363,7 +376,7 @@ export declare function parseStack(stack: string | undefined): Frame[];
 export declare function exceptionsFrom(error: unknown, mechanism: Mechanism): Exception[];
 //#endregion
 //#region src/index.d.ts
-export declare const SDK_VERSION = "0.1.0";
+export declare const SDK_VERSION = "0.2.1";
 /**
  * Parse a `Retry-After` header given in seconds or as an HTTP date.
  *

package/dist/index.mjs

@@ -201,7 +201,7 @@ function createQueue(options) {
 					items: batch.length
 				});
 				failures = 0;
-				if (result.status === 0) options.onUndeliverable?.(body);
+				options.onUndeliverable?.(body);
 				return;
 			}
 			pending.unshift(...batch);
@@ -375,7 +375,7 @@ function createClient(options, platform) {
 		let item = {
 			type: "error",
 			eventId: platform.eventId(),
-			timestamp: platform.now(),
+			timestamp: context.timestamp ?? platform.now(),
 			platform: platform.platform,
 			...base,
 			...options.release ? { release: options.release } : {},
@@ -427,15 +427,16 @@ function createClient(options, platform) {
 	* @param name - Event name.
 	* @param properties - Event properties.
 	* @param fields - Person, identify and person-property fields.
+	* @param when - When it happened and its session, if not now and the platform's current one.
 	* @returns Event id, if queued.
 	*/
-	function sendEvent(name, properties, fields) {
+	function sendEvent(name, properties, fields, when = {}) {
 		if (options.enabled === false || options.analytics === false) return;
-		const session = platform.session?.current();
+		const session = when.sessionId ?? platform.session?.current();
 		const item = {
 			type: "event",
 			eventId: platform.eventId(),
-			timestamp: platform.now(),
+			timestamp: when.timestamp ?? platform.now(),
 			name: name.slice(0, 256),
 			...fields,
 			...session ? { sessionId: session } : {},
@@ -507,6 +508,9 @@ function createClient(options, platform) {
 				distinctId: captureOptions.distinctId ?? identity.distinctId,
 				...captureOptions.set ? { set: captureOptions.set } : {},
 				...captureOptions.setOnce ? { setOnce: captureOptions.setOnce } : {}
+			}, {
+				...captureOptions.timestamp === void 0 ? {} : { timestamp: captureOptions.timestamp },
+				...captureOptions.sessionId === void 0 ? {} : { sessionId: captureOptions.sessionId }
 			});
 		},
 		identify(distinctId, set, setOnce) {
@@ -559,7 +563,7 @@ function createClient(options, platform) {
 }
 //#endregion
 //#region src/index.ts
-const SDK_VERSION = "0.1.0";
+const SDK_VERSION = "0.2.1";
 /**
 * Parse a `Retry-After` header given in seconds or as an HTTP date.
 *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chaja/sdk-core",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Shared client for the Chajá JavaScript SDKs: capture, scrubbing, sampling, batching and retries.",
   "keywords": [
     "chaja",