@reforma/site 0.0.2 → 0.0.4

package/dist/analytics.d.ts

@@ -0,0 +1,24 @@
+type AnalyticsOptions = {
+    /** Test-only: allow re-init and clear history hooks. */
+    reset?: boolean;
+    /** Default false — skip localhost / 127.0.0.1. */
+    captureOnLocalhost?: boolean;
+};
+type TrackOptions = {
+    url?: string;
+    referrer?: string;
+    props?: Record<string, string>;
+};
+/**
+ * Start first-party pageview collection for a published Reforma site.
+ * Reads `NEXT_PUBLIC_REFORMA_ANALYTICS*` env baked on publish. Safe to call
+ * multiple times — only the first call installs history hooks.
+ */
+export declare function initAnalytics(options?: AnalyticsOptions): void;
+/**
+ * Send a named event. `pageview` is traffic (deduped by path); any other name
+ * is a custom event / goal conversion. Optional `props` are string key/values.
+ */
+export declare function track(name: string, options?: TrackOptions): void;
+export {};
+//# sourceMappingURL=analytics.d.ts.map

package/dist/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,GAAG;IACpB,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,KAAK,YAAY,GAAG;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AASF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAqClE;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI,CA6DpE"}

package/dist/analytics.js

@@ -0,0 +1,132 @@
+let started = false;
+let enabled = false;
+let writeKey = '';
+let endpoint = '';
+let lastPath = '';
+let unhook = null;
+/**
+ * Start first-party pageview collection for a published Reforma site.
+ * Reads `NEXT_PUBLIC_REFORMA_ANALYTICS*` env baked on publish. Safe to call
+ * multiple times — only the first call installs history hooks.
+ */
+export function initAnalytics(options = {}) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    if (options.reset) {
+        unhook?.();
+        unhook = null;
+        started = false;
+        lastPath = '';
+    }
+    if (started) {
+        return;
+    }
+    started = true;
+    enabled = process.env.NEXT_PUBLIC_REFORMA_ANALYTICS === '1';
+    writeKey = process.env.NEXT_PUBLIC_REFORMA_ANALYTICS_KEY?.trim() ?? '';
+    endpoint = process.env.NEXT_PUBLIC_REFORMA_ANALYTICS_ENDPOINT?.trim() ?? '';
+    if (!enabled || !writeKey || !endpoint) {
+        enabled = false;
+        return;
+    }
+    if (!options.captureOnLocalhost && isLocalHost(window.location.hostname)) {
+        enabled = false;
+        return;
+    }
+    track('pageview');
+    unhook = installHistoryHook(() => {
+        track('pageview');
+    });
+}
+/**
+ * Send a named event. `pageview` is traffic (deduped by path); any other name
+ * is a custom event / goal conversion. Optional `props` are string key/values.
+ */
+export function track(name, options = {}) {
+    if (!enabled || typeof window === 'undefined') {
+        return;
+    }
+    const eventName = name.trim();
+    if (!eventName) {
+        return;
+    }
+    const url = options.url ?? window.location.href;
+    const path = pathOf(url);
+    if (eventName === 'pageview') {
+        if (path === lastPath) {
+            return;
+        }
+        lastPath = path;
+    }
+    const payload = {
+        key: writeKey,
+        name: eventName,
+        url,
+        referrer: options.referrer ?? (document.referrer || undefined),
+    };
+    if (eventName !== 'pageview' && options.props && typeof options.props === 'object') {
+        payload.props = options.props;
+    }
+    const bodyText = JSON.stringify(payload);
+    const body = typeof Blob === 'undefined'
+        ? bodyText
+        : new Blob([bodyText], { type: 'application/json' });
+    try {
+        if (typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function') {
+            const ok = navigator.sendBeacon(endpoint, body);
+            if (ok) {
+                return;
+            }
+        }
+        void fetch(endpoint, {
+            method: 'POST',
+            body: bodyText,
+            headers: { 'Content-Type': 'application/json' },
+            keepalive: true,
+            mode: 'cors',
+            credentials: 'omit',
+        }).catch(() => {
+            // Fire-and-forget — never break the host site.
+        });
+    }
+    catch {
+        // Ignore beacon failures.
+    }
+}
+function installHistoryHook(onNavigate) {
+    const { pushState, replaceState } = history;
+    const notify = () => {
+        queueMicrotask(onNavigate);
+    };
+    history.pushState = function (...args) {
+        const result = pushState.apply(this, args);
+        notify();
+        return result;
+    };
+    history.replaceState = function (...args) {
+        const result = replaceState.apply(this, args);
+        notify();
+        return result;
+    };
+    window.addEventListener('popstate', notify);
+    return () => {
+        history.pushState = pushState;
+        history.replaceState = replaceState;
+        window.removeEventListener('popstate', notify);
+    };
+}
+function isLocalHost(hostname) {
+    return hostname === 'localhost'
+        || hostname === '127.0.0.1'
+        || hostname === '[::1]'
+        || hostname.endsWith('.local');
+}
+function pathOf(url) {
+    try {
+        return new URL(url, window.location.origin).pathname;
+    }
+    catch {
+        return '/';
+    }
+}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { initAnalytics, track } from './analytics.js';
 export { projectMetadata, projectRobots } from './metadata.js';
 export { SiteRoot, useMode } from './root.js';
 export type { Appearance, ModeAppearances, ModeDocument, SystemModes } from './root.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
+export { initAnalytics, track } from './analytics.js';
 export { projectMetadata, projectRobots } from './metadata.js';
 export { SiteRoot, useMode } from './root.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@reforma/site",
-    "version": "0.0.2",
+    "version": "0.0.4",
     "description": "Visitor runtime for a Reforma site: mode, publish metadata, and the PostCSS url guard.",
     "type": "module",
     "license": "UNLICENSED",