adminforth 2.4.0-next.15 → 2.4.0-next.151

package/dist/spa/src/views/ShowView.vue

@@ -4,7 +4,7 @@
       v-if="!loading"
       v-for="c in coreStore?.resourceOptions?.pageInjections?.show?.beforeBreadcrumbs || []"
       :is="getCustomComponent(c)"
-      :meta="c.meta"
+      :meta="(c as AdminForthComponentDeclarationFull).meta"
       :record="coreStore.record"
       :resource="coreStore.resource"
       :adminUser="coreStore.adminUser"
@@ -15,7 +15,7 @@
           v-for="action in coreStore.resource.options.actions.filter(a => a.showIn?.showButton)" 
           :key="action.id"
           @click="startCustomAction(action.id)"
-          :disabled="actionLoadingStates[action.id]"
+          :disabled="actionLoadingStates[action.id!]"
           class="flex items-center py-1 px-3 text-sm font-medium text-gray-900 focus:outline-none bg-white rounded-default border border-gray-300 hover:bg-gray-100 hover:text-lightPrimary focus:z-10 focus:ring-4 focus:ring-gray-100 dark:focus:ring-gray-700 dark:bg-gray-800 dark:text-gray-400 dark:border-gray-600 dark:hover:text-white dark:hover:bg-gray-700"
         >
           <component 
@@ -28,28 +28,28 @@
       </template>
       <RouterLink v-if="coreStore.resource?.options?.allowedActions?.create"
         :to="{ name: 'resource-create', params: { resourceId: $route.params.resourceId } }"
-        class="flex items-center py-1 px-3 text-sm font-medium text-gray-900 focus:outline-none bg-white rounded border border-gray-300 hover:bg-gray-100 hover:text-lightPrimary focus:z-10 focus:ring-4 focus:ring-gray-100 dark:focus:ring-gray-700 dark:bg-gray-800 dark:text-gray-400 dark:border-gray-600 dark:hover:text-white dark:hover:bg-gray-700 rounded-default"
+        class="af-add-new-button flex items-center py-1 px-3 text-sm font-medium text-lightShowViewButtonText focus:outline-none bg-lightShowViewButtonBackground rounded border border-lightShowViewButtonBorder hover:bg-lightShowViewButtonBackgroundHover hover:text-lightShowViewButtonTextHover focus:z-10 focus:ring-4 focus:ring-lightShowViewButtonFocusRing dark:focus:ring-darkShowViewButtonFocusRing dark:bg-darkShowViewButtonBackground dark:text-darkShowViewButtonText dark:border-darkShowViewButtonBorder dark:hover:text-darkShowViewButtonTextHover dark:hover:bg-darkShowViewButtonBackgroundHover rounded-default gap-1"
       >
-        <IconPlusOutline class="w-4 h-4 me-2"/>
+        <IconPlusOutline class="w-4 h-4"/>
         {{ $t('Add new') }}
       </RouterLink>
 
       <RouterLink v-if="coreStore?.resourceOptions?.allowedActions?.edit" :to="{ name: 'resource-edit', params: { resourceId: $route.params.resourceId, primaryKey: $route.params.primaryKey } }" 
-        class="flex items-center py-1 px-3 text-sm font-medium text-gray-900 focus:outline-none bg-white rounded-default border border-gray-300 hover:bg-gray-100 hover:text-lightPrimary focus:z-10 focus:ring-4 focus:ring-gray-100 dark:focus:ring-gray-700 dark:bg-gray-800 dark:text-gray-400 dark:border-gray-600 dark:hover:text-white dark:hover:bg-gray-700"
+        class="flex items-center af-edit-button py-1 px-3 text-sm font-medium text-lightShowViewButtonText focus:outline-none bg-lightShowViewButtonBackground rounded-default border border-lightShowViewButtonBorder hover:bg-lightShowViewButtonBackgroundHover hover:text-lightShowViewButtonTextHover focus:z-10 focus:ring-4 focus:ring-lightShowViewButtonFocusRing dark:focus:ring-darkShowViewButtonFocusRing dark:bg-darkShowViewButtonBackground dark:text-darkShowViewButtonText dark:border-darkShowViewButtonBorder dark:hover:text-darkShowViewButtonTextHover dark:hover:bg-darkShowViewButtonBackgroundHover gap-1"
       >
         <IconPenSolid class="w-4 h-4" />
         {{ $t('Edit') }}
       </RouterLink>
 
       <button v-if="coreStore?.resourceOptions?.allowedActions?.delete"  @click="deleteRecord"
-        class="flex items-center py-1 px-3 text-sm font-medium rounded-default text-red-600 focus:outline-none bg-white  border border-gray-300 hover:bg-gray-100 hover:text-red-700 focus:z-10 focus:ring-4 focus:ring-gray-100 dark:focus:ring-gray-700 dark:bg-gray-800 dark:text-red-500 dark:border-gray-600 dark:hover:text-white dark:hover:bg-gray-700"
+        class="flex items-center af-delete-button py-1 px-3 text-sm font-medium rounded-default text-red-600 focus:outline-none bg-lightShowViewButtonBackground  border border-lightShowViewButtonBorder hover:bg-lightShowViewButtonBackgroundHover hover:text-red-700 focus:z-10 focus:ring-4 focus:ring-lightShowViewButtonFocusRing dark:focus:ring-darkShowViewButtonFocusRing dark:bg-darkShowViewButtonBackground dark:text-red-500 dark:border-darkShowViewButtonBorder dark:hover:text-darkShowViewButtonTextHover dark:hover:bg-darkShowViewButtonBackgroundHover gap-1"
       >
         <IconTrashBinSolid class="w-4 h-4" />
         {{ $t('Delete') }}
       </button>
 
       <ThreeDotsMenu 
-        :threeDotsDropdownItems="coreStore.resourceOptions?.pageInjections?.show?.threeDotsDropdownItems"
+        :threeDotsDropdownItems="(coreStore.resourceOptions?.pageInjections?.show?.threeDotsDropdownItems as [])"
         :customActions="customActions"
       ></ThreeDotsMenu>
     </BreadcrumbsWithButtons>
@@ -57,7 +57,7 @@
     <component 
       v-for="c in coreStore?.resourceOptions?.pageInjections?.show?.afterBreadcrumbs || []"
       :is="getCustomComponent(c)"
-      :meta="c.meta"
+      :meta="(c as AdminForthComponentDeclarationFull).meta"
       :record="coreStore.record"
       :resource="coreStore.resource"
       :adminUser="coreStore.adminUser"
@@ -76,11 +76,11 @@
       v-else-if="coreStore.record"
       class="relative w-full flex flex-col gap-4"
     >
-    <div v-if="!groups.length && allColumns.length">
+    <div v-if="!groups.length && allColumns?.length">
       <ShowTable
-        :columns="allColumns"
         :resource="coreStore.resource"
         :record="coreStore.record"
+        :columns="allColumns as Array<{ name: string; label?: string; components?: any }>"
       />
     </div>
     <template v-else> 
@@ -93,12 +93,12 @@
           :record="coreStore.record"
         />
       </template>
-      <template v-if="otherColumns.length > 0">
+      <template v-if="otherColumns && otherColumns.length > 0">
         <ShowTable
-          :columns="otherColumns"
           groupName="Other Fields"
           :resource="coreStore.resource"
           :record="coreStore.record"
+          :columns="otherColumns as Array<{ name: string; label?: string; components?: any }>"
         />
       </template>
     </template>
@@ -112,8 +112,7 @@
       v-if="!loading"
       v-for="c in coreStore?.resourceOptions?.pageInjections?.show?.bottom || []"
       :is="getCustomComponent(c)"
-      :meta="c.meta"
-      :column="column"
+      :meta="(c as AdminForthComponentDeclarationFull).meta"
       :record="coreStore.record"
       :resource="coreStore.resource"
       :adminUser="coreStore.adminUser"
@@ -140,6 +139,7 @@ import ShowTable from '@/components/ShowTable.vue';
 import adminforth from "@/adminforth";
 import { useI18n } from 'vue-i18n';
 import { getIcon } from '@/utils';
+import { type AdminForthComponentDeclarationFull, type AdminForthResourceColumnCommon, type FieldGroup } from '@/types/Common.js';
 
 const route = useRoute();
 const router = useRouter();
@@ -147,62 +147,65 @@ const loading = ref(true);
 const { t } = useI18n();
 const coreStore = useCoreStore();
 
-const actionLoadingStates = ref({});
+const actionLoadingStates = ref<Record<string, boolean>>({});
 
 const customActions = computed(() => {
-  return coreStore.resource?.options?.actions?.filter(a => a.showIn?.showThreeDotsMenu) || [];
+  return coreStore.resource?.options?.actions?.filter((a: any) => a.showIn?.showThreeDotsMenu) || [];
 });
 
 onMounted(async () => {
   loading.value = true;
   await coreStore.fetchResourceFull({
-    resourceId: route.params.resourceId
+    resourceId: route.params.resourceId as string,
   });
   initThreeDotsDropdown();
   await coreStore.fetchRecord({
-    resourceId: route.params.resourceId, 
-    primaryKey: route.params.primaryKey,
+    resourceId: route.params.resourceId as string, 
+    primaryKey: route.params.primaryKey as string,
     source: 'show',
   });
-  checkAcessByAllowedActions(coreStore.resourceOptions.allowedActions,'show');
+  if(coreStore.resourceOptions){
+    checkAcessByAllowedActions(coreStore.resourceOptions.allowedActions,'show');
+  }
   loading.value = false;
 });
 
 const groups = computed(() => {
   let fieldGroupType;
-  if (coreStore.resource.options?.showFieldGroups) {
-    fieldGroupType = coreStore.resource.options.showFieldGroups;
-  } else if (coreStore.resource.options?.showFieldGroups === null) {
-    fieldGroupType = [];
-  } else {
-    fieldGroupType = coreStore.resource.options?.fieldGroups;
+  if (coreStore.resource) {
+    if (coreStore.resource.options?.showFieldGroups) {
+      fieldGroupType = coreStore.resource.options.showFieldGroups;
+    } else if (coreStore.resource.options?.showFieldGroups === null) {
+      fieldGroupType = [];
+    } else {
+      fieldGroupType = coreStore.resource.options?.fieldGroups;
+    }
   }
+  const activeGroups: typeof fieldGroupType | [] = fieldGroupType ?? [];
 
-  const activeGroups = fieldGroupType ?? [];
-
-  return activeGroups.map(group => ({
+  return activeGroups.map((group: FieldGroup) => ({
     ...group,
-    columns: coreStore.resource.columns.filter(
-      col => group.columns.includes(col.name) && col.showIn.show
+    columns: coreStore.resource?.columns.filter(
+      col => group.columns.includes(col.name) && col.showIn?.show
     ),
   }));
 });
 
 const allColumns = computed(() => {
-  return coreStore.resource.columns.filter(col => col.showIn.show);
+  return coreStore.resource?.columns.filter(col => col.showIn?.show);
 });
 
 const otherColumns = computed(() => {
   const groupedColumnNames = new Set(
-    groups.value.flatMap(group => group.columns.map(col => col.name))
+    groups.value.flatMap(group => group.columns.map((col: AdminForthResourceColumnCommon) => col.name))
   );
 
-  return coreStore.resource.columns.filter(
-    col => !groupedColumnNames.has(col.name) && col.showIn.show
+  return coreStore.resource?.columns.filter(
+    col => !groupedColumnNames.has(col.name) && col.showIn?.show
   );
 });
 
-async function deleteRecord(row) {
+async function deleteRecord() {
   const data = await adminforth.confirm({
     message: t('Are you sure you want to delete this item?'),
     yes: t('Delete'),
@@ -231,7 +234,7 @@ async function deleteRecord(row) {
     
 }
 
-async function startCustomAction(actionId) {  
+async function startCustomAction(actionId: string) {  
   actionLoadingStates.value[actionId] = true;
 
   const data = await callAdminForthApi({
@@ -263,8 +266,8 @@ async function startCustomAction(actionId) {
   
   if (data?.ok) {
     await coreStore.fetchRecord({
-      resourceId: route.params.resourceId, 
-      primaryKey: route.params.primaryKey,
+      resourceId: route.params.resourceId as string, 
+      primaryKey: route.params.primaryKey as string,
       source: 'show',
     });
 
@@ -281,4 +284,21 @@ async function startCustomAction(actionId) {
   }
 }
 
+adminforth.show.refresh = () => {
+  (async () => {
+    try {
+      loading.value = true;
+      await coreStore.fetchRecord({
+        resourceId: String(route.params.resourceId),
+        primaryKey: String(route.params.primaryKey),
+        source: 'show',
+      });
+    } catch (e) {
+      showErrorTost((e as Error).message);
+    } finally {
+      loading.value = false;
+    }
+  })();
+}
+
 </script>

package/dist/spa/src/websocket.ts

@@ -1,8 +1,13 @@
 
 const subscriptions: { [topic: string]: ((data: any) => void)[] } = {};
+
+interface ExtendedWebSocket extends WebSocket {
+  connected?: boolean;
+}
+
 const state: {
   status: 'connecting' | 'connected' | 'disconnected';
-  ws: WebSocket | null;
+  ws: ExtendedWebSocket | null;
 } = {
   status: 'connecting',
   ws: null

package/dist/spa/tsconfig.app.json

@@ -1,6 +1,6 @@
 {
   "extends": "@vue/tsconfig/tsconfig.dom.json",
-  "include": ["env.d.ts", "src/**/*", "src/**/*.vue"],
+  "include": ["env.d.ts", "src/**/*", "src/**/*.vue", "src/**/*.d.ts"],
   "exclude": ["src/**/__tests__/*"],
   "compilerOptions": {
     "composite": true,

package/dist/spa/vite.config.ts

@@ -1,18 +1,60 @@
 import { fileURLToPath, URL } from 'node:url'
-
 import { defineConfig } from 'vite'
 import vue from '@vitejs/plugin-vue'
 import portfinder from 'portfinder';
+import { Plugin } from 'vite';
+import tailwindcss from 'tailwindcss';
+
 
 /**
  * Find the next available port after a specified port.
  * @param {number} startPort - The starting port to check.
  * @returns {Promise<number>} - A promise that resolves with the next available port.
  */
-async function getNextAvailablePort(startPort) {
+async function getNextAvailablePort(startPort: number | undefined) {
   return await portfinder.getPortPromise({ port: startPort });
 };
 
+function ignoreTailwindErrors(): Plugin {
+  return {
+    name: 'ignore-tailwind-errors',
+    configureServer(server) {
+      server.middlewares.use((req, res, next) => {
+        const originalWrite = res.write;
+        res.write = function(chunk) {
+          if (typeof chunk === 'string' && chunk.includes('tailwind')) {
+            return true;
+          }
+          return originalWrite.call(this, chunk);
+        };
+        next();
+      });
+    },
+    config(config, { command }) {
+      if (command === 'build') {
+        // Override PostCSS config for build
+        config.css = config.css || {};
+        config.css.postcss = {
+          plugins: [
+            {
+              postcssPlugin: 'ignore-tailwind-errors',
+              Once(root, helpers) {
+                try {
+                  return tailwindcss()(root, helpers);
+                } catch (error: any) {
+                  console.warn('TailwindCSS warning ignored:', error.message);
+                  return;
+                }
+              }
+            }
+          ]
+        };
+      }
+    }
+  };
+}
+
+
 const appPort = await getNextAvailablePort(5173);
 const hmrPort = await getNextAvailablePort(5273);
 console.log(`SPA port: ${appPort}. HMR port: ${hmrPort}`);
@@ -27,6 +69,7 @@ export default defineConfig({
     },
   },
   plugins: [
+    //ignoreTailwindErrors(),
     vue(),
   ],
   resolve: {

package/dist/types/Back.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="node" resolution-mode="require"/>
-import type { Express } from 'express';
+import type { Express, Request } from 'express';
 import type { Writable } from 'stream';
-import { ActionCheckSource, AdminForthFilterOperators, AdminForthSortDirections, AllowedActionsEnum, type AdminForthComponentDeclaration, type AdminUser, type AllowedActionsResolved, type AdminForthBulkActionCommon, type AdminForthForeignResourceCommon, type AdminForthResourceColumnCommon, AdminForthResourceInputCommon, AdminForthComponentDeclarationFull, AdminForthConfigMenuItem, AnnouncementBadgeResponse, AdminForthResourcePages, AdminForthResourceColumnInputCommon } from './Common.js';
+import { ActionCheckSource, AdminForthFilterOperators, AdminForthSortDirections, AllowedActionsEnum, type AdminForthComponentDeclaration, type AdminUser, type AllowedActionsResolved, type AdminForthBulkActionCommon, type AdminForthForeignResourceCommon, type AdminForthResourceColumnCommon, type AdminForthResourceInputCommon, type AdminForthComponentDeclarationFull, type AdminForthConfigMenuItem, type AnnouncementBadgeResponse, AdminForthResourcePages, type AdminForthResourceColumnInputCommon } from './Common.js';
 export interface ICodeInjector {
     srcFoldersToSync: Object;
     allComponentNames: Object;
@@ -62,23 +62,34 @@ export interface IExpressHttpServer extends IHttpServer {
      * Adds adminUser to request object if user is authorized. Drops request with 401 status if user is not authorized.
      * @param callable : Function which will be called if user is authorized.
      *
-     * Example:
      *
+     * @example
      * ```ts
-     * expressApp.get('/myApi', authorize((req, res) => \{
+     * expressApp.get('/myApi', authorize((req, res) => {
      *  console.log('User is authorized', req.adminUser);
-     *  res.json(\{ message: 'Hello World' \});
-     * \}));
-     * ``
+     *  res.json({ message: 'Hello World' });
+     * }));
+     * ```
      *
      */
     authorize(callable: Function): void;
 }
+export interface ITranslateFunction {
+    (msg: string, category: string, params: any, pluralizationNumber?: number): Promise<string>;
+}
+export interface IAdminUserExpressRequest extends Omit<Request, 'protocol' | 'param' | 'unshift'> {
+    adminUser: AdminUser;
+}
+export interface ITranslateExpressRequest extends Omit<Request, 'protocol' | 'param' | 'unshift'> {
+    tr: ITranslateFunction;
+}
 export interface IAdminForthSingleFilter {
     field?: string;
     operator?: AdminForthFilterOperators.EQ | AdminForthFilterOperators.NE | AdminForthFilterOperators.GT | AdminForthFilterOperators.LT | AdminForthFilterOperators.GTE | AdminForthFilterOperators.LTE | AdminForthFilterOperators.LIKE | AdminForthFilterOperators.ILIKE | AdminForthFilterOperators.IN | AdminForthFilterOperators.NIN;
     value?: any;
+    rightField?: string;
     insecureRawSQL?: string;
+    insecureRawNoSQL?: any;
 }
 export interface IAdminForthAndOrFilter {
     operator: AdminForthFilterOperators.AND | AdminForthFilterOperators.OR;
@@ -315,6 +326,7 @@ export interface IAdminForth {
     }): Promise<{
         error?: string;
         createdRecord?: any;
+        newRecordId?: any;
     }>;
     updateResourceRecord(params: {
         resource: AdminForthResource;
@@ -451,6 +463,7 @@ export type BeforeDataSourceRequestFunction = (params: {
 }) => Promise<{
     ok: boolean;
     error?: string;
+    newRecordId?: string;
 }>;
 /**
  * Modify response to change how data is returned after fetching from database.
@@ -509,7 +522,7 @@ export type BeforeEditSaveFunction = (params: {
     extra?: HttpExtra;
 }) => Promise<{
     ok: boolean;
-    error?: string;
+    error?: string | null;
 }>;
 export type BeforeCreateSaveFunction = (params: {
     resource: AdminForthResource;
@@ -519,7 +532,8 @@ export type BeforeCreateSaveFunction = (params: {
     extra?: HttpExtra;
 }) => Promise<{
     ok: boolean;
-    error?: string;
+    error?: string | null;
+    newRecordId?: string;
 }>;
 export type AfterCreateSaveFunction = (params: {
     resource: AdminForthResource;
@@ -602,11 +616,20 @@ interface AdminForthInputConfigCustomization {
      * Your app name
      */
     brandName?: string;
+    /**
+     * Whether to use single theme for the app
+     */
+    singleTheme?: 'light' | 'dark';
     /**
      * Whether to show brand name in sidebar
      * default is true
      */
     showBrandNameInSidebar?: boolean;
+    /**
+     * Whether to show brand logo in sidebar
+     * default is true
+     */
+    showBrandLogoInSidebar?: boolean;
     /**
      * Path to your app logo
      *
@@ -727,8 +750,17 @@ interface AdminForthInputConfigCustomization {
         userMenu?: AdminForthComponentDeclaration | Array<AdminForthComponentDeclaration>;
         header?: AdminForthComponentDeclaration | Array<AdminForthComponentDeclaration>;
         sidebar?: AdminForthComponentDeclaration | Array<AdminForthComponentDeclaration>;
+        sidebarTop?: AdminForthComponentDeclaration | Array<AdminForthComponentDeclaration>;
         everyPageBottom?: AdminForthComponentDeclaration | Array<AdminForthComponentDeclaration>;
     };
+    /**
+    * Allows adding custom elements (e.g., <link>, <script>, <meta>) to the <head> of the HTML document.
+    * Each item must include a tag name and a set of attributes.
+    */
+    customHeadItems?: {
+        tagName: string;
+        attributes: Record<string, string | boolean>;
+    }[];
 }
 export interface AdminForthActionInput {
     name: string;
@@ -885,6 +917,12 @@ export interface AdminForthInputConfig {
          * Default: '1/2'
          */
         loginBackgroundPosition?: 'over' | '1/2' | '1/3' | '2/3' | '3/4' | '2/5' | '3/5';
+        /**
+         * If true, background blend mode will be removed from login background image when position is 'over'
+         *
+         * Default: false
+         */
+        removeBackgroundBlendMode?: boolean;
         /**
          * Function or functions  which will be called before user try to login.
          * Each function will resive User object as an argument
@@ -903,7 +941,7 @@ export interface AdminForthInputConfig {
         /**
          * Any prompt to show users on login. Supports HTML.
          */
-        loginPromptHTML?: string;
+        loginPromptHTML?: string | (() => string | void | undefined | Promise<string | void | undefined>) | undefined;
         /**
          * Remember me days for "Remember Me" checkbox on login page.
          * If not set or set to null/0/undefined, "Remember Me" checkbox will not be displayed.
@@ -991,8 +1029,13 @@ export interface AdminForthConfigCustomization extends Omit<AdminForthInputConfi
         userMenu: Array<AdminForthComponentDeclarationFull>;
         header: Array<AdminForthComponentDeclarationFull>;
         sidebar: Array<AdminForthComponentDeclarationFull>;
+        sidebarTop: Array<AdminForthComponentDeclarationFull>;
         everyPageBottom: Array<AdminForthComponentDeclarationFull>;
     };
+    customHeadItems?: {
+        tagName: string;
+        attributes: Record<string, string | boolean>;
+    }[];
 }
 export interface AdminForthConfig extends Omit<AdminForthInputConfig, 'customization' | 'resources'> {
     baseUrl: string;
@@ -1011,6 +1054,11 @@ export declare class Filters {
     static IN(field: string, value: any): IAdminForthSingleFilter;
     static NOT_IN(field: string, value: any): IAdminForthSingleFilter;
     static LIKE(field: string, value: any): IAdminForthSingleFilter;
+    static ILIKE(field: string, value: any): IAdminForthSingleFilter;
+    static GT_FIELD(leftField: string, rightField: string): IAdminForthSingleFilter;
+    static GTE_FIELD(leftField: string, rightField: string): IAdminForthSingleFilter;
+    static LT_FIELD(leftField: string, rightField: string): IAdminForthSingleFilter;
+    static LTE_FIELD(leftField: string, rightField: string): IAdminForthSingleFilter;
     static AND(...args: (IAdminForthSingleFilter | IAdminForthAndOrFilter | Array<IAdminForthSingleFilter | IAdminForthAndOrFilter>)[]): IAdminForthAndOrFilter;
     static OR(...args: (IAdminForthSingleFilter | IAdminForthAndOrFilter | Array<IAdminForthSingleFilter | IAdminForthAndOrFilter>)[]): IAdminForthAndOrFilter;
 }
@@ -1166,9 +1214,13 @@ export interface AdminForthResource extends Omit<AdminForthResourceInput, 'optio
         };
         create?: {
             /**
+             * Should return `ok: true` to continue saving pipeline and allow creating record in database, and `ok: false` to interrupt pipeline and prevent record creation.
+             * If you need to show error on UI, set `error: \<error message\>` in response.
+             *
              * Typical use-cases:
-             * - Validate record before saving to database and interrupt execution if validation failed (`allowedActions.create` should be preferred in most cases)
-             * - fill-in adminUser as creator of record
+             * - Create record by custom code (return `{ ok: false, newRecordId: <id of created record from custom code> }`)
+             * - Validate record before saving to database and interrupt execution if validation failed (return `{ ok: false, error: <validation error> }`), though `allowedActions.create` should be preferred in most cases
+             * - fill-in adminUser as creator of record (set `record.<some field> = x; return \{ ok: true \}`)
              * - Attach additional data to record before saving to database (mostly fillOnCreate should be used instead)
              */
             beforeSave?: Array<BeforeCreateSaveFunction>;
@@ -1306,13 +1358,22 @@ export type ShowInInput = ShowInModernInput | ShowInLegacyInput;
 export type ShowIn = {
     [key in AdminForthResourcePages]: AllowedActionValue;
 };
-export interface AdminForthResourceColumnInput extends Omit<AdminForthResourceColumnInputCommon, 'showIn'> {
+export type BackendOnlyInput = boolean | ((p: {
+    adminUser: AdminUser;
+    resource: AdminForthResource;
+    meta: any;
+    source: ActionCheckSource;
+    adminforth: IAdminForth;
+}) => boolean | Promise<boolean>);
+export interface AdminForthResourceColumnInput extends Omit<AdminForthResourceColumnInputCommon, 'showIn' | 'backendOnly'> {
     showIn?: ShowInInput;
     foreignResource?: AdminForthForeignResource;
+    backendOnly?: BackendOnlyInput;
 }
-export interface AdminForthResourceColumn extends Omit<AdminForthResourceColumnCommon, 'showIn'> {
+export interface AdminForthResourceColumn extends Omit<AdminForthResourceColumnCommon, 'showIn' | 'backendOnly'> {
     showIn?: ShowIn;
     foreignResource?: AdminForthForeignResource;
+    backendOnly?: BackendOnlyInput;
 }
 export interface IWebSocketClient {
     id: string;