@usero/sdk 1.1.11 → 1.1.12

package/dist/vanilla.d.cts

@@ -1,3 +1,35 @@
+/**
+ * Returns the stable per-tab sdkSessionId. Core-owned so every plugin
+ * (replay, user-test, future feedback linkage) reads the SAME id for a
+ * given tab. Reads sessionStorage at most once per SDK instance; later
+ * calls hit the in-memory cache.
+ *
+ * Backward compat: reuses the `usero:sdk-session-id` key the replay
+ * plugin has always written, and the same loose sanity filter, so an
+ * id minted by an older replay-only SDK build is adopted as-is rather
+ * than rotated (which would split a tab's replay from its user-test).
+ */
+declare function getOrMintSdkSessionId(): string;
+/**
+ * Re-seat the per-tab sdkSessionId to a specific value. Used ONLY by the
+ * user-test resume path: a cross-origin hard navigation (e.g. an OAuth round
+ * trip) wipes sessionStorage, so the post-nav document would mint a NEW
+ * sdkSessionId and the post-nav SessionReplay row would no longer share an id
+ * with the audio session, breaking the (clientId, sdkSessionId) finalise join.
+ *
+ * The user-test plugin durably persists the original id in its localStorage
+ * resume state (which survives the round trip) and calls this synchronously at
+ * the very top of its onInit, BEFORE the session-replay plugin reads the id,
+ * so the resumed replay reuses the SAME id and the server stitches both replay
+ * rows under it.
+ *
+ * No-ops on a malformed id (so a corrupted resume entry can never poison the
+ * tab's id) and on an id identical to the current one. Writes sessionStorage
+ * AND the in-memory cache so a replay onInit that already cached a fresh mint
+ * is corrected (the cache is the read-through path).
+ */
+declare function reseatSdkSessionId(id: string): void;
+
 interface PluginLogger {
     debug: (...args: unknown[]) => void;
     info: (...args: unknown[]) => void;
@@ -12,6 +44,7 @@ interface PluginContext {
     logger: PluginLogger;
     resolveUser?: () => void;
     getSdkSessionId?: () => string;
+    reseatSdkSessionId?: (id: string) => void;
     getAnonymousId?: () => string;
     getUserId?: () => string | null;
     getReplayStartMs?: () => number | null;
@@ -100,6 +133,13 @@ declare const DEFAULT_THEME: WidgetTheme;
 declare const DARK_THEME: WidgetTheme;
 declare function mergeTheme(customTheme?: Partial<WidgetTheme>): WidgetTheme;
 
+declare const __identityTest__: {
+    ANON_STORAGE_KEY: string;
+    SDK_SESSION_STORAGE_KEY: string;
+    reseatSdkSessionId: typeof reseatSdkSessionId;
+    getOrMintSdkSessionId: typeof getOrMintSdkSessionId;
+    resetIdentityState: () => void;
+};
 declare function resolveTheme(userTheme: Partial<WidgetTheme> | undefined): WidgetTheme;
 
 interface UseroWidgetHandle {
@@ -113,4 +153,4 @@ interface UseroWidgetHandle {
 declare function mergePluginPatches(base: FeedbackSubmission, patches: ReadonlyArray<Partial<FeedbackSubmission> | undefined>): FeedbackSubmission;
 declare function initUseroFeedbackWidget(props: FeedbackWidgetProps): UseroWidgetHandle;
 
-export { DARK_THEME, DEFAULT_THEME, type FeedbackData, type FeedbackRating, type FeedbackSubmission, type FeedbackWidgetProps, type PluginContext, type PluginLogger, type ScreenshotData, type UseroPlugin, type UseroWidgetHandle, type WidgetPosition, type WidgetTheme, initUseroFeedbackWidget, mergePluginPatches, mergeTheme, resolveTheme };
+export { DARK_THEME, DEFAULT_THEME, type FeedbackData, type FeedbackRating, type FeedbackSubmission, type FeedbackWidgetProps, type PluginContext, type PluginLogger, type ScreenshotData, type UseroPlugin, type UseroWidgetHandle, type WidgetPosition, type WidgetTheme, __identityTest__, initUseroFeedbackWidget, mergePluginPatches, mergeTheme, resolveTheme };

package/dist/vanilla.d.ts

@@ -1,3 +1,35 @@
+/**
+ * Returns the stable per-tab sdkSessionId. Core-owned so every plugin
+ * (replay, user-test, future feedback linkage) reads the SAME id for a
+ * given tab. Reads sessionStorage at most once per SDK instance; later
+ * calls hit the in-memory cache.
+ *
+ * Backward compat: reuses the `usero:sdk-session-id` key the replay
+ * plugin has always written, and the same loose sanity filter, so an
+ * id minted by an older replay-only SDK build is adopted as-is rather
+ * than rotated (which would split a tab's replay from its user-test).
+ */
+declare function getOrMintSdkSessionId(): string;
+/**
+ * Re-seat the per-tab sdkSessionId to a specific value. Used ONLY by the
+ * user-test resume path: a cross-origin hard navigation (e.g. an OAuth round
+ * trip) wipes sessionStorage, so the post-nav document would mint a NEW
+ * sdkSessionId and the post-nav SessionReplay row would no longer share an id
+ * with the audio session, breaking the (clientId, sdkSessionId) finalise join.
+ *
+ * The user-test plugin durably persists the original id in its localStorage
+ * resume state (which survives the round trip) and calls this synchronously at
+ * the very top of its onInit, BEFORE the session-replay plugin reads the id,
+ * so the resumed replay reuses the SAME id and the server stitches both replay
+ * rows under it.
+ *
+ * No-ops on a malformed id (so a corrupted resume entry can never poison the
+ * tab's id) and on an id identical to the current one. Writes sessionStorage
+ * AND the in-memory cache so a replay onInit that already cached a fresh mint
+ * is corrected (the cache is the read-through path).
+ */
+declare function reseatSdkSessionId(id: string): void;
+
 interface PluginLogger {
     debug: (...args: unknown[]) => void;
     info: (...args: unknown[]) => void;
@@ -12,6 +44,7 @@ interface PluginContext {
     logger: PluginLogger;
     resolveUser?: () => void;
     getSdkSessionId?: () => string;
+    reseatSdkSessionId?: (id: string) => void;
     getAnonymousId?: () => string;
     getUserId?: () => string | null;
     getReplayStartMs?: () => number | null;
@@ -100,6 +133,13 @@ declare const DEFAULT_THEME: WidgetTheme;
 declare const DARK_THEME: WidgetTheme;
 declare function mergeTheme(customTheme?: Partial<WidgetTheme>): WidgetTheme;
 
+declare const __identityTest__: {
+    ANON_STORAGE_KEY: string;
+    SDK_SESSION_STORAGE_KEY: string;
+    reseatSdkSessionId: typeof reseatSdkSessionId;
+    getOrMintSdkSessionId: typeof getOrMintSdkSessionId;
+    resetIdentityState: () => void;
+};
 declare function resolveTheme(userTheme: Partial<WidgetTheme> | undefined): WidgetTheme;
 
 interface UseroWidgetHandle {
@@ -113,4 +153,4 @@ interface UseroWidgetHandle {
 declare function mergePluginPatches(base: FeedbackSubmission, patches: ReadonlyArray<Partial<FeedbackSubmission> | undefined>): FeedbackSubmission;
 declare function initUseroFeedbackWidget(props: FeedbackWidgetProps): UseroWidgetHandle;
 
-export { DARK_THEME, DEFAULT_THEME, type FeedbackData, type FeedbackRating, type FeedbackSubmission, type FeedbackWidgetProps, type PluginContext, type PluginLogger, type ScreenshotData, type UseroPlugin, type UseroWidgetHandle, type WidgetPosition, type WidgetTheme, initUseroFeedbackWidget, mergePluginPatches, mergeTheme, resolveTheme };
+export { DARK_THEME, DEFAULT_THEME, type FeedbackData, type FeedbackRating, type FeedbackSubmission, type FeedbackWidgetProps, type PluginContext, type PluginLogger, type ScreenshotData, type UseroPlugin, type UseroWidgetHandle, type WidgetPosition, type WidgetTheme, __identityTest__, initUseroFeedbackWidget, mergePluginPatches, mergeTheme, resolveTheme };

package/dist/vanilla.js

@@ -227,10 +227,13 @@ function rotateAnonymousId() {
   currentUserId = null;
   return id;
 }
+function isValidSdkSessionId(id) {
+  return /^[a-z0-9-]{8,}$/i.test(id);
+}
 function getOrMintSdkSessionId() {
   if (cachedSdkSessionId) return cachedSdkSessionId;
   const existing = safeReadSessionStorage(SDK_SESSION_STORAGE_KEY);
-  if (existing && /^[a-z0-9-]{8,}$/i.test(existing)) {
+  if (existing && isValidSdkSessionId(existing)) {
     cachedSdkSessionId = existing;
     return existing;
   }
@@ -239,6 +242,12 @@ function getOrMintSdkSessionId() {
   cachedSdkSessionId = id;
   return id;
 }
+function reseatSdkSessionId(id) {
+  if (!isValidSdkSessionId(id)) return;
+  if (cachedSdkSessionId === id) return;
+  cachedSdkSessionId = id;
+  safeWriteSessionStorage(SDK_SESSION_STORAGE_KEY, id);
+}
 function getCurrentUserId() {
   return currentUserId;
 }
@@ -301,6 +310,19 @@ async function identifyIfChanged(transport, user) {
 function handleLogout() {
   rotateAnonymousId();
 }
+var __test__ = {
+  ANON_STORAGE_KEY,
+  SDK_SESSION_STORAGE_KEY,
+  reseatSdkSessionId,
+  getOrMintSdkSessionId,
+  resetIdentityState: () => {
+    cachedAnonymousId = null;
+    cachedSdkSessionId = null;
+    currentUserId = null;
+    replayStartMs = null;
+    lastIdentifyFingerprint = null;
+  }
+};
 
 // src/plugin.ts
 function createPluginLogger(name) {
@@ -775,6 +797,7 @@ var FEEDBACK_CSS = `
 `;
 
 // src/vanilla.ts
+var __identityTest__ = __test__;
 function resolveBaseTheme() {
   if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
     return DARK_THEME;
@@ -950,6 +973,7 @@ function initUseroFeedbackWidget(props) {
       // source of truth in identity.ts, so user-test and session-replay
       // agree on the per-tab sdkSessionId without importing each other.
       getSdkSessionId: () => getOrMintSdkSessionId(),
+      reseatSdkSessionId: (id) => reseatSdkSessionId(id),
       getAnonymousId: () => getOrMintAnonymousId(),
       getUserId: () => getCurrentUserId(),
       getReplayStartMs: () => getReplayStartMs(),
@@ -1478,6 +1502,6 @@ function initUseroFeedbackWidget(props) {
   };
 }
 
-export { DARK_THEME, DEFAULT_THEME, initUseroFeedbackWidget, mergePluginPatches, mergeTheme, resolveTheme };
+export { DARK_THEME, DEFAULT_THEME, __identityTest__, initUseroFeedbackWidget, mergePluginPatches, mergeTheme, resolveTheme };
 //# sourceMappingURL=vanilla.js.map
 //# sourceMappingURL=vanilla.js.map