@timardex/cluemart-shared 1.7.90 → 2.0.0

package/dist/utils/index.d.mts

@@ -1,10 +1,10 @@
-import { a4 as DailyClueGameData, ah as GamePlacementClue, ag as GamePlacement, O as OptionItem, m as EnumPostType, aO as SocialMediaType, aN as ResourceImageType, a5 as DateTimeType, L as LocationType, h as VendorType, g as UnregisteredVendorType, c as EventListItemType } from '../global-CDYmiqmd.mjs';
+import { a3 as DailyClueGameData, ah as GamePlacementClue, ag as GamePlacement, O as OptionItem, ac as EnumPostType, aP as SocialMediaType, aO as ResourceImageType, a4 as DateTimeType, L as LocationType, h as VendorType, g as UnregisteredVendorType, c as EventListItemType } from '../global-C7-KDYqg.mjs';
 import dayjs from 'dayjs';
 import { EnumRegions, EnumUserLicence, EnumReward, EnumInviteStatus, EnumEventDateStatus, EnumResourceType, EnumBillingPeriod } from '../enums/index.mjs';
-import { h as EnumAffiliateRewardType, f as AffiliateRewardType } from '../affiliate-Cb8BLoQc.mjs';
-import { c as BillingCatalogKey, a as BillingCatalogDefinition, b as BillingCatalogInitialEntry, B as BillingCatalogEntryType } from '../billingCatalog-Bca0IZG_.mjs';
+import { h as EnumAffiliateRewardType, f as AffiliateRewardType } from '../affiliate-BL1ZN-4t.mjs';
+import { c as BillingCatalogKey, a as BillingCatalogDefinition, b as BillingCatalogInitialEntry, B as BillingCatalogEntryType } from '../billingCatalog-DDAU9BWV.mjs';
 import 'react-hook-form';
-import '../user-BTzwLwJl.mjs';
+import '../user-BA7TT2yB.mjs';
 
 /** Seeded shuffle so all players see the same letter order / placements for a game. */
 declare function seededShuffle<T>(array: readonly T[], seed: string): T[];
@@ -14,6 +14,22 @@ declare function computeDailyClueState(dailyClue: DailyClueGameData): {
     todaysPlacement: GamePlacement | null;
 } | null;
 
+/** Default page size shared by paginated list consumers. */
+declare const DEFAULT_PAGE_SIZE = 50;
+/**
+ * Default identity extractor for paginated items. Assumes the item has an `_id`
+ * field; callers with a different key (e.g. `userId`) should pass `getId`.
+ */
+declare function defaultGetId<TItem>(item: TItem): string;
+/**
+ * Appends `page` onto `items`, de-duplicating by `getId` (first occurrence
+ * wins) and preserving order. Returns the same reference when nothing new was
+ * added, so callers can rely on reference equality to avoid extra renders.
+ */
+declare function accumulateItems<TItem>(items: TItem[], page: TItem[], getId: (item: TItem) => string): TItem[];
+/** A full page means more pages may exist (offset pagination has no total count). */
+declare function computeHasMore(pageLength: number, pageSize: number): boolean;
+
 declare const dateFormat = "DD-MM-YYYY";
 declare const timeFormat = "HH:mm";
 declare function toNZTime(date?: Date | string): dayjs.Dayjs;
@@ -272,4 +288,4 @@ declare function toUserFacingErrorMessage(error: string | null | undefined, fall
 /** Extracts and sanitizes an unknown catch/Apollo error for toasts and alerts. */
 declare function getErrorMessage(error: unknown, fallback?: string): string;
 
-export { AFFILIATE_PARTICIPANT_TYPE_LABELS, AFFILIATE_REWARDS, ANDROID_URL, BILLING_CATALOG_CURRENCY, BILLING_CATALOG_DEFINITIONS, BILLING_CATALOG_KEYS, CLUEMART_MAIN_DOMAIN_URL, CM_AFFILIATE_PROMO_CODE, CM_SCHOOL_PROMO_CODE, type CalendarSheetContentData, DEFAULT_RESOURCES_RETURN_LIMIT, DEFAULT_RESOURCES_RETURN_OFFSET, DEFAULT_USER_FACING_ERROR, EVENT_DATE_STATUS_PERIOD_MAP, type EventScheduleStatusPresentation, type EventScheduleStatusTone, INITIAL_BILLING_CATALOG, IOS_URL, KNOWN_EVENT_SCHEDULE_STATUSES, NETWORK_USER_FACING_ERROR, PostTypeLabels, SCHOOL_MAX_STUDENT_COUNT, SCHOOL_MIN_STUDENT_COUNT, type StallholderFilterOption, availableRegionOptions, availableRegionTypes, billingCatalogDefinitionMatches, buildCalendarSheetContentData, capitalizeFirstLetter, cluemartSocialMedia, collectStallholderStartDates, collectVendorEventRelationDateTimes, computeDailyClueState, createAffiliateReward, dateFormat, eventHasSelectedDate, eventMatchesDateStatusPeriod, eventStartDatesSet, filterEventsByDateStatusPeriod, filterRegisteredVendorsByEventDatesOnly, filterRegisteredVendorsForEvent, filterUnregisteredVendorsByEventDatesOnly, filterUnregisteredVendorsForEvent, filterVendorEventsBySelectedDate, findEventDateTimeByIsoDate, formatDate, formatIrdNumber, formatNZBankAccount, formatTimestamp, fromCalendarIsoDate, futureTimePeriods, getAllowedEventDateStatuses, getBillingCatalogKeyForSelection, getCurrentAndFutureDates, getErrorMessage, getEventCalendarIsoDates, getEventDatesWithStallholders, getEventScheduleStatusLabel, getEventScheduleStatusPresentation, getEventScheduleStatusTone, getEventStallholderEmptyMessage, getRegisteredVendorCategoryNames, getRegisteredVendorStartDates, getStallholderCategoryNames, getStallholderCategoryOptions, getUnregisteredVendorCategoryNames, getUnregisteredVendorStartDates, getVendorEventRelationDateOptions, getVendorEventRelationStartDates, getVendorEventsEmptyMessage, hasMatchingEventDate, isFutureDatesBeforeThreshold, isInternalErrorMessage, isIsoDateString, isResourceImageActive, isTransientNetworkError, isValidIrdNumber, licenseNiceNames, mapArrayToOptions, matchesCategory, matchesSelectedDate, normalizeIrdNumber, normalizeResourceImage, normalizeUrl, nzStartOfDay, paymentMethodOptions, relationHasSelectedDate, removeTypename, resolveResourceImageActive, rewardNiceNames, seededShuffle, shouldShowEventActionsWithWeather, sortDatesChronologically, statusOptions, timeFormat, toCalendarIsoDate, toNZTime, toUserFacingErrorMessage, truncateText };
+export { AFFILIATE_PARTICIPANT_TYPE_LABELS, AFFILIATE_REWARDS, ANDROID_URL, BILLING_CATALOG_CURRENCY, BILLING_CATALOG_DEFINITIONS, BILLING_CATALOG_KEYS, CLUEMART_MAIN_DOMAIN_URL, CM_AFFILIATE_PROMO_CODE, CM_SCHOOL_PROMO_CODE, type CalendarSheetContentData, DEFAULT_PAGE_SIZE, DEFAULT_RESOURCES_RETURN_LIMIT, DEFAULT_RESOURCES_RETURN_OFFSET, DEFAULT_USER_FACING_ERROR, EVENT_DATE_STATUS_PERIOD_MAP, type EventScheduleStatusPresentation, type EventScheduleStatusTone, INITIAL_BILLING_CATALOG, IOS_URL, KNOWN_EVENT_SCHEDULE_STATUSES, NETWORK_USER_FACING_ERROR, PostTypeLabels, SCHOOL_MAX_STUDENT_COUNT, SCHOOL_MIN_STUDENT_COUNT, type StallholderFilterOption, accumulateItems, availableRegionOptions, availableRegionTypes, billingCatalogDefinitionMatches, buildCalendarSheetContentData, capitalizeFirstLetter, cluemartSocialMedia, collectStallholderStartDates, collectVendorEventRelationDateTimes, computeDailyClueState, computeHasMore, createAffiliateReward, dateFormat, defaultGetId, eventHasSelectedDate, eventMatchesDateStatusPeriod, eventStartDatesSet, filterEventsByDateStatusPeriod, filterRegisteredVendorsByEventDatesOnly, filterRegisteredVendorsForEvent, filterUnregisteredVendorsByEventDatesOnly, filterUnregisteredVendorsForEvent, filterVendorEventsBySelectedDate, findEventDateTimeByIsoDate, formatDate, formatIrdNumber, formatNZBankAccount, formatTimestamp, fromCalendarIsoDate, futureTimePeriods, getAllowedEventDateStatuses, getBillingCatalogKeyForSelection, getCurrentAndFutureDates, getErrorMessage, getEventCalendarIsoDates, getEventDatesWithStallholders, getEventScheduleStatusLabel, getEventScheduleStatusPresentation, getEventScheduleStatusTone, getEventStallholderEmptyMessage, getRegisteredVendorCategoryNames, getRegisteredVendorStartDates, getStallholderCategoryNames, getStallholderCategoryOptions, getUnregisteredVendorCategoryNames, getUnregisteredVendorStartDates, getVendorEventRelationDateOptions, getVendorEventRelationStartDates, getVendorEventsEmptyMessage, hasMatchingEventDate, isFutureDatesBeforeThreshold, isInternalErrorMessage, isIsoDateString, isResourceImageActive, isTransientNetworkError, isValidIrdNumber, licenseNiceNames, mapArrayToOptions, matchesCategory, matchesSelectedDate, normalizeIrdNumber, normalizeResourceImage, normalizeUrl, nzStartOfDay, paymentMethodOptions, relationHasSelectedDate, removeTypename, resolveResourceImageActive, rewardNiceNames, seededShuffle, shouldShowEventActionsWithWeather, sortDatesChronologically, statusOptions, timeFormat, toCalendarIsoDate, toNZTime, toUserFacingErrorMessage, truncateText };

package/dist/utils/index.d.ts

@@ -1,10 +1,10 @@
-import { a4 as DailyClueGameData, ah as GamePlacementClue, ag as GamePlacement, O as OptionItem, m as EnumPostType, aO as SocialMediaType, aN as ResourceImageType, a5 as DateTimeType, L as LocationType, h as VendorType, g as UnregisteredVendorType, c as EventListItemType } from '../global-DTXnm4Ok.js';
+import { a3 as DailyClueGameData, ah as GamePlacementClue, ag as GamePlacement, O as OptionItem, ac as EnumPostType, aP as SocialMediaType, aO as ResourceImageType, a4 as DateTimeType, L as LocationType, h as VendorType, g as UnregisteredVendorType, c as EventListItemType } from '../global-D_et_d2Y.js';
 import dayjs from 'dayjs';
 import { EnumRegions, EnumUserLicence, EnumReward, EnumInviteStatus, EnumEventDateStatus, EnumResourceType, EnumBillingPeriod } from '../enums/index.js';
-import { h as EnumAffiliateRewardType, f as AffiliateRewardType } from '../affiliate-DXpSgV4o.js';
-import { c as BillingCatalogKey, a as BillingCatalogDefinition, b as BillingCatalogInitialEntry, B as BillingCatalogEntryType } from '../billingCatalog-Rh9yvue3.js';
+import { h as EnumAffiliateRewardType, f as AffiliateRewardType } from '../affiliate-DStyY84o.js';
+import { c as BillingCatalogKey, a as BillingCatalogDefinition, b as BillingCatalogInitialEntry, B as BillingCatalogEntryType } from '../billingCatalog-oWAfZX95.js';
 import 'react-hook-form';
-import '../user-D6Mt35k0.js';
+import '../user-nHjaLZoG.js';
 
 /** Seeded shuffle so all players see the same letter order / placements for a game. */
 declare function seededShuffle<T>(array: readonly T[], seed: string): T[];
@@ -14,6 +14,22 @@ declare function computeDailyClueState(dailyClue: DailyClueGameData): {
     todaysPlacement: GamePlacement | null;
 } | null;
 
+/** Default page size shared by paginated list consumers. */
+declare const DEFAULT_PAGE_SIZE = 50;
+/**
+ * Default identity extractor for paginated items. Assumes the item has an `_id`
+ * field; callers with a different key (e.g. `userId`) should pass `getId`.
+ */
+declare function defaultGetId<TItem>(item: TItem): string;
+/**
+ * Appends `page` onto `items`, de-duplicating by `getId` (first occurrence
+ * wins) and preserving order. Returns the same reference when nothing new was
+ * added, so callers can rely on reference equality to avoid extra renders.
+ */
+declare function accumulateItems<TItem>(items: TItem[], page: TItem[], getId: (item: TItem) => string): TItem[];
+/** A full page means more pages may exist (offset pagination has no total count). */
+declare function computeHasMore(pageLength: number, pageSize: number): boolean;
+
 declare const dateFormat = "DD-MM-YYYY";
 declare const timeFormat = "HH:mm";
 declare function toNZTime(date?: Date | string): dayjs.Dayjs;
@@ -272,4 +288,4 @@ declare function toUserFacingErrorMessage(error: string | null | undefined, fall
 /** Extracts and sanitizes an unknown catch/Apollo error for toasts and alerts. */
 declare function getErrorMessage(error: unknown, fallback?: string): string;
 
-export { AFFILIATE_PARTICIPANT_TYPE_LABELS, AFFILIATE_REWARDS, ANDROID_URL, BILLING_CATALOG_CURRENCY, BILLING_CATALOG_DEFINITIONS, BILLING_CATALOG_KEYS, CLUEMART_MAIN_DOMAIN_URL, CM_AFFILIATE_PROMO_CODE, CM_SCHOOL_PROMO_CODE, type CalendarSheetContentData, DEFAULT_RESOURCES_RETURN_LIMIT, DEFAULT_RESOURCES_RETURN_OFFSET, DEFAULT_USER_FACING_ERROR, EVENT_DATE_STATUS_PERIOD_MAP, type EventScheduleStatusPresentation, type EventScheduleStatusTone, INITIAL_BILLING_CATALOG, IOS_URL, KNOWN_EVENT_SCHEDULE_STATUSES, NETWORK_USER_FACING_ERROR, PostTypeLabels, SCHOOL_MAX_STUDENT_COUNT, SCHOOL_MIN_STUDENT_COUNT, type StallholderFilterOption, availableRegionOptions, availableRegionTypes, billingCatalogDefinitionMatches, buildCalendarSheetContentData, capitalizeFirstLetter, cluemartSocialMedia, collectStallholderStartDates, collectVendorEventRelationDateTimes, computeDailyClueState, createAffiliateReward, dateFormat, eventHasSelectedDate, eventMatchesDateStatusPeriod, eventStartDatesSet, filterEventsByDateStatusPeriod, filterRegisteredVendorsByEventDatesOnly, filterRegisteredVendorsForEvent, filterUnregisteredVendorsByEventDatesOnly, filterUnregisteredVendorsForEvent, filterVendorEventsBySelectedDate, findEventDateTimeByIsoDate, formatDate, formatIrdNumber, formatNZBankAccount, formatTimestamp, fromCalendarIsoDate, futureTimePeriods, getAllowedEventDateStatuses, getBillingCatalogKeyForSelection, getCurrentAndFutureDates, getErrorMessage, getEventCalendarIsoDates, getEventDatesWithStallholders, getEventScheduleStatusLabel, getEventScheduleStatusPresentation, getEventScheduleStatusTone, getEventStallholderEmptyMessage, getRegisteredVendorCategoryNames, getRegisteredVendorStartDates, getStallholderCategoryNames, getStallholderCategoryOptions, getUnregisteredVendorCategoryNames, getUnregisteredVendorStartDates, getVendorEventRelationDateOptions, getVendorEventRelationStartDates, getVendorEventsEmptyMessage, hasMatchingEventDate, isFutureDatesBeforeThreshold, isInternalErrorMessage, isIsoDateString, isResourceImageActive, isTransientNetworkError, isValidIrdNumber, licenseNiceNames, mapArrayToOptions, matchesCategory, matchesSelectedDate, normalizeIrdNumber, normalizeResourceImage, normalizeUrl, nzStartOfDay, paymentMethodOptions, relationHasSelectedDate, removeTypename, resolveResourceImageActive, rewardNiceNames, seededShuffle, shouldShowEventActionsWithWeather, sortDatesChronologically, statusOptions, timeFormat, toCalendarIsoDate, toNZTime, toUserFacingErrorMessage, truncateText };
+export { AFFILIATE_PARTICIPANT_TYPE_LABELS, AFFILIATE_REWARDS, ANDROID_URL, BILLING_CATALOG_CURRENCY, BILLING_CATALOG_DEFINITIONS, BILLING_CATALOG_KEYS, CLUEMART_MAIN_DOMAIN_URL, CM_AFFILIATE_PROMO_CODE, CM_SCHOOL_PROMO_CODE, type CalendarSheetContentData, DEFAULT_PAGE_SIZE, DEFAULT_RESOURCES_RETURN_LIMIT, DEFAULT_RESOURCES_RETURN_OFFSET, DEFAULT_USER_FACING_ERROR, EVENT_DATE_STATUS_PERIOD_MAP, type EventScheduleStatusPresentation, type EventScheduleStatusTone, INITIAL_BILLING_CATALOG, IOS_URL, KNOWN_EVENT_SCHEDULE_STATUSES, NETWORK_USER_FACING_ERROR, PostTypeLabels, SCHOOL_MAX_STUDENT_COUNT, SCHOOL_MIN_STUDENT_COUNT, type StallholderFilterOption, accumulateItems, availableRegionOptions, availableRegionTypes, billingCatalogDefinitionMatches, buildCalendarSheetContentData, capitalizeFirstLetter, cluemartSocialMedia, collectStallholderStartDates, collectVendorEventRelationDateTimes, computeDailyClueState, computeHasMore, createAffiliateReward, dateFormat, defaultGetId, eventHasSelectedDate, eventMatchesDateStatusPeriod, eventStartDatesSet, filterEventsByDateStatusPeriod, filterRegisteredVendorsByEventDatesOnly, filterRegisteredVendorsForEvent, filterUnregisteredVendorsByEventDatesOnly, filterUnregisteredVendorsForEvent, filterVendorEventsBySelectedDate, findEventDateTimeByIsoDate, formatDate, formatIrdNumber, formatNZBankAccount, formatTimestamp, fromCalendarIsoDate, futureTimePeriods, getAllowedEventDateStatuses, getBillingCatalogKeyForSelection, getCurrentAndFutureDates, getErrorMessage, getEventCalendarIsoDates, getEventDatesWithStallholders, getEventScheduleStatusLabel, getEventScheduleStatusPresentation, getEventScheduleStatusTone, getEventStallholderEmptyMessage, getRegisteredVendorCategoryNames, getRegisteredVendorStartDates, getStallholderCategoryNames, getStallholderCategoryOptions, getUnregisteredVendorCategoryNames, getUnregisteredVendorStartDates, getVendorEventRelationDateOptions, getVendorEventRelationStartDates, getVendorEventsEmptyMessage, hasMatchingEventDate, isFutureDatesBeforeThreshold, isInternalErrorMessage, isIsoDateString, isResourceImageActive, isTransientNetworkError, isValidIrdNumber, licenseNiceNames, mapArrayToOptions, matchesCategory, matchesSelectedDate, normalizeIrdNumber, normalizeResourceImage, normalizeUrl, nzStartOfDay, paymentMethodOptions, relationHasSelectedDate, removeTypename, resolveResourceImageActive, rewardNiceNames, seededShuffle, shouldShowEventActionsWithWeather, sortDatesChronologically, statusOptions, timeFormat, toCalendarIsoDate, toNZTime, toUserFacingErrorMessage, truncateText };

package/dist/utils/index.mjs

@@ -81,7 +81,7 @@ import {
   toCalendarIsoDate,
   toUserFacingErrorMessage,
   truncateText
-} from "../chunk-D3U4LBOQ.mjs";
+} from "../chunk-L3SNS6OJ.mjs";
 import {
   dateFormat,
   formatDate,
@@ -96,11 +96,17 @@ import {
   timeFormat,
   toNZTime
 } from "../chunk-YRO6KEZG.mjs";
-import "../chunk-TD52IH52.mjs";
+import "../chunk-JJQL6LZE.mjs";
 import {
   isTransientNetworkError
 } from "../chunk-RAYUJODN.mjs";
 import "../chunk-DQ7ZHIXW.mjs";
+import {
+  DEFAULT_PAGE_SIZE,
+  accumulateItems,
+  computeHasMore,
+  defaultGetId
+} from "../chunk-7DQBUZXY.mjs";
 import "../chunk-P4NLBWEJ.mjs";
 export {
   AFFILIATE_PARTICIPANT_TYPE_LABELS,
@@ -112,6 +118,7 @@ export {
   CLUEMART_MAIN_DOMAIN_URL,
   CM_AFFILIATE_PROMO_CODE,
   CM_SCHOOL_PROMO_CODE,
+  DEFAULT_PAGE_SIZE,
   DEFAULT_RESOURCES_RETURN_LIMIT,
   DEFAULT_RESOURCES_RETURN_OFFSET,
   DEFAULT_USER_FACING_ERROR,
@@ -123,6 +130,7 @@ export {
   PostTypeLabels,
   SCHOOL_MAX_STUDENT_COUNT,
   SCHOOL_MIN_STUDENT_COUNT,
+  accumulateItems,
   availableRegionOptions,
   availableRegionTypes,
   billingCatalogDefinitionMatches,
@@ -132,8 +140,10 @@ export {
   collectStallholderStartDates,
   collectVendorEventRelationDateTimes,
   computeDailyClueState,
+  computeHasMore,
   createAffiliateReward,
   dateFormat,
+  defaultGetId,
   eventHasSelectedDate,
   eventMatchesDateStatusPeriod,
   eventStartDatesSet,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timardex/cluemart-shared",
-  "version": "1.7.90",
+  "version": "2.0.0",
   "description": "",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -116,6 +116,7 @@
   },
   "devDependencies": {
     "@apollo/client": "^3.14.1",
+    "@testing-library/react": "^16.3.3",
     "@types/node": "^22.13.4",
     "@types/react": "~19.2.10",
     "@typescript-eslint/eslint-plugin": "^8.20.0",
@@ -128,9 +129,11 @@
     "eslint-plugin-prettier": "^5.2.6",
     "graphql": "^16.12.0",
     "graphql-ws": "^6.0.6",
+    "jsdom": "^26.1.0",
     "prettier": "^3.4.2",
     "prettier-eslint": "^16.4.1",
     "react": "19.2.3",
+    "react-dom": "19.2.3",
     "rimraf": "^6.0.1",
     "tsup": "^8.3.6",
     "typescript": "^5.7.3",