Skip to content

feature-return advanced

Everything else the package exports, for when you go beyond its components and hooks, such as your own queries or cache updates. Most projects never need these.

Contexts8
ReturnContextThe context ReturnProvider fills.
@evolve-storefront/feature-return/context
useCanCreateReturnWhether the shopper may create a return.
@evolve-storefront/feature-return/context
useReturnContextRead the injected auth/session/mode context.
@evolve-storefront/feature-return/context
useReturnScopeDerive the read scope from the injected mode.
@evolve-storefront/feature-return/context
returnDefaultsWhat the context holds without a ReturnProvider: a signed-out consumer, online returns.
@evolve-storefront/feature-return/context
ReturnContextValueInjected auth/session/mode seam for the return feature, supplied by ReturnProvider so the feature stays decoupled from any specific auth package.
@evolve-storefront/feature-return/context
ReturnHandlingHow returns are handled for this store.
@evolve-storefront/feature-return/context
ReturnModeConsumer (own returns) vs business (company-scoped) — config, not a fork.
@evolve-storefront/feature-return/context
GraphQL documents13
GetBusinessReturnOne of a business unit's returns, by id.
@evolve-storefront/feature-return/queries
GetBusinessReturnableLinesThe lines of one of a business unit's orders that can still be returned.
@evolve-storefront/feature-return/queries
GetBusinessReturnsA business unit's returns, paged.
@evolve-storefront/feature-return/queries
GetCustomerReturnOne of the signed-in customer's returns, by id.
@evolve-storefront/feature-return/queries
GetCustomerReturnableLinesThe lines of one of the customer's orders that can still be returned.
@evolve-storefront/feature-return/queries
GetCustomerReturnsThe signed-in customer's returns, paged.
@evolve-storefront/feature-return/queries
GetReturnEstimateWhat a return of these lines would withhold, such as a restocking fee.
@evolve-storefront/feature-return/queries
GetReturnExchangeOptionsWhat a line of one of the customer's own orders can be exchanged for: other variants in stock, costing no more.
@evolve-storefront/feature-return/queries
GetReturnReasonsThe reasons a buyer may give, with what each requires.
@evolve-storefront/feature-return/queries
GetReturnRefundMethodsHow a consumer's return of one of their orders may be paid back.
@evolve-storefront/feature-return/queries
ReturnAttachmentUploadIssues a signed URL to upload one attachment to.
@evolve-storefront/feature-return/queries
ReturnCancelWithdraws a return that is still cancellable.
@evolve-storefront/feature-return/queries
ReturnCreateRequests a return for delivered lines.
@evolve-storefront/feature-return/queries
Data and cache helpers2
invalidateReturnsInvalidate every list cache for a scope (all pages).
@evolve-storefront/feature-return
returnKeysreact-query key factory for the return caches.
@evolve-storefront/feature-return
Schemas1
ReturnRequestFormSchemaReturn request form schema: the scalar fields.
@evolve-storefront/feature-return/schemas
Other functions and constants2
lineFieldNamesThe form field names of a line's controls, which its validation errors are keyed by.
@evolve-storefront/feature-return/return-items-picker
emptyLineDraftA line nothing has been chosen for yet.
@evolve-storefront/feature-return/return-items-picker
Types36
CreateReturnInputInput for requesting a return (Mutation.returnCreate).
@evolve-storefront/feature-return
MoneyAn amount in minor units (schema Money).
@evolve-storefront/feature-return
PaginationWhere a page sits in the full list (schema Pagination).
@evolve-storefront/feature-return
ProductImageMinimal product image.
@evolve-storefront/feature-return
ReturnA return request, as the detail view shows it.
@evolve-storefront/feature-return
ReturnableLineAn order line that can still be returned (Order.returnableLines).
@evolve-storefront/feature-return
ReturnableOrderA delivered order that still has lines to return.
@evolve-storefront/feature-return
ReturnableOrderResultA page of returnable orders, filtered from a page of delivered orders.
@evolve-storefront/feature-return
ReturnAddressA postal address, as a pickup or return destination (schema Address).
@evolve-storefront/feature-return
ReturnAttachmentA photo or document attached to a returned line.
@evolve-storefront/feature-return
ReturnCreditNoteThe credit note that settles a credited return against its invoice.
@evolve-storefront/feature-return
ReturnEstimateWhat a return of the chosen lines would withhold and pay back (Query.returnEstimate).
@evolve-storefront/feature-return
ReturnExchangeWhat a returned line is exchanged for, in the same quantity (ReturnExchange).
@evolve-storefront/feature-return
ReturnExchangeOptionA variant a line can be exchanged for (Query.returnExchangeOptions).
@evolve-storefront/feature-return
ReturnItemA line on a requested return.
@evolve-storefront/feature-return
ReturnItemInputOne line to return (ReturnItemInput).
@evolve-storefront/feature-return
ReturnLineItemThe order line a returned or returnable line refers to.
@evolve-storefront/feature-return
ReturnOrderAn order a return covers.
@evolve-storefront/feature-return
ReturnReasonWhy a line was returned: a code from the reason list, its label, and free text.
@evolve-storefront/feature-return
ReturnReasonInputA reason as the request names it (ReturnReasonInput).
@evolve-storefront/feature-return
ReturnReasonOptionA reason a buyer may give, with what it requires (Query.returnReasons).
@evolve-storefront/feature-return
ReturnRefundMethodHow a consumer's return is paid back (ReturnRefundMethodType).
@evolve-storefront/feature-return
ReturnRequesterThe associate who requested a return.
@evolve-storefront/feature-return
ReturnResolutionHow a completed return was settled (ReturnResolutionType).
@evolve-storefront/feature-return
ReturnResultA page of returns (ReturnResult).
@evolve-storefront/feature-return
ReturnScopeRead scope: the customer's own returns, or a business unit's.
@evolve-storefront/feature-return
ReturnShipping
@evolve-storefront/feature-return
ReturnShippingInput
@evolve-storefront/feature-return
ReturnShippingMethodHow the goods go back: collected by a carrier, or sent by the buyer.
@evolve-storefront/feature-return
ReturnStatusWhere a return is in the process (ReturnStatusType): REQUESTED → APPROVED → IN_TRANSIT → RECEIVED → COMPLETED, where a consumer's return skips APPROVED and an engine that cannot see IN_TRANSIT skips it.
@evolve-storefront/feature-return
ReturnSummaryA return as the list shows it.
@evolve-storefront/feature-return
ReturnRequestFormInput
@evolve-storefront/feature-return/schemas
CreateReturnLineA line to return, with the photos still to upload for it.
@evolve-storefront/feature-return/hooks
CreateReturnVariables
@evolve-storefront/feature-return/hooks
ReturnableOrderRendererRenders one returnable order, usually a ReturnableOrderCard with a start-return action.
@evolve-storefront/feature-return/returnable-orders
ReturnLineDraftWhat the buyer has filled in for one line.
@evolve-storefront/feature-return/return-items-picker

Not listed: 13 props and options types. They appear as the tables on the pages of what they type.