ponch-mcp-server 1.0.21 → 1.0.23

package/dist/schemas/marketing/calendario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendario.d.ts","sourceRoot":"","sources":["../../../src/schemas/marketing/calendario.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;gCAKjB,CAAC;AACjB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAUjB,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAKnB,CAAC;AAMjB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCASb,CAAC;AAEjB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/schemas/marketing/calendario.js

@@ -0,0 +1,60 @@
+/**
+ * mcp-server/src/schemas/marketing/calendario.ts
+ *
+ * Schemas Zod para marketing_calendario y sus items.
+ *
+ * Sub-deuda 2.5 (sesion 176B).
+ */
+import { z } from 'zod';
+const ESTADOS_CALENDARIO_ITEM = [
+    'planificado', 'pre_aprobado', 'generado', 'revisar',
+    'aprobado', 'publicado', 'rechazado',
+];
+const PLATAFORMAS = ['gbp', 'shopify_blog', 'instagram', 'review'];
+const TIPOS_CONTENIDO = ['post', 'blog', 'carousel', 'reel', 'story', 'review_response'];
+// ═══════════════════════════════════════════════════════════
+// NOTA DEL CALENDARIO (sub-objeto reutilizable)
+// ═══════════════════════════════════════════════════════════
+export const NotaCalendarioSchema = z.object({
+    texto: z.string().min(1),
+    fecha: z.string(),
+    autorId: z.string(),
+    autorNombre: z.string(),
+}).passthrough();
+// ═══════════════════════════════════════════════════════════
+// CALENDARIO ITEM (un slot)
+// ═══════════════════════════════════════════════════════════
+export const CalendarioItemSchema = z.object({
+    dia: z.string().nullable().optional(),
+    plataforma: z.enum(PLATAFORMAS).nullable().optional(),
+    tipo: z.enum(TIPOS_CONTENIDO).nullable().optional(),
+    keyword: z.string().nullable().optional(),
+    tema: z.string().nullable().optional(),
+    productoId: z.string().nullable().optional(),
+    estado: z.enum(ESTADOS_CALENDARIO_ITEM),
+    contenidoRef: z.string().nullable().optional(),
+    notas: z.array(NotaCalendarioSchema).optional(),
+}).passthrough();
+// ═══════════════════════════════════════════════════════════
+// SEMANA (sub-objeto del calendario)
+// ═══════════════════════════════════════════════════════════
+export const SemanaCalendarioSchema = z.object({
+    numero: z.number().int().positive(),
+    fechaInicio: z.string().optional(),
+    fechaFin: z.string().optional(),
+    items: z.array(CalendarioItemSchema).optional(),
+}).passthrough();
+// ═══════════════════════════════════════════════════════════
+// CALENDARIO RAIZ
+// ═══════════════════════════════════════════════════════════
+export const CalendarioSchema = z.object({
+    id: z.string().min(1, 'id es obligatorio'),
+    tenantId: z.string().min(1, 'tenantId es obligatorio'),
+    brandId: z.string().min(1, 'brandId es obligatorio'),
+    mes: z.string().regex(/^\d{4}-\d{2}$/, 'mes debe ser formato YYYY-MM').nullable(),
+    semanas: z.array(SemanaCalendarioSchema).optional(),
+    creadoAt: z.unknown().nullable().optional(),
+    creadoPorId: z.string().nullable().optional(),
+    updatedAt: z.unknown().nullable().optional(),
+}).passthrough();
+//# sourceMappingURL=calendario.js.map

package/dist/schemas/marketing/calendario.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendario.js","sourceRoot":"","sources":["../../../src/schemas/marketing/calendario.ts"],"names":[],"mappings":"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"}

package/dist/schemas/marketing/collectionSuggestions.d.ts

@@ -0,0 +1,274 @@
+/**
+ * mcp-server/src/schemas/marketing/collectionSuggestions.ts
+ *
+ * Schemas Zod para sugerencias SEO de colecciones de Shopify.
+ *
+ * Vive en marketing_config.brands[brandId].collectionSuggestions.{collectionId}
+ * Generado por Cowork via save_collection_suggestions.
+ *
+ * DEUDA 2 expandida (sesion 176B): collection suggestions migradas con
+ * reglas de negocio (max chars de meta title/description, etc).
+ */
+import { z } from 'zod';
+/**
+ * Una sola sugerencia de colección. Strict en max lengths
+ * (Google las trunca y la UI los marca como overflow).
+ *
+ * SEO best practices 2026:
+ *  - meta title 50-60 chars (max 600px width)
+ *  - meta description 120-158 chars (mobile 120, desktop 158)
+ *  - image alt < 125 chars (Google Images limit)
+ */
+export declare const CollectionSuggestionInputSchema: z.ZodObject<{
+    collectionId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    suggestedTitle: z.ZodOptional<z.ZodString>;
+    suggestedDescription: z.ZodOptional<z.ZodString>;
+    suggestedMetaTitle: z.ZodOptional<z.ZodString>;
+    suggestedMetaDescription: z.ZodOptional<z.ZodString>;
+    suggestedHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    suggestedImageAlt: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodString>;
+    notas: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    collectionId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    suggestedTitle: z.ZodOptional<z.ZodString>;
+    suggestedDescription: z.ZodOptional<z.ZodString>;
+    suggestedMetaTitle: z.ZodOptional<z.ZodString>;
+    suggestedMetaDescription: z.ZodOptional<z.ZodString>;
+    suggestedHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    suggestedImageAlt: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodString>;
+    notas: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    collectionId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    suggestedTitle: z.ZodOptional<z.ZodString>;
+    suggestedDescription: z.ZodOptional<z.ZodString>;
+    suggestedMetaTitle: z.ZodOptional<z.ZodString>;
+    suggestedMetaDescription: z.ZodOptional<z.ZodString>;
+    suggestedHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    suggestedImageAlt: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodString>;
+    notas: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type CollectionSuggestionInput = z.infer<typeof CollectionSuggestionInputSchema>;
+/**
+ * Array de sugerencias (lo que viene en el parametro `suggestions`).
+ */
+export declare const CollectionSuggestionsInputArraySchema: z.ZodArray<z.ZodObject<{
+    collectionId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    suggestedTitle: z.ZodOptional<z.ZodString>;
+    suggestedDescription: z.ZodOptional<z.ZodString>;
+    suggestedMetaTitle: z.ZodOptional<z.ZodString>;
+    suggestedMetaDescription: z.ZodOptional<z.ZodString>;
+    suggestedHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    suggestedImageAlt: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodString>;
+    notas: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    collectionId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    suggestedTitle: z.ZodOptional<z.ZodString>;
+    suggestedDescription: z.ZodOptional<z.ZodString>;
+    suggestedMetaTitle: z.ZodOptional<z.ZodString>;
+    suggestedMetaDescription: z.ZodOptional<z.ZodString>;
+    suggestedHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    suggestedImageAlt: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodString>;
+    notas: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    collectionId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    suggestedTitle: z.ZodOptional<z.ZodString>;
+    suggestedDescription: z.ZodOptional<z.ZodString>;
+    suggestedMetaTitle: z.ZodOptional<z.ZodString>;
+    suggestedMetaDescription: z.ZodOptional<z.ZodString>;
+    suggestedHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    suggestedImageAlt: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodString>;
+    notas: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>, "many">;
+export type CollectionSuggestionsInputArray = z.infer<typeof CollectionSuggestionsInputArraySchema>;
+/**
+ * Una sugerencia tal como queda guardada en Firestore.
+ * Tiene campos extra que el tool agrega: estado, generadoAt, generadoPor, appliedFields.
+ * Útil si en el futuro queremos validar lecturas del doc.
+ */
+export declare const CollectionSuggestionStoredSchema: z.ZodObject<{
+    collectionId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    suggestedTitle: z.ZodOptional<z.ZodString>;
+    suggestedDescription: z.ZodOptional<z.ZodString>;
+    suggestedMetaTitle: z.ZodOptional<z.ZodString>;
+    suggestedMetaDescription: z.ZodOptional<z.ZodString>;
+    suggestedHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    suggestedImageAlt: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodString>;
+    notas: z.ZodOptional<z.ZodString>;
+} & {
+    estado: z.ZodEnum<["pendiente", "rechazado", "aplicado_parcial", "aplicado_total"]>;
+    generadoAt: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate, z.ZodObject<{
+        seconds: z.ZodNumber;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        seconds: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        seconds: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">>]>>;
+    generadoPor: z.ZodOptional<z.ZodString>;
+    appliedFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        before: z.ZodUnknown;
+        after: z.ZodUnknown;
+        appliedAt: z.ZodUnion<[z.ZodString, z.ZodDate, z.ZodObject<{
+            seconds: z.ZodNumber;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">>]>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        before: z.ZodUnknown;
+        after: z.ZodUnknown;
+        appliedAt: z.ZodUnion<[z.ZodString, z.ZodDate, z.ZodObject<{
+            seconds: z.ZodNumber;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">>]>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        before: z.ZodUnknown;
+        after: z.ZodUnknown;
+        appliedAt: z.ZodUnion<[z.ZodString, z.ZodDate, z.ZodObject<{
+            seconds: z.ZodNumber;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">>]>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    collectionId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    suggestedTitle: z.ZodOptional<z.ZodString>;
+    suggestedDescription: z.ZodOptional<z.ZodString>;
+    suggestedMetaTitle: z.ZodOptional<z.ZodString>;
+    suggestedMetaDescription: z.ZodOptional<z.ZodString>;
+    suggestedHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    suggestedImageAlt: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodString>;
+    notas: z.ZodOptional<z.ZodString>;
+} & {
+    estado: z.ZodEnum<["pendiente", "rechazado", "aplicado_parcial", "aplicado_total"]>;
+    generadoAt: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate, z.ZodObject<{
+        seconds: z.ZodNumber;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        seconds: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        seconds: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">>]>>;
+    generadoPor: z.ZodOptional<z.ZodString>;
+    appliedFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        before: z.ZodUnknown;
+        after: z.ZodUnknown;
+        appliedAt: z.ZodUnion<[z.ZodString, z.ZodDate, z.ZodObject<{
+            seconds: z.ZodNumber;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">>]>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        before: z.ZodUnknown;
+        after: z.ZodUnknown;
+        appliedAt: z.ZodUnion<[z.ZodString, z.ZodDate, z.ZodObject<{
+            seconds: z.ZodNumber;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">>]>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        before: z.ZodUnknown;
+        after: z.ZodUnknown;
+        appliedAt: z.ZodUnion<[z.ZodString, z.ZodDate, z.ZodObject<{
+            seconds: z.ZodNumber;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">>]>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    collectionId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    suggestedTitle: z.ZodOptional<z.ZodString>;
+    suggestedDescription: z.ZodOptional<z.ZodString>;
+    suggestedMetaTitle: z.ZodOptional<z.ZodString>;
+    suggestedMetaDescription: z.ZodOptional<z.ZodString>;
+    suggestedHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    suggestedImageAlt: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodString>;
+    notas: z.ZodOptional<z.ZodString>;
+} & {
+    estado: z.ZodEnum<["pendiente", "rechazado", "aplicado_parcial", "aplicado_total"]>;
+    generadoAt: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate, z.ZodObject<{
+        seconds: z.ZodNumber;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        seconds: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        seconds: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">>]>>;
+    generadoPor: z.ZodOptional<z.ZodString>;
+    appliedFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        before: z.ZodUnknown;
+        after: z.ZodUnknown;
+        appliedAt: z.ZodUnion<[z.ZodString, z.ZodDate, z.ZodObject<{
+            seconds: z.ZodNumber;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">>]>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        before: z.ZodUnknown;
+        after: z.ZodUnknown;
+        appliedAt: z.ZodUnion<[z.ZodString, z.ZodDate, z.ZodObject<{
+            seconds: z.ZodNumber;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">>]>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        before: z.ZodUnknown;
+        after: z.ZodUnknown;
+        appliedAt: z.ZodUnion<[z.ZodString, z.ZodDate, z.ZodObject<{
+            seconds: z.ZodNumber;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            seconds: z.ZodNumber;
+        }, z.ZodTypeAny, "passthrough">>]>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type CollectionSuggestionStored = z.infer<typeof CollectionSuggestionStoredSchema>;
+export type CollectionSuggestionsValidationResult = {
+    ok: true;
+    parsed: CollectionSuggestionsInputArray;
+} | {
+    ok: false;
+    error: string;
+    path: string;
+    received: unknown;
+    example: unknown;
+};
+/**
+ * Valida un array de collection suggestions con reglas de negocio.
+ */
+export declare function validateCollectionSuggestions(value: unknown): CollectionSuggestionsValidationResult;
+export declare const COLLECTION_SUGGESTION_EXAMPLE: {
+    collectionId: number;
+    suggestedTitle: string;
+    suggestedDescription: string;
+    suggestedMetaTitle: string;
+    suggestedMetaDescription: string;
+    suggestedHandle: null;
+    suggestedImageAlt: string;
+    keyword: string;
+    notas: string;
+}[];
+//# sourceMappingURL=collectionSuggestions.d.ts.map

package/dist/schemas/marketing/collectionSuggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectionSuggestions.d.ts","sourceRoot":"","sources":["../../../src/schemas/marketing/collectionSuggestions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCA4B5B,CAAC;AAEjB,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCAAuF,CAAC;AAC1I,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAMpG;;;;GAIG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAiB7B,CAAC;AACjB,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAM1F,MAAM,MAAM,qCAAqC,GAC7C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,+BAA+B,CAAA;CAAE,GACrD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEN;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,qCAAqC,CAiBvC;AAmBD,eAAO,MAAM,6BAA6B;;;;;;;;;;GAYzC,CAAC"}

package/dist/schemas/marketing/collectionSuggestions.js

@@ -0,0 +1,125 @@
+/**
+ * mcp-server/src/schemas/marketing/collectionSuggestions.ts
+ *
+ * Schemas Zod para sugerencias SEO de colecciones de Shopify.
+ *
+ * Vive en marketing_config.brands[brandId].collectionSuggestions.{collectionId}
+ * Generado por Cowork via save_collection_suggestions.
+ *
+ * DEUDA 2 expandida (sesion 176B): collection suggestions migradas con
+ * reglas de negocio (max chars de meta title/description, etc).
+ */
+import { z } from 'zod';
+// ═══════════════════════════════════════════════════════════
+// SCHEMA INPUT (lo que Cowork manda a save_collection_suggestions)
+// ═══════════════════════════════════════════════════════════
+/**
+ * Una sola sugerencia de colección. Strict en max lengths
+ * (Google las trunca y la UI los marca como overflow).
+ *
+ * SEO best practices 2026:
+ *  - meta title 50-60 chars (max 600px width)
+ *  - meta description 120-158 chars (mobile 120, desktop 158)
+ *  - image alt < 125 chars (Google Images limit)
+ */
+export const CollectionSuggestionInputSchema = z.object({
+    collectionId: z.union([z.string(), z.number()], {
+        errorMap: () => ({ message: 'collectionId debe ser string o number (ID de Shopify, no GID)' }),
+    }),
+    suggestedTitle: z.string().min(1).max(120).optional()
+        .describe('H1 de la página. Keyword al inicio.'),
+    suggestedDescription: z.string().min(1).optional()
+        .describe('HTML 200-400 palabras. Incluir links internos.'),
+    suggestedMetaTitle: z.string().min(1).max(60, 'meta title NO debe exceder 60 chars (Google trunca)').optional()
+        .describe('50-60 chars. Keyword al inicio. Formato: {Keyword} | {Brand}'),
+    suggestedMetaDescription: z.string().min(1).max(158, 'meta description NO debe exceder 158 chars (Google trunca)').optional()
+        .describe('120-158 chars. Keyword + CTA + value prop'),
+    suggestedHandle: z.string().nullable().optional()
+        .describe('Solo cambiar si el handle actual es malo. null = no cambiar (preserva URL indexado)'),
+    suggestedImageAlt: z.string().min(1).max(125, 'image alt NO debe exceder 125 chars (Google Images)').optional()
+        .describe('Descriptivo con keyword. Accesibilidad + Google Images + AEO'),
+    keyword: z.string().min(1).optional()
+        .describe('Keyword target de esta colección (del plan de marketing)'),
+    notas: z.string().optional()
+        .describe('Explicación breve de qué cambiaste y por qué'),
+}).passthrough();
+/**
+ * Array de sugerencias (lo que viene en el parametro `suggestions`).
+ */
+export const CollectionSuggestionsInputArraySchema = z.array(CollectionSuggestionInputSchema).min(1, 'Debe enviar al menos 1 sugerencia');
+// ═══════════════════════════════════════════════════════════
+// SCHEMA STORED (como queda en Firestore con meta agregada)
+// ═══════════════════════════════════════════════════════════
+/**
+ * Una sugerencia tal como queda guardada en Firestore.
+ * Tiene campos extra que el tool agrega: estado, generadoAt, generadoPor, appliedFields.
+ * Útil si en el futuro queremos validar lecturas del doc.
+ */
+export const CollectionSuggestionStoredSchema = CollectionSuggestionInputSchema.extend({
+    estado: z.enum(['pendiente', 'rechazado', 'aplicado_parcial', 'aplicado_total']),
+    generadoAt: z.union([
+        z.string(),
+        z.date(),
+        z.object({ seconds: z.number() }).passthrough(),
+    ]).optional(),
+    generadoPor: z.string().optional(),
+    appliedFields: z.record(z.object({
+        before: z.unknown(),
+        after: z.unknown(),
+        appliedAt: z.union([
+            z.string(),
+            z.date(),
+            z.object({ seconds: z.number() }).passthrough(),
+        ]),
+    }).passthrough()).optional(),
+}).passthrough();
+/**
+ * Valida un array de collection suggestions con reglas de negocio.
+ */
+export function validateCollectionSuggestions(value) {
+    const result = CollectionSuggestionsInputArraySchema.safeParse(value);
+    if (result.success) {
+        return { ok: true, parsed: result.data };
+    }
+    const firstError = result.error.errors[0];
+    const path = ['suggestions', ...firstError.path].join('.');
+    const received = getValueAtPath(value, firstError.path);
+    return {
+        ok: false,
+        error: firstError.message,
+        path,
+        received,
+        example: COLLECTION_SUGGESTION_EXAMPLE,
+    };
+}
+function getValueAtPath(obj, path) {
+    let current = obj;
+    for (const key of path) {
+        if (current == null)
+            return current;
+        if (typeof current === 'object') {
+            current = current[key];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+// ═══════════════════════════════════════════════════════════
+// EJEMPLO HUMAN-READABLE
+// ═══════════════════════════════════════════════════════════
+export const COLLECTION_SUGGESTION_EXAMPLE = [
+    {
+        collectionId: 471581688126,
+        suggestedTitle: 'Flores Moradas | Envío CDMX',
+        suggestedDescription: '<p>Descubre nuestra colección de flores moradas con rosas, tulipanes y lirios...</p>',
+        suggestedMetaTitle: 'Flores Moradas CDMX | Envío Mismo Día',
+        suggestedMetaDescription: 'Envía flores moradas a domicilio en CDMX. Arreglos frescos con rosas, tulipanes y lirios. Entrega el mismo día.',
+        suggestedHandle: null,
+        suggestedImageAlt: 'Ramo de flores moradas con rosas y tulipanes - Ponch florería CDMX',
+        keyword: 'flores moradas cdmx',
+        notas: 'Meta title con keyword local. Description con long-tail. Handle preservado.',
+    },
+];
+//# sourceMappingURL=collectionSuggestions.js.map

package/dist/schemas/marketing/collectionSuggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectionSuggestions.js","sourceRoot":"","sources":["../../../src/schemas/marketing/collectionSuggestions.ts"],"names":[],"mappings":"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"}