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

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

@@ -0,0 +1,51 @@
+import { addDataAndFileToRequest } from 'payload';
+import { removeItem } from '../operations/removeItem.js';
+/**
+ * Creates an endpoint handler for removing items from a cart.
+ *
+ * Route: POST /api/{cartsSlug}/:id/remove-item
+ *
+ * Request body:
+ * - itemID: string (the cart item row ID to remove)
+ * - secret?: string (for guest cart access)
+ */ export const removeItemEndpoint = ({ cartsSlug })=>({
+        handler: async (req)=>{
+            await addDataAndFileToRequest(req);
+            const cartID = req.routeParams?.id;
+            const data = req.data;
+            if (!cartID) {
+                return Response.json({
+                    message: 'Cart ID is required',
+                    success: false
+                }, {
+                    status: 400
+                });
+            }
+            if (!data?.itemID) {
+                return Response.json({
+                    message: 'Item ID is required',
+                    success: false
+                }, {
+                    status: 400
+                });
+            }
+            const result = await removeItem({
+                cartID,
+                cartsSlug,
+                itemID: data.itemID,
+                payload: req.payload,
+                req,
+                secret: data.secret
+            });
+            if (!result.success) {
+                return Response.json(result, {
+                    status: 404
+                });
+            }
+            return Response.json(result);
+        },
+        method: 'post',
+        path: '/:id/remove-item'
+    });
+
+//# sourceMappingURL=removeItem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/collections/carts/endpoints/removeItem.ts"],"sourcesContent":["import type { CollectionSlug, Endpoint } from 'payload'\n\nimport { addDataAndFileToRequest } from 'payload'\n\nimport { removeItem } from '../operations/removeItem.js'\n\ntype Args = {\n  cartsSlug: CollectionSlug\n}\n\n/**\n * Creates an endpoint handler for removing items from a cart.\n *\n * Route: POST /api/{cartsSlug}/:id/remove-item\n *\n * Request body:\n * - itemID: string (the cart item row ID to remove)\n * - secret?: string (for guest cart access)\n */\nexport const removeItemEndpoint = ({ cartsSlug }: Args): Endpoint => ({\n  handler: async (req) => {\n    await addDataAndFileToRequest(req)\n\n    const cartID = req.routeParams?.id as string | undefined\n    const data = req.data as {\n      itemID?: string\n      secret?: string\n    }\n\n    if (!cartID) {\n      return Response.json({ message: 'Cart ID is required', success: false }, { status: 400 })\n    }\n\n    if (!data?.itemID) {\n      return Response.json({ message: 'Item ID is required', success: false }, { status: 400 })\n    }\n\n    const result = await removeItem({\n      cartID,\n      cartsSlug,\n      itemID: data.itemID,\n      payload: req.payload,\n      req,\n      secret: data.secret,\n    })\n\n    if (!result.success) {\n      return Response.json(result, { status: 404 })\n    }\n\n    return Response.json(result)\n  },\n  method: 'post',\n  path: '/:id/remove-item',\n})\n"],"names":["addDataAndFileToRequest","removeItem","removeItemEndpoint","cartsSlug","handler","req","cartID","routeParams","id","data","Response","json","message","success","status","itemID","result","payload","secret","method","path"],"mappings":"AAEA,SAASA,uBAAuB,QAAQ,UAAS;AAEjD,SAASC,UAAU,QAAQ,8BAA6B;AAMxD;;;;;;;;CAQC,GACD,OAAO,MAAMC,qBAAqB,CAAC,EAAEC,SAAS,EAAQ,GAAgB,CAAA;QACpEC,SAAS,OAAOC;YACd,MAAML,wBAAwBK;YAE9B,MAAMC,SAASD,IAAIE,WAAW,EAAEC;YAChC,MAAMC,OAAOJ,IAAII,IAAI;YAKrB,IAAI,CAACH,QAAQ;gBACX,OAAOI,SAASC,IAAI,CAAC;oBAAEC,SAAS;oBAAuBC,SAAS;gBAAM,GAAG;oBAAEC,QAAQ;gBAAI;YACzF;YAEA,IAAI,CAACL,MAAMM,QAAQ;gBACjB,OAAOL,SAASC,IAAI,CAAC;oBAAEC,SAAS;oBAAuBC,SAAS;gBAAM,GAAG;oBAAEC,QAAQ;gBAAI;YACzF;YAEA,MAAME,SAAS,MAAMf,WAAW;gBAC9BK;gBACAH;gBACAY,QAAQN,KAAKM,MAAM;gBACnBE,SAASZ,IAAIY,OAAO;gBACpBZ;gBACAa,QAAQT,KAAKS,MAAM;YACrB;YAEA,IAAI,CAACF,OAAOH,OAAO,EAAE;gBACnB,OAAOH,SAASC,IAAI,CAACK,QAAQ;oBAAEF,QAAQ;gBAAI;YAC7C;YAEA,OAAOJ,SAASC,IAAI,CAACK;QACvB;QACAG,QAAQ;QACRC,MAAM;IACR,CAAA,EAAE"}

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

@@ -0,0 +1,40 @@
+import type { CollectionSlug, Endpoint } from 'payload';
+type Args = {
+    cartsSlug: CollectionSlug;
+};
+/**
+ * Creates an endpoint handler for updating an item in a cart.
+ * Supports MongoDB-style operators for flexible updates.
+ *
+ * Route: POST /api/{cartsSlug}/:id/update-item
+ *
+ * Request body:
+ * - itemID: string (the cart item row ID to update)
+ * - quantity: number | { $inc: number } (set or increment/decrement)
+ * - removeOnZero?: boolean (defaults to true, removes item if quantity reaches 0)
+ * - secret?: string (for guest cart access)
+ *
+ * @example
+ * ```ts
+ * // Set quantity to 5
+ * fetch('/api/carts/123/update-item', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ itemID: 'item-456', quantity: 5 })
+ * })
+ *
+ * // Increment by 1
+ * fetch('/api/carts/123/update-item', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ itemID: 'item-456', quantity: { $inc: 1 } })
+ * })
+ *
+ * // Decrement by 1
+ * fetch('/api/carts/123/update-item', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ itemID: 'item-456', quantity: { $inc: -1 } })
+ * })
+ * ```
+ */
+export declare const updateItemEndpoint: ({ cartsSlug }: Args) => Endpoint;
+export {};
+//# sourceMappingURL=updateItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"updateItem.d.ts","sourceRoot":"","sources":["../../../../src/collections/carts/endpoints/updateItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAQvD,KAAK,IAAI,GAAG;IACV,SAAS,EAAE,cAAc,CAAA;CAC1B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,kBAAkB,kBAAmB,IAAI,KAAG,QA6DvD,CAAA"}

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

@@ -0,0 +1,95 @@
+import { addDataAndFileToRequest } from 'payload';
+import { updateItem } from '../operations/updateItem.js';
+/**
+ * Creates an endpoint handler for updating an item in a cart.
+ * Supports MongoDB-style operators for flexible updates.
+ *
+ * Route: POST /api/{cartsSlug}/:id/update-item
+ *
+ * Request body:
+ * - itemID: string (the cart item row ID to update)
+ * - quantity: number | { $inc: number } (set or increment/decrement)
+ * - removeOnZero?: boolean (defaults to true, removes item if quantity reaches 0)
+ * - secret?: string (for guest cart access)
+ *
+ * @example
+ * ```ts
+ * // Set quantity to 5
+ * fetch('/api/carts/123/update-item', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ itemID: 'item-456', quantity: 5 })
+ * })
+ *
+ * // Increment by 1
+ * fetch('/api/carts/123/update-item', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ itemID: 'item-456', quantity: { $inc: 1 } })
+ * })
+ *
+ * // Decrement by 1
+ * fetch('/api/carts/123/update-item', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ itemID: 'item-456', quantity: { $inc: -1 } })
+ * })
+ * ```
+ */ export const updateItemEndpoint = ({ cartsSlug })=>({
+        handler: async (req)=>{
+            await addDataAndFileToRequest(req);
+            const cartID = req.routeParams?.id;
+            const data = req.data;
+            if (!cartID) {
+                return Response.json({
+                    message: 'Cart ID is required',
+                    success: false
+                }, {
+                    status: 400
+                });
+            }
+            if (!data?.itemID) {
+                return Response.json({
+                    message: 'Item ID is required',
+                    success: false
+                }, {
+                    status: 400
+                });
+            }
+            if (data?.quantity === undefined) {
+                return Response.json({
+                    message: 'Quantity is required',
+                    success: false
+                }, {
+                    status: 400
+                });
+            }
+            // Validate quantity format
+            const isValidQuantity = typeof data.quantity === 'number' || typeof data.quantity === 'object' && data.quantity !== null && '$inc' in data.quantity && typeof data.quantity.$inc === 'number';
+            if (!isValidQuantity) {
+                return Response.json({
+                    message: 'Quantity must be a number or { $inc: number }',
+                    success: false
+                }, {
+                    status: 400
+                });
+            }
+            const result = await updateItem({
+                cartID,
+                cartsSlug,
+                itemID: data.itemID,
+                payload: req.payload,
+                quantity: data.quantity,
+                removeOnZero: data.removeOnZero,
+                req,
+                secret: data.secret
+            });
+            if (!result.success) {
+                return Response.json(result, {
+                    status: 404
+                });
+            }
+            return Response.json(result);
+        },
+        method: 'post',
+        path: '/:id/update-item'
+    });
+
+//# sourceMappingURL=updateItem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/collections/carts/endpoints/updateItem.ts"],"sourcesContent":["import type { CollectionSlug, Endpoint } from 'payload'\n\nimport { addDataAndFileToRequest } from 'payload'\n\nimport type { FieldWithOperator } from '../operations/types.js'\n\nimport { updateItem } from '../operations/updateItem.js'\n\ntype Args = {\n  cartsSlug: CollectionSlug\n}\n\n/**\n * Creates an endpoint handler for updating an item in a cart.\n * Supports MongoDB-style operators for flexible updates.\n *\n * Route: POST /api/{cartsSlug}/:id/update-item\n *\n * Request body:\n * - itemID: string (the cart item row ID to update)\n * - quantity: number | { $inc: number } (set or increment/decrement)\n * - removeOnZero?: boolean (defaults to true, removes item if quantity reaches 0)\n * - secret?: string (for guest cart access)\n *\n * @example\n * ```ts\n * // Set quantity to 5\n * fetch('/api/carts/123/update-item', {\n *   method: 'POST',\n *   body: JSON.stringify({ itemID: 'item-456', quantity: 5 })\n * })\n *\n * // Increment by 1\n * fetch('/api/carts/123/update-item', {\n *   method: 'POST',\n *   body: JSON.stringify({ itemID: 'item-456', quantity: { $inc: 1 } })\n * })\n *\n * // Decrement by 1\n * fetch('/api/carts/123/update-item', {\n *   method: 'POST',\n *   body: JSON.stringify({ itemID: 'item-456', quantity: { $inc: -1 } })\n * })\n * ```\n */\nexport const updateItemEndpoint = ({ cartsSlug }: Args): Endpoint => ({\n  handler: async (req) => {\n    await addDataAndFileToRequest(req)\n\n    const cartID = req.routeParams?.id as string | undefined\n    const data = req.data as {\n      itemID?: string\n      quantity?: FieldWithOperator<number>\n      removeOnZero?: boolean\n      secret?: string\n    }\n\n    if (!cartID) {\n      return Response.json({ message: 'Cart ID is required', success: false }, { status: 400 })\n    }\n\n    if (!data?.itemID) {\n      return Response.json({ message: 'Item ID is required', success: false }, { status: 400 })\n    }\n\n    if (data?.quantity === undefined) {\n      return Response.json({ message: 'Quantity is required', success: false }, { status: 400 })\n    }\n\n    // Validate quantity format\n    const isValidQuantity =\n      typeof data.quantity === 'number' ||\n      (typeof data.quantity === 'object' &&\n        data.quantity !== null &&\n        '$inc' in data.quantity &&\n        typeof data.quantity.$inc === 'number')\n\n    if (!isValidQuantity) {\n      return Response.json(\n        {\n          message: 'Quantity must be a number or { $inc: number }',\n          success: false,\n        },\n        { status: 400 },\n      )\n    }\n\n    const result = await updateItem({\n      cartID,\n      cartsSlug,\n      itemID: data.itemID,\n      payload: req.payload,\n      quantity: data.quantity,\n      removeOnZero: data.removeOnZero,\n      req,\n      secret: data.secret,\n    })\n\n    if (!result.success) {\n      return Response.json(result, { status: 404 })\n    }\n\n    return Response.json(result)\n  },\n  method: 'post',\n  path: '/:id/update-item',\n})\n"],"names":["addDataAndFileToRequest","updateItem","updateItemEndpoint","cartsSlug","handler","req","cartID","routeParams","id","data","Response","json","message","success","status","itemID","quantity","undefined","isValidQuantity","$inc","result","payload","removeOnZero","secret","method","path"],"mappings":"AAEA,SAASA,uBAAuB,QAAQ,UAAS;AAIjD,SAASC,UAAU,QAAQ,8BAA6B;AAMxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCC,GACD,OAAO,MAAMC,qBAAqB,CAAC,EAAEC,SAAS,EAAQ,GAAgB,CAAA;QACpEC,SAAS,OAAOC;YACd,MAAML,wBAAwBK;YAE9B,MAAMC,SAASD,IAAIE,WAAW,EAAEC;YAChC,MAAMC,OAAOJ,IAAII,IAAI;YAOrB,IAAI,CAACH,QAAQ;gBACX,OAAOI,SAASC,IAAI,CAAC;oBAAEC,SAAS;oBAAuBC,SAAS;gBAAM,GAAG;oBAAEC,QAAQ;gBAAI;YACzF;YAEA,IAAI,CAACL,MAAMM,QAAQ;gBACjB,OAAOL,SAASC,IAAI,CAAC;oBAAEC,SAAS;oBAAuBC,SAAS;gBAAM,GAAG;oBAAEC,QAAQ;gBAAI;YACzF;YAEA,IAAIL,MAAMO,aAAaC,WAAW;gBAChC,OAAOP,SAASC,IAAI,CAAC;oBAAEC,SAAS;oBAAwBC,SAAS;gBAAM,GAAG;oBAAEC,QAAQ;gBAAI;YAC1F;YAEA,2BAA2B;YAC3B,MAAMI,kBACJ,OAAOT,KAAKO,QAAQ,KAAK,YACxB,OAAOP,KAAKO,QAAQ,KAAK,YACxBP,KAAKO,QAAQ,KAAK,QAClB,UAAUP,KAAKO,QAAQ,IACvB,OAAOP,KAAKO,QAAQ,CAACG,IAAI,KAAK;YAElC,IAAI,CAACD,iBAAiB;gBACpB,OAAOR,SAASC,IAAI,CAClB;oBACEC,SAAS;oBACTC,SAAS;gBACX,GACA;oBAAEC,QAAQ;gBAAI;YAElB;YAEA,MAAMM,SAAS,MAAMnB,WAAW;gBAC9BK;gBACAH;gBACAY,QAAQN,KAAKM,MAAM;gBACnBM,SAAShB,IAAIgB,OAAO;gBACpBL,UAAUP,KAAKO,QAAQ;gBACvBM,cAAcb,KAAKa,YAAY;gBAC/BjB;gBACAkB,QAAQd,KAAKc,MAAM;YACrB;YAEA,IAAI,CAACH,OAAOP,OAAO,EAAE;gBACnB,OAAOH,SAASC,IAAI,CAACS,QAAQ;oBAAEN,QAAQ;gBAAI;YAC7C;YAEA,OAAOJ,SAASC,IAAI,CAACS;QACvB;QACAI,QAAQ;QACRC,MAAM;IACR,CAAA,EAAE"}

package/dist/collections/carts/hasCartSecretAccess.d.ts

@@ -1,10 +1,10 @@
 import type { Access } from 'payload';
 /**
- * Internal access function for guest cart access via secret query parameter.
+ * Internal access function for guest cart access via secret in context or queries.
  * Only active when allowGuestCarts is enabled.
  *
  * @param allowGuestCarts - Whether guest cart access is enabled
- * @returns Access function that checks for valid cart secret in query params
+ * @returns Access function that checks for valid cart secret in context
  */
 export declare const hasCartSecretAccess: (allowGuestCarts: boolean) => Access;
 //# sourceMappingURL=hasCartSecretAccess.d.ts.map

package/dist/collections/carts/hasCartSecretAccess.js

@@ -1,15 +1,15 @@
 /**
- * Internal access function for guest cart access via secret query parameter.
+ * Internal access function for guest cart access via secret in context or queries.
  * Only active when allowGuestCarts is enabled.
  *
  * @param allowGuestCarts - Whether guest cart access is enabled
- * @returns Access function that checks for valid cart secret in query params
+ * @returns Access function that checks for valid cart secret in context
  */ export const hasCartSecretAccess = (allowGuestCarts)=>{
     return ({ req })=>{
         if (!allowGuestCarts) {
             return false;
         }
-        const cartSecret = req.query?.secret;
+        const cartSecret = req.context?.cartSecret ?? req.query?.secret;
         if (!cartSecret || typeof cartSecret !== 'string') {
             return false;
         }

package/dist/collections/carts/hasCartSecretAccess.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/collections/carts/hasCartSecretAccess.ts"],"sourcesContent":["import type { Access } from 'payload'\n\n/**\n * Internal access function for guest cart access via secret query parameter.\n * Only active when allowGuestCarts is enabled.\n *\n * @param allowGuestCarts - Whether guest cart access is enabled\n * @returns Access function that checks for valid cart secret in query params\n */\nexport const hasCartSecretAccess = (allowGuestCarts: boolean): Access => {\n  return ({ req }) => {\n    if (!allowGuestCarts) {\n      return false\n    }\n\n    const cartSecret = req.query?.secret\n\n    if (!cartSecret || typeof cartSecret !== 'string') {\n      return false\n    }\n\n    return {\n      secret: {\n        equals: cartSecret,\n      },\n    }\n  }\n}\n"],"names":["hasCartSecretAccess","allowGuestCarts","req","cartSecret","query","secret","equals"],"mappings":"AAEA;;;;;;CAMC,GACD,OAAO,MAAMA,sBAAsB,CAACC;IAClC,OAAO,CAAC,EAAEC,GAAG,EAAE;QACb,IAAI,CAACD,iBAAiB;YACpB,OAAO;QACT;QAEA,MAAME,aAAaD,IAAIE,KAAK,EAAEC;QAE9B,IAAI,CAACF,cAAc,OAAOA,eAAe,UAAU;YACjD,OAAO;QACT;QAEA,OAAO;YACLE,QAAQ;gBACNC,QAAQH;YACV;QACF;IACF;AACF,EAAC"}
+{"version":3,"sources":["../../../src/collections/carts/hasCartSecretAccess.ts"],"sourcesContent":["import type { Access } from 'payload'\n\n/**\n * Internal access function for guest cart access via secret in context or queries.\n * Only active when allowGuestCarts is enabled.\n *\n * @param allowGuestCarts - Whether guest cart access is enabled\n * @returns Access function that checks for valid cart secret in context\n */\nexport const hasCartSecretAccess = (allowGuestCarts: boolean): Access => {\n  return ({ req }) => {\n    if (!allowGuestCarts) {\n      return false\n    }\n\n    const cartSecret = req.context?.cartSecret ?? req.query?.secret\n\n    if (!cartSecret || typeof cartSecret !== 'string') {\n      return false\n    }\n\n    return {\n      secret: {\n        equals: cartSecret,\n      },\n    }\n  }\n}\n"],"names":["hasCartSecretAccess","allowGuestCarts","req","cartSecret","context","query","secret","equals"],"mappings":"AAEA;;;;;;CAMC,GACD,OAAO,MAAMA,sBAAsB,CAACC;IAClC,OAAO,CAAC,EAAEC,GAAG,EAAE;QACb,IAAI,CAACD,iBAAiB;YACpB,OAAO;QACT;QAEA,MAAME,aAAaD,IAAIE,OAAO,EAAED,cAAcD,IAAIG,KAAK,EAAEC;QAEzD,IAAI,CAACH,cAAc,OAAOA,eAAe,UAAU;YACjD,OAAO;QACT;QAEA,OAAO;YACLG,QAAQ;gBACNC,QAAQJ;YACV;QACF;IACF;AACF,EAAC"}

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

@@ -0,0 +1,24 @@
+import type { AddItemArgs, CartOperationResult } from './types.js';
+/**
+ * Adds an item to a cart. If an item matching the same criteria already exists,
+ * its quantity is incremented instead of creating a duplicate entry.
+ *
+ * This handler is isolated and can be used from:
+ * - Custom endpoints
+ * - Local API operations
+ * - Hooks
+ *
+ * @example
+ * ```ts
+ * // From an endpoint or hook
+ * const result = await addItem({
+ *   payload,
+ *   cartsSlug: 'carts',
+ *   cartID: '123',
+ *   item: { product: 'prod-1', variant: 'var-1' },
+ *   quantity: 2,
+ * })
+ * ```
+ */
+export declare const addItem: (args: AddItemArgs) => Promise<CartOperationResult>;
+//# sourceMappingURL=addItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"addItem.d.ts","sourceRoot":"","sources":["../../../../src/collections/carts/operations/addItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAgB,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAKhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,OAAO,SAAgB,WAAW,KAAG,OAAO,CAAC,mBAAmB,CA8E5E,CAAA"}

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

@@ -0,0 +1,95 @@
+import { createRequestWithSecret } from './createRequestWithSecret.js';
+import { defaultCartItemMatcher } from './defaultCartItemMatcher.js';
+/**
+ * Adds an item to a cart. If an item matching the same criteria already exists,
+ * its quantity is incremented instead of creating a duplicate entry.
+ *
+ * This handler is isolated and can be used from:
+ * - Custom endpoints
+ * - Local API operations
+ * - Hooks
+ *
+ * @example
+ * ```ts
+ * // From an endpoint or hook
+ * const result = await addItem({
+ *   payload,
+ *   cartsSlug: 'carts',
+ *   cartID: '123',
+ *   item: { product: 'prod-1', variant: 'var-1' },
+ *   quantity: 2,
+ * })
+ * ```
+ */ export const addItem = async (args)=>{
+    const { cartID, cartItemMatcher = defaultCartItemMatcher, cartsSlug, item, payload, quantity = 1, 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 if item already exists using the matcher
+    const existingItemIndex = existingItems.findIndex((existingItem)=>cartItemMatcher({
+            existingItem,
+            newItem: item
+        }));
+    let updatedItems;
+    if (existingItemIndex !== -1) {
+        // Item exists - increment quantity
+        updatedItems = [
+            ...existingItems
+        ];
+        const existingItem = updatedItems[existingItemIndex];
+        updatedItems[existingItemIndex] = {
+            ...existingItem,
+            quantity: existingItem.quantity + quantity
+        };
+    } else {
+        // Item doesn't exist - add new item
+        const newItem = {
+            product: item.product,
+            quantity,
+            ...item.variant ? {
+                variant: item.variant
+            } : {},
+            // Spread any additional custom properties from the item
+            ...Object.fromEntries(Object.entries(item).filter(([key])=>![
+                    'product',
+                    'quantity',
+                    'variant'
+                ].includes(key)))
+        };
+        updatedItems = [
+            ...existingItems,
+            newItem
+        ];
+    }
+    const updatedCart = await payload.update({
+        id: cartID,
+        collection: cartsSlug,
+        data: {
+            items: updatedItems
+        },
+        depth: 0,
+        overrideAccess: false,
+        req: reqWithSecret
+    });
+    return {
+        cart: updatedCart,
+        message: existingItemIndex !== -1 ? 'Item quantity updated' : 'Item added to cart',
+        success: true
+    };
+};
+
+//# sourceMappingURL=addItem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/collections/carts/operations/addItem.ts"],"sourcesContent":["import type { AddItemArgs, CartItemData, CartOperationResult } from './types.js'\n\nimport { createRequestWithSecret } from './createRequestWithSecret.js'\nimport { defaultCartItemMatcher } from './defaultCartItemMatcher.js'\n\n/**\n * Adds an item to a cart. If an item matching the same criteria already exists,\n * its quantity is incremented instead of creating a duplicate entry.\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 * // From an endpoint or hook\n * const result = await addItem({\n *   payload,\n *   cartsSlug: 'carts',\n *   cartID: '123',\n *   item: { product: 'prod-1', variant: 'var-1' },\n *   quantity: 2,\n * })\n * ```\n */\nexport const addItem = async (args: AddItemArgs): Promise<CartOperationResult> => {\n  const {\n    cartID,\n    cartItemMatcher = defaultCartItemMatcher,\n    cartsSlug,\n    item,\n    payload,\n    quantity = 1,\n    req,\n    secret,\n  } = 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 if item already exists using the matcher\n  const existingItemIndex = existingItems.findIndex((existingItem) =>\n    cartItemMatcher({ existingItem, newItem: item }),\n  )\n\n  let updatedItems: CartItemData[]\n\n  if (existingItemIndex !== -1) {\n    // Item exists - increment quantity\n    updatedItems = [...existingItems]\n    const existingItem = updatedItems[existingItemIndex]!\n    updatedItems[existingItemIndex] = {\n      ...existingItem,\n      quantity: existingItem.quantity + quantity,\n    }\n  } else {\n    // Item doesn't exist - add new item\n    const newItem: CartItemData = {\n      product: item.product,\n      quantity,\n      ...(item.variant ? { variant: item.variant } : {}),\n      // Spread any additional custom properties from the item\n      ...Object.fromEntries(\n        Object.entries(item).filter(([key]) => !['product', 'quantity', 'variant'].includes(key)),\n      ),\n    }\n    updatedItems = [...existingItems, newItem]\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  return {\n    cart: updatedCart,\n    message: existingItemIndex !== -1 ? 'Item quantity updated' : 'Item added to cart',\n    success: true,\n  }\n}\n"],"names":["createRequestWithSecret","defaultCartItemMatcher","addItem","args","cartID","cartItemMatcher","cartsSlug","item","payload","quantity","req","secret","reqWithSecret","cart","findByID","id","collection","depth","overrideAccess","message","success","existingItems","items","existingItemIndex","findIndex","existingItem","newItem","updatedItems","product","variant","Object","fromEntries","entries","filter","key","includes","updatedCart","update","data"],"mappings":"AAEA,SAASA,uBAAuB,QAAQ,+BAA8B;AACtE,SAASC,sBAAsB,QAAQ,8BAA6B;AAEpE;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,MAAMC,UAAU,OAAOC;IAC5B,MAAM,EACJC,MAAM,EACNC,kBAAkBJ,sBAAsB,EACxCK,SAAS,EACTC,IAAI,EACJC,OAAO,EACPC,WAAW,CAAC,EACZC,GAAG,EACHC,MAAM,EACP,GAAGR;IAEJ,wDAAwD;IACxD,MAAMS,gBAAgBZ,wBAAwBU,KAAKC;IAEnD,MAAME,OAAO,MAAML,QAAQM,QAAQ,CAAC;QAClCC,IAAIX;QACJY,YAAYV;QACZW,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,gDAAgD;IAChD,MAAMC,oBAAoBF,cAAcG,SAAS,CAAC,CAACC,eACjDpB,gBAAgB;YAAEoB;YAAcC,SAASnB;QAAK;IAGhD,IAAIoB;IAEJ,IAAIJ,sBAAsB,CAAC,GAAG;QAC5B,mCAAmC;QACnCI,eAAe;eAAIN;SAAc;QACjC,MAAMI,eAAeE,YAAY,CAACJ,kBAAkB;QACpDI,YAAY,CAACJ,kBAAkB,GAAG;YAChC,GAAGE,YAAY;YACfhB,UAAUgB,aAAahB,QAAQ,GAAGA;QACpC;IACF,OAAO;QACL,oCAAoC;QACpC,MAAMiB,UAAwB;YAC5BE,SAASrB,KAAKqB,OAAO;YACrBnB;YACA,GAAIF,KAAKsB,OAAO,GAAG;gBAAEA,SAAStB,KAAKsB,OAAO;YAAC,IAAI,CAAC,CAAC;YACjD,wDAAwD;YACxD,GAAGC,OAAOC,WAAW,CACnBD,OAAOE,OAAO,CAACzB,MAAM0B,MAAM,CAAC,CAAC,CAACC,IAAI,GAAK,CAAC;oBAAC;oBAAW;oBAAY;iBAAU,CAACC,QAAQ,CAACD,MACrF;QACH;QACAP,eAAe;eAAIN;YAAeK;SAAQ;IAC5C;IAEA,MAAMU,cAAc,MAAM5B,QAAQ6B,MAAM,CAAC;QACvCtB,IAAIX;QACJY,YAAYV;QACZgC,MAAM;YACJhB,OAAOK;QACT;QACAV,OAAO;QACPC,gBAAgB;QAChBR,KAAKE;IACP;IAEA,OAAO;QACLC,MAAMuB;QACNjB,SAASI,sBAAsB,CAAC,IAAI,0BAA0B;QAC9DH,SAAS;IACX;AACF,EAAC"}

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

@@ -0,0 +1,20 @@
+import type { CartOperationResult, ClearCartArgs } from './types.js';
+/**
+ * Clears all items from a cart.
+ *
+ * This handler is isolated and can be used from:
+ * - Custom endpoints
+ * - Local API operations
+ * - Hooks
+ *
+ * @example
+ * ```ts
+ * const result = await clearCart({
+ *   payload,
+ *   cartsSlug: 'carts',
+ *   cartID: '123',
+ * })
+ * ```
+ */
+export declare const clearCart: (args: ClearCartArgs) => Promise<CartOperationResult>;
+//# sourceMappingURL=clearCart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clearCart.d.ts","sourceRoot":"","sources":["../../../../src/collections/carts/operations/clearCart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAIpE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS,SAAgB,aAAa,KAAG,OAAO,CAAC,mBAAmB,CAsChF,CAAA"}

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

@@ -0,0 +1,53 @@
+import { createRequestWithSecret } from './createRequestWithSecret.js';
+/**
+ * Clears all items from a cart.
+ *
+ * This handler is isolated and can be used from:
+ * - Custom endpoints
+ * - Local API operations
+ * - Hooks
+ *
+ * @example
+ * ```ts
+ * const result = await clearCart({
+ *   payload,
+ *   cartsSlug: 'carts',
+ *   cartID: '123',
+ * })
+ * ```
+ */ export const clearCart = async (args)=>{
+    const { cartID, cartsSlug, 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 updatedCart = await payload.update({
+        id: cartID,
+        collection: cartsSlug,
+        data: {
+            items: []
+        },
+        depth: 0,
+        overrideAccess: false,
+        req: reqWithSecret
+    });
+    return {
+        cart: updatedCart,
+        message: 'Cart cleared',
+        success: true
+    };
+};
+
+//# sourceMappingURL=clearCart.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/collections/carts/operations/clearCart.ts"],"sourcesContent":["import type { CartOperationResult, ClearCartArgs } from './types.js'\n\nimport { createRequestWithSecret } from './createRequestWithSecret.js'\n\n/**\n * Clears all items from a cart.\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 clearCart({\n *   payload,\n *   cartsSlug: 'carts',\n *   cartID: '123',\n * })\n * ```\n */\nexport const clearCart = async (args: ClearCartArgs): Promise<CartOperationResult> => {\n  const { cartID, cartsSlug, 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 updatedCart = await payload.update({\n    id: cartID,\n    collection: cartsSlug,\n    data: {\n      items: [],\n    },\n    depth: 0,\n    overrideAccess: false,\n    req: reqWithSecret,\n  })\n\n  return {\n    cart: updatedCart,\n    message: 'Cart cleared',\n    success: true,\n  }\n}\n"],"names":["createRequestWithSecret","clearCart","args","cartID","cartsSlug","payload","req","secret","reqWithSecret","cart","findByID","id","collection","depth","overrideAccess","message","success","updatedCart","update","data","items"],"mappings":"AAEA,SAASA,uBAAuB,QAAQ,+BAA8B;AAEtE;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,MAAMC,YAAY,OAAOC;IAC9B,MAAM,EAAEC,MAAM,EAAEC,SAAS,EAAEC,OAAO,EAAEC,GAAG,EAAEC,MAAM,EAAE,GAAGL;IAEpD,wDAAwD;IACxD,MAAMM,gBAAgBR,wBAAwBM,KAAKC;IAEnD,MAAME,OAAO,MAAMJ,QAAQK,QAAQ,CAAC;QAClCC,IAAIR;QACJS,YAAYR;QACZS,OAAO;QACPC,gBAAgB;QAChBR,KAAKE;IACP;IAEA,IAAI,CAACC,MAAM;QACT,OAAO;YACLA,MAAM;YACNM,SAAS,CAAC,aAAa,EAAEZ,OAAO,UAAU,CAAC;YAC3Ca,SAAS;QACX;IACF;IAEA,MAAMC,cAAc,MAAMZ,QAAQa,MAAM,CAAC;QACvCP,IAAIR;QACJS,YAAYR;QACZe,MAAM;YACJC,OAAO,EAAE;QACX;QACAP,OAAO;QACPC,gBAAgB;QAChBR,KAAKE;IACP;IAEA,OAAO;QACLC,MAAMQ;QACNF,SAAS;QACTC,SAAS;IACX;AACF,EAAC"}

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

@@ -0,0 +1,11 @@
+import type { PayloadRequest } from 'payload';
+/**
+ * Creates a modified request object with the cart secret injected into context.
+ * This allows the access control (hasCartSecretAccess) to properly verify guest cart access.
+ *
+ * @param req - The original PayloadRequest
+ * @param secret - The cart secret to inject
+ * @returns A new request object with the secret in context, or the original if no secret
+ */
+export declare const createRequestWithSecret: (req: PayloadRequest | undefined, secret: string | undefined) => PayloadRequest | undefined;
+//# sourceMappingURL=createRequestWithSecret.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createRequestWithSecret.d.ts","sourceRoot":"","sources":["../../../../src/collections/carts/operations/createRequestWithSecret.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,QAC7B,cAAc,GAAG,SAAS,UACvB,MAAM,GAAG,SAAS,KACzB,cAAc,GAAG,SAYnB,CAAA"}

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

@@ -0,0 +1,21 @@
+/**
+ * Creates a modified request object with the cart secret injected into context.
+ * This allows the access control (hasCartSecretAccess) to properly verify guest cart access.
+ *
+ * @param req - The original PayloadRequest
+ * @param secret - The cart secret to inject
+ * @returns A new request object with the secret in context, or the original if no secret
+ */ export const createRequestWithSecret = (req, secret)=>{
+    if (!secret || !req) {
+        return req;
+    }
+    return {
+        ...req,
+        context: {
+            ...req.context,
+            cartSecret: secret
+        }
+    };
+};
+
+//# sourceMappingURL=createRequestWithSecret.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/collections/carts/operations/createRequestWithSecret.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\n/**\n * Creates a modified request object with the cart secret injected into context.\n * This allows the access control (hasCartSecretAccess) to properly verify guest cart access.\n *\n * @param req - The original PayloadRequest\n * @param secret - The cart secret to inject\n * @returns A new request object with the secret in context, or the original if no secret\n */\nexport const createRequestWithSecret = (\n  req: PayloadRequest | undefined,\n  secret: string | undefined,\n): PayloadRequest | undefined => {\n  if (!secret || !req) {\n    return req\n  }\n\n  return {\n    ...req,\n    context: {\n      ...req.context,\n      cartSecret: secret,\n    },\n  } as PayloadRequest\n}\n"],"names":["createRequestWithSecret","req","secret","context","cartSecret"],"mappings":"AAEA;;;;;;;CAOC,GACD,OAAO,MAAMA,0BAA0B,CACrCC,KACAC;IAEA,IAAI,CAACA,UAAU,CAACD,KAAK;QACnB,OAAOA;IACT;IAEA,OAAO;QACL,GAAGA,GAAG;QACNE,SAAS;YACP,GAAGF,IAAIE,OAAO;YACdC,YAAYF;QACd;IACF;AACF,EAAC"}

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

@@ -0,0 +1,19 @@
+import type { CartItemMatcher } from './types.js';
+/**
+ * Default cart item matcher that considers items identical if they have
+ * the same product ID and variant ID.
+ *
+ * Users can provide a custom matcher to add additional criteria such as
+ * delivery options, customizations, or other item-specific properties.
+ *
+ * @example
+ * ```ts
+ * // Extend the default matcher to include a delivery option
+ * const customMatcher: CartItemMatcher = ({ existingItem, newItem }) => {
+ *   const defaultMatch = defaultCartItemMatcher({ existingItem, newItem })
+ *   return defaultMatch && existingItem.deliveryOption === newItem.deliveryOption
+ * }
+ * ```
+ */
+export declare const defaultCartItemMatcher: CartItemMatcher;
+//# sourceMappingURL=defaultCartItemMatcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaultCartItemMatcher.d.ts","sourceRoot":"","sources":["../../../../src/collections/carts/operations/defaultCartItemMatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAiBpC,CAAA"}

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

@@ -0,0 +1,25 @@
+/**
+ * Default cart item matcher that considers items identical if they have
+ * the same product ID and variant ID.
+ *
+ * Users can provide a custom matcher to add additional criteria such as
+ * delivery options, customizations, or other item-specific properties.
+ *
+ * @example
+ * ```ts
+ * // Extend the default matcher to include a delivery option
+ * const customMatcher: CartItemMatcher = ({ existingItem, newItem }) => {
+ *   const defaultMatch = defaultCartItemMatcher({ existingItem, newItem })
+ *   return defaultMatch && existingItem.deliveryOption === newItem.deliveryOption
+ * }
+ * ```
+ */ export const defaultCartItemMatcher = ({ existingItem, newItem })=>{
+    const existingProductID = typeof existingItem.product === 'object' ? existingItem.product.id : existingItem.product;
+    const existingVariantID = existingItem.variant && typeof existingItem.variant === 'object' ? existingItem.variant.id : existingItem.variant;
+    const productMatches = existingProductID === newItem.product;
+    // Variant matching: both must have same variant or both must have no variant
+    const variantMatches = newItem.variant ? existingVariantID === newItem.variant : !existingVariantID;
+    return productMatches && variantMatches;
+};
+
+//# sourceMappingURL=defaultCartItemMatcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/collections/carts/operations/defaultCartItemMatcher.ts"],"sourcesContent":["import type { CartItemMatcher } from './types.js'\n\n/**\n * Default cart item matcher that considers items identical if they have\n * the same product ID and variant ID.\n *\n * Users can provide a custom matcher to add additional criteria such as\n * delivery options, customizations, or other item-specific properties.\n *\n * @example\n * ```ts\n * // Extend the default matcher to include a delivery option\n * const customMatcher: CartItemMatcher = ({ existingItem, newItem }) => {\n *   const defaultMatch = defaultCartItemMatcher({ existingItem, newItem })\n *   return defaultMatch && existingItem.deliveryOption === newItem.deliveryOption\n * }\n * ```\n */\nexport const defaultCartItemMatcher: CartItemMatcher = ({ existingItem, newItem }) => {\n  const existingProductID =\n    typeof existingItem.product === 'object' ? existingItem.product.id : existingItem.product\n\n  const existingVariantID =\n    existingItem.variant && typeof existingItem.variant === 'object'\n      ? existingItem.variant.id\n      : existingItem.variant\n\n  const productMatches = existingProductID === newItem.product\n\n  // Variant matching: both must have same variant or both must have no variant\n  const variantMatches = newItem.variant\n    ? existingVariantID === newItem.variant\n    : !existingVariantID\n\n  return productMatches && variantMatches\n}\n"],"names":["defaultCartItemMatcher","existingItem","newItem","existingProductID","product","id","existingVariantID","variant","productMatches","variantMatches"],"mappings":"AAEA;;;;;;;;;;;;;;;CAeC,GACD,OAAO,MAAMA,yBAA0C,CAAC,EAAEC,YAAY,EAAEC,OAAO,EAAE;IAC/E,MAAMC,oBACJ,OAAOF,aAAaG,OAAO,KAAK,WAAWH,aAAaG,OAAO,CAACC,EAAE,GAAGJ,aAAaG,OAAO;IAE3F,MAAME,oBACJL,aAAaM,OAAO,IAAI,OAAON,aAAaM,OAAO,KAAK,WACpDN,aAAaM,OAAO,CAACF,EAAE,GACvBJ,aAAaM,OAAO;IAE1B,MAAMC,iBAAiBL,sBAAsBD,QAAQE,OAAO;IAE5D,6EAA6E;IAC7E,MAAMK,iBAAiBP,QAAQK,OAAO,GAClCD,sBAAsBJ,QAAQK,OAAO,GACrC,CAACD;IAEL,OAAOE,kBAAkBC;AAC3B,EAAC"}