@spindlecommerce/storefront-client 0.0.0-stage → 0.1.0

package/dist/documents.d.ts

@@ -0,0 +1,39 @@
+/** The GraphQL documents behind the client's methods. */
+/** For your own documents: spread `...ProductSummary` and append the fragment. */
+export declare const fragments: {
+    money: string;
+    address: string;
+    productSummary: string;
+    builderPage: string;
+    cart: string;
+};
+export declare const ROUTE = "\n  query Route($path: String!) {\n    route(path: $path) {\n      __typename\n      ... on Page { ...BuilderPage }\n      ... on Product {\n        ...ProductSummary\n        description\n        seo { title description }\n        categories { id name path }\n        media { id url alt kind position variant { id } }\n        variants {\n          id sku name isAvailable quantityAvailable\n          price { ...Money } compareAtPrice { ...Money }\n          selectedOptions { attribute value label name swatch }\n          media { url alt }\n        }\n        attributes { attribute { code label } value }\n      }\n      ... on Category { id name slug path description ancestors { id name path } children { id name path } }\n      ... on Redirect { location statusCode }\n    }\n  }\n  \n  fragment BuilderPage on Page {\n    id type path title isPreview publishedAt updatedAt\n    seo { title description noIndex image { url alt width height } }\n    content\n    references {\n      products { ...ProductSummary }\n      categories { id name path }\n      pages { id path title }\n    }\n  }\n  \n  fragment ProductSummary on Product {\n    id name slug isAvailable\n    priceRange { minVariantPrice { ...Money } maxVariantPrice { ...Money } compareAtMinVariantPrice { ...Money } }\n    media { url alt kind variant { id } }\n    options { attribute { code label } values { code label swatch } }\n    variants { id isAvailable selectedOptions { attribute value } }\n  }\n  fragment Money on Money { amount currencyCode formatted }";
+export declare const TEMPLATE = "\n  query Template($path: String!) {\n    route(path: $path) {\n      ... on Product { template { ...BuilderPage templateFor } }\n      ... on Category { template { ...BuilderPage templateFor } }\n    }\n  }\n  \n  fragment BuilderPage on Page {\n    id type path title isPreview publishedAt updatedAt\n    seo { title description noIndex image { url alt width height } }\n    content\n    references {\n      products { ...ProductSummary }\n      categories { id name path }\n      pages { id path title }\n    }\n  }\n  \n  fragment ProductSummary on Product {\n    id name slug isAvailable\n    priceRange { minVariantPrice { ...Money } maxVariantPrice { ...Money } compareAtMinVariantPrice { ...Money } }\n    media { url alt kind variant { id } }\n    options { attribute { code label } values { code label swatch } }\n    variants { id isAvailable selectedOptions { attribute value } }\n  }\n  fragment Money on Money { amount currencyCode formatted }";
+export declare const SECTIONS = "\n  query Sections($path: String!) {\n    route(path: $path) {\n      ... on Product { sections { ...BuilderPage } }\n      ... on Category { sections { ...BuilderPage } }\n    }\n  }\n  \n  fragment BuilderPage on Page {\n    id type path title isPreview publishedAt updatedAt\n    seo { title description noIndex image { url alt width height } }\n    content\n    references {\n      products { ...ProductSummary }\n      categories { id name path }\n      pages { id path title }\n    }\n  }\n  \n  fragment ProductSummary on Product {\n    id name slug isAvailable\n    priceRange { minVariantPrice { ...Money } maxVariantPrice { ...Money } compareAtMinVariantPrice { ...Money } }\n    media { url alt kind variant { id } }\n    options { attribute { code label } values { code label swatch } }\n    variants { id isAvailable selectedOptions { attribute value } }\n  }\n  fragment Money on Money { amount currencyCode formatted }";
+export declare const SITE = "\n  query Site($header: String!, $footer: String!) {\n    header: singletonPage(type: $header) { ...BuilderPage }\n    footer: singletonPage(type: $footer) { ...BuilderPage }\n    localization { locale currencyCode channel { code name } }\n  }\n  \n  fragment BuilderPage on Page {\n    id type path title isPreview publishedAt updatedAt\n    seo { title description noIndex image { url alt width height } }\n    content\n    references {\n      products { ...ProductSummary }\n      categories { id name path }\n      pages { id path title }\n    }\n  }\n  \n  fragment ProductSummary on Product {\n    id name slug isAvailable\n    priceRange { minVariantPrice { ...Money } maxVariantPrice { ...Money } compareAtMinVariantPrice { ...Money } }\n    media { url alt kind variant { id } }\n    options { attribute { code label } values { code label swatch } }\n    variants { id isAvailable selectedOptions { attribute value } }\n  }\n  fragment Money on Money { amount currencyCode formatted }";
+export declare const NEWEST_PRODUCTS = "\n  query NewestProducts($first: Int!) {\n    products(first: $first, sort: { field: NEWEST, direction: DESC }) { edges { node { ...ProductSummary } } }\n  }\n  \n  fragment ProductSummary on Product {\n    id name slug isAvailable\n    priceRange { minVariantPrice { ...Money } maxVariantPrice { ...Money } compareAtMinVariantPrice { ...Money } }\n    media { url alt kind variant { id } }\n    options { attribute { code label } values { code label swatch } }\n    variants { id isAvailable selectedOptions { attribute value } }\n  }\n  fragment Money on Money { amount currencyCode formatted }";
+export declare const CATEGORY_PRODUCTS = "\n  query CategoryProducts($id: ID!, $first: Int!, $after: String, $sort: ProductSortInput) {\n    category(id: $id) {\n      id name path\n      products(first: $first, after: $after, sort: $sort) {\n        totalCount\n        pageInfo { hasNextPage endCursor }\n        edges { node { ...ProductSummary } }\n      }\n    }\n  }\n  \n  fragment ProductSummary on Product {\n    id name slug isAvailable\n    priceRange { minVariantPrice { ...Money } maxVariantPrice { ...Money } compareAtMinVariantPrice { ...Money } }\n    media { url alt kind variant { id } }\n    options { attribute { code label } values { code label swatch } }\n    variants { id isAvailable selectedOptions { attribute value } }\n  }\n  fragment Money on Money { amount currencyCode formatted }";
+export declare const PAGES = "\n  query Pages($type: String, $first: Int!, $after: String) {\n    pages(type: $type, first: $first, after: $after) {\n      pageInfo { hasNextPage endCursor }\n      edges { node { path updatedAt seo { noIndex } } }\n    }\n  }";
+export declare const PRODUCT_SLUGS = "\n  query ProductSlugs($after: String) {\n    products(first: 100, after: $after) { pageInfo { hasNextPage endCursor } edges { node { slug } } }\n  }";
+export declare const CATEGORY_TREE = "\n  query CategoryTree { categoryTree { path children { path children { path children { path } } } } }";
+export declare const LOCALIZED_PATH = "\n  query LocalizedPath($id: ID!) {\n    node(id: $id) { ... on Product { slug } ... on Category { path } }\n  }";
+export declare const PREVIEW_SESSION = "query PreviewSession { previewSession { expiresAt adminOrigin at } }";
+export declare const COUNTRIES = "query Countries { localization { locale channel { countries { code name } } } }";
+export declare const CART_QUERY = "query Cart($id: ID!) { cart(id: $id) { ...Cart } } \n  fragment Cart on Cart {\n    id isOpen totalQuantity currencyCode\n    cost { subtotal { ...Money } total { ...Money } tax { ...Money } shipping { ...Money } discountTotal { ...Money } pricesIncludeTax }\n    lines {\n      id name quantity quantityAvailable\n      unitPrice { ...Money } compareAtUnitPrice { ...Money } total { ...Money }\n      issue { code message }\n      product { name slug media { url alt kind } }\n      variant { id name selectedOptions { name label } media { url alt } }\n    }\n  }\n  fragment Money on Money { amount currencyCode formatted }";
+export declare const CART_CREATE: string;
+export declare const CART_LINES_ADD: string;
+export declare const CART_LINES_UPDATE: string;
+export declare const CART_LINES_REMOVE: string;
+export declare const CART_MOVE: string;
+/** PaymentMethodOption.provider and sessionRequired are newer than the rest of the API. */
+export declare const PAYMENT_FIELDS = "code name instructions provider sessionRequired";
+export declare const LEGACY_PAYMENT_FIELDS = "code name instructions";
+export declare const checkoutCart: (paymentFields: string) => string;
+export declare const CART_UPDATE = "mutation CheckoutUpdate($cartId: ID!, $input: CartUpdateInput!) { result: cartUpdate(cartId: $cartId, input: $input) { __typename ... on Error { code message } ... on ValidationError { fieldErrors { path message } } } }";
+export declare const COUPON_APPLY = "mutation CheckoutCouponApply($cartId: ID!, $code: String!) { result: cartCouponApply(cartId: $cartId, code: $code) { __typename ... on Error { code message } ... on ValidationError { fieldErrors { path message } } ... on CouponNotApplicableError { reason } } }";
+export declare const COUPON_REMOVE = "mutation CheckoutCouponRemove($cartId: ID!, $code: String!) { result: cartCouponRemove(cartId: $cartId, code: $code) { __typename ... on Error { code message } ... on ValidationError { fieldErrors { path message } } } }";
+export declare const PAYMENT_SESSION_CREATE = "\n  mutation CheckoutPaymentSession($cartId: ID!) {\n    result: cartPaymentSessionCreate(cartId: $cartId) {\n      __typename\n      ... on CartPaymentSessionPayload { session { provider methodCode amount { ...Money } clientData } }\n      ... on Error { code message }\n    }\n  }\n  fragment Money on Money { amount currencyCode formatted }";
+export declare const PLACE_ORDER = "\n  mutation CheckoutPlaceOrder($cartId: ID!, $idempotencyKey: String!, $input: CartUpdateInput, $payment: PaymentDataInput) {\n    result: checkoutPlaceOrder(cartId: $cartId, idempotencyKey: $idempotencyKey, input: $input, payment: $payment) {\n      __typename\n      ... on CheckoutPayload { order { number email billingAddress { postalCode } } }\n      ... on Error { code message }\n      ... on ValidationError { fieldErrors { path message } }\n      ... on CartNotReadyError { missing fieldErrors { path message } }\n      ... on InsufficientStockError { sku available }\n    }\n  }";
+/** A cart that became an order elsewhere: a payment webhook, or another tab. */
+export declare const CONVERTED_CART = "query CheckoutConvertedCart($id: ID!) { cart(id: $id) { isOpen order { number email billingAddress { postalCode } } } }";
+export declare const GUEST_ORDER = "\n  query GuestOrder($email: EmailAddress!, $number: String!, $postalCode: String!, $cartId: ID!) {\n    order: guestOrder(email: $email, number: $number, postalCode: $postalCode) {\n      number email locale status paymentStatus placedAt currencyCode\n      lines {\n        id name sku quantity\n        unitPrice { ...Money } subtotal { ...Money } total { ...Money }\n        product { name slug media { url alt kind } }\n        variant { selectedOptions { name label } media { url alt } }\n      }\n      totals { subtotal { ...Money } shipping { ...Money } tax { ...Money } total { ...Money } pricesIncludeTax discounts { name couponCode amount { ...Money } } }\n      shippingAddress { ...Address }\n      billingAddress { ...Address }\n      shippingMethod { name }\n    }\n    cart(id: $cartId) { selectedPaymentMethod { code name instructions } }\n  }\n  fragment Money on Money { amount currencyCode formatted }\n  fragment Address on Address { firstName lastName company line1 line2 city region regionCode postalCode countryCode phone }";

package/dist/documents.js

@@ -0,0 +1,217 @@
+/** The GraphQL documents behind the client's methods. */
+const MONEY = `fragment Money on Money { amount currencyCode formatted }`;
+const ADDRESS = `fragment Address on Address { firstName lastName company line1 line2 city region regionCode postalCode countryCode phone }`;
+const PRODUCT_SUMMARY = `
+  fragment ProductSummary on Product {
+    id name slug isAvailable
+    priceRange { minVariantPrice { ...Money } maxVariantPrice { ...Money } compareAtMinVariantPrice { ...Money } }
+    media { url alt kind variant { id } }
+    options { attribute { code label } values { code label swatch } }
+    variants { id isAvailable selectedOptions { attribute value } }
+  }
+  ${MONEY}`;
+const BUILDER_PAGE = `
+  fragment BuilderPage on Page {
+    id type path title isPreview publishedAt updatedAt
+    seo { title description noIndex image { url alt width height } }
+    content
+    references {
+      products { ...ProductSummary }
+      categories { id name path }
+      pages { id path title }
+    }
+  }`;
+const CART = `
+  fragment Cart on Cart {
+    id isOpen totalQuantity currencyCode
+    cost { subtotal { ...Money } total { ...Money } tax { ...Money } shipping { ...Money } discountTotal { ...Money } pricesIncludeTax }
+    lines {
+      id name quantity quantityAvailable
+      unitPrice { ...Money } compareAtUnitPrice { ...Money } total { ...Money }
+      issue { code message }
+      product { name slug media { url alt kind } }
+      variant { id name selectedOptions { name label } media { url alt } }
+    }
+  }
+  ${MONEY}`;
+/** For your own documents: spread `...ProductSummary` and append the fragment. */
+export const fragments = { money: MONEY, address: ADDRESS, productSummary: PRODUCT_SUMMARY, builderPage: `${BUILDER_PAGE}${PRODUCT_SUMMARY}`, cart: CART };
+// ---------------------------------------------------------------- catalog and pages
+export const ROUTE = `
+  query Route($path: String!) {
+    route(path: $path) {
+      __typename
+      ... on Page { ...BuilderPage }
+      ... on Product {
+        ...ProductSummary
+        description
+        seo { title description }
+        categories { id name path }
+        media { id url alt kind position variant { id } }
+        variants {
+          id sku name isAvailable quantityAvailable
+          price { ...Money } compareAtPrice { ...Money }
+          selectedOptions { attribute value label name swatch }
+          media { url alt }
+        }
+        attributes { attribute { code label } value }
+      }
+      ... on Category { id name slug path description ancestors { id name path } children { id name path } }
+      ... on Redirect { location statusCode }
+    }
+  }
+  ${BUILDER_PAGE}
+  ${PRODUCT_SUMMARY}`;
+// Not part of the route query, which would then select more than the API's limit of 250 fields
+// (counting the __typename and id fields its response cache adds).
+export const TEMPLATE = `
+  query Template($path: String!) {
+    route(path: $path) {
+      ... on Product { template { ...BuilderPage templateFor } }
+      ... on Category { template { ...BuilderPage templateFor } }
+    }
+  }
+  ${BUILDER_PAGE}
+  ${PRODUCT_SUMMARY}`;
+// Not part of the route query either, for the same reason.
+export const SECTIONS = `
+  query Sections($path: String!) {
+    route(path: $path) {
+      ... on Product { sections { ...BuilderPage } }
+      ... on Category { sections { ...BuilderPage } }
+    }
+  }
+  ${BUILDER_PAGE}
+  ${PRODUCT_SUMMARY}`;
+export const SITE = `
+  query Site($header: String!, $footer: String!) {
+    header: singletonPage(type: $header) { ...BuilderPage }
+    footer: singletonPage(type: $footer) { ...BuilderPage }
+    localization { locale currencyCode channel { code name } }
+  }
+  ${BUILDER_PAGE}
+  ${PRODUCT_SUMMARY}`;
+export const NEWEST_PRODUCTS = `
+  query NewestProducts($first: Int!) {
+    products(first: $first, sort: { field: NEWEST, direction: DESC }) { edges { node { ...ProductSummary } } }
+  }
+  ${PRODUCT_SUMMARY}`;
+export const CATEGORY_PRODUCTS = `
+  query CategoryProducts($id: ID!, $first: Int!, $after: String, $sort: ProductSortInput) {
+    category(id: $id) {
+      id name path
+      products(first: $first, after: $after, sort: $sort) {
+        totalCount
+        pageInfo { hasNextPage endCursor }
+        edges { node { ...ProductSummary } }
+      }
+    }
+  }
+  ${PRODUCT_SUMMARY}`;
+export const PAGES = `
+  query Pages($type: String, $first: Int!, $after: String) {
+    pages(type: $type, first: $first, after: $after) {
+      pageInfo { hasNextPage endCursor }
+      edges { node { path updatedAt seo { noIndex } } }
+    }
+  }`;
+export const PRODUCT_SLUGS = `
+  query ProductSlugs($after: String) {
+    products(first: 100, after: $after) { pageInfo { hasNextPage endCursor } edges { node { slug } } }
+  }`;
+export const CATEGORY_TREE = `
+  query CategoryTree { categoryTree { path children { path children { path children { path } } } } }`;
+export const LOCALIZED_PATH = `
+  query LocalizedPath($id: ID!) {
+    node(id: $id) { ... on Product { slug } ... on Category { path } }
+  }`;
+export const PREVIEW_SESSION = `query PreviewSession { previewSession { expiresAt adminOrigin at } }`;
+export const COUNTRIES = `query Countries { localization { locale channel { countries { code name } } } }`;
+// ---------------------------------------------------------------- carts
+/** Only adding and changing quantities can return InsufficientStockError. */
+const cartResult = (canRunOutOfStock) => `
+  __typename
+  ... on CartPayload { cart { ...Cart } }
+  ... on Error { code message }
+  ${canRunOutOfStock ? "... on InsufficientStockError { available }" : ""}`;
+export const CART_QUERY = `query Cart($id: ID!) { cart(id: $id) { ...Cart } } ${CART}`;
+export const CART_CREATE = `mutation CartCreate($lines: [CartLineInput!]) { result: cartCreate(input: { lines: $lines }) { ${cartResult(true)} } } ${CART}`;
+export const CART_LINES_ADD = `mutation CartLinesAdd($id: ID!, $lines: [CartLineInput!]!) { result: cartLinesAdd(cartId: $id, lines: $lines) { ${cartResult(true)} } } ${CART}`;
+export const CART_LINES_UPDATE = `mutation CartLinesUpdate($id: ID!, $lines: [CartLineUpdateInput!]!) { result: cartLinesUpdate(cartId: $id, lines: $lines) { ${cartResult(true)} } } ${CART}`;
+export const CART_LINES_REMOVE = `mutation CartLinesRemove($id: ID!, $lineIds: [ID!]!) { result: cartLinesRemove(cartId: $id, lineIds: $lineIds) { ${cartResult(false)} } } ${CART}`;
+export const CART_MOVE = `mutation CartMove($id: ID!, $input: CartUpdateInput!) { result: cartUpdate(cartId: $id, input: $input) { ${cartResult(false)} } } ${CART}`;
+// ---------------------------------------------------------------- checkout
+/** PaymentMethodOption.provider and sessionRequired are newer than the rest of the API. */
+export const PAYMENT_FIELDS = "code name instructions provider sessionRequired";
+export const LEGACY_PAYMENT_FIELDS = "code name instructions";
+export const checkoutCart = (paymentFields) => `
+  query CheckoutCart($id: ID!) {
+    cart(id: $id) {
+      id isOpen currencyCode version email requiresShipping missing billingSameAsShipping
+      shippingAddress { ...Address }
+      billingAddress { ...Address }
+      availableShippingMethods { code name description price { ...Money } minDeliveryDays maxDeliveryDays }
+      selectedShippingMethod { code name price { ...Money } }
+      availablePaymentMethods { ${paymentFields} }
+      selectedPaymentMethod { code }
+      coupons { code applied reason }
+      discounts { name couponCode amount { ...Money } }
+      cost { subtotal { ...Money } total { ...Money } tax { ...Money } pricesIncludeTax }
+      lines {
+        id name quantity quantityAvailable
+        unitPrice { ...Money } compareAtUnitPrice { ...Money } subtotal { ...Money } total { ...Money }
+        issue { code message }
+        product { name slug media { url alt kind } }
+        variant { id name selectedOptions { name label } media { url alt } }
+      }
+    }
+  }
+  ${MONEY}
+  ${ADDRESS}`;
+/** What checkout reads of a cart mutation's result. */
+const CHANGE_RESULT = `__typename ... on Error { code message } ... on ValidationError { fieldErrors { path message } }`;
+export const CART_UPDATE = `mutation CheckoutUpdate($cartId: ID!, $input: CartUpdateInput!) { result: cartUpdate(cartId: $cartId, input: $input) { ${CHANGE_RESULT} } }`;
+export const COUPON_APPLY = `mutation CheckoutCouponApply($cartId: ID!, $code: String!) { result: cartCouponApply(cartId: $cartId, code: $code) { ${CHANGE_RESULT} ... on CouponNotApplicableError { reason } } }`;
+export const COUPON_REMOVE = `mutation CheckoutCouponRemove($cartId: ID!, $code: String!) { result: cartCouponRemove(cartId: $cartId, code: $code) { ${CHANGE_RESULT} } }`;
+export const PAYMENT_SESSION_CREATE = `
+  mutation CheckoutPaymentSession($cartId: ID!) {
+    result: cartPaymentSessionCreate(cartId: $cartId) {
+      __typename
+      ... on CartPaymentSessionPayload { session { provider methodCode amount { ...Money } clientData } }
+      ... on Error { code message }
+    }
+  }
+  ${MONEY}`;
+const PLACED = `number email billingAddress { postalCode }`;
+export const PLACE_ORDER = `
+  mutation CheckoutPlaceOrder($cartId: ID!, $idempotencyKey: String!, $input: CartUpdateInput, $payment: PaymentDataInput) {
+    result: checkoutPlaceOrder(cartId: $cartId, idempotencyKey: $idempotencyKey, input: $input, payment: $payment) {
+      __typename
+      ... on CheckoutPayload { order { ${PLACED} } }
+      ... on Error { code message }
+      ... on ValidationError { fieldErrors { path message } }
+      ... on CartNotReadyError { missing fieldErrors { path message } }
+      ... on InsufficientStockError { sku available }
+    }
+  }`;
+/** A cart that became an order elsewhere: a payment webhook, or another tab. */
+export const CONVERTED_CART = `query CheckoutConvertedCart($id: ID!) { cart(id: $id) { isOpen order { ${PLACED} } } }`;
+export const GUEST_ORDER = `
+  query GuestOrder($email: EmailAddress!, $number: String!, $postalCode: String!, $cartId: ID!) {
+    order: guestOrder(email: $email, number: $number, postalCode: $postalCode) {
+      number email locale status paymentStatus placedAt currencyCode
+      lines {
+        id name sku quantity
+        unitPrice { ...Money } subtotal { ...Money } total { ...Money }
+        product { name slug media { url alt kind } }
+        variant { selectedOptions { name label } media { url alt } }
+      }
+      totals { subtotal { ...Money } shipping { ...Money } tax { ...Money } total { ...Money } pricesIncludeTax discounts { name couponCode amount { ...Money } } }
+      shippingAddress { ...Address }
+      billingAddress { ...Address }
+      shippingMethod { name }
+    }
+    cart(id: $cartId) { selectedPaymentMethod { code name instructions } }
+  }
+  ${MONEY}
+  ${ADDRESS}`;

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+/** The API answered with GraphQL errors or an unexpected status. Status 0: it could not be reached. */
+export declare class StorefrontApiError extends Error {
+    readonly status: number;
+    readonly codes: string[];
+    constructor(message: string, status: number, codes?: string[], options?: ErrorOptions);
+}
+/** A request with a preview token the API no longer accepts. */
+export declare class PreviewExpiredError extends Error {
+    constructor();
+}
+/** Checked by name as well, since server bundles may hold more than one copy of this module. */
+export declare const isPreviewExpired: (error: unknown) => error is PreviewExpiredError;

package/dist/errors.js

@@ -0,0 +1,20 @@
+/** The API answered with GraphQL errors or an unexpected status. Status 0: it could not be reached. */
+export class StorefrontApiError extends Error {
+    status;
+    codes;
+    constructor(message, status, codes = [], options) {
+        super(message, options);
+        this.name = "StorefrontApiError";
+        this.status = status;
+        this.codes = codes;
+    }
+}
+/** A request with a preview token the API no longer accepts. */
+export class PreviewExpiredError extends Error {
+    constructor() {
+        super("The preview has expired; open it again from the admin");
+        this.name = "PreviewExpiredError";
+    }
+}
+/** Checked by name as well, since server bundles may hold more than one copy of this module. */
+export const isPreviewExpired = (error) => error instanceof PreviewExpiredError || (error instanceof Error && error.name === "PreviewExpiredError");

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { blockNodes, containsComponent, isContentNode } from "./builder.ts";
+export { CartError, createCartSession, type CartChange, type CartSession, type CartSessionOptions, type CartStore, type PaymentSession, type PaymentSessionResult, type PlaceOrderFailure, type PlaceOrderResult, } from "./cart.ts";
+export { allNodes, createStorefrontClient, type RequestOptions, type StorefrontClient, type StorefrontClientOptions, type StorefrontScope } from "./client.ts";
+export { fragments } from "./documents.ts";
+export { isPreviewExpired, PreviewExpiredError, StorefrontApiError } from "./errors.ts";
+export { mediaUrl } from "./media.ts";
+export { categoryPath, normalizePath, productPath, safeLocalPath } from "./paths.ts";
+export { isLower, isOnSale } from "./prices.ts";
+export type * from "./types.ts";
+export { chooseValue, firstValue, hasValues, inStock, matches, selectionOf, valuesWith, variantFor, type Selection } from "./variants.ts";
+export { editable, visualEditingBridge, visualEditingBridgeUrl, type EditAttributes, type Editable, type VisualEditingBridge } from "./visual-editing.ts";
+export { changesFor, parseWebhookEvent, SIGNATURE_TOLERANCE_SECONDS, verifyWebhookSignature, type ContentChange, type ContentChanges, type WebhookEvent } from "./webhooks.ts";

package/dist/index.js

@@ -0,0 +1,11 @@
+export { blockNodes, containsComponent, isContentNode } from "./builder.js";
+export { CartError, createCartSession, } from "./cart.js";
+export { allNodes, createStorefrontClient } from "./client.js";
+export { fragments } from "./documents.js";
+export { isPreviewExpired, PreviewExpiredError, StorefrontApiError } from "./errors.js";
+export { mediaUrl } from "./media.js";
+export { categoryPath, normalizePath, productPath, safeLocalPath } from "./paths.js";
+export { isLower, isOnSale } from "./prices.js";
+export { chooseValue, firstValue, hasValues, inStock, matches, selectionOf, valuesWith, variantFor } from "./variants.js";
+export { editable, visualEditingBridge, visualEditingBridgeUrl } from "./visual-editing.js";
+export { changesFor, parseWebhookEvent, SIGNATURE_TOLERANCE_SECONDS, verifyWebhookSignature } from "./webhooks.js";

package/dist/media.d.ts

@@ -0,0 +1,2 @@
+/** Content may hold paths on the API host, such as /media/…: those become absolute URLs. */
+export declare const mediaUrl: (apiUrl: string, src: string) => string;

package/dist/media.js

@@ -0,0 +1,2 @@
+/** Content may hold paths on the API host, such as /media/…: those become absolute URLs. */
+export const mediaUrl = (apiUrl, src) => (src.startsWith("/") && !src.startsWith("//") ? `${new URL(apiUrl).origin}${src}` : src);

package/dist/paths.d.ts

@@ -0,0 +1,10 @@
+/** The API's path rules: lowercase, single slashes, no trailing slash ("/" for the home page). */
+export declare const normalizePath: (input: string) => string;
+/** The API builds content links the same way. */
+export declare const productPath: (slug: string) => string;
+export declare const categoryPath: (path: string) => string;
+/**
+ * A same-origin path to redirect to, or null for anything that could leave the site: absolute
+ * URLs, "//host" and backslash tricks.
+ */
+export declare const safeLocalPath: (value: string | null | undefined) => string | null;

package/dist/paths.js

@@ -0,0 +1,25 @@
+/** The API's path rules: lowercase, single slashes, no trailing slash ("/" for the home page). */
+export const normalizePath = (input) => {
+    const trimmed = input.trim().toLowerCase().replace(/\/{2,}/g, "/");
+    const withSlash = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+    return withSlash.length > 1 ? withSlash.replace(/\/+$/, "") : withSlash;
+};
+/** The API builds content links the same way. */
+export const productPath = (slug) => `/products/${slug}`;
+export const categoryPath = (path) => `/categories/${path}`;
+/**
+ * A same-origin path to redirect to, or null for anything that could leave the site: absolute
+ * URLs, "//host" and backslash tricks.
+ */
+export const safeLocalPath = (value) => {
+    if (!value || !value.startsWith("/") || value.startsWith("//") || value.startsWith("/\\") || value.length > 2000)
+        return null;
+    try {
+        const base = "http://storefront.invalid";
+        const url = new URL(value, base);
+        return url.origin === base ? `${url.pathname}${url.search}${url.hash}` : null;
+    }
+    catch {
+        return null;
+    }
+};

package/dist/prices.d.ts

@@ -0,0 +1,4 @@
+import type { Money, PriceRange } from "./types.ts";
+/** Whether a compare-at price is above the price, so the item shows as on sale. */
+export declare const isLower: (price: Money, compareAt: Money | null | undefined) => compareAt is Money;
+export declare const isOnSale: (range: PriceRange | null | undefined) => boolean;

package/dist/prices.js

@@ -0,0 +1,3 @@
+/** Whether a compare-at price is above the price, so the item shows as on sale. */
+export const isLower = (price, compareAt) => !!compareAt && Number(compareAt.amount) > Number(price.amount);
+export const isOnSale = (range) => !!range?.minVariantPrice && isLower(range.minVariantPrice, range.compareAtMinVariantPrice);