@wasto/cms-components 1.5.10 → 1.5.12

package/src/index.ts

@@ -1,142 +1,161 @@
-export {
-    Article,
-    type ArticleProps,
-    type ArticleDisplayMode
-} from "./components/article/Article"
-export {
-    Challenge,
-    type ChallengeProps
-} from "./components/challenge/Challenge"
-export {
-    ChallengeVignette,
-    type ChallengeVignetteProps
-} from "./components/challenge/ChallengeVignette"
-export {
-    Chat,
-    type ChatProps
-} from "./components/chat/Chat"
-export {
-    CollectionCalendar,
-    type CollectionCalendarProps
-} from "./components/collection-calendar/CollectionCalendar"
-export {
-    Columns,
-    type ColumnsProps,
-    type ColumnsColumnCount
-} from "./components/columns/Columns"
-export {
-    Image,
-    ImageProps,
-} from "./components/image/Image"
-export {
-    LocationsMap,
-    type LocationsMapProps
-} from "./components/locations-map/LocationsMap"
-export {
-    NextCollection,
-    type NextCollectionProps
-} from "./components/next-collection/NextCollection"
-export {
-    Page,
-    type PageProps
-} from "./components/page/Page"
-export {
-    ContentInset,
-    type ContentInsetProps
-} from "./components/content-inset/ContentInset"
-export {
-    Paragraph,
-    type PararaphProps
-} from "./components/parapraph/Paragraph"
-export {
-    RecyclingInfo,
-    type RecyclingInfoProps
-} from "./components/recycling-info/RecyclingInfo"
-export {
-    Search,
-    type SearchProps
-} from "./components/search/Search"
-export {
-    Title,
-    type TitleProps,
-    type TitleLevel
-} from "./components/title/Title"
-export {
-    Header,
-    type HeaderProps,
-    type AppHeaderConfig,
-    type AppHeaderElement,
-    type AppHeaderLogoElement,
-    type AppHeaderTitleElement,
-    type AppHeaderActionElement,
-    type AppHeaderSlot,
-} from "./components/header/Header"
-export {
-    BottomTab,
-    type BottomTabProps
-} from "./components/bottom-tab/BottomTab"
-export {
-    NotificationsScreen,
-} from "./components/notifications/NotificationsScreen"
-export {
-    ProfileScreen,
-} from "./components/profile/ProfileScreen"
-export {
-    Vision,
-    type VisionProps,
-    type VisionCaptureResult,
-} from "./components/vision/Vision"
-export {
-    type VisionSuggestion,
-    type VisionActionCardProps,
-} from "./components/vision/VisionActionCard"
-
-export {
-    WastoProvider,
-    useWasto,
-    type WastoProviderProps,
-    type WastoContextType,
-} from "./contexts/WastoContext"
-
-export {
-    initWastoSentry,
-    wrapWithSentry,
-    reportError,
-    isWastoSentryActive,
-    type WastoSentryConfig,
-    type WastoErrorContext,
-} from "./sentry/initSentry"
-
-export { useWastoClient } from "./hooks/useWastoClient"
-
-export type {
-    Theme,
-    ResolvedTheme,
-    ThemeShadowStyle,
-} from "./types/Theme"
-
-export {
-    resolveTheme,
-    cardStyle,
-    softCardStyle,
-    groupedSectionStyle,
-    coloredShadow,
-} from "./helpers/themeStyles"
-
-export {
-    SPACE,
-    MAQUETTE_RADII,
-    MAQUETTE_COLORS,
-} from "./helpers/layout"
-
-export { SYSTEM_ROUTES, type SystemRouteKey } from "./helpers/systemRoutes"
-
-export { createMaquetteTheme } from "./helpers/maquetteTheme"
-
-export {
-    NavigationProvider,
-    useAppNavigation,
-    useOptionalAppNavigation,
-    type NavigationApi,
-    type NavigationProviderProps,
-} from "./navigation/NavigationContext"
+export {
+    Article,
+    type ArticleProps,
+    type ArticleDisplayMode
+} from "./components/article/Article"
+export {
+    Challenge,
+    type ChallengeProps
+} from "./components/challenge/Challenge"
+export {
+    ChallengeVignette,
+    type ChallengeVignetteProps
+} from "./components/challenge/ChallengeVignette"
+export {
+    Chat,
+    type ChatProps
+} from "./components/chat/Chat"
+export {
+    CollectionCalendar,
+    type CollectionCalendarProps
+} from "./components/collection-calendar/CollectionCalendar"
+export {
+    Columns,
+    type ColumnsProps,
+    type ColumnsColumnCount
+} from "./components/columns/Columns"
+export {
+    Image,
+    ImageProps,
+} from "./components/image/Image"
+export {
+    LocationsMap,
+    type LocationsMapProps
+} from "./components/locations-map/LocationsMap"
+export {
+    NextCollection,
+    type NextCollectionProps
+} from "./components/next-collection/NextCollection"
+export {
+    Page,
+    type PageProps
+} from "./components/page/Page"
+export {
+    ContentInset,
+    type ContentInsetProps
+} from "./components/content-inset/ContentInset"
+export {
+    Paragraph,
+    type PararaphProps
+} from "./components/parapraph/Paragraph"
+export {
+    RecyclingInfo,
+    type RecyclingInfoProps
+} from "./components/recycling-info/RecyclingInfo"
+export {
+    Search,
+    type SearchProps
+} from "./components/search/Search"
+export {
+    Title,
+    type TitleProps,
+    type TitleLevel
+} from "./components/title/Title"
+export {
+    Header,
+    DEFAULT_HEADER_ACTIONS,
+    type HeaderProps,
+    type AppHeaderConfig,
+    type AppHeaderElement,
+    type AppHeaderLogoElement,
+    type AppHeaderTitleElement,
+    type AppHeaderActionElement,
+    type AppHeaderSlot,
+} from "./components/header/Header"
+export {
+    BottomTab,
+    type BottomTabProps
+} from "./components/bottom-tab/BottomTab"
+export {
+    NotificationsScreen,
+} from "./components/notifications/NotificationsScreen"
+export {
+    ProfileScreen,
+} from "./components/profile/ProfileScreen"
+export {
+    Vision,
+    type VisionProps,
+    type VisionCaptureResult,
+} from "./components/vision/Vision"
+export {
+    type VisionSuggestion,
+    type VisionActionCardProps,
+} from "./components/vision/VisionActionCard"
+
+export {
+    WastoProvider,
+    useWasto,
+    type WastoProviderProps,
+    type WastoContextType,
+} from "./contexts/WastoContext"
+
+export {
+    HeaderConfigProvider,
+    useHeaderConfig,
+    type HeaderConfigProviderProps,
+} from "./contexts/HeaderConfigContext"
+
+export {
+    useAppData,
+    useOptionalAppData,
+    NEXT_EVENTS_DAY_RADIUS,
+    type AppDataContextType,
+} from "./contexts/AppDataContext"
+
+export {
+    initWastoSentry,
+    wrapWithSentry,
+    reportError,
+    isWastoSentryActive,
+    type WastoSentryConfig,
+    type WastoErrorContext,
+} from "./sentry/initSentry"
+
+export {
+    registerExpoPushToken,
+    type RegisterExpoPushTokenOptions,
+} from "./push/registerExpoPushToken"
+
+export { useWastoClient } from "./hooks/useWastoClient"
+
+export type {
+    Theme,
+    ResolvedTheme,
+    ThemeShadowStyle,
+} from "./types/Theme"
+
+export {
+    resolveTheme,
+    cardStyle,
+    softCardStyle,
+    groupedSectionStyle,
+    coloredShadow,
+} from "./helpers/themeStyles"
+
+export {
+    SPACE,
+    MAQUETTE_RADII,
+    MAQUETTE_COLORS,
+} from "./helpers/layout"
+
+export { SYSTEM_ROUTES, type SystemRouteKey } from "./helpers/systemRoutes"
+
+export { createMaquetteTheme } from "./helpers/maquetteTheme"
+
+export {
+    NavigationProvider,
+    useAppNavigation,
+    useOptionalAppNavigation,
+    type NavigationApi,
+    type NavigationProviderProps,
+} from "./navigation/NavigationContext"

package/src/navigation/NavigationContext.tsx

@@ -1,56 +1,56 @@
-import {
-    createContext,
-    useContext,
-    useMemo,
-    type PropsWithChildren,
-    type ReactNode,
-} from "react";
-
-/**
- * Host-agnostic navigation API.
- * Expo Router apps pass `router.push` / `router.back`;
- * React Navigation apps pass `navigation.navigate` / `goBack`.
- */
-export type NavigationApi = {
-    push: (href: string) => void;
-    canGoBack?: () => boolean;
-    goBack?: () => void;
-};
-
-const NavigationContext = createContext<NavigationApi | null>(null);
-
-export type NavigationProviderProps = PropsWithChildren & {
-    value: NavigationApi;
-};
-
-export function NavigationProvider({ value, children }: NavigationProviderProps): ReactNode {
-    const memo = useMemo(
-        () => ({
-            push: value.push,
-            canGoBack: value.canGoBack,
-            goBack: value.goBack,
-        }),
-        [value.push, value.canGoBack, value.goBack],
-    );
-
-    return (
-        <NavigationContext.Provider value={memo}>
-            {children}
-        </NavigationContext.Provider>
-    );
-}
-
-export function useAppNavigation(): NavigationApi {
-    const nav = useContext(NavigationContext);
-    if (!nav) {
-        throw new Error(
-            "[cms-components] NavigationProvider is required (wrap the app root).",
-        );
-    }
-    return nav;
-}
-
-/** Soft read — returns null when no provider (e.g. isolated component tests). */
-export function useOptionalAppNavigation(): NavigationApi | null {
-    return useContext(NavigationContext);
-}
+import {
+    createContext,
+    useContext,
+    useMemo,
+    type PropsWithChildren,
+    type ReactNode,
+} from "react";
+
+/**
+ * Host-agnostic navigation API.
+ * Expo Router apps pass `router.push` / `router.back`;
+ * React Navigation apps pass `navigation.navigate` / `goBack`.
+ */
+export type NavigationApi = {
+    push: (href: string) => void;
+    canGoBack?: () => boolean;
+    goBack?: () => void;
+};
+
+const NavigationContext = createContext<NavigationApi | null>(null);
+
+export type NavigationProviderProps = PropsWithChildren & {
+    value: NavigationApi;
+};
+
+export function NavigationProvider({ value, children }: NavigationProviderProps): ReactNode {
+    const memo = useMemo(
+        () => ({
+            push: value.push,
+            canGoBack: value.canGoBack,
+            goBack: value.goBack,
+        }),
+        [value.push, value.canGoBack, value.goBack],
+    );
+
+    return (
+        <NavigationContext.Provider value={memo}>
+            {children}
+        </NavigationContext.Provider>
+    );
+}
+
+export function useAppNavigation(): NavigationApi {
+    const nav = useContext(NavigationContext);
+    if (!nav) {
+        throw new Error(
+            "[cms-components] NavigationProvider is required (wrap the app root).",
+        );
+    }
+    return nav;
+}
+
+/** Soft read — returns null when no provider (e.g. isolated component tests). */
+export function useOptionalAppNavigation(): NavigationApi | null {
+    return useContext(NavigationContext);
+}

package/src/push/registerExpoPushToken.ts

@@ -0,0 +1,133 @@
+import { Platform } from "react-native";
+
+type NotificationsModule = typeof import("expo-notifications");
+
+type ExpoConstantsLike = {
+    expoConfig?: {
+        extra?: {
+            eas?: {
+                projectId?: string;
+            };
+        };
+    } | null;
+    easConfig?: {
+        projectId?: string;
+    };
+};
+
+let notificationsModule: NotificationsModule | null | undefined;
+let constantsModule: ExpoConstantsLike | null | undefined;
+let handlerConfigured = false;
+
+function loadNotifications(): NotificationsModule | null {
+    if (notificationsModule !== undefined) return notificationsModule;
+    try {
+        // Optional peer — apps without the package still load cms-components.
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        notificationsModule = require("expo-notifications") as NotificationsModule;
+    } catch {
+        notificationsModule = null;
+    }
+    return notificationsModule;
+}
+
+function loadConstants(): ExpoConstantsLike | null {
+    if (constantsModule !== undefined) return constantsModule;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const mod = require("expo-constants") as
+            | ExpoConstantsLike
+            | { default: ExpoConstantsLike };
+        constantsModule = "default" in mod && mod.default ? mod.default : (mod as ExpoConstantsLike);
+    } catch {
+        constantsModule = null;
+    }
+    return constantsModule;
+}
+
+function resolveEasProjectId(): string | null {
+    const Constants = loadConstants();
+    const fromExtra = Constants?.expoConfig?.extra?.eas?.projectId;
+    const fromEasConfig = Constants?.easConfig?.projectId;
+    const fromEnv =
+        typeof process !== "undefined"
+            ? String(process.env.EXPO_PUBLIC_EAS_PROJECT_ID ?? "").trim()
+            : "";
+    const projectId = String(fromExtra || fromEasConfig || fromEnv || "").trim();
+    return projectId || null;
+}
+
+export type RegisterExpoPushTokenOptions = {
+    deviceId: string;
+    registerPushToken: (deviceId: string, token: string) => Promise<unknown>;
+};
+
+/**
+ * Request OS permission, fetch Expo push token, register it on the API.
+ * No-op on web, preview, missing peer, missing EAS projectId, or denied permission.
+ */
+export async function registerExpoPushToken(
+    options: RegisterExpoPushTokenOptions,
+): Promise<string | null> {
+    if (Platform.OS === "web") return null;
+
+    const deviceId = options.deviceId?.trim();
+    if (!deviceId) return null;
+
+    const Notifications = loadNotifications();
+    if (!Notifications) {
+        if (__DEV__) {
+            console.warn(
+                "[wasto] expo-notifications is not installed; push registration skipped",
+            );
+        }
+        return null;
+    }
+
+    const projectId = resolveEasProjectId();
+    if (!projectId) {
+        if (__DEV__) {
+            console.warn(
+                "[wasto] EAS projectId missing (extra.eas.projectId or EXPO_PUBLIC_EAS_PROJECT_ID); push registration skipped",
+            );
+        }
+        return null;
+    }
+
+    if (!handlerConfigured) {
+        Notifications.setNotificationHandler({
+            handleNotification: async () => ({
+                shouldShowAlert: true,
+                shouldPlaySound: true,
+                shouldSetBadge: false,
+                shouldShowBanner: true,
+                shouldShowList: true,
+            }),
+        });
+        handlerConfigured = true;
+    }
+
+    if (Platform.OS === "android") {
+        await Notifications.setNotificationChannelAsync("default", {
+            name: "default",
+            importance: Notifications.AndroidImportance.MAX,
+            vibrationPattern: [0, 250, 250, 250],
+            lightColor: "#FF231F7C",
+        });
+    }
+
+    const { status: existingStatus } = await Notifications.getPermissionsAsync();
+    let finalStatus = existingStatus;
+    if (existingStatus !== "granted") {
+        const { status } = await Notifications.requestPermissionsAsync();
+        finalStatus = status;
+    }
+    if (finalStatus !== "granted") return null;
+
+    const push = await Notifications.getExpoPushTokenAsync({ projectId });
+    const token = push?.data?.trim();
+    if (!token) return null;
+
+    await options.registerPushToken(deviceId, token);
+    return token;
+}