@dropins/storefront-quote-management 1.0.0-beta1 → 1.0.0-beta3

package/data/transforms/__fixtures__/negotiableQuoteData.d.ts

@@ -198,6 +198,7 @@ export declare const mockQuoteData: {
             }[];
         };
         quantity: number;
+        is_available: boolean;
         note_from_buyer: {
             created_at: string;
             creator_id: number;
@@ -282,6 +283,7 @@ export declare const mockQuoteData: {
             discounts: never[];
         };
         quantity: number;
+        is_available: boolean;
         configurable_options: {
             option_label: string;
             value_label: string;
@@ -296,6 +298,7 @@ export declare const mockQuoteData: {
         }[];
         note_from_seller: never[];
         configured_variant: {
+            stock_status: string;
             thumbnail: {
                 label: string;
                 url: string;
@@ -400,6 +403,7 @@ export declare const mockQuoteData: {
             }[];
         };
         quantity: number;
+        is_available: boolean;
         bundle_options: {
             label: string;
             values: {
@@ -511,6 +515,7 @@ export declare const mockQuoteData: {
             }[];
         };
         quantity: number;
+        is_available: boolean;
         links: {
             sort_order: number;
             title: string;

package/data/transforms/__fixtures__/negotiableQuoteTemplateData.d.ts

@@ -314,6 +314,17 @@ export declare const mockQuoteTemplateData: {
         };
         telephone: string;
     }[];
+    reference_document_links: ({
+        link_id: string;
+        document_name: string;
+        document_identifier: string;
+        reference_document_url: string;
+    } | {
+        link_id: string;
+        document_name: string;
+        reference_document_url: string;
+        document_identifier?: undefined;
+    })[];
 };
 export declare const mockMinimalQuoteTemplateData: {
     template_id: string;
@@ -636,6 +647,17 @@ export declare const mockSubmittedQuoteTemplateData: {
         };
         telephone: string;
     }[];
+    reference_document_links: ({
+        link_id: string;
+        document_name: string;
+        document_identifier: string;
+        reference_document_url: string;
+    } | {
+        link_id: string;
+        document_name: string;
+        reference_document_url: string;
+        document_identifier?: undefined;
+    })[];
 };
 export declare const mockInReviewQuoteTemplateData: {
     template_id: string;
@@ -945,6 +967,17 @@ export declare const mockInReviewQuoteTemplateData: {
         };
         telephone: string;
     }[];
+    reference_document_links: ({
+        link_id: string;
+        document_name: string;
+        document_identifier: string;
+        reference_document_url: string;
+    } | {
+        link_id: string;
+        document_name: string;
+        reference_document_url: string;
+        document_identifier?: undefined;
+    })[];
 };
 export declare const mockClosedQuoteTemplateData: {
     template_id: string;
@@ -1254,6 +1287,17 @@ export declare const mockClosedQuoteTemplateData: {
         };
         telephone: string;
     }[];
+    reference_document_links: ({
+        link_id: string;
+        document_name: string;
+        document_identifier: string;
+        reference_document_url: string;
+    } | {
+        link_id: string;
+        document_name: string;
+        reference_document_url: string;
+        document_identifier?: undefined;
+    })[];
 };
 export declare const mockInactiveQuoteTemplateData: {
     template_id: string;
@@ -1563,6 +1607,17 @@ export declare const mockInactiveQuoteTemplateData: {
         };
         telephone: string;
     }[];
+    reference_document_links: ({
+        link_id: string;
+        document_name: string;
+        document_identifier: string;
+        reference_document_url: string;
+    } | {
+        link_id: string;
+        document_name: string;
+        reference_document_url: string;
+        document_identifier?: undefined;
+    })[];
 };
 export declare const mockQuoteTemplateListData: {
     items: {

package/hooks/useItemsQuotedTemplate.d.ts

@@ -0,0 +1,16 @@
+import { ProductListTableItem } from '../components';
+import { QuoteTemplateCartItem } from '../data/models/negotiable-quote-template-model';
+
+export interface UseItemsQuotedTemplateReturn {
+    dropdownSelections: Record<string, string | undefined>;
+    handleItemDropdownChange: (item: ProductListTableItem, action: string) => void;
+    handleDismissRemoveBanner: () => void;
+}
+export interface UseItemsQuotedTemplateParams {
+    handleRemoveItems: (items: QuoteTemplateCartItem[]) => void;
+}
+/**
+ * Custom hook to manage dropdown selections and item actions for quote template items
+ */
+export declare const useItemsQuotedTemplate: (params: UseItemsQuotedTemplateParams) => UseItemsQuotedTemplateReturn;
+//# sourceMappingURL=useItemsQuotedTemplate.d.ts.map

package/hooks/useReferenceDocumentLinks.d.ts

@@ -0,0 +1,34 @@
+import { ReferenceDocument } from '../components';
+import { ReferenceDocumentLinkInput } from '../api/sendQuoteTemplateForReview/sendQuoteTemplateForReview';
+
+export interface UseReferenceDocumentLinksParams {
+    templateReferenceDocuments?: ReferenceDocument[];
+    localReferenceDocuments: ReferenceDocument[];
+}
+export interface UseReferenceDocumentLinksReturn {
+    /**
+     * Checks if a document exists in the template reference documents.
+     * Matches by uid if both documents have it, otherwise matches by url.
+     */
+    isDocumentInTemplateData: (document: ReferenceDocument) => boolean;
+    /**
+     * Returns documents from localReferenceDocuments that are not in templateReferenceDocuments.
+     */
+    getNewDocuments: () => ReferenceDocument[];
+    /**
+     * Transforms all reference documents to API format.
+     */
+    getReferenceDocumentLinks: () => ReferenceDocumentLinkInput[];
+    /**
+     * Indicates if there are unsaved changes (new documents, removed documents, or modified documents).
+     */
+    hasUnsavedChanges: boolean;
+}
+/**
+ * Custom hook to manage reference document links logic.
+ * Handles document matching, filtering new documents, transformation to API format,
+ * and detection of unsaved changes (new, removed, or modified documents).
+ * Note: getReferenceDocumentLinks() returns all local reference documents, not just new ones.
+ */
+export declare const useReferenceDocumentLinks: (params: UseReferenceDocumentLinksParams) => UseReferenceDocumentLinksReturn;
+//# sourceMappingURL=useReferenceDocumentLinks.d.ts.map

package/hooks/useRemoveTemplateItems.d.ts

@@ -0,0 +1,25 @@
+import { QuoteTemplateCartItem } from '../data/models/negotiable-quote-template-model';
+
+export interface UseRemoveTemplateItemsReturn {
+    handleRemoveItems: (items: QuoteTemplateCartItem[]) => void;
+    handleConfirmRemove: () => Promise<void>;
+    handleCancelRemove: () => void;
+    isRemoveModalOpen: boolean;
+    itemsToRemove: QuoteTemplateCartItem[];
+    isRemoving: boolean;
+    removeNotificationState: {
+        type: 'success' | 'error' | null;
+        message: string;
+    };
+}
+export interface UseRemoveTemplateItemsParams {
+    templateId?: string;
+    onRemoveModalStateChange?: (isOpen: boolean) => void;
+    removeSuccessMessage: string;
+    removeErrorMessage: string;
+}
+/**
+ * Custom hook to manage removing items from a quote template
+ */
+export declare const useRemoveTemplateItems: (params: UseRemoveTemplateItemsParams) => UseRemoveTemplateItemsReturn;
+//# sourceMappingURL=useRemoveTemplateItems.d.ts.map

package/hooks/useRenameTemplate.d.ts

@@ -0,0 +1,71 @@
+/********************************************************************
+ *  Copyright 2025 Adobe
+ *  All Rights Reserved.
+ *
+ * NOTICE:  Adobe permits you to use, modify, and distribute this
+ * file in accordance with the terms of the Adobe license agreement
+ * accompanying it.
+ *******************************************************************/
+export interface UseRenameTemplateParams {
+    initialTemplateName?: string;
+    templateNameRequiredErrorMessage?: string;
+}
+export interface UseRenameTemplateReturn {
+    /**
+     * Whether the rename modal is currently open.
+     */
+    isRenameModalOpen: boolean;
+    /**
+     * The new template name entered by the user.
+     */
+    renameTemplateName: string;
+    /**
+     * The reason for renaming the template.
+     */
+    renameReason: string;
+    /**
+     * Error message for rename operation.
+     */
+    renameError: string;
+    /**
+     * Error message for template name validation.
+     */
+    renameTemplateNameError: string;
+    /**
+     * Success message for rename operation.
+     */
+    renameSuccess: string;
+    /**
+     * Opens the rename modal and initializes state with the current template name.
+     */
+    handleRenameClick: (currentTemplateName?: string) => void;
+    /**
+     * Closes the rename modal and resets all state.
+     */
+    handleRenameClose: () => void;
+    /**
+     * Updates the template name and clears any name-related errors.
+     */
+    handleRenameTemplateNameChange: (value: string) => void;
+    /**
+     * Updates the rename reason.
+     */
+    handleRenameReasonChange: (value: string) => void;
+    /**
+     * Validates and saves the rename. Closes the modal if validation passes.
+     * Does not make an API call - rename is tracked locally and included when submitting for review.
+     */
+    handleRenameSave: () => boolean;
+    /**
+     * Resets rename state (useful after successful submission).
+     */
+    resetRenameState: () => void;
+}
+/**
+ * Custom hook to manage quote template rename functionality.
+ * Handles state management for the rename modal, validation, and tracking rename changes.
+ * Note: This hook does not make API calls. The rename is tracked locally and should be
+ * included when calling sendQuoteTemplateForReview.
+ */
+export declare const useRenameTemplate: (params?: UseRenameTemplateParams) => UseRenameTemplateReturn;
+//# sourceMappingURL=useRenameTemplate.d.ts.map

package/hooks/useUpdateTemplateQuantities.d.ts

@@ -0,0 +1,27 @@
+import { ProductListTableItem } from '../components';
+
+export interface UseUpdateTemplateQuantitiesReturn {
+    quantityChanges: Record<string, number>;
+    handleQuantityChange: (item: ProductListTableItem, newQuantity: number) => void;
+    handleUpdate: (e: SubmitEvent) => void;
+    handleConfirmUpdate: () => Promise<void>;
+    handleCancelUpdate: () => void;
+    handleDismissBanner: () => void;
+    isUpdateModalOpen: boolean;
+    isUpdating: boolean;
+    updateNotificationState: {
+        type: 'success' | 'error' | null;
+        message: string;
+    };
+}
+export interface UseUpdateTemplateQuantitiesParams {
+    templateId?: string;
+    onUpdateModalStateChange?: (isOpen: boolean) => void;
+    updateSuccessMessage: string;
+    updateErrorMessage: string;
+}
+/**
+ * Custom hook to manage updating quantities of items in a quote template
+ */
+export declare const useUpdateTemplateQuantities: (params: UseUpdateTemplateQuantitiesParams) => UseUpdateTemplateQuantitiesReturn;
+//# sourceMappingURL=useUpdateTemplateQuantities.d.ts.map

package/i18n/en_US.json.d.ts

@@ -82,7 +82,9 @@ declare const _default: {
           "errorHeading": "Error",
           "errorFallback": "Failed to duplicate quote",
           "successHeading": "Success",
-          "successDescription": "Quote has been successfully duplicated. You will be redirected to the new quote shortly."
+          "successDescription": "Quote has been successfully duplicated. You will be redirected to the new quote shortly.",
+          "outOfStockWarningHeading": "Alert",
+          "outOfStockWarningMessage": "Some items were skipped during duplication due to errors."
         },
         "close": {
           "message": "Are you sure you want to close this quote?",
@@ -267,8 +269,31 @@ declare const _default: {
       "createdLabel": "Created:",
       "salesRepLabel": "Sales Rep:",
       "expiresLabel": "Expires:",
+      "templateIdLabel": "Template ID:",
       "referenceDocuments": {
-        "title": "Reference Documents"
+        "title": "Reference Documents",
+        "add": "Add",
+        "edit": "Edit",
+        "remove": "Remove",
+        "noReferenceDocuments": "No reference documents",
+        "form": {
+          "title": "Document Information",
+          "documentNameLabel": "Document name",
+          "documentIdentifierLabel": "Document identifier",
+          "referenceUrlLabel": "Reference URL",
+          "addButton": "Add to Quote Template",
+          "updateButton": "Update Document",
+          "cancelButton": "Cancel",
+          "documentNameRequired": "Document name is required",
+          "documentIdentifierRequired": "Document identifier is required",
+          "referenceUrlRequired": "Reference URL is required",
+          "invalidUrl": "Please enter a valid URL",
+          "errorHeading": "Error",
+          "duplicateUidError": "A document with this identifier already exists in the template. Please use a different identifier."
+        }
+      },
+      "shippingInformation": {
+        "title": "Shipping Information"
       },
       "comments": {
         "title": "Comments"
@@ -288,11 +313,52 @@ declare const _default: {
       "actionsLabel": "Actions",
       "actionButtons": {
         "sendForReview": "Send for review",
+        "delete": "Delete template",
+        "cancel": "Cancel template",
         "accept": "Accept",
         "generateQuote": "Generate quote"
       },
+      "removeItemsModal": {
+        "title": "Change Quote Template Items",
+        "description": "Making changes to any quote template item changes the terms of the template. After you update the template, return it to the seller for review and approval.",
+        "cancelButton": "Cancel",
+        "confirmButton": "Remove",
+        "confirmButtonRemoving": "Removing...",
+        "successHeading": "Success",
+        "successMessage": "Quote template items have been successfully removed.",
+        "errorHeading": "Error",
+        "errorMessage": "Failed to remove quote template items. Please try again."
+      },
+      "updateQuantitiesModal": {
+        "title": "Change Quote Template Items",
+        "description": "Making changes to any quote template item changes the terms of the template. After you update the template, return it to the seller for review and approval.",
+        "cancelButton": "Cancel",
+        "updateButton": "Apply Changes",
+        "successHeading": "Success",
+        "successMessage": "Quote template quantities have been successfully updated.",
+        "errorHeading": "Error",
+        "errorMessage": "Failed to update quote template quantities. Please try again."
+      },
       "confirmationModal": {
         "cancel": "Cancel",
+        "delete": {
+          "title": "Delete Quote Template",
+          "message": "Are you sure you want to delete this quote template?",
+          "confirm": "Delete",
+          "errorHeading": "Error",
+          "errorFallback": "Failed to delete quote template",
+          "successHeading": "Success",
+          "successDescription": "Quote template has been successfully deleted"
+        },
+        "cancelTemplate": {
+          "title": "Cancel Quote Template",
+          "message": "Are you sure you want to cancel this quote template?",
+          "confirm": "Cancel Template",
+          "errorHeading": "Error",
+          "errorFallback": "Failed to cancel quote template",
+          "successHeading": "Success",
+          "successDescription": "Quote template has been successfully cancelled"
+        },
         "accept": {
           "title": "Accept Quote Template",
           "message": "Are you sure you want to accept this quote template?",
@@ -324,7 +390,23 @@ declare const _default: {
       },
       "lineItemNoteModal": {
         "errorHeading": "Error"
-      }
+      },
+      "rename": {
+        "title": "Rename Quote Template",
+        "templateNameLabel": "Template name",
+        "reasonLabel": "Reason for change",
+        "renameButton": "Rename",
+        "cancelButton": "Cancel",
+        "errorHeading": "Error",
+        "templateNameRequired": "Template name is required",
+        "errorDefault": "Failed to rename quote template. Please try again.",
+        "successHeading": "Success",
+        "successMessage": "Quote template renamed successfully!"
+      },
+      "unsavedChangesWarningHeading": "Unsaved Changes",
+      "unsavedChangesWarningMessage": "The quote template must be submitted for review to save the changes.",
+      "shippingAddressWarningHeading": "No Shipping Address",
+      "shippingAddressWarningMessage": "No shipping address has been set for this quote template."
     }
   },
   "historyLog": {

package/package.json

@@ -1 +1 @@
-{"name": "@dropins/storefront-quote-management", "version": "1.0.0-beta1", "@dropins/tools": "1.6.0-beta3", "license": "SEE LICENSE IN LICENSE.md"}
+{"name": "@dropins/storefront-quote-management", "version": "1.0.0-beta3", "@dropins/tools": "1.6.0-beta3", "license": "SEE LICENSE IN LICENSE.md"}