@zssz-soft/firebase-functions-shared 1.2.16 → 1.4.0

package/lib/modules/events/booking-event.handlers.js

@@ -0,0 +1,274 @@
+"use strict";
+/**
+ * Booking Event Handlers (Eventarc Subscribers)
+ *
+ * Subscribes to booking events published by booking-event.triggers.ts
+ * and handles email notifications based on the event type.
+ *
+ * Architecture:
+ * - Single handler subscribes to all booking events (wildcard pattern)
+ * - NotificationMatrix determines what emails to send for each event
+ * - Template generators produce bilingual email content
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBookingEmailHandlers = createBookingEmailHandlers;
+const firebase_functions_1 = require("firebase-functions");
+const eventarc_1 = require("firebase-functions/v2/eventarc");
+const email_service_1 = require("../email/email.service");
+const email_validator_1 = require("../email/email.validator");
+const error_reporting_1 = require("../error-reporting");
+const booking_email_templates_1 = require("../booking/booking-email.templates");
+const booking_event_models_1 = require("./booking-event.models");
+/**
+ * Notification matrix - maps event types to notification configuration
+ */
+const NotificationMatrix = {
+    [booking_event_models_1.BookingEventTypes.BOOKING_SUBMITTED]: {
+        sendToGuest: true,
+        sendToAdmin: true,
+        guestTemplate: booking_email_templates_1.generateGuestConfirmationEmail,
+        adminTemplate: booking_email_templates_1.generateAdminNotificationEmail,
+    },
+    [booking_event_models_1.BookingEventTypes.BOOKING_APPROVED]: {
+        sendToGuest: true,
+        sendToAdmin: false,
+        guestTemplate: booking_email_templates_1.generateBookingApprovedEmail,
+    },
+    [booking_event_models_1.BookingEventTypes.BOOKING_READY]: {
+        sendToGuest: true,
+        sendToAdmin: false,
+        guestTemplate: booking_email_templates_1.generateBookingReadyEmail,
+    },
+    [booking_event_models_1.BookingEventTypes.BOOKING_REJECTED]: {
+        sendToGuest: true,
+        sendToAdmin: false,
+        guestTemplate: booking_email_templates_1.generateBookingRejectedEmail,
+    },
+    [booking_event_models_1.BookingEventTypes.BOOKING_COMPLETED]: {
+        sendToGuest: true,
+        sendToAdmin: false,
+        guestTemplate: booking_email_templates_1.generateBookingCompletedEmail,
+    },
+    [booking_event_models_1.BookingEventTypes.BOOKING_CANCELLED]: {
+        sendToGuest: true,
+        sendToAdmin: true,
+        guestTemplate: booking_email_templates_1.generateBookingCancelledEmail,
+        adminTemplate: booking_email_templates_1.generateBookingCancelledEmail, // Same template, different recipient
+    },
+    [booking_event_models_1.BookingEventTypes.BOOKING_USER_CANCELLED]: {
+        sendToGuest: true,
+        sendToAdmin: true,
+        guestTemplate: booking_email_templates_1.generateBookingCancelledEmail,
+        adminTemplate: booking_email_templates_1.generateBookingCancelledEmail,
+    },
+    [booking_event_models_1.BookingEventTypes.BOOKING_INSTANT_CONFIRMED]: {
+        sendToGuest: true,
+        sendToAdmin: true,
+        guestTemplate: booking_email_templates_1.generateVipConfirmationEmail,
+        adminTemplate: booking_email_templates_1.generateVipStaffNotificationEmail,
+    },
+    [booking_event_models_1.BookingEventTypes.BOOKING_VIP_CANCELLED]: {
+        sendToGuest: true,
+        sendToAdmin: true,
+        guestTemplate: booking_email_templates_1.generateBookingCancelledEmail,
+        adminTemplate: booking_email_templates_1.generateBookingCancelledEmail,
+    },
+};
+/**
+ * Get admin/owner email from booking data or config fallback
+ */
+function getAdminEmail(booking, cfg) {
+    var _a, _b;
+    // Try accommodation contact email first
+    const contactEmail = (_b = (_a = booking.accommodation) === null || _a === void 0 ? void 0 : _a.contact) === null || _b === void 0 ? void 0 : _b.email;
+    if (contactEmail && (0, email_validator_1.validateEmail)(contactEmail)) {
+        return contactEmail;
+    }
+    // Fallback to configured admin email
+    if (cfg.fallbackAdminEmail && (0, email_validator_1.validateEmail)(cfg.fallbackAdminEmail)) {
+        return cfg.fallbackAdminEmail;
+    }
+    // Try environment variable as last resort
+    const envAdminEmail = process.env.ADMIN_NOTIFICATION_EMAIL;
+    if (envAdminEmail && (0, email_validator_1.validateEmail)(envAdminEmail)) {
+        return envAdminEmail;
+    }
+    return null;
+}
+/**
+ * Create booking email event handlers
+ *
+ * @param config - Configuration options
+ * @returns Object containing event handler functions
+ *
+ * @example
+ * ```typescript
+ * const handlers = createBookingEmailHandlers({ region: 'europe-west1' });
+ * export const onBookingEmailHandler = handlers.onBookingEvent;
+ * ```
+ */
+function createBookingEmailHandlers(config = {}) {
+    const cfg = Object.assign(Object.assign({}, booking_event_models_1.DEFAULT_BOOKING_EVENT_CONFIG), config);
+    const errorReporter = (0, error_reporting_1.createErrorReporter)('BookingEmailHandler');
+    /**
+     * Send email using the email service
+     */
+    async function sendEmail(to, template, booking, context) {
+        try {
+            const email = template(booking, context);
+            const result = await email_service_1.emailService.sendEmail({
+                to,
+                subject: email.subject,
+                html: email.html,
+                text: email.text,
+            });
+            return result.success;
+        }
+        catch (error) {
+            firebase_functions_1.logger.error(`[EmailHandler] Failed to send email to ${to}`, error);
+            return false;
+        }
+    }
+    /**
+     * Handle a booking event and send appropriate notifications
+     */
+    async function handleBookingEvent(eventType, payload) {
+        var _a, _b;
+        const notificationConfig = NotificationMatrix[eventType];
+        if (!notificationConfig) {
+            firebase_functions_1.logger.info(`[EmailHandler] No notification config for event: ${eventType}`);
+            return;
+        }
+        const { booking, bookingId, context } = payload;
+        firebase_functions_1.logger.info(`[EmailHandler] Processing ${eventType} for booking ${bookingId}`, {
+            guestEmail: (_a = booking.guest) === null || _a === void 0 ? void 0 : _a.email,
+            sendToGuest: notificationConfig.sendToGuest,
+            sendToAdmin: notificationConfig.sendToAdmin,
+        });
+        // Send guest email
+        if (notificationConfig.sendToGuest && notificationConfig.guestTemplate) {
+            const guestEmail = (_b = booking.guest) === null || _b === void 0 ? void 0 : _b.email;
+            if (guestEmail && (0, email_validator_1.validateEmail)(guestEmail)) {
+                try {
+                    const success = await sendEmail(guestEmail, notificationConfig.guestTemplate, booking, context);
+                    if (success) {
+                        firebase_functions_1.logger.info(`[EmailHandler] Guest email sent for ${eventType}: ${bookingId}`);
+                    }
+                    else {
+                        errorReporter.warn(new Error('Guest email send returned false'), {
+                            requestId: bookingId,
+                            metadata: { type: 'guest_email_failed', eventType, email: guestEmail },
+                        });
+                    }
+                }
+                catch (error) {
+                    errorReporter.report(error, {
+                        requestId: bookingId,
+                        metadata: { type: 'guest_email_error', eventType, email: guestEmail },
+                    });
+                }
+            }
+            else {
+                firebase_functions_1.logger.warn(`[EmailHandler] Invalid or missing guest email for booking ${bookingId}`);
+            }
+        }
+        // Send admin email
+        if (cfg.adminNotificationEnabled &&
+            notificationConfig.sendToAdmin &&
+            notificationConfig.adminTemplate) {
+            const adminEmail = getAdminEmail(booking, cfg);
+            if (adminEmail) {
+                try {
+                    const success = await sendEmail(adminEmail, notificationConfig.adminTemplate, booking, context);
+                    if (success) {
+                        firebase_functions_1.logger.info(`[EmailHandler] Admin email sent for ${eventType}: ${bookingId}`);
+                    }
+                    else {
+                        errorReporter.warn(new Error('Admin email send returned false'), {
+                            requestId: bookingId,
+                            metadata: { type: 'admin_email_failed', eventType, email: adminEmail },
+                        });
+                    }
+                }
+                catch (error) {
+                    errorReporter.report(error, {
+                        requestId: bookingId,
+                        metadata: { type: 'admin_email_error', eventType, email: adminEmail },
+                    });
+                }
+            }
+            else {
+                firebase_functions_1.logger.warn(`[EmailHandler] No admin email available for booking ${bookingId}`);
+            }
+        }
+    }
+    return {
+        /**
+         * Universal handler for all booking events
+         *
+         * Subscribes to com.lodgeflow.booking.* events and routes to appropriate
+         * email templates based on the event type.
+         */
+        onBookingEvent: (0, eventarc_1.onCustomEventPublished)({
+            eventType: 'com.lodgeflow.booking.*',
+            channel: cfg.eventChannel,
+            region: cfg.region,
+            maxInstances: cfg.maxInstances,
+        }, async (event) => {
+            const eventType = event.type;
+            const payload = event.data;
+            if (!payload || !payload.booking || !payload.bookingId) {
+                firebase_functions_1.logger.warn(`[EmailHandler] Invalid event payload for ${eventType}`);
+                return;
+            }
+            await handleBookingEvent(eventType, payload);
+        }),
+        /**
+         * Individual handlers for specific event types (alternative approach)
+         * Use these if you need different scaling/configuration per event type
+         */
+        onBookingSubmitted: (0, eventarc_1.onCustomEventPublished)({
+            eventType: booking_event_models_1.BookingEventTypes.BOOKING_SUBMITTED,
+            channel: cfg.eventChannel,
+            region: cfg.region,
+        }, async (event) => {
+            await handleBookingEvent(event.type, event.data);
+        }),
+        onBookingApproved: (0, eventarc_1.onCustomEventPublished)({
+            eventType: booking_event_models_1.BookingEventTypes.BOOKING_APPROVED,
+            channel: cfg.eventChannel,
+            region: cfg.region,
+        }, async (event) => {
+            await handleBookingEvent(event.type, event.data);
+        }),
+        onBookingReady: (0, eventarc_1.onCustomEventPublished)({
+            eventType: booking_event_models_1.BookingEventTypes.BOOKING_READY,
+            channel: cfg.eventChannel,
+            region: cfg.region,
+        }, async (event) => {
+            await handleBookingEvent(event.type, event.data);
+        }),
+        onBookingRejected: (0, eventarc_1.onCustomEventPublished)({
+            eventType: booking_event_models_1.BookingEventTypes.BOOKING_REJECTED,
+            channel: cfg.eventChannel,
+            region: cfg.region,
+        }, async (event) => {
+            await handleBookingEvent(event.type, event.data);
+        }),
+        onBookingCompleted: (0, eventarc_1.onCustomEventPublished)({
+            eventType: booking_event_models_1.BookingEventTypes.BOOKING_COMPLETED,
+            channel: cfg.eventChannel,
+            region: cfg.region,
+        }, async (event) => {
+            await handleBookingEvent(event.type, event.data);
+        }),
+        onBookingCancelled: (0, eventarc_1.onCustomEventPublished)({
+            eventType: booking_event_models_1.BookingEventTypes.BOOKING_CANCELLED,
+            channel: cfg.eventChannel,
+            region: cfg.region,
+        }, async (event) => {
+            await handleBookingEvent(event.type, event.data);
+        }),
+    };
+}
+//# sourceMappingURL=booking-event.handlers.js.map

package/lib/modules/events/booking-event.handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking-event.handlers.js","sourceRoot":"","sources":["../../../src/modules/events/booking-event.handlers.ts"],"names":[],"mappings":"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"}

package/lib/modules/events/booking-event.models.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Booking Event Models
+ *
+ * Event types and payloads for booking workflow transitions.
+ * Used by Eventarc publishers and subscribers.
+ */
+import { BookingEmailData, BookingEmailConfig } from '../booking/booking-email.models';
+/**
+ * All booking workflow transition event types
+ *
+ * Naming convention: com.lodgeflow.booking.{action}
+ */
+export declare const BookingEventTypes: {
+    /** draft → pending_approval: New booking submitted for approval */
+    readonly BOOKING_SUBMITTED: "com.lodgeflow.booking.submitted";
+    /** pending_approval → confirmed: Admin approved the booking */
+    readonly BOOKING_APPROVED: "com.lodgeflow.booking.approved";
+    /** confirmed → ready: All conditions met for check-in */
+    readonly BOOKING_READY: "com.lodgeflow.booking.ready";
+    /** pending_approval → cancelled: Admin rejected the booking */
+    readonly BOOKING_REJECTED: "com.lodgeflow.booking.rejected";
+    /** ready → completed: Guest checked out */
+    readonly BOOKING_COMPLETED: "com.lodgeflow.booking.completed";
+    /** confirmed/ready → cancelled: Admin cancelled the booking */
+    readonly BOOKING_CANCELLED: "com.lodgeflow.booking.cancelled";
+    /** pending_approval/confirmed → cancelled: User cancelled their booking */
+    readonly BOOKING_USER_CANCELLED: "com.lodgeflow.booking.user_cancelled";
+    /** draft → confirmed: Instant VIP confirmation */
+    readonly BOOKING_INSTANT_CONFIRMED: "com.lodgeflow.booking.instant_confirmed";
+    /** VIP booking cancelled */
+    readonly BOOKING_VIP_CANCELLED: "com.lodgeflow.booking.vip_cancelled";
+};
+export type BookingEventType = (typeof BookingEventTypes)[keyof typeof BookingEventTypes];
+/**
+ * Transition context for workflow events
+ */
+export interface TransitionInfo {
+    /** Workflow transition identifier */
+    transitionId: string;
+    /** Previous workflow state */
+    from: string;
+    /** New workflow state */
+    to: string;
+    /** User ID who triggered the transition */
+    triggeredBy: string;
+    /** ISO timestamp when transition occurred */
+    triggeredAt: string;
+}
+/**
+ * Additional context for specific event types
+ */
+export interface BookingEventContext {
+    /** Reason for rejection or cancellation */
+    reason?: string;
+    /** Refund amount for cancellations */
+    refundAmount?: number;
+    /** Whether this is a VIP booking */
+    isVip?: boolean;
+}
+/**
+ * Payload for booking workflow events
+ */
+export interface BookingEventPayload {
+    /** Booking document ID */
+    bookingId: string;
+    /** Full booking data */
+    booking: BookingEmailData;
+    /** Workflow transition details */
+    transition: TransitionInfo;
+    /** Additional context (rejection reason, refund, etc.) */
+    context?: BookingEventContext;
+}
+/**
+ * Mapping from workflow transition IDs to event types
+ *
+ * Used to determine which event to publish based on the transition
+ */
+export declare const TransitionToEventMap: Record<string, BookingEventType>;
+/**
+ * Reverse mapping: state transitions to transition IDs
+ * Used when we only have before/after states
+ */
+export declare const StateChangeToTransitionMap: Record<string, Record<string, string>>;
+/**
+ * Configuration for booking event triggers
+ * Extends BookingEmailConfig with event-specific options
+ */
+export interface BookingEventConfig extends BookingEmailConfig {
+    /** Eventarc channel name (default: 'firebase') */
+    eventChannel: string;
+}
+/**
+ * Default configuration for booking events
+ */
+export declare const DEFAULT_BOOKING_EVENT_CONFIG: BookingEventConfig;
+/**
+ * Transitions that should NOT trigger email notifications
+ */
+export declare const SILENT_TRANSITIONS: Set<string>;
+/**
+ * Check if a transition should trigger notifications
+ */
+export declare function shouldNotify(transitionId: string): boolean;
+/**
+ * Infer transition ID from state change
+ * Falls back to generic transition if exact match not found
+ */
+export declare function inferTransitionId(fromState: string, toState: string): string | null;
+//# sourceMappingURL=booking-event.models.d.ts.map

package/lib/modules/events/booking-event.models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking-event.models.d.ts","sourceRoot":"","sources":["../../../src/modules/events/booking-event.models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAEnB,MAAM,iCAAiC,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAE5B,mEAAmE;;IAGnE,+DAA+D;;IAG/D,yDAAyD;;IAGzD,+DAA+D;;IAG/D,2CAA2C;;IAG3C,+DAA+D;;IAG/D,2EAA2E;;IAI3E,kDAAkD;;IAGlD,4BAA4B;;CAEpB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IAErB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IAEX,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IAEpB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,wBAAwB;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAE1B,kCAAkC;IAClC,UAAU,EAAE,cAAc,CAAC;IAE3B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAkBjE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkB7E,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,kBAG1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,aAA4B,CAAC;AAE5D;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMnF"}

package/lib/modules/events/booking-event.models.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Booking Event Models
+ *
+ * Event types and payloads for booking workflow transitions.
+ * Used by Eventarc publishers and subscribers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SILENT_TRANSITIONS = exports.DEFAULT_BOOKING_EVENT_CONFIG = exports.StateChangeToTransitionMap = exports.TransitionToEventMap = exports.BookingEventTypes = void 0;
+exports.shouldNotify = shouldNotify;
+exports.inferTransitionId = inferTransitionId;
+const booking_email_models_1 = require("../booking/booking-email.models");
+/**
+ * All booking workflow transition event types
+ *
+ * Naming convention: com.lodgeflow.booking.{action}
+ */
+exports.BookingEventTypes = {
+    // Standard Workflow Events
+    /** draft → pending_approval: New booking submitted for approval */
+    BOOKING_SUBMITTED: 'com.lodgeflow.booking.submitted',
+    /** pending_approval → confirmed: Admin approved the booking */
+    BOOKING_APPROVED: 'com.lodgeflow.booking.approved',
+    /** confirmed → ready: All conditions met for check-in */
+    BOOKING_READY: 'com.lodgeflow.booking.ready',
+    /** pending_approval → cancelled: Admin rejected the booking */
+    BOOKING_REJECTED: 'com.lodgeflow.booking.rejected',
+    /** ready → completed: Guest checked out */
+    BOOKING_COMPLETED: 'com.lodgeflow.booking.completed',
+    /** confirmed/ready → cancelled: Admin cancelled the booking */
+    BOOKING_CANCELLED: 'com.lodgeflow.booking.cancelled',
+    /** pending_approval/confirmed → cancelled: User cancelled their booking */
+    BOOKING_USER_CANCELLED: 'com.lodgeflow.booking.user_cancelled',
+    // Express Workflow Events (VIP)
+    /** draft → confirmed: Instant VIP confirmation */
+    BOOKING_INSTANT_CONFIRMED: 'com.lodgeflow.booking.instant_confirmed',
+    /** VIP booking cancelled */
+    BOOKING_VIP_CANCELLED: 'com.lodgeflow.booking.vip_cancelled',
+};
+/**
+ * Mapping from workflow transition IDs to event types
+ *
+ * Used to determine which event to publish based on the transition
+ */
+exports.TransitionToEventMap = {
+    // Standard workflow transitions
+    submit_for_approval: exports.BookingEventTypes.BOOKING_SUBMITTED,
+    approve_booking: exports.BookingEventTypes.BOOKING_APPROVED,
+    mark_ready: exports.BookingEventTypes.BOOKING_READY,
+    reject_booking: exports.BookingEventTypes.BOOKING_REJECTED,
+    complete_booking: exports.BookingEventTypes.BOOKING_COMPLETED,
+    cancel_ready_booking: exports.BookingEventTypes.BOOKING_CANCELLED,
+    cancel_confirmed_booking: exports.BookingEventTypes.BOOKING_CANCELLED,
+    user_cancel_pending: exports.BookingEventTypes.BOOKING_USER_CANCELLED,
+    user_cancel_confirmed: exports.BookingEventTypes.BOOKING_USER_CANCELLED,
+    // Express workflow transitions
+    instant_confirm: exports.BookingEventTypes.BOOKING_INSTANT_CONFIRMED,
+    cancel_vip_booking: exports.BookingEventTypes.BOOKING_VIP_CANCELLED,
+    // Draft cancellation - no event needed
+    // cancel_draft: null,
+};
+/**
+ * Reverse mapping: state transitions to transition IDs
+ * Used when we only have before/after states
+ */
+exports.StateChangeToTransitionMap = {
+    draft: {
+        pending_approval: 'submit_for_approval',
+        confirmed: 'instant_confirm', // Express workflow
+        cancelled: 'cancel_draft',
+    },
+    pending_approval: {
+        confirmed: 'approve_booking',
+        cancelled: 'reject_booking', // Could also be user_cancel_pending
+    },
+    confirmed: {
+        ready: 'mark_ready',
+        cancelled: 'cancel_confirmed_booking', // Could also be user_cancel_confirmed
+    },
+    ready: {
+        completed: 'complete_booking',
+        cancelled: 'cancel_ready_booking',
+    },
+};
+/**
+ * Default configuration for booking events
+ */
+exports.DEFAULT_BOOKING_EVENT_CONFIG = Object.assign(Object.assign({}, booking_email_models_1.DEFAULT_BOOKING_EMAIL_CONFIG), { eventChannel: 'firebase' });
+/**
+ * Transitions that should NOT trigger email notifications
+ */
+exports.SILENT_TRANSITIONS = new Set(['cancel_draft']);
+/**
+ * Check if a transition should trigger notifications
+ */
+function shouldNotify(transitionId) {
+    return !exports.SILENT_TRANSITIONS.has(transitionId);
+}
+/**
+ * Infer transition ID from state change
+ * Falls back to generic transition if exact match not found
+ */
+function inferTransitionId(fromState, toState) {
+    const transitions = exports.StateChangeToTransitionMap[fromState];
+    if (transitions && transitions[toState]) {
+        return transitions[toState];
+    }
+    return null;
+}
+//# sourceMappingURL=booking-event.models.js.map

package/lib/modules/events/booking-event.models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking-event.models.js","sourceRoot":"","sources":["../../../src/modules/events/booking-event.models.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA2KH,oCAEC;AAMD,8CAMC;AAvLD,0EAIyC;AAEzC;;;;GAIG;AACU,QAAA,iBAAiB,GAAG;IAC/B,2BAA2B;IAC3B,mEAAmE;IACnE,iBAAiB,EAAE,iCAAiC;IAEpD,+DAA+D;IAC/D,gBAAgB,EAAE,gCAAgC;IAElD,yDAAyD;IACzD,aAAa,EAAE,6BAA6B;IAE5C,+DAA+D;IAC/D,gBAAgB,EAAE,gCAAgC;IAElD,2CAA2C;IAC3C,iBAAiB,EAAE,iCAAiC;IAEpD,+DAA+D;IAC/D,iBAAiB,EAAE,iCAAiC;IAEpD,2EAA2E;IAC3E,sBAAsB,EAAE,sCAAsC;IAE9D,gCAAgC;IAChC,kDAAkD;IAClD,yBAAyB,EAAE,yCAAyC;IAEpE,4BAA4B;IAC5B,qBAAqB,EAAE,qCAAqC;CACpD,CAAC;AAuDX;;;;GAIG;AACU,QAAA,oBAAoB,GAAqC;IACpE,gCAAgC;IAChC,mBAAmB,EAAE,yBAAiB,CAAC,iBAAiB;IACxD,eAAe,EAAE,yBAAiB,CAAC,gBAAgB;IACnD,UAAU,EAAE,yBAAiB,CAAC,aAAa;IAC3C,cAAc,EAAE,yBAAiB,CAAC,gBAAgB;IAClD,gBAAgB,EAAE,yBAAiB,CAAC,iBAAiB;IACrD,oBAAoB,EAAE,yBAAiB,CAAC,iBAAiB;IACzD,wBAAwB,EAAE,yBAAiB,CAAC,iBAAiB;IAC7D,mBAAmB,EAAE,yBAAiB,CAAC,sBAAsB;IAC7D,qBAAqB,EAAE,yBAAiB,CAAC,sBAAsB;IAE/D,+BAA+B;IAC/B,eAAe,EAAE,yBAAiB,CAAC,yBAAyB;IAC5D,kBAAkB,EAAE,yBAAiB,CAAC,qBAAqB;IAE3D,uCAAuC;IACvC,sBAAsB;CACvB,CAAC;AAEF;;;GAGG;AACU,QAAA,0BAA0B,GAA2C;IAChF,KAAK,EAAE;QACL,gBAAgB,EAAE,qBAAqB;QACvC,SAAS,EAAE,iBAAiB,EAAE,mBAAmB;QACjD,SAAS,EAAE,cAAc;KAC1B;IACD,gBAAgB,EAAE;QAChB,SAAS,EAAE,iBAAiB;QAC5B,SAAS,EAAE,gBAAgB,EAAE,oCAAoC;KAClE;IACD,SAAS,EAAE;QACT,KAAK,EAAE,YAAY;QACnB,SAAS,EAAE,0BAA0B,EAAE,sCAAsC;KAC9E;IACD,KAAK,EAAE;QACL,SAAS,EAAE,kBAAkB;QAC7B,SAAS,EAAE,sBAAsB;KAClC;CACF,CAAC;AAWF;;GAEG;AACU,QAAA,4BAA4B,mCACpC,mDAA4B,KAC/B,YAAY,EAAE,UAAU,IACxB;AAEF;;GAEG;AACU,QAAA,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;AAE5D;;GAEG;AACH,SAAgB,YAAY,CAAC,YAAoB;IAC/C,OAAO,CAAC,0BAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,SAAiB,EAAE,OAAe;IAClE,MAAM,WAAW,GAAG,kCAA0B,CAAC,SAAS,CAAC,CAAC;IAC1D,IAAI,WAAW,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/modules/events/booking-event.triggers.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Booking Event Publisher Triggers
+ *
+ * Publishes CloudEvents to Eventarc when booking documents are created or updated.
+ * These events are consumed by subscriber handlers (email, audit, analytics).
+ *
+ * Architecture:
+ * - onDocumentCreated: Publishes BOOKING_SUBMITTED or BOOKING_INSTANT_CONFIRMED
+ * - onDocumentUpdated: Publishes events based on workflow state transitions
+ */
+import { BookingEventConfig } from './booking-event.models';
+/**
+ * Create booking event publisher triggers
+ *
+ * @param config - Configuration options
+ * @returns Object containing trigger functions
+ *
+ * @example
+ * ```typescript
+ * const triggers = createBookingEventTriggers({ region: 'europe-west1' });
+ * export const onBookingCreatedEvent = triggers.onBookingCreatedEvent;
+ * export const onBookingUpdatedEvent = triggers.onBookingUpdatedEvent;
+ * ```
+ */
+export declare function createBookingEventTriggers(config?: Partial<BookingEventConfig>): {
+    /**
+     * Trigger when a new booking is created
+     *
+     * Publishes:
+     * - BOOKING_SUBMITTED: When workflow state is 'pending_approval' (user booking)
+     * - BOOKING_INSTANT_CONFIRMED: When workflow state is 'confirmed' (admin/VIP booking)
+     */
+    onBookingCreatedEvent: import("firebase-functions").CloudFunction<import("firebase-functions/v2/firestore").FirestoreEvent<import("firebase-functions/v2/firestore").QueryDocumentSnapshot | undefined, {
+        bookingId: string;
+    }>>;
+    /**
+     * Trigger when a booking is updated
+     *
+     * Publishes events based on workflow state transitions.
+     * Only triggers when workflow.currentState changes.
+     */
+    onBookingUpdatedEvent: import("firebase-functions").CloudFunction<import("firebase-functions/v2/firestore").FirestoreEvent<import("firebase-functions").Change<import("firebase-functions/v2/firestore").QueryDocumentSnapshot> | undefined, {
+        bookingId: string;
+    }>>;
+};
+//# sourceMappingURL=booking-event.triggers.d.ts.map

package/lib/modules/events/booking-event.triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking-event.triggers.d.ts","sourceRoot":"","sources":["../../../src/modules/events/booking-event.triggers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,EACL,kBAAkB,EAOnB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAkE/E;;;;;;OAMG;;;;IA4CH;;;;;OAKG;;;;EA0DN"}