@voyantjs/octo 0.1.0

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAmBjE,KAAK,GAAG,GAAG;IACT,SAAS,EAAE;QACT,EAAE,EAAE,kBAAkB,CAAA;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BA6InB,CAAA;AAEJ,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAA"}

package/dist/routes.js

@@ -0,0 +1,121 @@
+import { cancelBookingSchema, confirmBookingSchema, expireBookingSchema, extendBookingHoldSchema, recordBookingRedemptionSchema, reserveBookingSchema, } from "@voyantjs/bookings";
+import { Hono } from "hono";
+import { octoService } from "./service.js";
+import { octoAvailabilityCalendarQuerySchema, octoAvailabilityListQuerySchema, octoBookingListQuerySchema, octoProductListQuerySchema, } from "./validation.js";
+export const octoRoutes = new Hono()
+    .get("/products", async (c) => {
+    const query = octoProductListQuerySchema.parse(Object.fromEntries(new URL(c.req.url).searchParams));
+    return c.json(await octoService.listProjectedProducts(c.get("db"), query));
+})
+    .get("/availability", async (c) => {
+    const query = octoAvailabilityListQuerySchema.parse(Object.fromEntries(new URL(c.req.url).searchParams));
+    return c.json(await octoService.listProjectedAvailability(c.get("db"), query));
+})
+    .get("/products/:id", async (c) => {
+    const row = await octoService.getProjectedProductById(c.get("db"), c.req.param("id"));
+    if (!row)
+        return c.json({ error: "Product not found" }, 404);
+    return c.json({ data: row });
+})
+    .get("/products/:id/availability", async (c) => {
+    const query = octoAvailabilityListQuerySchema.parse({
+        ...Object.fromEntries(new URL(c.req.url).searchParams),
+        productId: c.req.param("id"),
+    });
+    return c.json(await octoService.listProjectedAvailability(c.get("db"), query));
+})
+    .get("/products/:id/calendar", async (c) => {
+    const query = octoAvailabilityCalendarQuerySchema.parse(Object.fromEntries(new URL(c.req.url).searchParams));
+    return c.json(await octoService.getProjectedAvailabilityCalendar(c.get("db"), c.req.param("id"), query));
+})
+    .get("/availability/:id", async (c) => {
+    const row = await octoService.getProjectedAvailabilityById(c.get("db"), c.req.param("id"));
+    if (!row)
+        return c.json({ error: "Availability not found" }, 404);
+    return c.json({ data: row });
+})
+    .post("/bookings", async (c) => {
+    const result = await octoService.reserveProjectedBooking(c.get("db"), reserveBookingSchema.parse(await c.req.json()), c.get("userId"));
+    if ("booking" in result && result.booking) {
+        return c.json({ data: result.booking }, 201);
+    }
+    if (result.status === "slot_not_found")
+        return c.json({ error: "Availability slot not found" }, 404);
+    if (result.status === "insufficient_capacity")
+        return c.json({ error: "Insufficient slot capacity" }, 409);
+    if (result.status === "slot_unavailable")
+        return c.json({ error: "Availability slot is not bookable" }, 409);
+    if (result.status === "slot_product_mismatch" || result.status === "slot_option_mismatch") {
+        return c.json({ error: "Reservation item does not match availability slot" }, 409);
+    }
+    return c.json({ error: "Unable to reserve booking" }, 400);
+})
+    .get("/bookings", async (c) => {
+    const query = octoBookingListQuerySchema.parse(Object.fromEntries(new URL(c.req.url).searchParams));
+    return c.json(await octoService.listProjectedBookings(c.get("db"), query));
+})
+    .get("/bookings/:id", async (c) => {
+    const row = await octoService.getProjectedBookingById(c.get("db"), c.req.param("id"));
+    if (!row)
+        return c.json({ error: "Booking not found" }, 404);
+    return c.json({ data: row });
+})
+    .post("/bookings/:id/confirm", async (c) => {
+    const result = await octoService.confirmProjectedBooking(c.get("db"), c.req.param("id"), confirmBookingSchema.parse(await c.req.json()), c.get("userId"));
+    if ("booking" in result && result.booking)
+        return c.json({ data: result.booking });
+    if (result.status === "not_found")
+        return c.json({ error: "Booking not found" }, 404);
+    if (result.status === "invalid_transition")
+        return c.json({ error: "Invalid booking status transition" }, 409);
+    if (result.status === "hold_expired")
+        return c.json({ error: "Booking hold has expired" }, 409);
+    return c.json({ error: "Unable to confirm booking" }, 400);
+})
+    .post("/bookings/:id/extend-hold", async (c) => {
+    const result = await octoService.extendProjectedBookingHold(c.get("db"), c.req.param("id"), extendBookingHoldSchema.parse(await c.req.json()), c.get("userId"));
+    if ("booking" in result && result.booking)
+        return c.json({ data: result.booking });
+    if (result.status === "not_found")
+        return c.json({ error: "Booking not found" }, 404);
+    if (result.status === "invalid_transition")
+        return c.json({ error: "Invalid booking status transition" }, 409);
+    if (result.status === "hold_expired")
+        return c.json({ error: "Booking hold has expired" }, 409);
+    return c.json({ error: "Unable to extend booking hold" }, 400);
+})
+    .post("/bookings/:id/expire", async (c) => {
+    const result = await octoService.expireProjectedBooking(c.get("db"), c.req.param("id"), expireBookingSchema.parse(await c.req.json()), c.get("userId"));
+    if ("booking" in result && result.booking)
+        return c.json({ data: result.booking });
+    if (result.status === "not_found")
+        return c.json({ error: "Booking not found" }, 404);
+    if (result.status === "invalid_transition")
+        return c.json({ error: "Invalid booking status transition" }, 409);
+    return c.json({ error: "Unable to expire booking" }, 400);
+})
+    .post("/bookings/:id/cancel", async (c) => {
+    const result = await octoService.cancelProjectedBooking(c.get("db"), c.req.param("id"), cancelBookingSchema.parse(await c.req.json()), c.get("userId"));
+    if ("booking" in result && result.booking)
+        return c.json({ data: result.booking });
+    if (result.status === "not_found")
+        return c.json({ error: "Booking not found" }, 404);
+    if (result.status === "invalid_transition")
+        return c.json({ error: "Invalid booking status transition" }, 409);
+    return c.json({ error: "Unable to cancel booking" }, 400);
+})
+    .get("/bookings/:id/redemptions", async (c) => {
+    const booking = await octoService.getProjectedBookingById(c.get("db"), c.req.param("id"));
+    if (!booking)
+        return c.json({ error: "Booking not found" }, 404);
+    return c.json({
+        data: await octoService.listProjectedRedemptions(c.get("db"), c.req.param("id")),
+    });
+})
+    .post("/bookings/:id/redeem", async (c) => {
+    const result = await octoService.recordProjectedRedemption(c.get("db"), c.req.param("id"), recordBookingRedemptionSchema.parse(await c.req.json()), c.get("userId"));
+    if (!result) {
+        return c.json({ error: "Booking, item, or participant not found" }, 404);
+    }
+    return c.json({ data: result.event, booking: result.booking }, 201);
+});

package/dist/service.d.ts

@@ -0,0 +1,124 @@
+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;
+};
+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>;
+};
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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