@auspex-ai/next 0.0.0-stage → 1.4.2

package/dist/index.cjs

@@ -0,0 +1,169 @@
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
+let _auspex_ai_core = require("@auspex-ai/core");
+let next_navigation_js = require("next/navigation.js");
+let next_router_js = require("next/router.js");
+next_router_js = require_rolldown_runtime.__toESM(next_router_js, 1);
+let react = require("react");
+//#region src/provider/route.ts
+function decode(seg) {
+	try {
+		return decodeURIComponent(seg);
+	} catch {
+		return seg;
+	}
+}
+/**
+* `/products/medusa-t-shirt` + `{ handle: 'medusa-t-shirt' }` → `/products/[handle]`。
+* catch-all(値が配列)は連続するセグメントをまとめて `[...name]` にする。
+*
+* params はルートの浅い順に並ぶので、パスの末尾側から深い params を順に当てる(動的セグメントは葉に
+* 寄ることが多いため、`/products/products` のような静的セグメントと同じ値は後ろ側を動的とみなす)。
+* パスに見つからない params(ミドルウェアの rewrite で URL に出ないロケール等)は飛ばす。
+* 限界: 静的セグメントと同じ値の動的セグメントが前にある場合(`/[lang]/en` で lang=en)は取り違える。
+*/
+function routeTemplate(pathname, params) {
+	const segs = pathname.split("/").filter((s) => s !== "");
+	const values = segs.map(decode);
+	const out = [...segs];
+	let end = segs.length;
+	for (const [name, value] of Object.entries(params ?? {}).reverse()) {
+		if (value === void 0) continue;
+		const parts = Array.isArray(value) ? value : [value];
+		if (parts.length === 0) continue;
+		for (let start = end - parts.length; start >= 0; start--) {
+			if (!parts.every((p, i) => values[start + i] === p)) continue;
+			out.fill(null, start, start + parts.length);
+			out[start] = Array.isArray(value) ? `[...${name}]` : `[${name}]`;
+			end = start;
+			break;
+		}
+	}
+	return `/${out.filter((s) => s !== null).join("/")}`;
+}
+//#endregion
+//#region src/index.tsx
+/** 顧客のビルドで `NEXT_PUBLIC_BUILD_ID=$GIT_SHA` を設定する(Next がビルド時にこの式を値へ置換する) */
+function envBuildId() {
+	try {
+		return process.env.NEXT_PUBLIC_BUILD_ID || null;
+	} catch {
+		return null;
+	}
+}
+/**
+* pages router: `Router.pathname` がそのままテンプレート(`/products/[handle]`)。
+* `__NEXT_DATA__.page` は最初のページのまま更新されないので、ルーターが無いときだけ使う
+*/
+function pagesAdapter(data) {
+	return {
+		getRoute() {
+			try {
+				return next_router_js.default.pathname;
+			} catch {
+				return data.page ?? null;
+			}
+		},
+		getBuildId: () => envBuildId() ?? data.buildId ?? null,
+		onRouteChange(cb) {
+			next_router_js.default.events.on("routeChangeComplete", cb);
+			return () => next_router_js.default.events.off("routeChangeComplete", cb);
+		}
+	};
+}
+function createAppRouteStore() {
+	let current = null;
+	const listeners = /* @__PURE__ */ new Set();
+	return {
+		adapter: {
+			getRoute: () => current,
+			getBuildId: envBuildId,
+			onRouteChange(cb) {
+				listeners.add(cb);
+				return () => listeners.delete(cb);
+			}
+		},
+		set(route) {
+			if (route === current) return;
+			current = route;
+			for (const cb of listeners) cb();
+		}
+	};
+}
+/** userLoading が true のまま計装を待つ上限(ms)。過ぎたら userId なしで始める(計測が黙って止まらないように) */
+const USER_WAIT_MS = 3e3;
+function AuspexProvider({ publicKey, host, userId, userLoading, children }) {
+	const pathname = (0, next_navigation_js.usePathname)();
+	const params = (0, next_navigation_js.useParams)();
+	const route = pathname === null ? null : routeTemplate(pathname, params);
+	const [store] = (0, react.useState)(createAppRouteStore);
+	(0, react.useEffect)(() => {
+		store.set(route);
+	}, [store, route]);
+	const [ready, setReady] = (0, react.useState)(userLoading !== true);
+	(0, react.useEffect)(() => {
+		if (ready) return;
+		if (userLoading !== true) {
+			setReady(true);
+			return;
+		}
+		const t = setTimeout(() => setReady(true), USER_WAIT_MS);
+		return () => clearTimeout(t);
+	}, [ready, userLoading]);
+	const latestUserId = (0, react.useRef)(userId);
+	(0, react.useEffect)(() => {
+		latestUserId.current = userId;
+	});
+	(0, react.useEffect)(() => {
+		if (!publicKey) {
+			(0, _auspex_ai_core.init)({ host });
+			return;
+		}
+		if (!ready) return;
+		const data = window.__NEXT_DATA__;
+		const h = (0, _auspex_ai_core.init)({
+			publicKey,
+			host,
+			adapter: data ? pagesAdapter(data) : store.adapter,
+			userId: latestUserId.current
+		});
+		return () => h?.shutdown();
+	}, [
+		publicKey,
+		host,
+		store,
+		ready
+	]);
+	(0, react.useEffect)(() => {
+		if (!publicKey || !ready || userId === void 0) return;
+		(0, _auspex_ai_core.identify)(userId);
+	}, [
+		publicKey,
+		ready,
+		userId
+	]);
+	return children;
+}
+//#endregion
+exports.AuspexProvider = AuspexProvider;
+exports.USER_WAIT_MS = USER_WAIT_MS;
+Object.defineProperty(exports, "identify", {
+	enumerable: true,
+	get: function() {
+		return _auspex_ai_core.identify;
+	}
+});
+Object.defineProperty(exports, "isUserId", {
+	enumerable: true,
+	get: function() {
+		return _auspex_ai_core.isUserId;
+	}
+});
+Object.defineProperty(exports, "reset", {
+	enumerable: true,
+	get: function() {
+		return _auspex_ai_core.reset;
+	}
+});
+exports.routeTemplate = routeTemplate;

package/dist/index.d.cts

@@ -0,0 +1,41 @@
+import { ReactNode } from "react";
+import { identify, isUserId, reset } from "@auspex-ai/core";
+//#region src/provider/route.d.ts
+type Params = Record<string, string | string[] | undefined>;
+/**
+ * `/products/medusa-t-shirt` + `{ handle: 'medusa-t-shirt' }` → `/products/[handle]`。
+ * catch-all(値が配列)は連続するセグメントをまとめて `[...name]` にする。
+ *
+ * params はルートの浅い順に並ぶので、パスの末尾側から深い params を順に当てる(動的セグメントは葉に
+ * 寄ることが多いため、`/products/products` のような静的セグメントと同じ値は後ろ側を動的とみなす)。
+ * パスに見つからない params(ミドルウェアの rewrite で URL に出ないロケール等)は飛ばす。
+ * 限界: 静的セグメントと同じ値の動的セグメントが前にある場合(`/[lang]/en` で lang=en)は取り違える。
+ */
+export declare function routeTemplate(pathname: string, params: Params | null | undefined): string;
+//#endregion
+//#region src/index.d.ts
+export interface AuspexProviderProps {
+  /** write-only キー。無ければ何もしない(イベントもリスナーも無し) */
+  publicKey?: string | undefined;
+  /** Ingestion のベース URL */
+  host: string;
+  /**
+   * ログインしている人のアプリ側の ID(Design Doc #45)。値なら identify、null(ログインしていない)なら、このブラウザが
+   * 前に identify されていたときだけ reset する。undefined は何もしない(計装は今までどおりすぐ始める)。
+   * 読み込み中は undefined ではなく userLoading で表す(undefined のまま始めると、前に別の人に結ばれたブラウザで
+   * 最初の view が前の人の匿名 ID で出る)。メールアドレスではなく内部の ID を渡す
+   */
+  userId?: string | null | undefined;
+  /**
+   * ログインしている人をまだ読み込み中なら true(例: Auth.js の `status === 'loading'`、Design Doc #45)。true の間は
+   * 計装を始めず、分かってから開いた時点の userId を最初の view より前に当てる(前に別の人に結ばれたブラウザで、最初の
+   * view を前の人の匿名 ID で送らないため)。USER_WAIT_MS を過ぎても true のままなら userId なしで始める
+   */
+  userLoading?: boolean | undefined;
+  children?: ReactNode;
+}
+/** userLoading が true のまま計装を待つ上限(ms)。過ぎたら userId なしで始める(計測が黙って止まらないように) */
+export declare const USER_WAIT_MS = 3000;
+export declare function AuspexProvider({ publicKey, host, userId, userLoading, children }: AuspexProviderProps): ReactNode;
+//#endregion
+export { identify, isUserId, reset };

package/dist/index.d.mts

@@ -0,0 +1,41 @@
+import { identify, isUserId, reset } from "@auspex-ai/core";
+import { ReactNode } from "react";
+//#region src/provider/route.d.ts
+type Params = Record<string, string | string[] | undefined>;
+/**
+ * `/products/medusa-t-shirt` + `{ handle: 'medusa-t-shirt' }` → `/products/[handle]`。
+ * catch-all(値が配列)は連続するセグメントをまとめて `[...name]` にする。
+ *
+ * params はルートの浅い順に並ぶので、パスの末尾側から深い params を順に当てる(動的セグメントは葉に
+ * 寄ることが多いため、`/products/products` のような静的セグメントと同じ値は後ろ側を動的とみなす)。
+ * パスに見つからない params(ミドルウェアの rewrite で URL に出ないロケール等)は飛ばす。
+ * 限界: 静的セグメントと同じ値の動的セグメントが前にある場合(`/[lang]/en` で lang=en)は取り違える。
+ */
+export declare function routeTemplate(pathname: string, params: Params | null | undefined): string;
+//#endregion
+//#region src/index.d.ts
+export interface AuspexProviderProps {
+  /** write-only キー。無ければ何もしない(イベントもリスナーも無し) */
+  publicKey?: string | undefined;
+  /** Ingestion のベース URL */
+  host: string;
+  /**
+   * ログインしている人のアプリ側の ID(Design Doc #45)。値なら identify、null(ログインしていない)なら、このブラウザが
+   * 前に identify されていたときだけ reset する。undefined は何もしない(計装は今までどおりすぐ始める)。
+   * 読み込み中は undefined ではなく userLoading で表す(undefined のまま始めると、前に別の人に結ばれたブラウザで
+   * 最初の view が前の人の匿名 ID で出る)。メールアドレスではなく内部の ID を渡す
+   */
+  userId?: string | null | undefined;
+  /**
+   * ログインしている人をまだ読み込み中なら true(例: Auth.js の `status === 'loading'`、Design Doc #45)。true の間は
+   * 計装を始めず、分かってから開いた時点の userId を最初の view より前に当てる(前に別の人に結ばれたブラウザで、最初の
+   * view を前の人の匿名 ID で送らないため)。USER_WAIT_MS を過ぎても true のままなら userId なしで始める
+   */
+  userLoading?: boolean | undefined;
+  children?: ReactNode;
+}
+/** userLoading が true のまま計装を待つ上限(ms)。過ぎたら userId なしで始める(計測が黙って止まらないように) */
+export declare const USER_WAIT_MS = 3000;
+export declare function AuspexProvider({ publicKey, host, userId, userLoading, children }: AuspexProviderProps): ReactNode;
+//#endregion
+export { identify, isUserId, reset };

package/dist/index.mjs

@@ -0,0 +1,146 @@
+"use client";
+import { identify, identify as identify$1, init, isUserId, reset } from "@auspex-ai/core";
+import { useParams, usePathname } from "next/navigation.js";
+import Router from "next/router.js";
+import { useEffect, useRef, useState } from "react";
+//#region src/provider/route.ts
+function decode(seg) {
+	try {
+		return decodeURIComponent(seg);
+	} catch {
+		return seg;
+	}
+}
+/**
+* `/products/medusa-t-shirt` + `{ handle: 'medusa-t-shirt' }` → `/products/[handle]`。
+* catch-all(値が配列)は連続するセグメントをまとめて `[...name]` にする。
+*
+* params はルートの浅い順に並ぶので、パスの末尾側から深い params を順に当てる(動的セグメントは葉に
+* 寄ることが多いため、`/products/products` のような静的セグメントと同じ値は後ろ側を動的とみなす)。
+* パスに見つからない params(ミドルウェアの rewrite で URL に出ないロケール等)は飛ばす。
+* 限界: 静的セグメントと同じ値の動的セグメントが前にある場合(`/[lang]/en` で lang=en)は取り違える。
+*/
+function routeTemplate(pathname, params) {
+	const segs = pathname.split("/").filter((s) => s !== "");
+	const values = segs.map(decode);
+	const out = [...segs];
+	let end = segs.length;
+	for (const [name, value] of Object.entries(params ?? {}).reverse()) {
+		if (value === void 0) continue;
+		const parts = Array.isArray(value) ? value : [value];
+		if (parts.length === 0) continue;
+		for (let start = end - parts.length; start >= 0; start--) {
+			if (!parts.every((p, i) => values[start + i] === p)) continue;
+			out.fill(null, start, start + parts.length);
+			out[start] = Array.isArray(value) ? `[...${name}]` : `[${name}]`;
+			end = start;
+			break;
+		}
+	}
+	return `/${out.filter((s) => s !== null).join("/")}`;
+}
+//#endregion
+//#region src/index.tsx
+/** 顧客のビルドで `NEXT_PUBLIC_BUILD_ID=$GIT_SHA` を設定する(Next がビルド時にこの式を値へ置換する) */
+function envBuildId() {
+	try {
+		return process.env.NEXT_PUBLIC_BUILD_ID || null;
+	} catch {
+		return null;
+	}
+}
+/**
+* pages router: `Router.pathname` がそのままテンプレート(`/products/[handle]`)。
+* `__NEXT_DATA__.page` は最初のページのまま更新されないので、ルーターが無いときだけ使う
+*/
+function pagesAdapter(data) {
+	return {
+		getRoute() {
+			try {
+				return Router.pathname;
+			} catch {
+				return data.page ?? null;
+			}
+		},
+		getBuildId: () => envBuildId() ?? data.buildId ?? null,
+		onRouteChange(cb) {
+			Router.events.on("routeChangeComplete", cb);
+			return () => Router.events.off("routeChangeComplete", cb);
+		}
+	};
+}
+function createAppRouteStore() {
+	let current = null;
+	const listeners = /* @__PURE__ */ new Set();
+	return {
+		adapter: {
+			getRoute: () => current,
+			getBuildId: envBuildId,
+			onRouteChange(cb) {
+				listeners.add(cb);
+				return () => listeners.delete(cb);
+			}
+		},
+		set(route) {
+			if (route === current) return;
+			current = route;
+			for (const cb of listeners) cb();
+		}
+	};
+}
+/** userLoading が true のまま計装を待つ上限(ms)。過ぎたら userId なしで始める(計測が黙って止まらないように) */
+const USER_WAIT_MS = 3e3;
+function AuspexProvider({ publicKey, host, userId, userLoading, children }) {
+	const pathname = usePathname();
+	const params = useParams();
+	const route = pathname === null ? null : routeTemplate(pathname, params);
+	const [store] = useState(createAppRouteStore);
+	useEffect(() => {
+		store.set(route);
+	}, [store, route]);
+	const [ready, setReady] = useState(userLoading !== true);
+	useEffect(() => {
+		if (ready) return;
+		if (userLoading !== true) {
+			setReady(true);
+			return;
+		}
+		const t = setTimeout(() => setReady(true), USER_WAIT_MS);
+		return () => clearTimeout(t);
+	}, [ready, userLoading]);
+	const latestUserId = useRef(userId);
+	useEffect(() => {
+		latestUserId.current = userId;
+	});
+	useEffect(() => {
+		if (!publicKey) {
+			init({ host });
+			return;
+		}
+		if (!ready) return;
+		const data = window.__NEXT_DATA__;
+		const h = init({
+			publicKey,
+			host,
+			adapter: data ? pagesAdapter(data) : store.adapter,
+			userId: latestUserId.current
+		});
+		return () => h?.shutdown();
+	}, [
+		publicKey,
+		host,
+		store,
+		ready
+	]);
+	useEffect(() => {
+		if (!publicKey || !ready || userId === void 0) return;
+		identify$1(userId);
+	}, [
+		publicKey,
+		ready,
+		userId
+	]);
+	return children;
+}
+//#endregion
+export { AuspexProvider, USER_WAIT_MS, identify, isUserId, reset, routeTemplate };