@cronvello/shop-sdk 0.1.0 → 0.2.0

package/dist/browser.d.cts

@@ -1,5 +1,5 @@
-import { S as ShopClientOptions, H as HeaderProvider, a as ShopClient } from './error-C-cJ6OgX.cjs';
-export { B as BaseUrlProvider, M as MaybePromise, b as SHOP_API_URL, c as ShopApiError, d as ShopAuthType, e as ShopConfigurationError, f as ShopRequestContext, g as ShopRequestOptions, h as ShopRoute, i as ShopRouteAuth, j as ShopRouteBody, k as ShopRouteInput, l as ShopRouteKey, m as ShopRouteMethod, n as ShopRouteParams, o as ShopRouteQuery, p as ShopRouteResponse, q as ShopRouteResponseData } from './error-C-cJ6OgX.cjs';
+import { S as ShopClientOptions, H as HeaderProvider, a as ShopClient } from './error-C5_qRXMp.cjs';
+export { B as BaseUrlProvider, C as CONTRACT_SHA256, M as MaybePromise, b as SHOP_API_URL, c as ShopApiError, d as ShopAuthType, e as ShopConfigurationError, f as ShopContractStatus, g as ShopDiagnoseOptions, h as ShopDiagnosis, i as ShopRequestContext, j as ShopRequestOptions, k as ShopRoute, l as ShopRouteAuth, m as ShopRouteBody, n as ShopRouteInput, o as ShopRouteKey, p as ShopRouteMethod, q as ShopRouteParams, r as ShopRouteQuery, s as ShopRouteResponse, t as ShopRouteResponseData, u as diagnoseShop } from './error-C5_qRXMp.cjs';
 import './index-CIpUb0vL.cjs';
 
 type ShopBrowserClientOptions = Omit<ShopClientOptions, "headers"> & {

package/dist/browser.d.ts

@@ -1,5 +1,5 @@
-import { S as ShopClientOptions, H as HeaderProvider, a as ShopClient } from './error-BFzxyQkW.js';
-export { B as BaseUrlProvider, M as MaybePromise, b as SHOP_API_URL, c as ShopApiError, d as ShopAuthType, e as ShopConfigurationError, f as ShopRequestContext, g as ShopRequestOptions, h as ShopRoute, i as ShopRouteAuth, j as ShopRouteBody, k as ShopRouteInput, l as ShopRouteKey, m as ShopRouteMethod, n as ShopRouteParams, o as ShopRouteQuery, p as ShopRouteResponse, q as ShopRouteResponseData } from './error-BFzxyQkW.js';
+import { S as ShopClientOptions, H as HeaderProvider, a as ShopClient } from './error-Do0kyiZ6.js';
+export { B as BaseUrlProvider, C as CONTRACT_SHA256, M as MaybePromise, b as SHOP_API_URL, c as ShopApiError, d as ShopAuthType, e as ShopConfigurationError, f as ShopContractStatus, g as ShopDiagnoseOptions, h as ShopDiagnosis, i as ShopRequestContext, j as ShopRequestOptions, k as ShopRoute, l as ShopRouteAuth, m as ShopRouteBody, n as ShopRouteInput, o as ShopRouteKey, p as ShopRouteMethod, q as ShopRouteParams, r as ShopRouteQuery, s as ShopRouteResponse, t as ShopRouteResponseData, u as diagnoseShop } from './error-Do0kyiZ6.js';
 import './index-CIpUb0vL.js';
 
 type ShopBrowserClientOptions = Omit<ShopClientOptions, "headers"> & {

package/dist/browser.js

@@ -5270,7 +5270,7 @@ function createShopClient(options = {}) {
   const defaultTimeoutMs = options.timeoutMs ?? 3e4;
   const defaultRetries = options.retries ?? 2;
   const retryDelayMs = options.retryDelayMs ?? 250;
-  async function resolveBaseUrl() {
+  async function resolveBaseUrl2() {
     const value = typeof baseUrl === "function" ? await baseUrl() : baseUrl;
     return normalizeBaseUrl(value);
   }
@@ -5292,7 +5292,7 @@ function createShopClient(options = {}) {
     const body = hasBody ? JSON.stringify(values.body) : void 0;
     const retries = Math.max(0, requestOptions.retries ?? defaultRetries);
     const canRetry = SAFE_METHODS.has(route.method) || requestOptions.retryUnsafe === true;
-    const resolvedBaseUrl = await resolveBaseUrl();
+    const resolvedBaseUrl = await resolveBaseUrl2();
     for (let attempt = 0; ; attempt += 1) {
       const timeout = createRequestSignal(requestOptions.signal, requestOptions.timeoutMs ?? defaultTimeoutMs);
       try {
@@ -5369,6 +5369,102 @@ function createShopClient(options = {}) {
   return { baseUrl, request, requestText, requestRaw };
 }
 
+// src/contract-hash.ts
+var CONTRACT_SHA256 = "335eed391a2786a4f7f010b056d2a6a5b49d9e1244960a15516a5d77b93693b5";
+
+// src/client/diagnose.ts
+var SDK_VERSION = "0.2.0" ;
+async function resolveBaseUrl(options) {
+  const provider = options.client?.baseUrl ?? options.baseUrl ?? SHOP_API_URL;
+  const value = typeof provider === "function" ? await provider() : provider;
+  return normalizeBaseUrl(value);
+}
+async function diagnoseShop(options = {}) {
+  const checkedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const baseUrl = await resolveBaseUrl(options);
+  const doFetch = options.fetch ?? globalThis.fetch;
+  const timeoutMs = options.timeoutMs ?? 5e3;
+  const base = {
+    ok: false,
+    baseUrl,
+    sdkVersion: SDK_VERSION,
+    reachable: false,
+    contract: { status: "unknown", sdk: CONTRACT_SHA256, live: null, files: null },
+    problems: [],
+    checkedAt
+  };
+  if (typeof doFetch !== "function") {
+    return { ...base, problems: ["No fetch implementation available; pass `fetch` explicitly."] };
+  }
+  const controller = new AbortController();
+  const onAbort = () => controller.abort(options.signal?.reason);
+  options.signal?.addEventListener("abort", onAbort, { once: true });
+  if (options.signal?.aborted) controller.abort(options.signal.reason);
+  const timer = setTimeout(() => controller.abort(new Error(`Contract probe timed out after ${timeoutMs}ms`)), timeoutMs);
+  let response;
+  try {
+    response = await doFetch(`${baseUrl}/health/contract`, {
+      method: "GET",
+      headers: { accept: "application/json" },
+      signal: controller.signal
+    });
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    return { ...base, problems: [`node-shop at ${baseUrl} could not be reached: ${detail}`] };
+  } finally {
+    clearTimeout(timer);
+    options.signal?.removeEventListener("abort", onAbort);
+  }
+  if (response.status === 404) {
+    return {
+      ...base,
+      reachable: true,
+      problems: [
+        `node-shop at ${baseUrl} does not serve GET /health/contract, so the contract cannot be verified. Deploy a node-shop that includes it.`
+      ]
+    };
+  }
+  if (!response.ok) {
+    return {
+      ...base,
+      reachable: true,
+      problems: [`node-shop at ${baseUrl} answered ${response.status} for GET /health/contract; contract not verified.`]
+    };
+  }
+  let body;
+  try {
+    body = await response.json();
+  } catch {
+    return { ...base, reachable: true, problems: [`node-shop at ${baseUrl} returned a non-JSON contract fingerprint.`] };
+  }
+  const live = typeof body.contractSha256 === "string" && body.contractSha256 ? body.contractSha256 : null;
+  const files = typeof body.files === "number" ? body.files : null;
+  if (!live) {
+    return {
+      ...base,
+      reachable: true,
+      contract: { ...base.contract, files },
+      problems: [`node-shop at ${baseUrl} could not compute its own contract fingerprint; contract not verified.`]
+    };
+  }
+  if (live !== CONTRACT_SHA256) {
+    return {
+      ...base,
+      reachable: true,
+      contract: { status: "drift", sdk: CONTRACT_SHA256, live, files },
+      problems: [
+        `Contract drift: node-shop at ${baseUrl} speaks ${live.slice(0, 12)}, @cronvello/shop-sdk ${SDK_VERSION} was built against ${CONTRACT_SHA256.slice(0, 12)}. Pin a newer SDK version, or deploy the node-shop the SDK was built from.`
+      ]
+    };
+  }
+  return {
+    ...base,
+    ok: true,
+    reachable: true,
+    contract: { status: "match", sdk: CONTRACT_SHA256, live, files }
+  };
+}
+
 // src/browser.ts
 function createShopBrowserClient(options = {}) {
   const configured = options.headers;
@@ -5385,6 +5481,6 @@ function createShopBrowserClient(options = {}) {
   });
 }
 
-export { SHOP_API_URL, ShopApiError, ShopConfigurationError, createShopBrowserClient };
+export { CONTRACT_SHA256, SHOP_API_URL, ShopApiError, ShopConfigurationError, createShopBrowserClient, diagnoseShop };
 //# sourceMappingURL=browser.js.map
 //# sourceMappingURL=browser.js.map