@voyantjs/octo 0.2.0 → 0.3.1

package/dist/service-shared.js

@@ -0,0 +1,215 @@
+export function toIsoString(value) {
+    return value ? value.toISOString() : null;
+}
+export function formatLocalDateTime(value, timeZone) {
+    const parts = new Intl.DateTimeFormat("en-GB", {
+        timeZone,
+        hour12: false,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+    }).formatToParts(value);
+    const lookup = Object.fromEntries(parts.map((part) => [part.type, part.value]));
+    return `${lookup.year}-${lookup.month}-${lookup.day}T${lookup.hour}:${lookup.minute}:${lookup.second}`;
+}
+export function inferOctoAvailabilityType(bookingMode) {
+    return bookingMode === "open" ? "OPENING_HOURS" : "START_TIME";
+}
+export function inferOctoUnitType(unit) {
+    const haystack = `${unit.code ?? ""} ${unit.name}`.toLowerCase();
+    if (haystack.includes("adult"))
+        return "ADULT";
+    if (haystack.includes("child"))
+        return "CHILD";
+    if (haystack.includes("youth") || haystack.includes("teen"))
+        return "YOUTH";
+    if (haystack.includes("infant") || haystack.includes("baby"))
+        return "INFANT";
+    if (haystack.includes("family"))
+        return "FAMILY";
+    if (haystack.includes("senior"))
+        return "SENIOR";
+    if (haystack.includes("student"))
+        return "STUDENT";
+    if (haystack.includes("military"))
+        return "MILITARY";
+    return unit.unitType === "person" ? "ADULT" : "OTHER";
+}
+export function deriveOctoAvailabilityStatus(slot, capacityMode) {
+    if (slot.status === "sold_out")
+        return "SOLD_OUT";
+    if (slot.status === "closed" || slot.status === "cancelled")
+        return "CLOSED";
+    if (capacityMode === "free_sale" || slot.unlimited)
+        return "FREESALE";
+    if (slot.initialPax !== null &&
+        slot.initialPax !== undefined &&
+        slot.remainingPax !== null &&
+        slot.remainingPax !== undefined) {
+        if (slot.remainingPax <= 0)
+            return "SOLD_OUT";
+        if (slot.initialPax > 0 && slot.remainingPax / slot.initialPax < 0.5)
+            return "LIMITED";
+    }
+    return "AVAILABLE";
+}
+export function mapBookingStatus(status) {
+    switch (status) {
+        case "on_hold":
+            return "ON_HOLD";
+        case "expired":
+            return "EXPIRED";
+        case "cancelled":
+            return "CANCELLED";
+        default:
+            return "CONFIRMED";
+    }
+}
+export function mapUnit(unit) {
+    return {
+        id: unit.id,
+        name: unit.name,
+        code: unit.code,
+        type: inferOctoUnitType(unit),
+        restrictions: {
+            minAge: unit.minAge ?? undefined,
+            maxAge: unit.maxAge ?? undefined,
+            minQuantity: unit.minQuantity ?? undefined,
+            maxQuantity: unit.maxQuantity ?? undefined,
+            occupancyMin: unit.occupancyMin ?? undefined,
+            occupancyMax: unit.occupancyMax ?? undefined,
+        },
+    };
+}
+export function buildProductContent({ features, faqs, locations, }) {
+    return {
+        highlights: features
+            .filter((feature) => feature.featureType === "highlight" || feature.featureType === "other")
+            .map((feature) => ({
+            id: feature.id,
+            title: feature.title,
+            description: feature.description,
+        })),
+        inclusions: features
+            .filter((feature) => feature.featureType === "inclusion")
+            .map((feature) => ({
+            id: feature.id,
+            title: feature.title,
+            description: feature.description,
+        })),
+        exclusions: features
+            .filter((feature) => feature.featureType === "exclusion")
+            .map((feature) => ({
+            id: feature.id,
+            title: feature.title,
+            description: feature.description,
+        })),
+        importantInformation: features
+            .filter((feature) => feature.featureType === "important_information")
+            .map((feature) => ({
+            id: feature.id,
+            title: feature.title,
+            description: feature.description,
+        })),
+        faqs: faqs.map((faq) => ({
+            id: faq.id,
+            question: faq.question,
+            answer: faq.answer,
+        })),
+        locations: locations.map((location) => ({
+            id: location.id,
+            type: location.locationType,
+            title: location.title,
+            address: location.address,
+            city: location.city,
+            countryCode: location.countryCode,
+            latitude: location.latitude,
+            longitude: location.longitude,
+            googlePlaceId: location.googlePlaceId,
+            applePlaceId: location.applePlaceId,
+            tripadvisorLocationId: location.tripadvisorLocationId,
+        })),
+    };
+}
+export function pickOptionStartTimes(option, startTimes) {
+    const optionTimes = startTimes.filter((startTime) => startTime.optionId === option.id);
+    const sharedTimes = startTimes.filter((startTime) => startTime.optionId === null);
+    const source = optionTimes.length > 0 ? optionTimes : sharedTimes;
+    return source.map((startTime) => startTime.startTimeLocal);
+}
+export function pickBookingContact(participants) {
+    const preferred = participants.find((participant) => participant.participantType === "booker") ??
+        participants.find((participant) => participant.participantType === "contact") ??
+        participants.find((participant) => participant.isPrimary) ??
+        participants[0];
+    if (!preferred)
+        return null;
+    return {
+        participantId: preferred.id,
+        firstName: preferred.firstName,
+        lastName: preferred.lastName,
+        email: preferred.email,
+        phone: preferred.phone,
+        language: preferred.preferredLanguage,
+    };
+}
+export function pickPayloadString(payload, keys) {
+    if (!payload)
+        return null;
+    for (const key of keys) {
+        const value = payload[key];
+        if (typeof value === "string" && value.length > 0) {
+            return value;
+        }
+    }
+    return null;
+}
+export function mapBookingArtifact(fulfillment) {
+    const payload = fulfillment.payload ?? null;
+    const artifactUrl = fulfillment.artifactUrl;
+    const downloadUrl = pickPayloadString(payload, ["downloadUrl", "download_url", "url"]) ?? artifactUrl ?? null;
+    const pdfUrl = pickPayloadString(payload, ["pdfUrl", "pdf_url"]) ??
+        (fulfillment.fulfillmentType === "pdf" ? artifactUrl : null);
+    const qrCode = pickPayloadString(payload, ["qrCode", "qr_code"]) ??
+        (fulfillment.fulfillmentType === "qr_code"
+            ? pickPayloadString(payload, ["code", "voucherCode", "voucher_code"])
+            : null);
+    const barcode = pickPayloadString(payload, ["barcode", "barcodeValue", "barcode_value"]) ??
+        (fulfillment.fulfillmentType === "barcode"
+            ? pickPayloadString(payload, ["code", "voucherCode", "voucher_code"])
+            : null);
+    const voucherCode = pickPayloadString(payload, ["voucherCode", "voucher_code", "code"]);
+    return {
+        fulfillmentId: fulfillment.id,
+        bookingItemId: fulfillment.bookingItemId,
+        participantId: fulfillment.participantId,
+        type: fulfillment.fulfillmentType,
+        deliveryChannel: fulfillment.deliveryChannel,
+        status: fulfillment.status,
+        artifactUrl,
+        downloadUrl,
+        pdfUrl,
+        qrCode,
+        barcode,
+        voucherCode,
+        issuedAt: toIsoString(fulfillment.issuedAt),
+        revokedAt: toIsoString(fulfillment.revokedAt),
+    };
+}
+export function buildProjectedAvailability(slot, product) {
+    const timeZone = slot.timezone || product?.timezone || "UTC";
+    return {
+        id: slot.id,
+        productId: slot.productId,
+        optionId: slot.optionId,
+        localDateTimeStart: formatLocalDateTime(slot.startsAt, timeZone),
+        localDateTimeEnd: slot.endsAt ? formatLocalDateTime(slot.endsAt, timeZone) : null,
+        timeZone,
+        status: deriveOctoAvailabilityStatus(slot, product?.capacityMode),
+        vacancies: slot.unlimited ? null : slot.remainingPax,
+        capacity: slot.unlimited ? null : slot.initialPax,
+    };
+}

package/dist/service.d.ts

@@ -1,124 +1,21 @@
-import { availabilitySlots } from "@voyantjs/availability/schema";
-import { bookingsService } from "@voyantjs/bookings";
-import { bookingFulfillments, bookings } from "@voyantjs/bookings/schema";
-import { optionUnits, products } from "@voyantjs/products/schema";
-import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
-import type { z } from "zod";
-import type { OctoAvailabilityStatus, OctoAvailabilityType, OctoBookingStatus, OctoProjectedAvailability, OctoProjectedBooking, OctoProjectedProduct, OctoUnitType } from "./types.js";
-import type { octoAvailabilityCalendarQuerySchema, octoAvailabilityListQuerySchema, octoBookingListQuerySchema, octoProductListQuerySchema } from "./validation.js";
-type ProductRow = typeof products.$inferSelect;
-type UnitRow = typeof optionUnits.$inferSelect;
-type SlotRow = typeof availabilitySlots.$inferSelect;
-type BookingRow = typeof bookings.$inferSelect;
-type OctoAvailabilityListQuery = z.infer<typeof octoAvailabilityListQuerySchema>;
-type OctoAvailabilityCalendarQuery = z.infer<typeof octoAvailabilityCalendarQuerySchema>;
-type OctoProductListQuery = z.infer<typeof octoProductListQuerySchema>;
-type OctoBookingListQuery = z.infer<typeof octoBookingListQuerySchema>;
-export declare function inferOctoAvailabilityType(bookingMode: ProductRow["bookingMode"]): OctoAvailabilityType;
-export declare function inferOctoUnitType(unit: Pick<UnitRow, "name" | "code" | "unitType">): OctoUnitType;
-export declare function deriveOctoAvailabilityStatus(slot: Pick<SlotRow, "status" | "unlimited" | "initialPax" | "remainingPax">, capacityMode: ProductRow["capacityMode"] | null | undefined): OctoAvailabilityStatus;
-export declare function mapBookingStatus(status: BookingRow["status"]): OctoBookingStatus;
-export declare function mapBookingArtifact(fulfillment: typeof bookingFulfillments.$inferSelect): {
-    fulfillmentId: string;
-    bookingItemId: string | null;
-    participantId: string | null;
-    type: "other" | "voucher" | "ticket" | "pdf" | "qr_code" | "barcode" | "mobile";
-    deliveryChannel: "other" | "download" | "email" | "api" | "wallet";
-    status: "pending" | "issued" | "reissued" | "revoked" | "failed";
-    artifactUrl: string | null;
-    downloadUrl: string | null;
-    pdfUrl: string | null;
-    qrCode: string | null;
-    barcode: string | null;
-    voucherCode: string | null;
-    issuedAt: string | null;
-    revokedAt: string | null;
-};
+import { cancelProjectedBooking, confirmProjectedBooking, expireProjectedBooking, extendProjectedBookingHold, getProjectedBookingById, listProjectedBookings, listProjectedRedemptions, recordProjectedRedemption, reserveProjectedBooking } from "./service-bookings.js";
+import { getProjectedAvailabilityById, getProjectedAvailabilityCalendar, getProjectedProductById, listProjectedAvailability, listProjectedProducts } from "./service-products.js";
+import { deriveOctoAvailabilityStatus, inferOctoAvailabilityType, inferOctoUnitType, mapBookingArtifact, mapBookingStatus } from "./service-shared.js";
+export { deriveOctoAvailabilityStatus, inferOctoAvailabilityType, inferOctoUnitType, mapBookingArtifact, mapBookingStatus, };
 export declare const octoService: {
-    getProjectedProductById(db: PostgresJsDatabase, id: string): Promise<OctoProjectedProduct | null>;
-    getProjectedAvailabilityById(db: PostgresJsDatabase, id: string): Promise<OctoProjectedAvailability | null>;
-    listProjectedAvailability(db: PostgresJsDatabase, query: OctoAvailabilityListQuery): Promise<{
-        data: OctoProjectedAvailability[];
-        total: number;
-        limit: number;
-        offset: number;
-    }>;
-    getProjectedAvailabilityCalendar(db: PostgresJsDatabase, productId: string, query: OctoAvailabilityCalendarQuery): Promise<{
-        data: {
-            localDate: string;
-            status: OctoAvailabilityStatus;
-            vacancies: number | null;
-            capacity: number | null;
-            availabilityIds: string[];
-        }[];
-        total: number;
-    }>;
-    listProjectedProducts(db: PostgresJsDatabase, query: OctoProductListQuery): Promise<{
-        data: OctoProjectedProduct[];
-        total: number;
-        limit: number;
-        offset: number;
-    }>;
-    getProjectedBookingById(db: PostgresJsDatabase, id: string): Promise<OctoProjectedBooking | null>;
-    listProjectedBookings(db: PostgresJsDatabase, query: OctoBookingListQuery): Promise<{
-        data: OctoProjectedBooking[];
-        total: number;
-        limit: number;
-        offset: number;
-    }>;
-    reserveProjectedBooking(db: PostgresJsDatabase, data: Parameters<typeof bookingsService.reserveBooking>[1], userId?: string): Promise<{
-        status: Exclude<string, "ok">;
-    } | {
-        status: "ok";
-        booking: OctoProjectedBooking | null;
-    }>;
-    confirmProjectedBooking(db: PostgresJsDatabase, id: string, data: Parameters<typeof bookingsService.confirmBooking>[2], userId?: string): Promise<{
-        status: Exclude<string, "ok">;
-    } | {
-        status: "ok";
-        booking: OctoProjectedBooking | null;
-    }>;
-    extendProjectedBookingHold(db: PostgresJsDatabase, id: string, data: Parameters<typeof bookingsService.extendBookingHold>[2], userId?: string): Promise<{
-        status: Exclude<string, "ok">;
-    } | {
-        status: "ok";
-        booking: OctoProjectedBooking | null;
-    }>;
-    expireProjectedBooking(db: PostgresJsDatabase, id: string, data: Parameters<typeof bookingsService.expireBooking>[2], userId?: string): Promise<{
-        status: Exclude<string, "ok">;
-    } | {
-        status: "ok";
-        booking: OctoProjectedBooking | null;
-    }>;
-    cancelProjectedBooking(db: PostgresJsDatabase, id: string, data: Parameters<typeof bookingsService.cancelBooking>[2], userId?: string): Promise<{
-        status: Exclude<string, "ok">;
-    } | {
-        status: "ok";
-        booking: OctoProjectedBooking | null;
-    }>;
-    listProjectedRedemptions(db: PostgresJsDatabase, bookingId: string): Promise<{
-        id: string;
-        bookingItemId: string | null;
-        participantId: string | null;
-        redeemedAt: string;
-        redeemedBy: string | null;
-        location: string | null;
-        method: "other" | "manual" | "api" | "scan";
-        metadata: Record<string, unknown> | null;
-    }[]>;
-    recordProjectedRedemption(db: PostgresJsDatabase, bookingId: string, data: Parameters<typeof bookingsService.recordRedemption>[2], userId?: string): Promise<{
-        event: {
-            id: string;
-            bookingItemId: string | null;
-            participantId: string | null;
-            redeemedAt: string;
-            redeemedBy: string | null;
-            location: string | null;
-            method: "other" | "manual" | "api" | "scan";
-            metadata: Record<string, unknown> | null;
-        };
-        booking: OctoProjectedBooking | null;
-    } | null>;
+    getProjectedProductById: typeof getProjectedProductById;
+    getProjectedAvailabilityById: typeof getProjectedAvailabilityById;
+    listProjectedAvailability: typeof listProjectedAvailability;
+    getProjectedAvailabilityCalendar: typeof getProjectedAvailabilityCalendar;
+    listProjectedProducts: typeof listProjectedProducts;
+    getProjectedBookingById: typeof getProjectedBookingById;
+    listProjectedBookings: typeof listProjectedBookings;
+    reserveProjectedBooking: typeof reserveProjectedBooking;
+    confirmProjectedBooking: typeof confirmProjectedBooking;
+    extendProjectedBookingHold: typeof extendProjectedBookingHold;
+    expireProjectedBooking: typeof expireProjectedBooking;
+    cancelProjectedBooking: typeof cancelProjectedBooking;
+    listProjectedRedemptions: typeof listProjectedRedemptions;
+    recordProjectedRedemption: typeof recordProjectedRedemption;
 };
-export {};
 //# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,CAAA;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;CAevB,CAAA"}