@reactionary/feeds 0.10.53 → 0.10.55

package/cli.cjs

@@ -3328,17 +3328,17 @@ var require_generic_transformers = __commonJS({
       }
     }
     exports2.transformStreamsMessagesReplyResp3 = transformStreamsMessagesReplyResp3;
-    function transformRedisJsonArgument(json) {
-      return JSON.stringify(json);
+    function transformRedisJsonArgument(json2) {
+      return JSON.stringify(json2);
     }
     exports2.transformRedisJsonArgument = transformRedisJsonArgument;
-    function transformRedisJsonReply(json) {
-      const res = JSON.parse(json.toString());
+    function transformRedisJsonReply(json2) {
+      const res = JSON.parse(json2.toString());
       return res;
     }
     exports2.transformRedisJsonReply = transformRedisJsonReply;
-    function transformRedisJsonNullReply(json) {
-      return isNullReply(json) ? json : transformRedisJsonReply(json);
+    function transformRedisJsonNullReply(json2) {
+      return isNullReply(json2) ? json2 : transformRedisJsonReply(json2);
     }
     exports2.transformRedisJsonNullReply = transformRedisJsonNullReply;
   }
@@ -15913,16 +15913,16 @@ var require_enterprise_maintenance_manager = __commonJS({
             "moving-endpoint-type",
             movingEndpointType
           ],
-          errorHandler: (error6) => {
-            (0, exports2.dbgMaintenance)("handshake failed:", error6);
+          errorHandler: (error5) => {
+            (0, exports2.dbgMaintenance)("handshake failed:", error5);
             (0, tracing_1.publish)(tracing_1.CHANNELS.ERROR, () => ({
-              error: error6,
+              error: error5,
               origin: "client",
               internal: true,
               clientId
             }));
             if (options.maintNotifications === "enabled") {
-              throw error6;
+              throw error5;
             }
           }
         };
@@ -16026,8 +16026,8 @@ var require_enterprise_maintenance_manager = __commonJS({
           };
         }
         const tmpClient = this.#client.duplicate();
-        tmpClient.on("error", (error6) => {
-          (0, exports2.dbgMaintenance)(`[ERR]`, error6);
+        tmpClient.on("error", (error5) => {
+          (0, exports2.dbgMaintenance)(`[ERR]`, error5);
         });
         (0, exports2.dbgMaintenance)(`Tmp client created in ${(performance.now() - start).toFixed(2)}ms`);
         (0, exports2.dbgMaintenance)(`Set timeout for tmp client to ${this.#options.maintRelaxedSocketTimeout}`);
@@ -16427,8 +16427,8 @@ var require_socket = __commonJS({
         }
         if (this.#socketTimeout) {
           socket.once("timeout", () => {
-            const error6 = this.#maintenanceTimeout ? new errors_1.SocketTimeoutDuringMaintenanceError(this.#maintenanceTimeout) : new errors_1.SocketTimeoutError(this.#socketTimeout);
-            socket.destroy(error6);
+            const error5 = this.#maintenanceTimeout ? new errors_1.SocketTimeoutDuringMaintenanceError(this.#maintenanceTimeout) : new errors_1.SocketTimeoutError(this.#socketTimeout);
+            socket.destroy(error5);
           });
           socket.setTimeout(this.#socketTimeout);
         }
@@ -16614,7 +16614,7 @@ var require_token_manager = __commonJS({
         let result = Math.max(0, Math.floor(delay));
         return result;
       }
-      shouldRetry(error6) {
+      shouldRetry(error5) {
         if (!this.config.retry)
           return false;
         const { maxAttempts, isRetryable: isRetryable2 } = this.config.retry;
@@ -16622,7 +16622,7 @@ var require_token_manager = __commonJS({
           return false;
         }
         if (isRetryable2) {
-          return isRetryable2(error6, this.retryAttempt);
+          return isRetryable2(error5, this.retryAttempt);
         }
         return false;
       }
@@ -16636,14 +16636,14 @@ var require_token_manager = __commonJS({
         try {
           await this.identityProvider.requestToken().then(this.handleNewToken);
           this.retryAttempt = 0;
-        } catch (error6) {
-          if (this.shouldRetry(error6)) {
+        } catch (error5) {
+          if (this.shouldRetry(error5)) {
             this.retryAttempt++;
             const retryDelay = this.calculateRetryDelay();
-            this.notifyError(`Token refresh failed (attempt ${this.retryAttempt}), retrying in ${retryDelay}ms: ${error6}`, true);
+            this.notifyError(`Token refresh failed (attempt ${this.retryAttempt}), retrying in ${retryDelay}ms: ${error5}`, true);
             this.scheduleNextRefresh(retryDelay);
           } else {
-            this.notifyError(error6, false);
+            this.notifyError(error5, false);
             this.stop();
           }
         }
@@ -16708,8 +16708,8 @@ var require_token_manager = __commonJS({
       getCurrentToken() {
         return this.currentToken;
       }
-      notifyError(error6, isRetryable2) {
-        const errorMessage = error6 instanceof Error ? error6.message : String(error6);
+      notifyError(error5, isRetryable2) {
+        const errorMessage = error5 instanceof Error ? error5.message : String(error5);
         if (!this.listener) {
           throw new Error(`TokenManager is not running but received an error: ${errorMessage}`);
         }
@@ -19823,11 +19823,11 @@ var require_error_util = __commonJS({
     var types_1 = require_types();
     var errors_1 = require_errors();
     var REDIS_ERROR_PREFIX_REGEX = /^([A-Z][A-Z0-9_]*)\s/;
-    function extractRedisStatusCode(error6) {
-      if (!(error6 instanceof errors_1.ErrorReply)) {
+    function extractRedisStatusCode(error5) {
+      if (!(error5 instanceof errors_1.ErrorReply)) {
         return void 0;
       }
-      const match = REDIS_ERROR_PREFIX_REGEX.exec(error6.message);
+      const match = REDIS_ERROR_PREFIX_REGEX.exec(error5.message);
       return match?.[1];
     }
     var NETWORK_ERROR_CODES = /* @__PURE__ */ new Set([
@@ -19891,15 +19891,15 @@ var require_error_util = __commonJS({
       "WRONGPASS",
       "WRONGTYPE"
     ]);
-    function isNodeRedisNetworkError(error6) {
-      return error6 instanceof errors_1.ConnectionTimeoutError || error6 instanceof errors_1.SocketTimeoutError || error6 instanceof errors_1.SocketClosedUnexpectedlyError || error6 instanceof errors_1.SocketTimeoutDuringMaintenanceError || error6 instanceof errors_1.CommandTimeoutDuringMaintenanceError;
+    function isNodeRedisNetworkError(error5) {
+      return error5 instanceof errors_1.ConnectionTimeoutError || error5 instanceof errors_1.SocketTimeoutError || error5 instanceof errors_1.SocketClosedUnexpectedlyError || error5 instanceof errors_1.SocketTimeoutDuringMaintenanceError || error5 instanceof errors_1.CommandTimeoutDuringMaintenanceError;
     }
     function isTlsErrorMessage(message) {
       const lowerMessage = message.toLowerCase();
       return lowerMessage.includes("certificate") || lowerMessage.includes("handshake") || lowerMessage.includes("ssl") || lowerMessage.includes("tls");
     }
-    function categorizeRedisError(error6) {
-      const prefix = extractRedisStatusCode(error6);
+    function categorizeRedisError(error5) {
+      const prefix = extractRedisStatusCode(error5);
       if (!prefix) {
         return void 0;
       }
@@ -19911,11 +19911,11 @@ var require_error_util = __commonJS({
       }
       return void 0;
     }
-    function getCategory(error6) {
-      if (isNodeRedisNetworkError(error6)) {
+    function getCategory(error5) {
+      if (isNodeRedisNetworkError(error5)) {
         return types_1.ERROR_CATEGORY.NETWORK;
       }
-      const errorCode = error6.code;
+      const errorCode = error5.code;
       if (errorCode) {
         if (NETWORK_ERROR_CODES.has(errorCode)) {
           return types_1.ERROR_CATEGORY.NETWORK;
@@ -19924,24 +19924,24 @@ var require_error_util = __commonJS({
           return types_1.ERROR_CATEGORY.TLS;
         }
       }
-      if (isTlsErrorMessage(error6.message)) {
+      if (isTlsErrorMessage(error5.message)) {
         return types_1.ERROR_CATEGORY.TLS;
       }
-      const category = categorizeRedisError(error6);
+      const category = categorizeRedisError(error5);
       if (category) {
         return category;
       }
       return types_1.ERROR_CATEGORY.OTHER;
     }
-    function getErrorInfo(error6) {
-      if (!(error6 instanceof Error)) {
+    function getErrorInfo(error5) {
+      if (!(error5 instanceof Error)) {
         return {
           errorType: "unknown",
           category: types_1.ERROR_CATEGORY.OTHER,
           statusCode: void 0
         };
       }
-      const actualError = error6 instanceof errors_1.ReconnectStrategyError ? error6.originalError : error6;
+      const actualError = error5 instanceof errors_1.ReconnectStrategyError ? error5.originalError : error5;
       return {
         errorType: actualError.constructor.name,
         category: getCategory(actualError),
@@ -20218,9 +20218,9 @@ var require_metrics = __commonJS({
           });
         });
       }
-      #recordError(error6, clientId, extra) {
+      #recordError(error5, clientId, extra) {
         const clientAttributes = resolveClientAttributes(clientId);
-        const errorInfo = (0, utils_1.getErrorInfo)(error6);
+        const errorInfo = (0, utils_1.getErrorInfo)(error5);
         this.#instruments.redisClientErrors.add(1, {
           ...this.#options.attributes,
           ...(0, utils_1.parseClientAttributes)(clientAttributes),
@@ -21112,8 +21112,8 @@ var require_client = __commonJS({
       #subscribeForStreamingCredentials(cp) {
         return cp.subscribe({
           onNext: (credentials) => {
-            this.reAuthenticate(credentials).catch((error6) => {
-              const errorMessage = error6 instanceof Error ? error6.message : String(error6);
+            this.reAuthenticate(credentials).catch((error5) => {
+              const errorMessage = error5 instanceof Error ? error5.message : String(error5);
               cp.onReAuthenticationError(new authx_1.CredentialsError(errorMessage));
             });
           },
@@ -21256,8 +21256,8 @@ var require_client = __commonJS({
         const socketInitiator = async () => {
           const promises = [], chainId = /* @__PURE__ */ Symbol("Socket Initiator");
           const resubscribePromise = this.#queue.resubscribe(chainId);
-          resubscribePromise?.catch((error6) => {
-            if (error6.message && error6.message.startsWith("MOVED")) {
+          resubscribePromise?.catch((error5) => {
+            if (error5.message && error5.message.startsWith("MOVED")) {
               this.emit("__MOVED", this._self.#queue.removeAllPubSubListeners());
             }
           });
@@ -22155,7 +22155,7 @@ var require_cluster_slots = __commonJS({
           readonly: readonly2
         }));
         client._setIdentity(identity_1.ClientRole.CLUSTER_NODE, this.#clusterClientId);
-        client.on("error", (error6) => emit("node-error", error6, clientInfo)).on("reconnecting", () => emit("node-reconnecting", clientInfo)).once("ready", () => emit("node-ready", clientInfo)).once("connect", () => emit("node-connect", clientInfo)).once("end", () => emit("node-disconnect", clientInfo)).on(enterprise_maintenance_manager_1.SMIGRATED_EVENT, this.#handleSmigrated).on("__MOVED", async (allPubSubListeners) => {
+        client.on("error", (error5) => emit("node-error", error5, clientInfo)).on("reconnecting", () => emit("node-reconnecting", clientInfo)).once("ready", () => emit("node-ready", clientInfo)).once("connect", () => emit("node-connect", clientInfo)).once("end", () => emit("node-disconnect", clientInfo)).on(enterprise_maintenance_manager_1.SMIGRATED_EVENT, this.#handleSmigrated).on("__MOVED", async (allPubSubListeners) => {
           await this.rediscover(client);
           this.#emit(exports2.RESUBSCRIBE_LISTENERS_EVENT, allPubSubListeners);
         });
@@ -25252,10 +25252,10 @@ var require_INITBYPROB = __commonJS({
        * @param error - Estimate error, as a decimal between 0 and 1
        * @param probability - The desired probability for inflated count, as a decimal between 0 and 1
        */
-      parseCommand(parser, key, error6, probability) {
+      parseCommand(parser, key, error5, probability) {
         parser.push("CMS.INITBYPROB");
         parser.pushKey(key);
-        parser.push(error6.toString(), probability.toString());
+        parser.push(error5.toString(), probability.toString());
       },
       transformReply: void 0
     };
@@ -26479,10 +26479,10 @@ var require_ARRAPPEND = __commonJS({
        * @param json - The first value to append
        * @param jsons - Additional values to append
        */
-      parseCommand(parser, key, path2, json, ...jsons) {
+      parseCommand(parser, key, path2, json2, ...jsons) {
         parser.push("JSON.ARRAPPEND");
         parser.pushKey(key);
-        parser.push(path2, (0, generic_transformers_1.transformRedisJsonArgument)(json));
+        parser.push(path2, (0, generic_transformers_1.transformRedisJsonArgument)(json2));
         for (let i3 = 0; i3 < jsons.length; i3++) {
           parser.push((0, generic_transformers_1.transformRedisJsonArgument)(jsons[i3]));
         }
@@ -26512,10 +26512,10 @@ var require_ARRINDEX = __commonJS({
        * @param options.range.start - Starting index for the search
        * @param options.range.stop - Optional ending index for the search
        */
-      parseCommand(parser, key, path2, json, options) {
+      parseCommand(parser, key, path2, json2, options) {
         parser.push("JSON.ARRINDEX");
         parser.pushKey(key);
-        parser.push(path2, (0, generic_transformers_1.transformRedisJsonArgument)(json));
+        parser.push(path2, (0, generic_transformers_1.transformRedisJsonArgument)(json2));
         if (options?.range) {
           parser.push(options.range.start.toString());
           if (options.range.stop !== void 0) {
@@ -26547,10 +26547,10 @@ var require_ARRINSERT = __commonJS({
        * @param json - The first value to insert
        * @param jsons - Additional values to insert
        */
-      parseCommand(parser, key, path2, index, json, ...jsons) {
+      parseCommand(parser, key, path2, index, json2, ...jsons) {
         parser.push("JSON.ARRINSERT");
         parser.pushKey(key);
-        parser.push(path2, index.toString(), (0, generic_transformers_1.transformRedisJsonArgument)(json));
+        parser.push(path2, index.toString(), (0, generic_transformers_1.transformRedisJsonArgument)(json2));
         for (let i3 = 0; i3 < jsons.length; i3++) {
           parser.push((0, generic_transformers_1.transformRedisJsonArgument)(jsons[i3]));
         }
@@ -26840,7 +26840,7 @@ var require_MGET2 = __commonJS({
         parser.push(path2);
       },
       transformReply(reply) {
-        return reply.map((json) => (0, generic_transformers_1.transformRedisJsonNullReply)(json));
+        return reply.map((json2) => (0, generic_transformers_1.transformRedisJsonNullReply)(json2));
       }
     };
   }
@@ -27014,10 +27014,10 @@ var require_SET2 = __commonJS({
        * @deprecated options.NX - Use options.condition instead
        * @deprecated options.XX - Use options.condition instead
        */
-      parseCommand(parser, key, path2, json, options) {
+      parseCommand(parser, key, path2, json2, options) {
         parser.push("JSON.SET");
         parser.pushKey(key);
-        parser.push(path2, (0, generic_transformers_1.transformRedisJsonArgument)(json));
+        parser.push(path2, (0, generic_transformers_1.transformRedisJsonArgument)(json2));
         if (options?.condition) {
           parser.push(options?.condition);
         } else if (options?.NX) {
@@ -32038,10 +32038,10 @@ var init_util = __esm({
 });
 
 // node_modules/.pnpm/zod@4.1.9/node_modules/zod/v4/core/errors.js
-function flattenError(error6, mapper = (issue2) => issue2.message) {
+function flattenError(error5, mapper = (issue2) => issue2.message) {
   const fieldErrors = {};
   const formErrors = [];
-  for (const sub of error6.issues) {
+  for (const sub of error5.issues) {
     if (sub.path.length > 0) {
       fieldErrors[sub.path[0]] = fieldErrors[sub.path[0]] || [];
       fieldErrors[sub.path[0]].push(mapper(sub));
@@ -32051,13 +32051,13 @@ function flattenError(error6, mapper = (issue2) => issue2.message) {
   }
   return { formErrors, fieldErrors };
 }
-function formatError(error6, _mapper) {
+function formatError(error5, _mapper) {
   const mapper = _mapper || function(issue2) {
     return issue2.message;
   };
   const fieldErrors = { _errors: [] };
-  const processError = (error7) => {
-    for (const issue2 of error7.issues) {
+  const processError = (error6) => {
+    for (const issue2 of error6.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
         issue2.errors.map((issues) => processError({ issues }));
       } else if (issue2.code === "invalid_key") {
@@ -32084,7 +32084,7 @@ function formatError(error6, _mapper) {
       }
     }
   };
-  processError(error6);
+  processError(error5);
   return fieldErrors;
 }
 var initializer, $ZodError, $ZodRealError;
@@ -32221,7 +32221,7 @@ function datetime(args) {
   const timeRegex = `${time3}(?:${opts.join("|")})`;
   return new RegExp(`^${dateSource}T(?:${timeRegex})$`);
 }
-var cuid, cuid2, ulid, xid, ksuid, nanoid, duration, guid, uuid, email, _emoji, ipv4, ipv6, cidrv4, cidrv6, base64, base64url, hostname, e164, dateSource, date, string, bigint, integer, number, boolean, lowercase, uppercase;
+var cuid, cuid2, ulid, xid, ksuid, nanoid, duration, guid, uuid, email, _emoji, ipv4, ipv6, cidrv4, cidrv6, base64, base64url, hostname, e164, dateSource, date, string, bigint, integer, number, boolean, _null, lowercase, uppercase;
 var init_regexes = __esm({
   "node_modules/.pnpm/zod@4.1.9/node_modules/zod/v4/core/regexes.js"() {
     cuid = /^[cC][^\s-]{8,}$/;
@@ -32257,6 +32257,7 @@ var init_regexes = __esm({
     integer = /^-?\d+$/;
     number = /^-?\d+(?:\.\d+)?/;
     boolean = /^(?:true|false)$/i;
+    _null = /^null$/i;
     lowercase = /^[^A-Z]*$/;
     uppercase = /^[^a-z]*$/;
   }
@@ -32947,7 +32948,7 @@ function handleRefineResult(result, payload, input, inst) {
     payload.issues.push(issue(_iss));
   }
 }
-var $ZodType, $ZodString, $ZodStringFormat, $ZodGUID, $ZodUUID, $ZodEmail, $ZodURL, $ZodEmoji, $ZodNanoID, $ZodCUID, $ZodCUID2, $ZodULID, $ZodXID, $ZodKSUID, $ZodISODateTime, $ZodISODate, $ZodISOTime, $ZodISODuration, $ZodIPv4, $ZodIPv6, $ZodCIDRv4, $ZodCIDRv6, $ZodBase64, $ZodBase64URL, $ZodE164, $ZodJWT, $ZodNumber, $ZodNumberFormat, $ZodBoolean, $ZodBigInt, $ZodUnknown, $ZodNever, $ZodDate, $ZodArray, $ZodObject, $ZodObjectJIT, $ZodUnion, $ZodDiscriminatedUnion, $ZodIntersection, $ZodRecord, $ZodEnum, $ZodLiteral, $ZodTransform, $ZodOptional, $ZodNullable, $ZodDefault, $ZodPrefault, $ZodNonOptional, $ZodCatch, $ZodPipe, $ZodReadonly, $ZodCustom;
+var $ZodType, $ZodString, $ZodStringFormat, $ZodGUID, $ZodUUID, $ZodEmail, $ZodURL, $ZodEmoji, $ZodNanoID, $ZodCUID, $ZodCUID2, $ZodULID, $ZodXID, $ZodKSUID, $ZodISODateTime, $ZodISODate, $ZodISOTime, $ZodISODuration, $ZodIPv4, $ZodIPv6, $ZodCIDRv4, $ZodCIDRv6, $ZodBase64, $ZodBase64URL, $ZodE164, $ZodJWT, $ZodNumber, $ZodNumberFormat, $ZodBoolean, $ZodBigInt, $ZodNull, $ZodUnknown, $ZodNever, $ZodDate, $ZodArray, $ZodObject, $ZodObjectJIT, $ZodUnion, $ZodDiscriminatedUnion, $ZodIntersection, $ZodRecord, $ZodEnum, $ZodLiteral, $ZodTransform, $ZodOptional, $ZodNullable, $ZodDefault, $ZodPrefault, $ZodNonOptional, $ZodCatch, $ZodPipe, $ZodReadonly, $ZodLazy, $ZodCustom;
 var init_schemas = __esm({
   "node_modules/.pnpm/zod@4.1.9/node_modules/zod/v4/core/schemas.js"() {
     init_checks();
@@ -33398,6 +33399,23 @@ var init_schemas = __esm({
         return payload;
       };
     });
+    $ZodNull = /* @__PURE__ */ $constructor("$ZodNull", (inst, def) => {
+      $ZodType.init(inst, def);
+      inst._zod.pattern = _null;
+      inst._zod.values = /* @__PURE__ */ new Set([null]);
+      inst._zod.parse = (payload, _ctx) => {
+        const input = payload.value;
+        if (input === null)
+          return payload;
+        payload.issues.push({
+          expected: "null",
+          code: "invalid_type",
+          input,
+          inst
+        });
+        return payload;
+      };
+    });
     $ZodUnknown = /* @__PURE__ */ $constructor("$ZodUnknown", (inst, def) => {
       $ZodType.init(inst, def);
       inst._zod.parse = (payload) => payload;
@@ -34043,6 +34061,18 @@ var init_schemas = __esm({
         return handleReadonlyResult(result);
       };
     });
+    $ZodLazy = /* @__PURE__ */ $constructor("$ZodLazy", (inst, def) => {
+      $ZodType.init(inst, def);
+      defineLazy(inst._zod, "innerType", () => def.getter());
+      defineLazy(inst._zod, "pattern", () => inst._zod.innerType._zod.pattern);
+      defineLazy(inst._zod, "propValues", () => inst._zod.innerType._zod.propValues);
+      defineLazy(inst._zod, "optin", () => inst._zod.innerType._zod.optin ?? void 0);
+      defineLazy(inst._zod, "optout", () => inst._zod.innerType._zod.optout ?? void 0);
+      inst._zod.parse = (payload, ctx) => {
+        const inner = inst._zod.innerType;
+        return inner._zod.run(payload, ctx);
+      };
+    });
     $ZodCustom = /* @__PURE__ */ $constructor("$ZodCustom", (inst, def) => {
       $ZodCheck.init(inst, def);
       $ZodType.init(inst, def);
@@ -34902,6 +34932,12 @@ function _coercedBigint(Class2, params) {
     ...normalizeParams(params)
   });
 }
+function _null2(Class2, params) {
+  return new Class2({
+    type: "null",
+    ...normalizeParams(params)
+  });
+}
 function _unknown(Class2) {
   return new Class2({
     type: "unknown"
@@ -35266,6 +35302,9 @@ function int(params) {
 function boolean2(params) {
   return _boolean(ZodBoolean, params);
 }
+function _null3(params) {
+  return _null2(ZodNull, params);
+}
 function unknown() {
   return _unknown(ZodUnknown);
 }
@@ -35406,13 +35445,25 @@ function readonly(innerType) {
     innerType
   });
 }
+function lazy(getter) {
+  return new ZodLazy({
+    type: "lazy",
+    getter
+  });
+}
 function refine(fn, _params = {}) {
   return _refine(ZodCustom, fn, _params);
 }
 function superRefine(fn) {
   return _superRefine(fn);
 }
-var ZodType, _ZodString, ZodString, ZodStringFormat, ZodEmail, ZodGUID, ZodUUID, ZodURL, ZodEmoji, ZodNanoID, ZodCUID, ZodCUID2, ZodULID, ZodXID, ZodKSUID, ZodIPv4, ZodIPv6, ZodCIDRv4, ZodCIDRv6, ZodBase64, ZodBase64URL, ZodE164, ZodJWT, ZodNumber, ZodNumberFormat, ZodBoolean, ZodBigInt, ZodUnknown, ZodNever, ZodDate, ZodArray, ZodObject, ZodUnion, ZodDiscriminatedUnion, ZodIntersection, ZodRecord, ZodEnum, ZodLiteral, ZodTransform, ZodOptional, ZodNullable, ZodDefault, ZodPrefault, ZodNonOptional, ZodCatch, ZodPipe, ZodReadonly, ZodCustom;
+function json(params) {
+  const jsonSchema = lazy(() => {
+    return union([string2(params), number2(), boolean2(), _null3(), array(jsonSchema), record(string2(), jsonSchema)]);
+  });
+  return jsonSchema;
+}
+var ZodType, _ZodString, ZodString, ZodStringFormat, ZodEmail, ZodGUID, ZodUUID, ZodURL, ZodEmoji, ZodNanoID, ZodCUID, ZodCUID2, ZodULID, ZodXID, ZodKSUID, ZodIPv4, ZodIPv6, ZodCIDRv4, ZodCIDRv6, ZodBase64, ZodBase64URL, ZodE164, ZodJWT, ZodNumber, ZodNumberFormat, ZodBoolean, ZodBigInt, ZodNull, ZodUnknown, ZodNever, ZodDate, ZodArray, ZodObject, ZodUnion, ZodDiscriminatedUnion, ZodIntersection, ZodRecord, ZodEnum, ZodLiteral, ZodTransform, ZodOptional, ZodNullable, ZodDefault, ZodPrefault, ZodNonOptional, ZodCatch, ZodPipe, ZodReadonly, ZodLazy, ZodCustom;
 var init_schemas2 = __esm({
   "node_modules/.pnpm/zod@4.1.9/node_modules/zod/v4/classic/schemas.js"() {
     init_core2();
@@ -35682,6 +35733,10 @@ var init_schemas2 = __esm({
       inst.maxValue = bag.maximum ?? null;
       inst.format = bag.format ?? null;
     });
+    ZodNull = /* @__PURE__ */ $constructor("ZodNull", (inst, def) => {
+      $ZodNull.init(inst, def);
+      ZodType.init(inst, def);
+    });
     ZodUnknown = /* @__PURE__ */ $constructor("ZodUnknown", (inst, def) => {
       $ZodUnknown.init(inst, def);
       ZodType.init(inst, def);
@@ -35874,6 +35929,11 @@ var init_schemas2 = __esm({
       ZodType.init(inst, def);
       inst.unwrap = () => inst._zod.def.innerType;
     });
+    ZodLazy = /* @__PURE__ */ $constructor("ZodLazy", (inst, def) => {
+      $ZodLazy.init(inst, def);
+      ZodType.init(inst, def);
+      inst.unwrap = () => inst._zod.def.getter();
+    });
     ZodCustom = /* @__PURE__ */ $constructor("ZodCustom", (inst, def) => {
       $ZodCustom.init(inst, def);
       ZodType.init(inst, def);
@@ -36590,10 +36650,10 @@ var require_stringifiers = __commonJS({
       return "";
     }
     exports2._nullCoerce = _nullCoerce;
-    function _null3() {
+    function _null4() {
       return exports2.PREFIX.null;
     }
-    exports2._null = _null3;
+    exports2._null = _null4;
     function _functionCoerce(obj) {
       return obj.name + "=>" + obj.toString();
     }
@@ -37362,7 +37422,7 @@ var init_profile_model = __esm({
 });
 
 // packages/core/src/schemas/models/shipping-method.model.ts
-var PickupPointSchema, ShippingMethodSchema, ShippingInstructionSchema;
+var ShippingFulfillmentTypeSchema, ShippingProtocolDataSchema, SHIPPING_PROTOCOL_DATA_KEYS, PickupPointSchema, ShippingMethodSchema, ShippingInstructionSchema;
 var init_shipping_method_model = __esm({
   "packages/core/src/schemas/models/shipping-method.model.ts"() {
     "use strict";
@@ -37371,6 +37431,18 @@ var init_shipping_method_model = __esm({
     init_price_model();
     init_base_model();
     init_profile_model();
+    ShippingFulfillmentTypeSchema = _enum(["delivery", "pickup"]);
+    ShippingProtocolDataSchema = looseObject({
+      key: string2().meta({ description: 'The protocol-specific key, e.g. "timeSlotId".' }),
+      value: union([string2(), record(string2(), json())]).meta({ description: "The protocol-specific value: either a plain string, or a JSON-serializable object for richer structures." })
+    });
+    SHIPPING_PROTOCOL_DATA_KEYS = {
+      /**
+       * The identifier (Store.identifier.key) of the brand's own store an
+       * in-store pickup (BOPIS) shipping method is fulfilled from.
+       */
+      pickupStore: "pickup_store"
+    };
     PickupPointSchema = looseObject({
       identifier: object({
         key: string2()
@@ -37390,30 +37462,38 @@ var init_shipping_method_model = __esm({
       logo: ImageSchema.optional(),
       price: MonetaryAmountSchema,
       deliveryTime: string2(),
-      carrier: string2().optional()
+      carrier: string2().optional(),
+      fulfillmentType: ShippingFulfillmentTypeSchema.optional().meta({ description: `How this shipping method fulfills the order: "delivery" for shipment to an address (including third-party carrier service points selected via the shipping instruction's pickupPoint), "pickup" for collection at one of the brand's own stores (BOPIS). When absent, "delivery" can be assumed.` }),
+      protocolData: array(ShippingProtocolDataSchema).optional().meta({ description: `Additional provider-populated, protocol-specific data for this shipping method, e.g. available pickup time slots. Conventional keys (see SHIPPING_PROTOCOL_DATA_KEYS) include "pickup_store": the identifier of the brand's own store a pickup method is fulfilled from.` })
     });
     ShippingInstructionSchema = BaseModelSchema.extend({
       shippingMethod: ShippingMethodIdentifierSchema,
-      pickupPoint: string2().meta({ description: "An optional pickup point for the shipping method. This could be a physical store, a locker, or similar. If not set, it means home delivery to the shipping address." }),
+      pickupPoint: string2().meta({ description: "An optional third-party carrier service point for the shipping method (e.g. a GLS or PostNord parcel shop, or a locker). Reserved for the carrier-service-point case; for pickup at one of the brand's own stores (BOPIS), use the store field instead. If neither is set, it means home delivery to the shipping address." }),
       instructions: string2().meta({ description: "Optional instructions for the shipping. This could be delivery instructions, or similar." }),
-      consentForUnattendedDelivery: boolean2().meta({ description: "Indicates if the customer has given consent for unattended delivery, if applicable." })
+      consentForUnattendedDelivery: boolean2().meta({ description: "Indicates if the customer has given consent for unattended delivery, if applicable." }),
+      store: StoreIdentifierSchema.optional().meta({ description: "An optional reference to one of the brand's own stores where the order will be picked up (BOPIS). Distinct from pickupPoint, which is reserved for third-party carrier service points." }),
+      protocolData: array(ShippingProtocolDataSchema).optional().meta({ description: "Additional client-set, protocol-specific data for the shipping instruction, e.g. a selected pickup time slot." })
     });
   }
 });
 
 // packages/core/src/schemas/models/store.model.ts
-var StoreSchema;
+var StoreSchema, StorePaginatedResultSchema;
 var init_store_model = __esm({
   "packages/core/src/schemas/models/store.model.ts"() {
     "use strict";
     init_zod();
     init_base_model();
     init_identifiers_model();
+    init_profile_model();
     StoreSchema = BaseModelSchema.extend({
       identifier: StoreIdentifierSchema,
       name: string2(),
-      fulfillmentCenter: FulfillmentCenterIdentifierSchema
+      fulfillmentCenter: FulfillmentCenterIdentifierSchema,
+      address: AddressSchema.optional().meta({ description: "The physical address of the store, if known. Useful for showing the store on a map, and as the shipping address for in-store pickup (BOPIS)." }),
+      openingHours: string2().optional().meta({ description: 'The opening hours of the store, if known. This could be a string like "Mon-Fri 9am-5pm".' })
     });
+    StorePaginatedResultSchema = createPaginatedResponseSchema(StoreSchema);
   }
 });
 
@@ -38508,18 +38588,26 @@ var init_product_reviews_query = __esm({
 });
 
 // packages/core/src/schemas/queries/store.query.ts
-var StoreQueryByProximitySchema;
+var StoreQueryByProximitySchema, StoreQueryByIdSchema, StoreQueryForListSchema;
 var init_store_query = __esm({
   "packages/core/src/schemas/queries/store.query.ts"() {
     "use strict";
     init_zod();
     init_base_query();
+    init_identifiers_model();
+    init_base_model();
     StoreQueryByProximitySchema = BaseQuerySchema.extend({
       longitude: number2(),
       latitude: number2(),
       distance: number2(),
       limit: number2()
     });
+    StoreQueryByIdSchema = BaseQuerySchema.extend({
+      identifier: StoreIdentifierSchema
+    });
+    StoreQueryForListSchema = BaseQuerySchema.extend({
+      paginationOptions: PaginationOptionsSchema
+    });
   }
 });
 
@@ -38848,10 +38936,10 @@ function success(value) {
     }
   };
 }
-function error2(error6) {
+function error2(error5) {
   return {
     success: false,
-    error: error6,
+    error: error5,
     meta: {
       trace: trace.getActiveSpan()?.spanContext().traceId || ""
     }
@@ -42018,8 +42106,8 @@ var require_lib7 = __commonJS({
     exports2.byteSequence = byteSequence;
     var codePoint = __importStar(require_CodePoints());
     exports2.codePoint = codePoint;
-    var json = __importStar(require_JSON());
-    exports2.json = json;
+    var json2 = __importStar(require_JSON());
+    exports2.json = json2;
     var list = __importStar(require_List());
     exports2.list = list;
     var map = __importStar(require_Map());
@@ -60427,7 +60515,7 @@ var require_sax = __commonJS({
                 parser.script = "";
                 break;
               default:
-                error6(parser, "Max buffer length exceeded: " + buffers[i3]);
+                error5(parser, "Max buffer length exceeded: " + buffers[i3]);
             }
           }
           maxActual = Math.max(maxActual, len);
@@ -61027,7 +61115,7 @@ var require_sax = __commonJS({
         if (opt.normalize) text2 = text2.replace(/\s+/g, " ");
         return text2;
       }
-      function error6(parser, er3) {
+      function error5(parser, er3) {
         closeText(parser);
         if (parser.trackPosition) {
           er3 += "\nLine: " + parser.line + "\nColumn: " + parser.column + "\nChar: " + parser.c;
@@ -61041,7 +61129,7 @@ var require_sax = __commonJS({
         if (parser.sawRoot && !parser.closedRoot)
           strictFail(parser, "Unclosed root tag");
         if (parser.state !== S4.BEGIN && parser.state !== S4.BEGIN_WHITESPACE && parser.state !== S4.TEXT) {
-          error6(parser, "Unexpected end");
+          error5(parser, "Unexpected end");
         }
         closeText(parser);
         parser.c = "";
@@ -61055,7 +61143,7 @@ var require_sax = __commonJS({
           throw new Error("bad call to strictFail");
         }
         if (parser.strict) {
-          error6(parser, message);
+          error5(parser, message);
         }
       }
       function newTag(parser) {
@@ -61300,7 +61388,7 @@ var require_sax = __commonJS({
           throw this.error;
         }
         if (parser.closed) {
-          return error6(
+          return error5(
             parser,
             "Cannot write after close. Assign an onready handler."
           );
@@ -61696,7 +61784,7 @@ var require_sax = __commonJS({
                 parser.state = S4.ATTRIB_VALUE_QUOTED;
               } else {
                 if (!parser.opt.unquotedAttributeValues) {
-                  error6(parser, "Unquoted attribute value");
+                  error5(parser, "Unquoted attribute value");
                 }
                 parser.state = S4.ATTRIB_VALUE_UNQUOTED;
                 parser.attribValue = c3;
@@ -61809,13 +61897,13 @@ var require_sax = __commonJS({
                 var parsedEntity = parseEntity(parser);
                 if (parser.opt.unparsedEntities && !Object.values(sax3.XML_ENTITIES).includes(parsedEntity)) {
                   if ((parser.entityCount += 1) > parser.opt.maxEntityCount) {
-                    error6(
+                    error5(
                       parser,
                       "Parsed entity count exceeds max entity count"
                     );
                   }
                   if ((parser.entityDepth += 1) > parser.opt.maxEntityDepth) {
-                    error6(
+                    error5(
                       parser,
                       "Parsed entity depth exceeds max entity depth"
                     );
@@ -61980,7 +62068,7 @@ function createIterablePromise({
   func,
   validate: validate2,
   aggregator,
-  error: error6,
+  error: error5,
   timeout = () => 0
 }) {
   const retry = (previousResponse) => {
@@ -61992,8 +62080,8 @@ function createIterablePromise({
         if (await validate2(response)) {
           return resolve2(response);
         }
-        if (error6 && await error6.validate(response)) {
-          return reject(new Error(await error6.message(response)));
+        if (error5 && await error5.validate(response)) {
+          return reject(new Error(await error5.message(response)));
         }
         return setTimeout(
           () => {
@@ -62579,9 +62667,9 @@ var init_common = __esm({
     };
     DetailedApiError = class extends ApiError {
       error;
-      constructor(message, status, error6, stackTrace) {
+      constructor(message, status, error5, stackTrace) {
         super(message, status, stackTrace, "DetailedApiError");
-        this.error = error6;
+        this.error = error5;
       }
     };
   }
@@ -62643,10 +62731,10 @@ function createHttpRequester({
             isTimedOut: false
           });
         });
-        response.on("error", (error6) => {
+        response.on("error", (error5) => {
           clearTimeout(connectTimeout);
           clearTimeout(responseTimeout);
-          resolve2({ status: 0, content: error6.message, isTimedOut: false });
+          resolve2({ status: 0, content: error5.message, isTimedOut: false });
         });
       });
       const createTimeout = (timeout, content) => {
@@ -62660,10 +62748,10 @@ function createHttpRequester({
         }, timeout);
       };
       connectTimeout = createTimeout(request.connectTimeout, "Connection timeout");
-      req.on("error", (error6) => {
+      req.on("error", (error5) => {
         clearTimeout(connectTimeout);
         clearTimeout(responseTimeout);
-        resolve2({ status: 0, content: error6.message, isTimedOut: false });
+        resolve2({ status: 0, content: error5.message, isTimedOut: false });
       });
       req.once("response", () => {
         clearTimeout(connectTimeout);
@@ -62707,8 +62795,8 @@ function createHttpRequester({
         }
         resolve2(import_stream.Readable.toWeb(response));
       });
-      req.on("error", (error6) => {
-        reject(error6);
+      req.on("error", (error5) => {
+        reject(error5);
       });
       if (request.data !== void 0) {
         req.write(request.data);
@@ -65698,11 +65786,11 @@ function createSearchClient({
       }
       return createIterablePromise({
         ...baseIteratorOptions,
-        func: () => this.getApiKey({ key }, requestOptions).catch((error6) => {
-          if (error6.status === 404) {
+        func: () => this.getApiKey({ key }, requestOptions).catch((error5) => {
+          if (error5.status === 404) {
             return void 0;
           }
-          throw error6;
+          throw error5;
         }),
         validate: (response) => operation === "add" ? response !== void 0 : response === void 0
       });
@@ -65992,19 +66080,19 @@ function createSearchClient({
           maxRetries
         });
         return { copyOperationResponse, batchResponses, moveOperationResponse };
-      } catch (error6) {
+      } catch (error5) {
         await this.deleteIndex({ indexName: tmpIndexName });
-        throw error6;
+        throw error5;
       }
     },
     async indexExists({ indexName }) {
       try {
         await this.getSettings({ indexName });
-      } catch (error6) {
-        if (error6 instanceof ApiError && error6.status === 404) {
+      } catch (error5) {
+        if (error5 instanceof ApiError && error5.status === 404) {
           return false;
         }
-        throw error6;
+        throw error5;
       }
       return true;
     },
@@ -67963,11 +68051,11 @@ function createIngestionClient({
                 if (resp.eventID === void 0 || !resp.eventID) {
                   throw new Error("received unexpected response from the push endpoint, eventID must not be undefined");
                 }
-                return this.getEvent({ runID: resp.runID, eventID: resp.eventID }).catch((error6) => {
-                  if (error6.status === 404) {
+                return this.getEvent({ runID: resp.runID, eventID: resp.eventID }).catch((error5) => {
+                  if (error5.status === 404) {
                     return void 0;
                   }
-                  throw error6;
+                  throw error5;
                 });
               },
               validate: (response) => response !== void 0,
@@ -70749,9 +70837,9 @@ function algoliasearch(appId, apiKey, options) {
           maxRetries
         });
         return { copyOperationResponse, watchResponses, moveOperationResponse };
-      } catch (error6) {
+      } catch (error5) {
         await this.deleteIndex({ indexName: tmpIndexName });
-        throw error6;
+        throw error5;
       }
     },
     /**
@@ -71411,8 +71499,8 @@ var init_product_recommendations_capability2 = __esm({
             }
           }
           return result;
-        } catch (error6) {
-          console.error("Error fetching frequently bought together recommendations:", error6);
+        } catch (error5) {
+          console.error("Error fetching frequently bought together recommendations:", error5);
           return [];
         }
       }
@@ -71444,8 +71532,8 @@ var init_product_recommendations_capability2 = __esm({
             }
           }
           return result;
-        } catch (error6) {
-          console.error("Error fetching similar product recommendations:", error6);
+        } catch (error5) {
+          console.error("Error fetching similar product recommendations:", error5);
           return [];
         }
       }
@@ -71477,8 +71565,8 @@ var init_product_recommendations_capability2 = __esm({
             }
           }
           return result;
-        } catch (error6) {
-          console.error("Error fetching related product recommendations:", error6);
+        } catch (error5) {
+          console.error("Error fetching related product recommendations:", error5);
           return [];
         }
       }
@@ -71511,8 +71599,8 @@ var init_product_recommendations_capability2 = __esm({
             }
           }
           return result;
-        } catch (error6) {
-          console.error("Error fetching trending in category recommendations:", error6);
+        } catch (error5) {
+          console.error("Error fetching trending in category recommendations:", error5);
           return [];
         }
       }
@@ -71992,7 +72080,7 @@ var require_commercetools_ts_client_cjs_prod = __commonJS({
         });
         return response;
       }
-      return sendRequest().catch((error6) => Promise.reject(error6));
+      return sendRequest().catch((error5) => Promise.reject(error5));
     }
     async function executor(request) {
       const {
@@ -72461,8 +72549,8 @@ var require_commercetools_ts_client_cjs_prod = __commonJS({
           message: response.data.message,
           error: response.data.errors
         });
-      } catch (error6) {
-        throw error6;
+      } catch (error5) {
+        throw error5;
       }
     }
     async function authProcessor(request, tokenFetchPromise = null, tokenCacheObject, tokenCacheKey, tokenCache, builder, options, next) {
@@ -72621,11 +72709,11 @@ var require_commercetools_ts_client_cjs_prod = __commonJS({
         const response = await next(request);
         if (response.error) {
           const {
-            error: error6
+            error: error5
           } = response;
           if (options.handler && typeof options.handler == "function") {
             return options.handler({
-              error: error6,
+              error: error5,
               request,
               response,
               next
@@ -72633,10 +72721,10 @@ var require_commercetools_ts_client_cjs_prod = __commonJS({
           }
           return {
             ...response,
-            statusCode: error6.statusCode || 0,
-            headers: error6.headers || getHeaders({}),
-            body: error6,
-            error: error6
+            statusCode: error5.statusCode || 0,
+            headers: error5.headers || getHeaders({}),
+            body: error5,
+            error: error5
           };
         }
         return response;
@@ -72682,7 +72770,7 @@ var require_commercetools_ts_client_cjs_prod = __commonJS({
             headers: getHeaders(response.headers)
           };
         }
-        const error6 = createError({
+        const error5 = createError({
           code: response.data?.errors?.[0].code,
           message: response?.data?.message || response?.message,
           statusCode: response.statusCode || response?.data?.statusCode,
@@ -72701,14 +72789,14 @@ var require_commercetools_ts_client_cjs_prod = __commonJS({
           }
         });
         return {
-          ...error6,
-          error: error6
+          ...error5,
+          error: error5
         };
       } catch (e2) {
         const headers = includeResponseHeaders ? getHeaders(e2.response?.headers) : null;
         const statusCode = e2.response?.status || e2.response?.statusCode || e2.response?.data.statusCode || 0;
         const message = e2.response?.data?.message;
-        const error6 = createError({
+        const error5 = createError({
           statusCode,
           code: "NetworkError",
           status: statusCode,
@@ -72728,7 +72816,7 @@ var require_commercetools_ts_client_cjs_prod = __commonJS({
         throw {
           // because body and error should be mutually exclusive
           body: null,
-          error: error6
+          error: error5
         };
       }
     }
@@ -72850,8 +72938,8 @@ var require_commercetools_ts_client_cjs_prod = __commonJS({
               request.resolve(data);
               freeSlot();
             },
-            reject(error6) {
-              request.reject(error6);
+            reject(error5) {
+              request.reject(error5);
               freeSlot();
             }
           };
@@ -73028,8 +73116,8 @@ var require_commercetools_ts_client_cjs_prod = __commonJS({
             const last = results[resultsLength - 1];
             const newLastId = last && last.id;
             processPage(newLastId, accumulated);
-          } catch (error6) {
-            reject(error6);
+          } catch (error5) {
+            reject(error5);
           }
         };
         processPage();
@@ -73425,7 +73513,7 @@ var require_commercetools_ts_client_cjs_dev = __commonJS({
         });
         return response;
       }
-      return sendRequest().catch((error6) => Promise.reject(error6));
+      return sendRequest().catch((error5) => Promise.reject(error5));
     }
     async function executor(request) {
       const {
@@ -73894,8 +73982,8 @@ var require_commercetools_ts_client_cjs_dev = __commonJS({
           message: response.data.message,
           error: response.data.errors
         });
-      } catch (error6) {
-        throw error6;
+      } catch (error5) {
+        throw error5;
       }
     }
     async function authProcessor(request, tokenFetchPromise = null, tokenCacheObject, tokenCacheKey, tokenCache, builder, options, next) {
@@ -74054,11 +74142,11 @@ var require_commercetools_ts_client_cjs_dev = __commonJS({
         const response = await next(request);
         if (response.error) {
           const {
-            error: error6
+            error: error5
           } = response;
           if (options.handler && typeof options.handler == "function") {
             return options.handler({
-              error: error6,
+              error: error5,
               request,
               response,
               next
@@ -74066,10 +74154,10 @@ var require_commercetools_ts_client_cjs_dev = __commonJS({
           }
           return {
             ...response,
-            statusCode: error6.statusCode || 0,
-            headers: error6.headers || getHeaders({}),
-            body: error6,
-            error: error6
+            statusCode: error5.statusCode || 0,
+            headers: error5.headers || getHeaders({}),
+            body: error5,
+            error: error5
           };
         }
         return response;
@@ -74115,7 +74203,7 @@ var require_commercetools_ts_client_cjs_dev = __commonJS({
             headers: getHeaders(response.headers)
           };
         }
-        const error6 = createError({
+        const error5 = createError({
           code: response.data?.errors?.[0].code,
           message: response?.data?.message || response?.message,
           statusCode: response.statusCode || response?.data?.statusCode,
@@ -74134,14 +74222,14 @@ var require_commercetools_ts_client_cjs_dev = __commonJS({
           }
         });
         return {
-          ...error6,
-          error: error6
+          ...error5,
+          error: error5
         };
       } catch (e2) {
         const headers = includeResponseHeaders ? getHeaders(e2.response?.headers) : null;
         const statusCode = e2.response?.status || e2.response?.statusCode || e2.response?.data.statusCode || 0;
         const message = e2.response?.data?.message;
-        const error6 = createError({
+        const error5 = createError({
           statusCode,
           code: "NetworkError",
           status: statusCode,
@@ -74161,7 +74249,7 @@ var require_commercetools_ts_client_cjs_dev = __commonJS({
         throw {
           // because body and error should be mutually exclusive
           body: null,
-          error: error6
+          error: error5
         };
       }
     }
@@ -74283,8 +74371,8 @@ var require_commercetools_ts_client_cjs_dev = __commonJS({
               request.resolve(data);
               freeSlot();
             },
-            reject(error6) {
-              request.reject(error6);
+            reject(error5) {
+              request.reject(error5);
               freeSlot();
             }
           };
@@ -74461,8 +74549,8 @@ var require_commercetools_ts_client_cjs_dev = __commonJS({
             const last = results[resultsLength - 1];
             const newLastId = last && last.id;
             processPage(newLastId, accumulated);
-          } catch (error6) {
-            reject(error6);
+          } catch (error5) {
+            reject(error5);
           }
         };
         processPage();
@@ -111591,46 +111679,46 @@ var require_ms = __commonJS({
 var require_common2 = __commonJS({
   "node_modules/.pnpm/debug@4.4.3_supports-color@7.2.0/node_modules/debug/src/common.js"(exports2, module2) {
     function setup(env) {
-      createDebug40.debug = createDebug40;
-      createDebug40.default = createDebug40;
-      createDebug40.coerce = coerce;
-      createDebug40.disable = disable;
-      createDebug40.enable = enable;
-      createDebug40.enabled = enabled;
-      createDebug40.humanize = require_ms();
-      createDebug40.destroy = destroy;
+      createDebug41.debug = createDebug41;
+      createDebug41.default = createDebug41;
+      createDebug41.coerce = coerce;
+      createDebug41.disable = disable;
+      createDebug41.enable = enable;
+      createDebug41.enabled = enabled;
+      createDebug41.humanize = require_ms();
+      createDebug41.destroy = destroy;
       Object.keys(env).forEach((key) => {
-        createDebug40[key] = env[key];
+        createDebug41[key] = env[key];
       });
-      createDebug40.names = [];
-      createDebug40.skips = [];
-      createDebug40.formatters = {};
+      createDebug41.names = [];
+      createDebug41.skips = [];
+      createDebug41.formatters = {};
       function selectColor(namespace) {
         let hash2 = 0;
         for (let i3 = 0; i3 < namespace.length; i3++) {
           hash2 = (hash2 << 5) - hash2 + namespace.charCodeAt(i3);
           hash2 |= 0;
         }
-        return createDebug40.colors[Math.abs(hash2) % createDebug40.colors.length];
+        return createDebug41.colors[Math.abs(hash2) % createDebug41.colors.length];
       }
-      createDebug40.selectColor = selectColor;
-      function createDebug40(namespace) {
+      createDebug41.selectColor = selectColor;
+      function createDebug41(namespace) {
         let prevTime;
         let enableOverride = null;
         let namespacesCache;
         let enabledCache;
-        function debug40(...args) {
-          if (!debug40.enabled) {
+        function debug41(...args) {
+          if (!debug41.enabled) {
             return;
           }
-          const self2 = debug40;
+          const self2 = debug41;
           const curr = Number(/* @__PURE__ */ new Date());
           const ms = curr - (prevTime || curr);
           self2.diff = ms;
           self2.prev = prevTime;
           self2.curr = curr;
           prevTime = curr;
-          args[0] = createDebug40.coerce(args[0]);
+          args[0] = createDebug41.coerce(args[0]);
           if (typeof args[0] !== "string") {
             args.unshift("%O");
           }
@@ -111640,7 +111728,7 @@ var require_common2 = __commonJS({
               return "%";
             }
             index++;
-            const formatter = createDebug40.formatters[format];
+            const formatter = createDebug41.formatters[format];
             if (typeof formatter === "function") {
               const val = args[index];
               match = formatter.call(self2, val);
@@ -111649,25 +111737,25 @@ var require_common2 = __commonJS({
             }
             return match;
           });
-          createDebug40.formatArgs.call(self2, args);
-          const logFn = self2.log || createDebug40.log;
+          createDebug41.formatArgs.call(self2, args);
+          const logFn = self2.log || createDebug41.log;
           logFn.apply(self2, args);
         }
-        debug40.namespace = namespace;
-        debug40.useColors = createDebug40.useColors();
-        debug40.color = createDebug40.selectColor(namespace);
-        debug40.extend = extend2;
-        debug40.destroy = createDebug40.destroy;
-        Object.defineProperty(debug40, "enabled", {
+        debug41.namespace = namespace;
+        debug41.useColors = createDebug41.useColors();
+        debug41.color = createDebug41.selectColor(namespace);
+        debug41.extend = extend2;
+        debug41.destroy = createDebug41.destroy;
+        Object.defineProperty(debug41, "enabled", {
           enumerable: true,
           configurable: false,
           get: () => {
             if (enableOverride !== null) {
               return enableOverride;
             }
-            if (namespacesCache !== createDebug40.namespaces) {
-              namespacesCache = createDebug40.namespaces;
-              enabledCache = createDebug40.enabled(namespace);
+            if (namespacesCache !== createDebug41.namespaces) {
+              namespacesCache = createDebug41.namespaces;
+              enabledCache = createDebug41.enabled(namespace);
             }
             return enabledCache;
           },
@@ -111675,27 +111763,27 @@ var require_common2 = __commonJS({
             enableOverride = v4;
           }
         });
-        if (typeof createDebug40.init === "function") {
-          createDebug40.init(debug40);
+        if (typeof createDebug41.init === "function") {
+          createDebug41.init(debug41);
         }
-        return debug40;
+        return debug41;
       }
       function extend2(namespace, delimiter) {
-        const newDebug = createDebug40(this.namespace + (typeof delimiter === "undefined" ? ":" : delimiter) + namespace);
+        const newDebug = createDebug41(this.namespace + (typeof delimiter === "undefined" ? ":" : delimiter) + namespace);
         newDebug.log = this.log;
         return newDebug;
       }
       function enable(namespaces) {
-        createDebug40.save(namespaces);
-        createDebug40.namespaces = namespaces;
-        createDebug40.names = [];
-        createDebug40.skips = [];
+        createDebug41.save(namespaces);
+        createDebug41.namespaces = namespaces;
+        createDebug41.names = [];
+        createDebug41.skips = [];
         const split2 = (typeof namespaces === "string" ? namespaces : "").trim().replace(/\s+/g, ",").split(",").filter(Boolean);
         for (const ns of split2) {
           if (ns[0] === "-") {
-            createDebug40.skips.push(ns.slice(1));
+            createDebug41.skips.push(ns.slice(1));
           } else {
-            createDebug40.names.push(ns);
+            createDebug41.names.push(ns);
           }
         }
       }
@@ -111729,19 +111817,19 @@ var require_common2 = __commonJS({
       }
       function disable() {
         const namespaces = [
-          ...createDebug40.names,
-          ...createDebug40.skips.map((namespace) => "-" + namespace)
+          ...createDebug41.names,
+          ...createDebug41.skips.map((namespace) => "-" + namespace)
         ].join(",");
-        createDebug40.enable("");
+        createDebug41.enable("");
         return namespaces;
       }
       function enabled(name) {
-        for (const skip of createDebug40.skips) {
+        for (const skip of createDebug41.skips) {
           if (matchesTemplate(name, skip)) {
             return false;
           }
         }
-        for (const ns of createDebug40.names) {
+        for (const ns of createDebug41.names) {
           if (matchesTemplate(name, ns)) {
             return true;
           }
@@ -111757,8 +111845,8 @@ var require_common2 = __commonJS({
       function destroy() {
         console.warn("Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.");
       }
-      createDebug40.enable(createDebug40.load());
-      return createDebug40;
+      createDebug41.enable(createDebug41.load());
+      return createDebug41;
     }
     module2.exports = setup;
   }
@@ -111902,14 +111990,14 @@ var require_browser = __commonJS({
         } else {
           exports2.storage.removeItem("debug");
         }
-      } catch (error6) {
+      } catch (error5) {
       }
     }
     function load() {
       let r3;
       try {
         r3 = exports2.storage.getItem("debug") || exports2.storage.getItem("DEBUG");
-      } catch (error6) {
+      } catch (error5) {
       }
       if (!r3 && typeof process !== "undefined" && "env" in process) {
         r3 = process.env.DEBUG;
@@ -111919,7 +112007,7 @@ var require_browser = __commonJS({
     function localstorage() {
       try {
         return localStorage;
-      } catch (error6) {
+      } catch (error5) {
       }
     }
     module2.exports = require_common2()(exports2);
@@ -111927,8 +112015,8 @@ var require_browser = __commonJS({
     formatters.j = function(v4) {
       try {
         return JSON.stringify(v4);
-      } catch (error6) {
-        return "[UnexpectedJSONParseError]: " + error6.message;
+      } catch (error5) {
+        return "[UnexpectedJSONParseError]: " + error5.message;
       }
     };
   }
@@ -112148,7 +112236,7 @@ var require_node = __commonJS({
           221
         ];
       }
-    } catch (error6) {
+    } catch (error5) {
     }
     exports2.inspectOpts = Object.keys(process.env).filter((key) => {
       return /^debug_/i.test(key);
@@ -112203,11 +112291,11 @@ var require_node = __commonJS({
     function load() {
       return process.env.DEBUG;
     }
-    function init(debug40) {
-      debug40.inspectOpts = {};
+    function init(debug41) {
+      debug41.inspectOpts = {};
       const keys = Object.keys(exports2.inspectOpts);
       for (let i3 = 0; i3 < keys.length; i3++) {
-        debug40.inspectOpts[keys[i3]] = exports2.inspectOpts[keys[i3]];
+        debug41.inspectOpts[keys[i3]] = exports2.inspectOpts[keys[i3]];
       }
     }
     module2.exports = require_common2()(exports2);
@@ -112761,7 +112849,10 @@ var init_configuration_schema2 = __esm({
       paymentMethods: PaymentMethodSchema.array().optional().default(() => []),
       facetFieldsForSearch: array(string2()).default(() => []),
       listPriceChannelKey: string2().optional(),
-      customerPriceChannelKey: string2().optional()
+      customerPriceChannelKey: string2().optional(),
+      bopis: looseObject({
+        shippingMethodKeys: array(string2()).default(() => []).meta({ description: 'The keys of the commercetools shipping methods that represent in-store pickup (BOPIS). Shipping methods with these keys are tagged with fulfillmentType "pickup"; all others are tagged "delivery".' })
+      }).optional().meta({ description: "Optional buy-online-pickup-in-store (BOPIS) configuration." })
     });
   }
 });
@@ -113104,6 +113195,41 @@ var init_payment_protocol_data = __esm({
   }
 });
 
+// packages/commercetools/src/core/shipping-protocol-data.ts
+function serializeShippingProtocolData(entries) {
+  return JSON.stringify(Object.fromEntries(entries.map((entry) => [entry.key, entry.value])));
+}
+function parseShippingProtocolDataField(value) {
+  if (typeof value !== "string" || value.length === 0) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(value);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+      return void 0;
+    }
+    const entries = [];
+    for (const [key, entry] of Object.entries(parsed)) {
+      if (typeof entry === "string") {
+        entries.push({ key, value: entry });
+      } else if (typeof entry === "object" && entry !== null && !Array.isArray(entry)) {
+        entries.push({ key, value: entry });
+      }
+    }
+    return entries.length > 0 ? entries : void 0;
+  } catch {
+    return void 0;
+  }
+}
+var SHIPPING_PROTOCOL_DATA_FIELD, PICKUP_STORE_FIELD;
+var init_shipping_protocol_data = __esm({
+  "packages/commercetools/src/core/shipping-protocol-data.ts"() {
+    "use strict";
+    SHIPPING_PROTOCOL_DATA_FIELD = "shippingProtocolData";
+    PICKUP_STORE_FIELD = "pickupStoreKey";
+  }
+});
+
 // packages/commercetools/src/factories/checkout/checkout.factory.ts
 var CommercetoolsCheckoutFactory;
 var init_checkout_factory2 = __esm({
@@ -113112,6 +113238,7 @@ var init_checkout_factory2 = __esm({
     init_payment_protocol_data();
     init_src();
     init_locale_utils();
+    init_shipping_protocol_data();
     CommercetoolsCheckoutFactory = class {
       checkoutSchema;
       shippingMethodSchema;
@@ -113330,13 +113457,20 @@ var init_checkout_factory2 = __esm({
         const instructions = data.custom?.fields["shippingInstruction"] || "";
         const consentForUnattendedDelivery = data.custom?.fields["consentForUnattendedDelivery"] === "true";
         const pickupPoint = data.custom?.fields["pickupPointId"] || "";
+        const pickupStoreKey = data.custom?.fields[PICKUP_STORE_FIELD];
+        const store = typeof pickupStoreKey === "string" && pickupStoreKey.length > 0 ? { key: pickupStoreKey } : void 0;
+        const protocolData = parseShippingProtocolDataField(
+          data.custom?.fields[SHIPPING_PROTOCOL_DATA_FIELD]
+        );
         const result = {
           shippingMethod: {
             key: data.shippingInfo.shippingMethod?.obj?.key || ""
           },
           pickupPoint,
           instructions,
-          consentForUnattendedDelivery
+          consentForUnattendedDelivery,
+          store,
+          protocolData
         };
         return result;
       }
@@ -114800,10 +114934,10 @@ var init_category_capability2 = __esm({
             }
           }
           path2.push(category);
-        } catch (error6) {
+        } catch (error5) {
           console.error(
             `Error fetching category path for  ${payload.id.key}:`,
-            error6
+            error5
           );
         }
         return success(path2);
@@ -114825,10 +114959,10 @@ var init_category_capability2 = __esm({
           }).execute();
           const result = this.factory.parseCategoryPaginatedResult(this.context, response.body, payload);
           return success(result);
-        } catch (error6) {
+        } catch (error5) {
           console.error(
             `Error fetching category path for  ${payload.parentId.key}:`,
-            error6
+            error5
           );
         }
         const empty = {
@@ -114854,8 +114988,8 @@ var init_category_capability2 = __esm({
           }).execute();
           const result = this.factory.parseCategoryPaginatedResult(this.context, response.body, payload);
           return success(result);
-        } catch (error6) {
-          console.error(`Error fetching category top categories:`, error6);
+        } catch (error5) {
+          console.error(`Error fetching category top categories:`, error5);
         }
         const empty = {
           items: [],
@@ -114904,6 +115038,16 @@ var init_category_capability2 = __esm({
   }
 });
 
+// packages/commercetools/src/core/shipping-fulfillment.ts
+function resolveShippingFulfillmentType(shippingMethod, bopisShippingMethodKeys) {
+  return shippingMethod.key && (bopisShippingMethodKeys || []).includes(shippingMethod.key) ? "pickup" : "delivery";
+}
+var init_shipping_fulfillment = __esm({
+  "packages/commercetools/src/core/shipping-fulfillment.ts"() {
+    "use strict";
+  }
+});
+
 // packages/commercetools/src/schema/commercetools.schema.ts
 var CommercetoolsCartIdentifierSchema, CommercetoolsProductListIdentifierSchema, CommercetoolsCartItemIdentifierSchema, CommercetoolsOrderIdentifierSchema, CommercetoolsCheckoutIdentifierSchema, CommercetoolsResolveCategoryQueryByKeySchema, CommercetoolsResolveCategoryQueryByIdSchema, CommercetoolsCategoryLookupSchema, CommercetoolsEmployeeInviteCustomObjectValueSchema, CommercetoolsEmployeeInviteCustomObjectSchema;
 var init_commercetools_schema = __esm({
@@ -114964,6 +115108,8 @@ var init_checkout_capability2 = __esm({
   "packages/commercetools/src/capabilities/checkout.capability.ts"() {
     "use strict";
     init_payment_protocol_data();
+    init_shipping_protocol_data();
+    init_shipping_fulfillment();
     init_src();
     init_zod();
     init_locale_utils();
@@ -115110,10 +115256,25 @@ var init_checkout_capability2 = __esm({
           client.carts.withId({ ID: payload.checkout.key }).get().execute()
         ]);
         const result = shippingMethodsResponse.body.results.map(
-          (shippingMethod) => this.factory.parseShippingMethod(this.context, this.withFreeShipping(shippingMethod, cartResponse.body))
+          (shippingMethod) => this.withFulfillmentType(
+            this.factory.parseShippingMethod(this.context, this.withFreeShipping(shippingMethod, cartResponse.body)),
+            shippingMethod
+          )
         );
         return success(result);
       }
+      /**
+       * Tags a parsed shipping method with its fulfillment type: methods whose
+       * key is listed in the `bopis.shippingMethodKeys` configuration are
+       * in-store pickup (BOPIS), everything else is a delivery. The tagging lives
+       * here rather than in the factory, so factories stay configuration-free.
+       */
+      withFulfillmentType(shippingMethod, remote) {
+        return {
+          ...shippingMethod,
+          fulfillmentType: resolveShippingFulfillmentType(remote, this.config.bopis?.shippingMethodKeys)
+        };
+      }
       /**
        * Quotes the matching shipping rates as free where the cart reaches the
        * rate's free-above threshold. commercetools' matching-cart query returns
@@ -115225,6 +115386,20 @@ var init_checkout_capability2 = __esm({
           name: "pickupPointId",
           value: payload.shippingInstruction.pickupPoint
         });
+        if (payload.shippingInstruction.store?.key) {
+          actions.push({
+            action: "setCustomField",
+            name: PICKUP_STORE_FIELD,
+            value: payload.shippingInstruction.store.key
+          });
+        }
+        if (payload.shippingInstruction.protocolData && payload.shippingInstruction.protocolData.length > 0) {
+          actions.push({
+            action: "setCustomField",
+            name: SHIPPING_PROTOCOL_DATA_FIELD,
+            value: serializeShippingProtocolData(payload.shippingInstruction.protocolData)
+          });
+        }
         const result = await this.applyActions(
           payload.checkout,
           actions
@@ -116800,9 +116975,9 @@ var init_product_search_capability3 = __esm({
               continue;
             }
             facetValue.name = category.name[this.languageCode] || category.id;
-          } catch (error6) {
+          } catch (error5) {
             if (debug3.enabled) {
-              debug3(`Error resolving category key for id ${facetValue.identifier.key}:`, error6);
+              debug3(`Error resolving category key for id ${facetValue.identifier.key}:`, error5);
             }
           }
         }
@@ -117199,6 +117374,48 @@ var init_store_capability2 = __esm({
         }
         return success(results);
       }
+      /**
+       * The channel predicate selecting the channels that represent the brand's
+       * own stores. Override in a subclass if a project models stores differently.
+       */
+      getStoreChannelPredicate() {
+        return 'roles contains any ("InventorySupply")';
+      }
+      async list(payload) {
+        const client = await this.getClient();
+        const { pageNumber, pageSize } = payload.paginationOptions;
+        const remote = await client.channels().get({
+          queryArgs: {
+            limit: pageSize,
+            offset: (pageNumber - 1) * pageSize,
+            withTotal: true,
+            where: this.getStoreChannelPredicate()
+          }
+        }).execute();
+        const totalCount = remote.body.total ?? remote.body.results.length;
+        return success({
+          pageNumber,
+          pageSize,
+          totalCount,
+          totalPages: Math.ceil(totalCount / pageSize),
+          items: remote.body.results.map((r3) => this.factory.parseStore(this.context, r3))
+        });
+      }
+      async getById(payload) {
+        const client = await this.getClient();
+        const remote = await client.channels().get({
+          queryArgs: {
+            limit: 1,
+            where: `key = :key AND ${this.getStoreChannelPredicate()}`,
+            "var.key": payload.identifier.key
+          }
+        }).execute();
+        const channel = remote.body.results[0];
+        if (!channel) {
+          return error2({ type: "NotFound", identifier: payload.identifier });
+        }
+        return success(this.factory.parseStore(this.context, channel));
+      }
     };
     __decorateClass([
       Reactionary({
@@ -117206,6 +117423,18 @@ var init_store_capability2 = __esm({
         outputSchema: array(StoreSchema)
       })
     ], CommercetoolsStoreCapability.prototype, "queryByProximity", 1);
+    __decorateClass([
+      Reactionary({
+        inputSchema: StoreQueryForListSchema,
+        outputSchema: StorePaginatedResultSchema
+      })
+    ], CommercetoolsStoreCapability.prototype, "list", 1);
+    __decorateClass([
+      Reactionary({
+        inputSchema: StoreQueryByIdSchema,
+        outputSchema: StoreSchema
+      })
+    ], CommercetoolsStoreCapability.prototype, "getById", 1);
   }
 });
 
@@ -117302,11 +117531,11 @@ var init_company_registration_capability2 = __esm({
             message: "Only registered users can check company registration status"
           });
         }
-        const response = await client.businessUnits().withId({ ID: payload.requestIdentifier.key }).get().execute().catch((error6) => {
-          if (error6?.statusCode === 404) {
+        const response = await client.businessUnits().withId({ ID: payload.requestIdentifier.key }).get().execute().catch((error5) => {
+          if (error5?.statusCode === 404) {
             return null;
           }
-          throw error6;
+          throw error5;
         });
         if (!response) {
           return error2({
@@ -118216,11 +118445,11 @@ var init_employee_invitation_capability2 = __esm({
         const response = await adminClient.customObjects().withContainerAndKey({
           container: COMMERCERTOOLS_CUSTOM_OBJECT_CONTAINER_EMPLOYEE_INVITATIONS_INDEX,
           key
-        }).get().execute().catch((error6) => {
-          if (error6?.statusCode === 404) {
+        }).get().execute().catch((error5) => {
+          if (error5?.statusCode === 404) {
             return null;
           }
-          throw error6;
+          throw error5;
         });
         if (!response) {
           return [];
@@ -118279,11 +118508,11 @@ var init_employee_invitation_capability2 = __esm({
           allInviteIds = allInviteIds.slice(start, end);
         }
         for (const invitationId of allInviteIds) {
-          const invitationResponse = await adminClient.customObjects().withContainerAndKey({ container: COMMERCERTOOLS_CUSTOM_OBJECT_CONTAINER_EMPLOYEE_INVITATIONS, key: invitationId }).get().execute().catch((error6) => {
-            if (error6?.statusCode === 404) {
+          const invitationResponse = await adminClient.customObjects().withContainerAndKey({ container: COMMERCERTOOLS_CUSTOM_OBJECT_CONTAINER_EMPLOYEE_INVITATIONS, key: invitationId }).get().execute().catch((error5) => {
+            if (error5?.statusCode === 404) {
               return null;
             }
-            throw error6;
+            throw error5;
           });
           const invitation = invitationResponse?.body;
           if (!invitation) {
@@ -118306,11 +118535,11 @@ var init_employee_invitation_capability2 = __esm({
         return this.fetchInvitations(adminClient, this.makeKeyFromEmail(userEmail), onlyActive, paginationOptions);
       }
       async fetchInvitationByKey(adminClient, invitationKey) {
-        const inviteResponse = await adminClient.customObjects().withContainerAndKey({ container: COMMERCERTOOLS_CUSTOM_OBJECT_CONTAINER_EMPLOYEE_INVITATIONS, key: invitationKey }).get().execute().catch((error6) => {
-          if (error6?.statusCode === 404) {
+        const inviteResponse = await adminClient.customObjects().withContainerAndKey({ container: COMMERCERTOOLS_CUSTOM_OBJECT_CONTAINER_EMPLOYEE_INVITATIONS, key: invitationKey }).get().execute().catch((error5) => {
+          if (error5?.statusCode === 404) {
             return null;
           }
-          throw error6;
+          throw error5;
         });
         if (!inviteResponse) {
           return null;
@@ -118414,11 +118643,11 @@ var init_employee_invitation_capability2 = __esm({
             error: `Invitation token is invalid.`
           });
         }
-        const businessUnit = await adminClient.businessUnits().withKey({ key: invitation.value.company.taxIdentifier }).get().execute().catch((error6) => {
-          if (error6?.statusCode === 404) {
+        const businessUnit = await adminClient.businessUnits().withKey({ key: invitation.value.company.taxIdentifier }).get().execute().catch((error5) => {
+          if (error5?.statusCode === 404) {
             return null;
           }
-          throw error6;
+          throw error5;
         });
         if (!businessUnit) {
           return error2({
@@ -123052,6 +123281,7 @@ var init_store_capability3 = __esm({
     init_src();
     init_zod();
     init_dist();
+    init_seed();
     FakeStoreCapability = class extends StoreCapability {
       config;
       factory;
@@ -123060,26 +123290,82 @@ var init_store_capability3 = __esm({
         this.config = config3;
         this.factory = factory;
       }
-      async queryByProximity(payload) {
+      /**
+       * The countries the fake brand has physical stores in.
+       */
+      getStoreCountries() {
+        return ["DK", "SE", "NO", "FI", "US"];
+      }
+      /**
+       * How many physical stores the seed generates per country.
+       */
+      getStoresPerCountry() {
+        return 3;
+      }
+      /**
+       * The seeded set of physical stores: a fixed number per country, generated
+       * deterministically from the store key.
+       */
+      getSeededStores() {
+        const stores = [];
+        for (const country of this.getStoreCountries()) {
+          for (let i3 = 1; i3 <= this.getStoresPerCountry(); i3++) {
+            stores.push(this.generateStore(`${country.toLowerCase()}-${i3}`, country));
+          }
+        }
+        return stores;
+      }
+      generateStore(key, countryCode) {
         const generator = new Qe2({
-          seed: 42,
+          seed: calcSeed(key),
           locale: [ys, Oi]
         });
-        const results = [];
-        for (let i3 = 0; i3 < payload.limit; i3++) {
-          results.push(
-            this.factory.parseStore(this.context, {
-              identifier: {
-                key: `${i3}`
-              },
-              fulfillmentCenter: {
-                key: `${i3}`
-              },
-              name: generator.company.name()
-            })
-          );
+        const city = generator.location.city();
+        return this.factory.parseStore(this.context, {
+          identifier: {
+            key
+          },
+          fulfillmentCenter: {
+            key
+          },
+          name: `${generator.company.name()} ${city}`,
+          address: {
+            identifier: { nickName: key },
+            firstName: "",
+            lastName: "",
+            streetAddress: generator.location.streetAddress(),
+            streetNumber: "",
+            city,
+            region: "",
+            postalCode: generator.location.zipCode("####"),
+            countryCode
+          },
+          openingHours: "Mon-Fri 10am-6pm, Sat 10am-3pm"
+        });
+      }
+      async queryByProximity(payload) {
+        return success(this.getSeededStores().slice(0, payload.limit));
+      }
+      async list(payload) {
+        const stores = this.getSeededStores();
+        const { pageNumber, pageSize } = payload.paginationOptions;
+        const startIndex = (pageNumber - 1) * pageSize;
+        return success({
+          pageNumber,
+          pageSize,
+          totalCount: stores.length,
+          totalPages: Math.ceil(stores.length / pageSize),
+          items: stores.slice(startIndex, startIndex + pageSize)
+        });
+      }
+      async getById(payload) {
+        const store = this.getSeededStores().find(
+          (candidate) => candidate.identifier.key === payload.identifier.key
+        );
+        if (!store) {
+          return error2({ type: "NotFound", identifier: payload.identifier });
         }
-        return success(results);
+        return success(store);
       }
     };
     __decorateClass([
@@ -123088,6 +123374,18 @@ var init_store_capability3 = __esm({
         outputSchema: array(StoreSchema)
       })
     ], FakeStoreCapability.prototype, "queryByProximity", 1);
+    __decorateClass([
+      Reactionary({
+        inputSchema: StoreQueryForListSchema,
+        outputSchema: StorePaginatedResultSchema
+      })
+    ], FakeStoreCapability.prototype, "list", 1);
+    __decorateClass([
+      Reactionary({
+        inputSchema: StoreQueryByIdSchema,
+        outputSchema: StoreSchema
+      })
+    ], FakeStoreCapability.prototype, "getById", 1);
   }
 });
 
@@ -128406,7 +128704,8 @@ var init_medusa_schema = __esm({
       token: string2().optional(),
       expires: string2().optional(),
       allRegions: array(MedusaRegionSchema).optional(),
-      selectedRegion: MedusaRegionSchema.optional()
+      selectedRegion: MedusaRegionSchema.optional(),
+      finalizedOrders: record(string2(), MedusaOrderIdentifierSchema).optional().meta({ description: "Orders created by finalizing a checkout in this session, keyed by the originating cart id. Lets checkout reads report the resulting order when the Medusa store cart endpoint does not expose the cart-to-order relation." })
     });
   }
 });
@@ -128442,7 +128741,8 @@ var init_capabilities_schema6 = __esm({
       profile: true,
       productAssociations: true,
       personalizationProfile: true,
-      company: true
+      company: true,
+      store: true
     }).extend({
       product: OverridableCapabilitySchema4.optional(),
       productSearch: OverridableCapabilitySchema4.optional(),
@@ -128461,7 +128761,8 @@ var init_capabilities_schema6 = __esm({
       profile: OverridableCapabilitySchema4.optional(),
       productAssociations: OverridableCapabilitySchema4.optional(),
       productRecommendations: DirectCapabilitySchema2.optional(),
-      personalizationProfile: OverridableCapabilitySchema4.optional()
+      personalizationProfile: OverridableCapabilitySchema4.optional(),
+      store: OverridableCapabilitySchema4.optional()
     }).partial();
   }
 });
@@ -138020,9 +138321,9 @@ var init_client5 = __esm({
               return __asyncGenerator(this, arguments, function* () {
                 const res = yield __await(fetchPromise);
                 if (!res.ok) {
-                  const error6 = new Error(`Stream failed with status ${res.status}`);
-                  error6.name = "HttpError";
-                  throw error6;
+                  const error5 = new Error(`Stream failed with status ${res.status}`);
+                  error5.name = "HttpError";
+                  throw error5;
                 }
                 yield __await(yield* __asyncDelegator(__asyncValues(events(res, abortController.signal))));
               });
@@ -158181,10 +158482,10 @@ var init_client6 = __esm({
           });
           const identity = await this.login(email3, password, reqCtx);
           return identity;
-        } catch (error6) {
-          debug21("Registration failed:", error6);
+        } catch (error5) {
+          debug21("Registration failed:", error5);
           throw new Error(
-            `Registration failed: ${error6 instanceof Error ? error6.message : "Unknown error"}`
+            `Registration failed: ${error5 instanceof Error ? error5.message : "Unknown error"}`
           );
         }
       }
@@ -158214,10 +158515,10 @@ var init_client6 = __esm({
           return {
             type: "Anonymous"
           };
-        } catch (error6) {
-          debug21("Login failed:", error6);
+        } catch (error5) {
+          debug21("Login failed:", error5);
           throw new Error(
-            `Login failed: ${error6 instanceof Error ? error6.message : "Unknown error"}`
+            `Login failed: ${error5 instanceof Error ? error5.message : "Unknown error"}`
           );
         }
       }
@@ -158230,8 +158531,8 @@ var init_client6 = __esm({
           await client.auth.logout();
           await client.client.clearToken();
           return identity;
-        } catch (error6) {
-          debug21("Logout failed:", error6);
+        } catch (error5) {
+          debug21("Logout failed:", error5);
           await client.client.clearToken();
           return identity;
         }
@@ -158258,8 +158559,8 @@ var init_client6 = __esm({
 });
 
 // packages/medusa/src/utils/medusa-helpers.ts
-function isNotFoundFetchError(error6) {
-  return error6 instanceof FetchError && error6.status === 404;
+function isNotFoundFetchError(error5) {
+  return error5 instanceof FetchError && error5.status === 404;
 }
 function parseMedusaCostBreakdown(remote) {
   const grandTotal = remote.total || 0;
@@ -158318,12 +158619,12 @@ function parseMedusaItemPrice(remoteItem, currency) {
     }
   };
 }
-function handleProviderError(action, error6) {
+function handleProviderError(action, error5) {
   if (debug22.enabled) {
-    debug22(`Failed to ${action}:`, error6);
+    debug22(`Failed to ${action}:`, error5);
   }
   throw new Error(
-    `Failed to ${action}: ${error6 instanceof Error ? error6.message : "Unknown error"}`
+    `Failed to ${action}: ${error5 instanceof Error ? error5.message : "Unknown error"}`
   );
 }
 function safeBoolConvert(val) {
@@ -158616,8 +158917,8 @@ var init_cart_capability5 = __esm({
             return success(this.factory.parseCart(this.context, response.cart));
           }
           throw new Error("Failed to add item to cart");
-        } catch (error6) {
-          handleProviderError("add item to cart", error6);
+        } catch (error5) {
+          handleProviderError("add item to cart", error5);
         }
       }
       async renameCart(payload) {
@@ -158748,8 +159049,8 @@ var init_cart_capability5 = __esm({
             return success(this.factory.parseCart(this.context, response.cart));
           }
           throw new Error("Failed to create cart");
-        } catch (error6) {
-          handleProviderError("create cart", error6);
+        } catch (error5) {
+          handleProviderError("create cart", error5);
         }
       }
       async remove(payload) {
@@ -158767,8 +159068,8 @@ var init_cart_capability5 = __esm({
             return success(this.factory.parseCart(this.context, response.parent));
           }
           throw new Error("Failed to remove item from cart");
-        } catch (error6) {
-          handleProviderError("remove item from cart", error6);
+        } catch (error5) {
+          handleProviderError("remove item from cart", error5);
         }
       }
       /**
@@ -158802,8 +159103,8 @@ var init_cart_capability5 = __esm({
             return success(this.factory.parseCart(this.context, response.cart));
           }
           throw new Error("Failed to change item quantity");
-        } catch (error6) {
-          handleProviderError("change item quantity", error6);
+        } catch (error5) {
+          handleProviderError("change item quantity", error5);
         }
       }
       async getActiveCartId() {
@@ -158896,8 +159197,8 @@ var init_cart_capability5 = __esm({
             return success(this.factory.parseCart(this.context, response.cart));
           }
           throw new Error("Failed to apply coupon code");
-        } catch (error6) {
-          handleProviderError("apply coupon code", error6);
+        } catch (error5) {
+          handleProviderError("apply coupon code", error5);
         }
       }
       /**
@@ -158928,8 +159229,8 @@ var init_cart_capability5 = __esm({
             return success(this.factory.parseCart(this.context, response.cart));
           }
           throw new Error("Failed to remove coupon code");
-        } catch (error6) {
-          handleProviderError("remove coupon code", error6);
+        } catch (error5) {
+          handleProviderError("remove coupon code", error5);
         }
       }
       /**
@@ -158961,8 +159262,8 @@ var init_cart_capability5 = __esm({
             return success(this.factory.parseCart(this.context, updatedCartResponse.cart));
           }
           throw new Error("Failed to change currency");
-        } catch (error6) {
-          handleProviderError("change currency", error6);
+        } catch (error5) {
+          handleProviderError("change currency", error5);
         }
       }
       async getClient() {
@@ -159219,6 +159520,7 @@ var init_checkout_capability5 = __esm({
     init_src();
     import_debug24 = __toESM(require_src(), 1);
     init_zod();
+    init_client6();
     init_medusa_helpers();
     debug24 = (0, import_debug24.default)("reactionary:medusa:checkout");
     CheckoutNotReadyForFinalizationError3 = class extends Error {
@@ -159247,7 +159549,17 @@ var init_checkout_capability5 = __esm({
        *
        * example: this.includedFields = [includedFields, '+discounts.*'].join(',');
        */
-      includedFields = ["+items.*", "+order.id", "+order.display_id", "+order.custom_display_id"].join(",");
+      includedFields = ["+items.*", "+order.id", "+order.display_id", "+order.custom_display_id", "+shipping_methods.data"].join(",");
+      /**
+       * This controls which fields are requested for the cart's shipping options.
+       * You can override this in a subclass to add more fields as needed.
+       *
+       * The service zone's fulfillment set tells us whether an option is in-store
+       * pickup (BOPIS) or a delivery, and the option data is the fulfillment
+       * provider's payload (e.g. nShift option/carrier ids) that is mapped to the
+       * shipping method's protocolData.
+       */
+      shippingOptionFields = ["*service_zone.fulfillment_set", "+data"].join(",");
       initiateCheckoutForCartPayload(payload) {
         return {
           billing_address: payload.billingAddress ? this.mapAddressToStoreAddress(payload.billingAddress) : void 0,
@@ -159280,7 +159592,9 @@ var init_checkout_capability5 = __esm({
           const response = await client.store.cart.retrieve(payload.identifier.key, {
             fields: this.includedFields
           });
-          return success(this.factory.parseCheckout(this.context, response.cart));
+          return success(
+            this.hydrateResultingOrder(this.factory.parseCheckout(this.context, response.cart))
+          );
         } catch (err) {
           if (isNotFoundFetchError(err)) {
             return error2({
@@ -159309,7 +159623,8 @@ var init_checkout_capability5 = __esm({
       }
       getAvailableShippingMethodsPayload(payload) {
         return {
-          cart_id: payload.checkout.key
+          cart_id: payload.checkout.key,
+          fields: this.shippingOptionFields
         };
       }
       /**
@@ -159438,10 +159753,10 @@ var init_checkout_capability5 = __esm({
             }
           );
           return success(this.factory.parseCheckout(this.context, updatedCartResponse.cart));
-        } catch (error6) {
-          debug24("Failed to add payment instruction: {0}", [error6]);
+        } catch (error5) {
+          debug24("Failed to add payment instruction: {0}", [error5]);
           throw new Error(
-            `Failed to add payment instruction: ${error6 instanceof Error ? error6.message : "Unknown error"}`
+            `Failed to add payment instruction: ${error5 instanceof Error ? error5.message : "Unknown error"}`
           );
         }
       }
@@ -159449,14 +159764,65 @@ var init_checkout_capability5 = __esm({
         throw new Error("Method not implemented.");
       }
       setShippingInstructionPayload(payload) {
+        const data = {
+          consent_for_unattended_delivery: payload.shippingInstruction.consentForUnattendedDelivery + "",
+          instructions: payload.shippingInstruction.instructions || ""
+        };
+        for (const entry of payload.shippingInstruction.protocolData ?? []) {
+          data[entry.key] = entry.value;
+        }
+        if (payload.shippingInstruction.pickupPoint) {
+          data["pickup_point"] = payload.shippingInstruction.pickupPoint;
+        }
         return {
           option_id: payload.shippingInstruction.shippingMethod.key,
-          data: {
-            consent_for_unattended_delivery: payload.shippingInstruction.consentForUnattendedDelivery + "",
-            instructions: payload.shippingInstruction.instructions || ""
-          }
+          data
         };
       }
+      /**
+       * Serializes the client-set shipping protocol data as a JSON object string
+       * for persistence in the cart metadata, or undefined when none is set.
+       */
+      serializeShippingProtocolData(protocolData) {
+        if (!protocolData || protocolData.length === 0) {
+          return void 0;
+        }
+        return JSON.stringify(
+          Object.fromEntries(protocolData.map((entry) => [entry.key, entry.value]))
+        );
+      }
+      /**
+       * Resolves the shipping address to use for in-store pickup (BOPIS): the
+       * address of the selected store, so the order ships to the store. Returns
+       * undefined when the store or its address is unknown, leaving the cart's
+       * shipping address untouched.
+       */
+      async resolveStorePickupAddress(store) {
+        try {
+          const adminClient = await new MedusaAdminAPI(this.config, this.context).getClient();
+          const response = await adminClient.admin.stockLocation.retrieve(store.key, {
+            fields: "*address"
+          });
+          const address = response.stock_location?.address;
+          if (!address) {
+            return void 0;
+          }
+          return {
+            firstName: "",
+            lastName: response.stock_location.name,
+            streetAddress: address.address_1 || "",
+            streetNumber: address.address_2 || "",
+            city: address.city || "",
+            postalCode: address.postal_code || "",
+            countryCode: address.country_code || ""
+          };
+        } catch (err) {
+          if (debug24.enabled) {
+            debug24(`Unable to resolve address for pickup store ${store.key}`, err);
+          }
+          return void 0;
+        }
+      }
       async setShippingInstruction(payload) {
         const client = await this.medusaApi.getClient();
         const medusaId = payload.checkout;
@@ -159464,13 +159830,22 @@ var init_checkout_capability5 = __esm({
           if (payload.shippingInstruction.shippingMethod) {
             await client.store.cart.addShippingMethod(medusaId.key, this.setShippingInstructionPayload(payload));
           }
-          await client.store.cart.update(medusaId.key, {
+          const cartUpdate = {
             metadata: {
               consent_for_unattended_delivery: payload.shippingInstruction.consentForUnattendedDelivery + "",
               instructions: payload.shippingInstruction.instructions || "",
-              pickup_point: payload.shippingInstruction.pickupPoint || ""
+              pickup_point: payload.shippingInstruction.pickupPoint || "",
+              pickup_store: payload.shippingInstruction.store?.key || "",
+              shipping_protocol_data: this.serializeShippingProtocolData(payload.shippingInstruction.protocolData) || ""
             }
-          });
+          };
+          if (payload.shippingInstruction.store?.key) {
+            const storeAddress = await this.resolveStorePickupAddress(payload.shippingInstruction.store);
+            if (storeAddress) {
+              cartUpdate.shipping_address = this.mapAddressToStoreAddress(storeAddress);
+            }
+          }
+          await client.store.cart.update(medusaId.key, cartUpdate);
           const response = await client.store.cart.retrieve(medusaId.key, {
             fields: this.includedFields
           });
@@ -159478,8 +159853,8 @@ var init_checkout_capability5 = __esm({
             return success(this.factory.parseCheckout(this.context, response.cart));
           }
           throw new Error("Failed to set shipping method");
-        } catch (error6) {
-          handleProviderError("set shipping method", error6);
+        } catch (error5) {
+          handleProviderError("set shipping method", error5);
         }
       }
       async finalizeCheckout(payload) {
@@ -159493,14 +159868,24 @@ var init_checkout_capability5 = __esm({
         if (!checkout.value.resultingOrder) {
           const client = await this.medusaApi.getClient();
           const medusaId = payload.checkout;
+          await client.store.cart.update(medusaId.key, {
+            metadata: {
+              cart_id: medusaId.key
+            }
+          });
           const response = await client.store.cart.complete(medusaId.key);
           if (response.type === "order") {
+            const resultingOrder = this.parseCompletedOrderIdentifier(response.order);
+            this.rememberFinalizedOrder(medusaId.key, resultingOrder);
             checkout = await this.getById({
               identifier: payload.checkout
             });
             if (!checkout.success) {
               throw new Error(`Unable to reload checkout ${payload.checkout.key} after completion`);
             }
+            if (!checkout.value.resultingOrder) {
+              checkout = success({ ...checkout.value, resultingOrder });
+            }
           } else {
             throw new Error(`Failed to finalize checkout ${payload.checkout.key}. Expected order, got ${response.type}`);
           }
@@ -159520,6 +159905,48 @@ var init_checkout_capability5 = __esm({
         }
         return success(checkout.value);
       }
+      /**
+       * Builds the order identifier from a completed-cart response's order,
+       * following the same display-id precedence as the checkout factory
+       * (custom_display_id over display_id).
+       */
+      parseCompletedOrderIdentifier(order) {
+        const rawDisplayId = order.custom_display_id ?? order.display_id;
+        const displayId = rawDisplayId != null ? Number(`${rawDisplayId}`) : void 0;
+        return {
+          key: order.id,
+          display_id: displayId != null && Number.isFinite(displayId) ? displayId : void 0
+        };
+      }
+      /**
+       * Remembers which order a finalized cart produced, so later checkout reads
+       * in the same session can report the resulting order even when the Medusa
+       * store cart endpoint does not expose the cart->order relation.
+       */
+      rememberFinalizedOrder(cartKey, order) {
+        const sessionData = this.medusaApi.getSessionData();
+        this.medusaApi.setSessionData({
+          finalizedOrders: {
+            ...sessionData.finalizedOrders || {},
+            [cartKey]: order
+          }
+        });
+      }
+      /**
+       * Fills in a missing resultingOrder from the session's finalized-orders map.
+       * Checkouts that already carry a resulting order (older Medusa versions
+       * still hydrate the +order.* fields) are returned unchanged.
+       */
+      hydrateResultingOrder(checkout) {
+        if (checkout.resultingOrder) {
+          return checkout;
+        }
+        const remembered = this.medusaApi.getSessionData().finalizedOrders?.[checkout.identifier.key];
+        if (!remembered) {
+          return checkout;
+        }
+        return { ...checkout, resultingOrder: remembered };
+      }
       /**
        * Extension point to map an Address to a Store Address
        * @param address
@@ -160523,8 +160950,8 @@ var init_identity_capability5 = __esm({
           const identity = this.createAnonymousIdentity();
           this.updateIdentityContext(identity);
           return success(identity);
-        } catch (error6) {
-          debug29("getSelf failed, returning anonymous identity:", error6);
+        } catch (error5) {
+          debug29("getSelf failed, returning anonymous identity:", error5);
           const identity = this.createAnonymousIdentity();
           this.updateIdentityContext(identity);
           return success(identity);
@@ -160861,10 +161288,10 @@ var init_price_capability5 = __esm({
             return this.createEmptyPriceResult(sku);
           }
           return this.factory.parsePrice(this.context, { variant, mode });
-        } catch (error6) {
+        } catch (error5) {
           if (debug33.enabled) {
             debug33(
-              `Error fetching price for SKU ${sku}: ${error6.message}`
+              `Error fetching price for SKU ${sku}: ${error5.message}`
             );
           }
           return this.createEmptyPriceResult(sku);
@@ -160925,9 +161352,9 @@ var init_product_search_capability6 = __esm({
               break;
             }
             offset += limit;
-          } catch (error6) {
+          } catch (error5) {
             throw new Error(
-              "Category not found " + externalId + " due to error: " + error6
+              "Category not found " + externalId + " due to error: " + error5
             );
             break;
           }
@@ -161112,11 +161539,11 @@ var init_product_recommendations_capability4 = __esm({
             debug35(`Returning ${recommendations.length} recommendations`);
           }
           return success(recommendations);
-        } catch (error6) {
+        } catch (error5) {
           if (debug35.enabled) {
-            debug35(`Error fetching collection recommendations: %O`, error6);
+            debug35(`Error fetching collection recommendations: %O`, error5);
           }
-          console.error("Error fetching collection recommendations:", error6);
+          console.error("Error fetching collection recommendations:", error5);
           return success([]);
         }
       }
@@ -161730,6 +162157,173 @@ var init_personalization_profile_capability4 = __esm({
   }
 });
 
+// packages/medusa/src/utils/geo.ts
+function haversineDistanceKm(latitude1, longitude1, latitude2, longitude2) {
+  const toRadians = (degrees) => degrees * Math.PI / 180;
+  const deltaLatitude = toRadians(latitude2 - latitude1);
+  const deltaLongitude = toRadians(longitude2 - longitude1);
+  const a3 = Math.sin(deltaLatitude / 2) ** 2 + Math.cos(toRadians(latitude1)) * Math.cos(toRadians(latitude2)) * Math.sin(deltaLongitude / 2) ** 2;
+  return 2 * EARTH_RADIUS_KM * Math.asin(Math.sqrt(a3));
+}
+var EARTH_RADIUS_KM;
+var init_geo = __esm({
+  "packages/medusa/src/utils/geo.ts"() {
+    "use strict";
+    EARTH_RADIUS_KM = 6371;
+  }
+});
+
+// packages/medusa/src/capabilities/store.capability.ts
+var import_debug39, debug39, MedusaStoreCapability;
+var init_store_capability4 = __esm({
+  "packages/medusa/src/capabilities/store.capability.ts"() {
+    "use strict";
+    init_src();
+    import_debug39 = __toESM(require_src(), 1);
+    init_zod();
+    init_client6();
+    init_geo();
+    debug39 = (0, import_debug39.default)("reactionary:medusa:store");
+    MedusaStoreCapability = class extends StoreCapability {
+      constructor(config3, cache, context2, medusaApi, factory) {
+        super(cache, context2);
+        this.medusaApi = medusaApi;
+        this.config = config3;
+        this.factory = factory;
+      }
+      medusaApi;
+      config;
+      factory;
+      /**
+       * The fields requested for stock locations. Override in a subclass if a
+       * project needs more relations.
+       */
+      stockLocationFields = "*address,*fulfillment_sets";
+      /**
+       * Whether a stock location is a store customers can pick up orders from,
+       * i.e. it has a fulfillment set of type "pickup".
+       */
+      isPickupLocation(location) {
+        return (location.fulfillment_sets || []).some((set) => set.type === "pickup");
+      }
+      /**
+       * Fetches all stock locations that are pickup stores. Medusa installations
+       * have a small, bounded number of stock locations, so fetching them all and
+       * filtering client-side is acceptable.
+       */
+      async fetchPickupLocations() {
+        const adminClient = await new MedusaAdminAPI(this.config, this.context).getClient();
+        const pageSize = 200;
+        let offset = 0;
+        const locations = [];
+        for (; ; ) {
+          const response = await adminClient.admin.stockLocation.list({
+            fields: this.stockLocationFields,
+            limit: pageSize,
+            offset
+          });
+          locations.push(...response.stock_locations || []);
+          offset += pageSize;
+          if (offset >= response.count || (response.stock_locations || []).length === 0) {
+            break;
+          }
+        }
+        return locations.filter((location) => this.isPickupLocation(location));
+      }
+      async list(payload) {
+        const pickupLocations = await this.fetchPickupLocations();
+        if (debug39.enabled) {
+          debug39(`Found ${pickupLocations.length} pickup stock locations`);
+        }
+        const { pageNumber, pageSize } = payload.paginationOptions;
+        const startIndex = (pageNumber - 1) * pageSize;
+        const pagedLocations = pickupLocations.slice(startIndex, startIndex + pageSize);
+        return success({
+          pageNumber,
+          pageSize,
+          totalCount: pickupLocations.length,
+          totalPages: Math.ceil(pickupLocations.length / pageSize),
+          items: pagedLocations.map(
+            (location) => this.factory.parseStore(this.context, location)
+          )
+        });
+      }
+      async getById(payload) {
+        const adminClient = await new MedusaAdminAPI(this.config, this.context).getClient();
+        try {
+          const response = await adminClient.admin.stockLocation.retrieve(payload.identifier.key, {
+            fields: this.stockLocationFields
+          });
+          if (!response.stock_location || !this.isPickupLocation(response.stock_location)) {
+            return error2({ type: "NotFound", identifier: payload.identifier });
+          }
+          return success(this.factory.parseStore(this.context, response.stock_location));
+        } catch (err) {
+          if (debug39.enabled) {
+            debug39(`Error fetching stock location ${payload.identifier.key}`, err);
+          }
+          return error2({ type: "NotFound", identifier: payload.identifier });
+        }
+      }
+      /**
+       * Extension point resolving a stock location's geo coordinates. Medusa
+       * stock locations carry no first-class coordinates, so by default they are
+       * read from the location metadata keys `latitude` and `longitude`. Returns
+       * undefined when the location has no usable coordinates.
+       */
+      parseLocationCoordinates(location) {
+        const latitude = Number(location.metadata?.["latitude"]);
+        const longitude = Number(location.metadata?.["longitude"]);
+        if (!Number.isFinite(latitude) || !Number.isFinite(longitude)) {
+          return void 0;
+        }
+        return { latitude, longitude };
+      }
+      async queryByProximity(payload) {
+        const pickupLocations = await this.fetchPickupLocations();
+        const withinDistance = [];
+        for (const location of pickupLocations) {
+          const coordinates = this.parseLocationCoordinates(location);
+          if (!coordinates) {
+            continue;
+          }
+          const distance = haversineDistanceKm(
+            payload.latitude,
+            payload.longitude,
+            coordinates.latitude,
+            coordinates.longitude
+          );
+          if (distance <= payload.distance) {
+            withinDistance.push({ location, distance });
+          }
+        }
+        withinDistance.sort((a3, b3) => a3.distance - b3.distance);
+        return success(
+          withinDistance.slice(0, payload.limit).map((entry) => this.factory.parseStore(this.context, entry.location))
+        );
+      }
+    };
+    __decorateClass([
+      Reactionary({
+        inputSchema: StoreQueryForListSchema,
+        outputSchema: StorePaginatedResultSchema
+      })
+    ], MedusaStoreCapability.prototype, "list", 1);
+    __decorateClass([
+      Reactionary({
+        inputSchema: StoreQueryByIdSchema,
+        outputSchema: StoreSchema
+      })
+    ], MedusaStoreCapability.prototype, "getById", 1);
+    __decorateClass([
+      Reactionary({
+        inputSchema: StoreQueryByProximitySchema,
+        outputSchema: array(StoreSchema)
+      })
+    ], MedusaStoreCapability.prototype, "queryByProximity", 1);
+  }
+});
+
 // packages/medusa/src/factories/cart/cart.factory.ts
 var MedusaCartFactory;
 var init_cart_factory5 = __esm({
@@ -162062,15 +162656,23 @@ var init_checkout_factory5 = __esm({
         const backupUnattendedDelivery = data.metadata?.["consent_for_unattended_delivery"] !== void 0 ? data.metadata?.["consent_for_unattended_delivery"] === "true" : void 0;
         const backupInstructions = data.metadata?.["instructions"] != null ? String(data.metadata["instructions"]) : void 0;
         const backupPickupPoint = data.metadata?.["pickup_point"] != null ? String(data.metadata["pickup_point"]) : void 0;
+        const backupPickupStore = data.metadata?.["pickup_store"] != null && data.metadata["pickup_store"] !== "" ? String(data.metadata["pickup_store"]) : void 0;
+        const backupShippingProtocolData = this.parseShippingProtocolData(
+          data.metadata?.["shipping_protocol_data"]
+        );
         let shippingInstruction;
         data.shipping_methods?.forEach((sm) => {
           let pickupPoint = "";
           let instructions = "";
           let consentForUnattendedDelivery = false;
+          let pickupStore;
+          let protocolData;
           if (sm.data) {
             pickupPoint = sm.data["pickup_point"] != null ? String(sm.data["pickup_point"]) : "";
             instructions = sm.data["instructions"] != null ? String(sm.data["instructions"]) : "";
             consentForUnattendedDelivery = sm.data["consent_for_unattended_delivery"] === "true";
+            pickupStore = sm.data["pickup_store"] != null && sm.data["pickup_store"] !== "" ? String(sm.data["pickup_store"]) : void 0;
+            protocolData = this.parseInstructionProtocolData(sm.data);
           }
           if (!pickupPoint) {
             pickupPoint = backupPickupPoint || "";
@@ -162081,11 +162683,19 @@ var init_checkout_factory5 = __esm({
           if (!consentForUnattendedDelivery) {
             consentForUnattendedDelivery = backupUnattendedDelivery || false;
           }
+          if (!pickupStore) {
+            pickupStore = backupPickupStore;
+          }
+          if (!protocolData) {
+            protocolData = backupShippingProtocolData;
+          }
           shippingInstruction = {
-            shippingMethod: { key: sm.shipping_option_id },
+            shippingMethod: { key: sm.shipping_option_id || "" },
             consentForUnattendedDelivery,
             instructions,
-            pickupPoint
+            pickupPoint,
+            store: pickupStore ? { key: pickupStore } : void 0,
+            protocolData
           };
         });
         const paymentInstructions = new Array();
@@ -162149,10 +162759,164 @@ var init_checkout_factory5 = __esm({
             value: data.calculated_price.calculated_amount || 0,
             currency: data.calculated_price.currency_code?.toUpperCase() || _context.languageContext.currencyCode
           }),
-          deliveryTime: ""
+          deliveryTime: "",
+          carrier: this.parseShippingMethodCarrier(_context, data),
+          fulfillmentType: this.parseFulfillmentType(_context, data),
+          protocolData: this.mergeShippingMethodProtocolData(
+            this.parseShippingMethodProtocolData(_context, data),
+            this.parseShippingMethodStoreReference(_context, data)
+          )
         };
         return this.shippingMethodSchema.parse(sm);
       }
+      /**
+       * Appends a conventional entry to the provider-derived protocol data,
+       * unless the provider data already carries the same key (explicit provider
+       * data wins).
+       */
+      mergeShippingMethodProtocolData(protocolData, entry) {
+        if (!entry) {
+          return protocolData;
+        }
+        if ((protocolData ?? []).some((existing) => existing.key === entry.key)) {
+          return protocolData;
+        }
+        return [...protocolData ?? [], entry];
+      }
+      /**
+       * Extension point emitting the conventional "pickup_store" protocol data
+       * entry for in-store pickup options: the stock location id of the service
+       * zone's fulfillment set, which equals the store capability's
+       * Store.identifier.key. Delivery options also carry a location (the
+       * warehouse), so the entry is emitted for pickup options only.
+       */
+      parseShippingMethodStoreReference(_context, data) {
+        if (this.parseFulfillmentType(_context, data) !== "pickup") {
+          return void 0;
+        }
+        const locationId = data.service_zone?.fulfillment_set?.location?.id;
+        if (!locationId) {
+          return void 0;
+        }
+        return { key: SHIPPING_PROTOCOL_DATA_KEYS.pickupStore, value: locationId };
+      }
+      /**
+       * Extension point to control how a Medusa shipping option maps to the core
+       * fulfillment type. A shipping option belonging to a fulfillment set of type
+       * "pickup" is in-store pickup (BOPIS); everything else is a delivery.
+       */
+      parseFulfillmentType(_context, data) {
+        return data.service_zone?.fulfillment_set?.type === "pickup" ? "pickup" : "delivery";
+      }
+      /**
+       * Extension point mapping a Medusa shipping option's `data` - the payload
+       * the fulfillment provider works with (e.g. nShift's option/carrier ids) -
+       * to the shipping method's protocolData, so provider-protocol data reaches
+       * the client. String and JSON-object values are kept as-is, other
+       * primitives are stringified, and arrays/null entries are skipped.
+       *
+       * Option `metadata` is deliberately NOT mapped: it is merchant free-form
+       * annotation, not protocol data. Override this hook to surface it.
+       */
+      parseShippingMethodProtocolData(_context, data) {
+        if (!data.data) {
+          return void 0;
+        }
+        const entries = this.convertToProtocolDataEntries(data.data);
+        return entries.length > 0 ? entries : void 0;
+      }
+      /**
+       * Converts a Medusa key-value record into protocol data entries: string and
+       * JSON-object values are kept as-is, other primitives are stringified, and
+       * arrays/null entries are skipped. Keys listed in skipKeys are left out.
+       */
+      convertToProtocolDataEntries(record2, skipKeys = []) {
+        const entries = [];
+        for (const [key, value] of Object.entries(record2)) {
+          if (skipKeys.includes(key)) {
+            continue;
+          }
+          if (typeof value === "string") {
+            entries.push({ key, value });
+          } else if (typeof value === "number" || typeof value === "boolean") {
+            entries.push({ key, value: String(value) });
+          } else if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            entries.push({ key, value });
+          }
+        }
+        return entries;
+      }
+      /**
+       * Extension point resolving the carrier of a shipping option from its
+       * provider data (e.g. nShift's carrier_id), when present.
+       */
+      parseShippingMethodCarrier(_context, data) {
+        const carrierId = data.data?.["carrier_id"];
+        return typeof carrierId === "string" && carrierId.length > 0 ? carrierId : void 0;
+      }
+      /**
+       * The persisted shipping method data keys that are NOT surfaced as
+       * instruction protocol data: keys already represented as first-class
+       * instruction fields, the legacy JSON blob, and provider-side values that
+       * would mislead (nShift's data.price is not the charged amount).
+       */
+      instructionProtocolDataSkipKeys = [
+        "pickup_store",
+        "pickup_point",
+        "instructions",
+        "consent_for_unattended_delivery",
+        "shipping_protocol_data",
+        "price",
+        "currency_code"
+      ];
+      /**
+       * Builds the shipping instruction's protocolData from the persisted
+       * shipping method data: the provider payload enriched by the backend (e.g.
+       * nShift's session_id, carrier ids and optional delivery_time) merged with
+       * whatever the client sent when setting the instruction. First-class and
+       * misleading keys are skipped; the legacy shipping_protocol_data JSON blob
+       * still contributes entries whose keys are not already present.
+       */
+      parseInstructionProtocolData(smData) {
+        const entries = this.convertToProtocolDataEntries(
+          smData,
+          this.instructionProtocolDataSkipKeys
+        );
+        for (const legacyEntry of this.parseShippingProtocolData(smData["shipping_protocol_data"]) ?? []) {
+          if (!entries.some((entry) => entry.key === legacyEntry.key)) {
+            entries.push(legacyEntry);
+          }
+        }
+        return entries.length > 0 ? entries : void 0;
+      }
+      /**
+       * Parses shipping protocol data persisted as a JSON object string (keys
+       * mapping to string or JSON-object values) back into protocol data entries.
+       * Returns undefined when nothing (valid) is stored, keeping the field absent
+       * for carts that never set it.
+       */
+      parseShippingProtocolData(raw) {
+        if (typeof raw !== "string" || raw.length === 0) {
+          return void 0;
+        }
+        try {
+          const parsed = JSON.parse(raw);
+          if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            return void 0;
+          }
+          const entries = [];
+          for (const [key, value] of Object.entries(parsed)) {
+            if (typeof value === "string") {
+              entries.push({ key, value });
+            } else if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+              entries.push({ key, value });
+            }
+          }
+          return entries.length > 0 ? entries : void 0;
+        } catch {
+          return void 0;
+        }
+      }
       parsePaymentInstruction(_context, remotePayment, checkout) {
         const mainSession = (remotePayment.payment_sessions || []).find(
           (session) => session.status !== "canceled" && session.status !== "error"
@@ -162735,15 +163499,15 @@ var init_price_factory5 = __esm({
 });
 
 // packages/medusa/src/factories/product/product.factory.ts
-var import_debug39, debug39, MedusaProductFactory;
+var import_debug40, debug40, MedusaProductFactory;
 var init_product_factory5 = __esm({
   "packages/medusa/src/factories/product/product.factory.ts"() {
     "use strict";
     init_src();
-    import_debug39 = __toESM(require_src(), 1);
+    import_debug40 = __toESM(require_src(), 1);
     init_medusa_helpers();
     init_product_compliance();
-    debug39 = (0, import_debug39.default)("reactionary:medusa:product");
+    debug40 = (0, import_debug40.default)("reactionary:medusa:product");
     MedusaProductFactory = class {
       productSchema;
       constructor(productSchema) {
@@ -162912,7 +163676,7 @@ var init_product_factory5 = __esm({
         const sharedAttributes = this.parseAttributes(context2, data);
         const complianceData = this.parseComplianceData(context2, data);
         if (!data.variants) {
-          debug39("Product has no variants", data);
+          debug40("Product has no variants", data);
           throw new Error("Product has no variants " + data.external_id);
         }
         const mainVariant = this.parseVariant(context2, data.variants[0], data);
@@ -163156,6 +163920,60 @@ var init_personalization_profile_factory4 = __esm({
   }
 });
 
+// packages/medusa/src/factories/store/store.factory.ts
+var MedusaStoreFactory;
+var init_store_factory4 = __esm({
+  "packages/medusa/src/factories/store/store.factory.ts"() {
+    "use strict";
+    init_src();
+    MedusaStoreFactory = class {
+      storeSchema;
+      constructor(storeSchema) {
+        this.storeSchema = storeSchema;
+      }
+      /**
+       * Extension point to control the parsing of the stock location address
+       * into the store's address.
+       */
+      parseAddress(_context, data) {
+        if (!data.address) {
+          return void 0;
+        }
+        return {
+          identifier: AddressIdentifierSchema.parse({
+            nickName: data.address.id
+          }),
+          firstName: "",
+          lastName: data.address.company || data.name,
+          streetAddress: data.address.address_1 || "",
+          streetNumber: data.address.address_2 || "",
+          city: data.address.city || "",
+          region: data.address.province || "",
+          postalCode: data.address.postal_code || "",
+          countryCode: data.address.country_code || ""
+        };
+      }
+      parseStore(context2, data) {
+        const identifier = {
+          key: data.id
+        };
+        const fulfillmentCenter = {
+          key: data.name
+        };
+        const openingHours = data.metadata?.["opening_hours"] != null ? String(data.metadata["opening_hours"]) : void 0;
+        const result = {
+          identifier,
+          name: data.name,
+          fulfillmentCenter,
+          address: this.parseAddress(context2, data),
+          openingHours
+        };
+        return this.storeSchema.parse(result);
+      }
+    };
+  }
+});
+
 // packages/medusa/src/factories/index.ts
 var init_factories5 = __esm({
   "packages/medusa/src/factories/index.ts"() {
@@ -163177,6 +163995,7 @@ var init_factories5 = __esm({
     init_product_search_factory6();
     init_profile_factory5();
     init_personalization_profile_factory4();
+    init_store_factory4();
   }
 });
 
@@ -163499,6 +164318,22 @@ function withMedusaCapabilities(configuration, capabilities) {
         buildCapabilityArgs
       );
     }
+    if (caps.store?.enabled) {
+      client.store = resolveCapabilityWithFactory5(
+        capabilities.store,
+        {
+          factory: new MedusaStoreFactory(StoreSchema),
+          capability: (args) => new MedusaStoreCapability(
+            args.config,
+            args.cache,
+            args.context,
+            args.medusaApi,
+            args.factory
+          )
+        },
+        buildCapabilityArgs
+      );
+    }
     if (caps.personalizationProfile?.enabled) {
       client.personalizationProfile = resolveCapabilityWithFactory5(
         capabilities.personalizationProfile,
@@ -163540,6 +164375,7 @@ var init_initialize5 = __esm({
     init_product_associations_capability5();
     init_profile_capability5();
     init_personalization_profile_capability4();
+    init_store_capability4();
     init_capabilities_schema6();
     init_configuration_schema5();
     init_client6();
@@ -163577,6 +164413,7 @@ var init_src6 = __esm({
     init_checkout_capability5();
     init_product_capability5();
     init_personalization_profile_capability4();
+    init_store_capability4();
   }
 });
 
@@ -164997,8 +165834,8 @@ var init_product_recommendations_capability5 = __esm({
         try {
           const response = await index.searchSimilarDocuments(this.getSimilarProductsRecommendationsPayload(query));
           return this.parseRecommendations(response, "similar");
-        } catch (error6) {
-          console.error("Error fetching similar product recommendations:", error6);
+        } catch (error5) {
+          console.error("Error fetching similar product recommendations:", error5);
           return [];
         }
       }
@@ -165464,9 +166301,9 @@ var require_main = __commonJS({
           const attrs = _instructions(result, key);
           decrypted = DotenvModule.decrypt(attrs.ciphertext, attrs.key);
           break;
-        } catch (error6) {
+        } catch (error5) {
           if (i3 + 1 >= length) {
-            throw error6;
+            throw error5;
           }
         }
       }
@@ -165494,13 +166331,13 @@ var require_main = __commonJS({
       let uri;
       try {
         uri = new URL(dotenvKey);
-      } catch (error6) {
-        if (error6.code === "ERR_INVALID_URL") {
+      } catch (error5) {
+        if (error5.code === "ERR_INVALID_URL") {
           const err = new Error("INVALID_DOTENV_KEY: Wrong format. Must be in valid uri format like dotenv://:key_1234@dotenvx.com/vault/.env.vault?environment=development");
           err.code = "INVALID_DOTENV_KEY";
           throw err;
         }
-        throw error6;
+        throw error5;
       }
       const key = uri.password;
       if (!key) {
@@ -165547,9 +166384,9 @@ var require_main = __commonJS({
       return envPath[0] === "~" ? path2.join(os.homedir(), envPath.slice(1)) : envPath;
     }
     function _configVault(options) {
-      const debug40 = parseBoolean(process.env.DOTENV_CONFIG_DEBUG || options && options.debug);
+      const debug41 = parseBoolean(process.env.DOTENV_CONFIG_DEBUG || options && options.debug);
       const quiet = parseBoolean(process.env.DOTENV_CONFIG_QUIET || options && options.quiet);
-      if (debug40 || !quiet) {
+      if (debug41 || !quiet) {
         _log("loading env from encrypted .env.vault");
       }
       const parsed = DotenvModule._parseVault(options);
@@ -165567,12 +166404,12 @@ var require_main = __commonJS({
       if (options && options.processEnv != null) {
         processEnv = options.processEnv;
       }
-      let debug40 = parseBoolean(processEnv.DOTENV_CONFIG_DEBUG || options && options.debug);
+      let debug41 = parseBoolean(processEnv.DOTENV_CONFIG_DEBUG || options && options.debug);
       let quiet = parseBoolean(processEnv.DOTENV_CONFIG_QUIET || options && options.quiet);
       if (options && options.encoding) {
         encoding = options.encoding;
       } else {
-        if (debug40) {
+        if (debug41) {
           _debug("no encoding is specified (UTF-8 is used by default)");
         }
       }
@@ -165594,16 +166431,16 @@ var require_main = __commonJS({
           const parsed = DotenvModule.parse(fs2.readFileSync(path3, { encoding }));
           DotenvModule.populate(parsedAll, parsed, options);
         } catch (e2) {
-          if (debug40) {
+          if (debug41) {
             _debug(`failed to load ${path3} ${e2.message}`);
           }
           lastError = e2;
         }
       }
       const populated = DotenvModule.populate(processEnv, parsedAll, options);
-      debug40 = parseBoolean(processEnv.DOTENV_CONFIG_DEBUG || debug40);
+      debug41 = parseBoolean(processEnv.DOTENV_CONFIG_DEBUG || debug41);
       quiet = parseBoolean(processEnv.DOTENV_CONFIG_QUIET || quiet);
-      if (debug40 || !quiet) {
+      if (debug41 || !quiet) {
         const keysCount = Object.keys(populated).length;
         const shortPaths = [];
         for (const filePath of optionPaths) {
@@ -165611,7 +166448,7 @@ var require_main = __commonJS({
             const relative = path2.relative(process.cwd(), filePath);
             shortPaths.push(relative);
           } catch (e2) {
-            if (debug40) {
+            if (debug41) {
               _debug(`failed to load ${filePath} ${e2.message}`);
             }
             lastError = e2;
@@ -165646,10 +166483,10 @@ var require_main = __commonJS({
         const aesgcm = crypto4.createDecipheriv("aes-256-gcm", key, nonce);
         aesgcm.setAuthTag(authTag);
         return `${aesgcm.update(ciphertext)}${aesgcm.final()}`;
-      } catch (error6) {
-        const isRange = error6 instanceof RangeError;
-        const invalidKeyLength = error6.message === "Invalid key length";
-        const decryptionFailed = error6.message === "Unsupported state or unable to authenticate data";
+      } catch (error5) {
+        const isRange = error5 instanceof RangeError;
+        const invalidKeyLength = error5.message === "Invalid key length";
+        const decryptionFailed = error5.message === "Unsupported state or unable to authenticate data";
         if (isRange || invalidKeyLength) {
           const err = new Error("INVALID_DOTENV_KEY: It must be 64 characters long (or more)");
           err.code = "INVALID_DOTENV_KEY";
@@ -165659,12 +166496,12 @@ var require_main = __commonJS({
           err.code = "DECRYPTION_FAILED";
           throw err;
         } else {
-          throw error6;
+          throw error5;
         }
       }
     }
     function populate(processEnv, parsed, options = {}) {
-      const debug40 = Boolean(options && options.debug);
+      const debug41 = Boolean(options && options.debug);
       const override = Boolean(options && options.override);
       const populated = {};
       if (typeof parsed !== "object") {
@@ -165678,7 +166515,7 @@ var require_main = __commonJS({
             processEnv[key] = parsed[key];
             populated[key] = parsed[key];
           }
-          if (debug40) {
+          if (debug41) {
             if (override === true) {
               _debug(`"${key}" is already defined and WAS overwritten`);
             } else {
@@ -169125,11 +169962,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
    */
   _getOutputContext(contextOptions) {
     contextOptions = contextOptions || {};
-    const error6 = !!contextOptions.error;
+    const error5 = !!contextOptions.error;
     let baseWrite;
     let hasColors;
     let helpWidth;
-    if (error6) {
+    if (error5) {
       baseWrite = (str) => this._outputConfiguration.writeErr(str);
       hasColors = this._outputConfiguration.getErrHasColors();
       helpWidth = this._outputConfiguration.getErrHelpWidth();
@@ -169142,7 +169979,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       if (!hasColors) str = this._outputConfiguration.stripColor(str);
       return baseWrite(str);
     };
-    return { error: error6, write, hasColors, helpWidth };
+    return { error: error5, write, hasColors, helpWidth };
   }
   /**
    * Output help information for this command.
@@ -170841,11 +171678,11 @@ function validate(subject, name, url2, level) {
     }
   });
 }
-function handleError(error6, level) {
+function handleError(error5, level) {
   if (level === ErrorLevel.THROW) {
-    throw error6;
+    throw error5;
   } else if (level === ErrorLevel.WARN) {
-    console.warn(error6.name, error6.message);
+    console.warn(error5.name, error5.message);
   }
 }
 function validateSMIOptions(conf, level = ErrorLevel.WARN, errorHandler = handleError) {
@@ -171388,7 +172225,7 @@ function fanoutAsyncIterable(source, consumerCount) {
   const waiters = Array.from({ length: consumerCount }, () => []);
   const capacityWaiters = [];
   let done = false;
-  let error6 = void 0;
+  let error5 = void 0;
   const producer = (async () => {
     try {
       for await (const item of source) {
@@ -171405,7 +172242,7 @@ function fanoutAsyncIterable(source, consumerCount) {
         }
       }
     } catch (caught) {
-      error6 = caught;
+      error5 = caught;
     } finally {
       done = true;
       for (const queueWaiters of waiters) {
@@ -171423,8 +172260,8 @@ function fanoutAsyncIterable(source, consumerCount) {
           continue;
         }
         if (done) {
-          if (error6) {
-            throw error6;
+          if (error5) {
+            throw error5;
           }
           await producer;
           return;
@@ -171578,8 +172415,8 @@ function parseProductConcurrency(value, fallback2) {
   }
   return Math.floor(parsed);
 }
-main().catch((error6) => {
-  console.error(error6);
+main().catch((error5) => {
+  console.error(error5);
   process.exit(1);
 });
 /*! Bundled license information: