@anyreplay/electron 0.0.0-stage → 0.2.1

package/dist/index.js

@@ -0,0 +1,137 @@
+import {
+  BRIDGE_KEY,
+  CHANNELS
+} from "./chunk-5TQ2HVGX.js";
+
+// src/version.ts
+var SDK_NAME = "@anyreplay/electron";
+var SDK_VERSION = true ? "0.2.1" : "0.0.0-dev";
+var PLATFORM = "electron";
+
+// src/web-family.ts
+import {
+  createRecorder
+} from "@anyreplay/browser";
+var MAX_QUEUED = 64;
+function deferredRecorder(start, onStarted) {
+  let real = null;
+  let stopped = false;
+  const queue = [];
+  const run = (call) => {
+    if (real) {
+      call(real);
+      return;
+    }
+    if (stopped || queue.length >= MAX_QUEUED) return;
+    queue.push(call);
+  };
+  const ready = start().then((setup) => {
+    if (!setup || stopped) return;
+    real = createRecorder(setup.options, setup.shell);
+    for (const call of queue.splice(0)) call(real);
+    onStarted?.(real);
+  }).catch((error) => {
+    if (typeof console !== "undefined") console.warn("[anyreplay]", error);
+  });
+  return {
+    ready,
+    status: () => real ? real.status() : stopped ? "stopped" : "idle",
+    sessionId: () => real?.sessionId() ?? null,
+    consent: (granted) => run((h) => h.consent(granted)),
+    identify: (traits) => run((h) => h.identify(traits)),
+    track: (name, properties) => run((h) => h.track(name, properties)),
+    trackError: (error) => run((h) => h.trackError(error)),
+    stop: () => {
+      if (real) real.stop();
+      else {
+        stopped = true;
+        queue.length = 0;
+      }
+    },
+    flush: async () => {
+      await ready;
+      await real?.flush();
+    }
+  };
+}
+var APP_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{1,254}$/;
+var clipVersion = (version) => {
+  const trimmed = version?.trim();
+  return trimmed ? trimmed.slice(0, 40) : void 0;
+};
+
+// src/index.ts
+var current = null;
+function init(options) {
+  if (current) return current;
+  const bridge = findBridge();
+  const { flushOnBlur = true, ...rest } = options;
+  const handle = deferredRecorder(
+    async () => {
+      const info = bridge ? await bridge.appInfo() : {};
+      return electronSetup(rest, info);
+    },
+    (recorder) => wire(recorder, bridge, flushOnBlur)
+  );
+  current = handle;
+  return handle;
+}
+function electronSetup(options, info) {
+  const appId = options.appId?.trim() || info.appId;
+  if (!appId && typeof console !== "undefined") {
+    console.warn("[anyreplay] no appId: call setupAnyReplay({ appId }) in the main process and exposeAnyReplay() in the preload. A project that lists allowed apps refuses sessions without one.");
+  }
+  if (appId && !APP_ID_PATTERN.test(appId)) {
+    throw new Error(`anyreplay: appId ${JSON.stringify(appId)} should be an app identifier such as com.example.app`);
+  }
+  const { appVersion: ownVersion, ...browserOptions } = options;
+  const appVersion = clipVersion(ownVersion ?? info.appVersion);
+  return {
+    options: {
+      // Inline unless the app says otherwise: a window loaded from the app's
+      // own files has addresses no reviewer can load (contract §9.1).
+      assets: "inline",
+      ...browserOptions,
+      ...appId ? { appId } : {}
+    },
+    shell: {
+      platform: PLATFORM,
+      sdk: { name: SDK_NAME, version: SDK_VERSION },
+      ...appVersion ? { appVersion } : {}
+    }
+  };
+}
+function wire(recorder, bridge, flushOnBlur) {
+  bridge?.onFlushRequest(() => recorder.flush());
+  bridge?.onMainError((error) => recorder.trackError(mainError(error)));
+  if (flushOnBlur && typeof window !== "undefined") {
+    window.addEventListener("blur", () => {
+      void recorder.flush();
+    });
+  }
+}
+function mainError(error) {
+  const value = new Error(typeof error?.message === "string" ? error.message : "error");
+  value.name = typeof error?.name === "string" && error.name ? error.name : "Error";
+  value.stack = typeof error?.stack === "string" ? error.stack : "";
+  return value;
+}
+function findBridge() {
+  const candidate = globalThis[BRIDGE_KEY];
+  return candidate && typeof candidate.appInfo === "function" ? candidate : null;
+}
+function __resetForTests() {
+  current?.stop();
+  current = null;
+}
+export {
+  BRIDGE_KEY,
+  CHANNELS,
+  SDK_NAME,
+  SDK_VERSION,
+  __resetForTests,
+  electronSetup,
+  init,
+  mainError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/version.ts","../src/web-family.ts","../src/index.ts"],"sourcesContent":["/**\n * Which SDK recorded a session (docs/SDK-CONTRACT.md §2.4).\n *\n * The version is written in at build time by tsup (and by Vitest for the\n * tests) from package.json, as in the browser SDK; source used without that\n * step reports `0.0.0-dev`.\n */\ndeclare const __ANYREPLAY_SDK_VERSION__: string | undefined;\n\nexport const SDK_NAME = '@anyreplay/electron';\n\nexport const SDK_VERSION: string =\n  typeof __ANYREPLAY_SDK_VERSION__ === 'string' ? __ANYREPLAY_SDK_VERSION__ : '0.0.0-dev';\n\nexport const PLATFORM = 'electron';\n","import {\n  createRecorder, type AnyReplayOptions, type RecorderHandle, type RecorderStatus, type ShellInfo,\n} from '@anyreplay/browser';\n\n/**\n * What a desktop shell hands the browser SDK: its options, and who is\n * recording (docs/SDK-CONTRACT.md §1, §4) — the platform and SDK the session\n * reports and the app's version. `createRecorder(options, shell)` is how a\n * wrapper names itself without a public option a website could set.\n */\nexport interface RecorderSetup {\n  options: AnyReplayOptions;\n  shell: ShellInfo;\n}\n\n/**\n * A recorder handle that exists before the recorder does.\n *\n * A shell learns its app id and version asynchronously (an IPC round trip in\n * Electron, a Tauri command), but `init` has to hand something back at once so\n * an app can call `track` on its next line. Calls made in between are queued\n * in order and replayed on the real handle; `flush` waits for it.\n */\nexport interface DeferredHandle extends RecorderHandle {\n  /** Resolves once the recorder has started (or failed to). Never rejects. */\n  ready: Promise<void>;\n}\n\ntype Queued = (handle: RecorderHandle) => void;\n\n/** At most this many calls wait for the app info; enough for a boot sequence. */\nconst MAX_QUEUED = 64;\n\nexport function deferredRecorder(\n  start: () => Promise<RecorderSetup | null>,\n  onStarted?: (handle: RecorderHandle) => void,\n): DeferredHandle {\n  let real: RecorderHandle | null = null;\n  let stopped = false;\n  const queue: Queued[] = [];\n\n  const run = (call: Queued): void => {\n    if (real) {\n      call(real);\n      return;\n    }\n    if (stopped || queue.length >= MAX_QUEUED) return;\n    queue.push(call);\n  };\n\n  const ready = start()\n    .then((setup) => {\n      if (!setup || stopped) return;\n      real = createRecorder(setup.options, setup.shell);\n      for (const call of queue.splice(0)) call(real);\n      onStarted?.(real);\n    })\n    .catch((error: unknown) => {\n      // Nothing this library does may surface as an error in the app.\n      if (typeof console !== 'undefined') console.warn('[anyreplay]', error);\n    });\n\n  return {\n    ready,\n    status: (): RecorderStatus => (real ? real.status() : stopped ? 'stopped' : 'idle'),\n    sessionId: () => real?.sessionId() ?? null,\n    consent: (granted) => run((h) => h.consent(granted)),\n    identify: (traits) => run((h) => h.identify(traits)),\n    track: (name, properties) => run((h) => h.track(name, properties)),\n    trackError: (error) => run((h) => h.trackError(error)),\n    stop: () => {\n      if (real) real.stop();\n      else { stopped = true; queue.length = 0; }\n    },\n    flush: async () => {\n      await ready;\n      await real?.flush();\n    },\n  };\n}\n\n/** The browser SDK's app-id rule (`APP_ID_PATTERN`), so a bad id is caught here with a better message. */\nexport const APP_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{1,254}$/;\n\n/** `meta.appVersion` is at most 40 characters (§2.5). */\nexport const clipVersion = (version: string | undefined): string | undefined => {\n  const trimmed = version?.trim();\n  return trimmed ? trimmed.slice(0, 40) : undefined;\n};\n","import type { AnyReplayOptions, RecorderHandle } from '@anyreplay/browser';\nimport { BRIDGE_KEY, type AnyReplayBridge, type AppInfo, type MainErrorMessage } from './bridge.js';\nimport { PLATFORM, SDK_NAME, SDK_VERSION } from './version.js';\nimport { APP_ID_PATTERN, clipVersion, deferredRecorder, type DeferredHandle, type RecorderSetup } from './web-family.js';\n\nexport { BRIDGE_KEY, CHANNELS, type AnyReplayBridge, type AppInfo, type MainErrorMessage } from './bridge.js';\nexport { SDK_NAME, SDK_VERSION } from './version.js';\nexport type { RecorderSetup } from './web-family.js';\n\nexport interface AnyReplayElectronOptions extends AnyReplayOptions {\n  /**\n   * The app id. Normally left out: the main process supplies it\n   * (`setupAnyReplay({ appId })`). Set here, it wins.\n   */\n  appId?: string;\n  /** The app version. Normally left out: the main process supplies `app.getVersion()`. */\n  appVersion?: string;\n  /**\n   * Send what has been recorded whenever the window loses focus. On by\n   * default: a desktop app is rarely closed the way a tab is, and the main\n   * process can be killed without `before-quit`.\n   */\n  flushOnBlur?: boolean;\n}\n\nexport type AnyReplayElectron = DeferredHandle;\n\nlet current: AnyReplayElectron | null = null;\n\n/**\n * Starts recording this window. Call it once in the renderer, as early as you\n * can:\n *\n * ```ts\n * import { init } from '@anyreplay/electron';\n * const replay = init({ projectKey: 'ar_pk_live_…' });\n * replay.track('document_opened');\n * ```\n *\n * The app id and version come from the main process through the preload\n * bridge (`exposeAnyReplay()` and `setupAnyReplay()`), so recording starts a\n * moment after this returns; calls made in between are queued. A second call\n * returns the first handle.\n *\n * Each window is its own session: the session id lives in the window's\n * `sessionStorage`, the visitor id in `localStorage`, which Electron keeps\n * across launches and shares between windows of the same session partition.\n */\nexport function init(options: AnyReplayElectronOptions): AnyReplayElectron {\n  if (current) return current;\n  const bridge = findBridge();\n  const { flushOnBlur = true, ...rest } = options;\n\n  const handle = deferredRecorder(\n    async () => {\n      const info: AppInfo = bridge ? await bridge.appInfo() : {};\n      return electronSetup(rest, info);\n    },\n    (recorder) => wire(recorder, bridge, flushOnBlur),\n  );\n  current = handle;\n  return handle;\n}\n\n/**\n * The browser SDK's options for this window — the installer's, with the app\n * id filled in — and the shell it runs in, which only the wrapper knows.\n */\nexport function electronSetup(options: AnyReplayElectronOptions, info: AppInfo): RecorderSetup {\n  const appId = options.appId?.trim() || info.appId;\n  if (!appId && typeof console !== 'undefined') {\n    console.warn('[anyreplay] no appId: call setupAnyReplay({ appId }) in the main process and exposeAnyReplay() in the preload. A project that lists allowed apps refuses sessions without one.');\n  }\n  if (appId && !APP_ID_PATTERN.test(appId)) {\n    // Thrown by the browser SDK too; said here in the shell's own terms.\n    throw new Error(`anyreplay: appId ${JSON.stringify(appId)} should be an app identifier such as com.example.app`);\n  }\n  const { appVersion: ownVersion, ...browserOptions } = options;\n  const appVersion = clipVersion(ownVersion ?? info.appVersion);\n  return {\n    options: {\n      // Inline unless the app says otherwise: a window loaded from the app's\n      // own files has addresses no reviewer can load (contract §9.1).\n      assets: 'inline',\n      ...browserOptions,\n      ...(appId ? { appId } : {}),\n    },\n    shell: {\n      platform: PLATFORM,\n      sdk: { name: SDK_NAME, version: SDK_VERSION },\n      ...(appVersion ? { appVersion } : {}),\n    },\n  };\n}\n\nfunction wire(recorder: RecorderHandle, bridge: AnyReplayBridge | null, flushOnBlur: boolean): void {\n  bridge?.onFlushRequest(() => recorder.flush());\n  // An error like the window's own: the same `anyreplay.error` event, the same\n  // redaction and ceiling, and the session's `hasError` set (contract §8.3).\n  bridge?.onMainError((error) => recorder.trackError(mainError(error)));\n  if (flushOnBlur && typeof window !== 'undefined') {\n    window.addEventListener('blur', () => { void recorder.flush(); });\n  }\n}\n\n/**\n * A main-process error as an `Error` again — it crossed IPC as plain fields —\n * for the browser SDK to redact and clip like any other.\n */\nexport function mainError(error: MainErrorMessage | undefined): Error {\n  const value = new Error(typeof error?.message === 'string' ? error.message : 'error');\n  value.name = typeof error?.name === 'string' && error.name ? error.name : 'Error';\n  value.stack = typeof error?.stack === 'string' ? error.stack : '';\n  return value;\n}\n\nfunction findBridge(): AnyReplayBridge | null {\n  const candidate = (globalThis as Record<string, unknown>)[BRIDGE_KEY] as AnyReplayBridge | undefined;\n  return candidate && typeof candidate.appInfo === 'function' ? candidate : null;\n}\n\n/** For tests: forget the handle `init` returned. */\nexport function __resetForTests(): void {\n  current?.stop();\n  current = null;\n}\n"],"mappings":"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","names":[]}

package/dist/main.cjs

@@ -0,0 +1,143 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/main.ts
+var main_exports = {};
+__export(main_exports, {
+  describeError: () => describeError,
+  flushAll: () => flushAll,
+  resolveAppId: () => resolveAppId,
+  setupAnyReplay: () => setupAnyReplay
+});
+module.exports = __toCommonJS(main_exports);
+var import_electron = require("electron");
+
+// src/bridge.ts
+var CHANNELS = {
+  /** renderer → main (invoke): `AppInfo`. */
+  appInfo: "anyreplay:app-info",
+  /** main → renderer: flush now, then answer on `flushed` with the same id. */
+  flush: "anyreplay:flush",
+  /** renderer → main: a flush asked for by `flush` has finished. */
+  flushed: "anyreplay:flushed",
+  /** main → renderer: an uncaught exception in the main process. */
+  mainError: "anyreplay:main-error"
+};
+
+// src/main.ts
+var DEFAULT_QUIT_FLUSH_TIMEOUT_MS = 1500;
+var APP_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{1,254}$/;
+function resolveAppId(explicit, name) {
+  const given = explicit?.trim();
+  if (given) return APP_ID_PATTERN.test(given) ? given : void 0;
+  const raw = name?.trim() ?? "";
+  if (APP_ID_PATTERN.test(raw)) return raw;
+  const slug = raw.toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^[^a-z0-9]+|-+$/g, "");
+  return APP_ID_PATTERN.test(slug) ? slug : void 0;
+}
+function setupAnyReplay(options = {}) {
+  const appId = resolveAppId(options.appId, import_electron.app.getName());
+  if (options.appId !== void 0 && !appId) {
+    console.warn(`[anyreplay] appId ${JSON.stringify(options.appId)} is not an app identifier such as com.example.app; sessions are sent without one`);
+  }
+  const info = {
+    ...appId ? { appId } : {},
+    appVersion: import_electron.app.getVersion()
+  };
+  const cleanup = [];
+  import_electron.ipcMain.handle(CHANNELS.appInfo, () => info);
+  cleanup.push(() => import_electron.ipcMain.removeHandler(CHANNELS.appInfo));
+  const timeout = options.quitFlushTimeoutMs ?? DEFAULT_QUIT_FLUSH_TIMEOUT_MS;
+  if (timeout > 0) {
+    let flushed = false;
+    let flushing = false;
+    const onBeforeQuit = (event) => {
+      if (flushed) return;
+      event.preventDefault();
+      if (flushing) return;
+      flushing = true;
+      void flushAll(import_electron.BrowserWindow.getAllWindows().map((window) => window.webContents), timeout).finally(() => {
+        flushed = true;
+        import_electron.app.quit();
+      });
+    };
+    import_electron.app.on("before-quit", onBeforeQuit);
+    cleanup.push(() => import_electron.app.removeListener("before-quit", onBeforeQuit));
+  }
+  if (options.forwardMainErrors !== false) {
+    const onError = (error) => {
+      try {
+        const target = import_electron.BrowserWindow.getFocusedWindow() ?? import_electron.BrowserWindow.getAllWindows()[0];
+        if (!target || target.isDestroyed()) return;
+        target.webContents.send(CHANNELS.mainError, describeError(error));
+      } catch {
+      }
+    };
+    process.on("uncaughtExceptionMonitor", onError);
+    cleanup.push(() => process.removeListener("uncaughtExceptionMonitor", onError));
+  }
+  return { dispose: () => {
+    for (const undo of cleanup.splice(0).reverse()) undo();
+  } };
+}
+function describeError(error) {
+  if (error instanceof Error) {
+    return { name: error.name, message: error.message, ...error.stack ? { stack: error.stack } : {} };
+  }
+  return { message: String(error) };
+}
+function flushAll(targets, timeoutMs) {
+  const live = targets.filter((contents) => !contents.isDestroyed());
+  if (live.length === 0) return Promise.resolve();
+  return new Promise((resolve) => {
+    const id = `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    const waiting = new Set(live.map((contents) => contents.id));
+    let done = false;
+    const finish = () => {
+      if (done) return;
+      done = true;
+      clearTimeout(timer);
+      import_electron.ipcMain.removeListener(CHANNELS.flushed, onFlushed);
+      resolve();
+    };
+    const onFlushed = (event, answered) => {
+      if (answered !== id) return;
+      waiting.delete(event.sender.id);
+      if (waiting.size === 0) finish();
+    };
+    const timer = setTimeout(finish, timeoutMs);
+    import_electron.ipcMain.on(CHANNELS.flushed, onFlushed);
+    for (const contents of live) {
+      try {
+        contents.send(CHANNELS.flush, id);
+      } catch {
+        waiting.delete(contents.id);
+      }
+    }
+    if (waiting.size === 0) finish();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  describeError,
+  flushAll,
+  resolveAppId,
+  setupAnyReplay
+});
+//# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/main.ts","../src/bridge.ts"],"sourcesContent":["import { app, BrowserWindow, ipcMain, type WebContents } from 'electron';\nimport { CHANNELS, type AppInfo, type MainErrorMessage } from './bridge.js';\n\nexport interface AnyReplayMainOptions {\n  /**\n   * The app id sessions are reported under (§2.2 of the SDK contract) — the\n   * id you list under the project's allowed apps. Use your bundle id, the\n   * `appId` from electron-builder or Forge's `appBundleId`\n   * (`com.example.notes`).\n   *\n   * Electron has no API for the bundle id, so without this the id is made from\n   * `app.getName()`: kept as it is when it is already a valid id, otherwise\n   * lower-cased with every run of other characters turned into `-`\n   * (`\"Acme Notes\"` → `acme-notes`). Pass it explicitly in anything you ship.\n   */\n  appId?: string;\n  /**\n   * How long quitting may wait for the windows to send what they have\n   * recorded, in milliseconds. Default 1500; `0` turns the flush off.\n   */\n  quitFlushTimeoutMs?: number;\n  /**\n   * Forward uncaught exceptions in the main process into the focused window's\n   * recording as an error, as if the window had caught it (`trackError`): it\n   * shows in the replay's errors and marks the session as having one. On by\n   * default.\n   *\n   * Observed with `uncaughtExceptionMonitor`, so it changes nothing about how\n   * your app handles (or does not handle) the error. The message and stack are\n   * redacted in the window before they are recorded, by the same rules as the\n   * page's own errors.\n   */\n  forwardMainErrors?: boolean;\n}\n\nexport interface AnyReplayMainHandle {\n  /** Removes every listener and handler this installed. */\n  dispose: () => void;\n}\n\nconst DEFAULT_QUIT_FLUSH_TIMEOUT_MS = 1500;\nconst APP_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{1,254}$/;\n\n/** The app id from an explicit option or, failing that, from the app's name. */\nexport function resolveAppId(explicit: string | undefined, name: string | undefined): string | undefined {\n  const given = explicit?.trim();\n  if (given) return APP_ID_PATTERN.test(given) ? given : undefined;\n  const raw = name?.trim() ?? '';\n  if (APP_ID_PATTERN.test(raw)) return raw;\n  const slug = raw.toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^[^a-z0-9]+|-+$/g, '');\n  return APP_ID_PATTERN.test(slug) ? slug : undefined;\n}\n\n/**\n * Wires the main process to the recorder in your windows. Call it once, early\n * in your main process, before the first window loads:\n *\n * ```ts\n * // main.ts\n * import { setupAnyReplay } from '@anyreplay/electron/main';\n * setupAnyReplay({ appId: 'com.example.notes' });\n * ```\n *\n * It answers the windows' request for the app id and version, holds quitting\n * back (briefly) until every window has sent what it recorded, and forwards\n * uncaught main-process exceptions into the focused window's session.\n */\nexport function setupAnyReplay(options: AnyReplayMainOptions = {}): AnyReplayMainHandle {\n  const appId = resolveAppId(options.appId, app.getName());\n  if (options.appId !== undefined && !appId) {\n    console.warn(`[anyreplay] appId ${JSON.stringify(options.appId)} is not an app identifier such as com.example.app; sessions are sent without one`);\n  }\n  const info: AppInfo = {\n    ...(appId ? { appId } : {}),\n    appVersion: app.getVersion(),\n  };\n  const cleanup: (() => void)[] = [];\n\n  ipcMain.handle(CHANNELS.appInfo, () => info);\n  cleanup.push(() => ipcMain.removeHandler(CHANNELS.appInfo));\n\n  const timeout = options.quitFlushTimeoutMs ?? DEFAULT_QUIT_FLUSH_TIMEOUT_MS;\n  if (timeout > 0) {\n    let flushed = false;\n    let flushing = false;\n    const onBeforeQuit = (event: Electron.Event): void => {\n      if (flushed) return;\n      event.preventDefault();\n      if (flushing) return;\n      flushing = true;\n      void flushAll(BrowserWindow.getAllWindows().map((window) => window.webContents), timeout).finally(() => {\n        flushed = true;\n        app.quit();\n      });\n    };\n    app.on('before-quit', onBeforeQuit);\n    cleanup.push(() => app.removeListener('before-quit', onBeforeQuit));\n  }\n\n  if (options.forwardMainErrors !== false) {\n    const onError = (error: Error): void => {\n      try {\n        const target = BrowserWindow.getFocusedWindow() ?? BrowserWindow.getAllWindows()[0];\n        if (!target || target.isDestroyed()) return;\n        target.webContents.send(CHANNELS.mainError, describeError(error));\n      } catch {\n        /* the app is already failing; this must not add to it */\n      }\n    };\n    process.on('uncaughtExceptionMonitor', onError);\n    cleanup.push(() => process.removeListener('uncaughtExceptionMonitor', onError));\n  }\n\n  return { dispose: () => { for (const undo of cleanup.splice(0).reverse()) undo(); } };\n}\n\n/** What crosses to the window: plain strings, since an Error does not survive structured cloning whole. */\nexport function describeError(error: unknown): MainErrorMessage {\n  if (error instanceof Error) {\n    return { name: error.name, message: error.message, ...(error.stack ? { stack: error.stack } : {}) };\n  }\n  return { message: String(error) };\n}\n\n/**\n * Asks every page to flush and waits for all of them, or for the timeout.\n *\n * A page with no recorder (or no preload) never answers; the timeout is what\n * keeps that from holding quitting up for longer than it was allowed to.\n */\nexport function flushAll(targets: readonly WebContents[], timeoutMs: number): Promise<void> {\n  const live = targets.filter((contents) => !contents.isDestroyed());\n  if (live.length === 0) return Promise.resolve();\n\n  return new Promise<void>((resolve) => {\n    const id = `${Date.now()}-${Math.random().toString(36).slice(2)}`;\n    const waiting = new Set(live.map((contents) => contents.id));\n    let done = false;\n    const finish = (): void => {\n      if (done) return;\n      done = true;\n      clearTimeout(timer);\n      ipcMain.removeListener(CHANNELS.flushed, onFlushed);\n      resolve();\n    };\n    const onFlushed = (event: Electron.IpcMainEvent, answered: unknown): void => {\n      if (answered !== id) return;\n      waiting.delete(event.sender.id);\n      if (waiting.size === 0) finish();\n    };\n    const timer = setTimeout(finish, timeoutMs);\n    ipcMain.on(CHANNELS.flushed, onFlushed);\n    for (const contents of live) {\n      try {\n        contents.send(CHANNELS.flush, id);\n      } catch {\n        waiting.delete(contents.id);\n      }\n    }\n    if (waiting.size === 0) finish();\n  });\n}\n","/**\n * The contract between the three halves of the Electron SDK.\n *\n * The renderer records; the preload script is the only code that can talk to\n * the main process; the main process knows the app's id and version and sees\n * the app quit. They share nothing but these names, so each entry point can be\n * imported on its own without pulling in the others (or the recorder, which\n * has no business in the main process).\n */\n\n/** The global the preload script exposes through `contextBridge`. */\nexport const BRIDGE_KEY = 'anyreplayElectron';\n\n/** IPC channels. All of them, so a reviewer can see exactly what crosses. */\nexport const CHANNELS = {\n  /** renderer → main (invoke): `AppInfo`. */\n  appInfo: 'anyreplay:app-info',\n  /** main → renderer: flush now, then answer on `flushed` with the same id. */\n  flush: 'anyreplay:flush',\n  /** renderer → main: a flush asked for by `flush` has finished. */\n  flushed: 'anyreplay:flushed',\n  /** main → renderer: an uncaught exception in the main process. */\n  mainError: 'anyreplay:main-error',\n} as const;\n\n/** What the main process says about the app. */\nexport interface AppInfo {\n  /** The app id (§2.2 of the SDK contract), already checked against the id pattern. Absent when none could be found. */\n  appId?: string;\n  /** `app.getVersion()`. */\n  appVersion?: string;\n}\n\n/** An uncaught exception in the main process, as sent to a window. Raw: the renderer redacts it. */\nexport interface MainErrorMessage {\n  name?: string;\n  message: string;\n  stack?: string;\n}\n\n/**\n * What the preload script exposes on `window.anyreplayElectron`.\n *\n * Deliberately narrow: three fixed channels, no generic `send` or `invoke`, so\n * exposing it gives page script no more reach into the main process than\n * asking for the app's version and answering a flush.\n */\nexport interface AnyReplayBridge {\n  /** The bridge's own version, so a newer renderer can tell an older preload apart. */\n  readonly version: 1;\n  appInfo: () => Promise<AppInfo>;\n  /** The renderer's flush; called when the main process is about to quit. Replaces any earlier one. */\n  onFlushRequest: (flush: () => Promise<void> | void) => void;\n  /** Called with each main-process error forwarded to this window. Replaces any earlier listener. */\n  onMainError: (listener: (error: MainErrorMessage) => void) => void;\n}\n"],"mappings":"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","names":[]}

package/dist/main.d.cts

@@ -0,0 +1,66 @@
+import { WebContents } from 'electron';
+import { M as MainErrorMessage } from './bridge-BQKD7rrG.cjs';
+
+interface AnyReplayMainOptions {
+    /**
+     * The app id sessions are reported under (§2.2 of the SDK contract) — the
+     * id you list under the project's allowed apps. Use your bundle id, the
+     * `appId` from electron-builder or Forge's `appBundleId`
+     * (`com.example.notes`).
+     *
+     * Electron has no API for the bundle id, so without this the id is made from
+     * `app.getName()`: kept as it is when it is already a valid id, otherwise
+     * lower-cased with every run of other characters turned into `-`
+     * (`"Acme Notes"` → `acme-notes`). Pass it explicitly in anything you ship.
+     */
+    appId?: string;
+    /**
+     * How long quitting may wait for the windows to send what they have
+     * recorded, in milliseconds. Default 1500; `0` turns the flush off.
+     */
+    quitFlushTimeoutMs?: number;
+    /**
+     * Forward uncaught exceptions in the main process into the focused window's
+     * recording as an error, as if the window had caught it (`trackError`): it
+     * shows in the replay's errors and marks the session as having one. On by
+     * default.
+     *
+     * Observed with `uncaughtExceptionMonitor`, so it changes nothing about how
+     * your app handles (or does not handle) the error. The message and stack are
+     * redacted in the window before they are recorded, by the same rules as the
+     * page's own errors.
+     */
+    forwardMainErrors?: boolean;
+}
+interface AnyReplayMainHandle {
+    /** Removes every listener and handler this installed. */
+    dispose: () => void;
+}
+/** The app id from an explicit option or, failing that, from the app's name. */
+declare function resolveAppId(explicit: string | undefined, name: string | undefined): string | undefined;
+/**
+ * Wires the main process to the recorder in your windows. Call it once, early
+ * in your main process, before the first window loads:
+ *
+ * ```ts
+ * // main.ts
+ * import { setupAnyReplay } from '@anyreplay/electron/main';
+ * setupAnyReplay({ appId: 'com.example.notes' });
+ * ```
+ *
+ * It answers the windows' request for the app id and version, holds quitting
+ * back (briefly) until every window has sent what it recorded, and forwards
+ * uncaught main-process exceptions into the focused window's session.
+ */
+declare function setupAnyReplay(options?: AnyReplayMainOptions): AnyReplayMainHandle;
+/** What crosses to the window: plain strings, since an Error does not survive structured cloning whole. */
+declare function describeError(error: unknown): MainErrorMessage;
+/**
+ * Asks every page to flush and waits for all of them, or for the timeout.
+ *
+ * A page with no recorder (or no preload) never answers; the timeout is what
+ * keeps that from holding quitting up for longer than it was allowed to.
+ */
+declare function flushAll(targets: readonly WebContents[], timeoutMs: number): Promise<void>;
+
+export { type AnyReplayMainHandle, type AnyReplayMainOptions, describeError, flushAll, resolveAppId, setupAnyReplay };

package/dist/main.d.ts

@@ -0,0 +1,66 @@
+import { WebContents } from 'electron';
+import { M as MainErrorMessage } from './bridge-BQKD7rrG.js';
+
+interface AnyReplayMainOptions {
+    /**
+     * The app id sessions are reported under (§2.2 of the SDK contract) — the
+     * id you list under the project's allowed apps. Use your bundle id, the
+     * `appId` from electron-builder or Forge's `appBundleId`
+     * (`com.example.notes`).
+     *
+     * Electron has no API for the bundle id, so without this the id is made from
+     * `app.getName()`: kept as it is when it is already a valid id, otherwise
+     * lower-cased with every run of other characters turned into `-`
+     * (`"Acme Notes"` → `acme-notes`). Pass it explicitly in anything you ship.
+     */
+    appId?: string;
+    /**
+     * How long quitting may wait for the windows to send what they have
+     * recorded, in milliseconds. Default 1500; `0` turns the flush off.
+     */
+    quitFlushTimeoutMs?: number;
+    /**
+     * Forward uncaught exceptions in the main process into the focused window's
+     * recording as an error, as if the window had caught it (`trackError`): it
+     * shows in the replay's errors and marks the session as having one. On by
+     * default.
+     *
+     * Observed with `uncaughtExceptionMonitor`, so it changes nothing about how
+     * your app handles (or does not handle) the error. The message and stack are
+     * redacted in the window before they are recorded, by the same rules as the
+     * page's own errors.
+     */
+    forwardMainErrors?: boolean;
+}
+interface AnyReplayMainHandle {
+    /** Removes every listener and handler this installed. */
+    dispose: () => void;
+}
+/** The app id from an explicit option or, failing that, from the app's name. */
+declare function resolveAppId(explicit: string | undefined, name: string | undefined): string | undefined;
+/**
+ * Wires the main process to the recorder in your windows. Call it once, early
+ * in your main process, before the first window loads:
+ *
+ * ```ts
+ * // main.ts
+ * import { setupAnyReplay } from '@anyreplay/electron/main';
+ * setupAnyReplay({ appId: 'com.example.notes' });
+ * ```
+ *
+ * It answers the windows' request for the app id and version, holds quitting
+ * back (briefly) until every window has sent what it recorded, and forwards
+ * uncaught main-process exceptions into the focused window's session.
+ */
+declare function setupAnyReplay(options?: AnyReplayMainOptions): AnyReplayMainHandle;
+/** What crosses to the window: plain strings, since an Error does not survive structured cloning whole. */
+declare function describeError(error: unknown): MainErrorMessage;
+/**
+ * Asks every page to flush and waits for all of them, or for the timeout.
+ *
+ * A page with no recorder (or no preload) never answers; the timeout is what
+ * keeps that from holding quitting up for longer than it was allowed to.
+ */
+declare function flushAll(targets: readonly WebContents[], timeoutMs: number): Promise<void>;
+
+export { type AnyReplayMainHandle, type AnyReplayMainOptions, describeError, flushAll, resolveAppId, setupAnyReplay };

package/dist/main.js

@@ -0,0 +1,105 @@
+import {
+  CHANNELS
+} from "./chunk-5TQ2HVGX.js";
+
+// src/main.ts
+import { app, BrowserWindow, ipcMain } from "electron";
+var DEFAULT_QUIT_FLUSH_TIMEOUT_MS = 1500;
+var APP_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{1,254}$/;
+function resolveAppId(explicit, name) {
+  const given = explicit?.trim();
+  if (given) return APP_ID_PATTERN.test(given) ? given : void 0;
+  const raw = name?.trim() ?? "";
+  if (APP_ID_PATTERN.test(raw)) return raw;
+  const slug = raw.toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^[^a-z0-9]+|-+$/g, "");
+  return APP_ID_PATTERN.test(slug) ? slug : void 0;
+}
+function setupAnyReplay(options = {}) {
+  const appId = resolveAppId(options.appId, app.getName());
+  if (options.appId !== void 0 && !appId) {
+    console.warn(`[anyreplay] appId ${JSON.stringify(options.appId)} is not an app identifier such as com.example.app; sessions are sent without one`);
+  }
+  const info = {
+    ...appId ? { appId } : {},
+    appVersion: app.getVersion()
+  };
+  const cleanup = [];
+  ipcMain.handle(CHANNELS.appInfo, () => info);
+  cleanup.push(() => ipcMain.removeHandler(CHANNELS.appInfo));
+  const timeout = options.quitFlushTimeoutMs ?? DEFAULT_QUIT_FLUSH_TIMEOUT_MS;
+  if (timeout > 0) {
+    let flushed = false;
+    let flushing = false;
+    const onBeforeQuit = (event) => {
+      if (flushed) return;
+      event.preventDefault();
+      if (flushing) return;
+      flushing = true;
+      void flushAll(BrowserWindow.getAllWindows().map((window) => window.webContents), timeout).finally(() => {
+        flushed = true;
+        app.quit();
+      });
+    };
+    app.on("before-quit", onBeforeQuit);
+    cleanup.push(() => app.removeListener("before-quit", onBeforeQuit));
+  }
+  if (options.forwardMainErrors !== false) {
+    const onError = (error) => {
+      try {
+        const target = BrowserWindow.getFocusedWindow() ?? BrowserWindow.getAllWindows()[0];
+        if (!target || target.isDestroyed()) return;
+        target.webContents.send(CHANNELS.mainError, describeError(error));
+      } catch {
+      }
+    };
+    process.on("uncaughtExceptionMonitor", onError);
+    cleanup.push(() => process.removeListener("uncaughtExceptionMonitor", onError));
+  }
+  return { dispose: () => {
+    for (const undo of cleanup.splice(0).reverse()) undo();
+  } };
+}
+function describeError(error) {
+  if (error instanceof Error) {
+    return { name: error.name, message: error.message, ...error.stack ? { stack: error.stack } : {} };
+  }
+  return { message: String(error) };
+}
+function flushAll(targets, timeoutMs) {
+  const live = targets.filter((contents) => !contents.isDestroyed());
+  if (live.length === 0) return Promise.resolve();
+  return new Promise((resolve) => {
+    const id = `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    const waiting = new Set(live.map((contents) => contents.id));
+    let done = false;
+    const finish = () => {
+      if (done) return;
+      done = true;
+      clearTimeout(timer);
+      ipcMain.removeListener(CHANNELS.flushed, onFlushed);
+      resolve();
+    };
+    const onFlushed = (event, answered) => {
+      if (answered !== id) return;
+      waiting.delete(event.sender.id);
+      if (waiting.size === 0) finish();
+    };
+    const timer = setTimeout(finish, timeoutMs);
+    ipcMain.on(CHANNELS.flushed, onFlushed);
+    for (const contents of live) {
+      try {
+        contents.send(CHANNELS.flush, id);
+      } catch {
+        waiting.delete(contents.id);
+      }
+    }
+    if (waiting.size === 0) finish();
+  });
+}
+export {
+  describeError,
+  flushAll,
+  resolveAppId,
+  setupAnyReplay
+};
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/main.ts"],"sourcesContent":["import { app, BrowserWindow, ipcMain, type WebContents } from 'electron';\nimport { CHANNELS, type AppInfo, type MainErrorMessage } from './bridge.js';\n\nexport interface AnyReplayMainOptions {\n  /**\n   * The app id sessions are reported under (§2.2 of the SDK contract) — the\n   * id you list under the project's allowed apps. Use your bundle id, the\n   * `appId` from electron-builder or Forge's `appBundleId`\n   * (`com.example.notes`).\n   *\n   * Electron has no API for the bundle id, so without this the id is made from\n   * `app.getName()`: kept as it is when it is already a valid id, otherwise\n   * lower-cased with every run of other characters turned into `-`\n   * (`\"Acme Notes\"` → `acme-notes`). Pass it explicitly in anything you ship.\n   */\n  appId?: string;\n  /**\n   * How long quitting may wait for the windows to send what they have\n   * recorded, in milliseconds. Default 1500; `0` turns the flush off.\n   */\n  quitFlushTimeoutMs?: number;\n  /**\n   * Forward uncaught exceptions in the main process into the focused window's\n   * recording as an error, as if the window had caught it (`trackError`): it\n   * shows in the replay's errors and marks the session as having one. On by\n   * default.\n   *\n   * Observed with `uncaughtExceptionMonitor`, so it changes nothing about how\n   * your app handles (or does not handle) the error. The message and stack are\n   * redacted in the window before they are recorded, by the same rules as the\n   * page's own errors.\n   */\n  forwardMainErrors?: boolean;\n}\n\nexport interface AnyReplayMainHandle {\n  /** Removes every listener and handler this installed. */\n  dispose: () => void;\n}\n\nconst DEFAULT_QUIT_FLUSH_TIMEOUT_MS = 1500;\nconst APP_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{1,254}$/;\n\n/** The app id from an explicit option or, failing that, from the app's name. */\nexport function resolveAppId(explicit: string | undefined, name: string | undefined): string | undefined {\n  const given = explicit?.trim();\n  if (given) return APP_ID_PATTERN.test(given) ? given : undefined;\n  const raw = name?.trim() ?? '';\n  if (APP_ID_PATTERN.test(raw)) return raw;\n  const slug = raw.toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^[^a-z0-9]+|-+$/g, '');\n  return APP_ID_PATTERN.test(slug) ? slug : undefined;\n}\n\n/**\n * Wires the main process to the recorder in your windows. Call it once, early\n * in your main process, before the first window loads:\n *\n * ```ts\n * // main.ts\n * import { setupAnyReplay } from '@anyreplay/electron/main';\n * setupAnyReplay({ appId: 'com.example.notes' });\n * ```\n *\n * It answers the windows' request for the app id and version, holds quitting\n * back (briefly) until every window has sent what it recorded, and forwards\n * uncaught main-process exceptions into the focused window's session.\n */\nexport function setupAnyReplay(options: AnyReplayMainOptions = {}): AnyReplayMainHandle {\n  const appId = resolveAppId(options.appId, app.getName());\n  if (options.appId !== undefined && !appId) {\n    console.warn(`[anyreplay] appId ${JSON.stringify(options.appId)} is not an app identifier such as com.example.app; sessions are sent without one`);\n  }\n  const info: AppInfo = {\n    ...(appId ? { appId } : {}),\n    appVersion: app.getVersion(),\n  };\n  const cleanup: (() => void)[] = [];\n\n  ipcMain.handle(CHANNELS.appInfo, () => info);\n  cleanup.push(() => ipcMain.removeHandler(CHANNELS.appInfo));\n\n  const timeout = options.quitFlushTimeoutMs ?? DEFAULT_QUIT_FLUSH_TIMEOUT_MS;\n  if (timeout > 0) {\n    let flushed = false;\n    let flushing = false;\n    const onBeforeQuit = (event: Electron.Event): void => {\n      if (flushed) return;\n      event.preventDefault();\n      if (flushing) return;\n      flushing = true;\n      void flushAll(BrowserWindow.getAllWindows().map((window) => window.webContents), timeout).finally(() => {\n        flushed = true;\n        app.quit();\n      });\n    };\n    app.on('before-quit', onBeforeQuit);\n    cleanup.push(() => app.removeListener('before-quit', onBeforeQuit));\n  }\n\n  if (options.forwardMainErrors !== false) {\n    const onError = (error: Error): void => {\n      try {\n        const target = BrowserWindow.getFocusedWindow() ?? BrowserWindow.getAllWindows()[0];\n        if (!target || target.isDestroyed()) return;\n        target.webContents.send(CHANNELS.mainError, describeError(error));\n      } catch {\n        /* the app is already failing; this must not add to it */\n      }\n    };\n    process.on('uncaughtExceptionMonitor', onError);\n    cleanup.push(() => process.removeListener('uncaughtExceptionMonitor', onError));\n  }\n\n  return { dispose: () => { for (const undo of cleanup.splice(0).reverse()) undo(); } };\n}\n\n/** What crosses to the window: plain strings, since an Error does not survive structured cloning whole. */\nexport function describeError(error: unknown): MainErrorMessage {\n  if (error instanceof Error) {\n    return { name: error.name, message: error.message, ...(error.stack ? { stack: error.stack } : {}) };\n  }\n  return { message: String(error) };\n}\n\n/**\n * Asks every page to flush and waits for all of them, or for the timeout.\n *\n * A page with no recorder (or no preload) never answers; the timeout is what\n * keeps that from holding quitting up for longer than it was allowed to.\n */\nexport function flushAll(targets: readonly WebContents[], timeoutMs: number): Promise<void> {\n  const live = targets.filter((contents) => !contents.isDestroyed());\n  if (live.length === 0) return Promise.resolve();\n\n  return new Promise<void>((resolve) => {\n    const id = `${Date.now()}-${Math.random().toString(36).slice(2)}`;\n    const waiting = new Set(live.map((contents) => contents.id));\n    let done = false;\n    const finish = (): void => {\n      if (done) return;\n      done = true;\n      clearTimeout(timer);\n      ipcMain.removeListener(CHANNELS.flushed, onFlushed);\n      resolve();\n    };\n    const onFlushed = (event: Electron.IpcMainEvent, answered: unknown): void => {\n      if (answered !== id) return;\n      waiting.delete(event.sender.id);\n      if (waiting.size === 0) finish();\n    };\n    const timer = setTimeout(finish, timeoutMs);\n    ipcMain.on(CHANNELS.flushed, onFlushed);\n    for (const contents of live) {\n      try {\n        contents.send(CHANNELS.flush, id);\n      } catch {\n        waiting.delete(contents.id);\n      }\n    }\n    if (waiting.size === 0) finish();\n  });\n}\n"],"mappings":"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","names":[]}