@riebeckite/plugin-analytics 0.0.31 → 0.0.32

package/README.md

@@ -60,8 +60,8 @@ In a browser, the initializer sends exactly one event per document:
 
 `path` and `lang` are contextual metadata, not identity. Content without a
 stable ID is not tracked. The initializer is a no-op during builds/SSR and is
-idempotent in a document. Riebeckite's current static document navigation needs
-no SPA route hooks; SPA navigation is not tracked automatically.
+idempotent in a document. With SPA navigation enabled, the plugin sends another
+event after each successful route transition.
 
 Content IDs are an authoring responsibility. Duplicate `id` declarations across
 published notes are reported by

package/README_ja.md

@@ -44,7 +44,7 @@ Core の安定コンテンツ ID（frontmatter の `id`）がある公開コン
 }
 ```
 
-`path` と `lang` は補助情報であり、ID ではありません。安定 ID のないコンテンツは誤って計測しません。ビルド時・SSR 時は何もせず、同じドキュメント内での初期化も冪等です。現行リポジトリは静的なドキュメント遷移のため SPA フックは追加しておらず、SPA 遷移は自動計測しません。
+`path` と `lang` は補助情報であり、ID ではありません。安定 ID のないコンテンツは誤って計測しません。ビルド時・SSR 時は何もせず、同じドキュメント内での初期化も冪等です。SPA ナビゲーションを有効にした場合は、成功した Route Transition ごとに追加で Event を送信します。
 
 コンテンツ ID は執筆側の責務です。公開ノート間での `id` の重複は [`@riebeckite/plugin-diagnostics`](../diagnostics/README_ja.md) が報告し（`duplicate-content-id` / `invalid-content-id`）、プラグイン自身の `validateAnalyticsOptions` が `check` 時に検証します。
 

package/dist/client.js

@@ -1,20 +1,28 @@
 // src/init.ts
 var ANALYTICS_CONTENT_ID_ATTRIBUTE = "data-riebeckite-content-id";
 var INITIALIZED_ATTRIBUTE = "data-riebeckite-analytics-initialized";
-function initAnalytics(config) {
+function initAnalytics({
+  config
+}) {
   if (typeof window === "undefined" || typeof document === "undefined") return;
   if (document.documentElement.hasAttribute(INITIALIZED_ATTRIBUTE)) return;
   document.documentElement.setAttribute(INITIALIZED_ATTRIBUTE, "");
-  const contentId = document.querySelector(`[${ANALYTICS_CONTENT_ID_ATTRIBUTE}]`)?.getAttribute(ANALYTICS_CONTENT_ID_ATTRIBUTE);
-  if (!contentId) return;
-  const event = {
-    type: "page_view",
-    contentId,
-    occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
-    path: window.location.pathname,
-    ...document.documentElement.lang ? { lang: document.documentElement.lang } : {}
+  const sendPageView = () => {
+    const contentId = document.querySelector(`[${ANALYTICS_CONTENT_ID_ATTRIBUTE}]`)?.getAttribute(ANALYTICS_CONTENT_ID_ATTRIBUTE);
+    if (!contentId) return;
+    const event = {
+      type: "page_view",
+      contentId,
+      occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
+      path: window.location.pathname,
+      ...document.documentElement.lang ? { lang: document.documentElement.lang } : {}
+    };
+    void sendAnalyticsEvent(config.collectorUrl, event);
   };
-  void sendAnalyticsEvent(config.collectorUrl, event);
+  sendPageView();
+  if (typeof document.addEventListener !== "function") return;
+  document.addEventListener("riebeckite:navigation", sendPageView);
+  return () => document.removeEventListener("riebeckite:navigation", sendPageView);
 }
 async function sendAnalyticsEvent(collectorUrl, event) {
   await fetch(collectorUrl, {

package/dist/index.js

@@ -8,20 +8,28 @@ import {
 // src/init.ts
 var ANALYTICS_CONTENT_ID_ATTRIBUTE = "data-riebeckite-content-id";
 var INITIALIZED_ATTRIBUTE = "data-riebeckite-analytics-initialized";
-function initAnalytics(config) {
+function initAnalytics({
+  config
+}) {
   if (typeof window === "undefined" || typeof document === "undefined") return;
   if (document.documentElement.hasAttribute(INITIALIZED_ATTRIBUTE)) return;
   document.documentElement.setAttribute(INITIALIZED_ATTRIBUTE, "");
-  const contentId = document.querySelector(`[${ANALYTICS_CONTENT_ID_ATTRIBUTE}]`)?.getAttribute(ANALYTICS_CONTENT_ID_ATTRIBUTE);
-  if (!contentId) return;
-  const event = {
-    type: "page_view",
-    contentId,
-    occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
-    path: window.location.pathname,
-    ...document.documentElement.lang ? { lang: document.documentElement.lang } : {}
+  const sendPageView = () => {
+    const contentId = document.querySelector(`[${ANALYTICS_CONTENT_ID_ATTRIBUTE}]`)?.getAttribute(ANALYTICS_CONTENT_ID_ATTRIBUTE);
+    if (!contentId) return;
+    const event = {
+      type: "page_view",
+      contentId,
+      occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
+      path: window.location.pathname,
+      ...document.documentElement.lang ? { lang: document.documentElement.lang } : {}
+    };
+    void sendAnalyticsEvent(config.collectorUrl, event);
   };
-  void sendAnalyticsEvent(config.collectorUrl, event);
+  sendPageView();
+  if (typeof document.addEventListener !== "function") return;
+  document.addEventListener("riebeckite:navigation", sendPageView);
+  return () => document.removeEventListener("riebeckite:navigation", sendPageView);
 }
 async function sendAnalyticsEvent(collectorUrl, event) {
   await fetch(collectorUrl, {
@@ -146,7 +154,9 @@ function analytics(options) {
         "analytics",
         "@riebeckite/plugin-analytics/client",
         "initAnalytics",
-        options.publicConfig
+        options.publicConfig,
+        "app",
+        "context"
       )
     ],
     onManifestCreated: ({ manifest }) => {

package/dist/src/init.d.ts

@@ -4,4 +4,8 @@ export declare const ANALYTICS_CONTENT_ID_ATTRIBUTE = "data-riebeckite-content-i
  * Sends one document-level page view. Static Riebeckite sites reload documents
  * on navigation; SPA history hooks are intentionally not installed.
  */
-export declare function initAnalytics(config: AnalyticsPublicConfig): void;
+type ClientContext = {
+    config: AnalyticsPublicConfig;
+};
+export declare function initAnalytics({ config, }: ClientContext): (() => void) | undefined;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-analytics",
-  "version": "0.0.31",
+  "version": "0.0.32",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,7 +20,7 @@
     }
   },
   "dependencies": {
-    "@riebeckite/core": "0.0.31"
+    "@riebeckite/core": "0.0.32"
   },
   "devDependencies": {
     "tsx": "^4.22.4"