{"id":24892721,"url":"https://github.com/monicatvera/teatem","last_synced_at":"2026-02-13T01:06:11.571Z","repository":{"id":275209998,"uuid":"925424221","full_name":"monicatvera/teatem","owner":"monicatvera","description":"Teatem is a CLI tool that converts Excel data into structured JavaScript objects for tracking views and events in Tealium and other analytics platforms. It supports different channels (mobile, co, lo, imagin) and ensures that previous data is preserved.","archived":false,"fork":false,"pushed_at":"2025-01-31T22:28:20.000Z","size":6,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-27T13:49:19.576Z","etag":null,"topics":["analytics","automation","cli-tool","data-tagging","excel-to-json","javascript","nodejs","npm","tealium","tracking"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/teatem","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/monicatvera.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-31T21:16:15.000Z","updated_at":"2025-01-31T22:28:22.000Z","dependencies_parsed_at":"2025-01-31T21:45:39.654Z","dependency_job_id":null,"html_url":"https://github.com/monicatvera/teatem","commit_stats":null,"previous_names":["monicatvera/teatem"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monicatvera%2Fteatem","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monicatvera%2Fteatem/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monicatvera%2Fteatem/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monicatvera%2Fteatem/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/monicatvera","download_url":"https://codeload.github.com/monicatvera/teatem/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248799087,"owners_count":21163396,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analytics","automation","cli-tool","data-tagging","excel-to-json","javascript","nodejs","npm","tealium","tracking"],"created_at":"2025-02-01T18:16:27.871Z","updated_at":"2026-02-13T01:06:06.535Z","avatar_url":"https://github.com/monicatvera.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📊 Teatem\n\n**Teatem** es una herramienta CLI que permite **convertir datos de un archivo Excel a un archivo JavaScript estructurado** con `views` y `events` para diferentes canales (`mobile`, `co`, `lo`, `imagin`).  \n\nFacilita la gestión del etiquetado de datos en plataformas de seguimiento sin perder información previa.\n\n---\n\n## 🚀 Características\n\n✅ **Convierte datos de un archivo Excel a un JavaScript estructurado**  \n✅ **Selecciona interactivamente el canal en el que deseas aplicar el etiquetado**  \n✅ **Genera un archivo `tracking-data.js` organizado en `views` y `events`**  \n\n---\n\n## 📦 Instalación\n\nSi deseas instalarlo globalmente desde npm:\n\n```sh\nnpm install -g teatem\n```\n\nSi deseas usarlo de forma local en un proyecto:\n\n```sh\nnpm install teatem --save-dev\n```\n\nSi deseas clonar el código directamente:\n\n```sh\ngit clone https://github.com/monicatvera/teatem.git\ncd teatem\nnpm install\n```\n\n---\n\n## 🔧 Uso\n\n### 1️⃣ **Ejecutar el script**\n```sh\nteatem \u003carchivo.xlsx\u003e\n```\nEjemplo:\n```sh\nteatem cdb_etiquetado.xlsx\n```\n\n### 2️⃣ **Seleccionar el canal**\nAl ejecutar el comando, aparecerá un menú interactivo:\n```\nSelecciona el canal para aplicar el etiquetado:\n\u003e mobile\n  co\n  lo\n  imagin\n```\nSelecciona una opción y presiona `Enter`.\n\n### 3️⃣ **Revisar el archivo generado**\nDespués de ejecutar el script, se creará o actualizará el archivo `tracking-data.js` con la siguiente estructura:\n\n```javascript\nexport const views = {\n  mobile: [...],  // Datos de views del canal mobile\n  co: [...],      // Datos de views del canal co\n  lo: [...],      // Datos de views del canal lo\n  imagin: [...]   // Datos de views del canal imagin\n};\n\n//informar event_category siempre aunque sea ''\nexport const events = {\n  \"event_id_1\": { mobile: {...}, co: {...}, lo: {...}, imagin: {...} },\n  \"event_id_2\": { mobile: {...}, co: {...}, lo: {...}, imagin: {...} }\n};\n```\n\nCada vez que ejecutas el script con otro canal, **solo se actualizarán los datos de ese canal sin afectar los demás**.\n\n---\n\n## ⚠️ Importante\n\n🔹 **Revisa el archivo `tracking-data.js` después de la conversión.** Puede incluir algunos campos innecesarios, ya que es una copia del Excel.  \n🔹 **Es necesario configurar manualmente los valores de `page_route` según los requisitos del proyecto.**  \n🔹 **Si ejecutas el script con diferentes canales (`mobile`, `co`, `lo`, `imagin`), solo se actualizará el canal seleccionado y se mantendrán los demás sin cambios.**  \n\n---\n\n## 🛠 Requisitos y dependencias\n\nEste script usa:\n- **Node.js** (`\u003e=14.0.0`)\n- **Paquetes npm:**\n  - `xlsx` (para leer archivos Excel)\n  - `inquirer` (para la CLI interactiva)\n\nSi no tienes las dependencias, instálalas con:\n```sh\nnpm install\n```\n\n---\n\n## 📝 Licencia\n\nEste proyecto está bajo la licencia **MIT**. Puedes usarlo, modificarlo y compartirlo libremente. 😃\n\n---\n\n## 🔗 Contacto\n\nDesarrollado por [@monicatvera](https://github.com/monicatvera)  \n\nSi tienes preguntas o sugerencias, no dudes en abrir un **issue** en GitHub o contribuir al proyecto. 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonicatvera%2Fteatem","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmonicatvera%2Fteatem","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonicatvera%2Fteatem/lists"}