@spree/sdk 0.6.8 → 0.7.0

package/dist/index.d.cts

@@ -1,45 +1,7 @@
-import { ErrorResponse, LoginCredentials, AuthTokens, RegisterParams, ProductListParams, PaginatedResponse, StoreProduct, ProductFiltersParams, ProductFiltersResponse, ListParams, StoreTaxonomy, TaxonListParams, StoreTaxon, ListResponse, StoreCountry, StoreCurrency, StoreLocale, StoreMarket, StoreOrder, CreateCartParams, UpdateOrderParams, AddLineItemParams, UpdateLineItemParams, StorePayment, StorePaymentMethod, CreatePaymentSessionParams, StorePaymentSession, UpdatePaymentSessionParams, CompletePaymentSessionParams, StoreShipment, StoreCustomer, StoreAddress, AddressParams, StoreCreditCard, StoreGiftCard, OrderListParams, CreatePaymentSetupSessionParams, StorePaymentSetupSession, CompletePaymentSetupSessionParams, StoreWishlist, StoreWishedItem } from './types/index.cjs';
-export { AdminCustomer, AdminLineItem, AdminMetafield, AdminOrder, AdminPrice, AdminProduct, AdminTaxon, AdminTaxonomy, AdminVariant, AvailabilityFilter, FilterOption, LocaleDefaults, OptionFilter, OptionFilterOption, PaginationMeta, PriceRangeFilter, ProductFilter, SortOption, StoreAsset, StoreBase, StoreCustomerReturn, StoreDigital, StoreDigitalLink, StoreExport, StoreGiftCardBatch, StoreImage, StoreImport, StoreImportRow, StoreInvitation, StoreLineItem, StoreMetafield, StoreNewsletterSubscriber, StoreOptionType, StoreOptionValue, StoreOrderPromotion, StorePaymentSource, StorePrice, StorePromotion, StoreRefund, StoreReimbursement, StoreReport, StoreReturnAuthorization, StoreReturnItem, StoreShippingMethod, StoreShippingRate, StoreState, StoreStockItem, StoreStockLocation, StoreStockMovement, StoreStockTransfer, StoreStoreCredit, StoreVariant, TaxonFilter, TaxonFilterOption } from './types/index.cjs';
-
-interface RetryConfig {
-    /** Maximum number of retries (default: 2) */
-    maxRetries?: number;
-    /** HTTP status codes to retry on (default: [429, 500, 502, 503, 504]) */
-    retryOnStatus?: number[];
-    /** Base delay in ms for exponential backoff (default: 300) */
-    baseDelay?: number;
-    /** Maximum delay in ms (default: 10000) */
-    maxDelay?: number;
-    /** Whether to retry on network errors (default: true) */
-    retryOnNetworkError?: boolean;
-}
-interface RequestOptions {
-    /** Bearer token for authenticated requests */
-    token?: string;
-    /** Order token for guest checkout */
-    orderToken?: string;
-    /** Locale for translated content (e.g., 'en', 'fr') */
-    locale?: string;
-    /** Currency for prices (e.g., 'USD', 'EUR') */
-    currency?: string;
-    /** Country ISO code for market resolution (e.g., 'US', 'DE') */
-    country?: string;
-    /** Idempotency key for safe retries of mutating requests (max 255 characters) */
-    idempotencyKey?: string;
-    /** Custom headers */
-    headers?: Record<string, string>;
-}
-interface InternalRequestOptions extends RequestOptions {
-    body?: unknown;
-    params?: Record<string, string | number | boolean | (string | number)[] | undefined>;
-}
-declare class SpreeError extends Error {
-    readonly code: string;
-    readonly status: number;
-    readonly details?: Record<string, string[]>;
-    constructor(response: ErrorResponse, status: number);
-}
-type RequestFn = <T>(method: string, path: string, options?: InternalRequestOptions) => Promise<T>;
+import { RequestFn, LoginCredentials, AuthTokens, RegisterParams, RequestOptions, PaginatedResponse, ListParams, ListResponse, AddressParams, RetryConfig } from '@spree/sdk-core';
+export { AddressParams, AuthTokens, ErrorResponse, ListParams, ListResponse, LocaleDefaults, LoginCredentials, PaginatedResponse, PaginationMeta, RegisterParams, RequestOptions, RetryConfig, SpreeError } from '@spree/sdk-core';
+import { ProductListParams, Product, ProductFiltersParams, ProductFiltersResponse, StoreTaxonomy as Taxonomy, TaxonListParams, StoreTaxon as Taxon, Country, Currency, Locale, Market, Order, CreateCartParams, UpdateOrderParams, AddLineItemParams, UpdateLineItemParams, Payment, PaymentMethod, CreatePaymentSessionParams, PaymentSession, UpdatePaymentSessionParams, CompletePaymentSessionParams, Shipment, Customer, Address, CreditCard, GiftCard, OrderListParams, CreatePaymentSetupSessionParams, PaymentSetupSession, CompletePaymentSetupSessionParams, StoreWishlist as Wishlist, StoreWishedItem as WishedItem } from './types/index.cjs';
+export { Asset, AvailabilityFilter, Base, CustomerReturn, Digital, DigitalLink, Export, FilterOption, GiftCardBatch, Image, Import, ImportRow, Invitation, LineItem, LineItemInput, Metafield, NewsletterSubscriber, OptionFilter, OptionFilterOption, OptionType, OptionValue, OrderPromotion, PaymentSource, Price, PriceRangeFilter, ProductFilter, Promotion, Refund, Reimbursement, Report, ReturnAuthorization, ReturnItem, ShippingCategory, ShippingMethod, ShippingRate, SortOption, State, StockItem, StockLocation, StockMovement, StockTransfer, Asset as StoreAsset, StoreCredit, CustomerReturn as StoreCustomerReturn, Digital as StoreDigital, DigitalLink as StoreDigitalLink, GiftCardBatch as StoreGiftCardBatch, Image as StoreImage, LineItem as StoreLineItem, Metafield as StoreMetafield, OptionType as StoreOptionType, OptionValue as StoreOptionValue, OrderPromotion as StoreOrderPromotion, PaymentSource as StorePaymentSource, Price as StorePrice, Promotion as StorePromotion, Refund as StoreRefund, Reimbursement as StoreReimbursement, ReturnAuthorization as StoreReturnAuthorization, ReturnItem as StoreReturnItem, ShippingCategory as StoreShippingCategory, ShippingMethod as StoreShippingMethod, ShippingRate as StoreShippingRate, State as StoreState, StockItem as StoreStockItem, StockLocation as StoreStockLocation, StoreCredit as StoreStoreCredit, StoreTaxCategory, StoreVariant, StoreTaxCategory as TaxCategory, TaxonFilter, TaxonFilterOption, StoreVariant as Variant } from './types/index.cjs';
 
 declare class StoreClient {
     private readonly request;
@@ -62,13 +24,14 @@ declare class StoreClient {
         /**
          * List products
          */
-        list: (params?: ProductListParams, options?: RequestOptions) => Promise<PaginatedResponse<StoreProduct>>;
+        list: (params?: ProductListParams, options?: RequestOptions) => Promise<PaginatedResponse<Product>>;
         /**
          * Get a product by ID or slug
          */
         get: (idOrSlug: string, params?: {
             expand?: string[];
-        }, options?: RequestOptions) => Promise<StoreProduct>;
+            fields?: string[];
+        }, options?: RequestOptions) => Promise<Product>;
         /**
          * Get available filters for products
          * Returns filter options (price range, availability, option types, taxons) with counts
@@ -79,25 +42,27 @@ declare class StoreClient {
         /**
          * List taxonomies
          */
-        list: (params?: ListParams, options?: RequestOptions) => Promise<PaginatedResponse<StoreTaxonomy>>;
+        list: (params?: ListParams, options?: RequestOptions) => Promise<PaginatedResponse<Taxonomy>>;
         /**
          * Get a taxonomy by ID
          */
         get: (id: string, params?: {
             expand?: string[];
-        }, options?: RequestOptions) => Promise<StoreTaxonomy>;
+            fields?: string[];
+        }, options?: RequestOptions) => Promise<Taxonomy>;
     };
     readonly taxons: {
         /**
          * List taxons
          */
-        list: (params?: TaxonListParams, options?: RequestOptions) => Promise<PaginatedResponse<StoreTaxon>>;
+        list: (params?: TaxonListParams, options?: RequestOptions) => Promise<PaginatedResponse<Taxon>>;
         /**
          * Get a taxon by ID or permalink
          */
         get: (idOrPermalink: string, params?: {
             expand?: string[];
-        }, options?: RequestOptions) => Promise<StoreTaxon>;
+            fields?: string[];
+        }, options?: RequestOptions) => Promise<Taxon>;
         /**
          * Nested resource: Products in a taxon
          */
@@ -106,7 +71,7 @@ declare class StoreClient {
              * List products in a taxon
              * @param taxonId - Taxon ID (prefix_id) or permalink
              */
-            list: (taxonId: string, params?: ProductListParams, options?: RequestOptions) => Promise<PaginatedResponse<StoreProduct>>;
+            list: (taxonId: string, params?: ProductListParams, options?: RequestOptions) => Promise<PaginatedResponse<Product>>;
         };
     };
     readonly countries: {
@@ -114,7 +79,7 @@ declare class StoreClient {
          * List countries available in the store
          * Each country includes currency and default_locale derived from its market
          */
-        list: (options?: RequestOptions) => Promise<ListResponse<StoreCountry>>;
+        list: (options?: RequestOptions) => Promise<ListResponse<Country>>;
         /**
          * Get a country by ISO code
          * Use `?expand=states` to expand states for address forms
@@ -122,35 +87,36 @@ declare class StoreClient {
          */
         get: (iso: string, params?: {
             expand?: string[];
-        }, options?: RequestOptions) => Promise<StoreCountry>;
+            fields?: string[];
+        }, options?: RequestOptions) => Promise<Country>;
     };
     readonly currencies: {
         /**
          * List currencies supported by the store (derived from markets)
          */
-        list: (options?: RequestOptions) => Promise<ListResponse<StoreCurrency>>;
+        list: (options?: RequestOptions) => Promise<ListResponse<Currency>>;
     };
     readonly locales: {
         /**
          * List locales supported by the store (derived from markets)
          */
-        list: (options?: RequestOptions) => Promise<ListResponse<StoreLocale>>;
+        list: (options?: RequestOptions) => Promise<ListResponse<Locale>>;
     };
     readonly markets: {
         /**
          * List all markets for the current store
          */
-        list: (options?: RequestOptions) => Promise<ListResponse<StoreMarket>>;
+        list: (options?: RequestOptions) => Promise<ListResponse<Market>>;
         /**
          * Get a market by prefixed ID
          * @param id - Market prefixed ID (e.g., "mkt_k5nR8xLq")
          */
-        get: (id: string, options?: RequestOptions) => Promise<StoreMarket>;
+        get: (id: string, options?: RequestOptions) => Promise<Market>;
         /**
          * Resolve which market applies for a given country
          * @param country - ISO 3166-1 alpha-2 code (e.g., "DE", "US")
          */
-        resolve: (country: string, options?: RequestOptions) => Promise<StoreMarket>;
+        resolve: (country: string, options?: RequestOptions) => Promise<Market>;
         /**
          * Nested resource: Countries in a market
          */
@@ -159,7 +125,7 @@ declare class StoreClient {
              * List countries belonging to a market
              * @param marketId - Market prefixed ID
              */
-            list: (marketId: string, options?: RequestOptions) => Promise<ListResponse<StoreCountry>>;
+            list: (marketId: string, options?: RequestOptions) => Promise<ListResponse<Country>>;
             /**
              * Get a country by ISO code within a market
              * @param marketId - Market prefixed ID
@@ -167,7 +133,8 @@ declare class StoreClient {
              */
             get: (marketId: string, iso: string, params?: {
                 expand?: string[];
-            }, options?: RequestOptions) => Promise<StoreCountry>;
+                fields?: string[];
+            }, options?: RequestOptions) => Promise<Country>;
         };
     };
     readonly cart: {
@@ -175,14 +142,14 @@ declare class StoreClient {
          * Get current cart (returns null if none exists)
          * Pass orderToken for guest checkout, or use JWT for authenticated users
          */
-        get: (options?: RequestOptions) => Promise<StoreOrder & {
+        get: (options?: RequestOptions) => Promise<Order & {
             token: string;
         }>;
         /**
          * Create a new cart
          * @param params - Optional cart parameters (e.g., metadata)
          */
-        create: (params?: CreateCartParams, options?: RequestOptions) => Promise<StoreOrder & {
+        create: (params?: CreateCartParams, options?: RequestOptions) => Promise<Order & {
             token: string;
         }>;
         /**
@@ -190,7 +157,7 @@ declare class StoreClient {
          * Requires both JWT token (for authentication) and orderToken (to identify the cart)
          * @param options - Must include both `token` (JWT) and `orderToken` (guest cart token)
          */
-        associate: (options: RequestOptions) => Promise<StoreOrder & {
+        associate: (options: RequestOptions) => Promise<Order & {
             token: string;
         }>;
     };
@@ -200,31 +167,32 @@ declare class StoreClient {
          */
         get: (idOrNumber: string, params?: {
             expand?: string[];
-        }, options?: RequestOptions) => Promise<StoreOrder>;
+            fields?: string[];
+        }, options?: RequestOptions) => Promise<Order>;
         /**
          * Update an order
          */
-        update: (idOrNumber: string, params: UpdateOrderParams, options?: RequestOptions) => Promise<StoreOrder>;
+        update: (idOrNumber: string, params: UpdateOrderParams, options?: RequestOptions) => Promise<Order>;
         /**
          * Advance order to next checkout step
          */
-        next: (idOrNumber: string, options?: RequestOptions) => Promise<StoreOrder>;
+        next: (idOrNumber: string, options?: RequestOptions) => Promise<Order>;
         /**
          * Advance through all checkout steps
          */
-        advance: (idOrNumber: string, options?: RequestOptions) => Promise<StoreOrder>;
+        advance: (idOrNumber: string, options?: RequestOptions) => Promise<Order>;
         /**
          * Complete the order
          */
-        complete: (idOrNumber: string, options?: RequestOptions) => Promise<StoreOrder>;
+        complete: (idOrNumber: string, options?: RequestOptions) => Promise<Order>;
         /**
          * Add store credit to order
          */
-        addStoreCredit: (idOrNumber: string, amount?: number, options?: RequestOptions) => Promise<StoreOrder>;
+        addStoreCredit: (idOrNumber: string, amount?: number, options?: RequestOptions) => Promise<Order>;
         /**
          * Remove store credit from order
          */
-        removeStoreCredit: (idOrNumber: string, options?: RequestOptions) => Promise<StoreOrder>;
+        removeStoreCredit: (idOrNumber: string, options?: RequestOptions) => Promise<Order>;
         /**
          * Nested resource: Line items
          */
@@ -233,17 +201,17 @@ declare class StoreClient {
              * Add a line item to an order.
              * Returns the updated order with recalculated totals.
              */
-            create: (orderId: string, params: AddLineItemParams, options?: RequestOptions) => Promise<StoreOrder>;
+            create: (orderId: string, params: AddLineItemParams, options?: RequestOptions) => Promise<Order>;
             /**
              * Update a line item quantity.
              * Returns the updated order with recalculated totals.
              */
-            update: (orderId: string, lineItemId: string, params: UpdateLineItemParams, options?: RequestOptions) => Promise<StoreOrder>;
+            update: (orderId: string, lineItemId: string, params: UpdateLineItemParams, options?: RequestOptions) => Promise<Order>;
             /**
              * Remove a line item from an order.
              * Returns the updated order with recalculated totals.
              */
-            delete: (orderId: string, lineItemId: string, options?: RequestOptions) => Promise<StoreOrder>;
+            delete: (orderId: string, lineItemId: string, options?: RequestOptions) => Promise<Order>;
         };
         /**
          * Nested resource: Payments
@@ -252,11 +220,11 @@ declare class StoreClient {
             /**
              * List payments for an order
              */
-            list: (orderId: string, options?: RequestOptions) => Promise<PaginatedResponse<StorePayment>>;
+            list: (orderId: string, options?: RequestOptions) => Promise<PaginatedResponse<Payment>>;
             /**
              * Get a payment by ID
              */
-            get: (orderId: string, paymentId: string, options?: RequestOptions) => Promise<StorePayment>;
+            get: (orderId: string, paymentId: string, options?: RequestOptions) => Promise<Payment>;
         };
         /**
          * Nested resource: Payment methods
@@ -265,7 +233,7 @@ declare class StoreClient {
             /**
              * List available payment methods for an order
              */
-            list: (orderId: string, options?: RequestOptions) => Promise<ListResponse<StorePaymentMethod>>;
+            list: (orderId: string, options?: RequestOptions) => Promise<ListResponse<PaymentMethod>>;
         };
         /**
          * Nested resource: Payment sessions
@@ -275,21 +243,21 @@ declare class StoreClient {
              * Create a payment session for an order
              * Delegates to the payment gateway to initialize a provider-specific session
              */
-            create: (orderId: string, params: CreatePaymentSessionParams, options?: RequestOptions) => Promise<StorePaymentSession>;
+            create: (orderId: string, params: CreatePaymentSessionParams, options?: RequestOptions) => Promise<PaymentSession>;
             /**
              * Get a payment session by ID
              */
-            get: (orderId: string, sessionId: string, options?: RequestOptions) => Promise<StorePaymentSession>;
+            get: (orderId: string, sessionId: string, options?: RequestOptions) => Promise<PaymentSession>;
             /**
              * Update a payment session
              * Delegates to the payment gateway to sync changes with the provider
              */
-            update: (orderId: string, sessionId: string, params: UpdatePaymentSessionParams, options?: RequestOptions) => Promise<StorePaymentSession>;
+            update: (orderId: string, sessionId: string, params: UpdatePaymentSessionParams, options?: RequestOptions) => Promise<PaymentSession>;
             /**
              * Complete a payment session
              * Confirms the payment with the provider, triggering capture/authorization
              */
-            complete: (orderId: string, sessionId: string, params?: CompletePaymentSessionParams, options?: RequestOptions) => Promise<StorePaymentSession>;
+            complete: (orderId: string, sessionId: string, params?: CompletePaymentSessionParams, options?: RequestOptions) => Promise<PaymentSession>;
         };
         /**
          * Nested resource: Coupon codes
@@ -298,12 +266,12 @@ declare class StoreClient {
             /**
              * Apply a coupon code to an order
              */
-            apply: (orderId: string, code: string, options?: RequestOptions) => Promise<StoreOrder>;
+            apply: (orderId: string, code: string, options?: RequestOptions) => Promise<Order>;
             /**
              * Remove a coupon code from an order
              * @param promotionId - The promotion prefix_id (e.g., 'promo_xxx')
              */
-            remove: (orderId: string, promotionId: string, options?: RequestOptions) => Promise<StoreOrder>;
+            remove: (orderId: string, promotionId: string, options?: RequestOptions) => Promise<Order>;
         };
         /**
          * Nested resource: Shipments
@@ -312,21 +280,21 @@ declare class StoreClient {
             /**
              * List shipments for an order
              */
-            list: (orderId: string, options?: RequestOptions) => Promise<ListResponse<StoreShipment>>;
+            list: (orderId: string, options?: RequestOptions) => Promise<ListResponse<Shipment>>;
             /**
              * Select a shipping rate for a shipment.
              * Returns the updated order with recalculated totals.
              */
             update: (orderId: string, shipmentId: string, params: {
                 selected_shipping_rate_id: string;
-            }, options?: RequestOptions) => Promise<StoreOrder>;
+            }, options?: RequestOptions) => Promise<Order>;
         };
     };
     readonly customer: {
         /**
          * Get current customer profile
          */
-        get: (options?: RequestOptions) => Promise<StoreCustomer>;
+        get: (options?: RequestOptions) => Promise<Customer>;
         /**
          * Update current customer profile
          */
@@ -338,7 +306,7 @@ declare class StoreClient {
             password_confirmation?: string;
             accepts_email_marketing?: boolean;
             phone?: string;
-        }, options?: RequestOptions) => Promise<StoreCustomer>;
+        }, options?: RequestOptions) => Promise<Customer>;
         /**
          * Nested resource: Addresses
          */
@@ -346,19 +314,19 @@ declare class StoreClient {
             /**
              * List customer addresses
              */
-            list: (params?: ListParams, options?: RequestOptions) => Promise<PaginatedResponse<StoreAddress>>;
+            list: (params?: ListParams, options?: RequestOptions) => Promise<PaginatedResponse<Address>>;
             /**
              * Get an address by ID
              */
-            get: (id: string, options?: RequestOptions) => Promise<StoreAddress>;
+            get: (id: string, options?: RequestOptions) => Promise<Address>;
             /**
              * Create an address
              */
-            create: (params: AddressParams, options?: RequestOptions) => Promise<StoreAddress>;
+            create: (params: AddressParams, options?: RequestOptions) => Promise<Address>;
             /**
              * Update an address
              */
-            update: (id: string, params: Partial<AddressParams>, options?: RequestOptions) => Promise<StoreAddress>;
+            update: (id: string, params: Partial<AddressParams>, options?: RequestOptions) => Promise<Address>;
             /**
              * Delete an address
              */
@@ -366,7 +334,7 @@ declare class StoreClient {
             /**
              * Mark an address as default billing or shipping
              */
-            markAsDefault: (id: string, kind: "billing" | "shipping", options?: RequestOptions) => Promise<StoreAddress>;
+            markAsDefault: (id: string, kind: "billing" | "shipping", options?: RequestOptions) => Promise<Address>;
         };
         /**
          * Nested resource: Credit Cards
@@ -375,11 +343,11 @@ declare class StoreClient {
             /**
              * List customer credit cards
              */
-            list: (params?: ListParams, options?: RequestOptions) => Promise<PaginatedResponse<StoreCreditCard>>;
+            list: (params?: ListParams, options?: RequestOptions) => Promise<PaginatedResponse<CreditCard>>;
             /**
              * Get a credit card by ID
              */
-            get: (id: string, options?: RequestOptions) => Promise<StoreCreditCard>;
+            get: (id: string, options?: RequestOptions) => Promise<CreditCard>;
             /**
              * Delete a credit card
              */
@@ -393,11 +361,11 @@ declare class StoreClient {
              * List customer gift cards
              * Returns gift cards associated with the current user, ordered by newest first
              */
-            list: (params?: ListParams, options?: RequestOptions) => Promise<PaginatedResponse<StoreGiftCard>>;
+            list: (params?: ListParams, options?: RequestOptions) => Promise<PaginatedResponse<GiftCard>>;
             /**
              * Get a gift card by ID
              */
-            get: (id: string, options?: RequestOptions) => Promise<StoreGiftCard>;
+            get: (id: string, options?: RequestOptions) => Promise<GiftCard>;
         };
         /**
          * Nested resource: Orders (customer order history)
@@ -406,7 +374,7 @@ declare class StoreClient {
             /**
              * List orders for the authenticated customer
              */
-            list: (params?: OrderListParams, options?: RequestOptions) => Promise<PaginatedResponse<StoreOrder>>;
+            list: (params?: OrderListParams, options?: RequestOptions) => Promise<PaginatedResponse<Order>>;
         };
         /**
          * Nested resource: Payment Setup Sessions (save payment methods for future use)
@@ -416,29 +384,30 @@ declare class StoreClient {
              * Create a payment setup session
              * Delegates to the payment gateway to initialize a setup flow for saving a payment method
              */
-            create: (params: CreatePaymentSetupSessionParams, options?: RequestOptions) => Promise<StorePaymentSetupSession>;
+            create: (params: CreatePaymentSetupSessionParams, options?: RequestOptions) => Promise<PaymentSetupSession>;
             /**
              * Get a payment setup session by ID
              */
-            get: (id: string, options?: RequestOptions) => Promise<StorePaymentSetupSession>;
+            get: (id: string, options?: RequestOptions) => Promise<PaymentSetupSession>;
             /**
              * Complete a payment setup session
              * Confirms the setup with the provider, resulting in a saved payment method
              */
-            complete: (id: string, params?: CompletePaymentSetupSessionParams, options?: RequestOptions) => Promise<StorePaymentSetupSession>;
+            complete: (id: string, params?: CompletePaymentSetupSessionParams, options?: RequestOptions) => Promise<PaymentSetupSession>;
         };
     };
     readonly wishlists: {
         /**
          * List wishlists
          */
-        list: (params?: ListParams, options?: RequestOptions) => Promise<PaginatedResponse<StoreWishlist>>;
+        list: (params?: ListParams, options?: RequestOptions) => Promise<PaginatedResponse<Wishlist>>;
         /**
          * Get a wishlist by ID
          */
         get: (id: string, params?: {
             expand?: string[];
-        }, options?: RequestOptions) => Promise<StoreWishlist>;
+            fields?: string[];
+        }, options?: RequestOptions) => Promise<Wishlist>;
         /**
          * Create a wishlist
          */
@@ -446,7 +415,7 @@ declare class StoreClient {
             name: string;
             is_private?: boolean;
             is_default?: boolean;
-        }, options?: RequestOptions) => Promise<StoreWishlist>;
+        }, options?: RequestOptions) => Promise<Wishlist>;
         /**
          * Update a wishlist
          */
@@ -454,7 +423,7 @@ declare class StoreClient {
             name?: string;
             is_private?: boolean;
             is_default?: boolean;
-        }, options?: RequestOptions) => Promise<StoreWishlist>;
+        }, options?: RequestOptions) => Promise<Wishlist>;
         /**
          * Delete a wishlist
          */
@@ -469,13 +438,13 @@ declare class StoreClient {
             create: (wishlistId: string, params: {
                 variant_id: string;
                 quantity?: number;
-            }, options?: RequestOptions) => Promise<StoreWishedItem>;
+            }, options?: RequestOptions) => Promise<WishedItem>;
             /**
              * Update a wishlist item
              */
             update: (wishlistId: string, itemId: string, params: {
                 quantity: number;
-            }, options?: RequestOptions) => Promise<StoreWishedItem>;
+            }, options?: RequestOptions) => Promise<WishedItem>;
             /**
              * Remove an item from a wishlist
              */
@@ -484,19 +453,11 @@ declare class StoreClient {
     };
 }
 
-declare class AdminClient {
-    /** @internal */
-    private readonly request;
-    constructor(request: RequestFn);
-}
-
-interface SpreeClientConfig {
+interface ClientConfig {
     /** Base URL of the Spree API (e.g., 'https://api.mystore.com') */
     baseUrl: string;
-    /** Publishable API key for Store API access (required for Store API) */
-    publishableKey?: string;
-    /** Secret API key for Admin API access (optional) */
-    secretKey?: string;
+    /** Publishable API key for Store API access */
+    publishableKey: string;
     /** Custom fetch implementation (optional, defaults to global fetch) */
     fetch?: typeof fetch;
     /** Retry configuration. Enabled by default. Pass false to disable. */
@@ -508,13 +469,7 @@ interface SpreeClientConfig {
     /** Default country ISO code for market resolution (e.g., 'FR') */
     country?: string;
 }
-declare class SpreeClient {
-    /** Store API — customer-facing endpoints (products, cart, checkout, account) */
-    readonly store: StoreClient;
-    /** Admin API — administrative endpoints (manage orders, products, settings) */
-    readonly admin: AdminClient;
-    private readonly _defaults;
-    constructor(config: SpreeClientConfig);
+interface Client extends StoreClient {
     /** Set default locale for all subsequent requests */
     setLocale(locale: string): void;
     /** Set default currency for all subsequent requests */
@@ -523,8 +478,16 @@ declare class SpreeClient {
     setCountry(country: string): void;
 }
 /**
- * Create a new Spree SDK client
+ * Create a new Spree Store SDK client.
+ *
+ * Returns a flat client with all store resources directly accessible:
+ * ```ts
+ * const client = createClient({ baseUrl: '...', publishableKey: '...' })
+ * client.products.list()
+ * client.cart.create()
+ * client.orders.get('order_1')
+ * ```
  */
-declare function createSpreeClient(config: SpreeClientConfig): SpreeClient;
+declare function createClient(config: ClientConfig): Client;
 
-export { AddLineItemParams, AddressParams, AdminClient, AuthTokens, CompletePaymentSessionParams, CompletePaymentSetupSessionParams, CreateCartParams, CreatePaymentSessionParams, CreatePaymentSetupSessionParams, ErrorResponse, ListParams, ListResponse, LoginCredentials, OrderListParams, PaginatedResponse, ProductFiltersParams, ProductFiltersResponse, ProductListParams, RegisterParams, type RequestOptions, type RetryConfig, SpreeClient, type SpreeClientConfig, SpreeError, StoreAddress, StoreClient, StoreCountry, StoreCreditCard, StoreCurrency, StoreCustomer, StoreGiftCard, StoreLocale, StoreMarket, StoreOrder, StorePayment, StorePaymentMethod, StorePaymentSession, StorePaymentSetupSession, StoreProduct, StoreShipment, StoreTaxon, StoreTaxonomy, StoreWishedItem, StoreWishlist, TaxonListParams, UpdateLineItemParams, UpdateOrderParams, UpdatePaymentSessionParams, createSpreeClient };
+export { AddLineItemParams, Address, type Client, type ClientConfig, CompletePaymentSessionParams, CompletePaymentSetupSessionParams, Country, CreateCartParams, CreatePaymentSessionParams, CreatePaymentSetupSessionParams, CreditCard, Currency, Customer, GiftCard, Locale, Market, Order, OrderListParams, Payment, PaymentMethod, PaymentSession, PaymentSetupSession, Product, ProductFiltersParams, ProductFiltersResponse, ProductListParams, Shipment, Address as StoreAddress, StoreClient, Country as StoreCountry, CreditCard as StoreCreditCard, Currency as StoreCurrency, Customer as StoreCustomer, GiftCard as StoreGiftCard, Locale as StoreLocale, Market as StoreMarket, Order as StoreOrder, Payment as StorePayment, PaymentMethod as StorePaymentMethod, PaymentSession as StorePaymentSession, PaymentSetupSession as StorePaymentSetupSession, Product as StoreProduct, Shipment as StoreShipment, Taxon as StoreTaxon, Taxonomy as StoreTaxonomy, WishedItem as StoreWishedItem, Wishlist as StoreWishlist, Taxon, TaxonListParams, Taxonomy, UpdateLineItemParams, UpdateOrderParams, UpdatePaymentSessionParams, WishedItem, Wishlist, createClient };