@analytix/tracker 0.3.0

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { createAnalytixClient, type AnalytixClient, type AnalytixClientConfig, type AnalytixPlugin } from "@analytix/core";
+export interface InitAnalytixOptions extends AnalytixClientConfig {
+    plugins?: AnalytixPlugin[];
+    /** Track initial page + history navigation. Default true. */
+    autoPage?: boolean;
+}
+/**
+ * Initialize Analytix for vanilla JS / static HTML / Vite SPA.
+ * Returns the client instance (`page`, `track`, `identify`, `grantConsent`).
+ */
+export declare function initAnalytix(options: InitAnalytixOptions): AnalytixClient;
+export { createAnalytixClient };
+export type { AnalytixClient, AnalytixClientConfig, AnalytixPlugin };
+declare global {
+    interface Window {
+        analytix?: AnalytixClient;
+    }
+}
+/** Attach client to `window.analytix` for script-tag usage. */
+export declare function exposeAnalytix(client: AnalytixClient): AnalytixClient;

package/dist/index.js

@@ -0,0 +1,45 @@
+import { createAnalytixClient, } from "@analytix/core";
+function patchHistory(client) {
+    if (typeof window === "undefined")
+        return () => undefined;
+    const track = () => void client.page({ path: window.location.pathname });
+    window.addEventListener("popstate", track);
+    const push = history.pushState.bind(history);
+    const replace = history.replaceState.bind(history);
+    history.pushState = (...args) => {
+        push(...args);
+        track();
+    };
+    history.replaceState = (...args) => {
+        replace(...args);
+        track();
+    };
+    return () => {
+        window.removeEventListener("popstate", track);
+        history.pushState = push;
+        history.replaceState = replace;
+    };
+}
+/**
+ * Initialize Analytix for vanilla JS / static HTML / Vite SPA.
+ * Returns the client instance (`page`, `track`, `identify`, `grantConsent`).
+ */
+export function initAnalytix(options) {
+    const { autoPage = true, ...clientOptions } = options;
+    const client = createAnalytixClient(clientOptions);
+    if (autoPage && typeof window !== "undefined") {
+        void client.ready().then(() => {
+            void client.page({ path: window.location.pathname });
+            patchHistory(client);
+        });
+    }
+    return client;
+}
+export { createAnalytixClient };
+/** Attach client to `window.analytix` for script-tag usage. */
+export function exposeAnalytix(client) {
+    if (typeof window !== "undefined") {
+        window.analytix = client;
+    }
+    return client;
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@analytix/tracker",
+  "version": "0.3.0",
+  "description": "Vanilla JS entry point for Analytix (SPA + script tag)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Shashank519915/analytix.git",
+    "directory": "packages/tracker"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@analytix/core": "^0.3.0"
+  },
+  "devDependencies": {
+    "typescript": "^5"
+  }
+}