@zonetrix/shared 2.1.0 → 2.3.0

package/dist/index.d.mts

@@ -3,8 +3,9 @@
  */
 type SeatState = "available" | "reserved" | "selected" | "unavailable" | "hidden";
 type SeatShape = "circle" | "square" | "rounded-square";
-type Tool = "select" | "seat" | "row" | "section" | "stage";
+type Tool = "select" | "seat" | "row" | "section" | "object";
 type EditorMode = "edit" | "read";
+type ObjectType = "stage" | "table" | "wall" | "barrier" | "dj-booth" | "bar" | "entry-exit" | "custom";
 /**
  * Seat data structure used in the editor and viewer
  */
@@ -50,6 +51,12 @@ interface StageConfig {
     color?: string;
     floorId?: string;
 }
+/**
+ * Object configuration (extends StageConfig with object type support)
+ */
+interface ObjectConfig extends StageConfig {
+    objectType?: ObjectType;
+}
 /**
  * Floor configuration for multi-floor venues
  */
@@ -247,4 +254,195 @@ 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 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 (excludes 'selected' which is client-only, 'hidden' which is filtered)
+ */
+type FirebaseSeatState = 'available' | 'reserved' | 'unavailable';
+/**
+ * Lightweight seat states map for high-frequency real-time updates
+ * Stored at: seat_states/{seatMapId}
+ */
+interface FirebaseSeatStates {
+    [seatId: string]: FirebaseSeatState;
+}
+/**
+ * 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;
+}
+/**
+ * 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
+ */
+declare function extractSeatStates(config: SeatMapConfig): FirebaseSeatStates;
+/**
+ * Merge Firebase seat states with locally-derived reserved/unavailable arrays
+ */
+declare function deriveSeatArraysFromStates(states: FirebaseSeatStates): {
+    reservedSeats: string[];
+    unavailableSeats: 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 };

package/dist/index.d.ts

@@ -3,8 +3,9 @@
  */
 type SeatState = "available" | "reserved" | "selected" | "unavailable" | "hidden";
 type SeatShape = "circle" | "square" | "rounded-square";
-type Tool = "select" | "seat" | "row" | "section" | "stage";
+type Tool = "select" | "seat" | "row" | "section" | "object";
 type EditorMode = "edit" | "read";
+type ObjectType = "stage" | "table" | "wall" | "barrier" | "dj-booth" | "bar" | "entry-exit" | "custom";
 /**
  * Seat data structure used in the editor and viewer
  */
@@ -50,6 +51,12 @@ interface StageConfig {
     color?: string;
     floorId?: string;
 }
+/**
+ * Object configuration (extends StageConfig with object type support)
+ */
+interface ObjectConfig extends StageConfig {
+    objectType?: ObjectType;
+}
 /**
  * Floor configuration for multi-floor venues
  */
@@ -247,4 +254,195 @@ 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 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 (excludes 'selected' which is client-only, 'hidden' which is filtered)
+ */
+type FirebaseSeatState = 'available' | 'reserved' | 'unavailable';
+/**
+ * Lightweight seat states map for high-frequency real-time updates
+ * Stored at: seat_states/{seatMapId}
+ */
+interface FirebaseSeatStates {
+    [seatId: string]: FirebaseSeatState;
+}
+/**
+ * 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;
+}
+/**
+ * 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
+ */
+declare function extractSeatStates(config: SeatMapConfig): FirebaseSeatStates;
+/**
+ * Merge Firebase seat states with locally-derived reserved/unavailable arrays
+ */
+declare function deriveSeatArraysFromStates(states: FirebaseSeatStates): {
+    reservedSeats: string[];
+    unavailableSeats: 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 };

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,222 @@ 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);
+      const state = seatStates?.[encodedId] ?? seatStates?.[id] ?? seat.state;
+      return {
+        id,
+        position: seat.position,
+        shape: seat.shape,
+        state: fromFirebaseState(state),
+        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;
+    const encodedId = encodeSeatId(seat.id);
+    states[encodedId] = toFirebaseState(seat.state);
+  }
+  return states;
+}
+function deriveSeatArraysFromStates(states) {
+  const reservedSeats = [];
+  const unavailableSeats = [];
+  for (const [encodedId, state] of Object.entries(states)) {
+    const id = decodeSeatId(encodedId);
+    if (state === "reserved") {
+      reservedSeats.push(id);
+    } else if (state === "unavailable") {
+      unavailableSeats.push(id);
+    }
+  }
+  return { reservedSeats, unavailableSeats };
+}
+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,221 @@ 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);
+      const state = seatStates?.[encodedId] ?? seatStates?.[id] ?? seat.state;
+      return {
+        id,
+        position: seat.position,
+        shape: seat.shape,
+        state: fromFirebaseState(state),
+        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;
+    const encodedId = encodeSeatId(seat.id);
+    states[encodedId] = toFirebaseState(seat.state);
+  }
+  return states;
+}
+function deriveSeatArraysFromStates(states) {
+  const reservedSeats = [];
+  const unavailableSeats = [];
+  for (const [encodedId, state] of Object.entries(states)) {
+    const id = decodeSeatId(encodedId);
+    if (state === "reserved") {
+      reservedSeats.push(id);
+    } else if (state === "unavailable") {
+      unavailableSeats.push(id);
+    }
+  }
+  return { reservedSeats, unavailableSeats };
+}
+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.1.0",
+  "version": "2.3.0",
   "description": "Shared types and utilities for seat-map-studio packages",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",