@vendure/core 2.0.0-next.9 → 2.0.0

package/dist/service/services/stock-level.service.js

@@ -0,0 +1,128 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StockLevelService = void 0;
+const common_1 = require("@nestjs/common");
+const index_1 = require("../../config/index");
+const index_2 = require("../../connection/index");
+const index_3 = require("../../entity/index");
+const stock_location_service_1 = require("./stock-location.service");
+/**
+ * @description
+ * The StockLevelService is responsible for managing the stock levels of ProductVariants.
+ * Whenever you need to adjust the `stockOnHand` or `stockAllocated` for a ProductVariant,
+ * you should use this service.
+ *
+ * @docsCategory services
+ * @since 2.0.0
+ */
+let StockLevelService = class StockLevelService {
+    constructor(connection, stockLocationService, configService) {
+        this.connection = connection;
+        this.stockLocationService = stockLocationService;
+        this.configService = configService;
+    }
+    /**
+     * @description
+     * Returns the StockLevel for the given {@link ProductVariant} and {@link StockLocation}.
+     */
+    async getStockLevel(ctx, productVariantId, stockLocationId) {
+        const stockLevel = await this.connection.getRepository(ctx, index_3.StockLevel).findOne({
+            where: {
+                productVariantId,
+                stockLocationId,
+            },
+        });
+        if (stockLevel) {
+            return stockLevel;
+        }
+        return this.connection.getRepository(ctx, index_3.StockLevel).save(new index_3.StockLevel({
+            productVariantId,
+            stockLocationId,
+            stockOnHand: 0,
+            stockAllocated: 0,
+        }));
+    }
+    async getStockLevelsForVariant(ctx, productVariantId) {
+        return this.connection
+            .getRepository(ctx, index_3.StockLevel)
+            .createQueryBuilder('stockLevel')
+            .leftJoinAndSelect('stockLevel.stockLocation', 'stockLocation')
+            .leftJoin('stockLocation.channels', 'channel')
+            .where('stockLevel.productVariantId = :productVariantId', { productVariantId })
+            .andWhere('channel.id = :channelId', { channelId: ctx.channelId })
+            .getMany();
+    }
+    /**
+     * @description
+     * Returns the available stock (on hand and allocated) for the given {@link ProductVariant}. This is determined
+     * by the configured {@link StockLocationStrategy}.
+     */
+    async getAvailableStock(ctx, productVariantId) {
+        const { stockLocationStrategy } = this.configService.catalogOptions;
+        const stockLevels = await this.connection.getRepository(ctx, index_3.StockLevel).find({
+            where: {
+                productVariantId,
+            },
+        });
+        return stockLocationStrategy.getAvailableStock(ctx, productVariantId, stockLevels);
+    }
+    /**
+     * @description
+     * Updates the `stockOnHand` for the given {@link ProductVariant} and {@link StockLocation}.
+     */
+    async updateStockOnHandForLocation(ctx, productVariantId, stockLocationId, change) {
+        const stockLevel = await this.connection.getRepository(ctx, index_3.StockLevel).findOne({
+            where: {
+                productVariantId,
+                stockLocationId,
+            },
+        });
+        if (!stockLevel) {
+            await this.connection.getRepository(ctx, index_3.StockLevel).save(new index_3.StockLevel({
+                productVariantId,
+                stockLocationId,
+                stockOnHand: change,
+                stockAllocated: 0,
+            }));
+        }
+        if (stockLevel) {
+            await this.connection
+                .getRepository(ctx, index_3.StockLevel)
+                .update(stockLevel.id, { stockOnHand: stockLevel.stockOnHand + change });
+        }
+    }
+    /**
+     * @description
+     * Updates the `stockAllocated` for the given {@link ProductVariant} and {@link StockLocation}.
+     */
+    async updateStockAllocatedForLocation(ctx, productVariantId, stockLocationId, change) {
+        const stockLevel = await this.connection.getRepository(ctx, index_3.StockLevel).findOne({
+            where: {
+                productVariantId,
+                stockLocationId,
+            },
+        });
+        if (stockLevel) {
+            await this.connection
+                .getRepository(ctx, index_3.StockLevel)
+                .update(stockLevel.id, { stockAllocated: stockLevel.stockAllocated + change });
+        }
+    }
+};
+StockLevelService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [index_2.TransactionalConnection,
+        stock_location_service_1.StockLocationService,
+        index_1.ConfigService])
+], StockLevelService);
+exports.StockLevelService = StockLevelService;
+//# sourceMappingURL=stock-level.service.js.map

package/dist/service/services/stock-level.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stock-level.service.js","sourceRoot":"","sources":["../../../src/service/services/stock-level.service.ts"],"names":[],"mappings":"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"}

package/dist/service/services/stock-location.service.d.ts

@@ -0,0 +1,38 @@
+import { AssignStockLocationsToChannelInput, CreateStockLocationInput, DeleteStockLocationInput, DeletionResponse, RemoveStockLocationsFromChannelInput, UpdateStockLocationInput } from '@vendure/common/lib/generated-types';
+import { ID, PaginatedList } from '@vendure/common/lib/shared-types';
+import { RelationPaths, RequestContext } from '../../api/index';
+import { RequestContextCacheService } from '../../cache/index';
+import { ListQueryOptions } from '../../common/index';
+import { ConfigService } from '../../config/index';
+import { TransactionalConnection } from '../../connection/index';
+import { OrderLine } from '../../entity/index';
+import { StockLocation } from '../../entity/stock-location/stock-location.entity';
+import { ListQueryBuilder } from '../helpers/list-query-builder/list-query-builder';
+import { RequestContextService } from '../helpers/request-context/request-context.service';
+import { ChannelService } from './channel.service';
+import { RoleService } from './role.service';
+export declare class StockLocationService {
+    private requestContextService;
+    private connection;
+    private channelService;
+    private roleService;
+    private listQueryBuilder;
+    private configService;
+    private requestContextCache;
+    constructor(requestContextService: RequestContextService, connection: TransactionalConnection, channelService: ChannelService, roleService: RoleService, listQueryBuilder: ListQueryBuilder, configService: ConfigService, requestContextCache: RequestContextCacheService);
+    initStockLocations(): Promise<void>;
+    findOne(ctx: RequestContext, stockLocationId: ID): Promise<StockLocation | undefined>;
+    findAll(ctx: RequestContext, options?: ListQueryOptions<StockLocation>, relations?: RelationPaths<StockLocation>): Promise<PaginatedList<StockLocation>>;
+    create(ctx: RequestContext, input: CreateStockLocationInput): Promise<StockLocation>;
+    update(ctx: RequestContext, input: UpdateStockLocationInput): Promise<StockLocation>;
+    delete(ctx: RequestContext, input: DeleteStockLocationInput): Promise<DeletionResponse>;
+    assignStockLocationsToChannel(ctx: RequestContext, input: AssignStockLocationsToChannelInput): Promise<StockLocation[]>;
+    removeStockLocationsFromChannel(ctx: RequestContext, input: RemoveStockLocationsFromChannelInput): Promise<StockLocation[]>;
+    getAllStockLocations(ctx: RequestContext): Promise<StockLocation[]>;
+    defaultStockLocation(ctx: RequestContext): Promise<StockLocation>;
+    getAllocationLocations(ctx: RequestContext, orderLine: OrderLine, quantity: number): Promise<import("../../config/index").LocationWithQuantity[]>;
+    getReleaseLocations(ctx: RequestContext, orderLine: OrderLine, quantity: number): Promise<import("../../config/index").LocationWithQuantity[]>;
+    getSaleLocations(ctx: RequestContext, orderLine: OrderLine, quantity: number): Promise<import("../../config/index").LocationWithQuantity[]>;
+    getCancellationLocations(ctx: RequestContext, orderLine: OrderLine, quantity: number): Promise<import("../../config/index").LocationWithQuantity[]>;
+    private ensureDefaultStockLocationExists;
+}

package/dist/service/services/stock-location.service.js

@@ -0,0 +1,240 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StockLocationService = void 0;
+const common_1 = require("@nestjs/common");
+const generated_types_1 = require("@vendure/common/lib/generated-types");
+const index_1 = require("../../cache/index");
+const index_2 = require("../../common/index");
+const index_3 = require("../../config/index");
+const index_4 = require("../../connection/index");
+const index_5 = require("../../entity/index");
+const stock_location_entity_1 = require("../../entity/stock-location/stock-location.entity");
+const list_query_builder_1 = require("../helpers/list-query-builder/list-query-builder");
+const request_context_service_1 = require("../helpers/request-context/request-context.service");
+const channel_service_1 = require("./channel.service");
+const role_service_1 = require("./role.service");
+let StockLocationService = class StockLocationService {
+    constructor(requestContextService, connection, channelService, roleService, listQueryBuilder, configService, requestContextCache) {
+        this.requestContextService = requestContextService;
+        this.connection = connection;
+        this.channelService = channelService;
+        this.roleService = roleService;
+        this.listQueryBuilder = listQueryBuilder;
+        this.configService = configService;
+        this.requestContextCache = requestContextCache;
+    }
+    async initStockLocations() {
+        await this.ensureDefaultStockLocationExists();
+    }
+    findOne(ctx, stockLocationId) {
+        return this.connection
+            .findOneInChannel(ctx, stock_location_entity_1.StockLocation, stockLocationId, ctx.channelId)
+            .then(result => result !== null && result !== void 0 ? result : undefined);
+    }
+    findAll(ctx, options, relations) {
+        return this.listQueryBuilder
+            .build(stock_location_entity_1.StockLocation, options, {
+            channelId: ctx.channelId,
+            relations,
+            ctx,
+        })
+            .getManyAndCount()
+            .then(([items, totalItems]) => ({
+            items,
+            totalItems,
+        }));
+    }
+    async create(ctx, input) {
+        var _a;
+        const stockLocation = await this.connection.getRepository(ctx, stock_location_entity_1.StockLocation).save(new stock_location_entity_1.StockLocation({
+            name: input.name,
+            description: (_a = input.description) !== null && _a !== void 0 ? _a : '',
+        }));
+        await this.channelService.assignToCurrentChannel(stockLocation, ctx);
+        await this.connection.getRepository(ctx, stock_location_entity_1.StockLocation).save(stockLocation);
+        return stockLocation;
+    }
+    async update(ctx, input) {
+        const stockLocation = await this.connection.getEntityOrThrow(ctx, stock_location_entity_1.StockLocation, input.id);
+        if (input.name) {
+            stockLocation.name = input.name;
+        }
+        if (input.description) {
+            stockLocation.description = input.description;
+        }
+        return this.connection.getRepository(ctx, stock_location_entity_1.StockLocation).save(stockLocation);
+    }
+    async delete(ctx, input) {
+        const stockLocation = await this.connection.findOneInChannel(ctx, stock_location_entity_1.StockLocation, input.id, ctx.channelId);
+        if (!stockLocation) {
+            throw new index_2.EntityNotFoundError('StockLocation', input.id);
+        }
+        // Do not allow the last StockLocation to be deleted
+        const allStockLocations = await this.connection.getRepository(ctx, stock_location_entity_1.StockLocation).find();
+        if (allStockLocations.length === 1) {
+            return {
+                result: generated_types_1.DeletionResult.NOT_DELETED,
+                message: ctx.translate('message.cannot-delete-last-stock-location'),
+            };
+        }
+        if (input.transferToLocationId) {
+            // This is inefficient, and it would be nice to be able to do this as a single
+            // SQL `update` statement with a nested `select` subquery, but TypeORM doesn't
+            // seem to have a good solution for that. If this proves a perf bottleneck, we
+            // can look at implementing raw SQL with a switch over the DB type.
+            const stockLevelsToTransfer = await this.connection
+                .getRepository(ctx, index_5.StockLevel)
+                .find({ where: { stockLocationId: stockLocation.id } });
+            for (const stockLevel of stockLevelsToTransfer) {
+                const existingStockLevel = await this.connection.getRepository(ctx, index_5.StockLevel).findOne({
+                    where: {
+                        stockLocationId: input.transferToLocationId,
+                        productVariantId: stockLevel.productVariantId,
+                    },
+                });
+                if (existingStockLevel) {
+                    existingStockLevel.stockOnHand += stockLevel.stockOnHand;
+                    existingStockLevel.stockAllocated += stockLevel.stockAllocated;
+                    await this.connection.getRepository(ctx, index_5.StockLevel).save(existingStockLevel);
+                }
+                else {
+                    const newStockLevel = new index_5.StockLevel({
+                        productVariantId: stockLevel.productVariantId,
+                        stockLocationId: input.transferToLocationId,
+                        stockOnHand: stockLevel.stockOnHand,
+                        stockAllocated: stockLevel.stockAllocated,
+                    });
+                    await this.connection.getRepository(ctx, index_5.StockLevel).save(newStockLevel);
+                }
+                await this.connection.getRepository(ctx, index_5.StockLevel).remove(stockLevel);
+            }
+        }
+        try {
+            await this.connection.getRepository(ctx, stock_location_entity_1.StockLocation).remove(stockLocation);
+        }
+        catch (e) {
+            return {
+                result: generated_types_1.DeletionResult.NOT_DELETED,
+                message: e.message,
+            };
+        }
+        return {
+            result: generated_types_1.DeletionResult.DELETED,
+        };
+    }
+    async assignStockLocationsToChannel(ctx, input) {
+        const hasPermission = await this.roleService.userHasAnyPermissionsOnChannel(ctx, input.channelId, [
+            generated_types_1.Permission.UpdateStockLocation,
+        ]);
+        if (!hasPermission) {
+            throw new index_2.ForbiddenError();
+        }
+        for (const stockLocationId of input.stockLocationIds) {
+            const stockLocation = await this.connection.findOneInChannel(ctx, stock_location_entity_1.StockLocation, stockLocationId, ctx.channelId);
+            await this.channelService.assignToChannels(ctx, stock_location_entity_1.StockLocation, stockLocationId, [
+                input.channelId,
+            ]);
+        }
+        return this.connection.findByIdsInChannel(ctx, stock_location_entity_1.StockLocation, input.stockLocationIds, ctx.channelId, {});
+    }
+    async removeStockLocationsFromChannel(ctx, input) {
+        const hasPermission = await this.roleService.userHasAnyPermissionsOnChannel(ctx, input.channelId, [
+            generated_types_1.Permission.DeleteStockLocation,
+        ]);
+        if (!hasPermission) {
+            throw new index_2.ForbiddenError();
+        }
+        const defaultChannel = await this.channelService.getDefaultChannel(ctx);
+        if ((0, index_2.idsAreEqual)(input.channelId, defaultChannel.id)) {
+            throw new index_2.UserInputError('error.items-cannot-be-removed-from-default-channel');
+        }
+        for (const stockLocationId of input.stockLocationIds) {
+            const stockLocation = await this.connection.getEntityOrThrow(ctx, stock_location_entity_1.StockLocation, stockLocationId);
+            await this.channelService.removeFromChannels(ctx, stock_location_entity_1.StockLocation, stockLocationId, [
+                input.channelId,
+            ]);
+        }
+        return this.connection.findByIdsInChannel(ctx, stock_location_entity_1.StockLocation, input.stockLocationIds, ctx.channelId, {});
+    }
+    getAllStockLocations(ctx) {
+        return this.requestContextCache.get(ctx, 'StockLocationService.getAllStockLocations', () => this.connection.getRepository(ctx, stock_location_entity_1.StockLocation).find());
+    }
+    defaultStockLocation(ctx) {
+        return this.connection
+            .getRepository(ctx, stock_location_entity_1.StockLocation)
+            .find({ order: { createdAt: 'ASC' } })
+            .then(items => items[0]);
+    }
+    async getAllocationLocations(ctx, orderLine, quantity) {
+        const { stockLocationStrategy } = this.configService.catalogOptions;
+        const stockLocations = await this.getAllStockLocations(ctx);
+        const allocationLocations = await stockLocationStrategy.forAllocation(ctx, stockLocations, orderLine, quantity);
+        return allocationLocations;
+    }
+    async getReleaseLocations(ctx, orderLine, quantity) {
+        const { stockLocationStrategy } = this.configService.catalogOptions;
+        const stockLocations = await this.getAllStockLocations(ctx);
+        const releaseLocations = await stockLocationStrategy.forRelease(ctx, stockLocations, orderLine, quantity);
+        return releaseLocations;
+    }
+    async getSaleLocations(ctx, orderLine, quantity) {
+        const { stockLocationStrategy } = this.configService.catalogOptions;
+        const stockLocations = await this.getAllStockLocations(ctx);
+        const saleLocations = await stockLocationStrategy.forSale(ctx, stockLocations, orderLine, quantity);
+        return saleLocations;
+    }
+    async getCancellationLocations(ctx, orderLine, quantity) {
+        const { stockLocationStrategy } = this.configService.catalogOptions;
+        const stockLocations = await this.getAllStockLocations(ctx);
+        const cancellationLocations = await stockLocationStrategy.forCancellation(ctx, stockLocations, orderLine, quantity);
+        return cancellationLocations;
+    }
+    async ensureDefaultStockLocationExists() {
+        const ctx = await this.requestContextService.create({
+            apiType: 'admin',
+        });
+        const stockLocations = await this.connection.getRepository(ctx, stock_location_entity_1.StockLocation).find({
+            relations: {
+                channels: true,
+            },
+        });
+        if (stockLocations.length === 0) {
+            const defaultStockLocation = await this.connection.getRepository(ctx, stock_location_entity_1.StockLocation).save(new stock_location_entity_1.StockLocation({
+                name: 'Default Stock Location',
+                description: 'The default stock location',
+            }));
+            defaultStockLocation.channels = [];
+            stockLocations.push(defaultStockLocation);
+            await this.connection.getRepository(ctx, stock_location_entity_1.StockLocation).save(defaultStockLocation);
+        }
+        const defaultChannel = await this.channelService.getDefaultChannel();
+        for (const stockLocation of stockLocations) {
+            if (!stockLocation.channels.find(c => c.id === defaultChannel.id)) {
+                await this.channelService.assignToChannels(ctx, stock_location_entity_1.StockLocation, stockLocation.id, [
+                    defaultChannel.id,
+                ]);
+            }
+        }
+    }
+};
+StockLocationService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [request_context_service_1.RequestContextService,
+        index_4.TransactionalConnection,
+        channel_service_1.ChannelService,
+        role_service_1.RoleService,
+        list_query_builder_1.ListQueryBuilder,
+        index_3.ConfigService,
+        index_1.RequestContextCacheService])
+], StockLocationService);
+exports.StockLocationService = StockLocationService;
+//# sourceMappingURL=stock-location.service.js.map

package/dist/service/services/stock-location.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stock-location.service.js","sourceRoot":"","sources":["../../../src/service/services/stock-location.service.ts"],"names":[],"mappings":"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"}

package/dist/service/services/stock-movement.service.d.ts

@@ -1,11 +1,10 @@
-import { StockMovementListOptions } from '@vendure/common/lib/generated-types';
+import { OrderLineInput, StockLevelInput, StockMovementListOptions } from '@vendure/common/lib/generated-types';
 import { ID, PaginatedList } from '@vendure/common/lib/shared-types';
 import { RequestContext } from '../../api/common/request-context';
+import { ConfigService } from '../../config/index';
 import { ShippingCalculator } from '../../config/shipping-method/shipping-calculator';
 import { ShippingEligibilityChecker } from '../../config/shipping-method/shipping-eligibility-checker';
 import { TransactionalConnection } from '../../connection/transactional-connection';
-import { OrderItem } from '../../entity/order-item/order-item.entity';
-import { OrderLine } from '../../entity/order-line/order-line.entity';
 import { Order } from '../../entity/order/order.entity';
 import { Allocation } from '../../entity/stock-movement/allocation.entity';
 import { Cancellation } from '../../entity/stock-movement/cancellation.entity';
@@ -16,6 +15,8 @@ import { StockMovement } from '../../entity/stock-movement/stock-movement.entity
 import { EventBus } from '../../event-bus/event-bus';
 import { ListQueryBuilder } from '../helpers/list-query-builder/list-query-builder';
 import { GlobalSettingsService } from './global-settings.service';
+import { StockLevelService } from './stock-level.service';
+import { StockLocationService } from './stock-location.service';
 /**
  * @description
  * Contains methods relating to {@link StockMovement} entities.
@@ -26,11 +27,14 @@ export declare class StockMovementService {
     private connection;
     private listQueryBuilder;
     private globalSettingsService;
+    private stockLevelService;
     private eventBus;
+    private stockLocationService;
+    private configService;
     shippingEligibilityCheckers: ShippingEligibilityChecker[];
     shippingCalculators: ShippingCalculator[];
     private activeShippingMethods;
-    constructor(connection: TransactionalConnection, listQueryBuilder: ListQueryBuilder, globalSettingsService: GlobalSettingsService, eventBus: EventBus);
+    constructor(connection: TransactionalConnection, listQueryBuilder: ListQueryBuilder, globalSettingsService: GlobalSettingsService, stockLevelService: StockLevelService, eventBus: EventBus, stockLocationService: StockLocationService, configService: ConfigService);
     /**
      * @description
      * Returns a {@link PaginatedList} of all StockMovements associated with the specified ProductVariant.
@@ -41,7 +45,7 @@ export declare class StockMovementService {
      * Adjusts the stock level of the ProductVariant, creating a new {@link StockAdjustment} entity
      * in the process.
      */
-    adjustProductVariantStock(ctx: RequestContext, productVariantId: ID, oldStockLevel: number, newStockLevel: number): Promise<StockAdjustment | undefined>;
+    adjustProductVariantStock(ctx: RequestContext, productVariantId: ID, stockOnHandNumberOrInput: number | StockLevelInput[]): Promise<StockAdjustment[]>;
     /**
      * @description
      * Creates a new {@link Allocation} for each OrderLine in the Order. For ProductVariants
@@ -55,31 +59,28 @@ export declare class StockMovementService {
      * which are configured to track stock levels, the `ProductVariant.stockAllocated` value is
      * increased, indicating that this quantity of stock is allocated and cannot be sold.
      */
-    createAllocationsForOrderLines(ctx: RequestContext, lines: Array<{
-        orderLine: OrderLine;
-        quantity: number;
-    }>): Promise<Allocation[]>;
+    createAllocationsForOrderLines(ctx: RequestContext, lines: OrderLineInput[]): Promise<Allocation[]>;
     /**
      * @description
      * Creates {@link Sale}s for each OrderLine in the Order. For ProductVariants
      * which are configured to track stock levels, the `ProductVariant.stockAllocated` value is
-     * reduced and the `stockOnHand` value is also reduced the the OrderLine quantity, indicating
+     * reduced and the `stockOnHand` value is also reduced by the OrderLine quantity, indicating
      * that the stock is no longer allocated, but is actually sold and no longer available.
      */
-    createSalesForOrder(ctx: RequestContext, orderItems: OrderItem[]): Promise<Sale[]>;
+    createSalesForOrder(ctx: RequestContext, lines: OrderLineInput[]): Promise<Sale[]>;
     /**
      * @description
      * Creates a {@link Cancellation} for each of the specified OrderItems. For ProductVariants
      * which are configured to track stock levels, the `ProductVariant.stockOnHand` value is
      * increased for each Cancellation, allowing that stock to be sold again.
      */
-    createCancellationsForOrderItems(ctx: RequestContext, items: OrderItem[]): Promise<Cancellation[]>;
+    createCancellationsForOrderLines(ctx: RequestContext, lineInputs: OrderLineInput[]): Promise<Cancellation[]>;
     /**
      * @description
      * Creates a {@link Release} for each of the specified OrderItems. For ProductVariants
      * which are configured to track stock levels, the `ProductVariant.stockAllocated` value is
      * reduced, indicating that this stock is once again available to buy.
      */
-    createReleasesForOrderItems(ctx: RequestContext, items: OrderItem[]): Promise<Release[]>;
+    createReleasesForOrderLines(ctx: RequestContext, lineInputs: OrderLineInput[]): Promise<Release[]>;
     private trackInventoryForVariant;
 }