@voyantjs/storefront 0.24.1 → 0.24.3

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import type { Module } from "@voyantjs/core";
+import type { HonoModule } from "@voyantjs/hono/module";
+import { createStorefrontPublicRoutes } from "./routes-public.js";
+export type { StorefrontPublicRoutes } from "./routes-public.js";
+export { createStorefrontPublicRoutes } from "./routes-public.js";
+export type { StorefrontOfferResolvers, StorefrontRequestContext, StorefrontServiceOptions, } from "./service.js";
+export { createStorefrontService, resolveStorefrontSettings } from "./service.js";
+export type { StorefrontDepartureListQuery, StorefrontFormField, StorefrontFormFieldInput, StorefrontPaymentMethod, StorefrontPaymentMethodCode, StorefrontPaymentMethodInput, StorefrontProductAvailabilitySummaryQuery, StorefrontPromotionalOffer, StorefrontSettings, StorefrontSettingsInput, } from "./validation.js";
+export { storefrontDepartureItinerarySchema, storefrontDepartureListQuerySchema, storefrontDepartureListResponseSchema, storefrontDeparturePricePreviewInputSchema, storefrontDeparturePricePreviewSchema, storefrontDepartureSchema, storefrontFormFieldInputSchema, storefrontFormFieldOptionSchema, storefrontFormFieldSchema, storefrontFormFieldTypeSchema, storefrontPaymentMethodCodeSchema, storefrontPaymentMethodInputSchema, storefrontPaymentMethodSchema, storefrontProductAvailabilitySlotSchema, storefrontProductAvailabilityStateSchema, storefrontProductAvailabilitySummaryQuerySchema, storefrontProductAvailabilitySummaryResponseSchema, storefrontProductAvailabilitySummarySchema, storefrontProductExtensionsQuerySchema, storefrontProductExtensionsResponseSchema, storefrontPromotionalOfferListQuerySchema, storefrontPromotionalOfferListResponseSchema, storefrontPromotionalOfferResponseSchema, storefrontPromotionalOfferSchema, storefrontSettingsInputSchema, storefrontSettingsSchema, } from "./validation.js";
+export declare const storefrontModule: Module;
+export declare function createStorefrontHonoModule(options?: Parameters<typeof createStorefrontPublicRoutes>[0]): HonoModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AAEjE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AACjE,YAAY,EACV,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACjF,YAAY,EACV,4BAA4B,EAC5B,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC5B,yCAAyC,EACzC,0BAA0B,EAC1B,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,kCAAkC,EAClC,kCAAkC,EAClC,qCAAqC,EACrC,0CAA0C,EAC1C,qCAAqC,EACrC,yBAAyB,EACzB,8BAA8B,EAC9B,+BAA+B,EAC/B,yBAAyB,EACzB,6BAA6B,EAC7B,iCAAiC,EACjC,kCAAkC,EAClC,6BAA6B,EAC7B,uCAAuC,EACvC,wCAAwC,EACxC,+CAA+C,EAC/C,kDAAkD,EAClD,0CAA0C,EAC1C,sCAAsC,EACtC,yCAAyC,EACzC,yCAAyC,EACzC,4CAA4C,EAC5C,wCAAwC,EACxC,gCAAgC,EAChC,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,iBAAiB,CAAA;AAExB,eAAO,MAAM,gBAAgB,EAAE,MAE9B,CAAA;AAED,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,CAAC,CAAC,GAC3D,UAAU,CAMZ"}

package/dist/index.js

@@ -0,0 +1,14 @@
+import { createStorefrontPublicRoutes } from "./routes-public.js";
+export { createStorefrontPublicRoutes } from "./routes-public.js";
+export { createStorefrontService, resolveStorefrontSettings } from "./service.js";
+export { storefrontDepartureItinerarySchema, storefrontDepartureListQuerySchema, storefrontDepartureListResponseSchema, storefrontDeparturePricePreviewInputSchema, storefrontDeparturePricePreviewSchema, storefrontDepartureSchema, storefrontFormFieldInputSchema, storefrontFormFieldOptionSchema, storefrontFormFieldSchema, storefrontFormFieldTypeSchema, storefrontPaymentMethodCodeSchema, storefrontPaymentMethodInputSchema, storefrontPaymentMethodSchema, storefrontProductAvailabilitySlotSchema, storefrontProductAvailabilityStateSchema, storefrontProductAvailabilitySummaryQuerySchema, storefrontProductAvailabilitySummaryResponseSchema, storefrontProductAvailabilitySummarySchema, storefrontProductExtensionsQuerySchema, storefrontProductExtensionsResponseSchema, storefrontPromotionalOfferListQuerySchema, storefrontPromotionalOfferListResponseSchema, storefrontPromotionalOfferResponseSchema, storefrontPromotionalOfferSchema, storefrontSettingsInputSchema, storefrontSettingsSchema, } from "./validation.js";
+export const storefrontModule = {
+    name: "storefront",
+};
+export function createStorefrontHonoModule(options) {
+    return {
+        module: storefrontModule,
+        publicPath: "/",
+        publicRoutes: createStorefrontPublicRoutes(options),
+    };
+}

package/dist/routes-public.d.ts

@@ -0,0 +1,476 @@
+import { type StorefrontServiceOptions } from "./service.js";
+type Env = {
+    Variables: {
+        db: unknown;
+    };
+};
+export declare function createStorefrontPublicRoutes(options?: StorefrontServiceOptions): import("hono/hono-base").HonoBase<Env, {
+    "/settings": {
+        $get: {
+            input: {};
+            output: {
+                data: {
+                    branding: {
+                        logoUrl: string | null;
+                        supportedLanguages: string[];
+                    };
+                    support: {
+                        email: string | null;
+                        phone: string | null;
+                    };
+                    legal: {
+                        termsUrl: string | null;
+                        privacyUrl: string | null;
+                        defaultContractTemplateId: string | null;
+                    };
+                    forms: {
+                        billing: {
+                            fields: {
+                                key: string;
+                                label: string;
+                                type: "date" | "select" | "email" | "text" | "country" | "tel" | "textarea" | "checkbox";
+                                required: boolean;
+                                placeholder: string | null;
+                                description: string | null;
+                                autocomplete: string | null;
+                                options: {
+                                    value: string;
+                                    label: string;
+                                }[];
+                            }[];
+                        };
+                        travelers: {
+                            fields: {
+                                key: string;
+                                label: string;
+                                type: "date" | "select" | "email" | "text" | "country" | "tel" | "textarea" | "checkbox";
+                                required: boolean;
+                                placeholder: string | null;
+                                description: string | null;
+                                autocomplete: string | null;
+                                options: {
+                                    value: string;
+                                    label: string;
+                                }[];
+                            }[];
+                        };
+                    };
+                    payment: {
+                        defaultMethod: "voucher" | "card" | "bank_transfer" | "cash" | "invoice" | null;
+                        methods: {
+                            code: "voucher" | "card" | "bank_transfer" | "cash" | "invoice";
+                            label: string;
+                            description: string | null;
+                            enabled: boolean;
+                        }[];
+                    };
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/departures/:departureId": {
+        $get: {
+            input: {
+                param: {
+                    departureId: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    productId: string;
+                    itineraryId: string;
+                    optionId: string | null;
+                    dateLocal: string | null;
+                    startAt: string | null;
+                    endAt: string | null;
+                    timezone: string;
+                    startTime: {
+                        id: string;
+                        label: string | null;
+                        startTimeLocal: string;
+                        durationMinutes: number | null;
+                    } | null;
+                    meetingPoint: string | null;
+                    capacity: number | null;
+                    remaining: number | null;
+                    departureStatus: "open" | "closed" | "sold_out" | "cancelled" | "on_request";
+                    nights: number | null;
+                    days: number | null;
+                    ratePlans: {
+                        id: string;
+                        active: boolean;
+                        name: string;
+                        pricingModel: string;
+                        basePrices: {
+                            amount: number;
+                            currencyCode: string;
+                        }[];
+                        roomPrices: {
+                            amount: number;
+                            currencyCode: string;
+                            roomType: {
+                                id: string;
+                                name: string;
+                                occupancy: {
+                                    adultsMin: number;
+                                    adultsMax: number;
+                                    childrenMax: number;
+                                };
+                            };
+                        }[];
+                    }[];
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    departureId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
+} & {
+    "/products/:productId/departures": {
+        $get: {
+            input: {
+                param: {
+                    productId: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    productId: string;
+                    itineraryId: string;
+                    optionId: string | null;
+                    dateLocal: string | null;
+                    startAt: string | null;
+                    endAt: string | null;
+                    timezone: string;
+                    startTime: {
+                        id: string;
+                        label: string | null;
+                        startTimeLocal: string;
+                        durationMinutes: number | null;
+                    } | null;
+                    meetingPoint: string | null;
+                    capacity: number | null;
+                    remaining: number | null;
+                    departureStatus: "open" | "closed" | "sold_out" | "cancelled" | "on_request";
+                    nights: number | null;
+                    days: number | null;
+                    ratePlans: {
+                        id: string;
+                        active: boolean;
+                        name: string;
+                        pricingModel: string;
+                        basePrices: {
+                            amount: number;
+                            currencyCode: string;
+                        }[];
+                        roomPrices: {
+                            amount: number;
+                            currencyCode: string;
+                            roomType: {
+                                id: string;
+                                name: string;
+                                occupancy: {
+                                    adultsMin: number;
+                                    adultsMax: number;
+                                    childrenMax: number;
+                                };
+                            };
+                        }[];
+                    }[];
+                }[];
+                total: number;
+                limit: number;
+                offset: number;
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/departures/:departureId/price": {
+        $post: {
+            input: {
+                param: {
+                    departureId: string;
+                };
+            };
+            output: {
+                data: {
+                    departureId: string;
+                    productId: string;
+                    optionId: string | null;
+                    currencyCode: string;
+                    basePrice: number;
+                    taxAmount: number;
+                    total: number;
+                    notes: string | null;
+                    lineItems: {
+                        name: string;
+                        total: number;
+                        quantity: number;
+                        unitPrice: number;
+                    }[];
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    departureId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
+} & {
+    "/products/:productId/extensions": {
+        $get: {
+            input: {
+                param: {
+                    productId: string;
+                };
+            };
+            output: {
+                data: {
+                    extensions: {
+                        id: string;
+                        name: string;
+                        label: string;
+                        required: boolean;
+                        selectable: boolean;
+                        hasOptions: boolean;
+                        refProductId: string | null;
+                        thumb: string | null;
+                        pricePerPerson: number | null;
+                        currencyCode: string;
+                        pricingMode: string;
+                        defaultQuantity: number | null;
+                        minQuantity: number | null;
+                        maxQuantity: number | null;
+                    }[];
+                    items: {
+                        id: string;
+                        name: string;
+                        label: string;
+                        required: boolean;
+                        selectable: boolean;
+                        hasOptions: boolean;
+                        refProductId: string | null;
+                        thumb: string | null;
+                        pricePerPerson: number | null;
+                        currencyCode: string;
+                        pricingMode: string;
+                        defaultQuantity: number | null;
+                        minQuantity: number | null;
+                        maxQuantity: number | null;
+                    }[];
+                    details: {
+                        [x: string]: {
+                            description: string | null;
+                            media: {
+                                url: string;
+                                alt: string | null;
+                            }[];
+                        };
+                    };
+                    currencyCode: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/products/:productId/availability": {
+        $get: {
+            input: {
+                param: {
+                    productId: string;
+                };
+            };
+            output: {
+                data: {
+                    productId: string;
+                    availabilityState: "closed" | "sold_out" | "cancelled" | "past_cutoff" | "too_early" | "unavailable" | "on_request" | "available";
+                    counts: {
+                        total: number;
+                        open: number;
+                        closed: number;
+                        soldOut: number;
+                        cancelled: number;
+                        onRequest: number;
+                        pastCutoff: number;
+                        tooEarly: number;
+                        available: number;
+                    };
+                    departures: {
+                        id: string;
+                        productId: string;
+                        optionId: string | null;
+                        dateLocal: string | null;
+                        startAt: string | null;
+                        endAt: string | null;
+                        timezone: string;
+                        status: "open" | "closed" | "sold_out" | "cancelled" | "on_request";
+                        availabilityState: "closed" | "sold_out" | "cancelled" | "past_cutoff" | "too_early" | "unavailable" | "on_request" | "available";
+                        capacity: number | null;
+                        remaining: number | null;
+                        pastCutoff: boolean;
+                        tooEarly: boolean;
+                    }[];
+                    total: number;
+                    limit: number;
+                    offset: number;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/products/:productId/departures/:departureId/itinerary": {
+        $get: {
+            input: {
+                param: {
+                    departureId: string;
+                } & {
+                    productId: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    days: {
+                        id: string;
+                        title: string;
+                        description: string | null;
+                        thumbnail: {
+                            url: string;
+                        } | null;
+                        segments: {
+                            id: string;
+                            title: string;
+                            description: string | null;
+                        }[];
+                    }[];
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    departureId: string;
+                } & {
+                    productId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
+} & {
+    "/products/:productId/offers": {
+        $get: {
+            input: {
+                param: {
+                    productId: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    name: string;
+                    slug: string | null;
+                    description: string | null;
+                    discountType: "percentage" | "fixed_amount";
+                    discountValue: string;
+                    currency: string | null;
+                    applicableProductIds: string[];
+                    applicableDepartureIds: string[];
+                    validFrom: string | null;
+                    validTo: string | null;
+                    minTravelers: number | null;
+                    imageMobileUrl: string | null;
+                    imageDesktopUrl: string | null;
+                    stackable: boolean;
+                    createdAt: string;
+                    updatedAt: string;
+                }[];
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/offers/:slug": {
+        $get: {
+            input: {
+                param: {
+                    slug: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    name: string;
+                    slug: string | null;
+                    description: string | null;
+                    discountType: "percentage" | "fixed_amount";
+                    discountValue: string;
+                    currency: string | null;
+                    applicableProductIds: string[];
+                    applicableDepartureIds: string[];
+                    validFrom: string | null;
+                    validTo: string | null;
+                    minTravelers: number | null;
+                    imageMobileUrl: string | null;
+                    imageDesktopUrl: string | null;
+                    stackable: boolean;
+                    createdAt: string;
+                    updatedAt: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
+}, "/", "/offers/:slug">;
+export type StorefrontPublicRoutes = ReturnType<typeof createStorefrontPublicRoutes>;
+export {};
+//# sourceMappingURL=routes-public.d.ts.map

package/dist/routes-public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes-public.d.ts","sourceRoot":"","sources":["../src/routes-public.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,cAAc,CAAA;AASrB,KAAK,GAAG,GAAG;IACT,SAAS,EAAE;QACT,EAAE,EAAE,OAAO,CAAA;KACZ,CAAA;CACF,CAAA;AAED,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAiG9E;AAED,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAA"}

package/dist/routes-public.js

@@ -0,0 +1,73 @@
+import { parseJsonBody, parseQuery } from "@voyantjs/hono";
+import { Hono } from "hono";
+import { createStorefrontService, } from "./service.js";
+import { storefrontDepartureListQuerySchema, storefrontDeparturePricePreviewInputSchema, storefrontProductAvailabilitySummaryQuerySchema, storefrontProductExtensionsQuerySchema, storefrontPromotionalOfferListQuerySchema, } from "./validation.js";
+export function createStorefrontPublicRoutes(options) {
+    const storefrontService = createStorefrontService(options);
+    function getRequestContext(c) {
+        return {
+            db: c.get("db"),
+            env: c.env,
+            context: c,
+        };
+    }
+    return new Hono()
+        .get("/settings", async (c) => {
+        return c.json({ data: await storefrontService.resolveSettings(getRequestContext(c)) });
+    })
+        .get("/departures/:departureId", async (c) => {
+        const departure = await storefrontService.getDeparture(c.get("db"), c.req.param("departureId"));
+        return departure
+            ? c.json({ data: departure })
+            : c.json({ error: "Storefront departure not found" }, 404);
+    })
+        .get("/products/:productId/departures", async (c) => {
+        return c.json(await storefrontService.listProductDepartures(c.get("db"), c.req.param("productId"), await parseQuery(c, storefrontDepartureListQuerySchema)));
+    })
+        .post("/departures/:departureId/price", async (c) => {
+        const preview = await storefrontService.previewDeparturePrice(c.get("db"), c.req.param("departureId"), await parseJsonBody(c, storefrontDeparturePricePreviewInputSchema));
+        return preview
+            ? c.json({ data: preview })
+            : c.json({ error: "Storefront departure not found" }, 404);
+    })
+        .get("/products/:productId/extensions", async (c) => {
+        const query = await parseQuery(c, storefrontProductExtensionsQuerySchema);
+        return c.json({
+            data: await storefrontService.getProductExtensions(c.get("db"), c.req.param("productId"), query.optionId),
+        });
+    })
+        .get("/products/:productId/availability", async (c) => {
+        return c.json({
+            data: await storefrontService.getProductAvailabilitySummary(c.get("db"), c.req.param("productId"), await parseQuery(c, storefrontProductAvailabilitySummaryQuerySchema)),
+        });
+    })
+        .get("/products/:productId/departures/:departureId/itinerary", async (c) => {
+        const itinerary = await storefrontService.getDepartureItinerary(c.get("db"), {
+            departureId: c.req.param("departureId"),
+            productId: c.req.param("productId"),
+        });
+        return itinerary
+            ? c.json({ data: itinerary })
+            : c.json({ error: "Storefront itinerary not found" }, 404);
+    })
+        .get("/products/:productId/offers", async (c) => {
+        const query = await parseQuery(c, storefrontPromotionalOfferListQuerySchema);
+        return c.json({
+            data: await storefrontService.listApplicableOffers({
+                productId: c.req.param("productId"),
+                departureId: query.departureId,
+                locale: query.locale,
+                context: getRequestContext(c),
+            }),
+        });
+    })
+        .get("/offers/:slug", async (c) => {
+        const query = await parseQuery(c, storefrontPromotionalOfferListQuerySchema);
+        const offer = await storefrontService.getOfferBySlug({
+            slug: c.req.param("slug"),
+            locale: query.locale,
+            context: getRequestContext(c),
+        });
+        return offer ? c.json({ data: offer }) : c.json({ error: "Storefront offer not found" }, 404);
+    });
+}