ponch-mcp-server 1.0.93 → 1.0.95

package/dist/index.js

@@ -12942,7 +12942,9 @@ var brandBriefWriterContract = MartinContractSchema.parse(
 );
 async function save(input) {
   const { db, tenantId, brandId, plan, actor } = input;
-  const brandRef = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main");
+  const brandRef = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  );
   const brandSnap = await brandRef.get();
   if (!brandSnap.exists) {
     return { ok: false, error: `Brand "${brandId}" no encontrada`, code: "BRAND_NOT_FOUND" };
@@ -12973,7 +12975,9 @@ async function save(input) {
 }
 async function updateField(input) {
   const { db, tenantId, brandId, field, value } = input;
-  const brandRef = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main");
+  const brandRef = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  );
   const brandSnap = await brandRef.get();
   if (!brandSnap.exists) {
     return { ok: false, error: `Brand "${brandId}" no encontrada`, code: "BRAND_NOT_FOUND" };
@@ -13574,6 +13578,12 @@ var rawContract6 = {
   destructive: false,
   affectsPublication: true,
   affectsExternal: true,
+  martinConfirmationTemplate: (input, locale) => {
+    return getMessage("marketing.seoSuggestion.confirmApply", locale, {
+      suggestionId: input.suggestionId,
+      fieldsCount: String(input.fieldsToApply?.length ?? 0)
+    });
+  },
   martinSummaryTemplate: (_input, output, locale) => {
     if (!output.ok) {
       if (output.code) {
@@ -13851,11 +13861,12 @@ var rawContract7 = {
     after: output.ok ? {
       camposActualizados: output.camposActualizados,
       datosKeys: input.datos ? Object.keys(input.datos) : [],
-      fotoId: input.fotoId ?? void 0,
-      keyword: input.keyword ?? void 0,
-      languageCode: input.languageCode,
-      estado: input.estado,
-      calendarioItemRef: input.calendarioItemRef ?? void 0
+      // Firestore rechaza undefined — normalizar a null cuando el caller omite.
+      fotoId: input.fotoId ?? null,
+      keyword: input.keyword ?? null,
+      languageCode: input.languageCode ?? null,
+      estado: input.estado ?? null,
+      calendarioItemRef: input.calendarioItemRef ?? null
     } : null
   }),
   quotasConsumed: [],
@@ -13869,7 +13880,7 @@ var contenidoUpdaterContract = MartinContractSchema.parse(
 );
 async function addCalendarSlot(input) {
   const { db, tenantId, brandId, mes, semana, slot } = input;
-  const calQuery = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_calendario").where("mes", "==", mes).limit(1).get();
+  const calQuery = await db.collection(collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_calendario")).where("mes", "==", mes).limit(1).get();
   if (calQuery.empty) {
     return {
       ok: false,
@@ -13993,7 +14004,7 @@ async function calendarSlotUpdater(input) {
   if (slotIndex < 0) {
     return { ok: false, error: "slotIndex no puede ser negativo" };
   }
-  const calQuery = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_calendario").where("mes", "==", mes).limit(1).get();
+  const calQuery = await db.collection(collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_calendario")).where("mes", "==", mes).limit(1).get();
   if (calQuery.empty) {
     return { ok: false, error: "Calendario no encontrado" };
   }
@@ -14028,7 +14039,7 @@ async function calendarSlotUpdater(input) {
   }
   let contenidosADescartar = [];
   if (oldContenidoRef && (accionContenidoExistente === "descartar" || !tocaSemantica)) {
-    const contenidoQuery = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_contenido").where("calendarioItemRef", "==", oldContenidoRef).limit(10).get();
+    const contenidoQuery = await db.collection(collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_contenido")).where("calendarioItemRef", "==", oldContenidoRef).limit(10).get();
     contenidosADescartar = contenidoQuery.docs.filter((c) => {
       const data = c.data();
       return data.estado !== "descartado" && data.estado !== ESTADO_CONTENIDO.PUBLICADO;
@@ -14088,7 +14099,13 @@ async function calendarSlotUpdater(input) {
   let movedSlotEstado = null;
   if (moveTarget && oldContenidoRef) {
     try {
-      const contenidoSnap = await db.doc(`tenants/${tenantId}/brands/${brandId}/marketing_contenido/${oldContenidoRef}`).get();
+      const contenidoSnap = await db.doc(
+        docPath(
+          { kind: "brand-nested", tenantId, brandId },
+          "marketing_contenido",
+          oldContenidoRef
+        )
+      ).get();
       if (contenidoSnap.exists) {
         const estadoContenido = contenidoSnap.data().estado;
         movedSlotEstado = mapContenidoEstadoToSlotEstado(estadoContenido);
@@ -14161,7 +14178,13 @@ async function calendarSlotUpdater(input) {
   });
   if (moveTarget && oldContenidoRef) {
     try {
-      await db.doc(`tenants/${tenantId}/brands/${brandId}/marketing_contenido/${oldContenidoRef}`).update({
+      await db.doc(
+        docPath(
+          { kind: "brand-nested", tenantId, brandId },
+          "marketing_contenido",
+          oldContenidoRef
+        )
+      ).update({
         calendarioItemRef: moveTarget.targetRef
       });
     } catch (err) {
@@ -14325,7 +14348,7 @@ var calendarSlotUpdaterContract = MartinContractSchema.parse(
 );
 async function getCalendar(input) {
   const { db, tenantId, brandId, mes } = input;
-  const snap = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_calendario").where("mes", "==", mes).limit(1).get();
+  const snap = await db.collection(collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_calendario")).where("mes", "==", mes).limit(1).get();
   if (snap.empty) {
     return {
       ok: true,
@@ -14386,6 +14409,21 @@ var rawContract10 = {
 var getCalendarContract = MartinContractSchema.parse(
   rawContract10
 );
+function normalizeFechaSnapshot(raw) {
+  if (raw === null || raw === void 0) return null;
+  if (typeof raw === "string") return raw;
+  if (raw instanceof Date) return raw.toISOString();
+  const maybeTimestamp = raw;
+  if (typeof maybeTimestamp.toDate === "function") {
+    const d = maybeTimestamp.toDate();
+    if (d instanceof Date) return d.toISOString();
+  }
+  const maybeSerialized = raw;
+  if (typeof maybeSerialized._seconds === "number") {
+    return new Date(maybeSerialized._seconds * 1e3).toISOString();
+  }
+  return null;
+}
 var DEFAULT_ALERTS_ES = {
   noSeo: () => "No hay snapshot SEO. Genera uno para esta marca.",
   noPlan: () => "No hay plan de marketing. Genera uno desde el snapshot SEO.",
@@ -14394,14 +14432,20 @@ var DEFAULT_ALERTS_ES = {
 };
 async function brandMarketingSummary(input, alerts = DEFAULT_ALERTS_ES) {
   const { db, tenantId, brandId } = input;
-  const brandRef = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main");
+  const brandRef = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  );
   const brandSnap = await brandRef.get();
   if (!brandSnap.exists) {
     return { ok: false, code: "BRAND_NOT_FOUND" };
   }
   const brand = brandSnap.data() ?? {};
-  const contenidoCol = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_contenido");
-  const fotosCol = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_fotos");
+  const contenidoCol = db.collection(
+    collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_contenido")
+  );
+  const fotosCol = db.collection(
+    collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_fotos")
+  );
   const [pendientesSnap, publicadosSnap, fotosNuevasSnap] = await Promise.all([
     contenidoCol.where("estado", "==", ESTADO_CONTENIDO.PENDIENTE_APROBACION).get(),
     contenidoCol.where("estado", "==", ESTADO_CONTENIDO.PUBLICADO).limit(50).get(),
@@ -14426,7 +14470,9 @@ async function brandMarketingSummary(input, alerts = DEFAULT_ALERTS_ES) {
       rank: seoSnapshot.rank ?? null,
       totalKeywords: seoSnapshot.totalKeywords ?? null,
       traficoOrganico: seoSnapshot.traficoOrganico ?? null,
-      ultimoSnapshot: seoSnapshot.fechaSnapshot ?? null
+      // fechaSnapshot en Firestore es Timestamp. outputSchema declara
+      // string ISO. Normalizamos vía firebase-admin Timestamp check.
+      ultimoSnapshot: normalizeFechaSnapshot(seoSnapshot.fechaSnapshot)
     } : null,
     plan: { existe: planExiste },
     contenido: {
@@ -14527,14 +14573,20 @@ function extractPreview(plataforma, datos) {
 }
 async function brandMarketingPendingActions(input) {
   const { db, tenantId, brandId } = input;
-  const brandRef = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main");
+  const brandRef = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  );
   const brandSnap = await brandRef.get();
   if (!brandSnap.exists) {
     return { ok: false, code: "BRAND_NOT_FOUND" };
   }
   const brand = brandSnap.data() ?? {};
-  const contenidoCol = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_contenido");
-  const fotosCol = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_fotos");
+  const contenidoCol = db.collection(
+    collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_contenido")
+  );
+  const fotosCol = db.collection(
+    collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_fotos")
+  );
   const [pendientesSnap, fotosNuevasSnap] = await Promise.all([
     contenidoCol.where("estado", "==", ESTADO_CONTENIDO.PENDIENTE_APROBACION).get(),
     fotosCol.where("estado", "==", ESTADO_FOTO.NUEVA).get()
@@ -14624,7 +14676,7 @@ var DEFAULT_ALERTS_ES2 = {
 };
 async function tenantMarketingSummary(input, alerts = DEFAULT_ALERTS_ES2) {
   const { db, tenantId } = input;
-  const brandsSnap = await db.collection("tenants").doc(tenantId).collection("brands").get();
+  const brandsSnap = await db.collection(collectionPath({ kind: "tenant-nested", tenantId }, "brands")).get();
   const totalBrandsInTenant = brandsSnap.size;
   if (totalBrandsInTenant === 0) {
     return { ok: false, code: "TENANT_HAS_NO_BRANDS" };
@@ -14758,7 +14810,7 @@ var tenantMarketingSummaryContract = MartinContractSchema.parse(
 var TENANT_PENDING_CAP = 20;
 async function tenantMarketingPendingActions(input) {
   const { db, tenantId } = input;
-  const brandsSnap = await db.collection("tenants").doc(tenantId).collection("brands").get();
+  const brandsSnap = await db.collection(collectionPath({ kind: "tenant-nested", tenantId }, "brands")).get();
   const totalBrandsInTenant = brandsSnap.size;
   if (totalBrandsInTenant === 0) {
     return { ok: false, code: "TENANT_HAS_NO_BRANDS" };
@@ -14774,7 +14826,9 @@ async function tenantMarketingPendingActions(input) {
   const brandIds = brandsSnap.docs.map((d) => d.id);
   const nombrePorBrand = /* @__PURE__ */ new Map();
   const configReads = brandIds.map(
-    (brandId) => db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main").get().then((snap) => {
+    (brandId) => db.doc(
+      docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+    ).get().then((snap) => {
       const nombre = snap.exists ? snap.data()?.nombre ?? null : null;
       nombrePorBrand.set(brandId, nombre);
     })
@@ -14886,12 +14940,16 @@ var tenantMarketingPendingActionsContract = MartinContractSchema.parse(
 );
 async function seoSnapshotReader(input) {
   const { db, tenantId, brandId } = input;
-  const brandRef = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main");
+  const brandRef = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  );
   const brandSnap = await brandRef.get();
   if (!brandSnap.exists) {
     return { ok: false, code: "BRAND_NOT_FOUND" };
   }
-  const snap = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_snapshots_semrush").orderBy("mes", "desc").limit(1).get();
+  const snap = await db.collection(
+    collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_snapshots_semrush")
+  ).orderBy("mes", "desc").limit(1).get();
   if (snap.empty) {
     return { ok: false, code: "SEO_SNAPSHOT_MISSING" };
   }
@@ -14998,12 +15056,14 @@ var SCHEMA_FOR_SAVE_EN = {
 };
 async function collectionsReader(input) {
   const { db, tenantId, brandId } = input;
-  const brandRef = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main");
+  const brandRef = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  );
   const brandSnap = await brandRef.get();
   if (!brandSnap.exists) {
     return { ok: false, code: "BRAND_NOT_FOUND" };
   }
-  const collSnap = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_snapshots").doc("main").collection("collections").get();
+  const collSnap = await db.doc(docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_snapshots", "main")).collection("collections").get();
   if (collSnap.empty) {
     return { ok: false, code: "NO_COLLECTIONS_NESTED" };
   }
@@ -15011,7 +15071,9 @@ async function collectionsReader(input) {
   const brand = brandSnap.data() ?? {};
   const plan = brand.plan ?? {};
   const keywordsPrioritarios = Array.isArray(plan.keywordsPrioritarios) ? plan.keywordsPrioritarios : [];
-  const seoSuggestionsCol = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_suggestions_seo");
+  const seoSuggestionsCol = db.collection(
+    collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_suggestions_seo")
+  );
   const seoSnap = await seoSuggestionsCol.where("intent", "==", "seo_meta").where("target.category", "==", "collection").where("estado", "in", ["pendiente", "aplicada"]).get();
   const existingSuggestions = {};
   for (const d of seoSnap.docs) {
@@ -15132,7 +15194,9 @@ var collectionsReaderContract = MartinContractSchema.parse(
 var QUERY_LIMIT = 50;
 async function photoGalleryReader(input) {
   const { db, tenantId, brandId, estado } = input;
-  let query = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_fotos");
+  let query = db.collection(
+    collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_fotos")
+  );
   if (estado) {
     query = query.where("estado", "==", estado);
   }
@@ -15340,7 +15404,9 @@ async function photoEditStatusReader(input) {
   const { db, tenantId, brandId, fotoId } = input;
   const maxPerDay = MARKETING_CONSTRAINTS.photoEdit.maxIterationsPerPhotoPerDay;
   const costoPhotoEdit = CREDIT_COSTS.photo_edit;
-  const fotoRef = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_fotos").doc(fotoId);
+  const fotoRef = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_fotos", fotoId)
+  );
   const fotoSnap = await fotoRef.get();
   if (!fotoSnap.exists) {
     return { ok: false, code: "FOTO_NOT_FOUND" };
@@ -15354,7 +15420,9 @@ async function photoEditStatusReader(input) {
   const estado = typeof foto.estado === "string" ? foto.estado : "desconocido";
   const ultimoError = typeof foto.ultimoError === "string" ? foto.ultimoError : null;
   const lockId = `photo_edit_${fotoId}`;
-  const lockSnap = await db.collection("tenants").doc(tenantId).collection("locks").doc(lockId).get();
+  const lockSnap = await db.doc(
+    docPath({ kind: "tenant-nested", tenantId }, "locks", lockId)
+  ).get();
   let lock = { held: false };
   if (lockSnap.exists) {
     const lockData = lockSnap.data();
@@ -15376,7 +15444,9 @@ async function photoEditStatusReader(input) {
     periodEnd: null,
     costoPhotoEdit
   };
-  const creditsSnap = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("credits").doc("main").get();
+  const creditsSnap = await db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "credits", "main")
+  ).get();
   if (creditsSnap.exists) {
     const creditsData = creditsSnap.data();
     credits = {
@@ -15502,13 +15572,18 @@ var photoEditStatusReaderContract = MartinContractSchema.parse(
   rawContract18
 );
 async function contenidoApprover(input) {
-  const { db, tenantId, contenidoId, actor } = input;
-  const ref = db.collection("tenants").doc(tenantId).collection("marketing_contenido").doc(contenidoId);
+  const { db, tenantId, brandId, contenidoId, actor } = input;
+  const ref = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_contenido", contenidoId)
+  );
   const snap = await ref.get();
   if (!snap.exists) {
     return { ok: false, code: "CONTENT_NOT_FOUND" };
   }
   const data = snap.data();
+  if (typeof data.brandId === "string" && data.brandId !== brandId) {
+    return { ok: false, code: "CONTENT_BRAND_MISMATCH" };
+  }
   const estadoActual = typeof data.estado === "string" ? data.estado : "";
   if (!esTransicionValida(estadoActual, ESTADO_CONTENIDO.APROBADO)) {
     return {
@@ -15534,6 +15609,7 @@ async function contenidoApprover(input) {
 }
 var ParamsSchema19 = import_zod54.z.object({
   tenantId: import_zod54.z.string().min(1).describe('Tenant identifier (the business account). Example: "your-tenant-id".'),
+  brandId: import_zod54.z.string().min(1).describe('Brand identifier within the tenant. Example: "your-brand-id".'),
   contenidoId: import_zod54.z.string().min(1).describe('Marketing content document id. Example: "BgAeOYTcPaQ0gglhK4PU".'),
   actor: import_zod54.z.object({
     uid: import_zod54.z.string().min(1).describe('User id who is approving. Example: "your-user-uid".'),
@@ -15550,7 +15626,7 @@ var SuccessSchema8 = import_zod54.z.object({
 });
 var FailureSchema8 = import_zod54.z.object({
   ok: import_zod54.z.literal(false),
-  code: import_zod54.z.enum(["CONTENT_NOT_FOUND", "INVALID_STATE_TRANSITION"]),
+  code: import_zod54.z.enum(["CONTENT_NOT_FOUND", "INVALID_STATE_TRANSITION", "CONTENT_BRAND_MISMATCH"]),
   estadoActual: import_zod54.z.string().optional()
 });
 var OutputSchema19 = import_zod54.z.discriminatedUnion("ok", [SuccessSchema8, FailureSchema8]);
@@ -15585,7 +15661,7 @@ var rawContract19 = {
     });
   },
   auditAction: "marketing.contenido.aprobar",
-  extractTargetPath: (input) => `tenants/${input.tenantId}/marketing_contenido/${input.contenidoId}`,
+  extractTargetPath: (input) => `tenants/${input.tenantId}/brands/${input.brandId}/marketing_contenido/${input.contenidoId}`,
   extractChanges: (_input, output) => ({
     before: output.ok ? { estado: output.estadoAnterior } : null,
     after: output.ok ? { estado: output.nuevoEstado } : null
@@ -15600,13 +15676,18 @@ var contenidoApproverContract = MartinContractSchema.parse(
   rawContract19
 );
 async function contenidoRejecter(input) {
-  const { db, tenantId, contenidoId, motivo, actor } = input;
-  const ref = db.collection("tenants").doc(tenantId).collection("marketing_contenido").doc(contenidoId);
+  const { db, tenantId, brandId, contenidoId, motivo, actor } = input;
+  const ref = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_contenido", contenidoId)
+  );
   const snap = await ref.get();
   if (!snap.exists) {
     return { ok: false, code: "CONTENT_NOT_FOUND" };
   }
   const data = snap.data();
+  if (typeof data.brandId === "string" && data.brandId !== brandId) {
+    return { ok: false, code: "CONTENT_BRAND_MISMATCH" };
+  }
   const estadoActual = typeof data.estado === "string" ? data.estado : "";
   if (!esTransicionValida(estadoActual, ESTADO_CONTENIDO.RECHAZADO)) {
     return {
@@ -15634,6 +15715,7 @@ async function contenidoRejecter(input) {
 }
 var ParamsSchema20 = import_zod55.z.object({
   tenantId: import_zod55.z.string().min(1).describe('Tenant identifier (the business account). Example: "your-tenant-id".'),
+  brandId: import_zod55.z.string().min(1).describe('Brand identifier within the tenant. Example: "your-brand-id".'),
   contenidoId: import_zod55.z.string().min(1).describe('Marketing content document id. Example: "BgAeOYTcPaQ0gglhK4PU".'),
   motivo: import_zod55.z.string().min(1).describe('Reason for rejection (required, surfaced to tenant in UI). Example: "tono no encaja con la marca".'),
   actor: import_zod55.z.object({
@@ -15652,7 +15734,7 @@ var SuccessSchema9 = import_zod55.z.object({
 });
 var FailureSchema9 = import_zod55.z.object({
   ok: import_zod55.z.literal(false),
-  code: import_zod55.z.enum(["CONTENT_NOT_FOUND", "INVALID_STATE_TRANSITION"]),
+  code: import_zod55.z.enum(["CONTENT_NOT_FOUND", "INVALID_STATE_TRANSITION", "CONTENT_BRAND_MISMATCH"]),
   estadoActual: import_zod55.z.string().optional()
 });
 var OutputSchema20 = import_zod55.z.discriminatedUnion("ok", [SuccessSchema9, FailureSchema9]);
@@ -15689,7 +15771,7 @@ var rawContract20 = {
     });
   },
   auditAction: "marketing.contenido.rechazar",
-  extractTargetPath: (input) => `tenants/${input.tenantId}/marketing_contenido/${input.contenidoId}`,
+  extractTargetPath: (input) => `tenants/${input.tenantId}/brands/${input.brandId}/marketing_contenido/${input.contenidoId}`,
   extractChanges: (_input, output) => ({
     before: output.ok ? { estado: output.estadoAnterior } : null,
     after: output.ok ? { estado: output.nuevoEstado, rechazadoMotivo: output.motivo } : null
@@ -15706,7 +15788,9 @@ var contenidoRejecterContract = MartinContractSchema.parse(
 async function photoBriefingWriter(input) {
   const { db, tenantId, brandId, semana, necesidades, actor } = input;
   const docId = `${tenantId}_${brandId}_${semana}`;
-  const ref = db.collection("tenants").doc(tenantId).collection("marketing_fotobriefings").doc(docId);
+  const ref = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_fotobriefings", docId)
+  );
   const snap = await ref.get();
   const existing = snap.exists ? snap.data() : null;
   const prevNecesidades = Array.isArray(existing?.necesidades) ? existing.necesidades : [];
@@ -15769,7 +15853,7 @@ async function photoBriefingWriter(input) {
   return {
     ok: true,
     briefingId: docId,
-    briefingPath: `tenants/${tenantId}/marketing_fotobriefings/${docId}`,
+    briefingPath: docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_fotobriefings", docId),
     totalNecesidades,
     totalCubiertas,
     necesidadesAgregadas: necesidades.length,
@@ -15822,7 +15906,7 @@ var rawContract21 = {
     });
   },
   auditAction: "marketing.foto_briefing.agregar",
-  extractTargetPath: (input) => `tenants/${input.tenantId}/marketing_fotobriefings/${input.tenantId}_${input.brandId}_${input.semana}`,
+  extractTargetPath: (input) => `tenants/${input.tenantId}/brands/${input.brandId}/marketing_fotobriefings/${input.tenantId}_${input.brandId}_${input.semana}`,
   extractChanges: (input, output) => ({
     before: null,
     // Helper no captura snapshot pre-merge.
@@ -15844,7 +15928,9 @@ var photoBriefingWriterContract = MartinContractSchema.parse(
 );
 async function tenantContextSetter(input) {
   const { db, tenantId, brandId } = input;
-  const brandConfigRef = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main");
+  const brandConfigRef = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  );
   const brandSnap = await brandConfigRef.get();
   if (brandSnap.exists) {
     const data = brandSnap.data();
@@ -15856,7 +15942,7 @@ async function tenantContextSetter(input) {
       brandDominio: typeof data.dominio === "string" ? data.dominio : null
     };
   }
-  const allBrandsSnap = await db.collection("tenants").doc(tenantId).collection("brands").get();
+  const allBrandsSnap = await db.collection(collectionPath({ kind: "tenant-nested", tenantId }, "brands")).get();
   if (allBrandsSnap.empty) {
     return {
       ok: false,
@@ -15947,13 +16033,18 @@ var tenantContextSetterContract = MartinContractSchema.parse(
   rawContract22
 );
 async function photoDescarter(input) {
-  const { db, tenantId, fotoId, actor } = input;
-  const ref = db.collection("tenants").doc(tenantId).collection("marketing_fotos").doc(fotoId);
+  const { db, tenantId, brandId, fotoId, actor } = input;
+  const ref = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_fotos", fotoId)
+  );
   const snap = await ref.get();
   if (!snap.exists) {
     return { ok: false, code: "FOTO_NOT_FOUND" };
   }
   const data = snap.data();
+  if (typeof data.brandId === "string" && data.brandId !== brandId) {
+    return { ok: false, code: "FOTO_BRAND_MISMATCH" };
+  }
   const estadoActual = typeof data.estado === "string" ? data.estado : "";
   if (!validarTransicionFoto(estadoActual, ESTADO_FOTO.DESCARTADA)) {
     return {
@@ -15979,6 +16070,7 @@ async function photoDescarter(input) {
 }
 var ParamsSchema23 = import_zod58.z.object({
   tenantId: import_zod58.z.string().min(1).describe('Tenant identifier (the business account). Example: "your-tenant-id".'),
+  brandId: import_zod58.z.string().min(1).describe('Brand identifier within the tenant. Example: "your-brand-id".'),
   fotoId: import_zod58.z.string().min(1).describe('Photo identifier. Example: "your-tenant_your-brand_1234567890_abcdef".'),
   actor: import_zod58.z.object({
     uid: import_zod58.z.string().min(1).describe('User id who is discarding. Example: "your-user-uid".'),
@@ -15995,7 +16087,7 @@ var SuccessSchema11 = import_zod58.z.object({
 });
 var FailureSchema11 = import_zod58.z.object({
   ok: import_zod58.z.literal(false),
-  code: import_zod58.z.enum(["FOTO_NOT_FOUND", "INVALID_STATE_TRANSITION"]),
+  code: import_zod58.z.enum(["FOTO_NOT_FOUND", "INVALID_STATE_TRANSITION", "FOTO_BRAND_MISMATCH"]),
   estadoActual: import_zod58.z.string().optional()
 });
 var OutputSchema23 = import_zod58.z.discriminatedUnion("ok", [SuccessSchema11, FailureSchema11]);
@@ -16030,7 +16122,7 @@ var rawContract23 = {
     });
   },
   auditAction: "marketing.foto.descartar",
-  extractTargetPath: (input) => `tenants/${input.tenantId}/marketing_fotos/${input.fotoId}`,
+  extractTargetPath: (input) => `tenants/${input.tenantId}/brands/${input.brandId}/marketing_fotos/${input.fotoId}`,
   extractChanges: (_input, output) => ({
     before: output.ok ? { estado: output.estadoAnterior } : null,
     after: output.ok ? { estado: output.nuevoEstado } : null
@@ -16045,13 +16137,18 @@ var photoDescarterContract = MartinContractSchema.parse(
   rawContract23
 );
 async function photoEditadaMarker(input) {
-  const { db, tenantId, fotoId, actor } = input;
-  const ref = db.collection("tenants").doc(tenantId).collection("marketing_fotos").doc(fotoId);
+  const { db, tenantId, brandId, fotoId, actor } = input;
+  const ref = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_fotos", fotoId)
+  );
   const snap = await ref.get();
   if (!snap.exists) {
     return { ok: false, code: "FOTO_NOT_FOUND" };
   }
   const data = snap.data();
+  if (typeof data.brandId === "string" && data.brandId !== brandId) {
+    return { ok: false, code: "FOTO_BRAND_MISMATCH" };
+  }
   const estadoActual = typeof data.estado === "string" ? data.estado : "";
   const archivoOriginal = typeof data.archivoOriginal === "string" ? data.archivoOriginal : null;
   if (!validarTransicionFoto(estadoActual, ESTADO_FOTO.EDITADA)) {
@@ -16083,6 +16180,7 @@ async function photoEditadaMarker(input) {
 }
 var ParamsSchema24 = import_zod59.z.object({
   tenantId: import_zod59.z.string().min(1).describe('Tenant identifier. Example: "your-tenant-id".'),
+  brandId: import_zod59.z.string().min(1).describe('Brand identifier within the tenant. Example: "your-brand-id".'),
   fotoId: import_zod59.z.string().min(1).describe('Photo identifier. Example: "your-tenant_your-brand_1234567890_abcdef".'),
   actor: import_zod59.z.object({
     uid: import_zod59.z.string().min(1).describe('User id who marks the photo. Example: "your-user-uid".'),
@@ -16100,7 +16198,7 @@ var SuccessSchema12 = import_zod59.z.object({
 });
 var FailureSchema12 = import_zod59.z.object({
   ok: import_zod59.z.literal(false),
-  code: import_zod59.z.enum(["FOTO_NOT_FOUND", "INVALID_STATE_TRANSITION", "FOTO_SIN_ARCHIVO_ORIGINAL"]),
+  code: import_zod59.z.enum(["FOTO_NOT_FOUND", "INVALID_STATE_TRANSITION", "FOTO_SIN_ARCHIVO_ORIGINAL", "FOTO_BRAND_MISMATCH"]),
   estadoActual: import_zod59.z.string().optional()
 });
 var OutputSchema24 = import_zod59.z.discriminatedUnion("ok", [SuccessSchema12, FailureSchema12]);
@@ -16135,7 +16233,7 @@ var rawContract24 = {
     });
   },
   auditAction: "marketing.foto.usar_tal_cual",
-  extractTargetPath: (input) => `tenants/${input.tenantId}/marketing_fotos/${input.fotoId}`,
+  extractTargetPath: (input) => `tenants/${input.tenantId}/brands/${input.brandId}/marketing_fotos/${input.fotoId}`,
   extractChanges: (_input, output) => ({
     before: output.ok ? { estado: output.estadoAnterior } : null,
     after: output.ok ? { estado: output.nuevoEstado, archivoEditado: output.archivoEditado } : null
@@ -16151,7 +16249,9 @@ var photoEditadaMarkerContract = MartinContractSchema.parse(
 );
 async function brandContextSetter(input) {
   const { db, tenantId, brandId } = input;
-  const brandRef = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main");
+  const brandRef = db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  );
   const brandSnap = await brandRef.get();
   if (!brandSnap.exists) {
     return {
@@ -16634,7 +16734,9 @@ var brandBriefBuilderContract = MartinContractSchema.parse(
   rawContract27
 );
 async function resolveLastImportId(db, tenantId, brandId) {
-  const configSnap = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main").get();
+  const configSnap = await db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  ).get();
   const brand = configSnap.data();
   const canalId = brand?.canalId;
   if (!canalId) return null;
@@ -16645,7 +16747,9 @@ async function resolveLastImportId(db, tenantId, brandId) {
 }
 async function marketingPlanBuilder(input) {
   const { db, tenantId, brandId } = input;
-  const configSnap = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main").get();
+  const configSnap = await db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  ).get();
   if (!configSnap.exists) {
     return { ok: false, error: `Brand "${brandId}" no encontrada`, code: "BRAND_NOT_FOUND" };
   }
@@ -16659,7 +16763,9 @@ async function marketingPlanBuilder(input) {
   }
   const productosQ = await db.collection("productos").where("tenantId", "==", tenantId).limit(100).get();
   const productos = productosQ.docs.map((d) => d.data());
-  const histQ = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_contenido").where("estado", "==", ESTADO_CONTENIDO.PUBLICADO).limit(20).get();
+  const histQ = await db.collection(
+    collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_contenido")
+  ).where("estado", "==", ESTADO_CONTENIDO.PUBLICADO).limit(20).get();
   const historial = histQ.docs.map((d) => d.data());
   const lastImportId = await resolveLastImportId(db, tenantId, brandId);
   let colecciones = [];
@@ -16704,7 +16810,9 @@ async function marketingPlanBuilder(input) {
     shopifyBlogs = Object.values(blogMap);
   }
   const existingBlogStrategy = brand.blogStrategy;
-  const seoSuggestionsCol = db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_suggestions_seo");
+  const seoSuggestionsCol = db.collection(
+    collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_suggestions_seo")
+  );
   const appliedSnap = await seoSuggestionsCol.where("intent", "==", "seo_meta").where("target.category", "==", "collection").where("estado", "==", "aplicada").get();
   const appliedChanges = [];
   for (const d of appliedSnap.docs) {
@@ -17197,10 +17305,11 @@ var rawContract29 = {
     after: output.ok ? {
       contenidoId: output.contenidoId,
       plataforma: output.plataforma,
-      tipo: input.tipo,
-      keyword: input.keyword,
-      fotoId: input.fotoId,
-      calendarioItemRef: input.calendarioItemRef,
+      // Firestore rechaza undefined — normalizamos a null cuando el caller omite.
+      tipo: input.tipo ?? null,
+      keyword: input.keyword ?? null,
+      fotoId: input.fotoId ?? null,
+      calendarioItemRef: input.calendarioItemRef ?? null,
       descartados: output.descartados,
       pipelineLinked: output.pipelineLinked
     } : null
@@ -17874,7 +17983,9 @@ async function slotAssetFinder(input) {
   const limit = input.limit ?? 5;
   const photoThreshold = deps.thresholds?.photos ?? DEFAULT_PHOTO_THRESHOLD;
   const shopifyThreshold = deps.thresholds?.shopify ?? DEFAULT_SHOPIFY_THRESHOLD;
-  const configSnap = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main").get();
+  const configSnap = await db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  ).get();
   if (!configSnap.exists) {
     return { ok: false, error: `Brand "${brandId}" no encontrada`, code: "BRAND_NOT_FOUND" };
   }
@@ -18079,7 +18190,9 @@ function cosineSimilarity(a, b) {
 async function canvaTemplateSelector(input) {
   const { db, tenantId, brandId, plataforma, tipoContenido, keyword, deps } = input;
   const threshold = deps.threshold ?? DEFAULT_SIMILARITY_THRESHOLD;
-  const configSnap = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main").get();
+  const configSnap = await db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  ).get();
   if (!configSnap.exists) {
     return { plantillaId: null, motivo: "brand_no_encontrada" };
   }
@@ -18314,12 +18427,14 @@ function instruccionesParaError(code, details, lang) {
 }
 async function photoDirectorPlan(input) {
   const { db, tenantId, brandId, fotoId, deps } = input;
-  const fotoQ = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_fotos").where("id", "==", fotoId).limit(1).get();
+  const fotoQ = await db.collection(collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_fotos")).where("id", "==", fotoId).limit(1).get();
   if (fotoQ.empty) {
     return { ok: false, code: "FOTO_NOT_FOUND", error: `Foto ${fotoId} no encontrada` };
   }
   const foto = fotoQ.docs[0].data();
-  const configSnap = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main").get();
+  const configSnap = await db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  ).get();
   const brand = configSnap.exists ? configSnap.data() : null;
   const brandBrief = (brand?.brandBrief ?? null) || {};
   const visualRules = brandBrief.visualRules ?? {};
@@ -18895,12 +19010,16 @@ Campos comunes de save_generated_content:
   tipo: string (del slot)
 `;
 async function buildTenantContext(db, tenantId, brandId) {
-  const configSnap = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main").get();
+  const configSnap = await db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  ).get();
   if (!configSnap.exists) return "";
   const brand = configSnap.data();
   const [fotosQ, contenidoQ, productosQ] = await Promise.all([
-    db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_fotos").where("estado", "==", ESTADO_FOTO.EDITADA).limit(10).get(),
-    db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_contenido").where("estado", "==", ESTADO_CONTENIDO.PUBLICADO).limit(10).get(),
+    db.collection(collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_fotos")).where("estado", "==", ESTADO_FOTO.EDITADA).limit(10).get(),
+    db.collection(
+      collectionPath({ kind: "brand-nested", tenantId, brandId }, "marketing_contenido")
+    ).where("estado", "==", ESTADO_CONTENIDO.PUBLICADO).limit(10).get(),
     db.collection("productos").where("tenantId", "==", tenantId).limit(50).get()
   ]);
   const fotosEditadas = fotosQ.docs.map((d) => d.data());
@@ -19109,7 +19228,9 @@ async function buildSystemPrompt(input) {
     const p2 = PARTE_2_REGLAS.replace("{{SHAPES_BLOCK}}", shapesBlock);
     return p1 + p2;
   }
-  const configSnap = await db.collection("tenants").doc(tenantId).collection("brands").doc(brandId).collection("marketing_config").doc("main").get();
+  const configSnap = await db.doc(
+    docPath({ kind: "brand-nested", tenantId, brandId }, "marketing_config", "main")
+  ).get();
   const brand = configSnap.exists ? configSnap.data() : null;
   let prompt = PARTE_1_IDENTIDAD.replace(
     "{{brand_nombre}}",
@@ -20244,7 +20365,7 @@ IMPORTANT \u2014 'razon' field: the tenant sees this in the app. Write in friend
         contract: photoDescarterContract,
         helper: photoDescarter,
         callable: callPhotoDescarter,
-        input: { tenantId, fotoId, actor },
+        input: { tenantId, brandId, fotoId, actor },
         ctx
       });
       let payload;
@@ -20282,7 +20403,7 @@ IMPORTANT \u2014 'razon' field: the tenant sees this in the app. Write in friend
         contract: photoEditadaMarkerContract,
         helper: photoEditadaMarker,
         callable: callPhotoEditadaMarker,
-        input: { tenantId, fotoId, actor },
+        input: { tenantId, brandId, fotoId, actor },
         ctx
       });
       let payload;
@@ -21094,7 +21215,7 @@ NUNCA uses update_calendar_slot para asignar fotos \u2014 eso escribe en la agen
         contract: contenidoApproverContract,
         helper: contenidoApprover,
         callable: callContenidoApprover,
-        input: { tenantId, contenidoId, actor },
+        input: { tenantId, brandId, contenidoId, actor },
         ctx
       });
       let payload;
@@ -21135,7 +21256,7 @@ NUNCA uses update_calendar_slot para asignar fotos \u2014 eso escribe en la agen
         contract: contenidoRejecterContract,
         helper: contenidoRejecter,
         callable: callContenidoRejecter,
-        input: { tenantId, contenidoId, motivo, actor },
+        input: { tenantId, brandId, contenidoId, motivo, actor },
         ctx
       });
       let payload;