@mostajs/ticketing 1.0.0

package/dist/api/tickets.route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickets.route.js","sourceRoot":"","sources":["../../api/tickets.route.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { TicketSchema, ClientAccessSchema, ScanLogSchema, SubscriptionPlanSchema, ActivitySchema, CounterSchema, } from './schemas/index';
+export { TicketRepository, ClientAccessRepository, ScanLogRepository, SubscriptionPlanRepository, ActivityRepository, } from './repositories/index';
+export type { TicketDTO, ClientAccessDTO, ScanLogDTO, SubscriptionPlanDTO, PlanActivityDTO, ActivityDTO, ActivityScheduleDTO, } from './repositories/index';
+export { processScan } from './lib/scan-processor';
+export type { ScanDeps } from './lib/scan-processor';
+export { computeValidUntil, isExpired, isToday } from './lib/validity-checker';
+export { decrementQuota, isQuotaDepleted, wouldExceedQuota } from './lib/quota-manager';
+export { createScanHandler } from './api/scan.route';
+export { createTicketsHandler } from './api/tickets.route';
+export type { CodeFormat, ValidityMode, TicketStatus, ScanResult, ScanMethod, AccessType, AccessStatus, ActivityStatus, PlanType, DenyReason, ScanInput, ScanOutput, ScanGrantedResult, ScanDeniedResult, TicketInfo, ClientInfo, AccessInfo, CreateTicketInput, ScanHandlerConfig, TicketsHandlerConfig, } from './types/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,SAAS,EACT,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// @mostajs/ticketing — Main barrel exports
+// Author: Dr Hamid MADANI drmdh@msn.com
+// ── Schemas ────────────────────────────────────────────────────────
+export { TicketSchema, ClientAccessSchema, ScanLogSchema, SubscriptionPlanSchema, ActivitySchema, CounterSchema, } from './schemas/index';
+// ── Repositories ───────────────────────────────────────────────────
+export { TicketRepository, ClientAccessRepository, ScanLogRepository, SubscriptionPlanRepository, ActivityRepository, } from './repositories/index';
+// ── Core logic (pure functions) ────────────────────────────────────
+export { processScan } from './lib/scan-processor';
+export { computeValidUntil, isExpired, isToday } from './lib/validity-checker';
+export { decrementQuota, isQuotaDepleted, wouldExceedQuota } from './lib/quota-manager';
+// ── API route factories ────────────────────────────────────────────
+export { createScanHandler } from './api/scan.route';
+export { createTicketsHandler } from './api/tickets.route';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,wCAAwC;AAExC,sEAAsE;AACtE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,sEAAsE;AACtE,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAY9B,sEAAsE;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAExF,sEAAsE;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/quota-manager.d.ts

@@ -0,0 +1,18 @@
+export interface QuotaUpdate {
+    remainingQuota: number;
+    status?: 'depleted';
+}
+/**
+ * Compute the new quota after decrementing by 1.
+ * Returns null if the access has no quota (unlimited).
+ */
+export declare function decrementQuota(remainingQuota: number | null): QuotaUpdate | null;
+/**
+ * Check if a quota is exhausted.
+ */
+export declare function isQuotaDepleted(remainingQuota: number | null): boolean;
+/**
+ * Check if generating a new ticket would exceed the total quota.
+ */
+export declare function wouldExceedQuota(totalQuota: number | null, currentCount: number): boolean;
+//# sourceMappingURL=quota-manager.d.ts.map

package/dist/lib/quota-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-manager.d.ts","sourceRoot":"","sources":["../../lib/quota-manager.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,CAQhF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAGzF"}

package/dist/lib/quota-manager.js

@@ -0,0 +1,31 @@
+// @mostajs/ticketing — Quota manager (pure functions, zero coupling)
+// Author: Dr Hamid MADANI drmdh@msn.com
+/**
+ * Compute the new quota after decrementing by 1.
+ * Returns null if the access has no quota (unlimited).
+ */
+export function decrementQuota(remainingQuota) {
+    if (remainingQuota == null)
+        return null;
+    const newQuota = Math.max(0, remainingQuota - 1);
+    const update = { remainingQuota: newQuota };
+    if (newQuota === 0) {
+        update.status = 'depleted';
+    }
+    return update;
+}
+/**
+ * Check if a quota is exhausted.
+ */
+export function isQuotaDepleted(remainingQuota) {
+    return remainingQuota != null && remainingQuota <= 0;
+}
+/**
+ * Check if generating a new ticket would exceed the total quota.
+ */
+export function wouldExceedQuota(totalQuota, currentCount) {
+    if (totalQuota == null)
+        return false;
+    return currentCount >= totalQuota;
+}
+//# sourceMappingURL=quota-manager.js.map

package/dist/lib/quota-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-manager.js","sourceRoot":"","sources":["../../lib/quota-manager.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,wCAAwC;AAOxC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,cAA6B;IAC1D,IAAI,cAAc,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,MAAM,GAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;IACzD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,cAA6B;IAC3D,OAAO,cAAc,IAAI,IAAI,IAAI,cAAc,IAAI,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAyB,EAAE,YAAoB;IAC9E,IAAI,UAAU,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,YAAY,IAAI,UAAU,CAAC;AACpC,CAAC"}

package/dist/lib/scan-processor.d.ts

@@ -0,0 +1,39 @@
+import type { ScanOutput, ScanMethod } from '../types/index';
+export interface ScanDeps {
+    /** Find ticket by code value (QR code, barcode, etc.) */
+    findTicketByCode: (code: string) => Promise<any | null>;
+    /** Find client access by ID */
+    findAccessById: (id: string) => Promise<any | null>;
+    /** Find client by ID */
+    findClientById: (id: string) => Promise<any | null>;
+    /** Check if this ticket was already scanned (granted) today */
+    wasScannedToday: (ticketId: string) => Promise<boolean>;
+    /** Update ticket fields */
+    updateTicket: (id: string, data: Record<string, any>) => Promise<void>;
+    /** Update client access fields */
+    updateAccess: (id: string, data: Record<string, any>) => Promise<void>;
+    /** Create a scan log entry */
+    createScanLog: (data: Record<string, any>) => Promise<void>;
+    /** Extract the raw ID from a relation field (may be object or string) */
+    resolveId: (ref: any) => string;
+    /** Format a client's display name */
+    formatClientName: (client: any) => string;
+}
+/**
+ * Process a ticket scan through the 8-step validation pipeline.
+ *
+ * This is a pure business-logic function with zero coupling to any framework,
+ * ORM, or database. All I/O is performed via the injected `deps` callbacks.
+ *
+ * Steps:
+ * 1. Find ticket by code
+ * 2. Check ticket status
+ * 3. Check validUntil expiry
+ * 4. Load client access
+ * 5. Check client status
+ * 6. Process validity mode (day_reentry / single_use / time_slot / unlimited)
+ * 7. Update ticket + access, create scan log
+ * 8. Return result
+ */
+export declare function processScan(code: string, scanMethod: ScanMethod, scannedBy: string, deps: ScanDeps): Promise<ScanOutput>;
+//# sourceMappingURL=scan-processor.d.ts.map

package/dist/lib/scan-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-processor.d.ts","sourceRoot":"","sources":["../../lib/scan-processor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAA0B,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKrF,MAAM,WAAW,QAAQ;IACvB,yDAAyD;IACzD,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACxD,+BAA+B;IAC/B,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACpD,wBAAwB;IACxB,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACpD,+DAA+D;IAC/D,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,2BAA2B;IAC3B,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,kCAAkC;IAClC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,8BAA8B;IAC9B,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,yEAAyE;IACzE,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;IAChC,qCAAqC;IACrC,gBAAgB,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,MAAM,CAAC;CAC3C;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,UAAU,CAAC,CAqIrB"}

package/dist/lib/scan-processor.js

@@ -0,0 +1,168 @@
+// @mostajs/ticketing — Scan processor (core business logic, zero framework coupling)
+// Author: Dr Hamid MADANI drmdh@msn.com
+import { decrementQuota } from './quota-manager';
+// ── Main scan processing pipeline ──────────────────────────────────
+/**
+ * Process a ticket scan through the 8-step validation pipeline.
+ *
+ * This is a pure business-logic function with zero coupling to any framework,
+ * ORM, or database. All I/O is performed via the injected `deps` callbacks.
+ *
+ * Steps:
+ * 1. Find ticket by code
+ * 2. Check ticket status
+ * 3. Check validUntil expiry
+ * 4. Load client access
+ * 5. Check client status
+ * 6. Process validity mode (day_reentry / single_use / time_slot / unlimited)
+ * 7. Update ticket + access, create scan log
+ * 8. Return result
+ */
+export async function processScan(code, scanMethod, scannedBy, deps) {
+    // 1. Find ticket
+    const ticket = await deps.findTicketByCode(code);
+    if (!ticket) {
+        await deps.createScanLog({
+            scannedBy,
+            scanMethod,
+            result: 'denied',
+            denyReason: 'invalid_ticket',
+            timestamp: new Date(),
+        });
+        return { result: 'denied', reason: 'invalid_ticket' };
+    }
+    const ticketId = deps.resolveId(ticket.id ?? ticket._id);
+    // 2. Check ticket status
+    if (ticket.status === 'used' && ticket.validityMode !== 'day_reentry') {
+        await createDeniedLog(deps, ticket, scannedBy, scanMethod, 'ticket_already_used');
+        return { result: 'denied', reason: 'ticket_already_used', ticket: extractTicketInfo(ticket) };
+    }
+    if (ticket.status === 'expired' || ticket.status === 'cancelled') {
+        const reason = `ticket_${ticket.status}`;
+        await createDeniedLog(deps, ticket, scannedBy, scanMethod, reason);
+        return { result: 'denied', reason, ticket: extractTicketInfo(ticket) };
+    }
+    // 3. Check validUntil
+    if (ticket.validUntil && new Date() > new Date(ticket.validUntil)) {
+        await deps.updateTicket(ticketId, { status: 'expired' });
+        await createDeniedLog(deps, ticket, scannedBy, scanMethod, 'ticket_expired');
+        return { result: 'denied', reason: 'ticket_expired', ticket: extractTicketInfo(ticket) };
+    }
+    // 4. Load client access
+    const accessId = deps.resolveId(ticket.clientAccess);
+    const clientAccess = await deps.findAccessById(accessId);
+    if (!clientAccess || clientAccess.status !== 'active') {
+        const reason = clientAccess?.status === 'depleted' ? 'quota_depleted' : 'access_expired';
+        await createDeniedLog(deps, ticket, scannedBy, scanMethod, reason);
+        return { result: 'denied', reason, ticket: extractTicketInfo(ticket) };
+    }
+    // 5. Check client status
+    const clientId = deps.resolveId(ticket.client);
+    const client = await deps.findClientById(clientId);
+    if (!client || client.status !== 'active') {
+        await createDeniedLog(deps, ticket, scannedBy, scanMethod, 'client_suspended');
+        return { result: 'denied', reason: 'client_suspended', ticket: extractTicketInfo(ticket) };
+    }
+    // 6. Process validity mode
+    const quotaBefore = clientAccess.remainingQuota;
+    let quotaAfter = quotaBefore;
+    let isReentry = false;
+    const ticketUpdates = {};
+    const accessUpdates = {};
+    switch (ticket.validityMode) {
+        case 'single_use':
+        case 'time_slot':
+        case 'unlimited': {
+            ticketUpdates.status = 'used';
+            ticketUpdates.scannedAt = new Date();
+            ticketUpdates.scannedBy = scannedBy;
+            const quota = decrementQuota(clientAccess.remainingQuota);
+            if (quota) {
+                accessUpdates.remainingQuota = quota.remainingQuota;
+                quotaAfter = quota.remainingQuota;
+                if (quota.status)
+                    accessUpdates.status = quota.status;
+            }
+            break;
+        }
+        case 'day_reentry': {
+            const alreadyToday = await deps.wasScannedToday(ticketId);
+            if (alreadyToday) {
+                isReentry = true;
+            }
+            else {
+                ticketUpdates.status = 'used';
+                const quota = decrementQuota(clientAccess.remainingQuota);
+                if (quota) {
+                    accessUpdates.remainingQuota = quota.remainingQuota;
+                    quotaAfter = quota.remainingQuota;
+                    if (quota.status)
+                        accessUpdates.status = quota.status;
+                }
+            }
+            ticketUpdates.scannedAt = new Date();
+            ticketUpdates.scannedBy = scannedBy;
+            break;
+        }
+    }
+    // 7. Persist updates + scan log
+    await Promise.all([
+        Object.keys(ticketUpdates).length > 0 ? deps.updateTicket(ticketId, ticketUpdates) : Promise.resolve(),
+        Object.keys(accessUpdates).length > 0 ? deps.updateAccess(clientAccess.id, accessUpdates) : Promise.resolve(),
+    ]);
+    const activityId = deps.resolveId(ticket.activity);
+    await deps.createScanLog({
+        ticket: ticketId,
+        client: clientId,
+        activity: activityId,
+        scannedBy,
+        scanMethod,
+        result: 'granted',
+        quotaBefore,
+        quotaAfter,
+        isReentry,
+        timestamp: new Date(),
+    });
+    // 8. Return granted result
+    return {
+        result: 'granted',
+        isReentry,
+        ticket: extractTicketInfo(ticket),
+        client: {
+            id: clientId,
+            name: deps.formatClientName(client),
+            clientNumber: client.clientNumber,
+            photo: client.photo,
+        },
+        access: {
+            remainingQuota: quotaAfter,
+            totalQuota: clientAccess.totalQuota,
+            endDate: clientAccess.endDate,
+            status: accessUpdates.status || clientAccess.status,
+        },
+    };
+}
+// ── Helpers ────────────────────────────────────────────────────────
+function extractTicketInfo(ticket) {
+    return {
+        ticketNumber: ticket.ticketNumber,
+        clientName: ticket.clientName,
+        activityName: ticket.activityName,
+        ticketType: ticket.ticketType,
+        validityMode: ticket.validityMode,
+        status: ticket.status,
+    };
+}
+async function createDeniedLog(deps, ticket, scannedBy, scanMethod, reason) {
+    await deps.createScanLog({
+        ticket: deps.resolveId(ticket.id ?? ticket._id),
+        client: deps.resolveId(ticket.client),
+        activity: deps.resolveId(ticket.activity),
+        scannedBy,
+        scanMethod,
+        result: 'denied',
+        denyReason: reason,
+        timestamp: new Date(),
+    });
+}
+//# sourceMappingURL=scan-processor.js.map

package/dist/lib/scan-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-processor.js","sourceRoot":"","sources":["../../lib/scan-processor.ts"],"names":[],"mappings":"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"}

package/dist/lib/validity-checker.d.ts

@@ -0,0 +1,19 @@
+import type { ValidityMode } from '../types/index';
+/**
+ * Compute the expiration date for a ticket based on validity mode.
+ *
+ * - day_reentry  → end of current day (23:59:59.999)
+ * - time_slot    → now + duration minutes
+ * - single_use   → null (expires on use)
+ * - unlimited    → null (no expiration)
+ */
+export declare function computeValidUntil(mode: ValidityMode, durationMinutes: number | null): Date | null;
+/**
+ * Check if a ticket is expired based on its validUntil date.
+ */
+export declare function isExpired(validUntil: string | Date | null): boolean;
+/**
+ * Check if a timestamp falls within today (since midnight).
+ */
+export declare function isToday(date: string | Date): boolean;
+//# sourceMappingURL=validity-checker.d.ts.map

package/dist/lib/validity-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validity-checker.d.ts","sourceRoot":"","sources":["../../lib/validity-checker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAiBjG;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,CAGnE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAKpD"}

package/dist/lib/validity-checker.js

@@ -0,0 +1,45 @@
+/**
+ * Compute the expiration date for a ticket based on validity mode.
+ *
+ * - day_reentry  → end of current day (23:59:59.999)
+ * - time_slot    → now + duration minutes
+ * - single_use   → null (expires on use)
+ * - unlimited    → null (no expiration)
+ */
+export function computeValidUntil(mode, durationMinutes) {
+    const now = new Date();
+    switch (mode) {
+        case 'day_reentry': {
+            const end = new Date(now);
+            end.setHours(23, 59, 59, 999);
+            return end;
+        }
+        case 'time_slot': {
+            if (!durationMinutes)
+                return null;
+            return new Date(now.getTime() + durationMinutes * 60_000);
+        }
+        case 'single_use':
+        case 'unlimited':
+        default:
+            return null;
+    }
+}
+/**
+ * Check if a ticket is expired based on its validUntil date.
+ */
+export function isExpired(validUntil) {
+    if (!validUntil)
+        return false;
+    return new Date() > new Date(validUntil);
+}
+/**
+ * Check if a timestamp falls within today (since midnight).
+ */
+export function isToday(date) {
+    const d = new Date(date);
+    const start = new Date();
+    start.setHours(0, 0, 0, 0);
+    return d >= start;
+}
+//# sourceMappingURL=validity-checker.js.map

package/dist/lib/validity-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validity-checker.js","sourceRoot":"","sources":["../../lib/validity-checker.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAkB,EAAE,eAA8B;IAClF,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1B,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YAC9B,OAAO,GAAG,CAAC;QACb,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,IAAI,CAAC,eAAe;gBAAE,OAAO,IAAI,CAAC;YAClC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,eAAe,GAAG,MAAM,CAAC,CAAC;QAC5D,CAAC;QACD,KAAK,YAAY,CAAC;QAClB,KAAK,WAAW,CAAC;QACjB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,UAAgC;IACxD,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,IAAI,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAmB;IACzC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;IACzB,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,KAAK,CAAC;AACpB,CAAC"}

package/dist/repositories/activity.repository.d.ts

@@ -0,0 +1,38 @@
+import { BaseRepository } from '@mostajs/orm';
+import type { IDialect } from '@mostajs/orm';
+export interface ActivityScheduleDTO {
+    dayOfWeek: number;
+    openTime: string;
+    closeTime: string;
+    isOpen: boolean;
+}
+export interface ActivityDTO {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    icon?: string;
+    color?: string;
+    capacity?: number;
+    currentOccupancy: number;
+    schedule: ActivityScheduleDTO[];
+    ticketValidityMode: 'day_reentry' | 'single_use' | 'time_slot' | 'unlimited';
+    ticketDuration: number | null;
+    price: number;
+    currency: string;
+    status: 'active' | 'inactive' | 'maintenance';
+    sortOrder: number;
+    createdBy?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare class ActivityRepository extends BaseRepository<ActivityDTO> {
+    constructor(dialect: IDialect);
+    /** Find all sorted by sortOrder then name */
+    findAllOrdered(): Promise<ActivityDTO[]>;
+    /** Find by slug (unique) */
+    findBySlug(slug: string): Promise<ActivityDTO | null>;
+    /** Find active activities only */
+    findActive(): Promise<ActivityDTO[]>;
+}
+//# sourceMappingURL=activity.repository.d.ts.map

package/dist/repositories/activity.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.repository.d.ts","sourceRoot":"","sources":["../../repositories/activity.repository.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,kBAAkB,EAAE,aAAa,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;IAC7E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,kBAAmB,SAAQ,cAAc,CAAC,WAAW,CAAC;gBACrD,OAAO,EAAE,QAAQ;IAI7B,6CAA6C;IACvC,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI9C,4BAA4B;IACtB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAI3D,kCAAkC;IAC5B,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAG3C"}

package/dist/repositories/activity.repository.js

@@ -0,0 +1,23 @@
+// ActivityRepository
+// @mostajs/ticketing
+// Author: Dr Hamid MADANI drmdh@msn.com
+import { BaseRepository } from '@mostajs/orm';
+import { ActivitySchema } from '../schemas/activity.schema';
+export class ActivityRepository extends BaseRepository {
+    constructor(dialect) {
+        super(ActivitySchema, dialect);
+    }
+    /** Find all sorted by sortOrder then name */
+    async findAllOrdered() {
+        return this.findAll({}, { sort: { sortOrder: 1, name: 1 } });
+    }
+    /** Find by slug (unique) */
+    async findBySlug(slug) {
+        return this.findOne({ slug });
+    }
+    /** Find active activities only */
+    async findActive() {
+        return this.findAll({ status: 'active' }, { sort: { sortOrder: 1 } });
+    }
+}
+//# sourceMappingURL=activity.repository.js.map

package/dist/repositories/activity.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.repository.js","sourceRoot":"","sources":["../../repositories/activity.repository.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,qBAAqB;AACrB,wCAAwC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AA+B5D,MAAM,OAAO,kBAAmB,SAAQ,cAA2B;IACjE,YAAY,OAAiB;QAC3B,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/repositories/client-access.repository.d.ts

@@ -0,0 +1,31 @@
+import { BaseRepository } from '@mostajs/orm';
+import type { IDialect } from '@mostajs/orm';
+export interface ClientAccessDTO {
+    id: string;
+    client: any;
+    plan: any;
+    activity: any;
+    accessType: 'unlimited' | 'count' | 'temporal' | 'mixed';
+    totalQuota: number | null;
+    remainingQuota: number | null;
+    startDate: string;
+    endDate: string | null;
+    status: 'active' | 'expired' | 'blocked' | 'depleted';
+    createdBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare class ClientAccessRepository extends BaseRepository<ClientAccessDTO> {
+    constructor(dialect: IDialect);
+    /** Find all accesses for a client with activity & plan populated */
+    findByClient(clientId: string): Promise<ClientAccessDTO[]>;
+    /** Find active access for a client + activity */
+    findActiveAccess(clientId: string, activityId: string): Promise<ClientAccessDTO | null>;
+    /** Find blocked access for a client + activity (for reactivation) */
+    findBlockedAccess(clientId: string, activityId: string): Promise<ClientAccessDTO | null>;
+    /** Decrement remaining quota by 1 */
+    decrementQuota(id: string): Promise<ClientAccessDTO | null>;
+    /** Soft-block an access */
+    block(id: string): Promise<ClientAccessDTO | null>;
+}
+//# sourceMappingURL=client-access.repository.d.ts.map

package/dist/repositories/client-access.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-access.repository.d.ts","sourceRoot":"","sources":["../../repositories/client-access.repository.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC;IACV,QAAQ,EAAE,GAAG,CAAC;IACd,UAAU,EAAE,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IACzD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,sBAAuB,SAAQ,cAAc,CAAC,eAAe,CAAC;gBAC7D,OAAO,EAAE,QAAQ;IAI7B,oEAAoE;IAC9D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAQhE,iDAAiD;IAC3C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI7F,qEAAqE;IAC/D,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI9F,qCAAqC;IAC/B,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIjE,2BAA2B;IACrB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAGzD"}

package/dist/repositories/client-access.repository.js

@@ -0,0 +1,31 @@
+// ClientAccessRepository
+// @mostajs/ticketing
+// Author: Dr Hamid MADANI drmdh@msn.com
+import { BaseRepository } from '@mostajs/orm';
+import { ClientAccessSchema } from '../schemas/client-access.schema';
+export class ClientAccessRepository extends BaseRepository {
+    constructor(dialect) {
+        super(ClientAccessSchema, dialect);
+    }
+    /** Find all accesses for a client with activity & plan populated */
+    async findByClient(clientId) {
+        return this.findWithRelations({ client: clientId }, ['activity', 'plan'], { sort: { createdAt: -1 } });
+    }
+    /** Find active access for a client + activity */
+    async findActiveAccess(clientId, activityId) {
+        return this.findOne({ client: clientId, activity: activityId, status: 'active' });
+    }
+    /** Find blocked access for a client + activity (for reactivation) */
+    async findBlockedAccess(clientId, activityId) {
+        return this.findOne({ client: clientId, activity: activityId, status: 'blocked' });
+    }
+    /** Decrement remaining quota by 1 */
+    async decrementQuota(id) {
+        return this.increment(id, 'remainingQuota', -1);
+    }
+    /** Soft-block an access */
+    async block(id) {
+        return this.update(id, { status: 'blocked' });
+    }
+}
+//# sourceMappingURL=client-access.repository.js.map

package/dist/repositories/client-access.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-access.repository.js","sourceRoot":"","sources":["../../repositories/client-access.repository.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,qBAAqB;AACrB,wCAAwC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAmBrE,MAAM,OAAO,sBAAuB,SAAQ,cAA+B;IACzE,YAAY,OAAiB;QAC3B,KAAK,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,OAAO,IAAI,CAAC,iBAAiB,CAC3B,EAAE,MAAM,EAAE,QAAQ,EAAE,EACpB,CAAC,UAAU,EAAE,MAAM,CAAC,EACpB,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5B,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,gBAAgB,CAAC,QAAgB,EAAE,UAAkB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,iBAAiB,CAAC,QAAgB,EAAE,UAAkB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,cAAc,CAAC,EAAU;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,2BAA2B;IAC3B,KAAK,CAAC,KAAK,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAS,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/repositories/index.d.ts

@@ -0,0 +1,11 @@
+export { TicketRepository } from './ticket.repository';
+export type { TicketDTO } from './ticket.repository';
+export { ClientAccessRepository } from './client-access.repository';
+export type { ClientAccessDTO } from './client-access.repository';
+export { ScanLogRepository } from './scan-log.repository';
+export type { ScanLogDTO } from './scan-log.repository';
+export { SubscriptionPlanRepository } from './subscription-plan.repository';
+export type { SubscriptionPlanDTO, PlanActivityDTO } from './subscription-plan.repository';
+export { ActivityRepository } from './activity.repository';
+export type { ActivityDTO, ActivityScheduleDTO } from './activity.repository';
+//# sourceMappingURL=index.d.ts.map

package/dist/repositories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../repositories/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAE3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/repositories/index.js

@@ -0,0 +1,8 @@
+// @mostajs/ticketing — Repositories barrel
+// Author: Dr Hamid MADANI drmdh@msn.com
+export { TicketRepository } from './ticket.repository';
+export { ClientAccessRepository } from './client-access.repository';
+export { ScanLogRepository } from './scan-log.repository';
+export { SubscriptionPlanRepository } from './subscription-plan.repository';
+export { ActivityRepository } from './activity.repository';
+//# sourceMappingURL=index.js.map

package/dist/repositories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../repositories/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,wCAAwC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAG5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/repositories/scan-log.repository.d.ts

@@ -0,0 +1,32 @@
+import { BaseRepository } from '@mostajs/orm';
+import type { IDialect, QueryOptions } from '@mostajs/orm';
+export interface ScanLogDTO {
+    id: string;
+    ticket: any;
+    client: any;
+    activity: any;
+    scannedBy: any;
+    scanMethod: string;
+    result: 'granted' | 'denied';
+    denyReason: string | null;
+    quotaBefore: number | null;
+    quotaAfter: number | null;
+    isReentry: boolean;
+    timestamp: string;
+}
+export declare class ScanLogRepository extends BaseRepository<ScanLogDTO> {
+    constructor(dialect: IDialect);
+    /** Find recent scan logs with ticket & scannedBy populated */
+    findRecent(filter?: Record<string, unknown>, options?: QueryOptions): Promise<ScanLogDTO[]>;
+    /** Find scan history for a specific client */
+    findByClient(clientId: string, options?: QueryOptions): Promise<ScanLogDTO[]>;
+    /** Count all scans for today */
+    countToday(): Promise<number>;
+    /** Count granted scans for today */
+    countGrantedToday(): Promise<number>;
+    /** Get distinct clients with granted scans today (visitors present) */
+    findDistinctClientsToday(): Promise<unknown[]>;
+    /** Check if a ticket was already scanned today (for day_reentry) */
+    wasScannedToday(ticketId: string): Promise<boolean>;
+}
+//# sourceMappingURL=scan-log.repository.d.ts.map

package/dist/repositories/scan-log.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-log.repository.d.ts","sourceRoot":"","sources":["../../repositories/scan-log.repository.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,GAAG,CAAC;IACd,SAAS,EAAE,GAAG,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,UAAU,CAAC;gBACnD,OAAO,EAAE,QAAQ;IAI7B,8DAA8D;IACxD,UAAU,CAAC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAQrG,8CAA8C;IACxC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAQnF,gCAAgC;IAC1B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAMnC,oCAAoC;IAC9B,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAM1C,uEAAuE;IACjE,wBAAwB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAMpD,oEAAoE;IAC9D,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAU1D"}