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

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

@@ -16,11 +16,15 @@ export declare const mockStoreConfigGraphQLResponse: {
     shopping_cart_display_full_summary: boolean;
     shopping_cart_display_grand_total: boolean;
     configurable_thumbnail_source: string;
+    quote_minimum_amount: number;
+    quote_minimum_amount_message: string;
 };
 export declare const mockStoreConfigGraphQLResponseWithWrongValues: {
     shopping_cart_display_subtotal: number;
     shopping_cart_display_price: null;
     shopping_cart_display_shipping: number;
+    quote_minimum_amount: null;
+    quote_minimum_amount_message: null;
     cart_summary_display_quantity: number;
     max_items_in_order_summary: number;
     shopping_cart_display_zero_tax: boolean;

package/data/transforms/transform-history.d.ts

@@ -0,0 +1,15 @@
+import { NegotiableQuoteHistoryEntry } from '../models/negotiable-quote-model';
+
+/**
+ * Transforms a history entry from the API format to the model format
+ * @param historyEntry - Raw history entry from API
+ * @returns Transformed history entry
+ */
+export declare function transformHistoryEntry(historyEntry: any): NegotiableQuoteHistoryEntry;
+/**
+ * Transforms an array of history entries from the API format to the model format
+ * @param historyEntries - Array of raw history entries from API
+ * @returns Array of transformed history entries
+ */
+export declare function transformHistory(historyEntries: any[] | null | undefined): NegotiableQuoteHistoryEntry[] | undefined;
+//# sourceMappingURL=transform-history.d.ts.map

package/data/transforms/transform-quote-items.d.ts

@@ -0,0 +1,15 @@
+import { CartItemModel } from '../models/negotiable-quote-model';
+
+/**
+ * Transforms a single quote item from the API format to the model format
+ * @param item - Raw quote item from API
+ * @returns Transformed quote item
+ */
+export declare function transformQuoteItem(item: any): CartItemModel;
+/**
+ * Transforms an array of quote items from the API format to the model format
+ * @param items - Array of raw quote items from API
+ * @returns Array of transformed quote items
+ */
+export declare function transformQuoteItems(items: any[] | null | undefined): CartItemModel[];
+//# sourceMappingURL=transform-quote-items.d.ts.map

package/hooks/useItemsQuotedTemplate.d.ts

@@ -0,0 +1,15 @@
+import { CartItemModel } from '../data/models/negotiable-quote-model';
+
+export interface UseItemsQuotedTemplateReturn {
+    dropdownSelections: Record<string, string | undefined>;
+    handleItemDropdownChange: (item: CartItemModel, action: string) => void;
+    handleDismissRemoveBanner: () => void;
+}
+export interface UseItemsQuotedTemplateParams {
+    handleRemoveItems: (items: CartItemModel[]) => 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 { CartItemModel } from '../data/models/negotiable-quote-model';
+
+export interface UseRemoveTemplateItemsReturn {
+    handleRemoveItems: (items: CartItemModel[]) => void;
+    handleConfirmRemove: () => Promise<void>;
+    handleCancelRemove: () => void;
+    isRemoveModalOpen: boolean;
+    itemsToRemove: CartItemModel[];
+    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 { CartItemModel } from '../data/models/negotiable-quote-model';
+
+export interface UseUpdateTemplateQuantitiesReturn {
+    quantityChanges: Record<string, number>;
+    handleQuantityChange: (item: CartItemModel, 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?",
@@ -110,7 +112,9 @@ declare const _default: {
         "title": "Shipping Information"
       },
       "shippingAddress": {
-        "noAddress": "No shipping address has been set for this quote."
+        "noAddress": "No shipping address has been set for this quote.",
+        "noAddressHeading": "No Shipping Address",
+        "noAddressDescription": "Please select or enter a shipping address."
       },
       "quoteComments": {
         "title": "Quote Comments",
@@ -137,8 +141,11 @@ declare const _default: {
         "notes": {
           "header": "NOTES",
           "leftANote": "left a note:",
-          "buyer": "Buyer"
-        }
+          "buyer": "Buyer",
+          "seller": "Seller"
+        },
+        "outOfStock": "Out of Stock",
+        "outOfStockMessage": "This item is currently out of stock."
       },
       "rename": {
         "title": "Rename Quote",
@@ -267,8 +274,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 +318,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 +395,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/lib/itemFormatters.d.ts

@@ -1,6 +1,6 @@
 import { ImageProps } from '@dropins/tools/types/elsie/src/components';
 import { SlotProps } from '@dropins/tools/types/elsie/src/lib';
-import { NegotiableQuoteCartItem as NegotiableQuoteItemModel, StoreConfigModel } from '../data/models';
+import { CartItemModel as NegotiableQuoteItemModel, StoreConfigModel } from '../data/models';
 import { SwitchableAttributes } from '../containers/QuoteSummaryList/QuoteSummaryList';
 
 export interface ItemFormatterOptions {

package/lib/priceCalculators.d.ts

@@ -1,5 +1,5 @@
 import { PriceProps } from '@dropins/tools/types/elsie/src/components';
-import { NegotiableQuoteCartItem as NegotiableQuoteItemModel, StoreConfigModel } from '../data/models';
+import { CartItemModel as NegotiableQuoteItemModel, StoreConfigModel } from '../data/models';
 
 export interface PriceCalculatorOptions {
     dictionary: Record<string, string>;

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-beta10", "@dropins/tools": "1.6.0-beta3", "license": "SEE LICENSE IN LICENSE.md"}