@voyantjs/bookings 0.8.0 → 0.10.0

package/dist/validation.d.ts

@@ -366,7 +366,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 +383,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 +413,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 +436,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

@@ -194,7 +194,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 +205,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.8.0",
+  "version": "0.10.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.8.0",
-    "@voyantjs/db": "0.8.0",
-    "@voyantjs/hono": "0.8.0",
-    "@voyantjs/utils": "0.8.0"
+    "@voyantjs/core": "0.10.0",
+    "@voyantjs/db": "0.10.0",
+    "@voyantjs/hono": "0.10.0",
+    "@voyantjs/utils": "0.10.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",
-    "@voyantjs/products": "0.8.0",
+    "@voyantjs/markets": "0.10.0",
+    "@voyantjs/products": "0.10.0",
     "@voyantjs/voyant-typescript-config": "0.1.0"
   },
   "files": [