adserver-dashboard 1.0.0

package/PCM/src/routes/creatives.js

@@ -0,0 +1,437 @@
+import express from 'express';
+import { creativeSchema, creativeApprovalSchema } from '../validators/creativeValidator.js';
+import LineItemCreative from '../models/LineItemCreative.js';
+import LineItem from '../models/LineItem.js';
+import LineItemInventory from '../models/LineItemInventory.js';
+import Deal from '../models/Deal.js';
+import { toCamelCase, toSnakeCase } from '../utils/caseConverter.js';
+
+const router = express.Router({ mergeParams: true });
+
+const UUID_REGEX = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+
+const findDealByIdentifier = async (identifier) => {
+  let deal = await Deal.findOne({ where: { deal_id: identifier } });
+  
+  if (!deal && UUID_REGEX.test(identifier)) {
+    deal = await Deal.findOne({ where: { id: identifier } });
+  }
+  
+  return deal;
+};
+
+const findCreativeByIdentifier = async (creativeId, dealId) => {
+  let creative = await LineItemCreative.findOne({
+    where: { creative_id: creativeId, deal_id: dealId }
+  });
+
+  if (!creative && UUID_REGEX.test(creativeId)) {
+    creative = await LineItemCreative.findOne({
+      where: { id: creativeId, deal_id: dealId }
+    });
+  }
+
+  return creative;
+};
+
+const findLineItemByIdentifier = async (dealId, lineItemId) => {
+  let lineItem = await LineItem.findOne({ 
+    where: { deal_id: dealId, external_id: lineItemId }
+  });
+
+  if (!lineItem && UUID_REGEX.test(lineItemId)) {
+    lineItem = await LineItem.findOne({ 
+      where: { deal_id: dealId, id: lineItemId }
+    });
+  }
+
+  return lineItem;
+};
+
+/**
+ * GET /api/v1/rest/deals/:dealId/creatives
+ * GET /api/v1/rest/deals/:dealId/line-items/:lineItemId/creatives
+ */
+router.get('/', async (req, res, next) => {
+  try {
+    const { dealId, lineItemId } = req.params;
+    const page = parseInt(req.query.page) || 1;
+    const limit = parseInt(req.query.limit) || 10;
+    const offset = (page - 1) * limit;
+
+    const deal = await findDealByIdentifier(dealId);
+    if (!deal) {
+      return res.status(404).json({
+        code: 'NOT_FOUND',
+        message: 'Deal not found'
+      });
+    }
+    const resolvedDealId = deal.deal_id;
+
+    if (lineItemId) {
+      const lineItem = await findLineItemByIdentifier(resolvedDealId, lineItemId);
+
+      if (!lineItem) {
+        return res.status(404).json({
+          code: 'NOT_FOUND',
+          message: 'Line item not found'
+        });
+      }
+
+      const { count, rows } = await LineItemCreative.findAndCountAll({
+        where: { line_item_id: lineItem.id, deal_id: resolvedDealId },
+        limit,
+        offset,
+        order: [['created_at', 'DESC']]
+      });
+
+      const creatives = rows.map(creative => toCamelCase(creative.toJSON()));
+
+      return res.json({
+        requestId: req.requestId,
+        status: 200,
+        result: {
+          data: creatives,
+          pagination: {
+            page,
+            limit,
+            total: count,
+            totalPages: Math.ceil(count / limit)
+          }
+        }
+      });
+    } else {
+      const where = { deal_id: resolvedDealId };
+
+      if (req.query.search) {
+        const { Op } = (await import('sequelize')).default;
+        const searchTerm = `%${req.query.search}%`;
+        where[Op.or] = [
+          { creative_id: { [Op.iLike]: searchTerm } }
+        ];
+      }
+
+      if (req.query.creativeType) {
+        where.creative_type = req.query.creativeType.toUpperCase();
+      }
+
+      if (req.query.status) {
+        where.status = req.query.status.toUpperCase();
+      }
+
+      const { count, rows } = await LineItemCreative.findAndCountAll({
+        where,
+        limit,
+        offset,
+        order: [['created_at', 'DESC']]
+      });
+
+      const creatives = rows.map(creative => toCamelCase(creative.toJSON()));
+
+      return res.json({
+        requestId: req.requestId,
+        status: 200,
+        result: {
+          data: creatives,
+          pagination: {
+            page,
+            limit,
+            total: count,
+            totalPages: Math.ceil(count / limit)
+          }
+        }
+      });
+    }
+  } catch (error) {
+    next(error);
+  }
+});
+
+/**
+ * GET /api/v1/rest/deals/:dealId/creatives/:creativeId
+ */
+router.get('/:creativeId', async (req, res, next) => {
+  try {
+    const { dealId, creativeId } = req.params;
+
+    const deal = await findDealByIdentifier(dealId);
+    if (!deal) {
+      return res.status(404).json({
+        code: 'NOT_FOUND',
+        message: 'Deal not found'
+      });
+    }
+    const resolvedDealId = deal.deal_id;
+
+    const creative = await findCreativeByIdentifier(creativeId, resolvedDealId);
+
+    if (!creative) {
+      return res.status(404).json({
+        code: 'NOT_FOUND',
+        message: 'Creative not found'
+      });
+    }
+
+    res.json({
+      requestId: req.requestId,
+      status: 200,
+      result: toCamelCase(creative.toJSON())
+    });
+  } catch (error) {
+    next(error);
+  }
+});
+
+/**
+ * POST /api/v1/rest/deals/:dealId/line-items/:lineItemId/creatives/:creativeId
+ * Handles approval and rejection of creatives
+ */
+router.post('/:creativeId', async (req, res, next) => {
+  try {
+    const { dealId, creativeId } = req.params;
+    const bodyInCamelCase = toCamelCase(req.body);
+    
+    const { error, value } = creativeApprovalSchema.validate(bodyInCamelCase);
+    if (error) {
+      error.name = 'ValidationError';
+      return next(error);
+    }
+
+    const deal = await findDealByIdentifier(dealId);
+    if (!deal) {
+      return res.status(404).json({
+        code: 'NOT_FOUND',
+        message: 'Deal not found'
+      });
+    }
+    const resolvedDealId = deal.deal_id;
+
+    const creative = await findCreativeByIdentifier(creativeId, resolvedDealId);
+    if (!creative) {
+      return res.status(404).json({
+        code: 'NOT_FOUND',
+        message: 'Creative not found'
+      });
+    }
+
+    const decision = value.decision.toUpperCase();
+
+    if (decision === 'APPROVED') {
+      if (creative.status === 'APPROVED') {
+        return res.status(400).json({ code: 'INVALID_STATE', message: 'Creative is already approved' });
+      }
+      if (creative.status === 'REJECTED') {
+        return res.status(400).json({ code: 'INVALID_STATE', message: 'Cannot approve a rejected creative' });
+      }
+      
+      await creative.update({
+        status: 'APPROVED',
+        reviewer_id: value.reviewerId || null,
+        reviewer_name: value.reviewerName || null,
+        reviewed_at: new Date()
+      });
+    } else if (decision === 'REJECTED') {
+      if (creative.status === 'REJECTED') {
+        return res.status(400).json({ code: 'INVALID_STATE', message: 'Creative is already rejected' });
+      }
+      if (creative.status === 'APPROVED') {
+        return res.status(400).json({ code: 'INVALID_STATE', message: 'Cannot reject an approved creative' });
+      }
+      
+      const metadata = creative.metadata || {};
+      if (value.reason) {
+        metadata.rejectionReason = value.reason;
+      }
+
+      await creative.update({
+        status: 'REJECTED',
+        reviewer_id: value.reviewerId || null,
+        reviewer_name: value.reviewerName || null,
+        reviewed_at: new Date(),
+        metadata
+      });
+    }
+
+    res.json({
+      requestId: req.requestId,
+      status: 200,
+      result: {
+        id: creative.id,
+        creativeId: creative.creative_id,
+        status: creative.status,
+        rejectionReason: creative.status === 'REJECTED' ? (value.reason || null) : undefined,
+        reviewerId: creative.reviewer_id,
+        reviewerName: creative.reviewer_name,
+        reviewedAt: creative.reviewed_at
+      }
+    });
+  } catch (error) {
+    next(error);
+  }
+});
+
+/**
+ * POST /api/v1/rest/deals/:dealId/line-items/:lineItemId/creatives
+ */
+router.post('/', async (req, res, next) => {
+  try {
+    const { dealId, lineItemId } = req.params;
+    const bodyInCamelCase = toCamelCase(req.body);
+    const { error, value } = creativeSchema.validate(bodyInCamelCase);
+    
+    if (error) {
+      error.name = 'ValidationError';
+      return next(error);
+    }
+
+    const deal = await findDealByIdentifier(dealId);
+    if (!deal) {
+      return res.status(404).json({
+        code: 'NOT_FOUND',
+        message: 'Deal not found'
+      });
+    }
+    const resolvedDealId = deal.deal_id;
+
+    if (deal.mode === 'PROGRAMMATIC' && !['APPROVED', 'LIVE'].includes(deal.status)) {
+      return res.status(400).json({
+        code: 'VALIDATION_ERROR',
+        message: `Creatives can only be assigned to PROGRAMMATIC deals with status APPROVED or LIVE. Current status: ${deal.status}`
+      });
+    }
+
+    const lineItem = await findLineItemByIdentifier(resolvedDealId, lineItemId);
+
+    if (!lineItem) {
+      return res.status(404).json({
+        code: 'NOT_FOUND',
+        message: 'Line item not found'
+      });
+    }
+
+    if (value.creativeType !== lineItem.creative_type) {
+      return res.status(400).json({
+        code: 'VALIDATION_ERROR',
+        message: `Creative type mismatch: creative is ${value.creativeType}, but line item requires ${lineItem.creative_type}`
+      });
+    }
+
+    const requiresResolution = ['DISPLAY', 'VIDEO'].includes(value.creativeType);
+    
+    if (requiresResolution) {
+      const lineItemResolutions = lineItem.resolutions || [];
+      const lineItemSizes = lineItem.sizes || [];
+      const allowedResolutions = [...new Set([...lineItemResolutions, ...lineItemSizes])];
+      
+      let inventorySizes = [];
+      if (allowedResolutions.length === 0) {
+        const inventories = await LineItemInventory.findAll({
+          where: { line_item_id: lineItem.id },
+          attributes: ['size']
+        });
+        inventorySizes = [...new Set(inventories.map(inv => inv.size).filter(Boolean))];
+      }
+      
+      const allAllowedResolutions = [...new Set([...allowedResolutions, ...inventorySizes])];
+      
+      if (allAllowedResolutions.length === 0) {
+        return res.status(400).json({
+          code: 'VALIDATION_ERROR',
+          message: `Line item has no resolutions defined. Please add resolutions to the line item before assigning ${value.creativeType} creatives.`
+        });
+      }
+
+      if (!value.resolution) {
+        return res.status(400).json({
+          code: 'VALIDATION_ERROR',
+          message: `Resolution is required for ${value.creativeType} creatives`
+        });
+      }
+
+      if (!allAllowedResolutions.includes(value.resolution)) {
+        return res.status(400).json({
+          code: 'VALIDATION_ERROR',
+          message: `Resolution mismatch: creative resolution ${value.resolution} is not in line item's allowed resolutions [${allAllowedResolutions.join(', ')}]`
+        });
+      }
+    }
+
+    const creativeData = toSnakeCase(value);
+    creativeData.line_item_id = lineItem.id;
+    creativeData.deal_id = resolvedDealId;
+    creativeData.status = 'PENDING';
+
+    let matchedInventoryIds = [];
+    if (value.resolution) {
+      const matchingInventories = await LineItemInventory.findAll({
+        where: {
+          line_item_id: lineItem.id,
+          size: value.resolution
+        },
+        attributes: ['id']
+      });
+      matchedInventoryIds = matchingInventories.map(inv => inv.id);
+    }
+    creativeData.inventory_ids = matchedInventoryIds;
+
+    const creative = await LineItemCreative.create(creativeData);
+
+    res.status(201).json({
+      requestId: req.requestId,
+      status: 201,
+      result: {
+        id: creative.id,
+        creativeId: creative.creative_id,
+        creativeType: creative.creative_type,
+        resolution: creative.resolution,
+        status: creative.status,
+        matchedInventories: matchedInventoryIds.length,
+        inventoryIds: matchedInventoryIds,
+        createdAt: creative.created_at
+      }
+    });
+  } catch (error) {
+    next(error);
+  }
+});
+
+/**
+ * DELETE /api/v1/rest/deals/:dealId/creatives/:creativeId
+ */
+router.delete('/:creativeId', async (req, res, next) => {
+  try {
+    const { dealId, creativeId } = req.params;
+
+    const deal = await findDealByIdentifier(dealId);
+    if (!deal) {
+      return res.status(404).json({
+        code: 'NOT_FOUND',
+        message: 'Deal not found'
+      });
+    }
+    const resolvedDealId = deal.deal_id;
+
+    const creative = await findCreativeByIdentifier(creativeId, resolvedDealId);
+
+    if (!creative) {
+      return res.status(404).json({
+        code: 'NOT_FOUND',
+        message: 'Creative not found'
+      });
+    }
+
+    await creative.destroy();
+
+    res.json({
+      requestId: req.requestId,
+      status: 200,
+      result: {
+        message: 'Creative deleted successfully'
+      }
+    });
+  } catch (error) {
+    next(error);
+  }
+});
+
+export default router;