@zonetrix/shared 2.2.0 → 2.4.0

package/dist/index.d.mts

@@ -254,4 +254,225 @@ declare function importConfigFromJSON(jsonString: string): SeatMapConfig;
  */
 declare function downloadConfigAsFile(config: SeatMapConfig, filename?: string): void;
 
-export { type AlignmentGuide, type BookingSelection, type CanvasConfig, type CanvasState, type ColorSettings, DEFAULT_COLORS, type EditorMode, 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, downloadConfigAsFile, exportConfigAsJSON, formatDate, generateId, getSelectedSeats, importConfigFromJSON, updateConfigTimestamp, validateSeatMapConfig };
+/**
+ * Firebase Realtime Database type definitions for Seat Map Studio
+ */
+
+/**
+ * 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]: FirebaseSeatStateEntry;
+}
+/**
+ * Position in Firebase (same structure as app)
+ */
+interface FirebasePosition {
+    x: number;
+    y: number;
+}
+/**
+ * Seat data stored in Firebase
+ * Stored at: seatmaps/{seatMapId}/seats/{seatId}
+ */
+interface FirebaseSeat {
+    position: FirebasePosition;
+    shape: SeatShape;
+    state: FirebaseSeatState;
+    sectionName?: string;
+    rowLabel?: string;
+    columnLabel?: string;
+    seatNumber?: string;
+    price?: number;
+    floorId?: string;
+}
+/**
+ * Stage configuration in Firebase
+ * Stored at: seatmaps/{seatMapId}/config/stages/{stageId}
+ */
+interface FirebaseStage {
+    position: FirebasePosition;
+    config: {
+        label: string;
+        width: number;
+        height: number;
+        rotation?: number;
+        color?: string;
+        objectType?: ObjectType;
+    };
+    floorId?: string;
+}
+/**
+ * Canvas configuration in Firebase
+ * Stored at: seatmaps/{seatMapId}/config/canvas
+ */
+interface FirebaseCanvasConfig {
+    width: number;
+    height: number;
+    backgroundColor: string;
+}
+/**
+ * Seat map metadata in Firebase
+ * Stored at: seatmaps/{seatMapId}/meta
+ */
+interface FirebaseSeatMapMeta {
+    event_id: number;
+    sub_event_id: number;
+    name: string;
+    venue?: string;
+    capacity?: number;
+    updated_at: number;
+    version: string;
+}
+/**
+ * Design configuration in Firebase (excludes seats which are separate)
+ * Stored at: seatmaps/{seatMapId}/config
+ */
+interface FirebaseSeatMapConfig {
+    canvas: FirebaseCanvasConfig;
+    colors: ColorSettings;
+    floors?: Record<string, FloorConfig>;
+    stages?: Record<string, FirebaseStage>;
+}
+/**
+ * Complete seat map data structure in Firebase
+ * Stored at: seatmaps/{seatMapId}
+ */
+interface FirebaseSeatMap {
+    meta: FirebaseSeatMapMeta;
+    config: FirebaseSeatMapConfig;
+    seats: Record<string, FirebaseSeat>;
+}
+/**
+ * Index entry for seat map lookup by event
+ * Stored at: indexes/by_event/{eventId}/{seatMapId}
+ */
+type FirebaseIndexEntry = true;
+/**
+ * Options for Firebase real-time hooks
+ */
+interface FirebaseHookOptions {
+    enabled?: boolean;
+    onError?: (error: Error) => void;
+}
+/**
+ * Result from Firebase seat states hook
+ */
+interface FirebaseSeatStatesResult {
+    states: FirebaseSeatStates | null;
+    loading: boolean;
+    error: Error | null;
+    lastUpdated: number | null;
+    myReservedSeats: string[];
+    otherReservedSeats: string[];
+    unavailableSeats: string[];
+}
+/**
+ * Result from Firebase config hook
+ */
+interface FirebaseConfigResult {
+    config: FirebaseSeatMap | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+
+/**
+ * Firebase Realtime Database path utilities
+ * Provides type-safe path builders for all Firebase nodes
+ */
+/**
+ * All Firebase database paths used by Seat Map Studio
+ */
+declare const FirebasePaths: {
+    readonly seatmap: (seatMapId: string) => `seatmaps/${string}`;
+    readonly seatmapMeta: (seatMapId: string) => `seatmaps/${string}/meta`;
+    readonly seatmapConfig: (seatMapId: string) => `seatmaps/${string}/config`;
+    readonly seatmapSeats: (seatMapId: string) => `seatmaps/${string}/seats`;
+    readonly seatmapSeat: (seatMapId: string, seatId: string) => `seatmaps/${string}/seats/${string}`;
+    readonly seatStates: (seatMapId: string) => `seat_states/${string}`;
+    readonly seatState: (seatMapId: string, seatId: string) => `seat_states/${string}/${string}`;
+    readonly indexByEvent: (eventId: number) => `indexes/by_event/${number}`;
+    readonly indexBySubEvent: (subEventId: number) => `indexes/by_sub_event/${number}`;
+    readonly indexEntry: (eventId: number, seatMapId: string) => `indexes/by_event/${number}/${string}`;
+    readonly indexSubEventEntry: (subEventId: number, seatMapId: string) => `indexes/by_sub_event/${number}/${string}`;
+};
+/**
+ * Encode seat ID for Firebase path (Firebase doesn't allow certain characters)
+ * Replaces: . # $ [ ] /
+ */
+declare function encodeSeatId(seatId: string): string;
+/**
+ * Decode seat ID from Firebase path
+ */
+declare function decodeSeatId(encodedId: string): string;
+
+/**
+ * Converters between SeatMapConfig and Firebase data structures
+ */
+
+/**
+ * Convert app SeatState to Firebase state (filters out 'selected' and 'hidden')
+ */
+declare function toFirebaseState(state: SeatState): FirebaseSeatState;
+/**
+ * Convert Firebase state to app SeatState
+ */
+declare function fromFirebaseState(state: FirebaseSeatState): SeatState;
+/**
+ * Convert SeatMapConfig to Firebase format
+ */
+declare function toFirebaseSeatMap(config: SeatMapConfig, eventId: number, subEventId: number): FirebaseSeatMap;
+/**
+ * Convert Firebase data to SeatMapConfig
+ */
+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;
+/**
+ * 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, 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 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

@@ -254,4 +254,225 @@ declare function importConfigFromJSON(jsonString: string): SeatMapConfig;
  */
 declare function downloadConfigAsFile(config: SeatMapConfig, filename?: string): void;
 
-export { type AlignmentGuide, type BookingSelection, type CanvasConfig, type CanvasState, type ColorSettings, DEFAULT_COLORS, type EditorMode, 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, downloadConfigAsFile, exportConfigAsJSON, formatDate, generateId, getSelectedSeats, importConfigFromJSON, updateConfigTimestamp, validateSeatMapConfig };
+/**
+ * Firebase Realtime Database type definitions for Seat Map Studio
+ */
+
+/**
+ * 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]: FirebaseSeatStateEntry;
+}
+/**
+ * Position in Firebase (same structure as app)
+ */
+interface FirebasePosition {
+    x: number;
+    y: number;
+}
+/**
+ * Seat data stored in Firebase
+ * Stored at: seatmaps/{seatMapId}/seats/{seatId}
+ */
+interface FirebaseSeat {
+    position: FirebasePosition;
+    shape: SeatShape;
+    state: FirebaseSeatState;
+    sectionName?: string;
+    rowLabel?: string;
+    columnLabel?: string;
+    seatNumber?: string;
+    price?: number;
+    floorId?: string;
+}
+/**
+ * Stage configuration in Firebase
+ * Stored at: seatmaps/{seatMapId}/config/stages/{stageId}
+ */
+interface FirebaseStage {
+    position: FirebasePosition;
+    config: {
+        label: string;
+        width: number;
+        height: number;
+        rotation?: number;
+        color?: string;
+        objectType?: ObjectType;
+    };
+    floorId?: string;
+}
+/**
+ * Canvas configuration in Firebase
+ * Stored at: seatmaps/{seatMapId}/config/canvas
+ */
+interface FirebaseCanvasConfig {
+    width: number;
+    height: number;
+    backgroundColor: string;
+}
+/**
+ * Seat map metadata in Firebase
+ * Stored at: seatmaps/{seatMapId}/meta
+ */
+interface FirebaseSeatMapMeta {
+    event_id: number;
+    sub_event_id: number;
+    name: string;
+    venue?: string;
+    capacity?: number;
+    updated_at: number;
+    version: string;
+}
+/**
+ * Design configuration in Firebase (excludes seats which are separate)
+ * Stored at: seatmaps/{seatMapId}/config
+ */
+interface FirebaseSeatMapConfig {
+    canvas: FirebaseCanvasConfig;
+    colors: ColorSettings;
+    floors?: Record<string, FloorConfig>;
+    stages?: Record<string, FirebaseStage>;
+}
+/**
+ * Complete seat map data structure in Firebase
+ * Stored at: seatmaps/{seatMapId}
+ */
+interface FirebaseSeatMap {
+    meta: FirebaseSeatMapMeta;
+    config: FirebaseSeatMapConfig;
+    seats: Record<string, FirebaseSeat>;
+}
+/**
+ * Index entry for seat map lookup by event
+ * Stored at: indexes/by_event/{eventId}/{seatMapId}
+ */
+type FirebaseIndexEntry = true;
+/**
+ * Options for Firebase real-time hooks
+ */
+interface FirebaseHookOptions {
+    enabled?: boolean;
+    onError?: (error: Error) => void;
+}
+/**
+ * Result from Firebase seat states hook
+ */
+interface FirebaseSeatStatesResult {
+    states: FirebaseSeatStates | null;
+    loading: boolean;
+    error: Error | null;
+    lastUpdated: number | null;
+    myReservedSeats: string[];
+    otherReservedSeats: string[];
+    unavailableSeats: string[];
+}
+/**
+ * Result from Firebase config hook
+ */
+interface FirebaseConfigResult {
+    config: FirebaseSeatMap | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+
+/**
+ * Firebase Realtime Database path utilities
+ * Provides type-safe path builders for all Firebase nodes
+ */
+/**
+ * All Firebase database paths used by Seat Map Studio
+ */
+declare const FirebasePaths: {
+    readonly seatmap: (seatMapId: string) => `seatmaps/${string}`;
+    readonly seatmapMeta: (seatMapId: string) => `seatmaps/${string}/meta`;
+    readonly seatmapConfig: (seatMapId: string) => `seatmaps/${string}/config`;
+    readonly seatmapSeats: (seatMapId: string) => `seatmaps/${string}/seats`;
+    readonly seatmapSeat: (seatMapId: string, seatId: string) => `seatmaps/${string}/seats/${string}`;
+    readonly seatStates: (seatMapId: string) => `seat_states/${string}`;
+    readonly seatState: (seatMapId: string, seatId: string) => `seat_states/${string}/${string}`;
+    readonly indexByEvent: (eventId: number) => `indexes/by_event/${number}`;
+    readonly indexBySubEvent: (subEventId: number) => `indexes/by_sub_event/${number}`;
+    readonly indexEntry: (eventId: number, seatMapId: string) => `indexes/by_event/${number}/${string}`;
+    readonly indexSubEventEntry: (subEventId: number, seatMapId: string) => `indexes/by_sub_event/${number}/${string}`;
+};
+/**
+ * Encode seat ID for Firebase path (Firebase doesn't allow certain characters)
+ * Replaces: . # $ [ ] /
+ */
+declare function encodeSeatId(seatId: string): string;
+/**
+ * Decode seat ID from Firebase path
+ */
+declare function decodeSeatId(encodedId: string): string;
+
+/**
+ * Converters between SeatMapConfig and Firebase data structures
+ */
+
+/**
+ * Convert app SeatState to Firebase state (filters out 'selected' and 'hidden')
+ */
+declare function toFirebaseState(state: SeatState): FirebaseSeatState;
+/**
+ * Convert Firebase state to app SeatState
+ */
+declare function fromFirebaseState(state: FirebaseSeatState): SeatState;
+/**
+ * Convert SeatMapConfig to Firebase format
+ */
+declare function toFirebaseSeatMap(config: SeatMapConfig, eventId: number, subEventId: number): FirebaseSeatMap;
+/**
+ * Convert Firebase data to SeatMapConfig
+ */
+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;
+/**
+ * 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, 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 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

@@ -21,18 +21,28 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   DEFAULT_COLORS: () => DEFAULT_COLORS,
+  FirebasePaths: () => FirebasePaths,
   applySeatStateOverrides: () => applySeatStateOverrides,
   calculateAvailableSeats: () => calculateAvailableSeats,
   calculateCapacity: () => calculateCapacity,
   calculateSeatPrice: () => calculateSeatPrice,
   cloneConfig: () => cloneConfig,
   createDefaultConfig: () => createDefaultConfig,
+  createIndexUpdates: () => createIndexUpdates,
+  decodeSeatId: () => decodeSeatId,
+  deriveSeatArraysFromStates: () => deriveSeatArraysFromStates,
   downloadConfigAsFile: () => downloadConfigAsFile,
+  encodeSeatId: () => encodeSeatId,
   exportConfigAsJSON: () => exportConfigAsJSON,
+  extractSeatStates: () => extractSeatStates,
   formatDate: () => formatDate,
+  fromFirebaseSeatMap: () => fromFirebaseSeatMap,
+  fromFirebaseState: () => fromFirebaseState,
   generateId: () => generateId,
   getSelectedSeats: () => getSelectedSeats,
   importConfigFromJSON: () => importConfigFromJSON,
+  toFirebaseSeatMap: () => toFirebaseSeatMap,
+  toFirebaseState: () => toFirebaseState,
   updateConfigTimestamp: () => updateConfigTimestamp,
   validateSeatMapConfig: () => validateSeatMapConfig
 });
@@ -262,21 +272,242 @@ function downloadConfigAsFile(config, filename = "seat-map-config.json") {
   document.body.removeChild(link);
   URL.revokeObjectURL(url);
 }
+
+// src/firebase/schema.ts
+var FirebasePaths = {
+  // Seat map nodes
+  seatmap: (seatMapId) => `seatmaps/${seatMapId}`,
+  seatmapMeta: (seatMapId) => `seatmaps/${seatMapId}/meta`,
+  seatmapConfig: (seatMapId) => `seatmaps/${seatMapId}/config`,
+  seatmapSeats: (seatMapId) => `seatmaps/${seatMapId}/seats`,
+  seatmapSeat: (seatMapId, seatId) => `seatmaps/${seatMapId}/seats/${seatId}`,
+  // Lightweight seat states node (for high-frequency updates)
+  seatStates: (seatMapId) => `seat_states/${seatMapId}`,
+  seatState: (seatMapId, seatId) => `seat_states/${seatMapId}/${seatId}`,
+  // Index nodes for efficient lookups
+  indexByEvent: (eventId) => `indexes/by_event/${eventId}`,
+  indexBySubEvent: (subEventId) => `indexes/by_sub_event/${subEventId}`,
+  indexEntry: (eventId, seatMapId) => `indexes/by_event/${eventId}/${seatMapId}`,
+  indexSubEventEntry: (subEventId, seatMapId) => `indexes/by_sub_event/${subEventId}/${seatMapId}`
+};
+function encodeSeatId(seatId) {
+  return seatId.replace(/\./g, "%2E").replace(/#/g, "%23").replace(/\$/g, "%24").replace(/\[/g, "%5B").replace(/\]/g, "%5D").replace(/\//g, "%2F");
+}
+function decodeSeatId(encodedId) {
+  return encodedId.replace(/%2E/g, ".").replace(/%23/g, "#").replace(/%24/g, "$").replace(/%5B/g, "[").replace(/%5D/g, "]").replace(/%2F/g, "/");
+}
+
+// src/firebase/converters.ts
+function removeUndefined(obj) {
+  if (typeof obj !== "object" || obj === null) return obj;
+  const result = {};
+  for (const [key, value] of Object.entries(obj)) {
+    if (value !== void 0) {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+function toFirebaseState(state) {
+  if (state === "selected") return "available";
+  if (state === "hidden") return "unavailable";
+  return state;
+}
+function fromFirebaseState(state) {
+  return state;
+}
+function toFirebaseSeatMap(config, eventId, subEventId) {
+  const meta = removeUndefined({
+    event_id: eventId,
+    sub_event_id: subEventId,
+    name: config.metadata.name,
+    venue: config.metadata.venue,
+    capacity: config.metadata.capacity,
+    updated_at: Date.now(),
+    version: config.version
+  });
+  const seats = {};
+  for (const seat of config.seats) {
+    const encodedId = encodeSeatId(seat.id);
+    seats[encodedId] = removeUndefined({
+      position: seat.position,
+      shape: seat.shape,
+      state: toFirebaseState(seat.state),
+      sectionName: seat.sectionName,
+      rowLabel: seat.rowLabel,
+      columnLabel: seat.columnLabel,
+      seatNumber: seat.seatNumber,
+      price: seat.price,
+      floorId: seat.floorId
+    });
+  }
+  let stages = null;
+  if (config.stages && config.stages.length > 0) {
+    stages = {};
+    for (const stage of config.stages) {
+      stages[stage.id] = removeUndefined({
+        position: stage.position,
+        config: removeUndefined({
+          label: stage.config.label,
+          width: stage.config.width,
+          height: stage.config.height,
+          rotation: stage.config.rotation,
+          color: stage.config.color
+        }),
+        floorId: stage.floorId
+      });
+    }
+  }
+  let floors = null;
+  if (config.floors && config.floors.length > 0) {
+    floors = {};
+    for (const floor of config.floors) {
+      floors[floor.id] = {
+        id: floor.id,
+        name: floor.name,
+        order: floor.order,
+        ...floor.color !== void 0 ? { color: floor.color } : {}
+      };
+    }
+  }
+  const firebaseConfig = {
+    canvas: config.canvas,
+    colors: config.colors
+  };
+  if (floors) {
+    firebaseConfig.floors = floors;
+  }
+  if (stages) {
+    firebaseConfig.stages = stages;
+  }
+  return {
+    meta,
+    config: firebaseConfig,
+    seats
+  };
+}
+function fromFirebaseSeatMap(firebase, seatStates) {
+  const seats = Object.entries(firebase.seats || {}).map(
+    ([encodedId, seat]) => {
+      const id = decodeSeatId(encodedId);
+      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(effectiveState),
+        sectionName: seat.sectionName,
+        rowLabel: seat.rowLabel,
+        columnLabel: seat.columnLabel,
+        seatNumber: seat.seatNumber,
+        price: seat.price,
+        floorId: seat.floorId
+      };
+    }
+  );
+  const stages = firebase.config.stages ? Object.entries(firebase.config.stages).map(([id, stage]) => ({
+    id,
+    position: stage.position,
+    config: {
+      label: stage.config.label,
+      width: stage.config.width,
+      height: stage.config.height,
+      rotation: stage.config.rotation,
+      color: stage.config.color
+    },
+    floorId: stage.floorId
+  })) : void 0;
+  const floors = firebase.config.floors ? Object.values(firebase.config.floors).sort((a, b) => a.order - b.order) : void 0;
+  return {
+    version: firebase.meta.version,
+    metadata: {
+      name: firebase.meta.name,
+      venue: firebase.meta.venue,
+      capacity: firebase.meta.capacity,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      // Not stored in Firebase
+      updatedAt: new Date(firebase.meta.updated_at).toISOString()
+    },
+    canvas: firebase.config.canvas,
+    colors: firebase.config.colors,
+    seats,
+    stages,
+    floors
+  };
+}
+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] = {
+      state: seat.state,
+      timestamp: Date.now()
+    };
+  }
+  return states;
+}
+function deriveSeatArraysFromStates(states, currentUserId) {
+  const myReservedSeats = [];
+  const otherReservedSeats = [];
+  const unavailableSeats = [];
+  for (const [encodedId, entry] of Object.entries(states)) {
+    if (!entry) continue;
+    const id = decodeSeatId(encodedId);
+    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 {
+    myReservedSeats,
+    otherReservedSeats,
+    unavailableSeats,
+    // Legacy: all reserved seats (for non-user-aware usage)
+    reservedSeats: [...myReservedSeats, ...otherReservedSeats]
+  };
+}
+function createIndexUpdates(seatMapId, eventId, subEventId) {
+  return {
+    [`indexes/by_event/${eventId}/${seatMapId}`]: true,
+    [`indexes/by_sub_event/${subEventId}/${seatMapId}`]: true
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_COLORS,
+  FirebasePaths,
   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.mjs

@@ -222,20 +222,241 @@ function downloadConfigAsFile(config, filename = "seat-map-config.json") {
   document.body.removeChild(link);
   URL.revokeObjectURL(url);
 }
+
+// src/firebase/schema.ts
+var FirebasePaths = {
+  // Seat map nodes
+  seatmap: (seatMapId) => `seatmaps/${seatMapId}`,
+  seatmapMeta: (seatMapId) => `seatmaps/${seatMapId}/meta`,
+  seatmapConfig: (seatMapId) => `seatmaps/${seatMapId}/config`,
+  seatmapSeats: (seatMapId) => `seatmaps/${seatMapId}/seats`,
+  seatmapSeat: (seatMapId, seatId) => `seatmaps/${seatMapId}/seats/${seatId}`,
+  // Lightweight seat states node (for high-frequency updates)
+  seatStates: (seatMapId) => `seat_states/${seatMapId}`,
+  seatState: (seatMapId, seatId) => `seat_states/${seatMapId}/${seatId}`,
+  // Index nodes for efficient lookups
+  indexByEvent: (eventId) => `indexes/by_event/${eventId}`,
+  indexBySubEvent: (subEventId) => `indexes/by_sub_event/${subEventId}`,
+  indexEntry: (eventId, seatMapId) => `indexes/by_event/${eventId}/${seatMapId}`,
+  indexSubEventEntry: (subEventId, seatMapId) => `indexes/by_sub_event/${subEventId}/${seatMapId}`
+};
+function encodeSeatId(seatId) {
+  return seatId.replace(/\./g, "%2E").replace(/#/g, "%23").replace(/\$/g, "%24").replace(/\[/g, "%5B").replace(/\]/g, "%5D").replace(/\//g, "%2F");
+}
+function decodeSeatId(encodedId) {
+  return encodedId.replace(/%2E/g, ".").replace(/%23/g, "#").replace(/%24/g, "$").replace(/%5B/g, "[").replace(/%5D/g, "]").replace(/%2F/g, "/");
+}
+
+// src/firebase/converters.ts
+function removeUndefined(obj) {
+  if (typeof obj !== "object" || obj === null) return obj;
+  const result = {};
+  for (const [key, value] of Object.entries(obj)) {
+    if (value !== void 0) {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+function toFirebaseState(state) {
+  if (state === "selected") return "available";
+  if (state === "hidden") return "unavailable";
+  return state;
+}
+function fromFirebaseState(state) {
+  return state;
+}
+function toFirebaseSeatMap(config, eventId, subEventId) {
+  const meta = removeUndefined({
+    event_id: eventId,
+    sub_event_id: subEventId,
+    name: config.metadata.name,
+    venue: config.metadata.venue,
+    capacity: config.metadata.capacity,
+    updated_at: Date.now(),
+    version: config.version
+  });
+  const seats = {};
+  for (const seat of config.seats) {
+    const encodedId = encodeSeatId(seat.id);
+    seats[encodedId] = removeUndefined({
+      position: seat.position,
+      shape: seat.shape,
+      state: toFirebaseState(seat.state),
+      sectionName: seat.sectionName,
+      rowLabel: seat.rowLabel,
+      columnLabel: seat.columnLabel,
+      seatNumber: seat.seatNumber,
+      price: seat.price,
+      floorId: seat.floorId
+    });
+  }
+  let stages = null;
+  if (config.stages && config.stages.length > 0) {
+    stages = {};
+    for (const stage of config.stages) {
+      stages[stage.id] = removeUndefined({
+        position: stage.position,
+        config: removeUndefined({
+          label: stage.config.label,
+          width: stage.config.width,
+          height: stage.config.height,
+          rotation: stage.config.rotation,
+          color: stage.config.color
+        }),
+        floorId: stage.floorId
+      });
+    }
+  }
+  let floors = null;
+  if (config.floors && config.floors.length > 0) {
+    floors = {};
+    for (const floor of config.floors) {
+      floors[floor.id] = {
+        id: floor.id,
+        name: floor.name,
+        order: floor.order,
+        ...floor.color !== void 0 ? { color: floor.color } : {}
+      };
+    }
+  }
+  const firebaseConfig = {
+    canvas: config.canvas,
+    colors: config.colors
+  };
+  if (floors) {
+    firebaseConfig.floors = floors;
+  }
+  if (stages) {
+    firebaseConfig.stages = stages;
+  }
+  return {
+    meta,
+    config: firebaseConfig,
+    seats
+  };
+}
+function fromFirebaseSeatMap(firebase, seatStates) {
+  const seats = Object.entries(firebase.seats || {}).map(
+    ([encodedId, seat]) => {
+      const id = decodeSeatId(encodedId);
+      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(effectiveState),
+        sectionName: seat.sectionName,
+        rowLabel: seat.rowLabel,
+        columnLabel: seat.columnLabel,
+        seatNumber: seat.seatNumber,
+        price: seat.price,
+        floorId: seat.floorId
+      };
+    }
+  );
+  const stages = firebase.config.stages ? Object.entries(firebase.config.stages).map(([id, stage]) => ({
+    id,
+    position: stage.position,
+    config: {
+      label: stage.config.label,
+      width: stage.config.width,
+      height: stage.config.height,
+      rotation: stage.config.rotation,
+      color: stage.config.color
+    },
+    floorId: stage.floorId
+  })) : void 0;
+  const floors = firebase.config.floors ? Object.values(firebase.config.floors).sort((a, b) => a.order - b.order) : void 0;
+  return {
+    version: firebase.meta.version,
+    metadata: {
+      name: firebase.meta.name,
+      venue: firebase.meta.venue,
+      capacity: firebase.meta.capacity,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      // Not stored in Firebase
+      updatedAt: new Date(firebase.meta.updated_at).toISOString()
+    },
+    canvas: firebase.config.canvas,
+    colors: firebase.config.colors,
+    seats,
+    stages,
+    floors
+  };
+}
+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] = {
+      state: seat.state,
+      timestamp: Date.now()
+    };
+  }
+  return states;
+}
+function deriveSeatArraysFromStates(states, currentUserId) {
+  const myReservedSeats = [];
+  const otherReservedSeats = [];
+  const unavailableSeats = [];
+  for (const [encodedId, entry] of Object.entries(states)) {
+    if (!entry) continue;
+    const id = decodeSeatId(encodedId);
+    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 {
+    myReservedSeats,
+    otherReservedSeats,
+    unavailableSeats,
+    // Legacy: all reserved seats (for non-user-aware usage)
+    reservedSeats: [...myReservedSeats, ...otherReservedSeats]
+  };
+}
+function createIndexUpdates(seatMapId, eventId, subEventId) {
+  return {
+    [`indexes/by_event/${eventId}/${seatMapId}`]: true,
+    [`indexes/by_sub_event/${subEventId}/${seatMapId}`]: true
+  };
+}
 export {
   DEFAULT_COLORS,
+  FirebasePaths,
   applySeatStateOverrides,
   calculateAvailableSeats,
   calculateCapacity,
   calculateSeatPrice,
   cloneConfig,
   createDefaultConfig,
+  createIndexUpdates,
+  decodeSeatId,
+  deriveSeatArraysFromStates,
   downloadConfigAsFile,
+  encodeSeatId,
   exportConfigAsJSON,
+  extractSeatStates,
   formatDate,
+  fromFirebaseSeatMap,
+  fromFirebaseState,
   generateId,
   getSelectedSeats,
   importConfigFromJSON,
+  toFirebaseSeatMap,
+  toFirebaseState,
   updateConfigTimestamp,
   validateSeatMapConfig
 };

package/package.json

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