ready to test

Testing Signed-off-by: Kenneth Obsequio <k80308392@gmail.com>
2026-09-27 00:12:54 +08:00 · 2026-06-22 10:06:58 +08:00
parent bf48c95467
commit 439bb33f77
189 changed files with 17559 additions and 686 deletions
@@ -0,0 +1,100 @@
+// controllers/client/advertisements.controller.js
+
+const Advertisement = require("../../models/advertisements/advertisements.mdl");
+const mdl_Assets = require("../../models/assets/assets.mdl");
+const R = require('../../utils/response.util');
+
+const { Op } = require('sequelize');
+
+const ALLOWED_TYPES = ["hero", "banner", "popup", "sidebar"];
+
+// ─── Status derivation ─────────────────────────────────────────────────────
+// Mirrors admin controller's deriveStatus — single source of truth for what
+// "live right now" means. Kept duplicated rather than shared to avoid a
+// cross-boundary import between admin and client controllers.
+function deriveStatus(advertisement) {
+  if (advertisement.deletedAt) return "archived";
+  if (!advertisement.is_active) return "draft";
+
+  const now   = new Date();
+  const start = advertisement.start_date ? new Date(advertisement.start_date) : null;
+  const end   = advertisement.end_date   ? new Date(advertisement.end_date)   : null;
+
+  if (end && end < now) return "expired";
+  if (start && start > now) return "scheduled";
+  return "active";
+}
+
+// ─── GET ACTIVE ───────────────────────────────────────────────────────────────
+//
+// Resolves the single highest-priority live advertisement for a given placement
+// type. "Live" means is_active = true AND within start_date/end_date window —
+// computed the same way as deriveStatus, but expressed as a SQL WHERE clause
+// here since we want the DB to do the filtering/ordering, not JS.
+//
+// GET /api/client/advertisements/active?type=hero
+//
+exports.getActiveAdvertisement = async (req, res) => {
+  try {
+    const { type } = req.query;
+
+    if (!type) return R.error(res, "type is required.", 400);
+    if (!ALLOWED_TYPES.includes(type)) return R.error(res, `Invalid type. Must be one of: ${ALLOWED_TYPES.join(", ")}`, 400);
+
+    const now = new Date();
+
+    const advertisement = await Advertisement.findOne({
+      where: {
+        type,
+        is_active: true,
+        deletedAt: null,
+        [Op.and]: [
+          { [Op.or]: [{ start_date: null }, { start_date: { [Op.lte]: now } }] },
+          { [Op.or]: [{ end_date: null },   { end_date:   { [Op.gte]: now } }] },
+        ],
+      },
+      order: [["order", "ASC"], ["createdAt", "DESC"]],
+      include: [{
+        model:     mdl_Assets,
+        as:        "image",
+        attributes: ["asset_id", "display_name", "file_url", "thumbnail_url"],
+        required:  false,
+      }],
+      attributes: { exclude: ["createdBy", "updatedBy", "deletedBy", "deletedAt", "image_asset_id"] },
+    });
+
+    if (!advertisement) return R.success(res, "No active advertisement for this placement.", { data: null });
+
+    const json = advertisement.toJSON();
+    json.status = deriveStatus(json); // will always be "active" given the WHERE clause, but kept for shape consistency
+
+    return R.success(res, "Active advertisement retrieved.", { data: json });
+  } catch (err) {
+    console.error("[CLIENT][ADVERTISEMENT][GET ACTIVE]", err);
+    return R.error(res, "Could not retrieve advertisement.", 500);
+  }
+};
+
+// ─── TRACK CLICK ──────────────────────────────────────────────────────────────
+//
+// POST /api/client/advertisements/:advertisementId/click
+// Fire-and-forget increment. Never blocks or surfaces errors to the user —
+// a failed click tracking call should never disrupt navigation to the CTA link.
+//
+exports.trackClick = async (req, res) => {
+  try {
+    const { advertisementId } = req.params;
+    if (!advertisementId || advertisementId === "undefined") return R.error(res, "Invalid advertisement ID.", 400);
+
+    const advertisement = await Advertisement.findOne({ where: { advertisement_id: advertisementId, deletedAt: null } });
+    if (!advertisement) return R.success(res, "Advertisement not found, skipped.", { data: null });
+
+    await advertisement.increment("click_count");
+
+    return R.success(res, "Click tracked.", { data: { click_count: advertisement.click_count + 1 } });
+  } catch (err) {
+    console.error("[CLIENT][ADVERTISEMENT][TRACK CLICK]", err);
+    // Still respond 200-ish/success shape — click tracking failures shouldn't surface to the user.
+    return R.success(res, "Click tracking failed silently.", { data: null });
+  }
+};