@reforma/site 0.0.2 → 0.0.3

package/dist/analytics.d.ts

@@ -0,0 +1,20 @@
+type AnalyticsOptions = {
+    /** Test-only: allow re-init and clear history hooks. */
+    reset?: boolean;
+    /** Default false — skip localhost / 127.0.0.1. */
+    captureOnLocalhost?: boolean;
+};
+type TrackProps = {
+    url?: string;
+    referrer?: 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. Today only `pageview` is stored by the API. */
+export declare function track(name: string, props?: TrackProps): 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,UAAU,GAAG;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AASF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAqClE;AAED,sEAAsE;AACtE,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,UAAe,GAAG,IAAI,CA6ChE"}

package/dist/analytics.js

@@ -0,0 +1,118 @@
+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. Today only `pageview` is stored by the API. */
+export function track(name, props = {}) {
+    if (!enabled || name !== 'pageview' || typeof window === 'undefined') {
+        return;
+    }
+    const url = props.url ?? window.location.href;
+    const path = pathOf(url);
+    if (path === lastPath) {
+        return;
+    }
+    lastPath = path;
+    const payload = JSON.stringify({
+        key: writeKey,
+        url,
+        referrer: props.referrer ?? (document.referrer || undefined),
+    });
+    const body = typeof Blob === 'undefined'
+        ? payload
+        : new Blob([payload], { 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: payload,
+            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 url;
+    }
+}

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.3",
     "description": "Visitor runtime for a Reforma site: mode, publish metadata, and the PostCSS url guard.",
     "type": "module",
     "license": "UNLICENSED",