@burdenoff/fe-libs 2026.1003.4 → 2026.1004.2

package/dist/shared/tours/TourPlayerProvider.js

@@ -5,64 +5,65 @@ import { createContext as r, use as i, useEffect as a } from "react";
 import { Fragment as o, jsx as s, jsxs as c } from "react/jsx-runtime";
 //#region src/shared/tours/TourPlayerProvider.tsx
 var l = r(null);
-function u({ children: r, onTourStart: i, onTourComplete: a, onTourSkip: u, onStepChange: f, onStepComplete: p, zIndex: m = 9998 }) {
-	let h = e({
-		onTourStart: i,
-		onTourComplete: a,
-		onTourSkip: u,
-		onStepChange: f,
-		onStepComplete: p
-	}), g = {
-		isPlaying: h.isPlaying,
-		currentTour: h.currentTour,
-		currentStepIndex: h.currentStepIndex,
-		isPaused: h.isPaused,
-		isCompleted: h.isCompleted,
-		isSkipped: h.isSkipped,
-		currentStep: h.currentStep,
-		totalSteps: h.totalSteps,
-		progress: h.progress,
-		canGoNext: h.canGoNext,
-		canGoPrevious: h.canGoPrevious,
-		startTour: h.startTour,
-		stopTour: h.stopTour,
-		nextStep: h.nextStep,
-		previousStep: h.previousStep,
-		goToStep: h.goToStep,
-		pauseTour: h.pauseTour,
-		resumeTour: h.resumeTour,
-		skipTour: h.skipTour,
-		completeTour: h.completeTour
+function u({ children: r, scopeKey: i, onTourStart: a, onTourComplete: u, onTourSkip: f, onStepChange: p, onStepComplete: m, zIndex: h = 9998 }) {
+	let g = e({
+		scopeKey: i,
+		onTourStart: a,
+		onTourComplete: u,
+		onTourSkip: f,
+		onStepChange: p,
+		onStepComplete: m
+	}), _ = {
+		isPlaying: g.isPlaying,
+		currentTour: g.currentTour,
+		currentStepIndex: g.currentStepIndex,
+		isPaused: g.isPaused,
+		isCompleted: g.isCompleted,
+		isSkipped: g.isSkipped,
+		currentStep: g.currentStep,
+		totalSteps: g.totalSteps,
+		progress: g.progress,
+		canGoNext: g.canGoNext,
+		canGoPrevious: g.canGoPrevious,
+		startTour: g.startTour,
+		stopTour: g.stopTour,
+		nextStep: g.nextStep,
+		previousStep: g.previousStep,
+		goToStep: g.goToStep,
+		pauseTour: g.pauseTour,
+		resumeTour: g.resumeTour,
+		skipTour: g.skipTour,
+		completeTour: g.completeTour
 	};
 	return /* @__PURE__ */ c(l.Provider, {
-		value: g,
-		children: [r, h.isPlaying && !h.isPaused && h.currentStep && /* @__PURE__ */ c(o, { children: [
+		value: _,
+		children: [r, g.isPlaying && !g.isPaused && g.currentStep && /* @__PURE__ */ c(o, { children: [
 			/* @__PURE__ */ s(t, {
-				targetRect: h.targetRect,
-				zIndex: m
+				targetRect: g.targetRect,
+				zIndex: h
 			}),
 			/* @__PURE__ */ s(n, {
-				step: h.currentStep,
-				stepIndex: h.currentStepIndex,
-				totalSteps: h.totalSteps,
-				onNext: h.nextStep,
-				onPrevious: h.previousStep,
-				onSkip: h.skipTour,
-				onComplete: h.completeTour,
-				canGoNext: h.canGoNext,
-				canGoPrevious: h.canGoPrevious,
-				isLastStep: h.isLastStep,
-				placement: h.currentStep.placement,
-				targetRect: h.targetRect
+				step: g.currentStep,
+				stepIndex: g.currentStepIndex,
+				totalSteps: g.totalSteps,
+				onNext: g.nextStep,
+				onPrevious: g.previousStep,
+				onSkip: g.skipTour,
+				onComplete: g.completeTour,
+				canGoNext: g.canGoNext,
+				canGoPrevious: g.canGoPrevious,
+				isLastStep: g.isLastStep,
+				placement: g.currentStep.placement,
+				targetRect: g.targetRect
 			}),
 			/* @__PURE__ */ s(d, {
-				onNext: h.nextStep,
-				onPrevious: h.previousStep,
-				onSkip: h.skipTour,
-				onComplete: h.completeTour,
-				canGoNext: h.canGoNext,
-				canGoPrevious: h.canGoPrevious,
-				isLastStep: h.isLastStep
+				onNext: g.nextStep,
+				onPrevious: g.previousStep,
+				onSkip: g.skipTour,
+				onComplete: g.completeTour,
+				canGoNext: g.canGoNext,
+				canGoPrevious: g.canGoPrevious,
+				isLastStep: g.isLastStep
 			})
 		] })]
 	});

package/dist/shared/tours/TourTrigger.js

@@ -47,7 +47,7 @@ function O({ actions: e }) {
 function k({ pathname: i, navigateTo: a, actions: o }) {
 	let [v, y] = h(!1), [b, T] = h(!1), [D, O] = h(null), k = m(null), A = m(null);
 	t("header-help", v, d(() => y(!1), []));
-	let { pageTours: j, productId: M, moduleId: N, pageId: P, loading: F } = s(), I = n(), L = !!a, R = e()?.pageAccessDenied ?? !1;
+	let { pageTours: j, productId: M, moduleId: N, pageId: P, loading: F, error: I, refetch: L } = s(), R = n(), z = !!a, B = e()?.pageAccessDenied ?? !1;
 	f(() => {
 		let e = () => {
 			T(window.innerWidth < 768);
@@ -66,23 +66,23 @@ function k({ pathname: i, navigateTo: a, actions: o }) {
 		};
 		return v && document.addEventListener("keydown", e), () => document.removeEventListener("keydown", e);
 	}, [v]);
-	let z = (e) => {
+	let V = (e) => {
 		y(!1);
 		let t = E(e, i, {
 			productId: M ?? "",
 			moduleId: N,
 			pageId: P
-		}, L);
+		}, z);
 		if (t.type === "navigate") {
 			O(e.id), a?.(t.targetPath);
 			return;
 		}
 		t.type !== "ignore" && window.setTimeout(() => {
-			I(e);
+			R(e);
 		}, S);
-	}, B = (e) => {
+	}, H = (e) => {
 		y(!1), e.onClick?.();
-	}, V = p(() => ({
+	}, U = p(() => ({
 		productId: M ?? "",
 		moduleId: N,
 		pageId: P
@@ -90,40 +90,40 @@ function k({ pathname: i, navigateTo: a, actions: o }) {
 		N,
 		P,
 		M
-	]), H = p(() => j.filter((e) => w(e, M)).sort((e, t) => {
-		let n = r(e, V) - r(t, V);
+	]), W = p(() => j.filter((e) => w(e, M)).sort((e, t) => {
+		let n = r(e, U) - r(t, U);
 		if (n !== 0) return n;
 		let i = (t.priority ?? 0) - (e.priority ?? 0);
 		return i === 0 ? (e.displayOrder ?? 0) - (t.displayOrder ?? 0) : i;
 	}), [
-		V,
+		U,
 		M,
 		j
 	]);
 	f(() => {
 		if (!D) return;
-		let e = H.find((e) => e.id === D);
+		let e = W.find((e) => e.id === D);
 		if (!e) {
 			O(null);
 			return;
 		}
-		let t = E(e, i, V, L);
+		let t = E(e, i, U, z);
 		if (t.type === "navigate") return;
 		if (t.type === "ignore") {
 			O(null);
 			return;
 		}
 		let n = window.setTimeout(() => {
-			I(e), O(null);
+			R(e), O(null);
 		}, C);
 		return () => window.clearTimeout(n);
 	}, [
-		H,
-		L,
-		V,
+		W,
+		z,
+		U,
 		i,
 		D,
-		I
+		R
 	]), f(() => {
 		if (!D) return;
 		let e = window.setTimeout(() => {
@@ -131,34 +131,38 @@ function k({ pathname: i, navigateTo: a, actions: o }) {
 		}, x);
 		return () => window.clearTimeout(e);
 	}, [D]);
-	let U = H.length > 0, W = R;
+	let G = W.length > 0, K = B;
 	return f(() => {
-		W && v && y(!1);
-	}, [W, v]), W ? null : /* @__PURE__ */ _("div", {
+		K && v && y(!1);
+	}, [K, v]), K ? null : /* @__PURE__ */ _("div", {
 		className: "relative",
 		children: [
 			/* @__PURE__ */ g(c, {
 				ref: k,
 				isOpen: v,
-				hasTours: U,
+				hasTours: G,
 				onClick: () => y(!v)
 			}),
 			v && b && /* @__PURE__ */ g(l, {
 				ref: A,
 				loading: F,
-				tours: H,
+				error: I,
+				onRetry: L,
+				tours: W,
 				onClose: () => y(!1),
-				onStartTour: z,
+				onStartTour: V,
 				actions: o,
-				onAction: B
+				onAction: H
 			}),
 			v && !b && /* @__PURE__ */ g(u, {
 				ref: A,
 				loading: F,
-				tours: H,
-				onStartTour: z,
+				error: I,
+				onRetry: L,
+				tours: W,
+				onStartTour: V,
 				actions: o,
-				onAction: B
+				onAction: H
 			})
 		]
 	});

package/dist/shared/tours/ToursContext.d.ts

@@ -2,6 +2,7 @@ import { ReactNode } from 'react';
 import { Tour } from './types';
 import { TrackEventType, TrackEventOptions } from './toursContext/useTourMutations';
 export interface ToursContextValue {
+    progressScopeKey?: string;
     tours: Tour[];
     pageTours: Tour[];
     loading: boolean;
@@ -23,8 +24,10 @@ export interface ToursProviderProps {
     getPageIdFromPath?: (pathname: string) => string | undefined;
     /** Disable automatic tour bootstrap for the current route tree */
     disabled?: boolean;
+    /** Wait for workspace selection before loading workspace-scoped progress. */
+    requireWorkspace?: boolean;
 }
-export declare function ToursProvider({ children, defaultPageId, getPageIdFromPath, disabled, }: ToursProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ToursProvider({ children, defaultPageId, getPageIdFromPath, disabled, requireWorkspace, }: ToursProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useToursContext(): ToursContextValue;
 export declare function useSafeToursContext(): ToursContextValue;
 export declare function useTours(): {

package/dist/shared/tours/ToursContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToursContext.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/ToursContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAOf,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAOpC,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,EAAE,IAAI,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,EAAE,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,EAC3C,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,UAAU,EAAE,CACV,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,iBAAiB,KACxB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC7D,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,aAAsB,EACtB,iBAAiB,EACjB,QAAgB,GACjB,EAAE,kBAAkB,2CAuTpB;AAED,wBAAgB,eAAe,IAAI,iBAAiB,CAMnD;AAED,wBAAgB,mBAAmB,IAAI,iBAAiB,CAmBvD;AAED,wBAAgB,QAAQ;;;;mBAzXP,IAAI;4BAET,MAAM,UACN,SAAS,GAAG,WAAW,GAAG,SAAS,WAClC,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC;EA6XnB;AAED,wBAAgB,gBAAgB,IAAI,IAAI,GAAG,IAAI,CAG9C"}
+{"version":3,"file":"ToursContext.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/ToursContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EASL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AASf,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAOpC,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,EAAE,IAAI,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,EAAE,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,EAC3C,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,UAAU,EAAE,CACV,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,iBAAiB,KACxB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC7D,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,aAAsB,EACtB,iBAAiB,EACjB,QAAgB,EAChB,gBAAwB,GACzB,EAAE,kBAAkB,2CAsVpB;AAED,wBAAgB,eAAe,IAAI,iBAAiB,CAMnD;AAED,wBAAgB,mBAAmB,IAAI,iBAAiB,CAmBvD;AAED,wBAAgB,QAAQ;;;;mBA3ZP,IAAI;4BAET,MAAM,UACN,SAAS,GAAG,WAAW,GAAG,SAAS,WAClC,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC;EA+ZnB;AAED,wBAAgB,gBAAgB,IAAI,IAAI,GAAG,IAAI,CAG9C"}

package/dist/shared/tours/ToursContext.js

@@ -3,34 +3,36 @@ import "../../shared-graphql.js";
 import { useAppShell as t } from "../providers/shell/AppShellContext.js";
 import { useAuth as n } from "../providers/shell/AuthProvider.js";
 import { useActiveContext as r } from "../providers/shell/ActiveContextProvider.js";
-import { useLogger as i } from "../logger/useLogger.js";
+import { useSafePermissions as i } from "../providers/shell/PermissionProvider.js";
+import { useLogger as a } from "../logger/useLogger.js";
 import "../../shared-logger.js";
-import { isTourVisibleForContext as a } from "./routeCatalog.js";
-import { GET_TOURS_FOR_CONTEXT as o, GET_TOURS_FOR_CONTEXT_WITHOUT_PROGRESS as s } from "./toursContext/gql.js";
-import { isMyProgressFieldMissingError as c, isTeardownInvariant as l } from "./toursContext/errors.js";
-import { normalizeDeviceType as u } from "./toursContext/session.js";
-import { deriveRouteContext as d } from "./toursContext/route.js";
-import { useIdleReady as ee } from "./toursContext/useIdleReady.js";
-import { useTourMutations as te } from "./toursContext/useTourMutations.js";
-import { createContext as f, use as p, useCallback as m, useEffect as h, useMemo as g, useRef as _, useState as v } from "react";
-import { jsx as ne } from "react/jsx-runtime";
-import { useLocation as y } from "react-router";
+import { isTourAllowedByPermissions as o } from "./permissions.js";
+import { isTourVisibleForContext as s } from "./routeCatalog.js";
+import { GET_TOURS_FOR_CONTEXT as c, GET_TOURS_FOR_CONTEXT_WITHOUT_PROGRESS as l } from "./toursContext/gql.js";
+import { isMyProgressFieldMissingError as u, isTeardownInvariant as d } from "./toursContext/errors.js";
+import { normalizeDeviceType as ee } from "./toursContext/session.js";
+import { deriveRouteContext as te } from "./toursContext/route.js";
+import { useIdleReady as ne } from "./toursContext/useIdleReady.js";
+import { useTourMutations as re } from "./toursContext/useTourMutations.js";
+import { createContext as f, use as p, useCallback as m, useEffect as h, useLayoutEffect as ie, useMemo as g, useRef as _, useState as v } from "react";
+import { jsx as ae } from "react/jsx-runtime";
+import { useLocation as oe } from "react-router";
 //#region src/shared/tours/ToursContext.tsx
-var b = f(null);
-function x({ children: f, defaultPageId: p = "home", getPageIdFromPath: x, disabled: S = !1 }) {
-	let C = y(), w = e("global"), { workspaceId: T } = r(), { user: E } = n(), { productSlug: D } = t(), O = i("ToursContext"), k = T ?? void 0, A = S || C.pathname.startsWith("/devportal"), { moduleId: j, pageId: M } = g(() => d(C.pathname, D, p, x), [
+var y = f(null);
+function b({ children: f, defaultPageId: p = "home", getPageIdFromPath: b, disabled: x = !1, requireWorkspace: S = !1 }) {
+	let C = oe(), w = e("global"), { workspaceId: se } = r(), { user: T } = n(), E = i(), { productSlug: D } = t(), O = a("ToursContext"), k = se ?? void 0, A = x || S && !k || C.pathname.startsWith("/devportal"), { moduleId: j, pageId: M } = g(() => te(C.pathname, D, p, b), [
 		p,
-		x,
+		b,
 		C.pathname,
 		D
-	]), [N, P] = v([]), [F, I] = v(!1), [L, R] = v(null), z = ee(), B = _([]), re = _(0), ie = _(/* @__PURE__ */ new Map()), V = _(void 0), H = _(!1), U = _(!0), W = _(0), G = _(!0);
-	h(() => (U.current = !0, () => {
-		U.current = !1;
+	]), [N, P] = v([]), [F, I] = v(!1), [L, R] = v(null), z = ne(), B = _([]), ce = _(0), V = _(/* @__PURE__ */ new Map()), H = _(void 0), U = _(!1), W = _(!0), G = _(0), K = _(!0);
+	h(() => (W.current = !0, () => {
+		W.current = !1;
 	}), []);
-	let K = m(async (e = !1) => {
+	let q = m(async (e = !1) => {
 		if (!z && !e) return;
 		if (A) {
-			U.current && (P([]), I(!1), R(null));
+			W.current && (P([]), I(!1), R(null));
 			return;
 		}
 		if (!w) return;
@@ -39,17 +41,17 @@ function x({ children: f, defaultPageId: p = "home", getPageIdFromPath: x, disab
 			workspaceId: k,
 			moduleId: j,
 			pageId: M
-		}), n = u(), r = [
+		}), n = ee(), r = [
 			D,
 			j ?? "",
 			M ?? "",
 			k,
 			n,
-			E?.id ?? "anonymous"
+			T?.id ?? "anonymous"
 		].join("::");
-		if (!e && H.current && V.current === r) return;
-		U.current && (I(!0), R(null));
-		let i = ++W.current;
+		if (!e && U.current && H.current === r) return;
+		W.current && (I(!0), R(null));
+		let i = ++G.current;
 		try {
 			let e = { context: {
 				productId: D,
@@ -57,38 +59,53 @@ function x({ children: f, defaultPageId: p = "home", getPageIdFromPath: x, disab
 				pageId: M,
 				workspaceId: k,
 				deviceType: n
-			} }, a = "network-only", l, u = G.current ? o : s;
+			} }, a = "network-only", o, s = K.current ? c : l;
 			try {
-				l = await w.query({
-					query: u,
+				o = await w.query({
+					query: s,
 					variables: e,
 					fetchPolicy: a,
-					errorPolicy: "none"
+					errorPolicy: "none",
+					context: {
+						queryDeduplication: !1,
+						requiredWorkspaceAuth: !!k,
+						requiredWorkspaceId: k
+					}
 				});
-				let n = l.errors;
-				u === o && n?.some((e) => c(e)) && (G.current = !1, t.warn("[ToursContext] Gateway returned a Tour.myProgress validation error — falling back to query without progress chips until the backend field is published."), l = await w.query({
-					query: s,
+				let n = o.errors;
+				s === c && n?.some((e) => u(e)) && (K.current = !1, t.warn("[ToursContext] Gateway returned a Tour.myProgress validation error — falling back to query without progress chips until the backend field is published."), o = await w.query({
+					query: l,
 					variables: e,
 					fetchPolicy: a,
-					errorPolicy: "none"
+					errorPolicy: "none",
+					context: {
+						queryDeduplication: !1,
+						requiredWorkspaceAuth: !!k,
+						requiredWorkspaceId: k
+					}
 				}));
 			} catch (n) {
-				if (u === o && c(n)) G.current = !1, t.warn("[ToursContext] Gateway does not expose Tour.myProgress yet — falling back to query without progress chips until the backend field is published."), l = await w.query({
-					query: s,
+				if (s === c && u(n)) K.current = !1, t.warn("[ToursContext] Gateway does not expose Tour.myProgress yet — falling back to query without progress chips until the backend field is published."), o = await w.query({
+					query: l,
 					variables: e,
 					fetchPolicy: a,
-					errorPolicy: "none"
+					errorPolicy: "none",
+					context: {
+						queryDeduplication: !1,
+						requiredWorkspaceAuth: !!k,
+						requiredWorkspaceId: k
+					}
 				});
 				else throw n;
 			}
-			let d = (l.data?.toursForContext ?? []).filter((e, t, n) => n.findIndex((t) => t.id === e.id) === t);
-			U.current && i === W.current && (P(d), V.current = r, H.current = !0);
+			let d = (o.data?.toursForContext ?? []).filter((e, t, n) => n.findIndex((t) => t.id === e.id) === t);
+			W.current && i === G.current && (P(d), H.current = r, U.current = !0);
 		} catch (e) {
-			if (!U.current || i !== W.current || l(e)) return;
+			if (!W.current || i !== G.current || d(e)) return;
 			let n = e instanceof Error ? e : /* @__PURE__ */ Error("Failed to fetch tours");
 			t.error("Failed to fetch tours for context", n), R(n), P([]);
 		} finally {
-			U.current && i === W.current && I(!1);
+			W.current && i === G.current && I(!1);
 		}
 	}, [
 		z,
@@ -99,76 +116,79 @@ function x({ children: f, defaultPageId: p = "home", getPageIdFromPath: x, disab
 		M,
 		D,
 		k,
-		E?.id
-	]), q = _(E?.id);
-	h(() => {
-		q.current !== E?.id && (q.current = E?.id, H.current = !1, V.current = void 0, U.current && P([]));
-	}, [E?.id]), h(() => {
-		K();
-	}, [K]), h(() => {
+		T?.id
+	]), J = `${T?.id ?? ""}:${k ?? ""}`, [le, ue] = v(J);
+	le !== J && (ue(J), P([]), I(!0), R(null)), ie(() => (B.current = [], U.current = !1, H.current = void 0, G.current += 1, V.current.clear(), () => {
+		G.current += 1;
+	}), [J]), h(() => {
+		q();
+	}, [q]), h(() => {
 		B.current = N;
 	}, [N]);
-	let J = m(() => {
-		K(!0);
-	}, [K]), Y = g(() => N.filter((e) => e.isActive && e.steps?.length > 0 && a(e, {
+	let Y = m(() => {
+		q(!0);
+	}, [q]), X = g(() => N.filter((e) => o(e, E)), [N, E]), Z = g(() => X.filter((e) => e.isActive && e.steps?.length > 0 && s(e, {
 		productId: D,
 		moduleId: j,
 		pageId: M
 	})).sort((e, t) => (t.priority ?? 0) - (e.priority ?? 0)), [
-		N,
+		X,
 		j,
 		M,
 		D
-	]), X = g(() => z ? Y.find((e) => e.triggerType === "AUTO_FIRST_VISIT" || e.triggerType === "AUTO_ALWAYS") ?? null : null, [Y, z]), { trackProgress: Z, recordStepCompletion: Q, trackEvent: $ } = te({
+	]), Q = g(() => z ? Z.find((e) => e.triggerType === "AUTO_FIRST_VISIT" || e.triggerType === "AUTO_ALWAYS") ?? null : null, [Z, z]), { trackProgress: $, recordStepCompletion: de, trackEvent: fe } = re({
 		globalClient: w,
-		userId: E?.id,
+		userId: T?.id,
 		productSlug: D,
 		moduleId: j,
 		pageId: M,
 		workspaceId: k,
 		setAllTours: P,
 		allToursRef: B,
-		progressMutationVersionRef: re,
-		latestProgressMutationByTourRef: ie
-	}), ae = g(() => ({
-		tours: N,
-		pageTours: Y,
+		progressMutationVersionRef: ce,
+		latestProgressMutationByTourRef: V
+	}), pe = g(() => ({
+		progressScopeKey: `${T?.id ?? ""}:${k ?? ""}`,
+		tours: X,
+		pageTours: Z,
 		loading: F,
 		error: L,
-		refetch: J,
-		trackProgress: Z,
-		recordStepCompletion: Q,
-		trackEvent: $,
-		autoStartTour: X,
+		refetch: Y,
+		trackProgress: $,
+		recordStepCompletion: de,
+		trackEvent: fe,
+		autoStartTour: Q,
 		productId: D,
 		moduleId: j,
 		pageId: M
 	}), [
-		N,
 		X,
+		T?.id,
+		k,
+		Q,
 		L,
 		F,
 		j,
 		M,
-		Y,
+		Z,
 		D,
-		Q,
-		J,
-		$,
-		Z
+		de,
+		Y,
+		fe,
+		$
 	]);
-	return /* @__PURE__ */ ne(b.Provider, {
-		value: ae,
+	return /* @__PURE__ */ ae(y.Provider, {
+		value: pe,
 		children: f
 	});
 }
-function S() {
-	let e = p(b);
+function x() {
+	let e = p(y);
 	if (!e) throw Error("useToursContext must be used within a ToursProvider");
 	return e;
 }
-function C() {
-	return p(b) || {
+function S() {
+	return p(y) || {
 		tours: [],
 		pageTours: [],
 		loading: !1,
@@ -183,8 +203,8 @@ function C() {
 		pageId: void 0
 	};
 }
-function w() {
-	let e = S();
+function C() {
+	let e = x();
 	return {
 		tours: e.pageTours,
 		loading: e.loading,
@@ -193,8 +213,8 @@ function w() {
 		trackProgress: e.trackProgress
 	};
 }
-function T() {
-	return S().autoStartTour;
+function w() {
+	return x().autoStartTour;
 }
 //#endregion
-export { x as ToursProvider, T as useAutoStartTour, C as useSafeToursContext, w as useTours, S as useToursContext };
+export { b as ToursProvider, w as useAutoStartTour, S as useSafeToursContext, C as useTours, x as useToursContext };

package/dist/shared/tours/permissions.d.ts

@@ -0,0 +1,9 @@
+import { Tour } from './types';
+interface TourPermissions {
+    isLoading: boolean;
+    hasPermission: (permission: string) => boolean;
+}
+/** Tour targeting is guidance; the gateway still authorizes every product action. */
+export declare function isTourAllowedByPermissions(tour: Pick<Tour, 'triggerConfig'>, permissions: TourPermissions | null): boolean;
+export {};
+//# sourceMappingURL=permissions.d.ts.map

package/dist/shared/tours/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,UAAU,eAAe;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CAChD;AAED,qFAAqF;AACrF,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EACjC,WAAW,EAAE,eAAe,GAAG,IAAI,GAClC,OAAO,CAYT"}

package/dist/shared/tours/permissions.js

@@ -0,0 +1,7 @@
+//#region src/shared/tours/permissions.ts
+function e(e, t) {
+	let n = e.triggerConfig?.requiredPermissions;
+	return n === void 0 ? !0 : !Array.isArray(n) || n.some((e) => typeof e != "string" || !e.trim()) ? !1 : n.length === 0 ? !0 : !t || t.isLoading ? !1 : n.every((e) => t.hasPermission(e));
+}
+//#endregion
+export { e as isTourAllowedByPermissions };

package/dist/shared/tours/progress.d.ts

@@ -1,7 +1,12 @@
-import { TourUserStatus, TourUserProgressSummary } from './types';
+import { TourStep, TourUserStatus, TourUserProgressSummary } from './types';
 export interface TourProgressCarrier {
     id: string;
     myProgress?: TourUserProgressSummary | null;
 }
 export declare function withTourProgressStatus<T extends TourProgressCarrier>(tours: readonly T[], tourId: string, status: TourUserStatus): T[];
+/** Resume only an unfinished tour, using persisted step IDs that still exist. */
+export declare function tourResumeStepIndex(tour: {
+    steps: readonly Pick<TourStep, 'id'>[];
+    myProgress?: TourUserProgressSummary | null;
+}): number;
 //# sourceMappingURL=progress.d.ts.map

package/dist/shared/tours/progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC7C;AAED,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,mBAAmB,EAClE,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,CAAC,EAAE,CAYL"}
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEjF,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC7C;AAED,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,mBAAmB,EAClE,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,CAAC,EAAE,CAkBL;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;IACvC,UAAU,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC7C,GAAG,MAAM,CAQT"}

package/dist/shared/tours/progress.js

@@ -3,10 +3,20 @@ function e(e, t, n) {
 	return e.map((e) => e.id === t ? {
 		...e,
 		myProgress: {
+			...e.myProgress,
+			...n === "IN_PROGRESS" && e.myProgress?.status !== "IN_PROGRESS" ? {
+				completedSteps: [],
+				currentStepId: null
+			} : {},
 			id: e.myProgress?.id ?? `optimistic-${t}`,
 			status: n
 		}
 	} : e);
 }
+function t(e) {
+	if (e.myProgress?.status !== "IN_PROGRESS") return 0;
+	let t = e.myProgress.completedSteps, n = new Set(Array.isArray(t) ? t.filter((e) => typeof e == "string") : []), r = e.steps.findIndex((e) => !n.has(e.id));
+	return Math.max(0, r);
+}
 //#endregion
-export { e as withTourProgressStatus };
+export { t as tourResumeStepIndex, e as withTourProgressStatus };

package/dist/shared/tours/routeCatalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routeCatalog.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/routeCatalog.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnC;AA42BD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,MAAM,IAAI,CAkCZ;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,qBAAqB,EAAE,CAQzB;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,qBAAqB,EAAE,CAezB;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,mBAAmB,EAAE,CAWvB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,GACtB,MAAM,GAAG,SAAS,CAyBpB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAyBT;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAKR"}
+{"version":3,"file":"routeCatalog.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/routeCatalog.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnC;AAi6BD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,MAAM,IAAI,CAkCZ;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,qBAAqB,EAAE,CAQzB;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,qBAAqB,EAAE,CAezB;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,mBAAmB,EAAE,CAWvB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,GACtB,MAAM,GAAG,SAAS,CAyBpB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAyBT;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAKR"}