@djangocfg/nextjs 2.1.216 → 2.1.217

package/dist/monitor/index.d.mts

@@ -0,0 +1,22 @@
+export { ServerMonitorConfig, serverMonitor } from '@djangocfg/monitor/server';
+
+/**
+ * withMonitor — Route Handler wrapper for @djangocfg/nextjs
+ *
+ * Catches unhandled errors from a Next.js Route Handler,
+ * forwards them to serverMonitor, then re-throws so Next.js
+ * still returns a 500 response normally.
+ *
+ * @example
+ * // app/api/orders/route.ts
+ * import { withMonitor } from '@djangocfg/nextjs/monitor'
+ *
+ * export const POST = withMonitor(async (req) => {
+ *   // handler code
+ *   return Response.json({ ok: true })
+ * })
+ */
+type RouteHandler = (req: Request, ctx?: unknown) => Promise<Response> | Response;
+declare function withMonitor(handler: RouteHandler): RouteHandler;
+
+export { withMonitor };

package/dist/monitor/index.mjs

@@ -0,0 +1,23 @@
+// src/monitor/index.ts
+import { serverMonitor as serverMonitor2 } from "@djangocfg/monitor/server";
+
+// src/monitor/withMonitor.ts
+import { serverMonitor } from "@djangocfg/monitor/server";
+function withMonitor(handler) {
+  return async (req, ctx) => {
+    try {
+      return await handler(req, ctx);
+    } catch (err) {
+      try {
+        await serverMonitor.captureError(err, { url: req.url });
+      } catch {
+      }
+      throw err;
+    }
+  };
+}
+export {
+  serverMonitor2 as serverMonitor,
+  withMonitor
+};
+//# sourceMappingURL=index.mjs.map

package/dist/monitor/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/monitor/index.ts","../../src/monitor/withMonitor.ts"],"sourcesContent":["/**\n * @djangocfg/nextjs/monitor\n *\n * Server-side monitor utilities for Next.js Route Handlers and Server Components.\n *\n * Configure once in lib/monitor.ts, then use withMonitor() or serverMonitor directly.\n *\n * @example\n * // lib/monitor.ts\n * import { serverMonitor } from '@djangocfg/nextjs/monitor'\n * serverMonitor.configure({\n *   project: process.env.PROJECT_NAME ?? 'my-app',\n *   environment: process.env.NODE_ENV,\n *   baseUrl: process.env.NEXT_PUBLIC_API_URL,\n * })\n * export { serverMonitor }\n *\n * // app/api/orders/route.ts\n * import { withMonitor } from '@djangocfg/nextjs/monitor'\n * export const POST = withMonitor(async (req) => {\n *   // ...\n * })\n */\n\nexport { serverMonitor } from '@djangocfg/monitor/server'\nexport type { ServerMonitorConfig } from '@djangocfg/monitor/server'\nexport { withMonitor } from './withMonitor'\n","/**\n * withMonitor — Route Handler wrapper for @djangocfg/nextjs\n *\n * Catches unhandled errors from a Next.js Route Handler,\n * forwards them to serverMonitor, then re-throws so Next.js\n * still returns a 500 response normally.\n *\n * @example\n * // app/api/orders/route.ts\n * import { withMonitor } from '@djangocfg/nextjs/monitor'\n *\n * export const POST = withMonitor(async (req) => {\n *   // handler code\n *   return Response.json({ ok: true })\n * })\n */\n\nimport { serverMonitor } from '@djangocfg/monitor/server'\n\ntype RouteHandler = (req: Request, ctx?: unknown) => Promise<Response> | Response\n\nexport function withMonitor(handler: RouteHandler): RouteHandler {\n  return async (req: Request, ctx?: unknown): Promise<Response> => {\n    try {\n      return await handler(req, ctx)\n    } catch (err) {\n      try {\n        await serverMonitor.captureError(err, { url: req.url })\n      } catch { /* never crash */ }\n      throw err\n    }\n  }\n}\n"],"mappings":";AAwBA,SAAS,iBAAAA,sBAAqB;;;ACP9B,SAAS,qBAAqB;AAIvB,SAAS,YAAY,SAAqC;AAC/D,SAAO,OAAO,KAAc,QAAqC;AAC/D,QAAI;AACF,aAAO,MAAM,QAAQ,KAAK,GAAG;AAAA,IAC/B,SAAS,KAAK;AACZ,UAAI;AACF,cAAM,cAAc,aAAa,KAAK,EAAE,KAAK,IAAI,IAAI,CAAC;AAAA,MACxD,QAAQ;AAAA,MAAoB;AAC5B,YAAM;AAAA,IACR;AAAA,EACF;AACF;","names":["serverMonitor"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/nextjs",
-  "version": "2.1.216",
+  "version": "2.1.217",
   "description": "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
   "keywords": [
     "nextjs",
@@ -89,6 +89,11 @@
       "import": "./dist/pwa/worker/index.mjs",
       "default": "./dist/pwa/worker/index.mjs"
     },
+    "./monitor": {
+      "types": "./dist/monitor/index.d.mts",
+      "import": "./dist/monitor/index.mjs",
+      "default": "./dist/monitor/index.mjs"
+    },
     "./i18n": {
       "types": "./dist/i18n/index.d.mts",
       "import": "./dist/i18n/index.mjs",
@@ -148,11 +153,15 @@
     "ai-docs": "tsx src/ai/cli.ts"
   },
   "peerDependencies": {
-    "@djangocfg/i18n": "^2.1.216",
-    "@djangocfg/ui-core": "^2.1.216",
+    "@djangocfg/i18n": "^2.1.217",
+    "@djangocfg/monitor": "^2.1.217",
+    "@djangocfg/ui-core": "^2.1.217",
     "next": "^16.0.10"
   },
   "peerDependenciesMeta": {
+    "@djangocfg/monitor": {
+      "optional": true
+    },
     "@djangocfg/ui-core": {
       "optional": true
     }
@@ -168,14 +177,15 @@
     "serwist": "^9.2.3"
   },
   "devDependencies": {
-    "@djangocfg/i18n": "^2.1.216",
-    "@djangocfg/ui-core": "^2.1.216",
-    "@djangocfg/imgai": "^2.1.216",
-    "@djangocfg/layouts": "^2.1.216",
-    "@djangocfg/typescript-config": "^2.1.216",
+    "@djangocfg/i18n": "^2.1.217",
+    "@djangocfg/monitor": "^2.1.217",
+    "@djangocfg/ui-core": "^2.1.217",
+    "@djangocfg/imgai": "workspace:*",
+    "@djangocfg/layouts": "^2.1.217",
+    "@djangocfg/typescript-config": "^2.1.217",
     "@types/node": "^24.7.2",
-    "@types/react": "19.2.2",
-    "@types/react-dom": "19.2.1",
+    "@types/react": "^19.1.0",
+    "@types/react-dom": "^19.1.0",
     "@types/semver": "^7.7.1",
     "@types/webpack": "^5.28.5",
     "@vercel/og": "^0.8.5",

package/src/monitor/index.ts

@@ -0,0 +1,27 @@
+/**
+ * @djangocfg/nextjs/monitor
+ *
+ * Server-side monitor utilities for Next.js Route Handlers and Server Components.
+ *
+ * Configure once in lib/monitor.ts, then use withMonitor() or serverMonitor directly.
+ *
+ * @example
+ * // lib/monitor.ts
+ * import { serverMonitor } from '@djangocfg/nextjs/monitor'
+ * serverMonitor.configure({
+ *   project: process.env.PROJECT_NAME ?? 'my-app',
+ *   environment: process.env.NODE_ENV,
+ *   baseUrl: process.env.NEXT_PUBLIC_API_URL,
+ * })
+ * export { serverMonitor }
+ *
+ * // app/api/orders/route.ts
+ * import { withMonitor } from '@djangocfg/nextjs/monitor'
+ * export const POST = withMonitor(async (req) => {
+ *   // ...
+ * })
+ */
+
+export { serverMonitor } from '@djangocfg/monitor/server'
+export type { ServerMonitorConfig } from '@djangocfg/monitor/server'
+export { withMonitor } from './withMonitor'

package/src/monitor/withMonitor.ts

@@ -0,0 +1,33 @@
+/**
+ * withMonitor — Route Handler wrapper for @djangocfg/nextjs
+ *
+ * Catches unhandled errors from a Next.js Route Handler,
+ * forwards them to serverMonitor, then re-throws so Next.js
+ * still returns a 500 response normally.
+ *
+ * @example
+ * // app/api/orders/route.ts
+ * import { withMonitor } from '@djangocfg/nextjs/monitor'
+ *
+ * export const POST = withMonitor(async (req) => {
+ *   // handler code
+ *   return Response.json({ ok: true })
+ * })
+ */
+
+import { serverMonitor } from '@djangocfg/monitor/server'
+
+type RouteHandler = (req: Request, ctx?: unknown) => Promise<Response> | Response
+
+export function withMonitor(handler: RouteHandler): RouteHandler {
+  return async (req: Request, ctx?: unknown): Promise<Response> => {
+    try {
+      return await handler(req, ctx)
+    } catch (err) {
+      try {
+        await serverMonitor.captureError(err, { url: req.url })
+      } catch { /* never crash */ }
+      throw err
+    }
+  }
+}