@guidelytech/nextjs 0.15.0 → 0.17.0

package/README.md

@@ -81,3 +81,67 @@ export async function middleware(req) {
   if (flags.isEnabled("maintenance-mode")) return Response.redirect(new URL("/maintenance", req.url));
 }
 ```
+
+## Error monitoring
+
+What Sentry's Next.js SDK does, in the same places. In the browser the provider's client reports
+uncaught errors; the React error boundary and hooks are re-exported (see `@guidelytech/react`).
+
+```tsx
+// app/global-error.tsx: errors in the root layout (the provider is gone by then)
+"use client";
+import { GuidelyGlobalError } from "@guidelytech/nextjs";
+export default function GlobalError(props: { error: Error & { digest?: string }; reset: () => void }) {
+  return <GuidelyGlobalError {...props} projectId={process.env.NEXT_PUBLIC_GUIDELY_PROJECT_ID!} />;
+}
+
+// app/dashboard/error.tsx: segment errors (inside the provider)
+"use client";
+import { useCaptureException } from "@guidelytech/nextjs";
+export default function Error({ error, reset }: { error: Error; reset: () => void }) {
+  useCaptureException(error);
+  return <button onClick={reset}>Try again</button>;
+}
+```
+
+On the server, register a server client (`@guidelytech/node`, secret key) once and export
+`onRequestError` (Next.js 15+): every error thrown while rendering, in route handlers, server
+actions and middleware is reported with the request (cookies, `Authorization` and other credential
+headers removed) and the route as tags (`routerKind`, `routePath`, `routeType`).
+
+```ts
+// instrumentation.ts
+import { setGuidelyServerClient } from "@guidelytech/nextjs/server";
+
+export async function register() {
+  if (process.env.NEXT_RUNTIME === "nodejs") {
+    const { Guidely } = await import("@guidelytech/node");
+    setGuidelyServerClient(new Guidely({ secretKey: process.env.GUIDELY_SECRET_KEY!, environment: "production" }));
+  }
+}
+export { onRequestError } from "@guidelytech/nextjs/server";
+```
+
+```ts
+// Next.js 13/14, or code outside onRequestError's reach: wrap and rethrow.
+import { withGuidely, withServerActionGuidely } from "@guidelytech/nextjs/server";
+export const GET = withGuidely(async (req: Request) => Response.json(await load()), { route: "/api/items/[id]" });
+
+"use server";
+import { headers } from "next/headers";
+export const checkout = withServerActionGuidely("checkout", async (form: FormData) => { … }, { headers });
+```
+
+| Export | Where | Description |
+|---|---|---|
+| `GuidelyGlobalError` | client | `app/global-error.tsx` body: reports the error (`mechanism: nextjs.global-error`, `contexts.nextjs.digest` to match the server event) through the live client or one made from its `projectId`/`environment`/`apiUrl`/`release`/`errors` props; renders `children` or a "Try again" page. |
+| `setGuidelyServerClient(client)` | server | The client server captures report to. Any object with `captureException(error, context)` (plus optional `flush()` and `withScope()`) works; `@guidelytech/node`'s `Guidely` is one. This entry imports no Node built-ins, so it loads in the edge runtime too. |
+| `onRequestError` (alias `captureRequestError`), `createOnRequestError(options)` | `instrumentation.ts` | `mechanism: nextjs.onRequestError`, transaction `GET /api/x` or the page route. |
+| `withGuidely(handler, { route? })` | route handlers | Reports and rethrows; sync handlers stay sync. |
+| `withServerActionGuidely(name, action, { headers? })` | server actions | Reports (tag `serverAction`) and rethrows. |
+
+Reporting never throws into the request and never holds the response: the flush runs in the
+background (at most `flushTimeoutMs`, 2000 ms) under the request's `waitUntil` when the host has one
+(Next.js 15, Vercel). On other serverless hosts pass `{ waitForFlush: true }` to
+`createOnRequestError`. `redirect()`, `notFound()` and other Next.js control flow are not errors and
+are never reported; an error seen by both a wrapper and `onRequestError` is reported once.

package/dist/index.cjs

@@ -22,22 +22,46 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.tsx
 var index_exports = {};
 __export(index_exports, {
+  GuidelyGlobalError: () => GuidelyGlobalError,
   GuidelyNavigationListener: () => GuidelyNavigationListener,
   guidelyEnv: () => guidelyEnv
 });
 module.exports = __toCommonJS(index_exports);
-var import_react = require("@guidelytech/react");
+var import_react2 = require("@guidelytech/react");
 var import_navigation = require("next/navigation");
-var import_react2 = require("react");
+var import_react3 = require("react");
 __reExport(index_exports, require("@guidelytech/react"), module.exports);
+
+// src/global-error.tsx
+var import_sdk_core = require("@guidelytech/sdk-core");
+var import_react = require("react");
 var import_jsx_runtime = require("react/jsx-runtime");
+function GuidelyGlobalError({ error, reset, children, projectId, environment, apiUrl, release, errors }) {
+  (0, import_react.useEffect)(() => {
+    let own = null;
+    try {
+      let client = import_sdk_core.GuidelyClient.get();
+      if (!client && projectId) client = own = (0, import_sdk_core.createGuidely)({ projectId, environment, apiUrl, release, errors });
+      client?.captureException(error, { mechanism: { type: "nextjs.global-error", handled: false }, ...error?.digest ? { contexts: { nextjs: { digest: error.digest } } } : {} });
+    } catch {
+    }
+    return () => own?.destroy();
+  }, [error]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("html", { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("body", { children: children ?? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { fontFamily: "system-ui, sans-serif", padding: "4rem 1rem", textAlign: "center" }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h2", { children: "Something went wrong" }),
+    reset ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", onClick: () => reset(), children: "Try again" }) : null
+  ] }) }) });
+}
+
+// src/index.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
 function Listener() {
-  const client = (0, import_react.useGuidely)();
+  const client = (0, import_react2.useGuidely)();
   const pathname = (0, import_navigation.usePathname)();
   const search = (0, import_navigation.useSearchParams)();
   const query = search?.toString() ?? "";
-  const first = (0, import_react2.useRef)(true);
-  (0, import_react2.useEffect)(() => {
+  const first = (0, import_react3.useRef)(true);
+  (0, import_react3.useEffect)(() => {
     if (first.current) {
       first.current = false;
       return;
@@ -47,18 +71,19 @@ function Listener() {
   return null;
 }
 function GuidelyNavigationListener() {
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react2.Suspense, { fallback: null, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Listener, {}) });
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react3.Suspense, { fallback: null, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Listener, {}) });
 }
 function guidelyEnv(env = typeof process !== "undefined" ? process.env : {}) {
   return {
     projectId: env.NEXT_PUBLIC_GUIDELY_PROJECT_ID ?? "",
-    environment: env.NEXT_PUBLIC_GUIDELY_ENV ?? void 0,
+    environment: env.NEXT_PUBLIC_GUIDELY_ENV || void 0,
     apiUrl: env.NEXT_PUBLIC_GUIDELY_API_URL || void 0,
     release: env.NEXT_PUBLIC_GUIDELY_RELEASE || void 0
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  GuidelyGlobalError,
   GuidelyNavigationListener,
   guidelyEnv,
   ...require("@guidelytech/react")

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.tsx"],"sourcesContent":["import { useGuidely } from \"@guidelytech/react\";\nimport { usePathname, useSearchParams } from \"next/navigation\";\nimport { Suspense, useEffect, useRef } from \"react\";\n\nexport * from \"@guidelytech/react\";\n\nfunction Listener() {\n  const client = useGuidely();\n  const pathname = usePathname();\n  const search = useSearchParams();\n  const query = search?.toString() ?? \"\";\n  const first = useRef(true);\n  useEffect(() => {\n    if (first.current) {\n      first.current = false;\n      return;\n    }\n    client.page(typeof window !== \"undefined\" ? window.location.href : pathname + (query ? `?${query}` : \"\"));\n  }, [pathname, query]);\n  return null;\n}\n\n/**\n * Explicit App Router navigation bridge: calls `client.page()` whenever the pathname or search\n * params change. Wrapped in `Suspense` because `useSearchParams` requires it. sdk-core also\n * detects navigation through the History API, so this is belt and braces.\n */\nexport function GuidelyNavigationListener() {\n  return (\n    <Suspense fallback={null}>\n      <Listener />\n    </Suspense>\n  );\n}\n\n/** Reads the public `NEXT_PUBLIC_GUIDELY_*` environment variables (project id, env, API URL, release) into provider props. */\nexport function guidelyEnv(env: Record<string, string | undefined> = typeof process !== \"undefined\" ? process.env : {}) {\n  return {\n    projectId: env.NEXT_PUBLIC_GUIDELY_PROJECT_ID ?? \"\",\n    environment: (env.NEXT_PUBLIC_GUIDELY_ENV as \"development\" | \"staging\" | \"production\" | undefined) ?? undefined,\n    apiUrl: env.NEXT_PUBLIC_GUIDELY_API_URL || undefined,\n    release: env.NEXT_PUBLIC_GUIDELY_RELEASE || undefined,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA2B;AAC3B,wBAA6C;AAC7C,IAAAA,gBAA4C;AAE5C,0BAAc,+BAJd;AA8BM;AAxBN,SAAS,WAAW;AAClB,QAAM,aAAS,yBAAW;AAC1B,QAAM,eAAW,+BAAY;AAC7B,QAAM,aAAS,mCAAgB;AAC/B,QAAM,QAAQ,QAAQ,SAAS,KAAK;AACpC,QAAM,YAAQ,sBAAO,IAAI;AACzB,+BAAU,MAAM;AACd,QAAI,MAAM,SAAS;AACjB,YAAM,UAAU;AAChB;AAAA,IACF;AACA,WAAO,KAAK,OAAO,WAAW,cAAc,OAAO,SAAS,OAAO,YAAY,QAAQ,IAAI,KAAK,KAAK,GAAG;AAAA,EAC1G,GAAG,CAAC,UAAU,KAAK,CAAC;AACpB,SAAO;AACT;AAOO,SAAS,4BAA4B;AAC1C,SACE,4CAAC,0BAAS,UAAU,MAClB,sDAAC,YAAS,GACZ;AAEJ;AAGO,SAAS,WAAW,MAA0C,OAAO,YAAY,cAAc,QAAQ,MAAM,CAAC,GAAG;AACtH,SAAO;AAAA,IACL,WAAW,IAAI,kCAAkC;AAAA,IACjD,aAAc,IAAI,2BAAoF;AAAA,IACtG,QAAQ,IAAI,+BAA+B;AAAA,IAC3C,SAAS,IAAI,+BAA+B;AAAA,EAC9C;AACF;","names":["import_react"]}
+{"version":3,"sources":["../src/index.tsx","../src/global-error.tsx"],"sourcesContent":["import { useGuidely } from \"@guidelytech/react\";\nimport { usePathname, useSearchParams } from \"next/navigation\";\nimport { Suspense, useEffect, useRef } from \"react\";\n\nexport * from \"@guidelytech/react\";\nexport { GuidelyGlobalError } from \"./global-error\";\nexport type { GuidelyGlobalErrorProps } from \"./global-error\";\n\nfunction Listener() {\n  const client = useGuidely();\n  const pathname = usePathname();\n  const search = useSearchParams();\n  const query = search?.toString() ?? \"\";\n  const first = useRef(true);\n  useEffect(() => {\n    if (first.current) {\n      first.current = false;\n      return;\n    }\n    client.page(typeof window !== \"undefined\" ? window.location.href : pathname + (query ? `?${query}` : \"\"));\n  }, [pathname, query]);\n  return null;\n}\n\n/**\n * Explicit App Router navigation bridge: calls `client.page()` whenever the pathname or search\n * params change. Wrapped in `Suspense` because `useSearchParams` requires it. sdk-core also\n * detects navigation through the History API, so this is belt and braces.\n */\nexport function GuidelyNavigationListener() {\n  return (\n    <Suspense fallback={null}>\n      <Listener />\n    </Suspense>\n  );\n}\n\n/** Reads the public `NEXT_PUBLIC_GUIDELY_*` environment variables (project id, env, API URL, release) into provider props. */\nexport function guidelyEnv(env: Record<string, string | undefined> = typeof process !== \"undefined\" ? process.env : {}) {\n  return {\n    projectId: env.NEXT_PUBLIC_GUIDELY_PROJECT_ID ?? \"\",\n    environment: env.NEXT_PUBLIC_GUIDELY_ENV || undefined,\n    apiUrl: env.NEXT_PUBLIC_GUIDELY_API_URL || undefined,\n    release: env.NEXT_PUBLIC_GUIDELY_RELEASE || undefined,\n  };\n}\n","import { createGuidely, GuidelyClient, type GuidelyOptions } from \"@guidelytech/sdk-core\";\nimport { useEffect, type ReactNode } from \"react\";\n\nexport interface GuidelyGlobalErrorProps extends Partial<Pick<GuidelyOptions, \"projectId\" | \"environment\" | \"apiUrl\" | \"release\" | \"errors\">> {\n  /** The `error` prop Next.js passes to `app/global-error.tsx`. */\n  error: Error & { digest?: string };\n  /** The `reset` prop Next.js passes; the default page's \"Try again\" button calls it. */\n  reset?: () => void;\n  /** Your own page body (default: a short message and a \"Try again\" button). */\n  children?: ReactNode;\n}\n\n/**\n * `app/global-error.tsx` for Sentry-style reporting of errors in the root layout:\n *\n * ```tsx\n * \"use client\";\n * import { GuidelyGlobalError } from \"@guidelytech/nextjs\";\n * export default function GlobalError(props: { error: Error & { digest?: string }; reset: () => void }) {\n *   return <GuidelyGlobalError {...props} projectId={process.env.NEXT_PUBLIC_GUIDELY_PROJECT_ID!} />;\n * }\n * ```\n *\n * The root layout (and with it `GuidelyProvider` and its client) is gone when this renders, so it\n * reports through the live `createGuidely()` client when there is one, else through a client of\n * its own made from `projectId` (and `environment`, `apiUrl`, `release`, `errors`) that lives as\n * long as the page. Server errors arrive with only their `digest`; it is sent in `contexts.nextjs`\n * so the event matches the server's (`onRequestError`) one.\n */\nexport function GuidelyGlobalError({ error, reset, children, projectId, environment, apiUrl, release, errors }: GuidelyGlobalErrorProps) {\n  useEffect(() => {\n    let own: GuidelyClient | null = null;\n    try {\n      let client = GuidelyClient.get();\n      if (!client && projectId) client = own = createGuidely({ projectId, environment, apiUrl, release, errors });\n      client?.captureException(error, { mechanism: { type: \"nextjs.global-error\", handled: false }, ...(error?.digest ? { contexts: { nextjs: { digest: error.digest } } } : {}) });\n    } catch {\n      // never break the error page\n    }\n    return () => own?.destroy();\n  }, [error]);\n  return (\n    <html>\n      <body>\n        {children ?? (\n          <div style={{ fontFamily: \"system-ui, sans-serif\", padding: \"4rem 1rem\", textAlign: \"center\" }}>\n            <h2>Something went wrong</h2>\n            {reset ? (\n              <button type=\"button\" onClick={() => reset()}>\n                Try again\n              </button>\n            ) : null}\n          </div>\n        )}\n      </body>\n    </html>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAAA,gBAA2B;AAC3B,wBAA6C;AAC7C,IAAAA,gBAA4C;AAE5C,0BAAc,+BAJd;;;ACAA,sBAAkE;AAClE,mBAA0C;AA4ChC;AAhBH,SAAS,mBAAmB,EAAE,OAAO,OAAO,UAAU,WAAW,aAAa,QAAQ,SAAS,OAAO,GAA4B;AACvI,8BAAU,MAAM;AACd,QAAI,MAA4B;AAChC,QAAI;AACF,UAAI,SAAS,8BAAc,IAAI;AAC/B,UAAI,CAAC,UAAU,UAAW,UAAS,UAAM,+BAAc,EAAE,WAAW,aAAa,QAAQ,SAAS,OAAO,CAAC;AAC1G,cAAQ,iBAAiB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,SAAS,MAAM,GAAG,GAAI,OAAO,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,MAAM,OAAO,EAAE,EAAE,IAAI,CAAC,EAAG,CAAC;AAAA,IAC9K,QAAQ;AAAA,IAER;AACA,WAAO,MAAM,KAAK,QAAQ;AAAA,EAC5B,GAAG,CAAC,KAAK,CAAC;AACV,SACE,4CAAC,UACC,sDAAC,UACE,sBACC,6CAAC,SAAI,OAAO,EAAE,YAAY,yBAAyB,SAAS,aAAa,WAAW,SAAS,GAC3F;AAAA,gDAAC,QAAG,kCAAoB;AAAA,IACvB,QACC,4CAAC,YAAO,MAAK,UAAS,SAAS,MAAM,MAAM,GAAG,uBAE9C,IACE;AAAA,KACN,GAEJ,GACF;AAEJ;;;ADzBM,IAAAC,sBAAA;AAxBN,SAAS,WAAW;AAClB,QAAM,aAAS,0BAAW;AAC1B,QAAM,eAAW,+BAAY;AAC7B,QAAM,aAAS,mCAAgB;AAC/B,QAAM,QAAQ,QAAQ,SAAS,KAAK;AACpC,QAAM,YAAQ,sBAAO,IAAI;AACzB,+BAAU,MAAM;AACd,QAAI,MAAM,SAAS;AACjB,YAAM,UAAU;AAChB;AAAA,IACF;AACA,WAAO,KAAK,OAAO,WAAW,cAAc,OAAO,SAAS,OAAO,YAAY,QAAQ,IAAI,KAAK,KAAK,GAAG;AAAA,EAC1G,GAAG,CAAC,UAAU,KAAK,CAAC;AACpB,SAAO;AACT;AAOO,SAAS,4BAA4B;AAC1C,SACE,6CAAC,0BAAS,UAAU,MAClB,uDAAC,YAAS,GACZ;AAEJ;AAGO,SAAS,WAAW,MAA0C,OAAO,YAAY,cAAc,QAAQ,MAAM,CAAC,GAAG;AACtH,SAAO;AAAA,IACL,WAAW,IAAI,kCAAkC;AAAA,IACjD,aAAa,IAAI,2BAA2B;AAAA,IAC5C,QAAQ,IAAI,+BAA+B;AAAA,IAC3C,SAAS,IAAI,+BAA+B;AAAA,EAC9C;AACF;","names":["import_react","import_jsx_runtime"]}

package/dist/index.d.cts

@@ -1,5 +1,36 @@
 import * as react$1 from 'react';
+import { ReactNode } from 'react';
 export * from '@guidelytech/react';
+import { GuidelyOptions } from '@guidelytech/sdk-core';
+
+interface GuidelyGlobalErrorProps extends Partial<Pick<GuidelyOptions, "projectId" | "environment" | "apiUrl" | "release" | "errors">> {
+    /** The `error` prop Next.js passes to `app/global-error.tsx`. */
+    error: Error & {
+        digest?: string;
+    };
+    /** The `reset` prop Next.js passes; the default page's "Try again" button calls it. */
+    reset?: () => void;
+    /** Your own page body (default: a short message and a "Try again" button). */
+    children?: ReactNode;
+}
+/**
+ * `app/global-error.tsx` for Sentry-style reporting of errors in the root layout:
+ *
+ * ```tsx
+ * "use client";
+ * import { GuidelyGlobalError } from "@guidelytech/nextjs";
+ * export default function GlobalError(props: { error: Error & { digest?: string }; reset: () => void }) {
+ *   return <GuidelyGlobalError {...props} projectId={process.env.NEXT_PUBLIC_GUIDELY_PROJECT_ID!} />;
+ * }
+ * ```
+ *
+ * The root layout (and with it `GuidelyProvider` and its client) is gone when this renders, so it
+ * reports through the live `createGuidely()` client when there is one, else through a client of
+ * its own made from `projectId` (and `environment`, `apiUrl`, `release`, `errors`) that lives as
+ * long as the page. Server errors arrive with only their `digest`; it is sent in `contexts.nextjs`
+ * so the event matches the server's (`onRequestError`) one.
+ */
+declare function GuidelyGlobalError({ error, reset, children, projectId, environment, apiUrl, release, errors }: GuidelyGlobalErrorProps): react$1.JSX.Element;
 
 /**
  * Explicit App Router navigation bridge: calls `client.page()` whenever the pathname or search
@@ -10,9 +41,9 @@ declare function GuidelyNavigationListener(): react$1.JSX.Element;
 /** Reads the public `NEXT_PUBLIC_GUIDELY_*` environment variables (project id, env, API URL, release) into provider props. */
 declare function guidelyEnv(env?: Record<string, string | undefined>): {
     projectId: string;
-    environment: "development" | "staging" | "production" | undefined;
+    environment: string | undefined;
     apiUrl: string | undefined;
     release: string | undefined;
 };
 
-export { GuidelyNavigationListener, guidelyEnv };
+export { GuidelyGlobalError, type GuidelyGlobalErrorProps, GuidelyNavigationListener, guidelyEnv };

package/dist/index.d.ts

@@ -1,5 +1,36 @@
 import * as react$1 from 'react';
+import { ReactNode } from 'react';
 export * from '@guidelytech/react';
+import { GuidelyOptions } from '@guidelytech/sdk-core';
+
+interface GuidelyGlobalErrorProps extends Partial<Pick<GuidelyOptions, "projectId" | "environment" | "apiUrl" | "release" | "errors">> {
+    /** The `error` prop Next.js passes to `app/global-error.tsx`. */
+    error: Error & {
+        digest?: string;
+    };
+    /** The `reset` prop Next.js passes; the default page's "Try again" button calls it. */
+    reset?: () => void;
+    /** Your own page body (default: a short message and a "Try again" button). */
+    children?: ReactNode;
+}
+/**
+ * `app/global-error.tsx` for Sentry-style reporting of errors in the root layout:
+ *
+ * ```tsx
+ * "use client";
+ * import { GuidelyGlobalError } from "@guidelytech/nextjs";
+ * export default function GlobalError(props: { error: Error & { digest?: string }; reset: () => void }) {
+ *   return <GuidelyGlobalError {...props} projectId={process.env.NEXT_PUBLIC_GUIDELY_PROJECT_ID!} />;
+ * }
+ * ```
+ *
+ * The root layout (and with it `GuidelyProvider` and its client) is gone when this renders, so it
+ * reports through the live `createGuidely()` client when there is one, else through a client of
+ * its own made from `projectId` (and `environment`, `apiUrl`, `release`, `errors`) that lives as
+ * long as the page. Server errors arrive with only their `digest`; it is sent in `contexts.nextjs`
+ * so the event matches the server's (`onRequestError`) one.
+ */
+declare function GuidelyGlobalError({ error, reset, children, projectId, environment, apiUrl, release, errors }: GuidelyGlobalErrorProps): react$1.JSX.Element;
 
 /**
  * Explicit App Router navigation bridge: calls `client.page()` whenever the pathname or search
@@ -10,9 +41,9 @@ declare function GuidelyNavigationListener(): react$1.JSX.Element;
 /** Reads the public `NEXT_PUBLIC_GUIDELY_*` environment variables (project id, env, API URL, release) into provider props. */
 declare function guidelyEnv(env?: Record<string, string | undefined>): {
     projectId: string;
-    environment: "development" | "staging" | "production" | undefined;
+    environment: string | undefined;
     apiUrl: string | undefined;
     release: string | undefined;
 };
 
-export { GuidelyNavigationListener, guidelyEnv };
+export { GuidelyGlobalError, type GuidelyGlobalErrorProps, GuidelyNavigationListener, guidelyEnv };

package/dist/index.js

@@ -3,16 +3,39 @@
 // src/index.tsx
 import { useGuidely } from "@guidelytech/react";
 import { usePathname, useSearchParams } from "next/navigation";
-import { Suspense, useEffect, useRef } from "react";
+import { Suspense, useEffect as useEffect2, useRef } from "react";
 export * from "@guidelytech/react";
-import { jsx } from "react/jsx-runtime";
+
+// src/global-error.tsx
+import { createGuidely, GuidelyClient } from "@guidelytech/sdk-core";
+import { useEffect } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+function GuidelyGlobalError({ error, reset, children, projectId, environment, apiUrl, release, errors }) {
+  useEffect(() => {
+    let own = null;
+    try {
+      let client = GuidelyClient.get();
+      if (!client && projectId) client = own = createGuidely({ projectId, environment, apiUrl, release, errors });
+      client?.captureException(error, { mechanism: { type: "nextjs.global-error", handled: false }, ...error?.digest ? { contexts: { nextjs: { digest: error.digest } } } : {} });
+    } catch {
+    }
+    return () => own?.destroy();
+  }, [error]);
+  return /* @__PURE__ */ jsx("html", { children: /* @__PURE__ */ jsx("body", { children: children ?? /* @__PURE__ */ jsxs("div", { style: { fontFamily: "system-ui, sans-serif", padding: "4rem 1rem", textAlign: "center" }, children: [
+    /* @__PURE__ */ jsx("h2", { children: "Something went wrong" }),
+    reset ? /* @__PURE__ */ jsx("button", { type: "button", onClick: () => reset(), children: "Try again" }) : null
+  ] }) }) });
+}
+
+// src/index.tsx
+import { jsx as jsx2 } from "react/jsx-runtime";
 function Listener() {
   const client = useGuidely();
   const pathname = usePathname();
   const search = useSearchParams();
   const query = search?.toString() ?? "";
   const first = useRef(true);
-  useEffect(() => {
+  useEffect2(() => {
     if (first.current) {
       first.current = false;
       return;
@@ -22,17 +45,18 @@ function Listener() {
   return null;
 }
 function GuidelyNavigationListener() {
-  return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(Listener, {}) });
+  return /* @__PURE__ */ jsx2(Suspense, { fallback: null, children: /* @__PURE__ */ jsx2(Listener, {}) });
 }
 function guidelyEnv(env = typeof process !== "undefined" ? process.env : {}) {
   return {
     projectId: env.NEXT_PUBLIC_GUIDELY_PROJECT_ID ?? "",
-    environment: env.NEXT_PUBLIC_GUIDELY_ENV ?? void 0,
+    environment: env.NEXT_PUBLIC_GUIDELY_ENV || void 0,
     apiUrl: env.NEXT_PUBLIC_GUIDELY_API_URL || void 0,
     release: env.NEXT_PUBLIC_GUIDELY_RELEASE || void 0
   };
 }
 export {
+  GuidelyGlobalError,
   GuidelyNavigationListener,
   guidelyEnv
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.tsx"],"sourcesContent":["import { useGuidely } from \"@guidelytech/react\";\nimport { usePathname, useSearchParams } from \"next/navigation\";\nimport { Suspense, useEffect, useRef } from \"react\";\n\nexport * from \"@guidelytech/react\";\n\nfunction Listener() {\n  const client = useGuidely();\n  const pathname = usePathname();\n  const search = useSearchParams();\n  const query = search?.toString() ?? \"\";\n  const first = useRef(true);\n  useEffect(() => {\n    if (first.current) {\n      first.current = false;\n      return;\n    }\n    client.page(typeof window !== \"undefined\" ? window.location.href : pathname + (query ? `?${query}` : \"\"));\n  }, [pathname, query]);\n  return null;\n}\n\n/**\n * Explicit App Router navigation bridge: calls `client.page()` whenever the pathname or search\n * params change. Wrapped in `Suspense` because `useSearchParams` requires it. sdk-core also\n * detects navigation through the History API, so this is belt and braces.\n */\nexport function GuidelyNavigationListener() {\n  return (\n    <Suspense fallback={null}>\n      <Listener />\n    </Suspense>\n  );\n}\n\n/** Reads the public `NEXT_PUBLIC_GUIDELY_*` environment variables (project id, env, API URL, release) into provider props. */\nexport function guidelyEnv(env: Record<string, string | undefined> = typeof process !== \"undefined\" ? process.env : {}) {\n  return {\n    projectId: env.NEXT_PUBLIC_GUIDELY_PROJECT_ID ?? \"\",\n    environment: (env.NEXT_PUBLIC_GUIDELY_ENV as \"development\" | \"staging\" | \"production\" | undefined) ?? undefined,\n    apiUrl: env.NEXT_PUBLIC_GUIDELY_API_URL || undefined,\n    release: env.NEXT_PUBLIC_GUIDELY_RELEASE || undefined,\n  };\n}\n"],"mappings":";;;AAAA,SAAS,kBAAkB;AAC3B,SAAS,aAAa,uBAAuB;AAC7C,SAAS,UAAU,WAAW,cAAc;AAE5C,cAAc;AA0BR;AAxBN,SAAS,WAAW;AAClB,QAAM,SAAS,WAAW;AAC1B,QAAM,WAAW,YAAY;AAC7B,QAAM,SAAS,gBAAgB;AAC/B,QAAM,QAAQ,QAAQ,SAAS,KAAK;AACpC,QAAM,QAAQ,OAAO,IAAI;AACzB,YAAU,MAAM;AACd,QAAI,MAAM,SAAS;AACjB,YAAM,UAAU;AAChB;AAAA,IACF;AACA,WAAO,KAAK,OAAO,WAAW,cAAc,OAAO,SAAS,OAAO,YAAY,QAAQ,IAAI,KAAK,KAAK,GAAG;AAAA,EAC1G,GAAG,CAAC,UAAU,KAAK,CAAC;AACpB,SAAO;AACT;AAOO,SAAS,4BAA4B;AAC1C,SACE,oBAAC,YAAS,UAAU,MAClB,8BAAC,YAAS,GACZ;AAEJ;AAGO,SAAS,WAAW,MAA0C,OAAO,YAAY,cAAc,QAAQ,MAAM,CAAC,GAAG;AACtH,SAAO;AAAA,IACL,WAAW,IAAI,kCAAkC;AAAA,IACjD,aAAc,IAAI,2BAAoF;AAAA,IACtG,QAAQ,IAAI,+BAA+B;AAAA,IAC3C,SAAS,IAAI,+BAA+B;AAAA,EAC9C;AACF;","names":[]}
+{"version":3,"sources":["../src/index.tsx","../src/global-error.tsx"],"sourcesContent":["import { useGuidely } from \"@guidelytech/react\";\nimport { usePathname, useSearchParams } from \"next/navigation\";\nimport { Suspense, useEffect, useRef } from \"react\";\n\nexport * from \"@guidelytech/react\";\nexport { GuidelyGlobalError } from \"./global-error\";\nexport type { GuidelyGlobalErrorProps } from \"./global-error\";\n\nfunction Listener() {\n  const client = useGuidely();\n  const pathname = usePathname();\n  const search = useSearchParams();\n  const query = search?.toString() ?? \"\";\n  const first = useRef(true);\n  useEffect(() => {\n    if (first.current) {\n      first.current = false;\n      return;\n    }\n    client.page(typeof window !== \"undefined\" ? window.location.href : pathname + (query ? `?${query}` : \"\"));\n  }, [pathname, query]);\n  return null;\n}\n\n/**\n * Explicit App Router navigation bridge: calls `client.page()` whenever the pathname or search\n * params change. Wrapped in `Suspense` because `useSearchParams` requires it. sdk-core also\n * detects navigation through the History API, so this is belt and braces.\n */\nexport function GuidelyNavigationListener() {\n  return (\n    <Suspense fallback={null}>\n      <Listener />\n    </Suspense>\n  );\n}\n\n/** Reads the public `NEXT_PUBLIC_GUIDELY_*` environment variables (project id, env, API URL, release) into provider props. */\nexport function guidelyEnv(env: Record<string, string | undefined> = typeof process !== \"undefined\" ? process.env : {}) {\n  return {\n    projectId: env.NEXT_PUBLIC_GUIDELY_PROJECT_ID ?? \"\",\n    environment: env.NEXT_PUBLIC_GUIDELY_ENV || undefined,\n    apiUrl: env.NEXT_PUBLIC_GUIDELY_API_URL || undefined,\n    release: env.NEXT_PUBLIC_GUIDELY_RELEASE || undefined,\n  };\n}\n","import { createGuidely, GuidelyClient, type GuidelyOptions } from \"@guidelytech/sdk-core\";\nimport { useEffect, type ReactNode } from \"react\";\n\nexport interface GuidelyGlobalErrorProps extends Partial<Pick<GuidelyOptions, \"projectId\" | \"environment\" | \"apiUrl\" | \"release\" | \"errors\">> {\n  /** The `error` prop Next.js passes to `app/global-error.tsx`. */\n  error: Error & { digest?: string };\n  /** The `reset` prop Next.js passes; the default page's \"Try again\" button calls it. */\n  reset?: () => void;\n  /** Your own page body (default: a short message and a \"Try again\" button). */\n  children?: ReactNode;\n}\n\n/**\n * `app/global-error.tsx` for Sentry-style reporting of errors in the root layout:\n *\n * ```tsx\n * \"use client\";\n * import { GuidelyGlobalError } from \"@guidelytech/nextjs\";\n * export default function GlobalError(props: { error: Error & { digest?: string }; reset: () => void }) {\n *   return <GuidelyGlobalError {...props} projectId={process.env.NEXT_PUBLIC_GUIDELY_PROJECT_ID!} />;\n * }\n * ```\n *\n * The root layout (and with it `GuidelyProvider` and its client) is gone when this renders, so it\n * reports through the live `createGuidely()` client when there is one, else through a client of\n * its own made from `projectId` (and `environment`, `apiUrl`, `release`, `errors`) that lives as\n * long as the page. Server errors arrive with only their `digest`; it is sent in `contexts.nextjs`\n * so the event matches the server's (`onRequestError`) one.\n */\nexport function GuidelyGlobalError({ error, reset, children, projectId, environment, apiUrl, release, errors }: GuidelyGlobalErrorProps) {\n  useEffect(() => {\n    let own: GuidelyClient | null = null;\n    try {\n      let client = GuidelyClient.get();\n      if (!client && projectId) client = own = createGuidely({ projectId, environment, apiUrl, release, errors });\n      client?.captureException(error, { mechanism: { type: \"nextjs.global-error\", handled: false }, ...(error?.digest ? { contexts: { nextjs: { digest: error.digest } } } : {}) });\n    } catch {\n      // never break the error page\n    }\n    return () => own?.destroy();\n  }, [error]);\n  return (\n    <html>\n      <body>\n        {children ?? (\n          <div style={{ fontFamily: \"system-ui, sans-serif\", padding: \"4rem 1rem\", textAlign: \"center\" }}>\n            <h2>Something went wrong</h2>\n            {reset ? (\n              <button type=\"button\" onClick={() => reset()}>\n                Try again\n              </button>\n            ) : null}\n          </div>\n        )}\n      </body>\n    </html>\n  );\n}\n"],"mappings":";;;AAAA,SAAS,kBAAkB;AAC3B,SAAS,aAAa,uBAAuB;AAC7C,SAAS,UAAU,aAAAA,YAAW,cAAc;AAE5C,cAAc;;;ACJd,SAAS,eAAe,qBAA0C;AAClE,SAAS,iBAAiC;AA4ChC,SACE,KADF;AAhBH,SAAS,mBAAmB,EAAE,OAAO,OAAO,UAAU,WAAW,aAAa,QAAQ,SAAS,OAAO,GAA4B;AACvI,YAAU,MAAM;AACd,QAAI,MAA4B;AAChC,QAAI;AACF,UAAI,SAAS,cAAc,IAAI;AAC/B,UAAI,CAAC,UAAU,UAAW,UAAS,MAAM,cAAc,EAAE,WAAW,aAAa,QAAQ,SAAS,OAAO,CAAC;AAC1G,cAAQ,iBAAiB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,SAAS,MAAM,GAAG,GAAI,OAAO,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,MAAM,OAAO,EAAE,EAAE,IAAI,CAAC,EAAG,CAAC;AAAA,IAC9K,QAAQ;AAAA,IAER;AACA,WAAO,MAAM,KAAK,QAAQ;AAAA,EAC5B,GAAG,CAAC,KAAK,CAAC;AACV,SACE,oBAAC,UACC,8BAAC,UACE,sBACC,qBAAC,SAAI,OAAO,EAAE,YAAY,yBAAyB,SAAS,aAAa,WAAW,SAAS,GAC3F;AAAA,wBAAC,QAAG,kCAAoB;AAAA,IACvB,QACC,oBAAC,YAAO,MAAK,UAAS,SAAS,MAAM,MAAM,GAAG,uBAE9C,IACE;AAAA,KACN,GAEJ,GACF;AAEJ;;;ADzBM,gBAAAC,YAAA;AAxBN,SAAS,WAAW;AAClB,QAAM,SAAS,WAAW;AAC1B,QAAM,WAAW,YAAY;AAC7B,QAAM,SAAS,gBAAgB;AAC/B,QAAM,QAAQ,QAAQ,SAAS,KAAK;AACpC,QAAM,QAAQ,OAAO,IAAI;AACzB,EAAAC,WAAU,MAAM;AACd,QAAI,MAAM,SAAS;AACjB,YAAM,UAAU;AAChB;AAAA,IACF;AACA,WAAO,KAAK,OAAO,WAAW,cAAc,OAAO,SAAS,OAAO,YAAY,QAAQ,IAAI,KAAK,KAAK,GAAG;AAAA,EAC1G,GAAG,CAAC,UAAU,KAAK,CAAC;AACpB,SAAO;AACT;AAOO,SAAS,4BAA4B;AAC1C,SACE,gBAAAD,KAAC,YAAS,UAAU,MAClB,0BAAAA,KAAC,YAAS,GACZ;AAEJ;AAGO,SAAS,WAAW,MAA0C,OAAO,YAAY,cAAc,QAAQ,MAAM,CAAC,GAAG;AACtH,SAAO;AAAA,IACL,WAAW,IAAI,kCAAkC;AAAA,IACjD,aAAa,IAAI,2BAA2B;AAAA,IAC5C,QAAQ,IAAI,+BAA+B;AAAA,IAC3C,SAAS,IAAI,+BAA+B;AAAA,EAC9C;AACF;","names":["useEffect","jsx","useEffect"]}

package/dist/server.cjs

@@ -20,13 +20,208 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/server.ts
 var server_exports = {};
 __export(server_exports, {
+  captureRequestError: () => captureRequestError,
+  captureServerError: () => captureServerError,
+  createOnRequestError: () => createOnRequestError,
   createServerFlags: () => createServerFlags,
   getFlags: () => getFlags,
-  getFlagsBootstrap: () => getFlagsBootstrap
+  getFlagsBootstrap: () => getFlagsBootstrap,
+  isNextControlError: () => isNextControlError,
+  onRequestError: () => onRequestError,
+  setGuidelyServerClient: () => setGuidelyServerClient,
+  withGuidely: () => withGuidely,
+  withServerActionGuidely: () => withServerActionGuidely
 });
 module.exports = __toCommonJS(server_exports);
 var import_flags = require("@guidelytech/flags");
+
+// src/server-errors.ts
 function registry() {
+  const g = globalThis;
+  return g.__guidelyServerErrors ?? (g.__guidelyServerErrors = { client: null, reported: /* @__PURE__ */ new WeakSet(), warned: false });
+}
+function setGuidelyServerClient(client) {
+  registry().client = client;
+}
+var SENSITIVE_HEADER = /^(?:cookie|set-cookie|authorization|proxy-authorization)$|token|secret|password|api[-_]?key|session|csrf/i;
+function safeHeaders(headers) {
+  const out = {};
+  const add = (name, value) => {
+    if (Object.keys(out).length >= 50 || value === void 0 || value === null || SENSITIVE_HEADER.test(name)) return;
+    out[name.toLowerCase()] = (Array.isArray(value) ? value.join(", ") : String(value)).slice(0, 1e3);
+  };
+  try {
+    const h = headers;
+    if (h && typeof h.forEach === "function" && !Array.isArray(h)) h.forEach((value, name) => add(name, value));
+    else if (h && typeof h === "object") for (const [name, value] of Object.entries(h)) add(name, value);
+  } catch {
+  }
+  return out;
+}
+function isNextControlError(error) {
+  if (!error || typeof error !== "object") return false;
+  const e = error;
+  if (e.$$typeof === /* @__PURE__ */ Symbol.for("react.postpone")) return true;
+  const digest = typeof e.digest === "string" ? e.digest : typeof e.message === "string" ? e.message : "";
+  return /^(?:NEXT_REDIRECT|NEXT_NOT_FOUND|NEXT_HTTP_ERROR_FALLBACK|DYNAMIC_SERVER_USAGE|BAILOUT_TO_CLIENT_SIDE_RENDERING|NEXT_PRERENDER_INTERRUPTED|HANGING_PROMISE_REJECTION)/.test(digest);
+}
+function requestWaitUntil() {
+  try {
+    const g = globalThis;
+    for (const key of ["@next/request-context", "@vercel/request-context"]) {
+      const waitUntil = g[Symbol.for(key)]?.get?.()?.waitUntil;
+      if (typeof waitUntil === "function") return waitUntil;
+    }
+  } catch {
+  }
+  return void 0;
+}
+function flushSoon(client, options) {
+  const timeout = options.flushTimeoutMs ?? 2e3;
+  if (typeof client.flush !== "function" || timeout <= 0) return void 0;
+  let timer;
+  const p = Promise.race([
+    Promise.resolve().then(() => client.flush()).catch(() => {
+    }),
+    new Promise((resolve) => {
+      timer = setTimeout(resolve, timeout);
+      timer.unref?.();
+    })
+  ]).finally(() => clearTimeout(timer));
+  const waitUntil = requestWaitUntil();
+  if (waitUntil) {
+    try {
+      waitUntil(p);
+    } catch {
+    }
+  }
+  return p;
+}
+function captureServerError(error, input, options = {}) {
+  try {
+    if (isNextControlError(error)) return { eventId: "" };
+    const reg = registry();
+    const client = options.client ?? reg.client;
+    if (!client) {
+      if (!reg.warned) {
+        reg.warned = true;
+        console.warn("[Guidely] A server error was not reported: no server client. Call setGuidelyServerClient(new Guidely({ secretKey, environment })) from register() in instrumentation.ts.");
+      }
+      return { eventId: "" };
+    }
+    if (error && typeof error === "object") {
+      if (reg.reported.has(error)) return { eventId: "" };
+      reg.reported.add(error);
+    }
+    const digest = error && typeof error === "object" && typeof error.digest === "string" ? error.digest : void 0;
+    const nextjs = { ...input.contexts?.nextjs ?? {}, ...digest ? { digest } : {} };
+    const ctx = {
+      level: "error",
+      ...input.tags ? { tags: input.tags } : {},
+      contexts: { ...input.contexts ?? {}, ...Object.keys(nextjs).length ? { nextjs } : {} },
+      ...input.request ? { request: input.request } : {},
+      mechanism: { type: input.mechanism, handled: false }
+    };
+    const run = () => client.captureException(error, ctx);
+    const id = input.transaction && typeof client.withScope === "function" ? client.withScope((scope) => {
+      scope.setTransactionName?.(input.transaction);
+      return run();
+    }) : run();
+    return { eventId: typeof id === "string" ? id : "", flushed: flushSoon(client, options) };
+  } catch {
+    return { eventId: "" };
+  }
+}
+var str = (v) => typeof v === "string" && v ? v : void 0;
+function createOnRequestError(options = {}) {
+  return async (error, request, context) => {
+    try {
+      const tags = {};
+      const nextjs = {};
+      for (const [k, v] of Object.entries(context ?? {})) {
+        if (typeof v !== "string" || !v) continue;
+        nextjs[k] = v;
+        if (k === "routerKind" || k === "routePath" || k === "routeType") tags[k] = v;
+      }
+      const method = str(request?.method)?.toUpperCase();
+      const route = str(context?.routePath);
+      const { flushed } = captureServerError(
+        error,
+        {
+          tags,
+          contexts: { nextjs },
+          request: { method, url: str(request?.path), headers: safeHeaders(request?.headers) },
+          transaction: route ? method && context?.routeType !== "render" ? `${method} ${route}` : route : void 0,
+          mechanism: "nextjs.onRequestError"
+        },
+        options
+      );
+      if (options.waitForFlush && flushed) await flushed;
+    } catch {
+    }
+  };
+}
+var onRequestError = createOnRequestError();
+var captureRequestError = onRequestError;
+function requestOf(input) {
+  if (!input || typeof input !== "object") return void 0;
+  const r = input;
+  if (typeof r.url !== "string" || !r.headers) return void 0;
+  let path;
+  try {
+    path = new URL(r.url).pathname;
+  } catch {
+    path = void 0;
+  }
+  return { method: str(r.method)?.toUpperCase(), url: r.url, headers: safeHeaders(r.headers), path };
+}
+function withGuidely(handler, options = {}) {
+  const report = (error, args) => {
+    const req = requestOf(args[0]);
+    const route = options.route ?? req?.path;
+    captureServerError(error, { tags: { routeType: "route", ...options.route ? { routePath: options.route } : {} }, request: req && { method: req.method, url: req.url, headers: req.headers }, transaction: route ? `${req?.method ? `${req.method} ` : ""}${route}` : void 0, mechanism: "nextjs.route_handler" }, options);
+  };
+  const wrapped = function(...args) {
+    let out;
+    try {
+      out = handler.apply(this, args);
+    } catch (error) {
+      report(error, args);
+      throw error;
+    }
+    if (out && typeof out.then === "function") {
+      return out.then(void 0, (error) => {
+        report(error, args);
+        throw error;
+      });
+    }
+    return out;
+  };
+  return wrapped;
+}
+function withServerActionGuidely(name, action, options = {}) {
+  return async (...args) => {
+    try {
+      return await action(...args);
+    } catch (error) {
+      if (!isNextControlError(error)) {
+        let headers;
+        try {
+          const h = typeof options.headers === "function" ? options.headers() : options.headers;
+          headers = h ? safeHeaders(await h) : void 0;
+        } catch {
+          headers = void 0;
+        }
+        const { flushed } = captureServerError(error, { tags: { routeType: "action", serverAction: name.slice(0, 200) }, contexts: { nextjs: { serverAction: name } }, ...headers ? { request: { method: "POST", headers } } : {}, transaction: `serverAction/${name}`, mechanism: "nextjs.server_action" }, options);
+        if (options.waitForFlush && flushed) await flushed;
+      }
+      throw error;
+    }
+  };
+}
+
+// src/server.ts
+function registry2() {
   const g = globalThis;
   return g.__guidelyServerFlags ?? (g.__guidelyServerFlags = { clients: /* @__PURE__ */ new Map(), current: null, warned: /* @__PURE__ */ new Set() });
 }
@@ -47,7 +242,7 @@ function createServerFlags(options = {}) {
   const apiUrl = options.apiUrl ?? env("GUIDELY_API_URL") ?? env("NEXT_PUBLIC_GUIDELY_API_URL");
   const environment = options.environment ?? env("GUIDELY_ENV") ?? env("NEXT_PUBLIC_GUIDELY_ENV");
   const id = `${sdkKey}|${apiUrl ?? ""}|${environment ?? ""}|${options.pollingMode ?? "auto"}`;
-  const reg = registry();
+  const reg = registry2();
   let client = reg.clients.get(id);
   if (!client) {
     client = (0, import_flags.createFlagsClient)({ storage: false, ...options, sdkKey, apiUrl, environment, fetch: options.fetch ?? noStoreFetch });
@@ -61,14 +256,14 @@ function settle(client, timeoutMs) {
   return Promise.race([client.ready(), new Promise((r) => setTimeout(r, timeoutMs))]);
 }
 async function getFlags(attributes = {}, options = {}) {
-  const client = options.client ?? registry().current ?? createServerFlags();
+  const client = options.client ?? registry2().current ?? createServerFlags();
   await settle(client, options.timeoutMs ?? 1500);
   return client.forUser(attributes);
 }
 async function getFlagsBootstrap(options = {}) {
-  const client = options.client ?? registry().current ?? createServerFlags();
+  const client = options.client ?? registry2().current ?? createServerFlags();
   if (client.sdkKey.startsWith("gly_sk_")) {
-    const reg = registry();
+    const reg = registry2();
     if (!reg.warned.has(client.sdkKey)) {
       reg.warned.add(client.sdkKey);
       console.warn("[Guidely] getFlagsBootstrap() needs a public-key client (pk_\u2026): a gly_sk_ payload includes server-only flags. Pass { client: createServerFlags({ sdkKey: process.env.NEXT_PUBLIC_GUIDELY_PROJECT_ID }) }.");
@@ -80,8 +275,16 @@ async function getFlagsBootstrap(options = {}) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  captureRequestError,
+  captureServerError,
+  createOnRequestError,
   createServerFlags,
   getFlags,
-  getFlagsBootstrap
+  getFlagsBootstrap,
+  isNextControlError,
+  onRequestError,
+  setGuidelyServerClient,
+  withGuidely,
+  withServerActionGuidely
 });
 //# sourceMappingURL=server.cjs.map