@timardex/cluemart-shared 2.5.0 → 2.5.1

package/dist/utils/index.d.mts

@@ -406,6 +406,22 @@ declare function isValidIrdNumber(value: string): boolean;
 /** True for short-lived connectivity failures (e.g. resume before the stack is ready). */
 declare function isTransientNetworkError(err: unknown): boolean;
 
+/** Client-side rotation window shared by web (admin) and mobile ad renderers. */
+declare const AD_METRIC_ROTATION_INTERVAL_MS = 8000;
+/** Delay before a single impression retry within the same rotation slot. */
+declare const AD_METRIC_IMPRESSION_RETRY_DELAY_MS = 1000;
+/** Rotation slot index for a timestamp, matching the server dedupe window. */
+declare function getAdMetricRotationSlot(epochMilliseconds: number): number;
+/** Which ad of `count` is displayed at a given timestamp. */
+declare function getAdMetricRotationIndex(epochMilliseconds: number, count: number): number;
+/** Stable per-slot impression key used by the client to suppress duplicates. */
+declare function buildAdMetricSlotKey(adId: string, placement: string, slot: number): string;
+/**
+ * Unique per-click id. `crypto.randomUUID` is absent or non-callable in older
+ * browsers, non-secure contexts, and some React Native runtimes.
+ */
+declare function generateAdClickId(): string;
+
 declare const BILLING_CATALOG_KEYS: readonly ["pro_vendor_monthly", "pro_vendor_yearly", "pro_plus_vendor_monthly", "pro_plus_vendor_yearly"];
 declare const BILLING_CATALOG_CURRENCY: "nzd";
 /**
@@ -506,4 +522,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_PAGE_SIZE, DEFAULT_RESOURCES_RETURN_LIMIT, DEFAULT_RESOURCES_RETURN_OFFSET, DEFAULT_USER_FACING_ERROR, EVENT_DATE_STATUS_LABELS, EVENT_DATE_STATUS_PERIOD_MAP, type EventScheduleStatusPresentation, type EventScheduleStatusTone, type EventStallholderDateOption, type EventStallholdersData, FUTURE_EVENT_DATE_STATUSES, type GetEventStallholdersDataInput, type GetVendorEventsDataInput, INITIAL_BILLING_CATALOG, IOS_URL, MANUAL_DATE_STATUSES, NETWORK_USER_FACING_ERROR, NZ_TZ, PRESERVED_RELATION_DATE_STATUSES, PostTypeLabels, SCHOOL_MAX_STUDENT_COUNT, SCHOOL_MIN_STUDENT_COUNT, type StallholderFilterOption, type VendorEventDateOption, type VendorEventsData, accumulateItems, availableRegionOptions, availableRegionTypes, billingCatalogDefinitionMatches, buildCalendarSheetContentData, buildRelationEligibleEventSchedule, capitalizeFirstLetter, cluemartSocialMedia, collectStallholderDateTimes, collectVendorEventRelationDateTimes, computeDailyClueState, computeHasMore, countLetterOccurrences, countLetterOccurrencesUpTo, createAffiliateReward, dateFormat, defaultGetId, eventHasSelectedDate, eventMatchesDateStatusPeriod, eventStartDatesSet, filterDatesByFutureStatus, filterEventsByDateStatusPeriod, filterRegisteredVendorsByEventDatesOnly, filterRegisteredVendorsForEvent, filterUnregisteredVendorsByEventDatesOnly, filterUnregisteredVendorsForEvent, filterVendorEventsBySelectedDate, findEventDateTimeByIsoDate, formatDate, formatDistance, formatIrdNumber, formatNZBankAccount, formatTimestamp, fromCalendarIsoDate, futureTimePeriods, getAllowedEventDateStatuses, getBillingCatalogKeyForSelection, getCurrentAndFutureDates, getDailyClueDayIndex, getDistanceInKilometers, getDistanceInMeters, getErrorMessage, getEventCalendarIsoDates, getEventScheduleStatusLabel, getEventScheduleStatusPresentation, getEventScheduleStatusTone, getEventStallholderEmptyMessage, getEventStallholdersData, getFutureEventStatus, getRegisteredVendorCategoryNames, getRegisteredVendorStartDates, getStallholderCategoryNames, getStallholderCategoryOptions, getUniqueStallholderStartDates, getUniqueStartDates, getUnregisteredVendorCategoryNames, getUnregisteredVendorStartDates, getVendorEventRelationDateOptions, getVendorEventRelationStartDates, getVendorEventsData, getVendorEventsEmptyMessage, hasMatchingEventDate, isFutureDatesBeforeThreshold, isFutureEventDateStatus, isFutureStartDate, isInternalErrorMessage, isIsoDateString, isResourceImageActive, isTransientNetworkError, isUtcMidnight, isValidIrdNumber, isoDateFormat, licenseNiceNames, mapArrayToOptions, matchesCategory, matchesSelectedDate, normalizeIrdNumber, normalizeResourceImage, normalizeUrl, nzDayKey, nzStartOfDay, paymentMethodOptions, relationHasSelectedDate, removeTypename, resolveResourceImageActive, rewardNiceNames, seededShuffle, shouldShowEventActionsWithWeather, sortDatesChronologically, statusOptions, sumUserOverallPoints, timeFormat, toCalendarIsoDate, toNZTime, toUserFacingErrorMessage, truncateText, updateSingleDateTimeStatus, vendorLicences };
+export { AD_METRIC_IMPRESSION_RETRY_DELAY_MS, AD_METRIC_ROTATION_INTERVAL_MS, 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_LABELS, EVENT_DATE_STATUS_PERIOD_MAP, type EventScheduleStatusPresentation, type EventScheduleStatusTone, type EventStallholderDateOption, type EventStallholdersData, FUTURE_EVENT_DATE_STATUSES, type GetEventStallholdersDataInput, type GetVendorEventsDataInput, INITIAL_BILLING_CATALOG, IOS_URL, MANUAL_DATE_STATUSES, NETWORK_USER_FACING_ERROR, NZ_TZ, PRESERVED_RELATION_DATE_STATUSES, PostTypeLabels, SCHOOL_MAX_STUDENT_COUNT, SCHOOL_MIN_STUDENT_COUNT, type StallholderFilterOption, type VendorEventDateOption, type VendorEventsData, accumulateItems, availableRegionOptions, availableRegionTypes, billingCatalogDefinitionMatches, buildAdMetricSlotKey, buildCalendarSheetContentData, buildRelationEligibleEventSchedule, capitalizeFirstLetter, cluemartSocialMedia, collectStallholderDateTimes, collectVendorEventRelationDateTimes, computeDailyClueState, computeHasMore, countLetterOccurrences, countLetterOccurrencesUpTo, createAffiliateReward, dateFormat, defaultGetId, eventHasSelectedDate, eventMatchesDateStatusPeriod, eventStartDatesSet, filterDatesByFutureStatus, filterEventsByDateStatusPeriod, filterRegisteredVendorsByEventDatesOnly, filterRegisteredVendorsForEvent, filterUnregisteredVendorsByEventDatesOnly, filterUnregisteredVendorsForEvent, filterVendorEventsBySelectedDate, findEventDateTimeByIsoDate, formatDate, formatDistance, formatIrdNumber, formatNZBankAccount, formatTimestamp, fromCalendarIsoDate, futureTimePeriods, generateAdClickId, getAdMetricRotationIndex, getAdMetricRotationSlot, getAllowedEventDateStatuses, getBillingCatalogKeyForSelection, getCurrentAndFutureDates, getDailyClueDayIndex, getDistanceInKilometers, getDistanceInMeters, getErrorMessage, getEventCalendarIsoDates, getEventScheduleStatusLabel, getEventScheduleStatusPresentation, getEventScheduleStatusTone, getEventStallholderEmptyMessage, getEventStallholdersData, getFutureEventStatus, getRegisteredVendorCategoryNames, getRegisteredVendorStartDates, getStallholderCategoryNames, getStallholderCategoryOptions, getUniqueStallholderStartDates, getUniqueStartDates, getUnregisteredVendorCategoryNames, getUnregisteredVendorStartDates, getVendorEventRelationDateOptions, getVendorEventRelationStartDates, getVendorEventsData, getVendorEventsEmptyMessage, hasMatchingEventDate, isFutureDatesBeforeThreshold, isFutureEventDateStatus, isFutureStartDate, isInternalErrorMessage, isIsoDateString, isResourceImageActive, isTransientNetworkError, isUtcMidnight, isValidIrdNumber, isoDateFormat, licenseNiceNames, mapArrayToOptions, matchesCategory, matchesSelectedDate, normalizeIrdNumber, normalizeResourceImage, normalizeUrl, nzDayKey, nzStartOfDay, paymentMethodOptions, relationHasSelectedDate, removeTypename, resolveResourceImageActive, rewardNiceNames, seededShuffle, shouldShowEventActionsWithWeather, sortDatesChronologically, statusOptions, sumUserOverallPoints, timeFormat, toCalendarIsoDate, toNZTime, toUserFacingErrorMessage, truncateText, updateSingleDateTimeStatus, vendorLicences };

package/dist/utils/index.d.ts

@@ -406,6 +406,22 @@ declare function isValidIrdNumber(value: string): boolean;
 /** True for short-lived connectivity failures (e.g. resume before the stack is ready). */
 declare function isTransientNetworkError(err: unknown): boolean;
 
+/** Client-side rotation window shared by web (admin) and mobile ad renderers. */
+declare const AD_METRIC_ROTATION_INTERVAL_MS = 8000;
+/** Delay before a single impression retry within the same rotation slot. */
+declare const AD_METRIC_IMPRESSION_RETRY_DELAY_MS = 1000;
+/** Rotation slot index for a timestamp, matching the server dedupe window. */
+declare function getAdMetricRotationSlot(epochMilliseconds: number): number;
+/** Which ad of `count` is displayed at a given timestamp. */
+declare function getAdMetricRotationIndex(epochMilliseconds: number, count: number): number;
+/** Stable per-slot impression key used by the client to suppress duplicates. */
+declare function buildAdMetricSlotKey(adId: string, placement: string, slot: number): string;
+/**
+ * Unique per-click id. `crypto.randomUUID` is absent or non-callable in older
+ * browsers, non-secure contexts, and some React Native runtimes.
+ */
+declare function generateAdClickId(): string;
+
 declare const BILLING_CATALOG_KEYS: readonly ["pro_vendor_monthly", "pro_vendor_yearly", "pro_plus_vendor_monthly", "pro_plus_vendor_yearly"];
 declare const BILLING_CATALOG_CURRENCY: "nzd";
 /**
@@ -506,4 +522,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_PAGE_SIZE, DEFAULT_RESOURCES_RETURN_LIMIT, DEFAULT_RESOURCES_RETURN_OFFSET, DEFAULT_USER_FACING_ERROR, EVENT_DATE_STATUS_LABELS, EVENT_DATE_STATUS_PERIOD_MAP, type EventScheduleStatusPresentation, type EventScheduleStatusTone, type EventStallholderDateOption, type EventStallholdersData, FUTURE_EVENT_DATE_STATUSES, type GetEventStallholdersDataInput, type GetVendorEventsDataInput, INITIAL_BILLING_CATALOG, IOS_URL, MANUAL_DATE_STATUSES, NETWORK_USER_FACING_ERROR, NZ_TZ, PRESERVED_RELATION_DATE_STATUSES, PostTypeLabels, SCHOOL_MAX_STUDENT_COUNT, SCHOOL_MIN_STUDENT_COUNT, type StallholderFilterOption, type VendorEventDateOption, type VendorEventsData, accumulateItems, availableRegionOptions, availableRegionTypes, billingCatalogDefinitionMatches, buildCalendarSheetContentData, buildRelationEligibleEventSchedule, capitalizeFirstLetter, cluemartSocialMedia, collectStallholderDateTimes, collectVendorEventRelationDateTimes, computeDailyClueState, computeHasMore, countLetterOccurrences, countLetterOccurrencesUpTo, createAffiliateReward, dateFormat, defaultGetId, eventHasSelectedDate, eventMatchesDateStatusPeriod, eventStartDatesSet, filterDatesByFutureStatus, filterEventsByDateStatusPeriod, filterRegisteredVendorsByEventDatesOnly, filterRegisteredVendorsForEvent, filterUnregisteredVendorsByEventDatesOnly, filterUnregisteredVendorsForEvent, filterVendorEventsBySelectedDate, findEventDateTimeByIsoDate, formatDate, formatDistance, formatIrdNumber, formatNZBankAccount, formatTimestamp, fromCalendarIsoDate, futureTimePeriods, getAllowedEventDateStatuses, getBillingCatalogKeyForSelection, getCurrentAndFutureDates, getDailyClueDayIndex, getDistanceInKilometers, getDistanceInMeters, getErrorMessage, getEventCalendarIsoDates, getEventScheduleStatusLabel, getEventScheduleStatusPresentation, getEventScheduleStatusTone, getEventStallholderEmptyMessage, getEventStallholdersData, getFutureEventStatus, getRegisteredVendorCategoryNames, getRegisteredVendorStartDates, getStallholderCategoryNames, getStallholderCategoryOptions, getUniqueStallholderStartDates, getUniqueStartDates, getUnregisteredVendorCategoryNames, getUnregisteredVendorStartDates, getVendorEventRelationDateOptions, getVendorEventRelationStartDates, getVendorEventsData, getVendorEventsEmptyMessage, hasMatchingEventDate, isFutureDatesBeforeThreshold, isFutureEventDateStatus, isFutureStartDate, isInternalErrorMessage, isIsoDateString, isResourceImageActive, isTransientNetworkError, isUtcMidnight, isValidIrdNumber, isoDateFormat, licenseNiceNames, mapArrayToOptions, matchesCategory, matchesSelectedDate, normalizeIrdNumber, normalizeResourceImage, normalizeUrl, nzDayKey, nzStartOfDay, paymentMethodOptions, relationHasSelectedDate, removeTypename, resolveResourceImageActive, rewardNiceNames, seededShuffle, shouldShowEventActionsWithWeather, sortDatesChronologically, statusOptions, sumUserOverallPoints, timeFormat, toCalendarIsoDate, toNZTime, toUserFacingErrorMessage, truncateText, updateSingleDateTimeStatus, vendorLicences };
+export { AD_METRIC_IMPRESSION_RETRY_DELAY_MS, AD_METRIC_ROTATION_INTERVAL_MS, 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_LABELS, EVENT_DATE_STATUS_PERIOD_MAP, type EventScheduleStatusPresentation, type EventScheduleStatusTone, type EventStallholderDateOption, type EventStallholdersData, FUTURE_EVENT_DATE_STATUSES, type GetEventStallholdersDataInput, type GetVendorEventsDataInput, INITIAL_BILLING_CATALOG, IOS_URL, MANUAL_DATE_STATUSES, NETWORK_USER_FACING_ERROR, NZ_TZ, PRESERVED_RELATION_DATE_STATUSES, PostTypeLabels, SCHOOL_MAX_STUDENT_COUNT, SCHOOL_MIN_STUDENT_COUNT, type StallholderFilterOption, type VendorEventDateOption, type VendorEventsData, accumulateItems, availableRegionOptions, availableRegionTypes, billingCatalogDefinitionMatches, buildAdMetricSlotKey, buildCalendarSheetContentData, buildRelationEligibleEventSchedule, capitalizeFirstLetter, cluemartSocialMedia, collectStallholderDateTimes, collectVendorEventRelationDateTimes, computeDailyClueState, computeHasMore, countLetterOccurrences, countLetterOccurrencesUpTo, createAffiliateReward, dateFormat, defaultGetId, eventHasSelectedDate, eventMatchesDateStatusPeriod, eventStartDatesSet, filterDatesByFutureStatus, filterEventsByDateStatusPeriod, filterRegisteredVendorsByEventDatesOnly, filterRegisteredVendorsForEvent, filterUnregisteredVendorsByEventDatesOnly, filterUnregisteredVendorsForEvent, filterVendorEventsBySelectedDate, findEventDateTimeByIsoDate, formatDate, formatDistance, formatIrdNumber, formatNZBankAccount, formatTimestamp, fromCalendarIsoDate, futureTimePeriods, generateAdClickId, getAdMetricRotationIndex, getAdMetricRotationSlot, getAllowedEventDateStatuses, getBillingCatalogKeyForSelection, getCurrentAndFutureDates, getDailyClueDayIndex, getDistanceInKilometers, getDistanceInMeters, getErrorMessage, getEventCalendarIsoDates, getEventScheduleStatusLabel, getEventScheduleStatusPresentation, getEventScheduleStatusTone, getEventStallholderEmptyMessage, getEventStallholdersData, getFutureEventStatus, getRegisteredVendorCategoryNames, getRegisteredVendorStartDates, getStallholderCategoryNames, getStallholderCategoryOptions, getUniqueStallholderStartDates, getUniqueStartDates, getUnregisteredVendorCategoryNames, getUnregisteredVendorStartDates, getVendorEventRelationDateOptions, getVendorEventRelationStartDates, getVendorEventsData, getVendorEventsEmptyMessage, hasMatchingEventDate, isFutureDatesBeforeThreshold, isFutureEventDateStatus, isFutureStartDate, isInternalErrorMessage, isIsoDateString, isResourceImageActive, isTransientNetworkError, isUtcMidnight, isValidIrdNumber, isoDateFormat, licenseNiceNames, mapArrayToOptions, matchesCategory, matchesSelectedDate, normalizeIrdNumber, normalizeResourceImage, normalizeUrl, nzDayKey, nzStartOfDay, paymentMethodOptions, relationHasSelectedDate, removeTypename, resolveResourceImageActive, rewardNiceNames, seededShuffle, shouldShowEventActionsWithWeather, sortDatesChronologically, statusOptions, sumUserOverallPoints, timeFormat, toCalendarIsoDate, toNZTime, toUserFacingErrorMessage, truncateText, updateSingleDateTimeStatus, vendorLicences };

package/dist/utils/index.mjs

@@ -85,7 +85,7 @@ import {
   toUserFacingErrorMessage,
   truncateText,
   vendorLicences
-} from "../chunk-DEK7NF3O.mjs";
+} from "../chunk-NEOBS55J.mjs";
 import {
   formatDistance,
   getDistanceInKilometers,
@@ -128,13 +128,21 @@ import {
 } from "../chunk-RAYUJODN.mjs";
 import "../chunk-DQ7ZHIXW.mjs";
 import {
+  AD_METRIC_IMPRESSION_RETRY_DELAY_MS,
+  AD_METRIC_ROTATION_INTERVAL_MS,
   DEFAULT_PAGE_SIZE,
   accumulateItems,
+  buildAdMetricSlotKey,
   computeHasMore,
-  defaultGetId
-} from "../chunk-7DQBUZXY.mjs";
+  defaultGetId,
+  generateAdClickId,
+  getAdMetricRotationIndex,
+  getAdMetricRotationSlot
+} from "../chunk-YCUKTVVA.mjs";
 import "../chunk-A52C6JDT.mjs";
 export {
+  AD_METRIC_IMPRESSION_RETRY_DELAY_MS,
+  AD_METRIC_ROTATION_INTERVAL_MS,
   AFFILIATE_PARTICIPANT_TYPE_LABELS,
   AFFILIATE_REWARDS,
   ANDROID_URL,
@@ -164,6 +172,7 @@ export {
   availableRegionOptions,
   availableRegionTypes,
   billingCatalogDefinitionMatches,
+  buildAdMetricSlotKey,
   buildCalendarSheetContentData,
   buildRelationEligibleEventSchedule,
   capitalizeFirstLetter,
@@ -195,6 +204,9 @@ export {
   formatTimestamp,
   fromCalendarIsoDate,
   futureTimePeriods,
+  generateAdClickId,
+  getAdMetricRotationIndex,
+  getAdMetricRotationSlot,
   getAllowedEventDateStatuses,
   getBillingCatalogKeyForSelection,
   getCurrentAndFutureDates,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timardex/cluemart-shared",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",