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

package/dist/collections/addresses/createAddressesCollection.d.ts

@@ -1,7 +1,7 @@
 import type { CollectionConfig, Field } from 'payload';
 import type { AccessConfig, CountryType } from '../../types/index.js';
 type Props = {
-    access: Pick<AccessConfig, 'customerOnlyFieldAccess' | 'isAdmin' | 'isAuthenticated' | 'isDocumentOwner'>;
+    access: Pick<AccessConfig, 'customerOnlyFieldAccess' | 'isAdmin' | 'isAuthenticated' | 'isCustomer' | 'isDocumentOwner'>;
     /**
      * Array of fields used for capturing the address data. Use this over overrides to customise the fields here as it's reused across the plugin.
      */

package/dist/collections/addresses/createAddressesCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createAddressesCollection.d.ts","sourceRoot":"","sources":["../../../src/collections/addresses/createAddressesCollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAMrE,KAAK,KAAK,GAAG;IACX,MAAM,EAAE,IAAI,CACV,YAAY,EACZ,yBAAyB,GAAG,SAAS,GAAG,iBAAiB,GAAG,iBAAiB,CAC9E,CAAA;IACD;;OAEG;IACH,aAAa,EAAE,KAAK,EAAE,CAAA;IACtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kBAAkB,CAAC,EAAE,WAAW,EAAE,CAAA;CACnC,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,gBAyEzD,CAAA"}
+{"version":3,"file":"createAddressesCollection.d.ts","sourceRoot":"","sources":["../../../src/collections/addresses/createAddressesCollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAMrE,KAAK,KAAK,GAAG;IACX,MAAM,EAAE,IAAI,CACV,YAAY,EACZ,yBAAyB,GAAG,SAAS,GAAG,iBAAiB,GAAG,YAAY,GAAG,iBAAiB,CAC7F,CAAA;IACD;;OAEG;IACH,aAAa,EAAE,KAAK,EAAE,CAAA;IACtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kBAAkB,CAAC,EAAE,WAAW,EAAE,CAAA;CACnC,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,gBA2EzD,CAAA"}

package/dist/collections/addresses/createAddressesCollection.js

@@ -53,7 +53,7 @@ export const createAddressesCollection = (props)=>{
         hooks: {
             beforeChange: [
                 beforeChange({
-                    customerOnlyFieldAccess: access.customerOnlyFieldAccess
+                    isCustomer: access.isCustomer ?? access.customerOnlyFieldAccess
                 })
             ]
         },

package/dist/collections/addresses/createAddressesCollection.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/collections/addresses/createAddressesCollection.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nimport type { AccessConfig, CountryType } from '../../types/index.js'\n\nimport { accessOR } from '../../utilities/accessComposition.js'\nimport { defaultCountries } from './defaultCountries.js'\nimport { beforeChange } from './hooks/beforeChange.js'\n\ntype Props = {\n  access: Pick<\n    AccessConfig,\n    'customerOnlyFieldAccess' | 'isAdmin' | 'isAuthenticated' | 'isDocumentOwner'\n  >\n  /**\n   * Array of fields used for capturing the address data. Use this over overrides to customise the fields here as it's reused across the plugin.\n   */\n  addressFields: Field[]\n  /**\n   * Slug of the customers collection, defaults to 'users'.\n   */\n  customersSlug?: string\n  supportedCountries?: CountryType[]\n}\n\nexport const createAddressesCollection: (props: Props) => CollectionConfig = (props) => {\n  const { access, addressFields, customersSlug = 'users' } = props || {}\n\n  const { supportedCountries: supportedCountriesFromProps } = props || {}\n  const supportedCountries = supportedCountriesFromProps || defaultCountries\n  const hasOnlyOneCountry = supportedCountries && supportedCountries.length === 1\n\n  const fields: Field[] = [\n    {\n      name: 'customer',\n      type: 'relationship',\n      admin: {\n        position: 'sidebar',\n      },\n      label: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:customer'),\n      relationTo: customersSlug,\n    },\n    ...addressFields.map((field) => {\n      if ('name' in field && field.name === 'country') {\n        return {\n          name: 'country',\n          type: 'select',\n          label: ({ t }) =>\n            // @ts-expect-error - translations are not typed in plugins yet\n            t('plugin-ecommerce:addressCountry'),\n          options: supportedCountries || defaultCountries,\n          required: true,\n          ...(supportedCountries && supportedCountries?.[0] && hasOnlyOneCountry\n            ? {\n                defaultValue: supportedCountries?.[0].value,\n              }\n            : {}),\n        } as Field\n      }\n\n      return field\n    }),\n  ]\n\n  const baseConfig: CollectionConfig = {\n    slug: 'addresses',\n    access: {\n      create: access.isAuthenticated,\n      delete: accessOR(access.isAdmin, access.isDocumentOwner),\n      read: accessOR(access.isAdmin, access.isDocumentOwner),\n      update: accessOR(access.isAdmin, access.isDocumentOwner),\n    },\n    admin: {\n      description: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:addressesCollectionDescription'),\n      group: 'Ecommerce',\n      hidden: true,\n      useAsTitle: 'createdAt',\n    },\n    fields,\n    hooks: {\n      beforeChange: [beforeChange({ customerOnlyFieldAccess: access.customerOnlyFieldAccess })],\n    },\n    labels: {\n      plural: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:addresses'),\n      singular: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:address'),\n    },\n    timestamps: true,\n  }\n\n  return { ...baseConfig }\n}\n"],"names":["accessOR","defaultCountries","beforeChange","createAddressesCollection","props","access","addressFields","customersSlug","supportedCountries","supportedCountriesFromProps","hasOnlyOneCountry","length","fields","name","type","admin","position","label","t","relationTo","map","field","options","required","defaultValue","value","baseConfig","slug","create","isAuthenticated","delete","isAdmin","isDocumentOwner","read","update","description","group","hidden","useAsTitle","hooks","customerOnlyFieldAccess","labels","plural","singular","timestamps"],"mappings":"AAIA,SAASA,QAAQ,QAAQ,uCAAsC;AAC/D,SAASC,gBAAgB,QAAQ,wBAAuB;AACxD,SAASC,YAAY,QAAQ,0BAAyB;AAkBtD,OAAO,MAAMC,4BAAgE,CAACC;IAC5E,MAAM,EAAEC,MAAM,EAAEC,aAAa,EAAEC,gBAAgB,OAAO,EAAE,GAAGH,SAAS,CAAC;IAErE,MAAM,EAAEI,oBAAoBC,2BAA2B,EAAE,GAAGL,SAAS,CAAC;IACtE,MAAMI,qBAAqBC,+BAA+BR;IAC1D,MAAMS,oBAAoBF,sBAAsBA,mBAAmBG,MAAM,KAAK;IAE9E,MAAMC,SAAkB;QACtB;YACEC,MAAM;YACNC,MAAM;YACNC,OAAO;gBACLC,UAAU;YACZ;YACAC,OAAO,CAAC,EAAEC,CAAC,EAAE,GACX,+DAA+D;gBAC/DA,EAAE;YACJC,YAAYZ;QACd;WACGD,cAAcc,GAAG,CAAC,CAACC;YACpB,IAAI,UAAUA,SAASA,MAAMR,IAAI,KAAK,WAAW;gBAC/C,OAAO;oBACLA,MAAM;oBACNC,MAAM;oBACNG,OAAO,CAAC,EAAEC,CAAC,EAAE,GACX,+DAA+D;wBAC/DA,EAAE;oBACJI,SAASd,sBAAsBP;oBAC/BsB,UAAU;oBACV,GAAIf,sBAAsBA,oBAAoB,CAAC,EAAE,IAAIE,oBACjD;wBACEc,cAAchB,oBAAoB,CAAC,EAAE,CAACiB;oBACxC,IACA,CAAC,CAAC;gBACR;YACF;YAEA,OAAOJ;QACT;KACD;IAED,MAAMK,aAA+B;QACnCC,MAAM;QACNtB,QAAQ;YACNuB,QAAQvB,OAAOwB,eAAe;YAC9BC,QAAQ9B,SAASK,OAAO0B,OAAO,EAAE1B,OAAO2B,eAAe;YACvDC,MAAMjC,SAASK,OAAO0B,OAAO,EAAE1B,OAAO2B,eAAe;YACrDE,QAAQlC,SAASK,OAAO0B,OAAO,EAAE1B,OAAO2B,eAAe;QACzD;QACAjB,OAAO;YACLoB,aAAa,CAAC,EAAEjB,CAAC,EAAE,GACjB,+DAA+D;gBAC/DA,EAAE;YACJkB,OAAO;YACPC,QAAQ;YACRC,YAAY;QACd;QACA1B;QACA2B,OAAO;YACLrC,cAAc;gBAACA,aAAa;oBAAEsC,yBAAyBnC,OAAOmC,uBAAuB;gBAAC;aAAG;QAC3F;QACAC,QAAQ;YACNC,QAAQ,CAAC,EAAExB,CAAC,EAAE,GACZ,+DAA+D;gBAC/DA,EAAE;YACJyB,UAAU,CAAC,EAAEzB,CAAC,EAAE,GACd,+DAA+D;gBAC/DA,EAAE;QACN;QACA0B,YAAY;IACd;IAEA,OAAO;QAAE,GAAGlB,UAAU;IAAC;AACzB,EAAC"}
+{"version":3,"sources":["../../../src/collections/addresses/createAddressesCollection.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nimport type { AccessConfig, CountryType } from '../../types/index.js'\n\nimport { accessOR } from '../../utilities/accessComposition.js'\nimport { defaultCountries } from './defaultCountries.js'\nimport { beforeChange } from './hooks/beforeChange.js'\n\ntype Props = {\n  access: Pick<\n    AccessConfig,\n    'customerOnlyFieldAccess' | 'isAdmin' | 'isAuthenticated' | 'isCustomer' | 'isDocumentOwner'\n  >\n  /**\n   * Array of fields used for capturing the address data. Use this over overrides to customise the fields here as it's reused across the plugin.\n   */\n  addressFields: Field[]\n  /**\n   * Slug of the customers collection, defaults to 'users'.\n   */\n  customersSlug?: string\n  supportedCountries?: CountryType[]\n}\n\nexport const createAddressesCollection: (props: Props) => CollectionConfig = (props) => {\n  const { access, addressFields, customersSlug = 'users' } = props || {}\n\n  const { supportedCountries: supportedCountriesFromProps } = props || {}\n  const supportedCountries = supportedCountriesFromProps || defaultCountries\n  const hasOnlyOneCountry = supportedCountries && supportedCountries.length === 1\n\n  const fields: Field[] = [\n    {\n      name: 'customer',\n      type: 'relationship',\n      admin: {\n        position: 'sidebar',\n      },\n      label: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:customer'),\n      relationTo: customersSlug,\n    },\n    ...addressFields.map((field) => {\n      if ('name' in field && field.name === 'country') {\n        return {\n          name: 'country',\n          type: 'select',\n          label: ({ t }) =>\n            // @ts-expect-error - translations are not typed in plugins yet\n            t('plugin-ecommerce:addressCountry'),\n          options: supportedCountries || defaultCountries,\n          required: true,\n          ...(supportedCountries && supportedCountries?.[0] && hasOnlyOneCountry\n            ? {\n                defaultValue: supportedCountries?.[0].value,\n              }\n            : {}),\n        } as Field\n      }\n\n      return field\n    }),\n  ]\n\n  const baseConfig: CollectionConfig = {\n    slug: 'addresses',\n    access: {\n      create: access.isAuthenticated,\n      delete: accessOR(access.isAdmin, access.isDocumentOwner),\n      read: accessOR(access.isAdmin, access.isDocumentOwner),\n      update: accessOR(access.isAdmin, access.isDocumentOwner),\n    },\n    admin: {\n      description: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:addressesCollectionDescription'),\n      group: 'Ecommerce',\n      hidden: true,\n      useAsTitle: 'createdAt',\n    },\n    fields,\n    hooks: {\n      beforeChange: [\n        beforeChange({ isCustomer: access.isCustomer ?? access.customerOnlyFieldAccess }),\n      ],\n    },\n    labels: {\n      plural: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:addresses'),\n      singular: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:address'),\n    },\n    timestamps: true,\n  }\n\n  return { ...baseConfig }\n}\n"],"names":["accessOR","defaultCountries","beforeChange","createAddressesCollection","props","access","addressFields","customersSlug","supportedCountries","supportedCountriesFromProps","hasOnlyOneCountry","length","fields","name","type","admin","position","label","t","relationTo","map","field","options","required","defaultValue","value","baseConfig","slug","create","isAuthenticated","delete","isAdmin","isDocumentOwner","read","update","description","group","hidden","useAsTitle","hooks","isCustomer","customerOnlyFieldAccess","labels","plural","singular","timestamps"],"mappings":"AAIA,SAASA,QAAQ,QAAQ,uCAAsC;AAC/D,SAASC,gBAAgB,QAAQ,wBAAuB;AACxD,SAASC,YAAY,QAAQ,0BAAyB;AAkBtD,OAAO,MAAMC,4BAAgE,CAACC;IAC5E,MAAM,EAAEC,MAAM,EAAEC,aAAa,EAAEC,gBAAgB,OAAO,EAAE,GAAGH,SAAS,CAAC;IAErE,MAAM,EAAEI,oBAAoBC,2BAA2B,EAAE,GAAGL,SAAS,CAAC;IACtE,MAAMI,qBAAqBC,+BAA+BR;IAC1D,MAAMS,oBAAoBF,sBAAsBA,mBAAmBG,MAAM,KAAK;IAE9E,MAAMC,SAAkB;QACtB;YACEC,MAAM;YACNC,MAAM;YACNC,OAAO;gBACLC,UAAU;YACZ;YACAC,OAAO,CAAC,EAAEC,CAAC,EAAE,GACX,+DAA+D;gBAC/DA,EAAE;YACJC,YAAYZ;QACd;WACGD,cAAcc,GAAG,CAAC,CAACC;YACpB,IAAI,UAAUA,SAASA,MAAMR,IAAI,KAAK,WAAW;gBAC/C,OAAO;oBACLA,MAAM;oBACNC,MAAM;oBACNG,OAAO,CAAC,EAAEC,CAAC,EAAE,GACX,+DAA+D;wBAC/DA,EAAE;oBACJI,SAASd,sBAAsBP;oBAC/BsB,UAAU;oBACV,GAAIf,sBAAsBA,oBAAoB,CAAC,EAAE,IAAIE,oBACjD;wBACEc,cAAchB,oBAAoB,CAAC,EAAE,CAACiB;oBACxC,IACA,CAAC,CAAC;gBACR;YACF;YAEA,OAAOJ;QACT;KACD;IAED,MAAMK,aAA+B;QACnCC,MAAM;QACNtB,QAAQ;YACNuB,QAAQvB,OAAOwB,eAAe;YAC9BC,QAAQ9B,SAASK,OAAO0B,OAAO,EAAE1B,OAAO2B,eAAe;YACvDC,MAAMjC,SAASK,OAAO0B,OAAO,EAAE1B,OAAO2B,eAAe;YACrDE,QAAQlC,SAASK,OAAO0B,OAAO,EAAE1B,OAAO2B,eAAe;QACzD;QACAjB,OAAO;YACLoB,aAAa,CAAC,EAAEjB,CAAC,EAAE,GACjB,+DAA+D;gBAC/DA,EAAE;YACJkB,OAAO;YACPC,QAAQ;YACRC,YAAY;QACd;QACA1B;QACA2B,OAAO;YACLrC,cAAc;gBACZA,aAAa;oBAAEsC,YAAYnC,OAAOmC,UAAU,IAAInC,OAAOoC,uBAAuB;gBAAC;aAChF;QACH;QACAC,QAAQ;YACNC,QAAQ,CAAC,EAAEzB,CAAC,EAAE,GACZ,+DAA+D;gBAC/DA,EAAE;YACJ0B,UAAU,CAAC,EAAE1B,CAAC,EAAE,GACd,+DAA+D;gBAC/DA,EAAE;QACN;QACA2B,YAAY;IACd;IAEA,OAAO;QAAE,GAAGnB,UAAU;IAAC;AACzB,EAAC"}

package/dist/collections/addresses/hooks/beforeChange.d.ts

@@ -1,7 +1,6 @@
-import type { CollectionBeforeChangeHook } from 'payload';
-import type { AccessConfig } from '../../../types/index.js';
+import type { CollectionBeforeChangeHook, FieldAccess } from 'payload';
 interface Props {
-    customerOnlyFieldAccess: AccessConfig['customerOnlyFieldAccess'];
+    isCustomer?: FieldAccess;
 }
 export declare const beforeChange: (args: Props) => CollectionBeforeChangeHook;
 export {};

package/dist/collections/addresses/hooks/beforeChange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"beforeChange.d.ts","sourceRoot":"","sources":["../../../../src/collections/addresses/hooks/beforeChange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,UAAU,KAAK;IACb,uBAAuB,EAAE,YAAY,CAAC,yBAAyB,CAAC,CAAA;CACjE;AAED,eAAO,MAAM,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,0BAUzC,CAAA"}
+{"version":3,"file":"beforeChange.d.ts","sourceRoot":"","sources":["../../../../src/collections/addresses/hooks/beforeChange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEtE,UAAU,KAAK;IACb,UAAU,CAAC,EAAE,WAAW,CAAA;CACzB;AAED,eAAO,MAAM,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,0BAgBzC,CAAA"}

package/dist/collections/addresses/hooks/beforeChange.js

@@ -1,12 +1,16 @@
-export const beforeChange = ({ customerOnlyFieldAccess })=>async ({ data, req })=>{
-        const isCustomer = await customerOnlyFieldAccess({
+export const beforeChange = ({ isCustomer })=>async ({ data, req })=>{
+        if (!isCustomer) {
+            return data;
+        }
+        const userIsCustomer = await isCustomer({
             req
         });
         // Ensure that the customer field is set to the current user's ID if the user is a customer.
         // Admins can set to any customer.
-        if (req.user && isCustomer) {
+        if (req.user && userIsCustomer) {
             data.customer = req.user.id;
         }
+        return data;
     };
 
 //# sourceMappingURL=beforeChange.js.map

package/dist/collections/addresses/hooks/beforeChange.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/collections/addresses/hooks/beforeChange.ts"],"sourcesContent":["import type { CollectionBeforeChangeHook } from 'payload'\n\nimport type { AccessConfig } from '../../../types/index.js'\n\ninterface Props {\n  customerOnlyFieldAccess: AccessConfig['customerOnlyFieldAccess']\n}\n\nexport const beforeChange: (args: Props) => CollectionBeforeChangeHook =\n  ({ customerOnlyFieldAccess }) =>\n  async ({ data, req }) => {\n    const isCustomer = await customerOnlyFieldAccess({ req })\n\n    // Ensure that the customer field is set to the current user's ID if the user is a customer.\n    // Admins can set to any customer.\n    if (req.user && isCustomer) {\n      data.customer = req.user.id\n    }\n  }\n"],"names":["beforeChange","customerOnlyFieldAccess","data","req","isCustomer","user","customer","id"],"mappings":"AAQA,OAAO,MAAMA,eACX,CAAC,EAAEC,uBAAuB,EAAE,GAC5B,OAAO,EAAEC,IAAI,EAAEC,GAAG,EAAE;QAClB,MAAMC,aAAa,MAAMH,wBAAwB;YAAEE;QAAI;QAEvD,4FAA4F;QAC5F,kCAAkC;QAClC,IAAIA,IAAIE,IAAI,IAAID,YAAY;YAC1BF,KAAKI,QAAQ,GAAGH,IAAIE,IAAI,CAACE,EAAE;QAC7B;IACF,EAAC"}
+{"version":3,"sources":["../../../../src/collections/addresses/hooks/beforeChange.ts"],"sourcesContent":["import type { CollectionBeforeChangeHook, FieldAccess } from 'payload'\n\ninterface Props {\n  isCustomer?: FieldAccess\n}\n\nexport const beforeChange: (args: Props) => CollectionBeforeChangeHook =\n  ({ isCustomer }) =>\n  async ({ data, req }) => {\n    if (!isCustomer) {\n      return data\n    }\n\n    const userIsCustomer = await isCustomer({ req })\n\n    // Ensure that the customer field is set to the current user's ID if the user is a customer.\n    // Admins can set to any customer.\n    if (req.user && userIsCustomer) {\n      data.customer = req.user.id\n    }\n\n    return data\n  }\n"],"names":["beforeChange","isCustomer","data","req","userIsCustomer","user","customer","id"],"mappings":"AAMA,OAAO,MAAMA,eACX,CAAC,EAAEC,UAAU,EAAE,GACf,OAAO,EAAEC,IAAI,EAAEC,GAAG,EAAE;QAClB,IAAI,CAACF,YAAY;YACf,OAAOC;QACT;QAEA,MAAME,iBAAiB,MAAMH,WAAW;YAAEE;QAAI;QAE9C,4FAA4F;QAC5F,kCAAkC;QAClC,IAAIA,IAAIE,IAAI,IAAID,gBAAgB;YAC9BF,KAAKI,QAAQ,GAAGH,IAAIE,IAAI,CAACE,EAAE;QAC7B;QAEA,OAAOL;IACT,EAAC"}

package/dist/collections/carts/beforeChange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"beforeChange.d.ts","sourceRoot":"","sources":["../../../src/collections/carts/beforeChange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAIzD,KAAK,KAAK,GAAG;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,0BAsD7C,CAAA"}
+{"version":3,"file":"beforeChange.d.ts","sourceRoot":"","sources":["../../../src/collections/carts/beforeChange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAIzD,KAAK,KAAK,GAAG;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,0BAwD7C,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/collections/carts/beforeChange.ts"],"sourcesContent":["import type { CollectionBeforeChangeHook } from 'payload'\n\nimport crypto from 'crypto'\n\ntype Props = {\n  productsSlug: string\n  variantsSlug: string\n}\n\nexport const beforeChangeCart: (args: Props) => CollectionBeforeChangeHook =\n  ({ productsSlug, variantsSlug }) =>\n  async ({ data, operation, req }) => {\n    // Generate a secret for guest cart access on creation\n    if (operation === 'create' && !data.customer && !data.secret) {\n      // Generate a cryptographically secure random string\n      const secret = crypto.randomBytes(20).toString('hex')\n      data.secret = secret\n\n      // Store in context so afterRead hook can include it in the creation response\n      if (!req.context) { req.context = {} }\n      req.context.newCartSecret = secret\n    }\n\n    // Update subtotal based on items in the cart\n    if (data.items && Array.isArray(data.items)) {\n      const priceField = `priceIn${data.currency}`\n\n      let subtotal = 0\n\n      for (const item of data.items) {\n        if (item.variant) {\n          const id = typeof item.variant === 'object' ? item.variant.id : item.variant\n\n          const variant = await req.payload.findByID({\n            id,\n            collection: variantsSlug,\n            depth: 0,\n            select: {\n              [priceField]: true,\n            },\n          })\n\n          subtotal += variant[priceField] * item.quantity\n        } else {\n          const id = typeof item.product === 'object' ? item.product.id : item.product\n\n          const product = await req.payload.findByID({\n            id,\n            collection: productsSlug,\n            depth: 0,\n            select: {\n              [priceField]: true,\n            },\n          })\n\n          subtotal += product[priceField] * item.quantity\n        }\n      }\n\n      data.subtotal = subtotal\n    } else {\n      data.subtotal = 0\n    }\n  }\n"],"names":["crypto","beforeChangeCart","productsSlug","variantsSlug","data","operation","req","customer","secret","randomBytes","toString","context","newCartSecret","items","Array","isArray","priceField","currency","subtotal","item","variant","id","payload","findByID","collection","depth","select","quantity","product"],"mappings":"AAEA,OAAOA,YAAY,SAAQ;AAO3B,OAAO,MAAMC,mBACX,CAAC,EAAEC,YAAY,EAAEC,YAAY,EAAE,GAC/B,OAAO,EAAEC,IAAI,EAAEC,SAAS,EAAEC,GAAG,EAAE;QAC7B,sDAAsD;QACtD,IAAID,cAAc,YAAY,CAACD,KAAKG,QAAQ,IAAI,CAACH,KAAKI,MAAM,EAAE;YAC5D,oDAAoD;YACpD,MAAMA,SAASR,OAAOS,WAAW,CAAC,IAAIC,QAAQ,CAAC;YAC/CN,KAAKI,MAAM,GAAGA;YAEd,6EAA6E;YAC7E,IAAI,CAACF,IAAIK,OAAO,EAAE;gBAAEL,IAAIK,OAAO,GAAG,CAAC;YAAE;YACrCL,IAAIK,OAAO,CAACC,aAAa,GAAGJ;QAC9B;QAEA,6CAA6C;QAC7C,IAAIJ,KAAKS,KAAK,IAAIC,MAAMC,OAAO,CAACX,KAAKS,KAAK,GAAG;YAC3C,MAAMG,aAAa,CAAC,OAAO,EAAEZ,KAAKa,QAAQ,EAAE;YAE5C,IAAIC,WAAW;YAEf,KAAK,MAAMC,QAAQf,KAAKS,KAAK,CAAE;gBAC7B,IAAIM,KAAKC,OAAO,EAAE;oBAChB,MAAMC,KAAK,OAAOF,KAAKC,OAAO,KAAK,WAAWD,KAAKC,OAAO,CAACC,EAAE,GAAGF,KAAKC,OAAO;oBAE5E,MAAMA,UAAU,MAAMd,IAAIgB,OAAO,CAACC,QAAQ,CAAC;wBACzCF;wBACAG,YAAYrB;wBACZsB,OAAO;wBACPC,QAAQ;4BACN,CAACV,WAAW,EAAE;wBAChB;oBACF;oBAEAE,YAAYE,OAAO,CAACJ,WAAW,GAAGG,KAAKQ,QAAQ;gBACjD,OAAO;oBACL,MAAMN,KAAK,OAAOF,KAAKS,OAAO,KAAK,WAAWT,KAAKS,OAAO,CAACP,EAAE,GAAGF,KAAKS,OAAO;oBAE5E,MAAMA,UAAU,MAAMtB,IAAIgB,OAAO,CAACC,QAAQ,CAAC;wBACzCF;wBACAG,YAAYtB;wBACZuB,OAAO;wBACPC,QAAQ;4BACN,CAACV,WAAW,EAAE;wBAChB;oBACF;oBAEAE,YAAYU,OAAO,CAACZ,WAAW,GAAGG,KAAKQ,QAAQ;gBACjD;YACF;YAEAvB,KAAKc,QAAQ,GAAGA;QAClB,OAAO;YACLd,KAAKc,QAAQ,GAAG;QAClB;IACF,EAAC"}
+{"version":3,"sources":["../../../src/collections/carts/beforeChange.ts"],"sourcesContent":["import type { CollectionBeforeChangeHook } from 'payload'\n\nimport crypto from 'crypto'\n\ntype Props = {\n  productsSlug: string\n  variantsSlug: string\n}\n\nexport const beforeChangeCart: (args: Props) => CollectionBeforeChangeHook =\n  ({ productsSlug, variantsSlug }) =>\n  async ({ data, operation, req }) => {\n    // Generate a secret for guest cart access on creation\n    if (operation === 'create' && !data.customer && !data.secret) {\n      // Generate a cryptographically secure random string\n      const secret = crypto.randomBytes(20).toString('hex')\n      data.secret = secret\n\n      // Store in context so afterRead hook can include it in the creation response\n      if (!req.context) {\n        req.context = {}\n      }\n      req.context.newCartSecret = secret\n    }\n\n    // Update subtotal based on items in the cart\n    if (data.items && Array.isArray(data.items)) {\n      const priceField = `priceIn${data.currency}`\n\n      let subtotal = 0\n\n      for (const item of data.items) {\n        if (item.variant) {\n          const id = typeof item.variant === 'object' ? item.variant.id : item.variant\n\n          const variant = await req.payload.findByID({\n            id,\n            collection: variantsSlug,\n            depth: 0,\n            select: {\n              [priceField]: true,\n            },\n          })\n\n          subtotal += variant[priceField] * item.quantity\n        } else {\n          const id = typeof item.product === 'object' ? item.product.id : item.product\n\n          const product = await req.payload.findByID({\n            id,\n            collection: productsSlug,\n            depth: 0,\n            select: {\n              [priceField]: true,\n            },\n          })\n\n          subtotal += product[priceField] * item.quantity\n        }\n      }\n\n      data.subtotal = subtotal\n    } else {\n      data.subtotal = 0\n    }\n  }\n"],"names":["crypto","beforeChangeCart","productsSlug","variantsSlug","data","operation","req","customer","secret","randomBytes","toString","context","newCartSecret","items","Array","isArray","priceField","currency","subtotal","item","variant","id","payload","findByID","collection","depth","select","quantity","product"],"mappings":"AAEA,OAAOA,YAAY,SAAQ;AAO3B,OAAO,MAAMC,mBACX,CAAC,EAAEC,YAAY,EAAEC,YAAY,EAAE,GAC/B,OAAO,EAAEC,IAAI,EAAEC,SAAS,EAAEC,GAAG,EAAE;QAC7B,sDAAsD;QACtD,IAAID,cAAc,YAAY,CAACD,KAAKG,QAAQ,IAAI,CAACH,KAAKI,MAAM,EAAE;YAC5D,oDAAoD;YACpD,MAAMA,SAASR,OAAOS,WAAW,CAAC,IAAIC,QAAQ,CAAC;YAC/CN,KAAKI,MAAM,GAAGA;YAEd,6EAA6E;YAC7E,IAAI,CAACF,IAAIK,OAAO,EAAE;gBAChBL,IAAIK,OAAO,GAAG,CAAC;YACjB;YACAL,IAAIK,OAAO,CAACC,aAAa,GAAGJ;QAC9B;QAEA,6CAA6C;QAC7C,IAAIJ,KAAKS,KAAK,IAAIC,MAAMC,OAAO,CAACX,KAAKS,KAAK,GAAG;YAC3C,MAAMG,aAAa,CAAC,OAAO,EAAEZ,KAAKa,QAAQ,EAAE;YAE5C,IAAIC,WAAW;YAEf,KAAK,MAAMC,QAAQf,KAAKS,KAAK,CAAE;gBAC7B,IAAIM,KAAKC,OAAO,EAAE;oBAChB,MAAMC,KAAK,OAAOF,KAAKC,OAAO,KAAK,WAAWD,KAAKC,OAAO,CAACC,EAAE,GAAGF,KAAKC,OAAO;oBAE5E,MAAMA,UAAU,MAAMd,IAAIgB,OAAO,CAACC,QAAQ,CAAC;wBACzCF;wBACAG,YAAYrB;wBACZsB,OAAO;wBACPC,QAAQ;4BACN,CAACV,WAAW,EAAE;wBAChB;oBACF;oBAEAE,YAAYE,OAAO,CAACJ,WAAW,GAAGG,KAAKQ,QAAQ;gBACjD,OAAO;oBACL,MAAMN,KAAK,OAAOF,KAAKS,OAAO,KAAK,WAAWT,KAAKS,OAAO,CAACP,EAAE,GAAGF,KAAKS,OAAO;oBAE5E,MAAMA,UAAU,MAAMtB,IAAIgB,OAAO,CAACC,QAAQ,CAAC;wBACzCF;wBACAG,YAAYtB;wBACZuB,OAAO;wBACPC,QAAQ;4BACN,CAACV,WAAW,EAAE;wBAChB;oBACF;oBAEAE,YAAYU,OAAO,CAACZ,WAAW,GAAGG,KAAKQ,QAAQ;gBACjD;YACF;YAEAvB,KAAKc,QAAQ,GAAGA;QAClB,OAAO;YACLd,KAAKc,QAAQ,GAAG;QAClB;IACF,EAAC"}

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

@@ -1,5 +1,6 @@
 import type { CollectionConfig } from 'payload';
 import type { AccessConfig, CurrenciesConfig } from '../../types/index.js';
+import type { CartItemMatcher } from './operations/types.js';
 type Props = {
     access: Pick<Required<AccessConfig>, 'isAdmin' | 'isAuthenticated' | 'isDocumentOwner'>;
     /**
@@ -7,6 +8,26 @@ type Props = {
      * Defaults to false.
      */
     allowGuestCarts?: boolean;
+    /**
+     * Custom function to determine if two cart items should be considered the same.
+     * When items match, their quantities are combined instead of creating separate entries.
+     *
+     * Use this to add custom uniqueness criteria beyond product and variant IDs.
+     *
+     * @default defaultCartItemMatcher (matches by product and variant ID only)
+     *
+     * @example
+     * ```ts
+     * cartItemMatcher: ({ existingItem, newItem }) => {
+     *   // Match by product, variant, AND custom delivery option
+     *   const productMatch = existingItem.product === newItem.product
+     *   const variantMatch = existingItem.variant === newItem.variant
+     *   const deliveryMatch = existingItem.deliveryOption === newItem.deliveryOption
+     *   return productMatch && variantMatch && deliveryMatch
+     * }
+     * ```
+     */
+    cartItemMatcher?: CartItemMatcher;
     currenciesConfig?: CurrenciesConfig;
     /**
      * Slug of the customers collection, defaults to 'users'.

package/dist/collections/carts/createCartsCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createCartsCollection.d.ts","sourceRoot":"","sources":["../../../src/collections/carts/createCartsCollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,gBAAgB,EAAS,MAAM,SAAS,CAAA;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAU1E,KAAK,KAAK,GAAG;IACX,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,iBAAiB,CAAC,CAAA;IACvF;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,gBA0LrD,CAAA"}
+{"version":3,"file":"createCartsCollection.d.ts","sourceRoot":"","sources":["../../../src/collections/carts/createCartsCollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,gBAAgB,EAAS,MAAM,SAAS,CAAA;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAe5D,KAAK,KAAK,GAAG;IACX,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,iBAAiB,CAAC,CAAA;IACvF;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,gBAqMrD,CAAA"}

package/dist/collections/carts/createCartsCollection.js

@@ -3,10 +3,16 @@ import { cartItemsField } from '../../fields/cartItemsField.js';
 import { currencyField } from '../../fields/currencyField.js';
 import { accessOR, conditional } from '../../utilities/accessComposition.js';
 import { beforeChangeCart } from './beforeChange.js';
+import { addItemEndpoint } from './endpoints/addItem.js';
+import { clearCartEndpoint } from './endpoints/clearCart.js';
+import { mergeCartEndpoint } from './endpoints/mergeCart.js';
+import { removeItemEndpoint } from './endpoints/removeItem.js';
+import { updateItemEndpoint } from './endpoints/updateItem.js';
 import { hasCartSecretAccess } from './hasCartSecretAccess.js';
 import { statusBeforeRead } from './statusBeforeRead.js';
 export const createCartsCollection = (props)=>{
-    const { access, allowGuestCarts = false, currenciesConfig, customersSlug = 'users', enableVariants = false, productsSlug = 'products', variantsSlug = 'variants' } = props || {};
+    const { access, allowGuestCarts = false, cartItemMatcher, currenciesConfig, customersSlug = 'users', enableVariants = false, productsSlug = 'products', variantsSlug = 'variants' } = props || {};
+    const cartsSlug = 'carts';
     const fields = [
         cartItemsField({
             enableVariants,
@@ -120,7 +126,7 @@ export const createCartsCollection = (props)=>{
     // Internal access function for guest users (unauthenticated)
     const isGuest = ({ req })=>!req.user;
     const baseConfig = {
-        slug: 'carts',
+        slug: cartsSlug,
         access: {
             create: accessOR(access.isAdmin, access.isAuthenticated, conditional(allowGuestCarts, isGuest)),
             delete: accessOR(access.isAdmin, access.isDocumentOwner, hasCartSecretAccess(allowGuestCarts)),
@@ -133,6 +139,25 @@ export const createCartsCollection = (props)=>{
             group: 'Ecommerce',
             useAsTitle: 'createdAt'
         },
+        endpoints: [
+            addItemEndpoint({
+                cartItemMatcher,
+                cartsSlug
+            }),
+            clearCartEndpoint({
+                cartsSlug
+            }),
+            // mergeCartEndpoint uses its own matcher that handles CartItemData for both items
+            mergeCartEndpoint({
+                cartsSlug
+            }),
+            removeItemEndpoint({
+                cartsSlug
+            }),
+            updateItemEndpoint({
+                cartsSlug
+            })
+        ],
         fields,
         hooks: {
             afterRead: [

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/collections/carts/createCartsCollection.ts"],"sourcesContent":["import type { Access, CollectionConfig, Field } from 'payload'\n\nimport type { AccessConfig, CurrenciesConfig } from '../../types/index.js'\n\nimport { amountField } from '../../fields/amountField.js'\nimport { cartItemsField } from '../../fields/cartItemsField.js'\nimport { currencyField } from '../../fields/currencyField.js'\nimport { accessOR, conditional } from '../../utilities/accessComposition.js'\nimport { beforeChangeCart } from './beforeChange.js'\nimport { hasCartSecretAccess } from './hasCartSecretAccess.js'\nimport { statusBeforeRead } from './statusBeforeRead.js'\n\ntype Props = {\n  access: Pick<Required<AccessConfig>, 'isAdmin' | 'isAuthenticated' | 'isDocumentOwner'>\n  /**\n   * Allow guest (unauthenticated) users to create carts.\n   * Defaults to false.\n   */\n  allowGuestCarts?: boolean\n  currenciesConfig?: CurrenciesConfig\n  /**\n   * Slug of the customers collection, defaults to 'users'.\n   */\n  customersSlug?: string\n  /**\n   * Enables support for variants in the cart.\n   * Defaults to false.\n   */\n  enableVariants?: boolean\n  /**\n   * Slug of the products collection, defaults to 'products'.\n   */\n  productsSlug?: string\n  /**\n   * Slug of the variants collection, defaults to 'variants'.\n   */\n  variantsSlug?: string\n}\n\nexport const createCartsCollection: (props: Props) => CollectionConfig = (props) => {\n  const {\n    access,\n    allowGuestCarts = false,\n    currenciesConfig,\n    customersSlug = 'users',\n    enableVariants = false,\n    productsSlug = 'products',\n    variantsSlug = 'variants',\n  } = props || {}\n\n  const fields: Field[] = [\n    cartItemsField({\n      enableVariants,\n      overrides: {\n        label: ({ t }) =>\n          // @ts-expect-error - translations are not typed in plugins yet\n          t('plugin-ecommerce:items'),\n        labels: {\n          plural: ({ t }) =>\n            // @ts-expect-error - translations are not typed in plugins yet\n            t('plugin-ecommerce:items'),\n          singular: ({ t }) =>\n            // @ts-expect-error - translations are not typed in plugins yet\n            t('plugin-ecommerce:item'),\n        },\n      },\n      productsSlug,\n      variantsSlug,\n    }),\n    {\n      name: 'secret',\n      type: 'text',\n      access: {\n        create: () => false, // Users can't set it manually\n        read: () => false, // Never readable via field access (only through afterRead hook)\n        update: () => false, // Users can't update it\n      },\n      admin: {\n        hidden: true,\n        position: 'sidebar',\n        readOnly: true,\n      },\n      index: true,\n      label: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:cartSecret'),\n    },\n    {\n      name: 'customer',\n      type: 'relationship',\n      admin: {\n        position: 'sidebar',\n      },\n      label: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:customer'),\n      relationTo: customersSlug,\n    },\n    {\n      name: 'purchasedAt',\n      type: 'date',\n      admin: {\n        date: { pickerAppearance: 'dayAndTime' },\n        position: 'sidebar',\n      },\n      label: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:purchasedAt'),\n    },\n    {\n      name: 'status',\n      type: 'select',\n      admin: {\n        position: 'sidebar',\n        readOnly: true,\n      },\n      hooks: {\n        afterRead: [statusBeforeRead],\n      },\n      label: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:status'),\n      options: [\n        {\n          // @ts-expect-error - translations are not typed in plugins yet\n          label: ({ t }) => t('plugin-ecommerce:active'),\n          value: 'active',\n        },\n        {\n          // @ts-expect-error - translations are not typed in plugins yet\n          label: ({ t }) => t('plugin-ecommerce:purchased'),\n          value: 'purchased',\n        },\n        {\n          // @ts-expect-error - translations are not typed in plugins yet\n          label: ({ t }) => t('plugin-ecommerce:abandoned'),\n          value: 'abandoned',\n        },\n      ],\n      virtual: true,\n    },\n    ...(currenciesConfig\n      ? [\n          {\n            type: 'row',\n            admin: { position: 'sidebar' },\n            fields: [\n              amountField({\n                currenciesConfig,\n                overrides: {\n                  name: 'subtotal',\n\n                  label: ({ t }) =>\n                    // @ts-expect-error - translations are not typed in plugins yet\n                    t('plugin-ecommerce:subtotal'),\n                },\n              }),\n              currencyField({\n                currenciesConfig,\n              }),\n            ],\n          } as Field,\n        ]\n      : []),\n  ]\n\n  // Internal access function for guest users (unauthenticated)\n  const isGuest: Access = ({ req }) => !req.user\n\n  const baseConfig: CollectionConfig = {\n    slug: 'carts',\n    access: {\n      create: accessOR(\n        access.isAdmin,\n        access.isAuthenticated,\n        conditional(allowGuestCarts, isGuest),\n      ),\n      delete: accessOR(\n        access.isAdmin,\n        access.isDocumentOwner,\n        hasCartSecretAccess(allowGuestCarts),\n      ),\n      read: accessOR(access.isAdmin, access.isDocumentOwner, hasCartSecretAccess(allowGuestCarts)),\n      update: accessOR(\n        access.isAdmin,\n        access.isDocumentOwner,\n        hasCartSecretAccess(allowGuestCarts),\n      ),\n    },\n    admin: {\n      description: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:cartsCollectionDescription'),\n      group: 'Ecommerce',\n      useAsTitle: 'createdAt',\n    },\n    fields,\n    hooks: {\n      afterRead: [\n        ({ doc, req }) => {\n          // Include secret only if this was just created (stored in context by beforeChange)\n          if (req.context?.newCartSecret) {\n            doc.secret = req.context.newCartSecret\n          }\n          // Secret is otherwise never exposed (field access is locked)\n          return doc\n        },\n      ],\n      beforeChange: [\n        // This hook can be used to update the subtotal before saving the cart\n        beforeChangeCart({ productsSlug, variantsSlug }),\n      ],\n    },\n    labels: {\n      plural: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:carts'),\n      singular: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:cart'),\n    },\n    timestamps: true,\n  }\n\n  return { ...baseConfig }\n}\n"],"names":["amountField","cartItemsField","currencyField","accessOR","conditional","beforeChangeCart","hasCartSecretAccess","statusBeforeRead","createCartsCollection","props","access","allowGuestCarts","currenciesConfig","customersSlug","enableVariants","productsSlug","variantsSlug","fields","overrides","label","t","labels","plural","singular","name","type","create","read","update","admin","hidden","position","readOnly","index","relationTo","date","pickerAppearance","hooks","afterRead","options","value","virtual","isGuest","req","user","baseConfig","slug","isAdmin","isAuthenticated","delete","isDocumentOwner","description","group","useAsTitle","doc","context","newCartSecret","secret","beforeChange","timestamps"],"mappings":"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"}
+{"version":3,"sources":["../../../src/collections/carts/createCartsCollection.ts"],"sourcesContent":["import type { Access, CollectionConfig, Field } from 'payload'\n\nimport type { AccessConfig, CurrenciesConfig } from '../../types/index.js'\nimport type { CartItemMatcher } from './operations/types.js'\n\nimport { amountField } from '../../fields/amountField.js'\nimport { cartItemsField } from '../../fields/cartItemsField.js'\nimport { currencyField } from '../../fields/currencyField.js'\nimport { accessOR, conditional } from '../../utilities/accessComposition.js'\nimport { beforeChangeCart } from './beforeChange.js'\nimport { addItemEndpoint } from './endpoints/addItem.js'\nimport { clearCartEndpoint } from './endpoints/clearCart.js'\nimport { mergeCartEndpoint } from './endpoints/mergeCart.js'\nimport { removeItemEndpoint } from './endpoints/removeItem.js'\nimport { updateItemEndpoint } from './endpoints/updateItem.js'\nimport { hasCartSecretAccess } from './hasCartSecretAccess.js'\nimport { statusBeforeRead } from './statusBeforeRead.js'\n\ntype Props = {\n  access: Pick<Required<AccessConfig>, 'isAdmin' | 'isAuthenticated' | 'isDocumentOwner'>\n  /**\n   * Allow guest (unauthenticated) users to create carts.\n   * Defaults to false.\n   */\n  allowGuestCarts?: boolean\n  /**\n   * Custom 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   *\n   * Use this to add custom uniqueness criteria beyond product and variant IDs.\n   *\n   * @default defaultCartItemMatcher (matches by product and variant ID only)\n   *\n   * @example\n   * ```ts\n   * cartItemMatcher: ({ existingItem, newItem }) => {\n   *   // Match by product, variant, AND custom delivery option\n   *   const productMatch = existingItem.product === newItem.product\n   *   const variantMatch = existingItem.variant === newItem.variant\n   *   const deliveryMatch = existingItem.deliveryOption === newItem.deliveryOption\n   *   return productMatch && variantMatch && deliveryMatch\n   * }\n   * ```\n   */\n  cartItemMatcher?: CartItemMatcher\n  currenciesConfig?: CurrenciesConfig\n  /**\n   * Slug of the customers collection, defaults to 'users'.\n   */\n  customersSlug?: string\n  /**\n   * Enables support for variants in the cart.\n   * Defaults to false.\n   */\n  enableVariants?: boolean\n  /**\n   * Slug of the products collection, defaults to 'products'.\n   */\n  productsSlug?: string\n  /**\n   * Slug of the variants collection, defaults to 'variants'.\n   */\n  variantsSlug?: string\n}\n\nexport const createCartsCollection: (props: Props) => CollectionConfig = (props) => {\n  const {\n    access,\n    allowGuestCarts = false,\n    cartItemMatcher,\n    currenciesConfig,\n    customersSlug = 'users',\n    enableVariants = false,\n    productsSlug = 'products',\n    variantsSlug = 'variants',\n  } = props || {}\n\n  const cartsSlug = 'carts'\n\n  const fields: Field[] = [\n    cartItemsField({\n      enableVariants,\n      overrides: {\n        label: ({ t }) =>\n          // @ts-expect-error - translations are not typed in plugins yet\n          t('plugin-ecommerce:items'),\n        labels: {\n          plural: ({ t }) =>\n            // @ts-expect-error - translations are not typed in plugins yet\n            t('plugin-ecommerce:items'),\n          singular: ({ t }) =>\n            // @ts-expect-error - translations are not typed in plugins yet\n            t('plugin-ecommerce:item'),\n        },\n      },\n      productsSlug,\n      variantsSlug,\n    }),\n    {\n      name: 'secret',\n      type: 'text',\n      access: {\n        create: () => false, // Users can't set it manually\n        read: () => false, // Never readable via field access (only through afterRead hook)\n        update: () => false, // Users can't update it\n      },\n      admin: {\n        hidden: true,\n        position: 'sidebar',\n        readOnly: true,\n      },\n      index: true,\n      label: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:cartSecret'),\n    },\n    {\n      name: 'customer',\n      type: 'relationship',\n      admin: {\n        position: 'sidebar',\n      },\n      label: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:customer'),\n      relationTo: customersSlug,\n    },\n    {\n      name: 'purchasedAt',\n      type: 'date',\n      admin: {\n        date: { pickerAppearance: 'dayAndTime' },\n        position: 'sidebar',\n      },\n      label: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:purchasedAt'),\n    },\n    {\n      name: 'status',\n      type: 'select',\n      admin: {\n        position: 'sidebar',\n        readOnly: true,\n      },\n      hooks: {\n        afterRead: [statusBeforeRead],\n      },\n      label: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:status'),\n      options: [\n        {\n          // @ts-expect-error - translations are not typed in plugins yet\n          label: ({ t }) => t('plugin-ecommerce:active'),\n          value: 'active',\n        },\n        {\n          // @ts-expect-error - translations are not typed in plugins yet\n          label: ({ t }) => t('plugin-ecommerce:purchased'),\n          value: 'purchased',\n        },\n        {\n          // @ts-expect-error - translations are not typed in plugins yet\n          label: ({ t }) => t('plugin-ecommerce:abandoned'),\n          value: 'abandoned',\n        },\n      ],\n      virtual: true,\n    },\n    ...(currenciesConfig\n      ? [\n          {\n            type: 'row',\n            admin: { position: 'sidebar' },\n            fields: [\n              amountField({\n                currenciesConfig,\n                overrides: {\n                  name: 'subtotal',\n\n                  label: ({ t }) =>\n                    // @ts-expect-error - translations are not typed in plugins yet\n                    t('plugin-ecommerce:subtotal'),\n                },\n              }),\n              currencyField({\n                currenciesConfig,\n              }),\n            ],\n          } as Field,\n        ]\n      : []),\n  ]\n\n  // Internal access function for guest users (unauthenticated)\n  const isGuest: Access = ({ req }) => !req.user\n\n  const baseConfig: CollectionConfig = {\n    slug: cartsSlug,\n    access: {\n      create: accessOR(\n        access.isAdmin,\n        access.isAuthenticated,\n        conditional(allowGuestCarts, isGuest),\n      ),\n      delete: accessOR(\n        access.isAdmin,\n        access.isDocumentOwner,\n        hasCartSecretAccess(allowGuestCarts),\n      ),\n      read: accessOR(access.isAdmin, access.isDocumentOwner, hasCartSecretAccess(allowGuestCarts)),\n      update: accessOR(\n        access.isAdmin,\n        access.isDocumentOwner,\n        hasCartSecretAccess(allowGuestCarts),\n      ),\n    },\n    admin: {\n      description: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:cartsCollectionDescription'),\n      group: 'Ecommerce',\n      useAsTitle: 'createdAt',\n    },\n    endpoints: [\n      addItemEndpoint({ cartItemMatcher, cartsSlug }),\n      clearCartEndpoint({ cartsSlug }),\n      // mergeCartEndpoint uses its own matcher that handles CartItemData for both items\n      mergeCartEndpoint({ cartsSlug }),\n      removeItemEndpoint({ cartsSlug }),\n      updateItemEndpoint({ cartsSlug }),\n    ],\n    fields,\n    hooks: {\n      afterRead: [\n        ({ doc, req }) => {\n          // Include secret only if this was just created (stored in context by beforeChange)\n          if (req.context?.newCartSecret) {\n            doc.secret = req.context.newCartSecret\n          }\n          // Secret is otherwise never exposed (field access is locked)\n          return doc\n        },\n      ],\n      beforeChange: [\n        // This hook can be used to update the subtotal before saving the cart\n        beforeChangeCart({ productsSlug, variantsSlug }),\n      ],\n    },\n    labels: {\n      plural: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:carts'),\n      singular: ({ t }) =>\n        // @ts-expect-error - translations are not typed in plugins yet\n        t('plugin-ecommerce:cart'),\n    },\n    timestamps: true,\n  }\n\n  return { ...baseConfig }\n}\n"],"names":["amountField","cartItemsField","currencyField","accessOR","conditional","beforeChangeCart","addItemEndpoint","clearCartEndpoint","mergeCartEndpoint","removeItemEndpoint","updateItemEndpoint","hasCartSecretAccess","statusBeforeRead","createCartsCollection","props","access","allowGuestCarts","cartItemMatcher","currenciesConfig","customersSlug","enableVariants","productsSlug","variantsSlug","cartsSlug","fields","overrides","label","t","labels","plural","singular","name","type","create","read","update","admin","hidden","position","readOnly","index","relationTo","date","pickerAppearance","hooks","afterRead","options","value","virtual","isGuest","req","user","baseConfig","slug","isAdmin","isAuthenticated","delete","isDocumentOwner","description","group","useAsTitle","endpoints","doc","context","newCartSecret","secret","beforeChange","timestamps"],"mappings":"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"}

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

@@ -0,0 +1,19 @@
+import type { CollectionSlug, Endpoint } from 'payload';
+import type { CartItemMatcher } from '../operations/types.js';
+type Args = {
+    cartItemMatcher?: CartItemMatcher;
+    cartsSlug: CollectionSlug;
+};
+/**
+ * Creates an endpoint handler for adding items to a cart.
+ *
+ * Route: POST /api/{cartsSlug}/:id/add-item
+ *
+ * Request body:
+ * - item: { product: string, variant?: string, ...customFields }
+ * - quantity?: number (defaults to 1)
+ * - secret?: string (for guest cart access)
+ */
+export declare const addItemEndpoint: ({ cartItemMatcher, cartsSlug }: Args) => Endpoint;
+export {};
+//# sourceMappingURL=addItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"addItem.d.ts","sourceRoot":"","sources":["../../../../src/collections/carts/endpoints/addItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAIvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAI7D,KAAK,IAAI,GAAG;IACV,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,SAAS,EAAE,cAAc,CAAA;CAC1B,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,mCAAoC,IAAI,KAAG,QAyCrE,CAAA"}

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

@@ -0,0 +1,54 @@
+import { addDataAndFileToRequest } from 'payload';
+import { addItem } from '../operations/addItem.js';
+/**
+ * Creates an endpoint handler for adding items to a cart.
+ *
+ * Route: POST /api/{cartsSlug}/:id/add-item
+ *
+ * Request body:
+ * - item: { product: string, variant?: string, ...customFields }
+ * - quantity?: number (defaults to 1)
+ * - secret?: string (for guest cart access)
+ */ export const addItemEndpoint = ({ cartItemMatcher, 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?.item?.product) {
+                return Response.json({
+                    message: 'Item with product ID is required',
+                    success: false
+                }, {
+                    status: 400
+                });
+            }
+            const result = await addItem({
+                cartID,
+                cartItemMatcher,
+                cartsSlug,
+                item: data.item,
+                payload: req.payload,
+                quantity: data.quantity,
+                req,
+                secret: data.secret
+            });
+            if (!result.success) {
+                return Response.json(result, {
+                    status: 404
+                });
+            }
+            return Response.json(result);
+        },
+        method: 'post',
+        path: '/:id/add-item'
+    });
+
+//# sourceMappingURL=addItem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/collections/carts/endpoints/addItem.ts"],"sourcesContent":["import type { CollectionSlug, Endpoint } from 'payload'\n\nimport { addDataAndFileToRequest } from 'payload'\n\nimport type { CartItemMatcher } from '../operations/types.js'\n\nimport { addItem } from '../operations/addItem.js'\n\ntype Args = {\n  cartItemMatcher?: CartItemMatcher\n  cartsSlug: CollectionSlug\n}\n\n/**\n * Creates an endpoint handler for adding items to a cart.\n *\n * Route: POST /api/{cartsSlug}/:id/add-item\n *\n * Request body:\n * - item: { product: string, variant?: string, ...customFields }\n * - quantity?: number (defaults to 1)\n * - secret?: string (for guest cart access)\n */\nexport const addItemEndpoint = ({ cartItemMatcher, 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      item?: { [key: string]: unknown; product: string; variant?: string }\n      quantity?: number\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?.item?.product) {\n      return Response.json(\n        { message: 'Item with product ID is required', success: false },\n        { status: 400 },\n      )\n    }\n\n    const result = await addItem({\n      cartID,\n      cartItemMatcher,\n      cartsSlug,\n      item: data.item,\n      payload: req.payload,\n      quantity: data.quantity,\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/add-item',\n})\n"],"names":["addDataAndFileToRequest","addItem","addItemEndpoint","cartItemMatcher","cartsSlug","handler","req","cartID","routeParams","id","data","Response","json","message","success","status","item","product","result","payload","quantity","secret","method","path"],"mappings":"AAEA,SAASA,uBAAuB,QAAQ,UAAS;AAIjD,SAASC,OAAO,QAAQ,2BAA0B;AAOlD;;;;;;;;;CASC,GACD,OAAO,MAAMC,kBAAkB,CAAC,EAAEC,eAAe,EAAEC,SAAS,EAAQ,GAAgB,CAAA;QAClFC,SAAS,OAAOC;YACd,MAAMN,wBAAwBM;YAE9B,MAAMC,SAASD,IAAIE,WAAW,EAAEC;YAChC,MAAMC,OAAOJ,IAAII,IAAI;YAMrB,IAAI,CAACH,QAAQ;gBACX,OAAOI,SAASC,IAAI,CAAC;oBAAEC,SAAS;oBAAuBC,SAAS;gBAAM,GAAG;oBAAEC,QAAQ;gBAAI;YACzF;YAEA,IAAI,CAACL,MAAMM,MAAMC,SAAS;gBACxB,OAAON,SAASC,IAAI,CAClB;oBAAEC,SAAS;oBAAoCC,SAAS;gBAAM,GAC9D;oBAAEC,QAAQ;gBAAI;YAElB;YAEA,MAAMG,SAAS,MAAMjB,QAAQ;gBAC3BM;gBACAJ;gBACAC;gBACAY,MAAMN,KAAKM,IAAI;gBACfG,SAASb,IAAIa,OAAO;gBACpBC,UAAUV,KAAKU,QAAQ;gBACvBd;gBACAe,QAAQX,KAAKW,MAAM;YACrB;YAEA,IAAI,CAACH,OAAOJ,OAAO,EAAE;gBACnB,OAAOH,SAASC,IAAI,CAACM,QAAQ;oBAAEH,QAAQ;gBAAI;YAC7C;YAEA,OAAOJ,SAASC,IAAI,CAACM;QACvB;QACAI,QAAQ;QACRC,MAAM;IACR,CAAA,EAAE"}

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

@@ -0,0 +1,15 @@
+import type { CollectionSlug, Endpoint } from 'payload';
+type Args = {
+    cartsSlug: CollectionSlug;
+};
+/**
+ * Creates an endpoint handler for clearing all items from a cart.
+ *
+ * Route: POST /api/{cartsSlug}/:id/clear
+ *
+ * Request body:
+ * - secret?: string (for guest cart access)
+ */
+export declare const clearCartEndpoint: ({ cartsSlug }: Args) => Endpoint;
+export {};
+//# sourceMappingURL=clearCart.d.ts.map

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

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

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

@@ -0,0 +1,41 @@
+import { addDataAndFileToRequest } from 'payload';
+import { clearCart } from '../operations/clearCart.js';
+/**
+ * Creates an endpoint handler for clearing all items from a cart.
+ *
+ * Route: POST /api/{cartsSlug}/:id/clear
+ *
+ * Request body:
+ * - secret?: string (for guest cart access)
+ */ export const clearCartEndpoint = ({ 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
+                });
+            }
+            const result = await clearCart({
+                cartID,
+                cartsSlug,
+                payload: req.payload,
+                req,
+                secret: data?.secret
+            });
+            if (!result.success) {
+                return Response.json(result, {
+                    status: 404
+                });
+            }
+            return Response.json(result);
+        },
+        method: 'post',
+        path: '/:id/clear'
+    });
+
+//# sourceMappingURL=clearCart.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/collections/carts/endpoints/clearCart.ts"],"sourcesContent":["import type { CollectionSlug, Endpoint } from 'payload'\n\nimport { addDataAndFileToRequest } from 'payload'\n\nimport { clearCart } from '../operations/clearCart.js'\n\ntype Args = {\n  cartsSlug: CollectionSlug\n}\n\n/**\n * Creates an endpoint handler for clearing all items from a cart.\n *\n * Route: POST /api/{cartsSlug}/:id/clear\n *\n * Request body:\n * - secret?: string (for guest cart access)\n */\nexport const clearCartEndpoint = ({ 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      secret?: string\n    }\n\n    if (!cartID) {\n      return Response.json({ message: 'Cart ID is required', success: false }, { status: 400 })\n    }\n\n    const result = await clearCart({\n      cartID,\n      cartsSlug,\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/clear',\n})\n"],"names":["addDataAndFileToRequest","clearCart","clearCartEndpoint","cartsSlug","handler","req","cartID","routeParams","id","data","Response","json","message","success","status","result","payload","secret","method","path"],"mappings":"AAEA,SAASA,uBAAuB,QAAQ,UAAS;AAEjD,SAASC,SAAS,QAAQ,6BAA4B;AAMtD;;;;;;;CAOC,GACD,OAAO,MAAMC,oBAAoB,CAAC,EAAEC,SAAS,EAAQ,GAAgB,CAAA;QACnEC,SAAS,OAAOC;YACd,MAAML,wBAAwBK;YAE9B,MAAMC,SAASD,IAAIE,WAAW,EAAEC;YAChC,MAAMC,OAAOJ,IAAII,IAAI;YAIrB,IAAI,CAACH,QAAQ;gBACX,OAAOI,SAASC,IAAI,CAAC;oBAAEC,SAAS;oBAAuBC,SAAS;gBAAM,GAAG;oBAAEC,QAAQ;gBAAI;YACzF;YAEA,MAAMC,SAAS,MAAMd,UAAU;gBAC7BK;gBACAH;gBACAa,SAASX,IAAIW,OAAO;gBACpBX;gBACAY,QAAQR,MAAMQ;YAChB;YAEA,IAAI,CAACF,OAAOF,OAAO,EAAE;gBACnB,OAAOH,SAASC,IAAI,CAACI,QAAQ;oBAAED,QAAQ;gBAAI;YAC7C;YAEA,OAAOJ,SAASC,IAAI,CAACI;QACvB;QACAG,QAAQ;QACRC,MAAM;IACR,CAAA,EAAE"}

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

@@ -0,0 +1,21 @@
+import type { CollectionSlug, Endpoint } from 'payload';
+import type { MergeCartArgs } from '../operations/mergeCart.js';
+type Args = {
+    cartItemMatcher?: MergeCartArgs['cartItemMatcher'];
+    cartsSlug: CollectionSlug;
+};
+/**
+ * Creates an endpoint handler for merging a guest cart into the authenticated user's cart.
+ * This is used when a guest with an existing cart logs in.
+ *
+ * Route: POST /api/{cartsSlug}/:id/merge
+ *
+ * Request body:
+ * - sourceCartID: string - The ID of the guest cart to merge from
+ * - sourceSecret: string - The secret of the guest cart for verification
+ *
+ * Requires authentication - the :id in the URL is the target cart which must belong to the user.
+ */
+export declare const mergeCartEndpoint: ({ cartItemMatcher, cartsSlug }: Args) => Endpoint;
+export {};
+//# sourceMappingURL=mergeCart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mergeCart.d.ts","sourceRoot":"","sources":["../../../../src/collections/carts/endpoints/mergeCart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAIvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAI/D,KAAK,IAAI,GAAG;IACV,eAAe,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAA;IAClD,SAAS,EAAE,cAAc,CAAA;CAC1B,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,mCAAoC,IAAI,KAAG,QAsDvE,CAAA"}

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

@@ -0,0 +1,72 @@
+import { addDataAndFileToRequest } from 'payload';
+import { mergeCart } from '../operations/mergeCart.js';
+/**
+ * Creates an endpoint handler for merging a guest cart into the authenticated user's cart.
+ * This is used when a guest with an existing cart logs in.
+ *
+ * Route: POST /api/{cartsSlug}/:id/merge
+ *
+ * Request body:
+ * - sourceCartID: string - The ID of the guest cart to merge from
+ * - sourceSecret: string - The secret of the guest cart for verification
+ *
+ * Requires authentication - the :id in the URL is the target cart which must belong to the user.
+ */ export const mergeCartEndpoint = ({ cartItemMatcher, cartsSlug })=>({
+        handler: async (req)=>{
+            // This endpoint requires authentication
+            if (!req.user) {
+                return Response.json({
+                    message: 'Authentication required',
+                    success: false
+                }, {
+                    status: 401
+                });
+            }
+            await addDataAndFileToRequest(req);
+            const targetCartID = req.routeParams?.id;
+            const data = req.data;
+            if (!targetCartID) {
+                return Response.json({
+                    message: 'Target cart ID is required',
+                    success: false
+                }, {
+                    status: 400
+                });
+            }
+            if (!data?.sourceCartID) {
+                return Response.json({
+                    message: 'Source cart ID is required',
+                    success: false
+                }, {
+                    status: 400
+                });
+            }
+            if (!data?.sourceSecret) {
+                return Response.json({
+                    message: 'Source cart secret is required',
+                    success: false
+                }, {
+                    status: 400
+                });
+            }
+            const result = await mergeCart({
+                cartItemMatcher,
+                cartsSlug,
+                payload: req.payload,
+                req,
+                sourceCartID: data.sourceCartID,
+                sourceSecret: data.sourceSecret,
+                targetCartID
+            });
+            if (!result.success) {
+                return Response.json(result, {
+                    status: 404
+                });
+            }
+            return Response.json(result);
+        },
+        method: 'post',
+        path: '/:id/merge'
+    });
+
+//# sourceMappingURL=mergeCart.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/collections/carts/endpoints/mergeCart.ts"],"sourcesContent":["import type { CollectionSlug, Endpoint } from 'payload'\n\nimport { addDataAndFileToRequest } from 'payload'\n\nimport type { MergeCartArgs } from '../operations/mergeCart.js'\n\nimport { mergeCart } from '../operations/mergeCart.js'\n\ntype Args = {\n  cartItemMatcher?: MergeCartArgs['cartItemMatcher']\n  cartsSlug: CollectionSlug\n}\n\n/**\n * Creates an endpoint handler for merging a guest cart into the authenticated user's cart.\n * This is used when a guest with an existing cart logs in.\n *\n * Route: POST /api/{cartsSlug}/:id/merge\n *\n * Request body:\n * - sourceCartID: string - The ID of the guest cart to merge from\n * - sourceSecret: string - The secret of the guest cart for verification\n *\n * Requires authentication - the :id in the URL is the target cart which must belong to the user.\n */\nexport const mergeCartEndpoint = ({ cartItemMatcher, cartsSlug }: Args): Endpoint => ({\n  handler: async (req) => {\n    // This endpoint requires authentication\n    if (!req.user) {\n      return Response.json({ message: 'Authentication required', success: false }, { status: 401 })\n    }\n\n    await addDataAndFileToRequest(req)\n\n    const targetCartID = req.routeParams?.id as string | undefined\n    const data = req.data as {\n      sourceCartID?: string\n      sourceSecret?: string\n    }\n\n    if (!targetCartID) {\n      return Response.json(\n        { message: 'Target cart ID is required', success: false },\n        { status: 400 },\n      )\n    }\n\n    if (!data?.sourceCartID) {\n      return Response.json(\n        { message: 'Source cart ID is required', success: false },\n        { status: 400 },\n      )\n    }\n\n    if (!data?.sourceSecret) {\n      return Response.json(\n        { message: 'Source cart secret is required', success: false },\n        { status: 400 },\n      )\n    }\n\n    const result = await mergeCart({\n      cartItemMatcher,\n      cartsSlug,\n      payload: req.payload,\n      req,\n      sourceCartID: data.sourceCartID,\n      sourceSecret: data.sourceSecret,\n      targetCartID,\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/merge',\n})\n"],"names":["addDataAndFileToRequest","mergeCart","mergeCartEndpoint","cartItemMatcher","cartsSlug","handler","req","user","Response","json","message","success","status","targetCartID","routeParams","id","data","sourceCartID","sourceSecret","result","payload","method","path"],"mappings":"AAEA,SAASA,uBAAuB,QAAQ,UAAS;AAIjD,SAASC,SAAS,QAAQ,6BAA4B;AAOtD;;;;;;;;;;;CAWC,GACD,OAAO,MAAMC,oBAAoB,CAAC,EAAEC,eAAe,EAAEC,SAAS,EAAQ,GAAgB,CAAA;QACpFC,SAAS,OAAOC;YACd,wCAAwC;YACxC,IAAI,CAACA,IAAIC,IAAI,EAAE;gBACb,OAAOC,SAASC,IAAI,CAAC;oBAAEC,SAAS;oBAA2BC,SAAS;gBAAM,GAAG;oBAAEC,QAAQ;gBAAI;YAC7F;YAEA,MAAMZ,wBAAwBM;YAE9B,MAAMO,eAAeP,IAAIQ,WAAW,EAAEC;YACtC,MAAMC,OAAOV,IAAIU,IAAI;YAKrB,IAAI,CAACH,cAAc;gBACjB,OAAOL,SAASC,IAAI,CAClB;oBAAEC,SAAS;oBAA8BC,SAAS;gBAAM,GACxD;oBAAEC,QAAQ;gBAAI;YAElB;YAEA,IAAI,CAACI,MAAMC,cAAc;gBACvB,OAAOT,SAASC,IAAI,CAClB;oBAAEC,SAAS;oBAA8BC,SAAS;gBAAM,GACxD;oBAAEC,QAAQ;gBAAI;YAElB;YAEA,IAAI,CAACI,MAAME,cAAc;gBACvB,OAAOV,SAASC,IAAI,CAClB;oBAAEC,SAAS;oBAAkCC,SAAS;gBAAM,GAC5D;oBAAEC,QAAQ;gBAAI;YAElB;YAEA,MAAMO,SAAS,MAAMlB,UAAU;gBAC7BE;gBACAC;gBACAgB,SAASd,IAAIc,OAAO;gBACpBd;gBACAW,cAAcD,KAAKC,YAAY;gBAC/BC,cAAcF,KAAKE,YAAY;gBAC/BL;YACF;YAEA,IAAI,CAACM,OAAOR,OAAO,EAAE;gBACnB,OAAOH,SAASC,IAAI,CAACU,QAAQ;oBAAEP,QAAQ;gBAAI;YAC7C;YAEA,OAAOJ,SAASC,IAAI,CAACU;QACvB;QACAE,QAAQ;QACRC,MAAM;IACR,CAAA,EAAE"}

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

@@ -0,0 +1,16 @@
+import type { CollectionSlug, Endpoint } from 'payload';
+type Args = {
+    cartsSlug: CollectionSlug;
+};
+/**
+ * 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 declare const removeItemEndpoint: ({ cartsSlug }: Args) => Endpoint;
+export {};
+//# sourceMappingURL=removeItem.d.ts.map

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

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