Merge branch 'main' of github.com:devforth/adminforth

Author: NoOne7135

adminforth/dataConnectors/baseConnector.ts

@@ -471,7 +471,13 @@ export default class AdminForthBaseConnector implements IAdminForthDataSourceCon
         return this.setFieldValue(field, null);
       }
       if (typeof value !== 'boolean') {
-        throw new Error(`Value is not a boolean. Field ${field.name} with type is ${field.type}, but got value: ${value} with type ${typeof value}`);
+        const errorMessage = `Value is not a boolean. Field ${field.name} with type is ${field.type}, but got value: ${value} with type ${typeof value}`;
+        if (value !== 1 && value !== 0) {
+          throw new Error(errorMessage);
+        } else {
+          afLogger.warn(errorMessage);
+          afLogger.warn(`Ignore this warn, if you are using an sqlite database`);
+        }
       }
       return this.setFieldValue(field, value);
     }

adminforth/documentation/docs/tutorial/05-deploy.md

@@ -22,6 +22,8 @@ You can use it to build your AdminForth application in Docker container.
 
 ## Building the image
 
+> Make sure that you have database url in your .env.prod file
+
 Now you can build your image:
 
 ```bash

adminforth/documentation/docs/tutorial/08-UsageOfLogger.md

@@ -70,3 +70,27 @@ AF_LOG_SINGLE_LINE=true pnpm start
 
 Accepted truthy values are `true` and `1`. When unset, logs use the default multi-line pretty format.
 
+## Catching unhandled API handler errors
+
+When an unhandled error is thrown inside an AdminForth API endpoint handler (built-in or custom), AdminForth logs the
+error and responds with `500 Internal server error`. If you also want to forward these errors somewhere — for example
+to report them to an external error-tracking service like [Sentry](https://sentry.io/), or to do your own custom
+logging — set the `expressErrorCallback` option in your AdminForth config:
+
+```ts
+import AdminForth from 'adminforth';
+import * as Sentry from '@sentry/node';
+
+export const admin = new AdminForth({
+  // ...rest of your config
+  expressErrorCallback: ({ error, extra, adminforth }) => {
+    Sentry.captureException(error, {
+      extra: {
+        requestUrl: extra.requestUrl,
+        query: extra.query,
+      },
+    });
+  },
+});
+```
+

adminforth/documentation/docs/tutorial/09-Plugins/Bulk-vision-1.png

@@ -1252,8 +1252,18 @@ class CodeInjector implements ICodeInjector {
         }
       });
       devServer.stderr.on('data', (data) => {
+        const text = data.toString();
+        // pnpm/npm echo the script command they are about to run (e.g. "$ vite") to stderr,
+        // and emit empty lines. These are not errors, so don't log them as such.
+        const meaningful = stripAnsiCodes(text)
+          .split('\n')
+          .filter((line: string) => line.trim() && !line.trim().startsWith('$ '));
+        if (meaningful.length === 0) {
+          process.env.HEAVY_DEBUG && console.log(`[AdminForth SPA]:`, text);
+          return;
+        }
         afLogger.error(`[AdminForth SPA ERROR]:`);
-        afLogger.error(data.toString());
+        afLogger.error(text);
       });
 
     }

adminforth/documentation/docs/tutorial/09-Plugins/Bulk-vision-2.png

@@ -6,6 +6,8 @@ import crypto from 'crypto';
 import { AdminForthConfig, AdminForthResource, AdminForthResourceColumnInputCommon,Filters, IAdminForth, Predicate } from '../index.js';
 import { RateLimiterMemory, RateLimiterAbstract } from "rate-limiter-flexible";
 import { PERIOD_UNITS, type PeriodString, type PeriodUnit } from '../types/Back.js';
+import { z } from "zod";
+
 // @ts-ignore-next-line
 
 
@@ -644,4 +646,21 @@ export function applyRegexValidation(value, validation) {
   ╚${horizontal}╝
   ${RESET}
 `;
-  }
+  }
+
+
+export function parseBody<T>(
+  schema: z.ZodType<T>,
+  body: unknown,
+  response: { setStatus: (code: number, message: string) => void },
+): { ok: true; data: T } | { ok: false; error: { error: string; details: unknown } } {
+  const parsed = schema.safeParse(body ?? {});
+  if (!parsed.success) {
+    response.setStatus(400, '');
+    return {
+      ok: false,
+      error: { error: 'Request body validation failed', details: parsed.error.issues },
+    };
+  }
+  return { ok: true, data: parsed.data };
+}