npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.3 → 1.1.5 - Mend

@wildo-ai/saas-frontend-lib 1.1.3 → 1.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2521) hide show

package/dist/esm/core/mode/AppModeContext.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AppModeContext.js","sourceRoot":"","sources":["../../../../src/core/mode/AppModeContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n AppModeContext — manages the active application mode.\n \n Modes represent UI activities (explorer, search, admin, etc.) that control\n * which sidebar sections are visible. The `ACTIVITY_BAR` component renders\n * available modes; this context manages the selection state.\n \n Mode resolution cascade on mount:\n * 1. localStorage (persisted from last session)\n * 2. validate persisted mode is still available\n * 3. `isDefault` mode\n * 4. first available mode\n * 5. null (no modes configured)\n \n Auto-persists `activeMode` in localStorage keyed by `appName`.\n \n @see component-taxonomy-deep-review.md §7.3, §7.5\n * @see app-shell-implementation-plan.md Step 6\n /\n\nimport React, { createContext, useContext, useMemo, useState, useCallback, useEffect } from 'react';\nimport type { ReactNode } from 'react';\nimport type { AppModeDefinition } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useResolvedAuthConfig } from '~wildo-frontend-lib/core/security/useResolvedAuthConfig';\n\n// ════════════════════════════════════════════════════════════════\n// Context Value\n// ════════════════════════════════════════════════════════════════\n\nexport interface AppModeContextValue {\n /* All declared app modes (before user type filtering). /\n allModes: AppModeDefinition[];\n /* Modes available to the current user (after `visibleToUserTypes` filtering). /\n availableModes: AppModeDefinition[];\n /* Currently active mode ref, or `null` if no mode system. /\n activeMode: string \| null;\n /* Switch to a different mode. No-op if ref is not in `availableModes`. /\n setActiveMode: (modeRef: string) => void;\n /* Whether the app has any available modes at all. /\n hasModes: boolean;\n}\n\nconst AppModeContext = createContext<AppModeContextValue \| undefined>(undefined);\n\n// ════════════════════════════════════════════════════════════════\n// localStorage Persistence\n// ════════════════════════════════════════════════════════════════\n\nconst STORAGE_KEY_PREFIX = 'wildo:appMode:';\n\nfunction buildStorageKey(appName: string \| undefined, userId: string \| undefined): string {\n return `${STORAGE_KEY_PREFIX}${appName ?? 'default'}:${userId ?? 'anon'}`;\n}\n\nfunction readPersistedMode(storageKey: string): string \| null {\n try {\n return localStorage.getItem(storageKey);\n } catch {\n return null;\n }\n}\n\nfunction persistMode(storageKey: string, modeRef: string): void {\n try {\n localStorage.setItem(storageKey, modeRef);\n } catch {\n // localStorage may be unavailable (SSR, incognito quota)\n }\n}\n\n// ════════════════════════════════════════════════════════════════\n// Mode Resolution\n// ════════════════════════════════════════════════════════════════\n\n/\n Resolve the initial active mode using the cascade:\n * localStorage → validate → isDefault → first → null\n /\nfunction resolveInitialMode(\n availableModes: AppModeDefinition[],\n storageKey: string,\n): string \| null {\n if (availableModes.length === 0) return null;\n\n const availableRefs = new Set(availableModes.map(m => m.ref));\n\n // 1. Try persisted mode\n const persisted = readPersistedMode(storageKey);\n if (persisted && availableRefs.has(persisted)) {\n return persisted;\n }\n\n // 2. Try isDefault mode\n const defaultMode = availableModes.find(m => m.isDefault);\n if (defaultMode) {\n return defaultMode.ref;\n }\n\n // 3. First available\n return availableModes[0].ref;\n}\n\n// ════════════════════════════════════════════════════════════════\n// Provider\n// ════════════════════════════════════════════════════════════════\n\ninterface AppModeProviderProps {\n children: ReactNode;\n}\n\nexport const AppModeProvider: React.FC<AppModeProviderProps> = ({ children }) => {\n const { frontendConfiguration, appConfig } = useApplication();\n const { resolvedUserType } = useResolvedAuthConfig();\n\n const allModes: AppModeDefinition[] = useMemo(\n () => frontendConfiguration?.appModes ?? [],\n [frontendConfiguration?.appModes],\n );\n\n const availableModes: AppModeDefinition[] = useMemo(() => {\n if (!resolvedUserType) return allModes;\n return allModes.filter(mode => {\n if (!mode.visibleToUserTypes \|\| mode.visibleToUserTypes.length === 0) return true;\n return mode.visibleToUserTypes.includes(resolvedUserType);\n });\n }, [allModes, resolvedUserType]);\n\n const storageKey = useMemo(\n () => buildStorageKey(\n appConfig?.appIdentity?.appName,\n undefined, // userId is not available at this provider level; keyed by appName only\n ),\n [appConfig?.appIdentity?.appName],\n );\n\n const [activeMode, setActiveModeInternal] = useState<string \| null>(() =>\n resolveInitialMode(availableModes, storageKey),\n );\n\n // Re-resolve when available modes change (e.g., user type resolved after async auth)\n useEffect(() => {\n if (availableModes.length === 0) {\n setActiveModeInternal(null);\n return;\n }\n const availableRefs = new Set(availableModes.map(m => m.ref));\n if (activeMode && availableRefs.has(activeMode)) return;\n const resolved = resolveInitialMode(availableModes, storageKey);\n setActiveModeInternal(resolved);\n }, [availableModes, storageKey]); // eslint-disable-line react-hooks/exhaustive-deps\n\n const setActiveMode = useCallback((modeRef: string) => {\n const isValid = availableModes.some(m => m.ref === modeRef);\n if (!isValid) return;\n setActiveModeInternal(modeRef);\n persistMode(storageKey, modeRef);\n }, [availableModes, storageKey]);\n\n const contextValue: AppModeContextValue = useMemo(() => ({\n allModes,\n availableModes,\n activeMode,\n setActiveMode,\n hasModes: availableModes.length > 0,\n }), [allModes, availableModes, activeMode, setActiveMode]);\n\n return (\n <AppModeContext.Provider value={contextValue}>\n {children}\n </AppModeContext.Provider>\n );\n};\n\n// ════════════════════════════════════════════════════════════════\n// Hooks\n// ════════════════════════════════════════════════════════════════\n\n/\n Access the app mode context. Throws if used outside `AppModeProvider`.\n /\nexport function useAppMode(): AppModeContextValue {\n const ctx = useContext(AppModeContext);\n if (!ctx) {\n throw new Error('useAppMode must be used within an AppModeProvider');\n }\n return ctx;\n}\n\n/\n Access the app mode context without throwing if the provider is missing.\n * Returns `null` when used outside `AppModeProvider`.\n */\nexport function useAppModeSafe(): AppModeContextValue \| null {\n return useContext(AppModeContext) ?? null;\n}\n"]}
1	+ {"version":3,"file":"AppModeContext.js","sourceRoot":"","sources":["../../../../../src/core/mode/AppModeContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n AppModeContext — manages the active application mode.\n \n Modes represent UI activities (explorer, search, admin, etc.) that control\n * which sidebar sections are visible. The `ACTIVITY_BAR` component renders\n * available modes; this context manages the selection state.\n \n Mode resolution cascade on mount:\n * 1. localStorage (persisted from last session)\n * 2. validate persisted mode is still available\n * 3. `isDefault` mode\n * 4. first available mode\n * 5. null (no modes configured)\n \n Auto-persists `activeMode` in localStorage keyed by `appName`.\n \n @see component-taxonomy-deep-review.md §7.3, §7.5\n * @see app-shell-implementation-plan.md Step 6\n /\n\nimport React, { createContext, useContext, useMemo, useState, useCallback, useEffect } from 'react';\nimport type { ReactNode } from 'react';\nimport type { AppModeDefinition } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useResolvedAuthConfig } from '~wildo-frontend-lib/core/security/useResolvedAuthConfig';\n\n// ════════════════════════════════════════════════════════════════\n// Context Value\n// ════════════════════════════════════════════════════════════════\n\nexport interface AppModeContextValue {\n /* All declared app modes (before user type filtering). /\n allModes: AppModeDefinition[];\n /* Modes available to the current user (after `visibleToUserTypes` filtering). /\n availableModes: AppModeDefinition[];\n /* Currently active mode ref, or `null` if no mode system. /\n activeMode: string \| null;\n /* Switch to a different mode. No-op if ref is not in `availableModes`. /\n setActiveMode: (modeRef: string) => void;\n /* Whether the app has any available modes at all. /\n hasModes: boolean;\n}\n\nconst AppModeContext = createContext<AppModeContextValue \| undefined>(undefined);\n\n// ════════════════════════════════════════════════════════════════\n// localStorage Persistence\n// ════════════════════════════════════════════════════════════════\n\nconst STORAGE_KEY_PREFIX = 'wildo:appMode:';\n\nfunction buildStorageKey(appName: string \| undefined, userId: string \| undefined): string {\n return `${STORAGE_KEY_PREFIX}${appName ?? 'default'}:${userId ?? 'anon'}`;\n}\n\nfunction readPersistedMode(storageKey: string): string \| null {\n try {\n return localStorage.getItem(storageKey);\n } catch {\n return null;\n }\n}\n\nfunction persistMode(storageKey: string, modeRef: string): void {\n try {\n localStorage.setItem(storageKey, modeRef);\n } catch {\n // localStorage may be unavailable (SSR, incognito quota)\n }\n}\n\n// ════════════════════════════════════════════════════════════════\n// Mode Resolution\n// ════════════════════════════════════════════════════════════════\n\n/\n Resolve the initial active mode using the cascade:\n * localStorage → validate → isDefault → first → null\n /\nfunction resolveInitialMode(\n availableModes: AppModeDefinition[],\n storageKey: string,\n): string \| null {\n if (availableModes.length === 0) return null;\n\n const availableRefs = new Set(availableModes.map(m => m.ref));\n\n // 1. Try persisted mode\n const persisted = readPersistedMode(storageKey);\n if (persisted && availableRefs.has(persisted)) {\n return persisted;\n }\n\n // 2. Try isDefault mode\n const defaultMode = availableModes.find(m => m.isDefault);\n if (defaultMode) {\n return defaultMode.ref;\n }\n\n // 3. First available\n return availableModes[0].ref;\n}\n\n// ════════════════════════════════════════════════════════════════\n// Provider\n// ════════════════════════════════════════════════════════════════\n\ninterface AppModeProviderProps {\n children: ReactNode;\n}\n\nexport const AppModeProvider: React.FC<AppModeProviderProps> = ({ children }) => {\n const { frontendConfiguration, appConfig } = useApplication();\n const { resolvedUserType } = useResolvedAuthConfig();\n\n const allModes: AppModeDefinition[] = useMemo(\n () => frontendConfiguration?.appModes ?? [],\n [frontendConfiguration?.appModes],\n );\n\n const availableModes: AppModeDefinition[] = useMemo(() => {\n if (!resolvedUserType) return allModes;\n return allModes.filter(mode => {\n if (!mode.visibleToUserTypes \|\| mode.visibleToUserTypes.length === 0) return true;\n return mode.visibleToUserTypes.includes(resolvedUserType);\n });\n }, [allModes, resolvedUserType]);\n\n const storageKey = useMemo(\n () => buildStorageKey(\n appConfig?.appIdentity?.appName,\n undefined, // userId is not available at this provider level; keyed by appName only\n ),\n [appConfig?.appIdentity?.appName],\n );\n\n const [activeMode, setActiveModeInternal] = useState<string \| null>(() =>\n resolveInitialMode(availableModes, storageKey),\n );\n\n // Re-resolve when available modes change (e.g., user type resolved after async auth)\n useEffect(() => {\n if (availableModes.length === 0) {\n setActiveModeInternal(null);\n return;\n }\n const availableRefs = new Set(availableModes.map(m => m.ref));\n if (activeMode && availableRefs.has(activeMode)) return;\n const resolved = resolveInitialMode(availableModes, storageKey);\n setActiveModeInternal(resolved);\n }, [availableModes, storageKey]); // eslint-disable-line react-hooks/exhaustive-deps\n\n const setActiveMode = useCallback((modeRef: string) => {\n const isValid = availableModes.some(m => m.ref === modeRef);\n if (!isValid) return;\n setActiveModeInternal(modeRef);\n persistMode(storageKey, modeRef);\n }, [availableModes, storageKey]);\n\n const contextValue: AppModeContextValue = useMemo(() => ({\n allModes,\n availableModes,\n activeMode,\n setActiveMode,\n hasModes: availableModes.length > 0,\n }), [allModes, availableModes, activeMode, setActiveMode]);\n\n return (\n <AppModeContext.Provider value={contextValue}>\n {children}\n </AppModeContext.Provider>\n );\n};\n\n// ════════════════════════════════════════════════════════════════\n// Hooks\n// ════════════════════════════════════════════════════════════════\n\n/\n Access the app mode context. Throws if used outside `AppModeProvider`.\n /\nexport function useAppMode(): AppModeContextValue {\n const ctx = useContext(AppModeContext);\n if (!ctx) {\n throw new Error('useAppMode must be used within an AppModeProvider');\n }\n return ctx;\n}\n\n/\n Access the app mode context without throwing if the provider is missing.\n * Returns `null` when used outside `AppModeProvider`.\n */\nexport function useAppModeSafe(): AppModeContextValue \| null {\n return useContext(AppModeContext) ?? null;\n}\n"]}

package/dist/esm/core/mode/section-visibility.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"section-visibility.d.ts","sourceRoot":"","sources":["~~../../../../~~src/core/mode/section-visibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,iEAAiE,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uDAAuD,CAAC;AAO3F;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,oBAAoB,EAAE,oBAAoB,GACzC,OAAO,CAmBT;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EAAE,EAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,oBAAoB,EAAE,oBAAoB,EAC1C,aAAa,GAAE,OAAe,GAC7B,cAAc,EAAE,CAwBlB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAC7C,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,cAAc,EAAE,iBAAiB,EAAE,GAClC,oBAAoB,CAMtB;AAgBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EAAE,EAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,oBAAoB,EAAE,oBAAoB,GACzC,IAAI,CAwCN"}
1	+ {"version":3,"file":"section-visibility.d.ts","sourceRoot":"","sources":["../../../../../src/core/mode/section-visibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,iEAAiE,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uDAAuD,CAAC;AAO3F;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,oBAAoB,EAAE,oBAAoB,GACzC,OAAO,CAmBT;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EAAE,EAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,oBAAoB,EAAE,oBAAoB,EAC1C,aAAa,GAAE,OAAe,GAC7B,cAAc,EAAE,CAwBlB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAC7C,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,cAAc,EAAE,iBAAiB,EAAE,GAClC,oBAAoB,CAMtB;AAgBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EAAE,EAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,oBAAoB,EAAE,oBAAoB,GACzC,IAAI,CAwCN"}

package/dist/esm/core/mode/section-visibility.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"section-visibility.js","sourceRoot":"","sources":["~~../../../../~~src/core/mode/section-visibility.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Section Visibility Logic\n \n Pure functions for evaluating whether a sidebar section should be visible\n * based on the current mode and scope state. Also provides a DEV-mode\n * visibility debugger that logs a console table showing each section's\n * filter results.\n \n @see component-taxonomy-deep-review.md §7.6\n * @see app-shell-implementation-plan.md Steps 6, 8\n /\n\nimport type {\n SidebarSection,\n ScopeConditionParams,\n AppModeDefinition,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport type { AppScopeValue } from '~wildo-frontend-lib/core/scope/scope.frontend.schemas';\nimport { SidebarSectionContentKind } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\n\n// ════════════════════════════════════════════════════════════════\n// Section Visibility Evaluation\n// ════════════════════════════════════════════════════════════════\n\n/\n Determines whether a sidebar section should be visible given the\n * current mode and scope state.\n \n Evaluation order:\n * 1. `visibleInModes` — if set, section is only visible when\n * `activeMode` is in the list. If the list is empty or absent,\n * the section is visible in all modes.\n * 2. `scopeCondition` — if set, the predicate is called with\n * the current scope parameters. Must return `true` for the\n * section to be visible.\n * 3. Both must pass for the section to be visible.\n /\nexport function isSectionVisible(\n section: SidebarSection,\n activeMode: string \| null,\n scopeConditionParams: ScopeConditionParams,\n): boolean {\n // Mode filter\n if (section.visibleInModes && section.visibleInModes.length > 0) {\n if (!activeMode \|\| !section.visibleInModes.includes(activeMode)) {\n return false;\n }\n }\n\n // Scope condition\n if (section.scopeCondition) {\n try {\n return section.scopeCondition(scopeConditionParams);\n } catch {\n // Defensive: malformed scopeCondition should not crash the sidebar\n return false;\n }\n }\n\n return true;\n}\n\n/\n Filters a list of sidebar sections to only those visible in the\n * current mode and scope state.\n \n Also includes a DEV-mode warning if all sections are hidden and\n * no `GUIDANCE_WIDGET` covers the empty state.\n /\nexport function filterVisibleSections(\n sections: SidebarSection[],\n activeMode: string \| null,\n scopeConditionParams: ScopeConditionParams,\n isDevelopment: boolean = false,\n): SidebarSection[] {\n const visible = sections.filter(s =>\n isSectionVisible(s, activeMode, scopeConditionParams),\n );\n\n if (isDevelopment && visible.length === 0 && sections.length > 0) {\n // Only suppress the warning if a GUIDANCE_WIDGET exists that could actually\n // render — i.e., one without mode restrictions (always visible regardless of\n // which mode hides the other sections).\n const hasUnconditionalGuidance = sections.some(\n s => s.contentKind === SidebarSectionContentKind.GUIDANCE_WIDGET &&\n (!s.visibleInModes \|\| s.visibleInModes.length === 0),\n );\n if (!hasUnconditionalGuidance) {\n console.warn(\n '[AppMode] All sidebar sections are hidden and no unconditionally-visible ' +\n 'GUIDANCE_WIDGET section covers the empty state. Consider adding a ' +\n 'GUIDANCE_WIDGET section without visibleInModes restrictions and a ' +\n 'scopeCondition that activates when other sections are hidden.',\n );\n }\n }\n\n return visible;\n}\n\n/\n Builds `ScopeConditionParams` from the current app state.\n * Used by `useSidebarBehavior` to construct the params for `isSectionVisible`.\n /\nexport function buildScopeConditionParams(\n appScopeValues: Record<string, AppScopeValue>,\n activeMode: string \| null,\n availableModes: AppModeDefinition[],\n): ScopeConditionParams {\n return {\n appScopeValues,\n activeMode,\n availableModes,\n };\n}\n\n// ════════════════════════════════════════════════════════════════\n// DEV Visibility Debugger\n// ════════════════════════════════════════════════════════════════\n\ninterface SectionVisibilityDebugRow {\n ref: string;\n contentKind: string;\n modeFilter: string;\n modeMatch: boolean \| 'N/A';\n hasScopeCondition: boolean;\n scopeMatch: boolean \| 'N/A';\n visible: boolean;\n}\n\n/\n Logs a console table showing each sidebar section's visibility state.\n * Useful for diagnosing why sections are hidden/shown.\n \n Call from browser DevTools or wire into a debug flag:\n * ```typescript\n * if (window.__WILDO_DEBUG_SIDEBAR__) {\n * debugSectionVisibility(sections, activeMode, scopeParams);\n * }\n * ```\n \n @see app-shell-implementation-plan.md Step 8.3\n */\nexport function debugSectionVisibility(\n sections: SidebarSection[],\n activeMode: string \| null,\n scopeConditionParams: ScopeConditionParams,\n): void {\n const rows: SectionVisibilityDebugRow[] = sections.map(section => {\n const hasModeFilter = !!(section.visibleInModes && section.visibleInModes.length > 0);\n let modeMatch: boolean \| 'N/A' = 'N/A';\n\n if (hasModeFilter) {\n modeMatch = !!activeMode && section.visibleInModes!.includes(activeMode);\n }\n\n const hasScopeCondition = !!section.scopeCondition;\n let scopeMatch: boolean \| 'N/A' = 'N/A';\n\n if (hasScopeCondition) {\n try {\n scopeMatch = section.scopeCondition!(scopeConditionParams);\n } catch {\n scopeMatch = false;\n }\n }\n\n const visible = isSectionVisible(section, activeMode, scopeConditionParams);\n\n return {\n ref: section.ref,\n contentKind: section.contentKind,\n modeFilter: hasModeFilter ? section.visibleInModes!.join(', ') : '(all)',\n modeMatch,\n hasScopeCondition,\n scopeMatch,\n visible,\n };\n });\n\n console.group(\n `[SidebarVisibility] activeMode=\"${activeMode ?? 'none'}\" \| ` +\n `${rows.filter(r => r.visible).length}/${rows.length} sections visible`,\n );\n console.table(rows);\n console.log('Scope params:', scopeConditionParams);\n console.groupEnd();\n}\n"]}
1	+ {"version":3,"file":"section-visibility.js","sourceRoot":"","sources":["../../../../../src/core/mode/section-visibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,EAAE,yBAAyB,EAAE,MAAM,iEAAiE,CAAC;AAE5G,mEAAmE;AACnE,gCAAgC;AAChC,mEAAmE;AAEnE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAuB,EACvB,UAAyB,EACzB,oBAA0C;IAE1C,cAAc;IACd,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAChE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;YACnE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA0B,EAC1B,UAAyB,EACzB,oBAA0C,EAC1C,gBAAyB,KAAK;IAE9B,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAClC,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,oBAAoB,CAAC,CACtD,CAAC;IAEF,IAAI,aAAa,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjE,4EAA4E;QAC5E,6EAA6E;QAC7E,wCAAwC;QACxC,MAAM,wBAAwB,GAAG,QAAQ,CAAC,IAAI,CAC5C,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,yBAAyB,CAAC,eAAe;YAC3D,CAAC,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC,CAC1D,CAAC;QACF,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CACV,2EAA2E;gBAC3E,oEAAoE;gBACpE,oEAAoE;gBACpE,+DAA+D,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,cAA6C,EAC7C,UAAyB,EACzB,cAAmC;IAEnC,OAAO;QACL,cAAc;QACd,UAAU;QACV,cAAc;KACf,CAAC;AACJ,CAAC;AAgBD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA0B,EAC1B,UAAyB,EACzB,oBAA0C;IAE1C,MAAM,IAAI,GAAgC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QAC/D,MAAM,aAAa,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtF,IAAI,SAAS,GAAoB,KAAK,CAAC;QAEvC,IAAI,aAAa,EAAE,CAAC;YAClB,SAAS,GAAG,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC,cAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,iBAAiB,GAAG,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;QACnD,IAAI,UAAU,GAAoB,KAAK,CAAC;QAExC,IAAI,iBAAiB,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,UAAU,GAAG,OAAO,CAAC,cAAe,CAAC,oBAAoB,CAAC,CAAC;YAC7D,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU,GAAG,KAAK,CAAC;YACrB,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,oBAAoB,CAAC,CAAC;QAE5E,OAAO;YACL,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,cAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO;YACxE,SAAS;YACT,iBAAiB;YACjB,UAAU;YACV,OAAO;SACR,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,KAAK,CACX,mCAAmC,UAAU,IAAI,MAAM,MAAM;QAC7D,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,mBAAmB,CACxE,CAAC;IACF,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC;IACnD,OAAO,CAAC,QAAQ,EAAE,CAAC;AACrB,CAAC","sourcesContent":["/*\n Section Visibility Logic\n \n Pure functions for evaluating whether a sidebar section should be visible\n * based on the current mode and scope state. Also provides a DEV-mode\n * visibility debugger that logs a console table showing each section's\n * filter results.\n \n @see component-taxonomy-deep-review.md §7.6\n * @see app-shell-implementation-plan.md Steps 6, 8\n /\n\nimport type {\n SidebarSection,\n ScopeConditionParams,\n AppModeDefinition,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport type { AppScopeValue } from '~wildo-frontend-lib/core/scope/scope.frontend.schemas';\nimport { SidebarSectionContentKind } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\n\n// ════════════════════════════════════════════════════════════════\n// Section Visibility Evaluation\n// ════════════════════════════════════════════════════════════════\n\n/\n Determines whether a sidebar section should be visible given the\n * current mode and scope state.\n \n Evaluation order:\n * 1. `visibleInModes` — if set, section is only visible when\n * `activeMode` is in the list. If the list is empty or absent,\n * the section is visible in all modes.\n * 2. `scopeCondition` — if set, the predicate is called with\n * the current scope parameters. Must return `true` for the\n * section to be visible.\n * 3. Both must pass for the section to be visible.\n /\nexport function isSectionVisible(\n section: SidebarSection,\n activeMode: string \| null,\n scopeConditionParams: ScopeConditionParams,\n): boolean {\n // Mode filter\n if (section.visibleInModes && section.visibleInModes.length > 0) {\n if (!activeMode \|\| !section.visibleInModes.includes(activeMode)) {\n return false;\n }\n }\n\n // Scope condition\n if (section.scopeCondition) {\n try {\n return section.scopeCondition(scopeConditionParams);\n } catch {\n // Defensive: malformed scopeCondition should not crash the sidebar\n return false;\n }\n }\n\n return true;\n}\n\n/\n Filters a list of sidebar sections to only those visible in the\n * current mode and scope state.\n \n Also includes a DEV-mode warning if all sections are hidden and\n * no `GUIDANCE_WIDGET` covers the empty state.\n /\nexport function filterVisibleSections(\n sections: SidebarSection[],\n activeMode: string \| null,\n scopeConditionParams: ScopeConditionParams,\n isDevelopment: boolean = false,\n): SidebarSection[] {\n const visible = sections.filter(s =>\n isSectionVisible(s, activeMode, scopeConditionParams),\n );\n\n if (isDevelopment && visible.length === 0 && sections.length > 0) {\n // Only suppress the warning if a GUIDANCE_WIDGET exists that could actually\n // render — i.e., one without mode restrictions (always visible regardless of\n // which mode hides the other sections).\n const hasUnconditionalGuidance = sections.some(\n s => s.contentKind === SidebarSectionContentKind.GUIDANCE_WIDGET &&\n (!s.visibleInModes \|\| s.visibleInModes.length === 0),\n );\n if (!hasUnconditionalGuidance) {\n console.warn(\n '[AppMode] All sidebar sections are hidden and no unconditionally-visible ' +\n 'GUIDANCE_WIDGET section covers the empty state. Consider adding a ' +\n 'GUIDANCE_WIDGET section without visibleInModes restrictions and a ' +\n 'scopeCondition that activates when other sections are hidden.',\n );\n }\n }\n\n return visible;\n}\n\n/\n Builds `ScopeConditionParams` from the current app state.\n * Used by `useSidebarBehavior` to construct the params for `isSectionVisible`.\n /\nexport function buildScopeConditionParams(\n appScopeValues: Record<string, AppScopeValue>,\n activeMode: string \| null,\n availableModes: AppModeDefinition[],\n): ScopeConditionParams {\n return {\n appScopeValues,\n activeMode,\n availableModes,\n };\n}\n\n// ════════════════════════════════════════════════════════════════\n// DEV Visibility Debugger\n// ════════════════════════════════════════════════════════════════\n\ninterface SectionVisibilityDebugRow {\n ref: string;\n contentKind: string;\n modeFilter: string;\n modeMatch: boolean \| 'N/A';\n hasScopeCondition: boolean;\n scopeMatch: boolean \| 'N/A';\n visible: boolean;\n}\n\n/\n Logs a console table showing each sidebar section's visibility state.\n * Useful for diagnosing why sections are hidden/shown.\n \n Call from browser DevTools or wire into a debug flag:\n * ```typescript\n * if (window.__WILDO_DEBUG_SIDEBAR__) {\n * debugSectionVisibility(sections, activeMode, scopeParams);\n * }\n * ```\n \n @see app-shell-implementation-plan.md Step 8.3\n */\nexport function debugSectionVisibility(\n sections: SidebarSection[],\n activeMode: string \| null,\n scopeConditionParams: ScopeConditionParams,\n): void {\n const rows: SectionVisibilityDebugRow[] = sections.map(section => {\n const hasModeFilter = !!(section.visibleInModes && section.visibleInModes.length > 0);\n let modeMatch: boolean \| 'N/A' = 'N/A';\n\n if (hasModeFilter) {\n modeMatch = !!activeMode && section.visibleInModes!.includes(activeMode);\n }\n\n const hasScopeCondition = !!section.scopeCondition;\n let scopeMatch: boolean \| 'N/A' = 'N/A';\n\n if (hasScopeCondition) {\n try {\n scopeMatch = section.scopeCondition!(scopeConditionParams);\n } catch {\n scopeMatch = false;\n }\n }\n\n const visible = isSectionVisible(section, activeMode, scopeConditionParams);\n\n return {\n ref: section.ref,\n contentKind: section.contentKind,\n modeFilter: hasModeFilter ? section.visibleInModes!.join(', ') : '(all)',\n modeMatch,\n hasScopeCondition,\n scopeMatch,\n visible,\n };\n });\n\n console.group(\n `[SidebarVisibility] activeMode=\"${activeMode ?? 'none'}\" \| ` +\n `${rows.filter(r => r.visible).length}/${rows.length} sections visible`,\n );\n console.table(rows);\n console.log('Scope params:', scopeConditionParams);\n console.groupEnd();\n}\n"]}

package/dist/esm/core/monitoring/analytics/AnalyticsContext.d.ts CHANGED Viewed

@@ -18,7 +18,7 @@ export interface AnalyticsContextValue {
     /** Set of achieved value moment identifiers (scope-aware, persisted) */
     achievedMoments: Set<string>;
     /** Mark a value moment as achieved (persists to localStorage + backend sync) */
-    markMomentAchieved: (identifier: string) => void;
+    markMomentAchieved: (identifier: string) => boolean | Promise<boolean>;
     /**
      * Internal: ref for track() call interception (used by AnalyticsEventBridge).
      * The bridge registers a callback on mount to evaluate CUSTOM_EVENT and
@@ -28,6 +28,14 @@ export interface AnalyticsContextValue {
     _onTrackRef: React.MutableRefObject<((name: string, properties?: Record<string, unknown>) => void) | null>;
 }
 export declare const AnalyticsContext: React.Context<AnalyticsContextValue>;
+/** Identity snapshots come from the mounted AppScope owner, never a decoded token or a late event. */
+export interface AnalyticsIdentity {
+    userId: string | null;
+    organizationId: string | null;
+    applicationId: string | null;
+    anonymousUserId: string | null;
+}
+export declare const AnalyticsIdentityPublisherContext: React.Context<(identity: AnalyticsIdentity) => () => void>;
 export interface AnalyticsContextProviderProps {
     children: React.ReactNode;
     customProviders?: IAnalyticsProvider[];

package/dist/esm/core/monitoring/analytics/AnalyticsContext.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AnalyticsContext.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/core/monitoring/analytics/AnalyticsContext.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAuF,MAAM,OAAO,CAAC;AAE5G,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,yCAAyC,CAAC;~~AAUlG~~,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpE,wBAAwB;IACxB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnE,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,gFAAgF;IAChF,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,~~IAAI~~,CAAC;~~IACjD~~;;;;;OAKG;IACH,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;CAC5G;AAKD,eAAO,MAAM,gBAAgB,sCAAoD,CAAC;~~AAkBlF~~,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACxC;AAED,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAAC,6BAA6B,~~CAwO5E~~,CAAC"}
1	+ {"version":3,"file":"AnalyticsContext.d.ts","sourceRoot":"","sources":["../../../../../../src/core/monitoring/analytics/AnalyticsContext.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAuF,MAAM,OAAO,CAAC;AAE5G,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,yCAAyC,CAAC;AAWlG,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpE,wBAAwB;IACxB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnE,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,gFAAgF;IAChF,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE;;;;;OAKG;IACH,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;CAC5G;AAKD,eAAO,MAAM,gBAAgB,sCAAoD,CAAC;AAElF,sGAAsG;AACtG,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AACD,eAAO,MAAM,iCAAiC,2BAA6B,iBAAiB,KAAK,MAAM,IAAI,CAAe,CAAC;AAQ3H,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACxC;AAED,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAAC,6BAA6B,CA2S5E,CAAC"}

package/dist/esm/core/monitoring/analytics/AnalyticsContext.js CHANGED Viewed

@@ -6,29 +6,25 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * consent gating, and provider lifecycle management.
  */
 import { createContext, useContext, useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { DataProcessingConsent, ANALYTICS_ACHIEVED_STORAGE_KEY_PREFIX } from '@wildo-ai/saas-models';
+import { ConsentPurpose, CoreResourceType, hasGrantedConsentPurposes, normalizeConsentPurposes, ValueMomentRole, ValueMomentScope, AnalyticsTriggerSource, ANALYTICS_ACHIEVED_STORAGE_KEY_PREFIX } from '@wildo-ai/saas-models';
 import { AnalyticsProviderRegistry } from './analytics-provider-registry.frontend.service.js';
 import { ApplicationContext } from '../../../core/runtime/ApplicationContext.shared.js';
 import { useEventBus } from '../../../core/events/useEventBus.js';
 import { FrontendEvents } from '../../../core/events/events.frontend.schemas.js';
 import { getManualCallsHttpClient } from '../../../core/requests/wildo-http-client-manual-calls.frontend.service.js';
+import { useResourceReachability } from '../../../core/resources/useResourceRegistry.js';
 import { AnalyticsEventBridge } from './AnalyticsEventBridge.js';
 // ─── Context ────────────────────────────────────────────────────
 // Note: useAnalytics hook is in a separate file (useAnalytics.ts) for React Fast Refresh compatibility.
 export const AnalyticsContext = createContext(null);
-// ─── Consent order for comparison ───────────────────────────────
-const CONSENT_ORDER = [
-    DataProcessingConsent.NONE,
-    DataProcessingConsent.BASIC,
-    DataProcessingConsent.ANALYTICS,
-    DataProcessingConsent.MARKETING,
-    DataProcessingConsent.FULL,
-];
+export const AnalyticsIdentityPublisherContext = createContext(null);
 // ─── Provider Registry (singleton) ──────────────────────────────
 const providerRegistry = new AnalyticsProviderRegistry();
 export const AnalyticsContextProvider = ({ children, customProviders, }) => {
     const appContext = useContext(ApplicationContext);
     const { on } = useEventBus();
+    // Whether this consumer serves the progression-backed analytics routes at all (#1069).
+    const momentsReachable = useResourceReachability(CoreResourceType.USER_PROGRESSION_STATE);
     const providersRef = useRef([]);
     const [isActive, setIsActive] = useState(false);
     // Session start: captured once at mount
@@ -36,12 +32,45 @@ export const AnalyticsContextProvider = ({ children, customProviders, }) => {
     // Resolve analytics config from ApplicationContext
     const analyticsConfig = useMemo(() => appContext?.appConfig?.analytics, [appContext?.appConfig?.analytics]);
     // ─── Consent gating ─────────────────────────────────────────
-    const [consent, setConsent] = useState(DataProcessingConsent.NONE);
+    /*
+     * The purposes the signed-in person granted — a SET (#534). Starts EMPTY, never at a level: nothing
+     * is known to be granted until the person's preferences arrive, and analytics that started on an
+     * assumed consent would already have sent data by the time the real answer said otherwise.
+     *
+     * This used to hold one `DataProcessingConsent` and compare it against a module-private
+     * `CONSENT_ORDER` with `>=`, which asserted that agreeing to marketing implied agreeing to analytics
+     * — a claim nobody decided. Membership of ANALYTICS is the whole test now.
+     */
+    /*
+     * ONE subject grants: the signed-in ACCOUNT.
+     *
+     * A second, VISITOR tier lived here briefly (#1258 Step 1d) and was removed on 2026-09-20 with the
+     * pre-auth panel that fed it — see `PublicLayout_MainContainer` for why that panel went. Nothing
+     * publishes a visitor decision to this provider any more, so a visitor tier here would be a state
+     * nothing can ever set: the application's public pages run no consent-based analytics, which is the
+     * behaviour they had before the panel existed and is the safe direction.
+     *
+     * `null` means "nothing has been said", which is not the same as granting nothing — an empty array
+     * is a real, recorded withdrawal and must gate. That distinction is why this is not a bare array.
+     */
+    const [accountPurposes, setAccountPurposes] = useState(null);
+    const grantedPurposes = useMemo(() => accountPurposes ?? [], [accountPurposes]);
     useEffect(() => {
         return on(FrontendEvents.USER_PREFERENCES_CHANGED, (payload) => {
-            const newConsent = payload.privacy?.dataProcessingConsent;
-            if (newConsent) {
-                setConsent(newConsent);
+            /*
+             * `privacy: null` is the CLEARED state — sign-out, or an identity with no preferences. It must
+             * revoke: the old handler ignored it, so a signed-out browser kept the previous person's consent
+             * and analytics kept running for whoever used it next.
+             */
+            if (payload.privacy === null) {
+                setAccountPurposes([]);
+                return;
+            }
+            const purposes = payload.privacy?.consentedPurposes;
+            // `undefined` means this event carried no privacy block; an EMPTY set is a real withdrawal and
+            // must reach the gate below, which is why this does not test truthiness.
+            if (purposes !== undefined) {
+                setAccountPurposes(normalizeConsentPurposes(purposes));
             }
         });
     }, [on]);
@@ -51,8 +80,8 @@ export const AnalyticsContextProvider = ({ children, customProviders, }) => {
             setIsActive(false);
             return;
         }
-        const requiredConsent = analyticsConfig.requiredConsent ?? DataProcessingConsent.ANALYTICS;
-        const hasConsent = CONSENT_ORDER.indexOf(consent) >= CONSENT_ORDER.indexOf(requiredConsent);
+        const hasConsent = analyticsConfig.requiresConsent === false
+            || hasGrantedConsentPurposes(grantedPurposes, [ConsentPurpose.ANALYTICS]);
         if (!hasConsent) {
             providersRef.current.forEach(p => p.reset());
             setIsActive(false);
@@ -75,7 +104,7 @@ export const AnalyticsContextProvider = ({ children, customProviders, }) => {
             allProviders.forEach(p => p.shutdown().catch(() => { }));
             providersRef.current = [];
         };
-    }, [analyticsConfig, consent, customProviders]);
+    }, [analyticsConfig, grantedPurposes, customProviders]);
     // Identify user on login
     useEffect(() => {
         return on(FrontendEvents.USER_LOGIN, (payload) => {
@@ -89,57 +118,85 @@ export const AnalyticsContextProvider = ({ children, customProviders, }) => {
         });
     }, [on]);
     // ─── Achieved moments persistence ─────────────────────────────
-    // userId is set by the USER_LOGIN event for scope-aware persistence.
-    const [loggedInUserId, setLoggedInUserId] = useState(null);
-    useEffect(() => {
-        return on(FrontendEvents.USER_LOGIN, (payload) => {
-            setLoggedInUserId(payload.userId);
-        });
-    }, [on]);
-    useEffect(() => {
-        return on(FrontendEvents.USER_LOGOUT, () => {
-            setLoggedInUserId(null);
-        });
-    }, [on]);
-    const storageKey = useMemo(() => loggedInUserId ? `${ANALYTICS_ACHIEVED_STORAGE_KEY_PREFIX}${loggedInUserId}` : null, [loggedInUserId]);
-    const [achievedMoments, setAchievedMoments] = useState(new Set());
+    const [identity, setIdentity] = useState(null);
+    const identityOwner = useRef(null);
+    const publishIdentity = useCallback((next) => {
+        const owner = Symbol();
+        identityOwner.current = owner;
+        setIdentity(next);
+        return () => {
+            if (identityOwner.current === owner) {
+                identityOwner.current = null;
+                setIdentity(null);
+            }
+        };
+    }, []);
+    const identityKey = JSON.stringify(identity);
+    const currentIdentityKey = useRef(identityKey);
+    currentIdentityKey.current = identityKey;
+    const momentProgress = useRef({ signals: new Map(), counts: new Map(), lastFired: new Map(), completed: new Set() });
+    const userStorageKey = identity?.userId
+        ? `${ANALYTICS_ACHIEVED_STORAGE_KEY_PREFIX}${JSON.stringify([identity.applicationId, ValueMomentScope.USER, identity.userId])}` : null;
+    const organizationStorageKey = identity?.organizationId
+        ? `${ANALYTICS_ACHIEVED_STORAGE_KEY_PREFIX}${JSON.stringify([identity.applicationId, ValueMomentScope.ORGANIZATION, identity.organizationId])}` : null;
+    const storageKey = JSON.stringify([userStorageKey, organizationStorageKey]);
+    const isOrganizationMoment = useCallback((id) => analyticsConfig?.valueMoments?.find(moment => moment.identifier === id)?.scope === ValueMomentScope.ORGANIZATION, [analyticsConfig?.valueMoments]);
+    const isPersistentMoment = useCallback((id) => analyticsConfig?.valueMoments?.find(moment => moment.identifier === id)?.role !== ValueMomentRole.ANTI_PATTERN, [analyticsConfig?.valueMoments]);
+    const [achievementState, setAchievementState] = useState({ key: identityKey, moments: new Set() });
+    const achievedMoments = useMemo(() => achievementState.key === identityKey ? achievementState.moments : new Set(), [achievementState, identityKey]);
+    const setAchievedMoments = useCallback((update) => {
+        setAchievementState(previous => ({ key: identityKey, moments: typeof update === 'function'
+                ? update(previous.key === identityKey ? previous.moments : new Set()) : update }));
+    }, [identityKey]);
     // Helper: persist to localStorage
     const persistToStorage = useCallback((moments) => {
-        if (!storageKey)
-            return;
         try {
-            localStorage.setItem(storageKey, JSON.stringify([...moments]));
+            if (userStorageKey)
+                localStorage.setItem(userStorageKey, JSON.stringify([...moments].filter(id => !isOrganizationMoment(id))));
+            if (organizationStorageKey)
+                localStorage.setItem(organizationStorageKey, JSON.stringify([...moments].filter(isOrganizationMoment)));
         }
         catch {
             /* quota exceeded — best effort */
         }
-    }, [storageKey]);
+    }, [userStorageKey, organizationStorageKey, isOrganizationMoment]);
     // Load from localStorage on mount + fetch from backend if backendSync
     useEffect(() => {
-        if (!analyticsConfig?.enabled || !storageKey)
+        setAchievedMoments(new Set());
+        if (!analyticsConfig?.enabled || !identity || (!identity.userId && !identity.organizationId))
             return;
         // Load from localStorage
         try {
-            const stored = localStorage.getItem(storageKey);
-            if (stored) {
-                setAchievedMoments(new Set(JSON.parse(stored)));
+            const loaded = new Set();
+            for (const [key, organization] of [[userStorageKey, false], [organizationStorageKey, true]]) {
+                if (!key)
+                    continue;
+                const stored = localStorage.getItem(key);
+                if (stored)
+                    for (const id of JSON.parse(stored)) {
+                        if (isPersistentMoment(id) && isOrganizationMoment(id) === organization)
+                            loaded.add(id);
+                    }
             }
+            setAchievedMoments(loaded);
         }
         catch {
             /* corrupt storage — start fresh */
         }
-        // Fetch from backend if backendSync enabled
-        if (analyticsConfig?.persistence?.backendSync) {
+        // Fetch from backend if backendSync enabled AND this consumer can reach the route (#1069, the
+        // #268 rule): achieved moments are read from the progression store, which a consumer whose
+        // registry excludes it does not serve. localStorage still loads above.
+        if (analyticsConfig?.persistence?.backendSync && momentsReachable) {
             let aborted = false;
             getManualCallsHttpClient()
                 .getAnalyticsMomentsAchieved()
                 .then((response) => {
-                if (aborted)
+                if (aborted || currentIdentityKey.current !== identityKey)
                     return;
                 const res = response;
                 if (res.moments) {
                     setAchievedMoments(prev => {
-                        const merged = new Set([...prev, ...res.moments]);
+                        const merged = new Set([...prev, ...res.moments].filter(isPersistentMoment));
                         persistToStorage(merged);
                         return merged;
                     });
@@ -150,10 +207,12 @@ export const AnalyticsContextProvider = ({ children, customProviders, }) => {
             });
             return () => { aborted = true; };
         }
-    }, [analyticsConfig?.enabled, analyticsConfig?.persistence?.backendSync, storageKey, persistToStorage]);
+    }, [analyticsConfig?.enabled, analyticsConfig?.persistence?.backendSync, momentsReachable, storageKey, identityKey, persistToStorage, isPersistentMoment, isOrganizationMoment]);
     // Subscribe to ANALYTICS_MOMENT_ACHIEVED events (backend-pushed via WS)
     useEffect(() => {
         return on(FrontendEvents.ANALYTICS_MOMENT_ACHIEVED, (payload) => {
+            if (!identity || payload.triggerSource === AnalyticsTriggerSource.FRONTEND || payload.role === ValueMomentRole.ANTI_PATTERN || !isPersistentMoment(payload.momentIdentifier))
+                return;
             setAchievedMoments(prev => {
                 const next = new Set(prev);
                 next.add(payload.momentIdentifier);
@@ -161,23 +220,36 @@ export const AnalyticsContextProvider = ({ children, customProviders, }) => {
                 return next;
             });
         });
-    }, [on, persistToStorage]);
+    }, [on, persistToStorage, identityKey, isPersistentMoment]);
     const markMomentAchieved = useCallback((identifier) => {
-        setAchievedMoments(prev => {
-            const next = new Set(prev);
-            next.add(identifier);
-            persistToStorage(next);
-            return next;
-        });
-        // Sync to backend if enabled
-        if (analyticsConfig?.persistence?.backendSync) {
-            getManualCallsHttpClient()
-                .postAnalyticsMomentsAchieved({ momentIdentifier: identifier })
-                .catch(() => {
-                /* Best-effort sync */
+        if (!identity || !isPersistentMoment(identifier))
+            return false;
+        const definition = analyticsConfig?.valueMoments?.find(moment => moment.identifier === identifier);
+        if (definition?.requires?.some(id => !achievedMoments.has(id)) || definition?.beforeStage?.some(id => achievedMoments.has(id)))
+            return false;
+        const record = () => {
+            if (currentIdentityKey.current !== identityKey)
+                return false;
+            setAchievedMoments(prev => {
+                const next = new Set(prev);
+                next.add(identifier);
+                persistToStorage(next);
+                return next;
             });
-        }
-    }, [analyticsConfig?.persistence?.backendSync, persistToStorage]);
+            return true;
+        };
+        if (!analyticsConfig?.persistence?.backendSync)
+            return record();
+        // A refused report is not an achievement. Network failures retain the documented best-effort
+        // local behavior; explicit server refusals must never be merged back as local truth.
+        return getManualCallsHttpClient().postAnalyticsMomentsAchieved({ momentIdentifier: identifier, scope: definition?.scope })
+            .then(result => result.success === false ? false : record())
+            .catch((error) => {
+            const response = error;
+            const status = response?.httpStatus ?? response?.response?.status;
+            return status && status >= 400 && status < 500 ? false : record();
+        });
+    }, [analyticsConfig, persistToStorage, identityKey, isPersistentMoment, achievedMoments]);
     // ─── Track interceptor ref ────────────────────────────────────
     const onTrackRef = useRef(null);
     const track = useCallback((name, properties) => {
@@ -203,6 +275,6 @@ export const AnalyticsContextProvider = ({ children, customProviders, }) => {
         markMomentAchieved,
         _onTrackRef: onTrackRef,
     }), [track, page, isActive, sessionStartTimestamp, achievedMoments, markMomentAchieved]);
-    return (_jsxs(AnalyticsContext.Provider, { value: contextValue, children: [isActive && analyticsConfig && (_jsx(AnalyticsEventBridge, { config: analyticsConfig.autoInstrumentation, valueMoments: analyticsConfig.valueMoments })), children] }));
+    return (_jsx(AnalyticsIdentityPublisherContext.Provider, { value: publishIdentity, children: _jsxs(AnalyticsContext.Provider, { value: contextValue, children: [isActive && identity && analyticsConfig && (_jsx(AnalyticsEventBridge, { identity: identity, progress: momentProgress.current, config: analyticsConfig.autoInstrumentation, valueMoments: analyticsConfig.valueMoments }, `${identityKey}:${JSON.stringify(analyticsConfig.valueMoments)}`)), children] }) }));
 };
 //# sourceMappingURL=AnalyticsContext.js.map

package/dist/esm/core/monitoring/analytics/AnalyticsContext.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AnalyticsContext.js","sourceRoot":"","sources":["../../../../../src/core/monitoring/analytics/AnalyticsContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n Analytics Context Provider\n * \n * Provides analytics tracking, value moment achievement persistence,\n * consent gating, and provider lifecycle management.\n /\n\nimport React, { createContext, useContext, useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { DataProcessingConsent, type AnalyticsConfig, ANALYTICS_ACHIEVED_STORAGE_KEY_PREFIX } from '@wildo-ai/saas-models';\nimport type { IAnalyticsProvider, AnalyticsEvent } from './analytics-provider.frontend.interface';\nimport { AnalyticsProviderRegistry } from './analytics-provider-registry.frontend.service';\nimport { ApplicationContext } from '~wildo-frontend-lib/core/runtime/ApplicationContext.shared';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport { AnalyticsEventBridge } from './AnalyticsEventBridge';\n\n// ─── Context Value Interface ────────────────────────────────────\n\nexport interface AnalyticsContextValue {\n /* Track a custom event (app-custom usage) /\n track: (name: string, properties?: Record<string, unknown>) => void;\n /* Track a page view /\n page: (path: string, properties?: Record<string, unknown>) => void;\n /* Whether analytics is active (enabled + consent granted) /\n isActive: boolean;\n /* Session start timestamp (for TTFV computation) /\n sessionStartTimestamp: number;\n /* Set of achieved value moment identifiers (scope-aware, persisted) /\n achievedMoments: Set<string>;\n /* Mark a value moment as achieved (persists to localStorage + backend sync) /\n markMomentAchieved: (identifier: string) => void;\n /\n Internal: ref for track() call interception (used by AnalyticsEventBridge).\n * The bridge registers a callback on mount to evaluate CUSTOM_EVENT and\n * FEATURE_ACCESS signals when track() is called.\n * @internal\n /\n _onTrackRef: React.MutableRefObject<((name: string, properties?: Record<string, unknown>) => void) \| null>;\n}\n\n// ─── Context ────────────────────────────────────────────────────\n\n// Note: useAnalytics hook is in a separate file (useAnalytics.ts) for React Fast Refresh compatibility.\nexport const AnalyticsContext = createContext<AnalyticsContextValue \| null>(null);\n\n// ─── Consent order for comparison ───────────────────────────────\n\nconst CONSENT_ORDER = [\n DataProcessingConsent.NONE,\n DataProcessingConsent.BASIC,\n DataProcessingConsent.ANALYTICS,\n DataProcessingConsent.MARKETING,\n DataProcessingConsent.FULL,\n];\n\n// ─── Provider Registry (singleton) ──────────────────────────────\n\nconst providerRegistry = new AnalyticsProviderRegistry();\n\n// ─── Provider Component ─────────────────────────────────────────\n\nexport interface AnalyticsContextProviderProps {\n children: React.ReactNode;\n customProviders?: IAnalyticsProvider[];\n}\n\nexport const AnalyticsContextProvider: React.FC<AnalyticsContextProviderProps> = ({\n children,\n customProviders,\n}) => {\n const appContext = useContext(ApplicationContext);\n const { on } = useEventBus();\n const providersRef = useRef<IAnalyticsProvider[]>([]);\n const [isActive, setIsActive] = useState(false);\n\n // Session start: captured once at mount\n const sessionStartTimestamp = useRef(Date.now()).current;\n\n // Resolve analytics config from ApplicationContext\n const analyticsConfig = useMemo<AnalyticsConfig \| undefined>(\n () => appContext?.appConfig?.analytics,\n [appContext?.appConfig?.analytics],\n );\n\n // ─── Consent gating ─────────────────────────────────────────\n\n const [consent, setConsent] = useState<DataProcessingConsent>(DataProcessingConsent.NONE);\n\n useEffect(() => {\n return on(FrontendEvents.USER_PREFERENCES_CHANGED, (payload) => {\n const newConsent = payload.privacy?.dataProcessingConsent;\n if (newConsent) {\n setConsent(newConsent);\n }\n });\n }, [on]);\n\n // Initialize/teardown providers based on config + consent\n useEffect(() => {\n if (!analyticsConfig?.enabled) {\n setIsActive(false);\n return;\n }\n\n const requiredConsent = analyticsConfig.requiredConsent ?? DataProcessingConsent.ANALYTICS;\n const hasConsent = CONSENT_ORDER.indexOf(consent) >= CONSENT_ORDER.indexOf(requiredConsent);\n\n if (!hasConsent) {\n providersRef.current.forEach(p => p.reset());\n setIsActive(false);\n return;\n }\n\n let aborted = false;\n\n const httpClient = getManualCallsHttpClient();\n const builtInProviders = providerRegistry.resolveFromConfig(\n analyticsConfig.providers ?? [],\n httpClient,\n );\n const allProviders = [...builtInProviders, ...(customProviders ?? [])];\n\n Promise.all(\n allProviders.map(p =>\n p.initialize(analyticsConfig.providers?.find(c => c.providerType === p.name)?.config).catch(err => {\n console.warn(`[Analytics] Failed to initialize provider \"${p.name}\":`, err);\n })\n )\n ).then(() => {\n if (aborted) return;\n providersRef.current = allProviders;\n setIsActive(true);\n });\n\n return () => {\n aborted = true;\n allProviders.forEach(p => p.shutdown().catch(() => {}));\n providersRef.current = [];\n };\n }, [analyticsConfig, consent, customProviders]);\n\n // Identify user on login\n useEffect(() => {\n return on(FrontendEvents.USER_LOGIN, (payload) => {\n providersRef.current.forEach(p =>\n p.identify({ userId: payload.userId })\n );\n });\n }, [on]);\n\n // Reset on logout\n useEffect(() => {\n return on(FrontendEvents.USER_LOGOUT, () => {\n providersRef.current.forEach(p => p.reset());\n });\n }, [on]);\n\n // ─── Achieved moments persistence ─────────────────────────────\n\n // userId is set by the USER_LOGIN event for scope-aware persistence.\n const [loggedInUserId, setLoggedInUserId] = useState<string \| null>(null);\n\n useEffect(() => {\n return on(FrontendEvents.USER_LOGIN, (payload) => {\n setLoggedInUserId(payload.userId);\n });\n }, [on]);\n\n useEffect(() => {\n return on(FrontendEvents.USER_LOGOUT, () => {\n setLoggedInUserId(null);\n });\n }, [on]);\n\n const storageKey = useMemo(\n () => loggedInUserId ? `${ANALYTICS_ACHIEVED_STORAGE_KEY_PREFIX}${loggedInUserId}` : null,\n [loggedInUserId],\n );\n\n const [achievedMoments, setAchievedMoments] = useState<Set<string>>(new Set());\n\n // Helper: persist to localStorage\n const persistToStorage = useCallback((moments: Set<string>) => {\n if (!storageKey) return;\n try {\n localStorage.setItem(storageKey, JSON.stringify([...moments]));\n } catch {\n / quota exceeded — best effort /\n }\n }, [storageKey]);\n\n // Load from localStorage on mount + fetch from backend if backendSync\n useEffect(() => {\n if (!analyticsConfig?.enabled \|\| !storageKey) return;\n\n // Load from localStorage\n try {\n const stored = localStorage.getItem(storageKey);\n if (stored) {\n setAchievedMoments(new Set(JSON.parse(stored)));\n }\n } catch {\n / corrupt storage — start fresh /\n }\n\n // Fetch from backend if backendSync enabled\n if (analyticsConfig?.persistence?.backendSync) {\n let aborted = false;\n getManualCallsHttpClient()\n .getAnalyticsMomentsAchieved()\n .then((response: unknown) => {\n if (aborted) return;\n const res = response as { moments?: string[] };\n if (res.moments) {\n setAchievedMoments(prev => {\n const merged = new Set([...prev, ...res.moments!]);\n persistToStorage(merged);\n return merged;\n });\n }\n })\n .catch(() => {\n / Backend unavailable — use localStorage only /\n });\n\n return () => { aborted = true; };\n }\n }, [analyticsConfig?.enabled, analyticsConfig?.persistence?.backendSync, storageKey, persistToStorage]);\n\n // Subscribe to ANALYTICS_MOMENT_ACHIEVED events (backend-pushed via WS)\n useEffect(() => {\n return on(FrontendEvents.ANALYTICS_MOMENT_ACHIEVED, (payload) => {\n setAchievedMoments(prev => {\n const next = new Set(prev);\n next.add(payload.momentIdentifier);\n persistToStorage(next);\n return next;\n });\n });\n }, [on, persistToStorage]);\n\n const markMomentAchieved = useCallback((identifier: string) => {\n setAchievedMoments(prev => {\n const next = new Set(prev);\n next.add(identifier);\n persistToStorage(next);\n return next;\n });\n // Sync to backend if enabled\n if (analyticsConfig?.persistence?.backendSync) {\n getManualCallsHttpClient()\n .postAnalyticsMomentsAchieved({ momentIdentifier: identifier })\n .catch(() => {\n / Best-effort sync */\n });\n }\n }, [analyticsConfig?.persistence?.backendSync, persistToStorage]);\n\n // ─── Track interceptor ref ────────────────────────────────────\n\n const onTrackRef = useRef<((name: string, properties?: Record<string, unknown>) => void) \| null>(null);\n\n const track = useCallback((name: string, properties?: Record<string, unknown>) => {\n if (!isActive) return;\n const event: AnalyticsEvent = { name, properties, timestamp: Date.now() };\n providersRef.current.forEach(p => p.track(event));\n // Forward to bridge interceptor for CUSTOM_EVENT / FEATURE_ACCESS signal evaluation\n onTrackRef.current?.(name, properties);\n }, [isActive]);\n\n const page = useCallback((path: string, properties?: Record<string, unknown>) => {\n if (!isActive) return;\n providersRef.current.forEach(p => p.page(path, properties));\n }, [isActive]);\n\n // ─── Render ───────────────────────────────────────────────────\n\n const contextValue = useMemo<AnalyticsContextValue>(() => ({\n track,\n page,\n isActive,\n sessionStartTimestamp,\n achievedMoments,\n markMomentAchieved,\n _onTrackRef: onTrackRef,\n }), [track, page, isActive, sessionStartTimestamp, achievedMoments, markMomentAchieved]);\n\n return (\n <AnalyticsContext.Provider value={contextValue}>\n {isActive && analyticsConfig && (\n <AnalyticsEventBridge\n config={analyticsConfig.autoInstrumentation}\n valueMoments={analyticsConfig.valueMoments} \n />\n )}\n {children}\n </AnalyticsContext.Provider>\n );\n};\n"]}
1	+ {"version":3,"file":"AnalyticsContext.js","sourceRoot":"","sources":["../../../../../../src/core/monitoring/analytics/AnalyticsContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n Analytics Context Provider\n * \n * Provides analytics tracking, value moment achievement persistence,\n * consent gating, and provider lifecycle management.\n /\n\nimport React, { createContext, useContext, useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { ConsentPurpose, CoreResourceType, hasGrantedConsentPurposes, normalizeConsentPurposes, ValueMomentRole, ValueMomentScope, AnalyticsTriggerSource, type AnalyticsConfig, ANALYTICS_ACHIEVED_STORAGE_KEY_PREFIX } from '@wildo-ai/saas-models';\nimport type { IAnalyticsProvider, AnalyticsEvent } from './analytics-provider.frontend.interface';\nimport { AnalyticsProviderRegistry } from './analytics-provider-registry.frontend.service';\nimport { ApplicationContext } from '~wildo-frontend-lib/core/runtime/ApplicationContext.shared';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport { useResourceReachability } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { AnalyticsEventBridge, type AnalyticsMomentProgress } from './AnalyticsEventBridge';\n\n// ─── Context Value Interface ────────────────────────────────────\n\nexport interface AnalyticsContextValue {\n /* Track a custom event (app-custom usage) /\n track: (name: string, properties?: Record<string, unknown>) => void;\n /* Track a page view /\n page: (path: string, properties?: Record<string, unknown>) => void;\n /* Whether analytics is active (enabled + consent granted) /\n isActive: boolean;\n /* Session start timestamp (for TTFV computation) /\n sessionStartTimestamp: number;\n /* Set of achieved value moment identifiers (scope-aware, persisted) /\n achievedMoments: Set<string>;\n /* Mark a value moment as achieved (persists to localStorage + backend sync) /\n markMomentAchieved: (identifier: string) => boolean \| Promise<boolean>;\n /\n Internal: ref for track() call interception (used by AnalyticsEventBridge).\n * The bridge registers a callback on mount to evaluate CUSTOM_EVENT and\n * FEATURE_ACCESS signals when track() is called.\n * @internal\n /\n _onTrackRef: React.MutableRefObject<((name: string, properties?: Record<string, unknown>) => void) \| null>;\n}\n\n// ─── Context ────────────────────────────────────────────────────\n\n// Note: useAnalytics hook is in a separate file (useAnalytics.ts) for React Fast Refresh compatibility.\nexport const AnalyticsContext = createContext<AnalyticsContextValue \| null>(null);\n\n/* Identity snapshots come from the mounted AppScope owner, never a decoded token or a late event. /\nexport interface AnalyticsIdentity {\n userId: string \| null;\n organizationId: string \| null;\n applicationId: string \| null;\n anonymousUserId: string \| null;\n}\nexport const AnalyticsIdentityPublisherContext = createContext<((identity: AnalyticsIdentity) => () => void) \| null>(null);\n\n// ─── Provider Registry (singleton) ──────────────────────────────\n\nconst providerRegistry = new AnalyticsProviderRegistry();\n\n// ─── Provider Component ─────────────────────────────────────────\n\nexport interface AnalyticsContextProviderProps {\n children: React.ReactNode;\n customProviders?: IAnalyticsProvider[];\n}\n\nexport const AnalyticsContextProvider: React.FC<AnalyticsContextProviderProps> = ({\n children,\n customProviders,\n}) => {\n const appContext = useContext(ApplicationContext);\n const { on } = useEventBus();\n // Whether this consumer serves the progression-backed analytics routes at all (#1069).\n const momentsReachable = useResourceReachability(CoreResourceType.USER_PROGRESSION_STATE);\n const providersRef = useRef<IAnalyticsProvider[]>([]);\n const [isActive, setIsActive] = useState(false);\n\n // Session start: captured once at mount\n const sessionStartTimestamp = useRef(Date.now()).current;\n\n // Resolve analytics config from ApplicationContext\n const analyticsConfig = useMemo<AnalyticsConfig \| undefined>(\n () => appContext?.appConfig?.analytics,\n [appContext?.appConfig?.analytics],\n );\n\n // ─── Consent gating ─────────────────────────────────────────\n\n /\n * The purposes the signed-in person granted — a SET (#534). Starts EMPTY, never at a level: nothing\n * is known to be granted until the person's preferences arrive, and analytics that started on an\n * assumed consent would already have sent data by the time the real answer said otherwise.\n \n This used to hold one `DataProcessingConsent` and compare it against a module-private\n * `CONSENT_ORDER` with `>=`, which asserted that agreeing to marketing implied agreeing to analytics\n * — a claim nobody decided. Membership of ANALYTICS is the whole test now.\n /\n /\n * ONE subject grants: the signed-in ACCOUNT.\n \n A second, VISITOR tier lived here briefly (#1258 Step 1d) and was removed on 2026-09-20 with the\n * pre-auth panel that fed it — see `PublicLayout_MainContainer` for why that panel went. Nothing\n * publishes a visitor decision to this provider any more, so a visitor tier here would be a state\n * nothing can ever set: the application's public pages run no consent-based analytics, which is the\n * behaviour they had before the panel existed and is the safe direction.\n \n `null` means \"nothing has been said\", which is not the same as granting nothing — an empty array\n * is a real, recorded withdrawal and must gate. That distinction is why this is not a bare array.\n /\n const [accountPurposes, setAccountPurposes] = useState<readonly ConsentPurpose[] \| null>(null);\n const grantedPurposes = useMemo<readonly ConsentPurpose[]>(() => accountPurposes ?? [], [accountPurposes]);\n\n useEffect(() => {\n return on(FrontendEvents.USER_PREFERENCES_CHANGED, (payload) => {\n /\n * `privacy: null` is the CLEARED state — sign-out, or an identity with no preferences. It must\n * revoke: the old handler ignored it, so a signed-out browser kept the previous person's consent\n * and analytics kept running for whoever used it next.\n /\n if (payload.privacy === null) {\n setAccountPurposes([]);\n return;\n }\n const purposes = payload.privacy?.consentedPurposes;\n // `undefined` means this event carried no privacy block; an EMPTY set is a real withdrawal and\n // must reach the gate below, which is why this does not test truthiness.\n if (purposes !== undefined) {\n setAccountPurposes(normalizeConsentPurposes(purposes));\n }\n });\n }, [on]);\n\n\n // Initialize/teardown providers based on config + consent\n useEffect(() => {\n if (!analyticsConfig?.enabled) {\n setIsActive(false);\n return;\n }\n\n const hasConsent = analyticsConfig.requiresConsent === false\n \|\| hasGrantedConsentPurposes(grantedPurposes, [ConsentPurpose.ANALYTICS]);\n\n if (!hasConsent) {\n providersRef.current.forEach(p => p.reset());\n setIsActive(false);\n return;\n }\n\n let aborted = false;\n\n const httpClient = getManualCallsHttpClient();\n const builtInProviders = providerRegistry.resolveFromConfig(\n analyticsConfig.providers ?? [],\n httpClient,\n );\n const allProviders = [...builtInProviders, ...(customProviders ?? [])];\n\n Promise.all(\n allProviders.map(p =>\n p.initialize(analyticsConfig.providers?.find(c => c.providerType === p.name)?.config).catch(err => {\n console.warn(`[Analytics] Failed to initialize provider \"${p.name}\":`, err);\n })\n )\n ).then(() => {\n if (aborted) return;\n providersRef.current = allProviders;\n setIsActive(true);\n });\n\n return () => {\n aborted = true;\n allProviders.forEach(p => p.shutdown().catch(() => {}));\n providersRef.current = [];\n };\n }, [analyticsConfig, grantedPurposes, customProviders]);\n\n // Identify user on login\n useEffect(() => {\n return on(FrontendEvents.USER_LOGIN, (payload) => {\n providersRef.current.forEach(p =>\n p.identify({ userId: payload.userId })\n );\n });\n }, [on]);\n\n // Reset on logout\n useEffect(() => {\n return on(FrontendEvents.USER_LOGOUT, () => {\n providersRef.current.forEach(p => p.reset());\n });\n }, [on]);\n\n // ─── Achieved moments persistence ─────────────────────────────\n\n const [identity, setIdentity] = useState<AnalyticsIdentity \| null>(null);\n const identityOwner = useRef<symbol \| null>(null);\n const publishIdentity = useCallback((next: AnalyticsIdentity) => {\n const owner = Symbol();\n identityOwner.current = owner;\n setIdentity(next);\n return () => {\n if (identityOwner.current === owner) { identityOwner.current = null; setIdentity(null); }\n };\n }, []);\n const identityKey = JSON.stringify(identity);\n const currentIdentityKey = useRef(identityKey);\n currentIdentityKey.current = identityKey;\n const momentProgress = useRef<AnalyticsMomentProgress>({ signals: new Map(), counts: new Map(), lastFired: new Map(), completed: new Set() });\n const userStorageKey = identity?.userId\n ? `${ANALYTICS_ACHIEVED_STORAGE_KEY_PREFIX}${JSON.stringify([identity.applicationId, ValueMomentScope.USER, identity.userId])}` : null;\n const organizationStorageKey = identity?.organizationId\n ? `${ANALYTICS_ACHIEVED_STORAGE_KEY_PREFIX}${JSON.stringify([identity.applicationId, ValueMomentScope.ORGANIZATION, identity.organizationId])}` : null;\n const storageKey = JSON.stringify([userStorageKey, organizationStorageKey]);\n const isOrganizationMoment = useCallback((id: string) =>\n analyticsConfig?.valueMoments?.find(moment => moment.identifier === id)?.scope === ValueMomentScope.ORGANIZATION,\n [analyticsConfig?.valueMoments]);\n const isPersistentMoment = useCallback((id: string) =>\n analyticsConfig?.valueMoments?.find(moment => moment.identifier === id)?.role !== ValueMomentRole.ANTI_PATTERN,\n [analyticsConfig?.valueMoments]);\n\n const [achievementState, setAchievementState] = useState<{key: string; moments: Set<string>}>({key: identityKey, moments: new Set()});\n const achievedMoments = useMemo(() => achievementState.key === identityKey ? achievementState.moments : new Set<string>(), [achievementState, identityKey]);\n const setAchievedMoments = useCallback((update: React.SetStateAction<Set<string>>) => {\n setAchievementState(previous => ({key: identityKey, moments: typeof update === 'function'\n ? update(previous.key === identityKey ? previous.moments : new Set()) : update}));\n }, [identityKey]);\n\n // Helper: persist to localStorage\n const persistToStorage = useCallback((moments: Set<string>) => {\n try {\n if (userStorageKey) localStorage.setItem(userStorageKey, JSON.stringify([...moments].filter(id => !isOrganizationMoment(id))));\n if (organizationStorageKey) localStorage.setItem(organizationStorageKey, JSON.stringify([...moments].filter(isOrganizationMoment)));\n } catch {\n / quota exceeded — best effort /\n }\n }, [userStorageKey, organizationStorageKey, isOrganizationMoment]);\n\n // Load from localStorage on mount + fetch from backend if backendSync\n useEffect(() => {\n setAchievedMoments(new Set());\n if (!analyticsConfig?.enabled \|\| !identity \|\| (!identity.userId && !identity.organizationId)) return;\n\n // Load from localStorage\n try {\n const loaded = new Set<string>();\n for (const [key, organization] of [[userStorageKey, false], [organizationStorageKey, true]] as const) {\n if (!key) continue;\n const stored = localStorage.getItem(key);\n if (stored) for (const id of JSON.parse(stored) as string[]) {\n if (isPersistentMoment(id) && isOrganizationMoment(id) === organization) loaded.add(id);\n }\n }\n setAchievedMoments(loaded);\n } catch {\n / corrupt storage — start fresh /\n }\n\n // Fetch from backend if backendSync enabled AND this consumer can reach the route (#1069, the\n // #268 rule): achieved moments are read from the progression store, which a consumer whose\n // registry excludes it does not serve. localStorage still loads above.\n if (analyticsConfig?.persistence?.backendSync && momentsReachable) {\n let aborted = false;\n getManualCallsHttpClient()\n .getAnalyticsMomentsAchieved()\n .then((response: unknown) => {\n if (aborted \|\| currentIdentityKey.current !== identityKey) return;\n const res = response as { moments?: string[] };\n if (res.moments) {\n setAchievedMoments(prev => {\n const merged = new Set([...prev, ...res.moments!].filter(isPersistentMoment));\n persistToStorage(merged);\n return merged;\n });\n }\n })\n .catch(() => {\n / Backend unavailable — use localStorage only */\n });\n\n return () => { aborted = true; };\n }\n }, [analyticsConfig?.enabled, analyticsConfig?.persistence?.backendSync, momentsReachable, storageKey, identityKey, persistToStorage, isPersistentMoment, isOrganizationMoment]);\n\n // Subscribe to ANALYTICS_MOMENT_ACHIEVED events (backend-pushed via WS)\n useEffect(() => {\n return on(FrontendEvents.ANALYTICS_MOMENT_ACHIEVED, (payload) => {\n if (!identity \|\| payload.triggerSource === AnalyticsTriggerSource.FRONTEND \|\| payload.role === ValueMomentRole.ANTI_PATTERN \|\| !isPersistentMoment(payload.momentIdentifier)) return;\n setAchievedMoments(prev => {\n const next = new Set(prev);\n next.add(payload.momentIdentifier);\n persistToStorage(next);\n return next;\n });\n });\n }, [on, persistToStorage, identityKey, isPersistentMoment]);\n\n const markMomentAchieved = useCallback((identifier: string): boolean \| Promise<boolean> => {\n if (!identity \|\| !isPersistentMoment(identifier)) return false;\n const definition = analyticsConfig?.valueMoments?.find(moment => moment.identifier === identifier);\n if (definition?.requires?.some(id => !achievedMoments.has(id)) \|\| definition?.beforeStage?.some(id => achievedMoments.has(id))) return false;\n const record = (): boolean => {\n if (currentIdentityKey.current !== identityKey) return false;\n setAchievedMoments(prev => {\n const next = new Set(prev); next.add(identifier); persistToStorage(next); return next;\n });\n return true;\n };\n if (!analyticsConfig?.persistence?.backendSync) return record();\n // A refused report is not an achievement. Network failures retain the documented best-effort\n // local behavior; explicit server refusals must never be merged back as local truth.\n return getManualCallsHttpClient().postAnalyticsMomentsAchieved({ momentIdentifier: identifier, scope: definition?.scope })\n .then(result => result.success === false ? false : record())\n .catch((error: unknown) => {\n const response = error as {httpStatus?: number; response?: {status?: number}};\n const status = response?.httpStatus ?? response?.response?.status;\n return status && status >= 400 && status < 500 ? false : record();\n });\n }, [analyticsConfig, persistToStorage, identityKey, isPersistentMoment, achievedMoments]);\n\n // ─── Track interceptor ref ────────────────────────────────────\n\n const onTrackRef = useRef<((name: string, properties?: Record<string, unknown>) => void) \| null>(null);\n\n const track = useCallback((name: string, properties?: Record<string, unknown>) => {\n if (!isActive) return;\n const event: AnalyticsEvent = { name, properties, timestamp: Date.now() };\n providersRef.current.forEach(p => p.track(event));\n // Forward to bridge interceptor for CUSTOM_EVENT / FEATURE_ACCESS signal evaluation\n onTrackRef.current?.(name, properties);\n }, [isActive]);\n\n const page = useCallback((path: string, properties?: Record<string, unknown>) => {\n if (!isActive) return;\n providersRef.current.forEach(p => p.page(path, properties));\n }, [isActive]);\n\n // ─── Render ───────────────────────────────────────────────────\n\n const contextValue = useMemo<AnalyticsContextValue>(() => ({\n track,\n page,\n isActive,\n sessionStartTimestamp,\n achievedMoments,\n markMomentAchieved,\n _onTrackRef: onTrackRef,\n }), [track, page, isActive, sessionStartTimestamp, achievedMoments, markMomentAchieved]);\n\n return (\n <AnalyticsIdentityPublisherContext.Provider value={publishIdentity}>\n <AnalyticsContext.Provider value={contextValue}>\n {isActive && identity && analyticsConfig && (\n <AnalyticsEventBridge\n key={`${identityKey}:${JSON.stringify(analyticsConfig.valueMoments)}`}\n identity={identity}\n progress={momentProgress.current}\n config={analyticsConfig.autoInstrumentation}\n valueMoments={analyticsConfig.valueMoments} \n />\n )}\n {children}\n </AnalyticsContext.Provider>\n </AnalyticsIdentityPublisherContext.Provider>\n );\n};\n"]}

package/dist/esm/core/monitoring/analytics/AnalyticsEventBridge.d.ts CHANGED Viewed

@@ -8,7 +8,16 @@
  */
 import React from 'react';
 import { type AnalyticsConfig, type ValueMoment } from '@wildo-ai/saas-models';
+import type { AnalyticsIdentity } from './AnalyticsContext';
+export interface AnalyticsMomentProgress {
+    signals: Map<string, Set<number>>;
+    counts: Map<string, number>;
+    lastFired: Map<string, number>;
+    completed: Set<string>;
+}
 interface AnalyticsEventBridgeProps {
+    identity: AnalyticsIdentity;
+    progress: AnalyticsMomentProgress;
     config?: AnalyticsConfig['autoInstrumentation'];
     valueMoments?: ValueMoment[];
 }

package/dist/esm/core/monitoring/analytics/AnalyticsEventBridge.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AnalyticsEventBridge.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/core/monitoring/analytics/AnalyticsEventBridge.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAkD,MAAM,OAAO,CAAC;AACvE,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,~~EAajB~~,MAAM,uBAAuB,CAAC;~~AAQ~~/B,UAAU,yBAAyB;IACjC,MAAM,CAAC,EAAE,eAAe,CAAC,qBAAqB,CAAC,CAAC;IAChD,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC9B;AAID,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,~~CAmcpE~~,CAAC"}
1	+ {"version":3,"file":"AnalyticsEventBridge.d.ts","sourceRoot":"","sources":["../../../../../../src/core/monitoring/analytics/AnalyticsEventBridge.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAkD,MAAM,OAAO,CAAC;AACvE,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,EAYjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAQ5D,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACxB;AACD,UAAU,yBAAyB;IACjC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,uBAAuB,CAAC;IAClC,MAAM,CAAC,EAAE,eAAe,CAAC,qBAAqB,CAAC,CAAC;IAChD,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC9B;AAID,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAubpE,CAAC"}