@cgalaviz/easysell-mcp 0.4.0

package/dist/registry/super-admin.js

@@ -0,0 +1,222 @@
+/**
+ * Solo alcanzable con una key GLOBAL (T-IAM-09b): `SuperAdminGuard` rechaza
+ * cualquier key de tenant normal. No manda X-Tenant-Id — estas rutas son
+ * cross-tenant por diseño (administran empresas, no operan una).
+ *
+ * Fuera de este registro a propósito: impersonar (`POST/DELETE/GET
+ * .../impersonate`) es un mecanismo de cookie de sesión de navegador, no
+ * aplica a un cliente por API key — el mismo resultado se logra con una key
+ * global + el header X-Tenant-Id en cualquier tool de negocio normal.
+ */
+const ASSIGNABLE_ROLES = ["OWNER", "ADMIN", "VENDOR", "FINANCE", "CATALOG", "SUPPORT", "VIEWER"];
+/**
+ * Path del endpoint que `client.ts` usa como probe para detectar si la API
+ * key es GLOBAL (ver `probeKeyKind`). Exportado desde el registry para que
+ * un rename o mudanza aquí no rompa el probe silenciosamente (antes estaba
+ * hardcodeado en client.ts y eso significaba que el aviso de "key global"
+ * en main.ts dejaba de aparecer si esto se renombraba).
+ */
+export const SUPER_ADMIN_OVERVIEW_PATH = "/super-admin/overview";
+export const superAdminRoutes = [
+    {
+        name: "super_admin_overview",
+        method: "GET",
+        path: SUPER_ADMIN_OVERVIEW_PATH,
+        description: "Agregados de toda la plataforma: conteos de empresas, usuarios distintos, invitaciones pendientes y uso del mes en curso.",
+        scopes: [],
+    },
+    {
+        name: "super_admin_list_users",
+        method: "GET",
+        path: "/super-admin/users",
+        description: "Busca usuarios a través de todas las empresas.",
+        scopes: [],
+        query: { q: { type: "string" } },
+    },
+    {
+        name: "super_admin_list_tenants",
+        method: "GET",
+        path: "/super-admin/tenants",
+        description: "Lista todas las empresas (tenants) de la plataforma.",
+        scopes: [],
+    },
+    {
+        name: "super_admin_get_tenant",
+        method: "GET",
+        path: "/super-admin/tenants/:id",
+        description: "Detalle de una empresa por id.",
+        scopes: [],
+        pathParams: { id: { type: "string" } },
+    },
+    {
+        name: "super_admin_tenant_usage",
+        method: "GET",
+        path: "/super-admin/tenants/:id/usage",
+        description: "Consumo/costo de una empresa en un rango de fechas.",
+        scopes: [],
+        pathParams: { id: { type: "string" } },
+        query: { from: { type: "string", description: "Fecha ISO." }, to: { type: "string", description: "Fecha ISO." } },
+    },
+    {
+        name: "super_admin_create_tenant",
+        method: "POST",
+        path: "/super-admin/tenants",
+        description: "Da de alta una empresa nueva, con su primer OWNER (se le manda invitación por correo).",
+        scopes: [],
+        body: {
+            name: { type: "string", required: true },
+            slug: { type: "string", required: true, description: "Minúsculas, números y guion." },
+            ownerEmail: { type: "string", required: true },
+            ownerFullName: { type: "string", required: true },
+        },
+    },
+    {
+        name: "super_admin_update_tenant",
+        method: "PATCH",
+        path: "/super-admin/tenants/:id",
+        description: "Renombra una empresa. Nota: el backend audita esto con el usuario en sesión; con una key global " +
+            "(sin sesión humana) el actor de auditoría puede quedar vacío.",
+        scopes: [],
+        pathParams: { id: { type: "string" } },
+        body: { name: { type: "string" } },
+    },
+    {
+        name: "super_admin_update_tenant_status",
+        method: "PATCH",
+        path: "/super-admin/tenants/:id/status",
+        description: "Activa o desactiva una empresa (DISABLED bloquea el acceso de todo su equipo).",
+        scopes: [],
+        destructiveHint: true,
+        pathParams: { id: { type: "string" } },
+        body: { status: { type: "string", required: true, enum: ["ACTIVE", "DISABLED"] } },
+    },
+    {
+        name: "super_admin_invite_member",
+        method: "POST",
+        path: "/super-admin/tenants/:id/invitations",
+        description: "Invita a alguien a una empresa con cualquier rol, incluido OWNER (el super-admin no tiene el límite de jerarquía de un admin normal).",
+        scopes: [],
+        pathParams: { id: { type: "string" } },
+        body: {
+            email: { type: "string", required: true },
+            fullName: { type: "string", required: true },
+            role: { type: "string", required: true, enum: ASSIGNABLE_ROLES },
+        },
+    },
+    {
+        name: "super_admin_revoke_invitation",
+        method: "DELETE",
+        path: "/super-admin/tenants/:id/invitations/:invitationId",
+        description: "Cancela una invitación pendiente.",
+        scopes: [],
+        pathParams: { id: { type: "string" }, invitationId: { type: "string" } },
+    },
+    {
+        name: "super_admin_update_membership",
+        method: "PATCH",
+        path: "/super-admin/tenants/:id/memberships/:membershipId",
+        description: "Cambia el rol o el estado (ACTIVE/DISABLED) de un miembro de una empresa.",
+        scopes: [],
+        destructiveHint: true,
+        pathParams: { id: { type: "string" }, membershipId: { type: "string" } },
+        body: {
+            role: { type: "string", enum: ASSIGNABLE_ROLES },
+            status: { type: "string", enum: ["ACTIVE", "DISABLED"] },
+        },
+    },
+    {
+        name: "super_admin_remove_membership",
+        method: "DELETE",
+        path: "/super-admin/tenants/:id/memberships/:membershipId",
+        description: "Quita a alguien de una empresa (lo pasa a DISABLED; no borra la fila).",
+        scopes: [],
+        pathParams: { id: { type: "string" }, membershipId: { type: "string" } },
+    },
+    {
+        name: "super_admin_list_tenant_api_keys",
+        method: "GET",
+        path: "/super-admin/tenants/:id/api-keys",
+        description: "Lista las API keys de una empresa concreta (mismo dato que vería el OWNER de esa empresa).",
+        scopes: [],
+        pathParams: { id: { type: "string" } },
+    },
+    {
+        name: "super_admin_create_tenant_api_key",
+        method: "POST",
+        path: "/super-admin/tenants/:id/api-keys",
+        description: "Emite una API key para una empresa concreta, con los scopes que se indiquen (soporte/onboarding en nombre del tenant).",
+        scopes: [],
+        pathParams: { id: { type: "string" } },
+        body: {
+            name: { type: "string", required: true },
+            scopes: { type: "array", required: true, items: { type: "string" } },
+            expiresInDays: { type: "number", description: "1 a 730." },
+        },
+    },
+    {
+        name: "super_admin_revoke_tenant_api_key",
+        method: "DELETE",
+        path: "/super-admin/tenants/:id/api-keys/:keyId",
+        description: "Revoca una API key de una empresa concreta.",
+        scopes: [],
+        pathParams: { id: { type: "string" }, keyId: { type: "string" } },
+    },
+    {
+        name: "super_admin_list_global_api_keys",
+        method: "GET",
+        path: "/super-admin/api-keys",
+        description: "Lista las API keys globales (sin tenant, con todos los scopes) de la plataforma.",
+        scopes: [],
+    },
+    {
+        name: "super_admin_create_global_api_key",
+        method: "POST",
+        path: "/super-admin/api-keys",
+        description: "Emite una nueva key global. Siempre lleva TODOS los scopes (no configurable) — es la master key de la " +
+            "plataforma. El backend exige sesión de super-admin HUMANO para esto: una key global no puede emitir " +
+            "más keys globales por sí sola, así que esta llamada falla con una key global y necesita sesión de panel.",
+        scopes: [],
+        destructiveHint: true,
+        body: {
+            name: { type: "string", required: true },
+            expiresInDays: { type: "number", description: "1 a 730. Sin esto, no vence." },
+        },
+    },
+    {
+        name: "super_admin_revoke_global_api_key",
+        method: "DELETE",
+        path: "/super-admin/api-keys/:id",
+        description: "Revoca una key global. Mismo requisito de sesión humana que crearla.",
+        scopes: [],
+        destructiveHint: true,
+        pathParams: { id: { type: "string" } },
+    },
+    {
+        name: "super_admin_usage_summary",
+        method: "GET",
+        path: "/super-admin/usage",
+        description: "Resumen de uso/costo cross-tenant: tokens y USD por tenant en un rango. " +
+            "Sin tenantId, agrega a todos los tenants; con tenantId filtra a uno. " +
+            "Útil para facturación interna y para detectar anomalías. Solo key GLOBAL.",
+        scopes: [],
+        query: {
+            tenantId: { type: "string", description: "UUID de un tenant concreto; sin él, todos." },
+            from: { type: "string", description: "Fecha ISO, inclusive." },
+            to: { type: "string", description: "Fecha ISO, inclusive." },
+        },
+    },
+    {
+        name: "super_admin_usage_detail",
+        method: "GET",
+        path: "/super-admin/usage/detail",
+        description: "Drill-down de uso: desglose día × modelo de un tenant en un rango. tenantId es REQUERIDO " +
+            "(sin él el backend responde 400). Solo key GLOBAL.",
+        scopes: [],
+        query: {
+            tenantId: { type: "string", required: true, description: "UUID del tenant a detallar." },
+            from: { type: "string", description: "Fecha ISO, inclusive." },
+            to: { type: "string", description: "Fecha ISO, inclusive." },
+        },
+    },
+];
+//# sourceMappingURL=super-admin.js.map

package/dist/registry/super-admin.js.map

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

package/dist/registry/tenants.d.ts

@@ -0,0 +1,13 @@
+import type { RouteDef } from "./types.js";
+/**
+ * Auto-administración del propio tenant (`/tenants/me/...`):
+ * branding, parámetros comerciales, logo, contexto del agente. Es la
+ * "configuración del sistema" que el MCP necesita para que el agente
+ * sepa qué tenant es, qué税率 aplica, qué plantillas de WhatsApp usar, etc.
+ *
+ * Fuera de este registro a propósito:
+ * - `tenants/me/delivery-zones`: vive en `shipping.ts` (es de catálogo).
+ * - `tenants/me/canned-responses`: vive en `canned-responses.ts`.
+ */
+export declare const tenantRoutes: RouteDef[];
+//# sourceMappingURL=tenants.d.ts.map

package/dist/registry/tenants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.d.ts","sourceRoot":"","sources":["../../src/registry/tenants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,EAqElC,CAAC"}

package/dist/registry/tenants.js

@@ -0,0 +1,78 @@
+/**
+ * Auto-administración del propio tenant (`/tenants/me/...`):
+ * branding, parámetros comerciales, logo, contexto del agente. Es la
+ * "configuración del sistema" que el MCP necesita para que el agente
+ * sepa qué tenant es, qué税率 aplica, qué plantillas de WhatsApp usar, etc.
+ *
+ * Fuera de este registro a propósito:
+ * - `tenants/me/delivery-zones`: vive en `shipping.ts` (es de catálogo).
+ * - `tenants/me/canned-responses`: vive en `canned-responses.ts`.
+ */
+export const tenantRoutes = [
+    {
+        name: "tenants_me_get",
+        method: "GET",
+        path: "/tenants/me",
+        description: "Detalle del propio tenant (nombre, slug, status, configVersion).",
+        scopes: ["tenant.admin"],
+    },
+    {
+        name: "tenants_me_agent_context",
+        method: "GET",
+        path: "/tenants/me/agent-context",
+        description: "Contexto mínimo que el agente necesita para responder: nombre, branding, plantillas de " +
+            "WhatsApp,税率, link de checkout por defecto. Lectura ligera pensada para cargarse al " +
+            "inicio de cada sesión. Requiere catalog.read (no tenant.admin) — pensado para que " +
+            "incluso un VENDOR pueda llamar al agente sin permisos administrativos.",
+        scopes: ["catalog.read"],
+    },
+    {
+        name: "tenants_me_update_branding",
+        method: "PATCH",
+        path: "/tenants/me/branding",
+        description: "Actualiza el branding visual del tenant (logo URL, colores primario/secundario/acento).",
+        scopes: ["tenant.admin"],
+        body: {
+            logoUrl: { type: "string", description: "URL absoluta del logo (http/https)." },
+            primaryColor: { type: "string", description: "Color hex, formato #rrggbb." },
+            secondaryColor: { type: "string", description: "Color hex, formato #rrggbb." },
+            accentColor: { type: "string", description: "Color hex, formato #rrggbb." },
+        },
+    },
+    {
+        name: "tenants_me_update_settings",
+        method: "PATCH",
+        path: "/tenants/me/settings",
+        description: "Actualiza parámetros comerciales del tenant (taxRatePct, shippingFlat, validez de cotizaciones " +
+            "y checkouts, tope de descuento del vendedor, recordatorios de cotización, plantillas de " +
+            "WhatsApp aprobadas por Meta). Cada PATCH incrementa `configVersion`, lo que invalida caches " +
+            "del agente. Todos los campos opcionales — solo se aplica lo enviado.",
+        scopes: ["tenant.admin"],
+        body: {
+            taxRatePct: { type: "number", description: "0 a 100, hasta 2 decimales." },
+            shippingFlat: { type: "number", description: "Tarifa plana de envío cuando no hay zona, hasta 2 decimales." },
+            quoteValidityHours: { type: "number", description: "Validez de cotizaciones en horas (1 a 8760 = 1 año)." },
+            quickPayValidityHours: { type: "number", description: "Validez del link de pago rápido en horas (1 a 8760)." },
+            checkoutReservationMinutes: { type: "number", description: "Reserva del link de checkout en minutos (5 a 43200 = 30 días)." },
+            maxSellerDiscountPct: { type: "number", description: "0 a 100; tope de descuento que un VENDOR puede aplicar." },
+            quoteReminderEnabled: { type: "boolean" },
+            quoteReminderEveryHours: { type: "number", description: "1 a 720." },
+            quoteReminderMaxCount: { type: "number", description: "0 a 10." },
+            whatsappTemplates: {
+                type: "any",
+                description: "Mapa de clave interna a plantilla aprobada por Meta: " +
+                    "{ QUOTE_REMINDER: { name: \"recordatorio_cotizacion\", language: \"es_MX\" } }. " +
+                    "{} borra todas.",
+            },
+        },
+    },
+    {
+        name: "tenants_me_remove_logo",
+        method: "DELETE",
+        path: "/tenants/me/logo",
+        description: "Quita el logo del tenant (vuelve al placeholder).",
+        scopes: ["tenant.admin"],
+        destructiveHint: true,
+    },
+];
+//# sourceMappingURL=tenants.js.map

package/dist/registry/tenants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.js","sourceRoot":"","sources":["../../src/registry/tenants.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC;QACE,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,kEAAkE;QAC/E,MAAM,EAAE,CAAC,cAAc,CAAC;KACzB;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,yFAAyF;YACzF,qFAAqF;YACrF,oFAAoF;YACpF,wEAAwE;QAC1E,MAAM,EAAE,CAAC,cAAc,CAAC;KACzB;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,yFAAyF;QACtG,MAAM,EAAE,CAAC,cAAc,CAAC;QACxB,IAAI,EAAE;YACJ,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;YAC/E,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;YAC5E,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;YAC9E,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;SAC5E;KACF;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,iGAAiG;YACjG,0FAA0F;YAC1F,8FAA8F;YAC9F,sEAAsE;QACxE,MAAM,EAAE,CAAC,cAAc,CAAC;QACxB,IAAI,EAAE;YACJ,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;YAC1E,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8DAA8D,EAAE;YAC7G,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sDAAsD,EAAE;YAC3G,qBAAqB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sDAAsD,EAAE;YAC9G,0BAA0B,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gEAAgE,EAAE;YAC7H,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yDAAyD,EAAE;YAChH,oBAAoB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACzC,uBAAuB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE;YACpE,qBAAqB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE;YACjE,iBAAiB,EAAE;gBACjB,IAAI,EAAE,KAAK;gBACX,WAAW,EACT,uDAAuD;oBACvD,kFAAkF;oBAClF,iBAAiB;aACpB;SACF;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,mDAAmD;QAChE,MAAM,EAAE,CAAC,cAAc,CAAC;QACxB,eAAe,EAAE,IAAI;KACtB;CACF,CAAC"}

package/dist/registry/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * DSL declarativo para describir una ruta HTTP de commerce-api como una
+ * herramienta MCP. Un `RouteDef` por endpoint; `buildTool()` (ver tools.ts)
+ * lo convierte en un `ZodRawShape` de entrada y en el handler que arma la
+ * petición HTTP real. Mantener esto declarativo (en vez de una función a
+ * mano por endpoint) es lo que hace manejable cubrir ~90 rutas: cada
+ * definición son unas líneas de datos, no código repetido.
+ */
+export type Field = {
+    type: "string";
+    required?: boolean;
+    description?: string;
+    enum?: readonly string[];
+} | {
+    type: "number";
+    required?: boolean;
+    description?: string;
+} | {
+    type: "boolean";
+    required?: boolean;
+    description?: string;
+} | {
+    type: "array";
+    required?: boolean;
+    description?: string;
+    items: Field;
+} | {
+    type: "object";
+    required?: boolean;
+    description?: string;
+    fields: Record<string, Field>;
+} | {
+    type: "any";
+    required?: boolean;
+    description?: string;
+};
+export interface RouteDef {
+    /** Nombre de la herramienta MCP, snake_case, único. */
+    name: string;
+    method: "GET" | "POST" | "PATCH" | "DELETE";
+    /** Ruta con placeholders `:param`, relativa a `COMMERCE_API_BASE_URL` (sin incluir /api/v1). */
+    path: string;
+    description: string;
+    /**
+     * Scope(s) de commerce-api que exige el endpoint. `[]` significa "no
+     * requiere scope adicional al de estar autenticado" — se permite
+     * explícitamente para no obligar a mentir con un placeholder
+     * (`["_none"]` etc.). Solo informativo: el servidor real hace el 403 si
+     * falta (ver `apps/commerce-api/src/auth/principal.guard.ts`).
+     */
+    scopes: readonly string[];
+    pathParams?: Record<string, Field>;
+    query?: Record<string, Field>;
+    body?: Record<string, Field>;
+    /**
+     * Sobrescribe el `destructiveHint` que `tools.ts` deriva por default del
+     * método HTTP (`DELETE` → true, el resto → false). Márcalo `true` a mano
+     * en un POST/PATCH que tenga un efecto real difícil de deshacer: cobra
+     * dinero, cancela/desactiva algo, o manda un mensaje real a un cliente.
+     * Clientes MCP que respetan las `ToolAnnotations` (Claude Desktop, Claude
+     * Code) usan esto para decidir si piden confirmación antes de llamar la
+     * tool — es la señal, no una barrera dura: el servidor no bloquea nada
+     * por su cuenta, eso lo sigue haciendo commerce-api con scopes.
+     */
+    destructiveHint?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/registry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,KAAK,GACb;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;CAAE,GAG3F;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,QAAQ;IACvB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7B;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/dist/registry/types.js

@@ -0,0 +1,10 @@
+/**
+ * DSL declarativo para describir una ruta HTTP de commerce-api como una
+ * herramienta MCP. Un `RouteDef` por endpoint; `buildTool()` (ver tools.ts)
+ * lo convierte en un `ZodRawShape` de entrada y en el handler que arma la
+ * petición HTTP real. Mantener esto declarativo (en vez de una función a
+ * mano por endpoint) es lo que hace manejable cubrir ~90 rutas: cada
+ * definición son unas líneas de datos, no código repetido.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/registry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/registry/uploads.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTenantUploads(server: McpServer): void;
+//# sourceMappingURL=uploads.d.ts.map

package/dist/registry/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["../../src/registry/uploads.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6E7D"}

package/dist/registry/uploads.js

@@ -0,0 +1,86 @@
+/**
+ * Uploads multipart que no son fotos de catálogo: logo del tenant. No
+ * encajan en el DSL declarativo de `types.ts` (pensado para JSON), así que
+ * se registran a mano aquí con `apiUpload`.
+ *
+ * Lo que NO está aquí a propósito:
+ * - Constancia fiscal de cliente (PDF con campos extra en el mismo
+ *   multipart): el backend espera `multipart/form-data` con `file` +
+ *   campos de texto opcionales, y `apiUpload` solo soporta el archivo.
+ *   Agregarlo requiere extender el cliente; mientras tanto, sube la
+ *   constancia desde el panel del tenant y usa `customers_update` para
+ *   fijar RFC/legalName/etc. sin PDF.
+ * - Fotos de catálogo (producto/variante): viven en `catalog-images.ts`
+ *   porque tienen reglas de validación distintas y es lo que justifica
+ *   separar este archivo por dominio.
+ */
+import { z } from "zod";
+import { apiUpload } from "../client.js";
+const logoInputShape = {
+    fileBase64: z.string().describe("Contenido del logo codificado en base64."),
+    filename: z.string().describe("Nombre del archivo, p. ej. \"logo.png\"."),
+    mimeType: z.string().describe("image/png, image/jpeg, image/webp o image/svg+xml."),
+};
+export function registerTenantUploads(server) {
+    server.registerTool("tenants_me_upload_logo", {
+        description: "Sube el logo del propio tenant. PNG/JPG/WebP/SVG, entre 128×128 y 4096×4096 px, máximo 2 MB. " +
+            "Reemplaza el logo actual. Requiere scope: tenant.admin.",
+        inputSchema: logoInputShape,
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
+    }, async ({ fileBase64, filename, mimeType }) => {
+        const result = await apiUpload("/tenants/me/logo", {
+            base64: fileBase64,
+            filename,
+            mimeType,
+        });
+        return {
+            isError: !result.ok,
+            content: [{ type: "text", text: JSON.stringify({ status: result.status, data: result.data }, null, 2) }],
+        };
+    });
+    // La constancia fiscal NO está implementada como tool: el backend espera
+    // multipart con archivo + campos de texto opcionales, y `apiUpload` solo
+    // soporta el archivo. Mejor devolver un error claro y accionable que
+    // pretender que funciona — un cliente MCP que llame esto recibe
+    // instrucciones precisas en vez de un fallo opaco del backend.
+    server.registerTool("customers_upload_constancia", {
+        description: "PLACEHOLDER: la subida de constancia fiscal de cliente NO está soportada por el MCP. " +
+            "El backend (`POST /customers/:id/fiscal/constancia`) espera multipart/form-data con " +
+            "el PDF + campos de texto opcionales (rfc/legalName/postalCode/regimenFiscal/cfdiUse), " +
+            "y el cliente HTTP del MCP solo soporta uploads de archivo único. " +
+            "Para subir la constancia, usa el panel del tenant. Para fijar datos fiscales " +
+            "manualmente sin PDF, usa `customers_update` con expectedVersion + legalName + " +
+            "fiscalPostalCode + fiscalCfdiUse + fiscalRegimenFiscal.",
+        inputSchema: {
+            id: z.string().describe("id del cliente (UUID)"),
+            fileBase64: z.string().describe("IGNORADO — usar el panel del tenant."),
+            filename: z.string().describe("IGNORADO."),
+            rfc: z.string().optional(),
+            legalName: z.string().optional(),
+            postalCode: z.string().optional(),
+            regimenFiscal: z.string().optional(),
+            cfdiUse: z.string().optional(),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    }, async () => {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        status: 0,
+                        data: {
+                            error: "NOT_SUPPORTED",
+                            message: "La subida de constancia fiscal con campos opcionales no está expuesta por el MCP. " +
+                                "El backend exige multipart/form-data con archivo + campos de texto, lo que requiere " +
+                                "extender el cliente HTTP. Mientras tanto, sube la constancia desde el panel del tenant " +
+                                "y usa `customers_update` para fijar RFC/legalName/etc. sin PDF.",
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=uploads.js.map

package/dist/registry/uploads.js.map

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

package/dist/registry/usage.d.ts

@@ -0,0 +1,9 @@
+import type { RouteDef } from "./types.js";
+/**
+ * `usage.controller.ts` también expone `GET /super-admin/usage` y
+ * `GET /super-admin/usage/detail`, pero viven bajo `SuperAdminGuard`
+ * (cross-tenant, requiere sesión de super-admin): una API key de tenant no
+ * puede pasar ese guard nunca, así que no se incluyen aquí.
+ */
+export declare const usageRoutes: RouteDef[];
+//# sourceMappingURL=usage.d.ts.map

package/dist/registry/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/registry/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,EAyBjC,CAAC"}

package/dist/registry/usage.js

@@ -0,0 +1,33 @@
+/**
+ * `usage.controller.ts` también expone `GET /super-admin/usage` y
+ * `GET /super-admin/usage/detail`, pero viven bajo `SuperAdminGuard`
+ * (cross-tenant, requiere sesión de super-admin): una API key de tenant no
+ * puede pasar ese guard nunca, así que no se incluyen aquí.
+ */
+export const usageRoutes = [
+    {
+        name: "usage_record_event",
+        method: "POST",
+        path: "/usage/events",
+        description: "Reporta un consumo de tokens/costo (uso interno de agentes; no exige scope, solo tenant autenticado).",
+        scopes: [],
+        body: {
+            model: { type: "string", required: true },
+            inputTokens: { type: "number", required: true },
+            outputTokens: { type: "number", required: true },
+            costUsd: { type: "string", required: true, description: "Decimal, hasta 6 posiciones." },
+        },
+    },
+    {
+        name: "usage_summary",
+        method: "GET",
+        path: "/usage/summary",
+        description: "Resumen de consumo/costo del tenant en un rango de fechas. Requiere tenant.admin (solo OWNER).",
+        scopes: ["tenant.admin"],
+        query: {
+            from: { type: "string", description: "Fecha ISO." },
+            to: { type: "string", description: "Fecha ISO." },
+        },
+    },
+];
+//# sourceMappingURL=usage.js.map

package/dist/registry/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/registry/usage.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAe;IACrC;QACE,IAAI,EAAE,oBAAoB;QAC1B,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,uGAAuG;QACpH,MAAM,EAAE,EAAE;QACV,IAAI,EAAE;YACJ,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;YACzC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC/C,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;YAChD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,8BAA8B,EAAE;SACzF;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,gGAAgG;QAC7G,MAAM,EAAE,CAAC,cAAc,CAAC;QACxB,KAAK,EAAE;YACL,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;YACnD,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;SAClD;KACF;CACF,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RouteDef } from "./registry/types.js";
+/** `ZodRawShape` de entrada de la tool: path params (siempre requeridos), query y body, todo al mismo nivel. */
+export declare function routeInputShape(route: RouteDef): z.ZodRawShape;
+export declare function registerRoute(server: McpServer, route: RouteDef): void;
+export declare function registerRoutes(server: McpServer, routes: RouteDef[]): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AA+C3D,gHAAgH;AAChH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,CAAC,CAAC,WAAW,CAe9D;AAsED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAiBtE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAS1E"}