@voyant-travel/commerce 0.1.0

package/dist/promotions/routes.d.ts

@@ -0,0 +1,395 @@
+/**
+ * Admin routes for promotions — mounted by the operator starter at
+ * `/v1/admin/promotions/*` (staff-actor-gated by the parent app's
+ * middleware chain).
+ *
+ * PR1 ships CRUD only. Public storefront routes are exposed via the
+ * existing `/v1/public/products/:productId/offers` endpoints in
+ * `@voyant-travel/storefront` once the storefront resolver is wired in PR4.
+ */
+import { type Env } from "./routes-shared.js";
+export declare const promotionsRoutes: import("hono/hono-base").HonoBase<Env, {
+    "/": {
+        $get: {
+            input: {};
+            output: {
+                data: {
+                    id: string;
+                    name: string;
+                    slug: string;
+                    description: string | null;
+                    discountType: "percentage" | "fixed_amount";
+                    discountPercent: string | null;
+                    discountAmountCents: number | null;
+                    currency: string | null;
+                    scope: {
+                        kind: "global";
+                    } | {
+                        kind: "products";
+                        productIds: string[];
+                    } | {
+                        kind: "categories";
+                        categoryIds: string[];
+                    } | {
+                        kind: "destinations";
+                        destinationIds: string[];
+                    } | {
+                        kind: "markets";
+                        marketIds: string[];
+                    } | {
+                        kind: "audiences";
+                        audiences: ("staff" | "customer" | "partner" | "supplier")[];
+                    } | {
+                        kind: "fare_codes";
+                        fareCodes: string[];
+                    } | {
+                        kind: "cabin_grades";
+                        cabinGradeCodes: string[];
+                    };
+                    conditions: {
+                        minPax?: number | undefined;
+                        pastGuestOnly?: boolean | undefined;
+                        soloTravelerOnly?: boolean | undefined;
+                        childTravelerOnly?: boolean | undefined;
+                        familyOnly?: boolean | undefined;
+                    };
+                    validFrom: string | null;
+                    validUntil: string | null;
+                    code: string | null;
+                    stackable: boolean;
+                    active: boolean;
+                    metadata: import("hono/utils/types").JSONValue;
+                    createdAt: string;
+                    updatedAt: string;
+                }[];
+                total: number;
+                limit: number;
+                offset: number;
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/": {
+        $post: {
+            input: {};
+            output: {
+                data: {
+                    id: string;
+                    code: string | null;
+                    currency: string | null;
+                    validUntil: string | null;
+                    validFrom: string | null;
+                    active: boolean;
+                    metadata: import("hono/utils/types").JSONValue;
+                    description: string | null;
+                    name: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    slug: string;
+                    discountType: "percentage" | "fixed_amount";
+                    discountPercent: string | null;
+                    discountAmountCents: number | null;
+                    scope: {
+                        kind: "global";
+                    } | {
+                        kind: "products";
+                        productIds: string[];
+                    } | {
+                        kind: "categories";
+                        categoryIds: string[];
+                    } | {
+                        kind: "destinations";
+                        destinationIds: string[];
+                    } | {
+                        kind: "markets";
+                        marketIds: string[];
+                    } | {
+                        kind: "audiences";
+                        audiences: ("staff" | "customer" | "partner" | "supplier")[];
+                    } | {
+                        kind: "fare_codes";
+                        fareCodes: string[];
+                    } | {
+                        kind: "cabin_grades";
+                        cabinGradeCodes: string[];
+                    };
+                    conditions: {
+                        minPax?: number | undefined;
+                        pastGuestOnly?: boolean | undefined;
+                        soloTravelerOnly?: boolean | undefined;
+                        childTravelerOnly?: boolean | undefined;
+                        familyOnly?: boolean | undefined;
+                    };
+                    stackable: boolean;
+                };
+            };
+            outputFormat: "json";
+            status: 201;
+        };
+    };
+} & {
+    "/:id": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    code: string | null;
+                    currency: string | null;
+                    validUntil: string | null;
+                    validFrom: string | null;
+                    active: boolean;
+                    metadata: import("hono/utils/types").JSONValue;
+                    description: string | null;
+                    name: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    slug: string;
+                    discountType: "percentage" | "fixed_amount";
+                    discountPercent: string | null;
+                    discountAmountCents: number | null;
+                    scope: {
+                        kind: "global";
+                    } | {
+                        kind: "products";
+                        productIds: string[];
+                    } | {
+                        kind: "categories";
+                        categoryIds: string[];
+                    } | {
+                        kind: "destinations";
+                        destinationIds: string[];
+                    } | {
+                        kind: "markets";
+                        marketIds: string[];
+                    } | {
+                        kind: "audiences";
+                        audiences: ("staff" | "customer" | "partner" | "supplier")[];
+                    } | {
+                        kind: "fare_codes";
+                        fareCodes: string[];
+                    } | {
+                        kind: "cabin_grades";
+                        cabinGradeCodes: string[];
+                    };
+                    conditions: {
+                        minPax?: number | undefined;
+                        pastGuestOnly?: boolean | undefined;
+                        soloTravelerOnly?: boolean | undefined;
+                        childTravelerOnly?: boolean | undefined;
+                        familyOnly?: boolean | undefined;
+                    };
+                    stackable: boolean;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
+} & {
+    "/:id": {
+        $patch: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    code: string | null;
+                    currency: string | null;
+                    validUntil: string | null;
+                    validFrom: string | null;
+                    active: boolean;
+                    metadata: import("hono/utils/types").JSONValue;
+                    description: string | null;
+                    name: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    slug: string;
+                    discountType: "percentage" | "fixed_amount";
+                    discountPercent: string | null;
+                    discountAmountCents: number | null;
+                    scope: {
+                        kind: "global";
+                    } | {
+                        kind: "products";
+                        productIds: string[];
+                    } | {
+                        kind: "categories";
+                        categoryIds: string[];
+                    } | {
+                        kind: "destinations";
+                        destinationIds: string[];
+                    } | {
+                        kind: "markets";
+                        marketIds: string[];
+                    } | {
+                        kind: "audiences";
+                        audiences: ("staff" | "customer" | "partner" | "supplier")[];
+                    } | {
+                        kind: "fare_codes";
+                        fareCodes: string[];
+                    } | {
+                        kind: "cabin_grades";
+                        cabinGradeCodes: string[];
+                    };
+                    conditions: {
+                        minPax?: number | undefined;
+                        pastGuestOnly?: boolean | undefined;
+                        soloTravelerOnly?: boolean | undefined;
+                        childTravelerOnly?: boolean | undefined;
+                        familyOnly?: boolean | undefined;
+                    };
+                    stackable: boolean;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/:id/archive": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    code: string | null;
+                    currency: string | null;
+                    validUntil: string | null;
+                    validFrom: string | null;
+                    active: boolean;
+                    metadata: import("hono/utils/types").JSONValue;
+                    description: string | null;
+                    name: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    slug: string;
+                    discountType: "percentage" | "fixed_amount";
+                    discountPercent: string | null;
+                    discountAmountCents: number | null;
+                    scope: {
+                        kind: "global";
+                    } | {
+                        kind: "products";
+                        productIds: string[];
+                    } | {
+                        kind: "categories";
+                        categoryIds: string[];
+                    } | {
+                        kind: "destinations";
+                        destinationIds: string[];
+                    } | {
+                        kind: "markets";
+                        marketIds: string[];
+                    } | {
+                        kind: "audiences";
+                        audiences: ("staff" | "customer" | "partner" | "supplier")[];
+                    } | {
+                        kind: "fare_codes";
+                        fareCodes: string[];
+                    } | {
+                        kind: "cabin_grades";
+                        cabinGradeCodes: string[];
+                    };
+                    conditions: {
+                        minPax?: number | undefined;
+                        pastGuestOnly?: boolean | undefined;
+                        soloTravelerOnly?: boolean | undefined;
+                        childTravelerOnly?: boolean | undefined;
+                        familyOnly?: boolean | undefined;
+                    };
+                    stackable: boolean;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/:id": {
+        $delete: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 409;
+        };
+    };
+}, "/", "/:id">;
+export type PromotionsRoutes = typeof promotionsRoutes;
+//# sourceMappingURL=routes.d.ts.map

package/dist/promotions/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/promotions/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,KAAK,GAAG,EAAY,MAAM,oBAAoB,CAAA;AAQvD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAgDzB,CAAA;AAEJ,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAA"}

package/dist/promotions/routes.js

@@ -0,0 +1,55 @@
+/**
+ * Admin routes for promotions — mounted by the operator starter at
+ * `/v1/admin/promotions/*` (staff-actor-gated by the parent app's
+ * middleware chain).
+ *
+ * PR1 ships CRUD only. Public storefront routes are exposed via the
+ * existing `/v1/public/products/:productId/offers` endpoints in
+ * `@voyant-travel/storefront` once the storefront resolver is wired in PR4.
+ */
+import { parseJsonBody, parseQuery } from "@voyant-travel/hono";
+import { Hono } from "hono";
+import { notFound } from "./routes-shared.js";
+import { promotionsService } from "./service.js";
+import { insertPromotionalOfferSchema, promotionalOfferListQuerySchema, updatePromotionalOfferSchema, } from "./validation.js";
+export const promotionsRoutes = new Hono()
+    .get("/", async (c) => {
+    const query = await parseQuery(c, promotionalOfferListQuerySchema);
+    return c.json(await promotionsService.listOffers(c.get("db"), query));
+})
+    .post("/", async (c) => c.json({
+    data: await promotionsService.createOffer(c.get("db"), await parseJsonBody(c, insertPromotionalOfferSchema), { eventBus: c.get("eventBus") }),
+}, 201))
+    .get("/:id", async (c) => {
+    const offer = await promotionsService.getOfferById(c.get("db"), c.req.param("id"));
+    return offer ? c.json({ data: offer }) : notFound(c, "Promotional offer not found");
+})
+    .patch("/:id", async (c) => {
+    const patch = await parseJsonBody(c, updatePromotionalOfferSchema);
+    const offer = await promotionsService.updateOffer(c.get("db"), c.req.param("id"), patch, {
+        eventBus: c.get("eventBus"),
+    });
+    return offer ? c.json({ data: offer }) : notFound(c, "Promotional offer not found");
+})
+    .post("/:id/archive", async (c) => {
+    const offer = await promotionsService.archiveOffer(c.get("db"), c.req.param("id"), {
+        eventBus: c.get("eventBus"),
+    });
+    return offer ? c.json({ data: offer }) : notFound(c, "Promotional offer not found");
+})
+    .delete("/:id", async (c) => {
+    try {
+        const result = await promotionsService.deleteOffer(c.get("db"), c.req.param("id"), {
+            eventBus: c.get("eventBus"),
+        });
+        return result ? c.json({ data: result }) : notFound(c, "Promotional offer not found");
+    }
+    catch (err) {
+        // `deleteOffer` throws when redemptions exist (the FK RESTRICT
+        // would otherwise surface a less helpful error). Translate to 409.
+        if (err instanceof Error && err.message.includes("redemption(s) exist")) {
+            return c.json({ error: err.message }, 409);
+        }
+        throw err;
+    }
+});