@genn-inc/cluebase-frontend-sdk 0.0.2 → 0.0.3

package/dist/context/action-context.js

@@ -10,6 +10,17 @@ const resolveRestoredFunction = (candidate) => {
 };
 const captureFlag = (options) => typeof options === "boolean" ? options : options?.capture === true;
 const isCallable = (value) => typeof value === "function";
+const isWeakMapKey = (value) => (value !== null && typeof value === "object") || typeof value === "function";
+const resolveEventTarget = (receiver) => {
+    if (isWeakMapKey(receiver))
+        return receiver;
+    if (receiver === undefined &&
+        typeof EventTarget !== "undefined" &&
+        globalThis instanceof EventTarget) {
+        return globalThis;
+    }
+    return null;
+};
 const invokeListener = (listener, thisValue, event) => {
     if (typeof listener === "function") {
         return listener.call(thisValue, event);
@@ -185,11 +196,16 @@ export class PrivateActionContextManager {
                 originalAdd.call(this, type, listener, options);
                 return;
             }
-            if (!listener) {
+            const target = resolveEventTarget(this);
+            if (!target) {
                 originalAdd.call(this, type, listener, options);
                 return;
             }
-            const registrations = manager.eventRegistrations.get(this) ?? [];
+            if (!listener) {
+                originalAdd.call(target, type, listener, options);
+                return;
+            }
+            const registrations = manager.eventRegistrations.get(target) ?? [];
             if (registrations.some((registration) => registration.type === type &&
                 registration.listener === listener &&
                 captureFlag(registration.options) === captureFlag(options))) {
@@ -198,11 +214,10 @@ export class PrivateActionContextManager {
             if (typeof options === "object" &&
                 options !== null &&
                 options.signal?.aborted) {
-                originalAdd.call(this, type, listener, options);
+                originalAdd.call(target, type, listener, options);
                 return;
             }
             const registrationSnapshot = manager.capture();
-            const target = this;
             const wrappedListener = function (event) {
                 const eventSnapshot = manager.eventContexts.get(event);
                 const snapshot = eventSnapshot ?? registrationSnapshot;
@@ -251,16 +266,21 @@ export class PrivateActionContextManager {
                 originalRemove.call(this, type, listener, options);
                 return;
             }
-            if (!listener) {
+            const target = resolveEventTarget(this);
+            if (!target) {
                 originalRemove.call(this, type, listener, options);
                 return;
             }
-            const registrations = manager.eventRegistrations.get(this) ?? [];
+            if (!listener) {
+                originalRemove.call(target, type, listener, options);
+                return;
+            }
+            const registrations = manager.eventRegistrations.get(target) ?? [];
             const index = registrations.findIndex((registration) => registration.type === type &&
                 registration.listener === listener &&
                 captureFlag(registration.options) === captureFlag(options));
             if (index < 0) {
-                originalRemove.call(this, type, listener, options);
+                originalRemove.call(target, type, listener, options);
                 return;
             }
             const registration = registrations[index];

package/dist/index.js

@@ -1,5 +1,6 @@
 import { parseSendableUrl } from "./provider/config.js";
 import { createCluebaseBrowserSdk } from "./provider/sdk.js";
+import { reportSdkError } from "./provider/sdk-error.js";
 const GLOBAL_SDK_KEY = "__cluebase_frontend_sdk_singleton__";
 const globalWithCluebaseSdk = globalThis;
 const existingSdk = globalWithCluebaseSdk[GLOBAL_SDK_KEY];
@@ -7,7 +8,8 @@ const internalSdk = existingSdk ?? createCluebaseBrowserSdk();
 if (!existingSdk) {
     globalWithCluebaseSdk[GLOBAL_SDK_KEY] = internalSdk;
 }
-const reportPublicSdkError = (operation) => {
+const reportPublicSdkError = (operation, error) => {
+    reportSdkError(operation, error);
     try {
         if (typeof console !== "undefined" && typeof console.warn === "function") {
             console.warn(`[cluebase] ${operation} failed`, {
@@ -22,16 +24,16 @@ const safeCall = (operation, callback) => {
     try {
         callback();
     }
-    catch {
-        reportPublicSdkError(operation);
+    catch (error) {
+        reportPublicSdkError(operation, error);
     }
 };
 const safeAsyncCall = async (operation, callback) => {
     try {
         await callback();
     }
-    catch {
-        reportPublicSdkError(operation);
+    catch (error) {
+        reportPublicSdkError(operation, error);
     }
 };
 const REMOVED_PRIVACY_OPTIONS = {

package/dist/provider/_version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION: "0.0.2";
+export declare const SDK_VERSION: "0.0.3";

package/dist/provider/_version.js

@@ -1,3 +1,3 @@
 // This file is generated by scripts/generate-version-module.mjs.
 // Do NOT edit by hand. The source of truth is `package.json` `version`.
-export const SDK_VERSION = "0.0.2";
+export const SDK_VERSION = "0.0.3";

package/dist/provider/sdk-error.d.ts

@@ -0,0 +1,7 @@
+export type SdkErrorDetails = {
+    error_name: string;
+    error_message: string;
+    error_stack?: string;
+};
+export declare const getSdkErrorDetails: (error: unknown) => SdkErrorDetails;
+export declare const reportSdkError: (operation: string, error: unknown) => SdkErrorDetails;

package/dist/provider/sdk-error.js

@@ -0,0 +1,48 @@
+const redactSensitiveText = (value) => value
+    .replace(/\bpk_[A-Za-z0-9_-]+\b/g, "[redacted-project-key]")
+    .replace(/\b(Bearer|Basic)\s+[A-Za-z0-9._~+/-]+=*/gi, "$1 [redacted]")
+    .replace(/(https?:\/\/[^\s?]+)\?[^\s]*/gi, "$1?[redacted]")
+    .slice(0, 500);
+const readErrorField = (error, field) => {
+    try {
+        const value = error?.[field];
+        return typeof value === "string" ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+export const getSdkErrorDetails = (error) => {
+    let fallbackMessage;
+    try {
+        fallbackMessage = String(error);
+    }
+    catch {
+        fallbackMessage = "Unknown thrown value";
+    }
+    const stack = readErrorField(error, "stack");
+    return {
+        error_name: readErrorField(error, "name") || "UnknownError",
+        error_message: redactSensitiveText(readErrorField(error, "message") || fallbackMessage),
+        ...(stack
+            ? {
+                error_stack: stack
+                    .split(/\r?\n/)
+                    .slice(1, 9)
+                    .map(redactSensitiveText)
+                    .join("\n"),
+            }
+            : {}),
+    };
+};
+export const reportSdkError = (operation, error) => {
+    const details = getSdkErrorDetails(error);
+    try {
+        if (typeof console !== "undefined" && typeof console.error === "function") {
+            const stack = details.error_stack ? `\n${details.error_stack}` : "";
+            console.error(`[cluebase] ${operation} failed (${details.error_name}): ${details.error_message}${stack}`);
+        }
+    }
+    catch { }
+    return details;
+};

package/dist/provider/sdk.js

@@ -15,6 +15,7 @@ import { isValidPublicCustomEventName, normalizeProfileAvatarUrl, normalizePubli
 import { OFFICIAL_CUSTOM_EVENT_NAME, ProviderEventPipeline, readCurrentLifecycleUrl, } from "./sdk-event-pipeline.js";
 import { createCluebaseOtelPipeline, forceFlushCluebaseOtelProvider, shutdownCluebaseOtelProvider, shutdownCluebaseOtelProviderAsync, } from "./sdk-otel-pipeline.js";
 import { ProviderRuntimeSurfaces } from "./sdk-runtime-surfaces.js";
+import { getSdkErrorDetails, reportSdkError } from "./sdk-error.js";
 const createNoopLogger = () => {
     return {
         debug: () => undefined,
@@ -192,11 +193,24 @@ class CluebaseBrowserSdkImpl {
             }
             this.installUnloadHandlers();
         }
-        catch {
+        catch (error) {
+            const errorDetails = getSdkErrorDetails(error);
             this.logger.error("Cluebase Frontend SDK init failed", {
                 error_code: "sdk_operation_failed",
+                ...errorDetails,
             });
+            reportSdkError("init", error);
             this.warnPublicDrop("init", "sdk_operation_failed");
+            try {
+                this.shutdown();
+            }
+            catch (cleanupError) {
+                this.logger.error("Cluebase Frontend SDK init cleanup failed", {
+                    error_code: "sdk_cleanup_failed",
+                    ...getSdkErrorDetails(cleanupError),
+                });
+                reportSdkError("init cleanup", cleanupError);
+            }
         }
     }
     identify(userId, traits) {

package/package.json

@@ -1,56 +1,54 @@
 {
-	"name": "@genn-inc/cluebase-frontend-sdk",
-	"version": "0.0.2",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/genn-inc/cluebase.git"
-	},
-	"description": "Cluebase Frontend SDK — OTel-based observation-source event capture for frontend apps",
-	"type": "module",
-	"main": "dist/index.js",
-	"types": "dist/index.d.ts",
-	"files": [
-		"dist/",
-		"README.md"
-	],
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"browser": "./dist/index.js",
-			"default": "./dist/index.js"
-		}
-	},
-	"scripts": {
-		"build": "node ./scripts/clean-dist.mjs && node ../../../scripts/generate-shared-contract-tables.mjs && node ./scripts/generate-version-module.mjs && tsc -p tsconfig.build.json && node ./scripts/fix-esm-relative-imports.mjs",
-		"prepack": "pnpm build",
-		"prepublishOnly": "pnpm lint && pnpm test:cov && pnpm typecheck && pnpm test:package-import",
-		"lint": "pnpm exec biome lint src",
-		"test:package-import": "pnpm build && node ../../../tests/distribution/frontend-sdk/check-package-import.mjs",
-		"typecheck": "tsc -p tsconfig.typecheck.json",
-		"test": "vitest run --config ../../../tests/config/vitest/frontend-sdk.config.ts",
-		"test:cov": "vitest run --config ../../../tests/config/vitest/frontend-sdk.config.ts --coverage"
-	},
-	"devDependencies": {
-		"@cluebase/schema": "workspace:*",
-		"@cluebase/shared": "workspace:*",
-		"@vitest/coverage-v8": "^3.2.4",
-		"jsdom": "^26.1.0",
-		"typescript": "^5.9.3",
-		"vitest": "^3.2.7"
-	},
-	"dependencies": {
-		"@noble/hashes": "1.8.0",
-		"@opentelemetry/api": ">=1.9.1 <1.10.0",
-		"@opentelemetry/api-logs": ">=0.218.0 <1.0.0",
-		"@opentelemetry/browser-instrumentation": ">=0.5.2 <1.0.0",
-		"@opentelemetry/core": ">=2.7.1 <3.0.0",
-		"@opentelemetry/instrumentation-document-load": ">=0.63.0 <1.0.0",
-		"@opentelemetry/instrumentation-fetch": ">=0.218.0 <1.0.0",
-		"@opentelemetry/instrumentation-xml-http-request": ">=0.218.0 <1.0.0",
-		"@opentelemetry/resources": ">=2.7.1 <3.0.0",
-		"@opentelemetry/sdk-trace-base": ">=2.7.1 <3.0.0",
-		"@opentelemetry/sdk-trace-web": ">=2.7.1 <3.0.0",
-		"json-canonicalize": "2.0.0",
-		"zod": "^4.4.3"
-	}
-}
+  "name": "@genn-inc/cluebase-frontend-sdk",
+  "version": "0.0.3",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/genn-inc/cluebase.git"
+  },
+  "description": "Cluebase Frontend SDK — OTel-based observation-source event capture for frontend apps",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^3.2.4",
+    "jsdom": "^26.1.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7",
+    "@cluebase/schema": "1.0.0",
+    "@cluebase/shared": "1.0.0"
+  },
+  "dependencies": {
+    "@noble/hashes": "1.8.0",
+    "@opentelemetry/api": ">=1.9.1 <1.10.0",
+    "@opentelemetry/api-logs": ">=0.218.0 <1.0.0",
+    "@opentelemetry/browser-instrumentation": ">=0.5.2 <1.0.0",
+    "@opentelemetry/core": ">=2.7.1 <3.0.0",
+    "@opentelemetry/instrumentation-document-load": ">=0.63.0 <1.0.0",
+    "@opentelemetry/instrumentation-fetch": ">=0.218.0 <1.0.0",
+    "@opentelemetry/instrumentation-xml-http-request": ">=0.218.0 <1.0.0",
+    "@opentelemetry/resources": ">=2.7.1 <3.0.0",
+    "@opentelemetry/sdk-trace-base": ">=2.7.1 <3.0.0",
+    "@opentelemetry/sdk-trace-web": ">=2.7.1 <3.0.0",
+    "json-canonicalize": "2.0.0",
+    "zod": "^4.4.3"
+  },
+  "scripts": {
+    "build": "node ./scripts/clean-dist.mjs && node ../../../scripts/generate-shared-contract-tables.mjs && node ./scripts/generate-version-module.mjs && tsc -p tsconfig.build.json && node ./scripts/fix-esm-relative-imports.mjs",
+    "lint": "pnpm exec biome lint src",
+    "test:package-import": "pnpm build && node ../../../tests/distribution/frontend-sdk/check-package-import.mjs",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "test": "vitest run --config ../../../tests/config/vitest/frontend-sdk.config.ts",
+    "test:cov": "vitest run --config ../../../tests/config/vitest/frontend-sdk.config.ts --coverage"
+  }
+}