siteplane 0.2.0-next.0 → 0.2.0-rc.0

package/README.md

@@ -8,18 +8,21 @@ content as fallback in your code, a Draft Mode preview for the editor, Booking a
 Run this in the website's folder, or tell your coding agent "Install Siteplane":
 
 ```bash
-npx siteplane@next init
+npx siteplane@latest init
 ```
 
-Version 0.2 is on the `next` tag until it becomes `latest`.
-
 `init` opens the approval page in the browser. There you sign up or sign in, create the website in Siteplane or pick
 an existing one, and click Connect. If you created the website in Siteplane first, its prompt names the site:
 `npx siteplane@<version> init --site <site ID>`.
 
 `init` then writes `siteplane.config.json`, installs this package, wraps `next.config` in `withSiteplane`, adds the
 route `app/api/siteplane/[...siteplane]/route.ts` and `<SiteplaneBridge />`, and prints the task for the agent.
-Siteplane needs no environment variables or secrets in your project.
+Siteplane needs no environment variables or secrets in your project, and it never deploys: deploy the way the project
+always does.
+
+The approval creates an agent connection for this one website. It may read the task, sync fields and check the
+status; it cannot publish. It is listed under Settings → Connected agents in Siteplane, where it can be revoked, and
+expires after 90 days without use.
 
 ## Field API
 
@@ -49,6 +52,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
@@ -70,3 +80,9 @@ npx siteplane booking test
 approval. The agent connection is stored in the user config directory (`$SITEPLANE_CONFIG_DIR`,
 `$XDG_CONFIG_HOME/siteplane`, `%APPDATA%\siteplane` or `~/.config/siteplane`), never in the project; `--no-browser`
 skips opening the browser.
+
+## More
+
+- Instructions for coding agents: https://siteplane.io/agents and https://siteplane.io/llms.txt
+- Removing Siteplane: Settings → Export in Siteplane downloads every field with its published value and gives your
+  coding agent a task that writes the values into the code and removes this package.

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-rc.0";
 
 // 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-rc.0";
 
 // 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-rc.0",
   "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",