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,    };  },});

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