@01.software/sdk 0.29.0 → 0.30.1

package/dist/{server-Cv0Q4dPQ.d.ts → types-Dlb2mwpX.d.cts}

@@ -1,489 +1,11 @@
-import * as _tanstack_react_query from '@tanstack/react-query';
-import { QueryClient, InfiniteData, UseQueryResult } from '@tanstack/react-query';
-import { O as Order, d as Cart, e as CartItem, f as Product, l as OrderItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-Ci-ZA7aM.js';
-import { Sort, Where } from 'payload';
-import { Metadata } from 'next';
-import { C as CollectionType } from './types-BWq_WlbB.js';
-import { P as PublicCollection, d as ServerCollection } from './const-DAjQYNuM.js';
-
-declare function resolveApiUrl(): string;
-interface ClientConfig {
-    publishableKey: string;
-    /**
-     * Customer authentication options.
-     * Used to initialize CustomerAuth on Client.
-     */
-    customer?: {
-        /**
-         * Persist token in localStorage. Defaults to `true`.
-         * - `true` (default): uses key `'customer-token'`
-         * - `string`: uses the given string as localStorage key
-         * - `false`: disables persistence (token/onTokenChange used instead)
-         *
-         * Handles SSR safely (no-op on server).
-         * When enabled, `token` and `onTokenChange` are ignored.
-         */
-        persist?: boolean | string;
-        /** Initial token (e.g. from SSR cookie) */
-        token?: string;
-        /** Called when token changes (login/logout) — use to persist in localStorage/cookie */
-        onTokenChange?: (token: string | null) => void;
-    };
-}
-interface ClientServerConfig extends ClientConfig {
-    secretKey: string;
-}
-interface ClientMetadata {
-    userAgent?: string;
-    timestamp: number;
-}
-interface ClientState {
-    metadata: ClientMetadata;
-}
-interface PaginationMeta {
-    page: number;
-    limit: number;
-    totalDocs: number;
-    totalPages: number;
-    hasNextPage: boolean;
-    hasPrevPage: boolean;
-    pagingCounter: number;
-    prevPage: number | null;
-    nextPage: number | null;
-}
-/**
- * Payload CMS Find (List) Response
- * GET /api/{collection}
- */
-interface PayloadFindResponse<T = unknown> {
-    docs: T[];
-    totalDocs: number;
-    limit: number;
-    totalPages: number;
-    page: number;
-    pagingCounter: number;
-    hasPrevPage: boolean;
-    hasNextPage: boolean;
-    prevPage: number | null;
-    nextPage: number | null;
-}
-/**
- * Payload CMS Create/Update Response
- * POST /api/{collection}
- * PATCH /api/{collection}/{id}
- */
-interface PayloadMutationResponse<T = unknown> {
-    message: string;
-    doc: T;
-    errors?: unknown[];
-}
-/**
- * Do NOT replace with `Pick<FindOptions>` from `payload`. Payload's generic
- * types (`JoinQuery<TSlug>`, `PopulateType`) depend on `PayloadTypes` module
- * augmentation; external SDK consumers who skip that get degenerate types
- * (`never` / `{}`). Only non-generic `Sort`/`Where` are safe to import.
- * Excluded vs native: Local-API-only fields, `locale`/`fallbackLocale`.
- */
-interface ApiQueryOptions {
-    page?: number;
-    limit?: number;
-    sort?: Sort;
-    /**
-     * Filter documents. Id-based relation filters (`where: { product: { equals: id } }`) are the
-     * most reliable pattern. Dotted-path relation filters (`where: { 'product.slug': { equals } }`)
-     * are Payload-native but may silently return empty when access control restricts the related
-     * document or when the relation is polymorphic. String shorthand (`where: { slug: 'x' }`)
-     * silently matches nothing — always use `{ slug: { equals: 'x' } }`.
-     */
-    where?: Where;
-    /**
-     * Controls how deeply relationship fields are populated. This is the primary control for
-     * populating relationships like `category`, `images`, `brand`. The configured Payload default
-     * applies when unset.
-     */
-    depth?: number;
-    select?: Record<string, boolean>;
-    /**
-     * Controls which fields are returned for already-populated relationships, keyed by collection
-     * slug. Does NOT control which relationships to populate — that is `depth`.
-     *
-     * @example
-     * // depth: 2 populates category; populate trims which fields come back
-     * populate: { categories: { title: true, slug: true } }
-     */
-    populate?: Record<string, boolean | Record<string, boolean>>;
-    /**
-     * Controls Payload `type: 'join'` virtual reverse-relation fields only (pagination, sort,
-     * filter, count per join field, or `false` to disable all join-field population).
-     *
-     * Does NOT populate normal relationship fields like `category`, `images`, or `brand`.
-     * For normal relationship population use `depth` (and optionally `populate` for field
-     * selection).
-     *
-     * Pass `joins: false` to disable all join-field population — useful for lightweight list
-     * queries where join fields are not needed.
-     *
-     * @example
-     * // `article-authors` has a `type: 'join'` field `articles` (reverse-relation)
-     * joins: { articles: { limit: 10, sort: '-publishedAt' } }
-     *
-     * // depth: 2 populates product.category — joins has no effect on this
-     * depth: 2
-     *
-     * // Disable all join-field population
-     * joins: false
-     */
-    joins?: Record<string, {
-        limit?: number;
-        page?: number;
-        sort?: string;
-        where?: Where;
-        count?: boolean;
-    } | false> | false;
-    /** Set to `false` to skip the count query — returns docs without totalDocs/totalPages */
-    pagination?: boolean;
-    /** Include draft versions (access control still applies on the server) */
-    draft?: boolean;
-    /** Include soft-deleted documents (requires `trash` enabled on the collection) */
-    trash?: boolean;
-}
-interface DebugConfig {
-    logRequests?: boolean;
-    logResponses?: boolean;
-    logErrors?: boolean;
-}
-interface RetryConfig {
-    maxRetries?: number;
-    retryableStatuses?: number[];
-    retryDelay?: (attempt: number) => number;
-}
-type DeepPartial<T> = {
-    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
-};
-type ExtractArrayType<T> = T extends (infer U)[] ? U : never;
-
-interface GenerateMetadataOptions {
-    siteName?: string;
-}
-
-declare class SDKError extends Error {
-    readonly code: string;
-    readonly status?: number;
-    readonly details?: unknown;
-    readonly userMessage?: string;
-    readonly suggestion?: string;
-    readonly requestId?: string;
-    constructor(code: string, message: string, status?: number, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string);
-    getUserMessage(): string;
-    toJSON(): {
-        requestId?: string | undefined;
-        name: string;
-        code: string;
-        message: string;
-        status: number | undefined;
-        details: unknown;
-        userMessage: string | undefined;
-        suggestion: string | undefined;
-    };
-}
-declare class NetworkError extends SDKError {
-    constructor(message: string, status?: number, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class ValidationError extends SDKError {
-    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string, status?: number);
-}
-declare class ApiError extends SDKError {
-    constructor(message: string, status: number, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class ConfigError extends SDKError {
-    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class TimeoutError extends SDKError {
-    constructor(message?: string, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class GoneError extends SDKError {
-    constructor(message?: string, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class ServiceUnavailableError extends SDKError {
-    readonly retryAfter?: number;
-    constructor(message?: string, retryAfter?: number, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class UsageLimitError extends SDKError {
-    readonly usage: {
-        limit: number;
-        current: number;
-        remaining: number;
-    };
-    constructor(message: string, usage: {
-        limit: number;
-        current: number;
-        remaining: number;
-    }, details?: unknown, userMessage?: string, suggestion?: string);
-    toJSON(): {
-        usage: {
-            limit: number;
-            current: number;
-            remaining: number;
-        };
-        requestId?: string | undefined;
-        name: string;
-        code: string;
-        message: string;
-        status: number | undefined;
-        details: unknown;
-        userMessage: string | undefined;
-        suggestion: string | undefined;
-    };
-}
-declare class AuthError extends SDKError {
-    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string);
-}
-declare class PermissionError extends SDKError {
-    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string);
-}
-declare class NotFoundError extends SDKError {
-    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string);
-}
-declare class ConflictError extends SDKError {
-    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string);
-}
-declare class RateLimitError extends SDKError {
-    readonly retryAfter?: number;
-    constructor(message: string, retryAfter?: number, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string);
-}
-declare function isSDKError(error: unknown): error is SDKError;
-declare function isNetworkError(error: unknown): error is NetworkError;
-declare function isValidationError(error: unknown): error is ValidationError;
-declare function isApiError(error: unknown): error is ApiError;
-declare function isConfigError(error: unknown): error is ConfigError;
-declare function isTimeoutError(error: unknown): error is TimeoutError;
-declare function isGoneError(error: unknown): error is GoneError;
-declare function isServiceUnavailableError(error: unknown): error is ServiceUnavailableError;
-declare function isUsageLimitError(error: unknown): error is UsageLimitError;
-declare function isAuthError(error: unknown): error is AuthError;
-declare function isPermissionError(error: unknown): error is PermissionError;
-declare function isNotFoundError(error: unknown): error is NotFoundError;
-declare function isConflictError(error: unknown): error is ConflictError;
-declare function isRateLimitError(error: unknown): error is RateLimitError;
-declare const createAuthError: (message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string) => AuthError;
-declare const createPermissionError: (message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string) => PermissionError;
-declare const createNotFoundError: (message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string) => NotFoundError;
-declare const createConflictError: (message: string, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string) => ConflictError;
-declare const createRateLimitError: (message: string, retryAfter?: number, details?: unknown, userMessage?: string, suggestion?: string, requestId?: string) => RateLimitError;
-
-interface FetchOptions extends RequestInit {
-    publishableKey?: string;
-    secretKey?: string;
-    customerToken?: string;
-    timeout?: number;
-    debug?: boolean | DebugConfig;
-    retry?: RetryConfig;
-    /** Called on 401 when customerToken is set and reason=token_expired. Return a new token to retry, or null to fail. */
-    onUnauthorized?: () => Promise<string | null>;
-}
-
-declare class HttpClient {
-    protected publishableKey: string;
-    protected secretKey?: string;
-    private getCustomerToken?;
-    private onUnauthorized?;
-    private onRequestId?;
-    constructor(publishableKey: string, secretKey?: string, getCustomerToken?: () => string | null, onUnauthorized?: () => Promise<string | null>, onRequestId?: (id: string | null) => void);
-    protected get defaultOptions(): FetchOptions;
-    protected fetchWithTracking(url: string, opts: FetchOptions): Promise<Response>;
-    protected buildUrl(endpoint: string, options?: ApiQueryOptions): string;
-    protected assertJsonResponse(response: Response): void;
-    /**
-     * Parse Payload CMS find response (list query)
-     * Returns native Payload response structure
-     */
-    protected parseFindResponse<T>(response: Response): Promise<PayloadFindResponse<T>>;
-    /**
-     * Parse Payload CMS mutation response (create/update)
-     * Returns native Payload response structure
-     */
-    protected parseMutationResponse<T>(response: Response): Promise<PayloadMutationResponse<T>>;
-    /**
-     * Parse Payload CMS document response (findById/delete)
-     * Returns document directly without wrapper
-     */
-    protected parseDocumentResponse<T>(response: Response): Promise<T>;
-}
-
-declare class CollectionClient<TCollection extends string = PublicCollection> extends HttpClient {
-    from<T extends TCollection>(collection: T): CollectionQueryBuilder<T>;
-    /**
-     * Find documents (list query)
-     * GET /api/{collection}
-     */
-    requestFind<T = unknown>(endpoint: string, options?: ApiQueryOptions): Promise<PayloadFindResponse<T>>;
-    /**
-     * Find-like response from a custom endpoint
-     * POST /api/...custom-endpoint
-     */
-    requestFindEndpoint<T = unknown>(endpoint: string, data?: unknown): Promise<PayloadFindResponse<T>>;
-    /**
-     * Find document by ID
-     * GET /api/{collection}/{id}
-     */
-    requestFindById<T = unknown>(endpoint: string, options?: ApiQueryOptions): Promise<T>;
-    /**
-     * Create document
-     * POST /api/{collection}
-     */
-    requestCreate<T = unknown>(endpoint: string, data?: unknown): Promise<PayloadMutationResponse<T>>;
-    /**
-     * Update document
-     * PATCH /api/{collection}/{id}
-     */
-    requestUpdate<T = unknown>(endpoint: string, data?: unknown): Promise<PayloadMutationResponse<T>>;
-    /**
-     * Count documents
-     * GET /api/{collection}/count
-     */
-    requestCount(endpoint: string, options?: ApiQueryOptions): Promise<{
-        totalDocs: number;
-    }>;
-    /**
-     * Update multiple documents (bulk update)
-     * PATCH /api/{collection}
-     */
-    requestUpdateMany<T = unknown>(endpoint: string, data: {
-        where?: unknown;
-        data: unknown;
-    }): Promise<PayloadFindResponse<T>>;
-    /**
-     * Delete document
-     * DELETE /api/{collection}/{id}
-     */
-    requestDelete<T = unknown>(endpoint: string): Promise<T>;
-    /**
-     * Delete multiple documents (bulk delete)
-     * DELETE /api/{collection}
-     */
-    requestDeleteMany<T = unknown>(endpoint: string, data: {
-        where?: unknown;
-    }): Promise<PayloadFindResponse<T>>;
-    /**
-     * Create document with file upload
-     * POST /api/{collection} (multipart/form-data)
-     */
-    requestCreateWithFile<T = unknown>(endpoint: string, data: unknown, file: File | Blob, filename?: string): Promise<PayloadMutationResponse<T>>;
-    /**
-     * Update document with file upload
-     * PATCH /api/{collection}/{id} (multipart/form-data)
-     */
-    requestUpdateWithFile<T = unknown>(endpoint: string, data: unknown, file: File | Blob, filename?: string): Promise<PayloadMutationResponse<T>>;
-}
-declare class ServerCollectionClient extends CollectionClient<ServerCollection> {
-    from<T extends ServerCollection>(collection: T): ServerCollectionQueryBuilder<T>;
-}
-declare class ReadOnlyCollectionClient extends HttpClient {
-    from<T extends PublicCollection>(collection: T): ReadOnlyQueryBuilder<T>;
-    requestFind<T = unknown>(endpoint: string, options?: ApiQueryOptions): Promise<PayloadFindResponse<T>>;
-    requestFindById<T = unknown>(endpoint: string, options?: ApiQueryOptions): Promise<T>;
-    requestCount(endpoint: string, options?: ApiQueryOptions): Promise<{
-        totalDocs: number;
-    }>;
-}
-
-type ReadOnlyCollectionApi = Pick<CollectionClient, 'requestFind' | 'requestFindById' | 'requestCount'>;
-/**
- * Read-only subset of CollectionQueryBuilder.
- * Client.from() returns this type to prevent write operations at compile time.
- */
-type ReadOnlyQueryBuilder<T extends PublicCollection> = ReadOnlyCollectionQueryBuilder<T>;
-declare class ReadOnlyCollectionQueryBuilder<T extends PublicCollection> {
-    private api;
-    private collection;
-    constructor(api: ReadOnlyCollectionApi, collection: T);
-    find(options?: ApiQueryOptions): Promise<PayloadFindResponse<CollectionType<T>>>;
-    findById(id: string | number, options?: ApiQueryOptions): Promise<CollectionType<T>>;
-    count(options?: ApiQueryOptions): Promise<{
-        totalDocs: number;
-    }>;
-    findMetadata(options?: ApiQueryOptions, metadataOptions?: GenerateMetadataOptions): Promise<Metadata | null>;
-    findMetadataById(id: string, metadataOptions?: GenerateMetadataOptions): Promise<Metadata>;
-}
-declare class CollectionQueryBuilder<T extends string> {
-    private api;
-    private collection;
-    constructor(api: CollectionClient, collection: T);
-    /**
-     * Find documents (list query)
-     * GET /api/{collection}
-     * @returns Payload CMS find response with docs array and pagination
-     */
-    find(options?: ApiQueryOptions): Promise<PayloadFindResponse<CollectionType<T>>>;
-    /**
-     * Find document by ID
-     * GET /api/{collection}/{id}
-     * @returns Document object directly (no wrapper)
-     */
-    findById(id: string | number, options?: ApiQueryOptions): Promise<CollectionType<T>>;
-    /**
-     * Create a new document
-     * POST /api/{collection}
-     * @returns Payload CMS mutation response with doc and message
-     */
-    create(data: Partial<CollectionType<T>>, options?: {
-        file?: File | Blob;
-        filename?: string;
-    }): Promise<PayloadMutationResponse<CollectionType<T>>>;
-    /**
-     * Update a document by ID
-     * PATCH /api/{collection}/{id}
-     * @returns Payload CMS mutation response with doc and message
-     */
-    update(id: string, data: Partial<CollectionType<T>>, options?: {
-        file?: File | Blob;
-        filename?: string;
-    }): Promise<PayloadMutationResponse<CollectionType<T>>>;
-    /**
-     * Count documents
-     * GET /api/{collection}/count
-     * @returns Count response with totalDocs
-     */
-    count(options?: ApiQueryOptions): Promise<{
-        totalDocs: number;
-    }>;
-    /**
-     * Find first matching document and return its Next.js Metadata.
-     * Applies depth: 1 (SEO image populate) and limit: 1 automatically.
-     * @returns Metadata or null if no document matches
-     */
-    findMetadata(options?: ApiQueryOptions, metadataOptions?: GenerateMetadataOptions): Promise<Metadata | null>;
-    /**
-     * Find document by ID and return its Next.js Metadata.
-     * Applies depth: 1 (SEO image populate) automatically.
-     * @returns Metadata (throws on 404)
-     */
-    findMetadataById(id: string, metadataOptions?: GenerateMetadataOptions): Promise<Metadata>;
-    /**
-     * Update multiple documents (bulk update)
-     * PATCH /api/{collection}
-     * @returns Payload CMS find response with updated docs
-     */
-    updateMany(where: ApiQueryOptions['where'], data: Partial<CollectionType<T>>): Promise<PayloadFindResponse<CollectionType<T>>>;
-    /**
-     * Delete a document by ID
-     * DELETE /api/{collection}/{id}
-     * @returns Deleted document object directly (no wrapper)
-     */
-    remove(id: string): Promise<CollectionType<T>>;
-    /**
-     * Delete multiple documents (bulk delete)
-     * DELETE /api/{collection}
-     * @returns Payload CMS find response with deleted docs
-     */
-    removeMany(where: ApiQueryOptions['where']): Promise<PayloadFindResponse<CollectionType<T>>>;
-}
-declare class ServerCollectionQueryBuilder<T extends ServerCollection> extends CollectionQueryBuilder<T> {
-}
+import { P as PublicCollection } from './const-VZuk2tWc.cjs';
+import { C as CollectionType } from './types-BwT0eeaz.cjs';
+import { O as Order, h as Cart, i as CartItem, d as Product, l as OrderItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-DPjO_IbQ.cjs';
 
 interface CommunityClientOptions {
     publishableKey?: string;
     secretKey?: string;
+    apiUrl?: string;
     customerToken?: string | (() => string | null);
     onUnauthorized?: () => Promise<string | null>;
     onRequestId?: (id: string | null) => void;
@@ -551,6 +73,7 @@ interface PaginatedResponse<T> {
 declare class CommunityClient {
     private readonly publishableKey;
     private readonly secretKey?;
+    private readonly apiUrl?;
     private readonly customerToken?;
     private readonly onUnauthorized?;
     private readonly onRequestId?;
@@ -652,6 +175,7 @@ declare class CommunityClient {
 interface ServerApiOptions {
     publishableKey?: string;
     secretKey: string;
+    apiUrl?: string;
     onRequestId?: (id: string | null) => void;
 }
 interface RequestOptions {
@@ -661,39 +185,12 @@ interface RequestOptions {
 declare abstract class BaseApi {
     protected readonly publishableKey: string;
     protected readonly secretKey: string;
+    protected readonly apiUrl?: string;
     protected readonly onRequestId?: (id: string | null) => void;
     constructor(apiName: string, options: ServerApiOptions);
     protected request<T>(endpoint: string, body: unknown, options?: RequestOptions): Promise<T>;
 }
 
-type ModerationApiOptions = ServerApiOptions;
-interface CommunityBan {
-    id: string;
-    customer: string;
-    isPermanent?: boolean;
-    bannedUntil?: string;
-    reason?: string;
-    createdAt?: string;
-    updatedAt?: string;
-    [key: string]: unknown;
-}
-type BanCustomerParams = {
-    customerId: string;
-    isPermanent?: boolean;
-    bannedUntil?: string;
-    reason?: string;
-};
-type UnbanCustomerParams = {
-    customerId: string;
-};
-declare class ModerationApi extends BaseApi {
-    constructor(options: ModerationApiOptions);
-    banCustomer(params: BanCustomerParams): Promise<CommunityBan>;
-    unbanCustomer(params: UnbanCustomerParams): Promise<{
-        success: true;
-    }>;
-}
-
 interface CustomerAuthResponse {
     token: string;
     customer: CustomerProfile;
@@ -768,7 +265,7 @@ declare class CustomerAuth {
     private token;
     private onTokenChange?;
     private refreshPromise;
-    constructor(publishableKey: string, options?: CustomerAuthOptions);
+    constructor(publishableKey: string, options?: CustomerAuthOptions, apiUrl?: string);
     /**
      * Register a new customer account
      */
@@ -836,6 +333,7 @@ declare class CustomerAuth {
 interface CartApiOptions {
     publishableKey?: string;
     secretKey?: string;
+    apiUrl?: string;
     customerToken?: string | (() => string | null);
     onUnauthorized?: () => Promise<string | null>;
     onRequestId?: (id: string | null) => void;
@@ -867,6 +365,7 @@ type ClearCartParams = {
 declare class CartApi {
     private readonly publishableKey;
     private readonly secretKey?;
+    private readonly apiUrl?;
     private readonly customerToken?;
     private readonly onUnauthorized?;
     private readonly onRequestId?;
@@ -1006,21 +505,31 @@ type NormalizedProductSelection = {
     valueIds: string[];
     variantId: string | null;
 };
-type LegacyProductSelectionParamEvent = {
+type CompatibilityProductSelectionParamEvent = {
     optionId: string;
     optionSlug: string;
     valueSlug: string;
     searchParam: string;
 };
+type LegacyProductSelectionParamEvent = CompatibilityProductSelectionParamEvent;
 type ProductSelectionCodecOptions = {
+    onCompatibilityOptionIdParam?: (event: CompatibilityProductSelectionParamEvent) => void;
     onLegacyOptionIdParam?: (event: LegacyProductSelectionParamEvent) => void;
 };
+type ProductSelectionResolutionContext = {
+    detail?: Pick<ProductDetail, 'images' | 'listing'>;
+    images?: ProductDetail['images'];
+    listing?: ProductDetail['listing'];
+};
 type ProductSelectionAvailableValue = {
     valueId: string;
     value: string;
     slug: string;
     selected: boolean;
     available: boolean;
+    availableForSale: boolean;
+    isUnlimited: boolean;
+    availableStock: number | null;
     swatchColor?: string | null;
     thumbnail?: MediaValue;
     images?: MediaValue[] | null;
@@ -1066,13 +575,44 @@ declare function normalizeSelectedValueIds<TVariant extends ProductVariantShape
 declare function getAvailableOptionValues<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, optionId: string, selectedValueIds: Iterable<unknown>): ProductOptionMatrixValue[];
 declare function resolveVariantForSelection<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): ProductOptionMatrixVariant<TVariant> | undefined;
 declare function normalizeProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
+declare function normalizeProductSelectionFromMatrix(matrix: ProductOptionMatrix<ProductDetailVariant>, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
 declare function parseProductSelection(detail: ProductDetail, search: string | URLSearchParams | URL | null | undefined, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
 declare function stringifyProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): string;
 declare function createProductSelectionCodec(detail: ProductDetail, options?: ProductSelectionCodecOptions): {
     parse: (search: string | URLSearchParams | URL | null | undefined) => NormalizedProductSelection;
     stringify: (selection?: ProductSelectionInput) => string;
 };
+declare function resolveProductSelectionFromMatrix(matrix: ProductOptionMatrix<ProductDetailVariant>, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions, context?: ProductSelectionResolutionContext): ProductSelectionResolution;
 declare function resolveProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): ProductSelectionResolution;
+type ProductDetailImageMedia = Extract<ProductDetailMedia, {
+    id?: string | number | null;
+    url?: string | null;
+}>;
+declare function getProductSelectionImages(resolution: Pick<ProductSelectionResolution, 'media'>): ProductDetailImageMedia[];
+type ProductHrefProduct = ProductDetail | {
+    slug?: string | null;
+    product?: {
+        slug?: string | null;
+    } | null;
+};
+type ProductHrefGroup = {
+    optionId?: string | number | null;
+    optionSlug?: string | null;
+    optionValueId?: string | number | null;
+    optionValueSlug?: string | null;
+    variantId?: string | number | null;
+    listing?: {
+        selectionHintVariant?: string | number | null;
+    } | null;
+};
+type ProductHrefOptions = {
+    basePath?: string;
+    detail?: ProductDetail;
+    matrix?: ProductOptionMatrix<ProductDetailVariant>;
+    selection?: ProductSelectionInput;
+    trailingSlash?: boolean;
+};
+declare function buildProductHref(product: ProductHrefProduct, group?: ProductHrefGroup | null, options?: ProductHrefOptions): string;
 declare function buildProductListingProjection(product: ProductListingProductShape | null | undefined, variants: ProductVariantShape[]): ProductListingProjection;
 /**
  * Builds product-first listing groups for one primary option.
@@ -1485,17 +1025,19 @@ declare class OrderApi extends BaseApi {
     updateReturn(params: UpdateReturnParams): Promise<Return>;
 }
 
-interface ServerCommerceClientOptions {
-    publishableKey?: string;
-    secretKey: string;
+interface CommerceClientOptions {
+    publishableKey: string;
+    apiUrl?: string;
+    customerToken: () => string | null;
+    onUnauthorized?: () => Promise<string | null>;
     onRequestId?: (id: string | null) => void;
+    customerAuth: CustomerAuth;
 }
-declare class ServerCommerceClient {
+declare class CommerceClient {
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
         listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
         detail: (params: ProductDetailParams) => Promise<ProductDetail | null>;
-        upsert: (params: ProductUpsertParams) => Promise<ProductUpsertResponse>;
     };
     readonly cart: {
         get: (cartId: string) => Promise<Cart>;
@@ -1512,19 +1054,11 @@ declare class ServerCommerceClient {
     };
     readonly orders: {
         checkout: (params: CheckoutParams) => Promise<Order>;
-        create: (params: CreateOrderParams) => Promise<Order>;
-        update: (params: UpdateOrderParams) => Promise<Order>;
-        updateTransaction: (params: UpdateTransactionParams) => Promise<Transaction>;
-        confirmPayment: (params: ConfirmPaymentParams) => Promise<ConfirmPaymentResponse>;
-        createFulfillment: (params: CreateFulfillmentParams) => Promise<Fulfillment>;
-        updateFulfillment: (params: UpdateFulfillmentParams) => Promise<Fulfillment>;
-        bulkImportFulfillments: (params: BulkImportFulfillmentsParams) => Promise<BulkImportFulfillmentsResponse>;
-        createReturn: (params: CreateReturnParams) => Promise<Return>;
-        updateReturn: (params: UpdateReturnParams) => Promise<Return>;
-        returnWithRefund: (params: ReturnWithRefundParams) => Promise<{
-            return: Return;
-            transaction: Transaction | null;
-        }>;
+        listMine: (options?: {
+            page?: number;
+            limit?: number;
+            status?: string;
+        }) => Promise<PayloadFindResponse<Order>>;
     };
     readonly discounts: {
         validate: (params: ValidateDiscountParams) => Promise<ValidateDiscountResult>;
@@ -1532,231 +1066,184 @@ declare class ServerCommerceClient {
     readonly shipping: {
         calculate: (params: CalculateShippingParams) => Promise<CalculateShippingResult>;
     };
-    constructor(options: ServerCommerceClientOptions);
+    constructor(options: CommerceClientOptions);
 }
 
-interface CollectionQueryParams<T extends PublicCollection> {
-    collection: T;
-    options?: ApiQueryOptions;
-}
-interface CollectionDetailQueryParams<T extends PublicCollection> {
-    collection: T;
-    id: string;
-    options?: ApiQueryOptions;
-}
-interface CollectionInfiniteQueryParams<T extends PublicCollection> {
-    collection: T;
-    options?: Omit<ApiQueryOptions, 'page'>;
-    pageSize?: number;
+/**
+ * Customer namespace. Currently exposes .auth; reserved for future customer-
+ * scoped capabilities (addresses, preferences, etc.).
+ */
+declare class CustomerNamespace {
+    readonly auth: CustomerAuth;
+    constructor(publishableKey: string, options?: CustomerAuthOptions, apiUrl?: string);
 }
-interface QueryOptions<TQueryFnData = unknown, TData = TQueryFnData> {
-    enabled?: boolean;
-    staleTime?: number;
-    gcTime?: number;
-    refetchOnWindowFocus?: boolean;
-    refetchOnMount?: boolean | 'always';
-    refetchInterval?: number | false;
-    retry?: boolean | number;
-    select?: (data: TQueryFnData) => TData;
-    placeholderData?: TQueryFnData | ((previousData: TData | undefined) => TQueryFnData | undefined);
-    initialData?: TQueryFnData | (() => TQueryFnData);
-    initialDataUpdatedAt?: number | (() => number | undefined);
+
+interface ClientConfig {
+    publishableKey: string;
+    /** API base URL for staging, self-hosted, preview, or proxy deployments. */
+    apiUrl?: string;
+    /**
+     * Customer authentication options.
+     * Used to initialize CustomerAuth on Client.
+     */
+    customer?: {
+        /**
+         * Persist token in localStorage. Defaults to `true`.
+         * - `true` (default): uses key `'customer-token'`
+         * - `string`: uses the given string as localStorage key
+         * - `false`: disables persistence (token/onTokenChange used instead)
+         *
+         * Handles SSR safely (no-op on server).
+         * When enabled, `token` and `onTokenChange` are ignored.
+         */
+        persist?: boolean | string;
+        /** Initial token (e.g. from SSR cookie) */
+        token?: string;
+        /** Called when token changes (login/logout) — use to persist in localStorage/cookie */
+        onTokenChange?: (token: string | null) => void;
+    };
 }
-type SuspenseQueryOptions<TQueryFnData = unknown, TData = TQueryFnData> = Omit<QueryOptions<TQueryFnData, TData>, 'enabled' | 'placeholderData'>;
-interface InfiniteQueryOptions<TQueryFnData = unknown, TData = InfiniteData<TQueryFnData>> {
-    enabled?: boolean;
-    staleTime?: number;
-    gcTime?: number;
-    refetchOnWindowFocus?: boolean;
-    refetchOnMount?: boolean | 'always';
-    refetchInterval?: number | false;
-    retry?: boolean | number;
-    select?: (data: InfiniteData<TQueryFnData>) => TData;
+interface ClientServerConfig extends ClientConfig {
+    secretKey: string;
 }
-type SuspenseInfiniteQueryOptions<TQueryFnData = unknown, TData = InfiniteData<TQueryFnData>> = Omit<InfiniteQueryOptions<TQueryFnData, TData>, 'enabled'>;
-interface MutationCallbacks$1<TData> {
-    onSuccess?: (data: TData) => void;
-    onError?: (error: SDKError) => void;
-    onSettled?: () => void;
+interface ClientMetadata {
+    userAgent?: string;
+    timestamp: number;
 }
-declare class CollectionHooks {
-    protected queryClient: QueryClient;
-    protected collectionClient: CollectionClient;
-    constructor(queryClient: QueryClient, collectionClient: CollectionClient);
-    useQuery<T extends PublicCollection, TData = PayloadFindResponse<CollectionType<T>>>(params: CollectionQueryParams<T>, options?: QueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): _tanstack_react_query.UseQueryResult<_tanstack_react_query.NoInfer<TData>, Error>;
-    useSuspenseQuery<T extends PublicCollection, TData = PayloadFindResponse<CollectionType<T>>>(params: CollectionQueryParams<T>, options?: SuspenseQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): _tanstack_react_query.UseSuspenseQueryResult<TData, Error>;
-    useQueryById<T extends PublicCollection, TData = CollectionType<T>>(params: CollectionDetailQueryParams<T>, options?: QueryOptions<CollectionType<T>, TData>): _tanstack_react_query.UseQueryResult<_tanstack_react_query.NoInfer<TData>, Error>;
-    useSuspenseQueryById<T extends PublicCollection, TData = CollectionType<T>>(params: CollectionDetailQueryParams<T>, options?: SuspenseQueryOptions<CollectionType<T>, TData>): _tanstack_react_query.UseSuspenseQueryResult<TData, Error>;
-    useInfiniteQuery<T extends PublicCollection, TData = InfiniteData<PayloadFindResponse<CollectionType<T>>>>(params: CollectionInfiniteQueryParams<T>, options?: InfiniteQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): _tanstack_react_query.UseInfiniteQueryResult<TData, Error>;
-    useSuspenseInfiniteQuery<T extends PublicCollection, TData = InfiniteData<PayloadFindResponse<CollectionType<T>>>>(params: CollectionInfiniteQueryParams<T>, options?: SuspenseInfiniteQueryOptions<PayloadFindResponse<CollectionType<T>>, TData>): _tanstack_react_query.UseSuspenseInfiniteQueryResult<TData, Error>;
-    prefetchQuery<T extends PublicCollection>(params: CollectionQueryParams<T>, options?: {
-        staleTime?: number;
-    }): Promise<void>;
-    prefetchQueryById<T extends PublicCollection>(params: CollectionDetailQueryParams<T>, options?: {
-        staleTime?: number;
-    }): Promise<void>;
-    prefetchInfiniteQuery<T extends PublicCollection>(params: CollectionInfiniteQueryParams<T>, options?: {
-        pages?: number;
-        staleTime?: number;
-    }): Promise<void>;
-    useCreate<T extends PublicCollection>(params: {
-        collection: T;
-    }, options?: MutationCallbacks$1<PayloadMutationResponse<CollectionType<T>>>): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, SDKError, {
-        data: Partial<CollectionType<T>>;
-        file?: File | Blob;
-        filename?: string;
-    }, unknown>;
-    useUpdate<T extends PublicCollection>(params: {
-        collection: T;
-    }, options?: MutationCallbacks$1<PayloadMutationResponse<CollectionType<T>>>): _tanstack_react_query.UseMutationResult<PayloadMutationResponse<CollectionType<T>>, SDKError, {
-        id: string;
-        data: Partial<CollectionType<T>>;
-        file?: File | Blob;
-        filename?: string;
-    }, unknown>;
-    useRemove<T extends PublicCollection>(params: {
-        collection: T;
-    }, options?: MutationCallbacks$1<CollectionType<T>>): _tanstack_react_query.UseMutationResult<CollectionType<T>, SDKError, string, unknown>;
-    invalidateQueries<T extends PublicCollection>(collection: T, type?: 'list' | 'detail' | 'infinite'): Promise<void>;
-    getQueryData<T extends PublicCollection>(collection: T, type: 'list', options?: ApiQueryOptions): PayloadFindResponse<CollectionType<T>> | undefined;
-    getQueryData<T extends PublicCollection>(collection: T, type: 'detail', id: string, options?: ApiQueryOptions): CollectionType<T> | null | undefined;
-    setQueryData<T extends PublicCollection>(collection: T, type: 'list', data: PayloadFindResponse<CollectionType<T>>, options?: ApiQueryOptions): void;
-    setQueryData<T extends PublicCollection>(collection: T, type: 'detail', id: string, data: CollectionType<T> | null, options?: ApiQueryOptions): void;
+interface ClientState {
+    metadata: ClientMetadata;
 }
-
-interface MutationCallbacks<TData> {
-    onSuccess?: (data: TData) => void;
-    onError?: (error: SDKError) => void;
-    onSettled?: () => void;
+/**
+ * Payload CMS Find (List) Response
+ * GET /api/{collection}
+ */
+interface PayloadFindResponse<T = unknown> {
+    docs: T[];
+    totalDocs: number;
+    limit: number;
+    totalPages: number;
+    page: number;
+    pagingCounter: number;
+    hasPrevPage: boolean;
+    hasNextPage: boolean;
+    prevPage: number | null;
+    nextPage: number | null;
 }
-declare class CustomerHooks {
-    private queryClient;
-    private customerAuth?;
-    constructor(queryClient: QueryClient, customerAuth?: CustomerAuth);
-    private ensureCustomerAuth;
-    private invalidateMe;
-    useCustomerMe(options?: {
-        enabled?: boolean;
-        staleTime?: number;
-        gcTime?: number;
-        refetchOnWindowFocus?: boolean;
-        refetchOnMount?: boolean | 'always';
-        refetchInterval?: number | false;
-        retry?: boolean | number;
-    }): _tanstack_react_query.UseQueryResult<CustomerProfile | null, Error>;
-    useCustomerLogin(options?: MutationCallbacks<CustomerAuthResponse>): _tanstack_react_query.UseMutationResult<CustomerAuthResponse, SDKError, CustomerLoginData, unknown>;
-    useCustomerRegister(options?: MutationCallbacks<{
-        customer: CustomerProfile;
-    }>): _tanstack_react_query.UseMutationResult<CustomerRegisterResponse, SDKError, CustomerRegisterData, unknown>;
-    useCustomerLogout(options?: MutationCallbacks<void>): _tanstack_react_query.UseMutationResult<void, SDKError, void, unknown>;
-    useCustomerForgotPassword(options?: MutationCallbacks<void>): _tanstack_react_query.UseMutationResult<void, SDKError, string, unknown>;
-    useCustomerResetPassword(options?: MutationCallbacks<void>): _tanstack_react_query.UseMutationResult<void, SDKError, {
-        token: string;
-        password: string;
-    }, unknown>;
-    useCustomerRefreshToken(options?: MutationCallbacks<CustomerRefreshResponse>): _tanstack_react_query.UseMutationResult<CustomerRefreshResponse, SDKError, unknown, unknown>;
-    useCustomerUpdateProfile(options?: MutationCallbacks<CustomerProfile>): _tanstack_react_query.UseMutationResult<CustomerProfile, SDKError, UpdateProfileData, unknown>;
-    useCustomerChangePassword(options?: MutationCallbacks<void>): _tanstack_react_query.UseMutationResult<void, SDKError, {
-        currentPassword: string;
-        newPassword: string;
-    }, unknown>;
-    invalidateCustomerQueries(): Promise<void>;
-    getCustomerData(): CustomerProfile | null | undefined;
-    setCustomerData(data: CustomerProfile | null): void;
+/**
+ * Payload CMS Create/Update Response
+ * POST /api/{collection}
+ * PATCH /api/{collection}/{id}
+ */
+interface PayloadMutationResponse<T = unknown> {
+    message: string;
+    doc: T;
+    errors?: unknown[];
 }
-
-type ProductListingGroupsQueryOptions = Pick<ApiQueryOptions, 'page' | 'limit' | 'sort' | 'where'>;
-type ReadOnlyQueryHooks = Omit<QueryHooks, 'useCreate' | 'useUpdate' | 'useRemove'>;
+type Sort = string | string[];
+type Where = Record<string, unknown>;
 /**
- * Composes CollectionHooks + CustomerHooks into a single API surface.
- * All methods are delegated; no logic lives here.
+ * Do NOT replace with `Pick<FindOptions>` from `payload` or import Payload
+ * types here. Payload's generic query types depend on `PayloadTypes` module
+ * augmentation; external SDK consumers who only use `createClient` should not
+ * install Payload just to type REST query objects. Excluded vs native:
+ * Local-API-only fields, `locale`/`fallbackLocale`.
  */
-interface ProductDetailCallable {
-    product: {
-        detail: (params: ProductDetailParams) => Promise<ProductDetail | null>;
-    };
+interface ApiQueryOptions {
+    page?: number;
+    limit?: number;
+    sort?: Sort;
+    /**
+     * Filter documents. Id-based relation filters (`where: { product: { equals: id } }`) are the
+     * most reliable pattern. Dotted-path relation filters (`where: { 'product.slug': { equals } }`)
+     * are Payload-native but may silently return empty when access control restricts the related
+     * document or when the relation is polymorphic. String shorthand (`where: { slug: 'x' }`)
+     * silently matches nothing — always use `{ slug: { equals: 'x' } }`.
+     */
+    where?: Where;
+    /**
+     * Controls how deeply relationship fields are populated. This is the primary control for
+     * populating relationships like `category`, `images`, `brand`. The configured Payload default
+     * applies when unset.
+     */
+    depth?: number;
+    select?: Record<string, boolean>;
+    /**
+     * Controls which fields are returned for already-populated relationships, keyed by collection
+     * slug. Does NOT control which relationships to populate — that is `depth`.
+     *
+     * @example
+     * // depth: 2 populates category; populate trims which fields come back
+     * populate: { categories: { title: true, slug: true } }
+     */
+    populate?: Record<string, boolean | Record<string, boolean>>;
+    /**
+     * Controls Payload `type: 'join'` virtual reverse-relation fields only (pagination, sort,
+     * filter, count per join field, or `false` to disable all join-field population).
+     *
+     * Does NOT populate normal relationship fields like `category`, `images`, or `brand`.
+     * For normal relationship population use `depth` (and optionally `populate` for field
+     * selection).
+     *
+     * Pass `joins: false` to disable all join-field population — useful for lightweight list
+     * queries where join fields are not needed.
+     *
+     * @example
+     * // `article-authors` has a `type: 'join'` field `articles` (reverse-relation)
+     * joins: { articles: { limit: 10, sort: '-publishedAt' } }
+     *
+     * // depth: 2 populates product.category — joins has no effect on this
+     * depth: 2
+     *
+     * // Disable all join-field population
+     * joins: false
+     */
+    joins?: Record<string, {
+        limit?: number;
+        page?: number;
+        sort?: string;
+        where?: Where;
+        count?: boolean;
+    } | false> | false;
+    /** Set to `false` to skip the count query — returns docs without totalDocs/totalPages */
+    pagination?: boolean;
+    /** Include draft versions (access control still applies on the server) */
+    draft?: boolean;
+    /** Include soft-deleted documents (requires `trash` enabled on the collection) */
+    trash?: boolean;
 }
-declare class QueryHooks extends CollectionHooks {
-    private _customer;
-    private _commerce?;
-    constructor(queryClient: QueryClient, collectionClient: CollectionClient, customerAuth?: CustomerAuth, commerceClient?: ProductDetailCallable);
-    useCustomerMe: CustomerHooks['useCustomerMe'];
-    useCustomerLogin: CustomerHooks['useCustomerLogin'];
-    useCustomerRegister: CustomerHooks['useCustomerRegister'];
-    useCustomerLogout: CustomerHooks['useCustomerLogout'];
-    useCustomerForgotPassword: CustomerHooks['useCustomerForgotPassword'];
-    useCustomerResetPassword: CustomerHooks['useCustomerResetPassword'];
-    useCustomerRefreshToken: CustomerHooks['useCustomerRefreshToken'];
-    useCustomerUpdateProfile: CustomerHooks['useCustomerUpdateProfile'];
-    useCustomerChangePassword: CustomerHooks['useCustomerChangePassword'];
-    invalidateCustomerQueries: CustomerHooks['invalidateCustomerQueries'];
-    getCustomerData: CustomerHooks['getCustomerData'];
-    setCustomerData: CustomerHooks['setCustomerData'];
-    useProductListingGroupsQuery<TData = PayloadFindResponse<ProductListingGroupsItem>>(params: {
-        options?: ProductListingGroupsQueryOptions;
-    }, options?: QueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseQueryResult<_tanstack_react_query.NoInfer<TData>, Error>;
-    useSuspenseProductListingGroupsQuery<TData = PayloadFindResponse<ProductListingGroupsItem>>(params: {
-        options?: ProductListingGroupsQueryOptions;
-    }, options?: SuspenseQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): _tanstack_react_query.UseSuspenseQueryResult<TData, Error>;
-    useInfiniteProductListingGroupsQuery<TData = InfiniteData<PayloadFindResponse<ProductListingGroupsItem>>>(params: {
-        options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
-        pageSize?: number;
-    }, options?: InfiniteQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): _tanstack_react_query.UseInfiniteQueryResult<TData, Error>;
-    useSuspenseInfiniteProductListingGroupsQuery<TData = InfiniteData<PayloadFindResponse<ProductListingGroupsItem>>>(params: {
-        options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
-        pageSize?: number;
-    }, options?: SuspenseInfiniteQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): _tanstack_react_query.UseSuspenseInfiniteQueryResult<TData, Error>;
-    prefetchProductListingGroupsQuery(params: {
-        options?: ProductListingGroupsQueryOptions;
-    }, options?: {
-        staleTime?: number;
-    }): Promise<void>;
-    prefetchInfiniteProductListingGroupsQuery(params: {
-        options?: Omit<ProductListingGroupsQueryOptions, 'page' | 'limit'>;
-        pageSize?: number;
-    }, options?: {
-        pages?: number;
-        staleTime?: number;
-    }): Promise<void>;
-    useProductDetail(params: {
-        slug: string;
-    } | {
-        id: string;
-    }, options?: {
-        enabled?: boolean;
-    }): UseQueryResult<ProductDetail | null>;
-    useProductDetailBySlug(slug: string, options?: {
-        enabled?: boolean;
-    }): UseQueryResult<ProductDetail | null>;
-    useProductDetailById(id: string, options?: {
-        enabled?: boolean;
-    }): UseQueryResult<ProductDetail | null>;
+interface DebugConfig {
+    logRequests?: boolean;
+    logResponses?: boolean;
+    logErrors?: boolean;
 }
-
-declare class ServerClient {
-    commerce: ServerCommerceClient;
-    community: CommunityClient & {
-        moderation: {
-            banCustomer: (p: BanCustomerParams) => Promise<CommunityBan>;
-            unbanCustomer: (p: UnbanCustomerParams) => Promise<{
-                success: true;
-            }>;
-        };
-    };
-    query: QueryHooks;
-    collections: ServerCollectionClient;
-    queryClient: QueryClient;
+interface RetryConfig {
+    maxRetries?: number;
+    retryableStatuses?: number[];
+    retryDelay?: (attempt: number) => number;
+}
+interface RootQueryLookup<T extends string> {
+    find(options?: ApiQueryOptions): Promise<PayloadFindResponse<CollectionType<T>>>;
+    findById(id: string | number, options?: ApiQueryOptions): Promise<CollectionType<T>>;
+    count(options?: ApiQueryOptions): Promise<{
+        totalDocs: number;
+    }>;
+}
+type RootReadOnlyQueryBuilder<T extends PublicCollection> = RootQueryLookup<T>;
+interface RootCollectionClient {
+    from<T extends PublicCollection>(collection: T): RootReadOnlyQueryBuilder<T>;
+}
+interface RootClient {
+    commerce: CommerceClient;
+    community: CommunityClient;
+    customer: CustomerNamespace;
+    collections: RootCollectionClient;
     lastRequestId: string | null;
-    protected state: ClientState;
-    protected config: ClientServerConfig;
-    constructor(options: ClientServerConfig);
     getState(): ClientState;
-    getConfig(): Omit<ClientServerConfig, 'secretKey'>;
+    getConfig(): ClientConfig;
 }
-/**
- * Create a server-only client with full read/write access. Requires secretKey.
- * For read-only usage, prefer `createClient()` (no secretKey needed).
- */
-declare function createServerClient(options: ClientServerConfig): ServerClient;
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+type ExtractArrayType<T> = T extends (infer U)[] ? U : never;
 
-export { type CustomerAuthResponse as $, type AddItemParams as A, type BanCustomerParams as B, CustomerAuth as C, type ClientMetadata as D, type ClientServerConfig as E, CollectionClient as F, type CollectionDetailQueryParams as G, CollectionHooks as H, type CollectionInfiniteQueryParams as I, CollectionQueryBuilder as J, type CollectionQueryParams as K, type ListingGroupsParams as L, type CommunityBan as M, type CommunityClientOptions as N, type CommunityPost as O, type ProductListingGroupsResponse as P, ConfigError as Q, type RemoveItemParams as R, type StockCheckParams as S, type ConfirmPaymentParams as T, type UpdateItemParams as U, type ValidateDiscountParams as V, type ConfirmPaymentResponse as W, ConflictError as X, type CreateFulfillmentParams as Y, type CreateOrderParams as Z, type CreateReturnParams as _, type CustomerAuthOptions as a, type ReturnItem as a$, CustomerHooks as a0, type CustomerLoginData as a1, type CustomerProfile as a2, type CustomerRefreshResponse as a3, type CustomerRegisterData as a4, type CustomerRegisterResponse as a5, type CustomerSnapshot as a6, type DebugConfig as a7, type DeepPartial as a8, DiscountApi as a9, type ProductDetailVariant as aA, type ProductDetailVariantOptionValue as aB, type ProductDetailVideo as aC, type ProductListingGroup as aD, type ProductListingGroupSummary as aE, type ProductListingGroupsItem as aF, type ProductListingProductShape as aG, type ProductListingProjection as aH, type ProductOptionMatrix as aI, type ProductOptionMatrixOption as aJ, type ProductOptionMatrixValue as aK, type ProductOptionMatrixVariant as aL, type ProductOptionShape as aM, type ProductOptionValueShape as aN, type ProductSelectionAvailableValue as aO, type ProductSelectionByOptionValue as aP, ProductSelectionCodecError as aQ, type ProductSelectionCodecOptions as aR, type ProductSelectionInput as aS, type ProductSelectionResolution as aT, type ProductVariantShape as aU, QueryHooks as aV, type QueryOptions as aW, RateLimitError as aX, type ReadOnlyQueryBuilder as aY, type RequestOptions as aZ, type RetryConfig as a_, type DiscountApiOptions as aa, type ExtractArrayType as ab, type GenerateMetadataOptions as ac, GoneError as ad, type InfiniteQueryOptions as ae, type LegacyProductSelectionParamEvent as af, ModerationApi as ag, type ModerationApiOptions as ah, NetworkError as ai, type NormalizedProductSelection as aj, NotFoundError as ak, OrderApi as al, type OrderApiOptions as am, type PaginationMeta as an, type PayloadMutationResponse as ao, PermissionError as ap, ProductApi as aq, type ProductApiOptions as ar, type ProductDetailBrand as as, type ProductDetailCategory as at, type ProductDetailImage as au, type ProductDetailListing as av, type ProductDetailMedia as aw, type ProductDetailOption as ax, type ProductDetailOptionValue as ay, type ProductDetailTag as az, type StockCheckResponse as b, type ReturnReason as b0, type ReturnWithRefundParams as b1, SDKError as b2, type ServerApiOptions as b3, ServerClient as b4, ServerCollectionClient as b5, ServerCollectionQueryBuilder as b6, ServerCommerceClient as b7, type ServerCommerceClientOptions as b8, ServiceUnavailableError as b9, getSelectedValueByOptionId as bA, isApiError as bB, isAuthError as bC, isConfigError as bD, isConflictError as bE, isGoneError as bF, isNetworkError as bG, isNotFoundError as bH, isPermissionError as bI, isRateLimitError as bJ, isSDKError as bK, isServiceUnavailableError as bL, isTimeoutError as bM, isUsageLimitError as bN, isValidationError as bO, normalizeProductSelection as bP, normalizeSelectedValueIds as bQ, parseProductSelection as bR, resolveApiUrl as bS, resolveProductSelection as bT, resolveVariantForSelection as bU, stringifyProductSelection as bV, ShippingApi as ba, type ShippingApiOptions as bb, type StockCheckResult as bc, type SuspenseInfiniteQueryOptions as bd, type SuspenseQueryOptions as be, TimeoutError as bf, type UnbanCustomerParams as bg, type UpdateFulfillmentParams as bh, type UpdateOrderParams as bi, type UpdateProfileData as bj, type UpdateReturnParams as bk, type UpdateTransactionParams as bl, UsageLimitError as bm, ValidationError as bn, buildProductListingGroupsByOption as bo, buildProductListingProjection as bp, buildProductOptionMatrix as bq, buildProductOptionMatrixFromDetail as br, createAuthError as bs, createConflictError as bt, createNotFoundError as bu, createPermissionError as bv, createProductSelectionCodec as bw, createRateLimitError as bx, createServerClient as by, getAvailableOptionValues as bz, type ProductDetailParams as c, type ProductDetail as d, type ApplyDiscountParams as e, type RemoveDiscountParams as f, type ClearCartParams as g, type CheckoutParams as h, type PayloadFindResponse as i, type ValidateDiscountResult as j, type CalculateShippingParams as k, type CalculateShippingResult as l, type ApiQueryOptions as m, type ProductListingGroupsQueryOptions as n, CommunityClient as o, type ReadOnlyQueryHooks as p, ReadOnlyCollectionClient as q, type ClientState as r, type ClientConfig as s, ApiError as t, AuthError as u, BaseApi as v, type BulkImportFulfillmentsParams as w, type BulkImportFulfillmentsResponse as x, CartApi as y, type CartApiOptions as z };
+export { type OrderApiOptions as $, type ApiQueryOptions as A, BaseApi as B, CommerceClient as C, type DebugConfig as D, type ExtractArrayType as E, type CreateFulfillmentParams as F, type CreateOrderParams as G, type CreateReturnParams as H, CustomerAuth as I, type CustomerAuthOptions as J, type CustomerAuthResponse as K, type CustomerLoginData as L, type CustomerProfile as M, type CustomerRefreshResponse as N, type CustomerRegisterData as O, type PayloadFindResponse as P, type CustomerRegisterResponse as Q, type RetryConfig as R, type Sort as S, type CustomerSnapshot as T, DiscountApi as U, type DiscountApiOptions as V, type Where as W, type LegacyProductSelectionParamEvent as X, type ListingGroupsParams as Y, type NormalizedProductSelection as Z, OrderApi as _, CommunityClient as a, buildProductOptionMatrixFromDetail as a$, ProductApi as a0, type ProductApiOptions as a1, type ProductDetail as a2, type ProductDetailBrand as a3, type ProductDetailCategory as a4, type ProductDetailImage as a5, type ProductDetailImageMedia as a6, type ProductDetailListing as a7, type ProductDetailMedia as a8, type ProductDetailOption as a9, type ProductSelectionResolution as aA, type ProductSelectionResolutionContext as aB, type ProductVariantShape as aC, type RemoveDiscountParams as aD, type RemoveItemParams as aE, type RequestOptions as aF, type ReturnItem as aG, type ReturnReason as aH, type ReturnWithRefundParams as aI, type ServerApiOptions as aJ, ShippingApi as aK, type ShippingApiOptions as aL, type StockCheckParams as aM, type StockCheckResponse as aN, type StockCheckResult as aO, type UpdateFulfillmentParams as aP, type UpdateItemParams as aQ, type UpdateOrderParams as aR, type UpdateProfileData as aS, type UpdateReturnParams as aT, type UpdateTransactionParams as aU, type ValidateDiscountParams as aV, type ValidateDiscountResult as aW, buildProductHref as aX, buildProductListingGroupsByOption as aY, buildProductListingProjection as aZ, buildProductOptionMatrix as a_, type ProductDetailOptionValue as aa, type ProductDetailParams as ab, type ProductDetailTag as ac, type ProductDetailVariant as ad, type ProductDetailVariantOptionValue as ae, type ProductDetailVideo as af, type ProductHrefGroup as ag, type ProductHrefOptions as ah, type ProductHrefProduct as ai, type ProductListingGroup as aj, type ProductListingGroupSummary as ak, type ProductListingGroupsItem as al, type ProductListingGroupsResponse as am, type ProductListingProductShape as an, type ProductListingProjection as ao, type ProductOptionMatrix as ap, type ProductOptionMatrixOption as aq, type ProductOptionMatrixValue as ar, type ProductOptionMatrixVariant as as, type ProductOptionShape as at, type ProductOptionValueShape as au, type ProductSelectionAvailableValue as av, type ProductSelectionByOptionValue as aw, ProductSelectionCodecError as ax, type ProductSelectionCodecOptions as ay, type ProductSelectionInput as az, CustomerNamespace as b, createProductSelectionCodec as b0, getAvailableOptionValues as b1, getProductSelectionImages as b2, getSelectedValueByOptionId as b3, normalizeProductSelection as b4, normalizeProductSelectionFromMatrix as b5, normalizeSelectedValueIds as b6, parseProductSelection as b7, resolveProductSelection as b8, resolveProductSelectionFromMatrix as b9, resolveVariantForSelection as ba, stringifyProductSelection as bb, type ProductUpsertParams as bc, type ProductUpsertResponse as bd, type ClientServerConfig as be, type ClientState as c, type ClientConfig as d, type ClientMetadata as e, type DeepPartial as f, type PayloadMutationResponse as g, type RootClient as h, type RootCollectionClient as i, type RootReadOnlyQueryBuilder as j, type AddItemParams as k, type ApplyDiscountParams as l, type BulkImportFulfillmentsParams as m, type BulkImportFulfillmentsResponse as n, type CalculateShippingParams as o, type CalculateShippingResult as p, CartApi as q, type CartApiOptions as r, type CheckoutParams as s, type ClearCartParams as t, type CommerceClientOptions as u, type CommunityClientOptions as v, type CommunityPost as w, type CompatibilityProductSelectionParamEvent as x, type ConfirmPaymentParams as y, type ConfirmPaymentResponse as z };