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

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"}

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

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBookingEventTriggers = createBookingEventTriggers;
+const firebase_functions_1 = require("firebase-functions");
+const firestore_1 = require("firebase-functions/v2/firestore");
+const eventarc_1 = require("firebase-admin/eventarc");
+const error_reporting_1 = require("../error-reporting");
+const booking_event_models_1 = require("./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;
+ * ```
+ */
+function createBookingEventTriggers(config = {}) {
+    const cfg = Object.assign(Object.assign({}, booking_event_models_1.DEFAULT_BOOKING_EVENT_CONFIG), config);
+    const errorReporter = (0, error_reporting_1.createErrorReporter)('BookingEventPublisher');
+    /**
+     * Publish a booking event to Eventarc
+     */
+    async function publishBookingEvent(eventType, payload) {
+        try {
+            const channel = (0, eventarc_1.getEventarc)().channel(cfg.eventChannel);
+            await channel.publish({
+                type: eventType,
+                subject: `booking/${payload.bookingId}`,
+                data: payload,
+            });
+            firebase_functions_1.logger.info(`[BookingEvent] Published ${eventType} for booking ${payload.bookingId}`, {
+                transitionId: payload.transition.transitionId,
+                from: payload.transition.from,
+                to: payload.transition.to,
+            });
+        }
+        catch (error) {
+            // Log but don't throw - we don't want to fail the Firestore operation
+            errorReporter.report(error, {
+                requestId: payload.bookingId,
+                metadata: {
+                    type: 'event_publish_error',
+                    eventType,
+                    transitionId: payload.transition.transitionId,
+                },
+            });
+            throw error; // Re-throw to trigger retry
+        }
+    }
+    /**
+     * Create event payload from booking data
+     */
+    function createPayload(bookingId, booking, transitionId, from, to) {
+        var _a, _b, _c;
+        return {
+            bookingId,
+            booking: Object.assign(Object.assign({}, booking), { uid: bookingId }),
+            transition: {
+                transitionId,
+                from,
+                to,
+                triggeredBy: ((_a = booking.workflow) === null || _a === void 0 ? void 0 : _a.lastTransitionBy) ||
+                    ((_b = booking.meta) === null || _b === void 0 ? void 0 : _b.createdBy) ||
+                    'system',
+                triggeredAt: ((_c = booking.workflow) === null || _c === void 0 ? void 0 : _c.lastTransitionAt) || new Date().toISOString(),
+            },
+        };
+    }
+    return {
+        /**
+         * 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: (0, firestore_1.onDocumentCreated)({
+            document: `${cfg.bookingCollection}/{bookingId}`,
+            region: cfg.region,
+            maxInstances: cfg.maxInstances,
+        }, async (event) => {
+            var _a, _b;
+            const bookingId = event.params.bookingId;
+            const bookingData = (_a = event.data) === null || _a === void 0 ? void 0 : _a.data();
+            if (!bookingData) {
+                firebase_functions_1.logger.warn(`[BookingEvent] No data for new booking ${bookingId}`);
+                return;
+            }
+            const workflowState = (_b = bookingData.workflow) === null || _b === void 0 ? void 0 : _b.currentState;
+            // Determine event type based on initial workflow state
+            let eventType = null;
+            let transitionId;
+            if (workflowState === 'pending_approval') {
+                eventType = booking_event_models_1.BookingEventTypes.BOOKING_SUBMITTED;
+                transitionId = 'submit_for_approval';
+            }
+            else if (workflowState === 'confirmed') {
+                // Express workflow or admin-created booking
+                eventType = booking_event_models_1.BookingEventTypes.BOOKING_INSTANT_CONFIRMED;
+                transitionId = 'instant_confirm';
+            }
+            else if (workflowState === 'draft') {
+                // Draft state - no event needed until submitted
+                firebase_functions_1.logger.info(`[BookingEvent] Skipping draft booking ${bookingId}`);
+                return;
+            }
+            else {
+                firebase_functions_1.logger.info(`[BookingEvent] Skipping booking ${bookingId} with state: ${workflowState}`);
+                return;
+            }
+            const payload = createPayload(bookingId, bookingData, transitionId, 'draft', workflowState);
+            await publishBookingEvent(eventType, payload);
+        }),
+        /**
+         * Trigger when a booking is updated
+         *
+         * Publishes events based on workflow state transitions.
+         * Only triggers when workflow.currentState changes.
+         */
+        onBookingUpdatedEvent: (0, firestore_1.onDocumentUpdated)({
+            document: `${cfg.bookingCollection}/{bookingId}`,
+            region: cfg.region,
+            maxInstances: cfg.maxInstances,
+        }, async (event) => {
+            var _a, _b, _c, _d;
+            const bookingId = event.params.bookingId;
+            const before = (_a = event.data) === null || _a === void 0 ? void 0 : _a.before.data();
+            const after = (_b = event.data) === null || _b === void 0 ? void 0 : _b.after.data();
+            if (!before || !after) {
+                firebase_functions_1.logger.warn(`[BookingEvent] Missing before/after data for booking ${bookingId}`);
+                return;
+            }
+            // Check for workflow state change
+            const stateBefore = (_c = before.workflow) === null || _c === void 0 ? void 0 : _c.currentState;
+            const stateAfter = (_d = after.workflow) === null || _d === void 0 ? void 0 : _d.currentState;
+            if (!stateBefore || !stateAfter || stateBefore === stateAfter) {
+                // No workflow state change - skip
+                return;
+            }
+            firebase_functions_1.logger.info(`[BookingEvent] State change detected for ${bookingId}: ${stateBefore} → ${stateAfter}`);
+            // Infer transition ID from state change
+            const transitionId = (0, booking_event_models_1.inferTransitionId)(stateBefore, stateAfter);
+            if (!transitionId) {
+                firebase_functions_1.logger.warn(`[BookingEvent] Unknown transition: ${stateBefore} → ${stateAfter}`);
+                return;
+            }
+            // Check if this transition should send notifications
+            if (!(0, booking_event_models_1.shouldNotify)(transitionId)) {
+                firebase_functions_1.logger.info(`[BookingEvent] Silent transition ${transitionId}, skipping event`);
+                return;
+            }
+            // Get event type for this transition
+            const eventType = booking_event_models_1.TransitionToEventMap[transitionId];
+            if (!eventType) {
+                firebase_functions_1.logger.warn(`[BookingEvent] No event mapping for transition: ${transitionId}`);
+                return;
+            }
+            const payload = createPayload(bookingId, after, transitionId, stateBefore, stateAfter);
+            await publishBookingEvent(eventType, payload);
+        }),
+    };
+}
+//# sourceMappingURL=booking-event.triggers.js.map

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

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

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

@@ -0,0 +1,53 @@
+/**
+ * Base Event Models for LodgeFlow Eventarc Integration
+ *
+ * CloudEvents specification v1.0 compliant event types for
+ * the event-driven notification architecture.
+ */
+/**
+ * Base CloudEvent structure for LodgeFlow events
+ * Follows CloudEvents specification v1.0
+ * @see https://cloudevents.io/
+ */
+export interface LodgeFlowCloudEvent<T = unknown> {
+    /** CloudEvents specification version */
+    specversion: '1.0';
+    /** Event type identifier (e.g., 'com.lodgeflow.booking.approved') */
+    type: string;
+    /** Event source identifier */
+    source: string;
+    /** Unique event ID */
+    id: string;
+    /** Event timestamp in ISO 8601 format */
+    time?: string;
+    /** Subject of the event (e.g., 'booking/abc123') */
+    subject?: string;
+    /** Content type of the data field */
+    datacontenttype?: 'application/json';
+    /** Event payload */
+    data: T;
+}
+/**
+ * Event categories for routing and filtering
+ */
+export type EventCategory = 'booking' | 'user' | 'payment' | 'system';
+/**
+ * Event severity levels for alerting
+ */
+export type EventSeverity = 'info' | 'warning' | 'critical';
+/**
+ * Base configuration for event triggers
+ */
+export interface EventTriggerConfig {
+    /** Cloud Functions deployment region */
+    region: string;
+    /** Eventarc channel name (default: 'firebase') */
+    eventChannel: string;
+    /** Maximum number of concurrent function instances */
+    maxInstances?: number;
+}
+/**
+ * Default event trigger configuration
+ */
+export declare const DEFAULT_EVENT_TRIGGER_CONFIG: EventTriggerConfig;
+//# sourceMappingURL=event.models.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event.models.d.ts","sourceRoot":"","sources":["../../../src/modules/events/event.models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,wCAAwC;IACxC,WAAW,EAAE,KAAK,CAAC;IAEnB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IAEf,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IAEX,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,eAAe,CAAC,EAAE,kBAAkB,CAAC;IAErC,oBAAoB;IACpB,IAAI,EAAE,CAAC,CAAC;CACT;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IAEf,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IAErB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,kBAI1C,CAAC"}

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

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Base Event Models for LodgeFlow Eventarc Integration
+ *
+ * CloudEvents specification v1.0 compliant event types for
+ * the event-driven notification architecture.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_EVENT_TRIGGER_CONFIG = void 0;
+/**
+ * Default event trigger configuration
+ */
+exports.DEFAULT_EVENT_TRIGGER_CONFIG = {
+    region: 'europe-west1',
+    eventChannel: 'firebase',
+    maxInstances: 10,
+};
+//# sourceMappingURL=event.models.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event.models.js","sourceRoot":"","sources":["../../../src/modules/events/event.models.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAyDH;;GAEG;AACU,QAAA,4BAA4B,GAAuB;IAC9D,MAAM,EAAE,cAAc;IACtB,YAAY,EAAE,UAAU;IACxB,YAAY,EAAE,EAAE;CACjB,CAAC"}

package/lib/modules/events/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Events Module
+ *
+ * Provides Eventarc-based event-driven architecture for the booking system.
+ *
+ * Architecture:
+ * - Publishers: Firestore triggers that emit CloudEvents to Eventarc
+ * - Subscribers: Event handlers that process events (email, audit, etc.)
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   createBookingEventTriggers,
+ *   createBookingEmailHandlers,
+ * } from '@zssz-soft/firebase-functions-shared';
+ *
+ * const triggers = createBookingEventTriggers({ region: 'europe-west1' });
+ * const handlers = createBookingEmailHandlers({ region: 'europe-west1' });
+ *
+ * export const onBookingCreatedEvent = triggers.onBookingCreatedEvent;
+ * export const onBookingUpdatedEvent = triggers.onBookingUpdatedEvent;
+ * export const onBookingEmailHandler = handlers.onBookingEvent;
+ * ```
+ */
+export * from './event.models';
+export * from './booking-event.models';
+export * from './booking-event.triggers';
+export * from './booking-event.handlers';
+//# sourceMappingURL=index.d.ts.map

package/lib/modules/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,cAAc,wBAAwB,CAAC;AAGvC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,0BAA0B,CAAC"}

package/lib/modules/events/index.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Events Module
+ *
+ * Provides Eventarc-based event-driven architecture for the booking system.
+ *
+ * Architecture:
+ * - Publishers: Firestore triggers that emit CloudEvents to Eventarc
+ * - Subscribers: Event handlers that process events (email, audit, etc.)
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   createBookingEventTriggers,
+ *   createBookingEmailHandlers,
+ * } from '@zssz-soft/firebase-functions-shared';
+ *
+ * const triggers = createBookingEventTriggers({ region: 'europe-west1' });
+ * const handlers = createBookingEmailHandlers({ region: 'europe-west1' });
+ *
+ * export const onBookingCreatedEvent = triggers.onBookingCreatedEvent;
+ * export const onBookingUpdatedEvent = triggers.onBookingUpdatedEvent;
+ * export const onBookingEmailHandler = handlers.onBookingEvent;
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Base event models
+__exportStar(require("./event.models"), exports);
+// Booking event models and types
+__exportStar(require("./booking-event.models"), exports);
+// Booking event publishers (Firestore → Eventarc)
+__exportStar(require("./booking-event.triggers"), exports);
+// Booking event handlers (Eventarc → Email)
+__exportStar(require("./booking-event.handlers"), exports);
+//# sourceMappingURL=index.js.map

package/lib/modules/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/events/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;;;;;;;;;;;;AAEH,oBAAoB;AACpB,iDAA+B;AAE/B,iCAAiC;AACjC,yDAAuC;AAEvC,kDAAkD;AAClD,2DAAyC;AAEzC,4CAA4C;AAC5C,2DAAyC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zssz-soft/firebase-functions-shared",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Shared Firebase Cloud Functions modules for LodgeFlow applications",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",