@mcp-fe/event-tracker 0.0.1

package/README.md

@@ -0,0 +1,11 @@
+# event-tracker
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build event-tracker` to build the library.
+
+## Running unit tests
+
+Run `nx test event-tracker` to execute the unit tests via [Vitest](https://vitest.dev/).

package/eslint.config.mjs

@@ -0,0 +1,22 @@
+import baseConfig from '../../eslint.config.mjs';
+
+export default [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': [
+        'error',
+        {
+          ignoredFiles: [
+            '{projectRoot}/eslint.config.{js,cjs,mjs,ts,cts,mts}',
+            '{projectRoot}/vite.config.{js,ts,mjs,mts}',
+          ],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: await import('jsonc-eslint-parser'),
+    },
+  },
+];

package/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@mcp-fe/event-tracker",
+  "version": "0.0.1",
+  "private": false,
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "dependencies": {},
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/project.json

@@ -0,0 +1,9 @@
+{
+  "name": "event-tracker",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/event-tracker/src",
+  "projectType": "library",
+  "tags": [],
+  "// targets": "to see all targets run: nx show project event-tracker --web",
+  "targets": {}
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './lib/event-tracker';

package/src/lib/event-tracker.ts

@@ -0,0 +1,102 @@
+import { queryEvents, type UserEvent, WorkerClient } from '@mcp-fe/mcp-worker';
+export type { UserEvent } from '@mcp-fe/mcp-worker';
+
+
+export interface UserEventData {
+  type: 'navigation' | 'click' | 'input' | 'custom';
+  path?: string;
+  from?: string;
+  to?: string;
+  element?: string;
+  elementId?: string;
+  elementClass?: string;
+  elementText?: string;
+  metadata?: Record<string, unknown>;
+}
+
+// Singleton client used by exported functions
+const workerClient = new WorkerClient();
+
+// Public API - thin wrappers around workerClient
+export async function initEventTracker(registration?: ServiceWorkerRegistration): Promise<void> {
+  return workerClient.init(registration);
+}
+
+export async function trackEvent(event: UserEventData): Promise<void> {
+  const userEvent = { ...event, timestamp: Date.now() };
+  // use request to ensure the worker stored the event; mimic previous behavior
+  await workerClient.request('STORE_EVENT', { event: userEvent });
+}
+
+export async function getStoredEvents(): Promise<UserEvent[]> {
+  const res = await queryEvents();
+  return Array.isArray(res) ? res : [];
+}
+
+export async function getConnectionStatus(): Promise<boolean> {
+  return workerClient.getConnectionStatus();
+}
+
+export function setAuthToken(token: string): void {
+  workerClient.setAuthToken(token);
+}
+
+// Connection status subscription helpers
+export function onConnectionStatus(cb: (connected: boolean) => void): void {
+  workerClient.onConnectionStatus(cb);
+}
+
+export function offConnectionStatus(cb: (connected: boolean) => void): void {
+  workerClient.offConnectionStatus(cb);
+}
+
+// Convenience helpers (kept outside for ergonomic API)
+export async function trackNavigation(from: string, to: string, path?: string): Promise<void> {
+  return trackEvent({ type: 'navigation', from, to, path: path || to });
+}
+
+export async function trackClick(element: HTMLElement, path?: string, metadata?: Record<string, unknown>): Promise<void> {
+  const elementId = element.id || undefined;
+  const elementClass = element.className || undefined;
+  const elementText = element.textContent?.trim().substring(0, 100) || undefined;
+  const tagName = element.tagName.toLowerCase();
+
+  return trackEvent({
+    type: 'click',
+    element: tagName,
+    elementId,
+    elementClass,
+    elementText,
+    path: path || window.location.pathname,
+    metadata,
+  });
+}
+
+export async function trackInput(element: HTMLElement, value?: string, path?: string): Promise<void> {
+  const elementId = element.id || undefined;
+  const elementClass = element.className || undefined;
+  const tagName = element.tagName.toLowerCase();
+
+  return trackEvent({
+    type: 'input',
+    element: tagName,
+    elementId,
+    elementClass,
+    path: path || window.location.pathname,
+    metadata: {
+      valueLength: value?.length || 0,
+      value: value,
+    },
+  });
+}
+
+export async function trackCustom(eventName: string, metadata?: Record<string, unknown>, path?: string): Promise<void> {
+  return trackEvent({
+    type: 'custom',
+    path: path || window.location.pathname,
+    metadata: {
+      eventName,
+      ...metadata,
+    },
+  });
+}

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "importHelpers": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "lib": ["esnext", "dom", "webworker"]
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/tsconfig.lib.json

@@ -0,0 +1,25 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "module": "esnext",
+    "outDir": "../../dist/out-tsc",
+    "declaration": true,
+    "types": ["node", "vite/client"]
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.js",
+    "src/**/*.spec.js",
+    "src/**/*.test.jsx",
+    "src/**/*.spec.jsx"
+  ],
+  "references": []
+}

package/tsconfig.spec.json

@@ -0,0 +1,28 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "types": [
+      "vitest/globals",
+      "vitest/importMeta",
+      "vite/client",
+      "node",
+      "vitest"
+    ]
+  },
+  "include": [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.js",
+    "src/**/*.spec.js",
+    "src/**/*.test.jsx",
+    "src/**/*.spec.jsx",
+    "src/**/*.d.ts"
+  ]
+}

package/vite.config.mts

@@ -0,0 +1,59 @@
+/// <reference types='vitest' />
+import { defineConfig } from 'vite';
+import dts from 'vite-plugin-dts';
+import * as path from 'path';
+import { nxViteTsPaths } from '@nx/vite/plugins/nx-tsconfig-paths.plugin';
+import { nxCopyAssetsPlugin } from '@nx/vite/plugins/nx-copy-assets.plugin';
+
+export default defineConfig(() => ({
+  root: import.meta.dirname,
+  cacheDir: '../../node_modules/.vite/libs/event-tracker',
+  plugins: [
+    nxViteTsPaths(),
+    nxCopyAssetsPlugin(['*.md']),
+    dts({
+      entryRoot: 'src',
+      tsconfigPath: path.join(import.meta.dirname, 'tsconfig.lib.json'),
+      pathsToAliases: false,
+    }),
+  ],
+  // Uncomment this if you are using workers.
+  // worker: {
+  //   plugins: () => [ nxViteTsPaths() ],
+  // },
+  // Configuration for building your library.
+  // See: https://vite.dev/guide/build.html#library-mode
+  build: {
+    outDir: '../../dist/libs/event-tracker',
+    emptyOutDir: true,
+    reportCompressedSize: true,
+    commonjsOptions: {
+      transformMixedEsModules: true,
+    },
+    lib: {
+      // Could also be a dictionary or array of multiple entry points.
+      entry: 'src/index.ts',
+      name: 'event-tracker',
+      fileName: 'index',
+      // Change this to the formats you want to support.
+      // Don't forget to update your package.json as well.
+      formats: ['es' as const],
+    },
+    rollupOptions: {
+      // External packages that should not be bundled into your library.
+      external: [],
+    },
+  },
+  test: {
+    name: 'event-tracker',
+    watch: false,
+    globals: true,
+    environment: 'node',
+    include: ['{src,tests}/**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],
+    reporters: ['default'],
+    coverage: {
+      reportsDirectory: '../../coverage/libs/event-tracker',
+      provider: 'v8' as const,
+    },
+  },
+}));