better-ship 0.33.0 → 0.34.0

package/dist/sentry/client.d.ts

@@ -11,6 +11,27 @@ export type SentryClientOptions = Sentry.BrowserOptions & {
 export declare function createSentryClientOptions(options: SentryClientOptions): Sentry.BrowserOptions;
 /** Forward logged browser errors once, excluding TanStack navigation control flow. */
 export declare function createSentryLoggerErrorHook(): LoggerErrorHook;
+/** The error value as Sentry's React handler receives it. */
+type ReactRootError = Parameters<ReturnType<typeof Sentry.reactErrorHandler>>[0];
+/** The details React passes to a root error option; React may omit the component stack. */
+export type ReactRootErrorInfo = {
+  readonly componentStack?: string | undefined;
+};
+/** A `hydrateRoot` error option in React's own shape. */
+type ReactRootErrorHandler = (error: ReactRootError, errorInfo: ReactRootErrorInfo) => void;
+/** The `hydrateRoot` error options; each one replaces React's console default. */
+export type SentryReactRootOptions = {
+  readonly onCaughtError: ReactRootErrorHandler;
+  readonly onUncaughtError: ReactRootErrorHandler;
+  readonly onRecoverableError: ReactRootErrorHandler;
+};
+/**
+ * Report React errors to Sentry from `hydrateRoot`, as Sentry's React 19 setup does.
+ * Covers errors that a boundary catches, errors that no boundary catches, and hydration
+ * errors that React recovers from. TanStack redirects and not-found control flow are not
+ * reported. Each error still goes to the console, as with React's defaults.
+ */
+export declare function createSentryReactRootOptions(): SentryReactRootOptions;
 /** Initialize once in the browser entrypoint before hydration; server imports have no side effects. */
 export declare function initializeSentry(options: SentryClientOptions): ReturnType<typeof Sentry.init>;
 /** Attach tracing once after creating the browser router, as Porte does in getRouter. */

package/dist/sentry/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","names":[],"sources":["../../src/infrastructure/sentry/client.ts"],"mappings":";;;;YAMY,sBAAsB,OAAO;WAC9B;WACA;WACA;;;wBAIK,0BAA0B,SAAS,sBAAsB,OAAO;;wBAWhE,+BAA+B;;wBAY/B,iBAAiB,SAAS,sBAAsB,kBAAkB,OAAO;;wBAOzE,uBACd,QAAQ,kBAAkB,OAAO;;qBAOtB,sBAAsB,OAAO"}
+{"version":3,"file":"client.d.ts","names":[],"sources":["../../src/infrastructure/sentry/client.ts"],"mappings":";;;;YAMY,sBAAsB,OAAO;WAC9B;WACA;WACA;;;wBAIK,0BAA0B,SAAS,sBAAsB,OAAO;;wBAWhE,+BAA+B;;KAY1C,iBAAiB,WAAW,kBAAkB,OAAO;;YAG9C;WAAgC;;;KAGvC,yBAAyB,OAAO,gBAAgB,WAAW;;YAGpD;WACD,eAAe;WACf,iBAAiB;WACjB,oBAAoB;;;;;;;;wBASf,gCAAgC;;wBAoBhC,iBAAiB,SAAS,sBAAsB,kBAAkB,OAAO;;wBAOzE,uBACd,QAAQ,kBAAkB,OAAO;;qBAOtB,sBAAsB,OAAO"}

package/dist/sentry/client.js

@@ -24,6 +24,28 @@ function createSentryLoggerErrorHook() {
 		Sentry.captureException(error, { extra: attributes });
 	};
 }
+/**
+* Report React errors to Sentry from `hydrateRoot`, as Sentry's React 19 setup does.
+* Covers errors that a boundary catches, errors that no boundary catches, and hydration
+* errors that React recovers from. TanStack redirects and not-found control flow are not
+* reported. Each error still goes to the console, as with React's defaults.
+*/
+function createSentryReactRootOptions() {
+	const handler = Sentry.reactErrorHandler((error, errorInfo) => {
+		console.error(error, errorInfo.componentStack);
+	});
+	const report = (error, { componentStack }) => {
+		handler(error, { componentStack: componentStack ?? null });
+	};
+	return {
+		onCaughtError: (error, errorInfo) => {
+			if (isNotFound(error) || isRedirect(error)) return;
+			report(error, errorInfo);
+		},
+		onUncaughtError: report,
+		onRecoverableError: report
+	};
+}
 /** Initialize once in the browser entrypoint before hydration; server imports have no side effects. */
 function initializeSentry(options) {
 	const client = Sentry.init(createSentryClientOptions(options));
@@ -39,5 +61,5 @@ function instrumentSentryRouter(router) {
 const ErrorBoundary = Sentry.ErrorBoundary;
 
 //#endregion
-export { ErrorBoundary, Sentry, createSentryClientOptions, createSentryLoggerErrorHook, initializeSentry, instrumentSentryRouter };
+export { ErrorBoundary, Sentry, createSentryClientOptions, createSentryLoggerErrorHook, createSentryReactRootOptions, initializeSentry, instrumentSentryRouter };
 //# sourceMappingURL=client.js.map

package/dist/sentry/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../../src/infrastructure/sentry/client.ts"],"sourcesContent":["import * as Sentry from '@sentry/tanstackstart-react'\nimport { isNotFound, isRedirect } from '@tanstack/react-router'\n\nimport { setLoggerErrorHook, type LoggerErrorHook } from '@/core'\n\n/** Application settings use Sentry's names; enablement and environment belong to the application. */\nexport type SentryClientOptions = Sentry.BrowserOptions & {\n  readonly dsn: string\n  readonly environment: string\n  readonly enabled: boolean\n}\n\n/** Filter known DOM errors and use SDK collection defaults; application options take precedence. */\nexport function createSentryClientOptions(options: SentryClientOptions): Sentry.BrowserOptions {\n  return {\n    ignoreErrors: [\n      /^NotFoundError: Failed to execute 'removeChild' on 'Node': The node to be removed is not a child of this node\\.$/,\n      /^NotFoundError: Failed to execute 'insertBefore' on 'Node': The node before which the new node is to be inserted is not a child of this node\\.$/,\n    ],\n    ...options,\n  }\n}\n\n/** Forward logged browser errors once, excluding TanStack navigation control flow. */\nexport function createSentryLoggerErrorHook(): LoggerErrorHook {\n  return ({ error, userId, attributes }) => {\n    if (isNotFound(error) || isRedirect(error)) return\n    if (userId !== undefined) {\n      Sentry.captureException(error, { extra: attributes, user: { id: userId } })\n      return\n    }\n    Sentry.captureException(error, { extra: attributes })\n  }\n}\n\n/** Initialize once in the browser entrypoint before hydration; server imports have no side effects. */\nexport function initializeSentry(options: SentryClientOptions): ReturnType<typeof Sentry.init> {\n  const client = Sentry.init(createSentryClientOptions(options))\n  setLoggerErrorHook(createSentryLoggerErrorHook())\n  return client\n}\n\n/** Attach tracing once after creating the browser router, as Porte does in getRouter. */\nexport function instrumentSentryRouter(\n  router: Parameters<typeof Sentry.tanstackRouterBrowserTracingIntegration>[0],\n): void {\n  if (router.isServer) return\n  Sentry.addIntegration(Sentry.tanstackRouterBrowserTracingIntegration(router))\n}\n\n/** The SDK error boundary; the application supplies its fallback component. */\nexport const ErrorBoundary: typeof Sentry.ErrorBoundary = Sentry.ErrorBoundary\n\nexport { Sentry }\n"],"mappings":";;;;;;AAaA,SAAgB,0BAA0B,SAAqD;CAC7F,OAAO;EACL,cAAc,CACZ,oHACA,iJACF;EACA,GAAG;CACL;AACF;;AAGA,SAAgB,8BAA+C;CAC7D,QAAQ,EAAE,OAAO,QAAQ,iBAAiB;EACxC,IAAI,WAAW,KAAK,KAAK,WAAW,KAAK,GAAG;EAC5C,IAAI,WAAW,QAAW;GACxB,OAAO,iBAAiB,OAAO;IAAE,OAAO;IAAY,MAAM,EAAE,IAAI,OAAO;GAAE,CAAC;GAC1E;EACF;EACA,OAAO,iBAAiB,OAAO,EAAE,OAAO,WAAW,CAAC;CACtD;AACF;;AAGA,SAAgB,iBAAiB,SAA8D;CAC7F,MAAM,SAAS,OAAO,KAAK,0BAA0B,OAAO,CAAC;CAC7D,mBAAmB,4BAA4B,CAAC;CAChD,OAAO;AACT;;AAGA,SAAgB,uBACd,QACM;CACN,IAAI,OAAO,UAAU;CACrB,OAAO,eAAe,OAAO,wCAAwC,MAAM,CAAC;AAC9E;;AAGA,MAAa,gBAA6C,OAAO"}
+{"version":3,"file":"client.js","names":[],"sources":["../../src/infrastructure/sentry/client.ts"],"sourcesContent":["import * as Sentry from '@sentry/tanstackstart-react'\nimport { isNotFound, isRedirect } from '@tanstack/react-router'\n\nimport { setLoggerErrorHook, type LoggerErrorHook } from '@/core'\n\n/** Application settings use Sentry's names; enablement and environment belong to the application. */\nexport type SentryClientOptions = Sentry.BrowserOptions & {\n  readonly dsn: string\n  readonly environment: string\n  readonly enabled: boolean\n}\n\n/** Filter known DOM errors and use SDK collection defaults; application options take precedence. */\nexport function createSentryClientOptions(options: SentryClientOptions): Sentry.BrowserOptions {\n  return {\n    ignoreErrors: [\n      /^NotFoundError: Failed to execute 'removeChild' on 'Node': The node to be removed is not a child of this node\\.$/,\n      /^NotFoundError: Failed to execute 'insertBefore' on 'Node': The node before which the new node is to be inserted is not a child of this node\\.$/,\n    ],\n    ...options,\n  }\n}\n\n/** Forward logged browser errors once, excluding TanStack navigation control flow. */\nexport function createSentryLoggerErrorHook(): LoggerErrorHook {\n  return ({ error, userId, attributes }) => {\n    if (isNotFound(error) || isRedirect(error)) return\n    if (userId !== undefined) {\n      Sentry.captureException(error, { extra: attributes, user: { id: userId } })\n      return\n    }\n    Sentry.captureException(error, { extra: attributes })\n  }\n}\n\n/** The error value as Sentry's React handler receives it. */\ntype ReactRootError = Parameters<ReturnType<typeof Sentry.reactErrorHandler>>[0]\n\n/** The details React passes to a root error option; React may omit the component stack. */\nexport type ReactRootErrorInfo = { readonly componentStack?: string | undefined }\n\n/** A `hydrateRoot` error option in React's own shape. */\ntype ReactRootErrorHandler = (error: ReactRootError, errorInfo: ReactRootErrorInfo) => void\n\n/** The `hydrateRoot` error options; each one replaces React's console default. */\nexport type SentryReactRootOptions = {\n  readonly onCaughtError: ReactRootErrorHandler\n  readonly onUncaughtError: ReactRootErrorHandler\n  readonly onRecoverableError: ReactRootErrorHandler\n}\n\n/**\n * Report React errors to Sentry from `hydrateRoot`, as Sentry's React 19 setup does.\n * Covers errors that a boundary catches, errors that no boundary catches, and hydration\n * errors that React recovers from. TanStack redirects and not-found control flow are not\n * reported. Each error still goes to the console, as with React's defaults.\n */\nexport function createSentryReactRootOptions(): SentryReactRootOptions {\n  const handler = Sentry.reactErrorHandler((error, errorInfo) => {\n    console.error(error, errorInfo.componentStack)\n  })\n  // Sentry's handler takes `null` for a missing component stack.\n  const report: ReactRootErrorHandler = (error, { componentStack }) => {\n    handler(error, { componentStack: componentStack ?? null })\n  }\n  return {\n    // TanStack Router renders not-found through a React error boundary, so each 404 arrives here.\n    onCaughtError: (error, errorInfo) => {\n      if (isNotFound(error) || isRedirect(error)) return\n      report(error, errorInfo)\n    },\n    onUncaughtError: report,\n    onRecoverableError: report,\n  }\n}\n\n/** Initialize once in the browser entrypoint before hydration; server imports have no side effects. */\nexport function initializeSentry(options: SentryClientOptions): ReturnType<typeof Sentry.init> {\n  const client = Sentry.init(createSentryClientOptions(options))\n  setLoggerErrorHook(createSentryLoggerErrorHook())\n  return client\n}\n\n/** Attach tracing once after creating the browser router, as Porte does in getRouter. */\nexport function instrumentSentryRouter(\n  router: Parameters<typeof Sentry.tanstackRouterBrowserTracingIntegration>[0],\n): void {\n  if (router.isServer) return\n  Sentry.addIntegration(Sentry.tanstackRouterBrowserTracingIntegration(router))\n}\n\n/** The SDK error boundary; the application supplies its fallback component. */\nexport const ErrorBoundary: typeof Sentry.ErrorBoundary = Sentry.ErrorBoundary\n\nexport { Sentry }\n"],"mappings":";;;;;;AAaA,SAAgB,0BAA0B,SAAqD;CAC7F,OAAO;EACL,cAAc,CACZ,oHACA,iJACF;EACA,GAAG;CACL;AACF;;AAGA,SAAgB,8BAA+C;CAC7D,QAAQ,EAAE,OAAO,QAAQ,iBAAiB;EACxC,IAAI,WAAW,KAAK,KAAK,WAAW,KAAK,GAAG;EAC5C,IAAI,WAAW,QAAW;GACxB,OAAO,iBAAiB,OAAO;IAAE,OAAO;IAAY,MAAM,EAAE,IAAI,OAAO;GAAE,CAAC;GAC1E;EACF;EACA,OAAO,iBAAiB,OAAO,EAAE,OAAO,WAAW,CAAC;CACtD;AACF;;;;;;;AAwBA,SAAgB,+BAAuD;CACrE,MAAM,UAAU,OAAO,mBAAmB,OAAO,cAAc;EAC7D,QAAQ,MAAM,OAAO,UAAU,cAAc;CAC/C,CAAC;CAED,MAAM,UAAiC,OAAO,EAAE,qBAAqB;EACnE,QAAQ,OAAO,EAAE,gBAAgB,kBAAkB,KAAK,CAAC;CAC3D;CACA,OAAO;EAEL,gBAAgB,OAAO,cAAc;GACnC,IAAI,WAAW,KAAK,KAAK,WAAW,KAAK,GAAG;GAC5C,OAAO,OAAO,SAAS;EACzB;EACA,iBAAiB;EACjB,oBAAoB;CACtB;AACF;;AAGA,SAAgB,iBAAiB,SAA8D;CAC7F,MAAM,SAAS,OAAO,KAAK,0BAA0B,OAAO,CAAC;CAC7D,mBAAmB,4BAA4B,CAAC;CAChD,OAAO;AACT;;AAGA,SAAgB,uBACd,QACM;CACN,IAAI,OAAO,UAAU;CACrB,OAAO,eAAe,OAAO,wCAAwC,MAAM,CAAC;AAC9E;;AAGA,MAAa,gBAA6C,OAAO"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://www.schemastore.org/package.json",
   "name": "better-ship",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Foundation for applications on Cloudflare Workers: logger, errors, message bus, infrastructure adapters, and UI primitives",
   "license": "Apache-2.0",
   "repository": {

package/src/infrastructure/sentry/client.ts

@@ -33,6 +33,47 @@ export function createSentryLoggerErrorHook(): LoggerErrorHook {
   }
 }
 
+/** The error value as Sentry's React handler receives it. */
+type ReactRootError = Parameters<ReturnType<typeof Sentry.reactErrorHandler>>[0]
+
+/** The details React passes to a root error option; React may omit the component stack. */
+export type ReactRootErrorInfo = { readonly componentStack?: string | undefined }
+
+/** A `hydrateRoot` error option in React's own shape. */
+type ReactRootErrorHandler = (error: ReactRootError, errorInfo: ReactRootErrorInfo) => void
+
+/** The `hydrateRoot` error options; each one replaces React's console default. */
+export type SentryReactRootOptions = {
+  readonly onCaughtError: ReactRootErrorHandler
+  readonly onUncaughtError: ReactRootErrorHandler
+  readonly onRecoverableError: ReactRootErrorHandler
+}
+
+/**
+ * Report React errors to Sentry from `hydrateRoot`, as Sentry's React 19 setup does.
+ * Covers errors that a boundary catches, errors that no boundary catches, and hydration
+ * errors that React recovers from. TanStack redirects and not-found control flow are not
+ * reported. Each error still goes to the console, as with React's defaults.
+ */
+export function createSentryReactRootOptions(): SentryReactRootOptions {
+  const handler = Sentry.reactErrorHandler((error, errorInfo) => {
+    console.error(error, errorInfo.componentStack)
+  })
+  // Sentry's handler takes `null` for a missing component stack.
+  const report: ReactRootErrorHandler = (error, { componentStack }) => {
+    handler(error, { componentStack: componentStack ?? null })
+  }
+  return {
+    // TanStack Router renders not-found through a React error boundary, so each 404 arrives here.
+    onCaughtError: (error, errorInfo) => {
+      if (isNotFound(error) || isRedirect(error)) return
+      report(error, errorInfo)
+    },
+    onUncaughtError: report,
+    onRecoverableError: report,
+  }
+}
+
 /** Initialize once in the browser entrypoint before hydration; server imports have no side effects. */
 export function initializeSentry(options: SentryClientOptions): ReturnType<typeof Sentry.init> {
   const client = Sentry.init(createSentryClientOptions(options))