@timardex/cluemart-server-shared 1.0.281 → 1.0.287

package/dist/service/index.d.mts

@@ -1,11 +1,127 @@
-import { f as SchemaCreateBulkNotificationInput, O as ObjectId } from '../Chat-DYkhie3G.mjs';
-import { EnumUserLicence, DateTimeType, EventListItemType, DateTimeWithPriceType } from '@timardex/cluemart-shared';
+import * as _timardex_cluemart_shared from '@timardex/cluemart-shared';
+import { EnumAffiliateRewardType, AffiliateRewardType, PromoCodeType, UserLicenceType, EnumUserLicence, DateTimeType, EventListItemType, DateTimeWithPriceType } from '@timardex/cluemart-shared';
+import * as mongoose from 'mongoose';
+import { o as SchemaAffiliateResourceType, S as SchemaOwnerType, j as SchemaRelationType } from '../Affiliate-CmS0A1gU.mjs';
+import { f as SchemaCreateBulkNotificationInput, O as ObjectId } from '../Chat-Bnqec74U.mjs';
 import dayjs from 'dayjs';
 import { DateTimeType as DateTimeType$1 } from '@timardex/cluemart-shared/types';
-import { S as SchemaRelationType } from '../Relation-BjYghDE9.mjs';
-import 'mongoose';
 import 'express';
 
+/**
+ * Checks whether an affiliate code is already taken by an active, non-deleted affiliate.
+ *
+ * Used when generating new affiliate codes so collisions are avoided before insert.
+ * Matches the partial unique index on `affiliateCode` for active documents.
+ *
+ * @param affiliateCode - Candidate affiliate promo code to check.
+ * @returns `true` when an active, non-deleted affiliate already uses this code.
+ */
+declare function activeAffiliateCodeExists(affiliateCode: string): Promise<boolean>;
+
+type AwardAffiliateVendorSubscriptionRewardsResult = {
+    awarded: number;
+    skipped: number;
+};
+/**
+ * Awards monthly vendor subscription rewards to affiliates with active referred vendors.
+ *
+ * Eligibility per affiliate resource:
+ * - Affiliate is not soft-deleted
+ * - Linked `affiliateResources` entry is vendor, `resourceActive`, and not deleted
+ * - Vendor is active, not deleted, and `promoCodes` includes the affiliate code
+ * - Vendor owner has a non-expired Standard / Pro / Pro+ vendor licence
+ *
+ * Reward type follows the owner's highest valid licence:
+ * - Pro / Pro+ → `ACTIVE_VENDOR_PRO_SUBSCRIPTION` (3 pts)
+ * - Standard → `ACTIVE_VENDOR_STANDARD_SUBSCRIPTION` (1 pt)
+ *
+ * Idempotent per affiliate + vendor + reward type + calendar month.
+ * On successful award, notifies the affiliate owner (best-effort).
+ *
+ * @param now - Reference time for month bounds and licence expiry (defaults to now).
+ * @returns Counts of awarded and skipped candidates.
+ */
+declare function awardAffiliateVendorSubscriptionRewards(now?: Date): Promise<AwardAffiliateVendorSubscriptionRewardsResult>;
+
+declare const AFFILIATE_REWARDS: {
+    NEW_EVENT_REGISTRATION: {
+        description: string;
+        value: number;
+    };
+    NEW_VENDOR_REGISTRATION: {
+        description: string;
+        value: number;
+    };
+    ACTIVE_VENDOR_PRO_SUBSCRIPTION: {
+        description: string;
+        value: number;
+    };
+    ACTIVE_VENDOR_STANDARD_SUBSCRIPTION: {
+        description: string;
+        value: number;
+    };
+    ACTIVE_VENDOR_BONUS_REWARD: {
+        description: string;
+        value: number;
+    };
+    ACTIVE_EVENT_WITH_VENDOR_REGISTRATIONS: {
+        description: string;
+        value: number;
+    };
+};
+/**
+ * Create an affiliate reward
+ * @param rewardType - The type of reward
+ * @param createdAt - The date the reward was received
+ * @returns The affiliate reward
+ * @example
+ * const reward = createAffiliateReward(EnumAffiliateRewardType.NEW_EVENT_REGISTRATION, new Date());
+ * console.log(reward);
+ */
+declare function createAffiliateReward(rewardType: EnumAffiliateRewardType, createdAt: Date): AffiliateRewardType;
+
+/**
+ * Loads the affiliate whose `affiliateCode` matches the given promo code.
+ *
+ * Includes inactive affiliates (`active: false`) so resource referrals work before
+ * admin approval. Soft-deleted affiliates (`deletedAt` set) are excluded.
+ *
+ * @param promoCode - Normalized affiliate promo code to resolve.
+ * @returns The matching affiliate document, or `null` when not found.
+ */
+declare function findAffiliateByPromoCode(promoCode: PromoCodeType): Promise<(mongoose.Document<unknown, {}, Omit<_timardex_cluemart_shared.AffiliateType, "_id" | "owner" | "affiliateResources"> & {
+    affiliateResources: SchemaAffiliateResourceType[];
+    owner: SchemaOwnerType;
+}, {}, {}> & Omit<_timardex_cluemart_shared.AffiliateType, "_id" | "owner" | "affiliateResources"> & {
+    affiliateResources: SchemaAffiliateResourceType[];
+    owner: SchemaOwnerType;
+} & {
+    _id: mongoose.Types.ObjectId;
+} & {
+    __v: number;
+}) | null>;
+
+/**
+ * Normalizes, trims, uppercases, and deduplicates resource promo codes.
+ *
+ * @param promoCodes - Raw promo codes from a create-resource mutation input.
+ * @returns Unique normalized codes; empty strings and whitespace-only values are removed.
+ */
+declare function normalizeAffiliatePromoCodes(promoCodes: PromoCodeType[] | null | undefined): PromoCodeType[];
+
+/**
+ * Maps a vendor owner's highest valid vendor licence to a monthly subscription reward.
+ *
+ * Prefer Pro / Pro+ over Standard when both are valid.
+ * Returns `null` when no non-expired vendor licence applies.
+ */
+declare function mapVendorLicenceToSubscriptionRewardType(licences: UserLicenceType[] | null | undefined, now?: Date): EnumAffiliateRewardType | null;
+/** Inclusive start / exclusive end of the UTC calendar month containing `now`. */
+declare function getSubscriptionRewardPeriodBounds(now?: Date): {
+    periodEnd: Date;
+    periodStart: Date;
+};
+
 /**
  * Connect to MongoDB using Mongoose.
  * Supports both local MongoDB (via MONGODB_URI) and MongoDB Atlas (via individual env vars).
@@ -18,6 +134,14 @@ declare const connectToDatabase: ({ appName, dbName, dbPassword, dbUser, mongodb
     mongodbUri: string;
 }) => Promise<void>;
 
+/** Matches partial unique indexes for promo/affiliate codes on active documents. */
+declare const ACTIVE_NOT_DELETED_FILTER: {
+    readonly active: true;
+    readonly deletedAt: null;
+};
+
+declare function normalizePromoCode(decoratedPromoCode: string | null | undefined): string | null;
+
 /**
  * Create notifications in the database for multiple users
  * This is typically called when sending push notifications
@@ -73,4 +197,4 @@ declare function didRemoveAnyEventDates(previousDateTime: EventDateSlot[] | unde
  */
 declare function updateRelationDatesToUnavailable(relationDates: SchemaRelationType["relationDates"], eventDateTime: DateTimeWithPriceType[] | undefined): SchemaRelationType["relationDates"];
 
-export { connectToDatabase, convertObjectIdsToStrings, didRemoveAnyEventDates, findEventOrImportedMarketById, saveNotificationsInDb, sendPushNotifications, updateAdStatuses, updateAllEventDateTimeStatuses, updateRelationDatesToUnavailable, updateSingleDateTimeStatus, updateVendorBasedOnUserLicense };
+export { ACTIVE_NOT_DELETED_FILTER, AFFILIATE_REWARDS, type AwardAffiliateVendorSubscriptionRewardsResult, activeAffiliateCodeExists, awardAffiliateVendorSubscriptionRewards, connectToDatabase, convertObjectIdsToStrings, createAffiliateReward, didRemoveAnyEventDates, findAffiliateByPromoCode, findEventOrImportedMarketById, getSubscriptionRewardPeriodBounds, mapVendorLicenceToSubscriptionRewardType, normalizeAffiliatePromoCodes, normalizePromoCode, saveNotificationsInDb, sendPushNotifications, updateAdStatuses, updateAllEventDateTimeStatuses, updateRelationDatesToUnavailable, updateSingleDateTimeStatus, updateVendorBasedOnUserLicense };

package/dist/service/index.d.ts

@@ -1,11 +1,127 @@
-import { f as SchemaCreateBulkNotificationInput, O as ObjectId } from '../Chat-DYkhie3G.js';
-import { EnumUserLicence, DateTimeType, EventListItemType, DateTimeWithPriceType } from '@timardex/cluemart-shared';
+import * as _timardex_cluemart_shared from '@timardex/cluemart-shared';
+import { EnumAffiliateRewardType, AffiliateRewardType, PromoCodeType, UserLicenceType, EnumUserLicence, DateTimeType, EventListItemType, DateTimeWithPriceType } from '@timardex/cluemart-shared';
+import * as mongoose from 'mongoose';
+import { o as SchemaAffiliateResourceType, S as SchemaOwnerType, j as SchemaRelationType } from '../Affiliate-C_g6TdeG.js';
+import { f as SchemaCreateBulkNotificationInput, O as ObjectId } from '../Chat-Bnqec74U.js';
 import dayjs from 'dayjs';
 import { DateTimeType as DateTimeType$1 } from '@timardex/cluemart-shared/types';
-import { S as SchemaRelationType } from '../Relation-6t3Gn4pM.js';
-import 'mongoose';
 import 'express';
 
+/**
+ * Checks whether an affiliate code is already taken by an active, non-deleted affiliate.
+ *
+ * Used when generating new affiliate codes so collisions are avoided before insert.
+ * Matches the partial unique index on `affiliateCode` for active documents.
+ *
+ * @param affiliateCode - Candidate affiliate promo code to check.
+ * @returns `true` when an active, non-deleted affiliate already uses this code.
+ */
+declare function activeAffiliateCodeExists(affiliateCode: string): Promise<boolean>;
+
+type AwardAffiliateVendorSubscriptionRewardsResult = {
+    awarded: number;
+    skipped: number;
+};
+/**
+ * Awards monthly vendor subscription rewards to affiliates with active referred vendors.
+ *
+ * Eligibility per affiliate resource:
+ * - Affiliate is not soft-deleted
+ * - Linked `affiliateResources` entry is vendor, `resourceActive`, and not deleted
+ * - Vendor is active, not deleted, and `promoCodes` includes the affiliate code
+ * - Vendor owner has a non-expired Standard / Pro / Pro+ vendor licence
+ *
+ * Reward type follows the owner's highest valid licence:
+ * - Pro / Pro+ → `ACTIVE_VENDOR_PRO_SUBSCRIPTION` (3 pts)
+ * - Standard → `ACTIVE_VENDOR_STANDARD_SUBSCRIPTION` (1 pt)
+ *
+ * Idempotent per affiliate + vendor + reward type + calendar month.
+ * On successful award, notifies the affiliate owner (best-effort).
+ *
+ * @param now - Reference time for month bounds and licence expiry (defaults to now).
+ * @returns Counts of awarded and skipped candidates.
+ */
+declare function awardAffiliateVendorSubscriptionRewards(now?: Date): Promise<AwardAffiliateVendorSubscriptionRewardsResult>;
+
+declare const AFFILIATE_REWARDS: {
+    NEW_EVENT_REGISTRATION: {
+        description: string;
+        value: number;
+    };
+    NEW_VENDOR_REGISTRATION: {
+        description: string;
+        value: number;
+    };
+    ACTIVE_VENDOR_PRO_SUBSCRIPTION: {
+        description: string;
+        value: number;
+    };
+    ACTIVE_VENDOR_STANDARD_SUBSCRIPTION: {
+        description: string;
+        value: number;
+    };
+    ACTIVE_VENDOR_BONUS_REWARD: {
+        description: string;
+        value: number;
+    };
+    ACTIVE_EVENT_WITH_VENDOR_REGISTRATIONS: {
+        description: string;
+        value: number;
+    };
+};
+/**
+ * Create an affiliate reward
+ * @param rewardType - The type of reward
+ * @param createdAt - The date the reward was received
+ * @returns The affiliate reward
+ * @example
+ * const reward = createAffiliateReward(EnumAffiliateRewardType.NEW_EVENT_REGISTRATION, new Date());
+ * console.log(reward);
+ */
+declare function createAffiliateReward(rewardType: EnumAffiliateRewardType, createdAt: Date): AffiliateRewardType;
+
+/**
+ * Loads the affiliate whose `affiliateCode` matches the given promo code.
+ *
+ * Includes inactive affiliates (`active: false`) so resource referrals work before
+ * admin approval. Soft-deleted affiliates (`deletedAt` set) are excluded.
+ *
+ * @param promoCode - Normalized affiliate promo code to resolve.
+ * @returns The matching affiliate document, or `null` when not found.
+ */
+declare function findAffiliateByPromoCode(promoCode: PromoCodeType): Promise<(mongoose.Document<unknown, {}, Omit<_timardex_cluemart_shared.AffiliateType, "_id" | "owner" | "affiliateResources"> & {
+    affiliateResources: SchemaAffiliateResourceType[];
+    owner: SchemaOwnerType;
+}, {}, {}> & Omit<_timardex_cluemart_shared.AffiliateType, "_id" | "owner" | "affiliateResources"> & {
+    affiliateResources: SchemaAffiliateResourceType[];
+    owner: SchemaOwnerType;
+} & {
+    _id: mongoose.Types.ObjectId;
+} & {
+    __v: number;
+}) | null>;
+
+/**
+ * Normalizes, trims, uppercases, and deduplicates resource promo codes.
+ *
+ * @param promoCodes - Raw promo codes from a create-resource mutation input.
+ * @returns Unique normalized codes; empty strings and whitespace-only values are removed.
+ */
+declare function normalizeAffiliatePromoCodes(promoCodes: PromoCodeType[] | null | undefined): PromoCodeType[];
+
+/**
+ * Maps a vendor owner's highest valid vendor licence to a monthly subscription reward.
+ *
+ * Prefer Pro / Pro+ over Standard when both are valid.
+ * Returns `null` when no non-expired vendor licence applies.
+ */
+declare function mapVendorLicenceToSubscriptionRewardType(licences: UserLicenceType[] | null | undefined, now?: Date): EnumAffiliateRewardType | null;
+/** Inclusive start / exclusive end of the UTC calendar month containing `now`. */
+declare function getSubscriptionRewardPeriodBounds(now?: Date): {
+    periodEnd: Date;
+    periodStart: Date;
+};
+
 /**
  * Connect to MongoDB using Mongoose.
  * Supports both local MongoDB (via MONGODB_URI) and MongoDB Atlas (via individual env vars).
@@ -18,6 +134,14 @@ declare const connectToDatabase: ({ appName, dbName, dbPassword, dbUser, mongodb
     mongodbUri: string;
 }) => Promise<void>;
 
+/** Matches partial unique indexes for promo/affiliate codes on active documents. */
+declare const ACTIVE_NOT_DELETED_FILTER: {
+    readonly active: true;
+    readonly deletedAt: null;
+};
+
+declare function normalizePromoCode(decoratedPromoCode: string | null | undefined): string | null;
+
 /**
  * Create notifications in the database for multiple users
  * This is typically called when sending push notifications
@@ -73,4 +197,4 @@ declare function didRemoveAnyEventDates(previousDateTime: EventDateSlot[] | unde
  */
 declare function updateRelationDatesToUnavailable(relationDates: SchemaRelationType["relationDates"], eventDateTime: DateTimeWithPriceType[] | undefined): SchemaRelationType["relationDates"];
 
-export { connectToDatabase, convertObjectIdsToStrings, didRemoveAnyEventDates, findEventOrImportedMarketById, saveNotificationsInDb, sendPushNotifications, updateAdStatuses, updateAllEventDateTimeStatuses, updateRelationDatesToUnavailable, updateSingleDateTimeStatus, updateVendorBasedOnUserLicense };
+export { ACTIVE_NOT_DELETED_FILTER, AFFILIATE_REWARDS, type AwardAffiliateVendorSubscriptionRewardsResult, activeAffiliateCodeExists, awardAffiliateVendorSubscriptionRewards, connectToDatabase, convertObjectIdsToStrings, createAffiliateReward, didRemoveAnyEventDates, findAffiliateByPromoCode, findEventOrImportedMarketById, getSubscriptionRewardPeriodBounds, mapVendorLicenceToSubscriptionRewardType, normalizeAffiliatePromoCodes, normalizePromoCode, saveNotificationsInDb, sendPushNotifications, updateAdStatuses, updateAllEventDateTimeStatuses, updateRelationDatesToUnavailable, updateSingleDateTimeStatus, updateVendorBasedOnUserLicense };

package/dist/service/index.mjs

@@ -1,10 +1,14 @@
 import {
   AdModel,
+  AffiliateModel,
   ChatModel,
   EnumAdStatus,
+  EnumAffiliateRewardType,
   EnumChatType,
   EnumEventDateStatus,
   EnumInviteStatus,
+  EnumNotificationResourceType,
+  EnumNotificationType,
   EnumResourceType,
   EnumUserLicence,
   EventModel,
@@ -15,33 +19,29 @@ import {
   VendorModel,
   dateFormat,
   timeFormat
-} from "../chunk-6IK6D2KS.mjs";
+} from "../chunk-6EDO734D.mjs";
 
-// src/service/database.ts
-import mongoose from "mongoose";
-var connectToDatabase = async ({
-  appName,
-  dbName,
-  dbPassword,
-  dbUser,
-  mongodbUri
-}) => {
-  try {
-    const mongoUri = mongodbUri ? mongodbUri : (
-      // Fallback to MongoDB Atlas connection string
-      `mongodb+srv://${dbUser}:${dbPassword}@${dbName}.mongodb.net/?retryWrites=true&w=majority&appName=${appName}`
-    );
-    await mongoose.connect(mongoUri);
-    const connectionType = mongodbUri ? "Local MongoDB" : "MongoDB Atlas";
-    console.log(
-      `${connectionType} connected from server/src/service/database.ts`
-    );
-  } catch (err) {
-    console.error("Error connecting to MongoDB:", err);
-    throw err;
-  }
+// src/service/promoCode/constants.ts
+var ACTIVE_NOT_DELETED_FILTER = {
+  active: true,
+  deletedAt: null
 };
 
+// src/service/affiliate/activeAffiliateCodeExists.ts
+async function activeAffiliateCodeExists(affiliateCode) {
+  const existing = await AffiliateModel.exists({
+    ...ACTIVE_NOT_DELETED_FILTER,
+    affiliateCode
+  }).exec();
+  return existing !== null;
+}
+
+// src/service/promoCode/normalizePromoCode.ts
+function normalizePromoCode(decoratedPromoCode) {
+  const normalized = decoratedPromoCode?.trim().toUpperCase();
+  return normalized || null;
+}
+
 // src/service/saveNotificationsInDb.ts
 async function saveNotificationsInDb(payload) {
   const { data, message, title, type, userIds } = payload;
@@ -175,6 +175,285 @@ async function sendPushNotifications({
   }
 }
 
+// src/service/affiliate/createAffiliateReward.ts
+var AFFILIATE_REWARDS = {
+  [EnumAffiliateRewardType.NEW_EVENT_REGISTRATION]: {
+    description: "10 points for new event registration (one-time reward)",
+    value: 10
+  },
+  [EnumAffiliateRewardType.NEW_VENDOR_REGISTRATION]: {
+    description: "5 points for new vendor registration (one-time reward)",
+    value: 5
+  },
+  [EnumAffiliateRewardType.ACTIVE_VENDOR_PRO_SUBSCRIPTION]: {
+    description: "3 points for active vendor pro subscription (monthly reward)",
+    value: 3
+  },
+  [EnumAffiliateRewardType.ACTIVE_VENDOR_STANDARD_SUBSCRIPTION]: {
+    description: "1 point for active vendor standard subscription (monthly reward)",
+    value: 1
+  },
+  [EnumAffiliateRewardType.ACTIVE_VENDOR_BONUS_REWARD]: {
+    description: "5 bonus points for every 10th active vendor (one-time reward)",
+    value: 5
+  },
+  [EnumAffiliateRewardType.ACTIVE_EVENT_WITH_VENDOR_REGISTRATIONS]: {
+    description: "50 points for active event with vendor registrations (one-time reward)",
+    value: 50
+  }
+};
+function createAffiliateReward(rewardType, createdAt) {
+  const reward = AFFILIATE_REWARDS[rewardType];
+  return {
+    createdAt,
+    redeemedAt: null,
+    rewardDescription: reward.description,
+    rewardType,
+    rewardValue: reward.value
+  };
+}
+
+// src/service/affiliate/vendorSubscriptionRewards.ts
+function mapVendorLicenceToSubscriptionRewardType(licences, now = /* @__PURE__ */ new Date()) {
+  const validTypes = new Set(
+    (licences ?? []).filter(
+      (licence) => new Date(licence.expiryDate).getTime() > now.getTime()
+    ).map((licence) => licence.licenceType)
+  );
+  if (validTypes.has(EnumUserLicence.PRO_VENDOR) || validTypes.has(EnumUserLicence.PRO_PLUS_VENDOR)) {
+    return EnumAffiliateRewardType.ACTIVE_VENDOR_PRO_SUBSCRIPTION;
+  }
+  if (validTypes.has(EnumUserLicence.STANDARD_VENDOR)) {
+    return EnumAffiliateRewardType.ACTIVE_VENDOR_STANDARD_SUBSCRIPTION;
+  }
+  return null;
+}
+function getSubscriptionRewardPeriodBounds(now = /* @__PURE__ */ new Date()) {
+  const periodStart = new Date(
+    Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1)
+  );
+  const periodEnd = new Date(
+    Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 1)
+  );
+  return { periodEnd, periodStart };
+}
+
+// src/service/affiliate/awardAffiliateVendorSubscriptionRewards.ts
+function isEligibleVendorResource(resource) {
+  return resource.resourceType === EnumResourceType.VENDOR && resource.resourceActive === true && resource.resourceDeletedAt == null;
+}
+async function findAffiliatesWithActiveVendorReferrals() {
+  return await AffiliateModel.find({
+    affiliateResources: {
+      $elemMatch: {
+        resourceActive: true,
+        resourceDeletedAt: null,
+        resourceType: EnumResourceType.VENDOR
+      }
+    },
+    deletedAt: null
+  }).select("_id affiliateCode affiliateResources owner").lean().exec();
+}
+async function findEligibleReferredVendor(resourceId, affiliateCode) {
+  return await VendorModel.findOne({
+    _id: resourceId,
+    active: true,
+    deletedAt: null,
+    promoCodes: affiliateCode
+  }).select("_id name owner.userId").lean().exec();
+}
+async function resolveSubscriptionRewardTypeForVendorOwner(vendorOwnerUserId, now) {
+  const vendorOwner = await UserModel.findById(vendorOwnerUserId).select("licences").lean().exec();
+  return mapVendorLicenceToSubscriptionRewardType(vendorOwner?.licences, now);
+}
+async function notifyAffiliateOwnerOfSubscriptionReward({
+  affiliateId,
+  affiliateOwnerUserId,
+  resourceName,
+  rewardValue
+}) {
+  const payload = {
+    data: {
+      resourceId: String(affiliateId),
+      resourceName,
+      resourceType: EnumNotificationResourceType.AFFILIATE_REWARD_RECEIVED
+    },
+    message: `You earned ${rewardValue} points! Your referred vendor "${resourceName}" has an active subscription.`,
+    title: "Affiliate points earned",
+    type: EnumNotificationType.SYSTEM,
+    userIds: [affiliateOwnerUserId]
+  };
+  try {
+    await saveNotificationsInDb(payload);
+    await sendPushNotifications(payload);
+  } catch (error) {
+    console.error(
+      `[affiliate] subscription reward notification failed for affiliate ${String(affiliateId)}:`,
+      error instanceof Error ? error.message : error
+    );
+  }
+}
+async function tryAwardSubscriptionReward({
+  affiliate,
+  createdAt,
+  period,
+  resource,
+  rewardType,
+  vendor
+}) {
+  const reward = createAffiliateReward(rewardType, createdAt);
+  const updateResult = await AffiliateModel.updateOne(
+    {
+      _id: affiliate._id,
+      affiliateResources: {
+        $elemMatch: {
+          resourceActive: true,
+          resourceDeletedAt: null,
+          resourceId: vendor._id,
+          resourceType: EnumResourceType.VENDOR,
+          rewards: {
+            $not: {
+              $elemMatch: {
+                createdAt: {
+                  $gte: period.periodStart,
+                  $lt: period.periodEnd
+                },
+                rewardType
+              }
+            }
+          }
+        }
+      },
+      deletedAt: null
+    },
+    {
+      $inc: { overallPoints: reward.rewardValue },
+      $push: { "affiliateResources.$.rewards": reward }
+    }
+  ).exec();
+  if (updateResult.modifiedCount === 0) {
+    return "skipped";
+  }
+  const affiliateOwnerUserId = affiliate.owner?.userId;
+  if (affiliateOwnerUserId) {
+    await notifyAffiliateOwnerOfSubscriptionReward({
+      affiliateId: affiliate._id,
+      affiliateOwnerUserId,
+      resourceName: resource.resourceName || vendor.name || "vendor",
+      rewardValue: reward.rewardValue
+    });
+  }
+  return "awarded";
+}
+async function processAffiliateVendorReferral({
+  affiliate,
+  affiliateCode,
+  createdAt,
+  now,
+  period,
+  resource
+}) {
+  const vendor = await findEligibleReferredVendor(
+    resource.resourceId,
+    affiliateCode
+  );
+  if (!vendor?.owner?.userId) {
+    return "skipped";
+  }
+  const rewardType = await resolveSubscriptionRewardTypeForVendorOwner(
+    vendor.owner.userId,
+    now
+  );
+  if (!rewardType) {
+    return "skipped";
+  }
+  return tryAwardSubscriptionReward({
+    affiliate,
+    createdAt,
+    period,
+    resource,
+    rewardType,
+    vendor
+  });
+}
+async function awardAffiliateVendorSubscriptionRewards(now = /* @__PURE__ */ new Date()) {
+  const period = getSubscriptionRewardPeriodBounds(now);
+  const createdAt = now;
+  const affiliates = await findAffiliatesWithActiveVendorReferrals();
+  let awarded = 0;
+  let skipped = 0;
+  const seenPairs = /* @__PURE__ */ new Set();
+  for (const affiliate of affiliates) {
+    const affiliateCode = normalizePromoCode(affiliate.affiliateCode);
+    if (!affiliateCode) {
+      continue;
+    }
+    for (const resource of affiliate.affiliateResources) {
+      if (!isEligibleVendorResource(resource)) {
+        continue;
+      }
+      const pairKey = `${String(affiliate._id)}:${String(resource.resourceId)}`;
+      if (seenPairs.has(pairKey)) {
+        continue;
+      }
+      seenPairs.add(pairKey);
+      const outcome = await processAffiliateVendorReferral({
+        affiliate,
+        affiliateCode,
+        createdAt,
+        now,
+        period,
+        resource
+      });
+      if (outcome === "awarded") {
+        awarded += 1;
+      } else {
+        skipped += 1;
+      }
+    }
+  }
+  return { awarded, skipped };
+}
+
+// src/service/affiliate/findAffiliateByPromoCode.ts
+async function findAffiliateByPromoCode(promoCode) {
+  return AffiliateModel.findOne({
+    affiliateCode: promoCode,
+    deletedAt: null
+  }).exec();
+}
+
+// src/service/affiliate/normalizeAffiliatePromoCodes.ts
+function normalizeAffiliatePromoCodes(promoCodes) {
+  const normalized = (promoCodes ?? []).map((code) => normalizePromoCode(code)).filter((code) => code !== null);
+  return [...new Set(normalized)];
+}
+
+// src/service/database.ts
+import mongoose from "mongoose";
+var connectToDatabase = async ({
+  appName,
+  dbName,
+  dbPassword,
+  dbUser,
+  mongodbUri
+}) => {
+  try {
+    const mongoUri = mongodbUri ? mongodbUri : (
+      // Fallback to MongoDB Atlas connection string
+      `mongodb+srv://${dbUser}:${dbPassword}@${dbName}.mongodb.net/?retryWrites=true&w=majority&appName=${appName}`
+    );
+    await mongoose.connect(mongoUri);
+    const connectionType = mongodbUri ? "Local MongoDB" : "MongoDB Atlas";
+    console.log(
+      `${connectionType} connected from server/src/service/database.ts`
+    );
+  } catch (err) {
+    console.error("Error connecting to MongoDB:", err);
+    throw err;
+  }
+};
+
 // src/service/updateAdStatus.ts
 async function updateAdStatuses() {
   const now = /* @__PURE__ */ new Date();
@@ -552,10 +831,20 @@ function updateRelationDatesToUnavailable(relationDates, eventDateTime) {
   });
 }
 export {
+  ACTIVE_NOT_DELETED_FILTER,
+  AFFILIATE_REWARDS,
+  activeAffiliateCodeExists,
+  awardAffiliateVendorSubscriptionRewards,
   connectToDatabase,
   convertObjectIdsToStrings,
+  createAffiliateReward,
   didRemoveAnyEventDates,
+  findAffiliateByPromoCode,
   findEventOrImportedMarketById,
+  getSubscriptionRewardPeriodBounds,
+  mapVendorLicenceToSubscriptionRewardType,
+  normalizeAffiliatePromoCodes,
+  normalizePromoCode,
   saveNotificationsInDb,
   sendPushNotifications,
   updateAdStatuses,