ConfigurableOperationDef

ConfigurableOperationDef

A ConfigurableOperationDef is a special type of object used extensively by Vendure to define code blocks which have arguments which are configurable at run-time by the administrator.

This is the mechanism used by:

• CollectionFilter
• PaymentMethodHandler
• PromotionAction
• PromotionCondition
• ShippingCalculator
• ShippingEligibilityChecker

Any class which extends ConfigurableOperationDef works in the same way: it takes a config object as the constructor argument. That config object extends the ConfigurableOperationDefOptions interface and typically adds some kind of business logic function to it.

For example, in the case of ShippingEligibilityChecker, it adds the check() function to the config object which defines the logic for checking whether an Order is eligible for a particular ShippingMethod.

The args property

The key feature of the ConfigurableOperationDef is the args property. This is where we define those arguments that are exposed via the Admin UI as data input components. This allows their values to be set at run-time by the Administrator. Those values can then be accessed in the business logic of the operation.

The data type of the args can be one of ConfigArgType, and the configuration is further explained in the docs of ConfigArgs.

Dependency Injection

If your business logic relies on injectable providers, such as the TransactionalConnection object, or any of the internal Vendure services or those defined in a plugin, you can inject them by using the config object’s init() method, which exposes the Injector.

Here’s an example of a ShippingCalculator that injects a service which has been defined in a plugin:

Example

import { Injector, ShippingCalculator } from '@vendure/core';
import { ShippingRatesService } from './shipping-rates.service';

// We keep reference to our injected service by keeping it
// in the top-level scope of the file.
let shippingRatesService: ShippingRatesService;

export const customShippingCalculator = new ShippingCalculator({
  code: 'custom-shipping-calculator',
  description: [],
  args: {},

  init(injector: Injector) {
    // The init function is called during bootstrap, and allows
    // us to inject any providers we need.
    shippingRatesService = injector.get(ShippingRatesService);
  },

  calculate: async (order, args) => {
    // We can now use the injected provider in the business logic.
    const { price, priceWithTax } = await shippingRatesService.getRate({
      destination: order.shippingAddress,
      contents: order.lines,
    });

    return {
      price,
      priceWithTax,
    };
  },
});

Signature

class ConfigurableOperationDef<T extends ConfigArgs = ConfigArgs> {
  code: string
  args: T
  description: LocalizedStringArray
  constructor(options: ConfigurableOperationDefOptions<T>)
  async init(injector: Injector) => ;
  async destroy() => ;
  toGraphQlType(ctx: RequestContext) => ConfigurableOperationDefinition;
  protected argsArrayToHash(args: ConfigArg[]) => ConfigArgValues<T>;
}

Members

code

args

description

constructor

init

destroy

toGraphQlType

argsArrayToHash

Contents:

• ConfigArgs
• ConfigArgType
• ConfigurableOperationDefOptions
• DefaultFormComponentId
• DefaultFormConfigHash
• LocalizedStringArray