@powerhousedao/connect 6.1.0-dev.5 → 6.1.0-dev.6

package/dist/{sidebar-DPz78uG1.js → sidebar-1Vu1bx0C.js}

@@ -1,13 +1,14 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5b1d7a07-2b7c-56f8-8b06-e3bea15efbff")}catch(e){}}();
-import { n as defaultPHAppConfig, r as defaultPHDocumentEditorConfig, t as connectConfig } from "./connect.config-Cuh0hj_Q.js";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5a417e42-ad53-5ab7-a264-5f81414a1e25")}catch(e){}}();
+import { n as defaultPHAppConfig, r as defaultPHDocumentEditorConfig, t as connectConfig } from "./connect.config-B2xP5Iez.js";
 import { n as toast, t as ToastContainer } from "./toast-DnODOv28.js";
-import { t as i18n } from "./i18n-4rfcgnb9.js";
+import { t as i18n } from "./i18n-BuVT7wFQ.js";
 import { c as subscribeReactorPgMajor, d as createFileDataStore, f as idbError, l as IDB_STORE_NAME, m as readPgVersionFile, p as openIdb, r as getCachedReactorPgMajor, u as PRIMARY_IDB_NAMES } from "./pglite-runtime-Btp8ZXVH.js";
-import { t as serviceWorkerManager } from "./registerServiceWorker-CMRF2LWE.js";
-import { driveCollectionId, getRevisionFromDate, logout, openRenown, setPHAppConfig, setPHDocumentEditorConfig, setRevisionHistoryVisible, setSelectedDrive, setSelectedNode, showPHModal, useAppModuleById, useDefaultAppModule, useDocumentById, useDocumentModelModuleById, useDocumentOperations, useDrives, useEditorModuleById, useFallbackEditorModule, useNodeParentFolderById, usePHModal, usePackageDiscoveryService, useRevisionHistoryVisible, useSelectedDocument, useSelectedDocumentId, useSelectedDriveSafe, useSelectedFolder, useSelectedTimelineItem, useSyncList, useUser, useVetraPackageManager, useVetraPackages } from "@powerhousedao/reactor-browser";
+import { t as serviceWorkerManager } from "./registerServiceWorker-5FDz0DvH.js";
+import { driveCollectionId, getRevisionFromDate, logout, openRenown, setPHAppConfig, setPHDocumentEditorConfig, setRevisionHistoryVisible, setSelectedDrive, setSelectedNode, showPHModal, useAppModuleById, useDefaultAppModule, useDocumentById, useDocumentModelModuleById, useDocumentOperations, useDrives, useEditorModuleById, useFallbackEditorModule, useNodeParentFolderById, usePHModal, usePackageDiscoveryService, useReactorClientModule, useRevisionHistoryVisible, useSelectedDocument, useSelectedDocumentId, useSelectedDriveSafe, useSelectedFolder, useSelectedTimelineItem, useSyncList, useUser, useVetraPackageManager, useVetraPackages } from "@powerhousedao/reactor-browser";
 import { childLogger } from "document-model";
 import React, { StrictMode, Suspense, lazy, useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { z } from "zod";
 import { Trans, useTranslation } from "react-i18next";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Outlet, RouterProvider, createBrowserRouter, createRoutesFromChildren, matchRoutes, useLocation, useNavigationType } from "react-router-dom";
@@ -55,6 +56,224 @@ const useAcceptedCookies = () => {
 	return [useSyncExternalStore(subscribe$1, getCookies, getCookies), setCookies];
 };
 //#endregion
+//#region src/services/openpanel/buffer.ts
+const buffer = [];
+let errorHandler;
+function defaultOnError(err) {
+	console.warn("[useOpenPanel] track failed:", err);
+}
+/**
+* Forward a single event to the active client, swallowing any throw.
+*
+* The outer try/catch handles synchronous throws from `client.track`; the
+* inner `.catch()` handles rejected promises. Both are needed because
+* `Promise.resolve(x).catch()` cannot catch a throw from evaluating `x`.
+*/
+function forward(client, name, props) {
+	try {
+		Promise.resolve(client.track(name, props)).catch((err) => (errorHandler ?? defaultOnError)(err));
+	} catch (err) {
+		(errorHandler ?? defaultOnError)(err);
+	}
+}
+/**
+* Drain the pre-init buffer in FIFO order through `client.track`, then forward
+* subsequent events directly. Called once from `getOpenPanelClient()`.
+*/
+function drainOpenPanelBuffer(client, onError) {
+	errorHandler = onError;
+	const pending = buffer.splice(0, buffer.length);
+	for (const [name, props] of pending) forward(client, name, props);
+}
+/**
+* Clear the buffer and reset the active client. Buffered pre-consent events
+* are discarded so they are not replayed if the user later re-accepts.
+*/
+function clearOpenPanelBuffer() {
+	buffer.length = 0;
+	errorHandler = void 0;
+}
+//#endregion
+//#region src/services/openpanel/client.ts
+let client;
+/**
+* Returns the cached `OpenPanel` singleton, building it on first call.
+*
+* When `config.clientId` is empty it returns `undefined` without importing
+* `@openpanel/web`, so the bundler can tree-shake the SDK out of production.
+*/
+async function getOpenPanelClient(config) {
+	if (!config.clientId) return;
+	if (client) return client;
+	const { OpenPanel: OpenPanelClass } = await import("@openpanel/web");
+	client = new OpenPanelClass({
+		clientId: config.clientId,
+		...config.apiUrl ? { apiUrl: config.apiUrl } : {}
+	});
+	drainOpenPanelBuffer(client);
+	return client;
+}
+/**
+* Clears the cached singleton and the pre-init buffer. Call on consent
+* revocation or during tests; buffered events are discarded, not replayed.
+*/
+function resetOpenPanelClient() {
+	client = void 0;
+	clearOpenPanelBuffer();
+}
+//#endregion
+//#region src/services/openpanel/events.json
+var events_default = [
+	{
+		"documentType": "powerhouse/document-drive",
+		"actionTypes": [
+			"ADD_FOLDER",
+			"DELETE_NODE",
+			"ADD_FILE",
+			"UPDATE_FILE",
+			"COPY_NODE",
+			"MOVE_NODE",
+			"SET_DRIVE_NAME",
+			"SET_DRIVE_ICON"
+		]
+	},
+	{
+		"documentType": "powerhouse/document-model",
+		"actionTypes": [
+			"SET_MODEL_NAME",
+			"SET_MODEL_ID",
+			"ADD_MODULE",
+			"DELETE_MODULE",
+			"ADD_OPERATION",
+			"DELETE_OPERATION"
+		]
+	},
+	{
+		"documentType": "powerhouse/reactor-drive",
+		"actionTypes": [
+			"ADD_FOLDER",
+			"REMOVE_FOLDER",
+			"UPDATE_FOLDER"
+		]
+	}
+];
+//#endregion
+//#region src/services/openpanel/events.ts
+const EventMappingSchema = z.object({
+	documentType: z.string().min(1),
+	actionTypes: z.array(z.string().min(1)).min(1),
+	alias: z.string().optional()
+}).strict();
+const EventMappingsSchema = z.array(EventMappingSchema).readonly();
+/**
+* Parses and validates the event mapping table, returning the validated array
+* and an O(1) lookup map. Accepts a `raw` override for tests. Throws on zod
+* failures and on duplicate `(documentType, actionType)` pairs.
+*/
+function loadEvents(raw = events_default) {
+	const result = EventMappingsSchema.safeParse(raw);
+	if (!result.success) throw new Error(`Invalid OpenPanel events.json: ${result.error.message}`);
+	const mappings = result.data;
+	const lookupMap = /* @__PURE__ */ new Map();
+	for (const mapping of mappings) {
+		let inner = lookupMap.get(mapping.documentType);
+		if (!inner) {
+			inner = /* @__PURE__ */ new Map();
+			lookupMap.set(mapping.documentType, inner);
+		}
+		for (const actionType of mapping.actionTypes) {
+			if (inner.has(actionType)) throw new Error(`Duplicate OpenPanel event mapping for ${mapping.documentType}/${actionType}`);
+			inner.set(actionType, mapping);
+		}
+	}
+	return {
+		mappings,
+		lookupMap
+	};
+}
+const { mappings: defaultMappings, lookupMap: defaultLookupMap } = loadEvents();
+/** Validated mapping array from the bundled events.json. */
+const eventMappings = defaultMappings;
+/** O(1) lookup map: documentType → actionType → mapping. */
+const eventLookupMap = defaultLookupMap;
+/**
+* Normalizes a document type into a safe event-name segment: lowercased, `/`
+* replaced with `.`, and any character outside `[a-z0-9._-]` stripped.
+* e.g. `powerhouse/document-drive` → `powerhouse.document-drive`.
+*/
+function normalize(documentType) {
+	return documentType.toLowerCase().replace(/\//g, ".").replace(/[^a-z0-9._-]/g, "");
+}
+/**
+* Derives the OpenPanel event name: `mapping.alias` when present, otherwise
+* `${normalize(documentType)}.${actionType.toLowerCase()}`.
+*/
+function deriveEventName(mapping, op) {
+	if (mapping.alias) return mapping.alias;
+	return `${normalize(op.context.documentType)}.${op.operation.action.type.toLowerCase()}`;
+}
+/** Builds the default properties attached to every OpenPanel event. */
+function buildDefaultProperties(op) {
+	return {
+		documentType: op.context.documentType,
+		actionType: op.operation.action.type,
+		documentId: op.context.documentId,
+		scope: op.context.scope,
+		branch: op.context.branch,
+		app: "connect"
+	};
+}
+//#endregion
+//#region src/services/openpanel/processor.ts
+/**
+* Read-only reactor `IProcessor` that translates matching document operations
+* into OpenPanel analytics events. Operations whose `(documentType, actionType)`
+* pair is absent from the lookup map are skipped; per-operation errors are
+* routed to `onError` and never thrown back to the manager.
+*/
+var OpenPanelProcessor = class {
+	constructor(client, lookupMap, onError = (err) => console.warn("[OpenPanelProcessor] Error tracking event:", err)) {
+		this.client = client;
+		this.lookupMap = lookupMap;
+		this.onError = onError;
+	}
+	async onOperations(operations) {
+		for (const op of operations) {
+			const inner = this.lookupMap.get(op.context.documentType);
+			if (!inner) continue;
+			const mapping = inner.get(op.operation.action.type);
+			if (!mapping) continue;
+			const name = deriveEventName(mapping, op);
+			const payload = buildDefaultProperties(op);
+			try {
+				await this.client.track(name, payload);
+			} catch (err) {
+				this.onError(err, op);
+			}
+		}
+	}
+	async onDisconnect() {
+		this.client.flush?.();
+	}
+};
+//#endregion
+//#region src/services/openpanel/factory.ts
+/**
+* Returns a `ProcessorFactory` that, for each drive, creates a single
+* `OpenPanelProcessor` record whose `filter.documentType` is the union of all
+* document types present in the event mapping table.
+*/
+function createOpenPanelProcessorFactory(config) {
+	return function openPanelProcessorFactory(_driveHeader) {
+		const documentType = Array.from(config.events.lookupMap.keys());
+		return [{
+			processor: new OpenPanelProcessor(config.client, config.events.lookupMap, config.onError),
+			filter: { documentType },
+			startFrom: config.startFrom ?? "current"
+		}];
+	};
+}
+//#endregion
 //#region src/hooks/useIsEmbedded.ts
 /**
 * Detects whether Connect is being rendered inside another app (e.g. inside
@@ -229,6 +448,144 @@ const Analytics = () => {
 	return null;
 };
 //#endregion
+//#region src/components/openpanel-traits.ts
+/**
+* Builds the OpenPanel identity traits from a renown User.
+*
+* Rules:
+* - `credential` (contains a JWT) is **never** forwarded.
+* - `did` / `profileId` is sent as the top-level `profileId` key in the
+*   `client.identify()` call — it is **not** duplicated inside traits.
+* - Optional fields (`ens`, `profile`) are only included when their value is
+*   non-nullish (guards against `null` from `RenownProfile` fields as well
+*   as plain `undefined`).
+*
+* Mirror the Sentry pattern in `store/user.ts`: destructure off `credential`
+* first, then assemble the trait payload from the remainder.
+*/
+function buildTraits(user) {
+	const { credential: _credential, ...rest } = user;
+	const traits = {
+		address: rest.address,
+		networkId: rest.networkId,
+		chainId: rest.chainId
+	};
+	if (rest.ens?.name != null) traits.ensName = rest.ens.name;
+	if (rest.ens?.avatarUrl != null) traits.ensAvatar = rest.ens.avatarUrl;
+	if (rest.profile?.username != null) traits.username = rest.profile.username;
+	if (rest.profile?.userImage != null) traits.userImage = rest.profile.userImage;
+	if (rest.profile?.documentId != null) traits.profileDocumentId = rest.profile.documentId;
+	if (rest.profile?.createdAt != null) traits.profileCreatedAt = rest.profile.createdAt;
+	return traits;
+}
+//#endregion
+//#region src/components/openpanel.tsx
+/**
+* `OpenPanel` is a `null`-rendering component that manages the full lifecycle
+* of the OpenPanel analytics subsystem.
+*
+* Gates:
+* - `useAcceptedCookies().analytics === true` — the existing analytics cookie.
+* - `connectConfig.openPanel.clientId` non-empty — no client ID → no-op.
+*
+* Behaviour when both gates pass:
+* 1. Lazy-imports `@openpanel/web` and builds the singleton via
+*    `getOpenPanelClient(connectConfig.openPanel)`.
+* 2. Exposes the client on `window.openPanel` for the card-6 `useOpenPanel()`
+*    hook to consume.
+* 3. If `connectConfig.openPanel.trackOperations`, registers the processor
+*    factory against `processorManager` so document operations are forwarded.
+* 4. Calls `client.identify()` when the renown user transitions from
+*    `undefined` → defined (login).
+* 5. Calls `client.clear()` when the user transitions from defined →
+*    `undefined` (logout).
+*
+* Teardown (unmount **or** consent revocation):
+* - `unregisterFactory("openpanel")` to remove the processor.
+* - `resetOpenPanelClient()` to clear the singleton.
+* - `window.openPanel` is cleared.
+*
+* Mirrors the Sentry pattern in `store/user.ts` for login/logout detection.
+* Analytics failures are caught and forwarded to `console.warn` — they must
+* never throw into the application.
+*
+* Mounted next to `<Analytics />` in `app.tsx`.
+*/
+function OpenPanel() {
+	const [{ analytics }] = useAcceptedCookies();
+	const user = useUser();
+	const reactorClientModule = useReactorClientModule();
+	const [client, setClient] = useState();
+	/**
+	* Tracks the previous `user` value so we can detect the two transitions:
+	*   undefined → defined  (login)
+	*   defined   → undefined (logout)
+	*/
+	const prevUserRef = useRef(void 0);
+	const enabled = analytics && !!connectConfig.openPanel.clientId;
+	const processorManager = reactorClientModule?.reactorModule?.processorManager;
+	useEffect(() => {
+		if (!enabled) return;
+		let cancelled = false;
+		(async () => {
+			let builtClient;
+			try {
+				builtClient = await getOpenPanelClient(connectConfig.openPanel);
+			} catch (err) {
+				console.warn("[OpenPanel] Failed to build client:", err);
+				return;
+			}
+			if (cancelled || !builtClient) return;
+			setClient(builtClient);
+			window.openPanel = builtClient;
+			if (connectConfig.openPanel.trackOperations && processorManager) try {
+				await processorManager.registerFactory("openpanel", createOpenPanelProcessorFactory({
+					client: builtClient,
+					events: {
+						mappings: eventMappings,
+						lookupMap: eventLookupMap
+					},
+					startFrom: "current"
+				}));
+				if (cancelled) await processorManager.unregisterFactory("openpanel").catch((err) => console.warn("[OpenPanel] Failed to unregister factory after cancellation:", err));
+			} catch (err) {
+				console.warn("[OpenPanel] Failed to register processor factory:", err);
+			}
+		})();
+		return () => {
+			cancelled = true;
+			prevUserRef.current = void 0;
+			if (connectConfig.openPanel.trackOperations && processorManager) processorManager.unregisterFactory("openpanel").catch((err) => console.warn("[OpenPanel] Failed to unregister processor factory:", err));
+			resetOpenPanelClient();
+			window.openPanel = void 0;
+			setClient(void 0);
+		};
+	}, [enabled, processorManager]);
+	useEffect(() => {
+		if (!enabled || !client) return;
+		const prev = prevUserRef.current;
+		prevUserRef.current = user;
+		if (!prev && user) try {
+			client.identify({
+				profileId: user.did,
+				properties: buildTraits(user)
+			});
+		} catch (err) {
+			console.warn("[OpenPanel] Failed to identify user:", err);
+		}
+		else if (prev && !user) try {
+			client.clear();
+		} catch (err) {
+			console.warn("[OpenPanel] Failed to clear user:", err);
+		}
+	}, [
+		client,
+		user,
+		enabled
+	]);
+	return null;
+}
+//#endregion
 //#region src/components/document-editor-container.tsx
 function DocumentEditorContainer() {
 	const [selectedDocument] = useSelectedDocument();
@@ -890,16 +1247,16 @@ const MigrationBanner = () => {
 //#endregion
 //#region src/components/modal/modals-container.tsx
 const AddDriveModal$1 = lazy(() => import("./AddDriveModal-ZK9-BWMB.js").then((m) => ({ default: m.AddDriveModal })));
-const ClearStorageModal = lazy(() => import("./ClearStorageModal-x5YChNQM.js").then((m) => ({ default: m.ClearStorageModal })));
+const ClearStorageModal = lazy(() => import("./ClearStorageModal-Dx_kY08P.js").then((m) => ({ default: m.ClearStorageModal })));
 const CookiesPolicyModal = lazy(() => import("./CookiesPolicyModal-DiXQV82b.js").then((m) => ({ default: m.CookiesPolicyModal })));
 const CreateDocumentModal$1 = lazy(() => import("./CreateDocumentModal-BhJh4nWt.js").then((m) => ({ default: m.CreateDocumentModal })));
-const DebugSettingsModal = lazy(() => import("./DebugSettingsModal-DTwoo4sR.js").then((m) => ({ default: m.DebugSettingsModal })));
+const DebugSettingsModal = lazy(() => import("./DebugSettingsModal-CFk_kZiG.js").then((m) => ({ default: m.DebugSettingsModal })));
 const DeleteDriveModal = lazy(() => import("./DeleteDriveModal-CbuIdjKY.js").then((m) => ({ default: m.DeleteDriveModal })));
 const DeleteItemModal = lazy(() => import("./DeleteItemModal-9ErYlauT.js").then((m) => ({ default: m.DeleteItemModal })));
 const DisclaimerModal = lazy(() => import("./DisclaimerModal-CfDeiBz8.js").then((m) => ({ default: m.DisclaimerModal })));
 const DriveSettingsModal$1 = lazy(() => import("./DriveSettingsModal-DEk05PS7.js").then((m) => ({ default: m.DriveSettingsModal })));
 const DownloadDocumentWithErrorsModal = lazy(() => import("./DownloadDocumentWithErrorsModal-KZGWQ4J7.js").then((m) => ({ default: m.DownloadDocumentWithErrorsModal })));
-const SettingsModal$1 = lazy(() => import("./SettingsModal--JkI5IR3.js").then((m) => ({ default: m.SettingsModal })));
+const SettingsModal$1 = lazy(() => import("./SettingsModal-BRgHRZDb.js").then((m) => ({ default: m.SettingsModal })));
 const UpgradeDriveModal = lazy(() => import("./UpgradeDriveModal-BwI5E5k3.js").then((m) => ({ default: m.UpgradeDriveModal })));
 const modalComponents = {
 	addDrive: AddDriveModal$1,
@@ -912,7 +1269,7 @@ const modalComponents = {
 	disclaimer: DisclaimerModal,
 	driveSettings: DriveSettingsModal$1,
 	downloadDocumentWithErrors: DownloadDocumentWithErrorsModal,
-	inspector: lazy(() => import("./InspectorModal-CCzUCfvG.js").then((m) => ({ default: m.InspectorModal }))),
+	inspector: lazy(() => import("./InspectorModal-DRoE6sso.js").then((m) => ({ default: m.InspectorModal }))),
 	settings: SettingsModal$1,
 	upgradeDrive: UpgradeDriveModal,
 	missingPackage: lazy(() => import("./MissingPackageModal-CUdcDjSO.js").then((m) => ({ default: m.ConnectMissingPackageModal })))
@@ -935,7 +1292,7 @@ const ModalsContainer = lazy(async () => {
 //#endregion
 //#region src/components/app-loader.tsx
 const AppLoader = (props) => {
-	const Load = lazy(() => import("./load-DveXDmRN.js").then((m) => m.loadComponent(props.localPackage)));
+	const Load = lazy(() => import("./load-DBhrZTcC.js").then((m) => m.loadComponent(props.localPackage)));
 	return /* @__PURE__ */ jsx(StrictMode, { children: /* @__PURE__ */ jsxs(ErrorBoundary$1, {
 		fallbackRender: (props) => /* @__PURE__ */ jsx(AppSkeleton, { children: /* @__PURE__ */ jsx(DetailedFallback, { ...props }) }),
 		resetKeys: [props.localPackage],
@@ -1135,7 +1492,8 @@ const App = () => {
 		/* @__PURE__ */ jsx(MissingModelBanner, {}),
 		/* @__PURE__ */ jsx(Router, {}),
 		/* @__PURE__ */ jsx(PackageInstallPrompt, {}),
-		/* @__PURE__ */ jsx(Analytics, {})
+		/* @__PURE__ */ jsx(Analytics, {}),
+		/* @__PURE__ */ jsx(OpenPanel, {})
 	] });
 };
 //#endregion
@@ -1496,5 +1854,5 @@ function Sidebar() {
 //#endregion
 export { AppLoader as t };
 
-//# sourceMappingURL=sidebar-DPz78uG1.js.map
-//# debugId=5b1d7a07-2b7c-56f8-8b06-e3bea15efbff
+//# sourceMappingURL=sidebar-1Vu1bx0C.js.map
+//# debugId=5a417e42-ad53-5ab7-a264-5f81414a1e25