@timardex/cluemart-server-shared 1.1.35 → 1.1.36

package/dist/service/index.d.mts

@@ -1,11 +1,11 @@
 import * as mongoose from 'mongoose';
 import * as _timardex_cluemart_shared from '@timardex/cluemart-shared';
-import { PromoCodeType, EnumAffiliateRewardType, EnumUserLicence, DateTimeType, EventListItemType, DateTimeWithPriceType } from '@timardex/cluemart-shared';
-import { n as SchemaAffiliateResourceType, S as SchemaOwnerType, i as SchemaRelationType } from '../Affiliate-B76iZ3fE.mjs';
+import { PromoCodeType, EnumAffiliateRewardType, DateTimeType, EventListItemType, DateTimeWithPriceType, EnumUserLicence as EnumUserLicence$1, UserLicenceType, EnumNotificationResourceType, EnumNotificationType, EnumResourceType } from '@timardex/cluemart-shared';
+import { p as SchemaAffiliateResourceType, S as SchemaOwnerType, i as SchemaRelationType, n as SchemaUserType } from '../Affiliate-xCVhO2Cy.mjs';
 import { O as ObjectId, G as GraphQLContext, f as SchemaCreateBulkNotificationInput } from '../Chat-Wn7yfc3v.mjs';
-import dayjs from 'dayjs';
+import dayjs, { Dayjs } from 'dayjs';
 import { DateTimeType as DateTimeType$1 } from '@timardex/cluemart-shared/types';
-import { EnumUserLicence as EnumUserLicence$1 } from '@timardex/cluemart-shared/enums';
+import { EnumUserLicence } from '@timardex/cluemart-shared/enums';
 import 'express';
 
 /**
@@ -148,8 +148,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.
  */
@@ -196,8 +194,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
@@ -215,4 +213,240 @@ declare function getPayingVendorStripeSubscriptionPlan(userId: ObjectId | string
  */
 declare function getPayingEventStripeSubscriptionPlan(userId: ObjectId | string, now?: Date): Promise<PayingStripeSubscriptionPlanResult>;
 
-export { ACTIVE_NOT_DELETED_FILTER, type AwardAffiliateVendorSubscriptionRewardsResult, type NotificationPubSub, SUBSCRIPTION_REWARD_TIMEZONE, activeAffiliateCodeExists, awardAffiliateVendorSubscriptionRewards, connectToDatabase, convertObjectIdsToStrings, didRemoveAnyEventDates, findAffiliateByPromoCode, findEventOrImportedMarketById, getPayingEventStripeSubscriptionPlan, getPayingStripeSubscriptionPlan, getPayingVendorStripeSubscriptionPlan, getSubscriptionRewardPeriodBounds, isValidObjectId, mapVendorLicenceToSubscriptionRewardType, normalizeAffiliatePromoCodes, normalizePromoCode, notifyUsers, publishNotificationEvents, saveNotificationsInDb, sendPushNotifications, updateAdStatuses, updateAllEventDateTimeStatuses, updateRelationDatesToUnavailable, updateSingleDateTimeStatus, updateVendorBasedOnUserLicense };
+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>;
+
+/**
+ * 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, type AwardAffiliateVendorSubscriptionRewardsResult, LicenceCategory, LicenceExpiryDate, type NotificationPubSub, SUBSCRIPTION_REWARD_TIMEZONE, activeAffiliateCodeExists, awardAffiliateVendorSubscriptionRewards, buildLicenceExpiryPipeline, checkOwnerHasLicence, connectToDatabase, convertObjectIdsToStrings, createLicenceObject, didRemoveAnyEventDates, ensureUserLicenseCompliance, eventLicences, findAffiliateByPromoCode, findEventOrImportedMarketById, getEventResourceInfo, getHighestLicenceForCategory, getLicenceCategory, getLicenceExpiryMode, getPartnerResourceInfo, getPayingEventStripeSubscriptionPlan, getPayingStripeSubscriptionPlan, getPayingVendorStripeSubscriptionPlan, getSubscriptionRewardPeriodBounds, getVendorResourceInfo, handleEventLicenceCompliance, handlePartnerLicenceCompliance, handleVendorLicenceCompliance, hasValidLicence, isStandardLicence, isValidObjectId, licenceCategoryMapping, licencePriority, mapVendorLicenceToSubscriptionRewardType, normalizeAffiliatePromoCodes, normalizePromoCode, notifyUsers, partnerLicences, processLicenseReminder, processUserCompliance, processUserLicenseReminders, publishNotificationEvents, remindUsersAboutLicenseExpiration, replaceUserLicenceWithObject, saveNotificationsInDb, sendDeactivationNotification, sendLicenseReminder, sendPushNotifications, sendReminderSafely, syncUserLicencesAfterExpiry, updateAdStatuses, updateAllEventDateTimeStatuses, updateRelationDatesToUnavailable, updateSingleDateTimeStatus, updateVendorBasedOnUserLicense, upgradeUserToLicence, vendorLicences, vendorOwnerHasProLicence };

package/dist/service/index.d.ts

@@ -1,11 +1,11 @@
 import * as mongoose from 'mongoose';
 import * as _timardex_cluemart_shared from '@timardex/cluemart-shared';
-import { PromoCodeType, EnumAffiliateRewardType, EnumUserLicence, DateTimeType, EventListItemType, DateTimeWithPriceType } from '@timardex/cluemart-shared';
-import { n as SchemaAffiliateResourceType, S as SchemaOwnerType, i as SchemaRelationType } from '../Affiliate-gqV1-654.js';
+import { PromoCodeType, EnumAffiliateRewardType, DateTimeType, EventListItemType, DateTimeWithPriceType, EnumUserLicence as EnumUserLicence$1, UserLicenceType, EnumNotificationResourceType, EnumNotificationType, EnumResourceType } from '@timardex/cluemart-shared';
+import { p as SchemaAffiliateResourceType, S as SchemaOwnerType, i as SchemaRelationType, n as SchemaUserType } from '../Affiliate-CZKOOaz_.js';
 import { O as ObjectId, G as GraphQLContext, f as SchemaCreateBulkNotificationInput } from '../Chat-Wn7yfc3v.js';
-import dayjs from 'dayjs';
+import dayjs, { Dayjs } from 'dayjs';
 import { DateTimeType as DateTimeType$1 } from '@timardex/cluemart-shared/types';
-import { EnumUserLicence as EnumUserLicence$1 } from '@timardex/cluemart-shared/enums';
+import { EnumUserLicence } from '@timardex/cluemart-shared/enums';
 import 'express';
 
 /**
@@ -148,8 +148,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.
  */
@@ -196,8 +194,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
@@ -215,4 +213,240 @@ declare function getPayingVendorStripeSubscriptionPlan(userId: ObjectId | string
  */
 declare function getPayingEventStripeSubscriptionPlan(userId: ObjectId | string, now?: Date): Promise<PayingStripeSubscriptionPlanResult>;
 
-export { ACTIVE_NOT_DELETED_FILTER, type AwardAffiliateVendorSubscriptionRewardsResult, type NotificationPubSub, SUBSCRIPTION_REWARD_TIMEZONE, activeAffiliateCodeExists, awardAffiliateVendorSubscriptionRewards, connectToDatabase, convertObjectIdsToStrings, didRemoveAnyEventDates, findAffiliateByPromoCode, findEventOrImportedMarketById, getPayingEventStripeSubscriptionPlan, getPayingStripeSubscriptionPlan, getPayingVendorStripeSubscriptionPlan, getSubscriptionRewardPeriodBounds, isValidObjectId, mapVendorLicenceToSubscriptionRewardType, normalizeAffiliatePromoCodes, normalizePromoCode, notifyUsers, publishNotificationEvents, saveNotificationsInDb, sendPushNotifications, updateAdStatuses, updateAllEventDateTimeStatuses, updateRelationDatesToUnavailable, updateSingleDateTimeStatus, updateVendorBasedOnUserLicense };
+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>;
+
+/**
+ * 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, type AwardAffiliateVendorSubscriptionRewardsResult, LicenceCategory, LicenceExpiryDate, type NotificationPubSub, SUBSCRIPTION_REWARD_TIMEZONE, activeAffiliateCodeExists, awardAffiliateVendorSubscriptionRewards, buildLicenceExpiryPipeline, checkOwnerHasLicence, connectToDatabase, convertObjectIdsToStrings, createLicenceObject, didRemoveAnyEventDates, ensureUserLicenseCompliance, eventLicences, findAffiliateByPromoCode, findEventOrImportedMarketById, getEventResourceInfo, getHighestLicenceForCategory, getLicenceCategory, getLicenceExpiryMode, getPartnerResourceInfo, getPayingEventStripeSubscriptionPlan, getPayingStripeSubscriptionPlan, getPayingVendorStripeSubscriptionPlan, getSubscriptionRewardPeriodBounds, getVendorResourceInfo, handleEventLicenceCompliance, handlePartnerLicenceCompliance, handleVendorLicenceCompliance, hasValidLicence, isStandardLicence, isValidObjectId, licenceCategoryMapping, licencePriority, mapVendorLicenceToSubscriptionRewardType, normalizeAffiliatePromoCodes, normalizePromoCode, notifyUsers, partnerLicences, processLicenseReminder, processUserCompliance, processUserLicenseReminders, publishNotificationEvents, remindUsersAboutLicenseExpiration, replaceUserLicenceWithObject, saveNotificationsInDb, sendDeactivationNotification, sendLicenseReminder, sendPushNotifications, sendReminderSafely, syncUserLicencesAfterExpiry, updateAdStatuses, updateAllEventDateTimeStatuses, updateRelationDatesToUnavailable, updateSingleDateTimeStatus, updateVendorBasedOnUserLicense, upgradeUserToLicence, vendorLicences, vendorOwnerHasProLicence };