Plugins

Plugins in Medicus serve as the primary mechanism to customize and extend its functionality. They enable integration with third-party services or the addition of new features tailored to your application’s requirements.

Creating Plugins

To create a plugin, define its structure using the definePlugin function. A plugin can introduce new health checkers, modify configuration options, or respond to lifecycle events.

import { ,  } from 'medicus';

export const  = <void>(() => ({
  // Add new health checkers
  : {
    () {
      return .;
    }
  },

  // Modify default configuration or introduce new options
  () {
    . = 30;
  },

  // Hook into the instance creation lifecycle
  () {
    .(
      `Medicus instance created with ${.()} checkers!`
    );
  }
}));

Customizing Plugin Options

Plugins can be made configurable by defining options in their structure. This allows dynamic behavior based on the options provided during initialization.

import { ,  } from 'medicus';

export const  = <{ : boolean }>(() => {
  if (.) {
    throw new ('Plugin failed');
  }

  return {
    : {
      () {
        return .;
      }
    }
  };
});

Plugin Context

Sometimes, plugins require additional contextual values. You can define a context type using a generic argument for definePlugin. This ensures the context is correctly passed and validated.

import { , ,  } from 'medicus';

// Define a plugin expecting context of type `{ a: string }`
export const  = <void, { : string }>(() => ({
  /* Plugin implementation */
}));

// Valid usage: context matches plugin expectations
const  = new <{ : string }>({
  : { : 'Arthur' },
  : [()]
});

// Invalid usage: context mismatch
const  = new <{ : string }>({
  : { : 'Arthur' },
  : [myPlugin()]
Type 'MedicusPlugin<{ a: string; }>' is not assignable to type 'MedicusPlugin<{ b: string; }>'.
  Types of property 'checkers' are incompatible.
    Type 'HealthCheckerMap<{ a: string; }> | undefined' is not assignable to type 'HealthCheckerMap<{ b: string; }> | undefined'.
      Type 'HealthCheckerMap<{ a: string; }>' is not assignable to type 'HealthCheckerMap<{ b: string; }>'.
        Property 'a' is missing in type '{ b: string; }' but required in type '{ a: string; }'.
});

With plugins, your creativity is the limit. They provide a flexible and powerful way to extend Medicus while maintaining clear and organized code.