@growsober/sdk 1.0.5 → 1.0.6

package/dist/api/queries/events.d.ts

@@ -97,6 +97,8 @@ export declare function useEvent(id: string, options?: Omit<UseQueryOptions<Even
     isCancelled: boolean;
     isAmbient: boolean;
     ambientCategory?: Record<string, never>;
+    vibe?: "CHILL" | "ACTIVE" | "SOCIAL" | "CREATIVE" | "DEEP_TALK" | "ADVENTURE";
+    city?: import("@growsober/types/dist/generated").components["schemas"]["EventCityDto"];
     bookingCount: number;
     checkinCount: number;
     createdAt: string;
@@ -147,6 +149,8 @@ export declare function useEventBySlug(slug: string, options?: Omit<UseQueryOpti
     isCancelled: boolean;
     isAmbient: boolean;
     ambientCategory?: Record<string, never>;
+    vibe?: "CHILL" | "ACTIVE" | "SOCIAL" | "CREATIVE" | "DEEP_TALK" | "ADVENTURE";
+    city?: import("@growsober/types/dist/generated").components["schemas"]["EventCityDto"];
     bookingCount: number;
     checkinCount: number;
     createdAt: string;
@@ -197,6 +201,8 @@ export declare function useUpcomingEvents(limit?: number, options?: Omit<UseQuer
     isCancelled: boolean;
     isAmbient: boolean;
     ambientCategory?: Record<string, never>;
+    vibe?: "CHILL" | "ACTIVE" | "SOCIAL" | "CREATIVE" | "DEEP_TALK" | "ADVENTURE";
+    city?: import("@growsober/types/dist/generated").components["schemas"]["EventCityDto"];
     bookingCount: number;
     checkinCount: number;
     createdAt: string;
@@ -249,6 +255,8 @@ export declare function useFeaturedEvents(limit?: number, options?: Omit<UseQuer
     isCancelled: boolean;
     isAmbient: boolean;
     ambientCategory?: Record<string, never>;
+    vibe?: "CHILL" | "ACTIVE" | "SOCIAL" | "CREATIVE" | "DEEP_TALK" | "ADVENTURE";
+    city?: import("@growsober/types/dist/generated").components["schemas"]["EventCityDto"];
     bookingCount: number;
     checkinCount: number;
     createdAt: string;
@@ -299,6 +307,8 @@ export declare function useAmbientEvents(filters?: AmbientEventFilters, options?
     isCancelled: boolean;
     isAmbient: boolean;
     ambientCategory?: Record<string, never>;
+    vibe?: "CHILL" | "ACTIVE" | "SOCIAL" | "CREATIVE" | "DEEP_TALK" | "ADVENTURE";
+    city?: import("@growsober/types/dist/generated").components["schemas"]["EventCityDto"];
     bookingCount: number;
     checkinCount: number;
     createdAt: string;

package/dist/api/utils/eventGrouping.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Event Grouping Utilities
+ *
+ * Utilities for organizing events by time of day.
+ * Used in the Gatherings screen to show events grouped by
+ * Morning, Afternoon, and Evening.
+ *
+ * @module api/utils/eventGrouping
+ */
+import { EventResponse } from '../types';
+export type TimeOfDay = 'MORNING' | 'AFTERNOON' | 'EVENING';
+export interface GroupedEvents {
+    morning: EventResponse[];
+    afternoon: EventResponse[];
+    evening: EventResponse[];
+}
+export interface TimeOfDayInfo {
+    key: TimeOfDay;
+    label: string;
+    emoji: string;
+    hours: {
+        start: number;
+        end: number;
+    };
+}
+export declare const TIME_OF_DAY_CONFIG: Record<TimeOfDay, TimeOfDayInfo>;
+/**
+ * Get time of day for a given date
+ *
+ * @param date - Date string or Date object
+ * @returns TimeOfDay - MORNING, AFTERNOON, or EVENING
+ *
+ * @example
+ * ```tsx
+ * const timeOfDay = getTimeOfDay('2024-03-15T10:00:00Z');
+ * console.log(timeOfDay); // 'MORNING'
+ * ```
+ */
+export declare function getTimeOfDay(date: Date | string): TimeOfDay;
+/**
+ * Get label for time of day
+ *
+ * @param timeOfDay - TimeOfDay enum value
+ * @returns Human-readable label
+ *
+ * @example
+ * ```tsx
+ * const label = getTimeOfDayLabel('MORNING');
+ * console.log(label); // 'Morning'
+ * ```
+ */
+export declare function getTimeOfDayLabel(timeOfDay: TimeOfDay): string;
+/**
+ * Group events by time of day
+ *
+ * @param events - Array of events to group
+ * @returns GroupedEvents object with morning, afternoon, and evening arrays
+ *
+ * @example
+ * ```tsx
+ * import { useUpcomingEvents, groupEventsByTimeOfDay } from '@growsober/sdk';
+ *
+ * function GatheringsList() {
+ *   const { data: events } = useUpcomingEvents(30);
+ *   const grouped = useMemo(() => {
+ *     if (!events) return null;
+ *     return groupEventsByTimeOfDay(events);
+ *   }, [events]);
+ *
+ *   return (
+ *     <SectionList
+ *       sections={[
+ *         { title: 'Morning', data: grouped?.morning || [] },
+ *         { title: 'Afternoon', data: grouped?.afternoon || [] },
+ *         { title: 'Evening', data: grouped?.evening || [] },
+ *       ]}
+ *       ...
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export declare function groupEventsByTimeOfDay(events: EventResponse[]): GroupedEvents;
+/**
+ * Convert grouped events to section list data format
+ *
+ * @param events - Array of events to group
+ * @returns Array of sections with title and data
+ *
+ * @example
+ * ```tsx
+ * const sections = getEventSections(events);
+ * // [
+ * //   { title: 'Morning', data: [...] },
+ * //   { title: 'Afternoon', data: [...] },
+ * //   { title: 'Evening', data: [...] },
+ * // ]
+ * ```
+ */
+export declare function getEventSections(events: EventResponse[]): Array<{
+    title: string;
+    timeOfDay: TimeOfDay;
+    data: EventResponse[];
+}>;

package/dist/api/utils/eventGrouping.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * Event Grouping Utilities
+ *
+ * Utilities for organizing events by time of day.
+ * Used in the Gatherings screen to show events grouped by
+ * Morning, Afternoon, and Evening.
+ *
+ * @module api/utils/eventGrouping
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIME_OF_DAY_CONFIG = void 0;
+exports.getTimeOfDay = getTimeOfDay;
+exports.getTimeOfDayLabel = getTimeOfDayLabel;
+exports.groupEventsByTimeOfDay = groupEventsByTimeOfDay;
+exports.getEventSections = getEventSections;
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+exports.TIME_OF_DAY_CONFIG = {
+    MORNING: {
+        key: 'MORNING',
+        label: 'Morning',
+        emoji: '',
+        hours: { start: 5, end: 11 }, // 5:00 AM - 11:59 AM
+    },
+    AFTERNOON: {
+        key: 'AFTERNOON',
+        label: 'Afternoon',
+        emoji: '',
+        hours: { start: 12, end: 16 }, // 12:00 PM - 4:59 PM
+    },
+    EVENING: {
+        key: 'EVENING',
+        label: 'Evening',
+        emoji: '',
+        hours: { start: 17, end: 4 }, // 5:00 PM - 4:59 AM (next day)
+    },
+};
+// ============================================================================
+// FUNCTIONS
+// ============================================================================
+/**
+ * Get time of day for a given date
+ *
+ * @param date - Date string or Date object
+ * @returns TimeOfDay - MORNING, AFTERNOON, or EVENING
+ *
+ * @example
+ * ```tsx
+ * const timeOfDay = getTimeOfDay('2024-03-15T10:00:00Z');
+ * console.log(timeOfDay); // 'MORNING'
+ * ```
+ */
+function getTimeOfDay(date) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    const hour = d.getHours();
+    if (hour >= 5 && hour < 12)
+        return 'MORNING';
+    if (hour >= 12 && hour < 17)
+        return 'AFTERNOON';
+    return 'EVENING';
+}
+/**
+ * Get label for time of day
+ *
+ * @param timeOfDay - TimeOfDay enum value
+ * @returns Human-readable label
+ *
+ * @example
+ * ```tsx
+ * const label = getTimeOfDayLabel('MORNING');
+ * console.log(label); // 'Morning'
+ * ```
+ */
+function getTimeOfDayLabel(timeOfDay) {
+    return exports.TIME_OF_DAY_CONFIG[timeOfDay].label;
+}
+/**
+ * Group events by time of day
+ *
+ * @param events - Array of events to group
+ * @returns GroupedEvents object with morning, afternoon, and evening arrays
+ *
+ * @example
+ * ```tsx
+ * import { useUpcomingEvents, groupEventsByTimeOfDay } from '@growsober/sdk';
+ *
+ * function GatheringsList() {
+ *   const { data: events } = useUpcomingEvents(30);
+ *   const grouped = useMemo(() => {
+ *     if (!events) return null;
+ *     return groupEventsByTimeOfDay(events);
+ *   }, [events]);
+ *
+ *   return (
+ *     <SectionList
+ *       sections={[
+ *         { title: 'Morning', data: grouped?.morning || [] },
+ *         { title: 'Afternoon', data: grouped?.afternoon || [] },
+ *         { title: 'Evening', data: grouped?.evening || [] },
+ *       ]}
+ *       ...
+ *     />
+ *   );
+ * }
+ * ```
+ */
+function groupEventsByTimeOfDay(events) {
+    const grouped = {
+        morning: [],
+        afternoon: [],
+        evening: [],
+    };
+    for (const event of events) {
+        const timeOfDay = getTimeOfDay(event.startDate);
+        switch (timeOfDay) {
+            case 'MORNING':
+                grouped.morning.push(event);
+                break;
+            case 'AFTERNOON':
+                grouped.afternoon.push(event);
+                break;
+            case 'EVENING':
+                grouped.evening.push(event);
+                break;
+        }
+    }
+    return grouped;
+}
+/**
+ * Convert grouped events to section list data format
+ *
+ * @param events - Array of events to group
+ * @returns Array of sections with title and data
+ *
+ * @example
+ * ```tsx
+ * const sections = getEventSections(events);
+ * // [
+ * //   { title: 'Morning', data: [...] },
+ * //   { title: 'Afternoon', data: [...] },
+ * //   { title: 'Evening', data: [...] },
+ * // ]
+ * ```
+ */
+function getEventSections(events) {
+    const grouped = groupEventsByTimeOfDay(events);
+    return [
+        { title: 'Morning', timeOfDay: 'MORNING', data: grouped.morning },
+        { title: 'Afternoon', timeOfDay: 'AFTERNOON', data: grouped.afternoon },
+        { title: 'Evening', timeOfDay: 'EVENING', data: grouped.evening },
+    ].filter(section => section.data.length > 0);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXZlbnRHcm91cGluZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hcGkvdXRpbHMvZXZlbnRHcm91cGluZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7O0dBUUc7OztBQWdFSCxvQ0FPQztBQWNELDhDQUVDO0FBZ0NELHdEQXVCQztBQWtCRCw0Q0FZQztBQXJKRCwrRUFBK0U7QUFDL0UsWUFBWTtBQUNaLCtFQUErRTtBQUVsRSxRQUFBLGtCQUFrQixHQUFxQztJQUNsRSxPQUFPLEVBQUU7UUFDUCxHQUFHLEVBQUUsU0FBUztRQUNkLEtBQUssRUFBRSxTQUFTO1FBQ2hCLEtBQUssRUFBRSxFQUFFO1FBQ1QsS0FBSyxFQUFFLEVBQUUsS0FBSyxFQUFFLENBQUMsRUFBRSxHQUFHLEVBQUUsRUFBRSxFQUFFLEVBQUUscUJBQXFCO0tBQ3BEO0lBQ0QsU0FBUyxFQUFFO1FBQ1QsR0FBRyxFQUFFLFdBQVc7UUFDaEIsS0FBSyxFQUFFLFdBQVc7UUFDbEIsS0FBSyxFQUFFLEVBQUU7UUFDVCxLQUFLLEVBQUUsRUFBRSxLQUFLLEVBQUUsRUFBRSxFQUFFLEdBQUcsRUFBRSxFQUFFLEVBQUUsRUFBRSxxQkFBcUI7S0FDckQ7SUFDRCxPQUFPLEVBQUU7UUFDUCxHQUFHLEVBQUUsU0FBUztRQUNkLEtBQUssRUFBRSxTQUFTO1FBQ2hCLEtBQUssRUFBRSxFQUFFO1FBQ1QsS0FBSyxFQUFFLEVBQUUsS0FBSyxFQUFFLEVBQUUsRUFBRSxHQUFHLEVBQUUsQ0FBQyxFQUFFLEVBQUUsK0JBQStCO0tBQzlEO0NBQ0YsQ0FBQztBQUVGLCtFQUErRTtBQUMvRSxZQUFZO0FBQ1osK0VBQStFO0FBRS9FOzs7Ozs7Ozs7OztHQVdHO0FBQ0gsU0FBZ0IsWUFBWSxDQUFDLElBQW1CO0lBQzlDLE1BQU0sQ0FBQyxHQUFHLE9BQU8sSUFBSSxLQUFLLFFBQVEsQ0FBQyxDQUFDLENBQUMsSUFBSSxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQztJQUMzRCxNQUFNLElBQUksR0FBRyxDQUFDLENBQUMsUUFBUSxFQUFFLENBQUM7SUFFMUIsSUFBSSxJQUFJLElBQUksQ0FBQyxJQUFJLElBQUksR0FBRyxFQUFFO1FBQUUsT0FBTyxTQUFTLENBQUM7SUFDN0MsSUFBSSxJQUFJLElBQUksRUFBRSxJQUFJLElBQUksR0FBRyxFQUFFO1FBQUUsT0FBTyxXQUFXLENBQUM7SUFDaEQsT0FBTyxTQUFTLENBQUM7QUFDbkIsQ0FBQztBQUVEOzs7Ozs7Ozs7OztHQVdHO0FBQ0gsU0FBZ0IsaUJBQWlCLENBQUMsU0FBb0I7SUFDcEQsT0FBTywwQkFBa0IsQ0FBQyxTQUFTLENBQUMsQ0FBQyxLQUFLLENBQUM7QUFDN0MsQ0FBQztBQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQTZCRztBQUNILFNBQWdCLHNCQUFzQixDQUFDLE1BQXVCO0lBQzVELE1BQU0sT0FBTyxHQUFrQjtRQUM3QixPQUFPLEVBQUUsRUFBRTtRQUNYLFNBQVMsRUFBRSxFQUFFO1FBQ2IsT0FBTyxFQUFFLEVBQUU7S0FDWixDQUFDO0lBRUYsS0FBSyxNQUFNLEtBQUssSUFBSSxNQUFNLEVBQUUsQ0FBQztRQUMzQixNQUFNLFNBQVMsR0FBRyxZQUFZLENBQUMsS0FBSyxDQUFDLFNBQVMsQ0FBQyxDQUFDO1FBQ2hELFFBQVEsU0FBUyxFQUFFLENBQUM7WUFDbEIsS0FBSyxTQUFTO2dCQUNaLE9BQU8sQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDO2dCQUM1QixNQUFNO1lBQ1IsS0FBSyxXQUFXO2dCQUNkLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDO2dCQUM5QixNQUFNO1lBQ1IsS0FBSyxTQUFTO2dCQUNaLE9BQU8sQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDO2dCQUM1QixNQUFNO1FBQ1YsQ0FBQztJQUNILENBQUM7SUFFRCxPQUFPLE9BQU8sQ0FBQztBQUNqQixDQUFDO0FBRUQ7Ozs7Ozs7Ozs7Ozs7OztHQWVHO0FBQ0gsU0FBZ0IsZ0JBQWdCLENBQUMsTUFBdUI7SUFLdEQsTUFBTSxPQUFPLEdBQUcsc0JBQXNCLENBQUMsTUFBTSxDQUFDLENBQUM7SUFFL0MsT0FBTztRQUNMLEVBQUUsS0FBSyxFQUFFLFNBQVMsRUFBRSxTQUFTLEVBQUUsU0FBc0IsRUFBRSxJQUFJLEVBQUUsT0FBTyxDQUFDLE9BQU8sRUFBRTtRQUM5RSxFQUFFLEtBQUssRUFBRSxXQUFXLEVBQUUsU0FBUyxFQUFFLFdBQXdCLEVBQUUsSUFBSSxFQUFFLE9BQU8sQ0FBQyxTQUFTLEVBQUU7UUFDcEYsRUFBRSxLQUFLLEVBQUUsU0FBUyxFQUFFLFNBQVMsRUFBRSxTQUFzQixFQUFFLElBQUksRUFBRSxPQUFPLENBQUMsT0FBTyxFQUFFO0tBQy9FLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFDLENBQUM7QUFDL0MsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogRXZlbnQgR3JvdXBpbmcgVXRpbGl0aWVzXG4gKlxuICogVXRpbGl0aWVzIGZvciBvcmdhbml6aW5nIGV2ZW50cyBieSB0aW1lIG9mIGRheS5cbiAqIFVzZWQgaW4gdGhlIEdhdGhlcmluZ3Mgc2NyZWVuIHRvIHNob3cgZXZlbnRzIGdyb3VwZWQgYnlcbiAqIE1vcm5pbmcsIEFmdGVybm9vbiwgYW5kIEV2ZW5pbmcuXG4gKlxuICogQG1vZHVsZSBhcGkvdXRpbHMvZXZlbnRHcm91cGluZ1xuICovXG5cbmltcG9ydCB7IEV2ZW50UmVzcG9uc2UgfSBmcm9tICcuLi90eXBlcyc7XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIFRZUEVTXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCB0eXBlIFRpbWVPZkRheSA9ICdNT1JOSU5HJyB8ICdBRlRFUk5PT04nIHwgJ0VWRU5JTkcnO1xuXG5leHBvcnQgaW50ZXJmYWNlIEdyb3VwZWRFdmVudHMge1xuICBtb3JuaW5nOiBFdmVudFJlc3BvbnNlW107XG4gIGFmdGVybm9vbjogRXZlbnRSZXNwb25zZVtdO1xuICBldmVuaW5nOiBFdmVudFJlc3BvbnNlW107XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgVGltZU9mRGF5SW5mbyB7XG4gIGtleTogVGltZU9mRGF5O1xuICBsYWJlbDogc3RyaW5nO1xuICBlbW9qaTogc3RyaW5nO1xuICBob3VyczogeyBzdGFydDogbnVtYmVyOyBlbmQ6IG51bWJlciB9O1xufVxuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBDT05TVEFOVFNcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0IGNvbnN0IFRJTUVfT0ZfREFZX0NPTkZJRzogUmVjb3JkPFRpbWVPZkRheSwgVGltZU9mRGF5SW5mbz4gPSB7XG4gIE1PUk5JTkc6IHtcbiAgICBrZXk6ICdNT1JOSU5HJyxcbiAgICBsYWJlbDogJ01vcm5pbmcnLFxuICAgIGVtb2ppOiAnJyxcbiAgICBob3VyczogeyBzdGFydDogNSwgZW5kOiAxMSB9LCAvLyA1OjAwIEFNIC0gMTE6NTkgQU1cbiAgfSxcbiAgQUZURVJOT09OOiB7XG4gICAga2V5OiAnQUZURVJOT09OJyxcbiAgICBsYWJlbDogJ0FmdGVybm9vbicsXG4gICAgZW1vamk6ICcnLFxuICAgIGhvdXJzOiB7IHN0YXJ0OiAxMiwgZW5kOiAxNiB9LCAvLyAxMjowMCBQTSAtIDQ6NTkgUE1cbiAgfSxcbiAgRVZFTklORzoge1xuICAgIGtleTogJ0VWRU5JTkcnLFxuICAgIGxhYmVsOiAnRXZlbmluZycsXG4gICAgZW1vamk6ICcnLFxuICAgIGhvdXJzOiB7IHN0YXJ0OiAxNywgZW5kOiA0IH0sIC8vIDU6MDAgUE0gLSA0OjU5IEFNIChuZXh0IGRheSlcbiAgfSxcbn07XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIEZVTkNUSU9OU1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG4vKipcbiAqIEdldCB0aW1lIG9mIGRheSBmb3IgYSBnaXZlbiBkYXRlXG4gKlxuICogQHBhcmFtIGRhdGUgLSBEYXRlIHN0cmluZyBvciBEYXRlIG9iamVjdFxuICogQHJldHVybnMgVGltZU9mRGF5IC0gTU9STklORywgQUZURVJOT09OLCBvciBFVkVOSU5HXG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHRzeFxuICogY29uc3QgdGltZU9mRGF5ID0gZ2V0VGltZU9mRGF5KCcyMDI0LTAzLTE1VDEwOjAwOjAwWicpO1xuICogY29uc29sZS5sb2codGltZU9mRGF5KTsgLy8gJ01PUk5JTkcnXG4gKiBgYGBcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldFRpbWVPZkRheShkYXRlOiBEYXRlIHwgc3RyaW5nKTogVGltZU9mRGF5IHtcbiAgY29uc3QgZCA9IHR5cGVvZiBkYXRlID09PSAnc3RyaW5nJyA/IG5ldyBEYXRlKGRhdGUpIDogZGF0ZTtcbiAgY29uc3QgaG91ciA9IGQuZ2V0SG91cnMoKTtcblxuICBpZiAoaG91ciA+PSA1ICYmIGhvdXIgPCAxMikgcmV0dXJuICdNT1JOSU5HJztcbiAgaWYgKGhvdXIgPj0gMTIgJiYgaG91ciA8IDE3KSByZXR1cm4gJ0FGVEVSTk9PTic7XG4gIHJldHVybiAnRVZFTklORyc7XG59XG5cbi8qKlxuICogR2V0IGxhYmVsIGZvciB0aW1lIG9mIGRheVxuICpcbiAqIEBwYXJhbSB0aW1lT2ZEYXkgLSBUaW1lT2ZEYXkgZW51bSB2YWx1ZVxuICogQHJldHVybnMgSHVtYW4tcmVhZGFibGUgbGFiZWxcbiAqXG4gKiBAZXhhbXBsZVxuICogYGBgdHN4XG4gKiBjb25zdCBsYWJlbCA9IGdldFRpbWVPZkRheUxhYmVsKCdNT1JOSU5HJyk7XG4gKiBjb25zb2xlLmxvZyhsYWJlbCk7IC8vICdNb3JuaW5nJ1xuICogYGBgXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRUaW1lT2ZEYXlMYWJlbCh0aW1lT2ZEYXk6IFRpbWVPZkRheSk6IHN0cmluZyB7XG4gIHJldHVybiBUSU1FX09GX0RBWV9DT05GSUdbdGltZU9mRGF5XS5sYWJlbDtcbn1cblxuLyoqXG4gKiBHcm91cCBldmVudHMgYnkgdGltZSBvZiBkYXlcbiAqXG4gKiBAcGFyYW0gZXZlbnRzIC0gQXJyYXkgb2YgZXZlbnRzIHRvIGdyb3VwXG4gKiBAcmV0dXJucyBHcm91cGVkRXZlbnRzIG9iamVjdCB3aXRoIG1vcm5pbmcsIGFmdGVybm9vbiwgYW5kIGV2ZW5pbmcgYXJyYXlzXG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHRzeFxuICogaW1wb3J0IHsgdXNlVXBjb21pbmdFdmVudHMsIGdyb3VwRXZlbnRzQnlUaW1lT2ZEYXkgfSBmcm9tICdAZ3Jvd3NvYmVyL3Nkayc7XG4gKlxuICogZnVuY3Rpb24gR2F0aGVyaW5nc0xpc3QoKSB7XG4gKiAgIGNvbnN0IHsgZGF0YTogZXZlbnRzIH0gPSB1c2VVcGNvbWluZ0V2ZW50cygzMCk7XG4gKiAgIGNvbnN0IGdyb3VwZWQgPSB1c2VNZW1vKCgpID0+IHtcbiAqICAgICBpZiAoIWV2ZW50cykgcmV0dXJuIG51bGw7XG4gKiAgICAgcmV0dXJuIGdyb3VwRXZlbnRzQnlUaW1lT2ZEYXkoZXZlbnRzKTtcbiAqICAgfSwgW2V2ZW50c10pO1xuICpcbiAqICAgcmV0dXJuIChcbiAqICAgICA8U2VjdGlvbkxpc3RcbiAqICAgICAgIHNlY3Rpb25zPXtbXG4gKiAgICAgICAgIHsgdGl0bGU6ICdNb3JuaW5nJywgZGF0YTogZ3JvdXBlZD8ubW9ybmluZyB8fCBbXSB9LFxuICogICAgICAgICB7IHRpdGxlOiAnQWZ0ZXJub29uJywgZGF0YTogZ3JvdXBlZD8uYWZ0ZXJub29uIHx8IFtdIH0sXG4gKiAgICAgICAgIHsgdGl0bGU6ICdFdmVuaW5nJywgZGF0YTogZ3JvdXBlZD8uZXZlbmluZyB8fCBbXSB9LFxuICogICAgICAgXX1cbiAqICAgICAgIC4uLlxuICogICAgIC8+XG4gKiAgICk7XG4gKiB9XG4gKiBgYGBcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdyb3VwRXZlbnRzQnlUaW1lT2ZEYXkoZXZlbnRzOiBFdmVudFJlc3BvbnNlW10pOiBHcm91cGVkRXZlbnRzIHtcbiAgY29uc3QgZ3JvdXBlZDogR3JvdXBlZEV2ZW50cyA9IHtcbiAgICBtb3JuaW5nOiBbXSxcbiAgICBhZnRlcm5vb246IFtdLFxuICAgIGV2ZW5pbmc6IFtdLFxuICB9O1xuXG4gIGZvciAoY29uc3QgZXZlbnQgb2YgZXZlbnRzKSB7XG4gICAgY29uc3QgdGltZU9mRGF5ID0gZ2V0VGltZU9mRGF5KGV2ZW50LnN0YXJ0RGF0ZSk7XG4gICAgc3dpdGNoICh0aW1lT2ZEYXkpIHtcbiAgICAgIGNhc2UgJ01PUk5JTkcnOlxuICAgICAgICBncm91cGVkLm1vcm5pbmcucHVzaChldmVudCk7XG4gICAgICAgIGJyZWFrO1xuICAgICAgY2FzZSAnQUZURVJOT09OJzpcbiAgICAgICAgZ3JvdXBlZC5hZnRlcm5vb24ucHVzaChldmVudCk7XG4gICAgICAgIGJyZWFrO1xuICAgICAgY2FzZSAnRVZFTklORyc6XG4gICAgICAgIGdyb3VwZWQuZXZlbmluZy5wdXNoKGV2ZW50KTtcbiAgICAgICAgYnJlYWs7XG4gICAgfVxuICB9XG5cbiAgcmV0dXJuIGdyb3VwZWQ7XG59XG5cbi8qKlxuICogQ29udmVydCBncm91cGVkIGV2ZW50cyB0byBzZWN0aW9uIGxpc3QgZGF0YSBmb3JtYXRcbiAqXG4gKiBAcGFyYW0gZXZlbnRzIC0gQXJyYXkgb2YgZXZlbnRzIHRvIGdyb3VwXG4gKiBAcmV0dXJucyBBcnJheSBvZiBzZWN0aW9ucyB3aXRoIHRpdGxlIGFuZCBkYXRhXG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHRzeFxuICogY29uc3Qgc2VjdGlvbnMgPSBnZXRFdmVudFNlY3Rpb25zKGV2ZW50cyk7XG4gKiAvLyBbXG4gKiAvLyAgIHsgdGl0bGU6ICdNb3JuaW5nJywgZGF0YTogWy4uLl0gfSxcbiAqIC8vICAgeyB0aXRsZTogJ0FmdGVybm9vbicsIGRhdGE6IFsuLi5dIH0sXG4gKiAvLyAgIHsgdGl0bGU6ICdFdmVuaW5nJywgZGF0YTogWy4uLl0gfSxcbiAqIC8vIF1cbiAqIGBgYFxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0RXZlbnRTZWN0aW9ucyhldmVudHM6IEV2ZW50UmVzcG9uc2VbXSk6IEFycmF5PHtcbiAgdGl0bGU6IHN0cmluZztcbiAgdGltZU9mRGF5OiBUaW1lT2ZEYXk7XG4gIGRhdGE6IEV2ZW50UmVzcG9uc2VbXTtcbn0+IHtcbiAgY29uc3QgZ3JvdXBlZCA9IGdyb3VwRXZlbnRzQnlUaW1lT2ZEYXkoZXZlbnRzKTtcblxuICByZXR1cm4gW1xuICAgIHsgdGl0bGU6ICdNb3JuaW5nJywgdGltZU9mRGF5OiAnTU9STklORycgYXMgVGltZU9mRGF5LCBkYXRhOiBncm91cGVkLm1vcm5pbmcgfSxcbiAgICB7IHRpdGxlOiAnQWZ0ZXJub29uJywgdGltZU9mRGF5OiAnQUZURVJOT09OJyBhcyBUaW1lT2ZEYXksIGRhdGE6IGdyb3VwZWQuYWZ0ZXJub29uIH0sXG4gICAgeyB0aXRsZTogJ0V2ZW5pbmcnLCB0aW1lT2ZEYXk6ICdFVkVOSU5HJyBhcyBUaW1lT2ZEYXksIGRhdGE6IGdyb3VwZWQuZXZlbmluZyB9LFxuICBdLmZpbHRlcihzZWN0aW9uID0+IHNlY3Rpb24uZGF0YS5sZW5ndGggPiAwKTtcbn1cbiJdfQ==

package/dist/index.d.ts

@@ -34,3 +34,4 @@ export type { SDKConfig } from './api/client';
 export * from './api/types';
 export * from './api/queries';
 export * from './api/mutations';
+export * from './api/utils/eventGrouping';

package/dist/index.js

@@ -64,4 +64,8 @@ __exportStar(require("./api/queries"), exports);
 // MUTATION HOOKS
 // ============================================================================
 __exportStar(require("./api/mutations"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0E4Qkc7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBRUgsK0VBQStFO0FBQy9FLGFBQWE7QUFDYiwrRUFBK0U7QUFFL0UsdUNBQTBEO0FBQWpELHNHQUFBLFlBQVksT0FBQTtBQUFFLHNHQUFBLFlBQVksT0FBQTtBQUduQywrRUFBK0U7QUFDL0UsUUFBUTtBQUNSLCtFQUErRTtBQUUvRSw4Q0FBNEI7QUFFNUIsK0VBQStFO0FBQy9FLGNBQWM7QUFDZCwrRUFBK0U7QUFFL0UsZ0RBQThCO0FBRTlCLCtFQUErRTtBQUMvRSxpQkFBaUI7QUFDakIsK0VBQStFO0FBRS9FLGtEQUFnQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogR3Jvd1NvYmVyIFNES1xuICpcbiAqIFR5cGVTY3JpcHQgU0RLIGZvciB0aGUgR3Jvd1NvYmVyIEFQSSB3aXRoIFRhblN0YWNrIFF1ZXJ5IGhvb2tzLlxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0c3hcbiAqIGltcG9ydCB7IGNvbmZpZ3VyZVNESywgdXNlQ3VycmVudFVzZXIsIHVzZUxvZ2luIH0gZnJvbSAnQGdyb3dzb2Jlci9zZGsnO1xuICpcbiAqIC8vIENvbmZpZ3VyZSBTREsgd2l0aCB5b3VyIEFQSSBiYXNlIFVSTCBhbmQgdG9rZW4gbWFuYWdlbWVudFxuICogY29uZmlndXJlU0RLKHtcbiAqICAgYmFzZVVSTDogJ2h0dHBzOi8vYXBpLmdyb3dzb2Jlci5hcHAnLFxuICogICBnZXRBY2Nlc3NUb2tlbjogKCkgPT4gbG9jYWxTdG9yYWdlLmdldEl0ZW0oJ2FjY2Vzc1Rva2VuJyksXG4gKiAgIHJlZnJlc2hBY2Nlc3NUb2tlbjogYXN5bmMgKCkgPT4ge1xuICogICAgIC8vIFlvdXIgdG9rZW4gcmVmcmVzaCBsb2dpY1xuICogICAgIHJldHVybiBuZXdBY2Nlc3NUb2tlbjtcbiAqICAgfSxcbiAqICAgb25VbmF1dGhvcml6ZWQ6ICgpID0+IHtcbiAqICAgICAvLyBIYW5kbGUgdW5hdXRob3JpemVkIGFjY2Vzc1xuICogICAgIHdpbmRvdy5sb2NhdGlvbi5ocmVmID0gJy9sb2dpbic7XG4gKiAgIH0sXG4gKiB9KTtcbiAqXG4gKiAvLyBVc2UgaG9va3MgaW4geW91ciBjb21wb25lbnRzXG4gKiBmdW5jdGlvbiBBcHAoKSB7XG4gKiAgIGNvbnN0IHsgZGF0YTogdXNlciB9ID0gdXNlQ3VycmVudFVzZXIoKTtcbiAqICAgY29uc3QgeyBtdXRhdGU6IGxvZ2luIH0gPSB1c2VMb2dpbigpO1xuICogICAvLyAuLi5cbiAqIH1cbiAqIGBgYFxuICovXG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIEFQSSBDTElFTlRcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0IHsgY29uZmlndXJlU0RLLCBnZXRBcGlDbGllbnQgfSBmcm9tICcuL2FwaS9jbGllbnQnO1xuZXhwb3J0IHR5cGUgeyBTREtDb25maWcgfSBmcm9tICcuL2FwaS9jbGllbnQnO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBUWVBFU1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgKiBmcm9tICcuL2FwaS90eXBlcyc7XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIFFVRVJZIEhPT0tTXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCAqIGZyb20gJy4vYXBpL3F1ZXJpZXMnO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBNVVRBVElPTiBIT09LU1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgKiBmcm9tICcuL2FwaS9tdXRhdGlvbnMnO1xuXG4iXX0=
+// ============================================================================
+// UTILITIES
+// ============================================================================
+__exportStar(require("./api/utils/eventGrouping"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0E4Qkc7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBRUgsK0VBQStFO0FBQy9FLGFBQWE7QUFDYiwrRUFBK0U7QUFFL0UsdUNBQTBEO0FBQWpELHNHQUFBLFlBQVksT0FBQTtBQUFFLHNHQUFBLFlBQVksT0FBQTtBQUduQywrRUFBK0U7QUFDL0UsUUFBUTtBQUNSLCtFQUErRTtBQUUvRSw4Q0FBNEI7QUFFNUIsK0VBQStFO0FBQy9FLGNBQWM7QUFDZCwrRUFBK0U7QUFFL0UsZ0RBQThCO0FBRTlCLCtFQUErRTtBQUMvRSxpQkFBaUI7QUFDakIsK0VBQStFO0FBRS9FLGtEQUFnQztBQUVoQywrRUFBK0U7QUFDL0UsWUFBWTtBQUNaLCtFQUErRTtBQUUvRSw0REFBMEMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEdyb3dTb2JlciBTREtcbiAqXG4gKiBUeXBlU2NyaXB0IFNESyBmb3IgdGhlIEdyb3dTb2JlciBBUEkgd2l0aCBUYW5TdGFjayBRdWVyeSBob29rcy5cbiAqXG4gKiBAZXhhbXBsZVxuICogYGBgdHN4XG4gKiBpbXBvcnQgeyBjb25maWd1cmVTREssIHVzZUN1cnJlbnRVc2VyLCB1c2VMb2dpbiB9IGZyb20gJ0Bncm93c29iZXIvc2RrJztcbiAqXG4gKiAvLyBDb25maWd1cmUgU0RLIHdpdGggeW91ciBBUEkgYmFzZSBVUkwgYW5kIHRva2VuIG1hbmFnZW1lbnRcbiAqIGNvbmZpZ3VyZVNESyh7XG4gKiAgIGJhc2VVUkw6ICdodHRwczovL2FwaS5ncm93c29iZXIuYXBwJyxcbiAqICAgZ2V0QWNjZXNzVG9rZW46ICgpID0+IGxvY2FsU3RvcmFnZS5nZXRJdGVtKCdhY2Nlc3NUb2tlbicpLFxuICogICByZWZyZXNoQWNjZXNzVG9rZW46IGFzeW5jICgpID0+IHtcbiAqICAgICAvLyBZb3VyIHRva2VuIHJlZnJlc2ggbG9naWNcbiAqICAgICByZXR1cm4gbmV3QWNjZXNzVG9rZW47XG4gKiAgIH0sXG4gKiAgIG9uVW5hdXRob3JpemVkOiAoKSA9PiB7XG4gKiAgICAgLy8gSGFuZGxlIHVuYXV0aG9yaXplZCBhY2Nlc3NcbiAqICAgICB3aW5kb3cubG9jYXRpb24uaHJlZiA9ICcvbG9naW4nO1xuICogICB9LFxuICogfSk7XG4gKlxuICogLy8gVXNlIGhvb2tzIGluIHlvdXIgY29tcG9uZW50c1xuICogZnVuY3Rpb24gQXBwKCkge1xuICogICBjb25zdCB7IGRhdGE6IHVzZXIgfSA9IHVzZUN1cnJlbnRVc2VyKCk7XG4gKiAgIGNvbnN0IHsgbXV0YXRlOiBsb2dpbiB9ID0gdXNlTG9naW4oKTtcbiAqICAgLy8gLi4uXG4gKiB9XG4gKiBgYGBcbiAqL1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBBUEkgQ0xJRU5UXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCB7IGNvbmZpZ3VyZVNESywgZ2V0QXBpQ2xpZW50IH0gZnJvbSAnLi9hcGkvY2xpZW50JztcbmV4cG9ydCB0eXBlIHsgU0RLQ29uZmlnIH0gZnJvbSAnLi9hcGkvY2xpZW50JztcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gVFlQRVNcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0ICogZnJvbSAnLi9hcGkvdHlwZXMnO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBRVUVSWSBIT09LU1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgKiBmcm9tICcuL2FwaS9xdWVyaWVzJztcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gTVVUQVRJT04gSE9PS1Ncbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0ICogZnJvbSAnLi9hcGkvbXV0YXRpb25zJztcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gVVRJTElUSUVTXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCAqIGZyb20gJy4vYXBpL3V0aWxzL2V2ZW50R3JvdXBpbmcnO1xuXG4iXX0=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growsober/sdk",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Shared TypeScript SDK for GrowSober API - TanStack Query hooks, API client, and utilities",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/src/api/utils/eventGrouping.ts

@@ -0,0 +1,181 @@
+/**
+ * Event Grouping Utilities
+ *
+ * Utilities for organizing events by time of day.
+ * Used in the Gatherings screen to show events grouped by
+ * Morning, Afternoon, and Evening.
+ *
+ * @module api/utils/eventGrouping
+ */
+
+import { EventResponse } from '../types';
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export type TimeOfDay = 'MORNING' | 'AFTERNOON' | 'EVENING';
+
+export interface GroupedEvents {
+  morning: EventResponse[];
+  afternoon: EventResponse[];
+  evening: EventResponse[];
+}
+
+export interface TimeOfDayInfo {
+  key: TimeOfDay;
+  label: string;
+  emoji: string;
+  hours: { start: number; end: number };
+}
+
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+
+export const TIME_OF_DAY_CONFIG: Record<TimeOfDay, TimeOfDayInfo> = {
+  MORNING: {
+    key: 'MORNING',
+    label: 'Morning',
+    emoji: '',
+    hours: { start: 5, end: 11 }, // 5:00 AM - 11:59 AM
+  },
+  AFTERNOON: {
+    key: 'AFTERNOON',
+    label: 'Afternoon',
+    emoji: '',
+    hours: { start: 12, end: 16 }, // 12:00 PM - 4:59 PM
+  },
+  EVENING: {
+    key: 'EVENING',
+    label: 'Evening',
+    emoji: '',
+    hours: { start: 17, end: 4 }, // 5:00 PM - 4:59 AM (next day)
+  },
+};
+
+// ============================================================================
+// FUNCTIONS
+// ============================================================================
+
+/**
+ * Get time of day for a given date
+ *
+ * @param date - Date string or Date object
+ * @returns TimeOfDay - MORNING, AFTERNOON, or EVENING
+ *
+ * @example
+ * ```tsx
+ * const timeOfDay = getTimeOfDay('2024-03-15T10:00:00Z');
+ * console.log(timeOfDay); // 'MORNING'
+ * ```
+ */
+export function getTimeOfDay(date: Date | string): TimeOfDay {
+  const d = typeof date === 'string' ? new Date(date) : date;
+  const hour = d.getHours();
+
+  if (hour >= 5 && hour < 12) return 'MORNING';
+  if (hour >= 12 && hour < 17) return 'AFTERNOON';
+  return 'EVENING';
+}
+
+/**
+ * Get label for time of day
+ *
+ * @param timeOfDay - TimeOfDay enum value
+ * @returns Human-readable label
+ *
+ * @example
+ * ```tsx
+ * const label = getTimeOfDayLabel('MORNING');
+ * console.log(label); // 'Morning'
+ * ```
+ */
+export function getTimeOfDayLabel(timeOfDay: TimeOfDay): string {
+  return TIME_OF_DAY_CONFIG[timeOfDay].label;
+}
+
+/**
+ * Group events by time of day
+ *
+ * @param events - Array of events to group
+ * @returns GroupedEvents object with morning, afternoon, and evening arrays
+ *
+ * @example
+ * ```tsx
+ * import { useUpcomingEvents, groupEventsByTimeOfDay } from '@growsober/sdk';
+ *
+ * function GatheringsList() {
+ *   const { data: events } = useUpcomingEvents(30);
+ *   const grouped = useMemo(() => {
+ *     if (!events) return null;
+ *     return groupEventsByTimeOfDay(events);
+ *   }, [events]);
+ *
+ *   return (
+ *     <SectionList
+ *       sections={[
+ *         { title: 'Morning', data: grouped?.morning || [] },
+ *         { title: 'Afternoon', data: grouped?.afternoon || [] },
+ *         { title: 'Evening', data: grouped?.evening || [] },
+ *       ]}
+ *       ...
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export function groupEventsByTimeOfDay(events: EventResponse[]): GroupedEvents {
+  const grouped: GroupedEvents = {
+    morning: [],
+    afternoon: [],
+    evening: [],
+  };
+
+  for (const event of events) {
+    const timeOfDay = getTimeOfDay(event.startDate);
+    switch (timeOfDay) {
+      case 'MORNING':
+        grouped.morning.push(event);
+        break;
+      case 'AFTERNOON':
+        grouped.afternoon.push(event);
+        break;
+      case 'EVENING':
+        grouped.evening.push(event);
+        break;
+    }
+  }
+
+  return grouped;
+}
+
+/**
+ * Convert grouped events to section list data format
+ *
+ * @param events - Array of events to group
+ * @returns Array of sections with title and data
+ *
+ * @example
+ * ```tsx
+ * const sections = getEventSections(events);
+ * // [
+ * //   { title: 'Morning', data: [...] },
+ * //   { title: 'Afternoon', data: [...] },
+ * //   { title: 'Evening', data: [...] },
+ * // ]
+ * ```
+ */
+export function getEventSections(events: EventResponse[]): Array<{
+  title: string;
+  timeOfDay: TimeOfDay;
+  data: EventResponse[];
+}> {
+  const grouped = groupEventsByTimeOfDay(events);
+
+  return [
+    { title: 'Morning', timeOfDay: 'MORNING' as TimeOfDay, data: grouped.morning },
+    { title: 'Afternoon', timeOfDay: 'AFTERNOON' as TimeOfDay, data: grouped.afternoon },
+    { title: 'Evening', timeOfDay: 'EVENING' as TimeOfDay, data: grouped.evening },
+  ].filter(section => section.data.length > 0);
+}

package/src/index.ts

@@ -55,3 +55,9 @@ export * from './api/queries';
 
 export * from './api/mutations';
 
+// ============================================================================
+// UTILITIES
+// ============================================================================
+
+export * from './api/utils/eventGrouping';
+