@voyant-travel/quotes-react 0.122.0 → 0.124.0

package/dist/hooks/use-quote-media-mutation.js

@@ -0,0 +1,63 @@
+"use client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantContext } from "../provider.js";
+import { quotesQueryKeys } from "../query-keys.js";
+import { quoteMediaSingleResponse, successEnvelope } from "../schemas.js";
+/** Attach / remove quote media (the upload itself goes through `/v1/uploads`). */
+export function useQuoteMediaMutation() {
+    const { baseUrl, fetcher } = useVoyantContext();
+    const queryClient = useQueryClient();
+    const invalidate = (quoteId) => {
+        void queryClient.invalidateQueries({ queryKey: quotesQueryKeys.quoteMedia(quoteId) });
+    };
+    const create = useMutation({
+        mutationFn: async ({ quoteId, input }) => {
+            const { data } = await fetchWithValidation(`/v1/quotes/quotes/${quoteId}/media`, quoteMediaSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: (_data, vars) => invalidate(vars.quoteId),
+    });
+    // Upload a file to the deployment's media store (`/v1/uploads`), then attach
+    // the resulting object to the quote. Multipart upload uses a raw cookie-auth
+    // fetch (the shared JSON fetcher can't carry FormData).
+    const upload = useMutation({
+        mutationFn: async ({ quoteId, file }) => {
+            const form = new FormData();
+            form.append("file", file);
+            const res = await fetch(`${baseUrl}/v1/uploads`, {
+                method: "POST",
+                body: form,
+                credentials: "include",
+            });
+            if (!res.ok)
+                throw new Error(`Upload failed (${res.status})`);
+            const uploaded = (await res.json());
+            const mediaType = uploaded.mimeType.startsWith("video/")
+                ? "video"
+                : uploaded.mimeType.startsWith("image/")
+                    ? "image"
+                    : "document";
+            const { data } = await fetchWithValidation(`/v1/quotes/quotes/${quoteId}/media`, quoteMediaSingleResponse, { baseUrl, fetcher }, {
+                method: "POST",
+                body: JSON.stringify({
+                    mediaType,
+                    name: file.name,
+                    url: uploaded.url,
+                    storageKey: uploaded.key,
+                    mimeType: uploaded.mimeType,
+                    fileSize: uploaded.size,
+                }),
+            });
+            return data;
+        },
+        onSuccess: (_data, vars) => invalidate(vars.quoteId),
+    });
+    const remove = useMutation({
+        mutationFn: async ({ id }) => {
+            await fetchWithValidation(`/v1/quotes/quote-media/${id}`, successEnvelope, { baseUrl, fetcher }, { method: "DELETE" });
+        },
+        onSuccess: (_data, vars) => invalidate(vars.quoteId),
+    });
+    return { create, upload, remove };
+}

package/dist/hooks/use-quote-media.d.ts

@@ -0,0 +1,21 @@
+export interface UseQuoteMediaOptions {
+    enabled?: boolean;
+}
+/** Lists a quote's media (images / videos / documents shown on the proposal). */
+export declare function useQuoteMedia(quoteId: string | undefined, options?: UseQuoteMediaOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        id: string;
+        quoteId: string;
+        mediaType: string;
+        name: string;
+        url: string;
+        storageKey: string | null;
+        mimeType: string | null;
+        fileSize: number | null;
+        altText: string | null;
+        sortOrder: number;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+}, Error>;
+//# sourceMappingURL=use-quote-media.d.ts.map

package/dist/hooks/use-quote-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-quote-media.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quote-media.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,oBAAyB;;;;;;;;;;;;;;;UAa5F"}

package/dist/hooks/use-quote-media.js

@@ -0,0 +1,19 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantContext } from "../provider.js";
+import { quotesQueryKeys } from "../query-keys.js";
+import { quoteMediaListResponse } from "../schemas.js";
+/** Lists a quote's media (images / videos / documents shown on the proposal). */
+export function useQuoteMedia(quoteId, options = {}) {
+    const { baseUrl, fetcher } = useVoyantContext();
+    const { enabled = true } = options;
+    return useQuery({
+        queryKey: quotesQueryKeys.quoteMedia(quoteId ?? ""),
+        queryFn: () => fetchWithValidation(`/v1/quotes/quotes/${quoteId}/media`, quoteMediaListResponse, {
+            baseUrl,
+            fetcher,
+        }),
+        enabled: enabled && Boolean(quoteId),
+    });
+}

package/dist/hooks/use-quote-mutation.d.ts

@@ -30,11 +30,15 @@ export declare function useQuoteMutation(): {
         acceptedVersionId: string | null;
         valueAmountCents: number | null;
         valueCurrency: string | null;
+        paxCount: number | null;
+        description: string | null;
         expectedCloseDate: string | null;
         source: string | null;
         sourceRef: string | null;
         lostReason: string | null;
         tags: string[];
+        createdBy: string | null;
+        updatedBy: string | null;
         createdAt: string;
         updatedAt: string;
         stageChangedAt: string;
@@ -52,11 +56,15 @@ export declare function useQuoteMutation(): {
         acceptedVersionId: string | null;
         valueAmountCents: number | null;
         valueCurrency: string | null;
+        paxCount: number | null;
+        description: string | null;
         expectedCloseDate: string | null;
         source: string | null;
         sourceRef: string | null;
         lostReason: string | null;
         tags: string[];
+        createdBy: string | null;
+        updatedBy: string | null;
         createdAt: string;
         updatedAt: string;
         stageChangedAt: string;

package/dist/hooks/use-quote-mutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-quote-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quote-mutation.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAIxD,wBAAgB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAuBY,MAAM;eAAS,gBAAgB;;;;;EAqC1E"}
+{"version":3,"file":"use-quote-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quote-mutation.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAIxD,wBAAgB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAuBY,MAAM;eAAS,gBAAgB;;;;;EAqC1E"}

package/dist/hooks/use-quote-participant-mutation.d.ts

@@ -0,0 +1,24 @@
+export interface CreateQuoteParticipantInput {
+    personId: string;
+    role?: "traveler" | "booker" | "decision_maker" | "finance" | "other";
+    isPrimary?: boolean;
+}
+/** Add / remove travelers (participants / PAX) on a quote. */
+export declare function useQuoteParticipantMutation(): {
+    create: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        quoteId: string;
+        personId: string;
+        role: string;
+        isPrimary: boolean;
+        createdAt: string;
+    }, Error, {
+        quoteId: string;
+        input: CreateQuoteParticipantInput;
+    }, unknown>;
+    remove: import("@tanstack/react-query").UseMutationResult<void, Error, {
+        id: string;
+        quoteId: string;
+    }, unknown>;
+};
+//# sourceMappingURL=use-quote-participant-mutation.d.ts.map

package/dist/hooks/use-quote-participant-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-quote-participant-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quote-participant-mutation.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAA;IACrE,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,8DAA8D;AAC9D,wBAAgB,2BAA2B;;;;;;;;;iBAa5B,MAAM;eACR,2BAA2B;;;YAcH,MAAM;iBAAW,MAAM;;EAY3D"}

package/dist/hooks/use-quote-participant-mutation.js

@@ -0,0 +1,28 @@
+"use client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantContext } from "../provider.js";
+import { quotesQueryKeys } from "../query-keys.js";
+import { quoteParticipantSingleResponse, successEnvelope } from "../schemas.js";
+/** Add / remove travelers (participants / PAX) on a quote. */
+export function useQuoteParticipantMutation() {
+    const { baseUrl, fetcher } = useVoyantContext();
+    const queryClient = useQueryClient();
+    const invalidate = (quoteId) => {
+        void queryClient.invalidateQueries({ queryKey: quotesQueryKeys.quoteParticipants(quoteId) });
+    };
+    const create = useMutation({
+        mutationFn: async ({ quoteId, input, }) => {
+            const { data } = await fetchWithValidation(`/v1/quotes/quotes/${quoteId}/participants`, quoteParticipantSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: (_data, vars) => invalidate(vars.quoteId),
+    });
+    const remove = useMutation({
+        mutationFn: async ({ id }) => {
+            await fetchWithValidation(`/v1/quotes/quote-participants/${id}`, successEnvelope, { baseUrl, fetcher }, { method: "DELETE" });
+        },
+        onSuccess: (_data, vars) => invalidate(vars.quoteId),
+    });
+    return { create, remove };
+}

package/dist/hooks/use-quote-participants.d.ts

@@ -0,0 +1,15 @@
+export interface UseQuoteParticipantsOptions {
+    enabled?: boolean;
+}
+/** Lists a quote's participants (the travelers / PAX). */
+export declare function useQuoteParticipants(quoteId: string | undefined, options?: UseQuoteParticipantsOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        id: string;
+        quoteId: string;
+        personId: string;
+        role: string;
+        isPrimary: boolean;
+        createdAt: string;
+    }[];
+}, Error>;
+//# sourceMappingURL=use-quote-participants.d.ts.map

package/dist/hooks/use-quote-participants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-quote-participants.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quote-participants.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,GAAE,2BAAgC;;;;;;;;;UAe1C"}

package/dist/hooks/use-quote-participants.js

@@ -0,0 +1,16 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantContext } from "../provider.js";
+import { quotesQueryKeys } from "../query-keys.js";
+import { quoteParticipantListResponse } from "../schemas.js";
+/** Lists a quote's participants (the travelers / PAX). */
+export function useQuoteParticipants(quoteId, options = {}) {
+    const { baseUrl, fetcher } = useVoyantContext();
+    const { enabled = true } = options;
+    return useQuery({
+        queryKey: quotesQueryKeys.quoteParticipants(quoteId ?? ""),
+        queryFn: () => fetchWithValidation(`/v1/quotes/quotes/${quoteId}/participants`, quoteParticipantListResponse, { baseUrl, fetcher }),
+        enabled: enabled && Boolean(quoteId),
+    });
+}

package/dist/hooks/use-quote-product-mutation.d.ts

@@ -0,0 +1,57 @@
+export interface CreateQuoteProductInput {
+    nameSnapshot: string;
+    quantity?: number;
+    unitPriceAmountCents?: number | null;
+    currency?: string | null;
+    description?: string | null;
+    productId?: string | null;
+    supplierServiceId?: string | null;
+    costAmountCents?: number | null;
+    discountAmountCents?: number | null;
+}
+export type UpdateQuoteProductInput = Partial<CreateQuoteProductInput>;
+/** Create / update / remove a quote's line-item products. */
+export declare function useQuoteProductMutation(): {
+    create: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        quoteId: string;
+        productId: string | null;
+        supplierServiceId: string | null;
+        nameSnapshot: string;
+        description: string | null;
+        quantity: number;
+        unitPriceAmountCents: number | null;
+        costAmountCents: number | null;
+        currency: string | null;
+        discountAmountCents: number | null;
+        createdAt: string;
+        updatedAt: string;
+    }, Error, {
+        quoteId: string;
+        input: CreateQuoteProductInput;
+    }, unknown>;
+    update: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        quoteId: string;
+        productId: string | null;
+        supplierServiceId: string | null;
+        nameSnapshot: string;
+        description: string | null;
+        quantity: number;
+        unitPriceAmountCents: number | null;
+        costAmountCents: number | null;
+        currency: string | null;
+        discountAmountCents: number | null;
+        createdAt: string;
+        updatedAt: string;
+    }, Error, {
+        id: string;
+        quoteId: string;
+        input: UpdateQuoteProductInput;
+    }, unknown>;
+    remove: import("@tanstack/react-query").UseMutationResult<void, Error, {
+        id: string;
+        quoteId: string;
+    }, unknown>;
+};
+//# sourceMappingURL=use-quote-product-mutation.d.ts.map

package/dist/hooks/use-quote-product-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-quote-product-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quote-product-mutation.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC;AAED,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;AAEtE,6DAA6D;AAC7D,wBAAgB,uBAAuB;;;;;;;;;;;;;;;;iBAUe,MAAM;eAAS,uBAAuB;;;;;;;;;;;;;;;;;YAiBlF,MAAM;iBACD,MAAM;eACR,uBAAuB;;;YAcC,MAAM;iBAAW,MAAM;;EAY3D"}

package/dist/hooks/use-quote-product-mutation.js

@@ -0,0 +1,36 @@
+"use client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantContext } from "../provider.js";
+import { quotesQueryKeys } from "../query-keys.js";
+import { quoteProductSingleResponse, successEnvelope } from "../schemas.js";
+/** Create / update / remove a quote's line-item products. */
+export function useQuoteProductMutation() {
+    const { baseUrl, fetcher } = useVoyantContext();
+    const queryClient = useQueryClient();
+    const invalidate = (quoteId) => {
+        void queryClient.invalidateQueries({ queryKey: quotesQueryKeys.quoteProducts(quoteId) });
+        void queryClient.invalidateQueries({ queryKey: quotesQueryKeys.quote(quoteId) });
+    };
+    const create = useMutation({
+        mutationFn: async ({ quoteId, input }) => {
+            const { data } = await fetchWithValidation(`/v1/quotes/quotes/${quoteId}/products`, quoteProductSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: (_data, vars) => invalidate(vars.quoteId),
+    });
+    const update = useMutation({
+        mutationFn: async ({ id, input, }) => {
+            const { data } = await fetchWithValidation(`/v1/quotes/quote-products/${id}`, quoteProductSingleResponse, { baseUrl, fetcher }, { method: "PATCH", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: (_data, vars) => invalidate(vars.quoteId),
+    });
+    const remove = useMutation({
+        mutationFn: async ({ id }) => {
+            await fetchWithValidation(`/v1/quotes/quote-products/${id}`, successEnvelope, { baseUrl, fetcher }, { method: "DELETE" });
+        },
+        onSuccess: (_data, vars) => invalidate(vars.quoteId),
+    });
+    return { create, update, remove };
+}

package/dist/hooks/use-quote-products.d.ts

@@ -0,0 +1,22 @@
+export interface UseQuoteProductsOptions {
+    enabled?: boolean;
+}
+/** Lists a quote's products — the line items (flights, stays, experiences, …). */
+export declare function useQuoteProducts(quoteId: string | undefined, options?: UseQuoteProductsOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        id: string;
+        quoteId: string;
+        productId: string | null;
+        supplierServiceId: string | null;
+        nameSnapshot: string;
+        description: string | null;
+        quantity: number;
+        unitPriceAmountCents: number | null;
+        costAmountCents: number | null;
+        currency: string | null;
+        discountAmountCents: number | null;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+}, Error>;
+//# sourceMappingURL=use-quote-products.d.ts.map

package/dist/hooks/use-quote-products.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-quote-products.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quote-products.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,GAAE,uBAA4B;;;;;;;;;;;;;;;;UActC"}

package/dist/hooks/use-quote-products.js

@@ -0,0 +1,19 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantContext } from "../provider.js";
+import { quotesQueryKeys } from "../query-keys.js";
+import { quoteProductListResponse } from "../schemas.js";
+/** Lists a quote's products — the line items (flights, stays, experiences, …). */
+export function useQuoteProducts(quoteId, options = {}) {
+    const { baseUrl, fetcher } = useVoyantContext();
+    const { enabled = true } = options;
+    return useQuery({
+        queryKey: quotesQueryKeys.quoteProducts(quoteId ?? ""),
+        queryFn: () => fetchWithValidation(`/v1/quotes/quotes/${quoteId}/products`, quoteProductListResponse, {
+            baseUrl,
+            fetcher,
+        }),
+        enabled: enabled && Boolean(quoteId),
+    });
+}

package/dist/hooks/use-quote-version-mutation.d.ts

@@ -56,6 +56,81 @@ export declare function useQuoteVersionMutation(): {
         quoteId: string;
         input: CreateQuoteVersionInput;
     }, unknown>;
+    snapshot: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        quoteId: string;
+        label: string | null;
+        status: string;
+        supersedesId: string | null;
+        tripSnapshotId: string | null;
+        validUntil: string | null;
+        currency: string;
+        subtotalAmountCents: number;
+        taxAmountCents: number;
+        totalAmountCents: number;
+        notes: string | null;
+        sentAt: string | null;
+        viewedAt: string | null;
+        decidedAt: string | null;
+        createdAt: string;
+        updatedAt: string;
+        archivedAt: string | null;
+    }, Error, {
+        quoteId: string;
+    }, unknown>;
+    sendProposal: import("@tanstack/react-query").UseMutationResult<{
+        quoteVersion: {
+            id: string;
+            quoteId: string;
+            label: string | null;
+            status: string;
+            supersedesId: string | null;
+            tripSnapshotId: string | null;
+            validUntil: string | null;
+            currency: string;
+            subtotalAmountCents: number;
+            taxAmountCents: number;
+            totalAmountCents: number;
+            notes: string | null;
+            sentAt: string | null;
+            viewedAt: string | null;
+            decidedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+            archivedAt: string | null;
+        };
+        proposalUrl: string;
+    }, Error, {
+        id: string;
+    }, unknown>;
+    fetchProposalLink: import("@tanstack/react-query").UseMutationResult<{
+        proposalUrl: string;
+    }, Error, {
+        id: string;
+    }, unknown>;
+    setValidUntil: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        quoteId: string;
+        label: string | null;
+        status: string;
+        supersedesId: string | null;
+        tripSnapshotId: string | null;
+        validUntil: string | null;
+        currency: string;
+        subtotalAmountCents: number;
+        taxAmountCents: number;
+        totalAmountCents: number;
+        notes: string | null;
+        sentAt: string | null;
+        viewedAt: string | null;
+        decidedAt: string | null;
+        createdAt: string;
+        updatedAt: string;
+        archivedAt: string | null;
+    }, Error, {
+        id: string;
+        validUntil: string | null;
+    }, unknown>;
     update: import("@tanstack/react-query").UseMutationResult<{
         id: string;
         quoteId: string;
@@ -158,11 +233,15 @@ export declare function useQuoteVersionMutation(): {
             acceptedVersionId: string | null;
             valueAmountCents: number | null;
             valueCurrency: string | null;
+            paxCount: number | null;
+            description: string | null;
             expectedCloseDate: string | null;
             source: string | null;
             sourceRef: string | null;
             lostReason: string | null;
             tags: string[];
+            createdBy: string | null;
+            updatedBy: string | null;
             createdAt: string;
             updatedAt: string;
             stageChangedAt: string;

package/dist/hooks/use-quote-version-mutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-quote-version-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quote-version-mutation.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;AAEtE,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAA;AAK9E,wBAAgB,uBAAuB;;;;;;;;;;;;;;;;;;;;;iBAKe,MAAM;eAAS,uBAAuB;;;;;;;;;;;;;;;;;;;;;;YAmBhD,MAAM;eAAS,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;YAgCtC,MAAM;gBAAU,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqG3D,MAAM;eACf,2BAA2B;;;;;;;;;;;;;;;wBA0BlB,MAAM;gBACd,MAAM;eACP,2BAA2B;;;;;wBAyBlB,MAAM;gBACd,MAAM;;EAgCnB"}
+{"version":3,"file":"use-quote-version-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quote-version-mutation.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;AAEtE,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAA;AAK9E,wBAAgB,uBAAuB;;;;;;;;;;;;;;;;;;;;;iBAKe,MAAM;eAAS,uBAAuB;;;;;;;;;;;;;;;;;;;;;;iBAsB7C,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;YAuChB,MAAM;;;;;YAwBN,MAAM;;;;;;;;;;;;;;;;;;;;;;YA1CM,MAAM;oBAAc,MAAM,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;YAsDtC,MAAM;eAAS,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;YAgCtC,MAAM;gBAAU,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqG3D,MAAM;eACf,2BAA2B;;;;;;;;;;;;;;;wBA0BlB,MAAM;gBACd,MAAM;eACP,2BAA2B;;;;;wBAyBlB,MAAM;gBACd,MAAM;;EAoCnB"}

package/dist/hooks/use-quote-version-mutation.js

@@ -23,6 +23,60 @@ export function useQuoteVersionMutation() {
             void queryClient.invalidateQueries({ queryKey: quotesQueryKeys.quote(vars.quoteId) });
         },
     });
+    // Snapshot the quote's current line items into a new version (the "Save"
+    // action). The server copies products → version lines, computes the total,
+    // and supersedes the prior current version.
+    const snapshot = useMutation({
+        mutationFn: async ({ quoteId }) => {
+            const { data } = await fetchWithValidation(`/v1/quotes/quotes/${quoteId}/versions/snapshot`, quoteVersionSingleResponse, { baseUrl, fetcher }, { method: "POST" });
+            return data;
+        },
+        onSuccess: (_data, vars) => {
+            void queryClient.invalidateQueries({ queryKey: quotesQueryKeys.quoteVersions() });
+            void queryClient.invalidateQueries({
+                queryKey: quotesQueryKeys.quoteVersionsList({ quoteId: vars.quoteId }),
+            });
+            void queryClient.invalidateQueries({ queryKey: quotesQueryKeys.quote(vars.quoteId) });
+        },
+    });
+    // Narrow validity-date update (the generic update schema carries insert
+    // defaults that would clobber status/totals — see the service note).
+    const setValidUntil = useMutation({
+        mutationFn: async ({ id, validUntil }) => {
+            const { data } = await fetchWithValidation(`/v1/quotes/quote-versions/${id}/validity`, quoteVersionSingleResponse, { baseUrl, fetcher }, { method: "PATCH", body: JSON.stringify({ validUntil }) });
+            return data;
+        },
+        onSuccess: (data) => {
+            void queryClient.invalidateQueries({ queryKey: quotesQueryKeys.quoteVersions() });
+            void queryClient.invalidateQueries({ queryKey: quotesQueryKeys.quote(data.quoteId) });
+        },
+    });
+    // Send a version to the client for review (proposal admin route). Marks it
+    // "sent" and returns the shareable proposal URL.
+    const sendProposal = useMutation({
+        mutationFn: async ({ id }) => {
+            const { data } = await fetchWithValidation(`/v1/admin/quote-versions/${id}/send`, z.object({
+                data: z.object({ quoteVersion: quoteVersionRecordSchema, proposalUrl: z.string() }),
+            }), { baseUrl, fetcher }, { method: "POST", body: JSON.stringify({}) });
+            return data;
+        },
+        onSuccess: (data) => {
+            void queryClient.invalidateQueries({ queryKey: quotesQueryKeys.quoteVersions() });
+            void queryClient.invalidateQueries({
+                queryKey: quotesQueryKeys.quote(data.quoteVersion.quoteId),
+            });
+        },
+    });
+    // Resolve the deployment's shareable proposal URL for an already-sent
+    // version without side effects (no re-send, no view tracking) — used when
+    // re-copying the review link. Returns the same deployment-resolved URL the
+    // initial send produced.
+    const fetchProposalLink = useMutation({
+        mutationFn: async ({ id }) => {
+            const { data } = await fetchWithValidation(`/v1/admin/quote-versions/${id}/proposal-link`, z.object({ data: z.object({ proposalUrl: z.string() }) }), { baseUrl, fetcher }, { method: "GET" });
+            return data;
+        },
+    });
     const update = useMutation({
         mutationFn: async ({ id, input }) => {
             const { data } = await fetchWithValidation(`/v1/quotes/quote-versions/${id}`, quoteVersionSingleResponse, { baseUrl, fetcher }, { method: "PATCH", body: JSON.stringify(input) });
@@ -150,6 +204,10 @@ export function useQuoteVersionMutation() {
     });
     return {
         create,
+        snapshot,
+        sendProposal,
+        fetchProposalLink,
+        setValidUntil,
         update,
         remove,
         send,

package/dist/hooks/use-quote.d.ts

@@ -13,11 +13,15 @@ export declare function useQuote(id: string | undefined, options?: UseQuoteOptio
     acceptedVersionId: string | null;
     valueAmountCents: number | null;
     valueCurrency: string | null;
+    paxCount: number | null;
+    description: string | null;
     expectedCloseDate: string | null;
     source: string | null;
     sourceRef: string | null;
     lostReason: string | null;
     tags: string[];
+    createdBy: string | null;
+    updatedBy: string | null;
     createdAt: string;
     updatedAt: string;
     stageChangedAt: string;

package/dist/hooks/use-quote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-quote.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quote.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,eAAoB;;;;;;;;;;;;;;;;;;;;;UAgB7E"}
+{"version":3,"file":"use-quote.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quote.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,eAAoB;;;;;;;;;;;;;;;;;;;;;;;;;UAgB7E"}

package/dist/hooks/use-quotes.d.ts

@@ -19,11 +19,15 @@ export declare function useQuotes(options?: UseQuotesOptions): import("@tanstack
         acceptedVersionId: string | null;
         valueAmountCents: number | null;
         valueCurrency: string | null;
+        paxCount: number | null;
+        description: string | null;
         expectedCloseDate: string | null;
         source: string | null;
         sourceRef: string | null;
         lostReason: string | null;
         tags: string[];
+        createdBy: string | null;
+        updatedBy: string | null;
         createdAt: string;
         updatedAt: string;
         stageChangedAt: string;

package/dist/hooks/use-quotes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-quotes.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quotes.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,iBAAiB,EAAmB,MAAM,kBAAkB,CAAA;AAG1E,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;UAyBvD"}
+{"version":3,"file":"use-quotes.d.ts","sourceRoot":"","sources":["../../src/hooks/use-quotes.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,iBAAiB,EAAmB,MAAM,kBAAkB,CAAA;AAG1E,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAyBvD"}