@01.software/sdk 0.29.0 → 0.30.1

package/dist/server.cjs

@@ -30,205 +30,6 @@ __export(server_exports, {
 });
 module.exports = __toCommonJS(server_exports);
 
-// src/utils/types.ts
-var resolveRelation = (ref) => {
-  if (typeof ref === "string" || typeof ref === "number" || ref === null || ref === void 0)
-    return null;
-  return ref;
-};
-
-// src/core/metadata/index.ts
-function extractSeo(doc) {
-  const seo = doc.seo ?? {};
-  const og = seo.openGraph ?? {};
-  return {
-    title: seo.title ?? doc.title ?? null,
-    description: seo.description ?? null,
-    noIndex: seo.noIndex ?? null,
-    canonical: seo.canonical ?? null,
-    openGraph: {
-      title: og.title ?? null,
-      description: og.description ?? null,
-      image: og.image ?? null
-    }
-  };
-}
-function generateMetadata(input, options) {
-  const title = input.title ?? void 0;
-  const description = input.description ?? void 0;
-  const ogTitle = input.openGraph?.title ?? title;
-  const ogDescription = input.openGraph?.description ?? description;
-  const image = resolveMetaImage(input.openGraph?.image);
-  return {
-    title,
-    description,
-    ...input.noIndex && { robots: { index: false, follow: false } },
-    ...input.canonical && { alternates: { canonical: input.canonical } },
-    openGraph: {
-      ...ogTitle && { title: ogTitle },
-      ...ogDescription && { description: ogDescription },
-      ...options?.siteName && { siteName: options.siteName },
-      ...image && { images: [image] }
-    },
-    twitter: {
-      card: image ? "summary_large_image" : "summary",
-      ...ogTitle && { title: ogTitle },
-      ...ogDescription && { description: ogDescription },
-      ...image && { images: [image.url] }
-    }
-  };
-}
-function resolveMetaImage(ref) {
-  const image = resolveRelation(ref);
-  if (!image) return null;
-  const sized = image.sizes?.["1536"];
-  const url = sized?.url || image.url;
-  if (!url) return null;
-  const width = sized?.url ? sized.width : image.width;
-  const height = sized?.url ? sized.height : image.height;
-  return {
-    url,
-    ...width && { width },
-    ...height && { height },
-    ...image.alt && { alt: image.alt }
-  };
-}
-
-// src/core/collection/query-builder.ts
-var CollectionQueryBuilder = class {
-  constructor(api, collection) {
-    this.api = api;
-    this.collection = collection;
-  }
-  /**
-   * Find documents (list query)
-   * GET /api/{collection}
-   * @returns Payload CMS find response with docs array and pagination
-   */
-  async find(options) {
-    return this.api.requestFind(
-      `/api/${String(this.collection)}`,
-      options
-    );
-  }
-  /**
-   * Find document by ID
-   * GET /api/{collection}/{id}
-   * @returns Document object directly (no wrapper)
-   */
-  async findById(id, options) {
-    return this.api.requestFindById(
-      `/api/${String(this.collection)}/${String(id)}`,
-      options
-    );
-  }
-  /**
-   * Create a new document
-   * POST /api/{collection}
-   * @returns Payload CMS mutation response with doc and message
-   */
-  async create(data, options) {
-    const endpoint = `/api/${String(this.collection)}`;
-    if (options?.file) {
-      return this.api.requestCreateWithFile(
-        endpoint,
-        data,
-        options.file,
-        options.filename
-      );
-    }
-    return this.api.requestCreate(endpoint, data);
-  }
-  /**
-   * Update a document by ID
-   * PATCH /api/{collection}/{id}
-   * @returns Payload CMS mutation response with doc and message
-   */
-  async update(id, data, options) {
-    const endpoint = `/api/${String(this.collection)}/${String(id)}`;
-    if (options?.file) {
-      return this.api.requestUpdateWithFile(
-        endpoint,
-        data,
-        options.file,
-        options.filename
-      );
-    }
-    return this.api.requestUpdate(endpoint, data);
-  }
-  /**
-   * Count documents
-   * GET /api/{collection}/count
-   * @returns Count response with totalDocs
-   */
-  async count(options) {
-    return this.api.requestCount(
-      `/api/${String(this.collection)}/count`,
-      options
-    );
-  }
-  /**
-   * 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
-   */
-  async findMetadata(options, metadataOptions) {
-    const { docs } = await this.find({ ...options, limit: 1, depth: 1 });
-    const doc = docs[0];
-    if (!doc) return null;
-    return generateMetadata(
-      extractSeo(doc),
-      metadataOptions
-    );
-  }
-  /**
-   * Find document by ID and return its Next.js Metadata.
-   * Applies depth: 1 (SEO image populate) automatically.
-   * @returns Metadata (throws on 404)
-   */
-  async findMetadataById(id, metadataOptions) {
-    const doc = await this.findById(id, { depth: 1 });
-    return generateMetadata(
-      extractSeo(doc),
-      metadataOptions
-    );
-  }
-  /**
-   * Update multiple documents (bulk update)
-   * PATCH /api/{collection}
-   * @returns Payload CMS find response with updated docs
-   */
-  async updateMany(where, data) {
-    return this.api.requestUpdateMany(
-      `/api/${String(this.collection)}`,
-      { where, data }
-    );
-  }
-  /**
-   * Delete a document by ID
-   * DELETE /api/{collection}/{id}
-   * @returns Deleted document object directly (no wrapper)
-   */
-  async remove(id) {
-    return this.api.requestDelete(
-      `/api/${String(this.collection)}/${String(id)}`
-    );
-  }
-  /**
-   * Delete multiple documents (bulk delete)
-   * DELETE /api/{collection}
-   * @returns Payload CMS find response with deleted docs
-   */
-  async removeMany(where) {
-    return this.api.requestDeleteMany(
-      `/api/${String(this.collection)}`,
-      { where }
-    );
-  }
-};
-var ServerCollectionQueryBuilder = class extends CollectionQueryBuilder {
-};
-
 // src/core/collection/http-client.ts
 var import_qs_esm = require("qs-esm");
 
@@ -360,7 +161,10 @@ function requirePublishableKeyForSecret(apiName, publishableKey, secretKey) {
 }
 
 // src/core/client/types.ts
-function resolveApiUrl() {
+function resolveApiUrl(apiUrl) {
+  if (apiUrl) {
+    return apiUrl.replace(/\/$/, "");
+  }
   if (typeof process !== "undefined" && process.env) {
     const envUrl = process.env.SOFTWARE_API_URL || process.env.NEXT_PUBLIC_SOFTWARE_API_URL;
     if (envUrl) {
@@ -541,6 +345,7 @@ function createHttpStatusError(status, parsed, details, requestId) {
 }
 async function httpFetch(url, options) {
   const {
+    apiUrl,
     publishableKey,
     secretKey,
     customerToken,
@@ -550,7 +355,7 @@ async function httpFetch(url, options) {
     onUnauthorized,
     ...requestInit
   } = options || {};
-  const baseUrl = resolveApiUrl();
+  const baseUrl = resolveApiUrl(apiUrl);
   const retryConfig = {
     maxRetries: retry?.maxRetries ?? 3,
     retryableStatuses: retry?.retryableStatuses ?? DEFAULT_RETRYABLE_STATUSES,
@@ -739,7 +544,7 @@ async function httpFetch(url, options) {
 
 // src/core/collection/http-client.ts
 var HttpClient = class {
-  constructor(publishableKey, secretKey, getCustomerToken, onUnauthorized, onRequestId) {
+  constructor(publishableKey, secretKey, getCustomerToken, onUnauthorized, onRequestId, apiUrl) {
     this.publishableKey = requirePublishableKeyForSecret(
       "CollectionClient",
       publishableKey,
@@ -749,9 +554,11 @@ var HttpClient = class {
     this.getCustomerToken = getCustomerToken;
     this.onUnauthorized = onUnauthorized;
     this.onRequestId = onRequestId;
+    this.apiUrl = apiUrl;
   }
   get defaultOptions() {
     const opts = {
+      apiUrl: this.apiUrl,
       publishableKey: this.publishableKey,
       secretKey: this.secretKey
     };
@@ -775,99 +582,298 @@ var HttpClient = class {
       throw err;
     }
   }
-  buildUrl(endpoint, options) {
-    if (!options) return endpoint;
-    const queryString = (0, import_qs_esm.stringify)(options, { addQueryPrefix: true });
-    return queryString ? `${endpoint}${queryString}` : endpoint;
+  buildUrl(endpoint, options) {
+    if (!options) return endpoint;
+    const queryString = (0, import_qs_esm.stringify)(options, { addQueryPrefix: true });
+    return queryString ? `${endpoint}${queryString}` : endpoint;
+  }
+  assertJsonResponse(response) {
+    const contentType = response.headers.get("content-type");
+    if (!contentType?.includes("application/json")) {
+      throw createApiError("Response is not in JSON format.", response.status, {
+        contentType
+      });
+    }
+  }
+  /**
+   * Parse Payload CMS find response (list query)
+   * Returns native Payload response structure
+   */
+  async parseFindResponse(response) {
+    const contentType = response.headers.get("content-type");
+    try {
+      this.assertJsonResponse(response);
+      const jsonData = await response.json();
+      if (jsonData.docs === void 0) {
+        throw createApiError("Invalid find response.", response.status, {
+          jsonData
+        });
+      }
+      return {
+        docs: jsonData.docs,
+        totalDocs: jsonData.totalDocs ?? 0,
+        limit: jsonData.limit || 20,
+        totalPages: jsonData.totalPages ?? 0,
+        page: jsonData.page || 1,
+        pagingCounter: jsonData.pagingCounter || 1,
+        hasPrevPage: jsonData.hasPrevPage ?? false,
+        hasNextPage: jsonData.hasNextPage ?? false,
+        prevPage: jsonData.prevPage ?? null,
+        nextPage: jsonData.nextPage ?? null
+      };
+    } catch (error) {
+      if (error instanceof SDKError) throw error;
+      throw createApiError("Failed to parse response.", response.status, {
+        contentType,
+        error: error instanceof Error ? error.message : error
+      });
+    }
+  }
+  /**
+   * Parse Payload CMS mutation response (create/update)
+   * Returns native Payload response structure
+   */
+  async parseMutationResponse(response) {
+    const contentType = response.headers.get("content-type");
+    try {
+      this.assertJsonResponse(response);
+      const jsonData = await response.json();
+      if (jsonData.doc === void 0) {
+        throw createApiError("Invalid mutation response.", response.status, {
+          jsonData
+        });
+      }
+      return {
+        message: jsonData.message || "",
+        doc: jsonData.doc,
+        errors: jsonData.errors
+      };
+    } catch (error) {
+      if (error instanceof SDKError) throw error;
+      throw createApiError("Failed to parse response.", response.status, {
+        contentType,
+        error: error instanceof Error ? error.message : error
+      });
+    }
+  }
+  /**
+   * Parse Payload CMS document response (findById/delete)
+   * Returns document directly without wrapper
+   */
+  async parseDocumentResponse(response) {
+    const contentType = response.headers.get("content-type");
+    try {
+      this.assertJsonResponse(response);
+      const jsonData = await response.json();
+      return jsonData;
+    } catch (error) {
+      if (error instanceof SDKError) throw error;
+      throw createApiError("Failed to parse response.", response.status, {
+        contentType,
+        error: error instanceof Error ? error.message : error
+      });
+    }
+  }
+};
+
+// src/utils/types.ts
+var resolveRelation = (ref) => {
+  if (typeof ref === "string" || typeof ref === "number" || ref === null || ref === void 0)
+    return null;
+  return ref;
+};
+
+// src/core/metadata/index.ts
+function extractSeo(doc) {
+  const seo = doc.seo ?? {};
+  const og = seo.openGraph ?? {};
+  return {
+    title: seo.title ?? doc.title ?? null,
+    description: seo.description ?? null,
+    noIndex: seo.noIndex ?? null,
+    canonical: seo.canonical ?? null,
+    openGraph: {
+      title: og.title ?? null,
+      description: og.description ?? null,
+      image: og.image ?? null
+    }
+  };
+}
+function generateMetadata(input, options) {
+  const title = input.title ?? void 0;
+  const description = input.description ?? void 0;
+  const ogTitle = input.openGraph?.title ?? title;
+  const ogDescription = input.openGraph?.description ?? description;
+  const image = resolveMetaImage(input.openGraph?.image);
+  return {
+    title,
+    description,
+    ...input.noIndex && { robots: { index: false, follow: false } },
+    ...input.canonical && { alternates: { canonical: input.canonical } },
+    openGraph: {
+      ...ogTitle && { title: ogTitle },
+      ...ogDescription && { description: ogDescription },
+      ...options?.siteName && { siteName: options.siteName },
+      ...image && { images: [image] }
+    },
+    twitter: {
+      card: image ? "summary_large_image" : "summary",
+      ...ogTitle && { title: ogTitle },
+      ...ogDescription && { description: ogDescription },
+      ...image && { images: [image.url] }
+    }
+  };
+}
+function resolveMetaImage(ref) {
+  const image = resolveRelation(ref);
+  if (!image) return null;
+  const sized = image.sizes?.["1536"];
+  const url = sized?.url || image.url;
+  if (!url) return null;
+  const width = sized?.url ? sized.width : image.width;
+  const height = sized?.url ? sized.height : image.height;
+  return {
+    url,
+    ...width && { width },
+    ...height && { height },
+    ...image.alt && { alt: image.alt }
+  };
+}
+
+// src/core/collection/query-builder.ts
+var CollectionQueryBuilder = class {
+  constructor(api, collection) {
+    this.api = api;
+    this.collection = collection;
+  }
+  /**
+   * Find documents (list query)
+   * GET /api/{collection}
+   * @returns Payload CMS find response with docs array and pagination
+   */
+  async find(options) {
+    return this.api.requestFind(
+      `/api/${String(this.collection)}`,
+      options
+    );
+  }
+  /**
+   * Find document by ID
+   * GET /api/{collection}/{id}
+   * @returns Document object directly (no wrapper)
+   */
+  async findById(id, options) {
+    return this.api.requestFindById(
+      `/api/${String(this.collection)}/${String(id)}`,
+      options
+    );
+  }
+  /**
+   * Create a new document
+   * POST /api/{collection}
+   * @returns Payload CMS mutation response with doc and message
+   */
+  async create(data, options) {
+    const endpoint = `/api/${String(this.collection)}`;
+    if (options?.file) {
+      return this.api.requestCreateWithFile(
+        endpoint,
+        data,
+        options.file,
+        options.filename
+      );
+    }
+    return this.api.requestCreate(endpoint, data);
+  }
+  /**
+   * Update a document by ID
+   * PATCH /api/{collection}/{id}
+   * @returns Payload CMS mutation response with doc and message
+   */
+  async update(id, data, options) {
+    const endpoint = `/api/${String(this.collection)}/${String(id)}`;
+    if (options?.file) {
+      return this.api.requestUpdateWithFile(
+        endpoint,
+        data,
+        options.file,
+        options.filename
+      );
+    }
+    return this.api.requestUpdate(endpoint, data);
+  }
+  /**
+   * Count documents
+   * GET /api/{collection}/count
+   * @returns Count response with totalDocs
+   */
+  async count(options) {
+    return this.api.requestCount(
+      `/api/${String(this.collection)}/count`,
+      options
+    );
+  }
+  /**
+   * 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
+   */
+  async findMetadata(options, metadataOptions) {
+    const { docs } = await this.find({ ...options, limit: 1, depth: 1 });
+    const doc = docs[0];
+    if (!doc) return null;
+    return generateMetadata(
+      extractSeo(doc),
+      metadataOptions
+    );
   }
-  assertJsonResponse(response) {
-    const contentType = response.headers.get("content-type");
-    if (!contentType?.includes("application/json")) {
-      throw createApiError("Response is not in JSON format.", response.status, {
-        contentType
-      });
-    }
+  /**
+   * Find document by ID and return its Next.js Metadata.
+   * Applies depth: 1 (SEO image populate) automatically.
+   * @returns Metadata (throws on 404)
+   */
+  async findMetadataById(id, metadataOptions) {
+    const doc = await this.findById(id, { depth: 1 });
+    return generateMetadata(
+      extractSeo(doc),
+      metadataOptions
+    );
   }
   /**
-   * Parse Payload CMS find response (list query)
-   * Returns native Payload response structure
+   * Update multiple documents (bulk update)
+   * PATCH /api/{collection}
+   * @returns Payload CMS find response with updated docs
    */
-  async parseFindResponse(response) {
-    const contentType = response.headers.get("content-type");
-    try {
-      this.assertJsonResponse(response);
-      const jsonData = await response.json();
-      if (jsonData.docs === void 0) {
-        throw createApiError("Invalid find response.", response.status, {
-          jsonData
-        });
-      }
-      return {
-        docs: jsonData.docs,
-        totalDocs: jsonData.totalDocs ?? 0,
-        limit: jsonData.limit || 20,
-        totalPages: jsonData.totalPages ?? 0,
-        page: jsonData.page || 1,
-        pagingCounter: jsonData.pagingCounter || 1,
-        hasPrevPage: jsonData.hasPrevPage ?? false,
-        hasNextPage: jsonData.hasNextPage ?? false,
-        prevPage: jsonData.prevPage ?? null,
-        nextPage: jsonData.nextPage ?? null
-      };
-    } catch (error) {
-      if (error instanceof SDKError) throw error;
-      throw createApiError("Failed to parse response.", response.status, {
-        contentType,
-        error: error instanceof Error ? error.message : error
-      });
-    }
+  async updateMany(where, data) {
+    return this.api.requestUpdateMany(
+      `/api/${String(this.collection)}`,
+      { where, data }
+    );
   }
   /**
-   * Parse Payload CMS mutation response (create/update)
-   * Returns native Payload response structure
+   * Delete a document by ID
+   * DELETE /api/{collection}/{id}
+   * @returns Deleted document object directly (no wrapper)
    */
-  async parseMutationResponse(response) {
-    const contentType = response.headers.get("content-type");
-    try {
-      this.assertJsonResponse(response);
-      const jsonData = await response.json();
-      if (jsonData.doc === void 0) {
-        throw createApiError("Invalid mutation response.", response.status, {
-          jsonData
-        });
-      }
-      return {
-        message: jsonData.message || "",
-        doc: jsonData.doc,
-        errors: jsonData.errors
-      };
-    } catch (error) {
-      if (error instanceof SDKError) throw error;
-      throw createApiError("Failed to parse response.", response.status, {
-        contentType,
-        error: error instanceof Error ? error.message : error
-      });
-    }
+  async remove(id) {
+    return this.api.requestDelete(
+      `/api/${String(this.collection)}/${String(id)}`
+    );
   }
   /**
-   * Parse Payload CMS document response (findById/delete)
-   * Returns document directly without wrapper
+   * Delete multiple documents (bulk delete)
+   * DELETE /api/{collection}
+   * @returns Payload CMS find response with deleted docs
    */
-  async parseDocumentResponse(response) {
-    const contentType = response.headers.get("content-type");
-    try {
-      this.assertJsonResponse(response);
-      const jsonData = await response.json();
-      return jsonData;
-    } catch (error) {
-      if (error instanceof SDKError) throw error;
-      throw createApiError("Failed to parse response.", response.status, {
-        contentType,
-        error: error instanceof Error ? error.message : error
-      });
-    }
+  async removeMany(where) {
+    return this.api.requestDeleteMany(
+      `/api/${String(this.collection)}`,
+      { where }
+    );
   }
 };
+var ServerCollectionQueryBuilder = class extends CollectionQueryBuilder {
+};
 
 // src/core/collection/collection-client.ts
 function buildPayloadFormData(data, file, filename) {
@@ -1078,6 +1084,7 @@ var CommunityClient = class {
       options.secretKey
     );
     this.secretKey = options.secretKey;
+    this.apiUrl = options.apiUrl;
     this.customerToken = options.customerToken;
     this.onUnauthorized = options.onUnauthorized;
     this.onRequestId = options.onRequestId;
@@ -1092,6 +1099,7 @@ var CommunityClient = class {
     try {
       const response = await httpFetch(endpoint, {
         method,
+        apiUrl: this.apiUrl,
         publishableKey: this.publishableKey,
         secretKey: this.secretKey,
         customerToken: token ?? void 0,
@@ -1252,6 +1260,7 @@ var BaseApi = class {
       options.secretKey
     );
     this.secretKey = options.secretKey;
+    this.apiUrl = options.apiUrl;
     this.onRequestId = options.onRequestId;
   }
   async request(endpoint, body, options) {
@@ -1259,6 +1268,7 @@ var BaseApi = class {
     try {
       const response = await httpFetch(endpoint, {
         method,
+        apiUrl: this.apiUrl,
         publishableKey: this.publishableKey,
         secretKey: this.secretKey,
         ...body !== void 0 && { body: JSON.stringify(body) },
@@ -1301,6 +1311,7 @@ var CartApi = class {
       options.secretKey
     );
     this.secretKey = options.secretKey;
+    this.apiUrl = options.apiUrl;
     this.customerToken = options.customerToken;
     this.onUnauthorized = options.onUnauthorized;
     this.onRequestId = options.onRequestId;
@@ -1310,6 +1321,7 @@ var CartApi = class {
     try {
       const response = await httpFetch(endpoint, {
         method,
+        apiUrl: this.apiUrl,
         publishableKey: this.publishableKey,
         secretKey: this.secretKey,
         customerToken: token ?? void 0,
@@ -1480,6 +1492,7 @@ var ServerCommerceClient = class {
     const serverOptions = {
       publishableKey,
       secretKey: options.secretKey,
+      apiUrl: options.apiUrl,
       onRequestId: options.onRequestId
     };
     const productApi = new ProductApi(serverOptions);
@@ -1524,560 +1537,6 @@ var ServerCommerceClient = class {
   }
 };
 
-// src/core/query/get-query-client.ts
-var import_react_query = require("@tanstack/react-query");
-function makeQueryClient() {
-  return new import_react_query.QueryClient({
-    defaultOptions: {
-      queries: {
-        // Infinite staleTime: server-fetched data persists until explicitly invalidated.
-        // For browser clients needing fresher data, override per-query:
-        //   useQuery({ ..., staleTime: 5 * 60 * 1000 })
-        staleTime: Number.POSITIVE_INFINITY,
-        refetchOnWindowFocus: false
-      },
-      dehydrate: {
-        shouldDehydrateQuery: (query) => (0, import_react_query.defaultShouldDehydrateQuery)(query) || query.state.status === "pending",
-        shouldRedactErrors: () => false
-      }
-    }
-  });
-}
-var browserQueryClient;
-function getQueryClient() {
-  if (import_react_query.isServer) {
-    return makeQueryClient();
-  }
-  if (!browserQueryClient) {
-    browserQueryClient = makeQueryClient();
-  }
-  return browserQueryClient;
-}
-
-// src/core/query/query-hooks.ts
-var import_react_query4 = require("@tanstack/react-query");
-
-// src/core/query/collection-hooks.ts
-var import_react_query2 = require("@tanstack/react-query");
-
-// src/core/query/query-keys.ts
-function collectionKeys(collection) {
-  return {
-    all: [collection],
-    lists: () => [collection, "list"],
-    list: (options) => [collection, "list", options],
-    details: () => [collection, "detail"],
-    detail: (id, options) => [collection, "detail", id, options],
-    infinites: () => [collection, "infinite"],
-    infinite: (options) => [collection, "infinite", options]
-  };
-}
-var customerKeys = {
-  all: ["customer"],
-  me: () => ["customer", "me"]
-};
-var productKeys = {
-  listingGroups: (options) => ["products", "listing-groups", "list", options],
-  listingGroupsInfinite: (options) => ["products", "listing-groups", "infinite", options],
-  detail: (params) => ["products", "detail", params],
-  detailAll: () => ["products", "detail"]
-};
-
-// src/core/query/collection-hooks.ts
-var PRODUCT_DETAIL_INVALIDATING_COLLECTIONS = /* @__PURE__ */ new Set([
-  "products",
-  "product-variants",
-  "product-options",
-  "product-option-values",
-  "product-categories",
-  "product-tags",
-  "product-collections",
-  "brands",
-  "brand-logos",
-  "images"
-]);
-var DEFAULT_PAGE_SIZE = 20;
-var CollectionHooks = class {
-  constructor(queryClient, collectionClient) {
-    this.queryClient = queryClient;
-    this.collectionClient = collectionClient;
-  }
-  // ===== useQuery =====
-  useQuery(params, options) {
-    const { collection, options: queryOptions } = params;
-    const { placeholderData, ...restOptions } = options ?? {};
-    return (0, import_react_query2.useQuery)({
-      queryKey: collectionKeys(collection).list(queryOptions),
-      queryFn: async () => {
-        return await this.collectionClient.from(collection).find(queryOptions);
-      },
-      ...restOptions,
-      // NonFunctionGuard<T> incompatible with generic union types — safe cast
-      ...placeholderData !== void 0 && {
-        placeholderData
-      }
-    });
-  }
-  // ===== useSuspenseQuery =====
-  useSuspenseQuery(params, options) {
-    const { collection, options: queryOptions } = params;
-    return (0, import_react_query2.useSuspenseQuery)({
-      queryKey: collectionKeys(collection).list(queryOptions),
-      queryFn: async () => {
-        return await this.collectionClient.from(collection).find(queryOptions);
-      },
-      ...options
-    });
-  }
-  // ===== useQueryById =====
-  useQueryById(params, options) {
-    const { collection, id, options: queryOptions } = params;
-    const { placeholderData, ...restOptions } = options ?? {};
-    return (0, import_react_query2.useQuery)({
-      queryKey: collectionKeys(collection).detail(id, queryOptions),
-      queryFn: async () => {
-        return await this.collectionClient.from(collection).findById(id, queryOptions);
-      },
-      ...restOptions,
-      // NonFunctionGuard<T> incompatible with generic union types — safe cast
-      ...placeholderData !== void 0 && {
-        placeholderData
-      }
-    });
-  }
-  // ===== useSuspenseQueryById =====
-  useSuspenseQueryById(params, options) {
-    const { collection, id, options: queryOptions } = params;
-    return (0, import_react_query2.useSuspenseQuery)({
-      queryKey: collectionKeys(collection).detail(id, queryOptions),
-      queryFn: async () => {
-        return await this.collectionClient.from(collection).findById(id, queryOptions);
-      },
-      ...options
-    });
-  }
-  // ===== useInfiniteQuery =====
-  useInfiniteQuery(params, options) {
-    const {
-      collection,
-      options: queryOptions,
-      pageSize = DEFAULT_PAGE_SIZE
-    } = params;
-    return (0, import_react_query2.useInfiniteQuery)({
-      queryKey: collectionKeys(collection).infinite(queryOptions),
-      queryFn: async ({ pageParam }) => {
-        const response = await this.collectionClient.from(collection).find({ ...queryOptions, page: pageParam, limit: pageSize });
-        return response;
-      },
-      initialPageParam: 1,
-      getNextPageParam: (lastPage) => {
-        return lastPage.hasNextPage ? lastPage.nextPage : void 0;
-      },
-      ...options
-    });
-  }
-  // ===== useSuspenseInfiniteQuery =====
-  useSuspenseInfiniteQuery(params, options) {
-    const {
-      collection,
-      options: queryOptions,
-      pageSize = DEFAULT_PAGE_SIZE
-    } = params;
-    return (0, import_react_query2.useSuspenseInfiniteQuery)({
-      queryKey: collectionKeys(collection).infinite(queryOptions),
-      queryFn: async ({ pageParam }) => {
-        const response = await this.collectionClient.from(collection).find({ ...queryOptions, page: pageParam, limit: pageSize });
-        return response;
-      },
-      initialPageParam: 1,
-      getNextPageParam: (lastPage) => {
-        return lastPage.hasNextPage ? lastPage.nextPage : void 0;
-      },
-      ...options
-    });
-  }
-  // ===== prefetchQuery =====
-  async prefetchQuery(params, options) {
-    const { collection, options: queryOptions } = params;
-    return this.queryClient.prefetchQuery({
-      queryKey: collectionKeys(collection).list(queryOptions),
-      queryFn: async () => {
-        return await this.collectionClient.from(collection).find(queryOptions);
-      },
-      ...options
-    });
-  }
-  // ===== prefetchQueryById =====
-  async prefetchQueryById(params, options) {
-    const { collection, id, options: queryOptions } = params;
-    return this.queryClient.prefetchQuery({
-      queryKey: collectionKeys(collection).detail(id, queryOptions),
-      queryFn: async () => {
-        return await this.collectionClient.from(collection).findById(id, queryOptions);
-      },
-      ...options
-    });
-  }
-  // ===== prefetchInfiniteQuery =====
-  async prefetchInfiniteQuery(params, options) {
-    const {
-      collection,
-      options: queryOptions,
-      pageSize = DEFAULT_PAGE_SIZE
-    } = params;
-    return this.queryClient.prefetchInfiniteQuery({
-      queryKey: collectionKeys(collection).infinite(queryOptions),
-      queryFn: async ({ pageParam }) => {
-        const response = await this.collectionClient.from(collection).find({ ...queryOptions, page: pageParam, limit: pageSize });
-        return response;
-      },
-      initialPageParam: 1,
-      getNextPageParam: (lastPage) => {
-        return lastPage.hasNextPage ? lastPage.nextPage : void 0;
-      },
-      pages: options?.pages ?? 1,
-      staleTime: options?.staleTime
-    });
-  }
-  // ===== Mutation Hooks =====
-  useCreate(params, options) {
-    const { collection } = params;
-    return (0, import_react_query2.useMutation)({
-      mutationFn: async (variables) => {
-        return await this.collectionClient.from(collection).create(
-          variables.data,
-          variables.file ? { file: variables.file, filename: variables.filename } : void 0
-        );
-      },
-      onSuccess: (data) => {
-        this.queryClient.invalidateQueries({
-          queryKey: collectionKeys(collection).all
-        });
-        if (PRODUCT_DETAIL_INVALIDATING_COLLECTIONS.has(collection)) {
-          this.queryClient.invalidateQueries({ queryKey: ["products", "detail"] });
-        }
-        options?.onSuccess?.(data);
-      },
-      onError: options?.onError,
-      onSettled: options?.onSettled
-    });
-  }
-  useUpdate(params, options) {
-    const { collection } = params;
-    return (0, import_react_query2.useMutation)({
-      mutationFn: async (variables) => {
-        return await this.collectionClient.from(collection).update(
-          variables.id,
-          variables.data,
-          variables.file ? { file: variables.file, filename: variables.filename } : void 0
-        );
-      },
-      onSuccess: (data) => {
-        this.queryClient.invalidateQueries({
-          queryKey: collectionKeys(collection).all
-        });
-        if (PRODUCT_DETAIL_INVALIDATING_COLLECTIONS.has(collection)) {
-          this.queryClient.invalidateQueries({ queryKey: ["products", "detail"] });
-        }
-        options?.onSuccess?.(data);
-      },
-      onError: options?.onError,
-      onSettled: options?.onSettled
-    });
-  }
-  useRemove(params, options) {
-    const { collection } = params;
-    return (0, import_react_query2.useMutation)({
-      mutationFn: async (id) => {
-        return await this.collectionClient.from(collection).remove(id);
-      },
-      onSuccess: (data) => {
-        this.queryClient.invalidateQueries({
-          queryKey: collectionKeys(collection).all
-        });
-        if (PRODUCT_DETAIL_INVALIDATING_COLLECTIONS.has(collection)) {
-          this.queryClient.invalidateQueries({ queryKey: ["products", "detail"] });
-        }
-        options?.onSuccess?.(data);
-      },
-      onError: options?.onError,
-      onSettled: options?.onSettled
-    });
-  }
-  // ===== Cache Utilities =====
-  invalidateQueries(collection, type) {
-    const queryKey = type ? [collection, type] : [collection];
-    return this.queryClient.invalidateQueries({ queryKey });
-  }
-  getQueryData(collection, type, idOrOptions, options) {
-    if (type === "list") {
-      return this.queryClient.getQueryData(
-        collectionKeys(collection).list(idOrOptions)
-      );
-    }
-    return this.queryClient.getQueryData(
-      collectionKeys(collection).detail(idOrOptions, options)
-    );
-  }
-  setQueryData(collection, type, dataOrId, dataOrOptions, options) {
-    if (type === "list") {
-      this.queryClient.setQueryData(
-        collectionKeys(collection).list(dataOrOptions),
-        dataOrId
-      );
-    } else {
-      this.queryClient.setQueryData(
-        collectionKeys(collection).detail(dataOrId, options),
-        dataOrOptions
-      );
-    }
-  }
-};
-
-// src/core/query/customer-hooks.ts
-var import_react_query3 = require("@tanstack/react-query");
-function createMutation(mutationFn, callbacks, onSuccessExtra) {
-  return (0, import_react_query3.useMutation)({
-    mutationFn,
-    onSuccess: (data) => {
-      onSuccessExtra?.(data);
-      callbacks?.onSuccess?.(data);
-    },
-    onError: callbacks?.onError,
-    onSettled: callbacks?.onSettled
-  });
-}
-var CustomerHooks = class {
-  constructor(queryClient, customerAuth) {
-    this.invalidateMe = () => {
-      this.queryClient.invalidateQueries({ queryKey: customerKeys.me() });
-    };
-    this.queryClient = queryClient;
-    this.customerAuth = customerAuth;
-  }
-  ensureCustomerAuth() {
-    if (!this.customerAuth) {
-      throw createConfigError(
-        "Customer hooks require Client. Use createClient() instead of createServerClient()."
-      );
-    }
-    return this.customerAuth;
-  }
-  // ===== useCustomerMe =====
-  useCustomerMe(options) {
-    return (0, import_react_query3.useQuery)({
-      queryKey: customerKeys.me(),
-      queryFn: async () => {
-        return await this.ensureCustomerAuth().me();
-      },
-      ...options,
-      enabled: (options?.enabled ?? true) && !!this.customerAuth?.isAuthenticated()
-    });
-  }
-  // ===== Mutations =====
-  useCustomerLogin(options) {
-    return createMutation(
-      (data) => this.ensureCustomerAuth().login(data),
-      options,
-      this.invalidateMe
-    );
-  }
-  useCustomerRegister(options) {
-    return createMutation(
-      (data) => this.ensureCustomerAuth().register(data),
-      options
-    );
-  }
-  useCustomerLogout(options) {
-    return (0, import_react_query3.useMutation)({
-      mutationFn: async () => {
-        this.ensureCustomerAuth().logout();
-      },
-      onSuccess: () => {
-        this.queryClient.removeQueries({ queryKey: customerKeys.all });
-        options?.onSuccess?.();
-      },
-      onError: options?.onError,
-      onSettled: options?.onSettled
-    });
-  }
-  useCustomerForgotPassword(options) {
-    return createMutation(
-      (email) => this.ensureCustomerAuth().forgotPassword(email).then(() => {
-      }),
-      options
-    );
-  }
-  useCustomerResetPassword(options) {
-    return createMutation(
-      (data) => this.ensureCustomerAuth().resetPassword(data.token, data.password).then(() => {
-      }),
-      options
-    );
-  }
-  useCustomerRefreshToken(options) {
-    return createMutation(
-      () => this.ensureCustomerAuth().refreshToken(),
-      options,
-      this.invalidateMe
-    );
-  }
-  useCustomerUpdateProfile(options) {
-    return createMutation(
-      (data) => this.ensureCustomerAuth().updateProfile(data),
-      options,
-      this.invalidateMe
-    );
-  }
-  useCustomerChangePassword(options) {
-    return createMutation(
-      (data) => this.ensureCustomerAuth().changePassword(data.currentPassword, data.newPassword).then(() => {
-      }),
-      options
-    );
-  }
-  // ===== Customer Cache Utilities =====
-  invalidateCustomerQueries() {
-    return this.queryClient.invalidateQueries({ queryKey: customerKeys.all });
-  }
-  getCustomerData() {
-    return this.queryClient.getQueryData(customerKeys.me());
-  }
-  setCustomerData(data) {
-    this.queryClient.setQueryData(customerKeys.me(), data);
-  }
-};
-
-// src/core/query/query-hooks.ts
-var QueryHooks = class extends CollectionHooks {
-  constructor(queryClient, collectionClient, customerAuth, commerceClient) {
-    super(queryClient, collectionClient);
-    // --- Customer hooks delegation ---
-    this.useCustomerMe = (...args) => this._customer.useCustomerMe(...args);
-    this.useCustomerLogin = (...args) => this._customer.useCustomerLogin(...args);
-    this.useCustomerRegister = (...args) => this._customer.useCustomerRegister(...args);
-    this.useCustomerLogout = (...args) => this._customer.useCustomerLogout(...args);
-    this.useCustomerForgotPassword = (...args) => this._customer.useCustomerForgotPassword(...args);
-    this.useCustomerResetPassword = (...args) => this._customer.useCustomerResetPassword(...args);
-    this.useCustomerRefreshToken = (...args) => this._customer.useCustomerRefreshToken(...args);
-    this.useCustomerUpdateProfile = (...args) => this._customer.useCustomerUpdateProfile(...args);
-    this.useCustomerChangePassword = (...args) => this._customer.useCustomerChangePassword(...args);
-    // --- Customer cache delegation ---
-    this.invalidateCustomerQueries = () => this._customer.invalidateCustomerQueries();
-    this.getCustomerData = () => this._customer.getCustomerData();
-    this.setCustomerData = (data) => this._customer.setCustomerData(data);
-    this._customer = new CustomerHooks(queryClient, customerAuth);
-    this._commerce = commerceClient;
-  }
-  useProductListingGroupsQuery(params, options) {
-    const queryOptions = params.options;
-    const { placeholderData, ...restOptions } = options ?? {};
-    return (0, import_react_query4.useQuery)({
-      queryKey: productKeys.listingGroups(queryOptions),
-      queryFn: async () => this.collectionClient.requestFindEndpoint(
-        "/api/products/listing-groups/query",
-        { options: queryOptions }
-      ),
-      ...restOptions,
-      ...placeholderData !== void 0 && {
-        placeholderData
-      }
-    });
-  }
-  useSuspenseProductListingGroupsQuery(params, options) {
-    const queryOptions = params.options;
-    return (0, import_react_query4.useSuspenseQuery)({
-      queryKey: productKeys.listingGroups(queryOptions),
-      queryFn: async () => this.collectionClient.requestFindEndpoint(
-        "/api/products/listing-groups/query",
-        { options: queryOptions }
-      ),
-      ...options
-    });
-  }
-  useInfiniteProductListingGroupsQuery(params, options) {
-    const {
-      options: queryOptions,
-      pageSize = 20
-    } = params;
-    return (0, import_react_query4.useInfiniteQuery)({
-      queryKey: productKeys.listingGroupsInfinite(queryOptions),
-      queryFn: async ({ pageParam }) => this.collectionClient.requestFindEndpoint(
-        "/api/products/listing-groups/query",
-        {
-          options: { ...queryOptions, page: pageParam, limit: pageSize }
-        }
-      ),
-      initialPageParam: 1,
-      getNextPageParam: (lastPage) => lastPage.hasNextPage ? lastPage.nextPage : void 0,
-      ...options
-    });
-  }
-  useSuspenseInfiniteProductListingGroupsQuery(params, options) {
-    const {
-      options: queryOptions,
-      pageSize = 20
-    } = params;
-    return (0, import_react_query4.useSuspenseInfiniteQuery)({
-      queryKey: productKeys.listingGroupsInfinite(queryOptions),
-      queryFn: async ({ pageParam }) => this.collectionClient.requestFindEndpoint(
-        "/api/products/listing-groups/query",
-        {
-          options: { ...queryOptions, page: pageParam, limit: pageSize }
-        }
-      ),
-      initialPageParam: 1,
-      getNextPageParam: (lastPage) => lastPage.hasNextPage ? lastPage.nextPage : void 0,
-      ...options
-    });
-  }
-  async prefetchProductListingGroupsQuery(params, options) {
-    const queryOptions = params.options;
-    return this.queryClient.prefetchQuery({
-      queryKey: productKeys.listingGroups(queryOptions),
-      queryFn: async () => this.collectionClient.requestFindEndpoint(
-        "/api/products/listing-groups/query",
-        { options: queryOptions }
-      ),
-      ...options
-    });
-  }
-  async prefetchInfiniteProductListingGroupsQuery(params, options) {
-    const {
-      options: queryOptions,
-      pageSize = 20
-    } = params;
-    return this.queryClient.prefetchInfiniteQuery({
-      queryKey: productKeys.listingGroupsInfinite(queryOptions),
-      queryFn: async ({ pageParam }) => this.collectionClient.requestFindEndpoint(
-        "/api/products/listing-groups/query",
-        {
-          options: { ...queryOptions, page: pageParam, limit: pageSize }
-        }
-      ),
-      initialPageParam: 1,
-      getNextPageParam: (lastPage) => lastPage.hasNextPage ? lastPage.nextPage : void 0,
-      pages: options?.pages ?? 1,
-      staleTime: options?.staleTime
-    });
-  }
-  useProductDetail(params, options) {
-    const discriminator = "slug" in params ? params.slug : params.id;
-    const enabled = options?.enabled !== false && Boolean(discriminator);
-    return (0, import_react_query4.useQuery)({
-      queryKey: productKeys.detail(params),
-      queryFn: () => this._commerce.product.detail(params),
-      enabled
-    });
-  }
-  useProductDetailBySlug(slug, options) {
-    return this.useProductDetail({ slug }, options);
-  }
-  useProductDetailById(id, options) {
-    return this.useProductDetail({ id }, options);
-  }
-};
-
 // src/core/client/client.server.ts
 var ServerClient = class {
   constructor(options) {
@@ -2107,6 +1566,7 @@ var ServerClient = class {
     const serverOptions = {
       publishableKey: this.config.publishableKey,
       secretKey: this.config.secretKey,
+      apiUrl: this.config.apiUrl,
       onRequestId
     };
     this.commerce = new ServerCommerceClient(serverOptions);
@@ -2123,10 +1583,9 @@ var ServerClient = class {
       this.config.secretKey,
       void 0,
       void 0,
-      onRequestId
+      onRequestId,
+      this.config.apiUrl
     );
-    this.queryClient = getQueryClient();
-    this.query = new QueryHooks(this.queryClient, this.collections, void 0, this.commerce);
   }
   getState() {
     return { ...this.state };