anear-js-api 1.2.0 → 1.2.1

package/lib/utils/AppMachineTransition.js

@@ -15,6 +15,9 @@ const REFRESH_EVENT_TYPES = new Set([
   // Temporary disconnects (useful for "halt/pause" and UI indicators):
   'PARTICIPANT_DISCONNECT',
   'HOST_DISCONNECT',
+  // Permanent exits (should update participant counts and UI):
+  'PARTICIPANT_EXIT',
+  'HOST_EXIT',
   // Location/heartbeat updates can also want a "refresh current view":
   'PARTICIPANT_UPDATE',
   'HOST_UPDATE'

package/lib/utils/PugHelpers.js

@@ -19,6 +19,81 @@ const PugHelpers = s3ImageAssetsUrl => ({
     } catch (error) {
       throw new Error("Invalid JSON for data-click-action:", finalPayload);
     }
+  },
+  /**
+   * Format a timestamp in the event's timezone (or fallback to local time)
+   * General-purpose helper that works for both time and date formatting.
+   *
+   * @param {number|Date} timestamp - Timestamp in milliseconds or Date object
+   * @param {string|null} timezone - IANA timezone ID (e.g., 'America/New_York') or null for local time
+   * @param {object} options - Intl.DateTimeFormat options
+   *   - For time: { hour: 'numeric', minute: '2-digit', hour12: true }
+   *   - For date: { weekday: 'short', month: 'short', day: 'numeric' }
+   *   - For both: { weekday: 'short', month: 'short', day: 'numeric', hour: 'numeric', minute: '2-digit', hour12: true }
+   * @returns {string} Formatted date/time string
+   *
+   * @example
+   *   // Format time only
+   *   formatDateTime(timestamp, app.eventTimezone)
+   *   // => "3:08 PM"
+   *
+   *   // Format date only
+   *   formatDateTime(timestamp, app.eventTimezone, { weekday: 'short', month: 'short', day: 'numeric' })
+   *   // => "Thu, Jan 1"
+   *
+   *   // Format date and time
+   *   formatDateTime(timestamp, app.eventTimezone, { month: 'short', day: 'numeric', hour: 'numeric', minute: '2-digit' })
+   *   // => "Jan 1, 3:08 PM"
+   */
+  formatDateTime: (timestamp, timezone, options = { hour: 'numeric', minute: '2-digit', hour12: true }) => {
+    const date = timestamp instanceof Date ? timestamp : new Date(timestamp)
+
+    if (timezone && typeof Intl !== 'undefined' && Intl.DateTimeFormat) {
+      const formatter = new Intl.DateTimeFormat('en-US', { ...options, timeZone: timezone })
+      return formatter.format(date)
+    }
+
+    // Fallback: format based on what options were requested
+    const hasTimeOptions = options.hour !== undefined || options.minute !== undefined
+    const hasDateOptions = options.weekday !== undefined || options.month !== undefined || options.day !== undefined || options.year !== undefined
+
+    // If only time options, use simple time fallback
+    if (hasTimeOptions && !hasDateOptions) {
+      const hours = date.getHours()
+      const minutes = date.getMinutes()
+      const ampm = hours >= 12 ? 'PM' : 'AM'
+      const displayHours = hours % 12 || 12
+      return `${displayHours}:${minutes.toString().padStart(2, '0')} ${ampm}`
+    }
+
+    // If date options (with or without time), use UTC fallback for consistency
+    const days = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
+    const months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
+    const parts = []
+
+    if (options.weekday === 'short' || options.weekday === 'long') {
+      parts.push(days[date.getUTCDay()])
+    }
+    if (options.month === 'short' || options.month === 'long') {
+      parts.push(months[date.getUTCMonth()])
+    }
+    if (options.day === 'numeric') {
+      parts.push(date.getUTCDate())
+    }
+    if (options.year === 'numeric') {
+      parts.push(date.getUTCFullYear())
+    }
+
+    // Add time if requested
+    if (hasTimeOptions) {
+      const hours = date.getUTCHours()
+      const minutes = date.getUTCMinutes()
+      const ampm = hours >= 12 ? 'PM' : 'AM'
+      const displayHours = hours % 12 || 12
+      parts.push(`${displayHours}:${minutes.toString().padStart(2, '0')} ${ampm}`)
+    }
+
+    return parts.join(' ')
   }
 })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anear-js-api",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Javascript Developer API for Anear Apps",
   "main": "lib/index.js",
   "scripts": {