adminforth 2.27.0-next.6 → 2.27.0-next.61

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

@@ -2,10 +2,11 @@
   <div class="relative flex flex-col max-w-full w-full">
     <Teleport to="body">
       <Filters
-        :columns="coreStore.resource?.columns"
+        :columns="coreStore.resource?.columns as AdminForthResourceColumnCommon[] || []"
         :columnsMinMax="columnsMinMax" 
         :show="filtersShow"
         @hide="filtersShow = false"
+        :filtersStore="filtersStore"
       />
     </Teleport>
 
@@ -69,19 +70,10 @@
             v-if="action.icon && !bulkActionLoadingStates[action.id!]"
             :is="getIcon(action.icon)"
             class="w-5 h-5 transition duration-75 group-hover:text-gray-900 dark:group-hover:text-white"></component>
-          <div v-if="bulkActionLoadingStates[action.id!]">
-            <svg 
-              aria-hidden="true" 
-              class="w-5 h-5 animate-spin text-gray-200 dark:text-gray-500 fill-gray-500 dark:fill-gray-300" 
-              viewBox="0 0 100 101" 
-              fill="none" 
-              xmlns="http://www.w3.org/2000/svg"
-            >
-              <path d="M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z" fill="currentColor"/>
-              <path d="M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z" fill="currentFill"/>
-            </svg>
-            <span class="sr-only">Loading...</span>
-          </div>
+            <Spinner
+              v-if="bulkActionLoadingStates[action.id!]"
+              class="w-5 h-5 text-gray-200 dark:text-gray-500 fill-gray-500 dark:fill-gray-300"
+            />
           {{ `${action.label} (${checkboxes.length})` }}
           <div v-if="action.badge" class="text-white bg-gradient-to-r from-purple-500 
           via-purple-600 to-purple-700 hover:bg-gradient-to-br focus:ring-4 focus:outline-none
@@ -98,25 +90,22 @@
         <button
           :key="action.id"
           @click="startCustomBulkActionInner(action.id!)"
-          class="flex gap-1 items-center py-1 px-3 text-sm font-medium text-lightListViewButtonText focus:outline-none bg-lightListViewButtonBackground rounded-default border border-lightListViewButtonBorder hover:bg-lightListViewButtonBackgroundHover hover:text-lightListViewButtonTextHover focus:z-10 focus:ring-4 focus:ring-lightListViewButtonFocusRing dark:focus:ring-darkListViewButtonFocusRing dark:bg-darkListViewButtonBackground dark:text-darkListViewButtonText dark:border-darkListViewButtonBorder dark:hover:text-darkListViewButtonTextHover dark:hover:bg-darkListViewButtonBackgroundHover"
+          class="flex gap-1 items-center py-1 px-3 text-sm font-medium text-lightListViewButtonText
+            focus:outline-none bg-lightListViewButtonBackground rounded-default border h-[34px]
+            border-lightListViewButtonBorder hover:bg-lightListViewButtonBackgroundHover 
+            hover:text-lightListViewButtonTextHover focus:z-10 focus:ring-4 af-button-shadow
+            focus:ring-lightListViewButtonFocusRing dark:focus:ring-darkListViewButtonFocusRing 
+            dark:bg-darkListViewButtonBackground dark:text-darkListViewButtonText dark:border-darkListViewButtonBorder 
+            dark:hover:text-darkListViewButtonTextHover dark:hover:bg-darkListViewButtonBackgroundHover"
         >
           <component
             v-if="action.icon && !customActionLoadingStates[action.id!]"
             :is="getIcon(action.icon)"
             class="w-5 h-5 transition duration-75 group-hover:text-gray-900 dark:group-hover:text-white"></component>
-            <div v-if="customActionLoadingStates[action.id!]">
-              <svg 
-                aria-hidden="true" 
-                class="w-5 h-5 animate-spin text-gray-200 dark:text-gray-500 fill-gray-500 dark:fill-gray-300" 
-                viewBox="0 0 100 101" 
-                fill="none" 
-                xmlns="http://www.w3.org/2000/svg"
-              >
-                <path d="M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z" fill="currentColor"/>
-                <path d="M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z" fill="currentFill"/>
-              </svg>
-              <span class="sr-only">Loading...</span>
-            </div>
+            <Spinner
+              v-if="customActionLoadingStates[action.id!]"
+              class="w-5 h-5 text-gray-200 dark:text-gray-500 fill-gray-500 dark:fill-gray-300"
+            />
             {{ `${action.name} (${checkboxes.length})` }}
         </button>
       </div>
@@ -233,8 +222,8 @@ import { computed, onMounted, onUnmounted, ref, watch, type Ref } from 'vue';
 import { useRoute } from 'vue-router';
 import { getCustomComponent, initThreeDotsDropdown, getList, startBulkAction } from '@/utils';
 import ThreeDotsMenu from '@/components/ThreeDotsMenu.vue';
-import { Tooltip } from '@/afcl'
-import type { AdminForthComponentDeclaration, AdminForthComponentDeclarationFull } from '@/types/Common';
+import { Tooltip, Spinner } from '@/afcl'
+import type { AdminForthComponentDeclaration, AdminForthComponentDeclarationFull, AdminForthFilterOperators, AdminForthResourceColumnCommon } from '@/types/Common';
 
 
 import {
@@ -344,6 +333,7 @@ async function startCustomBulkActionInner(actionId: string | number) {
     resourceId: route.params.resourceId as string,
     recordIds: checkboxes.value,
     confirmMessage: action?.bulkConfirmationMessage,
+    resource: coreStore.resource!,
     setLoadingState: (loading: boolean) => {
       customActionLoadingStates.value[actionId] = loading;
     },
@@ -354,7 +344,7 @@ async function startCustomBulkActionInner(actionId: string | number) {
       const successResults = results.filter(r => r?.successMessage);
       if (successResults.length > 0) {
         alert({
-          message: action?.bulkSuccessMessage || `${successResults.length} out of ${results.length} items processed successfully`,
+          message: action?.bulkSuccessMessage ? action.bulkSuccessMessage : action?.hasBulkHandler ? successResults[0].successMessage : `${successResults.length} out of ${results.length} items processed successfully`,
           variant: 'success'
         });
       }
@@ -413,7 +403,7 @@ async function init() {
     const [_, field, operator] = k.split('__');
     return {
       field,
-      operator,
+      operator: operator as AdminForthFilterOperators,
       value: JSON.parse((route.query[k] as string))
     }
   });

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

@@ -12,7 +12,7 @@
     <BreadcrumbsWithButtons>
       <template v-if="coreStore.resource?.options?.actions">
 
-        <template  v-for="action in coreStore.resource.options.actions.filter(a => a.showIn?.showButton)" :key="action.id">
+        <div class="flex gap-1" v-for="action in coreStore.resource.options.actions.filter(a => a.showIn?.showButton)" :key="action.id">
           <component
             :is="action?.customComponent ? getCustomComponent(formatComponent(action.customComponent)) : CallActionWrapper"
             :meta="action.customComponent ? formatComponent(action.customComponent).meta : undefined"
@@ -29,23 +29,14 @@
                 :is="getIcon(action.icon)" 
                 class="w-4 h-4 me-2 text-lightPrimary dark:text-darkPrimary"
               />
-              <div v-if="actionLoadingStates[action.id!]" class="me-2">
-                <svg 
-                  aria-hidden="true" 
-                  class="w-4 h-4 animate-spin text-gray-200 dark:text-gray-500 fill-gray-500 dark:fill-gray-300" 
-                  viewBox="0 0 100 101" 
-                  fill="none" 
-                  xmlns="http://www.w3.org/2000/svg"
-                >
-                  <path d="M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z" fill="currentColor"/>
-                  <path d="M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z" fill="currentFill"/>
-                </svg>
-                <span class="sr-only">Loading...</span>
-              </div>
+              <Spinner
+                v-if="actionLoadingStates[action.id!]"
+                class="w-5 h-5 me-2 text-gray-200 dark:text-gray-500 fill-gray-500 dark:fill-gray-300"
+              />
               {{ action.name }}
             </button>
           </component>
-        </template>
+        </div>
       </template>
       <RouterLink v-if="coreStore.resource?.options?.allowedActions?.create"
         :to="{ name: 'resource-create', params: { resourceId: $route.params.resourceId } }"
@@ -85,14 +76,52 @@
       :adminUser="coreStore.adminUser"
     />
 
-    <div v-if="loading" role="status" class="max-w-sm animate-pulse">
-        <div class="h-2.5 bg-gray-200 rounded-full dark:bg-gray-700 w-48 mb-4"></div>
-        <div class="h-2 bg-gray-200 rounded-full dark:bg-gray-700 max-w-[360px] mb-2.5"></div>
-        <div class="h-2 bg-gray-200 rounded-full dark:bg-gray-700 mb-2.5"></div>
-        <div class="h-2 bg-gray-200 rounded-full dark:bg-gray-700 max-w-[330px] mb-2.5"></div>
-        <div class="h-2 bg-gray-200 rounded-full dark:bg-gray-700 max-w-[300px] mb-2.5"></div>
-        <div class="h-2 bg-gray-200 rounded-full dark:bg-gray-700 max-w-[360px]"></div>
-        <span class="sr-only">{{ $t('Loading...') }}</span>
+    <div 
+      v-if="loading" 
+      role="status" 
+      class="animate-pulse overflow-x-auto shadow-resourseFormShadow dark:shadow-darkResourseFormShadow rounded-lg overflow-hidden border border-lightShowTableBodyBorder dark:border-darkShowTableBodyBorder"
+    >
+      <div 
+        v-if="groups && groups.length > 0" 
+        class="text-md font-semibold px-6 py-3 flex flex-1 items-center bg-lightShowTableHeadingBackground dark:bg-darkShowTableHeadingBackground dark:text-darkShowTableHeadingText border-b border-lightShowTableBodyBorder dark:border-darkShowTableBodyBorder"
+      >
+        <div class="h-4 bg-gray-300 dark:bg-gray-600 rounded-full w-32"></div>
+      </div>
+
+      <table class="w-full text-sm text-left table-fixed border-collapse">
+        <thead class="bg-lightShowTableUnderHeadingBackground dark:bg-darkShowTableUnderHeadingBackground block md:table-row-group">
+          <tr class="block md:table-row">
+            <th scope="col" class="px-6 py-3 text-xs uppercase hidden md:w-52 md:table-cell text-lightShowTableUnderHeadingText dark:text-darkShowTableUnderHeadingText">
+              {{ $t('Field') }}
+            </th>
+            <th scope="col" class="px-6 py-3 text-xs uppercase hidden md:table-cell text-lightShowTableUnderHeadingText dark:text-darkShowTableUnderHeadingText">
+              {{ $t('Value') }}
+            </th>
+          </tr>
+        </thead>
+
+        <tbody>
+          <tr 
+            v-for="i in skeletonRowsCount" 
+            :key="i"
+            class="bg-lightShowTablesBodyBackground border-t border-lightShowTableBodyBorder dark:bg-darkShowTablesBodyBackground dark:border-darkShowTableBodyBorder block md:table-row"
+          >
+            <td class="px-6 py-[15.5px] relative block md:table-cell pb-0 md:pb-[15.5px]">
+              <div class="md:absolute md:inset-0 flex items-center px-6 py-[15.5px]">
+                <div class="h-2.5 bg-gray-200 dark:bg-gray-700 rounded-full w-24"></div>
+              </div>
+            </td>
+
+            <td class="px-6 py-[15.5px] whitespace-pre-wrap block md:table-cell">
+              <div class="flex items-center h-full min-h-[21px]">
+                <div class="h-2.5 bg-gray-200 dark:bg-gray-700 rounded-full w-full max-w-[280px]"></div>
+              </div>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+
+      <span class="sr-only">{{ $t('Loading...') }}</span>
     </div>
     <div 
       v-else-if="coreStore.record"
@@ -163,6 +192,7 @@ import { useI18n } from 'vue-i18n';
 import { getIcon } from '@/utils';
 import { type AdminForthComponentDeclarationFull, type AdminForthResourceColumnCommon, type FieldGroup } from '@/types/Common.js';
 import CallActionWrapper from '@/components/CallActionWrapper.vue'
+import { Spinner } from '@/afcl';
 
 const route = useRoute();
 const router = useRouter();
@@ -177,6 +207,18 @@ const customActions = computed(() => {
   return coreStore.resource?.options?.actions?.filter((a: any) => a.showIn?.showThreeDotsMenu) || [];
 });
 
+const skeletonRowsCount = computed(() => {
+  const allCols = coreStore.resource?.columns || [];
+
+  const isEnabledInConfig = (col: any) => {
+    return col.showIn?.list !== false;
+  };
+  
+  const finalCount = allCols.filter(isEnabledInConfig).length;
+
+  return finalCount > 0 ? finalCount : 10;
+});
+
 onMounted(async () => {
   loading.value = true;
   await coreStore.fetchResourceFull({
@@ -216,7 +258,7 @@ const groups = computed(() => {
 });
 
 const allColumns = computed(() => {
-  return coreStore.resource?.columns.filter(col => col.showIn?.show);
+  return coreStore.resource?.columns?.filter(col => col.showIn?.show);
 });
 
 const otherColumns = computed(() => {

package/dist/types/Back.d.ts

@@ -1,6 +1,8 @@
 import type { Express, Request, Response } from 'express';
+import type { AnySchemaObject } from 'ajv';
 import type { Writable } from 'stream';
-import { ActionCheckSource, AdminForthFilterOperators, AdminForthSortDirections, AllowedActionsEnum, AdminForthResourcePages, type AdminForthComponentDeclaration, type AdminUser, type AllowedActionsResolved, type AdminForthBulkActionCommon, type AdminForthForeignResourceCommon, type AdminForthResourceColumnCommon, type AdminForthResourceInputCommon, type AdminForthComponentDeclarationFull, type AdminForthConfigMenuItem, type AnnouncementBadgeResponse, type AdminForthResourceColumnInputCommon } from './Common.js';
+import type { ZodType } from 'zod';
+import { ActionCheckSource, AdminForthFilterOperators, AdminForthSortDirections, AllowedActionsEnum, AdminForthResourcePages, type AdminForthComponentDeclaration, type AdminUser, type AllowedActionsResolved, type AdminForthBulkActionCommon, type AdminForthForeignResourceCommon, type AdminForthResourceColumnCommon, type AdminForthResourceInputCommon, type AdminForthComponentDeclarationFull, type AdminForthConfigMenuItem, type AnnouncementBadgeResponse, type AdminForthResourceColumnInputCommon, type ColumnMinMaxValue } from './Common.js';
 export interface ICodeInjector {
     srcFoldersToSync: Object;
     allComponentNames: Object;
@@ -19,6 +21,81 @@ export interface IAdminForthHttpResponse {
     setStatus: (code: number, message: string) => void;
     blobStream: () => Writable;
 }
+export interface IAdminForthEndpointHandlerInput {
+    body: any;
+    adminUser: AdminUser | undefined;
+    query: {
+        [key: string]: any;
+    };
+    headers: {
+        [key: string]: any;
+    };
+    cookies: Array<{
+        key: string;
+        value: string;
+    }>;
+    response: IAdminForthHttpResponse;
+    requestUrl: string;
+    abortSignal: AbortSignal;
+    _raw_express_req: Request;
+    _raw_express_res: Response;
+    tr: ITranslateFunction;
+}
+export interface IAdminForthEndpointOptions {
+    method: string;
+    noAuth?: boolean;
+    path: string;
+    description?: string;
+    request_schema?: AnySchemaObject;
+    response_schema?: AnySchemaObject;
+    responce_schema?: AnySchemaObject;
+    handler: (input: IAdminForthEndpointHandlerInput) => void | Promise<any>;
+}
+export type AdminForthExpressSchemaInput = AnySchemaObject | ZodType;
+export interface IAdminForthExpressRouteSchema {
+    /**
+     * Detailed OpenAPI operation description for a custom Express route.
+     */
+    description?: string;
+    /**
+     * JSON schema or Zod schema describing the request body for a custom Express route.
+     */
+    request?: AdminForthExpressSchemaInput;
+    /**
+     * JSON schema or Zod schema describing the JSON response body for a custom Express route.
+     */
+    response?: AdminForthExpressSchemaInput;
+}
+export interface IRegisteredApiSchema {
+    method: string;
+    path: string;
+    description?: string;
+    request_schema?: AnySchemaObject;
+    response_schema?: AnySchemaObject;
+}
+export interface IAdminForthApiValidationError {
+    instancePath: string;
+    schemaPath: string;
+    keyword: string;
+    message?: string;
+    params: {
+        [key: string]: any;
+    };
+}
+export interface IAdminForthApiValidationResult {
+    valid: boolean;
+    errors?: IAdminForthApiValidationError[];
+}
+export interface IOpenApiRegistry {
+    registeredSchemas: IRegisteredApiSchema[];
+    registerApiSchema(options: IAdminForthEndpointOptions): IRegisteredApiSchema;
+    register_api_schema(options: IAdminForthEndpointOptions): IRegisteredApiSchema;
+    validateRequestSchema(route: IRegisteredApiSchema | null, payload: any): IAdminForthApiValidationResult;
+    validateResponseSchema(route: IRegisteredApiSchema | null, payload: any): IAdminForthApiValidationResult;
+    renderOpenApiDocument(): {
+        [key: string]: any;
+    };
+}
 /**
  * Implement this interface to create custom HTTP server adapter for AdminForth.
  */
@@ -34,18 +111,7 @@ export interface IHttpServer {
      *
      * @param options : Object with method, path and handler properties.
      */
-    endpoint(options: {
-        method: string;
-        noAuth?: boolean;
-        path: string;
-        handler: (body: any, adminUser: any, query: {
-            [key: string]: string;
-        }, headers: {
-            [key: string]: string;
-        }, cookies: {
-            [key: string]: string;
-        }, response: IAdminForthHttpResponse, requestUrl: string, abortSignal: AbortSignal, _raw_express_req: Request, _raw_express_res: Response) => void;
-    }): void;
+    endpoint(options: IAdminForthEndpointOptions): void;
 }
 export interface IExpressHttpServer extends IHttpServer {
     /**
@@ -73,10 +139,32 @@ export interface IExpressHttpServer extends IHttpServer {
      * ```
      *
      */
-    authorize(callable: Function): void;
+    authorize(callable: (...args: any[]) => any): (...args: any[]) => any;
+    /**
+     * Method (middleware) to inject translation helper into Express request object.
+     */
+    translatable(callable: (...args: any[]) => any): (...args: any[]) => any;
+    /**
+     * Registers OpenAPI schemas for a custom Express route.
+     *
+     * Wrap this around the handler passed to `app.get/post/...`.
+     * If you also need authorization, make `withSchema` the outer wrapper:
+     *
+     * ```ts
+    * import * as z from 'zod';
+    *
+     * app.get('/myApi', admin.express.withSchema({
+     *   description: 'Returns current user profile',
+    *   response: z.object({ user: z.unknown() }),
+     * }, admin.express.authorize((req, res) => {
+     *   res.json({ user: req.adminUser });
+     * })));
+     * ```
+     */
+    withSchema(schema: IAdminForthExpressRouteSchema, callable: (...args: any[]) => any): (...args: any[]) => any;
 }
 export interface ITranslateFunction {
-    (msg: string, category: string, params: any, pluralizationNumber?: number): Promise<string>;
+    (msg: string, category: string, params?: any, pluralizationNumber?: number): Promise<string>;
 }
 export interface IAdminUserExpressRequest extends Omit<Request, 'protocol' | 'param' | 'unshift'> {
     adminUser: AdminUser;
@@ -206,12 +294,7 @@ export interface IAdminForthDataSourceConnector {
     getMinMaxForColumnsWithOriginalTypes({ resource, columns }: {
         resource: AdminForthResource;
         columns: AdminForthResourceColumn[];
-    }): Promise<{
-        [key: string]: {
-            min: any;
-            max: any;
-        };
-    }>;
+    }): Promise<ColumnMinMaxValue>;
     /**
      * Used to create record in database. Should return value of primary key column of created record.
      */
@@ -274,12 +357,7 @@ export interface IAdminForthDataSourceConnectorBase extends IAdminForthDataSourc
     getMinMaxForColumns({ resource, columns }: {
         resource: AdminForthResource;
         columns: AdminForthResourceColumn[];
-    }): Promise<{
-        [key: string]: {
-            min: any;
-            max: any;
-        };
-    }>;
+    }): Promise<ColumnMinMaxValue>;
     deleteMany?({ resource, recordIds }: {
         resource: AdminForthResource;
         recordIds: any[];
@@ -343,7 +421,8 @@ export interface IAdminForthRestAPI {
 export interface IAdminForth {
     config: AdminForthConfig;
     codeInjector: ICodeInjector;
-    express: IHttpServer;
+    express: IExpressHttpServer;
+    openApi: IOpenApiRegistry;
     restApi: IAdminForthRestAPI;
     activatedPlugins: Array<IAdminForthPlugin>;
     websocket: IWebSocketBroker;
@@ -418,6 +497,7 @@ export interface IAdminForth {
      * ```
      */
     getPluginById<T>(id: string): T;
+    refreshMenuBadge(menuItemId: string, adminUser: AdminUser): Promise<void>;
 }
 export interface IAdminForthPlugin {
     adminforth: IAdminForth;
@@ -486,7 +566,10 @@ export type BeforeDataSourceRequestFunction = (params: {
         body: any;
         query: Record<string, string>;
         headers: Record<string, string>;
-        cookies: Record<string, string>;
+        cookies: {
+            key: string;
+            value: string;
+        }[];
         requestUrl: string;
     };
     filtersTools: any;
@@ -528,7 +611,10 @@ export interface HttpExtra {
     body: any;
     query: Record<string, string>;
     headers: Record<string, string>;
-    cookies: Record<string, string>;
+    cookies: {
+        key: string;
+        value: string;
+    }[];
     requestUrl: string;
     meta?: any;
     response: IAdminForthHttpResponse;
@@ -1205,6 +1291,19 @@ export interface AdminForthActionInput {
         standardAllowedActions: AllowedActions;
     }) => boolean;
     url?: string;
+    bulkHandler?: (params: {
+        adminforth: IAdminForth;
+        resource: AdminForthResource;
+        recordIds: (string | number)[];
+        adminUser: AdminUser;
+        response: IAdminForthHttpResponse;
+        extra?: HttpExtra;
+        tr: ITranslateFunction;
+    }) => Promise<{
+        ok: boolean;
+        error?: string;
+        successMessage?: string;
+    }>;
     action?: (params: {
         adminforth: IAdminForth;
         resource: AdminForthResource;
@@ -1212,7 +1311,7 @@ export interface AdminForthActionInput {
         adminUser: AdminUser;
         response: IAdminForthHttpResponse;
         extra?: HttpExtra;
-        tr: Function;
+        tr: ITranslateFunction;
     }) => Promise<{
         ok: boolean;
         error?: string;
@@ -1597,6 +1696,8 @@ export interface ResourceOptionsInput extends Omit<NonNullable<AdminForthResourc
     /**
      * Custom bulk actions list. Bulk actions available in list view when user selects multiple records by
      * using checkboxes.
+     * @deprecated Since 2.26.5. Will be removed in 3.0.0. Use `actions` instead.
+  
      */
     bulkActions?: Array<AdminForthBulkAction>;
     /**
@@ -1750,7 +1851,7 @@ export interface AdminForthBulkAction extends AdminForthBulkActionCommon {
         selectedIds: Array<any>;
         adminUser: AdminUser;
         response: IAdminForthHttpResponse;
-        tr: (key: string, category?: string, params?: any) => string;
+        tr: ITranslateFunction;
     }) => Promise<{
         ok: boolean;
         error?: string;
@@ -1869,5 +1970,12 @@ export interface IWebSocketBroker {
     publish: (topic: string, data: any, filterUsers?: (adminUser: AdminUser) => Promise<boolean>) => void;
     registerWsClient: (client: IWebSocketClient) => void;
 }
+export interface PluginsCommonOptions {
+    /**
+      * Id of the plugin. It should be unique across all plugins.
+      * It is required if you want to log custom actions, otherwise it is optional.
+     */
+    id?: string;
+}
 export {};
 //# sourceMappingURL=Back.d.ts.map