siteplane 0.2.0-next.0 → 0.2.0-next.1

package/README.md

@@ -49,6 +49,13 @@ A website with `basePath` in `next.config` needs no extra setup. Check it with t
 (`npx siteplane status --url https://www.example.com/docs`); Siteplane saves that address as the website URL and
 reaches the website below it.
 
+## Analytics
+
+With Analytics on for the site, `init` also adds `<SiteplaneAnalytics siteId="…" />` to the root layout. It counts
+page views, App Router navigations and clicks on elements with `data-siteplane-event="<name>"`, on links to other
+websites, phone numbers and email addresses. It sets no cookies and uses no browser storage; Siteplane counts visitors
+per day on its server. Development builds and the editor's preview send nothing.
+
 ## Booking
 
 ```ts

package/dist/bin/siteplane.js

@@ -2046,7 +2046,7 @@ async function writeStore(connections, options) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.2.0-next.0";
+var PACKAGE_VERSION = "0.2.0-next.1";
 
 // src/bin/run-siteplane.ts
 var usage = [

package/dist/{chunk-YDCNEIOB.js → chunk-BLJCWIYD.js}

@@ -334,6 +334,7 @@ export {
   siteCacheTag,
   siteConfig,
   signingKeys,
+  isDraftMode,
   readPreviewToken,
   loadSiteValues
 };

package/dist/components.d.ts

@@ -8,12 +8,15 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
  */
 declare function SiteplaneBridge(): Promise<react_jsx_runtime.JSX.Element | null>;
 /**
- * `<SiteplaneAnalytics siteId="…" />` (Vertrag 54 §10). Page views and clicks
- * are measured from Plan 55 J1 on, when Siteplane's collector accepts them;
- * until then the component renders nothing and loads no script.
+ * `<SiteplaneAnalytics siteId="…" />` (Vertrag 54 §10): page views, App Router
+ * navigations and clicks, without cookies or browser storage, sent to
+ * Siteplane's collector. In Draft Mode, which only the editor's preview uses,
+ * it renders nothing, so previews never count. The client part reads the
+ * search parameters and therefore sits in its own Suspense boundary, as with
+ * Vercel's `<Analytics />`.
  */
-declare function SiteplaneAnalytics(props: {
+declare function SiteplaneAnalytics({ siteId }: {
     siteId: string;
-}): null;
+}): Promise<react_jsx_runtime.JSX.Element | null>;
 
 export { SiteplaneAnalytics, SiteplaneBridge };

package/dist/components.js

@@ -1,12 +1,21 @@
 import {
+  isDraftMode,
   readPreviewToken,
   signingKeys,
   siteConfig,
   verifySitePreviewToken
-} from "./chunk-YDCNEIOB.js";
+} from "./chunk-BLJCWIYD.js";
 import "./chunk-KZ3AQ6OA.js";
 
+// ../shared/dist/site-analytics.js
+var SITE_ANALYTICS_SEND_PATH = "/api/analytics/send";
+function siteAnalyticsEndpoint(apiOrigin) {
+  return `${apiOrigin}${SITE_ANALYTICS_SEND_PATH}`;
+}
+
 // src/components.tsx
+import { Suspense } from "react";
+import { AnalyticsTracker } from "siteplane/internal/analytics";
 import { BridgeLoader } from "siteplane/internal/bridge-loader";
 import { jsx } from "react/jsx-runtime";
 async function SiteplaneBridge() {
@@ -23,9 +32,10 @@ async function readEditorOrigin() {
     return null;
   }
 }
-function SiteplaneAnalytics(props) {
-  void props;
-  return null;
+async function SiteplaneAnalytics({ siteId }) {
+  if (await isDraftMode()) return null;
+  const endpoint = siteAnalyticsEndpoint(siteConfig?.apiOrigin ?? "https://siteplane.io");
+  return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(AnalyticsTracker, { siteId, endpoint }) });
 }
 export {
   SiteplaneAnalytics,

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   loadSiteValues
-} from "./chunk-YDCNEIOB.js";
+} from "./chunk-BLJCWIYD.js";
 import "./chunk-KZ3AQ6OA.js";
 
 // src/index.ts

package/dist/internal/analytics.js

@@ -0,0 +1,91 @@
+"use client";
+
+// src/analytics-tracker.tsx
+import { usePathname, useSearchParams } from "next/navigation";
+import { useEffect, useRef } from "react";
+
+// ../shared/dist/site-analytics.js
+var SITE_ANALYTICS_EVENT_ATTRIBUTE = "data-siteplane-event";
+var SITE_ANALYTICS_LINK_EVENTS = {
+  outbound: "outbound-link",
+  tel: "tel-link",
+  mailto: "mailto-link"
+};
+
+// src/analytics.ts
+function createAnalytics(config, deps = {}) {
+  const send = deps.send ?? sendEvent;
+  let lastUrl = null;
+  const page = () => ({
+    website: config.siteId,
+    hostname: location.hostname,
+    url: location.pathname + location.search,
+    screen: `${screen.width}x${screen.height}`
+  });
+  const emit = (payload) => send(config.endpoint, { type: "event", payload });
+  const onClick = (event) => {
+    if (event.type === "auxclick" && event.button !== 1) return;
+    const element = event.target instanceof Element ? event.target : null;
+    const name = element?.closest(`[${SITE_ANALYTICS_EVENT_ATTRIBUTE}]`)?.getAttribute(SITE_ANALYTICS_EVENT_ATTRIBUTE)?.trim();
+    if (name) return emit({ ...page(), name: name.slice(0, 100) });
+    const link = element?.closest("a[href]");
+    if (!(link instanceof HTMLAnchorElement)) return;
+    const kind = link.protocol === "tel:" ? SITE_ANALYTICS_LINK_EVENTS.tel : link.protocol === "mailto:" ? SITE_ANALYTICS_LINK_EVENTS.mailto : /^https?:$/u.test(link.protocol) && link.host !== location.host ? SITE_ANALYTICS_LINK_EVENTS.outbound : null;
+    if (kind) emit({ ...page(), name: kind, data: { url: link.href } });
+  };
+  return {
+    /** Counts the current page once; a later page names the previous one as referrer. */
+    pageView() {
+      const current = page();
+      if (current.url === lastUrl) return;
+      const referrer = lastUrl === null ? document.referrer : `${location.origin}${lastUrl}`;
+      lastUrl = current.url;
+      emit(referrer ? { ...current, referrer } : current);
+    },
+    /** Listens for clicks (and middle clicks) until the returned function runs. */
+    start() {
+      document.addEventListener("click", onClick, true);
+      document.addEventListener("auxclick", onClick, true);
+      return () => {
+        document.removeEventListener("click", onClick, true);
+        document.removeEventListener("auxclick", onClick, true);
+      };
+    }
+  };
+}
+function sendEvent(endpoint, body) {
+  try {
+    void fetch(endpoint, {
+      method: "POST",
+      body: JSON.stringify(body),
+      headers: { "content-type": "text/plain" },
+      credentials: "omit",
+      keepalive: true
+    }).catch(() => void 0);
+  } catch {
+  }
+}
+
+// src/analytics-tracker.tsx
+function AnalyticsTracker({ siteId, endpoint }) {
+  const pathname = usePathname();
+  const search = useSearchParams()?.toString() ?? "";
+  const analytics = useRef(null);
+  useEffect(() => {
+    if (process.env.NODE_ENV !== "production") return;
+    const instance = createAnalytics({ siteId, endpoint });
+    analytics.current = instance;
+    const stop = instance.start();
+    return () => {
+      stop();
+      analytics.current = null;
+    };
+  }, [siteId, endpoint]);
+  useEffect(() => {
+    analytics.current?.pageView();
+  }, [pathname, search, siteId, endpoint]);
+  return null;
+}
+export {
+  AnalyticsTracker
+};

package/dist/route.js

@@ -5,7 +5,7 @@ import {
   siteConfig,
   verifySitePreviewToken,
   verifySiteRevalidation
-} from "./chunk-YDCNEIOB.js";
+} from "./chunk-BLJCWIYD.js";
 import "./chunk-KZ3AQ6OA.js";
 
 // src/route.ts
@@ -114,7 +114,7 @@ async function readBoundedText(request) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.2.0-next.0";
+var PACKAGE_VERSION = "0.2.0-next.1";
 
 // src/route.ts
 var embeddable = { httpOnly: true, secure: true, sameSite: "none", partitioned: true, path: "/" };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "siteplane",
   "private": false,
-  "version": "0.2.0-next.0",
+  "version": "0.2.0-next.1",
   "description": "Siteplane for Next.js websites: editable content with code fallbacks, Draft Mode preview, Booking and the siteplane CLI.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -36,6 +36,7 @@
     },
     "./internal/bridge-loader": "./dist/internal/bridge-loader.js",
     "./internal/bridge": "./dist/internal/bridge.js",
+    "./internal/analytics": "./dist/internal/analytics.js",
     "./package.json": "./package.json"
   },
   "types": "./dist/index.d.ts",