Telegram Bot Starter

Learn more at \n \n https://docs.val.town/integrations/telegram/

`,\n { status: 200, headers: { \"content-type\": \"text/html\" } },\n );\n};",[70],"66c91a2da341d395ffd91fd9f1453bc769409c1b6ef8c8a4539ed947b2265727",{"_69":141,"_71":-7,"_73":142},{"_69":133,"_71":-7,"_73":134},{"_69":124,"_71":-7,"_73":125},{"_69":115,"_71":-7,"_73":116},{"_69":105,"_71":-7,"_73":106},"types.ts",{"_32":107,"_13":105,"_76":108,"_78":-5,"_79":57,"_80":109,"_81":26,"_34":110,"_40":22,"_84":111,"_86":112,"_64":48,"_88":-5,"_89":-7,"_69":113,"_91":114},"c175f06d-1216-492e-98e4-975f5e2f686b","db63b358-862c-11f1-b5bf-1607ee4eb77e",3,["D",1784766264211],"script","// Tipos del dominio de la despensa\n\nexport type MetodoPago = \"efectivo\" | \"transferencia\";\nexport type TipoMovimiento = \"venta\" | \"gasto\";\nexport type TipoFiado = \"fiado\" | \"pago\";\n\nexport interface MovimientoCaja {\n descripcion: string;\n tipo: TipoMovimiento;\n metodoPago: MetodoPago;\n monto: number;\n fecha: string; // ISO string\n}\n\nexport interface Producto {\n categoria?: string;\n codigo_barras?: string;\n marca?: string;\n nombre: string;\n precio_compra?: number;\n precio_venta: number;\n stock_actual: number;\n stock_minimo: number;\n stock_maximo?: number;\n}\n\nexport interface MovimientoFiado {\n tipo: TipoFiado;\n monto: number;\n fecha: string; // ISO string\n}\n\nexport interface ClienteFiado {\n nombre: string;\n movs?: Record;\n}\n\n// Tipo que Claude devuelve al interpretar un mensaje\nexport interface Intent {\n accion:\n | \"consultar_ventas_hoy\"\n | \"consultar_caja_hoy\"\n | \"stock_bajo\"\n | \"buscar_producto\"\n | \"consultar_fiados\"\n | \"registrar_venta\"\n | \"modificar_precio\"\n | \"registrar_gasto\"\n | \"no_entendido\";\n params: {\n nombre?: string;\n producto?: string;\n cantidad?: number;\n metodoPago?: MetodoPago;\n cliente?: string;\n nuevo_precio?: number;\n descripcion?: string;\n monto?: number;\n mensaje?: string;\n };\n}\n",[105],"3dfa8e1fef572660789121b143342c731009a9fe3844252129131fc47deecd40","intents.ts",{"_32":117,"_13":115,"_76":118,"_78":-5,"_79":57,"_80":119,"_81":26,"_34":120,"_40":22,"_84":111,"_86":121,"_64":48,"_88":-5,"_89":-7,"_69":122,"_91":123},"896402e0-3bfc-4839-a300-1ef16b4ef32d","07cf053c-862d-11f1-a3a9-1607ee4eb77e",5,["D",1784766338775],"// Manejadores de intenciones — cada función ejecuta la acción contra Firebase\n// y devuelve un mensaje en español listo para enviar por Telegram\n\nimport { fbGet, fbPatch, fbPost } from \"./firebase.ts\";\nimport type {\n ClienteFiado,\n Intent,\n MetodoPago,\n MovimientoCaja,\n Producto,\n} from \"./types.ts\";\n\n// ─── Helpers ────────────────────────────────────────────────\n\nconst money = (n: number) => `$${n.toLocaleString(\"es-AR\")}`;\n\n/** Devuelve YYYY-MM-DD de hoy en zona horaria local */\nfunction todayStr(): string {\n return new Date().toISOString().slice(0, 10);\n}\n\n/** Filtra movimientos cuya fecha empieza con hoy */\nfunction isToday(fecha: string): boolean {\n return fecha.startsWith(todayStr());\n}\n\n/** Busca productos por nombre (parcial, case-insensitive) */\nfunction buscarProductos(\n productos: Record | null,\n query: string,\n): Array<[string, Producto]> {\n if (!productos) return [];\n const q = query.toLowerCase().trim();\n return Object.entries(productos).filter(([, p]) =>\n p.nombre.toLowerCase().includes(q) ||\n (p.marca ?? \"\").toLowerCase().includes(q)\n );\n}\n\n// ─── Intent: consultar_ventas_hoy ───────────────────────────\n\nasync function consultarVentasHoy(): Promise {\n const movs = await fbGet>(\"/caja/movs\");\n if (!movs) return \"📭 No hay movimientos registrados.\";\n\n const ventasHoy = Object.entries(movs)\n .filter(([, m]) => m.tipo === \"venta\" && isToday(m.fecha));\n\n if (ventasHoy.length === 0) {\n return \"📭 No se registraron ventas hoy.\";\n }\n\n const total = ventasHoy.reduce((sum, [, m]) => sum + m.monto, 0);\n const lineas = ventasHoy.map(([, m]) =>\n ` • ${m.descripcion} — ${money(m.monto)} (${m.metodoPago})`\n ).join(\"\\n\");\n\n return `📊 *Ventas de hoy*\\n${lineas}\\n\\n💰 *Total: ${money(total)}*`;\n}\n\n// ─── Intent: consultar_caja_hoy ─────────────────────────────\n\nasync function consultarCajaHoy(): Promise {\n const movs = await fbGet>(\"/caja/movs\");\n if (!movs) return \"📭 No hay movimientos registrados.\";\n\n const movsHoy = Object.entries(movs)\n .filter(([, m]) => isToday(m.fecha));\n\n if (movsHoy.length === 0) {\n return \"📭 No hay movimientos de caja hoy.\";\n }\n\n const porMetodo: Record = {\n efectivo: { ventas: 0, gastos: 0 },\n transferencia: { ventas: 0, gastos: 0 },\n };\n\n for (const [, m] of movsHoy) {\n const bucket = porMetodo[m.metodoPago] ?? porMetodo.efectivo;\n if (m.tipo === \"venta\") bucket.ventas += m.monto;\n else bucket.gastos += m.monto;\n }\n\n const efectivoNeto = porMetodo.efectivo.ventas - porMetodo.efectivo.gastos;\n const transfNeto = porMetodo.transferencia.ventas -\n porMetodo.transferencia.gastos;\n const total = efectivoNeto + transfNeto;\n\n return `📊 *Caja de hoy*\n\n💵 *Efectivo*\n Ventas: ${money(porMetodo.efectivo.ventas)}\n Gastos: ${money(porMetodo.efectivo.gastos)}\n Neto: ${money(efectivoNeto)}\n\n🏦 *Transferencia*\n Ventas: ${money(porMetodo.transferencia.ventas)}\n Gastos: ${money(porMetodo.transferencia.gastos)}\n Neto: ${money(transfNeto)}\n\n💰 *Total general: ${money(total)}*`;\n}\n\n// ─── Intent: stock_bajo ─────────────────────────────────────\n\nasync function stockBajo(): Promise {\n const productos = await fbGet>(\n \"/stock/productos\",\n );\n if (!productos) return \"📭 No hay productos registrados.\";\n\n const bajos = Object.entries(productos)\n .filter(([, p]) => p.stock_actual <= p.stock_minimo);\n\n if (bajos.length === 0) {\n return \"✅ No hay productos con stock bajo.\";\n }\n\n const lineas = bajos.map(([, p]) => {\n const alerta = p.stock_actual === 0 ? \"🚫 SIN STOCK\" : \"⚠️ BAJO\";\n return ` ${alerta} ${p.nombre} (${p.marca ?? \"s/m\"}) — actual: ${p.stock_actual}, mínimo: ${p.stock_minimo}`;\n }).join(\"\\n\");\n\n return `📦 *Productos con stock bajo* (${bajos.length})\\n${lineas}`;\n}\n\n// ─── Intent: buscar_producto ────────────────────────────────\n\nasync function buscarProducto(nombre: string): Promise {\n const productos = await fbGet>(\n \"/stock/productos\",\n );\n const resultados = buscarProductos(productos, nombre);\n\n if (resultados.length === 0) {\n return `🔍 No encontré productos con \"${nombre}\".`;\n }\n\n const lineas = resultados.map(([, p]) =>\n ` • ${p.nombre} (${p.marca ?? \"s/m\"}) — Precio: ${money(p.precio_venta)} | Stock: ${p.stock_actual}/${p.stock_minimo}`\n ).join(\"\\n\");\n\n return `🔍 *Resultados para \"${nombre}\"*\\n${lineas}`;\n}\n\n// ─── Intent: consultar_fiados ───────────────────────────────\n\nasync function consultarFiados(cliente?: string): Promise {\n const clientes = await fbGet>(\n \"/fiados/clientes\",\n );\n if (!clientes) return \"📭 No hay clientes con fiados registrados.\";\n\n if (cliente) {\n // Buscar cliente específico (match parcial, case-insensitive)\n const q = cliente.toLowerCase().trim();\n const encontrados = Object.entries(clientes)\n .filter(([, c]) => c.nombre.toLowerCase().includes(q));\n\n if (encontrados.length === 0) {\n return `🔍 No encontré al cliente \"${cliente}\".`;\n }\n if (encontrados.length > 1) {\n const nombres = encontrados.map(([, c]) => c.nombre).join(\", \");\n return `🔍 Encontré varios: ${nombres}. Se más específico.`;\n }\n\n const [id, c] = encontrados[0];\n const movs = c.movs ?? {};\n const movEntries = Object.entries(movs);\n const saldo = movEntries.reduce((sum, [, m]) =>\n m.tipo === \"fiado\" ? sum + m.monto : sum - m.monto, 0);\n\n const lineas = movEntries.length > 0\n ? movEntries.map(([, m]) =>\n ` • ${m.tipo === \"fiado\" ? \"🔴 Fiado\" : \"🟢 Pago\"} — ${money(m.monto)} (${m.fecha.slice(0, 10)})`\n ).join(\"\\n\")\n : \" Sin movimientos.\";\n\n return `👤 *${c.nombre}*\\n${lineas}\\n\\n💰 *Saldo: ${money(saldo)}*`;\n }\n\n // Listar todos los fiados\n const resumen = Object.entries(clientes).map(([, c]) => {\n const movs = c.movs ?? {};\n const saldo = Object.values(movs).reduce((sum, m) =>\n m.tipo === \"fiado\" ? sum + m.monto : sum - m.monto, 0);\n return { nombre: c.nombre, saldo };\n });\n\n const conSaldo = resumen.filter((r) => r.saldo > 0);\n const totalGeneral = resumen.reduce((sum, r) => sum + r.saldo, 0);\n\n if (conSaldo.length === 0) {\n return \"✅ Nadie te debe. Todos los fiados están saldados.\";\n }\n\n conSaldo.sort((a, b) => b.saldo - a.saldo);\n\n const lineas = conSaldo.map((r) =>\n ` • ${r.nombre} — ${money(r.saldo)}`\n ).join(\"\\n\");\n\n return `📋 *Fiados pendientes*\\n${lineas}\\n\\n💰 *Total adeudado: ${money(totalGeneral)}*`;\n}\n\n// ─── Intent: registrar_venta ────────────────────────────────\n\nasync function registrarVenta(\n producto: string,\n cantidad: number,\n metodoPago: MetodoPago,\n): Promise {\n const productos = await fbGet>(\n \"/stock/productos\",\n );\n const resultados = buscarProductos(productos, producto);\n\n if (resultados.length === 0) {\n return `❌ No encontré el producto \"${producto}\".`;\n }\n if (resultados.length > 1) {\n const nombres = resultados.map(([, p]) => p.nombre).join(\", \");\n return `🔍 Encontré varios: ${nombres}. Se más específico.`;\n }\n\n const [id, p] = resultados[0];\n\n if (p.stock_actual < cantidad) {\n return `❌ Stock insuficiente. ${p.nombre}: stock actual ${p.stock_actual}, pediste ${cantidad}.`;\n }\n\n const monto = p.precio_venta * cantidad;\n const nuevoStock = p.stock_actual - cantidad;\n\n // 1) Restar stock (PATCH en el path específico del producto)\n await fbPatch(`/stock/productos/${id}`, { stock_actual: nuevoStock });\n\n // 2) Agregar movimiento de caja (POST crea un nuevo push ID)\n const mov: MovimientoCaja = {\n descripcion: `${cantidad}x ${p.nombre}`,\n tipo: \"venta\",\n metodoPago,\n monto,\n fecha: new Date().toISOString(),\n };\n await fbPost(\"/caja/movs\", mov as unknown as Record);\n\n return `✅ *Venta registrada*\n📦 ${cantidad}x ${p.nombre} (${p.marca ?? \"s/m\"})\n💵 ${money(monto)} — ${metodoPago}\n📊 Stock restante: ${nuevoStock}`;\n}\n\n// ─── Intent: modificar_precio ───────────────────────────────\n\nasync function modificarPrecio(\n producto: string,\n nuevoPrecio: number,\n): Promise {\n const productos = await fbGet>(\n \"/stock/productos\",\n );\n const resultados = buscarProductos(productos, producto);\n\n if (resultados.length === 0) {\n return `❌ No encontré el producto \"${producto}\".`;\n }\n if (resultados.length > 1) {\n const nombres = resultados.map(([, p]) => p.nombre).join(\", \");\n return `🔍 Encontré varios: ${nombres}. Se más específico.`;\n }\n\n const [id, p] = resultados[0];\n const precioAnterior = p.precio_venta;\n\n await fbPatch(`/stock/productos/${id}`, { precio_venta: nuevoPrecio });\n\n return `✅ *Precio actualizado*\n📦 ${p.nombre} (${p.marca ?? \"s/m\"})\n📉 Antes: ${money(precioAnterior)}\n📈 Ahora: ${money(nuevoPrecio)}`;\n}\n\n// ─── Intent: registrar_gasto ────────────────────────────────\n\nasync function registrarGasto(\n descripcion: string,\n monto: number,\n metodoPago: MetodoPago,\n): Promise {\n const mov: MovimientoCaja = {\n descripcion,\n tipo: \"gasto\",\n metodoPago,\n monto,\n fecha: new Date().toISOString(),\n };\n await fbPost(\"/caja/movs\", mov as unknown as Record);\n\n return `✅ *Gasto registrado*\n📝 ${descripcion}\n💵 ${money(monto)} — ${metodoPago}`;\n}\n\n// ─── Dispatcher ─────────────────────────────────────────────\n\n/** Ejecuta el intent y devuelve un mensaje formateado para Telegram */\nexport async function ejecutarIntent(intent: Intent): Promise {\n const p = intent.params;\n\n switch (intent.accion) {\n case \"consultar_ventas_hoy\":\n return await consultarVentasHoy();\n\n case \"consultar_caja_hoy\":\n return await consultarCajaHoy();\n\n case \"stock_bajo\":\n return await stockBajo();\n\n case \"buscar_producto\":\n if (!p.nombre) return \"❌ Falta el nombre del producto.\";\n return await buscarProducto(p.nombre);\n\n case \"consultar_fiados\":\n return await consultarFiados(p.cliente);\n\n case \"registrar_venta\":\n if (!p.producto) return \"❌ Falta el nombre del producto.\";\n return await registrarVenta(\n p.producto,\n p.cantidad ?? 1,\n p.metodoPago ?? \"efectivo\",\n );\n\n case \"modificar_precio\":\n if (!p.producto) return \"❌ Falta el nombre del producto.\";\n if (!p.nuevo_precio) return \"❌ Falta el nuevo precio.\";\n return await modificarPrecio(p.producto, p.nuevo_precio);\n\n case \"registrar_gasto\":\n if (!p.descripcion) return \"❌ Falta la descripción del gasto.\";\n if (!p.monto) return \"❌ Falta el monto del gasto.\";\n return await registrarGasto(\n p.descripcion,\n p.monto,\n p.metodoPago ?? \"efectivo\",\n );\n\n case \"no_entendido\":\n return `🤔 No te entendí. ${p.mensaje ?? \"\"}\\n\\nPuedo ayudarte con:\\n• Consultar ventas o caja de hoy\\n• Stock bajo\\n• Buscar productos\\n• Fiados\\n• Registrar ventas o gastos\\n• Modificar precios`;\n\n default:\n return `❌ Acción no reconocida: ${intent.accion}`;\n }\n}\n",[115],"3026f7fbfcd40055ac20d45e62b6be6c94574ba28904a11bb0ca97457cf7c723","grok.ts",{"_32":126,"_13":124,"_76":127,"_78":-5,"_79":57,"_80":128,"_81":26,"_34":129,"_40":83,"_84":111,"_86":130,"_64":48,"_88":-5,"_89":-7,"_69":131,"_91":132},"252636ef-adc8-4104-aa34-3d0d59cf5e40","74475924-8634-11f1-9aea-1607ee4eb77e",18,["D",1784769567276],"// grok.ts - interpreta el mensaje del usuario usando la API de Grok (xAI)\n// Reemplaza a claude.ts. La API de xAI es compatible con el formato de OpenAI.\n\nfunction systemPrompt(fechaHoy: string) {\n return `Sos el traductor de mensajes para el bot de \"Mi Kiosco\", un kiosco/despensa.\nTu única tarea es convertir el mensaje del dueño en un JSON de acción. NUNCA respondas\ncon texto explicativo, markdown, ni backticks. SOLO el JSON.\n\nFormato de salida (siempre este shape):\n{\"intent\": \"NOMBRE_INTENT\", \"params\": { ... }}\n\nIntents disponibles:\n- consultar_ventas_hoy -> params: {}\n- consultar_caja -> params: {}\n- consultar_stock_bajo -> params: {}\n- buscar_producto -> params: {\"nombre\": \"texto a buscar\"}\n- consultar_fiados -> params: {\"cliente\": \"nombre\"} (vacío {} para listar todos)\n- registrar_venta -> params: {\"producto\": \"nombre\", \"cantidad\": n, \"metodoPago\": \"efectivo\"|\"transferencia\"}\n- modificar_precio -> params: {\"producto\": \"nombre\", \"nuevoPrecio\": n}\n- registrar_gasto -> params: {\"descripcion\": \"texto\", \"monto\": n, \"metodoPago\": \"efectivo\"|\"transferencia\"}\n- desconocido -> params: {} (si el mensaje no encaja en ningún intent de arriba)\n\nFecha de hoy (Argentina): ${fechaHoy}`;\n}\n\nexport async function interpretarMensaje(mensaje: string) {\n const fechaHoy = new Date().toLocaleDateString(\"es-AR\", {\n timeZone: \"America/Argentina/Buenos_Aires\",\n });\n\n const response = await fetch(\"https://api.x.ai/v1/chat/completions\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n Authorization: `Bearer ${Deno.env.get(\"XAI_API_KEY\")}`,\n },\n body: JSON.stringify({\n model: \"grok-4.3\",\n messages: [\n { role: \"system\", content: systemPrompt(fechaHoy) },\n { role: \"user\", content: mensaje },\n ],\n max_tokens: 300,\n }),\n });\n\n if (!response.ok) {\n const errText = await response.text();\n throw new Error(`Grok API error (${response.status}): ${errText}`);\n }\n\n const data = await response.json();\n const raw = (data.choices?.[0]?.message?.content || \"{}\").replace(\n /```json|```/g,\n \"\",\n ).trim();\n\n try {\n const parsed = JSON.parse(raw);\n if (!parsed.intent) throw new Error(\"sin intent\");\n return parsed;\n } catch {\n return { intent: \"desconocido\", params: {} };\n }\n}",[124],"58b87c77030827d26086db84932ba96a52e60fc5a705ba0d06ae2837ebca3f44","firebase.ts",{"_32":135,"_13":133,"_76":136,"_78":-5,"_79":57,"_80":83,"_81":26,"_34":137,"_40":22,"_84":111,"_86":138,"_64":48,"_88":-5,"_89":-7,"_69":139,"_91":140},"5ade5bbb-d2fe-43a4-b041-6952065e5184","db5da526-862c-11f1-9dbb-1607ee4eb77e",["D",1784766264210],"// Cliente de Firebase Realtime Database usando REST API + service account JWT\n// No usa firebase-admin SDK — solo fetch + crypto para firmar el JWT\n\nimport { createSign } from \"node:crypto\";\n\ninterface ServiceAccount {\n client_email: string;\n private_key: string;\n token_uri: string;\n project_id: string;\n}\n\nconst DB_URL = Deno.env.get(\"FIREBASE_DATABASE_URL\")!;\nconst SCOPE = \"https://www.googleapis.com/auth/firebase.database\";\n\n// Cache del access token\nlet cachedToken: string | null = null;\nlet tokenExpiry = 0;\n\nfunction getServiceAccount(): ServiceAccount {\n const raw = Deno.env.get(\"FIREBASE_SERVICE_ACCOUNT_JSON\");\n if (!raw) throw new Error(\"FIREBASE_SERVICE_ACCOUNT_JSON no está configurada\");\n return JSON.parse(raw);\n}\n\n/** Crea un JWT firmado con RS256 usando la private key de la service account */\nfunction createSignedJwt(\n payload: Record,\n privateKeyPem: string,\n): string {\n const header = { alg: \"RS256\", typ: \"JWT\" };\n const b64url = (obj: unknown) =>\n btoa(JSON.stringify(obj)).replace(/\\+/g, \"-\").replace(/\\//g, \"_\")\n .replace(/=+$/, \"\");\n\n const encodedHeader = b64url(header);\n const encodedPayload = b64url(payload);\n const signingInput = `${encodedHeader}.${encodedPayload}`;\n\n const signer = createSign(\"RSA-SHA256\");\n signer.update(signingInput);\n // La private key viene con \\n literales en el JSON — los convertimos a reales\n const key = privateKeyPem.replace(/\\\\n/g, \"\\n\");\n const signature = signer.sign(key, \"base64url\");\n\n return `${signingInput}.${signature}`;\n}\n\n/** Obtiene un access token de Google OAuth2 intercambiando un JWT */\nasync function getAccessToken(): Promise {\n const now = Math.floor(Date.now() / 1000);\n if (cachedToken && now < tokenExpiry - 60) {\n return cachedToken;\n }\n\n const sa = getServiceAccount();\n\n const payload = {\n iss: sa.client_email,\n scope: SCOPE,\n aud: sa.token_uri,\n iat: now,\n exp: now + 3600,\n };\n\n const jwt = createSignedJwt(payload, sa.private_key);\n\n const resp = await fetch(sa.token_uri, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n body: new URLSearchParams({\n grant_type: \"urn:ietf:params:oauth:grant-type:jwt-bearer\",\n assertion: jwt,\n }),\n });\n\n if (!resp.ok) {\n const text = await resp.text();\n throw new Error(`Firebase auth failed (${resp.status}): ${text}`);\n }\n\n const data = await resp.json();\n cachedToken = data.access_token;\n tokenExpiry = now + data.expires_in;\n return cachedToken!;\n}\n\n/** Construye la URL de Firebase REST API con auth */\nasync function fbUrl(path: string): Promise {\n const token = await getAccessToken();\n const cleanPath = path.startsWith(\"/\") ? path : `/${path}`;\n return `${DB_URL}${cleanPath}.json?auth=${token}`;\n}\n\n/** GET — lee un nodo completo de Firebase */\nexport async function fbGet(path: string): Promise {\n const url = await fbUrl(path);\n const resp = await fetch(url);\n if (!resp.ok) {\n const text = await resp.text();\n throw new Error(`Firebase GET ${path} failed (${resp.status}): ${text}`);\n }\n return resp.json();\n}\n\n/**\n * PATCH — actualiza paths puntuales sin sobrescribir nodos hermanos.\n * Nunca usar PUT en nodos padre (/caja, /stock, /fiados).\n */\nexport async function fbPatch(\n path: string,\n data: Record,\n): Promise {\n const url = await fbUrl(path);\n const resp = await fetch(url, {\n method: \"PATCH\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify(data),\n });\n if (!resp.ok) {\n const text = await resp.text();\n throw new Error(`Firebase PATCH ${path} failed (${resp.status}): ${text}`);\n }\n}\n\n/** POST — crea un nuevo hijo con un push ID autogenerado por Firebase */\nexport async function fbPost(\n path: string,\n data: Record,\n): Promise {\n const url = await fbUrl(path);\n const resp = await fetch(url, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify(data),\n });\n if (!resp.ok) {\n const text = await resp.text();\n throw new Error(`Firebase POST ${path} failed (${resp.status}): ${text}`);\n }\n const result = await resp.json();\n return result.name; // Firebase devuelve { name: \"-PushId\" }\n}\n",[133],"f578ee540c360638674b377553a7b69f6b2bed734eb8745f9cdd94460caa88cf","README.md",{"_32":143,"_13":141,"_76":144,"_78":-5,"_79":57,"_80":145,"_81":26,"_34":146,"_40":22,"_84":147,"_86":148,"_64":48,"_88":-5,"_89":-7,"_69":149,"_91":150},"305db143-0121-45a0-81cd-a1c4e596f024","435b5542-862d-11f1-a9cd-1607ee4eb77e",7,["D",1784766438679],"file","# 🏪 Despensa Bot\n\nBot de Telegram para gestionar tu despensa: ventas, caja, stock y fiados.\nUsa **grammY** + **Claude AI** (Anthropic) para interpretar mensajes en lenguaje natural\ny **Firebase Realtime Database** (REST API) como backend.\n\n## Arquitectura\n\n```\nUsuario → Telegram → webhook (index.ts)\n ↓\n grammY bot recibe el mensaje\n ↓\n claude.ts → Anthropic API → devuelve Intent JSON\n ↓\n intents.ts → ejecuta la acción contra Firebase\n ↓\n firebase.ts → REST API (GET/PATCH/POST) con auth JWT\n ↓\n Respuesta formateada → Telegram → Usuario\n```\n\n### Archivos\n\n| Archivo | Descripción |\n|---|---|\n| `index.ts` | HTTP handler + bot de Telegram (grammY) |\n| `claude.ts` | Cliente de Anthropic para interpretar intenciones |\n| `intents.ts` | Lógica de cada intención (consultas y mutaciones) |\n| `firebase.ts` | Cliente de Firebase REST API con auth de service account |\n| `types.ts` | Tipos de TypeScript del dominio |\n\n## Intenciones soportadas\n\n| Intent | Ejemplo | Descripción |\n|---|---|---|\n| `consultar_ventas_hoy` | \"cuánto vendí hoy\" | Lista ventas del día con total |\n| `consultar_caja_hoy` | \"cómo está la caja\" | Totales por método de pago (ventas - gastos) |\n| `stock_bajo` | \"stock bajo\" | Productos con stock_actual ≤ stock_minimo |\n| `buscar_producto` | \"buscar coca\" | Búsqueda parcial por nombre o marca |\n| `consultar_fiados` | \"fiados de juan\" / \"quiénes me deben\" | Fiados de un cliente o todos |\n| `registrar_venta` | \"vendí 2 coca transferencia\" | Resta stock + agrega movimiento de caja |\n| `modificar_precio` | \"cambiar precio de coca a 500\" | Actualiza precio_venta del producto |\n| `registrar_gasto` | \"gasté 200 en luz\" | Agrega movimiento de caja tipo gasto |\n\n## Schema de Firebase\n\n```\n/caja/movs/{id}: {descripcion, tipo: \"venta\"|\"gasto\", metodoPago: \"efectivo\"|\"transferencia\", monto, fecha}\n/stock/productos/{id}: {categoria, codigo_barras, marca, nombre, precio_compra, precio_venta, stock_actual, stock_minimo, stock_maximo}\n/fiados/clientes/{id}: {nombre, movs/{movId}: {tipo: \"fiado\"|\"pago\", monto, fecha}}\n```\n\n## Reglas de seguridad\n\n- **Nunca se usa PUT** en nodos padre (`/caja`, `/stock`, `/fiados`).\n- **PATCH** actualiza paths puntuales sin sobrescribir hermanos.\n- **POST** crea nuevos nodos con push ID autogenerado por Firebase.\n\n## Variables de entorno\n\n| Key | Descripción |\n|---|---|\n| `TELEGRAM_TOKEN` | Token del bot (de @BotFather) |\n| `ANTHROPIC_API_KEY` | API key de Anthropic (Claude) |\n| `FIREBASE_DATABASE_URL` | URL de Firebase Realtime Database |\n| `FIREBASE_SERVICE_ACCOUNT_JSON` | JSON completo de la service account de Firebase |\n\n## Setup\n\n1. Las variables de entorno ya están configuradas (excepto TELEGRAM_TOKEN que debe setearse manualmente).\n2. El webhook se registra automáticamente al primer GET del endpoint.\n3. Enviar `/start` al bot por Telegram para verificar que funciona.\n",[141],"95e0a39456eb9b4ae9fcfcf648c2c7fcb93c7da7f33142420b2d8ba99c687d86",["D",1784765752879],"legacyEnvVars","httpPrivacy","description","Bot Telegram para despensa con Firebase + Claude AI","imageUrl","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/67d990da-e147-47fd-bb8a-1a0ca9479500/square512?exp=1789592554&sig=bd7e38789e4b1905e9a672ca0b183f0c367e25d00188ca18aef0b7afeb4d4548","userId","358a05dc-1556-4be6-865e-f6f0ff3f30b9","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",1,"019f8c4e-d39e-70d9-86b4-1332aebc6dcb","tursoName","b050d6398b3f42b399b0cabc159c115c","tursoHostname","b050d6398b3f42b399b0cabc159c115c-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789563036726],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_195":191},"org",{"_11":12,"_188":189,"_190":191,"_158":159,"_192":193,"_194":48},"branch","displayName","Elías García","avatar","https://lh3.googleusercontent.com/a/ACg8ocLN-o7D_lyw5LDS2NiFx5oxbS-1iBwNoLZxkljqgnLhXBEk0Q=s96-c","tier","free","canRestrictVals","profileImageUrl","","adoptOrgId",{"_32":58,"_13":14,"_34":271,"_46":-5,"_152":48,"_49":50,"_153":50,"_154":155,"_156":157,"_158":159,"_160":77,"_161":26,"_162":-5,"_163":-5,"_164":165,"_53":166,"_167":168,"_169":170,"_171":272,"_173":-5,"_174":175,"_176":175,"_177":178,"_179":178,"_180":178,"_181":175,"_182":175,"_183":273,"_185":274,"_187":275,"_47":48},"tree",[253,254,255,256,257,258],"files",[253,254,255,256,257,258],"counts",{"_242":22,"_243":165,"_244":22,"_245":246,"_247":248},"contents",[224,225,226,227,228,229],"upstreamProject",{"_32":39,"_13":56,"_154":221,"_156":157,"_49":50,"_183":222},"upstreamBranch",{"_32":33,"_34":219,"_36":220,"_13":16,"_38":39,"_40":41,"_42":-5,"_43":-5,"_44":45,"_46":-5,"_47":48,"_49":50,"_51":52,"_53":54,"_55":56},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1741790272811],["D",1741794858963],"Telegram Bot that receives and responds to messages",{"_11":52,"_195":223},"https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/129cab32-3bd7-4c3e-f39b-f12900c76100/square512?exp=1789592554&sig=f2f59d13973ae24759639684434a2a179fa30db12a22bb552a805d314c959356",{"_32":143,"_13":141,"_76":144,"_78":-5,"_79":57,"_80":145,"_81":26,"_34":240,"_40":22,"_84":147,"_86":148,"_64":48,"_88":-5,"_69":241},{"_32":135,"_13":133,"_76":136,"_78":-5,"_79":57,"_80":83,"_81":26,"_34":238,"_40":22,"_84":111,"_86":138,"_64":48,"_88":-5,"_69":239},{"_32":126,"_13":124,"_76":127,"_78":-5,"_79":57,"_80":128,"_81":26,"_34":236,"_40":83,"_84":111,"_86":130,"_64":48,"_88":-5,"_69":237},{"_32":75,"_13":70,"_76":77,"_78":-5,"_79":57,"_80":20,"_81":26,"_34":234,"_40":83,"_84":85,"_86":87,"_64":48,"_88":-5,"_69":235},{"_32":117,"_13":115,"_76":118,"_78":-5,"_79":57,"_80":119,"_81":26,"_34":232,"_40":22,"_84":111,"_86":121,"_64":48,"_88":-5,"_69":233},{"_32":107,"_13":105,"_76":108,"_78":-5,"_79":57,"_80":109,"_81":26,"_34":230,"_40":22,"_84":111,"_86":112,"_64":48,"_88":-5,"_69":231},["D",1784766264211],[105],["D",1784766338775],[115],["D",1784769653043],[70],["D",1784769567276],[124],["D",1784766264210],[133],["D",1784766438679],[141],"pulls","branches","forks","envVars",{"_249":251,"_252":22},"connections",{"_249":22,"_250":22},"count","unfilledCount",4,"emptyCount",{"_32":143,"_13":141,"_76":144,"_78":-5,"_79":57,"_80":145,"_81":26,"_34":146,"_40":22,"_84":147,"_86":148,"_64":48,"_88":-5,"_89":269,"_69":270},{"_32":135,"_13":133,"_76":136,"_78":-5,"_79":57,"_80":83,"_81":26,"_34":137,"_40":22,"_84":111,"_86":138,"_64":48,"_88":-5,"_89":267,"_69":268},{"_32":126,"_13":124,"_76":127,"_78":-5,"_79":57,"_80":128,"_81":26,"_34":129,"_40":83,"_84":111,"_86":130,"_64":48,"_88":-5,"_89":265,"_69":266},{"_32":75,"_13":70,"_76":77,"_78":-5,"_79":57,"_80":20,"_81":26,"_34":82,"_40":83,"_84":85,"_86":87,"_64":48,"_88":-5,"_89":263,"_69":264},{"_32":117,"_13":115,"_76":118,"_78":-5,"_79":57,"_80":119,"_81":26,"_34":120,"_40":22,"_84":111,"_86":121,"_64":48,"_88":-5,"_89":261,"_69":262},{"_32":107,"_13":105,"_76":108,"_78":-5,"_79":57,"_80":109,"_81":26,"_34":110,"_40":22,"_84":111,"_86":112,"_64":48,"_88":-5,"_89":259,"_69":260},[],[105],[],[115],[],[70],[],[124],[],[133],[],[141],["D",1784765752879],["D",1789563036726],{"_11":12,"_195":191},{"_11":12,"_188":189,"_190":191,"_158":159,"_192":193,"_194":48},{"_40":20,"_13":16,"_32":57,"_38":58,"_42":33,"_43":41,"_59":50,"_60":39,"_61":54,"_55":14,"_51":12},"ctx",{"_183":-5,"_216":309,"_310":311,"_312":313,"_314":48,"_315":48,"_316":48,"_317":26,"_318":-5,"_319":-7,"_320":-7,"_321":22,"_322":48,"_323":48,"_324":-5,"_325":48,"_326":48,"_327":48,"_328":-5},"ENV",{"_280":281,"_282":283,"_284":16,"_285":286,"_287":288,"_289":290,"_291":292,"_293":294,"_295":296,"_297":298,"_299":300,"_301":302,"_303":304,"_305":306,"_307":308},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","811aa22498c9b0b5a47e8d778de579cdb990f332","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Compare

Mergeelasgarc/mainintotemplates/main

Hindex.ts+73-15

README.md+73-0

firebase.ts+143-0

grok.ts+65-0

intents.ts+358-0

types.ts+61-0