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

package/dist/provider/sdk.js

@@ -47,10 +47,6 @@ class CluebaseBrowserSdkImpl {
         this.traceManager = null;
         this.diagnostics = new DiagnosticStore();
         this.transport = null;
-        // OTel TracerProvider wired with the source-signal exporter so every span
-        // produced by `@opentelemetry/api`'s global tracer flows through
-        // `ObservationSourceEventExporter` → `BatchTransport.enqueue` →
-        // Cluebase ingest endpoint.
         this.tracerProvider = null;
         this.logger = logger;
         this.internalMetrics = new InternalMetricsStore();
@@ -120,6 +116,7 @@ class CluebaseBrowserSdkImpl {
             this.tabManager = new TabManager();
             this.organizationManager = new OrganizationManager();
             this.traceManager = new TraceManager();
+            this.traceManager.enableAsyncContext();
             this.environmentManager = new EnvironmentManager({
                 frontendRelease: resolved.release.frontendRelease,
                 contextTraitsProvider: resolved.contextTraitsProvider,
@@ -168,9 +165,6 @@ class CluebaseBrowserSdkImpl {
             if (this.consent !== "denied") {
                 this.warmupBrowserToken(ingestClient);
             }
-            // Wire WebTracerProvider with the canonical exporter. The provider is
-            // registered globally so OTel-instrumented code and capture modules
-            // converge on the same transport buffer.
             this.tracerProvider = createCluebaseOtelPipeline({
                 resolved,
                 getTransport: () => this.transport,
@@ -214,8 +208,6 @@ class CluebaseBrowserSdkImpl {
             return;
         }
         try {
-            // Capture the pre-identify anonymous id so the worker can fuse the
-            // anonymous → identified subject as a single resolution chain.
             const normalizedUserId = normalizePublicIdentityId(userId);
             if (!normalizedUserId) {
                 this.warnPublicDrop("identify", "userId must be a non-empty string");
@@ -380,7 +372,6 @@ class CluebaseBrowserSdkImpl {
             },
         });
     }
-    // SDK は observation source event だけを送り、ingest core が意味付けを行う。
     setConsent(consent) {
         this.consent = consent;
         if (!this.initialized) {
@@ -421,7 +412,6 @@ class CluebaseBrowserSdkImpl {
             }
         }
         catch {
-            // Public warnings must never break the host app.
         }
     }
     warnPublicFieldDrop(operation, field, _reason) {
@@ -436,7 +426,6 @@ class CluebaseBrowserSdkImpl {
             }
         }
         catch {
-            // Public warnings must never break the host app.
         }
     }
     sanitizeIdentifyTraits(traits) {
@@ -479,7 +468,6 @@ class CluebaseBrowserSdkImpl {
     flushLifecycleEvents() {
         void this.transport?.flush();
     }
-    // 内部 transport の即時 flush を要求する。SPA navigation や明示的 shutdown シナリオ用。
     async flush() {
         const deadline = this.transport?.beginFlushDeadline();
         try {
@@ -491,7 +479,6 @@ class CluebaseBrowserSdkImpl {
             this.transport?.endFlushDeadline(deadline);
         }
     }
-    // 残バッファを flush した上で SDK を停止する。テスト / 明示的 shutdown 用。
     async close() {
         const closeSignal = this.transport?.beginClose();
         await awaitUntilDeadline(this.flushCaptureSummaries("close"), closeSignal);
@@ -499,7 +486,7 @@ class CluebaseBrowserSdkImpl {
         await forceFlushCluebaseOtelProvider(this.tracerProvider, closeSignal ?? undefined);
         await this.transport?.close();
         if (this.transport?.getDiagnostics().lifecycle === "closing_failed") {
-            this.runtimeSurfaces.stopRuntimeSurfaces();
+            await this.shutdownAsync();
             return;
         }
         await this.shutdownAsync();
@@ -544,14 +531,6 @@ class CluebaseBrowserSdkImpl {
     refreshSessionCaptureEligibility() {
         this.eventPipeline.refreshSessionCaptureEligibility();
     }
-    /**
-     * Sanitize an identity value (userId / organizationId) before publishing.
-     * If the caller passed an email / phone / credit-card / SSN-shaped
-     * value, hash it deterministically and warn via the internal logger.
-     * This prevents raw PII from landing in canonical span attributes
-     * (`cluebase.actor.user_id`) and raw observation storage.
-     *
-     */
     sanitizeIdentityValue(field, raw) {
         if (typeof raw !== "string")
             return raw;
@@ -587,6 +566,7 @@ class CluebaseBrowserSdkImpl {
             this.transport.dispose();
             this.transport = null;
         }
+        this.traceManager?.disableAsyncContext();
         this.traceManager = null;
         this.initialized = false;
         this.initSignature = null;

package/dist/provider/types.d.ts

@@ -3,11 +3,6 @@ import type { DiagnosticsSnapshot } from "../exporter/diagnostics.js";
 import type { FrontendEventName, ParameterCaptureMode, SdkCollectionMode } from "./contracts.js";
 export type { FrontendEventCategory, FrontendEventName, FrontendEventStatus, ParameterCaptureMode, SdkCollectionMode, } from "./contracts.js";
 export type CluebaseConsentState = "granted" | "denied" | "unknown";
-/**
- * MVP group taxonomy. Public `cluebase.group(...)` accepts only the customer
- * company concept. `account` / `workspace` are future concepts and are not
- * exposed as MVP group inputs.
- */
 export type CluebaseGroupType = "organization";
 export type CanonicalJsonValue = string | number | boolean | null | CanonicalJsonValue[] | {
     [key: string]: CanonicalJsonValue;
@@ -37,14 +32,8 @@ export type DiagnosticCollectionConfig = {
     reason?: string;
     enabledBy?: string;
 };
-/**
- * Public bootstrap options accepted by `cluebase.init`.
- *
- * The SDK derives dev/prod from the `projectKey` prefix. Browser ingest obtains
- * short-lived tokens from `POST <endpoint>/api/v1/ingest/browser-tokens`.
- */
 export type CluebaseInitOptions = {
-    endpoint: string;
+    endpoint?: string;
     projectKey: string;
     autocapture?: boolean;
     captureNetwork?: boolean;
@@ -70,23 +59,6 @@ export type CluebaseInitOptions = {
         frontendRelease?: string;
     };
     contextTraitsProvider?: () => CluebaseTrackProperties;
-    /**
-     * Controls how the SDK's internal ``WebTracerProvider`` interacts with
-     * the page's global OTel context.
-     *
-     * - ``"register"`` (default for SDKs initialised on pages without
-     *   pre-existing OTel): call ``WebTracerProvider#register()`` so any
-     *   ``trace.getTracer(...)`` call in the page routes through Cluebase's
-     *   exporter, including Cluebase's own runtime span emissions.
-     * - ``"standalone"``: do not register globally. Cluebase's pipeline is
-     *   private; only spans created via the SDK's own internal tracer
-     *   reach the exporter. Use this when the host app already manages an
-     *   OTel TracerProvider (Sentry, Datadog, Honeycomb, etc.) and Cluebase
-     *   must not hijack it.
-     * - ``"detect"`` (recommended): inspect ``trace.getTracerProvider()``;
-     *   if a non-proxy provider is already installed, behave as
-     *   ``standalone``; otherwise behave as ``register``.
-     */
     otelProviderMode?: "register" | "standalone" | "detect";
 };
 export type ResolvedCluebaseConfig = {
@@ -195,6 +167,7 @@ export type CluebaseContext = {
     trace_id: string;
     request_id: string;
     request_span_id: string;
+    action_id: string | null;
     interaction_id: string;
     correlation_id: string | null;
     sdk_collection_mode: SdkCollectionMode;
@@ -255,16 +228,6 @@ export type CluebaseSubjectProfile = {
     contact_identity_hash: string | null;
     contact_domain: string | null;
 };
-/**
- * Customer-facing trait dict accepted by `cluebase.identify` /
- * `cluebase.setOrganization`.
- *
- * Customers use the camelCase form on every SDK. The ingest core normalizes
- * these values after receiving the SDK source signal.
- *
- * `displayName`, `email`, and `emailAddress` are accepted alternate keys.
- * Email traits are transported only as privacy-safe contact-derived fields.
- */
 export type CluebaseSubjectTraits = {
     name?: string | null;
     email?: string | null;
@@ -315,6 +278,7 @@ export type CaptureModuleContext = {
         interactionScopeKey?: string | null;
         nowMs?: number;
     }) => string | null;
+    bindEventContext?: (event: Event) => void;
     requestFlush?: () => void;
 };
 export type CaptureStopHandle = {

package/dist/provider/usage-governor.js

@@ -4,8 +4,6 @@ export const DEFAULT_INGEST_USAGE_GOVERNOR_FEEDBACK = {
     limitReasons: [],
     retryAfterAt: null,
 };
-// 正本から生成した一覧をそのまま使います。ここへ書き写していたため
-// `replay_storage` が抜け、受付側が「止めよ」と言っても画面側が捨てていました。
 const COST_CAPABILITIES = new Set(GENERATED_COST_CAPABILITIES);
 const LIMIT_KINDS = new Set(GENERATED_LIMIT_KINDS);
 const THRESHOLD_STAGES = new Set(GENERATED_THRESHOLD_STAGES);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@genn-inc/cluebase-frontend-sdk",
-	"version": "0.0.1",
+	"version": "0.0.2",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/genn-inc/cluebase.git"
@@ -27,11 +27,8 @@
 		"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",
-		"_comment_test": "実環境が要る試験 (`*-live.test.ts`) を既定の実行から外します (`tests/README.md` §12.2)。**綴りで拾います** — file 名を並べると、新しい live を足した人がここへ足し忘れて黙ります。**設定側 (`vitest.config.ts`) の `exclude` には置けません**: 実測 (2026-08-21) では、そこへ置くと live を名指しした実行まで `No test files found` で落ちます。script に置けば、手元と CI で対象が同じまま、実環境のあるジョブだけが名指しで拾えます。",
-		"test": "vitest run --config ../../../tests/config/vitest/frontend-sdk.config.ts --exclude \"../../../tests/integration/frontend-sdk/**/*-live.test.ts\"",
-		"test:cov": "vitest run --config ../../../tests/config/vitest/frontend-sdk.config.ts --coverage --exclude \"../../../tests/integration/frontend-sdk/**/*-live.test.ts\"",
-		"_comment_test_live": "実環境がある段だけがここを呼びます。**vitest の位置引数は glob ではなく道筋への部分一致です** — 実測 (2026-08-21): `vitest run \"src/**/*-live.test.ts\"` は `No test files found` で 0 件、`vitest run live.test.ts` は 1 件。綴りを CI ではなくここに置くので、CI 側は script 名を呼ぶだけになります。",
-		"test:live": "vitest run --config ../../../tests/config/vitest/frontend-sdk.config.ts ../../../tests/integration/frontend-sdk"
+		"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:*",