@voyantjs/bookings 0.9.0 → 0.11.0

package/dist/state-machine.d.ts

@@ -0,0 +1,29 @@
+import type { bookings } from "./schema-core.js";
+export type BookingStatus = (typeof bookings.$inferSelect)["status"];
+export declare const BOOKING_TRANSITIONS: {
+    readonly draft: readonly ["on_hold", "confirmed", "cancelled"];
+    readonly on_hold: readonly ["confirmed", "expired", "cancelled"];
+    readonly confirmed: readonly ["in_progress", "cancelled"];
+    readonly in_progress: readonly ["completed", "cancelled"];
+    readonly completed: readonly [];
+    readonly expired: readonly [];
+    readonly cancelled: readonly [];
+};
+export declare class BookingTransitionError extends Error {
+    readonly from: BookingStatus;
+    readonly to: BookingStatus;
+    readonly code = "INVALID_BOOKING_TRANSITION";
+    constructor(from: BookingStatus, to: BookingStatus);
+}
+export declare function canTransitionBooking(from: BookingStatus, to: BookingStatus): boolean;
+export interface BookingStatusPatch {
+    status: BookingStatus;
+    confirmedAt?: Date;
+    expiredAt?: Date;
+    cancelledAt?: Date;
+    completedAt?: Date;
+}
+export declare function transitionBooking(from: BookingStatus, to: BookingStatus, opts?: {
+    now?: Date;
+}): BookingStatusPatch;
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEhD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,QAAQ,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAA;AAEpE,eAAO,MAAM,mBAAmB;;;;;;;;CAQoC,CAAA;AAEpE,qBAAa,sBAAuB,SAAQ,KAAK;IAI7C,QAAQ,CAAC,IAAI,EAAE,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,aAAa;IAJ5B,QAAQ,CAAC,IAAI,gCAA+B;gBAGjC,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,aAAa;CAK7B;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,GAAG,OAAO,CAEpF;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,CAAA;IACrB,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,WAAW,CAAC,EAAE,IAAI,CAAA;CACnB;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,aAAa,EACjB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAA;CAAO,GACxB,kBAAkB,CAcpB"}

package/dist/state-machine.js

@@ -0,0 +1,39 @@
+export const BOOKING_TRANSITIONS = {
+    draft: ["on_hold", "confirmed", "cancelled"],
+    on_hold: ["confirmed", "expired", "cancelled"],
+    confirmed: ["in_progress", "cancelled"],
+    in_progress: ["completed", "cancelled"],
+    completed: [],
+    expired: [],
+    cancelled: [],
+};
+export class BookingTransitionError extends Error {
+    from;
+    to;
+    code = "INVALID_BOOKING_TRANSITION";
+    constructor(from, to) {
+        super(`Illegal booking status transition: ${from} → ${to}`);
+        this.from = from;
+        this.to = to;
+        this.name = "BookingTransitionError";
+    }
+}
+export function canTransitionBooking(from, to) {
+    return BOOKING_TRANSITIONS[from].includes(to);
+}
+export function transitionBooking(from, to, opts = {}) {
+    if (!canTransitionBooking(from, to)) {
+        throw new BookingTransitionError(from, to);
+    }
+    const now = opts.now ?? new Date();
+    const patch = { status: to };
+    if (to === "confirmed")
+        patch.confirmedAt = now;
+    if (to === "expired")
+        patch.expiredAt = now;
+    if (to === "cancelled")
+        patch.cancelledAt = now;
+    if (to === "completed")
+        patch.completedAt = now;
+    return patch;
+}

package/dist/validation-public.d.ts

@@ -17,7 +17,6 @@ export declare const publicBookingSessionTravelerInputSchema: z.ZodObject<{
     email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     preferredLanguage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    accessibilityNeeds: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     specialRequests: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     isPrimary: z.ZodDefault<z.ZodBoolean>;
     notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -127,7 +126,6 @@ export declare const publicCreateBookingSessionSchema: z.ZodObject<{
         email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         preferredLanguage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        accessibilityNeeds: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         specialRequests: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         isPrimary: z.ZodDefault<z.ZodBoolean>;
         notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -157,7 +155,6 @@ export declare const publicUpdateBookingSessionSchema: z.ZodObject<{
         email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         preferredLanguage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        accessibilityNeeds: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         specialRequests: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         isPrimary: z.ZodDefault<z.ZodBoolean>;
         notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -230,7 +227,6 @@ export declare const publicBookingSessionTravelerSchema: z.ZodObject<{
     email: z.ZodNullable<z.ZodString>;
     phone: z.ZodNullable<z.ZodString>;
     preferredLanguage: z.ZodNullable<z.ZodString>;
-    accessibilityNeeds: z.ZodNullable<z.ZodString>;
     specialRequests: z.ZodNullable<z.ZodString>;
     isPrimary: z.ZodBoolean;
     notes: z.ZodNullable<z.ZodString>;
@@ -373,7 +369,6 @@ export declare const publicBookingSessionSchema: z.ZodObject<{
         email: z.ZodNullable<z.ZodString>;
         phone: z.ZodNullable<z.ZodString>;
         preferredLanguage: z.ZodNullable<z.ZodString>;
-        accessibilityNeeds: z.ZodNullable<z.ZodString>;
         specialRequests: z.ZodNullable<z.ZodString>;
         isPrimary: z.ZodBoolean;
         notes: z.ZodNullable<z.ZodString>;
@@ -578,7 +573,6 @@ export declare const publicBookingSessionRepriceResultSchema: z.ZodObject<{
             email: z.ZodNullable<z.ZodString>;
             phone: z.ZodNullable<z.ZodString>;
             preferredLanguage: z.ZodNullable<z.ZodString>;
-            accessibilityNeeds: z.ZodNullable<z.ZodString>;
             specialRequests: z.ZodNullable<z.ZodString>;
             isPrimary: z.ZodBoolean;
             notes: z.ZodNullable<z.ZodString>;

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

@@ -1 +1 @@
-{"version":3,"file":"validation-public.d.ts","sourceRoot":"","sources":["../src/validation-public.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validation-public.d.ts","sourceRoot":"","sources":["../src/validation-public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAqBvB,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;iBAYlD,CAAA;AAEF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoB/C,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsB3C,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAa3C,CAAA;AAEF,eAAO,MAAM,kCAAkC;;iBAE7C,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;iBAS1C,CAAA;AAEF,eAAO,MAAM,qCAAqC;;;;;iBAKhD,CAAA;AAEF,eAAO,MAAM,0CAA0C;;;;;;iBAMrD,CAAA;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;iBAI5C,CAAA;AAEF,eAAO,MAAM,sCAAsC;;;iBAGjD,CAAA;AAEF,eAAO,MAAM,wCAAwC;;;;;iBASjD,CAAA;AAEJ,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;iBAY7C,CAAA;AAEF,eAAO,MAAM,sCAAsC;;;;;;;;;;iBAKjD,CAAA;AAEF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsBzC,CAAA;AAEF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;iBAc/C,CAAA;AAEF,eAAO,MAAM,mCAAmC;;;;;;iBAM9C,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBrC,CAAA;AAEF,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;iBAchD,CAAA;AAEF,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;iBAQnD,CAAA;AAEF,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGlD,CAAA;AAEF,eAAO,MAAM,mCAAmC;;;;;;;;;;iBAM9C,CAAA;AAEF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;iBAM9C,CAAA;AAEF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQjD,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgBtC,CAAA;AAEF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAC9F,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAC9F,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAClG,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CACxD,OAAO,qCAAqC,CAC7C,CAAA;AACD,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAA;AAChG,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,sCAAsC,CAC9C,CAAA;AACD,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,wCAAwC,CAChD,CAAA"}

package/dist/validation-public.js

@@ -13,7 +13,6 @@ export const publicBookingSessionTravelerInputSchema = z.object({
     email: z.string().email().nullable().optional(),
     phone: z.string().max(50).nullable().optional(),
     preferredLanguage: z.string().max(35).nullable().optional(),
-    accessibilityNeeds: z.string().nullable().optional(),
     specialRequests: z.string().nullable().optional(),
     isPrimary: z.boolean().default(false),
     notes: z.string().nullable().optional(),
@@ -130,7 +129,6 @@ export const publicBookingSessionTravelerSchema = z.object({
     email: z.string().nullable(),
     phone: z.string().nullable(),
     preferredLanguage: z.string().nullable(),
-    accessibilityNeeds: z.string().nullable(),
     specialRequests: z.string().nullable(),
     isPrimary: z.boolean(),
     notes: z.string().nullable(),

package/dist/validation.d.ts

@@ -191,18 +191,6 @@ export declare const pricingPreviewSchema: z.ZodObject<{
     optionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     catalogId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
-export declare const updateBookingStatusSchema: z.ZodObject<{
-    status: z.ZodEnum<{
-        cancelled: "cancelled";
-        draft: "draft";
-        on_hold: "on_hold";
-        confirmed: "confirmed";
-        in_progress: "in_progress";
-        completed: "completed";
-        expired: "expired";
-    }>;
-    note: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-}, z.core.$strip>;
 export declare const reserveBookingItemSchema: z.ZodObject<{
     title: z.ZodString;
     description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -333,6 +321,31 @@ export declare const expireStaleBookingsSchema: z.ZodObject<{
     before: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     note: z.ZodNullable<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
+export declare const startBookingSchema: z.ZodObject<{
+    note: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export declare const completeBookingSchema: z.ZodObject<{
+    note: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Admin-only override: skips the transition graph. `reason` is required —
+ * the operator has to explain why they're bypassing lifecycle laws. Use the
+ * verb-specific endpoints (/confirm, /cancel, /start, /complete, /expire) for
+ * normal state changes; this is for data-correction and exceptional cases.
+ */
+export declare const overrideBookingStatusSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        draft: "draft";
+        on_hold: "on_hold";
+        confirmed: "confirmed";
+        in_progress: "in_progress";
+        completed: "completed";
+        expired: "expired";
+    }>;
+    reason: z.ZodString;
+    note: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
 export declare const reserveBookingFromTransactionSchema: z.ZodObject<{
     bookingNumber: z.ZodString;
     contactFirstName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -366,7 +379,6 @@ export declare const insertTravelerSchema: z.ZodObject<{
     email: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     phone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     preferredLanguage: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-    accessibilityNeeds: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     specialRequests: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     travelerCategory: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
         other: "other";
@@ -384,7 +396,6 @@ export declare const updateTravelerSchema: z.ZodObject<{
     email: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
     phone: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
     preferredLanguage: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
-    accessibilityNeeds: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
     specialRequests: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
     travelerCategory: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodEnum<{
         other: "other";
@@ -415,7 +426,6 @@ export declare const insertTravelerRecordSchema: z.ZodObject<{
     email: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     phone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     preferredLanguage: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-    accessibilityNeeds: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     specialRequests: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     isPrimary: z.ZodDefault<z.ZodBoolean>;
     notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -439,7 +449,6 @@ export declare const updateTravelerRecordSchema: z.ZodObject<{
     email: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
     phone: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
     preferredLanguage: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
-    accessibilityNeeds: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
     specialRequests: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
     isPrimary: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     notes: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;

package/dist/validation.d.ts.map

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

package/dist/validation.js

@@ -84,10 +84,6 @@ export const pricingPreviewSchema = z.object({
     optionId: z.string().optional().nullable(),
     catalogId: z.string().optional().nullable(),
 });
-export const updateBookingStatusSchema = z.object({
-    status: bookingStatusSchema,
-    note: z.string().optional().nullable(),
-});
 export const reserveBookingItemSchema = z.object({
     title: z.string().min(1).max(255),
     description: z.string().optional().nullable(),
@@ -156,6 +152,23 @@ export const expireStaleBookingsSchema = z.object({
     before: z.string().datetime().optional().nullable(),
     note: z.string().optional().nullable(),
 });
+export const startBookingSchema = z.object({
+    note: z.string().optional().nullable(),
+});
+export const completeBookingSchema = z.object({
+    note: z.string().optional().nullable(),
+});
+/**
+ * Admin-only override: skips the transition graph. `reason` is required —
+ * the operator has to explain why they're bypassing lifecycle laws. Use the
+ * verb-specific endpoints (/confirm, /cancel, /start, /complete, /expire) for
+ * normal state changes; this is for data-correction and exceptional cases.
+ */
+export const overrideBookingStatusSchema = z.object({
+    status: bookingStatusSchema,
+    reason: z.string().min(1).max(2000),
+    note: z.string().optional().nullable(),
+});
 export const reserveBookingFromTransactionSchema = bookingCoreSchema
     .pick({
     bookingNumber: true,
@@ -194,7 +207,6 @@ const travelerRecordCoreSchema = z.object({
     email: z.string().email().optional().nullable(),
     phone: z.string().max(50).optional().nullable(),
     preferredLanguage: z.string().max(35).optional().nullable(),
-    accessibilityNeeds: z.string().optional().nullable(),
     specialRequests: z.string().optional().nullable(),
     isPrimary: z.boolean().default(false),
     notes: z.string().optional().nullable(),
@@ -206,7 +218,6 @@ const travelerCoreSchema = z.object({
     email: z.string().email().optional().nullable(),
     phone: z.string().max(50).optional().nullable(),
     preferredLanguage: z.string().max(35).optional().nullable(),
-    accessibilityNeeds: z.string().optional().nullable(),
     specialRequests: z.string().optional().nullable(),
     travelerCategory: bookingTravelerCategorySchema.optional().nullable(),
     isPrimary: z.boolean().optional().nullable(),

package/dist/workflows/refund-booking.d.ts

@@ -0,0 +1,87 @@
+import { type EventBus } from "@voyantjs/core";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+/**
+ * Input passed when starting a refund.
+ */
+export interface RefundBookingInput {
+    bookingId: string;
+    /** Free-form audit reason. Required for ops + customer comms. */
+    reason: string;
+    /**
+     * Refund amount in cents. Pass `null` to refund the booking's full
+     * `sellAmountCents`; pass a smaller value for a partial refund.
+     */
+    amountCents?: number | null;
+    /** User triggering the refund (for audit). */
+    userId?: string;
+}
+/**
+ * Side-effect dependencies — supplied by the caller. Decouples the saga
+ * from finance + transactions + notifications packages so this can ship
+ * without those modules being imported.
+ *
+ * - `createCreditNote` is expected to be transactional internally and to
+ *   return a credit note id. Pass a no-op when there's no payment to refund.
+ * - `voidCreditNote` is the compensation; it should mark the credit note
+ *   void (or delete it) so a retry of the saga doesn't double-credit.
+ * - `reverseSupplierOffer` updates linked supplier offer/order rows. May
+ *   be a no-op if no transaction link exists.
+ * - `notifyCustomer` is fire-and-forget; failures don't trigger
+ *   compensation (notifications fail closed elsewhere).
+ */
+export interface RefundBookingDeps {
+    db: PostgresJsDatabase;
+    eventBus?: EventBus;
+    createCreditNote: (args: {
+        bookingId: string;
+        amountCents: number;
+        reason: string;
+    }) => Promise<{
+        creditNoteId: string;
+    } | null>;
+    voidCreditNote?: (args: {
+        creditNoteId: string;
+        reason: string;
+    }) => Promise<void>;
+    reverseSupplierOffer?: (args: {
+        bookingId: string;
+        reason: string;
+    }) => Promise<void>;
+    notifyCustomer?: (args: {
+        bookingId: string;
+        reason: string;
+        amountCents: number;
+    }) => Promise<void>;
+}
+/**
+ * Build the refund saga for a booking.
+ *
+ * **Steps**
+ *
+ * 1. `validate-state` — load the booking, ensure it's in a refundable
+ *    status (`confirmed`, `in_progress`, or `on_hold`), compute the refund
+ *    amount. Compensation: none — this step doesn't mutate.
+ * 2. `create-credit-note` — call into finance via the injected dep.
+ *    Compensation: void the credit note.
+ * 3. `release-inventory` — release any held allocations + the slot
+ *    capacity (only when the booking hasn't started yet). Compensation:
+ *    re-acquire (best-effort; if inventory has since been re-sold,
+ *    that's a known limitation logged for ops triage).
+ * 4. `reverse-supplier-offer` — best-effort call into transactions.
+ *    Compensation: none (idempotent re-call expected if needed).
+ * 5. `transition-booking` — flip the booking to `cancelled`. Last
+ *    DB-touching step so a failure here doesn't leave the booking
+ *    cancelled with no credit-note rollback.
+ * 6. `emit` — fire `booking.refunded` after-commit. Best-effort; no
+ *    compensation.
+ * 7. `notify` — async-style notification. Best-effort; no compensation.
+ *
+ * The saga always runs in a single host process — durability for async
+ * notifications is the deployment's responsibility (see `JobRunner`).
+ */
+export declare function buildRefundBookingWorkflow(deps: RefundBookingDeps): import("@voyantjs/core").WorkflowDefinition;
+/**
+ * Convenience wrapper: build + run the saga in one call.
+ */
+export declare function refundBooking(input: RefundBookingInput, deps: RefundBookingDeps): Promise<import("@voyantjs/core").WorkflowResult>;
+//# sourceMappingURL=refund-booking.d.ts.map

package/dist/workflows/refund-booking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refund-booking.d.ts","sourceRoot":"","sources":["../../src/workflows/refund-booking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAQ,MAAM,gBAAgB,CAAA;AAEpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAMjE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,kBAAkB,CAAA;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,gBAAgB,EAAE,CAAC,IAAI,EAAE;QACvB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAA;KACf,KAAK,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAC9C,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClF,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrF,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QACtB,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,WAAW,EAAE,MAAM,CAAA;KACpB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpB;AAuBD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,iBAAiB,+CAgMjE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB,oDAGrF"}

package/dist/workflows/refund-booking.js

@@ -0,0 +1,210 @@
+import { createWorkflow, step } from "@voyantjs/core";
+import { eq, sql } from "drizzle-orm";
+import { availabilitySlotsRef } from "../availability-ref.js";
+import { bookingActivityLog, bookingAllocations, bookingItems, bookings } from "../schema.js";
+import { transitionBooking } from "../state-machine.js";
+/**
+ * Build the refund saga for a booking.
+ *
+ * **Steps**
+ *
+ * 1. `validate-state` — load the booking, ensure it's in a refundable
+ *    status (`confirmed`, `in_progress`, or `on_hold`), compute the refund
+ *    amount. Compensation: none — this step doesn't mutate.
+ * 2. `create-credit-note` — call into finance via the injected dep.
+ *    Compensation: void the credit note.
+ * 3. `release-inventory` — release any held allocations + the slot
+ *    capacity (only when the booking hasn't started yet). Compensation:
+ *    re-acquire (best-effort; if inventory has since been re-sold,
+ *    that's a known limitation logged for ops triage).
+ * 4. `reverse-supplier-offer` — best-effort call into transactions.
+ *    Compensation: none (idempotent re-call expected if needed).
+ * 5. `transition-booking` — flip the booking to `cancelled`. Last
+ *    DB-touching step so a failure here doesn't leave the booking
+ *    cancelled with no credit-note rollback.
+ * 6. `emit` — fire `booking.refunded` after-commit. Best-effort; no
+ *    compensation.
+ * 7. `notify` — async-style notification. Best-effort; no compensation.
+ *
+ * The saga always runs in a single host process — durability for async
+ * notifications is the deployment's responsibility (see `JobRunner`).
+ */
+export function buildRefundBookingWorkflow(deps) {
+    return createWorkflow("refund-booking", [
+        step("validate-state").run(async (input) => {
+            const [row] = await deps.db
+                .select({
+                id: bookings.id,
+                bookingNumber: bookings.bookingNumber,
+                status: bookings.status,
+                sellAmountCents: bookings.sellAmountCents,
+            })
+                .from(bookings)
+                .where(eq(bookings.id, input.bookingId))
+                .limit(1);
+            if (!row) {
+                throw new Error(`refund-booking: booking ${input.bookingId} not found`);
+            }
+            if (row.status !== "confirmed" && row.status !== "in_progress" && row.status !== "on_hold") {
+                throw new Error(`refund-booking: booking ${input.bookingId} is in ${row.status}, not refundable`);
+            }
+            const fullRefundAmount = row.sellAmountCents ?? 0;
+            const requested = input.amountCents ?? fullRefundAmount;
+            if (requested < 0 || requested > fullRefundAmount) {
+                throw new Error(`refund-booking: requested amount ${requested} out of range [0, ${fullRefundAmount}]`);
+            }
+            return {
+                bookingId: row.id,
+                bookingNumber: row.bookingNumber,
+                previousStatus: row.status,
+                fullRefundAmount,
+                refundAmount: requested,
+            };
+        }),
+        step("create-credit-note")
+            .run(async (input, ctx) => {
+            const validate = ctx.results["validate-state"];
+            if (validate.refundAmount === 0) {
+                // Draft / unpaid booking — no payment to refund. Short-circuit.
+                return { creditNoteId: null, amountCents: 0 };
+            }
+            const created = await deps.createCreditNote({
+                bookingId: input.bookingId,
+                amountCents: validate.refundAmount,
+                reason: input.reason,
+            });
+            return {
+                creditNoteId: created?.creditNoteId ?? null,
+                amountCents: validate.refundAmount,
+            };
+        })
+            .compensate(async (output) => {
+            if (output.creditNoteId && deps.voidCreditNote) {
+                await deps.voidCreditNote({
+                    creditNoteId: output.creditNoteId,
+                    reason: "refund-saga rolled back",
+                });
+            }
+        }),
+        step("release-inventory")
+            .run(async (input) => {
+            return await deps.db.transaction(async (tx) => {
+                const allocs = await tx
+                    .select()
+                    .from(bookingAllocations)
+                    .where(eq(bookingAllocations.bookingId, input.bookingId));
+                const releaseable = allocs.filter((a) => a.status === "held" || a.status === "confirmed");
+                for (const allocation of releaseable) {
+                    if (allocation.availabilitySlotId) {
+                        // Best-effort capacity release — restore the held quantity.
+                        await tx
+                            .update(availabilitySlotsRef)
+                            .set({
+                            remainingPax: sql `${availabilitySlotsRef.remainingPax} + ${allocation.quantity}`,
+                        })
+                            .where(eq(availabilitySlotsRef.id, allocation.availabilitySlotId));
+                    }
+                }
+                if (releaseable.length > 0) {
+                    const releaseableIds = releaseable.map((a) => a.id);
+                    await tx
+                        .update(bookingAllocations)
+                        .set({ status: "released", releasedAt: new Date(), updatedAt: new Date() })
+                        .where(sql `${bookingAllocations.id} IN (${sql.join(releaseableIds.map((id) => sql `${id}`), sql `, `)})`);
+                }
+                await tx
+                    .update(bookingItems)
+                    .set({ status: "cancelled", updatedAt: new Date() })
+                    .where(eq(bookingItems.bookingId, input.bookingId));
+                return {
+                    releasedAllocationIds: releaseable.map((a) => a.id),
+                    slotIds: releaseable
+                        .map((a) => a.availabilitySlotId)
+                        .filter((id) => Boolean(id)),
+                };
+            });
+        })
+            .compensate(async (output) => {
+            // Re-decrement the slots we restored. Note: if the slot has since
+            // been re-sold this will fail loudly — that's intentional, an
+            // operator must intervene.
+            if (output.slotIds.length === 0)
+                return;
+            await deps.db.transaction(async (tx) => {
+                for (const slotId of output.slotIds) {
+                    await tx
+                        .update(availabilitySlotsRef)
+                        .set({ remainingPax: sql `${availabilitySlotsRef.remainingPax} - 1` })
+                        .where(eq(availabilitySlotsRef.id, slotId));
+                }
+            });
+        }),
+        step("reverse-supplier-offer").run(async (input) => {
+            if (!deps.reverseSupplierOffer)
+                return { reversed: false };
+            await deps.reverseSupplierOffer({ bookingId: input.bookingId, reason: input.reason });
+            return { reversed: true };
+        }),
+        step("transition-booking").run(async (input, ctx) => {
+            const validate = ctx.results["validate-state"];
+            const patch = transitionBooking(validate.previousStatus, "cancelled");
+            await deps.db.transaction(async (tx) => {
+                await tx
+                    .update(bookings)
+                    .set({ ...patch, updatedAt: new Date() })
+                    .where(eq(bookings.id, input.bookingId));
+                await tx.insert(bookingActivityLog).values({
+                    bookingId: input.bookingId,
+                    actorId: input.userId ?? "system",
+                    activityType: "status_change",
+                    description: `Refunded from ${validate.previousStatus}: ${input.reason}`,
+                    metadata: {
+                        oldStatus: validate.previousStatus,
+                        newStatus: "cancelled",
+                        refundAmountCents: validate.refundAmount,
+                        reason: input.reason,
+                    },
+                });
+            });
+            return { status: "cancelled" };
+        }),
+        step("emit").run(async (input, ctx) => {
+            const validate = ctx.results["validate-state"];
+            if (!deps.eventBus)
+                return { emitted: false };
+            await deps.eventBus.emit("booking.refunded", {
+                bookingId: input.bookingId,
+                bookingNumber: validate.bookingNumber,
+                previousStatus: validate.previousStatus,
+                refundAmountCents: validate.refundAmount,
+                reason: input.reason,
+                actorId: input.userId ?? null,
+            }, { category: "domain", source: "service" });
+            return { emitted: true };
+        }),
+        step("notify").run(async (input, ctx) => {
+            if (!deps.notifyCustomer)
+                return { notified: false };
+            const validate = ctx.results["validate-state"];
+            try {
+                await deps.notifyCustomer({
+                    bookingId: input.bookingId,
+                    reason: input.reason,
+                    amountCents: validate.refundAmount,
+                });
+            }
+            catch {
+                // Notifications are best-effort. Log via the deployment's logger.
+                return { notified: false };
+            }
+            return { notified: true };
+        }),
+    ]);
+}
+/**
+ * Convenience wrapper: build + run the saga in one call.
+ */
+export async function refundBooking(input, deps) {
+    const wf = buildRefundBookingWorkflow(deps);
+    return wf.run({ input });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/bookings",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",
   "exports": {
@@ -49,14 +49,15 @@
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.10",
     "zod": "^4.3.6",
-    "@voyantjs/core": "0.9.0",
-    "@voyantjs/db": "0.9.0",
-    "@voyantjs/hono": "0.9.0",
-    "@voyantjs/utils": "0.9.0"
+    "@voyantjs/core": "0.11.0",
+    "@voyantjs/db": "0.11.0",
+    "@voyantjs/hono": "0.11.0",
+    "@voyantjs/utils": "0.11.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",
-    "@voyantjs/products": "0.9.0",
+    "@voyantjs/markets": "0.11.0",
+    "@voyantjs/products": "0.11.0",
     "@voyantjs/voyant-typescript-config": "0.1.0"
   },
   "files": [