@the-portland-company/shell 0.7.0 → 0.8.0

package/dist/index.d.cts

@@ -78,6 +78,18 @@ interface ShellUser {
 }
 /** Status of the auth session lifecycle. */
 type ShellAuthStatus = 'loading' | 'authenticated' | 'unauthenticated';
+/**
+ * Host-app-driven auth for apps that do not authenticate through Supabase
+ * (e.g., OIDC apps like Contacts). When passed to ShellProvider it takes
+ * precedence over `supabaseClient` session tracking. The host app is
+ * responsible for building a Supabase-shaped `user.raw` (id/email/
+ * user_metadata.full_name) so chrome components render identically.
+ */
+interface ShellInjectedAuth {
+    status: ShellAuthStatus;
+    user: ShellUser | null;
+    signOut: () => void | Promise<void>;
+}
 /**
  * One entry in the shell's app-switcher sidebar. The shell uses this list to
  * render navigation links between sub-apps and to drive Speculation Rules
@@ -261,8 +273,11 @@ interface ShellProviderProps {
     children: ReactNode;
     /** Stable ID of the current app, e.g., 'crm'. */
     currentApp: string;
-    /** Authenticated Supabase client owned by the host app. */
-    supabaseClient: SupabaseClient;
+    /** Authenticated Supabase client owned by the host app. Optional since
+     *  0.8.0 — apps that authenticate elsewhere pass `auth` instead. */
+    supabaseClient?: SupabaseClient;
+    /** Host-driven auth (takes precedence over supabaseClient). Since 0.8.0. */
+    auth?: ShellInjectedAuth;
     /** App registry for the sidebar. If omitted, uses the default registry shipped with the shell. */
     appRegistry?: AppRegistryEntry[];
     /** Optional override for the base path if the app is mounted under a sub-path (e.g., '/contacts'). */
@@ -378,7 +393,7 @@ interface ShellChromeValue {
     userAvatarUrl?: string;
 }
 declare const ShellChromeContext: react.Context<ShellChromeValue | null>;
-declare function ShellProvider({ children, supabaseClient, currentApp, appRegistry, basename, organization, linkedAccounts, support, devNotesMenu, myProfileHref, userAvatarUrl, }: ShellProviderProps): react_jsx_runtime.JSX.Element;
+declare function ShellProvider({ children, supabaseClient, auth, currentApp, appRegistry, basename, organization, linkedAccounts, support, devNotesMenu, myProfileHref, userAvatarUrl, }: ShellProviderProps): react_jsx_runtime.JSX.Element;
 
 declare function useShellAuth(): ShellAuthValue;
 
@@ -805,4 +820,4 @@ declare function registerShellPrecache(opts?: RegisterShellPrecacheOptions): Pro
  */
 declare function buildSpeculationRules(currentApp: string, registry: AppRegistryEntry[]): string | null;
 
-export { AppLayout, type AppRegistryEntry, BrandIcon, BrandLogo, BreadcrumbBar, Card, CommitCopyButton, type CommitCopyButtonProps, Footer, GlobalUiIdProvider, Header, HeaderTabBar, type HeaderTabBarItem, ModePill, NavItem, OrgPill, OrgPill as OrgSelector, PageContainer, PageHeader, type ShellActiveRoleConfig, type ShellAuthStatus, type ShellAuthValue, ShellChrome, ShellChromeContext, type ShellChromeProps, type ShellChromeValue, ShellFooterContext, type ShellFooterLink, type ShellFooterValue, type ShellLinkedAccount, ShellLinkedAccountsContext, type ShellLinkedAccountsValue, type ShellModeConfig, ShellModeContext, type ShellModeValue, type ShellNavItem, ShellNavItemsContext, type ShellNavItemsValue, ShellNavigationPreferenceContext, type ShellNavigationPreferenceValue, ShellOrgContext, type ShellOrganization, type ShellOrganizationValue, ShellProvider, type ShellProviderProps, ShellRoleContext, type ShellRoleValue, type ShellSlots, type ShellSupportContext, ShellSupportProviderContext, type ShellSupportValue, type ShellUser, Sidebar, SupportRequestButton, UserMenu, buildSpeculationRules, getOrganizationBadgeLetters, getOrganizationBrandColor, getUserDisplayName, hexToRgba, lightenHexColor, normalizeHexColor, politogyTheme, registerShellPrecache, useAppRegistry, useCurrentApp, useShellAuth, useShellChrome, useShellFooter, useShellLinkedAccounts, useShellMode, useShellNavItems, useShellNavigationPreference, useShellOrganization, useShellRole, useShellSupport };
+export { AppLayout, type AppRegistryEntry, BrandIcon, BrandLogo, BreadcrumbBar, Card, CommitCopyButton, type CommitCopyButtonProps, Footer, GlobalUiIdProvider, Header, HeaderTabBar, type HeaderTabBarItem, ModePill, NavItem, OrgPill, OrgPill as OrgSelector, PageContainer, PageHeader, type ShellActiveRoleConfig, type ShellAuthStatus, type ShellAuthValue, ShellChrome, ShellChromeContext, type ShellChromeProps, type ShellChromeValue, ShellFooterContext, type ShellFooterLink, type ShellFooterValue, type ShellInjectedAuth, type ShellLinkedAccount, ShellLinkedAccountsContext, type ShellLinkedAccountsValue, type ShellModeConfig, ShellModeContext, type ShellModeValue, type ShellNavItem, ShellNavItemsContext, type ShellNavItemsValue, ShellNavigationPreferenceContext, type ShellNavigationPreferenceValue, ShellOrgContext, type ShellOrganization, type ShellOrganizationValue, ShellProvider, type ShellProviderProps, ShellRoleContext, type ShellRoleValue, type ShellSlots, type ShellSupportContext, ShellSupportProviderContext, type ShellSupportValue, type ShellUser, Sidebar, SupportRequestButton, UserMenu, buildSpeculationRules, getOrganizationBadgeLetters, getOrganizationBrandColor, getUserDisplayName, hexToRgba, lightenHexColor, normalizeHexColor, politogyTheme, registerShellPrecache, useAppRegistry, useCurrentApp, useShellAuth, useShellChrome, useShellFooter, useShellLinkedAccounts, useShellMode, useShellNavItems, useShellNavigationPreference, useShellOrganization, useShellRole, useShellSupport };

package/dist/index.d.ts

@@ -78,6 +78,18 @@ interface ShellUser {
 }
 /** Status of the auth session lifecycle. */
 type ShellAuthStatus = 'loading' | 'authenticated' | 'unauthenticated';
+/**
+ * Host-app-driven auth for apps that do not authenticate through Supabase
+ * (e.g., OIDC apps like Contacts). When passed to ShellProvider it takes
+ * precedence over `supabaseClient` session tracking. The host app is
+ * responsible for building a Supabase-shaped `user.raw` (id/email/
+ * user_metadata.full_name) so chrome components render identically.
+ */
+interface ShellInjectedAuth {
+    status: ShellAuthStatus;
+    user: ShellUser | null;
+    signOut: () => void | Promise<void>;
+}
 /**
  * One entry in the shell's app-switcher sidebar. The shell uses this list to
  * render navigation links between sub-apps and to drive Speculation Rules
@@ -261,8 +273,11 @@ interface ShellProviderProps {
     children: ReactNode;
     /** Stable ID of the current app, e.g., 'crm'. */
     currentApp: string;
-    /** Authenticated Supabase client owned by the host app. */
-    supabaseClient: SupabaseClient;
+    /** Authenticated Supabase client owned by the host app. Optional since
+     *  0.8.0 — apps that authenticate elsewhere pass `auth` instead. */
+    supabaseClient?: SupabaseClient;
+    /** Host-driven auth (takes precedence over supabaseClient). Since 0.8.0. */
+    auth?: ShellInjectedAuth;
     /** App registry for the sidebar. If omitted, uses the default registry shipped with the shell. */
     appRegistry?: AppRegistryEntry[];
     /** Optional override for the base path if the app is mounted under a sub-path (e.g., '/contacts'). */
@@ -378,7 +393,7 @@ interface ShellChromeValue {
     userAvatarUrl?: string;
 }
 declare const ShellChromeContext: react.Context<ShellChromeValue | null>;
-declare function ShellProvider({ children, supabaseClient, currentApp, appRegistry, basename, organization, linkedAccounts, support, devNotesMenu, myProfileHref, userAvatarUrl, }: ShellProviderProps): react_jsx_runtime.JSX.Element;
+declare function ShellProvider({ children, supabaseClient, auth, currentApp, appRegistry, basename, organization, linkedAccounts, support, devNotesMenu, myProfileHref, userAvatarUrl, }: ShellProviderProps): react_jsx_runtime.JSX.Element;
 
 declare function useShellAuth(): ShellAuthValue;
 
@@ -805,4 +820,4 @@ declare function registerShellPrecache(opts?: RegisterShellPrecacheOptions): Pro
  */
 declare function buildSpeculationRules(currentApp: string, registry: AppRegistryEntry[]): string | null;
 
-export { AppLayout, type AppRegistryEntry, BrandIcon, BrandLogo, BreadcrumbBar, Card, CommitCopyButton, type CommitCopyButtonProps, Footer, GlobalUiIdProvider, Header, HeaderTabBar, type HeaderTabBarItem, ModePill, NavItem, OrgPill, OrgPill as OrgSelector, PageContainer, PageHeader, type ShellActiveRoleConfig, type ShellAuthStatus, type ShellAuthValue, ShellChrome, ShellChromeContext, type ShellChromeProps, type ShellChromeValue, ShellFooterContext, type ShellFooterLink, type ShellFooterValue, type ShellLinkedAccount, ShellLinkedAccountsContext, type ShellLinkedAccountsValue, type ShellModeConfig, ShellModeContext, type ShellModeValue, type ShellNavItem, ShellNavItemsContext, type ShellNavItemsValue, ShellNavigationPreferenceContext, type ShellNavigationPreferenceValue, ShellOrgContext, type ShellOrganization, type ShellOrganizationValue, ShellProvider, type ShellProviderProps, ShellRoleContext, type ShellRoleValue, type ShellSlots, type ShellSupportContext, ShellSupportProviderContext, type ShellSupportValue, type ShellUser, Sidebar, SupportRequestButton, UserMenu, buildSpeculationRules, getOrganizationBadgeLetters, getOrganizationBrandColor, getUserDisplayName, hexToRgba, lightenHexColor, normalizeHexColor, politogyTheme, registerShellPrecache, useAppRegistry, useCurrentApp, useShellAuth, useShellChrome, useShellFooter, useShellLinkedAccounts, useShellMode, useShellNavItems, useShellNavigationPreference, useShellOrganization, useShellRole, useShellSupport };
+export { AppLayout, type AppRegistryEntry, BrandIcon, BrandLogo, BreadcrumbBar, Card, CommitCopyButton, type CommitCopyButtonProps, Footer, GlobalUiIdProvider, Header, HeaderTabBar, type HeaderTabBarItem, ModePill, NavItem, OrgPill, OrgPill as OrgSelector, PageContainer, PageHeader, type ShellActiveRoleConfig, type ShellAuthStatus, type ShellAuthValue, ShellChrome, ShellChromeContext, type ShellChromeProps, type ShellChromeValue, ShellFooterContext, type ShellFooterLink, type ShellFooterValue, type ShellInjectedAuth, type ShellLinkedAccount, ShellLinkedAccountsContext, type ShellLinkedAccountsValue, type ShellModeConfig, ShellModeContext, type ShellModeValue, type ShellNavItem, ShellNavItemsContext, type ShellNavItemsValue, ShellNavigationPreferenceContext, type ShellNavigationPreferenceValue, ShellOrgContext, type ShellOrganization, type ShellOrganizationValue, ShellProvider, type ShellProviderProps, ShellRoleContext, type ShellRoleValue, type ShellSlots, type ShellSupportContext, ShellSupportProviderContext, type ShellSupportValue, type ShellUser, Sidebar, SupportRequestButton, UserMenu, buildSpeculationRules, getOrganizationBadgeLetters, getOrganizationBrandColor, getUserDisplayName, hexToRgba, lightenHexColor, normalizeHexColor, politogyTheme, registerShellPrecache, useAppRegistry, useCurrentApp, useShellAuth, useShellChrome, useShellFooter, useShellLinkedAccounts, useShellMode, useShellNavItems, useShellNavigationPreference, useShellOrganization, useShellRole, useShellSupport };

package/dist/index.js

@@ -1120,6 +1120,7 @@ function toShellUser(session) {
 function ShellProvider({
   children,
   supabaseClient,
+  auth,
   currentApp,
   appRegistry,
   basename,
@@ -1133,6 +1134,11 @@ function ShellProvider({
   const [status, setStatus] = useState("loading");
   const [session, setSession] = useState(null);
   useEffect(() => {
+    if (auth || !supabaseClient) {
+      setSession(null);
+      if (!auth) setStatus("unauthenticated");
+      return;
+    }
     let cancelled = false;
     supabaseClient.auth.getSession().then(({ data }) => {
       if (cancelled) return;
@@ -1147,18 +1153,27 @@ function ShellProvider({
       cancelled = true;
       sub.data.subscription.unsubscribe();
     };
-  }, [supabaseClient]);
-  const value = useMemo(
-    () => ({
+  }, [supabaseClient, auth]);
+  const value = useMemo(() => {
+    if (auth) {
+      return {
+        status: auth.status,
+        session: null,
+        user: auth.user,
+        signOut: async () => {
+          await auth.signOut();
+        }
+      };
+    }
+    return {
       status,
       session,
       user: toShellUser(session),
       signOut: async () => {
-        await supabaseClient.auth.signOut();
+        await supabaseClient?.auth.signOut();
       }
-    }),
-    [status, session, supabaseClient]
-  );
+    };
+  }, [auth, status, session, supabaseClient]);
   const meta = useMemo(
     () => ({
       currentApp,