@multiplayer-app/session-recorder-common 1.3.16 → 1.3.18-beta.0

package/dist/src/type/crash-buffer.d.ts

@@ -0,0 +1,59 @@
+export type CrashBufferAttrs = {
+    sessionAttributes?: Record<string, any>;
+    resourceAttributes?: Record<string, any>;
+    userAttributes?: any;
+};
+export type CrashBufferRrwebEventPayload = {
+    ts: number;
+    isFullSnapshot?: boolean;
+    event: any;
+};
+export type CrashBufferOtelSpanPayload = {
+    ts: number;
+    span: any;
+};
+/**
+ * Batch append payload for OTEL spans.
+ * This is intentionally the same per-span shape as `CrashBufferOtelSpanPayload`,
+ * just provided as an array to allow implementations to persist efficiently.
+ */
+export type CrashBufferOtelSpanBatchPayload = CrashBufferOtelSpanPayload[];
+export type CrashBufferErrorSpanAppendedEvent = CrashBufferOtelSpanPayload;
+export type CrashBufferEventName = 'error-span-appended';
+export type CrashBufferEventMap = {
+    'error-span-appended': CrashBufferErrorSpanAppendedEvent;
+};
+export type CrashBufferSnapshot = {
+    rrwebEvents: CrashBufferRrwebEventPayload[];
+    otelSpans: CrashBufferOtelSpanPayload[];
+    attrs: CrashBufferAttrs | null;
+    windowMs: number;
+    fromTs: number;
+    toTs: number;
+};
+/**
+ * Shared CrashBuffer contract used across browser + react-native implementations.
+ *
+ * Notes:
+ * - `windowMs` is optional because browser implementations usually bake the window into the instance,
+ *   while React Native typically passes it per call.
+ * - `pruneOlderThan` is optional because browser implementations can handle pruning internally.
+ */
+export interface CrashBuffer {
+    setAttrs(attrs: CrashBufferAttrs): Promise<void>;
+    appendEvent(payload: CrashBufferRrwebEventPayload, windowMs?: number): Promise<void>;
+    appendSpans(payload: CrashBufferOtelSpanBatchPayload, windowMs?: number): Promise<void>;
+    snapshot(windowMs?: number, now?: number): Promise<CrashBufferSnapshot>;
+    clear(): Promise<void>;
+    pruneOlderThan?(cutoffTs: number): Promise<void>;
+    on?(event: CrashBufferEventName, listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void): () => void;
+    off?(event: CrashBufferEventName, listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void): void;
+}
+/**
+ * Optional lifecycle controls supported by some CrashBuffer implementations (e.g. browser tabs).
+ */
+export interface CrashBufferLifecycle extends CrashBuffer {
+    setActive(active: boolean): void;
+    needsFullSnapshot(): boolean;
+}
+//# sourceMappingURL=crash-buffer.d.ts.map

package/dist/src/type/crash-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crash-buffer.d.ts","sourceRoot":"","sources":["../../../src/type/crash-buffer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACxC,cAAc,CAAC,EAAE,GAAG,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,KAAK,EAAE,GAAG,CAAA;CACX,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,GAAG,CAAA;CACV,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,GAAG,0BAA0B,EAAE,CAAA;AAE1E,MAAM,MAAM,iCAAiC,GAAG,0BAA0B,CAAA;AAE1E,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAA;AAExD,MAAM,MAAM,mBAAmB,GAAG;IAChC,qBAAqB,EAAE,iCAAiC,CAAA;CACzD,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,4BAA4B,EAAE,CAAA;IAC3C,SAAS,EAAE,0BAA0B,EAAE,CAAA;IACvC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,WAAW,CAAC,OAAO,EAAE,4BAA4B,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpF,WAAW,CAAC,OAAO,EAAE,+BAA+B,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,EAAE,CAAC,CACD,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,KAAK,IAAI,GACrE,MAAM,IAAI,CAAA;IACb,GAAG,CAAC,CACF,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,KAAK,IAAI,GACrE,IAAI,CAAA;CACR;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAChC,iBAAiB,IAAI,OAAO,CAAA;CAC7B"}

package/dist/src/type/crash-buffer.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=crash-buffer.js.map

package/dist/src/type/crash-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crash-buffer.js","sourceRoot":"","sources":["../../../src/type/crash-buffer.ts"],"names":[],"mappings":"","sourcesContent":["export type CrashBufferAttrs = {\n  sessionAttributes?: Record<string, any>\n  resourceAttributes?: Record<string, any>\n  userAttributes?: any\n}\n\nexport type CrashBufferRrwebEventPayload = {\n  ts: number\n  isFullSnapshot?: boolean\n  event: any\n}\n\nexport type CrashBufferOtelSpanPayload = {\n  ts: number\n  span: any\n}\n\n/**\n * Batch append payload for OTEL spans.\n * This is intentionally the same per-span shape as `CrashBufferOtelSpanPayload`,\n * just provided as an array to allow implementations to persist efficiently.\n */\nexport type CrashBufferOtelSpanBatchPayload = CrashBufferOtelSpanPayload[]\n\nexport type CrashBufferErrorSpanAppendedEvent = CrashBufferOtelSpanPayload\n\nexport type CrashBufferEventName = 'error-span-appended'\n\nexport type CrashBufferEventMap = {\n  'error-span-appended': CrashBufferErrorSpanAppendedEvent\n}\n\nexport type CrashBufferSnapshot = {\n  rrwebEvents: CrashBufferRrwebEventPayload[]\n  otelSpans: CrashBufferOtelSpanPayload[]\n  attrs: CrashBufferAttrs | null\n  windowMs: number\n  fromTs: number\n  toTs: number\n}\n\n/**\n * Shared CrashBuffer contract used across browser + react-native implementations.\n *\n * Notes:\n * - `windowMs` is optional because browser implementations usually bake the window into the instance,\n *   while React Native typically passes it per call.\n * - `pruneOlderThan` is optional because browser implementations can handle pruning internally.\n */\nexport interface CrashBuffer {\n  setAttrs(attrs: CrashBufferAttrs): Promise<void>\n  appendEvent(payload: CrashBufferRrwebEventPayload, windowMs?: number): Promise<void>\n  appendSpans(payload: CrashBufferOtelSpanBatchPayload, windowMs?: number): Promise<void>\n  snapshot(windowMs?: number, now?: number): Promise<CrashBufferSnapshot>\n  clear(): Promise<void>\n  pruneOlderThan?(cutoffTs: number): Promise<void>\n  on?(\n    event: CrashBufferEventName,\n    listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void\n  ): () => void\n  off?(\n    event: CrashBufferEventName,\n    listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void\n  ): void\n}\n\n/**\n * Optional lifecycle controls supported by some CrashBuffer implementations (e.g. browser tabs).\n */\nexport interface CrashBufferLifecycle extends CrashBuffer {\n  setActive(active: boolean): void\n  needsFullSnapshot(): boolean\n}\n"]}

package/dist/src/type/index.d.ts

@@ -1,4 +1,5 @@
 export * from './session-type.enum';
 export * from './user-type.enum';
 export * from './session';
+export * from './crash-buffer';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/type/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/type/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/type/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA"}

package/dist/src/type/index.js

@@ -17,4 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./session-type.enum"), exports);
 __exportStar(require("./user-type.enum"), exports);
 __exportStar(require("./session"), exports);
+__exportStar(require("./crash-buffer"), exports);
 //# sourceMappingURL=index.js.map

package/dist/src/type/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/type/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAmC;AACnC,mDAAgC;AAChC,4CAAyB","sourcesContent":["export * from './session-type.enum'\nexport * from './user-type.enum'\nexport * from './session'"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/type/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAmC;AACnC,mDAAgC;AAChC,4CAAyB;AACzB,iDAA8B","sourcesContent":["export * from './session-type.enum'\nexport * from './user-type.enum'\nexport * from './session'\nexport * from './crash-buffer'\n"]}

package/dist/src/type/session-type.enum.d.ts

@@ -4,6 +4,8 @@ export declare enum SessionType {
      * @deprecated Use MANUAL instead
      */
     PLAIN = "MANUAL",
-    MANUAL = "MANUAL"
+    MANUAL = "MANUAL",
+    CONTINUOUS_SESSION_CACHE = "CONTINUOUS_SESSION_CACHE",
+    SESSION_CACHE = "SESSION_CACHE"
 }
 //# sourceMappingURL=session-type.enum.d.ts.map

package/dist/src/type/session-type.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-type.enum.d.ts","sourceRoot":"","sources":["../../../src/type/session-type.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,UAAU,eAAe;IACzB;;OAEG;IACH,KAAK,WAAW;IAChB,MAAM,WAAW;CAClB"}
+{"version":3,"file":"session-type.enum.d.ts","sourceRoot":"","sources":["../../../src/type/session-type.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,UAAU,eAAe;IACzB;;OAEG;IACH,KAAK,WAAW;IAChB,MAAM,WAAW;IAEjB,wBAAwB,6BAA6B;IACrD,aAAa,kBAAkB;CAChC"}

package/dist/src/type/session-type.enum.js

@@ -9,5 +9,7 @@ var SessionType;
      */
     SessionType["PLAIN"] = "MANUAL";
     SessionType["MANUAL"] = "MANUAL";
+    SessionType["CONTINUOUS_SESSION_CACHE"] = "CONTINUOUS_SESSION_CACHE";
+    SessionType["SESSION_CACHE"] = "SESSION_CACHE";
 })(SessionType || (exports.SessionType = SessionType = {}));
 //# sourceMappingURL=session-type.enum.js.map

package/dist/src/type/session-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-type.enum.js","sourceRoot":"","sources":["../../../src/type/session-type.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB;;OAEG;IACH,+BAAgB,CAAA;IAChB,gCAAiB,CAAA;AACnB,CAAC,EAPW,WAAW,2BAAX,WAAW,QAOtB","sourcesContent":["export enum SessionType {\n  CONTINUOUS = 'CONTINUOUS',\n  /**\n   * @deprecated Use MANUAL instead\n   */\n  PLAIN = 'MANUAL',\n  MANUAL = 'MANUAL',\n}\n"]}
+{"version":3,"file":"session-type.enum.js","sourceRoot":"","sources":["../../../src/type/session-type.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,WAUX;AAVD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB;;OAEG;IACH,+BAAgB,CAAA;IAChB,gCAAiB,CAAA;IAEjB,oEAAqD,CAAA;IACrD,8CAA+B,CAAA;AACjC,CAAC,EAVW,WAAW,2BAAX,WAAW,QAUtB","sourcesContent":["export enum SessionType {\n  CONTINUOUS = 'CONTINUOUS',\n  /**\n   * @deprecated Use MANUAL instead\n   */\n  PLAIN = 'MANUAL',\n  MANUAL = 'MANUAL',\n\n  CONTINUOUS_SESSION_CACHE = 'CONTINUOUS_SESSION_CACHE',\n  SESSION_CACHE = 'SESSION_CACHE',\n}\n"]}

package/dist/src/type/session.d.ts

@@ -1,5 +1,5 @@
-import { SessionType } from "./session-type.enum";
-import { UserType } from "./user-type.enum";
+import { SessionType } from './session-type.enum';
+import { UserType } from './user-type.enum';
 export interface IResourceAttributes {
     browserInfo?: string;
     cookiesEnabled?: string;

package/dist/src/type/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/type/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAA;IACd,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,WAAW,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,GAAG,EAAE,CAAC;IAEZ,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;IAEvC,cAAc,CAAC,EAAE,eAAe,CAAA;IAEhC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,oBAAoB,CAAC;QAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IACJ,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAGD,oBAAY,oBAAoB;IAC9B,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,YAAY,iBAAiB;CAC9B"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/type/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE3C,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAA;IACd,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,WAAW,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,GAAG,EAAE,CAAC;IAEZ,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;IAEvC,cAAc,CAAC,EAAE,eAAe,CAAA;IAEhC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,oBAAoB,CAAC;QAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IACJ,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAGD,oBAAY,oBAAoB;IAC9B,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,YAAY,iBAAiB;CAC9B"}

package/dist/src/type/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/type/session.ts"],"names":[],"mappings":";;;AA+EA,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC9B,mDAA2B,CAAA;IAC3B,+CAAuB,CAAA;IACvB,qDAA6B,CAAA;AAC/B,CAAC,EAJW,oBAAoB,oCAApB,oBAAoB,QAI/B","sourcesContent":["import { SessionType } from \"./session-type.enum\";\nimport { UserType } from \"./user-type.enum\";\n\nexport interface IResourceAttributes {\n  browserInfo?: string;\n  cookiesEnabled?: string;\n  deviceInfo?: string;\n  hardwareConcurrency?: number;\n  osInfo?: string;\n  pixelRatio?: number;\n  screenSize?: string;\n  packageVersion?: string;\n  [key: string]: any;\n}\n\nexport interface ISessionAttributes {\n  [key: string]: any;\n}\n\nexport interface IUserAttributes {\n  type: UserType\n  id?: string\n  name?: string\n  groupId?: string\n  groupName?: string\n  userEmail?: string\n  userId?: string\n  userName?: string\n  accountId?: string\n  accountName?: string\n  orgId?: string\n  orgName?: string\n  tags?: string[]\n  environment?: string\n}\n\nexport interface ISession {\n  _id: string;\n  shortId: string;\n  workspace: string;\n  project: string;\n  continuousDebugSession?: string;\n  creationType: SessionType;\n  name: string;\n  startedAt: string | Date;\n  stoppedAt: string | Date;\n  durationInSeconds?: number;\n  createdAt: string | Date;\n  updatedAt: string | Date;\n  tags: any[];\n\n  resourceAttributes?: IResourceAttributes;\n  sessionAttributes?: ISessionAttributes;\n\n  userAttributes?: IUserAttributes\n\n  views: ISessionView[];\n  starred: boolean;\n  starredItems: string[];\n  s3Files: {\n    _id?: string;\n    bucket: string;\n    key: string;\n    dataType: DebugSessionDataType;\n    url?: string;\n  }[];\n  finishedS3Transfer?: boolean;\n  tempApiKey?: string;\n}\n\n\n\nexport interface ISessionView {\n  _id: string;\n  name: string;\n  components?: string[];\n}\n\n\nexport enum DebugSessionDataType {\n  OTLP_TRACES = 'OTLP_TRACES',\n  OTLP_LOGS = 'OTLP_LOGS',\n  RRWEB_EVENTS = 'RRWEB_EVENTS',\n}\n"]}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/type/session.ts"],"names":[],"mappings":";;;AA+EA,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC9B,mDAA2B,CAAA;IAC3B,+CAAuB,CAAA;IACvB,qDAA6B,CAAA;AAC/B,CAAC,EAJW,oBAAoB,oCAApB,oBAAoB,QAI/B","sourcesContent":["import { SessionType } from './session-type.enum'\nimport { UserType } from './user-type.enum'\n\nexport interface IResourceAttributes {\n  browserInfo?: string;\n  cookiesEnabled?: string;\n  deviceInfo?: string;\n  hardwareConcurrency?: number;\n  osInfo?: string;\n  pixelRatio?: number;\n  screenSize?: string;\n  packageVersion?: string;\n  [key: string]: any;\n}\n\nexport interface ISessionAttributes {\n  [key: string]: any;\n}\n\nexport interface IUserAttributes {\n  type: UserType\n  id?: string\n  name?: string\n  groupId?: string\n  groupName?: string\n  userEmail?: string\n  userId?: string\n  userName?: string\n  accountId?: string\n  accountName?: string\n  orgId?: string\n  orgName?: string\n  tags?: string[]\n  environment?: string\n}\n\nexport interface ISession {\n  _id: string;\n  shortId: string;\n  workspace: string;\n  project: string;\n  continuousDebugSession?: string;\n  creationType: SessionType;\n  name: string;\n  startedAt: string | Date;\n  stoppedAt: string | Date;\n  durationInSeconds?: number;\n  createdAt: string | Date;\n  updatedAt: string | Date;\n  tags: any[];\n\n  resourceAttributes?: IResourceAttributes;\n  sessionAttributes?: ISessionAttributes;\n\n  userAttributes?: IUserAttributes\n\n  views: ISessionView[];\n  starred: boolean;\n  starredItems: string[];\n  s3Files: {\n    _id?: string;\n    bucket: string;\n    key: string;\n    dataType: DebugSessionDataType;\n    url?: string;\n  }[];\n  finishedS3Transfer?: boolean;\n  tempApiKey?: string;\n}\n\n\n\nexport interface ISessionView {\n  _id: string;\n  name: string;\n  components?: string[];\n}\n\n\nexport enum DebugSessionDataType {\n  OTLP_TRACES = 'OTLP_TRACES',\n  OTLP_LOGS = 'OTLP_LOGS',\n  RRWEB_EVENTS = 'RRWEB_EVENTS',\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplayer-app/session-recorder-common",
-  "version": "1.3.16",
+  "version": "1.3.18-beta.0",
   "description": "Multiplayer Fullstack Session Recorder - opentelemetry",
   "author": {
     "name": "Multiplayer Software, Inc.",

package/src/SessionRecorderIdGenerator.ts

@@ -1,14 +1,14 @@
 import { IdGenerator } from '@opentelemetry/sdk-trace-base'
 import { SessionType } from './type'
+import { getIdGenerator } from './sdk'
 import {
-  MULTIPLAYER_TRACE_DEBUG_PREFIX,
-  MULTIPLAYER_TRACE_CONTINUOUS_DEBUG_PREFIX,
+  MULTIPLAYER_TRACE_PREFIX_MAP,
 } from './constants/constants.base'
-import { getIdGenerator } from './sdk'
 
 export class SessionRecorderIdGenerator implements IdGenerator {
   sessionShortId: string
   sessionType: SessionType
+  clientId: string
   private generateLongId: () => string
   private generateShortId: () => string
 
@@ -16,30 +16,22 @@ export class SessionRecorderIdGenerator implements IdGenerator {
     this.generateLongId = getIdGenerator(16)
     this.generateShortId = getIdGenerator(8)
     this.sessionShortId = ''
+    this.clientId = ''
     this.sessionType = SessionType.MANUAL
   }
 
   generateTraceId(): string {
     const traceId = this.generateLongId()
 
-    if (this.sessionShortId) {
-      let sessionTypePrefix: string = ''
-      switch (this.sessionType) {
-        case SessionType.CONTINUOUS:
-          sessionTypePrefix = MULTIPLAYER_TRACE_CONTINUOUS_DEBUG_PREFIX
-          break
-        default:
-          sessionTypePrefix = MULTIPLAYER_TRACE_DEBUG_PREFIX
-      }
-
-      const prefix = `${sessionTypePrefix}${this.sessionShortId}`
-
-      const sessionTraceId = `${prefix}${traceId.substring(prefix.length, traceId.length)}`
-
-      return sessionTraceId
+    if (!this.sessionShortId && !this.sessionType) {
+      return traceId
     }
 
-    return traceId
+    const sessionTypePrefix = MULTIPLAYER_TRACE_PREFIX_MAP[this.sessionType]
+    const prefix = `${sessionTypePrefix}${[SessionType.CONTINUOUS_SESSION_CACHE, SessionType.SESSION_CACHE].includes(this.sessionType) ? this.clientId : ''}${this.sessionShortId}`
+    const sessionTraceId = `${prefix}${traceId.substring(prefix.length, traceId.length)}`
+
+    return sessionTraceId
   }
 
   generateSpanId(): string {
@@ -49,8 +41,23 @@ export class SessionRecorderIdGenerator implements IdGenerator {
   setSessionId(
     sessionShortId: string,
     sessionType: SessionType = SessionType.MANUAL,
+    clientId: string = '',
   ) {
+    if (
+      !clientId &&
+      [
+        SessionType.SESSION_CACHE,
+        SessionType.CONTINUOUS_SESSION_CACHE,
+      ].includes(sessionType)
+    ) {
+      throw new Error(`Client ID is required for ${[
+        SessionType.SESSION_CACHE,
+        SessionType.CONTINUOUS_SESSION_CACHE,
+      ].join(', ')} session types`)
+    }
+
     this.sessionShortId = sessionShortId
     this.sessionType = sessionType
+    this.clientId = clientId
   }
 }

package/src/SessionRecorderTraceIdRatioBasedSampler.ts

@@ -7,6 +7,8 @@ import {
 import {
   MULTIPLAYER_TRACE_DEBUG_PREFIX,
   MULTIPLAYER_TRACE_CONTINUOUS_DEBUG_PREFIX,
+  // MULTIPLAYER_TRACE_SESSION_CACHE_PREFIX,
+  // MULTIPLAYER_TRACE_CONTINUOUS_SESSION_CACHE_PREFIX,
 } from './constants/constants.base'
 
 export class SessionRecorderTraceIdRatioBasedSampler implements Sampler {
@@ -21,6 +23,8 @@ export class SessionRecorderTraceIdRatioBasedSampler implements Sampler {
     if (
       traceId.startsWith(MULTIPLAYER_TRACE_DEBUG_PREFIX)
       || traceId.startsWith(MULTIPLAYER_TRACE_CONTINUOUS_DEBUG_PREFIX)
+      // || traceId.startsWith(MULTIPLAYER_TRACE_SESSION_CACHE_PREFIX)
+      // || traceId.startsWith(MULTIPLAYER_TRACE_CONTINUOUS_SESSION_CACHE_PREFIX)
     ) {
       return {
         decision: SamplingDecision.RECORD_AND_SAMPLED,

package/src/constants/constants.base.ts

@@ -1,3 +1,5 @@
+import { SessionType } from '../type'
+
 /**
  * @deprecated
  */
@@ -7,7 +9,20 @@ export const MULTIPLAYER_TRACE_DEBUG_PREFIX = 'debdeb'
 
 export const MULTIPLAYER_TRACE_CONTINUOUS_DEBUG_PREFIX = 'cdbcdb'
 
-export const MULTIPLAYER_TRACE_DEBUG_SESSION_SHORT_ID_LENGTH = 16
+export const MULTIPLAYER_TRACE_SESSION_CACHE_PREFIX = 'cdbcac'
+
+export const MULTIPLAYER_TRACE_CONTINUOUS_SESSION_CACHE_PREFIX = 'debcdb'
+
+export const MULTIPLAYER_TRACE_PREFIX_MAP = {
+  [SessionType.CONTINUOUS]: MULTIPLAYER_TRACE_CONTINUOUS_DEBUG_PREFIX,
+  [SessionType.SESSION_CACHE]: MULTIPLAYER_TRACE_SESSION_CACHE_PREFIX,
+  [SessionType.CONTINUOUS_SESSION_CACHE]: MULTIPLAYER_TRACE_CONTINUOUS_SESSION_CACHE_PREFIX,
+  [SessionType.MANUAL]: MULTIPLAYER_TRACE_DEBUG_PREFIX,
+} as Record<SessionType, string>
+
+export const MULTIPLAYER_TRACE_DEBUG_SESSION_SHORT_ID_LENGTH = 8
+
+export const MULTIPLAYER_TRACE_CLIENT_ID_LENGTH = 8
 
 /**
  * @deprecated Use MULTIPLAYER_OTEL_DEFAULT_TRACES_EXPORTER_HTTP_URL instead
@@ -49,6 +64,8 @@ export const ATTR_MULTIPLAYER_INTEGRATION_ID = 'multiplayer.integration.id'
 
 export const ATTR_MULTIPLAYER_SESSION_ID = 'multiplayer.session.id'
 
+export const ATTR_MULTIPLAYER_SESSION_CLIENT_ID = 'multiplayer.session.client.id'
+
 export const ATTR_MULTIPLAYER_HTTP_PROXY = 'multiplayer.http.proxy'
 
 export const ATTR_MULTIPLAYER_HTTP_PROXY_TYPE = 'multiplayer.http.proxy.type'

package/src/exporters/SessionRecorderBrowserTraceExporter.ts

@@ -1,9 +1,11 @@
 import { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base'
+import { ExportResult } from '@opentelemetry/core'
+
 import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http'
 import {
   MULTIPLAYER_OTEL_DEFAULT_TRACES_EXPORTER_HTTP_URL,
   MULTIPLAYER_TRACE_DEBUG_PREFIX,
-  MULTIPLAYER_TRACE_CONTINUOUS_DEBUG_PREFIX,
+  MULTIPLAYER_TRACE_CONTINUOUS_DEBUG_PREFIX
 } from '../constants/constants.base'
 
 export interface SessionRecorderBrowserTraceExporterConfig {
@@ -48,7 +50,7 @@ export class SessionRecorderBrowserTraceExporter implements SpanExporter {
       keepAlive = true,
       concurrencyLimit = 20,
       postMessageType = 'MULTIPLAYER_SESSION_DEBUGGER_LIB',
-      postMessageTargetOrigin = '*',
+      postMessageTargetOrigin = '*'
     } = config
 
     this.config = {
@@ -56,9 +58,9 @@ export class SessionRecorderBrowserTraceExporter implements SpanExporter {
       url,
       apiKey,
       headers,
-      timeoutMillis,
       keepAlive,
-      concurrencyLimit,
+      timeoutMillis,
+      concurrencyLimit
     }
     this.postMessageType = postMessageType
     this.postMessageTargetOrigin = postMessageTargetOrigin
@@ -66,15 +68,14 @@ export class SessionRecorderBrowserTraceExporter implements SpanExporter {
     this.exporter = this._createExporter()
   }
 
-  export(
-    spans: ReadableSpan[],
-    resultCallback: (result: { code: number }) => void,
-  ): void {
+  export(spans: ReadableSpan[], resultCallback: (result: { code: number }) => void): void {
     // Filter spans to only include those with Multiplayer trace prefixes
-    const filteredSpans = spans.filter(span => {
+    const filteredSpans = spans.filter((span) => {
       const traceId = span.spanContext().traceId
-      return traceId.startsWith(MULTIPLAYER_TRACE_DEBUG_PREFIX) ||
+      return (
+        traceId.startsWith(MULTIPLAYER_TRACE_DEBUG_PREFIX) ||
         traceId.startsWith(MULTIPLAYER_TRACE_CONTINUOUS_DEBUG_PREFIX)
+      )
     })
 
     // Only proceed if there are filtered spans
@@ -104,6 +105,14 @@ export class SessionRecorderBrowserTraceExporter implements SpanExporter {
     return this.exporter.shutdown()
   }
 
+  exportBuffer(spans: ReadableSpan[]): Promise<ExportResult | undefined> {
+    return new Promise((resolve) => {
+      this.exporter.export(spans, (result) => {
+        resolve(result)
+      })
+    })
+  }
+
   private exportViaPostMessage(spans: ReadableSpan[], resultCallback: (result: { code: number }) => void): void {
     if (typeof window === 'undefined') {
       resultCallback({ code: 1 })
@@ -115,9 +124,9 @@ export class SessionRecorderBrowserTraceExporter implements SpanExporter {
         {
           action: 'traces',
           type: this.postMessageType,
-          payload: spans.map(span => this._serializeSpan(span)),
+          payload: spans.map((span) => this.serializeSpan(span))
         },
-        this.postMessageTargetOrigin,
+        this.postMessageTargetOrigin
       )
       resultCallback({ code: 0 })
     } catch (e) {
@@ -125,7 +134,7 @@ export class SessionRecorderBrowserTraceExporter implements SpanExporter {
     }
   }
 
-  private _serializeSpan(span: ReadableSpan): any {
+  serializeSpan(span: ReadableSpan): any {
     const spanContext = span.spanContext()
     return {
       _spanContext: spanContext,
@@ -136,17 +145,15 @@ export class SessionRecorderBrowserTraceExporter implements SpanExporter {
       events: span.events,
       status: span.status,
       endTime: span.endTime,
-      startTime: span.startTime,
+      resource: span.resource,
       duration: span.duration,
+      startTime: span.startTime,
       attributes: span.attributes,
-      parentSpanId: span.parentSpanContext?.spanId,
-      droppedAttributesCount: span.droppedAttributesCount,
-      droppedEventsCount: span.droppedEventsCount,
       droppedLinksCount: span.droppedLinksCount,
-      resource: {
-        attributes: span.resource.attributes,
-        asyncAttributesPending: span.resource.asyncAttributesPending,
-      },
+      parentSpanContext: span.parentSpanContext,
+      droppedEventsCount: span.droppedEventsCount,
+      instrumentationScope: span.instrumentationScope,
+      droppedAttributesCount: span.droppedAttributesCount
     }
   }
 
@@ -155,18 +162,17 @@ export class SessionRecorderBrowserTraceExporter implements SpanExporter {
       url: this.config.url,
       headers: {
         'Content-Type': 'application/json',
-        ...(this.config.apiKey ? { 'Authorization': this.config.apiKey } : {}),
-        ...(this.config.headers || {}),
+        ...(this.config.apiKey ? { Authorization: this.config.apiKey } : {}),
+        ...(this.config.headers || {})
       },
       timeoutMillis: this.config.timeoutMillis,
       keepAlive: this.config.keepAlive,
-      concurrencyLimit: this.config.concurrencyLimit,
+      concurrencyLimit: this.config.concurrencyLimit
     })
   }
 
   setApiKey(apiKey: string): void {
     this.config.apiKey = apiKey
-
     this.exporter = this._createExporter()
   }
 }

package/src/type/crash-buffer.ts

@@ -0,0 +1,73 @@
+export type CrashBufferAttrs = {
+  sessionAttributes?: Record<string, any>
+  resourceAttributes?: Record<string, any>
+  userAttributes?: any
+}
+
+export type CrashBufferRrwebEventPayload = {
+  ts: number
+  isFullSnapshot?: boolean
+  event: any
+}
+
+export type CrashBufferOtelSpanPayload = {
+  ts: number
+  span: any
+}
+
+/**
+ * Batch append payload for OTEL spans.
+ * This is intentionally the same per-span shape as `CrashBufferOtelSpanPayload`,
+ * just provided as an array to allow implementations to persist efficiently.
+ */
+export type CrashBufferOtelSpanBatchPayload = CrashBufferOtelSpanPayload[]
+
+export type CrashBufferErrorSpanAppendedEvent = CrashBufferOtelSpanPayload
+
+export type CrashBufferEventName = 'error-span-appended'
+
+export type CrashBufferEventMap = {
+  'error-span-appended': CrashBufferErrorSpanAppendedEvent
+}
+
+export type CrashBufferSnapshot = {
+  rrwebEvents: CrashBufferRrwebEventPayload[]
+  otelSpans: CrashBufferOtelSpanPayload[]
+  attrs: CrashBufferAttrs | null
+  windowMs: number
+  fromTs: number
+  toTs: number
+}
+
+/**
+ * Shared CrashBuffer contract used across browser + react-native implementations.
+ *
+ * Notes:
+ * - `windowMs` is optional because browser implementations usually bake the window into the instance,
+ *   while React Native typically passes it per call.
+ * - `pruneOlderThan` is optional because browser implementations can handle pruning internally.
+ */
+export interface CrashBuffer {
+  setAttrs(attrs: CrashBufferAttrs): Promise<void>
+  appendEvent(payload: CrashBufferRrwebEventPayload, windowMs?: number): Promise<void>
+  appendSpans(payload: CrashBufferOtelSpanBatchPayload, windowMs?: number): Promise<void>
+  snapshot(windowMs?: number, now?: number): Promise<CrashBufferSnapshot>
+  clear(): Promise<void>
+  pruneOlderThan?(cutoffTs: number): Promise<void>
+  on?(
+    event: CrashBufferEventName,
+    listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void
+  ): () => void
+  off?(
+    event: CrashBufferEventName,
+    listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void
+  ): void
+}
+
+/**
+ * Optional lifecycle controls supported by some CrashBuffer implementations (e.g. browser tabs).
+ */
+export interface CrashBufferLifecycle extends CrashBuffer {
+  setActive(active: boolean): void
+  needsFullSnapshot(): boolean
+}

package/src/type/index.ts

@@ -1,3 +1,4 @@
 export * from './session-type.enum'
 export * from './user-type.enum'
-export * from './session'
+export * from './session'
+export * from './crash-buffer'

package/src/type/session-type.enum.ts

@@ -5,4 +5,7 @@ export enum SessionType {
    */
   PLAIN = 'MANUAL',
   MANUAL = 'MANUAL',
+
+  CONTINUOUS_SESSION_CACHE = 'CONTINUOUS_SESSION_CACHE',
+  SESSION_CACHE = 'SESSION_CACHE',
 }

package/src/type/session.ts

@@ -1,5 +1,5 @@
-import { SessionType } from "./session-type.enum";
-import { UserType } from "./user-type.enum";
+import { SessionType } from './session-type.enum'
+import { UserType } from './user-type.enum'
 
 export interface IResourceAttributes {
   browserInfo?: string;