@timardex/cluemart-shared 1.5.741 → 1.5.742

package/dist/index.d.ts

@@ -322,1025 +322,1029 @@ type EventInfoType = Omit<EventInfoFormData, "_id"> & {
     active?: boolean;
 };
 
-type VendorCalendarData = Omit<ResourceDetails, "dateTime" | "eventStatus"> & {
-    dateTime: DateTimeType;
-};
-type VendorProductList = {
-    description?: string | null;
-    name: string;
-    price: number;
-    priceUnit: string;
-    productGroups?: string[] | null;
-};
-interface VendorFormData extends BaseResourceTypeFormData {
-    availability?: {
-        school: boolean;
-        private: boolean;
-        corporate: boolean;
-    };
-    claimed?: boolean;
-    calendar?: {
-        active?: boolean | null;
-        calendarData?: VendorCalendarData[] | null;
-    } | null;
-    categories: Category[];
-    foodTruck: boolean;
-    products?: {
-        active?: boolean | null;
-        productsList?: VendorProductList[] | null;
-    } | null;
-    unregisteredVendorId?: string | null;
-    vendorType: EnumVendorType;
+declare enum EnumGameType {
+    DAILY_CLUE = "dailyClue",
+    MINI_QUIZ = "miniQuiz",
+    ODD_ONE_OUT = "oddOneOut"
 }
-type CreateVendorFormData = CreateFormData<VendorFormData>;
-type VendorAttributes = {
-    details?: string | null;
-    isRequired: boolean;
+type GameDate = {
+    startDate: Date;
+    endDate: Date;
 };
-type VendorInfoFormData = {
-    _id?: string;
-    compliance?: {
-        liabilityInsurance: boolean;
-        foodBeverageLicense: boolean;
-    };
-    documents?: ResourceImageType[] | null;
-    documentsUpload?: ResourceImageType[] | null;
-    product: {
-        foodFlavors: EnumFoodFlavor[];
-        packaging: string[];
-        priceRange: {
-            max: string;
-            min: string;
-        };
-        producedIn: string[];
-    };
-    requirements?: {
-        electricity: VendorAttributes;
-        gazebo: VendorAttributes;
-        table: VendorAttributes;
-    };
-    stallInfo: {
-        size: {
-            depth: string;
-            width: string;
-        };
-    };
-    vendorId: string;
+declare const gameTypeToDisplayName: Record<EnumGameType, string>;
+type GlobalGameData = {
+    points: number;
+    streak: number;
 };
-type CreateVendorInfoFormData = CreateFormData<VendorInfoFormData>;
-interface VendorType extends BaseResourceType {
-    availability?: {
-        school: boolean;
-        private: boolean;
-        corporate: boolean;
-    };
-    claimed: boolean;
-    calendar: VendorFormData["calendar"] | null;
-    categories: VendorFormData["categories"];
-    foodTruck: boolean;
-    products: VendorFormData["products"] | null;
-    vendorInfoId: string;
-    vendorType: EnumVendorType;
-    relations: {
-        relationId: string | null;
-        relationDates: RelationDate[] | null;
-    }[] | null;
-    unregisteredVendorId?: string | null;
-}
-type VendorInfoType = Omit<VendorInfoFormData, "_id" | "documentsUpload"> & {
-    _id: string;
-    active?: boolean;
+
+declare const gameScreenIdentifierList: readonly [{
+    readonly clue: "Where your actions turn into a timeline.";
+    readonly id: "activities";
+    readonly match: "/profile/activities";
+}, {
+    readonly clue: "Where conversations happen without speaking.";
+    readonly id: "chat";
+    readonly match: "/profile/chat";
+}, {
+    readonly clue: "The place to redefine who you are.";
+    readonly id: "edit-profile";
+    readonly match: "/profile/edit-profile";
+}, {
+    readonly clue: "A single moment worth showing up for.";
+    readonly id: "single-event";
+    readonly match: RegExp;
+}, {
+    readonly clue: "What’s happening around you, right now.";
+    readonly id: "events-near-me";
+    readonly match: "/events/events-near-me";
+}, {
+    readonly clue: "Where events appear as pins on a map.";
+    readonly id: "events-map";
+    readonly match: "/events/events-map";
+}, {
+    readonly clue: "A collection of events worth attending.";
+    readonly id: "events";
+    readonly match: "/events";
+}, {
+    readonly clue: "What’s happening in a wider area — not just nearby.";
+    readonly id: "events-region";
+    readonly match: RegExp;
+}, {
+    readonly clue: "Where fun becomes a challenge.";
+    readonly id: "games";
+    readonly match: "/games";
+}, {
+    readonly clue: "Your starting point for everything.";
+    readonly id: "home";
+    readonly match: "/";
+}, {
+    readonly clue: "Where the app whispers what you shouldn’t miss.";
+    readonly id: "notifications";
+    readonly match: "/notifications";
+}, {
+    readonly clue: "Where you fine-tune your experience.";
+    readonly id: "options";
+    readonly match: "/options";
+}, {
+    readonly clue: "An organisation or creator supporting the community.";
+    readonly id: "single-partner";
+    readonly match: RegExp;
+}, {
+    readonly clue: "Organisations and creators supporting the community.";
+    readonly id: "partners";
+    readonly match: "/partners";
+}, {
+    readonly clue: "A single published post in full view.";
+    readonly id: "single-visitor-post";
+    readonly match: RegExp;
+}, {
+    readonly clue: "Your identity, on display.";
+    readonly id: "profile";
+    readonly match: "/profile";
+}, {
+    readonly clue: "One stallholder offering something valuable.";
+    readonly id: "single-vendor";
+    readonly match: RegExp;
+}, {
+    readonly clue: "Where every stallholder waits under the right category.";
+    readonly id: "vendors";
+    readonly match: "/vendors";
+}, {
+    readonly clue: "Where you browse articles and posts from around the platform.";
+    readonly id: "visitors";
+    readonly match: "/visitors";
+}];
+type GamePlacement = (typeof gameScreenIdentifierList)[number]["id"];
+type GamePlacementClue = (typeof gameScreenIdentifierList)[number]["clue"];
+type DailyClueBaseGame = {
+    gameDate: GameDate;
+    gameSolution: string;
 };
-interface UnregisteredVendorFormData {
-    categoryIds: string[];
-    dateTime: DateTimeType[];
-    email?: string | null;
-    inviterId: string;
-    name: string;
-    region: string;
-}
-type CreateUnregisteredVendorFormData = CreateFormData<UnregisteredVendorFormData>;
-type UnregisteredVendorInvitationType = Pick<UnregisteredVendorFormData, "dateTime" | "inviterId">;
-type UnregisteredVendorType = Omit<UnregisteredVendorFormData, "dateTime" | "inviterId"> & {
-    _id: string;
-    active: boolean;
-    claimed: boolean;
-    claimedAt?: Date;
-    claimedByUserId?: string;
-    createdAt: Date;
-    deletedAt: Date | null;
-    invitations: UnregisteredVendorInvitationType[];
-    updatedAt: Date | null;
+type DailyClueGameData = GlobalGameData & {
+    gameFields: DailyClueBaseGame;
+    lastFoundDate: Date | null;
+    letterInfo: {
+        collected: string[] | null;
+        solutionShuffled: string[];
+        todaysClue: GamePlacementClue | null;
+        todaysLetter: string | null;
+        todaysPlacement: GamePlacement | null;
+    };
 };
 
-declare const PROMO_CODE_PREFIX = "CM-";
-type PromoCodeType = `${typeof PROMO_CODE_PREFIX}${string}`;
-type Nullable<T> = {
-    [K in keyof T]: T[K] | null | undefined;
+type PuzzleAnswer = {
+    answerId: string;
+    answer: string;
+    correct: boolean;
 };
-type DeviceInfo = {
-    appBuildNumber: string;
-    appId: string;
-    appVersion: string;
-    brand: string;
-    deviceName: string;
-    installationId: string;
-    manufacturer: string;
-    modelName: string;
-    osName: string;
-    osVersion: string;
-    timestamp: string;
+type PuzzleQuestion = {
+    answers: PuzzleAnswer[];
+    question: string;
+    questionId: string;
 };
-type TermsAgreement = DeviceInfo & {
-    termVersion: string;
+/**
+ * Stores only the answerId  and the questionId of the selected answer.
+ */
+type PuzzleAnsweredQuestion = {
+    selectedAnswerId: string;
+    questionId: string;
 };
-type ResourceContactDetailsType = {
-    email?: string | null;
-    landlinePhone?: string | null;
-    mobilePhone?: string | null;
+type PuzzleBaseGame = {
+    questions: PuzzleQuestion[];
 };
-type ResourceImageType = {
-    active?: boolean | null;
-    source: string;
-    title: string;
+type PuzzleGameData = GlobalGameData & {
+    gameFields: PuzzleBaseGame;
+    /**
+     * Stores user answers only.
+     * Never store correctness from client.
+     */
+    answeredQuestions: PuzzleAnsweredQuestion[];
 };
-type SocialMediaType = {
-    name?: EnumSocialMedia;
-    link?: string;
+
+type BaseGameMap = {
+    [EnumGameType.DAILY_CLUE]: DailyClueBaseGame;
+    [EnumGameType.MINI_QUIZ]: PuzzleBaseGame;
+    [EnumGameType.ODD_ONE_OUT]: PuzzleBaseGame;
 };
-type UserLicenceType = {
-    expiryDate: Date;
-    issuedDate: Date;
-    licenceType: EnumUserLicence;
-    prevLicenceType?: EnumUserLicence | null;
+type BaseGameType = {
+    gameType: EnumGameType;
+    gameTypeId: string;
+    gameTitle: string;
+} & {
+    [K in keyof BaseGameMap]?: BaseGameMap[K] | null;
 };
-type AssociateType = {
-    email: string;
-    resourceId: string;
-    resourceType: EnumResourceType;
-    licence: UserLicenceType;
+declare enum EnumGameStatus {
+    GAME_COMPLETED = "GAME_COMPLETED",
+    GAME_IN_PROGRESS = "GAME_IN_PROGRESS",
+    GAME_LEFT = "GAME_LEFT",
+    GAME_STARTED = "GAME_STARTED"
+}
+type GameHistory = Pick<BaseGameType, "gameTitle" | "gameType" | "gameTypeId"> & {
+    createdAt: Date;
+    gameDate: GameDate;
+    gameStatus: EnumGameStatus;
+    /** Per-event delta. Not persisted for overallGamePoints (computed at read time). */
+    pointsEarned: number;
+    /** Running total for this game instance; computed at read time, not stored in Mongo. */
+    overallGamePoints?: number;
 };
-type OwnerType = {
-    email: string;
-    userId: string;
+type GameDataMap = {
+    [EnumGameType.DAILY_CLUE]: DailyClueGameData;
+    [EnumGameType.MINI_QUIZ]: PuzzleGameData;
+    [EnumGameType.ODD_ONE_OUT]: PuzzleGameData;
 };
-interface BaseResourceTypeFormData {
-    _id?: string;
+type GameDataType = {
+    [K in keyof GameDataMap]?: GameDataMap[K] | null;
+};
+type GameType = Pick<BaseGameType, "gameTitle" | "gameType" | "gameTypeId"> & {
+    _id: string;
     active: boolean;
-    associates: AssociateType[] | null;
-    contactDetails: ResourceContactDetailsType | null;
-    cover: ResourceImageType;
-    coverUpload?: ResourceImageType | null;
-    description: string;
-    images?: ResourceImageType[] | null;
-    imagesUpload?: ResourceImageType[] | null;
-    logo?: ResourceImageType | null;
-    logoUpload?: ResourceImageType | null;
-    name: string;
-    owner?: OwnerType | null;
-    promoCodes?: PromoCodeType[] | null;
-    region: string;
-    socialMedia: SocialMediaType[] | null;
-    termsAgreement?: TermsAgreement | null;
-}
-type PosterUsageType = {
-    month: string;
-    count: number;
+    createdAt: Date;
+    gameData: GameDataType;
+    gameHistory: GameHistory[] | null;
+    updatedAt: Date | null;
 };
-type BaseResourceType = Omit<BaseResourceTypeFormData, "_id" | "coverUpload" | "imagesUpload" | "logoUpload"> & {
+type GameDocType = {
     _id: string;
-    adIds?: string[] | null;
+    active: boolean;
     createdAt: Date;
     deletedAt: Date | null;
-    posterUsage?: PosterUsageType | null;
-    rating?: number | null;
-    reviewCount?: number | null;
+    games: GameType[] | null;
+    owner: OwnerType;
+    points: number;
     updatedAt: Date | null;
 };
-type LocationGeoType = {
-    coordinates: number[];
-    type: "Point";
-};
-type LocationType = {
-    city: string;
-    country: string;
-    fullAddress: string;
-    geo: LocationGeoType;
-    latitude: number;
-    longitude: number;
-    region: string;
-};
-type DateTimeType = {
-    dateStatus: EnumEventDateStatus;
-    endDate: string;
-    endTime: string;
-    startDate: string;
-    startTime: string;
-};
-type Region = {
-    latitude: number;
-    latitudeDelta: number;
-    longitude: number;
-    longitudeDelta: number;
-};
-type ResourceDetails = {
-    dateTime: DateTimeType[] | null;
-    description: string | null;
-    eventStatus?: EventStatusType | null;
-    location: LocationType | null;
-    resourceCover: ResourceImageType | null;
-    resourceId: string;
-    resourceLogo: ResourceImageType | null;
-    resourceName: string;
-    resourceType: EnumResourceType;
-};
-type GeocodeLocation = Pick<LocationType, "latitude" | "longitude">;
-type EventStatusType = {
-    claimed: boolean;
-    eventType: EnumEventType;
-    googlePlaceId?: string | null;
+type GameLeaderboard = {
+    gameHistory: GameHistory[] | null;
+    overallPoints: number;
+    owner: OwnerType;
 };
-interface FormField {
-    disabled?: boolean;
-    helperText?: string;
-    isTextArea?: boolean;
-    keyboardType?: "default" | "email-address" | "number-pad" | "url" | "decimal-pad" | "phone-pad";
-    name: string;
-    placeholder: string;
-    required?: boolean;
-    secureTextEntry?: boolean;
-}
-interface FormDateField {
-    dateMode: "date" | "time";
-    helperText?: string;
-    name: "endDate" | "endTime" | "startDate" | "startTime";
-    placeholder: string;
-}
-interface SubcategoryItems {
-    id: string;
-    name: string;
-    description?: string | null;
-}
-interface Subcategory {
-    id: string;
-    name: string;
-    items?: SubcategoryItems[] | null;
+
+declare enum EnumPostType {
+    MARKET_FACES = "market_faces",
+    CLUE_BITES = "clue_bites",
+    PLAY_AND_WIN = "play_and_win"
 }
-interface Category {
-    color?: string | null;
-    description?: string | null;
-    id: string;
-    name: string;
-    subcategories: Subcategory[];
+declare enum EnumPostContentType {
+    GAME = "game",
+    IMAGE = "image",
+    LIST = "list",
+    TEXTAREA = "textarea",
+    VIDEO = "video"
 }
-type OptionItem = {
-    value: string;
-    label: string;
+type PostFileInput = {
+    source: File;
+    title?: string;
 };
-type ImageObjectType = {
-    uri: string;
-    type: string;
-    name: string;
+type PostContentTextarea = {
+    textarea: {
+        title?: string;
+        data: string;
+    };
 };
-interface ResourceConnectionsType {
-    events: EventListItemType[] | null;
-    vendors: VendorType[] | null;
-}
-interface CreateFormData<T extends FieldValues> {
-    control: Control<T, any>;
-    fields: T;
-    formState: FormState<T>;
-    handleSubmit: UseFormHandleSubmit<T, any>;
-    reset: UseFormReset<T>;
-    setValue: UseFormSetValue<T>;
-    watch: UseFormWatch<T>;
-    getValues: UseFormGetValues<T>;
-}
-interface UseGetResourcesByRegionOptions {
-    onlyClaimed?: boolean;
-    limit?: number;
-    offset?: number;
-}
-
-declare const vendorBasicInfoFields: FormField[];
-declare const vendorFullAddress: FormField;
-declare const vendorStartDateFields: FormDateField[];
-declare const vendorEndDateFields: FormDateField[];
-declare const vendorAvailability: FormField[];
-declare const vendorLocationDescription: FormField;
-declare const vendorMenuFields: FormField[];
-declare const productLabelGroups: {
-    category: string;
-    items: {
-        abbreviation: string;
-        fullName: string;
-    }[];
-}[];
-declare const priceUnits: OptionItem[];
-
-interface AdminUpdateResourceType {
-    active: boolean;
-    resourceId: string;
-    resourceType: EnumResourceType;
-}
-
-type UserFormData = {
-    _id?: string;
-    active: boolean;
-    avatar?: ResourceImageType | null;
-    avatarUpload?: ResourceImageType | null;
-    confirmPassword?: string | null;
-    email: string;
-    firstName: string;
-    isTester: boolean;
-    lastName: string;
-    location?: LocationType | null;
-    password?: string | null;
-    platform?: EnumOSPlatform;
-    preferredRegion: string;
-    role: EnumUserRole;
-    termsAgreement?: TermsAgreement | null;
+type PostContentImage = {
+    images: ResourceImageType[] | null;
+    imagesUpload?: PostFileInput[] | null;
+};
+type PostContentVideo = {
+    video: {
+        source: string;
+        title?: string;
+    };
+};
+type PostContentList = {
+    list: {
+        title?: string;
+        items: {
+            text: string;
+        }[];
+    };
 };
-type CreateUserFormData = CreateFormData<UserFormData>;
-type UserActivityEvent = {
-    resourceId: string;
-    dateTime: DateTimeType;
+type PostContentGame = {
+    game: BaseGameType;
 };
-type StripeSubscription = {
-    customerId?: string;
-    subscriptionId?: string;
-    status?: EnumSubscriptionStatus;
-    currentPlan?: EnumUserLicence;
-    startDate?: string;
-    endDate?: string;
+type PostContentData = PostContentGame | PostContentTextarea | PostContentImage | PostContentVideo | PostContentList;
+type PostContentFormData = {
+    contentData?: PostContentData | null;
+    contentOrder?: number | null;
+    contentType?: EnumPostContentType | null;
 };
-type SubscriptionStatusData = {
-    subscriptionId: string | null;
-    status: EnumSubscriptionStatus;
-    priceId: string | null;
-    currentPlan: EnumUserLicence | null;
+interface PostFormData {
+    active: boolean;
+    caption: string;
+    content: PostContentFormData[];
+    cover?: ResourceImageType | null;
+    coverUpload?: PostFileInput | null;
+    postType: EnumPostType;
+    resource?: {
+        resourceId: string;
+        resourceType: EnumResourceType;
+        resourceRegion: string;
+    } | null;
+    tags?: string[] | null;
+    title: string;
+    notifyUsers?: boolean | null;
+}
+type CreatePostFormData = CreateFormData<PostFormData>;
+type PostContentType = Omit<PostContentFormData, "contentData"> & {
+    contentData: Omit<PostContentData, "imagesUpload">;
 };
-type SubscriptionPricingData = {
-    basePrice: number;
-    discountedPrice: number | null;
-    hasDiscount: boolean;
-    discountPercent: number | null;
-    discountAmount: number | null;
-    currency: string;
-    formattedBasePrice: string;
-    formattedDiscountedPrice: string | null;
+type PostType = Omit<PostFormData, "content" | "coverUpload"> & {
+    _id: string;
+    content: PostContentType[];
+    createdAt: Date;
+    deletedAt: Date | null;
+    updatedAt: Date | null;
 };
-type SubscriptionPlanData = {
+
+type VendorCalendarData = Omit<ResourceDetails, "dateTime" | "eventStatus"> & {
+    dateTime: DateTimeType;
+};
+type VendorProductList = {
+    description?: string | null;
     name: string;
-    description: string | null;
-    licenceType: EnumUserLicence;
-    billingPeriod: string;
-    stripeProductId: string;
-    stripePriceId: string;
-    isEligibleForDiscount: boolean;
-    pricing: SubscriptionPricingData;
+    price: number;
+    priceUnit: string;
+    productGroups?: string[] | null;
 };
-type SubscriptionPlansResponse = {
-    plans: SubscriptionPlanData[];
-    isNewUser: boolean;
-    isTester: boolean;
-    appliedDiscountType: string;
+interface VendorFormData extends BaseResourceTypeFormData {
+    availability?: {
+        school: boolean;
+        private: boolean;
+        corporate: boolean;
+    };
+    claimed?: boolean;
+    calendar?: {
+        active?: boolean | null;
+        calendarData?: VendorCalendarData[] | null;
+    } | null;
+    categories: Category[];
+    foodTruck: boolean;
+    products?: {
+        active?: boolean | null;
+        productsList?: VendorProductList[] | null;
+    } | null;
+    unregisteredVendorId?: string | null;
+    vendorType: EnumVendorType;
+}
+type CreateVendorFormData = CreateFormData<VendorFormData>;
+type VendorAttributes = {
+    details?: string | null;
+    isRequired: boolean;
 };
-type UserActivity = {
-    favourites: {
-        events: string[];
-        vendors: string[];
-        partners: string[];
+type VendorInfoFormData = {
+    _id?: string;
+    compliance?: {
+        liabilityInsurance: boolean;
+        foodBeverageLicense: boolean;
     };
-    going: {
-        events: UserActivityEvent[];
+    documents?: ResourceImageType[] | null;
+    documentsUpload?: ResourceImageType[] | null;
+    product: {
+        foodFlavors: EnumFoodFlavor[];
+        packaging: string[];
+        priceRange: {
+            max: string;
+            min: string;
+        };
+        producedIn: string[];
     };
-    interested: {
-        events: UserActivityEvent[];
+    requirements?: {
+        electricity: VendorAttributes;
+        gazebo: VendorAttributes;
+        table: VendorAttributes;
     };
-    present: {
-        events: UserActivityEvent[];
+    stallInfo: {
+        size: {
+            depth: string;
+            width: string;
+        };
     };
+    vendorId: string;
 };
-type RedeemRewardInput = {
-    reward: EnumReward;
-};
-type RedeemRewardResponse = {
-    userId: string;
-    message: string;
-};
-type RedeemedReward = {
-    name: EnumReward;
-    pointsUsed: number;
-    redeemedAt: Date;
+type CreateVendorInfoFormData = CreateFormData<VendorInfoFormData>;
+interface VendorType extends BaseResourceType {
+    availability?: {
+        school: boolean;
+        private: boolean;
+        corporate: boolean;
+    };
+    claimed: boolean;
+    calendar: VendorFormData["calendar"] | null;
+    categories: VendorFormData["categories"];
+    foodTruck: boolean;
+    products: VendorFormData["products"] | null;
+    vendorInfoId: string;
+    vendorType: EnumVendorType;
+    relations: {
+        relationId: string | null;
+        relationDates: RelationDate[] | null;
+    }[] | null;
+    unregisteredVendorId?: string | null;
+}
+type VendorInfoType = Omit<VendorInfoFormData, "_id" | "documentsUpload"> & {
+    _id: string;
+    active?: boolean;
 };
-type UserType = Omit<UserFormData, "confirmPassword" | "avatarUpload" | "_id"> & {
+interface UnregisteredVendorFormData {
+    categoryIds: string[];
+    dateTime: DateTimeType[];
+    email?: string | null;
+    inviterId: string;
+    name: string;
+    region: string;
+}
+type CreateUnregisteredVendorFormData = CreateFormData<UnregisteredVendorFormData>;
+type UnregisteredVendorInvitationType = Pick<UnregisteredVendorFormData, "dateTime" | "inviterId">;
+type UnregisteredVendorType = Omit<UnregisteredVendorFormData, "dateTime" | "inviterId"> & {
     _id: string;
-    associates?: AssociateType[] | null;
+    active: boolean;
+    claimed: boolean;
+    claimedAt?: Date;
+    claimedByUserId?: string;
     createdAt: Date;
     deletedAt: Date | null;
-    events: string[] | null;
-    game: string | null;
-    licences: UserLicenceType[] | null;
-    overallPoints: number | null;
-    partner: string | null;
-    promoCodes?: PromoCodeType[] | null;
-    redeemedRewards?: RedeemedReward[] | null;
-    refreshToken: string | null;
-    school: string | null;
-    stripe?: StripeSubscription;
+    invitations: UnregisteredVendorInvitationType[];
     updatedAt: Date | null;
-    userActivity: UserActivity | null;
-    vendor: string | null;
-};
-type SafeUserType = Omit<UserType, "password" | "refreshToken">;
-type ResourceByUser = {
-    _id: string;
-    active: boolean;
-    logo: string;
-    name: string;
-    resourceType: EnumResourceType;
 };
 
-declare enum EnumVerificationType {
-    REGISTER = "register",
-    RESET_PASSWORD = "resetPassword"
-}
-type LoginFormData = {
-    email: string;
-    isAdminPage?: boolean;
-    password: string;
-    platform?: EnumOSPlatform;
-};
-type CreateLoginFormData = CreateFormData<LoginFormData>;
-type RegisterFormData = {
-    email: string;
-    firstName: string;
-    lastName: string;
-    password: string;
-    platform?: EnumOSPlatform;
-    preferredRegion: string;
-    promoCode?: PromoCodeType | null;
-    termsAgreement?: TermsAgreement | null;
-};
-type CreateRegisterFormData = CreateFormData<RegisterFormData>;
-type RequestPasswordResetFormData = {
-    email: string;
+declare const PROMO_CODE_PREFIX = "CM-";
+type PromoCodeType = `${typeof PROMO_CODE_PREFIX}${string}`;
+type Nullable<T> = {
+    [K in keyof T]: T[K] | null | undefined;
 };
-type CreateRequestPasswordResetFormData = CreateFormData<RequestPasswordResetFormData>;
-type ResetPasswordFormData = {
-    confirmPassword: string;
-    email: string;
-    password: string;
+type DeviceInfo = {
+    appBuildNumber: string;
+    appId: string;
+    appVersion: string;
+    brand: string;
+    deviceName: string;
+    installationId: string;
+    manufacturer: string;
+    modelName: string;
+    osName: string;
+    osVersion: string;
+    timestamp: string;
 };
-type CreateResetPasswordFormData = CreateFormData<ResetPasswordFormData>;
-type ValidateVerificationTokenFormData = {
-    email: string;
-    verificationToken: string;
-    verificationType?: EnumVerificationType;
+type TermsAgreement = DeviceInfo & {
+    termVersion: string;
 };
-type CreateValidateVerificationTokenFormData = CreateFormData<ValidateVerificationTokenFormData>;
-type AuthPayloadType = {
-    message: string;
-    token: string;
-    refreshToken: string | null;
-    user: SafeUserType;
+type ResourceContactDetailsType = {
+    email?: string | null;
+    landlinePhone?: string | null;
+    mobilePhone?: string | null;
 };
-type RefreshTokenPayloadType = {
-    refreshToken: string;
-    token: string;
+type ResourceImageType = {
+    active?: boolean | null;
+    source: string;
+    title: string;
 };
-
-type ParticipantType = {
-    active: boolean;
-    isAssociate?: boolean | null;
-    userAvatar: string | null;
-    userEmail: string;
-    userId: string;
-    userName: string;
+type SocialMediaType = {
+    name?: EnumSocialMedia;
+    link?: string;
 };
-interface ChatMessageInput {
-    content: string;
-    replyToMessageId?: string | null;
-    senderId: string;
-}
-type ChatMessageReplyPreview = {
-    senderId: string;
-    senderName: string;
-    contentPreview: string;
+type UserLicenceType = {
+    expiryDate: Date;
+    issuedDate: Date;
+    licenceType: EnumUserLicence;
+    prevLicenceType?: EnumUserLicence | null;
 };
-type ChatMessageReaction = {
-    userId: string;
-    createdAt: Date;
+type AssociateType = {
+    email: string;
+    resourceId: string;
+    resourceType: EnumResourceType;
+    licence: UserLicenceType;
 };
-type ChatMessageSeen = {
+type OwnerType = {
+    email: string;
     userId: string;
-    seenAt: Date;
 };
-interface ChatMessageType {
+interface BaseResourceTypeFormData {
     _id?: string;
-    content: string;
-    createdAt?: Date;
-    replyToMessageId?: string | null;
-    replyPreview?: ChatMessageReplyPreview | null;
-    likedBy?: ChatMessageReaction[];
-    senderId: string;
-    seenBy?: ChatMessageSeen[];
-    updatedAt?: Date;
-}
-interface ChatType {
-    _id: string;
     active: boolean;
-    chatDescription?: string | null;
-    chatName: string;
-    chatType: EnumChatType;
-    createdAt: Date;
-    deletedAt: Date | null;
-    messages: ChatMessageType[];
-    participants: ParticipantType[];
-    region: string | null;
-    updatedAt: Date | null;
+    associates: AssociateType[] | null;
+    contactDetails: ResourceContactDetailsType | null;
+    cover: ResourceImageType;
+    coverUpload?: ResourceImageType | null;
+    description: string;
+    images?: ResourceImageType[] | null;
+    imagesUpload?: ResourceImageType[] | null;
+    logo?: ResourceImageType | null;
+    logoUpload?: ResourceImageType | null;
+    name: string;
+    owner?: OwnerType | null;
+    promoCodes?: PromoCodeType[] | null;
+    region: string;
+    socialMedia: SocialMediaType[] | null;
+    termsAgreement?: TermsAgreement | null;
 }
-interface ReportChatUser {
+type PosterUsageType = {
+    month: string;
+    count: number;
+};
+type BaseResourceType = Omit<BaseResourceTypeFormData, "_id" | "coverUpload" | "imagesUpload" | "logoUpload"> & {
     _id: string;
-    chatId: string;
+    adIds?: string[] | null;
     createdAt: Date;
-    reason: {
-        reasonType: EnumChatReportReason;
-        details: string | null;
-    };
-    reportedUserId: string;
-    reporterUserId: string;
-    resolved: boolean;
+    deletedAt: Date | null;
+    posterUsage?: PosterUsageType | null;
+    rating?: number | null;
+    reviewCount?: number | null;
     updatedAt: Date | null;
-}
-
-type ContactUsFormData = {
-    email: string;
-    firstName: string;
-    lastName: string;
-    message: string;
+    relatedPost?: {
+        postId: string;
+        postType: EnumPostType;
+    } | null;
 };
-type CreateContactUsFormData = CreateFormData<ContactUsFormData>;
-
-interface NotificationDataType {
-    resourceId: string;
-    resourceName: string;
-    resourceType: EnumNotificationResourceType;
-}
-type NotificationType = {
-    _id: string;
-    userId: string;
-    title: string;
-    message: string;
-    isRead: boolean;
-    type: EnumNotificationType;
-    data: NotificationDataType | null;
-    createdAt: Date;
-    updatedAt: Date;
+type LocationGeoType = {
+    coordinates: number[];
+    type: "Point";
 };
-type NotificationCount = {
-    total: number;
-    unread: number;
+type LocationType = {
+    city: string;
+    country: string;
+    fullAddress: string;
+    geo: LocationGeoType;
+    latitude: number;
+    longitude: number;
+    region: string;
 };
-type CreateBulkNotificationInput = {
-    data: NotificationDataType | null;
-    message: string;
-    title: string;
-    type: EnumNotificationType;
-    userIds: string[];
+type DateTimeType = {
+    dateStatus: EnumEventDateStatus;
+    endDate: string;
+    endTime: string;
+    startDate: string;
+    startTime: string;
 };
-
-declare const PKG: "@timardex/cluemart-shared";
-declare const IMAGE_EXTENSION: ".webp";
-/**
- * Basenames under the shared images directory — use with `getSharedImagePath` from `@timardex/cluemart-shared/images/node` (Express / Node).
- * This object is the single source of poster keys; `posters` is derived from it. Add an image with `IMAGE_EXTENSION` under `src/images/posters/` when adding an entry.
- * `images/node` reads this at runtime for `getSharedImagePath` allow-listing.
- */
-declare const posterIds: readonly ["mini-market1", "mini-market2", "mini-market3", "mini-market4", "mini-market5", "poster1", "poster2", "poster3", "poster4"];
-declare const posterFiles: { readonly [K in (typeof posterIds)[number]]: `${K}${typeof IMAGE_EXTENSION}`; };
-/**
- * Basenames for assets under `src/images/clui/` in source; they are copied flat into `dist/images/` (same as posters).
- * `images/node` reads this at runtime for `getSharedImagePath` allow-listing.
- */
-declare const cluiIds: readonly ["cluiTui", "sima", "tablas", "telefonos", "ugralos"];
-declare const cluiFiles: { readonly [K in (typeof cluiIds)[number]]: `${K}${typeof IMAGE_EXTENSION}`; };
-declare const iconIds: readonly ["apple-maps-icon", "facebook", "google-maps-icon", "instagram", "meet", "poll", "tiktok", "tip", "waze-maps-icon", "website", "youtube"];
-declare const iconFiles: { readonly [K in (typeof iconIds)[number]]: `${K}${typeof IMAGE_EXTENSION}`; };
-declare const badgeIds: readonly ["corporate", "private", "school"];
-declare const badgeFiles: { readonly [K in (typeof badgeIds)[number]]: `${K}${typeof IMAGE_EXTENSION}`; };
-declare const logoIds: readonly ["googleMaps-logo-dark", "googleMaps-logo-light", "logo-atr", "logo-dark", "logo"];
-declare const logoFiles: { readonly [K in (typeof logoIds)[number]]: `${K}${typeof IMAGE_EXTENSION}`; };
-declare const otherImagesIds: readonly ["banner-horizontal", "banner-vertical", "gazebo-top", "qr-code", "store-android", "store-ios"];
-declare const otherImagesFiles: { readonly [K in (typeof otherImagesIds)[number]]: `${K}${typeof IMAGE_EXTENSION}`; };
-/**
- * Module specifiers for each poster (not resolved file URLs). Use a static import or require with these paths
- * so your bundler resolves the file, e.g.
- * `import poster1 from "@timardex/cluemart-shared/images/poster1.webp"`
- * or `require("@timardex/cluemart-shared/images/poster1.webp")` (React Native / Metro).
- *
- * Derived from `posterFiles` so keys and filenames stay aligned.
- */
-declare const posters: { readonly [K in keyof typeof posterFiles]: `${typeof PKG}/images/${(typeof posterFiles)[K]}`; };
-/**
- * Module specifiers for Clui assets (same flat `@…/images/<file>.webp` pattern as posters), e.g.
- * `import clui from "@timardex/cluemart-shared/images/cluiTui.webp"`.
- */
-declare const cluiImages: { readonly [K in keyof typeof cluiFiles]: `${typeof PKG}/images/${(typeof cluiFiles)[K]}`; };
-declare const icons: { readonly [K in keyof typeof iconFiles]: `${typeof PKG}/images/${(typeof iconFiles)[K]}`; };
-declare const badges: { readonly [K in keyof typeof badgeFiles]: `${typeof PKG}/images/${(typeof badgeFiles)[K]}`; };
-declare const logos: { readonly [K in keyof typeof logoFiles]: `${typeof PKG}/images/${(typeof logoFiles)[K]}`; };
-declare const otherImages: { readonly [K in keyof typeof otherImagesFiles]: `${typeof PKG}/images/${(typeof otherImagesFiles)[K]}`; };
-type PosterAssetId = keyof typeof posters;
-/** A single filename under the shared images directory (values of `posterFiles`). */
-type PosterImageBasename = (typeof posterFiles)[PosterAssetId];
-type CluiImageId = keyof typeof cluiImages;
-/** Basename under the shared images directory (values of `cluiFiles`). */
-type CluiImageBasename = (typeof cluiFiles)[CluiImageId];
-type IconId = keyof typeof icons;
-type IconBasename = (typeof iconFiles)[IconId];
-type BadgeId = keyof typeof badges;
-type BadgeBasename = (typeof badgeFiles)[BadgeId];
-type LogoId = keyof typeof logos;
-type LogoBasename = (typeof logoFiles)[LogoId];
-type OtherImagesId = keyof typeof otherImages;
-type OtherImagesBasename = (typeof otherImagesFiles)[OtherImagesId];
-
-interface PosterInputType {
-    description: string;
-    posterName: PosterAssetId;
+type Region = {
+    latitude: number;
+    latitudeDelta: number;
+    longitude: number;
+    longitudeDelta: number;
+};
+type ResourceDetails = {
+    dateTime: DateTimeType[] | null;
+    description: string | null;
+    eventStatus?: EventStatusType | null;
+    location: LocationType | null;
+    resourceCover: ResourceImageType | null;
     resourceId: string;
+    resourceLogo: ResourceImageType | null;
+    resourceName: string;
     resourceType: EnumResourceType;
+};
+type GeocodeLocation = Pick<LocationType, "latitude" | "longitude">;
+type EventStatusType = {
+    claimed: boolean;
+    eventType: EnumEventType;
+    googlePlaceId?: string | null;
+};
+interface FormField {
+    disabled?: boolean;
+    helperText?: string;
+    isTextArea?: boolean;
+    keyboardType?: "default" | "email-address" | "number-pad" | "url" | "decimal-pad" | "phone-pad";
+    name: string;
+    placeholder: string;
+    required?: boolean;
+    secureTextEntry?: boolean;
 }
-
-declare enum EnumAdShowOn {
-    EVENTS_PAGE = "Events_page",
-    FRONT_PAGE = "Front_page",
-    PARTNERS_PAGE = "Partners_page",
-    VENDORS_PAGE = "Vendors_page"
+interface FormDateField {
+    dateMode: "date" | "time";
+    helperText?: string;
+    name: "endDate" | "endTime" | "startDate" | "startTime";
+    placeholder: string;
 }
-declare enum EnumAdStatus {
-    ACTIVE = "Active",
-    PAUSED = "Paused",
-    EXPIRED = "Expired"
+interface SubcategoryItems {
+    id: string;
+    name: string;
+    description?: string | null;
 }
-declare enum EnumAdType {
-    SPONSORED = "Sponsored",
-    FREE = "Free"
+interface Subcategory {
+    id: string;
+    name: string;
+    items?: SubcategoryItems[] | null;
 }
-declare enum EnumAdStyle {
-    BLOOM = "Bloom",
-    RISE = "Rise"
+interface Category {
+    color?: string | null;
+    description?: string | null;
+    id: string;
+    name: string;
+    subcategories: Subcategory[];
 }
-type AdResource = {
-    adDescription: string;
-    adImage: string;
-    adStyle: EnumAdStyle;
-    adTitle: string;
-    adType: EnumAdType;
-    resourceId: string;
-    resourceName: string;
-    resourceRegion: string;
-    resourceType: EnumResourceType;
+type OptionItem = {
+    value: string;
+    label: string;
 };
-interface AdFormData {
-    active: boolean;
-    end: Date;
-    resource: AdResource;
-    showOn: EnumAdShowOn[];
-    start?: Date;
-    status: EnumAdStatus;
-    targetRegion: string[];
+type ImageObjectType = {
+    uri: string;
+    type: string;
+    name: string;
+};
+interface ResourceConnectionsType {
+    events: EventListItemType[] | null;
+    vendors: VendorType[] | null;
 }
-type AdFormState = AdFormData;
-type CreateAdFormData = CreateFormData<AdFormData>;
-type CreateAdFormState = CreateFormData<AdFormState>;
-interface AdType extends AdFormData {
-    _id: string;
-    clicks?: number;
-    createdAt: Date;
-    impressions?: number;
-    start: Date;
-    updatedAt: Date | null;
+interface CreateFormData<T extends FieldValues> {
+    control: Control<T, any>;
+    fields: T;
+    formState: FormState<T>;
+    handleSubmit: UseFormHandleSubmit<T, any>;
+    reset: UseFormReset<T>;
+    setValue: UseFormSetValue<T>;
+    watch: UseFormWatch<T>;
+    getValues: UseFormGetValues<T>;
+}
+interface UseGetResourcesByRegionOptions {
+    onlyClaimed?: boolean;
+    limit?: number;
+    offset?: number;
 }
 
-declare enum EnumActivity {
-    FAVORITE = "FAVORITE",
-    GOING = "GOING",
-    INTERESTED = "INTERESTED",
-    PRESENT = "PRESENT",
-    VIEW = "VIEW"
+declare const vendorBasicInfoFields: FormField[];
+declare const vendorFullAddress: FormField;
+declare const vendorStartDateFields: FormDateField[];
+declare const vendorEndDateFields: FormDateField[];
+declare const vendorAvailability: FormField[];
+declare const vendorLocationDescription: FormField;
+declare const vendorMenuFields: FormField[];
+declare const productLabelGroups: {
+    category: string;
+    items: {
+        abbreviation: string;
+        fullName: string;
+    }[];
+}[];
+declare const priceUnits: OptionItem[];
+
+interface AdminUpdateResourceType {
+    active: boolean;
+    resourceId: string;
+    resourceType: EnumResourceType;
 }
-type ResourceActivityEntry = {
-    activityType: EnumActivity;
-    location: LocationGeoType | null;
-    dateStatus?: EnumEventDateStatus | null;
-    startDate?: string | null;
-    startTime?: string | null;
-    timestamp: Date;
-    userAgent: EnumOSPlatform;
-    userId?: string | null;
+
+type UserFormData = {
+    _id?: string;
+    active: boolean;
+    avatar?: ResourceImageType | null;
+    avatarUpload?: ResourceImageType | null;
+    confirmPassword?: string | null;
+    email: string;
+    firstName: string;
+    isTester: boolean;
+    lastName: string;
+    location?: LocationType | null;
+    password?: string | null;
+    platform?: EnumOSPlatform;
+    preferredRegion: string;
+    role: EnumUserRole;
+    termsAgreement?: TermsAgreement | null;
 };
-type ResourceActivityType = {
-    _id: string;
-    resourceType: EnumResourceType;
+type CreateUserFormData = CreateFormData<UserFormData>;
+type UserActivityEvent = {
     resourceId: string;
-    activity: ResourceActivityEntry[];
+    dateTime: DateTimeType;
 };
-type ResourceActivityInputType = {
-    resourceId: string;
-    resourceType: EnumResourceType;
-    activity: Omit<ResourceActivityEntry, "timestamp">;
+type StripeSubscription = {
+    customerId?: string;
+    subscriptionId?: string;
+    status?: EnumSubscriptionStatus;
+    currentPlan?: EnumUserLicence;
+    startDate?: string;
+    endDate?: string;
 };
-
-interface PartnerFormData extends BaseResourceTypeFormData {
-    location: LocationType;
-    nzbn: string;
-    partnerType: EnumPartnerType;
-}
-type CreatePartnerFormData = CreateFormData<PartnerFormData>;
-interface PartnerType extends BaseResourceType {
-    location: LocationType;
-    nzbn: string;
-    partnerType: EnumPartnerType;
-}
-
-declare enum EnumGameType {
-    DAILY_CLUE = "dailyClue",
-    MINI_QUIZ = "miniQuiz",
-    ODD_ONE_OUT = "oddOneOut"
-}
-type GameDate = {
-    startDate: Date;
-    endDate: Date;
+type SubscriptionStatusData = {
+    subscriptionId: string | null;
+    status: EnumSubscriptionStatus;
+    priceId: string | null;
+    currentPlan: EnumUserLicence | null;
+};
+type SubscriptionPricingData = {
+    basePrice: number;
+    discountedPrice: number | null;
+    hasDiscount: boolean;
+    discountPercent: number | null;
+    discountAmount: number | null;
+    currency: string;
+    formattedBasePrice: string;
+    formattedDiscountedPrice: string | null;
+};
+type SubscriptionPlanData = {
+    name: string;
+    description: string | null;
+    licenceType: EnumUserLicence;
+    billingPeriod: string;
+    stripeProductId: string;
+    stripePriceId: string;
+    isEligibleForDiscount: boolean;
+    pricing: SubscriptionPricingData;
+};
+type SubscriptionPlansResponse = {
+    plans: SubscriptionPlanData[];
+    isNewUser: boolean;
+    isTester: boolean;
+    appliedDiscountType: string;
+};
+type UserActivity = {
+    favourites: {
+        events: string[];
+        vendors: string[];
+        partners: string[];
+    };
+    going: {
+        events: UserActivityEvent[];
+    };
+    interested: {
+        events: UserActivityEvent[];
+    };
+    present: {
+        events: UserActivityEvent[];
+    };
+};
+type RedeemRewardInput = {
+    reward: EnumReward;
+};
+type RedeemRewardResponse = {
+    userId: string;
+    message: string;
+};
+type RedeemedReward = {
+    name: EnumReward;
+    pointsUsed: number;
+    redeemedAt: Date;
+};
+type UserType = Omit<UserFormData, "confirmPassword" | "avatarUpload" | "_id"> & {
+    _id: string;
+    associates?: AssociateType[] | null;
+    createdAt: Date;
+    deletedAt: Date | null;
+    events: string[] | null;
+    game: string | null;
+    licences: UserLicenceType[] | null;
+    overallPoints: number | null;
+    partner: string | null;
+    promoCodes?: PromoCodeType[] | null;
+    redeemedRewards?: RedeemedReward[] | null;
+    refreshToken: string | null;
+    school: string | null;
+    stripe?: StripeSubscription;
+    updatedAt: Date | null;
+    userActivity: UserActivity | null;
+    vendor: string | null;
 };
-declare const gameTypeToDisplayName: Record<EnumGameType, string>;
-type GlobalGameData = {
-    points: number;
-    streak: number;
+type SafeUserType = Omit<UserType, "password" | "refreshToken">;
+type ResourceByUser = {
+    _id: string;
+    active: boolean;
+    logo: string;
+    name: string;
+    resourceType: EnumResourceType;
 };
 
-declare const gameScreenIdentifierList: readonly [{
-    readonly clue: "Where your actions turn into a timeline.";
-    readonly id: "activities";
-    readonly match: "/profile/activities";
-}, {
-    readonly clue: "Where conversations happen without speaking.";
-    readonly id: "chat";
-    readonly match: "/profile/chat";
-}, {
-    readonly clue: "The place to redefine who you are.";
-    readonly id: "edit-profile";
-    readonly match: "/profile/edit-profile";
-}, {
-    readonly clue: "A single moment worth showing up for.";
-    readonly id: "single-event";
-    readonly match: RegExp;
-}, {
-    readonly clue: "What’s happening around you, right now.";
-    readonly id: "events-near-me";
-    readonly match: "/events/events-near-me";
-}, {
-    readonly clue: "Where events appear as pins on a map.";
-    readonly id: "events-map";
-    readonly match: "/events/events-map";
-}, {
-    readonly clue: "A collection of events worth attending.";
-    readonly id: "events";
-    readonly match: "/events";
-}, {
-    readonly clue: "What’s happening in a wider area — not just nearby.";
-    readonly id: "events-region";
-    readonly match: RegExp;
-}, {
-    readonly clue: "Where fun becomes a challenge.";
-    readonly id: "games";
-    readonly match: "/games";
-}, {
-    readonly clue: "Your starting point for everything.";
-    readonly id: "home";
-    readonly match: "/";
-}, {
-    readonly clue: "Where the app whispers what you shouldn’t miss.";
-    readonly id: "notifications";
-    readonly match: "/notifications";
-}, {
-    readonly clue: "Where you fine-tune your experience.";
-    readonly id: "options";
-    readonly match: "/options";
-}, {
-    readonly clue: "An organisation or creator supporting the community.";
-    readonly id: "single-partner";
-    readonly match: RegExp;
-}, {
-    readonly clue: "Organisations and creators supporting the community.";
-    readonly id: "partners";
-    readonly match: "/partners";
-}, {
-    readonly clue: "A single published post in full view.";
-    readonly id: "single-visitor-post";
-    readonly match: RegExp;
-}, {
-    readonly clue: "Your identity, on display.";
-    readonly id: "profile";
-    readonly match: "/profile";
-}, {
-    readonly clue: "One stallholder offering something valuable.";
-    readonly id: "single-vendor";
-    readonly match: RegExp;
-}, {
-    readonly clue: "Where every stallholder waits under the right category.";
-    readonly id: "vendors";
-    readonly match: "/vendors";
-}, {
-    readonly clue: "Where you browse articles and posts from around the platform.";
-    readonly id: "visitors";
-    readonly match: "/visitors";
-}];
-type GamePlacement = (typeof gameScreenIdentifierList)[number]["id"];
-type GamePlacementClue = (typeof gameScreenIdentifierList)[number]["clue"];
-type DailyClueBaseGame = {
-    gameDate: GameDate;
-    gameSolution: string;
+declare enum EnumVerificationType {
+    REGISTER = "register",
+    RESET_PASSWORD = "resetPassword"
+}
+type LoginFormData = {
+    email: string;
+    isAdminPage?: boolean;
+    password: string;
+    platform?: EnumOSPlatform;
 };
-type DailyClueGameData = GlobalGameData & {
-    gameFields: DailyClueBaseGame;
-    lastFoundDate: Date | null;
-    letterInfo: {
-        collected: string[] | null;
-        solutionShuffled: string[];
-        todaysClue: GamePlacementClue | null;
-        todaysLetter: string | null;
-        todaysPlacement: GamePlacement | null;
-    };
+type CreateLoginFormData = CreateFormData<LoginFormData>;
+type RegisterFormData = {
+    email: string;
+    firstName: string;
+    lastName: string;
+    password: string;
+    platform?: EnumOSPlatform;
+    preferredRegion: string;
+    promoCode?: PromoCodeType | null;
+    termsAgreement?: TermsAgreement | null;
 };
-
-type PuzzleAnswer = {
-    answerId: string;
-    answer: string;
-    correct: boolean;
+type CreateRegisterFormData = CreateFormData<RegisterFormData>;
+type RequestPasswordResetFormData = {
+    email: string;
 };
-type PuzzleQuestion = {
-    answers: PuzzleAnswer[];
-    question: string;
-    questionId: string;
+type CreateRequestPasswordResetFormData = CreateFormData<RequestPasswordResetFormData>;
+type ResetPasswordFormData = {
+    confirmPassword: string;
+    email: string;
+    password: string;
 };
-/**
- * Stores only the answerId  and the questionId of the selected answer.
- */
-type PuzzleAnsweredQuestion = {
-    selectedAnswerId: string;
-    questionId: string;
+type CreateResetPasswordFormData = CreateFormData<ResetPasswordFormData>;
+type ValidateVerificationTokenFormData = {
+    email: string;
+    verificationToken: string;
+    verificationType?: EnumVerificationType;
 };
-type PuzzleBaseGame = {
-    questions: PuzzleQuestion[];
+type CreateValidateVerificationTokenFormData = CreateFormData<ValidateVerificationTokenFormData>;
+type AuthPayloadType = {
+    message: string;
+    token: string;
+    refreshToken: string | null;
+    user: SafeUserType;
 };
-type PuzzleGameData = GlobalGameData & {
-    gameFields: PuzzleBaseGame;
-    /**
-     * Stores user answers only.
-     * Never store correctness from client.
-     */
-    answeredQuestions: PuzzleAnsweredQuestion[];
+type RefreshTokenPayloadType = {
+    refreshToken: string;
+    token: string;
 };
 
-type BaseGameMap = {
-    [EnumGameType.DAILY_CLUE]: DailyClueBaseGame;
-    [EnumGameType.MINI_QUIZ]: PuzzleBaseGame;
-    [EnumGameType.ODD_ONE_OUT]: PuzzleBaseGame;
-};
-type BaseGameType = {
-    gameType: EnumGameType;
-    gameTypeId: string;
-    gameTitle: string;
-} & {
-    [K in keyof BaseGameMap]?: BaseGameMap[K] | null;
+type ParticipantType = {
+    active: boolean;
+    isAssociate?: boolean | null;
+    userAvatar: string | null;
+    userEmail: string;
+    userId: string;
+    userName: string;
 };
-declare enum EnumGameStatus {
-    GAME_COMPLETED = "GAME_COMPLETED",
-    GAME_IN_PROGRESS = "GAME_IN_PROGRESS",
-    GAME_LEFT = "GAME_LEFT",
-    GAME_STARTED = "GAME_STARTED"
+interface ChatMessageInput {
+    content: string;
+    replyToMessageId?: string | null;
+    senderId: string;
 }
-type GameHistory = Pick<BaseGameType, "gameTitle" | "gameType" | "gameTypeId"> & {
-    createdAt: Date;
-    gameDate: GameDate;
-    gameStatus: EnumGameStatus;
-    /** Per-event delta. Not persisted for overallGamePoints (computed at read time). */
-    pointsEarned: number;
-    /** Running total for this game instance; computed at read time, not stored in Mongo. */
-    overallGamePoints?: number;
+type ChatMessageReplyPreview = {
+    senderId: string;
+    senderName: string;
+    contentPreview: string;
 };
-type GameDataMap = {
-    [EnumGameType.DAILY_CLUE]: DailyClueGameData;
-    [EnumGameType.MINI_QUIZ]: PuzzleGameData;
-    [EnumGameType.ODD_ONE_OUT]: PuzzleGameData;
+type ChatMessageReaction = {
+    userId: string;
+    createdAt: Date;
 };
-type GameDataType = {
-    [K in keyof GameDataMap]?: GameDataMap[K] | null;
+type ChatMessageSeen = {
+    userId: string;
+    seenAt: Date;
 };
-type GameType = Pick<BaseGameType, "gameTitle" | "gameType" | "gameTypeId"> & {
+interface ChatMessageType {
+    _id?: string;
+    content: string;
+    createdAt?: Date;
+    replyToMessageId?: string | null;
+    replyPreview?: ChatMessageReplyPreview | null;
+    likedBy?: ChatMessageReaction[];
+    senderId: string;
+    seenBy?: ChatMessageSeen[];
+    updatedAt?: Date;
+}
+interface ChatType {
     _id: string;
     active: boolean;
+    chatDescription?: string | null;
+    chatName: string;
+    chatType: EnumChatType;
     createdAt: Date;
-    gameData: GameDataType;
-    gameHistory: GameHistory[] | null;
+    deletedAt: Date | null;
+    messages: ChatMessageType[];
+    participants: ParticipantType[];
+    region: string | null;
+    updatedAt: Date | null;
+}
+interface ReportChatUser {
+    _id: string;
+    chatId: string;
+    createdAt: Date;
+    reason: {
+        reasonType: EnumChatReportReason;
+        details: string | null;
+    };
+    reportedUserId: string;
+    reporterUserId: string;
+    resolved: boolean;
     updatedAt: Date | null;
+}
+
+type ContactUsFormData = {
+    email: string;
+    firstName: string;
+    lastName: string;
+    message: string;
 };
-type GameDocType = {
+type CreateContactUsFormData = CreateFormData<ContactUsFormData>;
+
+interface NotificationDataType {
+    resourceId: string;
+    resourceName: string;
+    resourceType: EnumNotificationResourceType;
+}
+type NotificationType = {
     _id: string;
-    active: boolean;
+    userId: string;
+    title: string;
+    message: string;
+    isRead: boolean;
+    type: EnumNotificationType;
+    data: NotificationDataType | null;
     createdAt: Date;
-    deletedAt: Date | null;
-    games: GameType[] | null;
-    owner: OwnerType;
-    points: number;
-    updatedAt: Date | null;
+    updatedAt: Date;
 };
-type GameLeaderboard = {
-    gameHistory: GameHistory[] | null;
-    overallPoints: number;
-    owner: OwnerType;
+type NotificationCount = {
+    total: number;
+    unread: number;
+};
+type CreateBulkNotificationInput = {
+    data: NotificationDataType | null;
+    message: string;
+    title: string;
+    type: EnumNotificationType;
+    userIds: string[];
 };
 
-declare enum EnumPostType {
-    MARKET_FACES = "market_faces",
-    CLUE_BITES = "clue_bites",
-    PLAY_AND_WIN = "play_and_win"
+declare const PKG: "@timardex/cluemart-shared";
+declare const IMAGE_EXTENSION: ".webp";
+/**
+ * Basenames under the shared images directory — use with `getSharedImagePath` from `@timardex/cluemart-shared/images/node` (Express / Node).
+ * This object is the single source of poster keys; `posters` is derived from it. Add an image with `IMAGE_EXTENSION` under `src/images/posters/` when adding an entry.
+ * `images/node` reads this at runtime for `getSharedImagePath` allow-listing.
+ */
+declare const posterIds: readonly ["mini-market1", "mini-market2", "mini-market3", "mini-market4", "mini-market5", "poster1", "poster2", "poster3", "poster4"];
+declare const posterFiles: { readonly [K in (typeof posterIds)[number]]: `${K}${typeof IMAGE_EXTENSION}`; };
+/**
+ * Basenames for assets under `src/images/clui/` in source; they are copied flat into `dist/images/` (same as posters).
+ * `images/node` reads this at runtime for `getSharedImagePath` allow-listing.
+ */
+declare const cluiIds: readonly ["cluiTui", "sima", "tablas", "telefonos", "ugralos"];
+declare const cluiFiles: { readonly [K in (typeof cluiIds)[number]]: `${K}${typeof IMAGE_EXTENSION}`; };
+declare const iconIds: readonly ["apple-maps-icon", "facebook", "google-maps-icon", "instagram", "meet", "poll", "tiktok", "tip", "waze-maps-icon", "website", "youtube"];
+declare const iconFiles: { readonly [K in (typeof iconIds)[number]]: `${K}${typeof IMAGE_EXTENSION}`; };
+declare const badgeIds: readonly ["corporate", "private", "school"];
+declare const badgeFiles: { readonly [K in (typeof badgeIds)[number]]: `${K}${typeof IMAGE_EXTENSION}`; };
+declare const logoIds: readonly ["googleMaps-logo-dark", "googleMaps-logo-light", "logo-atr", "logo-dark", "logo"];
+declare const logoFiles: { readonly [K in (typeof logoIds)[number]]: `${K}${typeof IMAGE_EXTENSION}`; };
+declare const otherImagesIds: readonly ["banner-horizontal", "banner-vertical", "gazebo-top", "qr-code", "store-android", "store-ios"];
+declare const otherImagesFiles: { readonly [K in (typeof otherImagesIds)[number]]: `${K}${typeof IMAGE_EXTENSION}`; };
+/**
+ * Module specifiers for each poster (not resolved file URLs). Use a static import or require with these paths
+ * so your bundler resolves the file, e.g.
+ * `import poster1 from "@timardex/cluemart-shared/images/poster1.webp"`
+ * or `require("@timardex/cluemart-shared/images/poster1.webp")` (React Native / Metro).
+ *
+ * Derived from `posterFiles` so keys and filenames stay aligned.
+ */
+declare const posters: { readonly [K in keyof typeof posterFiles]: `${typeof PKG}/images/${(typeof posterFiles)[K]}`; };
+/**
+ * Module specifiers for Clui assets (same flat `@…/images/<file>.webp` pattern as posters), e.g.
+ * `import clui from "@timardex/cluemart-shared/images/cluiTui.webp"`.
+ */
+declare const cluiImages: { readonly [K in keyof typeof cluiFiles]: `${typeof PKG}/images/${(typeof cluiFiles)[K]}`; };
+declare const icons: { readonly [K in keyof typeof iconFiles]: `${typeof PKG}/images/${(typeof iconFiles)[K]}`; };
+declare const badges: { readonly [K in keyof typeof badgeFiles]: `${typeof PKG}/images/${(typeof badgeFiles)[K]}`; };
+declare const logos: { readonly [K in keyof typeof logoFiles]: `${typeof PKG}/images/${(typeof logoFiles)[K]}`; };
+declare const otherImages: { readonly [K in keyof typeof otherImagesFiles]: `${typeof PKG}/images/${(typeof otherImagesFiles)[K]}`; };
+type PosterAssetId = keyof typeof posters;
+/** A single filename under the shared images directory (values of `posterFiles`). */
+type PosterImageBasename = (typeof posterFiles)[PosterAssetId];
+type CluiImageId = keyof typeof cluiImages;
+/** Basename under the shared images directory (values of `cluiFiles`). */
+type CluiImageBasename = (typeof cluiFiles)[CluiImageId];
+type IconId = keyof typeof icons;
+type IconBasename = (typeof iconFiles)[IconId];
+type BadgeId = keyof typeof badges;
+type BadgeBasename = (typeof badgeFiles)[BadgeId];
+type LogoId = keyof typeof logos;
+type LogoBasename = (typeof logoFiles)[LogoId];
+type OtherImagesId = keyof typeof otherImages;
+type OtherImagesBasename = (typeof otherImagesFiles)[OtherImagesId];
+
+interface PosterInputType {
+    description: string;
+    posterName: PosterAssetId;
+    resourceId: string;
+    resourceType: EnumResourceType;
 }
-declare enum EnumPostContentType {
-    GAME = "game",
-    IMAGE = "image",
-    LIST = "list",
-    TEXTAREA = "textarea",
-    VIDEO = "video"
+
+declare enum EnumAdShowOn {
+    EVENTS_PAGE = "Events_page",
+    FRONT_PAGE = "Front_page",
+    PARTNERS_PAGE = "Partners_page",
+    VENDORS_PAGE = "Vendors_page"
 }
-type PostFileInput = {
-    source: File;
-    title?: string;
-};
-type PostContentTextarea = {
-    textarea: {
-        title?: string;
-        data: string;
-    };
-};
-type PostContentImage = {
-    images: ResourceImageType[] | null;
-    imagesUpload?: PostFileInput[] | null;
-};
-type PostContentVideo = {
-    video: {
-        source: string;
-        title?: string;
-    };
-};
-type PostContentList = {
-    list: {
-        title?: string;
-        items: {
-            text: string;
-        }[];
-    };
-};
-type PostContentGame = {
-    game: BaseGameType;
-};
-type PostContentData = PostContentGame | PostContentTextarea | PostContentImage | PostContentVideo | PostContentList;
-type PostContentFormData = {
-    contentData?: PostContentData | null;
-    contentOrder?: number | null;
-    contentType?: EnumPostContentType | null;
+declare enum EnumAdStatus {
+    ACTIVE = "Active",
+    PAUSED = "Paused",
+    EXPIRED = "Expired"
+}
+declare enum EnumAdType {
+    SPONSORED = "Sponsored",
+    FREE = "Free"
+}
+declare enum EnumAdStyle {
+    BLOOM = "Bloom",
+    RISE = "Rise"
+}
+type AdResource = {
+    adDescription: string;
+    adImage: string;
+    adStyle: EnumAdStyle;
+    adTitle: string;
+    adType: EnumAdType;
+    resourceId: string;
+    resourceName: string;
+    resourceRegion: string;
+    resourceType: EnumResourceType;
 };
-interface PostFormData {
+interface AdFormData {
     active: boolean;
-    caption: string;
-    content: PostContentFormData[];
-    cover?: ResourceImageType | null;
-    coverUpload?: PostFileInput | null;
-    postType: EnumPostType;
-    resource?: {
-        resourceId: string;
-        resourceType: EnumResourceType;
-        resourceRegion: string;
-    } | null;
-    tags?: string[] | null;
-    title: string;
-    notifyUsers?: boolean | null;
+    end: Date;
+    resource: AdResource;
+    showOn: EnumAdShowOn[];
+    start?: Date;
+    status: EnumAdStatus;
+    targetRegion: string[];
 }
-type CreatePostFormData = CreateFormData<PostFormData>;
-type PostContentType = Omit<PostContentFormData, "contentData"> & {
-    contentData: Omit<PostContentData, "imagesUpload">;
-};
-type PostType = Omit<PostFormData, "content" | "coverUpload"> & {
+type AdFormState = AdFormData;
+type CreateAdFormData = CreateFormData<AdFormData>;
+type CreateAdFormState = CreateFormData<AdFormState>;
+interface AdType extends AdFormData {
     _id: string;
-    content: PostContentType[];
+    clicks?: number;
     createdAt: Date;
-    deletedAt: Date | null;
+    impressions?: number;
+    start: Date;
     updatedAt: Date | null;
+}
+
+declare enum EnumActivity {
+    FAVORITE = "FAVORITE",
+    GOING = "GOING",
+    INTERESTED = "INTERESTED",
+    PRESENT = "PRESENT",
+    VIEW = "VIEW"
+}
+type ResourceActivityEntry = {
+    activityType: EnumActivity;
+    location: LocationGeoType | null;
+    dateStatus?: EnumEventDateStatus | null;
+    startDate?: string | null;
+    startTime?: string | null;
+    timestamp: Date;
+    userAgent: EnumOSPlatform;
+    userId?: string | null;
+};
+type ResourceActivityType = {
+    _id: string;
+    resourceType: EnumResourceType;
+    resourceId: string;
+    activity: ResourceActivityEntry[];
+};
+type ResourceActivityInputType = {
+    resourceId: string;
+    resourceType: EnumResourceType;
+    activity: Omit<ResourceActivityEntry, "timestamp">;
 };
 
+interface PartnerFormData extends BaseResourceTypeFormData {
+    location: LocationType;
+    nzbn: string;
+    partnerType: EnumPartnerType;
+}
+type CreatePartnerFormData = CreateFormData<PartnerFormData>;
+interface PartnerType extends BaseResourceType {
+    location: LocationType;
+    nzbn: string;
+    partnerType: EnumPartnerType;
+}
+
 type PushTokenType = {
     _id: string;
     createdAt: Date;