The complete open source platform to run your entire marketplace. Storefront, vendor panel, admin console, and integrations in one enterprise-grade platform you own.
TypeScript b2b-marketplacecomposable-commerceecommerceenterpriseheadless-commercemarketplacemedusamedusajsmulti-vendortypescript
import { ClientError, InferClientInput, InferClientOutput } from "@mercurjs/client";
import {
HttpTypes,
ProductAttributeBatchInput,
ProductChangeDTO,
} from "@mercurjs/types";
import {
QueryKey,
useMutation,
UseMutationOptions,
useQuery,
UseQueryOptions,
} from "@tanstack/react-query";
import { sdk } from "../../lib/client";
import { queryClient } from "../../lib/query-client";
import { queryKeysFactory } from "../../lib/query-key-factory";
import { inventoryItemsQueryKeys } from "./inventory.tsx";
const PRODUCTS_QUERY_KEY = "products" as const;
export const productsQueryKeys = queryKeysFactory(PRODUCTS_QUERY_KEY);
const VARIANTS_QUERY_KEY = "product_variants" as const;
export const variantsQueryKeys = queryKeysFactory(VARIANTS_QUERY_KEY);
const PRODUCT_CHANGE_QUERY_KEY = "product_change" as const;
export const productChangeQueryKeys = queryKeysFactory(
PRODUCT_CHANGE_QUERY_KEY,
);
type ProductChangeResponse = { product_change: ProductChangeDTO };
// --- Product queries ---
export const useProduct = (
id: string,
query?: Record<string, any>,
options?: Omit<
UseQueryOptions<
HttpTypes.AdminProductResponse,
ClientError,
HttpTypes.AdminProductResponse,
QueryKey
>,
"queryFn" | "queryKey"
>,
) => {
const { data, ...rest } = useQuery({
queryFn: () => sdk.admin.products.$id.query({ $id: id, ...query }),
queryKey: productsQueryKeys.detail(id, query),
...options,
});
return { ...data, ...rest };
};
export const useProducts = (
query?: Record<string, any>,
options?: Omit<
UseQueryOptions<
HttpTypes.AdminProductListResponse,
ClientError,
HttpTypes.AdminProductListResponse,
QueryKey
>,
"queryFn" | "queryKey"
>,
) => {
const { data, ...rest } = useQuery({
queryFn: () => sdk.admin.products.query({ ...query }),
queryKey: productsQueryKeys.list(query),
...options,
});
return { ...data, ...rest };
};
// --- Product mutations ---
export const useCreateProduct = (
options?: UseMutationOptions<
HttpTypes.AdminProductResponse,
ClientError,
Record<string, any>
>,
) => {
return useMutation({
mutationFn: (payload) => sdk.admin.products.mutate(payload as any),
onSuccess: (data, variables, context) => {
queryClient.invalidateQueries({ queryKey: productsQueryKeys.lists() });
queryClient.invalidateQueries({
queryKey: inventoryItemsQueryKeys.lists(),
});
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useUpdateProduct = (
id: string,
options?: UseMutationOptions<
HttpTypes.AdminProductResponse,
ClientError,
Record<string, any>
>,
) => {
return useMutation({
mutationFn: (payload) =>
sdk.admin.products.$id.mutate({ $id: id, ...payload }),
onSuccess: async (data, variables, context) => {
await queryClient.invalidateQueries({
queryKey: productsQueryKeys.lists(),
});
await queryClient.invalidateQueries({
queryKey: productsQueryKeys.detail(id),
});
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useLinkProductSellers = (
id: string,
options?: UseMutationOptions<
InferClientOutput<typeof sdk.admin.products.$id.sellers.mutate>,
ClientError,
{ add?: string[]; remove?: string[] }
>,
) => {
return useMutation({
mutationFn: (payload) =>
sdk.admin.products.$id.sellers.mutate({ $id: id, ...payload }),
onSuccess: async (data, variables, context) => {
await queryClient.invalidateQueries({
queryKey: productsQueryKeys.lists(),
});
await queryClient.invalidateQueries({
queryKey: productsQueryKeys.detail(id),
});
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useDeleteProduct = (
id: string,
options?: UseMutationOptions<
HttpTypes.AdminProductDeleteResponse,
ClientError,
void
>,
) => {
return useMutation({
mutationFn: () => sdk.admin.products.$id.delete({ $id: id }),
onSuccess: (data: any, variables: any, context: any) => {
queryClient.invalidateQueries({ queryKey: productsQueryKeys.lists() });
queryClient.invalidateQueries({ queryKey: productsQueryKeys.detail(id) });
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useBatchProducts = (
options?: UseMutationOptions<
InferClientOutput<typeof sdk.admin.products.batch.mutate>,
ClientError,
InferClientInput<typeof sdk.admin.products.batch.mutate>
>,
) => {
return useMutation({
mutationFn: (payload) => sdk.admin.products.batch.mutate(payload),
onSuccess: (data, variables, context) => {
queryClient.invalidateQueries({ queryKey: productsQueryKeys.all });
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
// --- Product action mutations ---
export const useConfirmProduct = (
id: string,
options?: UseMutationOptions<
HttpTypes.AdminProductResponse,
ClientError,
{ internal_note?: string } | void
>,
) => {
return useMutation({
mutationFn: (payload) =>
sdk.admin.products.$id.confirm.mutate({
$id: id,
...(payload ?? {}),
}),
onSuccess: (data: any, variables: any, context: any) => {
queryClient.invalidateQueries({ queryKey: productsQueryKeys.lists() });
queryClient.invalidateQueries({ queryKey: productsQueryKeys.detail(id) });
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useRejectProduct = (
id: string,
options?: UseMutationOptions<
HttpTypes.AdminProductResponse,
ClientError,
{ message?: string }
>,
) => {
return useMutation({
mutationFn: (payload) =>
sdk.admin.products.$id.reject.mutate({ $id: id, ...payload }),
onSuccess: (data: any, variables: any, context: any) => {
queryClient.invalidateQueries({ queryKey: productsQueryKeys.lists() });
queryClient.invalidateQueries({ queryKey: productsQueryKeys.detail(id) });
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useRequestProductChanges = (
id: string,
options?: UseMutationOptions<
HttpTypes.AdminProductResponse,
ClientError,
{ message?: string }
>,
) => {
return useMutation({
mutationFn: (payload) =>
sdk.admin.products.$id.requestChanges.mutate({ $id: id, ...payload }),
onSuccess: (data: any, variables: any, context: any) => {
queryClient.invalidateQueries({ queryKey: productsQueryKeys.lists() });
queryClient.invalidateQueries({ queryKey: productsQueryKeys.detail(id) });
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useProductChange = (
productId: string,
options?: Omit<
UseQueryOptions<ProductChangeResponse, ClientError, ProductChangeResponse>,
"queryFn" | "queryKey"
>,
) => {
const { data, ...rest } = useQuery({
queryFn: () =>
sdk.admin.products.$id.preview.query({ $id: productId }) as Promise<
ProductChangeResponse
>,
queryKey: productChangeQueryKeys.detail(productId),
...options,
});
return { ...data, ...rest };
};
export const useConfirmProductChange = (
productChangeId: string,
productId: string,
options?: UseMutationOptions<
unknown,
ClientError,
{ internal_note?: string } | void
>,
) => {
return useMutation({
mutationFn: (payload) =>
sdk.admin.productChanges.$id.confirm.mutate({
$id: productChangeId,
...(payload ?? {}),
}),
onSuccess: (data, variables, context) => {
queryClient.invalidateQueries({
queryKey: productChangeQueryKeys.detail(productId),
});
queryClient.invalidateQueries({
queryKey: productsQueryKeys.detail(productId),
});
queryClient.invalidateQueries({ queryKey: productsQueryKeys.lists() });
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useCancelProductChange = (
productChangeId: string,
productId: string,
options?: UseMutationOptions<
ProductChangeResponse,
ClientError,
{ internal_note?: string } | void
>,
) => {
return useMutation({
mutationFn: (payload) =>
sdk.admin.productChanges.$id.cancel.mutate({
$id: productChangeId,
...(payload ?? {}),
}) as Promise<ProductChangeResponse>,
onSuccess: (data, variables, context) => {
queryClient.invalidateQueries({
queryKey: productChangeQueryKeys.detail(productId),
});
queryClient.invalidateQueries({
queryKey: productsQueryKeys.detail(productId),
});
queryClient.invalidateQueries({ queryKey: productsQueryKeys.lists() });
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useProductVariant = (
productId: string,
variantId: string,
query?: Record<string, any>,
options?: Omit<
UseQueryOptions<
HttpTypes.AdminProductVariantResponse,
ClientError,
HttpTypes.AdminProductVariantResponse,
QueryKey
>,
"queryFn" | "queryKey"
>,
) => {
const { data, ...rest } = useQuery({
queryFn: () =>
sdk.admin.products.$id.variants.$variantId.query({
$id: productId,
$variantId: variantId,
...query,
}),
queryKey: variantsQueryKeys.detail(variantId, query),
...options,
});
return { ...data, ...rest };
};
export const useProductVariants = (
productId: string,
query?: Record<string, any>,
options?: Omit<
UseQueryOptions<
HttpTypes.AdminProductVariantListResponse,
ClientError,
HttpTypes.AdminProductVariantListResponse,
QueryKey
>,
"queryFn" | "queryKey"
>,
) => {
const { data, ...rest } = useQuery({
queryFn: () =>
sdk.admin.products.$id.variants.query({ $id: productId, ...query }),
queryKey: variantsQueryKeys.list({ productId, ...query }),
...options,
});
return { ...data, ...rest };
};
export const useCreateProductVariant = (
productId: string,
options?: UseMutationOptions<any, ClientError, any>,
) => {
return useMutation({
mutationFn: (payload) =>
sdk.admin.products.$id.variants.mutate({ $id: productId, ...payload }),
onSuccess: (data: any, variables: any, context: any) => {
queryClient.invalidateQueries({ queryKey: variantsQueryKeys.lists() });
queryClient.invalidateQueries({
queryKey: productsQueryKeys.detail(productId),
});
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useUpdateProductVariant = (
productId: string,
variantId: string,
options?: UseMutationOptions<any, ClientError, any>,
) => {
return useMutation({
mutationFn: (payload: any) =>
sdk.admin.products.$id.variants.$variantId.mutate({
$id: productId,
$variantId: variantId,
...payload,
}),
onSuccess: (data: any, variables: any, context: any) => {
queryClient.invalidateQueries({ queryKey: variantsQueryKeys.lists() });
queryClient.invalidateQueries({
queryKey: variantsQueryKeys.detail(variantId),
});
queryClient.invalidateQueries({
queryKey: productsQueryKeys.detail(productId),
});
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useDeleteVariant = (
productId: string,
variantId: string,
options?: UseMutationOptions<any, ClientError, void>,
) => {
return useMutation({
mutationFn: () =>
sdk.admin.products.$id.variants.$variantId.delete({
$id: productId,
$variantId: variantId,
}),
onSuccess: (data: any, variables: any, context: any) => {
queryClient.invalidateQueries({ queryKey: variantsQueryKeys.lists() });
queryClient.invalidateQueries({
queryKey: variantsQueryKeys.detail(variantId),
});
queryClient.invalidateQueries({
queryKey: productsQueryKeys.detail(productId),
});
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useDeleteVariantLazy = (
productId: string,
options?: UseMutationOptions<any, ClientError, { variantId: string }>,
) => {
return useMutation({
mutationFn: ({ variantId }) =>
sdk.admin.products.$id.variants.$variantId.delete({
$id: productId,
$variantId: variantId,
}),
onSuccess: (data, variables, context) => {
queryClient.invalidateQueries({ queryKey: variantsQueryKeys.lists() });
queryClient.invalidateQueries({
queryKey: variantsQueryKeys.detail(variables.variantId),
});
queryClient.invalidateQueries({
queryKey: productsQueryKeys.detail(productId),
});
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
// --- Product attribute sub-resource (SPEC-014: the batch endpoint is the
// single attribute-mutation surface; add/edit/delete all go through it) ---
const PRODUCT_ATTRIBUTES_QUERY_KEY = "product_product_attributes" as const;
export const scopedProductAttributesQueryKeys = queryKeysFactory(
PRODUCT_ATTRIBUTES_QUERY_KEY,
);
/** The batch body minus `product_id` (sourced from the path). */
export type ProductAttributeBatchPayload = Omit<
ProductAttributeBatchInput,
"product_id"
>;
/**
* SPEC-014 §G: applies `add` / `remove` / `update` against
* `POST /admin/products/:id/attributes/batch` (order remove → add → update on
* the server). Returns the refreshed `{ product }`.
*/
export const useBatchProductAttributes = (
productId: string,
options?: UseMutationOptions<
HttpTypes.AdminProductResponse,
ClientError,
ProductAttributeBatchPayload
>,
) => {
return useMutation({
mutationFn: (payload) =>
sdk.admin.products.$id.attributes.batch.mutate({
$id: productId,
...payload,
}) as Promise<HttpTypes.AdminProductResponse>,
onSuccess: (data, variables, context) => {
queryClient.invalidateQueries({
queryKey: scopedProductAttributesQueryKeys.lists(),
});
queryClient.invalidateQueries({
queryKey: productsQueryKeys.detail(productId),
});
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
/**
* Convenience wrapper to detach a single attribute (batch `remove`).
*/
export const useRemoveAttributeFromProduct = (
productId: string,
attributeId: string,
options?: UseMutationOptions<HttpTypes.AdminProductResponse, ClientError, void>,
) => {
return useMutation({
mutationFn: () =>
sdk.admin.products.$id.attributes.batch.mutate({
$id: productId,
remove: [attributeId],
}) as Promise<HttpTypes.AdminProductResponse>,
onSuccess: (data, variables, context) => {
queryClient.invalidateQueries({
queryKey: scopedProductAttributesQueryKeys.lists(),
});
queryClient.invalidateQueries({
queryKey: productsQueryKeys.detail(productId),
});
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
// --- Variant batch mutations ---
export const useUpdateProductVariantsBatch = (
productId: string,
options?: UseMutationOptions<any, ClientError, any>,
) => {
return useMutation({
mutationFn: (payload: any) =>
sdk.admin.products.$id.variants.batch.mutate({
$id: productId,
update: payload,
}),
onSuccess: (data: any, variables: any, context: any) => {
queryClient.invalidateQueries({ queryKey: variantsQueryKeys.lists() });
queryClient.invalidateQueries({ queryKey: variantsQueryKeys.details() });
queryClient.invalidateQueries({
queryKey: productsQueryKeys.detail(productId),
});
options?.onSuccess?.(data, variables, context);
},
...options,
});
};
export const useProductVariantsInventoryItemsBatch = (
productId: string,
options?: UseMutationOptions<any, ClientError, any>,
) => {
return useMutation({
mutationFn: (payload: any) =>
sdk.admin.products.$id.variants.inventoryItems.batch.mutate({
$id: productId,
...payload,
}),
onSuccess: (data: any, variables: any, context: any) => {
queryClient.invalidateQueries({ queryKey: variantsQueryKeys.lists() });
queryClient.invalidateQueries({ queryKey: variantsQueryKeys.details() });
queryClient.invalidateQueries({
queryKey: productsQueryKeys.detail(productId),
});
options?.onSuccess?.(data, variables, context);
},
...options,
});
};