// controllers/admin/advertisements.controller.js const sequelize = require("../../config/db.config"); const Advertisement = require("../../models/advertisements/advertisements.mdl"); const mdl_Assets = require("../../models/assets/assets.mdl"); const mdl_Users = require('../../models/users/users.mdl'); const R = require('../../utils/response.util'); const { paginate } = require("../../utils/paginate.util"); const { adminExclude, jsonbSchemas, computedAttributes } = require("../../models/advertisements/advertisements.attributes"); const { getFieldValues } = require("../../utils/fieldValues.util"); const logActivity = require('../../utils/logActivity.util'); const { Op } = require('sequelize'); // ─── Helpers ────────────────────────────────────────────────────────────────── const notDeleted = { deletedAt: null }; const ALLOWED_TYPES = ["hero", "banner", "popup", "sidebar"]; const ALLOWED_STATUSES = ["draft", "active", "scheduled", "expired", "archived"]; // ─── Status derivation ───────────────────────────────────────────────────── // status is never trusted as manually-set truth — it's derived from is_active // + start_date/end_date every time an advertisement is read or written. // "archived" is the only status that bypasses derivation (set by archive/restore). 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"; } const ALLOWED_CTA_VARIANTS = ["default", "outline"]; function normalizeCtas(ctas) { if (!Array.isArray(ctas)) return []; return ctas .filter((c) => c && typeof c.label === "string" && typeof c.link === "string") .slice(0, 2) // hard cap: max 2 CTAs per advertisement .map((c, i) => ({ label: c.label.trim(), link: c.link.trim(), // First CTA defaults to "default" (primary), second to "outline" — but // an explicit, valid variant from the client always wins. variant: ALLOWED_CTA_VARIANTS.includes(c.variant) ? c.variant : (i === 0 ? "default" : "outline"), })); } async function applyAdvertisementFields(advertisement, body) { if (body.type !== undefined) { if (!ALLOWED_TYPES.includes(body.type)) { const err = new Error(`Invalid type. Must be one of: ${ALLOWED_TYPES.join(", ")}`); err.status = 400; throw err; } advertisement.type = body.type; } // status is intentionally NOT settable here — it's derived via deriveStatus() // right before save, based on is_active + start_date/end_date. if (body.badge_label !== undefined) advertisement.badge_label = body.badge_label; if (body.headline !== undefined) advertisement.headline = body.headline; if (body.description !== undefined) advertisement.description = body.description; if (body.image_url !== undefined) advertisement.image_url = body.image_url; if (body.image_asset_id !== undefined) { if (body.image_asset_id === null) { advertisement.image_asset_id = null; } else { const asset = await mdl_Assets.findOne({ where: { asset_id: body.image_asset_id, deletedAt: null } }); if (!asset) { const err = new Error("Selected image asset was not found."); err.status = 400; throw err; } advertisement.image_asset_id = asset.asset_id; } } if (body.ctas !== undefined) advertisement.ctas = normalizeCtas(body.ctas); if (body.start_date !== undefined) advertisement.start_date = body.start_date || null; if (body.end_date !== undefined) advertisement.end_date = body.end_date || null; if (body.order !== undefined) advertisement.order = parseInt(body.order) || 0; if (body.is_active !== undefined) advertisement.is_active = body.is_active === true || body.is_active === "true"; if (body.size !== undefined) { if (body.size !== null && !["sm", "md", "lg"].includes(body.size)) { const err = new Error(`Invalid size. Must be one of: sm, md, lg`); err.status = 400; throw err; } advertisement.size = body.size || null; } // Recompute status now that is_active/start_date/end_date are all up to date advertisement.status = deriveStatus(advertisement); } // ─── GET ALL ────────────────────────────────────────────────────────────────── exports.getAdvertisements = async (req, res) => { try { const result = await paginate(Advertisement, req, { excludeAttributes: adminExclude, jsonbSchemas, computedAttributes, context: "list", auditOptions: { mdl_Users, parentAlias: 'Advertisement' }, findOptions: { where: { ...notDeleted }, include: [{ model: mdl_Assets, as: "image", attributes: ["asset_id", "display_name", "file_url", "thumbnail_url"], required: false, }], }, }); // Resync status on the way out — never trust what's stored, since // start_date/end_date may have lapsed since the row was last saved. if (Array.isArray(result?.data)) { result.data = result.data.map((row) => ({ ...row, status: deriveStatus(row) })); } return R.success(res, "Advertisements retrieved.", result); } catch (err) { console.error("[ADVERTISEMENT][GET ALL]", err); return R.error(res, "Could not retrieve advertisements.", 500); } }; // ─── GET ONE ────────────────────────────────────────────────────────────────── exports.getAdvertisement = 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, ...notDeleted }, include: [ { model: mdl_Assets, as: "image", attributes: ["asset_id", "display_name", "file_url", "thumbnail_url"], required: false }, { model: mdl_Users, as: "creator", attributes: ["user_id", "personal_info"], foreignKey: "createdBy" }, { model: mdl_Users, as: "updater", attributes: ["user_id", "personal_info"], foreignKey: "updatedBy" }, ], }); if (!advertisement) return R.error(res, "Advertisement not found.", 404); const json = advertisement.toJSON(); json.status = deriveStatus(json); if (json.creator) { json.creator = { user_id: json.creator.user_id, full_name: json.creator.personal_info?.name?.full_name ?? null, }; } if (json.updater) { json.updater = { user_id: json.updater.user_id, full_name: json.updater.personal_info?.name?.full_name ?? null, }; } return R.success(res, "Advertisement retrieved.", { data: json }); } catch (err) { console.error("[ADVERTISEMENT][GET ONE]", err); return R.error(res, "Internal server error.", 500); } }; // ─── CREATE ─────────────────────────────────────────────────────────────────── exports.createAdvertisement = async (req, res) => { try { const { type, createdBy } = req.body; 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); if (!createdBy) return R.error(res, "createdBy is required.", 400); const t = await sequelize.transaction(); try { const advertisement = await Advertisement.build({ type, createdBy }); await applyAdvertisementFields(advertisement, req.body); await advertisement.save({ transaction: t }); await t.commit(); logActivity(req.user?.user_id, 'create_advertisement', { entityType: 'advertisement', entityId: advertisement.advertisement_id, details: { type: advertisement.type } }); return R.success(res, "Advertisement created.", { data: advertisement }, 201); } catch (dbErr) { try { await t.rollback(); } catch { /* connection gone */ } throw dbErr; } } catch (err) { console.error("[ADVERTISEMENT][CREATE]", err); if (err.status) return R.error(res, err.message, err.status); return R.error(res, "Internal server error.", 500); } }; // ─── UPDATE ─────────────────────────────────────────────────────────────────── exports.updateAdvertisement = 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, ...notDeleted } }); if (!advertisement) return R.error(res, "Advertisement not found.", 404); const t = await sequelize.transaction(); try { await applyAdvertisementFields(advertisement, req.body); advertisement.updatedBy = req.body.updatedBy ?? null; await advertisement.save({ transaction: t }); await t.commit(); logActivity(req.user?.user_id, 'update_advertisement', { entityType: 'advertisement', entityId: Number(advertisementId) }); return R.success(res, "Advertisement updated.", { data: advertisement }); } catch (dbErr) { try { await t.rollback(); } catch { /* gone */ } throw dbErr; } } catch (err) { console.error("[ADVERTISEMENT][UPDATE]", err); if (err.status) return R.error(res, err.message, err.status); return R.error(res, "Internal server error.", 500); } }; // ─── ARCHIVE (single) ───────────────────────────────────────────────────────── exports.archiveAdvertisement = 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, ...notDeleted } }); if (!advertisement) return R.error(res, "Advertisement not found.", 404); await advertisement.update({ deletedBy: req.body.deletedBy ?? null }); await advertisement.destroy(); logActivity(req.user?.user_id, 'archive_advertisement', { entityType: 'advertisement', entityId: Number(advertisementId) }); return R.success(res, "Advertisement archived."); } catch (err) { console.error("[ADVERTISEMENT][ARCHIVE]", err); return R.error(res, "Internal server error.", 500); } }; // ─── ARCHIVE (bulk) ─────────────────────────────────────────────────────────── exports.archiveAdvertisements = async (req, res) => { try { const { ids, deletedBy } = req.body; if (!Array.isArray(ids) || !ids.length) return R.error(res, "ids must be a non-empty array.", 400); const advertisements = await Advertisement.findAll({ where: { advertisement_id: { [Op.in]: ids }, ...notDeleted } }); if (!advertisements.length) return R.error(res, "No advertisements found.", 404); const activeIds = advertisements.map((a) => a.advertisement_id); await Advertisement.update({ deletedBy: deletedBy ?? null }, { where: { advertisement_id: { [Op.in]: activeIds } } }); await Advertisement.destroy({ where: { advertisement_id: { [Op.in]: activeIds } } }); logActivity(req.user?.user_id, 'bulk_archive_advertisements', { entityType: 'advertisement', details: { ids: activeIds, count: activeIds.length } }); return R.success(res, `${activeIds.length} advertisement(s) archived.`, { archived_ids: activeIds, skipped_ids: ids.filter((id) => !activeIds.includes(id)), }); } catch (err) { console.error("[ADVERTISEMENT][BULK ARCHIVE]", err); return R.error(res, "Internal server error.", 500); } }; // ─── RESTORE (single) ───────────────────────────────────────────────────────── exports.restoreAdvertisement = async (req, res) => { try { const { advertisementId } = req.params; const advertisement = await Advertisement.findOne({ where: { advertisement_id: advertisementId }, paranoid: false }); if (!advertisement) return R.error(res, "Advertisement not found.", 404); if (!advertisement.deletedAt) return R.error(res, "Advertisement is not archived.", 400); await advertisement.restore(); await advertisement.update({ deletedBy: null }); logActivity(req.user?.user_id, 'restore_advertisement', { entityType: 'advertisement', entityId: Number(advertisementId) }); return R.success(res, "Advertisement restored.", { data: advertisement }); } catch (err) { console.error("[ADVERTISEMENT][RESTORE]", err); return R.error(res, "Internal server error.", 500); } }; // ─── RESTORE (bulk) ─────────────────────────────────────────────────────────── exports.restoreAdvertisements = async (req, res) => { try { const { ids } = req.body; if (!Array.isArray(ids) || !ids.length) return R.error(res, "ids must be a non-empty array.", 400); const advertisements = await Advertisement.findAll({ where: { advertisement_id: { [Op.in]: ids } }, paranoid: false }); if (!advertisements.length) return R.error(res, "No advertisements found.", 404); const archived = advertisements.filter((a) => a.deletedAt); if (!archived.length) return R.error(res, "All selected advertisements are already active.", 400); const archivedIds = archived.map((a) => a.advertisement_id); await Advertisement.restore({ where: { advertisement_id: { [Op.in]: archivedIds } } }); await Advertisement.update({ deletedBy: null }, { where: { advertisement_id: { [Op.in]: archivedIds } }, paranoid: false }); logActivity(req.user?.user_id, 'bulk_restore_advertisements', { entityType: 'advertisement', details: { ids: archivedIds, count: archivedIds.length } }); return R.success(res, `${archivedIds.length} advertisement(s) restored.`, { restored_ids: archivedIds, skipped_ids: ids.filter((id) => !archivedIds.includes(id)), }); } catch (err) { console.error("[ADVERTISEMENT][BULK RESTORE]", err); return R.error(res, "Internal server error.", 500); } }; // ─── ARCHIVED LIST ──────────────────────────────────────────────────────────── exports.getArchivedAdvertisements = async (req, res) => { try { const result = await paginate(Advertisement, req, { excludeAttributes: adminExclude, jsonbSchemas, computedAttributes, context: "list", auditOptions: { mdl_Users, parentAlias: 'Advertisement' }, findOptions: { paranoid: false, where: { deletedAt: { [Op.ne]: null } } }, }); return R.success(res, "Archived advertisements retrieved.", result); } catch (err) { console.error("[ADVERTISEMENT][GET ARCHIVED]", err); return R.error(res, "Could not retrieve archived advertisements.", 500); } }; exports.getAdvertisementFieldValues = getFieldValues(Advertisement, "ADVERTISEMENT");