@acmekit/js-sdk 2.13.1

package/dist/esm/admin/inventory-item.d.ts

@@ -0,0 +1,320 @@
+import { HttpTypes, SelectParams } from "@acmekit/types";
+import { Client } from "../client";
+import { ClientHeaders } from "../types";
+export declare class InventoryItem {
+    /**
+     * @ignore
+     */
+    private client;
+    /**
+     * @ignore
+     */
+    constructor(client: Client);
+    /**
+     * This method creates an inventory item. It sends a request to the
+     * [Create Inventory Item](https://docs.acmekit.com/api/admin#inventory-items_postinventoryitems)
+     * API route.
+     *
+     * @param body - The inventory item's details.
+     * @param query - Configure the fields to retrieve in the inventory item.
+     * @param headers - Headers to pass in the request.
+     * @returns The inventory item's details.
+     *
+     * @example
+     * sdk.admin.inventoryItem.create({
+     *   sku: "SHIRT"
+     * })
+     * .then(({ inventory_item }) => {
+     *   console.log(inventory_item)
+     * })
+     */
+    create(body: HttpTypes.AdminCreateInventoryItem, query?: HttpTypes.SelectParams, headers?: ClientHeaders): Promise<HttpTypes.AdminInventoryItemResponse>;
+    /**
+     * This method updates an inventory level. It sends a request to the
+     * [Update Inventory Item](https://docs.acmekit.com/api/admin#inventory-items_postinventoryitemsid)
+     * API route.
+     *
+     * @param id - The inventory item's ID.
+     * @param body - The data to update.
+     * @param query - Configure the fields to retrieve in the inventory item.
+     * @param headers - Headers to pass in the request.
+     * @returns The inventory item's details.
+     *
+     * @example
+     * sdk.admin.inventoryItem.update("iitem_123", {
+     *   sku: "SHIRT"
+     * })
+     * .then(({ inventory_item }) => {
+     *   console.log(inventory_item)
+     * })
+     */
+    update(id: string, body: HttpTypes.AdminUpdateInventoryItem, query?: SelectParams, headers?: ClientHeaders): Promise<HttpTypes.AdminInventoryItemResponse>;
+    /**
+     * This method retrieves a paginated list of inventory items. It sends a request to the
+     * [List Inventory Items](https://docs.acmekit.com/api/admin#inventory-items_getinventoryitems)
+     * API route.
+     *
+     * @param query - Filters and pagination configurations.
+     * @param headers - Headers to pass in the request.
+     * @returns The paginated list of inventory items.
+     *
+     * @example
+     * To retrieve the list of inventory items:
+     *
+     * ```ts
+     * sdk.admin.inventoryItem.list()
+     * .then(({ inventory_items, count, limit, offset }) => {
+     *   console.log(inventory_items)
+     * })
+     * ```
+     *
+     * To configure the pagination, pass the `limit` and `offset` query parameters.
+     *
+     * For example, to retrieve only 10 items and skip 10 items:
+     *
+     * ```ts
+     * sdk.admin.inventoryItem.list({
+     *   limit: 10,
+     *   offset: 10
+     * })
+     * .then(({ inventory_items, count, limit, offset }) => {
+     *   console.log(inventory_items)
+     * })
+     * ```
+     *
+     * Using the `fields` query parameter, you can specify the fields and relations to retrieve
+     * in each inventory item:
+     *
+     * ```ts
+     * sdk.admin.inventoryItem.list({
+     *   fields: "id,*location_levels"
+     * })
+     * .then(({ inventory_items, count, limit, offset }) => {
+     *   console.log(inventory_items)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.acmekit.com/api/store#select-fields-and-relations).
+     */
+    list(query?: HttpTypes.AdminInventoryItemsParams, headers?: ClientHeaders): Promise<HttpTypes.AdminInventoryItemListResponse>;
+    /**
+     * This method retrieves an inventory item by its ID. It sends a request to the
+     * [Get Inventory Item](https://docs.acmekit.com/api/admin#inventory-items_getinventoryitemsid) API route.
+     *
+     * @param id - The inventory item's ID.
+     * @param query - Configure the fields to retrieve in the inventory item.
+     * @param headers - Headers to pass in the request
+     * @returns The inventory item's details.
+     *
+     * @example
+     * To retrieve an inventory item by its ID:
+     *
+     * ```ts
+     * sdk.admin.inventoryItem.retrieve("iitem_123")
+     * .then(({ inventory_item }) => {
+     *   console.log(inventory_item)
+     * })
+     * ```
+     *
+     * To specify the fields and relations to retrieve:
+     *
+     * ```ts
+     * sdk.admin.inventoryItem.retrieve("iitem_123", {
+     *   fields: "id,*location_levels"
+     * })
+     * .then(({ inventory_item }) => {
+     *   console.log(inventory_item)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.acmekit.com/api/store#select-fields-and-relations).
+     */
+    retrieve(id: string, query?: SelectParams, headers?: ClientHeaders): Promise<HttpTypes.AdminInventoryItemResponse>;
+    /**
+     * This method deletes an inventory item. This sends a request to the
+     * [Delete Inventory Item](https://docs.acmekit.com/api/admin#inventory-items_deleteinventoryitemsid)
+     * API route.
+     *
+     * @param id - The inventory item's ID.
+     * @param headers - Headers to pass in the request
+     * @returns The deletion's details.
+     *
+     * @example
+     * sdk.admin.inventoryItem.delete("iitem_123")
+     * .then(({ deleted }) => {
+     *   console.log(deleted)
+     * })
+     */
+    delete(id: string, headers?: ClientHeaders): Promise<HttpTypes.AdminInventoryItemDeleteResponse>;
+    /**
+     * This method retrieves a paginated list of inventory levels that belong to an inventory item.
+     * It sends a request to the [List Inventory Items](https://docs.acmekit.com/api/admin#inventory-items_getinventoryitems)
+     * API route.
+     *
+     * @param id - The inventory item's ID.
+     * @param query - Filters and pagination configurations.
+     * @param headers - Headers to pass in the request.
+     * @returns The paginated list of inventory levels.
+     *
+     * @example
+     * To retrieve the list of inventory levels:
+     *
+     * ```ts
+     * sdk.admin.inventoryItem.listLevels("iitem_123")
+     * .then(({ inventory_levels, count, limit, offset }) => {
+     *   console.log(inventory_levels)
+     * })
+     * ```
+     *
+     * To configure the pagination, pass the `limit` and `offset` query parameters.
+     *
+     * For example, to retrieve only 10 items and skip 10 items:
+     *
+     * ```ts
+     * sdk.admin.inventoryItem.listLevels("iitem_123", {
+     *   limit: 10,
+     *   offset: 10
+     * })
+     * .then(({ inventory_levels, count, limit, offset }) => {
+     *   console.log(inventory_levels)
+     * })
+     * ```
+     *
+     * Using the `fields` query parameter, you can specify the fields and relations to retrieve
+     * in each inventory level:
+     *
+     * ```ts
+     * sdk.admin.inventoryItem.listLevels("iitem_123", {
+     *   fields: "id,*inventory_item"
+     * })
+     * .then(({ inventory_levels, count, limit, offset }) => {
+     *   console.log(inventory_levels)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.acmekit.com/api/store#select-fields-and-relations).
+     */
+    listLevels(id: string, query?: HttpTypes.AdminInventoryLevelFilters, headers?: ClientHeaders): Promise<HttpTypes.AdminInventoryLevelListResponse>;
+    /**
+     * This method updates the inventory level of the specified inventory item and
+     * stock location.
+     *
+     * This method sends a request to the
+     * [Update Inventory Level](https://docs.acmekit.com/api/admin#inventory-items_postinventoryitemsidlocationlevelslocation_id)
+     * API route.
+     *
+     * @param id - The inventory item's ID.
+     * @param locationId - The stock location's ID.
+     * @param body - The details to update.
+     * @param query - Configure the fields to retrieve in the inventory item.
+     * @param headers - Headers to pass in the request
+     * @returns The inventory item's details.
+     *
+     * @example
+     * sdk.admin.inventoryItem.updateLevel(
+     *   "iitem_123",
+     *   "sloc_123",
+     *   {
+     *     stocked_quantity: 10
+     *   }
+     * )
+     * .then(({ inventory_item }) => {
+     *   console.log(inventory_item)
+     * })
+     */
+    updateLevel(id: string, locationId: string, body: HttpTypes.AdminUpdateInventoryLevel, query?: SelectParams, headers?: ClientHeaders): Promise<HttpTypes.AdminInventoryItemResponse>;
+    /**
+     * This method deletes an inventory level associated with an inventory item
+     * and a stock location.
+     *
+     * This method sends a request to the
+     * [Remove Inventory Level](https://docs.acmekit.com/api/admin#inventory-items_deleteinventoryitemsidlocationlevelslocation_id)
+     * API route.
+     *
+     * @param id - The inventory item's ID.
+     * @param locationId - The stock location's ID.
+     * @param headers - Headers to pass in the request
+     * @returns The deletion's details.
+     *
+     * @example
+     * sdk.admin.inventoryItem.deleteLevel(
+     *   "iitem_123",
+     *   "sloc_123",
+     * )
+     * .then(({ deleted, parent: inventoryItem }) => {
+     *   console.log(deleted, inventoryItem)
+     * })
+     */
+    deleteLevel(id: string, locationId: string, headers?: ClientHeaders): Promise<HttpTypes.AdminInventoryLevelDeleteResponse>;
+    /**
+     * This method manages the inventory levels of an inventory item. It sends a request to the
+     * [Manage Inventory Levels](https://docs.acmekit.com/api/admin#inventory-items_postinventoryitemsidlocationlevelsbatch)
+     * API route.
+     *
+     * @deprecated Use `batchInventoryItemLocationLevels` instead.
+     *
+     * @param id - The inventory item's ID.
+     * @param body - The inventory levels to create or delete.
+     * @param query - Configure the fields to retrieve in the inventory item.
+     * @param headers - Headers to pass in the request
+     * @returns The inventory item's details.
+     *
+     * @example
+     * sdk.admin.inventoryItem.batchUpdateLevels("iitem_123", {
+     *   create: [{
+     *     location_id: "sloc_123",
+     *     stocked_quantity: 10
+     *   }],
+     *   delete: ["ilvl_123"]
+     * })
+     * .then(({ created, updated, deleted }) => {
+     *   console.log(created, updated, deleted)
+     * })
+     */
+    batchUpdateLevels(id: string, body: HttpTypes.AdminBatchInventoryItemLocationLevels, query?: SelectParams, headers?: ClientHeaders): Promise<HttpTypes.AdminBatchInventoryItemLocationLevelsResponse>;
+    /**
+     * This method manages the inventory levels of an inventory item. It sends a request to the
+     * [Manage Inventory Levels](https://docs.acmekit.com/api/admin#inventory-items_postinventoryitemsidlocationlevelsbatch)
+     * API route.
+     *
+     * @param id - The inventory item's ID.
+     * @param body - The inventory levels to create, update or delete, and an optional `force` flag.
+     * @param headers - Headers to pass in the request
+     * @returns The inventory item's details.
+     *
+     * @example
+     * sdk.admin.inventoryItem.batchInventoryItemLocationLevels("iitem_123", {
+     *   create: [{
+     *     location_id: "sloc_123",
+     *     stocked_quantity: 10
+     *   }],
+     *   delete: ["ilvl_123"]
+     * })
+     * .then(({ created, updated, deleted }) => {
+     *   console.log(created, updated, deleted)
+     * })
+     */
+    batchInventoryItemLocationLevels(id: string, body: HttpTypes.AdminBatchInventoryItemLocationLevels, headers?: ClientHeaders): Promise<HttpTypes.AdminBatchInventoryItemLocationLevelsResponse>;
+    /**
+     * This method manages the inventory levels of multiple inventory items.
+     *
+     * @param body - The inventory levels to create, update or delete, and an optional `force` flag.
+     * @param headers - Headers to pass in the request
+     * @returns The inventory item's details.
+     *
+     * @example
+     * sdk.admin.inventoryItem.batchInventoryItemsLocationLevels({
+     *   create: [{
+     *     inventory_item_id: "iitem_123",
+     *     location_id: "sloc_123",
+     *     stocked_quantity: 10
+     *   }],
+     *   delete: ["ilvl_123"]
+     * })
+     * .then(({ created, updated, deleted }) => {
+     *   console.log(created, updated, deleted)
+     * })
+     */
+    batchInventoryItemsLocationLevels(body: HttpTypes.AdminBatchInventoryItemsLocationLevels, headers?: ClientHeaders): Promise<HttpTypes.AdminBatchInventoryItemsLocationLevelsResponse>;
+}
+//# sourceMappingURL=inventory-item.d.ts.map

package/dist/esm/admin/inventory-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory-item.d.ts","sourceRoot":"","sources":["../../../src/admin/inventory-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,qBAAa,aAAa;IACxB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAQ;IACtB;;OAEG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CACV,IAAI,EAAE,SAAS,CAAC,wBAAwB,EACxC,KAAK,CAAC,EAAE,SAAS,CAAC,YAAY,EAC9B,OAAO,CAAC,EAAE,aAAa;IAazB;;;;;;;;;;;;;;;;;;OAkBG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,SAAS,CAAC,wBAAwB,EACxC,KAAK,CAAC,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,aAAa;IAazB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACG,IAAI,CACR,KAAK,CAAC,EAAE,SAAS,CAAC,yBAAyB,EAC3C,OAAO,CAAC,EAAE,aAAa;IAWzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,aAAa;IAUxE;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IAUhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+CG;IACG,UAAU,CACd,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,SAAS,CAAC,0BAA0B,EAC5C,OAAO,CAAC,EAAE,aAAa;IAWzB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,WAAW,CACf,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,CAAC,yBAAyB,EACzC,KAAK,CAAC,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,aAAa;IAazB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IAUzE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,iBAAiB,CACrB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,SAAS,CAAC,qCAAqC,EACrD,KAAK,CAAC,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,aAAa;IAazB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,gCAAgC,CACpC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,SAAS,CAAC,qCAAqC,EACrD,OAAO,CAAC,EAAE,aAAa;IAYzB;;;;;;;;;;;;;;;;;;;OAmBG;IACG,iCAAiC,CACrC,IAAI,EAAE,SAAS,CAAC,sCAAsC,EACtD,OAAO,CAAC,EAAE,aAAa;CAW1B"}