@zonetrix/shared 2.3.0 → 2.4.0

package/dist/index.d.mts

@@ -259,15 +259,32 @@ declare function downloadConfigAsFile(config: SeatMapConfig, filename?: string):
  */
 
 /**
- * Firebase seat state (excludes 'selected' which is client-only, 'hidden' which is filtered)
+ * Firebase seat state type (excludes 'selected' which is client-only, 'hidden' which is filtered)
  */
 type FirebaseSeatState = 'available' | 'reserved' | 'unavailable';
+/**
+ * Seat state value stored in Firebase (for reserved/unavailable seats)
+ * Available seats: key is deleted (doesn't exist)
+ * Reserved/Unavailable seats: object with state, userId, and timestamp
+ */
+interface FirebaseSeatStateValue {
+    state: 'reserved' | 'unavailable';
+    userId?: string;
+    timestamp?: number;
+}
+/**
+ * Entry in the seat states map - null/undefined means available
+ */
+type FirebaseSeatStateEntry = FirebaseSeatStateValue | null;
 /**
  * Lightweight seat states map for high-frequency real-time updates
  * Stored at: seat_states/{seatMapId}
+ *
+ * Keys: encoded seat IDs
+ * Values: null = available, object = reserved/unavailable with user info
  */
 interface FirebaseSeatStates {
-    [seatId: string]: FirebaseSeatState;
+    [seatId: string]: FirebaseSeatStateEntry;
 }
 /**
  * Position in Firebase (same structure as app)
@@ -368,6 +385,9 @@ interface FirebaseSeatStatesResult {
     loading: boolean;
     error: Error | null;
     lastUpdated: number | null;
+    myReservedSeats: string[];
+    otherReservedSeats: string[];
+    unavailableSeats: string[];
 }
 /**
  * Result from Firebase config hook
@@ -431,18 +451,28 @@ declare function toFirebaseSeatMap(config: SeatMapConfig, eventId: number, subEv
 declare function fromFirebaseSeatMap(firebase: FirebaseSeatMap, seatStates?: FirebaseSeatStates): SeatMapConfig;
 /**
  * Extract seat states from SeatMapConfig for the lightweight states node
+ *
+ * Only stores non-available states (reserved/unavailable).
+ * Available seats: key is not stored (viewer treats missing keys as available)
+ * Hidden seats: not stored (filtered out by viewer)
  */
 declare function extractSeatStates(config: SeatMapConfig): FirebaseSeatStates;
 /**
- * Merge Firebase seat states with locally-derived reserved/unavailable arrays
+ * Derive user-aware seat arrays from Firebase seat states
+ *
+ * @param states - Firebase seat states map
+ * @param currentUserId - Optional current user ID for user-aware derivation
+ * @returns Object with myReservedSeats, otherReservedSeats, and unavailableSeats arrays
  */
-declare function deriveSeatArraysFromStates(states: FirebaseSeatStates): {
-    reservedSeats: string[];
+declare function deriveSeatArraysFromStates(states: FirebaseSeatStates, currentUserId?: string): {
+    myReservedSeats: string[];
+    otherReservedSeats: string[];
     unavailableSeats: string[];
+    reservedSeats: string[];
 };
 /**
  * Create index updates for a seat map
  */
 declare function createIndexUpdates(seatMapId: string, eventId: number, subEventId: number): Record<string, boolean>;
 
-export { type AlignmentGuide, type BookingSelection, type CanvasConfig, type CanvasState, type ColorSettings, DEFAULT_COLORS, type EditorMode, type FirebaseCanvasConfig, type FirebaseConfigResult, type FirebaseHookOptions, type FirebaseIndexEntry, FirebasePaths, type FirebasePosition, type FirebaseSeat, type FirebaseSeatMap, type FirebaseSeatMapConfig, type FirebaseSeatMapMeta, type FirebaseSeatState, type FirebaseSeatStates, type FirebaseSeatStatesResult, type FirebaseStage, type ObjectConfig, type ObjectType, type RowPricing, type SeatData, type SeatMapConfig, type SeatMapMetadata, type SeatShape, type SeatState, type SectionConfig, type SerializedSeat, type SerializedSection, type SerializedStage, type StageConfig, type Tool, type ValidationResult, applySeatStateOverrides, calculateAvailableSeats, calculateCapacity, calculateSeatPrice, cloneConfig, createDefaultConfig, createIndexUpdates, decodeSeatId, deriveSeatArraysFromStates, downloadConfigAsFile, encodeSeatId, exportConfigAsJSON, extractSeatStates, formatDate, fromFirebaseSeatMap, fromFirebaseState, generateId, getSelectedSeats, importConfigFromJSON, toFirebaseSeatMap, toFirebaseState, updateConfigTimestamp, validateSeatMapConfig };
+export { type AlignmentGuide, type BookingSelection, type CanvasConfig, type CanvasState, type ColorSettings, DEFAULT_COLORS, type EditorMode, type FirebaseCanvasConfig, type FirebaseConfigResult, type FirebaseHookOptions, type FirebaseIndexEntry, FirebasePaths, type FirebasePosition, type FirebaseSeat, type FirebaseSeatMap, type FirebaseSeatMapConfig, type FirebaseSeatMapMeta, type FirebaseSeatState, type FirebaseSeatStateEntry, type FirebaseSeatStateValue, type FirebaseSeatStates, type FirebaseSeatStatesResult, type FirebaseStage, type ObjectConfig, type ObjectType, type RowPricing, type SeatData, type SeatMapConfig, type SeatMapMetadata, type SeatShape, type SeatState, type SectionConfig, type SerializedSeat, type SerializedSection, type SerializedStage, type StageConfig, type Tool, type ValidationResult, applySeatStateOverrides, calculateAvailableSeats, calculateCapacity, calculateSeatPrice, cloneConfig, createDefaultConfig, createIndexUpdates, decodeSeatId, deriveSeatArraysFromStates, downloadConfigAsFile, encodeSeatId, exportConfigAsJSON, extractSeatStates, formatDate, fromFirebaseSeatMap, fromFirebaseState, generateId, getSelectedSeats, importConfigFromJSON, toFirebaseSeatMap, toFirebaseState, updateConfigTimestamp, validateSeatMapConfig };

package/dist/index.d.ts

@@ -259,15 +259,32 @@ declare function downloadConfigAsFile(config: SeatMapConfig, filename?: string):
  */
 
 /**
- * Firebase seat state (excludes 'selected' which is client-only, 'hidden' which is filtered)
+ * Firebase seat state type (excludes 'selected' which is client-only, 'hidden' which is filtered)
  */
 type FirebaseSeatState = 'available' | 'reserved' | 'unavailable';
+/**
+ * Seat state value stored in Firebase (for reserved/unavailable seats)
+ * Available seats: key is deleted (doesn't exist)
+ * Reserved/Unavailable seats: object with state, userId, and timestamp
+ */
+interface FirebaseSeatStateValue {
+    state: 'reserved' | 'unavailable';
+    userId?: string;
+    timestamp?: number;
+}
+/**
+ * Entry in the seat states map - null/undefined means available
+ */
+type FirebaseSeatStateEntry = FirebaseSeatStateValue | null;
 /**
  * Lightweight seat states map for high-frequency real-time updates
  * Stored at: seat_states/{seatMapId}
+ *
+ * Keys: encoded seat IDs
+ * Values: null = available, object = reserved/unavailable with user info
  */
 interface FirebaseSeatStates {
-    [seatId: string]: FirebaseSeatState;
+    [seatId: string]: FirebaseSeatStateEntry;
 }
 /**
  * Position in Firebase (same structure as app)
@@ -368,6 +385,9 @@ interface FirebaseSeatStatesResult {
     loading: boolean;
     error: Error | null;
     lastUpdated: number | null;
+    myReservedSeats: string[];
+    otherReservedSeats: string[];
+    unavailableSeats: string[];
 }
 /**
  * Result from Firebase config hook
@@ -431,18 +451,28 @@ declare function toFirebaseSeatMap(config: SeatMapConfig, eventId: number, subEv
 declare function fromFirebaseSeatMap(firebase: FirebaseSeatMap, seatStates?: FirebaseSeatStates): SeatMapConfig;
 /**
  * Extract seat states from SeatMapConfig for the lightweight states node
+ *
+ * Only stores non-available states (reserved/unavailable).
+ * Available seats: key is not stored (viewer treats missing keys as available)
+ * Hidden seats: not stored (filtered out by viewer)
  */
 declare function extractSeatStates(config: SeatMapConfig): FirebaseSeatStates;
 /**
- * Merge Firebase seat states with locally-derived reserved/unavailable arrays
+ * Derive user-aware seat arrays from Firebase seat states
+ *
+ * @param states - Firebase seat states map
+ * @param currentUserId - Optional current user ID for user-aware derivation
+ * @returns Object with myReservedSeats, otherReservedSeats, and unavailableSeats arrays
  */
-declare function deriveSeatArraysFromStates(states: FirebaseSeatStates): {
-    reservedSeats: string[];
+declare function deriveSeatArraysFromStates(states: FirebaseSeatStates, currentUserId?: string): {
+    myReservedSeats: string[];
+    otherReservedSeats: string[];
     unavailableSeats: string[];
+    reservedSeats: string[];
 };
 /**
  * Create index updates for a seat map
  */
 declare function createIndexUpdates(seatMapId: string, eventId: number, subEventId: number): Record<string, boolean>;
 
-export { type AlignmentGuide, type BookingSelection, type CanvasConfig, type CanvasState, type ColorSettings, DEFAULT_COLORS, type EditorMode, type FirebaseCanvasConfig, type FirebaseConfigResult, type FirebaseHookOptions, type FirebaseIndexEntry, FirebasePaths, type FirebasePosition, type FirebaseSeat, type FirebaseSeatMap, type FirebaseSeatMapConfig, type FirebaseSeatMapMeta, type FirebaseSeatState, type FirebaseSeatStates, type FirebaseSeatStatesResult, type FirebaseStage, type ObjectConfig, type ObjectType, type RowPricing, type SeatData, type SeatMapConfig, type SeatMapMetadata, type SeatShape, type SeatState, type SectionConfig, type SerializedSeat, type SerializedSection, type SerializedStage, type StageConfig, type Tool, type ValidationResult, applySeatStateOverrides, calculateAvailableSeats, calculateCapacity, calculateSeatPrice, cloneConfig, createDefaultConfig, createIndexUpdates, decodeSeatId, deriveSeatArraysFromStates, downloadConfigAsFile, encodeSeatId, exportConfigAsJSON, extractSeatStates, formatDate, fromFirebaseSeatMap, fromFirebaseState, generateId, getSelectedSeats, importConfigFromJSON, toFirebaseSeatMap, toFirebaseState, updateConfigTimestamp, validateSeatMapConfig };
+export { type AlignmentGuide, type BookingSelection, type CanvasConfig, type CanvasState, type ColorSettings, DEFAULT_COLORS, type EditorMode, type FirebaseCanvasConfig, type FirebaseConfigResult, type FirebaseHookOptions, type FirebaseIndexEntry, FirebasePaths, type FirebasePosition, type FirebaseSeat, type FirebaseSeatMap, type FirebaseSeatMapConfig, type FirebaseSeatMapMeta, type FirebaseSeatState, type FirebaseSeatStateEntry, type FirebaseSeatStateValue, type FirebaseSeatStates, type FirebaseSeatStatesResult, type FirebaseStage, type ObjectConfig, type ObjectType, type RowPricing, type SeatData, type SeatMapConfig, type SeatMapMetadata, type SeatShape, type SeatState, type SectionConfig, type SerializedSeat, type SerializedSection, type SerializedStage, type StageConfig, type Tool, type ValidationResult, applySeatStateOverrides, calculateAvailableSeats, calculateCapacity, calculateSeatPrice, cloneConfig, createDefaultConfig, createIndexUpdates, decodeSeatId, deriveSeatArraysFromStates, downloadConfigAsFile, encodeSeatId, exportConfigAsJSON, extractSeatStates, formatDate, fromFirebaseSeatMap, fromFirebaseState, generateId, getSelectedSeats, importConfigFromJSON, toFirebaseSeatMap, toFirebaseState, updateConfigTimestamp, validateSeatMapConfig };

package/dist/index.js

@@ -390,12 +390,16 @@ function fromFirebaseSeatMap(firebase, seatStates) {
   const seats = Object.entries(firebase.seats || {}).map(
     ([encodedId, seat]) => {
       const id = decodeSeatId(encodedId);
-      const state = seatStates?.[encodedId] ?? seatStates?.[id] ?? seat.state;
+      let effectiveState = seat.state;
+      const stateEntry = seatStates?.[encodedId] ?? seatStates?.[id];
+      if (stateEntry) {
+        effectiveState = stateEntry.state;
+      }
       return {
         id,
         position: seat.position,
         shape: seat.shape,
-        state: fromFirebaseState(state),
+        state: fromFirebaseState(effectiveState),
         sectionName: seat.sectionName,
         rowLabel: seat.rowLabel,
         columnLabel: seat.columnLabel,
@@ -439,23 +443,39 @@ function extractSeatStates(config) {
   const states = {};
   for (const seat of config.seats) {
     if (seat.state === "hidden") continue;
+    if (seat.state === "available" || seat.state === "selected") continue;
     const encodedId = encodeSeatId(seat.id);
-    states[encodedId] = toFirebaseState(seat.state);
+    states[encodedId] = {
+      state: seat.state,
+      timestamp: Date.now()
+    };
   }
   return states;
 }
-function deriveSeatArraysFromStates(states) {
-  const reservedSeats = [];
+function deriveSeatArraysFromStates(states, currentUserId) {
+  const myReservedSeats = [];
+  const otherReservedSeats = [];
   const unavailableSeats = [];
-  for (const [encodedId, state] of Object.entries(states)) {
+  for (const [encodedId, entry] of Object.entries(states)) {
+    if (!entry) continue;
     const id = decodeSeatId(encodedId);
-    if (state === "reserved") {
-      reservedSeats.push(id);
-    } else if (state === "unavailable") {
+    if (entry.state === "unavailable") {
       unavailableSeats.push(id);
+    } else if (entry.state === "reserved") {
+      if (currentUserId && entry.userId === currentUserId) {
+        myReservedSeats.push(id);
+      } else {
+        otherReservedSeats.push(id);
+      }
     }
   }
-  return { reservedSeats, unavailableSeats };
+  return {
+    myReservedSeats,
+    otherReservedSeats,
+    unavailableSeats,
+    // Legacy: all reserved seats (for non-user-aware usage)
+    reservedSeats: [...myReservedSeats, ...otherReservedSeats]
+  };
 }
 function createIndexUpdates(seatMapId, eventId, subEventId) {
   return {

package/dist/index.mjs

@@ -340,12 +340,16 @@ function fromFirebaseSeatMap(firebase, seatStates) {
   const seats = Object.entries(firebase.seats || {}).map(
     ([encodedId, seat]) => {
       const id = decodeSeatId(encodedId);
-      const state = seatStates?.[encodedId] ?? seatStates?.[id] ?? seat.state;
+      let effectiveState = seat.state;
+      const stateEntry = seatStates?.[encodedId] ?? seatStates?.[id];
+      if (stateEntry) {
+        effectiveState = stateEntry.state;
+      }
       return {
         id,
         position: seat.position,
         shape: seat.shape,
-        state: fromFirebaseState(state),
+        state: fromFirebaseState(effectiveState),
         sectionName: seat.sectionName,
         rowLabel: seat.rowLabel,
         columnLabel: seat.columnLabel,
@@ -389,23 +393,39 @@ function extractSeatStates(config) {
   const states = {};
   for (const seat of config.seats) {
     if (seat.state === "hidden") continue;
+    if (seat.state === "available" || seat.state === "selected") continue;
     const encodedId = encodeSeatId(seat.id);
-    states[encodedId] = toFirebaseState(seat.state);
+    states[encodedId] = {
+      state: seat.state,
+      timestamp: Date.now()
+    };
   }
   return states;
 }
-function deriveSeatArraysFromStates(states) {
-  const reservedSeats = [];
+function deriveSeatArraysFromStates(states, currentUserId) {
+  const myReservedSeats = [];
+  const otherReservedSeats = [];
   const unavailableSeats = [];
-  for (const [encodedId, state] of Object.entries(states)) {
+  for (const [encodedId, entry] of Object.entries(states)) {
+    if (!entry) continue;
     const id = decodeSeatId(encodedId);
-    if (state === "reserved") {
-      reservedSeats.push(id);
-    } else if (state === "unavailable") {
+    if (entry.state === "unavailable") {
       unavailableSeats.push(id);
+    } else if (entry.state === "reserved") {
+      if (currentUserId && entry.userId === currentUserId) {
+        myReservedSeats.push(id);
+      } else {
+        otherReservedSeats.push(id);
+      }
     }
   }
-  return { reservedSeats, unavailableSeats };
+  return {
+    myReservedSeats,
+    otherReservedSeats,
+    unavailableSeats,
+    // Legacy: all reserved seats (for non-user-aware usage)
+    reservedSeats: [...myReservedSeats, ...otherReservedSeats]
+  };
 }
 function createIndexUpdates(seatMapId, eventId, subEventId) {
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zonetrix/shared",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Shared types and utilities for seat-map-studio packages",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",