You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 

660 lines
16 KiB

import { shopRequest } from './http';
export interface ApiBanner {
id: number;
slug: string;
title: string;
title_i18n?: Record<string, string>;
subtitle: string;
cta_label: string;
image_url: string;
target_route: string;
display_order: number;
}
export interface ApiCategory {
id: number;
parent: number | null;
slug: string;
title: string;
localized_title: string;
title_i18n?: Record<string, string>;
icon_url: string;
small_icon_url: string;
accent_color: string;
display_order: number;
is_quick: boolean;
products_count: number;
}
export interface ApiStoreSummary {
id: number;
slug: string;
name: string;
tagline: string;
country: string;
city: string;
origin_label: string;
logo_url: string;
banner_url: string;
badge: string;
membership_label: string;
sales_label: string;
since_label: string;
avg_response_time: string;
on_time_delivery_rate: number;
satisfaction_rate: number;
rating_avg: string | number;
reviews_count: number;
products_count: number;
is_verified: boolean;
}
export interface ApiProductCard {
id: number;
slug: string;
sku: string;
title: string;
primary_image_url: string;
hero_image_url: string;
price: string;
formatted_price: string;
compare_at_price: string | null;
formatted_old_price: string | null;
discount_badge: string;
coin_price: number;
currency: string;
stock_qty: number;
origin_label: string;
rating_avg: string | number;
reviews_count: number;
store: number;
store_slug: string;
store_name: string;
category: number;
category_slug: string;
category_title: string;
is_popular: boolean;
is_new_store_pick: boolean;
is_bookmarked: boolean;
}
export interface ApiProductMedia {
id: number;
image_url: string;
alt_text: string;
sort_order: number;
}
export interface ApiProductVariant {
id: number;
sku: string;
title: string;
attributes_json: Record<string, string>;
price_override: string | null;
coin_price_override: number | null;
stock_qty: number;
is_active: boolean;
}
export interface ApiReview {
id: number;
product: number;
author_name: string;
rating: number;
comment: string;
image_url: string;
formatted_date: string;
created_at: string;
}
export interface ApiProductDetail extends ApiProductCard {
breadcrumb: string;
description: string;
condition_label: string;
processing_time_label: string;
product_type_label: string;
specs_json: Record<string, string>;
shipping_info_json: Record<string, string>;
store_detail: ApiStoreSummary;
media: ApiProductMedia[];
variants: ApiProductVariant[];
reviews: ApiReview[];
related_products: ApiProductCard[];
}
export interface ApiStoreDetail extends ApiStoreSummary {
description: string;
created_at: string;
products: ApiProductCard[];
}
export interface ApiCartItem {
id: number;
product_id: number;
product_slug: string;
title: string;
image_url: string;
origin_label: string;
store_id: number;
store_slug: string;
store_name: string;
variant: number | null;
variant_title: string;
quantity: number;
unit_price: string;
formatted_unit_price: string;
line_total: string;
formatted_line_total: string;
coin_unit_price: number;
}
export interface ApiCartPricing {
items_count: number;
total_quantity: number;
total_units?: number;
shops_count: number;
subtotal: string;
formatted_subtotal: string;
shipping_fee: string;
formatted_shipping_fee: string;
discount_amount: string;
formatted_discount: string;
formatted_discount_amount?: string;
promo_code: string;
total: string;
total_amount?: string;
formatted_total: string;
coin_total: number;
coins_total?: number;
}
export interface ApiCart {
id: number;
currency: string;
promo_code: string;
items: ApiCartItem[];
pricing: ApiCartPricing;
updated_at: string;
}
export interface ApiAddress {
id: number;
label: string;
recipient_name: string;
phone: string;
country: string;
city: string;
street_line: string;
postal_code: string;
lat: string | number | null;
lon: string | number | null;
is_default: boolean;
full_address: string;
created_at: string;
}
export interface ApiShippingMethod {
id: number;
code: string;
title: string;
title_i18n?: Record<string, string>;
subtitle: string;
price: string;
formatted_price: string;
coin_price: number;
estimated_days_min: number;
estimated_days_max: number;
is_default: boolean;
}
export interface ApiPaymentMethod {
id: string;
code: string;
label: string;
icon_url: string;
is_default: boolean;
balance?: number;
}
export interface ApiShipmentEvent {
id: number;
status: string;
title: string;
location: string;
formatted_time: string;
occurred_at: string;
}
export interface ApiShipment {
id: number;
store: number;
booth_name: string;
booth_slug: string;
booth_avatar: string;
status: 'ordered' | 'packed' | 'shipping' | 'delivered' | 'canceled';
carrier_name: string;
tracking_code: string;
estimated_delivery_label: string;
completed_steps: number;
thumbnails: string[];
events: ApiShipmentEvent[];
}
export interface ApiOrderItem {
id: number;
product: number | null;
product_slug: string;
store: number;
store_name: string;
store_slug: string;
title_snapshot: string;
image_snapshot: string;
origin_snapshot: string;
unit_price: string;
formatted_unit_price: string;
coin_unit_price: number;
quantity: number;
line_total: string;
formatted_line_total: string;
}
export interface ApiOrderSummary {
id: number;
order_number: string;
status: string;
payment_method: string;
payment_method_label: string;
payment_status: string;
currency: string;
total_amount: string;
formatted_total: string;
coins_charged: number;
formatted_date: string;
formatted_datetime: string;
thumbnails: string[];
items_count: number;
shops_count: number;
delivered_shipments_count: number;
total_shipments_count: number;
placed_at: string;
}
export interface ApiOrderDetail extends ApiOrderSummary {
subtotal: string;
formatted_subtotal: string;
shipping_fee: string;
formatted_shipping_fee: string;
discount_amount: string;
formatted_discount: string;
promo_code: string;
shipping_method_title: string;
shipping_address_snapshot: {
recipient_name?: string;
phone?: string;
full_address?: string;
city?: string;
country?: string;
street_line?: string;
};
notes: string;
items: ApiOrderItem[];
shipments: ApiShipment[];
}
export interface ApiOrderCounters {
current: number;
in_progress: number;
delivered: number;
canceled: number;
returned: number;
}
export interface ApiUserProfile {
is_authenticated: boolean;
id?: number;
guest_token?: string;
full_name: string;
email: string;
phone_number: string;
avatar_url: string;
habib_coins_balance: number;
shop_provider: Record<string, unknown> | null;
provider_requests: {
id: number;
service: string;
status: string;
public_name: string;
created_at: string;
}[];
}
export interface ApiSupportSubject {
id: number;
slug: string;
label: string;
title_i18n?: Record<string, string>;
icon_url: string;
display_order: number;
}
export interface ApiSupportTicket {
id: number;
ticket_number: string;
order: number | null;
order_number: string;
subject: number | null;
subject_label: string;
description: string;
attachment_url: string;
status: string;
admin_reply: string;
formatted_date: string;
created_at: string;
}
export interface ApiConversation {
id: number;
store: number;
store_detail: ApiStoreSummary;
last_message_preview: string;
last_message_at: string | null;
formatted_last_time: string;
unread_user_count: number;
created_at: string;
}
export interface ApiChatMessage {
id: number;
conversation: number;
sender_type: 'customer' | 'store' | 'system';
text: string;
attachment_url: string;
product_ref: number | null;
order_ref: number | null;
is_read: boolean;
formatted_time: string;
date_group: string;
created_at: string;
}
export interface HomeFeedResponse {
banners: ApiBanner[];
quick_categories: ApiCategory[];
categories: ApiCategory[];
popular_products: ApiProductCard[];
new_store_products: ApiProductCard[];
featured_stores: ApiStoreSummary[];
cart_items_count: number;
habib_coins_balance: number;
}
export const shopApi = {
// Home & Catalog
fetchHomeFeed: () => shopRequest<HomeFeedResponse>('/home/'),
fetchCategories: (q?: string) =>
shopRequest<{ results: ApiCategory[] }>('/categories/', { query: { q } }),
fetchCategoryDetail: (slug: string, q?: string) =>
shopRequest<{ category: ApiCategory; products: ApiProductCard[] }>(
`/categories/${encodeURIComponent(slug)}/`,
{ query: { q } }
),
fetchProducts: (params?: {
q?: string;
category?: string;
store?: string;
popular?: boolean;
new_store?: boolean;
sort?: 'price_asc' | 'price_desc' | 'rating' | 'newest';
}) =>
shopRequest<{ count: number; results: ApiProductCard[] }>('/products/', {
query: params,
}),
fetchProductDetail: (idOrSlug: string | number) =>
shopRequest<ApiProductDetail>(`/products/${encodeURIComponent(String(idOrSlug))}/`),
fetchProductReviews: (idOrSlug: string | number) =>
shopRequest<{ count: number; results: ApiReview[] }>(
`/products/${encodeURIComponent(String(idOrSlug))}/reviews/`
),
createProductReview: (
idOrSlug: string | number,
payload: { rating: number; comment: string; author_name?: string; image_url?: string }
) =>
shopRequest<ApiReview>(
`/products/${encodeURIComponent(String(idOrSlug))}/reviews/`,
{ method: 'POST', body: payload }
),
fetchStores: (q?: string) =>
shopRequest<{ count: number; results: ApiStoreSummary[] }>('/stores/', {
query: { q },
}),
fetchStoreDetail: (idOrSlug: string | number) =>
shopRequest<ApiStoreDetail>(`/stores/${encodeURIComponent(String(idOrSlug))}/`),
// Cart & Checkout
fetchCart: (includeShipping = false) =>
shopRequest<ApiCart>('/cart/', {
query: { include_shipping: includeShipping ? '1' : undefined },
}),
clearCart: () => shopRequest<ApiCart>('/cart/', { method: 'DELETE' }),
addCartItem: (payload: {
product_id: string | number;
variant_id?: number | null;
quantity?: number;
}) => shopRequest<ApiCart>('/cart/items/', { method: 'POST', body: payload }),
updateCartItem: (itemId: number, quantity: number) =>
shopRequest<ApiCart>(`/cart/items/${itemId}/`, {
method: 'PATCH',
body: { quantity },
}),
removeCartItem: (itemId: number) =>
shopRequest<ApiCart>(`/cart/items/${itemId}/`, { method: 'DELETE' }),
mergeGuestCart: (guestToken?: string) =>
shopRequest<ApiCart>('/cart/merge/', {
method: 'POST',
body: guestToken ? { guest_token: guestToken } : {},
}),
applyPromoCode: (promoCode: string) =>
shopRequest<ApiCart>('/cart/promo/', {
method: 'POST',
body: { promo_code: promoCode },
}),
fetchShippingMethods: () =>
shopRequest<{ results: ApiShippingMethod[] }>('/checkout/shipping-methods/'),
fetchCheckoutSummary: (shippingMethodCodeOrId?: string | number) =>
shopRequest<{
cart: ApiCart;
shipping_method: ApiShippingMethod;
pricing: ApiCartPricing;
habib_coins_balance: number;
}>('/checkout/summary/', {
query: { shipping_method: shippingMethodCodeOrId },
}),
fetchPaymentMethods: () =>
shopRequest<{ habib_coins_balance: number; results: ApiPaymentMethod[] }>(
'/payment/methods/'
),
// Orders & Shipments
fetchOrders: (status?: 'current' | 'delivered' | 'canceled') =>
shopRequest<{ count: number; results: ApiOrderSummary[] }>('/orders/', {
query: { status },
}),
fetchOrderCounters: () => shopRequest<ApiOrderCounters>('/orders/counters/'),
placeOrder: (payload: {
address_id?: number | null;
shipping_address?: Record<string, unknown>;
shipping_method?: string | number;
payment_method: string;
promo_code?: string;
notes?: string;
}) => shopRequest<ApiOrderDetail>('/orders/', { method: 'POST', body: payload }),
fetchOrderDetail: (orderNumber: string) =>
shopRequest<ApiOrderDetail>(`/orders/${encodeURIComponent(orderNumber)}/`),
fetchOrderReceipt: (orderNumber: string) =>
shopRequest<{
order_number: string;
status: string;
payment_status: string;
payment_method: string;
payment_method_label: string;
total_paid: string;
coins_charged: number;
order_date: string;
shipping_address: Record<string, unknown>;
}>(`/orders/${encodeURIComponent(orderNumber)}/receipt/`),
cancelOrder: (orderNumber: string) =>
shopRequest<ApiOrderDetail>(`/orders/${encodeURIComponent(orderNumber)}/cancel/`, {
method: 'POST',
}),
fetchShipmentTracking: (orderNumber: string, shipmentId: number) =>
shopRequest<ApiShipment>(
`/orders/${encodeURIComponent(orderNumber)}/shipments/${shipmentId}/`
),
// Profile, Addresses, Bookmarks & Provider
fetchProfile: () => shopRequest<ApiUserProfile>('/me/profile/'),
updateProfile: (payload: {
full_name?: string;
email?: string;
phone_number?: string;
}) => shopRequest<ApiUserProfile>('/me/profile/', { method: 'PUT', body: payload }),
fetchAddresses: () => shopRequest<{ results: ApiAddress[] }>('/me/addresses/'),
createAddress: (payload: {
label?: string;
recipient_name: string;
phone?: string;
country?: string;
city?: string;
street_line: string;
postal_code?: string;
lat?: number | null;
lon?: number | null;
is_default?: boolean;
}) => shopRequest<ApiAddress>('/me/addresses/', { method: 'POST', body: payload }),
updateAddress: (
id: number,
payload: Partial<{
label: string;
recipient_name: string;
phone: string;
country: string;
city: string;
street_line: string;
postal_code: string;
lat: number | null;
lon: number | null;
is_default: boolean;
}>
) =>
shopRequest<ApiAddress>(`/me/addresses/${id}/`, {
method: 'PATCH',
body: payload,
}),
deleteAddress: (id: number) =>
shopRequest<void>(`/me/addresses/${id}/`, { method: 'DELETE' }),
fetchBookmarks: () =>
shopRequest<{
count: number;
results: { id: number; product: number; product_detail: ApiProductCard }[];
}>('/me/bookmarks/'),
addBookmark: (productIdOrSlug: string | number) =>
shopRequest<{ id: number; product: number; product_detail: ApiProductCard }>(
'/me/bookmarks/',
{ method: 'POST', body: { product_id: productIdOrSlug } }
),
removeBookmark: (productIdOrSlug: string | number) =>
shopRequest<void>(
`/me/bookmarks/${encodeURIComponent(String(productIdOrSlug))}/`,
{ method: 'DELETE' }
),
applyAsProvider: (payload: { store_name: string; description?: string }) =>
shopRequest<{
id?: number;
service: string;
status: string;
public_name: string;
message: string;
}>('/providers/apply/', { method: 'POST', body: payload }),
// Support & Chat
fetchSupportSubjects: () =>
shopRequest<{ results: ApiSupportSubject[] }>('/support/subjects/'),
fetchSupportTickets: () =>
shopRequest<{ count: number; results: ApiSupportTicket[] }>('/support/tickets/'),
createSupportTicket: (payload: {
order_number?: string;
product_id?: string | number;
subject?: string | number;
subject_label?: string;
description: string;
attachment_url?: string;
}) =>
shopRequest<ApiSupportTicket>('/support/tickets/', {
method: 'POST',
body: payload,
}),
fetchChatConversations: () =>
shopRequest<{ count: number; results: ApiConversation[] }>('/chat/conversations/'),
createChatConversation: (storeIdOrSlug: string | number) =>
shopRequest<ApiConversation>('/chat/conversations/', {
method: 'POST',
body: { store_id: storeIdOrSlug },
}),
fetchChatMessages: (pkOrSlug: string | number, afterId?: number) =>
shopRequest<{ conversation: ApiConversation; results: ApiChatMessage[] }>(
`/chat/conversations/${encodeURIComponent(String(pkOrSlug))}/messages/`,
{ query: { after_id: afterId } }
),
sendChatMessage: (
pkOrSlug: string | number,
payload: { text?: string; attachment_url?: string }
) =>
shopRequest<{
conversation: ApiConversation;
message: ApiChatMessage;
new_messages: ApiChatMessage[];
}>(
`/chat/conversations/${encodeURIComponent(String(pkOrSlug))}/messages/`,
{ method: 'POST', body: payload }
),
};