@payloadcms/plugin-ecommerce 3.67.0-internal.87c53da → 3.68.0-canary.0

package/dist/utilities/accessComposition.d.ts

@@ -0,0 +1,55 @@
+import type { Access } from 'payload';
+/**
+ * Combines multiple access functions with OR logic.
+ *
+ * Logic:
+ * - If ANY function returns `true` → return `true` (full access, short-circuit)
+ * - If ALL functions return `false` → return `false` (no access)
+ * - If any functions return `Where` queries → combine them with OR logic
+ *
+ * @example
+ * ```ts
+ * const canCreate = or(
+ *   isAdmin,
+ *   isAuthenticated,
+ *   conditional(allowGuestAccess, isGuest)
+ * )
+ * ```
+ */
+export declare const accessOR: (...accessFunctions: Access[]) => Access;
+/**
+ * Combines multiple access functions with AND logic.
+ *
+ * Logic:
+ * - If ANY function returns `false` → return `false` (no access, short-circuit)
+ * - If ALL functions return `true` → return `true` (full access)
+ * - If any functions return `Where` queries → combine them with AND logic
+ *
+ * @example
+ * ```ts
+ * const canUpdate = and(
+ *   isAuthenticated,
+ *   isDocumentOwner
+ * )
+ * ```
+ */
+export declare const accessAND: (...accessFunctions: Access[]) => Access;
+/**
+ * Conditionally applies an access function based on a boolean condition or function.
+ *
+ * Useful for feature flags and plugin configuration.
+ *
+ * @param condition - Boolean or function to determine which function to use
+ * @param checker - Access function to use if condition is true
+ * @param fallback - Access function to use if condition is false (defaults to denying access)
+ *
+ * @example
+ * ```ts
+ * const canCreate = or(
+ *   isAdmin,
+ *   conditional(allowGuestCarts, isGuest)
+ * )
+ * ```
+ */
+export declare const conditional: (condition: ((args: any) => boolean) | boolean, accessFunction: Access, fallback?: Access) => Access;
+//# sourceMappingURL=accessComposition.d.ts.map

package/dist/utilities/accessComposition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessComposition.d.ts","sourceRoot":"","sources":["../../src/utilities/accessComposition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAS,MAAM,SAAS,CAAA;AAI5C;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ,uBAAwB,MAAM,EAAE,KAAG,MA0BvD,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,uBAAwB,MAAM,EAAE,KAAG,MA0BxD,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,cACX,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,OAAO,kBAC7B,MAAM,aACZ,MAAM,KACf,MAQF,CAAA"}

package/dist/utilities/accessComposition.js

@@ -0,0 +1,103 @@
+import { combineWhereConstraints } from 'payload/shared';
+/**
+ * Combines multiple access functions with OR logic.
+ *
+ * Logic:
+ * - If ANY function returns `true` → return `true` (full access, short-circuit)
+ * - If ALL functions return `false` → return `false` (no access)
+ * - If any functions return `Where` queries → combine them with OR logic
+ *
+ * @example
+ * ```ts
+ * const canCreate = or(
+ *   isAdmin,
+ *   isAuthenticated,
+ *   conditional(allowGuestAccess, isGuest)
+ * )
+ * ```
+ */ export const accessOR = (...accessFunctions)=>{
+    return async (args)=>{
+        const whereQueries = [];
+        for (const access of accessFunctions){
+            const result = await access(args);
+            // Short-circuit on true - full access granted
+            if (result === true) {
+                return true;
+            }
+            // Collect Where queries for combination (must be an object, not null/undefined/false)
+            if (result && typeof result === 'object') {
+                whereQueries.push(result);
+            }
+        }
+        // If we have Where queries, combine them with OR
+        if (whereQueries.length > 0) {
+            return combineWhereConstraints(whereQueries, 'or');
+        }
+        // All checkers returned false - no access
+        return false;
+    };
+};
+/**
+ * Combines multiple access functions with AND logic.
+ *
+ * Logic:
+ * - If ANY function returns `false` → return `false` (no access, short-circuit)
+ * - If ALL functions return `true` → return `true` (full access)
+ * - If any functions return `Where` queries → combine them with AND logic
+ *
+ * @example
+ * ```ts
+ * const canUpdate = and(
+ *   isAuthenticated,
+ *   isDocumentOwner
+ * )
+ * ```
+ */ export const accessAND = (...accessFunctions)=>{
+    return async (args)=>{
+        const whereQueries = [];
+        for (const access of accessFunctions){
+            const result = await access(args);
+            // Short-circuit on false - no access
+            if (result === false) {
+                return false;
+            }
+            // Collect Where queries for combination (must be an object, not null/undefined/true)
+            if (result !== true && result && typeof result === 'object') {
+                whereQueries.push(result);
+            }
+        }
+        // If we have Where queries, combine them with AND
+        if (whereQueries.length > 0) {
+            return combineWhereConstraints(whereQueries, 'and');
+        }
+        // All checkers returned true - full access
+        return true;
+    };
+};
+/**
+ * Conditionally applies an access function based on a boolean condition or function.
+ *
+ * Useful for feature flags and plugin configuration.
+ *
+ * @param condition - Boolean or function to determine which function to use
+ * @param checker - Access function to use if condition is true
+ * @param fallback - Access function to use if condition is false (defaults to denying access)
+ *
+ * @example
+ * ```ts
+ * const canCreate = or(
+ *   isAdmin,
+ *   conditional(allowGuestCarts, isGuest)
+ * )
+ * ```
+ */ export const conditional = (condition, accessFunction, fallback = ()=>false)=>{
+    return async (args)=>{
+        const shouldApply = typeof condition === 'function' ? condition(args) : condition;
+        if (shouldApply) {
+            return accessFunction(args);
+        }
+        return fallback(args);
+    };
+};
+
+//# sourceMappingURL=accessComposition.js.map

package/dist/utilities/accessComposition.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/accessComposition.ts"],"sourcesContent":["import type { Access, Where } from 'payload'\n\nimport { combineWhereConstraints } from 'payload/shared'\n\n/**\n * Combines multiple access functions with OR logic.\n *\n * Logic:\n * - If ANY function returns `true` → return `true` (full access, short-circuit)\n * - If ALL functions return `false` → return `false` (no access)\n * - If any functions return `Where` queries → combine them with OR logic\n *\n * @example\n * ```ts\n * const canCreate = or(\n *   isAdmin,\n *   isAuthenticated,\n *   conditional(allowGuestAccess, isGuest)\n * )\n * ```\n */\nexport const accessOR = (...accessFunctions: Access[]): Access => {\n  return async (args) => {\n    const whereQueries: Where[] = []\n\n    for (const access of accessFunctions) {\n      const result = await access(args)\n\n      // Short-circuit on true - full access granted\n      if (result === true) {\n        return true\n      }\n\n      // Collect Where queries for combination (must be an object, not null/undefined/false)\n      if (result && typeof result === 'object') {\n        whereQueries.push(result)\n      }\n    }\n\n    // If we have Where queries, combine them with OR\n    if (whereQueries.length > 0) {\n      return combineWhereConstraints(whereQueries, 'or')\n    }\n\n    // All checkers returned false - no access\n    return false\n  }\n}\n\n/**\n * Combines multiple access functions with AND logic.\n *\n * Logic:\n * - If ANY function returns `false` → return `false` (no access, short-circuit)\n * - If ALL functions return `true` → return `true` (full access)\n * - If any functions return `Where` queries → combine them with AND logic\n *\n * @example\n * ```ts\n * const canUpdate = and(\n *   isAuthenticated,\n *   isDocumentOwner\n * )\n * ```\n */\nexport const accessAND = (...accessFunctions: Access[]): Access => {\n  return async (args) => {\n    const whereQueries: Where[] = []\n\n    for (const access of accessFunctions) {\n      const result = await access(args)\n\n      // Short-circuit on false - no access\n      if (result === false) {\n        return false\n      }\n\n      // Collect Where queries for combination (must be an object, not null/undefined/true)\n      if (result !== true && result && typeof result === 'object') {\n        whereQueries.push(result)\n      }\n    }\n\n    // If we have Where queries, combine them with AND\n    if (whereQueries.length > 0) {\n      return combineWhereConstraints(whereQueries, 'and')\n    }\n\n    // All checkers returned true - full access\n    return true\n  }\n}\n\n/**\n * Conditionally applies an access function based on a boolean condition or function.\n *\n * Useful for feature flags and plugin configuration.\n *\n * @param condition - Boolean or function to determine which function to use\n * @param checker - Access function to use if condition is true\n * @param fallback - Access function to use if condition is false (defaults to denying access)\n *\n * @example\n * ```ts\n * const canCreate = or(\n *   isAdmin,\n *   conditional(allowGuestCarts, isGuest)\n * )\n * ```\n */\nexport const conditional = (\n  condition: ((args: any) => boolean) | boolean,\n  accessFunction: Access,\n  fallback: Access = () => false,\n): Access => {\n  return async (args) => {\n    const shouldApply = typeof condition === 'function' ? condition(args) : condition\n    if (shouldApply) {\n      return accessFunction(args)\n    }\n    return fallback(args)\n  }\n}\n"],"names":["combineWhereConstraints","accessOR","accessFunctions","args","whereQueries","access","result","push","length","accessAND","conditional","condition","accessFunction","fallback","shouldApply"],"mappings":"AAEA,SAASA,uBAAuB,QAAQ,iBAAgB;AAExD;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,MAAMC,WAAW,CAAC,GAAGC;IAC1B,OAAO,OAAOC;QACZ,MAAMC,eAAwB,EAAE;QAEhC,KAAK,MAAMC,UAAUH,gBAAiB;YACpC,MAAMI,SAAS,MAAMD,OAAOF;YAE5B,8CAA8C;YAC9C,IAAIG,WAAW,MAAM;gBACnB,OAAO;YACT;YAEA,sFAAsF;YACtF,IAAIA,UAAU,OAAOA,WAAW,UAAU;gBACxCF,aAAaG,IAAI,CAACD;YACpB;QACF;QAEA,iDAAiD;QACjD,IAAIF,aAAaI,MAAM,GAAG,GAAG;YAC3B,OAAOR,wBAAwBI,cAAc;QAC/C;QAEA,0CAA0C;QAC1C,OAAO;IACT;AACF,EAAC;AAED;;;;;;;;;;;;;;;CAeC,GACD,OAAO,MAAMK,YAAY,CAAC,GAAGP;IAC3B,OAAO,OAAOC;QACZ,MAAMC,eAAwB,EAAE;QAEhC,KAAK,MAAMC,UAAUH,gBAAiB;YACpC,MAAMI,SAAS,MAAMD,OAAOF;YAE5B,qCAAqC;YACrC,IAAIG,WAAW,OAAO;gBACpB,OAAO;YACT;YAEA,qFAAqF;YACrF,IAAIA,WAAW,QAAQA,UAAU,OAAOA,WAAW,UAAU;gBAC3DF,aAAaG,IAAI,CAACD;YACpB;QACF;QAEA,kDAAkD;QAClD,IAAIF,aAAaI,MAAM,GAAG,GAAG;YAC3B,OAAOR,wBAAwBI,cAAc;QAC/C;QAEA,2CAA2C;QAC3C,OAAO;IACT;AACF,EAAC;AAED;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,MAAMM,cAAc,CACzBC,WACAC,gBACAC,WAAmB,IAAM,KAAK;IAE9B,OAAO,OAAOV;QACZ,MAAMW,cAAc,OAAOH,cAAc,aAAaA,UAAUR,QAAQQ;QACxE,IAAIG,aAAa;YACf,OAAOF,eAAeT;QACxB;QACA,OAAOU,SAASV;IAClB;AACF,EAAC"}