@commercejs/types 0.1.0

package/dist/adapter.d.ts

@@ -0,0 +1,310 @@
+import type { PaginatedResult, PaginationParams } from './common.js';
+import type { Product } from './product.js';
+import type { Category } from './category.js';
+import type { Cart } from './cart.js';
+import type { Customer, Address, RegisterInput, UpdateCustomerInput } from './customer.js';
+import type { Order } from './order.js';
+import type { ShippingMethod } from './shipping.js';
+import type { PaymentMethod } from './payment.js';
+import type { SearchParams, SearchResult } from './search.js';
+import type { Wishlist } from './wishlist.js';
+import type { Review, ReviewInput, ReviewSummary } from './review.js';
+import type { StoreInfo } from './store.js';
+import type { Promotion, Coupon } from './promotion.js';
+import type { ReturnRequest, CreateReturnInput } from './return.js';
+import type { CustomerGroup, QuoteRequest, CreateQuoteInput } from './wholesale.js';
+import type { Bid, PlaceBidInput } from './auction.js';
+import type { RentalBooking, CreateRentalBookingInput, AvailabilitySlot } from './rental.js';
+import type { GiftCard, GiftCardTransaction, PurchaseGiftCardInput, RedeemGiftCardInput } from './gift-card.js';
+import type { Brand } from './brand.js';
+import type { Country } from './country.js';
+import type { StoreLocation } from './location.js';
+import type { CreateOrderInput } from './order-input.js';
+import type { OrderStatusInfo, OrderHistoryEntry, UpdateOrderStatusInput } from './order-status.js';
+export interface GetProductParams {
+    id?: string;
+    slug?: string;
+}
+export interface GetCategoriesParams {
+    parentId?: string;
+    depth?: number;
+}
+export interface AddToCartInput {
+    productId: string;
+    variantId?: string;
+    quantity: number;
+}
+/**
+ * Catalog operations — product and category retrieval.
+ *
+ * Generic type parameters allow adapters to return enriched types
+ * (e.g., SallaProduct extends Product) while keeping the contract satisfied.
+ */
+export interface CatalogAdapter<TProduct extends Product = Product, TCategory extends Category = Category, TSearchResult extends SearchResult = SearchResult> {
+    /** Fetch a single product by ID or slug */
+    getProduct(params: GetProductParams): Promise<TProduct>;
+    /** Search / list products with filters and pagination */
+    getProducts(params: SearchParams): Promise<TSearchResult>;
+    /** Fetch category tree */
+    getCategories(params?: GetCategoriesParams): Promise<TCategory[]>;
+}
+/**
+ * Cart operations — CRUD for cart items.
+ */
+export interface CartAdapter<TCart extends Cart = Cart> {
+    /** Create a new empty cart and return it */
+    createCart(): Promise<TCart>;
+    /** Get an existing cart by ID */
+    getCart(cartId: string): Promise<TCart>;
+    /** Add an item to the cart */
+    addToCart(cartId: string, item: AddToCartInput): Promise<TCart>;
+    /** Update cart item quantity */
+    updateCartItem(cartId: string, itemId: string, quantity: number): Promise<TCart>;
+    /** Remove an item from the cart */
+    removeFromCart(cartId: string, itemId: string): Promise<TCart>;
+    /** Apply a coupon code to the cart */
+    applyCoupon(cartId: string, code: string): Promise<TCart>;
+    /** Remove a coupon from the cart */
+    removeCoupon(cartId: string): Promise<TCart>;
+}
+/**
+ * Checkout operations — shipping, payment, and order placement.
+ */
+export interface CheckoutAdapter<TCart extends Cart = Cart, TOrder extends Order = Order> {
+    /** List available shipping methods for a cart */
+    getShippingMethods(cartId: string): Promise<ShippingMethod[]>;
+    /** Set the shipping address */
+    setShippingAddress(cartId: string, address: Omit<Address, 'id' | 'isDefault'>): Promise<TCart>;
+    /** Set the billing address */
+    setBillingAddress(cartId: string, address: Omit<Address, 'id' | 'isDefault'>): Promise<TCart>;
+    /** Select a shipping method */
+    setShippingMethod(cartId: string, methodId: string): Promise<TCart>;
+    /** List available payment methods for a cart */
+    getPaymentMethods(cartId: string): Promise<PaymentMethod[]>;
+    /** Select a payment method */
+    setPaymentMethod(cartId: string, methodId: string): Promise<TCart>;
+    /** Place the order (finalize checkout) */
+    placeOrder(cartId: string): Promise<TOrder>;
+}
+/**
+ * Customer operations — authentication, profile, and address book.
+ */
+export interface CustomerAdapter<TCustomer extends Customer = Customer> {
+    /** Authenticate a customer */
+    login(email: string, password: string): Promise<TCustomer>;
+    /** Register a new customer */
+    register(input: RegisterInput): Promise<TCustomer>;
+    /** Get the currently authenticated customer */
+    getCustomer(): Promise<TCustomer>;
+    /** Update customer profile */
+    updateCustomer(input: UpdateCustomerInput): Promise<TCustomer>;
+    /** Logout the current customer */
+    logout(): Promise<void>;
+    /** Send a password reset email / OTP */
+    forgotPassword(email: string): Promise<void>;
+    /** Reset password using a token/OTP received via email */
+    resetPassword(token: string, newPassword: string): Promise<void>;
+    /** Get all saved addresses for the authenticated customer */
+    getAddresses(): Promise<Address[]>;
+    /** Add a new address to the customer's address book */
+    addAddress(address: Omit<Address, 'id'>): Promise<Address>;
+    /** Update an existing address */
+    updateAddress(addressId: string, address: Partial<Omit<Address, 'id'>>): Promise<Address>;
+    /** Delete an address from the address book */
+    deleteAddress(addressId: string): Promise<void>;
+}
+/**
+ * Order operations — create, read, and list orders.
+ *
+ * Separated from CustomerAdapter so that order creation can be handled
+ * independently (e.g., by a checkout engine that pushes orders to the
+ * platform after payment processing).
+ */
+export interface OrderAdapter<TOrder extends Order = Order> {
+    /** Create a new order from structured input (e.g., after checkout) */
+    createOrder(input: CreateOrderInput): Promise<TOrder>;
+    /** Get a single order by ID */
+    getOrder(orderId: string): Promise<TOrder>;
+    /** Get paginated list of orders (optionally filtered by customer) */
+    getCustomerOrders(params?: PaginationParams): Promise<PaginatedResult<TOrder>>;
+    /** Get all available order statuses (with labels, colors, icons) */
+    getOrderStatuses(): Promise<OrderStatusInfo[]>;
+    /** Update an order's status */
+    updateOrderStatus(orderId: string, input: UpdateOrderStatusInput): Promise<void>;
+    /** Cancel an order (convenience — calls updateOrderStatus with 'canceled') */
+    cancelOrder(orderId: string, note?: string): Promise<void>;
+    /** Duplicate an existing order (reorder) */
+    duplicateOrder(orderId: string): Promise<TOrder>;
+    /** Get order status change history / timeline */
+    getOrderHistory(orderId: string): Promise<OrderHistoryEntry[]>;
+}
+/**
+ * Wishlist operations — favorites / saved items.
+ */
+export interface WishlistAdapter<TWishlist extends Wishlist = Wishlist> {
+    /** Get the authenticated customer's wishlist */
+    getWishlist(): Promise<TWishlist>;
+    /** Add a product to the wishlist */
+    addToWishlist(productId: string, variantId?: string): Promise<TWishlist>;
+    /** Remove an item from the wishlist */
+    removeFromWishlist(itemId: string): Promise<TWishlist>;
+}
+/**
+ * Review operations — product ratings and reviews.
+ */
+export interface ReviewAdapter {
+    /** Get paginated reviews for a product */
+    getProductReviews(productId: string, params?: PaginationParams): Promise<PaginatedResult<Review>>;
+    /** Get review summary (average rating, distribution) for a product */
+    getReviewSummary(productId: string): Promise<ReviewSummary>;
+    /** Submit a new review for a product */
+    submitReview(input: ReviewInput): Promise<Review>;
+}
+/**
+ * Store operations — store-level metadata.
+ */
+export interface StoreAdapter<TStoreInfo extends StoreInfo = StoreInfo> {
+    /** Get store information (name, logo, currencies, locales) */
+    getStoreInfo(): Promise<TStoreInfo>;
+}
+/**
+ * Promotion operations — discounts and coupon validation.
+ */
+export interface PromotionAdapter {
+    /** Get all currently active promotions */
+    getActivePromotions(): Promise<Promotion[]>;
+    /** Validate a coupon code and return coupon details */
+    validateCoupon(code: string): Promise<Coupon>;
+}
+/**
+ * Return operations — return requests and refunds.
+ */
+export interface ReturnAdapter {
+    /** Create a return request for an order */
+    createReturn(input: CreateReturnInput): Promise<ReturnRequest>;
+    /** Get paginated list of customer's return requests */
+    getReturns(params?: PaginationParams): Promise<PaginatedResult<ReturnRequest>>;
+    /** Get a single return request by ID */
+    getReturn(returnId: string): Promise<ReturnRequest>;
+    /** Cancel a return request (only if status is 'requested') */
+    cancelReturn(returnId: string): Promise<ReturnRequest>;
+}
+/**
+ * Brand operations — product brand listing.
+ */
+export interface BrandAdapter {
+    /** Get all product brands */
+    getBrands(): Promise<Brand[]>;
+}
+/**
+ * Country operations — for address forms and locale resolution.
+ */
+export interface CountryAdapter {
+    /** Get all countries supported by the store */
+    getCountries(): Promise<Country[]>;
+}
+/**
+ * Location operations — store branches and pickup points.
+ */
+export interface LocationAdapter {
+    /** Get all store locations / branches */
+    getStoreLocations(): Promise<StoreLocation[]>;
+}
+/**
+ * Wholesale / B2B operations — customer groups, quotes, and bulk pricing.
+ */
+export interface WholesaleAdapter {
+    /** Get all customer groups (wholesale, retail, VIP, etc.) */
+    getCustomerGroups(): Promise<CustomerGroup[]>;
+    /** Create a request-for-quote */
+    createQuote(input: CreateQuoteInput): Promise<QuoteRequest>;
+    /** Get paginated list of customer's quote requests */
+    getQuotes(params?: PaginationParams): Promise<PaginatedResult<QuoteRequest>>;
+    /** Get a single quote by ID */
+    getQuote(quoteId: string): Promise<QuoteRequest>;
+    /** Accept a quoted price (converts to order) */
+    acceptQuote(quoteId: string): Promise<QuoteRequest>;
+    /** Reject a quote */
+    rejectQuote(quoteId: string): Promise<QuoteRequest>;
+}
+/**
+ * Auction operations — bidding on products.
+ */
+export interface AuctionAdapter {
+    /** Place a bid on an auction product */
+    placeBid(input: PlaceBidInput): Promise<Bid>;
+    /** Get bid history for a product */
+    getBids(productId: string, params?: PaginationParams): Promise<PaginatedResult<Bid>>;
+    /** Get the current winning bid for a product */
+    getWinningBid(productId: string): Promise<Bid | null>;
+}
+/**
+ * Rental / booking operations.
+ */
+export interface RentalAdapter {
+    /** Check availability for a product in a date range */
+    checkAvailability(productId: string, startDate: string, endDate: string): Promise<AvailabilitySlot[]>;
+    /** Create a rental booking */
+    createBooking(input: CreateRentalBookingInput): Promise<RentalBooking>;
+    /** Get customer's bookings */
+    getBookings(params?: PaginationParams): Promise<PaginatedResult<RentalBooking>>;
+    /** Get a single booking by ID */
+    getBooking(bookingId: string): Promise<RentalBooking>;
+    /** Cancel a booking */
+    cancelBooking(bookingId: string): Promise<RentalBooking>;
+}
+/**
+ * Gift card operations.
+ */
+export interface GiftCardAdapter {
+    /** Purchase a new gift card */
+    purchaseGiftCard(input: PurchaseGiftCardInput): Promise<GiftCard>;
+    /** Check a gift card balance by code */
+    getGiftCardBalance(code: string): Promise<GiftCard>;
+    /** Redeem a gift card at checkout (apply to cart) */
+    redeemGiftCard(input: RedeemGiftCardInput): Promise<GiftCard>;
+    /** Get customer's gift cards */
+    getMyGiftCards(): Promise<GiftCard[]>;
+    /** Get transaction history for a gift card */
+    getGiftCardTransactions(giftCardId: string): Promise<GiftCardTransaction[]>;
+}
+/** Well-known capability domain names */
+export type AdapterDomain = 'catalog' | 'cart' | 'checkout' | 'orders' | 'customers' | 'wishlist' | 'reviews' | 'store' | 'promotions' | 'returns' | 'wholesale' | 'auctions' | 'rentals' | 'gift-cards' | 'brands' | 'countries' | 'locations';
+/**
+ * CommerceAdapter — the full contract that platform adapters implement.
+ *
+ * Composed from domain-specific sub-interfaces. Each adapter (Salla, Zid,
+ * Shopify, Medusa, etc.) provides its own implementation, mapping
+ * platform-specific API calls and data shapes to the unified types.
+ *
+ * Adapters MUST implement all sub-interfaces but MAY throw a
+ * `CommerceError` with code 'NOT_SUPPORTED' (status 501) for domains
+ * the platform doesn't support. Use `capabilities` to check support
+ * at runtime before calling.
+ *
+ * Generic type parameters allow adapters to expose enriched, platform-specific
+ * types while remaining compatible with the base interface.
+ *
+ * @example
+ * ```ts
+ * // Check before calling optional domain
+ * if (adapter.capabilities.includes('cart')) {
+ *   const cart = await adapter.createCart()
+ * }
+ *
+ * // Adapter with enriched types
+ * class SallaAdapter implements CommerceAdapter<SallaProduct, SallaCategory> { ... }
+ * ```
+ */
+export interface CommerceAdapter<TProduct extends Product = Product, TCategory extends Category = Category, TSearchResult extends SearchResult = SearchResult, TCart extends Cart = Cart, TOrder extends Order = Order, TCustomer extends Customer = Customer, TWishlist extends Wishlist = Wishlist, TStoreInfo extends StoreInfo = StoreInfo> extends CatalogAdapter<TProduct, TCategory, TSearchResult>, CartAdapter<TCart>, CheckoutAdapter<TCart, TOrder>, CustomerAdapter<TCustomer>, OrderAdapter<TOrder>, WishlistAdapter<TWishlist>, ReviewAdapter, StoreAdapter<TStoreInfo>, PromotionAdapter, ReturnAdapter, WholesaleAdapter, AuctionAdapter, RentalAdapter, GiftCardAdapter, BrandAdapter, CountryAdapter, LocationAdapter {
+    /** Unique adapter identifier (e.g., "salla", "zid", "shopify") */
+    readonly name: string;
+    /**
+     * Domains this adapter actually supports (i.e., won't throw NOT_SUPPORTED).
+     *
+     * Consumers should check this before calling methods in optional domains.
+     * Required domains like 'catalog' and 'store' should always be listed.
+     */
+    readonly capabilities: AdapterDomain[];
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/adapter.js

@@ -0,0 +1,12 @@
+// ---------------------------------------------------------------------------
+// Adapter contract — the interface every platform adapter must implement
+// ---------------------------------------------------------------------------
+// Split into domain-specific sub-interfaces (Design Pattern: Interface
+// Segregation) so adapters can implement only the domains they support.
+//
+// The CommerceAdapter type composes all sub-interfaces. For composable
+// setups, consumers can use individual sub-interfaces (CatalogAdapter,
+// OrderAdapter, etc.) and the AdapterCapabilities system.
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAC9E,uEAAuE;AACvE,wEAAwE;AACxE,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,0DAA0D;AAC1D,8EAA8E"}

package/dist/auction.d.ts

@@ -0,0 +1,59 @@
+import type { Id, Maybe, Price } from './common.js';
+/** Type of auction */
+export type AuctionType = 'english' | 'dutch' | 'sealed' | 'reverse';
+/** Auction lifecycle status */
+export type AuctionStatus = 'upcoming' | 'active' | 'ended' | 'sold' | 'cancelled' | 'reserve_not_met';
+/** Auction metadata on a product */
+export interface AuctionProductMeta {
+    /** Type of auction */
+    auctionType: AuctionType;
+    status: AuctionStatus;
+    /** Starting / opening price */
+    startingPrice: Price;
+    /** Reserve price — minimum to sell (null = no reserve) */
+    reservePrice: Maybe<Price>;
+    /** Minimum bid increment */
+    bidIncrement: Price;
+    /** Buy-it-now price — skip the auction (null = no buy-it-now) */
+    buyNowPrice: Maybe<Price>;
+    /** Auction start time (ISO 8601) */
+    startsAt: string;
+    /** Auction end time (ISO 8601) */
+    endsAt: string;
+    /** Current highest bid (null if no bids yet) */
+    currentBid: Maybe<Price>;
+    /** Total number of bids placed */
+    bidCount: number;
+    /** Whether auto-bidding (proxy bidding) is allowed */
+    autoBiddingEnabled: boolean;
+    /** ID of the current winning bidder (null if no bids) */
+    winningBidderId: Maybe<Id>;
+}
+/** A single bid placed by a customer */
+export interface Bid {
+    id: Id;
+    /** Product / auction ID */
+    productId: Id;
+    /** Bidder customer ID */
+    bidderId: Id;
+    /** Bidder display name */
+    bidderName: string;
+    /** Bid amount */
+    amount: Price;
+    /** Maximum amount for auto-bidding (null if not auto-bidding) */
+    maxAutoBid: Maybe<Price>;
+    /** Whether this is currently the winning bid */
+    isWinning: boolean;
+    /** Whether this was an auto-bid placed by the system */
+    isAutoBid: boolean;
+    createdAt: string;
+}
+/** Input for placing a bid */
+export interface PlaceBidInput {
+    productId: string;
+    /** Bid amount */
+    amount: number;
+    /** Maximum auto-bid amount (optional — enables proxy bidding) */
+    maxAutoBid?: number;
+}
+//# sourceMappingURL=auction.d.ts.map

package/dist/auction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auction.d.ts","sourceRoot":"","sources":["../src/auction.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEnD,sBAAsB;AACtB,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,OAAO,GACP,QAAQ,GACR,SAAS,CAAA;AAEb,+BAA+B;AAC/B,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,QAAQ,GACR,OAAO,GACP,MAAM,GACN,WAAW,GACX,iBAAiB,CAAA;AAErB,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,WAAW,EAAE,WAAW,CAAA;IACxB,MAAM,EAAE,aAAa,CAAA;IACrB,+BAA+B;IAC/B,aAAa,EAAE,KAAK,CAAA;IACpB,0DAA0D;IAC1D,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC1B,4BAA4B;IAC5B,YAAY,EAAE,KAAK,CAAA;IACnB,iEAAiE;IACjE,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACzB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACxB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,sDAAsD;IACtD,kBAAkB,EAAE,OAAO,CAAA;IAC3B,yDAAyD;IACzD,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;CAC3B;AAED,wCAAwC;AACxC,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,EAAE,CAAA;IACN,2BAA2B;IAC3B,SAAS,EAAE,EAAE,CAAA;IACb,yBAAyB;IACzB,QAAQ,EAAE,EAAE,CAAA;IACZ,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB;IACjB,MAAM,EAAE,KAAK,CAAA;IACb,iEAAiE;IACjE,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACxB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAA;IAClB,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/dist/auction.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Auction / bidding types
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=auction.js.map

package/dist/auction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auction.js","sourceRoot":"","sources":["../src/auction.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E"}

package/dist/brand.d.ts

@@ -0,0 +1,16 @@
+import type { Id, LocalizedString, Maybe, Image } from './common.js';
+/** A product brand */
+export interface Brand {
+    id: Id;
+    /** Display name */
+    name: LocalizedString;
+    /** URL-friendly slug */
+    slug: string;
+    /** Brand logo */
+    logo: Maybe<Image>;
+    /** Brand description */
+    description: Maybe<LocalizedString>;
+    /** Whether the brand is active/visible */
+    isActive: boolean;
+}
+//# sourceMappingURL=brand.d.ts.map

package/dist/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEpE,sBAAsB;AACtB,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,EAAE,CAAA;IACN,mBAAmB;IACnB,IAAI,EAAE,eAAe,CAAA;IACrB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB;IACjB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAClB,wBAAwB;IACxB,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;IACnC,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,CAAA;CAClB"}

package/dist/brand.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Brand types
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=brand.js.map

package/dist/brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.js","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,cAAc;AACd,8EAA8E"}

package/dist/cart.d.ts

@@ -0,0 +1,42 @@
+import type { DiscountablePrice, Id, Image, LocalizedString, Maybe, Price } from './common.js';
+import type { Address } from './customer.js';
+import type { ShippingMethod } from './shipping.js';
+import type { PaymentMethod } from './payment.js';
+/** A single item in the cart */
+export interface CartItem {
+    id: Id;
+    productId: Id;
+    variantId: Maybe<Id>;
+    name: LocalizedString;
+    image: Maybe<Image>;
+    quantity: number;
+    /** Unit price */
+    price: DiscountablePrice;
+    /** Quantity × unit price */
+    totalPrice: Price;
+}
+/** Aggregated cart totals */
+export interface CartTotals {
+    subtotal: Price;
+    shipping: Maybe<Price>;
+    tax: Maybe<Price>;
+    discount: Maybe<Price>;
+    total: Price;
+}
+/** Shopping cart */
+export interface Cart {
+    id: Id;
+    items: CartItem[];
+    totals: CartTotals;
+    shippingAddress: Maybe<Address>;
+    billingAddress: Maybe<Address>;
+    shippingMethod: Maybe<ShippingMethod>;
+    paymentMethod: Maybe<PaymentMethod>;
+    couponCode: Maybe<string>;
+    /** Associated customer (null for guest carts) */
+    customerId: Maybe<Id>;
+    itemCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=cart.d.ts.map

package/dist/cart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../src/cart.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,gCAAgC;AAChC,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,EAAE,CAAA;IACN,SAAS,EAAE,EAAE,CAAA;IACb,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IACpB,IAAI,EAAE,eAAe,CAAA;IACrB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB;IACjB,KAAK,EAAE,iBAAiB,CAAA;IACxB,4BAA4B;IAC5B,UAAU,EAAE,KAAK,CAAA;CAClB;AAED,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,KAAK,CAAA;IACf,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACtB,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACjB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACtB,KAAK,EAAE,KAAK,CAAA;CACb;AAED,oBAAoB;AACpB,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,EAAE,CAAA;IACN,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,MAAM,EAAE,UAAU,CAAA;IAClB,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAC/B,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAC9B,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;IACrC,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;IACnC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACzB,iDAAiD;IACjD,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/dist/cart.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Cart domain types
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=cart.js.map

package/dist/cart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.js","sourceRoot":"","sources":["../src/cart.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E"}

package/dist/category.d.ts

@@ -0,0 +1,13 @@
+import type { Id, Image, LocalizedString, Maybe } from './common.js';
+/** Product category */
+export interface Category {
+    id: Id;
+    name: LocalizedString;
+    slug: string;
+    description: Maybe<LocalizedString>;
+    image: Maybe<Image>;
+    parentId: Maybe<Id>;
+    children: Category[];
+    productCount: Maybe<number>;
+}
+//# sourceMappingURL=category.d.ts.map

package/dist/category.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.d.ts","sourceRoot":"","sources":["../src/category.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEpE,uBAAuB;AACvB,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,EAAE,CAAA;IACN,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;IACnC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACnB,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IACnB,QAAQ,EAAE,QAAQ,EAAE,CAAA;IACpB,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAC5B"}

package/dist/category.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Category domain types
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=category.js.map

package/dist/category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.js","sourceRoot":"","sources":["../src/category.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E"}

package/dist/common.d.ts

@@ -0,0 +1,81 @@
+/** Nullable helper — a value that may be null */
+export type Maybe<T> = T | null;
+/** String identifier type for all entities */
+export type Id = string;
+/**
+ * Bilingual / multilingual string.
+ * Arabic and English are required, additional languages are optional.
+ */
+export interface LocalizedString {
+    /** Arabic value (required for GCC markets) */
+    ar: string;
+    /** English value */
+    en: string;
+    /** Additional languages keyed by ISO 639-1 code */
+    [locale: string]: string;
+}
+/** Standard paginated result wrapper */
+export interface PaginatedResult<T> {
+    items: T[];
+    total: number;
+    page: number;
+    perPage: number;
+    hasMore: boolean;
+}
+/** Pagination input params */
+export interface PaginationParams {
+    page?: number;
+    perPage?: number;
+}
+/** Monetary amount */
+export interface Price {
+    /** Amount in the smallest currency unit (e.g., halalat for SAR) */
+    amount: number;
+    /** ISO 4217 currency code (e.g., "SAR", "AED", "USD") */
+    currency: string;
+    /** Human-readable formatted string (e.g., "١٢٫٩٩ ر.س" or "SAR 12.99") */
+    formatted: string;
+}
+/** Price that may have a discount applied */
+export interface DiscountablePrice extends Price {
+    /** Original amount before discount */
+    originalAmount?: number;
+    /** Discount percentage (0–100) */
+    discountPercent?: number;
+}
+/** Image reference */
+export interface Image {
+    url: string;
+    alt: string;
+    width?: number;
+    height?: number;
+}
+/** Recursive partial — allows deep nested partial updates */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? T[P] extends Array<infer U> ? Array<DeepPartial<U>> : DeepPartial<T[P]> : T[P];
+};
+/** Standardized error codes for all adapter operations */
+export type CommerceErrorCode = 'NOT_FOUND' | 'NOT_SUPPORTED' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'VALIDATION' | 'RATE_LIMIT' | 'PLATFORM_ERROR' | 'NETWORK' | 'TIMEOUT' | 'UNKNOWN';
+/**
+ * Typed error class for all commerce operations.
+ * Adapters must throw CommerceError (not raw errors)
+ * so consumers can handle failures in a typed, platform-agnostic way.
+ */
+export declare class CommerceError extends Error {
+    readonly code: CommerceErrorCode;
+    readonly statusCode?: number | undefined;
+    readonly cause?: unknown | undefined;
+    readonly name = "CommerceError";
+    constructor(message: string, code: CommerceErrorCode, statusCode?: number | undefined, cause?: unknown | undefined);
+}
+/** Type guard — narrows unknown errors to CommerceError */
+export declare function isCommerceError(err: unknown): err is CommerceError;
+/**
+ * Tax calculation strategy — allows per-market tax rules.
+ * e.g., 15% VAT for KSA, 5% for UAE, 0% for Bahrain.
+ */
+export interface TaxStrategy {
+    /** Calculate tax for a given subtotal and country code */
+    calculate(subtotal: number, currency: string, countryCode: string): Price;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAIA,iDAAiD;AACjD,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAE/B,8CAA8C;AAC9C,MAAM,MAAM,EAAE,GAAG,MAAM,CAAA;AAEvB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAA;IACV,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,mDAAmD;IACnD,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CACzB;AAED,wCAAwC;AACxC,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,8BAA8B;AAC9B,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,sBAAsB;AACtB,MAAM,WAAW,KAAK;IACpB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAkB,SAAQ,KAAK;IAC9C,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kCAAkC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,sBAAsB;AACtB,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID,6DAA6D;AAC7D,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAChC,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACzB,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACrB,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACnB,CAAC,CAAC,CAAC,CAAC;CACT,CAAA;AAID,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,eAAe,GACf,cAAc,GACd,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,gBAAgB,GAChB,SAAS,GACT,SAAS,GACT,SAAS,CAAA;AAEb;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAKpB,IAAI,EAAE,iBAAiB;aACvB,UAAU,CAAC,EAAE,MAAM;aACnB,KAAK,CAAC,EAAE,OAAO;IANjC,SAAgB,IAAI,mBAAkB;gBAGpC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,iBAAiB,EACvB,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,KAAK,CAAC,EAAE,OAAO,YAAA;CAMlC;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAElE;AAID;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,KAAK,CAAA;CAC1E"}