feat: implement getPluginById method and update plugin registration with unique IDs

Author: Pavlo Kulyk

adminforth/index.ts

@@ -116,6 +116,7 @@ class AdminForth implements IAdminForth {
   connectorClasses: any;
   runningHotReload: boolean;
   activatedPlugins: Array<AdminForthPlugin>;
+  pluginsById: Record<string, AdminForthPlugin> = {};
   configValidator: IConfigValidator;
   restApi: AdminForthRestAPI;
 
@@ -256,6 +257,12 @@ class AdminForth implements IAdminForth {
             throw new Error(`Attempt to activate Plugin ${pluginInstance.constructor.name} second time for same resource, but plugin does not support it. 
               To support multiple plugin instance pre one resource, plugin should return unique string values for each installation from instanceUniqueRepresentation`);
           }
+          if (pluginInstance.id) {
+            if (this.pluginsById[pluginInstance.id]) {
+              throw new Error(`Plugin with id "${pluginInstance.id}" already exists!`);
+            }
+            this.pluginsById[pluginInstance.id] = pluginInstance;
+          }
           this.activatedPlugins.push(pluginInstance);
           afLogger.trace(`🔌 Plugin ${pluginInstance.constructor.name} activated successfully`);
         }
@@ -282,6 +289,14 @@ class AdminForth implements IAdminForth {
     return plugins[0] as T;
   }
 
+   getPluginById<T = any>(id: string): T {
+    const plugin = this.pluginsById[id];
+    if (!plugin) {
+      throw new Error(`Plugin with id "${id}" not found`);
+    }
+    return plugin as T;
+  }
+
   validateFieldGroups(fieldGroups: {
     groupName: string;
     columns: string[];

adminforth/types/Back.ts

@@ -424,6 +424,17 @@ export interface IAdminForth {
    * 
    */
   getPluginByClassName<T>(className: string): T;
+
+  /**
+   * This method can be used when you want to get a plugin instance by its unique pluginInstanceId.
+   * @param pluginInstanceId - unique id of the plugin instance
+   * 
+   * Example:
+   * ```ts
+   * const auditLog = adminforth.getPluginById<AuditLogPlugin>('TestPlugin');
+   * ```
+   */
+  getPluginById<T>(pluginInstanceId: string): T;
 }
 
 

dev-demo/resources/auditLogs.ts

@@ -39,6 +39,7 @@ export default {
   },
   plugins: [
     new AuditLogPlugin({
+      id: 'AuditLogPlugin',
       // if you want to exclude some resources from logging
       //excludeResourceIds: ['adminuser'],
       resourceColumns: {

dev-demo/resources/carsResourseTemplate.ts

@@ -373,7 +373,8 @@ export default function carsResourseTemplate(resourceId: string, dataSource: str
               return { ok: false, error: result?.error ?? 'Provided 2fa verification data is invalid' };
             }
             await adminforth
-              .getPluginByClassName<AuditLogPlugin>('AuditLogPlugin')
+              // .getPluginByClassName<AuditLogPlugin>('AuditLogPlugin')
+              .getPluginById<AuditLogPlugin>('AuditLogPlugin')
               .logCustomAction({
                 resourceId: resourceId,
                 recordId: null,