@timardex/cluemart-server-shared 1.1.35 → 1.1.37

package/dist/index.d.mts

@@ -1,13 +1,13 @@
 import * as _timardex_cluemart_shared from '@timardex/cluemart-shared';
-import { AdType, CreateBulkNotificationInput, NotificationType, EnumUserRole, ChatMessageType, ParticipantType, ChatType, ReportChatUser, RelatedPostType, OwnerType, SocialMediaType, ResourceImageType, Category, UserLicenceType, ResourceContactDetailsType, TermsAgreement, RelationDate, DateTimeType, LocationGeoType, LocationType, SocialShareResourceType, PosterUsageType, GoogleImportedMarket, PushTokenType, RelationType, ResourceActivityType, UserActivityEvent, UserType, VendorProductList, VendorType, VendorInfoType, UnregisteredVendorInvitationType, UnregisteredVendorType, EventType, StallType, RefundPolicy, EventInfoType, PartnerType, PostType, PostContentType, PostResource, AppSettingsType, GameType, GameDocType, SchoolType, AffiliateRewardType, AffiliateResourceType, AffiliateType, CouponType, CouponDataType, CouponParticipantUserType, PromoCodeType, EnumAffiliateRewardType, EnumUserLicence, EventListItemType, DateTimeWithPriceType } from '@timardex/cluemart-shared';
+import { AdType, CreateBulkNotificationInput, NotificationType, EnumUserRole, ChatMessageType, ParticipantType, ChatType, ReportChatUser, RelatedPostType, OwnerType, SocialMediaType, ResourceImageType, Category, UserLicenceType, ResourceContactDetailsType, TermsAgreement, RelationDate, DateTimeType, LocationGeoType, LocationType, SocialShareResourceType, PosterUsageType, GoogleImportedMarket, PushTokenType, RelationType, ResourceActivityType, UserActivityEvent, UserType, VendorProductList, VendorType, VendorInfoType, UnregisteredVendorInvitationType, UnregisteredVendorType, EventType, StallType, RefundPolicy, EventInfoType, PartnerType, PostType, PostContentType, PostResource, AppSettingsType, GameType, GameDocType, SchoolType, AffiliateRewardType, AffiliateResourceType, AffiliateType, CouponType, CouponDataType, CouponParticipantUserType, PromoCodeType, EnumAffiliateRewardType, EventListItemType, DateTimeWithPriceType, EnumUserLicence as EnumUserLicence$1, EnumNotificationResourceType, EnumNotificationType, EnumResourceType } from '@timardex/cluemart-shared';
 import * as mongoose from 'mongoose';
 import mongoose__default from 'mongoose';
 export { default as mongoose } from 'mongoose';
 import { NotificationCount, DateTimeType as DateTimeType$1 } from '@timardex/cluemart-shared/types';
 import express from 'express';
 export { default as express } from 'express';
-import dayjs from 'dayjs';
-import { EnumUserLicence as EnumUserLicence$1 } from '@timardex/cluemart-shared/enums';
+import dayjs, { Dayjs } from 'dayjs';
+import { EnumUserLicence } from '@timardex/cluemart-shared/enums';
 
 declare const AdModel: mongoose__default.Model<AdType, {}, {}, {}, mongoose__default.Document<unknown, {}, AdType, {}, {}> & AdType & Required<{
     _id: string;
@@ -923,8 +923,6 @@ declare function sendPushNotifications({ data, message, title, userIds, }: Schem
  */
 declare function updateAdStatuses(): Promise<void>;
 
-declare function updateVendorBasedOnUserLicense(userId: ObjectId, licenceType: EnumUserLicence): Promise<void>;
-
 /**
  * True when `value` is a valid Mongo ObjectId string.
  */
@@ -971,8 +969,8 @@ declare function updateRelationDatesToUnavailable(relationDates: SchemaRelationT
 
 type PayingStripeSubscriptionPlanResult = {
     hasSubscription: boolean;
-    plan: EnumUserLicence$1 | null;
-    validTypes: Set<EnumUserLicence$1>;
+    plan: EnumUserLicence | null;
+    validTypes: Set<EnumUserLicence>;
 };
 /**
  * Returns the paying Stripe plan when `currentPlan` is any PRO plan
@@ -990,4 +988,253 @@ declare function getPayingVendorStripeSubscriptionPlan(userId: ObjectId | string
  */
 declare function getPayingEventStripeSubscriptionPlan(userId: ObjectId | string, now?: Date): Promise<PayingStripeSubscriptionPlanResult>;
 
-export { ACTIVE_NOT_DELETED_FILTER, APP_SETTINGS_ID, AdModel, AffiliateModel, AppSettingModel, type AuthUser, type AwardAffiliateVendorSubscriptionRewardsResult, CategorySchema, ChatModel, ChatReportModel, ContactDetailsSchema, type CouponDocument, CouponModel, EnumPubSubEvents, EventInfoModel, EventModel, GameModel, GoogleImportedMarketModel, type GraphQLContext, NotificationModel, type NotificationPubSub, type ObjectId, OwnerTypeSchema, PartnerModel, PostModel, PushTokenModel, RelationModel, RelationTypeSchema, ResourceActivityModel, ResourceImageTypeSchema, SUBSCRIPTION_REWARD_TIMEZONE, type SchemaAffiliateResourceType, type SchemaAffiliateReward, type SchemaChatMessageReactionType, type SchemaChatMessageReplyPreviewType, type SchemaChatMessageSeenType, type SchemaChatMessageType, type SchemaChatReportType, type SchemaChatType, type SchemaCreateBulkNotificationInput, type SchemaEventInfoType, type SchemaEventType, type SchemaGameType, type SchemaGoogleImportedMarket, type SchemaNotificationType, type SchemaOwnerType, type SchemaParticipantType, type SchemaPartnerType, type SchemaPostType, type SchemaPushTokenType, type SchemaRelatedPostType, type SchemaRelationType, type SchemaUnregisteredVendorInvitationType, type SchemaUnregisteredVendorType, type SchemaUserActivityEvent, type SchemaUserType, type SchemaVendorInfoType, type SchemaVendorType, SchoolModel, SocialMediaTypeSchema, StallTypeSchema, type SubscriptionPayload, UnregisteredVendorModel, UserModel, VendorInfoModel, VendorModel, VerificationTokenModel, type VerificationTokenType, activeAffiliateCodeExists, awardAffiliateVendorSubscriptionRewards, baseResourceFields, connectToDatabase, convertObjectIdsToStrings, dateTimeSchema, didRemoveAnyEventDates, findAffiliateByPromoCode, findEventOrImportedMarketById, getPayingEventStripeSubscriptionPlan, getPayingStripeSubscriptionPlan, getPayingVendorStripeSubscriptionPlan, getSubscriptionRewardPeriodBounds, isValidObjectId, locationGeoSchema, locationsSchema, mapVendorLicenceToSubscriptionRewardType, normalizeAffiliatePromoCodes, normalizePromoCode, notifyUsers, publishNotificationEvents, refundPolicySchema, relatedPostSchema, relationDatesSchema, resourceRelationsSchema, saveNotificationsInDb, sendPushNotifications, socialShareResourceSchema, termsAgreementSchema, updateAdStatuses, updateAllEventDateTimeStatuses, updateRelationDatesToUnavailable, updateSingleDateTimeStatus, updateVendorBasedOnUserLicense, userLicenseSchema, vendorProductTypeSchema };
+declare function ensureUserLicenseCompliance(): Promise<void>;
+
+declare const eventLicences: EnumUserLicence$1[];
+/**
+ * Handles event licence compliance for a single user.
+ *
+ * Event licences are kept and extended on expiry — no deactivation.
+ */
+declare function handleEventLicenceCompliance(user: SchemaUserType, now: Dayjs): Promise<void>;
+
+/**
+ * Builds an aggregation pipeline that atomically applies expiry rules to the
+ * `licences` array. Used by syncUserLicencesAfterExpiry for a single
+ * updateOne with no read-modify-write.
+ *
+ * downgradeBranches: PRO_* / PRO_PLUS_* licence types mapped to their STANDARD_*
+ * counterpart (e.g. pro_plus_event → standard_event). Use EnumUserLicence in the
+ * caller to avoid string drift.
+ *
+ * Note: Uses MongoDB aggregation keys "then"/"case" (required by $cond/$switch).
+ *
+ * Requires MongoDB 4.2+: this emits an updateOne aggregation pipeline (the
+ * [ { $set: ... } ] form) and uses $reduce / $indexOfArray / $regexMatch in the
+ * dedupe + standard-detection stages. The project runs MongoDB 8.0
+ * (docker-compose.yml), well above the minimum.
+ */
+declare function buildLicenceExpiryPipeline(params: {
+    /** Pairs of (licenceType, standardCounterpart) for downgrade; e.g. PRO_PLUS_VENDOR → STANDARD_VENDOR */
+    downgradeBranches: ReadonlyArray<{
+        case: string;
+        then: string;
+    }>;
+    licenceTypes: string[];
+    /**
+     * How expired, targeted licences are handled:
+     * - "downgrade": extend expired STANDARD_* and downgrade expired PRO_* or PRO_PLUS_* (vendor)
+     * - "extend": keep the licence as-is and extend expiryDate to oneYearFromNow (partner/event)
+     */
+    mode?: "downgrade" | "extend";
+    nowDate: Date;
+    oneYearFromNow: Date;
+}): object[];
+
+declare const partnerLicences: EnumUserLicence$1[];
+/**
+ * Handles partner licence compliance for a single user.
+ *
+ * Partner licences are kept and extended on expiry — no deactivation.
+ */
+declare function handlePartnerLicenceCompliance(user: SchemaUserType, now: Dayjs): Promise<void>;
+
+/**
+ * Syncs the user's `licences` array
+ * Uses a single atomic updateOne with an aggregation pipeline so it is safe under
+ * concurrency (no read-modify-write, no lost updates).
+ *
+ * Rules (applied server-side only to licences whose licenceType is in licenceTypes):
+ * - mode "downgrade" (vendor): expired STANDARD_* → extended to one year from now;
+ *   expired PRO_* or PRO_PLUS_* → downgraded to STANDARD_* with issuedDate=now and
+ *   expiryDate=one year from now
+ * - mode "extend" (partner/event): expired licences are kept and their expiryDate
+ *   is extended to one year from now
+ * - Non-expired or non-targeted licences are unchanged in both modes
+ */
+declare function syncUserLicencesAfterExpiry(userId: ObjectId, licenceTypes: EnumUserLicence$1[], now: dayjs.Dayjs, mode?: "downgrade" | "extend"): Promise<void>;
+/**
+ * Checks if user has a valid licence of the given types
+ */
+declare function hasValidLicence(licences: UserLicenceType[], licenceTypes: EnumUserLicence$1[], now: dayjs.Dayjs): boolean;
+/**
+ * Sends a deactivation notification to the user
+ */
+declare function sendDeactivationNotification(payload: {
+    data: {
+        resourceId: string;
+        resourceName: string;
+        resourceType: EnumNotificationResourceType;
+    };
+    message: string;
+    title: string;
+    type: EnumNotificationType;
+    userIds: ObjectId[];
+}, userId: ObjectId, resourceName: string, resourceType: string): Promise<void>;
+/**
+ * Processes license compliance for a single user
+ */
+declare function processUserCompliance(user: SchemaUserType, now: dayjs.Dayjs): Promise<void>;
+
+declare function updateVendorBasedOnUserLicense(userId: ObjectId, licenceType: EnumUserLicence$1): Promise<void>;
+declare const vendorLicences: EnumUserLicence$1[];
+/**
+ * Handles vendor licence compliance for a single user
+ */
+declare function handleVendorLicenceCompliance(user: SchemaUserType, now: Dayjs): Promise<void>;
+/**
+ * Checks whether a vendor's owner currently holds a PRO (or higher) vendor licence.
+ */
+declare function vendorOwnerHasProLicence(vendorId: string): Promise<boolean>;
+
+/**
+ * Gets event resource information for a reminder
+ */
+declare function getEventResourceInfo(userId: ObjectId, eventIds: ObjectId[]): Promise<{
+    resourceId: string;
+    resourceName: string;
+} | null>;
+
+/**
+ * Gets partner resource information for a reminder
+ */
+declare function getPartnerResourceInfo(userId: ObjectId, partnerId: ObjectId): Promise<{
+    resourceId: string;
+    resourceName: string;
+} | null>;
+
+/**
+ * Sends license expiration reminders to users whose licenses expire in 7 days
+ */
+declare function remindUsersAboutLicenseExpiration(): Promise<void>;
+
+/**
+ * License expiration reminder window bounds.
+ *
+ * A licence qualifies for the "7 days before expiry" reminder when its expiry is
+ * between {@link REMINDER_WINDOW_MIN_HOURS} and {@link REMINDER_WINDOW_MAX_HOURS}
+ * away.
+ *
+ * Expressed in hours (derived from days) because dayjs rounds fractional "day"
+ * adds: `now.add(6.5, "day")` becomes 7 days and `now.add(7.5, "day")` 8 days.
+ */
+declare const REMINDER_WINDOW_MIN_HOURS: number;
+declare const REMINDER_WINDOW_MAX_HOURS: number;
+
+/**
+ * Single source of truth for how a licence type is handled on expiry.
+ *
+ * - "downgrade": PRO_VENDOR / PRO_PLUS_VENDOR → downgraded to STANDARD_VENDOR.
+ * - "extend": every other licence type is auto-extended for another year.
+ *
+ * Note: `cluemart-server`'s `licenceCategoryMapping` / `licencePriority`
+ * (ModelHelpers/licenses/index.ts) is a SEPARATE concern (entitlement priority,
+ * not expiry behaviour) and is intentionally not merged here.
+ */
+declare function getLicenceExpiryMode(licenceType: EnumUserLicence$1): "downgrade" | "extend";
+/**
+ * Sends a reminder notification for a license.
+ *
+ * Intentionally does NOT use the shared `notifyUsers` helper: that helper
+ * persists via `saveNotificationsInDb` (plain `insertMany`), whereas this job
+ * must claim the dedupe slot atomically through
+ * {@link checkAndCreateNotification} (upsert) so a reminder is only sent once.
+ * Push is therefore sent directly via `sendPushNotifications` only after the
+ * claim succeeds.
+ */
+declare function sendLicenseReminder(user: {
+    _id: ObjectId;
+    vendor?: ObjectId;
+    events?: ObjectId[];
+    partner?: ObjectId;
+}, licence: {
+    licenceType: EnumUserLicence$1;
+    expiryDate: Date | string;
+}): Promise<void>;
+/**
+ * Processes a single license and sends reminder if needed
+ *
+ * Checks if a license expires within the 6.5-7.5 day window and hasn't already
+ * received a reminder. See isLicenseExpiringIn7Days for details on the reminder window.
+ *
+ * @returns true if a reminder should be sent, false otherwise
+ */
+declare function processLicenseReminder(user: {
+    _id: ObjectId;
+    vendor?: ObjectId;
+    events?: ObjectId[];
+    partner?: ObjectId;
+}, licence: {
+    licenceType: EnumUserLicence$1;
+    expiryDate: Date | string;
+}, now: dayjs.Dayjs): Promise<boolean>;
+/**
+ * Sends a reminder for a single license, handling errors gracefully
+ */
+declare function sendReminderSafely(user: {
+    _id: ObjectId;
+    vendor?: ObjectId;
+    events?: ObjectId[];
+    partner?: ObjectId;
+}, licence: UserLicenceType): Promise<boolean>;
+/**
+ * Processes reminders for a single user's licenses
+ */
+declare function processUserLicenseReminders(user: SchemaUserType, now: dayjs.Dayjs): Promise<number>;
+
+/**
+ * Gets vendor resource information for a reminder
+ */
+declare function getVendorResourceInfo(userId: ObjectId, vendorId: ObjectId): Promise<{
+    resourceId: string;
+    resourceName: string;
+} | null>;
+
+declare enum LicenceExpiryDate {
+    ONE_YEAR = "1 year",
+    ONE_MONTH = "1 month",
+    TWO_MONTHS = "2 months"
+}
+declare enum LicenceCategory {
+    EVENT = "event",
+    PARTNER = "partner",
+    VENDOR = "vendor",
+    AFFILIATE = "affiliate",
+    SCHOOL = "school"
+}
+declare const licenceCategoryMapping: Record<EnumUserLicence$1, LicenceCategory>;
+declare const licencePriority: Record<EnumUserLicence$1, number>;
+declare const standardLicences: readonly [EnumUserLicence$1.STANDARD_VENDOR, EnumUserLicence$1.STANDARD_EVENT, EnumUserLicence$1.STANDARD_PARTNER];
+declare function isStandardLicence(licence: EnumUserLicence$1): licence is (typeof standardLicences)[number];
+type LicenceUpgradeArgs = {
+    expiryDate: LicenceExpiryDate;
+    licenceType: EnumUserLicence$1;
+    userId: ObjectId;
+};
+type LicenceUpgradeResult = {
+    licenceObject: UserLicenceType;
+    updatedUser: SchemaUserType | null;
+};
+declare function getLicenceCategory(licence: EnumUserLicence$1): LicenceCategory;
+declare function getHighestLicenceForCategory(licences: UserLicenceType[] | null | undefined, category: LicenceCategory): EnumUserLicence$1 | null;
+declare function createLicenceObject(expiryDate: LicenceExpiryDate, licenceType: EnumUserLicence$1): UserLicenceType;
+declare function replaceUserLicenceWithObject({ userId, licenceObject, protectHigherLicence, }: {
+    userId: ObjectId;
+    licenceObject: UserLicenceType;
+    protectHigherLicence?: boolean;
+}): Promise<void>;
+/**
+ * Upgrades a user's license by adding a new license object to their account.
+ * It calculates the expiry date based on the provided expiry duration and updates the user's licenses in the database.
+ * @param licenceType - The licence type to upgrade the user to.
+ * @param expiryDate - The expiry duration for the license being upgraded.
+ * @param userId - The ID of the user whose license is being upgraded.
+ * @returns An object containing the updated user and the new license object.
+ */
+declare const upgradeUserToLicence: ({ licenceType, expiryDate, userId, }: LicenceUpgradeArgs) => Promise<LicenceUpgradeResult>;
+declare function checkOwnerHasLicence({ userId, resourceType, }: {
+    userId: ObjectId;
+    resourceType: EnumResourceType;
+}): Promise<void>;
+
+export { ACTIVE_NOT_DELETED_FILTER, APP_SETTINGS_ID, AdModel, AffiliateModel, AppSettingModel, type AuthUser, type AwardAffiliateVendorSubscriptionRewardsResult, CategorySchema, ChatModel, ChatReportModel, ContactDetailsSchema, type CouponDocument, CouponModel, EnumPubSubEvents, EventInfoModel, EventModel, GameModel, GoogleImportedMarketModel, type GraphQLContext, LicenceCategory, LicenceExpiryDate, NotificationModel, type NotificationPubSub, type ObjectId, OwnerTypeSchema, PartnerModel, PostModel, PushTokenModel, REMINDER_WINDOW_MAX_HOURS, REMINDER_WINDOW_MIN_HOURS, RelationModel, RelationTypeSchema, ResourceActivityModel, ResourceImageTypeSchema, SUBSCRIPTION_REWARD_TIMEZONE, type SchemaAffiliateResourceType, type SchemaAffiliateReward, type SchemaChatMessageReactionType, type SchemaChatMessageReplyPreviewType, type SchemaChatMessageSeenType, type SchemaChatMessageType, type SchemaChatReportType, type SchemaChatType, type SchemaCreateBulkNotificationInput, type SchemaEventInfoType, type SchemaEventType, type SchemaGameType, type SchemaGoogleImportedMarket, type SchemaNotificationType, type SchemaOwnerType, type SchemaParticipantType, type SchemaPartnerType, type SchemaPostType, type SchemaPushTokenType, type SchemaRelatedPostType, type SchemaRelationType, type SchemaUnregisteredVendorInvitationType, type SchemaUnregisteredVendorType, type SchemaUserActivityEvent, type SchemaUserType, type SchemaVendorInfoType, type SchemaVendorType, SchoolModel, SocialMediaTypeSchema, StallTypeSchema, type SubscriptionPayload, UnregisteredVendorModel, UserModel, VendorInfoModel, VendorModel, VerificationTokenModel, type VerificationTokenType, activeAffiliateCodeExists, awardAffiliateVendorSubscriptionRewards, baseResourceFields, buildLicenceExpiryPipeline, checkOwnerHasLicence, connectToDatabase, convertObjectIdsToStrings, createLicenceObject, dateTimeSchema, didRemoveAnyEventDates, ensureUserLicenseCompliance, eventLicences, findAffiliateByPromoCode, findEventOrImportedMarketById, getEventResourceInfo, getHighestLicenceForCategory, getLicenceCategory, getLicenceExpiryMode, getPartnerResourceInfo, getPayingEventStripeSubscriptionPlan, getPayingStripeSubscriptionPlan, getPayingVendorStripeSubscriptionPlan, getSubscriptionRewardPeriodBounds, getVendorResourceInfo, handleEventLicenceCompliance, handlePartnerLicenceCompliance, handleVendorLicenceCompliance, hasValidLicence, isStandardLicence, isValidObjectId, licenceCategoryMapping, licencePriority, locationGeoSchema, locationsSchema, mapVendorLicenceToSubscriptionRewardType, normalizeAffiliatePromoCodes, normalizePromoCode, notifyUsers, partnerLicences, processLicenseReminder, processUserCompliance, processUserLicenseReminders, publishNotificationEvents, refundPolicySchema, relatedPostSchema, relationDatesSchema, remindUsersAboutLicenseExpiration, replaceUserLicenceWithObject, resourceRelationsSchema, saveNotificationsInDb, sendDeactivationNotification, sendLicenseReminder, sendPushNotifications, sendReminderSafely, socialShareResourceSchema, syncUserLicencesAfterExpiry, termsAgreementSchema, updateAdStatuses, updateAllEventDateTimeStatuses, updateRelationDatesToUnavailable, updateSingleDateTimeStatus, updateVendorBasedOnUserLicense, upgradeUserToLicence, userLicenseSchema, vendorLicences, vendorOwnerHasProLicence, vendorProductTypeSchema };

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 import * as _timardex_cluemart_shared from '@timardex/cluemart-shared';
-import { AdType, CreateBulkNotificationInput, NotificationType, EnumUserRole, ChatMessageType, ParticipantType, ChatType, ReportChatUser, RelatedPostType, OwnerType, SocialMediaType, ResourceImageType, Category, UserLicenceType, ResourceContactDetailsType, TermsAgreement, RelationDate, DateTimeType, LocationGeoType, LocationType, SocialShareResourceType, PosterUsageType, GoogleImportedMarket, PushTokenType, RelationType, ResourceActivityType, UserActivityEvent, UserType, VendorProductList, VendorType, VendorInfoType, UnregisteredVendorInvitationType, UnregisteredVendorType, EventType, StallType, RefundPolicy, EventInfoType, PartnerType, PostType, PostContentType, PostResource, AppSettingsType, GameType, GameDocType, SchoolType, AffiliateRewardType, AffiliateResourceType, AffiliateType, CouponType, CouponDataType, CouponParticipantUserType, PromoCodeType, EnumAffiliateRewardType, EnumUserLicence, EventListItemType, DateTimeWithPriceType } from '@timardex/cluemart-shared';
+import { AdType, CreateBulkNotificationInput, NotificationType, EnumUserRole, ChatMessageType, ParticipantType, ChatType, ReportChatUser, RelatedPostType, OwnerType, SocialMediaType, ResourceImageType, Category, UserLicenceType, ResourceContactDetailsType, TermsAgreement, RelationDate, DateTimeType, LocationGeoType, LocationType, SocialShareResourceType, PosterUsageType, GoogleImportedMarket, PushTokenType, RelationType, ResourceActivityType, UserActivityEvent, UserType, VendorProductList, VendorType, VendorInfoType, UnregisteredVendorInvitationType, UnregisteredVendorType, EventType, StallType, RefundPolicy, EventInfoType, PartnerType, PostType, PostContentType, PostResource, AppSettingsType, GameType, GameDocType, SchoolType, AffiliateRewardType, AffiliateResourceType, AffiliateType, CouponType, CouponDataType, CouponParticipantUserType, PromoCodeType, EnumAffiliateRewardType, EventListItemType, DateTimeWithPriceType, EnumUserLicence as EnumUserLicence$1, EnumNotificationResourceType, EnumNotificationType, EnumResourceType } from '@timardex/cluemart-shared';
 import * as mongoose from 'mongoose';
 import mongoose__default from 'mongoose';
 export { default as mongoose } from 'mongoose';
 import { NotificationCount, DateTimeType as DateTimeType$1 } from '@timardex/cluemart-shared/types';
 import express from 'express';
 export { default as express } from 'express';
-import dayjs from 'dayjs';
-import { EnumUserLicence as EnumUserLicence$1 } from '@timardex/cluemart-shared/enums';
+import dayjs, { Dayjs } from 'dayjs';
+import { EnumUserLicence } from '@timardex/cluemart-shared/enums';
 
 declare const AdModel: mongoose__default.Model<AdType, {}, {}, {}, mongoose__default.Document<unknown, {}, AdType, {}, {}> & AdType & Required<{
     _id: string;
@@ -923,8 +923,6 @@ declare function sendPushNotifications({ data, message, title, userIds, }: Schem
  */
 declare function updateAdStatuses(): Promise<void>;
 
-declare function updateVendorBasedOnUserLicense(userId: ObjectId, licenceType: EnumUserLicence): Promise<void>;
-
 /**
  * True when `value` is a valid Mongo ObjectId string.
  */
@@ -971,8 +969,8 @@ declare function updateRelationDatesToUnavailable(relationDates: SchemaRelationT
 
 type PayingStripeSubscriptionPlanResult = {
     hasSubscription: boolean;
-    plan: EnumUserLicence$1 | null;
-    validTypes: Set<EnumUserLicence$1>;
+    plan: EnumUserLicence | null;
+    validTypes: Set<EnumUserLicence>;
 };
 /**
  * Returns the paying Stripe plan when `currentPlan` is any PRO plan
@@ -990,4 +988,253 @@ declare function getPayingVendorStripeSubscriptionPlan(userId: ObjectId | string
  */
 declare function getPayingEventStripeSubscriptionPlan(userId: ObjectId | string, now?: Date): Promise<PayingStripeSubscriptionPlanResult>;
 
-export { ACTIVE_NOT_DELETED_FILTER, APP_SETTINGS_ID, AdModel, AffiliateModel, AppSettingModel, type AuthUser, type AwardAffiliateVendorSubscriptionRewardsResult, CategorySchema, ChatModel, ChatReportModel, ContactDetailsSchema, type CouponDocument, CouponModel, EnumPubSubEvents, EventInfoModel, EventModel, GameModel, GoogleImportedMarketModel, type GraphQLContext, NotificationModel, type NotificationPubSub, type ObjectId, OwnerTypeSchema, PartnerModel, PostModel, PushTokenModel, RelationModel, RelationTypeSchema, ResourceActivityModel, ResourceImageTypeSchema, SUBSCRIPTION_REWARD_TIMEZONE, type SchemaAffiliateResourceType, type SchemaAffiliateReward, type SchemaChatMessageReactionType, type SchemaChatMessageReplyPreviewType, type SchemaChatMessageSeenType, type SchemaChatMessageType, type SchemaChatReportType, type SchemaChatType, type SchemaCreateBulkNotificationInput, type SchemaEventInfoType, type SchemaEventType, type SchemaGameType, type SchemaGoogleImportedMarket, type SchemaNotificationType, type SchemaOwnerType, type SchemaParticipantType, type SchemaPartnerType, type SchemaPostType, type SchemaPushTokenType, type SchemaRelatedPostType, type SchemaRelationType, type SchemaUnregisteredVendorInvitationType, type SchemaUnregisteredVendorType, type SchemaUserActivityEvent, type SchemaUserType, type SchemaVendorInfoType, type SchemaVendorType, SchoolModel, SocialMediaTypeSchema, StallTypeSchema, type SubscriptionPayload, UnregisteredVendorModel, UserModel, VendorInfoModel, VendorModel, VerificationTokenModel, type VerificationTokenType, activeAffiliateCodeExists, awardAffiliateVendorSubscriptionRewards, baseResourceFields, connectToDatabase, convertObjectIdsToStrings, dateTimeSchema, didRemoveAnyEventDates, findAffiliateByPromoCode, findEventOrImportedMarketById, getPayingEventStripeSubscriptionPlan, getPayingStripeSubscriptionPlan, getPayingVendorStripeSubscriptionPlan, getSubscriptionRewardPeriodBounds, isValidObjectId, locationGeoSchema, locationsSchema, mapVendorLicenceToSubscriptionRewardType, normalizeAffiliatePromoCodes, normalizePromoCode, notifyUsers, publishNotificationEvents, refundPolicySchema, relatedPostSchema, relationDatesSchema, resourceRelationsSchema, saveNotificationsInDb, sendPushNotifications, socialShareResourceSchema, termsAgreementSchema, updateAdStatuses, updateAllEventDateTimeStatuses, updateRelationDatesToUnavailable, updateSingleDateTimeStatus, updateVendorBasedOnUserLicense, userLicenseSchema, vendorProductTypeSchema };
+declare function ensureUserLicenseCompliance(): Promise<void>;
+
+declare const eventLicences: EnumUserLicence$1[];
+/**
+ * Handles event licence compliance for a single user.
+ *
+ * Event licences are kept and extended on expiry — no deactivation.
+ */
+declare function handleEventLicenceCompliance(user: SchemaUserType, now: Dayjs): Promise<void>;
+
+/**
+ * Builds an aggregation pipeline that atomically applies expiry rules to the
+ * `licences` array. Used by syncUserLicencesAfterExpiry for a single
+ * updateOne with no read-modify-write.
+ *
+ * downgradeBranches: PRO_* / PRO_PLUS_* licence types mapped to their STANDARD_*
+ * counterpart (e.g. pro_plus_event → standard_event). Use EnumUserLicence in the
+ * caller to avoid string drift.
+ *
+ * Note: Uses MongoDB aggregation keys "then"/"case" (required by $cond/$switch).
+ *
+ * Requires MongoDB 4.2+: this emits an updateOne aggregation pipeline (the
+ * [ { $set: ... } ] form) and uses $reduce / $indexOfArray / $regexMatch in the
+ * dedupe + standard-detection stages. The project runs MongoDB 8.0
+ * (docker-compose.yml), well above the minimum.
+ */
+declare function buildLicenceExpiryPipeline(params: {
+    /** Pairs of (licenceType, standardCounterpart) for downgrade; e.g. PRO_PLUS_VENDOR → STANDARD_VENDOR */
+    downgradeBranches: ReadonlyArray<{
+        case: string;
+        then: string;
+    }>;
+    licenceTypes: string[];
+    /**
+     * How expired, targeted licences are handled:
+     * - "downgrade": extend expired STANDARD_* and downgrade expired PRO_* or PRO_PLUS_* (vendor)
+     * - "extend": keep the licence as-is and extend expiryDate to oneYearFromNow (partner/event)
+     */
+    mode?: "downgrade" | "extend";
+    nowDate: Date;
+    oneYearFromNow: Date;
+}): object[];
+
+declare const partnerLicences: EnumUserLicence$1[];
+/**
+ * Handles partner licence compliance for a single user.
+ *
+ * Partner licences are kept and extended on expiry — no deactivation.
+ */
+declare function handlePartnerLicenceCompliance(user: SchemaUserType, now: Dayjs): Promise<void>;
+
+/**
+ * Syncs the user's `licences` array
+ * Uses a single atomic updateOne with an aggregation pipeline so it is safe under
+ * concurrency (no read-modify-write, no lost updates).
+ *
+ * Rules (applied server-side only to licences whose licenceType is in licenceTypes):
+ * - mode "downgrade" (vendor): expired STANDARD_* → extended to one year from now;
+ *   expired PRO_* or PRO_PLUS_* → downgraded to STANDARD_* with issuedDate=now and
+ *   expiryDate=one year from now
+ * - mode "extend" (partner/event): expired licences are kept and their expiryDate
+ *   is extended to one year from now
+ * - Non-expired or non-targeted licences are unchanged in both modes
+ */
+declare function syncUserLicencesAfterExpiry(userId: ObjectId, licenceTypes: EnumUserLicence$1[], now: dayjs.Dayjs, mode?: "downgrade" | "extend"): Promise<void>;
+/**
+ * Checks if user has a valid licence of the given types
+ */
+declare function hasValidLicence(licences: UserLicenceType[], licenceTypes: EnumUserLicence$1[], now: dayjs.Dayjs): boolean;
+/**
+ * Sends a deactivation notification to the user
+ */
+declare function sendDeactivationNotification(payload: {
+    data: {
+        resourceId: string;
+        resourceName: string;
+        resourceType: EnumNotificationResourceType;
+    };
+    message: string;
+    title: string;
+    type: EnumNotificationType;
+    userIds: ObjectId[];
+}, userId: ObjectId, resourceName: string, resourceType: string): Promise<void>;
+/**
+ * Processes license compliance for a single user
+ */
+declare function processUserCompliance(user: SchemaUserType, now: dayjs.Dayjs): Promise<void>;
+
+declare function updateVendorBasedOnUserLicense(userId: ObjectId, licenceType: EnumUserLicence$1): Promise<void>;
+declare const vendorLicences: EnumUserLicence$1[];
+/**
+ * Handles vendor licence compliance for a single user
+ */
+declare function handleVendorLicenceCompliance(user: SchemaUserType, now: Dayjs): Promise<void>;
+/**
+ * Checks whether a vendor's owner currently holds a PRO (or higher) vendor licence.
+ */
+declare function vendorOwnerHasProLicence(vendorId: string): Promise<boolean>;
+
+/**
+ * Gets event resource information for a reminder
+ */
+declare function getEventResourceInfo(userId: ObjectId, eventIds: ObjectId[]): Promise<{
+    resourceId: string;
+    resourceName: string;
+} | null>;
+
+/**
+ * Gets partner resource information for a reminder
+ */
+declare function getPartnerResourceInfo(userId: ObjectId, partnerId: ObjectId): Promise<{
+    resourceId: string;
+    resourceName: string;
+} | null>;
+
+/**
+ * Sends license expiration reminders to users whose licenses expire in 7 days
+ */
+declare function remindUsersAboutLicenseExpiration(): Promise<void>;
+
+/**
+ * License expiration reminder window bounds.
+ *
+ * A licence qualifies for the "7 days before expiry" reminder when its expiry is
+ * between {@link REMINDER_WINDOW_MIN_HOURS} and {@link REMINDER_WINDOW_MAX_HOURS}
+ * away.
+ *
+ * Expressed in hours (derived from days) because dayjs rounds fractional "day"
+ * adds: `now.add(6.5, "day")` becomes 7 days and `now.add(7.5, "day")` 8 days.
+ */
+declare const REMINDER_WINDOW_MIN_HOURS: number;
+declare const REMINDER_WINDOW_MAX_HOURS: number;
+
+/**
+ * Single source of truth for how a licence type is handled on expiry.
+ *
+ * - "downgrade": PRO_VENDOR / PRO_PLUS_VENDOR → downgraded to STANDARD_VENDOR.
+ * - "extend": every other licence type is auto-extended for another year.
+ *
+ * Note: `cluemart-server`'s `licenceCategoryMapping` / `licencePriority`
+ * (ModelHelpers/licenses/index.ts) is a SEPARATE concern (entitlement priority,
+ * not expiry behaviour) and is intentionally not merged here.
+ */
+declare function getLicenceExpiryMode(licenceType: EnumUserLicence$1): "downgrade" | "extend";
+/**
+ * Sends a reminder notification for a license.
+ *
+ * Intentionally does NOT use the shared `notifyUsers` helper: that helper
+ * persists via `saveNotificationsInDb` (plain `insertMany`), whereas this job
+ * must claim the dedupe slot atomically through
+ * {@link checkAndCreateNotification} (upsert) so a reminder is only sent once.
+ * Push is therefore sent directly via `sendPushNotifications` only after the
+ * claim succeeds.
+ */
+declare function sendLicenseReminder(user: {
+    _id: ObjectId;
+    vendor?: ObjectId;
+    events?: ObjectId[];
+    partner?: ObjectId;
+}, licence: {
+    licenceType: EnumUserLicence$1;
+    expiryDate: Date | string;
+}): Promise<void>;
+/**
+ * Processes a single license and sends reminder if needed
+ *
+ * Checks if a license expires within the 6.5-7.5 day window and hasn't already
+ * received a reminder. See isLicenseExpiringIn7Days for details on the reminder window.
+ *
+ * @returns true if a reminder should be sent, false otherwise
+ */
+declare function processLicenseReminder(user: {
+    _id: ObjectId;
+    vendor?: ObjectId;
+    events?: ObjectId[];
+    partner?: ObjectId;
+}, licence: {
+    licenceType: EnumUserLicence$1;
+    expiryDate: Date | string;
+}, now: dayjs.Dayjs): Promise<boolean>;
+/**
+ * Sends a reminder for a single license, handling errors gracefully
+ */
+declare function sendReminderSafely(user: {
+    _id: ObjectId;
+    vendor?: ObjectId;
+    events?: ObjectId[];
+    partner?: ObjectId;
+}, licence: UserLicenceType): Promise<boolean>;
+/**
+ * Processes reminders for a single user's licenses
+ */
+declare function processUserLicenseReminders(user: SchemaUserType, now: dayjs.Dayjs): Promise<number>;
+
+/**
+ * Gets vendor resource information for a reminder
+ */
+declare function getVendorResourceInfo(userId: ObjectId, vendorId: ObjectId): Promise<{
+    resourceId: string;
+    resourceName: string;
+} | null>;
+
+declare enum LicenceExpiryDate {
+    ONE_YEAR = "1 year",
+    ONE_MONTH = "1 month",
+    TWO_MONTHS = "2 months"
+}
+declare enum LicenceCategory {
+    EVENT = "event",
+    PARTNER = "partner",
+    VENDOR = "vendor",
+    AFFILIATE = "affiliate",
+    SCHOOL = "school"
+}
+declare const licenceCategoryMapping: Record<EnumUserLicence$1, LicenceCategory>;
+declare const licencePriority: Record<EnumUserLicence$1, number>;
+declare const standardLicences: readonly [EnumUserLicence$1.STANDARD_VENDOR, EnumUserLicence$1.STANDARD_EVENT, EnumUserLicence$1.STANDARD_PARTNER];
+declare function isStandardLicence(licence: EnumUserLicence$1): licence is (typeof standardLicences)[number];
+type LicenceUpgradeArgs = {
+    expiryDate: LicenceExpiryDate;
+    licenceType: EnumUserLicence$1;
+    userId: ObjectId;
+};
+type LicenceUpgradeResult = {
+    licenceObject: UserLicenceType;
+    updatedUser: SchemaUserType | null;
+};
+declare function getLicenceCategory(licence: EnumUserLicence$1): LicenceCategory;
+declare function getHighestLicenceForCategory(licences: UserLicenceType[] | null | undefined, category: LicenceCategory): EnumUserLicence$1 | null;
+declare function createLicenceObject(expiryDate: LicenceExpiryDate, licenceType: EnumUserLicence$1): UserLicenceType;
+declare function replaceUserLicenceWithObject({ userId, licenceObject, protectHigherLicence, }: {
+    userId: ObjectId;
+    licenceObject: UserLicenceType;
+    protectHigherLicence?: boolean;
+}): Promise<void>;
+/**
+ * Upgrades a user's license by adding a new license object to their account.
+ * It calculates the expiry date based on the provided expiry duration and updates the user's licenses in the database.
+ * @param licenceType - The licence type to upgrade the user to.
+ * @param expiryDate - The expiry duration for the license being upgraded.
+ * @param userId - The ID of the user whose license is being upgraded.
+ * @returns An object containing the updated user and the new license object.
+ */
+declare const upgradeUserToLicence: ({ licenceType, expiryDate, userId, }: LicenceUpgradeArgs) => Promise<LicenceUpgradeResult>;
+declare function checkOwnerHasLicence({ userId, resourceType, }: {
+    userId: ObjectId;
+    resourceType: EnumResourceType;
+}): Promise<void>;
+
+export { ACTIVE_NOT_DELETED_FILTER, APP_SETTINGS_ID, AdModel, AffiliateModel, AppSettingModel, type AuthUser, type AwardAffiliateVendorSubscriptionRewardsResult, CategorySchema, ChatModel, ChatReportModel, ContactDetailsSchema, type CouponDocument, CouponModel, EnumPubSubEvents, EventInfoModel, EventModel, GameModel, GoogleImportedMarketModel, type GraphQLContext, LicenceCategory, LicenceExpiryDate, NotificationModel, type NotificationPubSub, type ObjectId, OwnerTypeSchema, PartnerModel, PostModel, PushTokenModel, REMINDER_WINDOW_MAX_HOURS, REMINDER_WINDOW_MIN_HOURS, RelationModel, RelationTypeSchema, ResourceActivityModel, ResourceImageTypeSchema, SUBSCRIPTION_REWARD_TIMEZONE, type SchemaAffiliateResourceType, type SchemaAffiliateReward, type SchemaChatMessageReactionType, type SchemaChatMessageReplyPreviewType, type SchemaChatMessageSeenType, type SchemaChatMessageType, type SchemaChatReportType, type SchemaChatType, type SchemaCreateBulkNotificationInput, type SchemaEventInfoType, type SchemaEventType, type SchemaGameType, type SchemaGoogleImportedMarket, type SchemaNotificationType, type SchemaOwnerType, type SchemaParticipantType, type SchemaPartnerType, type SchemaPostType, type SchemaPushTokenType, type SchemaRelatedPostType, type SchemaRelationType, type SchemaUnregisteredVendorInvitationType, type SchemaUnregisteredVendorType, type SchemaUserActivityEvent, type SchemaUserType, type SchemaVendorInfoType, type SchemaVendorType, SchoolModel, SocialMediaTypeSchema, StallTypeSchema, type SubscriptionPayload, UnregisteredVendorModel, UserModel, VendorInfoModel, VendorModel, VerificationTokenModel, type VerificationTokenType, activeAffiliateCodeExists, awardAffiliateVendorSubscriptionRewards, baseResourceFields, buildLicenceExpiryPipeline, checkOwnerHasLicence, connectToDatabase, convertObjectIdsToStrings, createLicenceObject, dateTimeSchema, didRemoveAnyEventDates, ensureUserLicenseCompliance, eventLicences, findAffiliateByPromoCode, findEventOrImportedMarketById, getEventResourceInfo, getHighestLicenceForCategory, getLicenceCategory, getLicenceExpiryMode, getPartnerResourceInfo, getPayingEventStripeSubscriptionPlan, getPayingStripeSubscriptionPlan, getPayingVendorStripeSubscriptionPlan, getSubscriptionRewardPeriodBounds, getVendorResourceInfo, handleEventLicenceCompliance, handlePartnerLicenceCompliance, handleVendorLicenceCompliance, hasValidLicence, isStandardLicence, isValidObjectId, licenceCategoryMapping, licencePriority, locationGeoSchema, locationsSchema, mapVendorLicenceToSubscriptionRewardType, normalizeAffiliatePromoCodes, normalizePromoCode, notifyUsers, partnerLicences, processLicenseReminder, processUserCompliance, processUserLicenseReminders, publishNotificationEvents, refundPolicySchema, relatedPostSchema, relationDatesSchema, remindUsersAboutLicenseExpiration, replaceUserLicenceWithObject, resourceRelationsSchema, saveNotificationsInDb, sendDeactivationNotification, sendLicenseReminder, sendPushNotifications, sendReminderSafely, socialShareResourceSchema, syncUserLicencesAfterExpiry, termsAgreementSchema, updateAdStatuses, updateAllEventDateTimeStatuses, updateRelationDatesToUnavailable, updateSingleDateTimeStatus, updateVendorBasedOnUserLicense, upgradeUserToLicence, userLicenseSchema, vendorLicences, vendorOwnerHasProLicence, vendorProductTypeSchema };