@lowdefy/server 0.0.0-experimental-20251203205559 → 0.0.0-experimental-20260112140412

package/lib/client/createLogUsage.js

@@ -13,6 +13,7 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */
+import { v4 as uuid } from 'uuid';
 
 // What if this fails?
 // What about public usage
@@ -22,7 +23,7 @@ function createLogUsage({ usageDataRef }) {
   let isOffline = false;
   let machine = localStorage.getItem('lowdefy_machine_id');
   if (!machine) {
-    machine = crypto.randomUUID();
+    machine = uuid();
     localStorage.setItem('lowdefy_machine_id', machine);
   }
 

package/lib/client/sentry/captureSentryError.js

@@ -0,0 +1,43 @@
+/*
+  Copyright 2020-2024 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import * as Sentry from '@sentry/nextjs';
+
+function captureSentryError({ error, pageId, blockId, configLocation }) {
+  const tags = {};
+  const extra = {};
+
+  // Add Lowdefy-specific context
+  if (pageId) {
+    tags.pageId = pageId;
+  }
+
+  if (blockId) {
+    tags.blockId = blockId;
+  }
+
+  // Add config location context
+  if (configLocation) {
+    extra.configLocation = configLocation;
+  }
+
+  Sentry.captureException(error, {
+    tags,
+    extra,
+  });
+}
+
+export default captureSentryError;

package/lib/client/sentry/initSentryClient.js

@@ -0,0 +1,55 @@
+/*
+  Copyright 2020-2024 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import * as Sentry from '@sentry/nextjs';
+
+let initialized = false;
+
+function initSentryClient({ sentryDsn, sentryConfig }) {
+  // No-op if already initialized
+  if (initialized) {
+    return;
+  }
+
+  // No-op if SENTRY_DSN not set
+  if (!sentryDsn) {
+    return;
+  }
+
+  // No-op if client logging is explicitly disabled
+  if (sentryConfig?.client === false) {
+    return;
+  }
+
+  const config = sentryConfig || {};
+
+  Sentry.init({
+    dsn: sentryDsn,
+    environment: config.environment || process.env.NODE_ENV || 'production',
+    tracesSampleRate: config.tracesSampleRate ?? 0.1,
+    replaysSessionSampleRate: config.replaysSessionSampleRate ?? 0,
+    replaysOnErrorSampleRate: config.replaysOnErrorSampleRate ?? 0.1,
+    integrations: [
+      Sentry.replayIntegration(),
+      ...(config.feedback ? [Sentry.feedbackIntegration({ colorScheme: 'system' })] : []),
+    ],
+  });
+
+  initialized = true;
+  console.log('Sentry enabled: client');
+}
+
+export default initSentryClient;

package/lib/client/sentry/setSentryUser.js

@@ -0,0 +1,41 @@
+/*
+  Copyright 2020-2024 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import * as Sentry from '@sentry/nextjs';
+
+function setSentryUser({ user, sentryConfig }) {
+  // No-op if no user
+  if (!user) {
+    Sentry.setUser(null);
+    return;
+  }
+
+  const userFields = sentryConfig?.userFields || ['id', '_id'];
+  const sentryUser = {};
+
+  userFields.forEach((field) => {
+    if (user[field] !== undefined) {
+      sentryUser[field] = user[field];
+    }
+  });
+
+  // Only set user if we have at least one field
+  if (Object.keys(sentryUser).length > 0) {
+    Sentry.setUser(sentryUser);
+  }
+}
+
+export default setSentryUser;

package/lib/server/apiWrapper.js

@@ -15,9 +15,9 @@
 */
 
 import path from 'path';
-import crypto from 'crypto';
 import { createApiContext } from '@lowdefy/api';
 import { getSecretsFromEnv } from '@lowdefy/node-utils';
+import { v4 as uuid } from 'uuid';
 
 import config from '../../build/config.json';
 import connections from '../../build/plugins/connections.js';
@@ -29,6 +29,14 @@ import logRequest from './log/logRequest.js';
 import operators from '../../build/plugins/operators/server.js';
 import jsMap from '../../build/plugins/operators/serverJsMap.js';
 import getAuthOptions from './auth/getAuthOptions.js';
+import setSentryUser from './sentry/setSentryUser.js';
+
+let loggerConfig = {};
+try {
+  loggerConfig = require('../../build/logger.json');
+} catch {
+  // logger.json may not exist if logger is not configured
+}
 
 const secrets = getSecretsFromEnv();
 
@@ -36,7 +44,7 @@ function apiWrapper(handler) {
   return async function wrappedHandler(req, res) {
     const context = {
       // Important to give absolute path so Next can trace build files
-      rid: crypto.randomUUID(),
+      rid: uuid(),
       buildDirectory: path.join(process.cwd(), 'build'),
       config,
       connections,
@@ -54,6 +62,11 @@ function apiWrapper(handler) {
       context.authOptions = getAuthOptions(context);
       if (!req.url.startsWith('/api/auth')) {
         context.session = await getServerSession(context);
+        // Set Sentry user context for authenticated requests
+        setSentryUser({
+          user: context.session?.user,
+          sentryConfig: loggerConfig.sentry,
+        });
       }
       createApiContext(context);
       logRequest({ context });
@@ -61,7 +74,7 @@ function apiWrapper(handler) {
       const response = await handler({ context, req, res });
       return response;
     } catch (error) {
-      logError({ error, context });
+      await logError({ error, context });
       res.status(500).json({ name: error.name, message: error.message });
     }
   };

package/lib/server/log/logError.js

@@ -14,53 +14,109 @@
   limitations under the License.
 */
 
-function logError({ context, error }) {
+import { resolveConfigLocation } from '@lowdefy/helpers';
+
+import captureSentryError from '../sentry/captureSentryError.js';
+
+async function resolveErrorConfigLocation(context, error) {
+  if (!error.configKey) {
+    return null;
+  }
+  try {
+    const [keyMap, refMap] = await Promise.all([
+      context.readConfigFile('keyMap.json'),
+      context.readConfigFile('refMap.json'),
+    ]);
+    const location = resolveConfigLocation({
+      configKey: error.configKey,
+      keyMap,
+      refMap,
+      configDirectory: context.configDirectory,
+    });
+    return location || null;
+  } catch {
+    return null;
+  }
+}
+
+async function logError({ context, error }) {
   try {
     const { headers = {}, user = {} } = context;
+    const message = error?.message || 'Unknown error';
+    const isServiceError = error?.isServiceError === true;
 
-    context.logger.error({
-      // TODO:
-      // app_name
-      // app_version
-      // lowdefy_version
-      // build_hash
-      // config_hash
-      err: error,
-      user: {
-        id: user.id,
-        roles: user.roles,
-        sub: user.sub,
-        session_id: user.session_id,
-      },
-      url: context.req.url,
-      method: context.req.method,
-      resolvedUrl: context.nextContext?.resolvedUrl,
-      hostname: context.req.hostname,
-      headers: {
-        'accept-language': headers['accept-language'],
-        'sec-ch-ua-mobile': headers['sec-ch-ua-mobile'],
-        'sec-ch-ua-platform': headers['sec-ch-ua-platform'],
-        'sec-ch-ua': headers['sec-ch-ua'],
-        'user-agent': headers['user-agent'],
-        host: headers.host,
-        referer: headers.referer,
-        // Non localhost headers
-        'x-forward-for': headers['x-forward-for'],
-        // Vercel headers
-        'x-vercel-id': headers['x-vercel-id'],
-        'x-real-ip': headers['x-real-ip'],
-        'x-vercel-ip-country': headers['x-vercel-ip-country'],
-        'x-vercel-ip-country-region': headers['x-vercel-ip-country-region'],
-        'x-vercel-ip-city': headers['x-vercel-ip-city'],
-        'x-vercel-ip-latitude': headers['x-vercel-ip-latitude'],
-        'x-vercel-ip-longitude': headers['x-vercel-ip-longitude'],
-        'x-vercel-ip-timezone': headers['x-vercel-ip-timezone'],
-        // Cloudflare headers
-        'cf-connecting-ip': headers['cf-connecting-ip'],
-        'cf-ray': headers['cf-ray'],
-        'cf-ipcountry': headers['cf-ipcountry'],
-        'cf-visitor': headers['cf-visitor'],
+    // For service errors, don't resolve config location (not a config issue)
+    const location = isServiceError ? null : await resolveErrorConfigLocation(context, error);
+
+    // Human-readable console output (single log entry)
+    const errorType = isServiceError ? 'Service Error' : 'Config Error';
+    const source = location?.source ? `${location.source} at ${location.config}` : '';
+    const link = location?.link || '';
+
+    if (isServiceError) {
+      console.error(`[${errorType}] ${message}`);
+    } else {
+      console.error(`[${errorType}] ${message}\n  ${source}\n  ${link}`);
+    }
+
+    // Structured logging (consistent with client error schema + production fields)
+    context.logger.error(
+      {
+        // Core error schema (consistent with client)
+        event: isServiceError ? 'service_error' : 'config_error',
+        errorName: error?.name || 'Error',
+        errorMessage: message,
+        isServiceError,
+        pageId: context.pageId || null,
+        timestamp: new Date().toISOString(),
+        source: location?.source || null,
+        config: location?.config || null,
+        link: location?.link || null,
+        // Production fields
+        user: {
+          id: user.id,
+          roles: user.roles,
+          sub: user.sub,
+          session_id: user.session_id,
+        },
+        url: context.req.url,
+        method: context.req.method,
+        resolvedUrl: context.nextContext?.resolvedUrl,
+        hostname: context.req.hostname,
+        headers: {
+          'accept-language': headers['accept-language'],
+          'sec-ch-ua-mobile': headers['sec-ch-ua-mobile'],
+          'sec-ch-ua-platform': headers['sec-ch-ua-platform'],
+          'sec-ch-ua': headers['sec-ch-ua'],
+          'user-agent': headers['user-agent'],
+          host: headers.host,
+          referer: headers.referer,
+          // Non localhost headers
+          'x-forward-for': headers['x-forward-for'],
+          // Vercel headers
+          'x-vercel-id': headers['x-vercel-id'],
+          'x-real-ip': headers['x-real-ip'],
+          'x-vercel-ip-country': headers['x-vercel-ip-country'],
+          'x-vercel-ip-country-region': headers['x-vercel-ip-country-region'],
+          'x-vercel-ip-city': headers['x-vercel-ip-city'],
+          'x-vercel-ip-latitude': headers['x-vercel-ip-latitude'],
+          'x-vercel-ip-longitude': headers['x-vercel-ip-longitude'],
+          'x-vercel-ip-timezone': headers['x-vercel-ip-timezone'],
+          // Cloudflare headers
+          'cf-connecting-ip': headers['cf-connecting-ip'],
+          'cf-ray': headers['cf-ray'],
+          'cf-ipcountry': headers['cf-ipcountry'],
+          'cf-visitor': headers['cf-visitor'],
+        },
       },
+      message
+    );
+
+    // Capture error to Sentry (no-op if Sentry not configured)
+    captureSentryError({
+      error,
+      context,
+      configLocation: location,
     });
   } catch (e) {
     console.error(error);

package/lib/server/sentry/captureSentryError.js

@@ -0,0 +1,57 @@
+/*
+  Copyright 2020-2024 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import * as Sentry from '@sentry/nextjs';
+
+function captureSentryError({ error, context, configLocation }) {
+  // No-op if Sentry not initialized (DSN not set)
+  if (!process.env.SENTRY_DSN) {
+    return;
+  }
+
+  const tags = {};
+  const extra = {};
+
+  // Add Lowdefy-specific context
+  if (context?.pageId) {
+    tags.pageId = context.pageId;
+  }
+
+  if (error?.blockId) {
+    tags.blockId = error.blockId;
+  }
+
+  if (error?.isServiceError !== undefined) {
+    tags.isServiceError = error.isServiceError;
+  }
+
+  // Add config location context
+  if (configLocation) {
+    extra.configLocation = configLocation;
+  }
+
+  // Add config key for reference
+  if (error?.configKey) {
+    extra.configKey = error.configKey;
+  }
+
+  Sentry.captureException(error, {
+    tags,
+    extra,
+  });
+}
+
+export default captureSentryError;

package/lib/server/sentry/initSentry.js

@@ -0,0 +1,52 @@
+/*
+  Copyright 2020-2024 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import * as Sentry from '@sentry/nextjs';
+
+function loadLoggerConfig() {
+  try {
+    // Dynamic require to handle missing file gracefully
+    return require('../../../build/logger.json');
+  } catch {
+    return {};
+  }
+}
+
+function initSentryServer() {
+  // No-op if SENTRY_DSN not set
+  if (!process.env.SENTRY_DSN) {
+    return;
+  }
+
+  const loggerConfig = loadLoggerConfig();
+  const sentryConfig = loggerConfig.sentry || {};
+
+  // No-op if server logging is explicitly disabled
+  if (sentryConfig.server === false) {
+    return;
+  }
+
+  Sentry.init({
+    dsn: process.env.SENTRY_DSN,
+    environment: sentryConfig.environment || process.env.NODE_ENV || 'production',
+    tracesSampleRate: sentryConfig.tracesSampleRate ?? 0.1,
+  });
+
+  console.log('Sentry enabled: server');
+}
+
+export default initSentryServer;
+export { initSentryServer };

package/lib/server/sentry/setSentryUser.js

@@ -0,0 +1,46 @@
+/*
+  Copyright 2020-2024 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import * as Sentry from '@sentry/nextjs';
+
+function setSentryUser({ user, sentryConfig }) {
+  // No-op if Sentry not initialized (DSN not set)
+  if (!process.env.SENTRY_DSN) {
+    return;
+  }
+
+  // No-op if no user
+  if (!user) {
+    Sentry.setUser(null);
+    return;
+  }
+
+  const userFields = sentryConfig?.userFields || ['id', '_id'];
+  const sentryUser = {};
+
+  userFields.forEach((field) => {
+    if (user[field] !== undefined) {
+      sentryUser[field] = user[field];
+    }
+  });
+
+  // Only set user if we have at least one field
+  if (Object.keys(sentryUser).length > 0) {
+    Sentry.setUser(sentryUser);
+  }
+}
+
+export default setSentryUser;

package/lib/server/serverSidePropsWrapper.js

@@ -15,8 +15,8 @@
 */
 
 import path from 'path';
-import crypto from 'crypto';
 import { createApiContext } from '@lowdefy/api';
+import { v4 as uuid } from 'uuid';
 
 import config from '../../build/config.json';
 import createLogger from './log/createLogger.js';
@@ -31,7 +31,7 @@ function serverSidePropsWrapper(handler) {
   return async function wrappedHandler(nextContext) {
     const context = {
       // Important to give absolute path so Next can trace build files
-      rid: crypto.randomUUID(),
+      rid: uuid(),
       buildDirectory: path.join(process.cwd(), 'build'),
       config,
       fileCache,

package/next.config.js

@@ -1,7 +1,8 @@
+const { withSentryConfig } = require('@sentry/nextjs');
 const withLess = require('next-with-less');
 const lowdefyConfig = require('./build/config.json');
 
-module.exports = withLess({
+const nextConfig = withLess({
   basePath: lowdefyConfig.basePath,
   reactStrictMode: true,
   webpack: (config, { isServer }) => {
@@ -27,3 +28,13 @@ module.exports = withLess({
     ignoreDuringBuilds: true,
   },
 });
+
+// Only wrap with Sentry if SENTRY_DSN is configured
+// This enables source map uploads when SENTRY_AUTH_TOKEN is present
+module.exports = process.env.SENTRY_DSN
+  ? withSentryConfig(nextConfig, {
+      // Sentry options
+      silent: true,
+      hideSourceMaps: true,
+    })
+  : nextConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/server",
-  "version": "0.0.0-experimental-20251203205559",
+  "version": "0.0.0-experimental-20260112140412",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -36,18 +36,25 @@
     ".npmrc"
   ],
   "dependencies": {
-    "@lowdefy/actions-core": "0.0.0-experimental-20251203205559",
-    "@lowdefy/api": "0.0.0-experimental-20251203205559",
-    "@lowdefy/block-utils": "0.0.0-experimental-20251203205559",
-    "@lowdefy/blocks-antd": "0.0.0-experimental-20251203205559",
-    "@lowdefy/blocks-basic": "0.0.0-experimental-20251203205559",
-    "@lowdefy/blocks-loaders": "0.0.0-experimental-20251203205559",
-    "@lowdefy/client": "0.0.0-experimental-20251203205559",
-    "@lowdefy/helpers": "0.0.0-experimental-20251203205559",
-    "@lowdefy/layout": "0.0.0-experimental-20251203205559",
-    "@lowdefy/node-utils": "0.0.0-experimental-20251203205559",
-    "@lowdefy/operators-js": "0.0.0-experimental-20251203205559",
-    "@lowdefy/plugin-next-auth": "0.0.0-experimental-20251203205559",
+    "@lowdefy/actions-core": "0.0.0-experimental-20260112140412",
+    "@lowdefy/api": "0.0.0-experimental-20260112140412",
+    "@lowdefy/block-utils": "0.0.0-experimental-20260112140412",
+    "@lowdefy/blocks-antd": "0.0.0-experimental-20260112140412",
+    "@lowdefy/blocks-basic": "0.0.0-experimental-20260112140412",
+    "@lowdefy/blocks-loaders": "0.0.0-experimental-20260112140412",
+    "@lowdefy/blocks-markdown": "0.0.0-experimental-20260112140412",
+    "@lowdefy/client": "0.0.0-experimental-20260112140412",
+    "@lowdefy/connection-axios-http": "0.0.0-experimental-20260112140412",
+    "@lowdefy/connection-mongodb": "0.0.0-experimental-20260112140412",
+    "@lowdefy/helpers": "0.0.0-experimental-20260112140412",
+    "@lowdefy/layout": "0.0.0-experimental-20260112140412",
+    "@lowdefy/node-utils": "0.0.0-experimental-20260112140412",
+    "@lowdefy/operators-js": "0.0.0-experimental-20260112140412",
+    "@lowdefy/operators-nunjucks": "0.0.0-experimental-20260112140412",
+    "@lowdefy/operators-uuid": "0.0.0-experimental-20260112140412",
+    "@lowdefy/plugin-next-auth": "0.0.0-experimental-20260112140412",
+    "@sentry/nextjs": "8.53.0",
+    "uuid": "13.0.0",
     "next": "13.5.4",
     "next-auth": "4.24.5",
     "pino": "8.16.2",
@@ -57,7 +64,7 @@
     "react-icons": "4.12.0"
   },
   "devDependencies": {
-    "@lowdefy/build": "0.0.0-experimental-20251203205559",
+    "@lowdefy/build": "0.0.0-experimental-20260112140412",
     "@next/eslint-plugin-next": "13.5.4",
     "less": "4.2.0",
     "less-loader": "11.1.3",

package/package.original.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/server",
-  "version": "0.0.0-experimental-20251203205559",
+  "version": "0.0.0-experimental-20260112140412",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -46,18 +46,25 @@
     "prepublishOnly": "pnpm build"
   },
   "dependencies": {
-    "@lowdefy/actions-core": "0.0.0-experimental-20251203205559",
-    "@lowdefy/api": "0.0.0-experimental-20251203205559",
-    "@lowdefy/block-utils": "0.0.0-experimental-20251203205559",
-    "@lowdefy/blocks-antd": "0.0.0-experimental-20251203205559",
-    "@lowdefy/blocks-basic": "0.0.0-experimental-20251203205559",
-    "@lowdefy/blocks-loaders": "0.0.0-experimental-20251203205559",
-    "@lowdefy/client": "0.0.0-experimental-20251203205559",
-    "@lowdefy/helpers": "0.0.0-experimental-20251203205559",
-    "@lowdefy/layout": "0.0.0-experimental-20251203205559",
-    "@lowdefy/node-utils": "0.0.0-experimental-20251203205559",
-    "@lowdefy/operators-js": "0.0.0-experimental-20251203205559",
-    "@lowdefy/plugin-next-auth": "0.0.0-experimental-20251203205559",
+    "@lowdefy/actions-core": "0.0.0-experimental-20260112140412",
+    "@lowdefy/api": "0.0.0-experimental-20260112140412",
+    "@lowdefy/block-utils": "0.0.0-experimental-20260112140412",
+    "@lowdefy/blocks-antd": "0.0.0-experimental-20260112140412",
+    "@lowdefy/blocks-basic": "0.0.0-experimental-20260112140412",
+    "@lowdefy/blocks-loaders": "0.0.0-experimental-20260112140412",
+    "@lowdefy/blocks-markdown": "0.0.0-experimental-20260112140412",
+    "@lowdefy/client": "0.0.0-experimental-20260112140412",
+    "@lowdefy/connection-axios-http": "0.0.0-experimental-20260112140412",
+    "@lowdefy/connection-mongodb": "0.0.0-experimental-20260112140412",
+    "@lowdefy/helpers": "0.0.0-experimental-20260112140412",
+    "@lowdefy/layout": "0.0.0-experimental-20260112140412",
+    "@lowdefy/node-utils": "0.0.0-experimental-20260112140412",
+    "@lowdefy/operators-js": "0.0.0-experimental-20260112140412",
+    "@lowdefy/operators-nunjucks": "0.0.0-experimental-20260112140412",
+    "@lowdefy/operators-uuid": "0.0.0-experimental-20260112140412",
+    "@lowdefy/plugin-next-auth": "0.0.0-experimental-20260112140412",
+    "@sentry/nextjs": "8.53.0",
+    "uuid": "13.0.0",
     "next": "13.5.4",
     "next-auth": "4.24.5",
     "pino": "8.16.2",
@@ -67,7 +74,7 @@
     "react-icons": "4.12.0"
   },
   "devDependencies": {
-    "@lowdefy/build": "0.0.0-experimental-20251203205559",
+    "@lowdefy/build": "0.0.0-experimental-20260112140412",
     "@next/eslint-plugin-next": "13.5.4",
     "less": "4.2.0",
     "less-loader": "11.1.3",

package/pages/_app.js

@@ -14,25 +14,46 @@
   limitations under the License.
 */
 
-import React, { useRef } from 'react';
+import React, { useEffect, useRef } from 'react';
 import dynamic from 'next/dynamic';
 
 import { ErrorBoundary } from '@lowdefy/block-utils';
 
 import Auth from '../lib/client/auth/Auth.js';
 import createLogUsage from '../lib/client/createLogUsage.js';
+import initSentryClient from '../lib/client/sentry/initSentryClient.js';
+import setSentryUser from '../lib/client/sentry/setSentryUser.js';
+
+let loggerConfig = {};
+try {
+  loggerConfig = require('../build/logger.json');
+} catch {
+  // logger.json may not exist if Sentry is not configured
+}
 
 // Must be in _app due to next specifications.
 import '../build/plugins/styles.less';
 
+// Initialize Sentry client once on module load
+initSentryClient({
+  sentryDsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
+  sentryConfig: loggerConfig.sentry,
+});
+
 function App({ Component, pageProps: { session, rootConfig, pageConfig } }) {
   const usageDataRef = useRef({});
   const lowdefyRef = useRef({ eventCallback: createLogUsage({ usageDataRef }) });
+
   return (
     <ErrorBoundary fullPage>
       <Auth session={session}>
         {(auth) => {
           usageDataRef.current.user = auth.session?.hashed_id;
+          // Set Sentry user context when auth changes
+          setSentryUser({
+            user: auth.session,
+            sentryConfig: loggerConfig.sentry,
+          });
           return (
             <Component
               auth={auth}

package/pages/api/client-error.js

@@ -0,0 +1,47 @@
+/*
+  Copyright 2020-2024 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import { logClientError } from '@lowdefy/api';
+
+import apiWrapper from '../../lib/server/apiWrapper.js';
+import captureSentryError from '../../lib/server/sentry/captureSentryError.js';
+
+async function handler({ context, req, res }) {
+  if (req.method !== 'POST') {
+    throw new Error('Only POST requests are supported.');
+  }
+  const { configKey, message, name, pageId, timestamp } = req.body;
+  const response = await logClientError(context, {
+    configKey,
+    message,
+    name,
+    pageId,
+    timestamp,
+  });
+
+  // Capture client error to Sentry (no-op if Sentry not configured)
+  captureSentryError({
+    error: new Error(message),
+    context: { ...context, pageId },
+    configLocation: response.source
+      ? { source: response.source, config: response.config, link: response.link }
+      : null,
+  });
+
+  res.status(200).json(response);
+}
+
+export default apiWrapper(handler);