@payloadcms/plugin-ecommerce 3.71.0-internal.ef75fa0 → 3.71.0

package/dist/collections/carts/operations/removeItem.js

@@ -0,0 +1,69 @@
+import { createRequestWithSecret } from './createRequestWithSecret.js';
+/**
+ * Removes an item from a cart by its row ID.
+ *
+ * This handler is isolated and can be used from:
+ * - Custom endpoints
+ * - Local API operations
+ * - Hooks
+ *
+ * @example
+ * ```ts
+ * const result = await removeItem({
+ *   payload,
+ *   cartsSlug: 'carts',
+ *   cartID: '123',
+ *   itemID: 'item-row-id',
+ * })
+ * ```
+ */ export const removeItem = async (args)=>{
+    const { cartID, cartsSlug, itemID, payload, req, secret } = args;
+    // Inject secret into request context for access control
+    const reqWithSecret = createRequestWithSecret(req, secret);
+    const cart = await payload.findByID({
+        id: cartID,
+        collection: cartsSlug,
+        depth: 0,
+        overrideAccess: false,
+        req: reqWithSecret
+    });
+    if (!cart) {
+        return {
+            cart: null,
+            message: `Cart with ID ${cartID} not found`,
+            success: false
+        };
+    }
+    const existingItems = cart.items || [];
+    // Find the item by its row ID
+    const itemIndex = existingItems.findIndex((item)=>item.id === itemID);
+    if (itemIndex === -1) {
+        return {
+            cart,
+            message: `Item with ID ${itemID} not found in cart`,
+            success: false
+        };
+    }
+    // Remove the item
+    const updatedItems = [
+        ...existingItems
+    ];
+    updatedItems.splice(itemIndex, 1);
+    const updatedCart = await payload.update({
+        id: cartID,
+        collection: cartsSlug,
+        data: {
+            items: updatedItems
+        },
+        depth: 0,
+        overrideAccess: false,
+        req: reqWithSecret
+    });
+    return {
+        cart: updatedCart,
+        message: 'Item removed from cart',
+        success: true
+    };
+};
+
+//# sourceMappingURL=removeItem.js.map

package/dist/collections/carts/operations/removeItem.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/collections/carts/operations/removeItem.ts"],"sourcesContent":["import type { CartItemData, CartOperationResult, RemoveItemArgs } from './types.js'\n\nimport { createRequestWithSecret } from './createRequestWithSecret.js'\n\n/**\n * Removes an item from a cart by its row ID.\n *\n * This handler is isolated and can be used from:\n * - Custom endpoints\n * - Local API operations\n * - Hooks\n *\n * @example\n * ```ts\n * const result = await removeItem({\n *   payload,\n *   cartsSlug: 'carts',\n *   cartID: '123',\n *   itemID: 'item-row-id',\n * })\n * ```\n */\nexport const removeItem = async (args: RemoveItemArgs): Promise<CartOperationResult> => {\n  const { cartID, cartsSlug, itemID, payload, req, secret } = args\n\n  // Inject secret into request context for access control\n  const reqWithSecret = createRequestWithSecret(req, secret)\n\n  const cart = await payload.findByID({\n    id: cartID,\n    collection: cartsSlug,\n    depth: 0,\n    overrideAccess: false,\n    req: reqWithSecret,\n  })\n\n  if (!cart) {\n    return {\n      cart: null,\n      message: `Cart with ID ${cartID} not found`,\n      success: false,\n    }\n  }\n\n  const existingItems: CartItemData[] = (cart.items as CartItemData[]) || []\n\n  // Find the item by its row ID\n  const itemIndex = existingItems.findIndex((item) => item.id === itemID)\n\n  if (itemIndex === -1) {\n    return {\n      cart,\n      message: `Item with ID ${itemID} not found in cart`,\n      success: false,\n    }\n  }\n\n  // Remove the item\n  const updatedItems = [...existingItems]\n  updatedItems.splice(itemIndex, 1)\n\n  const updatedCart = await payload.update({\n    id: cartID,\n    collection: cartsSlug,\n    data: {\n      items: updatedItems,\n    },\n    depth: 0,\n    overrideAccess: false,\n    req: reqWithSecret,\n  })\n\n  return {\n    cart: updatedCart,\n    message: 'Item removed from cart',\n    success: true,\n  }\n}\n"],"names":["createRequestWithSecret","removeItem","args","cartID","cartsSlug","itemID","payload","req","secret","reqWithSecret","cart","findByID","id","collection","depth","overrideAccess","message","success","existingItems","items","itemIndex","findIndex","item","updatedItems","splice","updatedCart","update","data"],"mappings":"AAEA,SAASA,uBAAuB,QAAQ,+BAA8B;AAEtE;;;;;;;;;;;;;;;;;CAiBC,GACD,OAAO,MAAMC,aAAa,OAAOC;IAC/B,MAAM,EAAEC,MAAM,EAAEC,SAAS,EAAEC,MAAM,EAAEC,OAAO,EAAEC,GAAG,EAAEC,MAAM,EAAE,GAAGN;IAE5D,wDAAwD;IACxD,MAAMO,gBAAgBT,wBAAwBO,KAAKC;IAEnD,MAAME,OAAO,MAAMJ,QAAQK,QAAQ,CAAC;QAClCC,IAAIT;QACJU,YAAYT;QACZU,OAAO;QACPC,gBAAgB;QAChBR,KAAKE;IACP;IAEA,IAAI,CAACC,MAAM;QACT,OAAO;YACLA,MAAM;YACNM,SAAS,CAAC,aAAa,EAAEb,OAAO,UAAU,CAAC;YAC3Cc,SAAS;QACX;IACF;IAEA,MAAMC,gBAAgC,AAACR,KAAKS,KAAK,IAAuB,EAAE;IAE1E,8BAA8B;IAC9B,MAAMC,YAAYF,cAAcG,SAAS,CAAC,CAACC,OAASA,KAAKV,EAAE,KAAKP;IAEhE,IAAIe,cAAc,CAAC,GAAG;QACpB,OAAO;YACLV;YACAM,SAAS,CAAC,aAAa,EAAEX,OAAO,kBAAkB,CAAC;YACnDY,SAAS;QACX;IACF;IAEA,kBAAkB;IAClB,MAAMM,eAAe;WAAIL;KAAc;IACvCK,aAAaC,MAAM,CAACJ,WAAW;IAE/B,MAAMK,cAAc,MAAMnB,QAAQoB,MAAM,CAAC;QACvCd,IAAIT;QACJU,YAAYT;QACZuB,MAAM;YACJR,OAAOI;QACT;QACAT,OAAO;QACPC,gBAAgB;QAChBR,KAAKE;IACP;IAEA,OAAO;QACLC,MAAMe;QACNT,SAAS;QACTC,SAAS;IACX;AACF,EAAC"}

package/dist/collections/carts/operations/types.d.ts

@@ -0,0 +1,152 @@
+import type { DefaultDocumentIDType, Payload, PayloadRequest } from 'payload';
+/**
+ * Represents an item in the cart with populated or ID references.
+ */
+export type CartItemData = {
+    [key: string]: unknown;
+    /**
+     * The ID of the cart item. Array item IDs are always strings in Payload,
+     * regardless of the database adapter's default ID type.
+     */
+    id?: string;
+    product: {
+        [key: string]: unknown;
+        id: DefaultDocumentIDType;
+    } | DefaultDocumentIDType;
+    quantity: number;
+    variant?: {
+        [key: string]: unknown;
+        id: DefaultDocumentIDType;
+    } | DefaultDocumentIDType;
+};
+/**
+ * Represents a new item to be added to the cart.
+ */
+export type NewCartItem = {
+    [key: string]: unknown;
+    product: DefaultDocumentIDType;
+    quantity?: number;
+    variant?: DefaultDocumentIDType;
+};
+/**
+ * Arguments for the cart item matcher function.
+ */
+export type CartItemMatcherArgs = {
+    /** The existing cart item to compare against */
+    existingItem: CartItemData;
+    /** The new item being added */
+    newItem: NewCartItem;
+};
+/**
+ * Function to determine if two cart items should be considered the same.
+ * When items match, their quantities are combined instead of creating separate entries.
+ */
+export type CartItemMatcher = (args: CartItemMatcherArgs) => boolean;
+/**
+ * MongoDB-style update operator for numeric fields.
+ * Supports $inc for increment/decrement operations.
+ *
+ * @example
+ * ```ts
+ * // Set quantity to 5
+ * { quantity: 5 }
+ *
+ * // Increment quantity by 1
+ * { quantity: { $inc: 1 } }
+ *
+ * // Decrement quantity by 2
+ * { quantity: { $inc: -2 } }
+ * ```
+ */
+export type NumericOperator = {
+    /** Increment by this value (use negative to decrement) */
+    $inc: number;
+};
+/**
+ * A field value that can be either a direct value or an operator.
+ */
+export type FieldWithOperator<T> = NumericOperator | T;
+/**
+ * Checks if a value is a NumericOperator.
+ */
+export declare function isNumericOperator(value: unknown): value is NumericOperator;
+/**
+ * Base arguments for all cart operations.
+ */
+export type BaseCartOperationArgs = {
+    /** The cart ID to operate on */
+    cartID: DefaultDocumentIDType;
+    /** The carts collection slug */
+    cartsSlug: string;
+    /** Payload instance */
+    payload: Payload;
+    /** Optional request context for access control */
+    req?: PayloadRequest;
+    /** Secret for guest cart access */
+    secret?: string;
+};
+/**
+ * Arguments for the addItem operation.
+ */
+export type AddItemArgs = {
+    /** Custom matcher function to determine item uniqueness */
+    cartItemMatcher?: CartItemMatcher;
+    /** The item to add */
+    item: NewCartItem;
+    /** Quantity to add (defaults to 1) */
+    quantity?: number;
+} & BaseCartOperationArgs;
+/**
+ * Arguments for the removeItem operation.
+ */
+export type RemoveItemArgs = {
+    /**
+     * The cart item row ID to remove.
+     * Array item IDs are always strings in Payload, regardless of the database adapter's default ID type.
+     */
+    itemID: string;
+} & BaseCartOperationArgs;
+/**
+ * Arguments for the updateItem operation.
+ * Supports MongoDB-style operators for flexible updates.
+ */
+export type UpdateItemArgs = {
+    /**
+     * The cart item row ID to update.
+     * Array item IDs are always strings in Payload, regardless of the database adapter's default ID type.
+     */
+    itemID: string;
+    /**
+     * The quantity value or operator.
+     * - Direct number: Sets the quantity to this value
+     * - { $inc: n }: Increments quantity by n (use negative to decrement)
+     *
+     * @example
+     * ```ts
+     * // Set quantity to 5
+     * { quantity: 5 }
+     *
+     * // Increment by 1
+     * { quantity: { $inc: 1 } }
+     *
+     * // Decrement by 1
+     * { quantity: { $inc: -1 } }
+     * ```
+     */
+    quantity: FieldWithOperator<number>;
+    /** Whether to remove the item if quantity reaches 0 (defaults to true) */
+    removeOnZero?: boolean;
+} & BaseCartOperationArgs;
+/**
+ * Arguments for the clearCart operation.
+ */
+export type ClearCartArgs = BaseCartOperationArgs;
+/**
+ * Result of a cart operation.
+ */
+export type CartOperationResult<T = unknown> = {
+    cart: T;
+    message: string;
+    success: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/collections/carts/operations/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/collections/carts/operations/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7E;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,EAAE,EAAE,qBAAqB,CAAA;KAAE,GAAG,qBAAqB,CAAA;IACtF,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,EAAE,EAAE,qBAAqB,CAAA;KAAE,GAAG,qBAAqB,CAAA;CACxF,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,OAAO,EAAE,qBAAqB,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,qBAAqB,CAAA;CAChC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,gDAAgD;IAChD,YAAY,EAAE,YAAY,CAAA;IAC1B,+BAA+B;IAC/B,OAAO,EAAE,WAAW,CAAA;CACrB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAA;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,eAAe,GAAG,CAAC,CAAA;AAEtD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,gCAAgC;IAChC,MAAM,EAAE,qBAAqB,CAAA;IAC7B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,kDAAkD;IAClD,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,sBAAsB;IACtB,IAAI,EAAE,WAAW,CAAA;IACjB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,qBAAqB,CAAA;AAEzB;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,qBAAqB,CAAA;AAEzB;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAA;IACnC,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,GAAG,qBAAqB,CAAA;AAEzB;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAAA;AAEjD;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC7C,IAAI,EAAE,CAAC,CAAA;IACP,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA"}

package/dist/collections/carts/operations/types.js

@@ -0,0 +1,7 @@
+/**
+ * Checks if a value is a NumericOperator.
+ */ export function isNumericOperator(value) {
+    return typeof value === 'object' && value !== null && '$inc' in value;
+}
+
+//# sourceMappingURL=types.js.map

package/dist/collections/carts/operations/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/collections/carts/operations/types.ts"],"sourcesContent":["import type { DefaultDocumentIDType, Payload, PayloadRequest } from 'payload'\n\n/**\n * Represents an item in the cart with populated or ID references.\n */\nexport type CartItemData = {\n  [key: string]: unknown\n  /**\n   * The ID of the cart item. Array item IDs are always strings in Payload,\n   * regardless of the database adapter's default ID type.\n   */\n  id?: string\n  product: { [key: string]: unknown; id: DefaultDocumentIDType } | DefaultDocumentIDType\n  quantity: number\n  variant?: { [key: string]: unknown; id: DefaultDocumentIDType } | DefaultDocumentIDType\n}\n\n/**\n * Represents a new item to be added to the cart.\n */\nexport type NewCartItem = {\n  [key: string]: unknown\n  product: DefaultDocumentIDType\n  quantity?: number\n  variant?: DefaultDocumentIDType\n}\n\n/**\n * Arguments for the cart item matcher function.\n */\nexport type CartItemMatcherArgs = {\n  /** The existing cart item to compare against */\n  existingItem: CartItemData\n  /** The new item being added */\n  newItem: NewCartItem\n}\n\n/**\n * Function to determine if two cart items should be considered the same.\n * When items match, their quantities are combined instead of creating separate entries.\n */\nexport type CartItemMatcher = (args: CartItemMatcherArgs) => boolean\n\n/**\n * MongoDB-style update operator for numeric fields.\n * Supports $inc for increment/decrement operations.\n *\n * @example\n * ```ts\n * // Set quantity to 5\n * { quantity: 5 }\n *\n * // Increment quantity by 1\n * { quantity: { $inc: 1 } }\n *\n * // Decrement quantity by 2\n * { quantity: { $inc: -2 } }\n * ```\n */\nexport type NumericOperator = {\n  /** Increment by this value (use negative to decrement) */\n  $inc: number\n}\n\n/**\n * A field value that can be either a direct value or an operator.\n */\nexport type FieldWithOperator<T> = NumericOperator | T\n\n/**\n * Checks if a value is a NumericOperator.\n */\nexport function isNumericOperator(value: unknown): value is NumericOperator {\n  return typeof value === 'object' && value !== null && '$inc' in value\n}\n\n/**\n * Base arguments for all cart operations.\n */\nexport type BaseCartOperationArgs = {\n  /** The cart ID to operate on */\n  cartID: DefaultDocumentIDType\n  /** The carts collection slug */\n  cartsSlug: string\n  /** Payload instance */\n  payload: Payload\n  /** Optional request context for access control */\n  req?: PayloadRequest\n  /** Secret for guest cart access */\n  secret?: string\n}\n\n/**\n * Arguments for the addItem operation.\n */\nexport type AddItemArgs = {\n  /** Custom matcher function to determine item uniqueness */\n  cartItemMatcher?: CartItemMatcher\n  /** The item to add */\n  item: NewCartItem\n  /** Quantity to add (defaults to 1) */\n  quantity?: number\n} & BaseCartOperationArgs\n\n/**\n * Arguments for the removeItem operation.\n */\nexport type RemoveItemArgs = {\n  /**\n   * The cart item row ID to remove.\n   * Array item IDs are always strings in Payload, regardless of the database adapter's default ID type.\n   */\n  itemID: string\n} & BaseCartOperationArgs\n\n/**\n * Arguments for the updateItem operation.\n * Supports MongoDB-style operators for flexible updates.\n */\nexport type UpdateItemArgs = {\n  /**\n   * The cart item row ID to update.\n   * Array item IDs are always strings in Payload, regardless of the database adapter's default ID type.\n   */\n  itemID: string\n  /**\n   * The quantity value or operator.\n   * - Direct number: Sets the quantity to this value\n   * - { $inc: n }: Increments quantity by n (use negative to decrement)\n   *\n   * @example\n   * ```ts\n   * // Set quantity to 5\n   * { quantity: 5 }\n   *\n   * // Increment by 1\n   * { quantity: { $inc: 1 } }\n   *\n   * // Decrement by 1\n   * { quantity: { $inc: -1 } }\n   * ```\n   */\n  quantity: FieldWithOperator<number>\n  /** Whether to remove the item if quantity reaches 0 (defaults to true) */\n  removeOnZero?: boolean\n} & BaseCartOperationArgs\n\n/**\n * Arguments for the clearCart operation.\n */\nexport type ClearCartArgs = BaseCartOperationArgs\n\n/**\n * Result of a cart operation.\n */\nexport type CartOperationResult<T = unknown> = {\n  cart: T\n  message: string\n  success: boolean\n}\n"],"names":["isNumericOperator","value"],"mappings":"AAqEA;;CAEC,GACD,OAAO,SAASA,kBAAkBC,KAAc;IAC9C,OAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,UAAUA;AAClE"}

package/dist/collections/carts/operations/updateItem.d.ts

@@ -0,0 +1,41 @@
+import type { CartOperationResult, UpdateItemArgs } from './types.js';
+/**
+ * Updates an item in the cart using MongoDB-style operators.
+ *
+ * This handler is isolated and can be used from:
+ * - Custom endpoints
+ * - Local API operations
+ * - Hooks
+ *
+ * @example
+ * ```ts
+ * // Set quantity to 5
+ * const result = await updateItem({
+ *   payload,
+ *   cartsSlug: 'carts',
+ *   cartID: '123',
+ *   itemID: 'item-row-id',
+ *   quantity: 5,
+ * })
+ *
+ * // Increment by 1
+ * const result = await updateItem({
+ *   payload,
+ *   cartsSlug: 'carts',
+ *   cartID: '123',
+ *   itemID: 'item-row-id',
+ *   quantity: { $inc: 1 },
+ * })
+ *
+ * // Decrement by 2
+ * const result = await updateItem({
+ *   payload,
+ *   cartsSlug: 'carts',
+ *   cartID: '123',
+ *   itemID: 'item-row-id',
+ *   quantity: { $inc: -2 },
+ * })
+ * ```
+ */
+export declare const updateItem: (args: UpdateItemArgs) => Promise<CartOperationResult>;
+//# sourceMappingURL=updateItem.d.ts.map

package/dist/collections/carts/operations/updateItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateItem.d.ts","sourceRoot":"","sources":["../../../../src/collections/carts/operations/updateItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAKnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,UAAU,SAAgB,cAAc,KAAG,OAAO,CAAC,mBAAmB,CA8ElF,CAAA"}

package/dist/collections/carts/operations/updateItem.js

@@ -0,0 +1,110 @@
+import { createRequestWithSecret } from './createRequestWithSecret.js';
+import { isNumericOperator } from './types.js';
+/**
+ * Updates an item in the cart using MongoDB-style operators.
+ *
+ * This handler is isolated and can be used from:
+ * - Custom endpoints
+ * - Local API operations
+ * - Hooks
+ *
+ * @example
+ * ```ts
+ * // Set quantity to 5
+ * const result = await updateItem({
+ *   payload,
+ *   cartsSlug: 'carts',
+ *   cartID: '123',
+ *   itemID: 'item-row-id',
+ *   quantity: 5,
+ * })
+ *
+ * // Increment by 1
+ * const result = await updateItem({
+ *   payload,
+ *   cartsSlug: 'carts',
+ *   cartID: '123',
+ *   itemID: 'item-row-id',
+ *   quantity: { $inc: 1 },
+ * })
+ *
+ * // Decrement by 2
+ * const result = await updateItem({
+ *   payload,
+ *   cartsSlug: 'carts',
+ *   cartID: '123',
+ *   itemID: 'item-row-id',
+ *   quantity: { $inc: -2 },
+ * })
+ * ```
+ */ export const updateItem = async (args)=>{
+    const { cartID, cartsSlug, itemID, payload, quantity, removeOnZero = true, req, secret } = args;
+    // Inject secret into request context for access control
+    const reqWithSecret = createRequestWithSecret(req, secret);
+    const cart = await payload.findByID({
+        id: cartID,
+        collection: cartsSlug,
+        depth: 0,
+        overrideAccess: false,
+        req: reqWithSecret
+    });
+    if (!cart) {
+        return {
+            cart: null,
+            message: `Cart with ID ${cartID} not found`,
+            success: false
+        };
+    }
+    const existingItems = cart.items || [];
+    // Find the item by its row ID
+    const itemIndex = existingItems.findIndex((item)=>item.id === itemID);
+    if (itemIndex === -1) {
+        return {
+            cart,
+            message: `Item with ID ${itemID} not found in cart`,
+            success: false
+        };
+    }
+    const updatedItems = [
+        ...existingItems
+    ];
+    const existingItem = updatedItems[itemIndex];
+    const currentQuantity = existingItem.quantity;
+    // Calculate new quantity based on operator or direct value
+    let newQuantity;
+    if (isNumericOperator(quantity)) {
+        // $inc operator: add to current value
+        newQuantity = currentQuantity + quantity.$inc;
+    } else {
+        // Direct value: set to this value
+        newQuantity = quantity;
+    }
+    if (newQuantity <= 0 && removeOnZero) {
+        // Remove the item if quantity reaches 0 or below
+        updatedItems.splice(itemIndex, 1);
+    } else {
+        // Update the quantity (minimum 1 if not removing on zero)
+        updatedItems[itemIndex] = {
+            ...existingItem,
+            quantity: removeOnZero ? newQuantity : Math.max(1, newQuantity)
+        };
+    }
+    const updatedCart = await payload.update({
+        id: cartID,
+        collection: cartsSlug,
+        data: {
+            items: updatedItems
+        },
+        depth: 0,
+        overrideAccess: false,
+        req: reqWithSecret
+    });
+    const wasRemoved = newQuantity <= 0 && removeOnZero;
+    return {
+        cart: updatedCart,
+        message: wasRemoved ? 'Item removed from cart' : 'Item quantity updated',
+        success: true
+    };
+};
+
+//# sourceMappingURL=updateItem.js.map

package/dist/collections/carts/operations/updateItem.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/collections/carts/operations/updateItem.ts"],"sourcesContent":["import type { CartItemData, CartOperationResult, UpdateItemArgs } from './types.js'\n\nimport { createRequestWithSecret } from './createRequestWithSecret.js'\nimport { isNumericOperator } from './types.js'\n\n/**\n * Updates an item in the cart using MongoDB-style operators.\n *\n * This handler is isolated and can be used from:\n * - Custom endpoints\n * - Local API operations\n * - Hooks\n *\n * @example\n * ```ts\n * // Set quantity to 5\n * const result = await updateItem({\n *   payload,\n *   cartsSlug: 'carts',\n *   cartID: '123',\n *   itemID: 'item-row-id',\n *   quantity: 5,\n * })\n *\n * // Increment by 1\n * const result = await updateItem({\n *   payload,\n *   cartsSlug: 'carts',\n *   cartID: '123',\n *   itemID: 'item-row-id',\n *   quantity: { $inc: 1 },\n * })\n *\n * // Decrement by 2\n * const result = await updateItem({\n *   payload,\n *   cartsSlug: 'carts',\n *   cartID: '123',\n *   itemID: 'item-row-id',\n *   quantity: { $inc: -2 },\n * })\n * ```\n */\nexport const updateItem = async (args: UpdateItemArgs): Promise<CartOperationResult> => {\n  const { cartID, cartsSlug, itemID, payload, quantity, removeOnZero = true, req, secret } = args\n\n  // Inject secret into request context for access control\n  const reqWithSecret = createRequestWithSecret(req, secret)\n\n  const cart = await payload.findByID({\n    id: cartID,\n    collection: cartsSlug,\n    depth: 0,\n    overrideAccess: false,\n    req: reqWithSecret,\n  })\n\n  if (!cart) {\n    return {\n      cart: null,\n      message: `Cart with ID ${cartID} not found`,\n      success: false,\n    }\n  }\n\n  const existingItems: CartItemData[] = (cart.items as CartItemData[]) || []\n\n  // Find the item by its row ID\n  const itemIndex = existingItems.findIndex((item) => item.id === itemID)\n\n  if (itemIndex === -1) {\n    return {\n      cart,\n      message: `Item with ID ${itemID} not found in cart`,\n      success: false,\n    }\n  }\n\n  const updatedItems = [...existingItems]\n  const existingItem = updatedItems[itemIndex]!\n  const currentQuantity = existingItem.quantity\n\n  // Calculate new quantity based on operator or direct value\n  let newQuantity: number\n  if (isNumericOperator(quantity)) {\n    // $inc operator: add to current value\n    newQuantity = currentQuantity + quantity.$inc\n  } else {\n    // Direct value: set to this value\n    newQuantity = quantity\n  }\n\n  if (newQuantity <= 0 && removeOnZero) {\n    // Remove the item if quantity reaches 0 or below\n    updatedItems.splice(itemIndex, 1)\n  } else {\n    // Update the quantity (minimum 1 if not removing on zero)\n    updatedItems[itemIndex] = {\n      ...existingItem,\n      quantity: removeOnZero ? newQuantity : Math.max(1, newQuantity),\n    }\n  }\n\n  const updatedCart = await payload.update({\n    id: cartID,\n    collection: cartsSlug,\n    data: {\n      items: updatedItems,\n    },\n    depth: 0,\n    overrideAccess: false,\n    req: reqWithSecret,\n  })\n\n  const wasRemoved = newQuantity <= 0 && removeOnZero\n\n  return {\n    cart: updatedCart,\n    message: wasRemoved ? 'Item removed from cart' : 'Item quantity updated',\n    success: true,\n  }\n}\n"],"names":["createRequestWithSecret","isNumericOperator","updateItem","args","cartID","cartsSlug","itemID","payload","quantity","removeOnZero","req","secret","reqWithSecret","cart","findByID","id","collection","depth","overrideAccess","message","success","existingItems","items","itemIndex","findIndex","item","updatedItems","existingItem","currentQuantity","newQuantity","$inc","splice","Math","max","updatedCart","update","data","wasRemoved"],"mappings":"AAEA,SAASA,uBAAuB,QAAQ,+BAA8B;AACtE,SAASC,iBAAiB,QAAQ,aAAY;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCC,GACD,OAAO,MAAMC,aAAa,OAAOC;IAC/B,MAAM,EAAEC,MAAM,EAAEC,SAAS,EAAEC,MAAM,EAAEC,OAAO,EAAEC,QAAQ,EAAEC,eAAe,IAAI,EAAEC,GAAG,EAAEC,MAAM,EAAE,GAAGR;IAE3F,wDAAwD;IACxD,MAAMS,gBAAgBZ,wBAAwBU,KAAKC;IAEnD,MAAME,OAAO,MAAMN,QAAQO,QAAQ,CAAC;QAClCC,IAAIX;QACJY,YAAYX;QACZY,OAAO;QACPC,gBAAgB;QAChBR,KAAKE;IACP;IAEA,IAAI,CAACC,MAAM;QACT,OAAO;YACLA,MAAM;YACNM,SAAS,CAAC,aAAa,EAAEf,OAAO,UAAU,CAAC;YAC3CgB,SAAS;QACX;IACF;IAEA,MAAMC,gBAAgC,AAACR,KAAKS,KAAK,IAAuB,EAAE;IAE1E,8BAA8B;IAC9B,MAAMC,YAAYF,cAAcG,SAAS,CAAC,CAACC,OAASA,KAAKV,EAAE,KAAKT;IAEhE,IAAIiB,cAAc,CAAC,GAAG;QACpB,OAAO;YACLV;YACAM,SAAS,CAAC,aAAa,EAAEb,OAAO,kBAAkB,CAAC;YACnDc,SAAS;QACX;IACF;IAEA,MAAMM,eAAe;WAAIL;KAAc;IACvC,MAAMM,eAAeD,YAAY,CAACH,UAAU;IAC5C,MAAMK,kBAAkBD,aAAanB,QAAQ;IAE7C,2DAA2D;IAC3D,IAAIqB;IACJ,IAAI5B,kBAAkBO,WAAW;QAC/B,sCAAsC;QACtCqB,cAAcD,kBAAkBpB,SAASsB,IAAI;IAC/C,OAAO;QACL,kCAAkC;QAClCD,cAAcrB;IAChB;IAEA,IAAIqB,eAAe,KAAKpB,cAAc;QACpC,iDAAiD;QACjDiB,aAAaK,MAAM,CAACR,WAAW;IACjC,OAAO;QACL,0DAA0D;QAC1DG,YAAY,CAACH,UAAU,GAAG;YACxB,GAAGI,YAAY;YACfnB,UAAUC,eAAeoB,cAAcG,KAAKC,GAAG,CAAC,GAAGJ;QACrD;IACF;IAEA,MAAMK,cAAc,MAAM3B,QAAQ4B,MAAM,CAAC;QACvCpB,IAAIX;QACJY,YAAYX;QACZ+B,MAAM;YACJd,OAAOI;QACT;QACAT,OAAO;QACPC,gBAAgB;QAChBR,KAAKE;IACP;IAEA,MAAMyB,aAAaR,eAAe,KAAKpB;IAEvC,OAAO;QACLI,MAAMqB;QACNf,SAASkB,aAAa,2BAA2B;QACjDjB,SAAS;IACX;AACF,EAAC"}

package/dist/collections/variants/createVariantsCollection/index.d.ts

@@ -15,6 +15,10 @@ type Props = {
      * Slug of the variant options collection, defaults to 'variantOptions'.
      */
     variantOptionsSlug?: string;
+    /**
+     * Slug of the variant types collection, defaults to 'variantTypes'.
+     */
+    variantTypesSlug?: string;
 };
 export declare const createVariantsCollection: (props: Props) => CollectionConfig;
 export {};

package/dist/collections/variants/createVariantsCollection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/collections/variants/createVariantsCollection/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAS,MAAM,SAAS,CAAA;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAO9F,KAAK,KAAK,GAAG;IACX,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,wBAAwB,GAAG,SAAS,CAAC,CAAA;IAChE,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,eAAe,CAAA;IACrC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED,eAAO,MAAM,wBAAwB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,gBAqGxD,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/collections/variants/createVariantsCollection/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAS,MAAM,SAAS,CAAA;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAO9F,KAAK,KAAK,GAAG;IACX,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,wBAAwB,GAAG,SAAS,CAAC,CAAA;IAChE,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,eAAe,CAAA;IACrC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,wBAAwB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,gBA0GxD,CAAA"}

package/dist/collections/variants/createVariantsCollection/index.js

@@ -3,7 +3,7 @@ import { pricesField } from '../../../fields/pricesField.js';
 import { variantsCollectionBeforeChange as beforeChange } from './hooks/beforeChange.js';
 import { validateOptions } from './hooks/validateOptions.js';
 export const createVariantsCollection = (props)=>{
-    const { access, currenciesConfig, inventory = true, productsSlug = 'products', variantOptionsSlug = 'variantOptions' } = props || {};
+    const { access, currenciesConfig, inventory = true, productsSlug = 'products', variantOptionsSlug = 'variantOptions', variantTypesSlug = 'variantTypes' } = props || {};
     const { supportedCurrencies } = currenciesConfig || {};
     const fields = [
         {
@@ -38,11 +38,17 @@ export const createVariantsCollection = (props)=>{
                     }
                 }
             },
+            custom: {
+                productsSlug,
+                variantTypesSlug
+            },
             hasMany: true,
             label: 'Variant options',
             relationTo: variantOptionsSlug,
             required: true,
-            validate: validateOptions()
+            validate: validateOptions({
+                productsCollectionSlug: productsSlug
+            })
         },
         ...inventory ? [
             inventoryField()

package/dist/collections/variants/createVariantsCollection/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/collections/variants/createVariantsCollection/index.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nimport type { AccessConfig, CurrenciesConfig, InventoryConfig } from '../../../types/index.js'\n\nimport { inventoryField } from '../../../fields/inventoryField.js'\nimport { pricesField } from '../../../fields/pricesField.js'\nimport { variantsCollectionBeforeChange as beforeChange } from './hooks/beforeChange.js'\nimport { validateOptions } from './hooks/validateOptions.js'\n\ntype Props = {\n  access: Pick<AccessConfig, 'adminOrPublishedStatus' | 'isAdmin'>\n  currenciesConfig?: CurrenciesConfig\n  /**\n   * Enables inventory tracking for variants. Defaults to true.\n   */\n  inventory?: boolean | InventoryConfig\n  /**\n   * Slug of the products collection, defaults to 'products'.\n   */\n  productsSlug?: string\n  /**\n   * Slug of the variant options collection, defaults to 'variantOptions'.\n   */\n  variantOptionsSlug?: string\n}\n\nexport const createVariantsCollection: (props: Props) => CollectionConfig = (props) => {\n  const {\n    access,\n    currenciesConfig,\n    inventory = true,\n    productsSlug = 'products',\n    variantOptionsSlug = 'variantOptions',\n  } = props || {}\n  const { supportedCurrencies } = currenciesConfig || {}\n\n  const fields: Field[] = [\n    {\n      name: 'title',\n      type: 'text',\n      admin: {\n        description:\n          'Used for administrative purposes, not shown to customers. This is populated by default.',\n      },\n    },\n    {\n      name: 'product',\n      type: 'relationship',\n      admin: {\n        position: 'sidebar',\n        readOnly: true,\n      },\n      relationTo: productsSlug,\n      required: true,\n    },\n    {\n      // This might need to be a custom component, to show a selector for each variant that is\n      // enabled on the parent product\n      // - separate select inputs, each showing only a specific variant (w/ options)\n      // - it will save data to the DB as IDs in this relationship field\n      // and needs a validate function as well which enforces that the options are fully specified, and accurate\n      name: 'options',\n      type: 'relationship',\n      admin: {\n        components: {\n          Field: {\n            path: '@payloadcms/plugin-ecommerce/rsc#VariantOptionsSelector',\n          },\n        },\n      },\n      hasMany: true,\n      label: 'Variant options',\n      relationTo: variantOptionsSlug,\n      required: true,\n      validate: validateOptions(),\n    },\n    ...(inventory ? [inventoryField()] : []),\n  ]\n\n  if (supportedCurrencies?.length && supportedCurrencies.length > 0) {\n    const currencyOptions: string[] = []\n\n    supportedCurrencies.forEach((currency) => {\n      currencyOptions.push(currency.code)\n    })\n\n    if (currenciesConfig) {\n      fields.push(...pricesField({ currenciesConfig }))\n    }\n  }\n\n  const baseConfig: CollectionConfig = {\n    slug: 'variants',\n    access: {\n      create: access.isAdmin,\n      delete: access.isAdmin,\n      read: access.adminOrPublishedStatus,\n      update: access.isAdmin,\n    },\n    admin: {\n      description: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:variantsCollectionDescription'),\n      group: false,\n      useAsTitle: 'title',\n    },\n    fields,\n    hooks: {\n      beforeChange: [beforeChange({ productsSlug, variantOptionsSlug })],\n    },\n    labels: {\n      plural: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:variants'),\n      singular: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:variant'),\n    },\n    trash: true,\n    versions: {\n      drafts: {\n        autosave: true,\n      },\n    },\n  }\n\n  return baseConfig\n}\n"],"names":["inventoryField","pricesField","variantsCollectionBeforeChange","beforeChange","validateOptions","createVariantsCollection","props","access","currenciesConfig","inventory","productsSlug","variantOptionsSlug","supportedCurrencies","fields","name","type","admin","description","position","readOnly","relationTo","required","components","Field","path","hasMany","label","validate","length","currencyOptions","forEach","currency","push","code","baseConfig","slug","create","isAdmin","delete","read","adminOrPublishedStatus","update","t","group","useAsTitle","hooks","labels","plural","singular","trash","versions","drafts","autosave"],"mappings":"AAIA,SAASA,cAAc,QAAQ,oCAAmC;AAClE,SAASC,WAAW,QAAQ,iCAAgC;AAC5D,SAASC,kCAAkCC,YAAY,QAAQ,0BAAyB;AACxF,SAASC,eAAe,QAAQ,6BAA4B;AAmB5D,OAAO,MAAMC,2BAA+D,CAACC;IAC3E,MAAM,EACJC,MAAM,EACNC,gBAAgB,EAChBC,YAAY,IAAI,EAChBC,eAAe,UAAU,EACzBC,qBAAqB,gBAAgB,EACtC,GAAGL,SAAS,CAAC;IACd,MAAM,EAAEM,mBAAmB,EAAE,GAAGJ,oBAAoB,CAAC;IAErD,MAAMK,SAAkB;QACtB;YACEC,MAAM;YACNC,MAAM;YACNC,OAAO;gBACLC,aACE;YACJ;QACF;QACA;YACEH,MAAM;YACNC,MAAM;YACNC,OAAO;gBACLE,UAAU;gBACVC,UAAU;YACZ;YACAC,YAAYV;YACZW,UAAU;QACZ;QACA;YACE,wFAAwF;YACxF,gCAAgC;YAChC,8EAA8E;YAC9E,kEAAkE;YAClE,0GAA0G;YAC1GP,MAAM;YACNC,MAAM;YACNC,OAAO;gBACLM,YAAY;oBACVC,OAAO;wBACLC,MAAM;oBACR;gBACF;YACF;YACAC,SAAS;YACTC,OAAO;YACPN,YAAYT;YACZU,UAAU;YACVM,UAAUvB;QACZ;WACIK,YAAY;YAACT;SAAiB,GAAG,EAAE;KACxC;IAED,IAAIY,qBAAqBgB,UAAUhB,oBAAoBgB,MAAM,GAAG,GAAG;QACjE,MAAMC,kBAA4B,EAAE;QAEpCjB,oBAAoBkB,OAAO,CAAC,CAACC;YAC3BF,gBAAgBG,IAAI,CAACD,SAASE,IAAI;QACpC;QAEA,IAAIzB,kBAAkB;YACpBK,OAAOmB,IAAI,IAAI/B,YAAY;gBAAEO;YAAiB;QAChD;IACF;IAEA,MAAM0B,aAA+B;QACnCC,MAAM;QACN5B,QAAQ;YACN6B,QAAQ7B,OAAO8B,OAAO;YACtBC,QAAQ/B,OAAO8B,OAAO;YACtBE,MAAMhC,OAAOiC,sBAAsB;YACnCC,QAAQlC,OAAO8B,OAAO;QACxB;QACArB,OAAO;YACLC,aAAa,CAAC,EAAEyB,CAAC,EAAE,GACjB,+DAA+D;gBAC/DA,EAAE;YACJC,OAAO;YACPC,YAAY;QACd;QACA/B;QACAgC,OAAO;YACL1C,cAAc;gBAACA,aAAa;oBAAEO;oBAAcC;gBAAmB;aAAG;QACpE;QACAmC,QAAQ;YACNC,QAAQ,CAAC,EAAEL,CAAC,EAAE,GACZ,+DAA+D;gBAC/DA,EAAE;YACJM,UAAU,CAAC,EAAEN,CAAC,EAAE,GACd,+DAA+D;gBAC/DA,EAAE;QACN;QACAO,OAAO;QACPC,UAAU;YACRC,QAAQ;gBACNC,UAAU;YACZ;QACF;IACF;IAEA,OAAOlB;AACT,EAAC"}
+{"version":3,"sources":["../../../../src/collections/variants/createVariantsCollection/index.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nimport type { AccessConfig, CurrenciesConfig, InventoryConfig } from '../../../types/index.js'\n\nimport { inventoryField } from '../../../fields/inventoryField.js'\nimport { pricesField } from '../../../fields/pricesField.js'\nimport { variantsCollectionBeforeChange as beforeChange } from './hooks/beforeChange.js'\nimport { validateOptions } from './hooks/validateOptions.js'\n\ntype Props = {\n  access: Pick<AccessConfig, 'adminOrPublishedStatus' | 'isAdmin'>\n  currenciesConfig?: CurrenciesConfig\n  /**\n   * Enables inventory tracking for variants. Defaults to true.\n   */\n  inventory?: boolean | InventoryConfig\n  /**\n   * Slug of the products collection, defaults to 'products'.\n   */\n  productsSlug?: string\n  /**\n   * Slug of the variant options collection, defaults to 'variantOptions'.\n   */\n  variantOptionsSlug?: string\n  /**\n   * Slug of the variant types collection, defaults to 'variantTypes'.\n   */\n  variantTypesSlug?: string\n}\n\nexport const createVariantsCollection: (props: Props) => CollectionConfig = (props) => {\n  const {\n    access,\n    currenciesConfig,\n    inventory = true,\n    productsSlug = 'products',\n    variantOptionsSlug = 'variantOptions',\n    variantTypesSlug = 'variantTypes',\n  } = props || {}\n  const { supportedCurrencies } = currenciesConfig || {}\n\n  const fields: Field[] = [\n    {\n      name: 'title',\n      type: 'text',\n      admin: {\n        description:\n          'Used for administrative purposes, not shown to customers. This is populated by default.',\n      },\n    },\n    {\n      name: 'product',\n      type: 'relationship',\n      admin: {\n        position: 'sidebar',\n        readOnly: true,\n      },\n      relationTo: productsSlug,\n      required: true,\n    },\n    {\n      // This might need to be a custom component, to show a selector for each variant that is\n      // enabled on the parent product\n      // - separate select inputs, each showing only a specific variant (w/ options)\n      // - it will save data to the DB as IDs in this relationship field\n      // and needs a validate function as well which enforces that the options are fully specified, and accurate\n      name: 'options',\n      type: 'relationship',\n      admin: {\n        components: {\n          Field: {\n            path: '@payloadcms/plugin-ecommerce/rsc#VariantOptionsSelector',\n          },\n        },\n      },\n      custom: {\n        productsSlug,\n        variantTypesSlug,\n      },\n      hasMany: true,\n      label: 'Variant options',\n      relationTo: variantOptionsSlug,\n      required: true,\n      validate: validateOptions({ productsCollectionSlug: productsSlug }),\n    },\n    ...(inventory ? [inventoryField()] : []),\n  ]\n\n  if (supportedCurrencies?.length && supportedCurrencies.length > 0) {\n    const currencyOptions: string[] = []\n\n    supportedCurrencies.forEach((currency) => {\n      currencyOptions.push(currency.code)\n    })\n\n    if (currenciesConfig) {\n      fields.push(...pricesField({ currenciesConfig }))\n    }\n  }\n\n  const baseConfig: CollectionConfig = {\n    slug: 'variants',\n    access: {\n      create: access.isAdmin,\n      delete: access.isAdmin,\n      read: access.adminOrPublishedStatus,\n      update: access.isAdmin,\n    },\n    admin: {\n      description: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:variantsCollectionDescription'),\n      group: false,\n      useAsTitle: 'title',\n    },\n    fields,\n    hooks: {\n      beforeChange: [beforeChange({ productsSlug, variantOptionsSlug })],\n    },\n    labels: {\n      plural: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:variants'),\n      singular: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:variant'),\n    },\n    trash: true,\n    versions: {\n      drafts: {\n        autosave: true,\n      },\n    },\n  }\n\n  return baseConfig\n}\n"],"names":["inventoryField","pricesField","variantsCollectionBeforeChange","beforeChange","validateOptions","createVariantsCollection","props","access","currenciesConfig","inventory","productsSlug","variantOptionsSlug","variantTypesSlug","supportedCurrencies","fields","name","type","admin","description","position","readOnly","relationTo","required","components","Field","path","custom","hasMany","label","validate","productsCollectionSlug","length","currencyOptions","forEach","currency","push","code","baseConfig","slug","create","isAdmin","delete","read","adminOrPublishedStatus","update","t","group","useAsTitle","hooks","labels","plural","singular","trash","versions","drafts","autosave"],"mappings":"AAIA,SAASA,cAAc,QAAQ,oCAAmC;AAClE,SAASC,WAAW,QAAQ,iCAAgC;AAC5D,SAASC,kCAAkCC,YAAY,QAAQ,0BAAyB;AACxF,SAASC,eAAe,QAAQ,6BAA4B;AAuB5D,OAAO,MAAMC,2BAA+D,CAACC;IAC3E,MAAM,EACJC,MAAM,EACNC,gBAAgB,EAChBC,YAAY,IAAI,EAChBC,eAAe,UAAU,EACzBC,qBAAqB,gBAAgB,EACrCC,mBAAmB,cAAc,EAClC,GAAGN,SAAS,CAAC;IACd,MAAM,EAAEO,mBAAmB,EAAE,GAAGL,oBAAoB,CAAC;IAErD,MAAMM,SAAkB;QACtB;YACEC,MAAM;YACNC,MAAM;YACNC,OAAO;gBACLC,aACE;YACJ;QACF;QACA;YACEH,MAAM;YACNC,MAAM;YACNC,OAAO;gBACLE,UAAU;gBACVC,UAAU;YACZ;YACAC,YAAYX;YACZY,UAAU;QACZ;QACA;YACE,wFAAwF;YACxF,gCAAgC;YAChC,8EAA8E;YAC9E,kEAAkE;YAClE,0GAA0G;YAC1GP,MAAM;YACNC,MAAM;YACNC,OAAO;gBACLM,YAAY;oBACVC,OAAO;wBACLC,MAAM;oBACR;gBACF;YACF;YACAC,QAAQ;gBACNhB;gBACAE;YACF;YACAe,SAAS;YACTC,OAAO;YACPP,YAAYV;YACZW,UAAU;YACVO,UAAUzB,gBAAgB;gBAAE0B,wBAAwBpB;YAAa;QACnE;WACID,YAAY;YAACT;SAAiB,GAAG,EAAE;KACxC;IAED,IAAIa,qBAAqBkB,UAAUlB,oBAAoBkB,MAAM,GAAG,GAAG;QACjE,MAAMC,kBAA4B,EAAE;QAEpCnB,oBAAoBoB,OAAO,CAAC,CAACC;YAC3BF,gBAAgBG,IAAI,CAACD,SAASE,IAAI;QACpC;QAEA,IAAI5B,kBAAkB;YACpBM,OAAOqB,IAAI,IAAIlC,YAAY;gBAAEO;YAAiB;QAChD;IACF;IAEA,MAAM6B,aAA+B;QACnCC,MAAM;QACN/B,QAAQ;YACNgC,QAAQhC,OAAOiC,OAAO;YACtBC,QAAQlC,OAAOiC,OAAO;YACtBE,MAAMnC,OAAOoC,sBAAsB;YACnCC,QAAQrC,OAAOiC,OAAO;QACxB;QACAvB,OAAO;YACLC,aAAa,CAAC,EAAE2B,CAAC,EAAE,GACjB,+DAA+D;gBAC/DA,EAAE;YACJC,OAAO;YACPC,YAAY;QACd;QACAjC;QACAkC,OAAO;YACL7C,cAAc;gBAACA,aAAa;oBAAEO;oBAAcC;gBAAmB;aAAG;QACpE;QACAsC,QAAQ;YACNC,QAAQ,CAAC,EAAEL,CAAC,EAAE,GACZ,+DAA+D;gBAC/DA,EAAE;YACJM,UAAU,CAAC,EAAEN,CAAC,EAAE,GACd,+DAA+D;gBAC/DA,EAAE;QACN;QACAO,OAAO;QACPC,UAAU;YACRC,QAAQ;gBACNC,UAAU;YACZ;QACF;IACF;IAEA,OAAOlB;AACT,EAAC"}

package/dist/endpoints/confirmOrder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"confirmOrder.d.ts","sourceRoot":"","sources":["../../src/endpoints/confirmOrder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuD,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAE5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE7F,KAAK,IAAI,GAAG;IACV;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,gBAAgB,CAAA;IAClC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,cAAc,CAAA;IAC7B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,KAAK,mBAAmB,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAA;AAE9D;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,mBAkL/B,CAAA"}
+{"version":3,"file":"confirmOrder.d.ts","sourceRoot":"","sources":["../../src/endpoints/confirmOrder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuD,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAE5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE7F,KAAK,IAAI,GAAG;IACV;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,gBAAgB,CAAA;IAClC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,cAAc,CAAA;IAC7B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,KAAK,mBAAmB,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAA;AAE9D;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,mBA0L/B,CAAA"}

package/dist/endpoints/confirmOrder.js

@@ -11,6 +11,7 @@ import { addDataAndFileToRequest } from 'payload';
         let cartID = data?.cartID;
         let cart = undefined;
         let customerEmail = user?.email ?? '';
+        const cartSecret = data?.secret;
         if (user) {
             if (user.cart?.docs && Array.isArray(user.cart.docs) && user.cart.docs.length > 0) {
                 if (!cartID && user.cart.docs[0]) {
@@ -37,19 +38,24 @@ import { addDataAndFileToRequest } from 'payload';
         }
         if (!cart) {
             if (cartID) {
+                // Add cart secret to query for guest cart access control
+                if (cartSecret && typeof cartSecret === 'string') {
+                    req.query = req.query || {};
+                    req.query.secret = cartSecret;
+                }
                 cart = await payload.findByID({
                     id: cartID,
                     collection: cartsSlug,
                     depth: 2,
                     overrideAccess: false,
+                    req,
                     select: {
                         id: true,
                         currency: true,
                         customerEmail: true,
                         items: true,
                         subtotal: true
-                    },
-                    user
+                    }
                 });
                 if (!cart) {
                     return Response.json({
@@ -79,6 +85,7 @@ import { addDataAndFileToRequest } from 'payload';
         }
         try {
             const paymentResponse = await paymentMethod.confirmOrder({
+                cartsSlug,
                 customersSlug,
                 data: {
                     ...data,

package/dist/endpoints/confirmOrder.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/endpoints/confirmOrder.ts"],"sourcesContent":["import { addDataAndFileToRequest, type DefaultDocumentIDType, type Endpoint } from 'payload'\n\nimport type { CurrenciesConfig, PaymentAdapter, ProductsValidation } from '../types/index.js'\n\ntype Args = {\n  /**\n   * The slug of the carts collection, defaults to 'carts'.\n   */\n  cartsSlug?: string\n  currenciesConfig: CurrenciesConfig\n  /**\n   * The slug of the customers collection, defaults to 'users'.\n   */\n  customersSlug?: string\n  /**\n   * The slug of the orders collection, defaults to 'orders'.\n   */\n  ordersSlug?: string\n  paymentMethod: PaymentAdapter\n  /**\n   * The slug of the products collection, defaults to 'products'.\n   */\n  productsSlug?: string\n  /**\n   * Customise the validation used for checking products or variants before a transaction is created.\n   */\n  productsValidation?: ProductsValidation\n  /**\n   * The slug of the transactions collection, defaults to 'transactions'.\n   */\n  transactionsSlug?: string\n  /**\n   * The slug of the variants collection, defaults to 'variants'.\n   */\n  variantsSlug?: string\n}\n\ntype ConfirmOrderHandler = (args: Args) => Endpoint['handler']\n\n/**\n * Handles the endpoint for initiating payments. We will handle checking the amount and product and variant prices here before it is sent to the payment provider.\n * This is the first step in the payment process.\n */\nexport const confirmOrderHandler: ConfirmOrderHandler =\n  ({\n    cartsSlug = 'carts',\n    currenciesConfig,\n    customersSlug = 'users',\n    ordersSlug = 'orders',\n    paymentMethod,\n    productsSlug = 'products',\n    productsValidation,\n    transactionsSlug = 'transactions',\n    variantsSlug = 'variants',\n  }) =>\n  async (req) => {\n    await addDataAndFileToRequest(req)\n\n    const data = req.data\n    const payload = req.payload\n    const user = req.user\n\n    let currency: string = currenciesConfig.defaultCurrency\n    let cartID: DefaultDocumentIDType = data?.cartID\n    let cart = undefined\n    let customerEmail: string = user?.email ?? ''\n\n    if (user) {\n      if (user.cart?.docs && Array.isArray(user.cart.docs) && user.cart.docs.length > 0) {\n        if (!cartID && user.cart.docs[0]) {\n          // Use the user's cart instead\n          if (typeof user.cart.docs[0] === 'object') {\n            cartID = user.cart.docs[0].id\n            cart = user.cart.docs[0]\n          } else {\n            cartID = user.cart.docs[0]\n          }\n        }\n      }\n    } else {\n      // Get the email from the data if user is not available\n      if (data?.customerEmail && typeof data.customerEmail === 'string') {\n        customerEmail = data.customerEmail\n      } else {\n        return Response.json(\n          {\n            message: 'A customer email is required to make a purchase.',\n          },\n          {\n            status: 400,\n          },\n        )\n      }\n    }\n\n    if (!cart) {\n      if (cartID) {\n        cart = await payload.findByID({\n          id: cartID,\n          collection: cartsSlug,\n          depth: 2,\n          overrideAccess: false,\n          select: {\n            id: true,\n            currency: true,\n            customerEmail: true,\n            items: true,\n            subtotal: true,\n          },\n          user,\n        })\n\n        if (!cart) {\n          return Response.json(\n            {\n              message: `Cart with ID ${cartID} not found.`,\n            },\n            {\n              status: 404,\n            },\n          )\n        }\n      } else {\n        return Response.json(\n          {\n            message: 'Cart ID is required.',\n          },\n          {\n            status: 400,\n          },\n        )\n      }\n    }\n\n    if (cart.currency && typeof cart.currency === 'string') {\n      currency = cart.currency\n    }\n\n    // Ensure the currency is provided or inferred in some way\n    if (!currency) {\n      return Response.json(\n        {\n          message: 'Currency is required.',\n        },\n        {\n          status: 400,\n        },\n      )\n    }\n\n    try {\n      const paymentResponse = await paymentMethod.confirmOrder({\n        customersSlug,\n        data: {\n          ...data,\n          customerEmail,\n        },\n        ordersSlug,\n        req,\n        transactionsSlug,\n      })\n\n      if (paymentResponse.transactionID) {\n        const transaction = await payload.findByID({\n          id: paymentResponse.transactionID,\n          collection: transactionsSlug,\n          depth: 0,\n          select: {\n            id: true,\n            items: true,\n          },\n        })\n\n        if (transaction && Array.isArray(transaction.items) && transaction.items.length > 0) {\n          for (const item of transaction.items) {\n            if (item.variant) {\n              const id = typeof item.variant === 'object' ? item.variant.id : item.variant\n\n              await payload.db.updateOne({\n                id,\n                collection: variantsSlug,\n                data: {\n                  inventory: {\n                    $inc: item.quantity * -1,\n                  },\n                },\n              })\n            } else if (item.product) {\n              const id = typeof item.product === 'object' ? item.product.id : item.product\n\n              await payload.db.updateOne({\n                id,\n                collection: productsSlug,\n                data: {\n                  inventory: {\n                    $inc: item.quantity * -1,\n                  },\n                },\n              })\n            }\n          }\n        }\n      }\n\n      if ('paymentResponse.transactionID' in paymentResponse && paymentResponse.transactionID) {\n        delete (paymentResponse as Partial<typeof paymentResponse>).transactionID\n      }\n\n      return Response.json(paymentResponse)\n    } catch (error) {\n      payload.logger.error(error, 'Error confirming order.')\n\n      return Response.json(\n        {\n          message: 'Error confirming order.',\n        },\n        {\n          status: 500,\n        },\n      )\n    }\n  }\n"],"names":["addDataAndFileToRequest","confirmOrderHandler","cartsSlug","currenciesConfig","customersSlug","ordersSlug","paymentMethod","productsSlug","productsValidation","transactionsSlug","variantsSlug","req","data","payload","user","currency","defaultCurrency","cartID","cart","undefined","customerEmail","email","docs","Array","isArray","length","id","Response","json","message","status","findByID","collection","depth","overrideAccess","select","items","subtotal","paymentResponse","confirmOrder","transactionID","transaction","item","variant","db","updateOne","inventory","$inc","quantity","product","error","logger"],"mappings":"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"}
+{"version":3,"sources":["../../src/endpoints/confirmOrder.ts"],"sourcesContent":["import { addDataAndFileToRequest, type DefaultDocumentIDType, type Endpoint } from 'payload'\n\nimport type { CurrenciesConfig, PaymentAdapter, ProductsValidation } from '../types/index.js'\n\ntype Args = {\n  /**\n   * The slug of the carts collection, defaults to 'carts'.\n   */\n  cartsSlug?: string\n  currenciesConfig: CurrenciesConfig\n  /**\n   * The slug of the customers collection, defaults to 'users'.\n   */\n  customersSlug?: string\n  /**\n   * The slug of the orders collection, defaults to 'orders'.\n   */\n  ordersSlug?: string\n  paymentMethod: PaymentAdapter\n  /**\n   * The slug of the products collection, defaults to 'products'.\n   */\n  productsSlug?: string\n  /**\n   * Customise the validation used for checking products or variants before a transaction is created.\n   */\n  productsValidation?: ProductsValidation\n  /**\n   * The slug of the transactions collection, defaults to 'transactions'.\n   */\n  transactionsSlug?: string\n  /**\n   * The slug of the variants collection, defaults to 'variants'.\n   */\n  variantsSlug?: string\n}\n\ntype ConfirmOrderHandler = (args: Args) => Endpoint['handler']\n\n/**\n * Handles the endpoint for initiating payments. We will handle checking the amount and product and variant prices here before it is sent to the payment provider.\n * This is the first step in the payment process.\n */\nexport const confirmOrderHandler: ConfirmOrderHandler =\n  ({\n    cartsSlug = 'carts',\n    currenciesConfig,\n    customersSlug = 'users',\n    ordersSlug = 'orders',\n    paymentMethod,\n    productsSlug = 'products',\n    productsValidation,\n    transactionsSlug = 'transactions',\n    variantsSlug = 'variants',\n  }) =>\n  async (req) => {\n    await addDataAndFileToRequest(req)\n\n    const data = req.data\n    const payload = req.payload\n    const user = req.user\n\n    let currency: string = currenciesConfig.defaultCurrency\n    let cartID: DefaultDocumentIDType = data?.cartID\n    let cart = undefined\n    let customerEmail: string = user?.email ?? ''\n    const cartSecret = data?.secret\n\n    if (user) {\n      if (user.cart?.docs && Array.isArray(user.cart.docs) && user.cart.docs.length > 0) {\n        if (!cartID && user.cart.docs[0]) {\n          // Use the user's cart instead\n          if (typeof user.cart.docs[0] === 'object') {\n            cartID = user.cart.docs[0].id\n            cart = user.cart.docs[0]\n          } else {\n            cartID = user.cart.docs[0]\n          }\n        }\n      }\n    } else {\n      // Get the email from the data if user is not available\n      if (data?.customerEmail && typeof data.customerEmail === 'string') {\n        customerEmail = data.customerEmail\n      } else {\n        return Response.json(\n          {\n            message: 'A customer email is required to make a purchase.',\n          },\n          {\n            status: 400,\n          },\n        )\n      }\n    }\n\n    if (!cart) {\n      if (cartID) {\n        // Add cart secret to query for guest cart access control\n        if (cartSecret && typeof cartSecret === 'string') {\n          req.query = req.query || {}\n          req.query.secret = cartSecret\n        }\n\n        cart = await payload.findByID({\n          id: cartID,\n          collection: cartsSlug,\n          depth: 2,\n          overrideAccess: false,\n          req,\n          select: {\n            id: true,\n            currency: true,\n            customerEmail: true,\n            items: true,\n            subtotal: true,\n          },\n        })\n\n        if (!cart) {\n          return Response.json(\n            {\n              message: `Cart with ID ${cartID} not found.`,\n            },\n            {\n              status: 404,\n            },\n          )\n        }\n      } else {\n        return Response.json(\n          {\n            message: 'Cart ID is required.',\n          },\n          {\n            status: 400,\n          },\n        )\n      }\n    }\n\n    if (cart.currency && typeof cart.currency === 'string') {\n      currency = cart.currency\n    }\n\n    // Ensure the currency is provided or inferred in some way\n    if (!currency) {\n      return Response.json(\n        {\n          message: 'Currency is required.',\n        },\n        {\n          status: 400,\n        },\n      )\n    }\n\n    try {\n      const paymentResponse = await paymentMethod.confirmOrder({\n        cartsSlug,\n        customersSlug,\n        data: {\n          ...data,\n          customerEmail,\n        },\n        ordersSlug,\n        req,\n        transactionsSlug,\n      })\n\n      if (paymentResponse.transactionID) {\n        const transaction = await payload.findByID({\n          id: paymentResponse.transactionID,\n          collection: transactionsSlug,\n          depth: 0,\n          select: {\n            id: true,\n            items: true,\n          },\n        })\n\n        if (transaction && Array.isArray(transaction.items) && transaction.items.length > 0) {\n          for (const item of transaction.items) {\n            if (item.variant) {\n              const id = typeof item.variant === 'object' ? item.variant.id : item.variant\n\n              await payload.db.updateOne({\n                id,\n                collection: variantsSlug,\n                data: {\n                  inventory: {\n                    $inc: item.quantity * -1,\n                  },\n                },\n              })\n            } else if (item.product) {\n              const id = typeof item.product === 'object' ? item.product.id : item.product\n\n              await payload.db.updateOne({\n                id,\n                collection: productsSlug,\n                data: {\n                  inventory: {\n                    $inc: item.quantity * -1,\n                  },\n                },\n              })\n            }\n          }\n        }\n      }\n\n      if ('paymentResponse.transactionID' in paymentResponse && paymentResponse.transactionID) {\n        delete (paymentResponse as Partial<typeof paymentResponse>).transactionID\n      }\n\n      return Response.json(paymentResponse)\n    } catch (error) {\n      payload.logger.error(error, 'Error confirming order.')\n\n      return Response.json(\n        {\n          message: 'Error confirming order.',\n        },\n        {\n          status: 500,\n        },\n      )\n    }\n  }\n"],"names":["addDataAndFileToRequest","confirmOrderHandler","cartsSlug","currenciesConfig","customersSlug","ordersSlug","paymentMethod","productsSlug","productsValidation","transactionsSlug","variantsSlug","req","data","payload","user","currency","defaultCurrency","cartID","cart","undefined","customerEmail","email","cartSecret","secret","docs","Array","isArray","length","id","Response","json","message","status","query","findByID","collection","depth","overrideAccess","select","items","subtotal","paymentResponse","confirmOrder","transactionID","transaction","item","variant","db","updateOne","inventory","$inc","quantity","product","error","logger"],"mappings":"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"}

package/dist/endpoints/initiatePayment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initiatePayment.d.ts","sourceRoot":"","sources":["../../src/endpoints/initiatePayment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuD,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAE5F,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,8BAA8B,EAC/B,MAAM,mBAAmB,CAAA;AAI1B,KAAK,IAAI,GAAG;IACV;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,gBAAgB,CAAA;IAClC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,8BAA8B,CAAC,WAAW,CAAC,CAAA;IACvD,aAAa,EAAE,cAAc,CAAA;IAC7B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,KAAK,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAA;AAE1D;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,eA0RlC,CAAA"}
+{"version":3,"file":"initiatePayment.d.ts","sourceRoot":"","sources":["../../src/endpoints/initiatePayment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuD,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAE5F,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,8BAA8B,EAC/B,MAAM,mBAAmB,CAAA;AAI1B,KAAK,IAAI,GAAG;IACV;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,gBAAgB,CAAA;IAClC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,8BAA8B,CAAC,WAAW,CAAC,CAAA;IACvD,aAAa,EAAE,cAAc,CAAA;IAC7B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,KAAK,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAA;AAE1D;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAiSlC,CAAA"}