@voyant-travel/quotes 0.119.3 → 0.120.1

package/dist/index.d.ts

@@ -8,6 +8,8 @@ export declare function createQuotesHonoModule(): HonoModule;
 export declare const quotesHonoModule: HonoModule;
 export type { BookingQuoteDetail, NewBookingQuoteDetail } from "./booking-extension.js";
 export { bookingQuoteDetails, bookingQuoteExtensionService, quotesBookingExtension, } from "./booking-extension.js";
+export type { AcceptPublicProposalResult, ApplyTripSnapshotToQuoteVersionResult, DeclinePublicProposalResult, PublicQuoteVersionProposal, PublicQuoteVersionProposalLine, QuoteProposalRoutesOptions, SendQuoteVersionResult, } from "./proposal-routes.js";
+export { buildQuoteVersionProposalUrl, createQuoteProposalAdminRoutes, createQuoteProposalPublicRoutes, createQuoteVersionSnapshotRoutes, tripSnapshotToQuoteVersionApply, } from "./proposal-routes.js";
 export type { NewPipeline, NewQuote, NewQuoteParticipant, NewQuoteProduct, NewQuoteVersion, NewQuoteVersionLine, NewStage, Pipeline, Quote, QuoteParticipant, QuoteProduct, QuoteVersion, QuoteVersionLine, Stage, } from "./schema.js";
 export { pipelines, quoteParticipants, quoteProducts, quoteStatusEnum, quotes, quoteVersionLines, quoteVersionStatusEnum, quoteVersions, stages, } from "./schema.js";
 export type { AcceptQuoteVersionResult } from "./service/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAI5D,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,eAAO,MAAM,aAAa,EAAE,kBAK3B,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,kBAKlC,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,MAO1B,CAAA;AAED,wBAAgB,sBAAsB,IAAI,UAAU,CAKnD;AAED,eAAO,MAAM,gBAAgB,EAAE,UAAqC,CAAA;AAEpE,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACvF,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,KAAK,GACN,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,MAAM,EACN,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,MAAM,GACP,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,wBAAwB,EACxB,uCAAuC,EACvC,qCAAqC,EACrC,yBAAyB,EACzB,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACxB,iBAAiB,EACjB,4BAA4B,EAC5B,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,4BAA4B,EAC5B,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAI5D,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,eAAO,MAAM,aAAa,EAAE,kBAK3B,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,kBAKlC,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,MAO1B,CAAA;AAED,wBAAgB,sBAAsB,IAAI,UAAU,CAKnD;AAED,eAAO,MAAM,gBAAgB,EAAE,UAAqC,CAAA;AAEpE,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACvF,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,0BAA0B,EAC1B,qCAAqC,EACrC,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,EAC9B,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,KAAK,GACN,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,MAAM,EACN,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,MAAM,GACP,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,wBAAwB,EACxB,uCAAuC,EACvC,qCAAqC,EACrC,yBAAyB,EACzB,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACxB,iBAAiB,EACjB,4BAA4B,EAC5B,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,4BAA4B,EAC5B,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -27,6 +27,7 @@ export function createQuotesHonoModule() {
 }
 export const quotesHonoModule = createQuotesHonoModule();
 export { bookingQuoteDetails, bookingQuoteExtensionService, quotesBookingExtension, } from "./booking-extension.js";
+export { buildQuoteVersionProposalUrl, createQuoteProposalAdminRoutes, createQuoteProposalPublicRoutes, createQuoteVersionSnapshotRoutes, tripSnapshotToQuoteVersionApply, } from "./proposal-routes.js";
 export { pipelines, quoteParticipants, quoteProducts, quoteStatusEnum, quotes, quoteVersionLines, quoteVersionStatusEnum, quoteVersions, stages, } from "./schema.js";
 export { pipelinesService, QuoteVersionConflictError, quoteRecordsService, quotesService, quoteVersionsService, } from "./service/index.js";
 export { acceptQuoteVersionSchema, applyTripSnapshotQuoteVersionLineSchema, applyTripSnapshotToQuoteVersionSchema, declineQuoteVersionSchema, entityTypeSchema, expireQuoteVersionsSchema, insertPipelineSchema, insertQuoteParticipantSchema, insertQuoteProductSchema, insertQuoteSchema, insertQuoteVersionLineSchema, insertQuoteVersionSchema, insertStageSchema, participantRoleSchema, pipelineListQuerySchema, quoteListQuerySchema, quoteStatusSchema, quoteVersionListQuerySchema, quoteVersionStatusSchema, sendQuoteVersionSchema, stageListQuerySchema, updatePipelineSchema, updateQuoteProductSchema, updateQuoteSchema, updateQuoteVersionLineSchema, updateQuoteVersionSchema, updateStageSchema, } from "./validation.js";

package/dist/proposal-routes.d.ts

@@ -0,0 +1,98 @@
+import { type ReserveTripDeps, type StartCheckoutDeps, type TripSnapshot } from "@voyant-travel/trips";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { type Context, Hono } from "hono";
+import type { QuoteVersion, QuoteVersionLine } from "./schema.js";
+import { quotesService } from "./service/index.js";
+/**
+ * Deployment-supplied dependencies for the quote proposal + snapshot routes.
+ *
+ * Generic / structural types keep the quotes package free of operator types and
+ * CloudflareBindings — the deployment casts `c.get("db")` to its own concrete
+ * type inside `resolveDb` and supplies its trips reserve/checkout deps and
+ * public operator profile.
+ */
+export interface QuoteProposalRoutesOptions {
+    /** Resolve the concrete transactional db for a request. */
+    resolveDb(c: Context): PostgresJsDatabase;
+    /**
+     * Resolve the public base URL for proposal links (e.g. the customer dashboard
+     * origin). Returns `null` to emit a root-relative path.
+     */
+    resolvePublicProposalBaseUrl(c: Context): string | null;
+    /** Build the trips reserve deps for a request (catalog/non-catalog wiring). */
+    reserveTripDeps(c: Context): ReserveTripDeps;
+    /** Build the trips checkout deps for a request (payment-session wiring). */
+    startCheckoutDeps(c: Context): StartCheckoutDeps;
+    /**
+     * Resolve the deployment's public operator profile, surfaced on the public
+     * proposal payload. Returns `null` when no profile is configured.
+     */
+    resolveOperatorProfile(db: PostgresJsDatabase): Promise<unknown | null>;
+}
+type OperatorProposalRouteEnv = {
+    Bindings: Record<string, unknown>;
+    Variables: {
+        db: unknown;
+        userId?: string;
+    };
+};
+type OperatorQuoteVersionSnapshotRouteEnv = {
+    Variables: {
+        db: unknown;
+        userId?: string;
+    };
+};
+export interface PublicQuoteVersionProposal {
+    title: string;
+    status: QuoteVersion["status"];
+    currency: string;
+    subtotalAmountCents: number;
+    taxAmountCents: number;
+    totalAmountCents: number;
+    validUntil: string | null;
+    lines: PublicQuoteVersionProposalLine[];
+    operator: unknown | null;
+    proposalUrl: string;
+}
+export interface PublicQuoteVersionProposalLine {
+    description: string;
+    quantity: number;
+    unitPriceAmountCents: number;
+    totalAmountCents: number;
+    currency: string;
+}
+export interface SendQuoteVersionResult {
+    quoteVersion: QuoteVersion;
+    proposalUrl: string;
+}
+export interface DeclinePublicProposalResult {
+    status: QuoteVersion["status"];
+}
+export interface AcceptPublicProposalResult {
+    status: Extract<QuoteVersion["status"], "accepted">;
+    checkoutUrl: string | null;
+    paymentSessionId: string | null;
+    currency: string;
+    totalAmountCents: number;
+    warnings: string[];
+}
+export type ApplyTripSnapshotToQuoteVersionResult = {
+    snapshot: TripSnapshot;
+    quoteVersion: QuoteVersion;
+    lines: QuoteVersionLine[];
+};
+type ApplyTripSnapshotPayload = Parameters<typeof quotesService.applyTripSnapshotToQuoteVersion>[2];
+/** Build a proposal URL — absolute when a base URL is supplied, else root-relative. */
+export declare function buildQuoteVersionProposalUrl(quoteVersionId: string, options?: {
+    baseUrl?: string | null;
+}): string;
+/** Build the admin proposal routes (relative paths; mount at `/v1/admin/quote-versions`). */
+export declare function createQuoteProposalAdminRoutes(options: QuoteProposalRoutesOptions): Hono<OperatorProposalRouteEnv>;
+/** Build the public proposal routes (relative paths; mount at `/v1/public/proposals`). */
+export declare function createQuoteProposalPublicRoutes(options: QuoteProposalRoutesOptions): Hono<OperatorProposalRouteEnv>;
+/** Build the Trip-snapshot freeze route (relative path; mount at `/v1/admin/trips`). */
+export declare function createQuoteVersionSnapshotRoutes(options: QuoteProposalRoutesOptions): Hono<OperatorQuoteVersionSnapshotRouteEnv>;
+/** Map a frozen Trip snapshot's proposal into a quote-version apply payload. */
+export declare function tripSnapshotToQuoteVersionApply(snapshot: TripSnapshot): ApplyTripSnapshotPayload;
+export {};
+//# sourceMappingURL=proposal-routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proposal-routes.d.ts","sourceRoot":"","sources":["../src/proposal-routes.ts"],"names":[],"mappings":"AA4BA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAGtB,KAAK,YAAY,EAIlB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAGzC,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACjE,OAAO,EAA6B,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAG7E;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B;IACzC,2DAA2D;IAC3D,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAA;IACzC;;;OAGG;IACH,4BAA4B,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAA;IACvD,+EAA+E;IAC/E,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,eAAe,CAAA;IAC5C,4EAA4E;IAC5E,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAA;IAChD;;;OAGG;IACH,sBAAsB,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;CACxE;AAED,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE;QACT,EAAE,EAAE,OAAO,CAAA;QACX,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AAED,KAAK,oCAAoC,GAAG;IAC1C,SAAS,EAAE;QACT,EAAE,EAAE,OAAO,CAAA;QACX,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,KAAK,EAAE,8BAA8B,EAAE,CAAA;IACvC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,YAAY,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAA;IACnD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,MAAM,qCAAqC,GAAG;IAClD,QAAQ,EAAE,YAAY,CAAA;IACtB,YAAY,EAAE,YAAY,CAAA;IAC1B,KAAK,EAAE,gBAAgB,EAAE,CAAA;CAC1B,CAAA;AAED,KAAK,wBAAwB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC,CAAA;AA0BnG,uFAAuF;AACvF,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,UAK1C;AAgCD,6FAA6F;AAC7F,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,0BAA0B,GAClC,IAAI,CAAC,wBAAwB,CAAC,CAIhC;AAED,0FAA0F;AAC1F,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,0BAA0B,GAClC,IAAI,CAAC,wBAAwB,CAAC,CAMhC;AAED,wFAAwF;AACxF,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,0BAA0B,GAClC,IAAI,CAAC,oCAAoC,CAAC,CAM5C;AA6bD,gFAAgF;AAChF,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,YAAY,GAAG,wBAAwB,CAUhG"}

package/dist/proposal-routes.js

@@ -0,0 +1,445 @@
+/**
+ * Quote-version proposal + Trip-snapshot HTTP routes, owned by the quotes
+ * module.
+ *
+ * agent-quality: file-size exception -- the proposal lifecycle (admin send,
+ * public get/accept/decline) plus the Trip-snapshot freeze form one cohesive
+ * route family backed by the same quotes/trips services; splitting it would
+ * scatter a single accept-under-lock contract.
+ *
+ *   Admin proposal (mount at /v1/admin/quote-versions):
+ *     POST   /:quoteVersionId/send
+ *   Public proposal (mount at /v1/public/proposals):
+ *     GET    /:quoteVersionId
+ *     POST   /:quoteVersionId/accept
+ *     POST   /:quoteVersionId/decline
+ *   Admin snapshot (mount at /v1/admin/trips):
+ *     POST   /:envelopeId/quote-versions/:quoteVersionId/snapshot
+ *
+ * These shapes (validation, status codes, the accept-under-advisory-lock flow,
+ * the snapshot↔proposal equivalence checks, and the pure
+ * `tripSnapshotToQuoteVersionApply` mapper) are framework logic and live here.
+ *
+ * The deployment supplies the concrete db resolver, the public proposal base
+ * URL resolver, the trips reserve/checkout deps, and the public operator
+ * profile via `QuoteProposalRoutesOptions` — all generic / structural so this
+ * package stays free of operator types and CloudflareBindings.
+ */
+import { parseJsonBody, parseOptionalJsonBody } from "@voyant-travel/hono";
+import { TripsInvariantError, tripsService, } from "@voyant-travel/trips";
+import { sql } from "drizzle-orm";
+import { Hono } from "hono";
+import { z } from "zod";
+import { QuoteVersionConflictError, quotesService } from "./service/index.js";
+import { sendQuoteVersionSchema } from "./validation.js";
+const acceptPublicProposalSchema = z.object({
+    intent: z.enum(["card", "bank_transfer"]).default("card"),
+    idempotencyKey: z.string().min(1).max(120).optional(),
+});
+const freezeQuoteVersionSnapshotBodySchema = z.object({
+    createdBy: z.string().min(1).nullable().optional(),
+});
+/** Build a proposal URL — absolute when a base URL is supplied, else root-relative. */
+export function buildQuoteVersionProposalUrl(quoteVersionId, options = {}) {
+    const path = `/proposal/${encodeURIComponent(quoteVersionId)}`;
+    const baseUrl = options.baseUrl?.trim().replace(/\/+$/, "");
+    return baseUrl ? `${baseUrl}${path}` : path;
+}
+function toPublicQuoteVersionProposal(proposal, options) {
+    const quoteVersion = options.quoteVersion ?? proposal.quoteVersion;
+    return {
+        title: proposal.quote.title,
+        status: quoteVersion.status,
+        currency: quoteVersion.currency,
+        subtotalAmountCents: quoteVersion.subtotalAmountCents,
+        taxAmountCents: quoteVersion.taxAmountCents,
+        totalAmountCents: quoteVersion.totalAmountCents,
+        validUntil: quoteVersion.validUntil,
+        lines: proposal.lines.map((line) => ({
+            description: line.description,
+            quantity: line.quantity,
+            unitPriceAmountCents: line.unitPriceAmountCents,
+            totalAmountCents: line.totalAmountCents,
+            currency: line.currency,
+        })),
+        operator: options.operator,
+        proposalUrl: options.proposalUrl,
+    };
+}
+/** Build the admin proposal routes (relative paths; mount at `/v1/admin/quote-versions`). */
+export function createQuoteProposalAdminRoutes(options) {
+    const app = new Hono();
+    app.post("/:quoteVersionId/send", (c) => handleSendQuoteVersion(c, options));
+    return app;
+}
+/** Build the public proposal routes (relative paths; mount at `/v1/public/proposals`). */
+export function createQuoteProposalPublicRoutes(options) {
+    const app = new Hono();
+    app.get("/:quoteVersionId", (c) => handleGetPublicProposal(c, options));
+    app.post("/:quoteVersionId/accept", (c) => handleAcceptPublicProposal(c, options));
+    app.post("/:quoteVersionId/decline", (c) => handleDeclinePublicProposal(c, options));
+    return app;
+}
+/** Build the Trip-snapshot freeze route (relative path; mount at `/v1/admin/trips`). */
+export function createQuoteVersionSnapshotRoutes(options) {
+    const app = new Hono();
+    app.post("/:envelopeId/quote-versions/:quoteVersionId/snapshot", (c) => handleFreezeQuoteVersionSnapshot(c, options));
+    return app;
+}
+async function handleSendQuoteVersion(c, options) {
+    const quoteVersionId = c.req.param("quoteVersionId");
+    if (!quoteVersionId)
+        return c.json({ error: "Quote Version id is required" }, 400);
+    try {
+        const quoteVersion = await quotesService.sendQuoteVersion(options.resolveDb(c), quoteVersionId, await parseOptionalJsonBody(c, sendQuoteVersionSchema));
+        if (!quoteVersion)
+            return c.json({ error: "Quote Version not found" }, 404);
+        return c.json({
+            data: {
+                quoteVersion,
+                proposalUrl: buildQuoteVersionProposalUrl(quoteVersion.id, {
+                    baseUrl: options.resolvePublicProposalBaseUrl(c),
+                }),
+            },
+        });
+    }
+    catch (error) {
+        if (error instanceof QuoteVersionConflictError) {
+            return c.json({ error: error.message }, 409);
+        }
+        throw error;
+    }
+}
+async function handleGetPublicProposal(c, options) {
+    const quoteVersionId = c.req.param("quoteVersionId");
+    if (!quoteVersionId)
+        return c.json({ error: "Quote Version id is required" }, 400);
+    const db = options.resolveDb(c);
+    await quotesService.expireQuoteVersionIfPastValidUntil(db, quoteVersionId);
+    const proposal = await quotesService.getQuoteVersionProposal(db, quoteVersionId);
+    if (!proposal)
+        return c.json({ error: "Proposal not found" }, 404);
+    if (proposal.quoteVersion.status === "draft")
+        return c.json({ error: "Proposal not found" }, 404);
+    if (proposal.quoteVersion.status === "superseded") {
+        return c.json({ error: "Proposal has been superseded" }, 410);
+    }
+    const viewedQuoteVersion = proposal.quoteVersion.status === "sent"
+        ? await quotesService.markQuoteVersionViewed(db, quoteVersionId)
+        : proposal.quoteVersion;
+    const operator = await options.resolveOperatorProfile(db);
+    return c.json({
+        data: toPublicQuoteVersionProposal(proposal, {
+            quoteVersion: viewedQuoteVersion,
+            operator: operator ?? null,
+            proposalUrl: buildQuoteVersionProposalUrl(quoteVersionId, {
+                baseUrl: options.resolvePublicProposalBaseUrl(c),
+            }),
+        }),
+    });
+}
+async function handleDeclinePublicProposal(c, options) {
+    const quoteVersionId = c.req.param("quoteVersionId");
+    if (!quoteVersionId)
+        return c.json({ error: "Quote Version id is required" }, 400);
+    const db = options.resolveDb(c);
+    await quotesService.expireQuoteVersionIfPastValidUntil(db, quoteVersionId);
+    const proposal = await quotesService.getQuoteVersionProposal(db, quoteVersionId);
+    if (!proposal)
+        return c.json({ error: "Proposal not found" }, 404);
+    if (proposal.quoteVersion.status === "draft")
+        return c.json({ error: "Proposal not found" }, 404);
+    if (proposal.quoteVersion.status === "superseded") {
+        return c.json({ error: "Proposal has been superseded" }, 410);
+    }
+    try {
+        const quoteVersion = await quotesService.declineQuoteVersion(db, quoteVersionId);
+        if (!quoteVersion)
+            return c.json({ error: "Proposal not found" }, 404);
+        return c.json({
+            data: { status: quoteVersion.status },
+        });
+    }
+    catch (error) {
+        if (error instanceof QuoteVersionConflictError) {
+            return c.json({ error: error.message }, 409);
+        }
+        throw error;
+    }
+}
+async function handleAcceptPublicProposal(c, options) {
+    const quoteVersionId = c.req.param("quoteVersionId");
+    if (!quoteVersionId)
+        return c.json({ error: "Quote Version id is required" }, 400);
+    const body = await parseOptionalJsonBody(c, acceptPublicProposalSchema);
+    const db = options.resolveDb(c);
+    const proposalForLock = await quotesService.getQuoteVersionProposal(db, quoteVersionId);
+    if (!proposalForLock)
+        return c.json({ error: "Proposal not found" }, 404);
+    try {
+        const lockedResult = await db.transaction((tx) => acceptPublicProposalWithQuoteLock({
+            c,
+            options,
+            db: tx,
+            quoteId: proposalForLock.quote.id,
+            quoteVersionId,
+            body,
+        }));
+        if (lockedResult.kind === "response")
+            return lockedResult.response;
+        const checkout = await startAcceptedProposalCheckout(c, options, lockedResult.snapshot, body, quoteVersionId);
+        const checkoutWarnings = checkout
+            ? checkout.failures.map((failure) => failure.reason)
+            : ["checkout_start_failed"];
+        return c.json({
+            data: {
+                status: "accepted",
+                checkoutUrl: checkout?.target.checkoutUrl ?? null,
+                paymentSessionId: checkout?.target.paymentSessionId ?? null,
+                currency: checkout?.target.currency ?? lockedResult.accepted.quoteVersion.currency,
+                totalAmountCents: checkout?.target.totalAmountCents ?? lockedResult.accepted.quoteVersion.totalAmountCents,
+                warnings: [...lockedResult.warnings, ...(checkout?.warnings ?? []), ...checkoutWarnings],
+            },
+        });
+    }
+    catch (error) {
+        if (error instanceof QuoteVersionConflictError) {
+            return c.json({ error: error.message }, 409);
+        }
+        if (error instanceof TripsInvariantError) {
+            return c.json({ error: error.message }, error.message.includes("was not found") ? 404 : 409);
+        }
+        throw error;
+    }
+}
+async function acceptPublicProposalWithQuoteLock({ c, options, db, quoteId, quoteVersionId, body, }) {
+    await lockQuoteAccept(db, quoteId);
+    await quotesService.expireQuoteVersionIfPastValidUntil(db, quoteVersionId);
+    const proposal = await quotesService.getQuoteVersionProposal(db, quoteVersionId);
+    if (!proposal)
+        return { kind: "response", response: c.json({ error: "Proposal not found" }, 404) };
+    if (proposal.quoteVersion.status === "draft") {
+        return { kind: "response", response: c.json({ error: "Proposal not found" }, 404) };
+    }
+    if (proposal.quoteVersion.status === "superseded") {
+        return {
+            kind: "response",
+            response: c.json({ error: "Proposal has been superseded" }, 410),
+        };
+    }
+    const isAcceptedReplay = proposal.quoteVersion.status === "accepted" &&
+        proposal.quote.acceptedVersionId === proposal.quoteVersion.id;
+    if (proposal.quoteVersion.status !== "sent" && !isAcceptedReplay) {
+        return {
+            kind: "response",
+            response: c.json({ error: "Proposal can no longer be accepted" }, 409),
+        };
+    }
+    if (!proposal.quoteVersion.tripSnapshotId) {
+        return {
+            kind: "response",
+            response: c.json({ error: "Proposal has no frozen Trip snapshot" }, 409),
+        };
+    }
+    const snapshot = await tripsService.getTripSnapshotById(db, proposal.quoteVersion.tripSnapshotId);
+    if (!snapshot) {
+        return {
+            kind: "response",
+            response: c.json({ error: "Proposal Trip snapshot not found" }, 409),
+        };
+    }
+    assertProposalMatchesTripSnapshot(proposal, snapshot);
+    if (isAcceptedReplay) {
+        const accepted = await quotesService.acceptQuoteVersion(db, quoteVersionId, {});
+        if (!accepted) {
+            return { kind: "response", response: c.json({ error: "Proposal not found" }, 404) };
+        }
+        return { kind: "accepted", accepted, snapshot, warnings: [] };
+    }
+    assertSnapshotCanUsePublicAcceptReserve(snapshot);
+    const liveTrip = await tripsService.getTrip(db, snapshot.envelopeId);
+    if (!liveTrip) {
+        return {
+            kind: "response",
+            response: c.json({ error: "Proposal Trip envelope not found" }, 409),
+        };
+    }
+    assertLiveTripMatchesSnapshot(liveTrip, snapshot);
+    const reserveIdempotencyKey = `proposal-accept-reserve:${quoteVersionId}:${body.idempotencyKey ?? "default"}`;
+    const reserved = await tripsService.reserveTrip(db, {
+        envelopeId: snapshot.envelopeId,
+        idempotencyKey: reserveIdempotencyKey,
+        refreshScope: {
+            locale: "en-US",
+            audience: "customer",
+            market: "default",
+            currency: snapshot.currency,
+        },
+    }, options.reserveTripDeps(c));
+    if (reserved.failures.length > 0) {
+        return {
+            kind: "response",
+            response: c.json({
+                error: "Proposal could not be reserved",
+                failures: reserved.failures.map(({ code, reason }) => ({ code, reason })),
+            }, 409),
+        };
+    }
+    const accepted = await quotesService.acceptQuoteVersion(db, quoteVersionId, {});
+    if (!accepted)
+        return { kind: "response", response: c.json({ error: "Proposal not found" }, 404) };
+    return { kind: "accepted", accepted, snapshot, warnings: reserved.warnings };
+}
+function lockQuoteAccept(db, quoteId) {
+    return db.execute(
+    // agent-quality: raw-sql reviewed -- owner: quotes; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+    sql `SELECT pg_advisory_xact_lock(hashtextextended(${quoteAcceptLockKey(quoteId)}, 0))`);
+}
+function quoteAcceptLockKey(quoteId) {
+    return `quote-accept:${quoteId}`;
+}
+function assertSnapshotCanUsePublicAcceptReserve(snapshot) {
+    const sourcedCatalogComponent = snapshot.frozenComponents.find(isSourcedCatalogSnapshotComponent);
+    if (!sourcedCatalogComponent)
+        return;
+    // reserveTrip runs under the Quote accept transaction. Owned catalog holds
+    // and manual placeholders are DB-local, but sourced catalog adapters can
+    // create upstream holds before local release records commit.
+    throw new QuoteVersionConflictError("Sourced catalog components cannot be accepted from public proposals yet");
+}
+function isSourcedCatalogSnapshotComponent(component) {
+    return Boolean(component.kind === "catalog_booking" &&
+        component.entityModule &&
+        component.entityId &&
+        component.sourceKind &&
+        component.sourceKind !== "owned");
+}
+async function startAcceptedProposalCheckout(c, options, snapshot, body, quoteVersionId) {
+    try {
+        return await tripsService.startCheckout(options.resolveDb(c), {
+            envelopeId: snapshot.envelopeId,
+            intent: body.intent,
+            idempotencyKey: `proposal-accept-checkout:${quoteVersionId}:${body.intent}:${body.idempotencyKey ?? "default"}`,
+            request: {
+                initiatedBy: "public-proposal",
+                collectionCurrency: snapshot.currency,
+            },
+        }, options.startCheckoutDeps(c));
+    }
+    catch (error) {
+        console.warn("[proposal] checkout handoff failed after proposal acceptance:", error);
+        return null;
+    }
+}
+function assertLiveTripMatchesSnapshot(trip, snapshot) {
+    const liveComponents = trip.components.filter((component) => component.status !== "removed");
+    if (stableSnapshotString(trip.envelope) !== stableSnapshotString(snapshot.frozenEnvelope) ||
+        stableSnapshotString(liveComponents) !== stableSnapshotString(snapshot.frozenComponents)) {
+        throw new QuoteVersionConflictError("Proposal Trip has changed since this Quote Version was sent");
+    }
+}
+function assertProposalMatchesTripSnapshot(proposal, snapshot) {
+    const expected = tripSnapshotToQuoteVersionApply(snapshot);
+    const actual = proposal.quoteVersion;
+    if (actual.tripSnapshotId !== snapshot.id ||
+        actual.currency !== expected.currency ||
+        actual.subtotalAmountCents !== expected.subtotalAmountCents ||
+        actual.taxAmountCents !== expected.taxAmountCents ||
+        actual.totalAmountCents !== expected.totalAmountCents ||
+        proposal.lines.length !== expected.lines.length) {
+        throw new QuoteVersionConflictError("Proposal does not match its frozen Trip snapshot");
+    }
+    for (const [index, expectedLine] of expected.lines.entries()) {
+        const actualLine = proposal.lines[index];
+        if (!actualLine ||
+            actualLine.description !== expectedLine.description ||
+            actualLine.quantity !== expectedLine.quantity ||
+            actualLine.unitPriceAmountCents !== expectedLine.unitPriceAmountCents ||
+            actualLine.totalAmountCents !== expectedLine.totalAmountCents ||
+            actualLine.currency !== expectedLine.currency) {
+            throw new QuoteVersionConflictError("Proposal does not match its frozen Trip snapshot");
+        }
+    }
+}
+function stableSnapshotString(value) {
+    return JSON.stringify(canonicalSnapshotValue(value));
+}
+function canonicalSnapshotValue(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value))
+        return value.map(canonicalSnapshotValue);
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value)
+            .filter(([, entryValue]) => entryValue !== undefined)
+            .sort(([leftKey], [rightKey]) => leftKey.localeCompare(rightKey))
+            .map(([key, entryValue]) => [key, canonicalSnapshotValue(entryValue)]));
+    }
+    return value;
+}
+async function handleFreezeQuoteVersionSnapshot(c, options) {
+    const envelopeId = c.req.param("envelopeId");
+    const quoteVersionId = c.req.param("quoteVersionId");
+    if (!envelopeId)
+        return c.json({ error: "Trip envelope id is required" }, 400);
+    if (!quoteVersionId)
+        return c.json({ error: "Quote version id is required" }, 400);
+    const db = options.resolveDb(c);
+    const body = await parseJsonBody(c, freezeQuoteVersionSnapshotBodySchema);
+    try {
+        const quoteVersion = await quotesService.getQuoteVersionById(db, quoteVersionId);
+        if (!quoteVersion)
+            return c.json({ error: "Quote version not found" }, 404);
+        if (quoteVersion.status !== "draft") {
+            return c.json({ error: "Trip snapshots can only be applied to draft Quote Versions" }, 409);
+        }
+        const userId = c.get("userId");
+        const snapshot = await tripsService.freezeTripSnapshot(db, {
+            envelopeId,
+            createdBy: typeof userId === "string" ? userId : (body.createdBy ?? undefined),
+        });
+        const applied = await quotesService.applyTripSnapshotToQuoteVersion(db, quoteVersionId, tripSnapshotToQuoteVersionApply(snapshot));
+        if (!applied)
+            return c.json({ error: "Quote version not found" }, 404);
+        return c.json({
+            data: {
+                snapshot,
+                quoteVersion: applied.quoteVersion,
+                lines: applied.lines,
+            },
+        }, 201);
+    }
+    catch (error) {
+        if (error instanceof TripsInvariantError) {
+            return c.json({ error: error.message }, error.message.includes("was not found") ? 404 : 409);
+        }
+        if (error instanceof QuoteVersionConflictError) {
+            return c.json({ error: error.message }, 409);
+        }
+        throw error;
+    }
+}
+/** Map a frozen Trip snapshot's proposal into a quote-version apply payload. */
+export function tripSnapshotToQuoteVersionApply(snapshot) {
+    const proposal = snapshot.proposal;
+    return {
+        tripSnapshotId: snapshot.id,
+        currency: proposal.currency,
+        subtotalAmountCents: proposal.subtotalAmountCents,
+        taxAmountCents: proposal.taxAmountCents,
+        totalAmountCents: proposal.totalAmountCents,
+        lines: proposal.lines.map(tripSnapshotLineToQuoteVersionLine),
+    };
+}
+function tripSnapshotLineToQuoteVersionLine(line) {
+    return {
+        componentId: line.componentId,
+        productId: line.entityModule === "products" ? line.entityId : null,
+        supplierServiceId: line.entityModule === "supplier_services" ? line.entityId : null,
+        description: line.description,
+        quantity: 1,
+        unitPriceAmountCents: line.subtotalAmountCents,
+        totalAmountCents: line.totalAmountCents,
+        currency: line.currency,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/quotes",
-  "version": "0.119.3",
+  "version": "0.120.1",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -28,6 +28,11 @@
       "types": "./dist/booking-extension.d.ts",
       "import": "./dist/booking-extension.js",
       "default": "./dist/booking-extension.js"
+    },
+    "./proposal-routes": {
+      "types": "./dist/proposal-routes.d.ts",
+      "import": "./dist/proposal-routes.js",
+      "default": "./dist/proposal-routes.js"
     }
   },
   "dependencies": {
@@ -36,8 +41,9 @@
     "zod": "^4.3.6",
     "@voyant-travel/core": "^0.109.0",
     "@voyant-travel/quotes-contracts": "^0.107.0",
-    "@voyant-travel/db": "^0.108.0",
-    "@voyant-travel/hono": "^0.110.0"
+    "@voyant-travel/db": "^0.108.1",
+    "@voyant-travel/hono": "^0.111.0",
+    "@voyant-travel/trips": "^0.113.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",