Digital Products

import { LanguageCode, PluginCommonModule, VendurePlugin } from '@vendure/core';@VendurePlugin({    imports: [PluginCommonModule],    configuration: config => {        // config.customFields.ProductVariant.push({ ... omitted        config.customFields.ShippingMethod.push({ // [!code highlight]            type: 'boolean', // [!code highlight]            name: 'digitalFulfilmentOnly', // [!code highlight]            defaultValue: false, // [!code highlight]            label: [{ languageCode: LanguageCode.en, value: 'Digital fulfilment only' }], // [!code highlight]            public: true, // [!code highlight]        }); // [!code highlight]        return config;    },})

import { LanguageCode, PluginCommonModule, VendurePlugin } from '@vendure/core';@VendurePlugin({    imports: [PluginCommonModule],    configuration: config => {        // config.customFields.ProductVariant.push({ ... omitted        // config.customFields.ShippingMethod.push({ ... omitted        config.customFields.Fulfillment.push({ // [!code highlight]            type: 'string', // [!code highlight]            name: 'downloadUrls', // [!code highlight]            nullable: true, // [!code highlight]            list: true, // [!code highlight]            label: [{ languageCode: LanguageCode.en, value: 'Urls of any digital purchases' }], // [!code highlight]            public: true, // [!code highlight]        }); // [!code highlight]        return config;    },})

import { FulfillmentHandler, LanguageCode, OrderLine, TransactionalConnection } from '@vendure/core';import { In } from 'typeorm';let connection: TransactionalConnection;/** * @description * This is a fulfillment handler for digital products which generates a download url * for each digital product in the order. */export const digitalFulfillmentHandler = new FulfillmentHandler({    code: 'digital-fulfillment',    description: [        {            languageCode: LanguageCode.en,            value: 'Generates product keys for the digital download',        },    ],    args: {},    init: injector => {        connection = injector.get(TransactionalConnection);    },    createFulfillment: async (ctx, orders, lines) => {        const digitalDownloadUrls: string[] = [];        const orderLines = await connection.getRepository(ctx, OrderLine).find({            where: {                id: In(lines.map(l => l.orderLineId)),            },            relations: {                productVariant: true,            },        });        for (const orderLine of orderLines) {            if (orderLine.productVariant.customFields.isDigital) {                // This is a digital product, so generate a download url                const downloadUrl = await generateDownloadUrl(orderLine);                digitalDownloadUrls.push(downloadUrl);            }        }        return {            method: 'Digital Fulfillment',            trackingCode: 'DIGITAL',            customFields: {                downloadUrls: digitalDownloadUrls,            },        };    },});function generateDownloadUrl(orderLine: OrderLine) {    // This is a dummy function that would generate a download url for the given OrderLine    // by interfacing with some external system that manages access to the digital product.    // In this example, we just generate a random string.    const downloadUrl = `https://example.com/download?key=${Math.random().toString(36).substring(7)}`;    return Promise.resolve(downloadUrl);}

import { LanguageCode, PluginCommonModule, VendurePlugin } from '@vendure/core';import { digitalFulfillmentHandler } from './config/digital-fulfillment-handler';@VendurePlugin({    imports: [PluginCommonModule],    configuration: config => {        // config.customFields.ProductVariant.push({ ... omitted        // config.customFields.ShippingMethod.push({ ... omitted        // config.customFields.Fulfillment.push({ ... omitted        config.shippingOptions.fulfillmentHandlers.push(digitalFulfillmentHandler); // [!code highlight]        return config;    },})export class DigitalProductsPlugin {}

import { LanguageCode, ShippingEligibilityChecker } from '@vendure/core';export const digitalShippingEligibilityChecker = new ShippingEligibilityChecker({    code: 'digital-shipping-eligibility-checker',    description: [        {            languageCode: LanguageCode.en,            value: 'Allows only orders that contain at least 1 digital product',        },    ],    args: {},    check: (ctx, order, args) => {        const digitalOrderLines = order.lines.filter(l => l.productVariant.customFields.isDigital);        return digitalOrderLines.length > 0;    },});

import {    Order,    OrderLine,    RequestContext,    ShippingLine,    ShippingLineAssignmentStrategy,} from '@vendure/core';/** * @description * This ShippingLineAssignmentStrategy ensures that digital products are assigned to a * ShippingLine which has the `isDigital` flag set to true. */export class DigitalShippingLineAssignmentStrategy implements ShippingLineAssignmentStrategy {    assignShippingLineToOrderLines(        ctx: RequestContext,        shippingLine: ShippingLine,        order: Order,    ): OrderLine[] | Promise<OrderLine[]> {        if (shippingLine.shippingMethod.customFields.isDigital) {            return order.lines.filter(l => l.productVariant.customFields.isDigital);        } else {            return order.lines.filter(l => !l.productVariant.customFields.isDigital);        }    }}

import { OrderProcess, OrderService } from '@vendure/core';import { digitalFulfillmentHandler } from './digital-fulfillment-handler';let orderService: OrderService;/** * @description * This OrderProcess ensures that when an Order transitions from ArrangingPayment to * PaymentAuthorized or PaymentSettled, then any digital products are automatically * fulfilled. */export const digitalOrderProcess: OrderProcess<string> = {    init(injector) {        orderService = injector.get(OrderService);    },    async onTransitionEnd(fromState, toState, data) {        if (            fromState === 'ArrangingPayment' &&            (toState === 'PaymentAuthorized' || toState === 'PaymentSettled')        ) {            const digitalOrderLines = data.order.lines.filter(l => l.productVariant.customFields.isDigital);            if (digitalOrderLines.length) {                await orderService.createFulfillment(data.ctx, {                    lines: digitalOrderLines.map(l => ({ orderLineId: l.id, quantity: l.quantity })),                    handler: { code: digitalFulfillmentHandler.code, arguments: [] },                });            }        }    },};

import { VendureConfig } from '@vendure/core';import { DigitalProductsPlugin } from './plugins/digital-products/digital-products.plugin';const config: VendureConfig = {    // ... other config omitted    plugins: [        // ... other plugins omitted        DigitalProductsPlugin, // [!code highlight]    ],};