@timardex/cluemart-shared 2.0.18 → 2.1.1

package/dist/map/index.d.mts

@@ -1,4 +1,4 @@
-import { J as Region } from '../global-C6w0hQ5Y.mjs';
+import { J as Region } from '../global-CWo-hWKZ.mjs';
 import 'react-hook-form';
 import '../enums/index.mjs';
 

package/dist/map/index.d.ts

@@ -1,4 +1,4 @@
-import { J as Region } from '../global-Coz5Jgi2.js';
+import { J as Region } from '../global-BqeTWrvk.js';
 import 'react-hook-form';
 import '../enums/index.js';
 

package/dist/region/index.cjs

@@ -0,0 +1,290 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/region/index.ts
+var region_exports = {};
+__export(region_exports, {
+  REGION_CENTERS: () => REGION_CENTERS,
+  nzRegions: () => nzRegions,
+  useRegionSelectionState: () => useRegionSelectionState
+});
+module.exports = __toCommonJS(region_exports);
+
+// src/enums/index.ts
+var EnumRegions = /* @__PURE__ */ ((EnumRegions2) => {
+  EnumRegions2["All"] = "All Regions";
+  EnumRegions2["Auckland"] = "Auckland";
+  EnumRegions2["BayOfPlentyGisborne"] = "Bay of Plenty & Gisborne";
+  EnumRegions2["CanterburyWestCoast"] = "Canterbury & West Coast";
+  EnumRegions2["HawkesBay"] = "Hawke's Bay";
+  EnumRegions2["ManawatuWanganui"] = "Manawatu-Wanganui";
+  EnumRegions2["MarlboroughNelsonTasman"] = "Marlborough & Nelson & Tasman";
+  EnumRegions2["Northland"] = "Northland";
+  EnumRegions2["Otago"] = "Otago";
+  EnumRegions2["Southland"] = "Southland";
+  EnumRegions2["Taranaki"] = "Taranaki";
+  EnumRegions2["Waikato"] = "Waikato";
+  EnumRegions2["Wellington"] = "Wellington";
+  return EnumRegions2;
+})(EnumRegions || {});
+
+// src/region/constants.ts
+var REGION_CENTERS = [
+  {
+    latitude: -36.8485,
+    latitudeDelta: 2,
+    longitude: 174.7633,
+    longitudeDelta: 2,
+    region: "Auckland" /* Auckland */
+  },
+  {
+    latitude: -38.1387,
+    latitudeDelta: 2,
+    longitude: 176.2452,
+    longitudeDelta: 2,
+    region: "Bay of Plenty & Gisborne" /* BayOfPlentyGisborne */
+  },
+  {
+    latitude: -43.5321,
+    latitudeDelta: 2,
+    longitude: 172.6362,
+    longitudeDelta: 2,
+    region: "Canterbury & West Coast" /* CanterburyWestCoast */
+  },
+  {
+    latitude: -39.4928,
+    latitudeDelta: 2,
+    longitude: 176.912,
+    longitudeDelta: 2,
+    region: "Hawke's Bay" /* HawkesBay */
+  },
+  {
+    latitude: -40.3523,
+    latitudeDelta: 2,
+    longitude: 175.6082,
+    longitudeDelta: 2,
+    region: "Manawatu-Wanganui" /* ManawatuWanganui */
+  },
+  {
+    latitude: -41.2706,
+    latitudeDelta: 2,
+    longitude: 173.284,
+    longitudeDelta: 2,
+    region: "Marlborough & Nelson & Tasman" /* MarlboroughNelsonTasman */
+  },
+  {
+    latitude: -35.7251,
+    latitudeDelta: 2,
+    longitude: 174.3237,
+    longitudeDelta: 2,
+    region: "Northland" /* Northland */
+  },
+  {
+    latitude: -45.8788,
+    latitudeDelta: 2,
+    longitude: 170.5028,
+    longitudeDelta: 2,
+    region: "Otago" /* Otago */
+  },
+  {
+    latitude: -46.4132,
+    latitudeDelta: 2,
+    longitude: 168.3538,
+    longitudeDelta: 2,
+    region: "Southland" /* Southland */
+  },
+  {
+    latitude: -39.0556,
+    latitudeDelta: 2,
+    longitude: 174.0752,
+    longitudeDelta: 2,
+    region: "Taranaki" /* Taranaki */
+  },
+  {
+    latitude: -37.787,
+    latitudeDelta: 2,
+    longitude: 175.2793,
+    longitudeDelta: 2,
+    region: "Waikato" /* Waikato */
+  },
+  {
+    latitude: -41.2866,
+    latitudeDelta: 2,
+    longitude: 174.7756,
+    longitudeDelta: 2,
+    region: "Wellington" /* Wellington */
+  },
+  {
+    latitude: -36.8624942,
+    // Default: New Zealand
+    latitudeDelta: 2,
+    longitude: 174.7450494,
+    longitudeDelta: 2,
+    region: "All Regions" /* All */
+  }
+];
+var nzRegions = Object.values(EnumRegions).filter(
+  (region) => region !== "All Regions" /* All */
+);
+
+// src/region/useRegionSelectionState.ts
+var import_react2 = require("react");
+
+// src/auth/UserProvider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var UserContext = (0, import_react.createContext)(void 0);
+var useAuthUser = () => {
+  const context = (0, import_react.useContext)(UserContext);
+  if (!context) {
+    throw new Error("useAuthUser must be used within a UserProvider");
+  }
+  return context;
+};
+
+// src/utils/distance.ts
+function getDistanceInMeters(coordinates1, coordinates2) {
+  const [lon1, lat1] = coordinates1;
+  const [lon2, lat2] = coordinates2;
+  const values = [lon1, lat1, lon2, lat2];
+  if (values.some((v) => !Number.isFinite(v))) {
+    return Infinity;
+  }
+  const toRadians = (deg) => deg * Math.PI / 180;
+  const R = 6371e3;
+  const dLat = toRadians(lat2 - lat1);
+  const dLon = toRadians(lon2 - lon1);
+  const radLat1 = toRadians(lat1);
+  const radLat2 = toRadians(lat2);
+  const a = Math.sin(dLat / 2) ** 2 + Math.sin(dLon / 2) ** 2 * Math.cos(radLat1) * Math.cos(radLat2);
+  const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+  return R * c;
+}
+
+// src/region/useRegionSelectionState.ts
+function getDefaultRegion() {
+  const [first] = REGION_CENTERS;
+  if (first === void 0) {
+    throw new Error(
+      "[useRegionSelectionState] REGION_CENTERS is empty \u2014 check the import."
+    );
+  }
+  return first;
+}
+function deriveRegion(location, preferredRegion) {
+  if (location) {
+    const { latitude, longitude } = location;
+    const userCoords = [longitude, latitude];
+    let nearestRegion = getDefaultRegion();
+    let nearestDistance = Infinity;
+    for (const region of REGION_CENTERS) {
+      const regionCoords = [
+        region.longitude,
+        region.latitude
+      ];
+      const distance = getDistanceInMeters(userCoords, regionCoords);
+      if (Number.isFinite(distance) && distance < nearestDistance) {
+        nearestDistance = distance;
+        nearestRegion = region;
+      }
+    }
+    if (Number.isFinite(nearestDistance)) {
+      return nearestRegion;
+    }
+  }
+  if (preferredRegion) {
+    const preferred = REGION_CENTERS.find((r) => r.region === preferredRegion);
+    if (preferred) return preferred;
+  }
+  return getDefaultRegion();
+}
+function useRegionSelectionState({
+  location
+}) {
+  const { authUser } = useAuthUser();
+  const preferredRegion = authUser?.preferredRegion;
+  const [selectedRegion, setSelectedRegion] = (0, import_react2.useState)(
+    () => deriveRegion(location, preferredRegion ?? null)
+  );
+  const [derivedRegion, setDerivedRegion] = (0, import_react2.useState)(
+    () => deriveRegion(location, preferredRegion ?? null)
+  );
+  const [loading, setLoading] = (0, import_react2.useState)(false);
+  const [hasManualSelection, setHasManualSelection] = (0, import_react2.useState)(false);
+  const timerRef = (0, import_react2.useRef)(null);
+  const prevUserIdRef = (0, import_react2.useRef)(authUser?._id);
+  (0, import_react2.useEffect)(() => {
+    if (prevUserIdRef.current !== authUser?._id) {
+      prevUserIdRef.current = authUser?._id;
+      setHasManualSelection(false);
+    }
+  }, [authUser?._id]);
+  (0, import_react2.useEffect)(() => {
+    const derived = deriveRegion(location, preferredRegion ?? null);
+    setDerivedRegion(derived);
+    if (hasManualSelection) return;
+    setSelectedRegion(derived);
+  }, [location, preferredRegion, hasManualSelection]);
+  const handleSelectRegion = (0, import_react2.useCallback)((region) => {
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+    }
+    const regionCenter = REGION_CENTERS.find((r) => r.region === region) ?? getDefaultRegion();
+    setLoading(true);
+    setSelectedRegion(regionCenter);
+    setHasManualSelection(true);
+    timerRef.current = setTimeout(() => {
+      setLoading(false);
+      timerRef.current = null;
+    }, 500);
+  }, []);
+  const handleResetRegion = (0, import_react2.useCallback)(() => {
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+    setLoading(false);
+    const derived = deriveRegion(location, preferredRegion ?? null);
+    setDerivedRegion(derived);
+    setSelectedRegion(derived);
+    setHasManualSelection(false);
+  }, [location, preferredRegion]);
+  (0, import_react2.useEffect)(() => {
+    return () => {
+      if (timerRef.current) {
+        clearTimeout(timerRef.current);
+      }
+    };
+  }, []);
+  return {
+    derivedRegion,
+    handleResetRegion,
+    handleSelectRegion,
+    loading,
+    selectedRegion
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  REGION_CENTERS,
+  nzRegions,
+  useRegionSelectionState
+});
+//# sourceMappingURL=index.cjs.map

package/dist/region/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/region/index.ts","../../src/enums/index.ts","../../src/region/constants.ts","../../src/region/useRegionSelectionState.ts","../../src/auth/UserProvider.tsx","../../src/utils/distance.ts"],"sourcesContent":["/**\n * Region selection — shared state hook and NZ region constants.\n *\n * The hook takes `location` as a prop (platform-specific: Expo geolocation on\n * mobile, `navigator.geolocation` on web) and reads `authUser` from the shared\n * auth context. Apps keep a thin local `RegionSelectionProvider` that feeds\n * the platform location and exposes the result via context.\n *\n * `\"use client\"`: required for Next.js; ignored by React Native.\n */\n\"use client\";\n\nexport { REGION_CENTERS, nzRegions, type RegionCenterType } from \"./constants\";\nexport {\n  useRegionSelectionState,\n  type IUseRegionSelectionReturn,\n  type UseRegionSelectionStateArgs,\n} from \"./useRegionSelectionState\";\n","export enum EnumInviteStatus {\n  ACCEPTED = \"Accepted\",\n  COMPLETED = \"Completed\",\n  EXPIRED = \"Expired\",\n  NO_STATUS = \"No_Status\",\n  PENDING = \"Pending\",\n  REJECTED = \"Rejected\",\n  UNAVAILABLE = \"Unavailable\",\n}\n\nexport enum EnumChatReportReason {\n  INAPPROPRIATE_CONTENT = \"Inappropriate_Content\",\n  HARASSMENT_OR_BULLYING = \"Harassment_or_Bullying\",\n  HATE_SPEECH = \"Hate_Speech\",\n  SPAM_OR_SCAM = \"Spam_or_Scam\",\n  VIOLENCE_OR_DANGEROUS_BEHAVIOR = \"Violence_or_Dangerous_Behavior\",\n  OTHER = \"Other\",\n}\n\nexport enum EnumChatType {\n  GROUP = \"group\",\n  PRIVATE = \"private\",\n}\n\nexport enum EnumPaymentMethod {\n  CASH = \"cash\",\n  EFTPOS = \"eftpos\",\n  BANK_TRANSFER = \"bank_transfer\",\n  PAYPAL = \"paypal\",\n  STRIPE = \"stripe\",\n}\n\nexport enum EnumFoodFlavor {\n  SALTY = \"Salty\",\n  SAVOURY = \"Savoury\",\n  SPICY = \"Spicy\",\n  SWEET = \"Sweet\",\n  OTHER = \"Not_Applicable\",\n}\n\nexport enum EnumFoodType {\n  ADDITIVE_FREE = \"Additive_Free\",\n  AIR_FRIED = \"Air_Fried\",\n  ALLERGEN_FRIENDLY = \"Allergen_Friendly\",\n  ATHLETE_FRIENDLY = \"Athlete_Friendly\",\n  BAKED = \"Baked\",\n  DAIRY_FREE = \"Dairy_Free\",\n  DIABETIC_FRIENDLY = \"Diabetic_Friendly\",\n  EGG_FREE = \"Egg_Free\",\n  FRESH = \"Fresh\",\n  GLUTEN_FREE = \"Gluten_Free\",\n  GRILLED = \"Grilled\",\n  HALAL = \"Halal\",\n  HEART_HEALTHY = \"Heart_Healthy\",\n  HIGH_FIBER = \"High_Fiber\",\n  HIGH_PROTEIN = \"High_Protein\",\n  KETO = \"Keto\",\n  KOSHER = \"Kosher\",\n  LACTOSE_FREE = \"Lactose_Free\",\n  LOW_CALORIE = \"Low_Calorie\",\n  LOW_CARB = \"Low_Carb\",\n  LOW_FAT = \"Low_Fat\",\n  LOW_SODIUM = \"Low_Sodium\",\n  NO_ADDED_SUGAR = \"No_Added_Sugar\",\n  NO_PRESERVATIVES = \"No_Preservatives\",\n  NON_GMO = \"Non_GMO\",\n  NUT_FREE = \"Nut_Free\",\n  ORGANIC = \"Organic\",\n  PALEO = \"Paleo\",\n  PLANT_BASED = \"Plant_Based\",\n  RAW = \"Raw\",\n  SMOKED = \"Smoked\",\n  SOY_FREE = \"Soy_Free\",\n  SUGAR_FREE = \"Sugar_Free\",\n  VEGAN = \"Vegan\",\n  VEGETARIAN = \"Vegetarian\",\n}\n\nexport enum EnumResourceType {\n  AFFILIATE = \"affiliate\",\n  EVENT = \"event\",\n  PARTNER = \"partner\",\n  SCHOOL = \"school\",\n  VENDOR = \"vendor\",\n  VISITOR = \"visitor\",\n}\n\n/** `EnumResourceType` values that map to a stored resource — excludes the user-only `VISITOR` type. */\nexport type NonVisitorResourceType = Exclude<\n  EnumResourceType,\n  EnumResourceType.VISITOR\n>;\n\n/** Type guard that narrows an `EnumResourceType` to `NonVisitorResourceType`. */\nexport function isNonVisitorResourceType(\n  value: EnumResourceType,\n): value is NonVisitorResourceType {\n  return value !== EnumResourceType.VISITOR;\n}\n\nexport enum EnumEventType {\n  MARKET = \"Market\",\n  EXPO = \"Expo\",\n  FAIR = \"Fair\",\n  FESTIVAL = \"Festival\",\n}\n\nexport enum EnumVendorType {\n  STALLHOLDER = \"Stallholder\",\n  SHOP = \"Shop\",\n}\n\nexport enum EnumPartnerType {\n  CHARITY_PARTNER = \"Charity_Partner\",\n  MEDIA_PARTNER = \"Media_Partner\",\n  SUPPORTING_PARTNER = \"Supporting_Partner\",\n}\n\nexport enum EnumOSPlatform {\n  ANDROID = \"android\",\n  IOS = \"ios\",\n  WEB = \"web\",\n}\n\nexport enum EnumRelationResource {\n  EVENT_INVITE_VENDOR = \"event_invite_vendor\",\n  EVENT_UPDATE_RELATION_TO_VENDOR = \"event_update_relation_to_vendor\",\n  VENDOR_UPDATE_RELATION_TO_EVENT = \"vendor_update_relation_to_event\",\n  VENDOR_APPLICATION_TO_EVENT = \"vendor_application_to_event\",\n}\n\nexport enum EnumNotificationResourceType {\n  AFFILIATE_REWARD_RECEIVED = \"affiliate_reward_received\",\n  APPROVED_AFFILIATE = \"approved_affiliate\",\n  APPROVED_EVENT = \"approved_event\",\n  APPROVED_PARTNER = \"approved_partner\",\n  APPROVED_SCHOOL = \"approved_school\",\n  APPROVED_VENDOR = \"approved_vendor\",\n  CREATED_EVENT = \"created_event\",\n  CREATED_PARTNER = \"created_partner\",\n  CREATED_VENDOR = \"created_vendor\",\n  DAILY_CLUE_GAME = \"daily_clue_game\",\n  DEACTIVATED_EVENT = \"deactivated_event\",\n  DEACTIVATED_PARTNER = \"deactivated_partner\",\n  DEACTIVATED_VENDOR = \"deactivated_vendor\",\n  DECLINED_EVENT = \"declined_event\",\n  DECLINED_PARTNER = \"declined_partner\",\n  DECLINED_VENDOR = \"declined_vendor\",\n  DOWNGRADED_EVENT = \"downgraded_event\",\n  DOWNGRADED_PARTNER = \"downgraded_partner\",\n  DOWNGRADED_VENDOR = \"downgraded_vendor\",\n  EVENT_INVITE_VENDOR = EnumRelationResource.EVENT_INVITE_VENDOR,\n  EVENT_STARTING_SOON = \"event_starting_soon\",\n  EVENT_UPDATE_RELATION_TO_VENDOR = EnumRelationResource.EVENT_UPDATE_RELATION_TO_VENDOR,\n  EXPIRATION_REMINDER_EVENT = \"expiration_reminder_event\",\n  EXPIRATION_REMINDER_PARTNER = \"expiration_reminder_partner\",\n  EXPIRATION_REMINDER_VENDOR = \"expiration_reminder_vendor\",\n  NEW_CHAT_MESSAGE = \"new_chat_message\",\n  NEW_POST_CREATED = \"new_post_created\",\n  REGISTERED_USER_BY_SCHOOL_CODE = \"registered_user_by_school_code\",\n  SYSTEM_ALERT = \"system_alert\",\n  USER_COUPON_REDEEMED = \"user_coupon_redeemed\",\n  VENDOR_APPLICATION_TO_EVENT = EnumRelationResource.VENDOR_APPLICATION_TO_EVENT,\n  VENDOR_UPDATE_RELATION_TO_EVENT = EnumRelationResource.VENDOR_UPDATE_RELATION_TO_EVENT,\n}\n\nexport enum EnumNotificationType {\n  CHAT = \"chat\",\n  EVENT = EnumResourceType.EVENT,\n  RELATION = \"relation\",\n  SYSTEM = \"system\",\n  VENDOR = EnumResourceType.VENDOR,\n}\n\nexport enum EnumRegions {\n  All = \"All Regions\",\n  Auckland = \"Auckland\",\n  BayOfPlentyGisborne = \"Bay of Plenty & Gisborne\",\n  CanterburyWestCoast = \"Canterbury & West Coast\",\n  HawkesBay = \"Hawke's Bay\",\n  ManawatuWanganui = \"Manawatu-Wanganui\",\n  MarlboroughNelsonTasman = \"Marlborough & Nelson & Tasman\",\n  Northland = \"Northland\",\n  Otago = \"Otago\",\n  Southland = \"Southland\",\n  Taranaki = \"Taranaki\",\n  Waikato = \"Waikato\",\n  Wellington = \"Wellington\",\n}\n\nexport enum ImageTypeEnum {\n  AVATAR = \"avatar\",\n  COVER = \"cover\",\n  IMAGE = \"image\",\n  LOGO = \"logo\",\n}\n\nexport enum EnumUserLicence {\n  PRO_EVENT = \"pro_event\",\n  PRO_PLUS_EVENT = \"pro_plus_event\",\n  PRO_PLUS_VENDOR = \"pro_plus_vendor\",\n  PRO_VENDOR = \"pro_vendor\",\n  STANDARD_EVENT = \"standard_event\",\n  STANDARD_VENDOR = \"standard_vendor\",\n  STANDARD_PARTNER = \"standard_partner\",\n  STANDARD_AFFILIATE = \"standard_affiliate\",\n  STANDARD_SCHOOL = \"standard_school\",\n}\n\nexport enum LicenceExpiryDate {\n  ONE_YEAR = \"1 year\",\n  ONE_MONTH = \"1 month\",\n  TWO_MONTHS = \"2 months\",\n  THREE_MONTHS = \"3 months\",\n  SIX_MONTHS = \"6 months\",\n}\n\nexport enum EnumUserRole {\n  ADMIN = \"admin\",\n  AFFILIATE = \"affiliate\",\n  CUSTOMER = \"customer\",\n  EVENT = \"event\",\n  PARTNER = \"partner\",\n  SCHOOL = \"school\",\n  SUPER_ADMIN = \"super_admin\",\n  VENDOR = \"vendor\",\n}\n\nexport enum EnumSocialMedia {\n  FACEBOOK = \"facebook\",\n  INSTAGRAM = \"instagram\",\n  TIKTOK = \"tiktok\",\n  TWITTER = \"twitter\",\n  WEBSITE = \"website\",\n  YOUTUBE = \"youtube\",\n}\n\nexport enum EnumEventDateStatus {\n  STARTING_SOON = \"Starting_Soon\",\n  STARTED = \"Started\",\n  TODAY = \"Today\",\n  TOMORROW = \"Tomorrow\",\n  THIS_WEEK = \"This_Week\",\n  NEXT_WEEK = \"Next_Week\",\n  UPCOMING = \"Upcoming\",\n  ENDED = \"Ended\",\n  RE_SCHEDULED = \"Rescheduled\",\n  CANCELED = \"Canceled\",\n  INVALID = \"Invalid\",\n}\n\nexport enum EnumSubscriptionStatus {\n  ACTIVE = \"active\",\n  INACTIVE = \"inactive\",\n  CANCELLED = \"cancelled\",\n  NO_SUBSCRIPTION = \"no_subscription\",\n  PAST_DUE = \"past_due\",\n  TRIALING = \"trialing\",\n}\n\nexport enum EnumBillingPeriod {\n  MONTHLY_CANCEL_ANYTIME = \"monthly_cancel_anytime\",\n  YEARLY_ANNUAL_BILLED = \"yearly_annual_billed\",\n}\n\nexport enum EnumReward {\n  MYSTERY_JOY_BOX = \"mystery_joy_box\",\n  MYSTERY_SQUEEZE_BOX = \"mystery_squeeze_box\",\n  MYSTERY_DELUXE_BOX = \"mystery_deluxe_box\",\n}\n","import { EnumRegions } from \"../enums\";\nimport type { Region } from \"../types\";\n\nexport type RegionCenterType = Region & { region: EnumRegions };\n\n/**\n * New Zealand region centres used to derive the nearest region from a\n * location and to map a region selection to map coordinates.\n *\n * The final `EnumRegions.All` entry is the NZ-wide default.\n */\nexport const REGION_CENTERS: RegionCenterType[] = [\n  {\n    latitude: -36.8485,\n    latitudeDelta: 2,\n    longitude: 174.7633,\n    longitudeDelta: 2,\n    region: EnumRegions.Auckland,\n  },\n  {\n    latitude: -38.1387,\n    latitudeDelta: 2,\n    longitude: 176.2452,\n    longitudeDelta: 2,\n    region: EnumRegions.BayOfPlentyGisborne,\n  },\n  {\n    latitude: -43.5321,\n    latitudeDelta: 2,\n    longitude: 172.6362,\n    longitudeDelta: 2,\n    region: EnumRegions.CanterburyWestCoast,\n  },\n  {\n    latitude: -39.4928,\n    latitudeDelta: 2,\n    longitude: 176.912,\n    longitudeDelta: 2,\n    region: EnumRegions.HawkesBay,\n  },\n  {\n    latitude: -40.3523,\n    latitudeDelta: 2,\n    longitude: 175.6082,\n    longitudeDelta: 2,\n    region: EnumRegions.ManawatuWanganui,\n  },\n  {\n    latitude: -41.2706,\n    latitudeDelta: 2,\n    longitude: 173.284,\n    longitudeDelta: 2,\n    region: EnumRegions.MarlboroughNelsonTasman,\n  },\n  {\n    latitude: -35.7251,\n    latitudeDelta: 2,\n    longitude: 174.3237,\n    longitudeDelta: 2,\n    region: EnumRegions.Northland,\n  },\n  {\n    latitude: -45.8788,\n    latitudeDelta: 2,\n    longitude: 170.5028,\n    longitudeDelta: 2,\n    region: EnumRegions.Otago,\n  },\n  {\n    latitude: -46.4132,\n    latitudeDelta: 2,\n    longitude: 168.3538,\n    longitudeDelta: 2,\n    region: EnumRegions.Southland,\n  },\n  {\n    latitude: -39.0556,\n    latitudeDelta: 2,\n    longitude: 174.0752,\n    longitudeDelta: 2,\n    region: EnumRegions.Taranaki,\n  },\n  {\n    latitude: -37.787,\n    latitudeDelta: 2,\n    longitude: 175.2793,\n    longitudeDelta: 2,\n    region: EnumRegions.Waikato,\n  },\n  {\n    latitude: -41.2866,\n    latitudeDelta: 2,\n    longitude: 174.7756,\n    longitudeDelta: 2,\n    region: EnumRegions.Wellington,\n  },\n  {\n    latitude: -36.8624942, // Default: New Zealand\n    latitudeDelta: 2,\n    longitude: 174.7450494,\n    longitudeDelta: 2,\n    region: EnumRegions.All,\n  },\n];\n\n/**\n * All selectable NZ regions, excluding the `All` pseudo-region.\n */\nexport const nzRegions = Object.values(EnumRegions).filter(\n  (region) => region !== EnumRegions.All,\n);\n","import { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useAuthUser } from \"../auth/UserProvider\";\nimport { EnumRegions } from \"../enums\";\nimport { getDistanceInMeters } from \"../utils/distance\";\n\nimport { REGION_CENTERS, type RegionCenterType } from \"./constants\";\n\nexport interface IUseRegionSelectionReturn {\n  derivedRegion: RegionCenterType;\n  handleResetRegion: () => void;\n  handleSelectRegion: (region: EnumRegions) => void;\n  loading: boolean;\n  selectedRegion: RegionCenterType;\n}\n\ntype DeriveRegionLocation = {\n  latitude: number;\n  longitude: number;\n};\n\nexport interface UseRegionSelectionStateArgs {\n  location: DeriveRegionLocation | null | undefined;\n}\n\n// AUDIT-DECISION: Fail fast if REGION_CENTERS is empty. It is a compile-time\n// constant, so an empty array means the import is broken — an invariant beats\n// a silent undefined that surfaces as a crash three screens away.\nfunction getDefaultRegion(): RegionCenterType {\n  const [first] = REGION_CENTERS;\n  if (first === undefined) {\n    throw new Error(\n      \"[useRegionSelectionState] REGION_CENTERS is empty — check the import.\",\n    );\n  }\n  return first;\n}\n\n// AUDIT-DECISION: Pure helper — no side effects, no hook calls.\n// Accepts nullable inputs so callers never need to guard before calling it.\nfunction deriveRegion(\n  location: DeriveRegionLocation | null | undefined,\n  preferredRegion: EnumRegions | null | undefined,\n): RegionCenterType {\n  // 1. Location available — pick nearest valid region.\n  if (location) {\n    const { latitude, longitude } = location;\n    const userCoords: [number, number] = [longitude, latitude];\n\n    let nearestRegion: RegionCenterType = getDefaultRegion();\n    let nearestDistance = Infinity;\n\n    for (const region of REGION_CENTERS) {\n      const regionCoords: [number, number] = [\n        region.longitude,\n        region.latitude,\n      ];\n      const distance = getDistanceInMeters(userCoords, regionCoords);\n\n      // AUDIT-DECISION: Skip non-finite distances — getDistanceInMeters\n      // returns Infinity for invalid coords. We do not want a bogus distance to\n      // \"win\" the reduce by being the first candidate with the starting Infinity\n      // baseline, which was the original bug.\n      if (Number.isFinite(distance) && distance < nearestDistance) {\n        nearestDistance = distance;\n        nearestRegion = region;\n      }\n    }\n\n    // AUDIT-DECISION: If every distance was non-finite (malformed location),\n    // fall through to the preference path rather than returning REGION_CENTERS[0]\n    // unconditionally. This keeps the fallback chain consistent.\n    if (Number.isFinite(nearestDistance)) {\n      return nearestRegion;\n    }\n  }\n\n  // 2. No usable location — use the user's stored preference.\n  if (preferredRegion) {\n    const preferred = REGION_CENTERS.find((r) => r.region === preferredRegion);\n    if (preferred) return preferred;\n  }\n\n  // 3. Last resort — first entry in the array.\n  return getDefaultRegion();\n}\n\nexport function useRegionSelectionState({\n  location,\n}: UseRegionSelectionStateArgs): IUseRegionSelectionReturn {\n  const { authUser } = useAuthUser();\n\n  const preferredRegion = authUser?.preferredRegion as\n    EnumRegions | null | undefined;\n\n  // AUDIT-DECISION: Derive the initial region synchronously so the very first\n  // render never sees undefined. deriveRegion is cheap (O(n) array scan).\n  const [selectedRegion, setSelectedRegion] = useState<RegionCenterType>(() =>\n    deriveRegion(location, preferredRegion ?? null),\n  );\n  // AUDIT-DECISION: Track the auto-derived default separately from the user's\n  // manual selection. derivedRegion always reflects deriveRegion(location,\n  // preferredRegion) — nearest location → preferred region → first region — so\n  // consumers can detect divergence from the default and reset back to it.\n  const [derivedRegion, setDerivedRegion] = useState<RegionCenterType>(() =>\n    deriveRegion(location, preferredRegion ?? null),\n  );\n  const [loading, setLoading] = useState<boolean>(false);\n  const [hasManualSelection, setHasManualSelection] = useState<boolean>(false);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // AUDIT-DECISION: Reset manual selection when the authenticated user changes\n  // so the auto-derive re-runs for the new identity. Keying on authUser?._id\n  // (not the full object) avoids false resets on reference-stable re-renders.\n  const prevUserIdRef = useRef<string | undefined>(authUser?._id);\n  useEffect(() => {\n    if (prevUserIdRef.current !== authUser?._id) {\n      prevUserIdRef.current = authUser?._id;\n      setHasManualSelection(false);\n    }\n  }, [authUser?._id]);\n\n  // AUDIT-DECISION: Compute and apply the derived region in a single effect —\n  // no intermediate memo. This removes the two-cycle race window where the\n  // memoised value existed before the state write committed.\n  useEffect(() => {\n    const derived = deriveRegion(location, preferredRegion ?? null);\n    setDerivedRegion(derived);\n\n    if (hasManualSelection) return;\n    setSelectedRegion(derived);\n  }, [location, preferredRegion, hasManualSelection]);\n\n  const handleSelectRegion = useCallback((region: EnumRegions) => {\n    if (timerRef.current) {\n      clearTimeout(timerRef.current);\n    }\n\n    const regionCenter =\n      REGION_CENTERS.find((r) => r.region === region) ?? getDefaultRegion();\n\n    setLoading(true);\n    setSelectedRegion(regionCenter);\n    setHasManualSelection(true);\n\n    timerRef.current = setTimeout(() => {\n      setLoading(false);\n      timerRef.current = null;\n    }, 500);\n  }, []);\n\n  const handleResetRegion = useCallback(() => {\n    if (timerRef.current) {\n      clearTimeout(timerRef.current);\n      timerRef.current = null;\n    }\n\n    setLoading(false);\n    const derived = deriveRegion(location, preferredRegion ?? null);\n    setDerivedRegion(derived);\n    setSelectedRegion(derived);\n    setHasManualSelection(false);\n  }, [location, preferredRegion]);\n\n  // Cleanup on unmount.\n  useEffect(() => {\n    return () => {\n      if (timerRef.current) {\n        clearTimeout(timerRef.current);\n      }\n    };\n  }, []);\n\n  return {\n    derivedRegion,\n    handleResetRegion,\n    handleSelectRegion,\n    loading,\n    selectedRegion,\n  };\n}\n\nexport default useRegionSelectionState;\n","/**\n * Shared React context for auth session state.\n *\n * Apps keep a thin local UserProvider that calls their platform `useAuth`\n * (adapters) and pass the result here as `value`. Import `useAuthUser` from\n * this module (or re-export it) so consumers share one context instance.\n *\n * `\"use client\"`: required for Next.js; ignored by React Native.\n */\n\"use client\";\n\nimport React, { createContext, useContext, type ReactNode } from \"react\";\n\nimport type { UseAuthReturnType } from \"./types\";\n\nconst UserContext = createContext<UseAuthReturnType | undefined>(undefined);\n\n/**\n * Provides auth session value from the app's thin useAuth wrapper.\n */\nexport const UserProvider: React.FC<{\n  children: ReactNode;\n  value: UseAuthReturnType;\n}> = ({ children, value }) => {\n  return <UserContext.Provider value={value}>{children}</UserContext.Provider>;\n};\n\nexport const useAuthUser = (): UseAuthReturnType => {\n  const context = useContext(UserContext);\n  if (!context) {\n    throw new Error(\"useAuthUser must be used within a UserProvider\");\n  }\n  return context;\n};\n","export function getDistanceInMeters(\n  coordinates1: number[],\n  coordinates2: number[],\n): number {\n  const [lon1, lat1] = coordinates1;\n  const [lon2, lat2] = coordinates2;\n\n  const values = [lon1, lat1, lon2, lat2];\n  if (values.some((v) => !Number.isFinite(v))) {\n    return Infinity;\n  }\n\n  const toRadians = (deg: number) => (deg * Math.PI) / 180;\n  const R = 6371000; // Earth radius in meters\n\n  const dLat = toRadians(lat2 - lat1);\n  const dLon = toRadians(lon2 - lon1);\n  const radLat1 = toRadians(lat1);\n  const radLat2 = toRadians(lat2);\n\n  const a =\n    Math.sin(dLat / 2) ** 2 +\n    Math.sin(dLon / 2) ** 2 * Math.cos(radLat1) * Math.cos(radLat2);\n\n  const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));\n\n  return R * c;\n}\n\nexport function getDistanceInKilometers(\n  coordinates1: number[],\n  coordinates2: number[],\n): number {\n  const distanceInMeters = getDistanceInMeters(coordinates1, coordinates2);\n\n  if (!Number.isFinite(distanceInMeters)) {\n    return Infinity;\n  }\n\n  return Math.round(distanceInMeters / 1000);\n}\n\nexport function formatDistance(\n  coordinates1: number[],\n  coordinates2: number[],\n): string {\n  const distanceInMeters = getDistanceInMeters(coordinates1, coordinates2);\n\n  if (!Number.isFinite(distanceInMeters)) {\n    return \"—\";\n  }\n\n  const roundedMeters = Math.round(distanceInMeters);\n\n  if (roundedMeters < 1000) {\n    return `${roundedMeters} m`;\n  }\n\n  return `${Math.round(roundedMeters / 1000)} km`;\n}\n"],"mappings":"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","names":["EnumRegions","import_react"]}

package/dist/region/index.d.mts

@@ -0,0 +1,36 @@
+import { EnumRegions } from '../enums/index.mjs';
+import { J as Region } from '../global-CWo-hWKZ.mjs';
+import 'react-hook-form';
+
+type RegionCenterType = Region & {
+    region: EnumRegions;
+};
+/**
+ * New Zealand region centres used to derive the nearest region from a
+ * location and to map a region selection to map coordinates.
+ *
+ * The final `EnumRegions.All` entry is the NZ-wide default.
+ */
+declare const REGION_CENTERS: RegionCenterType[];
+/**
+ * All selectable NZ regions, excluding the `All` pseudo-region.
+ */
+declare const nzRegions: (EnumRegions.Auckland | EnumRegions.BayOfPlentyGisborne | EnumRegions.CanterburyWestCoast | EnumRegions.HawkesBay | EnumRegions.ManawatuWanganui | EnumRegions.MarlboroughNelsonTasman | EnumRegions.Northland | EnumRegions.Otago | EnumRegions.Southland | EnumRegions.Taranaki | EnumRegions.Waikato | EnumRegions.Wellington)[];
+
+interface IUseRegionSelectionReturn {
+    derivedRegion: RegionCenterType;
+    handleResetRegion: () => void;
+    handleSelectRegion: (region: EnumRegions) => void;
+    loading: boolean;
+    selectedRegion: RegionCenterType;
+}
+type DeriveRegionLocation = {
+    latitude: number;
+    longitude: number;
+};
+interface UseRegionSelectionStateArgs {
+    location: DeriveRegionLocation | null | undefined;
+}
+declare function useRegionSelectionState({ location, }: UseRegionSelectionStateArgs): IUseRegionSelectionReturn;
+
+export { type IUseRegionSelectionReturn, REGION_CENTERS, type RegionCenterType, type UseRegionSelectionStateArgs, nzRegions, useRegionSelectionState };

package/dist/region/index.d.ts

@@ -0,0 +1,36 @@
+import { EnumRegions } from '../enums/index.js';
+import { J as Region } from '../global-BqeTWrvk.js';
+import 'react-hook-form';
+
+type RegionCenterType = Region & {
+    region: EnumRegions;
+};
+/**
+ * New Zealand region centres used to derive the nearest region from a
+ * location and to map a region selection to map coordinates.
+ *
+ * The final `EnumRegions.All` entry is the NZ-wide default.
+ */
+declare const REGION_CENTERS: RegionCenterType[];
+/**
+ * All selectable NZ regions, excluding the `All` pseudo-region.
+ */
+declare const nzRegions: (EnumRegions.Auckland | EnumRegions.BayOfPlentyGisborne | EnumRegions.CanterburyWestCoast | EnumRegions.HawkesBay | EnumRegions.ManawatuWanganui | EnumRegions.MarlboroughNelsonTasman | EnumRegions.Northland | EnumRegions.Otago | EnumRegions.Southland | EnumRegions.Taranaki | EnumRegions.Waikato | EnumRegions.Wellington)[];
+
+interface IUseRegionSelectionReturn {
+    derivedRegion: RegionCenterType;
+    handleResetRegion: () => void;
+    handleSelectRegion: (region: EnumRegions) => void;
+    loading: boolean;
+    selectedRegion: RegionCenterType;
+}
+type DeriveRegionLocation = {
+    latitude: number;
+    longitude: number;
+};
+interface UseRegionSelectionStateArgs {
+    location: DeriveRegionLocation | null | undefined;
+}
+declare function useRegionSelectionState({ location, }: UseRegionSelectionStateArgs): IUseRegionSelectionReturn;
+
+export { type IUseRegionSelectionReturn, REGION_CENTERS, type RegionCenterType, type UseRegionSelectionStateArgs, nzRegions, useRegionSelectionState };

package/dist/region/index.mjs

@@ -0,0 +1,220 @@
+"use client";
+import {
+  useAuthUser
+} from "../chunk-N46DFZ3R.mjs";
+import {
+  getDistanceInMeters
+} from "../chunk-RE4NZPYY.mjs";
+import {
+  EnumRegions
+} from "../chunk-7TZDJXYL.mjs";
+
+// src/region/constants.ts
+var REGION_CENTERS = [
+  {
+    latitude: -36.8485,
+    latitudeDelta: 2,
+    longitude: 174.7633,
+    longitudeDelta: 2,
+    region: "Auckland" /* Auckland */
+  },
+  {
+    latitude: -38.1387,
+    latitudeDelta: 2,
+    longitude: 176.2452,
+    longitudeDelta: 2,
+    region: "Bay of Plenty & Gisborne" /* BayOfPlentyGisborne */
+  },
+  {
+    latitude: -43.5321,
+    latitudeDelta: 2,
+    longitude: 172.6362,
+    longitudeDelta: 2,
+    region: "Canterbury & West Coast" /* CanterburyWestCoast */
+  },
+  {
+    latitude: -39.4928,
+    latitudeDelta: 2,
+    longitude: 176.912,
+    longitudeDelta: 2,
+    region: "Hawke's Bay" /* HawkesBay */
+  },
+  {
+    latitude: -40.3523,
+    latitudeDelta: 2,
+    longitude: 175.6082,
+    longitudeDelta: 2,
+    region: "Manawatu-Wanganui" /* ManawatuWanganui */
+  },
+  {
+    latitude: -41.2706,
+    latitudeDelta: 2,
+    longitude: 173.284,
+    longitudeDelta: 2,
+    region: "Marlborough & Nelson & Tasman" /* MarlboroughNelsonTasman */
+  },
+  {
+    latitude: -35.7251,
+    latitudeDelta: 2,
+    longitude: 174.3237,
+    longitudeDelta: 2,
+    region: "Northland" /* Northland */
+  },
+  {
+    latitude: -45.8788,
+    latitudeDelta: 2,
+    longitude: 170.5028,
+    longitudeDelta: 2,
+    region: "Otago" /* Otago */
+  },
+  {
+    latitude: -46.4132,
+    latitudeDelta: 2,
+    longitude: 168.3538,
+    longitudeDelta: 2,
+    region: "Southland" /* Southland */
+  },
+  {
+    latitude: -39.0556,
+    latitudeDelta: 2,
+    longitude: 174.0752,
+    longitudeDelta: 2,
+    region: "Taranaki" /* Taranaki */
+  },
+  {
+    latitude: -37.787,
+    latitudeDelta: 2,
+    longitude: 175.2793,
+    longitudeDelta: 2,
+    region: "Waikato" /* Waikato */
+  },
+  {
+    latitude: -41.2866,
+    latitudeDelta: 2,
+    longitude: 174.7756,
+    longitudeDelta: 2,
+    region: "Wellington" /* Wellington */
+  },
+  {
+    latitude: -36.8624942,
+    // Default: New Zealand
+    latitudeDelta: 2,
+    longitude: 174.7450494,
+    longitudeDelta: 2,
+    region: "All Regions" /* All */
+  }
+];
+var nzRegions = Object.values(EnumRegions).filter(
+  (region) => region !== "All Regions" /* All */
+);
+
+// src/region/useRegionSelectionState.ts
+import { useCallback, useEffect, useRef, useState } from "react";
+function getDefaultRegion() {
+  const [first] = REGION_CENTERS;
+  if (first === void 0) {
+    throw new Error(
+      "[useRegionSelectionState] REGION_CENTERS is empty \u2014 check the import."
+    );
+  }
+  return first;
+}
+function deriveRegion(location, preferredRegion) {
+  if (location) {
+    const { latitude, longitude } = location;
+    const userCoords = [longitude, latitude];
+    let nearestRegion = getDefaultRegion();
+    let nearestDistance = Infinity;
+    for (const region of REGION_CENTERS) {
+      const regionCoords = [
+        region.longitude,
+        region.latitude
+      ];
+      const distance = getDistanceInMeters(userCoords, regionCoords);
+      if (Number.isFinite(distance) && distance < nearestDistance) {
+        nearestDistance = distance;
+        nearestRegion = region;
+      }
+    }
+    if (Number.isFinite(nearestDistance)) {
+      return nearestRegion;
+    }
+  }
+  if (preferredRegion) {
+    const preferred = REGION_CENTERS.find((r) => r.region === preferredRegion);
+    if (preferred) return preferred;
+  }
+  return getDefaultRegion();
+}
+function useRegionSelectionState({
+  location
+}) {
+  const { authUser } = useAuthUser();
+  const preferredRegion = authUser?.preferredRegion;
+  const [selectedRegion, setSelectedRegion] = useState(
+    () => deriveRegion(location, preferredRegion ?? null)
+  );
+  const [derivedRegion, setDerivedRegion] = useState(
+    () => deriveRegion(location, preferredRegion ?? null)
+  );
+  const [loading, setLoading] = useState(false);
+  const [hasManualSelection, setHasManualSelection] = useState(false);
+  const timerRef = useRef(null);
+  const prevUserIdRef = useRef(authUser?._id);
+  useEffect(() => {
+    if (prevUserIdRef.current !== authUser?._id) {
+      prevUserIdRef.current = authUser?._id;
+      setHasManualSelection(false);
+    }
+  }, [authUser?._id]);
+  useEffect(() => {
+    const derived = deriveRegion(location, preferredRegion ?? null);
+    setDerivedRegion(derived);
+    if (hasManualSelection) return;
+    setSelectedRegion(derived);
+  }, [location, preferredRegion, hasManualSelection]);
+  const handleSelectRegion = useCallback((region) => {
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+    }
+    const regionCenter = REGION_CENTERS.find((r) => r.region === region) ?? getDefaultRegion();
+    setLoading(true);
+    setSelectedRegion(regionCenter);
+    setHasManualSelection(true);
+    timerRef.current = setTimeout(() => {
+      setLoading(false);
+      timerRef.current = null;
+    }, 500);
+  }, []);
+  const handleResetRegion = useCallback(() => {
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+    setLoading(false);
+    const derived = deriveRegion(location, preferredRegion ?? null);
+    setDerivedRegion(derived);
+    setSelectedRegion(derived);
+    setHasManualSelection(false);
+  }, [location, preferredRegion]);
+  useEffect(() => {
+    return () => {
+      if (timerRef.current) {
+        clearTimeout(timerRef.current);
+      }
+    };
+  }, []);
+  return {
+    derivedRegion,
+    handleResetRegion,
+    handleSelectRegion,
+    loading,
+    selectedRegion
+  };
+}
+export {
+  REGION_CENTERS,
+  nzRegions,
+  useRegionSelectionState
+};
+//# sourceMappingURL=index.mjs.map