@dataemergencia/emergency 0.2.1 → 0.3.0

package/dist/index.cjs

@@ -84,13 +84,8 @@ function isFiniteNumber(value) {
 function isArrayOf(value, guard) {
 	return Array.isArray(value) && value.every(guard);
 }
-function isRealtimeConfig(value) {
-	if (!isRecord(value) || value["mode"] !== "public" || !isRecord(value["pusher"])) return false;
-	const pusher = value["pusher"];
-	return isString(pusher["key"]) && isString(pusher["cluster"]) && isString(pusher["channel_pattern"]);
-}
 function isConfigResponse(value) {
-	return isRecord(value) && isString(value["route_prefix"]) && isString(value["csrf_token"]) && isRealtimeConfig(value["realtime"]);
+	return isRecord(value) && isString(value["route_prefix"]) && isString(value["csrf_token"]);
 }
 function isSessionResponse(value) {
 	return isRecord(value) && isString(value["code"]) && isString(value["csrf_token"]) && isFiniteNumber(value["expires_in"]);
@@ -108,7 +103,7 @@ function isEmergencyResultPayload(value) {
 	return (value["emergency_id"] === null || isString(value["emergency_id"])) && isBoolean(value["simulated"]) && isArrayOf(value["responders"], isResponderPayload) && isArrayOf(value["failures"], isFailurePayload);
 }
 function isCurrentResponse(value) {
-	if (!isRecord(value) || !isBoolean(value["active"]) || !isRealtimeConfig(value["realtime"])) return false;
+	if (!isRecord(value) || !isBoolean(value["active"])) return false;
 	return value["emergency"] === null || isRecord(value["emergency"]) && !Array.isArray(value["emergency"]);
 }
 function isRefreshResponse(value) {
@@ -634,8 +629,9 @@ function themeToCssVariables(theme) {
 }
 
 // src/core/realtime.ts
+const DEFAULT_CHANNEL_PATTERN = "whatsapp.{phone}";
 function channelForPhone(pattern, phone) {
-	return pattern.replace("{phone}", phone.replace(/^\+/, ""));
+	return pattern.replace("{phone}", phone.replace(/\D/g, ""));
 }
 function toStatus(state) {
 	switch (state) {
@@ -650,11 +646,11 @@ function toStatus(state) {
 }
 function createPusherRealtimeProvider() {
 	return { subscribe(config, phones, handlers) {
-		if (typeof window === "undefined" || !config.pusher.key || !config.pusher.cluster) return null;
+		if (typeof window === "undefined" || !config.key || !config.cluster) return null;
 		let pusher;
 		try {
-			pusher = new pusher_js.default(config.pusher.key, {
-				cluster: config.pusher.cluster,
+			pusher = new pusher_js.default(config.key, {
+				cluster: config.cluster,
 				forceTLS: true
 			});
 		} catch {
@@ -666,7 +662,7 @@ function createPusherRealtimeProvider() {
 			handlers.onStatus(toStatus(change.current));
 		});
 		const channels = [...new Set(phones.filter((phone) => phone !== ""))].map((phone) => {
-			const channelName = channelForPhone(config.pusher.channel_pattern, phone);
+			const channelName = channelForPhone(config.channelPattern ?? DEFAULT_CHANNEL_PATTERN, phone);
 			pusher.subscribe(channelName).bind_global((eventName, data) => {
 				handlers.onEvent(channelName, eventName, data);
 			});
@@ -795,7 +791,6 @@ function createEmergencyController(deps) {
 	let sessionPromise = null;
 	let refreshing = false;
 	let realtimeSubscription = null;
-	let realtimeConfig = null;
 	let subscribedPhones = [];
 	let messageSequence = 0;
 	let lastReconcileAt = 0;
@@ -853,9 +848,12 @@ function createEmergencyController(deps) {
 		realtimeSubscription = null;
 		subscribedPhones = [];
 	}
-	function startRealtime(realtime, responders) {
-		if (!realtime) return;
-		realtimeConfig = realtime;
+	function startRealtime(responders) {
+		const realtime = config.realtime ?? null;
+		if (!realtime) {
+			if (responders.length > 0) patch({ realtimeStatus: "unavailable" });
+			return;
+		}
 		const phones = [...new Set(responders.map((responder) => responder.phone))];
 		if (realtimeSubscription && phones.length === subscribedPhones.length && phones.every((phone, index) => phone === subscribedPhones[index])) return;
 		realtimeSubscription?.disconnect();
@@ -889,7 +887,7 @@ function createEmergencyController(deps) {
 		const phase = get().phase.kind;
 		if (phase === "idle" || phase === "error") transition({ kind: "initializing" });
 		try {
-			realtimeConfig = (await bff.config()).realtime;
+			await bff.config();
 			const session = await bff.session(config.code);
 			patch({
 				sessionReady: true,
@@ -919,7 +917,6 @@ function createEmergencyController(deps) {
 	async function hydrateCurrent() {
 		try {
 			const current = await bff.current();
-			realtimeConfig = current.realtime;
 			if (current.active && current.emergency) {
 				const snapshot = payloadToSnapshot(current.emergency, { code: config.code });
 				patch({
@@ -935,7 +932,7 @@ function createEmergencyController(deps) {
 					emergencyId: snapshot.emergencyId,
 					simulated: snapshot.simulated
 				});
-				startRealtime(current.realtime, snapshot.responders);
+				startRealtime(snapshot.responders);
 				events.emit("emergency:resumed", { snapshot });
 				return;
 			}
@@ -1017,7 +1014,7 @@ function createEmergencyController(deps) {
 			});
 			pushMessage(failures.length > 0 ? "warning" : "success", failures.length > 0 ? copy.partialFailure : copy.activeBanner);
 			events.emit("emergency:activated", { snapshot: hydrated });
-			startRealtime(realtimeConfig, responders);
+			startRealtime(responders);
 		} catch (error) {
 			const normalized = toEmergencyError(error, "network");
 			if (normalized.code === "emergency_already_active") {
@@ -1109,7 +1106,7 @@ function createEmergencyController(deps) {
 				emergencyId: updated.emergencyId,
 				simulated: updated.simulated
 			});
-			startRealtime(realtimeConfig, responders);
+			startRealtime(responders);
 			events.emit("emergency:updated", { snapshot: updated });
 		} catch (error) {
 			const normalized = toEmergencyError(error, "network");
@@ -1242,7 +1239,6 @@ function createEmergencyController(deps) {
 		bff.destroy();
 		realtimeSubscription?.disconnect();
 		realtimeSubscription = null;
-		realtimeConfig = null;
 		subscribedPhones = [];
 		patch({
 			destroyed: true,
@@ -1373,6 +1369,24 @@ function installEmergencyFonts(input) {
 
 // src/core/config.ts
 const EMERGENCY_CODE_PATTERN = /^[A-Za-z][A-Za-z0-9]{5}$/;
+const DEFAULT_REALTIME_CHANNEL_PATTERN = "whatsapp.{phone}";
+/**
+* Validates the host-supplied realtime block. Returns `null` when the value is
+* present but invalid; callers treat `undefined` as "realtime not requested".
+*/
+function normalizeRealtimeConfig(value) {
+	if (!isRecord(value)) return null;
+	const key = value["key"];
+	const cluster = value["cluster"];
+	const channelPattern = value["channelPattern"];
+	if (typeof key !== "string" || key.trim() === "" || typeof cluster !== "string" || cluster.trim() === "") return null;
+	if (channelPattern !== void 0 && (typeof channelPattern !== "string" || channelPattern.trim() === "" || !channelPattern.includes("{phone}"))) return null;
+	return {
+		key,
+		cluster,
+		channelPattern: channelPattern ?? "whatsapp.{phone}"
+	};
+}
 const LOOPBACK_HOSTS = /* @__PURE__ */ new Set([
 	"localhost",
 	"127.0.0.1",
@@ -1433,6 +1447,12 @@ function validateConfig(config) {
 		config: null,
 		error: createEmergencyError("configuration", "The fallback requires a non-empty phone and label.")
 	};
+	const realtime = config.realtime === void 0 ? void 0 : normalizeRealtimeConfig(config.realtime);
+	if (realtime === null) return {
+		ok: false,
+		config: null,
+		error: createEmergencyError("configuration", "The realtime configuration requires a non-empty key and cluster, and a channel pattern containing {phone}.")
+	};
 	return {
 		ok: true,
 		error: null,
@@ -1443,7 +1463,8 @@ function validateConfig(config) {
 			locale: config.locale ?? "es",
 			geolocationTimeoutMs: config.geolocationTimeoutMs ?? 8e3,
 			requestTimeoutMs: config.requestTimeoutMs ?? 15e3,
-			fontLoading: normalizeFontLoading(config.fontLoading)
+			fontLoading: normalizeFontLoading(config.fontLoading),
+			realtime
 		}
 	};
 }

package/dist/index.d.cts

@@ -101,6 +101,17 @@ interface EmergencyGeolocation {
   readonly longitude: number;
   readonly accuracy?: number;
 }
+interface EmergencyRealtimeConfig {
+  /** Public Pusher app key supplied by the host. */
+  readonly key: string;
+  /** Pusher cluster that serves the app key. */
+  readonly cluster: string;
+  /**
+   * Channel name pattern. `{phone}` is replaced with the responder phone in
+   * digits-only form. Defaults to `whatsapp.{phone}`.
+   */
+  readonly channelPattern?: string;
+}
 interface EmergencyConfig {
   /** Full BFF route prefix, for example `https://example.com/de-bff/emergency`. */
   readonly bffBaseUrl: string;
@@ -122,6 +133,11 @@ interface EmergencyConfig {
   readonly geolocationTimeoutMs?: number;
   /** Request timeout in milliseconds. Defaults to 15000. */
   readonly requestTimeoutMs?: number;
+  /**
+   * Public Pusher values supplied by the host. When omitted, the client stays
+   * in pull mode and never opens a realtime connection.
+   */
+  readonly realtime?: EmergencyRealtimeConfig;
 }
 interface EmergencySnapshot {
   readonly emergencyId: string;
@@ -239,18 +255,8 @@ interface EmergencyMountOptions extends EmergencyConfig {
  * message, and an inert client.
  */
 export declare function mount(options: EmergencyMountOptions): EmergencyClient;
-interface RealtimePusherConfig {
-  readonly key: string;
-  readonly cluster: string;
-  readonly channel_pattern: string;
-}
-interface RealtimePublicConfig {
-  readonly mode: 'public';
-  readonly pusher: RealtimePusherConfig;
-}
 interface ConfigResponse {
   readonly route_prefix: string;
-  readonly realtime: RealtimePublicConfig;
   readonly csrf_token: string;
 }
 interface SessionResponse {
@@ -292,7 +298,6 @@ type EmergencyPayload = Readonly<Record<string, unknown>>;
 interface CurrentResponse {
   readonly active: boolean;
   readonly emergency: EmergencyPayload | null;
-  readonly realtime: RealtimePublicConfig;
 }
 interface GeolocationRequest {
   readonly latitude: number;
@@ -377,7 +382,7 @@ interface RealtimeProvider {
    * Returns `null` when the realtime configuration is unusable, in which case
    * the client keeps working in pull mode.
    */
-  subscribe(config: RealtimePublicConfig, phones: readonly string[], handlers: RealtimeHandlers): RealtimeSubscription | null;
+  subscribe(config: EmergencyRealtimeConfig, phones: readonly string[], handlers: RealtimeHandlers): RealtimeSubscription | null;
 }
 export declare function createPusherRealtimeProvider(): RealtimeProvider;
 type EmergencyStore = StoreApi<EmergencyClientState>;
@@ -409,7 +414,10 @@ interface ConfigValidationResult {
   readonly error: EmergencyError | null;
   readonly config: EmergencyConfig | null;
 }
-export declare function validateConfig(config: EmergencyConfig): ConfigValidationResult;
+type EmergencyConfigInput = Omit<EmergencyConfig, 'realtime'> & {
+  readonly realtime?: unknown;
+};
+export declare function validateConfig(config: EmergencyConfigInput): ConfigValidationResult;
 export declare function themeToCssVariables(theme: EmergencyTheme | undefined): Record<string, string>;
 interface EmergencyErrorOptions {
   status?: number | null;
@@ -428,5 +436,5 @@ export declare class EmergencyClientError extends Error {
   readonly error: EmergencyError;
   constructor(error: EmergencyError);
 }
-export type { AbortResponse, AbortResult, ActivateRequest, BffClient, BffClientOptions, ConfigResponse, CsrfStrategy, CurrentResponse, EmergencyClient, EmergencyClientState, EmergencyConfig, EmergencyController, EmergencyControllerDeps, EmergencyError, EmergencyErrorCode, EmergencyEventEmitter, EmergencyEventMap, EmergencyEventName, EmergencyFailure, EmergencyFallback, EmergencyFontFamilyFlags, EmergencyFontLoading, EmergencyGeolocation, EmergencyMountOptions, EmergencyOperation, EmergencyPhase, EmergencyPhaseName, EmergencyResultPayload, EmergencySnapshot, EmergencyStore, EmergencyTheme, EmergencyTrigger, FailurePayload, Message, MessageKind, PanelCloseReason, PanelOpenReason, RealtimeStatus, RefreshResponse, Responder, ResponderPayload, ResponderStatus, SessionResponse, SimulationResult };
+export type { AbortResponse, AbortResult, ActivateRequest, BffClient, BffClientOptions, ConfigResponse, CsrfStrategy, CurrentResponse, EmergencyClient, EmergencyClientState, EmergencyConfig, EmergencyConfigInput, EmergencyController, EmergencyControllerDeps, EmergencyError, EmergencyErrorCode, EmergencyEventEmitter, EmergencyEventMap, EmergencyEventName, EmergencyFailure, EmergencyFallback, EmergencyFontFamilyFlags, EmergencyFontLoading, EmergencyGeolocation, EmergencyMountOptions, EmergencyOperation, EmergencyPhase, EmergencyPhaseName, EmergencyRealtimeConfig, EmergencyResultPayload, EmergencySnapshot, EmergencyStore, EmergencyTheme, EmergencyTrigger, FailurePayload, Message, MessageKind, PanelCloseReason, PanelOpenReason, RealtimeStatus, RefreshResponse, Responder, ResponderPayload, ResponderStatus, SessionResponse, SimulationResult };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -101,6 +101,17 @@ interface EmergencyGeolocation {
   readonly longitude: number;
   readonly accuracy?: number;
 }
+interface EmergencyRealtimeConfig {
+  /** Public Pusher app key supplied by the host. */
+  readonly key: string;
+  /** Pusher cluster that serves the app key. */
+  readonly cluster: string;
+  /**
+   * Channel name pattern. `{phone}` is replaced with the responder phone in
+   * digits-only form. Defaults to `whatsapp.{phone}`.
+   */
+  readonly channelPattern?: string;
+}
 interface EmergencyConfig {
   /** Full BFF route prefix, for example `https://example.com/de-bff/emergency`. */
   readonly bffBaseUrl: string;
@@ -122,6 +133,11 @@ interface EmergencyConfig {
   readonly geolocationTimeoutMs?: number;
   /** Request timeout in milliseconds. Defaults to 15000. */
   readonly requestTimeoutMs?: number;
+  /**
+   * Public Pusher values supplied by the host. When omitted, the client stays
+   * in pull mode and never opens a realtime connection.
+   */
+  readonly realtime?: EmergencyRealtimeConfig;
 }
 interface EmergencySnapshot {
   readonly emergencyId: string;
@@ -239,18 +255,8 @@ interface EmergencyMountOptions extends EmergencyConfig {
  * message, and an inert client.
  */
 export declare function mount(options: EmergencyMountOptions): EmergencyClient;
-interface RealtimePusherConfig {
-  readonly key: string;
-  readonly cluster: string;
-  readonly channel_pattern: string;
-}
-interface RealtimePublicConfig {
-  readonly mode: 'public';
-  readonly pusher: RealtimePusherConfig;
-}
 interface ConfigResponse {
   readonly route_prefix: string;
-  readonly realtime: RealtimePublicConfig;
   readonly csrf_token: string;
 }
 interface SessionResponse {
@@ -292,7 +298,6 @@ type EmergencyPayload = Readonly<Record<string, unknown>>;
 interface CurrentResponse {
   readonly active: boolean;
   readonly emergency: EmergencyPayload | null;
-  readonly realtime: RealtimePublicConfig;
 }
 interface GeolocationRequest {
   readonly latitude: number;
@@ -377,7 +382,7 @@ interface RealtimeProvider {
    * Returns `null` when the realtime configuration is unusable, in which case
    * the client keeps working in pull mode.
    */
-  subscribe(config: RealtimePublicConfig, phones: readonly string[], handlers: RealtimeHandlers): RealtimeSubscription | null;
+  subscribe(config: EmergencyRealtimeConfig, phones: readonly string[], handlers: RealtimeHandlers): RealtimeSubscription | null;
 }
 export declare function createPusherRealtimeProvider(): RealtimeProvider;
 type EmergencyStore = StoreApi<EmergencyClientState>;
@@ -409,7 +414,10 @@ interface ConfigValidationResult {
   readonly error: EmergencyError | null;
   readonly config: EmergencyConfig | null;
 }
-export declare function validateConfig(config: EmergencyConfig): ConfigValidationResult;
+type EmergencyConfigInput = Omit<EmergencyConfig, 'realtime'> & {
+  readonly realtime?: unknown;
+};
+export declare function validateConfig(config: EmergencyConfigInput): ConfigValidationResult;
 export declare function themeToCssVariables(theme: EmergencyTheme | undefined): Record<string, string>;
 interface EmergencyErrorOptions {
   status?: number | null;
@@ -428,5 +436,5 @@ export declare class EmergencyClientError extends Error {
   readonly error: EmergencyError;
   constructor(error: EmergencyError);
 }
-export type { AbortResponse, AbortResult, ActivateRequest, BffClient, BffClientOptions, ConfigResponse, CsrfStrategy, CurrentResponse, EmergencyClient, EmergencyClientState, EmergencyConfig, EmergencyController, EmergencyControllerDeps, EmergencyError, EmergencyErrorCode, EmergencyEventEmitter, EmergencyEventMap, EmergencyEventName, EmergencyFailure, EmergencyFallback, EmergencyFontFamilyFlags, EmergencyFontLoading, EmergencyGeolocation, EmergencyMountOptions, EmergencyOperation, EmergencyPhase, EmergencyPhaseName, EmergencyResultPayload, EmergencySnapshot, EmergencyStore, EmergencyTheme, EmergencyTrigger, FailurePayload, Message, MessageKind, PanelCloseReason, PanelOpenReason, RealtimeStatus, RefreshResponse, Responder, ResponderPayload, ResponderStatus, SessionResponse, SimulationResult };
+export type { AbortResponse, AbortResult, ActivateRequest, BffClient, BffClientOptions, ConfigResponse, CsrfStrategy, CurrentResponse, EmergencyClient, EmergencyClientState, EmergencyConfig, EmergencyConfigInput, EmergencyController, EmergencyControllerDeps, EmergencyError, EmergencyErrorCode, EmergencyEventEmitter, EmergencyEventMap, EmergencyEventName, EmergencyFailure, EmergencyFallback, EmergencyFontFamilyFlags, EmergencyFontLoading, EmergencyGeolocation, EmergencyMountOptions, EmergencyOperation, EmergencyPhase, EmergencyPhaseName, EmergencyRealtimeConfig, EmergencyResultPayload, EmergencySnapshot, EmergencyStore, EmergencyTheme, EmergencyTrigger, FailurePayload, Message, MessageKind, PanelCloseReason, PanelOpenReason, RealtimeStatus, RefreshResponse, Responder, ResponderPayload, ResponderStatus, SessionResponse, SimulationResult };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -55,13 +55,8 @@ function isFiniteNumber(value) {
 function isArrayOf(value, guard) {
 	return Array.isArray(value) && value.every(guard);
 }
-function isRealtimeConfig(value) {
-	if (!isRecord(value) || value["mode"] !== "public" || !isRecord(value["pusher"])) return false;
-	const pusher = value["pusher"];
-	return isString(pusher["key"]) && isString(pusher["cluster"]) && isString(pusher["channel_pattern"]);
-}
 function isConfigResponse(value) {
-	return isRecord(value) && isString(value["route_prefix"]) && isString(value["csrf_token"]) && isRealtimeConfig(value["realtime"]);
+	return isRecord(value) && isString(value["route_prefix"]) && isString(value["csrf_token"]);
 }
 function isSessionResponse(value) {
 	return isRecord(value) && isString(value["code"]) && isString(value["csrf_token"]) && isFiniteNumber(value["expires_in"]);
@@ -79,7 +74,7 @@ function isEmergencyResultPayload(value) {
 	return (value["emergency_id"] === null || isString(value["emergency_id"])) && isBoolean(value["simulated"]) && isArrayOf(value["responders"], isResponderPayload) && isArrayOf(value["failures"], isFailurePayload);
 }
 function isCurrentResponse(value) {
-	if (!isRecord(value) || !isBoolean(value["active"]) || !isRealtimeConfig(value["realtime"])) return false;
+	if (!isRecord(value) || !isBoolean(value["active"])) return false;
 	return value["emergency"] === null || isRecord(value["emergency"]) && !Array.isArray(value["emergency"]);
 }
 function isRefreshResponse(value) {
@@ -605,8 +600,9 @@ function themeToCssVariables(theme) {
 }
 
 // src/core/realtime.ts
+const DEFAULT_CHANNEL_PATTERN = "whatsapp.{phone}";
 function channelForPhone(pattern, phone) {
-	return pattern.replace("{phone}", phone.replace(/^\+/, ""));
+	return pattern.replace("{phone}", phone.replace(/\D/g, ""));
 }
 function toStatus(state) {
 	switch (state) {
@@ -621,11 +617,11 @@ function toStatus(state) {
 }
 function createPusherRealtimeProvider() {
 	return { subscribe(config, phones, handlers) {
-		if (typeof window === "undefined" || !config.pusher.key || !config.pusher.cluster) return null;
+		if (typeof window === "undefined" || !config.key || !config.cluster) return null;
 		let pusher;
 		try {
-			pusher = new Pusher(config.pusher.key, {
-				cluster: config.pusher.cluster,
+			pusher = new Pusher(config.key, {
+				cluster: config.cluster,
 				forceTLS: true
 			});
 		} catch {
@@ -637,7 +633,7 @@ function createPusherRealtimeProvider() {
 			handlers.onStatus(toStatus(change.current));
 		});
 		const channels = [...new Set(phones.filter((phone) => phone !== ""))].map((phone) => {
-			const channelName = channelForPhone(config.pusher.channel_pattern, phone);
+			const channelName = channelForPhone(config.channelPattern ?? DEFAULT_CHANNEL_PATTERN, phone);
 			pusher.subscribe(channelName).bind_global((eventName, data) => {
 				handlers.onEvent(channelName, eventName, data);
 			});
@@ -766,7 +762,6 @@ function createEmergencyController(deps) {
 	let sessionPromise = null;
 	let refreshing = false;
 	let realtimeSubscription = null;
-	let realtimeConfig = null;
 	let subscribedPhones = [];
 	let messageSequence = 0;
 	let lastReconcileAt = 0;
@@ -824,9 +819,12 @@ function createEmergencyController(deps) {
 		realtimeSubscription = null;
 		subscribedPhones = [];
 	}
-	function startRealtime(realtime, responders) {
-		if (!realtime) return;
-		realtimeConfig = realtime;
+	function startRealtime(responders) {
+		const realtime = config.realtime ?? null;
+		if (!realtime) {
+			if (responders.length > 0) patch({ realtimeStatus: "unavailable" });
+			return;
+		}
 		const phones = [...new Set(responders.map((responder) => responder.phone))];
 		if (realtimeSubscription && phones.length === subscribedPhones.length && phones.every((phone, index) => phone === subscribedPhones[index])) return;
 		realtimeSubscription?.disconnect();
@@ -860,7 +858,7 @@ function createEmergencyController(deps) {
 		const phase = get().phase.kind;
 		if (phase === "idle" || phase === "error") transition({ kind: "initializing" });
 		try {
-			realtimeConfig = (await bff.config()).realtime;
+			await bff.config();
 			const session = await bff.session(config.code);
 			patch({
 				sessionReady: true,
@@ -890,7 +888,6 @@ function createEmergencyController(deps) {
 	async function hydrateCurrent() {
 		try {
 			const current = await bff.current();
-			realtimeConfig = current.realtime;
 			if (current.active && current.emergency) {
 				const snapshot = payloadToSnapshot(current.emergency, { code: config.code });
 				patch({
@@ -906,7 +903,7 @@ function createEmergencyController(deps) {
 					emergencyId: snapshot.emergencyId,
 					simulated: snapshot.simulated
 				});
-				startRealtime(current.realtime, snapshot.responders);
+				startRealtime(snapshot.responders);
 				events.emit("emergency:resumed", { snapshot });
 				return;
 			}
@@ -988,7 +985,7 @@ function createEmergencyController(deps) {
 			});
 			pushMessage(failures.length > 0 ? "warning" : "success", failures.length > 0 ? copy.partialFailure : copy.activeBanner);
 			events.emit("emergency:activated", { snapshot: hydrated });
-			startRealtime(realtimeConfig, responders);
+			startRealtime(responders);
 		} catch (error) {
 			const normalized = toEmergencyError(error, "network");
 			if (normalized.code === "emergency_already_active") {
@@ -1080,7 +1077,7 @@ function createEmergencyController(deps) {
 				emergencyId: updated.emergencyId,
 				simulated: updated.simulated
 			});
-			startRealtime(realtimeConfig, responders);
+			startRealtime(responders);
 			events.emit("emergency:updated", { snapshot: updated });
 		} catch (error) {
 			const normalized = toEmergencyError(error, "network");
@@ -1213,7 +1210,6 @@ function createEmergencyController(deps) {
 		bff.destroy();
 		realtimeSubscription?.disconnect();
 		realtimeSubscription = null;
-		realtimeConfig = null;
 		subscribedPhones = [];
 		patch({
 			destroyed: true,
@@ -1344,6 +1340,24 @@ function installEmergencyFonts(input) {
 
 // src/core/config.ts
 const EMERGENCY_CODE_PATTERN = /^[A-Za-z][A-Za-z0-9]{5}$/;
+const DEFAULT_REALTIME_CHANNEL_PATTERN = "whatsapp.{phone}";
+/**
+* Validates the host-supplied realtime block. Returns `null` when the value is
+* present but invalid; callers treat `undefined` as "realtime not requested".
+*/
+function normalizeRealtimeConfig(value) {
+	if (!isRecord(value)) return null;
+	const key = value["key"];
+	const cluster = value["cluster"];
+	const channelPattern = value["channelPattern"];
+	if (typeof key !== "string" || key.trim() === "" || typeof cluster !== "string" || cluster.trim() === "") return null;
+	if (channelPattern !== void 0 && (typeof channelPattern !== "string" || channelPattern.trim() === "" || !channelPattern.includes("{phone}"))) return null;
+	return {
+		key,
+		cluster,
+		channelPattern: channelPattern ?? "whatsapp.{phone}"
+	};
+}
 const LOOPBACK_HOSTS = /* @__PURE__ */ new Set([
 	"localhost",
 	"127.0.0.1",
@@ -1404,6 +1418,12 @@ function validateConfig(config) {
 		config: null,
 		error: createEmergencyError("configuration", "The fallback requires a non-empty phone and label.")
 	};
+	const realtime = config.realtime === void 0 ? void 0 : normalizeRealtimeConfig(config.realtime);
+	if (realtime === null) return {
+		ok: false,
+		config: null,
+		error: createEmergencyError("configuration", "The realtime configuration requires a non-empty key and cluster, and a channel pattern containing {phone}.")
+	};
 	return {
 		ok: true,
 		error: null,
@@ -1414,7 +1434,8 @@ function validateConfig(config) {
 			locale: config.locale ?? "es",
 			geolocationTimeoutMs: config.geolocationTimeoutMs ?? 8e3,
 			requestTimeoutMs: config.requestTimeoutMs ?? 15e3,
-			fontLoading: normalizeFontLoading(config.fontLoading)
+			fontLoading: normalizeFontLoading(config.fontLoading),
+			realtime
 		}
 	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dataemergencia/emergency",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Framework-agnostic emergency client for DataEmergencia, with a mountable React panel and an IIFE build.",
   "license": "MIT",
   "type": "module",