@kylelogue/eventfoundry-tracker 0.1.0

package/README.md

@@ -0,0 +1,104 @@
+# EventFoundry Tracker
+
+Embedded JavaScript tracking script for EventFoundry - enables custom GA4 event tracking with a visual editor.
+
+## Installation
+
+### Via unpkg CDN (Recommended)
+
+Add the script to your website's HTML:
+
+```html
+<!-- Latest version (auto-updates) -->
+<script src="https://unpkg.com/@kylelogue/eventfoundry-tracker@latest/dist/tracker.min.js"
+        data-site-key="YOUR_SITE_KEY_HERE"
+        async></script>
+```
+
+Or pin to a specific version for production stability:
+
+```html
+<!-- Pinned version -->
+<script src="https://unpkg.com/@kylelogue/eventfoundry-tracker@0.1.0/dist/tracker.min.js"
+        data-site-key="YOUR_SITE_KEY_HERE"
+        async></script>
+```
+
+### Via npm
+
+```bash
+npm install @kylelogue/eventfoundry-tracker
+```
+
+## Usage
+
+### Option 1: Auto-inject GA4
+
+Let EventFoundry automatically inject Google Analytics 4:
+
+```html
+<script src="https://unpkg.com/@kylelogue/eventfoundry-tracker@latest/dist/tracker.min.js"
+        data-site-key="YOUR_SITE_KEY_HERE"
+        data-measurement-id="G-XXXXXXXXXX"
+        async></script>
+```
+
+### Option 2: Use existing GA4
+
+If you already have GA4 installed, EventFoundry will detect and use it:
+
+```html
+<!-- Your existing GA4 installation -->
+<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
+<script>
+  window.dataLayer = window.dataLayer || [];
+  function gtag(){dataLayer.push(arguments);}
+  gtag('js', new Date());
+  gtag('config', 'G-XXXXXXXXXX');
+</script>
+
+<!-- EventFoundry Tracker -->
+<script src="https://unpkg.com/@kylelogue/eventfoundry-tracker@latest/dist/tracker.min.js"
+        data-site-key="YOUR_SITE_KEY_HERE"
+        async></script>
+```
+
+## How It Works
+
+EventFoundry Tracker runs in two modes:
+
+1. **Tracking Mode** (default): Fetches event definitions from your EventFoundry account, attaches click listeners to elements, and sends events directly to GA4.
+
+2. **Editor Mode**: When loaded in the EventFoundry app, enables a visual overlay for defining custom events by clicking elements on your site.
+
+## Features
+
+- **Lightweight**: < 1KB gzipped
+- **Zero dependencies**: Pure vanilla JavaScript
+- **Fast**: 1-hour localStorage caching of event definitions
+- **Non-blocking**: Async loading won't slow down your site
+- **Browser support**: Chrome, Firefox, Safari, Edge (ES2015+)
+
+## Configuration
+
+The script accepts the following attributes:
+
+- `data-site-key` (required): Your EventFoundry site key
+- `data-measurement-id` (optional): Your GA4 measurement ID (if not already installed)
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build for production
+npm run build
+
+# Development watch mode
+npm run dev
+```
+
+## License
+
+MIT © Kyle Logue

package/dist/tracker.min.js

@@ -0,0 +1 @@
+var EventFoundry=(()=>{var r=(t,e,n)=>new Promise((d,l)=>{var y=o=>{try{i(n.next(o))}catch(a){l(a)}},h=o=>{try{i(n.throw(o))}catch(a){l(a)}},i=o=>o.done?d(o.value):Promise.resolve(o.value).then(y,h);i((n=n.apply(t,e)).next())});var c=document.currentScript||document.querySelector("script[data-site-key]"),f=c==null?void 0:c.getAttribute("data-site-key"),g=window.location.hostname==="localhost"||window.location.hostname==="127.0.0.1",m=g?"http://localhost/api/tracking/events":"https://eventfoundry.app/api/tracking/events",s="eventfoundry_definitions",v=3600*1e3;function u(){return r(this,null,function*(){if(!f){console.warn("EventFoundry: No site key found. Add data-site-key attribute to script tag.");return}try{let t=yield w();console.log("EventFoundry: Loaded event definitions:",t)}catch(t){console.error("EventFoundry: Failed to initialize:",t)}})}function w(){return r(this,null,function*(){let t=E();if(t)return console.log("EventFoundry: Using cached definitions"),t;console.log("EventFoundry: Fetching definitions from API");let e=yield fetch(`${m}?siteKey=${f}`);if(!e.ok)throw new Error(`API returned ${e.status}`);let n=yield e.json();return p(n),n})}function E(){try{let t=localStorage.getItem(s);if(!t)return null;let{data:e,timestamp:n}=JSON.parse(t);return Date.now()-n>v?(localStorage.removeItem(s),null):e}catch(t){return console.warn("EventFoundry: Cache read failed:",t),null}}function p(t){try{let e={data:t,timestamp:Date.now()};localStorage.setItem(s,JSON.stringify(e))}catch(e){console.warn("EventFoundry: Cache write failed:",e)}}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",u):u();})();

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@kylelogue/eventfoundry-tracker",
+  "version": "0.1.0",
+  "description": "EventFoundry tracking script for custom GA4 event tracking",
+  "main": "dist/tracker.min.js",
+  "files": ["dist"],
+  "scripts": {
+    "build": "node build.js",
+    "dev": "node build.js --watch",
+    "test": "echo \"No tests yet\"",
+    "serve": "./serve-test.sh",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kylelogue/eventfoundry-tracker"
+  },
+  "homepage": "https://github.com/kylelogue/eventfoundry-tracker#readme",
+  "bugs": {
+    "url": "https://github.com/kylelogue/eventfoundry-tracker/issues"
+  },
+  "keywords": ["analytics", "ga4", "tracking", "google-analytics", "eventfoundry"],
+  "author": "Kyle Logue",
+  "license": "MIT",
+  "devDependencies": {
+    "esbuild": "^0.27.0"
+  }
+}