@replohq/sdk 0.1.0

package/gateways/canopy-api.js

@@ -0,0 +1,197 @@
+import { z } from "zod";
+import { cartSchema } from "../cart/cart-schema";
+import { getEnv } from "../env";
+import { CanopyError } from "../lib/canopy-error";
+import { buildBaseUrl } from "../lib/url-utils";
+class CanopyApiGatewayError extends CanopyError {
+  statusCode;
+  constructor(config) {
+    const resolvedStatusCode = config.statusCode ?? 500;
+    super({
+      message: config.message,
+      cause: config.cause,
+      additionalData: {
+        ...config.additionalData,
+        statusCode: resolvedStatusCode
+      }
+    });
+    this.statusCode = resolvedStatusCode;
+  }
+}
+class UnknownCanopyApiError extends CanopyApiGatewayError {
+  constructor(config) {
+    super({ ...config, statusCode: 502 });
+  }
+}
+const loaderInvokeResponseSchema = z.object({
+  data: z.unknown(),
+  meta: z.object({
+    cache: z.object({
+      hit: z.boolean(),
+      ttlSeconds: z.number()
+    })
+  }).optional()
+});
+class CanopyApiGateway {
+  apiHost;
+  baseUrl;
+  constructor(apiHost) {
+    this.apiHost = apiHost;
+    this.baseUrl = buildBaseUrl(apiHost);
+  }
+  static REQUEST_TIMEOUT_MILLISECONDS = 1e4;
+  static async setup() {
+    const env = await getEnv();
+    return new CanopyApiGateway(env.CANOPY_API_HOST);
+  }
+  async _post(url, body) {
+    const abortController = new AbortController();
+    const timeoutId = setTimeout(() => {
+      abortController.abort();
+    }, CanopyApiGateway.REQUEST_TIMEOUT_MILLISECONDS);
+    try {
+      return await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        signal: abortController.signal
+      });
+    } catch (error) {
+      let message = `Failed to POST to canopy-api at ${url}: ${error}`;
+      if (process.env.NODE_ENV !== "production") {
+        message += `
+
+apiHost: ${this.apiHost}
+If you're running locally, make sure the canopy-api cloudflare worker is running. You may need to restart the dev server.`;
+      }
+      throw new UnknownCanopyApiError({ message, cause: error });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  async _get(url) {
+    const abortController = new AbortController();
+    const timeoutId = setTimeout(() => {
+      abortController.abort();
+    }, CanopyApiGateway.REQUEST_TIMEOUT_MILLISECONDS);
+    try {
+      return await fetch(url, { signal: abortController.signal });
+    } catch (error) {
+      let message = `Failed to GET from canopy-api at ${url}: ${error}`;
+      if (process.env.NODE_ENV !== "production") {
+        message += `
+
+apiHost: ${this.apiHost}
+If you're running locally, make sure the canopy-api cloudflare worker is running. You may need to restart the dev server.`;
+      }
+      throw new UnknownCanopyApiError({ message, cause: error });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  async invokeLoader({
+    loaderKey,
+    args
+  }) {
+    const env = await getEnv();
+    const response = await this._post(`${this.baseUrl}/api/v1/loaders/invoke`, {
+      projectId: env.PROJECT_ID,
+      loaderKey,
+      args
+    });
+    if (!response.ok) {
+      const errorBody = await response.text().catch(() => "");
+      throw new CanopyApiGatewayError({
+        message: `Failed to invoke loader ${loaderKey}: ${response.status} ${response.statusText}${errorBody ? ` \u2014 ${errorBody}` : ""}`,
+        statusCode: response.status
+      });
+    }
+    return loaderInvokeResponseSchema.parse(await response.json());
+  }
+  // ---------------------------------------------------------------------------
+  // Cart operations (canopy-api-backed ExternalCart)
+  // ---------------------------------------------------------------------------
+  async _cartPost(path, body) {
+    const env = await getEnv();
+    const url = `${this.baseUrl}/api/v1/cart${path}`;
+    const abortController = new AbortController();
+    const timeoutId = setTimeout(() => {
+      abortController.abort();
+    }, CanopyApiGateway.REQUEST_TIMEOUT_MILLISECONDS);
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ ...body, projectId: env.PROJECT_ID }),
+        signal: abortController.signal
+      });
+    } catch (error) {
+      throw new UnknownCanopyApiError({
+        message: `Failed to POST cart operation to ${url}: ${error}`,
+        cause: error
+      });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+    if (!response.ok) {
+      const text = await response.text().catch(() => "");
+      throw new CanopyApiGatewayError({
+        message: `Cart operation ${path} failed: ${response.status} ${response.statusText} \u2014 ${text}`,
+        statusCode: response.status
+      });
+    }
+    const json = await response.json();
+    return cartSchema.parse(json.data);
+  }
+  async cartGet({ cartId }) {
+    try {
+      return await this._cartPost("/get", { cartId });
+    } catch (error) {
+      if (error instanceof CanopyApiGatewayError && error.statusCode === 404) {
+        return null;
+      }
+      throw error;
+    }
+  }
+  async cartCreate(options) {
+    return this._cartPost("/create", {
+      lines: options?.lines,
+      discountCodes: options?.discountCodes
+    });
+  }
+  async cartAddLines({
+    cartId,
+    lines
+  }) {
+    return this._cartPost("/add-lines", { cartId, lines });
+  }
+  async cartUpdateLines({
+    cartId,
+    lines
+  }) {
+    return this._cartPost("/update-lines", { cartId, lines });
+  }
+  async cartRemoveLines({
+    cartId,
+    lineIds
+  }) {
+    return this._cartPost("/remove-lines", { cartId, lineIds });
+  }
+  async cartUpdateDiscountCodes({
+    cartId,
+    discountCodes
+  }) {
+    return this._cartPost("/update-discount-codes", { cartId, discountCodes });
+  }
+}
+async function getCanopyApiGateway() {
+  return CanopyApiGateway.setup();
+}
+export {
+  CanopyApiGatewayError,
+  getCanopyApiGateway
+};
+//# sourceMappingURL=canopy-api.js.map

package/gateways/canopy-api.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../gateways/canopy-api.ts"],
+  "sourcesContent": ["import type { Cart } from \"../cart/cart-schema\";\n\nimport { z } from \"zod\";\n\nimport { cartSchema } from \"../cart/cart-schema\";\nimport { getEnv } from \"../env\";\nimport { CanopyError } from \"../lib/canopy-error\";\nimport { buildBaseUrl } from \"../lib/url-utils\";\n\ntype CanopyApiGatewayErrorConfig = {\n  message: string;\n  statusCode?: number;\n  cause?: unknown;\n  additionalData?: Record<string, unknown>;\n};\n\nexport class CanopyApiGatewayError extends CanopyError {\n  statusCode: number;\n\n  constructor(config: CanopyApiGatewayErrorConfig) {\n    const resolvedStatusCode = config.statusCode ?? 500;\n    super({\n      message: config.message,\n      cause: config.cause,\n      additionalData: {\n        ...config.additionalData,\n        statusCode: resolvedStatusCode,\n      },\n    });\n    this.statusCode = resolvedStatusCode;\n  }\n}\n\nclass UnknownCanopyApiError extends CanopyApiGatewayError {\n  constructor(config: Omit<CanopyApiGatewayErrorConfig, \"statusCode\">) {\n    super({ ...config, statusCode: 502 });\n  }\n}\n\nconst loaderInvokeResponseSchema = z.object({\n  data: z.unknown(),\n  meta: z\n    .object({\n      cache: z.object({\n        hit: z.boolean(),\n        ttlSeconds: z.number(),\n      }),\n    })\n    .optional(),\n});\n\nclass CanopyApiGateway {\n  private apiHost: string;\n  private baseUrl: string;\n  constructor(apiHost: string) {\n    this.apiHost = apiHost;\n    this.baseUrl = buildBaseUrl(apiHost);\n  }\n\n  private static readonly REQUEST_TIMEOUT_MILLISECONDS = 10_000;\n\n  static async setup() {\n    const env = await getEnv();\n\n    return new CanopyApiGateway(env.CANOPY_API_HOST);\n  }\n\n  private async _post(url: string, body: unknown) {\n    const abortController = new AbortController();\n    const timeoutId = setTimeout(() => {\n      abortController.abort();\n    }, CanopyApiGateway.REQUEST_TIMEOUT_MILLISECONDS);\n\n    try {\n      return await fetch(url, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(body),\n        signal: abortController.signal,\n      });\n    } catch (error) {\n      let message = `Failed to POST to canopy-api at ${url}: ${error}`;\n      if (process.env.NODE_ENV !== \"production\") {\n        message += `\\n\\napiHost: ${this.apiHost}\\nIf you're running locally, make sure the canopy-api cloudflare worker is running. You may need to restart the dev server.`;\n      }\n      throw new UnknownCanopyApiError({ message, cause: error });\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private async _get(url: string) {\n    const abortController = new AbortController();\n    const timeoutId = setTimeout(() => {\n      abortController.abort();\n    }, CanopyApiGateway.REQUEST_TIMEOUT_MILLISECONDS);\n\n    try {\n      return await fetch(url, { signal: abortController.signal });\n    } catch (error) {\n      let message = `Failed to GET from canopy-api at ${url}: ${error}`;\n      if (process.env.NODE_ENV !== \"production\") {\n        message += `\\n\\napiHost: ${this.apiHost}\\nIf you're running locally, make sure the canopy-api cloudflare worker is running. You may need to restart the dev server.`;\n      }\n      throw new UnknownCanopyApiError({ message, cause: error });\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  async invokeLoader({\n    loaderKey,\n    args,\n  }: {\n    loaderKey: string;\n    args: Record<string, unknown>;\n  }) {\n    const env = await getEnv();\n    const response = await this._post(`${this.baseUrl}/api/v1/loaders/invoke`, {\n      projectId: env.PROJECT_ID,\n      loaderKey,\n      args,\n    });\n\n    if (!response.ok) {\n      const errorBody = await response.text().catch(() => \"\");\n      throw new CanopyApiGatewayError({\n        message: `Failed to invoke loader ${loaderKey}: ${response.status} ${response.statusText}${errorBody ? ` \u2014 ${errorBody}` : \"\"}`,\n        statusCode: response.status,\n      });\n    }\n\n    return loaderInvokeResponseSchema.parse(await response.json());\n  }\n\n  // ---------------------------------------------------------------------------\n  // Cart operations (canopy-api-backed ExternalCart)\n  // ---------------------------------------------------------------------------\n\n  private async _cartPost(\n    path: string,\n    body: Record<string, unknown>,\n  ): Promise<Cart> {\n    const env = await getEnv();\n    const url = `${this.baseUrl}/api/v1/cart${path}`;\n\n    const abortController = new AbortController();\n    const timeoutId = setTimeout(() => {\n      abortController.abort();\n    }, CanopyApiGateway.REQUEST_TIMEOUT_MILLISECONDS);\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ ...body, projectId: env.PROJECT_ID }),\n        signal: abortController.signal,\n      });\n    } catch (error) {\n      throw new UnknownCanopyApiError({\n        message: `Failed to POST cart operation to ${url}: ${error}`,\n        cause: error,\n      });\n    } finally {\n      clearTimeout(timeoutId);\n    }\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\");\n      throw new CanopyApiGatewayError({\n        message: `Cart operation ${path} failed: ${response.status} ${response.statusText} \u2014 ${text}`,\n        statusCode: response.status,\n      });\n    }\n\n    // Legacy cast - may or may not be necessary\n    // eslint-disable-next-line replo/no-as-cast\n    const json = (await response.json()) as { data: unknown };\n    return cartSchema.parse(json.data);\n  }\n\n  async cartGet({ cartId }: { cartId: string }): Promise<Cart | null> {\n    try {\n      return await this._cartPost(\"/get\", { cartId });\n    } catch (error) {\n      if (error instanceof CanopyApiGatewayError && error.statusCode === 404) {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  async cartCreate(options?: {\n    lines?: {\n      merchandiseId: string;\n      quantity: number;\n      attributes?: { key: string; value: string }[];\n      sellingPlanId?: string | null;\n    }[];\n    discountCodes?: string[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/create\", {\n      lines: options?.lines,\n      discountCodes: options?.discountCodes,\n    });\n  }\n\n  async cartAddLines({\n    cartId,\n    lines,\n  }: {\n    cartId: string;\n    lines: {\n      merchandiseId: string;\n      quantity: number;\n      attributes?: { key: string; value: string }[];\n      sellingPlanId?: string | null;\n    }[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/add-lines\", { cartId, lines });\n  }\n\n  async cartUpdateLines({\n    cartId,\n    lines,\n  }: {\n    cartId: string;\n    lines: {\n      lineId: string;\n      quantity: number;\n      attributes?: { key: string; value: string }[];\n      sellingPlanId?: string | null;\n    }[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/update-lines\", { cartId, lines });\n  }\n\n  async cartRemoveLines({\n    cartId,\n    lineIds,\n  }: {\n    cartId: string;\n    lineIds: string[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/remove-lines\", { cartId, lineIds });\n  }\n\n  async cartUpdateDiscountCodes({\n    cartId,\n    discountCodes,\n  }: {\n    cartId: string;\n    discountCodes: string[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/update-discount-codes\", { cartId, discountCodes });\n  }\n}\n\nexport async function getCanopyApiGateway() {\n  return CanopyApiGateway.setup();\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/hooks/use-client-value.d.ts

@@ -0,0 +1,10 @@
+/**
+ * NOTE (Max, 2025-09-15): This hook is to be used for values that aren't available on the server (such as window.location).
+ *
+ * This hook will use a dummy value both on the server & on hydration. Then,
+ * after hydration, this useEffect will update the value to the actual value.
+ *
+ * The useEffect doesn't have any dependencies - it's designed to only run once. So if you expect your read() function to return
+ * different values through the lifecycle of the component, you should not use this hook.
+ */
+export declare function useClientValue<ValueType>(readValue: () => ValueType, initialValue: ValueType): ValueType;

package/hooks/use-client-value.js

@@ -0,0 +1,12 @@
+import * as React from "react";
+function useClientValue(readValue, initialValue) {
+  const [value, setValue] = React.useState(initialValue);
+  React.useEffect(() => {
+    setValue(readValue());
+  }, []);
+  return value;
+}
+export {
+  useClientValue
+};
+//# sourceMappingURL=use-client-value.js.map

package/hooks/use-client-value.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../hooks/use-client-value.ts"],
+  "sourcesContent": ["import * as React from \"react\";\n\n/**\n * NOTE (Max, 2025-09-15): This hook is to be used for values that aren't available on the server (such as window.location).\n *\n * This hook will use a dummy value both on the server & on hydration. Then,\n * after hydration, this useEffect will update the value to the actual value.\n *\n * The useEffect doesn't have any dependencies - it's designed to only run once. So if you expect your read() function to return\n * different values through the lifecycle of the component, you should not use this hook.\n */\n\nexport function useClientValue<ValueType>(\n  readValue: () => ValueType,\n  initialValue: ValueType,\n) {\n  const [value, setValue] = React.useState<ValueType>(initialValue);\n\n  // eslint-disable-next-line replo/no-use-effect -- (Noah, 2026-07-20): Legacy effect - may or may not be necessary\n  React.useEffect(() => {\n    setValue(readValue());\n  }, []);\n  return value;\n}\n"],
+  "mappings": "AAAA,YAAY,WAAW;AAYhB,SAAS,eACd,WACA,cACA;AACA,QAAM,CAAC,OAAO,QAAQ,IAAI,MAAM,SAAoB,YAAY;AAGhE,QAAM,UAAU,MAAM;AACpB,aAAS,UAAU,CAAC;AAAA,EACtB,GAAG,CAAC,CAAC;AACL,SAAO;AACT;",
+  "names": []
+}

package/hooks/use-formatted-price.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Use `useFormattedPrice` to format prices with proper currency and locale.
+ * @returns A formatted price string based on the price and currency code. It
+ * already takes into account the user's locale/browser.
+ * @example
+ * ```tsx
+ * import { useFormattedPrice } from "@replohq/sdk/hooks/use-formatted-price";
+ *
+ * const originalPrice = 1999; // integer minor units
+ * const originalPriceFormatted = useFormattedPrice(originalPrice, "USD");
+ * // Display the formatted price
+ * <p>{originalPriceFormatted}</p>;
+ * ```
+ */
+export declare const useFormattedPrice: (price: number | null, currency: string | null) => string | null;

package/hooks/use-formatted-price.js

@@ -0,0 +1,20 @@
+import { formatAmount } from "../_vendor/schemas/money.mjs";
+import { useClientValue } from "./use-client-value";
+const useFormattedPrice = (price, currency) => {
+  const navigatorLanguage = useClientValue(
+    () => window.navigator.language,
+    "en-US"
+  );
+  if (price === null) {
+    return null;
+  }
+  return formatAmount({
+    amount: price,
+    currencyCode: currency ?? "USD",
+    locale: navigatorLanguage
+  });
+};
+export {
+  useFormattedPrice
+};
+//# sourceMappingURL=use-formatted-price.js.map

package/hooks/use-formatted-price.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../hooks/use-formatted-price.ts"],
+  "sourcesContent": ["/**\n * Use useFormattedPrice() hook to display prices with proper currency symbols and formatting. Pass in a price in integer minor units (Stripe convention) and a currency code (e.g., 1999 and \"USD\") and it returns a formatted string like \"$19.99\".\n * @module\n */\nimport { formatAmount } from \"schemas/money\";\n\nimport { useClientValue } from \"./use-client-value\";\n\n/**\n * Use `useFormattedPrice` to format prices with proper currency and locale.\n * @returns A formatted price string based on the price and currency code. It\n * already takes into account the user's locale/browser.\n * @example\n * ```tsx\n * import { useFormattedPrice } from \"@replohq/sdk/hooks/use-formatted-price\";\n *\n * const originalPrice = 1999; // integer minor units\n * const originalPriceFormatted = useFormattedPrice(originalPrice, \"USD\");\n * // Display the formatted price\n * <p>{originalPriceFormatted}</p>;\n * ```\n */\nexport const useFormattedPrice = (\n  price: number | null,\n  currency: string | null,\n) => {\n  const navigatorLanguage = useClientValue(\n    () => window.navigator.language,\n    \"en-US\",\n  );\n\n  // NOTE (Max, 2026-08-03): guard on null, not falsiness \u2014 0 is a real amount\n  // (a free item), so `if (!price)` would render no price at all for it.\n  if (price === null) {\n    return null;\n  }\n\n  return formatAmount({\n    amount: price,\n    currencyCode: currency ?? \"USD\",\n    locale: navigatorLanguage,\n  });\n};\n"],
+  "mappings": "AAIA,SAAS,oBAAoB;AAE7B,SAAS,sBAAsB;AAgBxB,MAAM,oBAAoB,CAC/B,OACA,aACG;AACH,QAAM,oBAAoB;AAAA,IACxB,MAAM,OAAO,UAAU;AAAA,IACvB;AAAA,EACF;AAIA,MAAI,UAAU,MAAM;AAClB,WAAO;AAAA,EACT;AAEA,SAAO,aAAa;AAAA,IAClB,QAAQ;AAAA,IACR,cAAc,YAAY;AAAA,IAC1B,QAAQ;AAAA,EACV,CAAC;AACH;",
+  "names": []
+}

package/lib/canopy-error.d.ts

@@ -0,0 +1,25 @@
+export type CanopyErrorConfig = {
+    /**
+     * Message of the error. If not provided, defaults to the error's class name.
+     */
+    message?: string;
+    /**
+     * Additional context about the error (ids, contextual variables, etc.),
+     * surfaced when the error is logged.
+     */
+    additionalData?: Record<string, unknown>;
+    /**
+     * Original cause of the error, useful when catching and re-throwing with more
+     * context.
+     */
+    cause?: unknown;
+};
+/**
+ * Base error that all SDK errors inherit from. Deliberately minimal and
+ * self-contained; it does not depend on the `schemas` workspace package.
+ */
+export declare abstract class CanopyError extends Error {
+    config: CanopyErrorConfig;
+    id: string;
+    constructor(config: CanopyErrorConfig);
+}

package/lib/canopy-error.js

@@ -0,0 +1,24 @@
+class CanopyError extends Error {
+  config;
+  id;
+  constructor(config) {
+    super(config.message);
+    this.message = config.message ?? this.constructor.name;
+    this.config = config;
+    this.id = crypto.randomUUID();
+    const cause = config.cause;
+    if (cause) {
+      this.cause = cause;
+      if (cause instanceof CanopyError) {
+        this.config.additionalData = {
+          ...this.config.additionalData,
+          ...cause.config.additionalData
+        };
+      }
+    }
+  }
+}
+export {
+  CanopyError
+};
+//# sourceMappingURL=canopy-error.js.map

package/lib/canopy-error.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../lib/canopy-error.ts"],
+  "sourcesContent": ["// NOTE (Ryan, 2026-07-23, REPL-27611): Local error base for the SDK's\n// published-page code. Mirrors the minimal surface of `schemas`' `ReploError`\n// (a `config` bag, a stable `id`, and cause chaining) that canopy's scoped\n// error classes actually use, so nothing shipped to a generated site imports\n// from `schemas`.\n\nexport type CanopyErrorConfig = {\n  /**\n   * Message of the error. If not provided, defaults to the error's class name.\n   */\n  message?: string;\n  /**\n   * Additional context about the error (ids, contextual variables, etc.),\n   * surfaced when the error is logged.\n   */\n  additionalData?: Record<string, unknown>;\n  /**\n   * Original cause of the error, useful when catching and re-throwing with more\n   * context.\n   */\n  cause?: unknown;\n};\n\n/**\n * Base error that all SDK errors inherit from. Deliberately minimal and\n * self-contained; it does not depend on the `schemas` workspace package.\n */\nexport abstract class CanopyError extends Error {\n  config: CanopyErrorConfig;\n  id: string;\n\n  constructor(config: CanopyErrorConfig) {\n    super(config.message);\n    this.message = config.message ?? this.constructor.name;\n    this.config = config;\n    // crypto.randomUUID is natively available in browsers, Node, and the\n    // Cloudflare Workers runtime \u2014 the three environments the SDK runs in.\n    this.id = crypto.randomUUID();\n\n    const cause = config.cause;\n    if (cause) {\n      this.cause = cause;\n      if (cause instanceof CanopyError) {\n        this.config.additionalData = {\n          ...this.config.additionalData,\n          ...cause.config.additionalData,\n        };\n      }\n    }\n  }\n}\n"],
+  "mappings": "AA2BO,MAAe,oBAAoB,MAAM;AAAA,EAC9C;AAAA,EACA;AAAA,EAEA,YAAY,QAA2B;AACrC,UAAM,OAAO,OAAO;AACpB,SAAK,UAAU,OAAO,WAAW,KAAK,YAAY;AAClD,SAAK,SAAS;AAGd,SAAK,KAAK,OAAO,WAAW;AAE5B,UAAM,QAAQ,OAAO;AACrB,QAAI,OAAO;AACT,WAAK,QAAQ;AACb,UAAI,iBAAiB,aAAa;AAChC,aAAK,OAAO,iBAAiB;AAAA,UAC3B,GAAG,KAAK,OAAO;AAAA,UACf,GAAG,MAAM,OAAO;AAAA,QAClB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/lib/get-query-client.d.ts

@@ -0,0 +1,2 @@
+import { QueryClient } from "@tanstack/react-query";
+export declare function getQueryClient(): QueryClient;

package/lib/get-query-client.js

@@ -0,0 +1,34 @@
+import {
+  defaultShouldDehydrateQuery,
+  isServer,
+  QueryClient
+} from "@tanstack/react-query";
+const STALE_TIME_MILLISECONDS = 60 * 1e3;
+const makeQueryClient = () => {
+  return new QueryClient({
+    defaultOptions: {
+      queries: {
+        staleTime: STALE_TIME_MILLISECONDS
+      },
+      dehydrate: {
+        shouldDehydrateQuery: (query) => {
+          return defaultShouldDehydrateQuery(query) || query.state.status === "pending";
+        }
+      }
+    }
+  });
+};
+let browserQueryClient;
+function getQueryClient() {
+  if (isServer) {
+    return makeQueryClient();
+  }
+  if (!browserQueryClient) {
+    browserQueryClient = makeQueryClient();
+  }
+  return browserQueryClient;
+}
+export {
+  getQueryClient
+};
+//# sourceMappingURL=get-query-client.js.map

package/lib/get-query-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../lib/get-query-client.ts"],
+  "sourcesContent": ["import {\n  defaultShouldDehydrateQuery,\n  isServer,\n  QueryClient,\n} from \"@tanstack/react-query\";\n\nconst STALE_TIME_MILLISECONDS = 60 * 1000;\n\nconst makeQueryClient = () => {\n  return new QueryClient({\n    defaultOptions: {\n      queries: {\n        staleTime: STALE_TIME_MILLISECONDS,\n      },\n      dehydrate: {\n        shouldDehydrateQuery: (query) => {\n          return (\n            defaultShouldDehydrateQuery(query) ||\n            query.state.status === \"pending\"\n          );\n        },\n      },\n    },\n  });\n};\n\nlet browserQueryClient: QueryClient | undefined;\n\nexport function getQueryClient() {\n  if (isServer) {\n    return makeQueryClient();\n  }\n\n  if (!browserQueryClient) {\n    browserQueryClient = makeQueryClient();\n  }\n\n  return browserQueryClient;\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,MAAM,0BAA0B,KAAK;AAErC,MAAM,kBAAkB,MAAM;AAC5B,SAAO,IAAI,YAAY;AAAA,IACrB,gBAAgB;AAAA,MACd,SAAS;AAAA,QACP,WAAW;AAAA,MACb;AAAA,MACA,WAAW;AAAA,QACT,sBAAsB,CAAC,UAAU;AAC/B,iBACE,4BAA4B,KAAK,KACjC,MAAM,MAAM,WAAW;AAAA,QAE3B;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEA,IAAI;AAEG,SAAS,iBAAiB;AAC/B,MAAI,UAAU;AACZ,WAAO,gBAAgB;AAAA,EACzB;AAEA,MAAI,CAAC,oBAAoB;AACvB,yBAAqB,gBAAgB;AAAA,EACvC;AAEA,SAAO;AACT;",
+  "names": []
+}

package/lib/integration-utils.d.ts

@@ -0,0 +1,2 @@
+export type CheckoutProvider = "shopify" | "stripe" | "none";
+export declare function getCheckoutProvider(): Promise<CheckoutProvider>;

package/lib/integration-utils.js

@@ -0,0 +1,9 @@
+import { getEnv } from "../env";
+async function getCheckoutProvider() {
+  const env = await getEnv();
+  return env.CHECKOUT_PROVIDER ?? "none";
+}
+export {
+  getCheckoutProvider
+};
+//# sourceMappingURL=integration-utils.js.map

package/lib/integration-utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../lib/integration-utils.ts"],
+  "sourcesContent": ["import { getEnv } from \"../env\";\n\nexport type CheckoutProvider = \"shopify\" | \"stripe\" | \"none\";\n\nexport async function getCheckoutProvider(): Promise<CheckoutProvider> {\n  const env = await getEnv();\n  return env.CHECKOUT_PROVIDER ?? \"none\";\n}\n"],
+  "mappings": "AAAA,SAAS,cAAc;AAIvB,eAAsB,sBAAiD;AACrE,QAAM,MAAM,MAAM,OAAO;AACzB,SAAO,IAAI,qBAAqB;AAClC;",
+  "names": []
+}

package/lib/shopify-utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Utility functions for working with Shopify IDs and GIDs
+ */
+/**
+ * Converts a legacy resource ID to a Shopify GraphQL ID
+ * @param id - The legacy resource ID (e.g., "123456")
+ * @param type - The Shopify resource type
+ * @returns The full Shopify GID (e.g., "gid://shopify/ProductVariant/123456")
+ */
+export declare function convertLegacyResourceIdToGraphQLId(id: string, type: "Product" | "ProductVariant"): string;

package/lib/shopify-utils.js

@@ -0,0 +1,7 @@
+function convertLegacyResourceIdToGraphQLId(id, type) {
+  return `gid://shopify/${type}/${id}`;
+}
+export {
+  convertLegacyResourceIdToGraphQLId
+};
+//# sourceMappingURL=shopify-utils.js.map

package/lib/shopify-utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../lib/shopify-utils.ts"],
+  "sourcesContent": ["/**\n * Utility functions for working with Shopify IDs and GIDs\n */\n\n/**\n * Converts a legacy resource ID to a Shopify GraphQL ID\n * @param id - The legacy resource ID (e.g., \"123456\")\n * @param type - The Shopify resource type\n * @returns The full Shopify GID (e.g., \"gid://shopify/ProductVariant/123456\")\n */\nexport function convertLegacyResourceIdToGraphQLId(\n  id: string,\n  type: \"Product\" | \"ProductVariant\",\n): string {\n  return `gid://shopify/${type}/${id}`;\n}\n"],
+  "mappings": "AAUO,SAAS,mCACd,IACA,MACQ;AACR,SAAO,iBAAiB,IAAI,IAAI,EAAE;AACpC;",
+  "names": []
+}

package/lib/url-utils.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Builds a base URL from an API host, using http for local hosts and https otherwise.
+ */
+export declare function buildBaseUrl(apiHost: string): string;

package/lib/url-utils.js

@@ -0,0 +1,8 @@
+function buildBaseUrl(apiHost) {
+  const isLocal = apiHost.startsWith("localhost") || apiHost.startsWith("127.0.0.1") || apiHost.startsWith("host.docker.internal");
+  return `${isLocal ? "http" : "https"}://${apiHost}`;
+}
+export {
+  buildBaseUrl
+};
+//# sourceMappingURL=url-utils.js.map

package/lib/url-utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../lib/url-utils.ts"],
+  "sourcesContent": ["/**\n * Builds a base URL from an API host, using http for local hosts and https otherwise.\n */\nexport function buildBaseUrl(apiHost: string): string {\n  const isLocal =\n    apiHost.startsWith(\"localhost\") ||\n    apiHost.startsWith(\"127.0.0.1\") ||\n    apiHost.startsWith(\"host.docker.internal\");\n  return `${isLocal ? \"http\" : \"https\"}://${apiHost}`;\n}\n"],
+  "mappings": "AAGO,SAAS,aAAa,SAAyB;AACpD,QAAM,UACJ,QAAQ,WAAW,WAAW,KAC9B,QAAQ,WAAW,WAAW,KAC9B,QAAQ,WAAW,sBAAsB;AAC3C,SAAO,GAAG,UAAU,SAAS,OAAO,MAAM,OAAO;AACnD;",
+  "names": []
+}

package/loaders/collection-loader.d.ts

@@ -0,0 +1,11 @@
+import type { ReactNode } from "react";
+import type { FullCollection } from "./loader-schemas";
+type CollectionLoaderProps = {
+    loaderKey: string;
+    handle?: string;
+    collectionGid?: string;
+    children: (data: FullCollection) => ReactNode;
+    fallback?: ReactNode;
+};
+export declare function CollectionLoader({ loaderKey, handle, collectionGid, children, fallback, }: CollectionLoaderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/loaders/collection-loader.js

@@ -0,0 +1,55 @@
+"use client";
+import { Fragment, jsx } from "react/jsx-runtime";
+import { Suspense } from "react";
+import { useSuspenseQuery } from "@tanstack/react-query";
+import { invokeLoader } from "./invoke-loader";
+import { LoaderErrorBoundary } from "./loader-error-boundary";
+import { fullCollectionSchema } from "./loader-schemas";
+import { useReportPreviewPlaceholderRender } from "./preview-placeholder";
+function CollectionLoaderInner({
+  loaderKey,
+  handle,
+  collectionGid,
+  children
+}) {
+  const queryResult = useSuspenseQuery({
+    queryKey: [loaderKey, { handle, collectionGid }],
+    queryFn: async () => {
+      const loadedData = await invokeLoader({
+        loaderKey,
+        args: { handle, collectionGid }
+      });
+      return fullCollectionSchema.parse(loadedData);
+    }
+  });
+  useReportPreviewPlaceholderRender(queryResult.data);
+  return /* @__PURE__ */ jsx(Fragment, { children: children(queryResult.data) });
+}
+function CollectionLoader({
+  loaderKey,
+  handle,
+  collectionGid,
+  children,
+  fallback
+}) {
+  return /* @__PURE__ */ jsx(
+    LoaderErrorBoundary,
+    {
+      fallback: fallback ?? null,
+      resetKey: `${loaderKey}:${handle ?? ""}:${collectionGid ?? ""}`,
+      children: /* @__PURE__ */ jsx(Suspense, { fallback: fallback ?? null, children: /* @__PURE__ */ jsx(
+        CollectionLoaderInner,
+        {
+          loaderKey,
+          handle,
+          collectionGid,
+          children
+        }
+      ) })
+    }
+  );
+}
+export {
+  CollectionLoader
+};
+//# sourceMappingURL=collection-loader.js.map

package/loaders/collection-loader.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../loaders/collection-loader.tsx"],
+  "sourcesContent": ["\"use client\";\n\nimport type { ReactNode } from \"react\";\nimport type { FullCollection } from \"./loader-schemas\";\n\nimport { Suspense } from \"react\";\n\nimport { useSuspenseQuery } from \"@tanstack/react-query\";\n\nimport { invokeLoader } from \"./invoke-loader\";\nimport { LoaderErrorBoundary } from \"./loader-error-boundary\";\nimport { fullCollectionSchema } from \"./loader-schemas\";\nimport { useReportPreviewPlaceholderRender } from \"./preview-placeholder\";\n\ntype CollectionLoaderProps = {\n  loaderKey: string;\n  handle?: string;\n  collectionGid?: string;\n  children: (data: FullCollection) => ReactNode;\n  fallback?: ReactNode;\n};\n\nfunction CollectionLoaderInner({\n  loaderKey,\n  handle,\n  collectionGid,\n  children,\n}: Omit<CollectionLoaderProps, \"fallback\">) {\n  const queryResult = useSuspenseQuery({\n    queryKey: [loaderKey, { handle, collectionGid }],\n    queryFn: async () => {\n      const loadedData = await invokeLoader({\n        loaderKey,\n        args: { handle, collectionGid },\n      });\n      return fullCollectionSchema.parse(loadedData);\n    },\n  });\n  useReportPreviewPlaceholderRender(queryResult.data);\n\n  return <>{children(queryResult.data)}</>;\n}\n\nexport function CollectionLoader({\n  loaderKey,\n  handle,\n  collectionGid,\n  children,\n  fallback,\n}: CollectionLoaderProps) {\n  return (\n    <LoaderErrorBoundary\n      fallback={fallback ?? null}\n      resetKey={`${loaderKey}:${handle ?? \"\"}:${collectionGid ?? \"\"}`}\n    >\n      <Suspense fallback={fallback ?? null}>\n        <CollectionLoaderInner\n          loaderKey={loaderKey}\n          handle={handle}\n          collectionGid={collectionGid}\n        >\n          {children}\n        </CollectionLoaderInner>\n      </Suspense>\n    </LoaderErrorBoundary>\n  );\n}\n"],
+  "mappings": ";AAwCS;AAnCT,SAAS,gBAAgB;AAEzB,SAAS,wBAAwB;AAEjC,SAAS,oBAAoB;AAC7B,SAAS,2BAA2B;AACpC,SAAS,4BAA4B;AACrC,SAAS,yCAAyC;AAUlD,SAAS,sBAAsB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA4C;AAC1C,QAAM,cAAc,iBAAiB;AAAA,IACnC,UAAU,CAAC,WAAW,EAAE,QAAQ,cAAc,CAAC;AAAA,IAC/C,SAAS,YAAY;AACnB,YAAM,aAAa,MAAM,aAAa;AAAA,QACpC;AAAA,QACA,MAAM,EAAE,QAAQ,cAAc;AAAA,MAChC,CAAC;AACD,aAAO,qBAAqB,MAAM,UAAU;AAAA,IAC9C;AAAA,EACF,CAAC;AACD,oCAAkC,YAAY,IAAI;AAElD,SAAO,gCAAG,mBAAS,YAAY,IAAI,GAAE;AACvC;AAEO,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA0B;AACxB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,UAAU,YAAY;AAAA,MACtB,UAAU,GAAG,SAAS,IAAI,UAAU,EAAE,IAAI,iBAAiB,EAAE;AAAA,MAE7D,8BAAC,YAAS,UAAU,YAAY,MAC9B;AAAA,QAAC;AAAA;AAAA,UACC;AAAA,UACA;AAAA,UACA;AAAA,UAEC;AAAA;AAAA,MACH,GACF;AAAA;AAAA,EACF;AAEJ;",
+  "names": []
+}

package/loaders/collection-products-loader.d.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from "react";
+import type { PaginatedProducts } from "./loader-schemas";
+type CollectionProductsLoaderProps = {
+    loaderKey: string;
+    collectionGid: string;
+    first?: number;
+    after?: string;
+    children: (data: PaginatedProducts) => ReactNode;
+    fallback?: ReactNode;
+};
+export declare function CollectionProductsLoader({ loaderKey, collectionGid, first, after, children, fallback, }: CollectionProductsLoaderProps): import("react/jsx-runtime").JSX.Element;
+export {};