feat(core-shared): initSentryClient helper (R34, R35, R37 mandatory replay defaults)

packages/core-shared/src/instrumentation/sentry/init-client.test.ts

@@ -0,0 +1,75 @@
+// packages/core-shared/src/instrumentation/sentry/init-client.test.ts
+import { describe, it, expect, vi, beforeEach } from "vitest";
+
+const { replayIntegration } = vi.hoisted(() => {
+  const replayIntegration = vi.fn((opts: unknown) => ({ name: "Replay", _opts: opts }));
+  return { replayIntegration };
+});
+
+vi.mock("@sentry/nextjs", () => ({
+  init: vi.fn(),
+  replayIntegration,
+}));
+
+import * as Sentry from "@sentry/nextjs";
+import { initSentryClient } from "@/instrumentation/sentry/init-client";
+
+describe("initSentryClient", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("calls Sentry.init with sendDefaultPii: false (R31)", () => {
+    initSentryClient({ dsn: "https://x@y/1", app: "web-next" });
+    const call = (Sentry.init as ReturnType<typeof vi.fn>).mock.calls[0][0] as Record<
+      string,
+      unknown
+    >;
+    expect(call["sendDefaultPii"]).toBe(false);
+  });
+
+  it("attaches replay integration with maskAllText/maskAllInputs/blockAllMedia: true (R34, R35)", () => {
+    initSentryClient({ dsn: "https://x@y/1", app: "web-next" });
+    expect(replayIntegration).toHaveBeenCalledTimes(1);
+    const replayOpts = (replayIntegration as ReturnType<typeof vi.fn>).mock.calls[0][0] as Record<
+      string,
+      unknown
+    >;
+    expect(replayOpts["maskAllText"]).toBe(true);
+    expect(replayOpts["maskAllInputs"]).toBe(true);
+    expect(replayOpts["blockAllMedia"]).toBe(true);
+  });
+
+  it("defaults replaysSessionSampleRate to 0.0 (R37)", () => {
+    initSentryClient({ dsn: "https://x@y/1", app: "web-next" });
+    const call = (Sentry.init as ReturnType<typeof vi.fn>).mock.calls[0][0] as Record<
+      string,
+      unknown
+    >;
+    expect(call["replaysSessionSampleRate"]).toBe(0.0);
+  });
+
+  it("defaults replaysOnErrorSampleRate to 1.0 (R37)", () => {
+    initSentryClient({ dsn: "https://x@y/1", app: "web-next" });
+    const call = (Sentry.init as ReturnType<typeof vi.fn>).mock.calls[0][0] as Record<
+      string,
+      unknown
+    >;
+    expect(call["replaysOnErrorSampleRate"]).toBe(1.0);
+  });
+
+  it("attaches beforeSend + beforeSendTransaction", () => {
+    initSentryClient({ dsn: "https://x@y/1", app: "web-next" });
+    const call = (Sentry.init as ReturnType<typeof vi.fn>).mock.calls[0][0] as Record<
+      string,
+      unknown
+    >;
+    expect(typeof call["beforeSend"]).toBe("function");
+    expect(typeof call["beforeSendTransaction"]).toBe("function");
+  });
+
+  it("is a no-op when dsn is empty", () => {
+    initSentryClient({ dsn: "", app: "web-next" });
+    expect(Sentry.init).not.toHaveBeenCalled();
+  });
+});

packages/core-shared/src/instrumentation/sentry/init-client.ts

@@ -0,0 +1,46 @@
+// packages/core-shared/src/instrumentation/sentry/init-client.ts
+import * as Sentry from "@sentry/nextjs";
+import { beforeSend, beforeSendTransaction } from "./scrub";
+
+export type InitClientOpts = {
+  dsn: string | undefined;
+  app: "web-next" | "cms" | "web-tanstack";
+  release?: string;
+};
+
+export function initSentryClient(opts: InitClientOpts): void {
+  if (!opts.dsn) return;
+
+  const isProd = process.env["NODE_ENV"] === "production";
+  const tracesSampleRate =
+    process.env["SENTRY_TRACES_SAMPLE_RATE"] !== undefined
+      ? Number(process.env["SENTRY_TRACES_SAMPLE_RATE"])
+      : isProd
+        ? 0.1
+        : 1.0;
+
+  const environment =
+    process.env["SENTRY_ENVIRONMENT"] ?? process.env["NODE_ENV"] ?? "development";
+  const release = opts.release ?? "unknown";
+
+  Sentry.init({
+    dsn: opts.dsn,
+    environment,
+    release,
+    tracesSampleRate,
+    sendDefaultPii: false, // R31
+    beforeSend, // R32
+    beforeSendTransaction, // R33
+    replaysSessionSampleRate: 0.0, // R37 — privacy default
+    replaysOnErrorSampleRate: 1.0, // R37
+    integrations: [
+      // R34, R35 — mandatory mask flags; allowlist starts empty
+      Sentry.replayIntegration({
+        maskAllText: true,
+        maskAllInputs: true,
+        blockAllMedia: true,
+      }),
+    ],
+    initialScope: { tags: { app: opts.app } },
+  });
+}