@shopbb/helium 0.1.0

package/README.md

@@ -0,0 +1,50 @@
+# @shopbb/helium
+
+The storefront framework for [shopbb](https://oxygen-demo.cloudc.top). Use it inside a Cloudflare Worker to talk to the shopbb Storefront API.
+
+## Install
+
+```bash
+npm install @shopbb/helium
+```
+
+## Quick start
+
+```ts
+import { createHeliumContext, cartGetIdDefault, cartSetIdDefault } from '@shopbb/helium';
+
+export default {
+  async fetch(request: Request, env: Env, ctx: ExecutionContext) {
+    const ctx = createHeliumContext({
+      request,
+      env,
+      executionContext: ctx,
+      storefront: {
+        apiUrl: env.PUBLIC_STOREFRONT_API_URL,
+        publicAccessToken: request.headers.get('X-Public-Storefront-Token')!,
+        privateAccessToken: request.headers.get('X-Private-Storefront-Token') ?? undefined,
+        storeId: request.headers.get('X-Store-Id')!,
+      },
+      cart: {
+        getId: cartGetIdDefault(request.headers),
+        setId: cartSetIdDefault({ maxage: 60 * 60 * 24 * 365 }),
+      },
+    });
+
+    const { products } = await ctx.storefront.query(
+      `{ products(first: 10) { nodes { id title } } }`,
+      { cache: ctx.storefront.CacheShort() },
+    );
+
+    return new Response(JSON.stringify(products), {
+      headers: { ...Object.fromEntries(ctx.responseHeaders), 'content-type': 'application/json' },
+    });
+  },
+};
+```
+
+See the full docs at [oxygen-demo.cloudc.top/docs/helium](https://oxygen-demo.cloudc.top/docs/helium).
+
+## License
+
+MIT

package/dist/cache.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Cache strategies.
+ *
+ * Use with storefront.query({ cache: CacheLong() }).
+ *
+ * Mirrors Shopify Hydrogen's cache strategies API.
+ */
+import type { CacheStrategy } from './types';
+export declare function CacheNone(): CacheStrategy;
+export declare function CacheShort(): CacheStrategy;
+export declare function CacheLong(): CacheStrategy;
+/**
+ * Custom cache TTL in seconds.
+ */
+export declare function CacheCustom(seconds: number): CacheStrategy;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,wBAAgB,SAAS,IAAI,aAAa,CAEzC;AAED,wBAAgB,UAAU,IAAI,aAAa,CAE1C;AAED,wBAAgB,SAAS,IAAI,aAAa,CAEzC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAK1D"}

package/dist/cache.js

@@ -0,0 +1,26 @@
+/**
+ * Cache strategies.
+ *
+ * Use with storefront.query({ cache: CacheLong() }).
+ *
+ * Mirrors Shopify Hydrogen's cache strategies API.
+ */
+export function CacheNone() {
+    return { mode: 'NONE', maxAge: 0 };
+}
+export function CacheShort() {
+    return { mode: 'PUBLIC', maxAge: 60, staleWhileRevalidate: 600 };
+}
+export function CacheLong() {
+    return { mode: 'PUBLIC', maxAge: 3600, staleWhileRevalidate: 82800 };
+}
+/**
+ * Custom cache TTL in seconds.
+ */
+export function CacheCustom(seconds) {
+    return {
+        mode: seconds > 0 ? 'PUBLIC' : 'NONE',
+        maxAge: Math.max(0, seconds),
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,UAAU,SAAS;IACvB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,oBAAoB,EAAE,GAAG,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO;QACL,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;QACrC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;AACJ,CAAC"}

package/dist/cart-id.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Cart ID helpers.
+ *
+ * Cookie name: "cart"
+ * - cartGetIdDefault: parse "cart=<id>" from request cookie
+ * - cartSetIdDefault: returns a function that appends Set-Cookie to response headers
+ *
+ * 命名/行为对齐 Shopify Hydrogen (`cartGetIdDefault` / `cartSetIdDefault`).
+ */
+import type { CartIdGetter, CartIdSetter } from './types';
+export interface CartSetIdOptions {
+    /** Cookie path (default '/') */
+    path?: string;
+    /** Cookie max-age in seconds (default 1 year) */
+    maxage?: number;
+    /** SameSite policy (default 'Lax') */
+    sameSite?: 'Lax' | 'Strict' | 'None';
+    /** Secure flag (default true) */
+    secure?: boolean;
+    /** HttpOnly flag (default true) */
+    httpOnly?: boolean;
+    /** Optional domain */
+    domain?: string;
+}
+/**
+ * Returns a getter that reads `cart=<id>` from request cookies.
+ */
+export declare function cartGetIdDefault(requestHeaders: Headers): CartIdGetter;
+/**
+ * Returns a setter that appends `Set-Cookie: cart=<id>; ...` to response headers.
+ */
+export declare function cartSetIdDefault(options?: CartSetIdOptions): CartIdSetter;
+//# sourceMappingURL=cart-id.d.ts.map

package/dist/cart-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-id.d.ts","sourceRoot":"","sources":["../src/cart-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,OAAO,GAAG,YAAY,CAMtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,gBAAqB,GAAG,YAAY,CAmB7E"}

package/dist/cart-id.js

@@ -0,0 +1,42 @@
+/**
+ * Cart ID helpers.
+ *
+ * Cookie name: "cart"
+ * - cartGetIdDefault: parse "cart=<id>" from request cookie
+ * - cartSetIdDefault: returns a function that appends Set-Cookie to response headers
+ *
+ * 命名/行为对齐 Shopify Hydrogen (`cartGetIdDefault` / `cartSetIdDefault`).
+ */
+const COOKIE_NAME = 'cart';
+/**
+ * Returns a getter that reads `cart=<id>` from request cookies.
+ */
+export function cartGetIdDefault(requestHeaders) {
+    return () => {
+        const cookie = requestHeaders.get('cookie') || '';
+        const match = cookie.match(/(?:^|; )cart=([^;]+)/);
+        return match ? decodeURIComponent(match[1]) : null;
+    };
+}
+/**
+ * Returns a setter that appends `Set-Cookie: cart=<id>; ...` to response headers.
+ */
+export function cartSetIdDefault(options = {}) {
+    const path = options.path ?? '/';
+    const maxage = options.maxage ?? 60 * 60 * 24 * 365;
+    const sameSite = options.sameSite ?? 'Lax';
+    const secure = options.secure !== false;
+    const httpOnly = options.httpOnly !== false;
+    const domainPart = options.domain ? `; Domain=${options.domain}` : '';
+    return (cartId, headers) => {
+        const cookie = `${COOKIE_NAME}=${encodeURIComponent(cartId)}` +
+            `; Path=${path}` +
+            `; Max-Age=${maxage}` +
+            `; SameSite=${sameSite}` +
+            (secure ? '; Secure' : '') +
+            (httpOnly ? '; HttpOnly' : '') +
+            domainPart;
+        headers.append('Set-Cookie', cookie);
+    };
+}
+//# sourceMappingURL=cart-id.js.map

package/dist/cart-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-id.js","sourceRoot":"","sources":["../src/cart-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,MAAM,WAAW,GAAG,MAAM,CAAC;AAE3B;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,cAAuB;IACtD,OAAO,GAAG,EAAE;QACV,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA4B,EAAE;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC;IAC5C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtE,OAAO,CAAC,MAAc,EAAE,OAAgB,EAAE,EAAE;QAC1C,MAAM,MAAM,GACV,GAAG,WAAW,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE;YAC9C,UAAU,IAAI,EAAE;YAChB,aAAa,MAAM,EAAE;YACrB,cAAc,QAAQ,EAAE;YACxB,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1B,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9B,UAAU,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC"}

package/dist/createCartHandler.d.ts

@@ -0,0 +1,17 @@
+/**
+ * createCartHandler
+ *
+ * High-level cart API that wraps the storefront GraphQL mutations.
+ * Behavior aligned with Shopify Hydrogen:
+ *   - get(): returns null if no cart cookie or cart doesn't exist
+ *   - addLines(): if no cart exists, calls cartCreate first
+ *   - All mutations: auto setCookie when a new cart is created
+ *
+ * The handler operates on Cart GIDs internally; callers pass merchandiseIds
+ * (ProductVariant GIDs) and line IDs (cart line IDs).
+ */
+import type { CartHandler, CartHandlerOptions } from './types';
+/** Default cart return fragment. Can be overridden by caller. */
+export declare const DEFAULT_CART_FRAGMENT = "\n  fragment CartReturn on Cart {\n    id\n    createdAt\n    updatedAt\n    totalQuantity\n    cost {\n      subtotalAmount { amount currencyCode }\n      totalAmount { amount currencyCode }\n    }\n    lines(first: 50) {\n      nodes {\n        id\n        quantity\n        cost {\n          totalAmount { amount currencyCode }\n          amountPerQuantity { amount currencyCode }\n        }\n        merchandise {\n          ... on ProductVariant {\n            id\n            title\n            sku\n            availableForSale\n            price { amount currencyCode }\n            image { url altText }\n            product { id handle title }\n          }\n        }\n      }\n    }\n    checkoutUrl\n  }\n";
+export declare function createCartHandler(options: CartHandlerOptions): CartHandler;
+//# sourceMappingURL=createCartHandler.d.ts.map

package/dist/createCartHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCartHandler.d.ts","sourceRoot":"","sources":["../src/createCartHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAInB,MAAM,SAAS,CAAC;AAEjB,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,ktBAiCjC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAmI1E"}

package/dist/createCartHandler.js

@@ -0,0 +1,156 @@
+/**
+ * createCartHandler
+ *
+ * High-level cart API that wraps the storefront GraphQL mutations.
+ * Behavior aligned with Shopify Hydrogen:
+ *   - get(): returns null if no cart cookie or cart doesn't exist
+ *   - addLines(): if no cart exists, calls cartCreate first
+ *   - All mutations: auto setCookie when a new cart is created
+ *
+ * The handler operates on Cart GIDs internally; callers pass merchandiseIds
+ * (ProductVariant GIDs) and line IDs (cart line IDs).
+ */
+/** Default cart return fragment. Can be overridden by caller. */
+export const DEFAULT_CART_FRAGMENT = /* GraphQL */ `
+  fragment CartReturn on Cart {
+    id
+    createdAt
+    updatedAt
+    totalQuantity
+    cost {
+      subtotalAmount { amount currencyCode }
+      totalAmount { amount currencyCode }
+    }
+    lines(first: 50) {
+      nodes {
+        id
+        quantity
+        cost {
+          totalAmount { amount currencyCode }
+          amountPerQuantity { amount currencyCode }
+        }
+        merchandise {
+          ... on ProductVariant {
+            id
+            title
+            sku
+            availableForSale
+            price { amount currencyCode }
+            image { url altText }
+            product { id handle title }
+          }
+        }
+      }
+    }
+    checkoutUrl
+  }
+`;
+export function createCartHandler(options) {
+    const { storefront, getCartId, setCartId: rawSetId, responseHeaders } = options;
+    // Set the cart ID (delegate to options.setCartId, which writes Set-Cookie)
+    function setCartId(cartId) {
+        rawSetId(cartId, responseHeaders);
+    }
+    // ----- GraphQL operations -----
+    const CART_QUERY = /* GraphQL */ `
+    ${DEFAULT_CART_FRAGMENT}
+    query Cart($id: ID!) {
+      cart(id: $id) { ...CartReturn }
+    }
+  `;
+    const CART_CREATE = /* GraphQL */ `
+    ${DEFAULT_CART_FRAGMENT}
+    mutation CartCreate($input: CartInput) {
+      cartCreate(input: $input) {
+        cart { ...CartReturn }
+        userErrors { field message code }
+      }
+    }
+  `;
+    const CART_LINES_ADD = /* GraphQL */ `
+    ${DEFAULT_CART_FRAGMENT}
+    mutation CartLinesAdd($cartId: ID!, $lines: [CartLineInput!]!) {
+      cartLinesAdd(cartId: $cartId, lines: $lines) {
+        cart { ...CartReturn }
+        userErrors { field message code }
+      }
+    }
+  `;
+    const CART_LINES_UPDATE = /* GraphQL */ `
+    ${DEFAULT_CART_FRAGMENT}
+    mutation CartLinesUpdate($cartId: ID!, $lines: [CartLineUpdateInput!]!) {
+      cartLinesUpdate(cartId: $cartId, lines: $lines) {
+        cart { ...CartReturn }
+        userErrors { field message code }
+      }
+    }
+  `;
+    const CART_LINES_REMOVE = /* GraphQL */ `
+    ${DEFAULT_CART_FRAGMENT}
+    mutation CartLinesRemove($cartId: ID!, $lineIds: [ID!]!) {
+      cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {
+        cart { ...CartReturn }
+        userErrors { field message code }
+      }
+    }
+  `;
+    // ----- Handler methods -----
+    async function get() {
+        const cartId = getCartId();
+        if (!cartId)
+            return null;
+        const data = await storefront.query(CART_QUERY, {
+            variables: { id: cartId },
+            cache: storefront.CacheNone(),
+        });
+        return data.cart ?? null;
+    }
+    async function create(input) {
+        const data = await storefront.mutate(CART_CREATE, { variables: { input: input ?? {} } });
+        const result = data.cartCreate;
+        if (result.cart)
+            setCartId(result.cart.id);
+        return { cart: result.cart, userErrors: result.userErrors };
+    }
+    async function addLines(lines) {
+        const cartId = getCartId();
+        if (!cartId) {
+            // No existing cart → create with these lines
+            return create({ lines });
+        }
+        const data = await storefront.mutate(CART_LINES_ADD, { variables: { cartId, lines } });
+        return { cart: data.cartLinesAdd.cart, userErrors: data.cartLinesAdd.userErrors };
+    }
+    async function updateLines(lines) {
+        const cartId = getCartId();
+        if (!cartId) {
+            return {
+                cart: null,
+                userErrors: [{ message: 'No cart exists', code: 'NO_CART' }],
+            };
+        }
+        const data = await storefront.mutate(CART_LINES_UPDATE, { variables: { cartId, lines } });
+        return { cart: data.cartLinesUpdate.cart, userErrors: data.cartLinesUpdate.userErrors };
+    }
+    async function removeLines(lineIds) {
+        const cartId = getCartId();
+        if (!cartId) {
+            return {
+                cart: null,
+                userErrors: [{ message: 'No cart exists', code: 'NO_CART' }],
+            };
+        }
+        const data = await storefront.mutate(CART_LINES_REMOVE, { variables: { cartId, lineIds } });
+        return { cart: data.cartLinesRemove.cart, userErrors: data.cartLinesRemove.userErrors };
+    }
+    return {
+        get,
+        getCartId,
+        setCartId,
+        create,
+        addLines,
+        updateLines,
+        removeLines,
+    };
+}
+//# sourceMappingURL=createCartHandler.js.map

package/dist/createCartHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCartHandler.js","sourceRoot":"","sources":["../src/createCartHandler.ts"],"names":[],"mappings":"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"}

package/dist/createHeliumContext.d.ts

@@ -0,0 +1,23 @@
+/**
+ * createHeliumContext
+ *
+ * Entry-point factory that assembles a storefront client and a cart handler
+ * into a single context object that loaders/actions can consume.
+ *
+ * Usage:
+ *   const context = createHeliumContext({ request, env, executionContext,
+ *     storefront: { apiUrl, publicAccessToken, storeId },
+ *     cart: { getId: cartGetIdDefault(request.headers),
+ *             setId: cartSetIdDefault({ maxage: ... }) }
+ *   });
+ *
+ *   // Then:
+ *   const data = await context.storefront.query(QUERY);
+ *   const result = await context.cart.addLines([...]);
+ *
+ *   // When responding:
+ *   return new Response(html, { headers: context.responseHeaders });
+ */
+import type { HeliumContext, HeliumContextOptions } from './types';
+export declare function createHeliumContext(options: HeliumContextOptions): HeliumContext;
+//# sourceMappingURL=createHeliumContext.d.ts.map

package/dist/createHeliumContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHeliumContext.d.ts","sourceRoot":"","sources":["../src/createHeliumContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAInE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA8ChF"}

package/dist/createHeliumContext.js

@@ -0,0 +1,66 @@
+/**
+ * createHeliumContext
+ *
+ * Entry-point factory that assembles a storefront client and a cart handler
+ * into a single context object that loaders/actions can consume.
+ *
+ * Usage:
+ *   const context = createHeliumContext({ request, env, executionContext,
+ *     storefront: { apiUrl, publicAccessToken, storeId },
+ *     cart: { getId: cartGetIdDefault(request.headers),
+ *             setId: cartSetIdDefault({ maxage: ... }) }
+ *   });
+ *
+ *   // Then:
+ *   const data = await context.storefront.query(QUERY);
+ *   const result = await context.cart.addLines([...]);
+ *
+ *   // When responding:
+ *   return new Response(html, { headers: context.responseHeaders });
+ */
+import { createStorefrontClient } from './createStorefrontClient';
+import { createCartHandler } from './createCartHandler';
+export function createHeliumContext(options) {
+    const { request, env, executionContext, storefront: storefrontOpts, cart: cartOpts } = options;
+    // Mutable headers that will be merged into the eventual response
+    // (used for Set-Cookie when cart cookie needs to be written).
+    const responseHeaders = new Headers();
+    // 1. Build storefront client
+    const storefront = createStorefrontClient({
+        apiUrl: storefrontOpts.apiUrl,
+        publicAccessToken: storefrontOpts.publicAccessToken,
+        privateAccessToken: storefrontOpts.privateAccessToken,
+        storeId: storefrontOpts.storeId,
+        request,
+        cache: storefrontOpts.cache,
+        waitUntil: storefrontOpts.waitUntil ??
+            executionContext.waitUntil.bind(executionContext),
+    });
+    // 2. Build cart handler (if cart options provided)
+    let cart;
+    if (cartOpts) {
+        cart = createCartHandler({
+            storefront,
+            getCartId: cartOpts.getId,
+            setCartId: cartOpts.setId,
+            responseHeaders,
+        });
+    }
+    else {
+        // No cart options provided → no-op cart handler
+        cart = createCartHandler({
+            storefront,
+            getCartId: () => null,
+            setCartId: () => { },
+            responseHeaders,
+        });
+    }
+    return {
+        env,
+        request,
+        storefront,
+        cart,
+        responseHeaders,
+    };
+}
+//# sourceMappingURL=createHeliumContext.js.map

package/dist/createHeliumContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHeliumContext.js","sourceRoot":"","sources":["../src/createHeliumContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE/F,iEAAiE;IACjE,8DAA8D;IAC9D,MAAM,eAAe,GAAG,IAAI,OAAO,EAAE,CAAC;IAEtC,6BAA6B;IAC7B,MAAM,UAAU,GAAG,sBAAsB,CAAC;QACxC,MAAM,EAAE,cAAc,CAAC,MAAM;QAC7B,iBAAiB,EAAE,cAAc,CAAC,iBAAiB;QACnD,kBAAkB,EAAE,cAAc,CAAC,kBAAkB;QACrD,OAAO,EAAE,cAAc,CAAC,OAAO;QAC/B,OAAO;QACP,KAAK,EAAE,cAAc,CAAC,KAAK;QAC3B,SAAS,EACP,cAAc,CAAC,SAAS;YACxB,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC;KACpD,CAAC,CAAC;IAEH,mDAAmD;IACnD,IAAI,IAAI,CAAC;IACT,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,GAAG,iBAAiB,CAAC;YACvB,UAAU;YACV,SAAS,EAAE,QAAQ,CAAC,KAAK;YACzB,SAAS,EAAE,QAAQ,CAAC,KAAK;YACzB,eAAe;SAChB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,gDAAgD;QAChD,IAAI,GAAG,iBAAiB,CAAC;YACvB,UAAU;YACV,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;YACrB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;YACnB,eAAe;SAChB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,GAAG;QACH,OAAO;QACP,UAAU;QACV,IAAI;QACJ,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/createStorefrontClient.d.ts

@@ -0,0 +1,19 @@
+/**
+ * createStorefrontClient
+ *
+ * A thin GraphQL client wrapper around fetch(), with caching.
+ *
+ * 行为对齐 Shopify Hydrogen 的 storefront client：
+ *   - query() 可缓存（CacheLong / CacheShort / etc.）
+ *   - mutate() 不缓存
+ *   - 自动注入 X-Storefront-Access-Token header
+ *   - GraphQL errors 非空时抛出
+ *
+ * 内部缓存策略：
+ *   - 用 caches.default 或传入的 cache 对象（Cache API）
+ *   - cache key = SHA256(query + variables + storeId)
+ *   - 命中 / SWR / MISS 模式区分
+ */
+import type { StorefrontClient, StorefrontClientOptions } from './types';
+export declare function createStorefrontClient(options: StorefrontClientOptions): StorefrontClient;
+//# sourceMappingURL=createStorefrontClient.d.ts.map

package/dist/createStorefrontClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStorefrontClient.d.ts","sourceRoot":"","sources":["../src/createStorefrontClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EAIxB,MAAM,SAAS,CAAC;AAGjB,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAyIzF"}

package/dist/createStorefrontClient.js

@@ -0,0 +1,131 @@
+/**
+ * createStorefrontClient
+ *
+ * A thin GraphQL client wrapper around fetch(), with caching.
+ *
+ * 行为对齐 Shopify Hydrogen 的 storefront client：
+ *   - query() 可缓存（CacheLong / CacheShort / etc.）
+ *   - mutate() 不缓存
+ *   - 自动注入 X-Storefront-Access-Token header
+ *   - GraphQL errors 非空时抛出
+ *
+ * 内部缓存策略：
+ *   - 用 caches.default 或传入的 cache 对象（Cache API）
+ *   - cache key = SHA256(query + variables + storeId)
+ *   - 命中 / SWR / MISS 模式区分
+ */
+import { CacheNone, CacheShort, CacheLong, CacheCustom } from './cache';
+export function createStorefrontClient(options) {
+    const { apiUrl, publicAccessToken, privateAccessToken, storeId, cache, waitUntil, } = options;
+    const headers = () => ({
+        'Content-Type': 'application/json',
+        Accept: 'application/json',
+        'X-Storefront-Access-Token': privateAccessToken || publicAccessToken,
+        'X-Store-Id': storeId,
+    });
+    /**
+     * Compute a stable cache key for a query + variables.
+     */
+    async function cacheKeyFor(query, variables) {
+        const payload = JSON.stringify({ q: query, v: variables ?? {}, s: storeId });
+        const hashBuf = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(payload));
+        const hashHex = Array.from(new Uint8Array(hashBuf))
+            .map((b) => b.toString(16).padStart(2, '0'))
+            .join('');
+        return new Request(`https://helium-cache.invalid/${storeId}/${hashHex}`, { method: 'GET' });
+    }
+    async function executeGraphQL(query, variables) {
+        const body = JSON.stringify({ query, variables });
+        const res = await fetch(apiUrl, {
+            method: 'POST',
+            headers: headers(),
+            body,
+        });
+        if (!res.ok) {
+            throw new Error(`Storefront API HTTP ${res.status}: ${await res.text()}`);
+        }
+        const json = await res.json();
+        if (json.errors && json.errors.length > 0) {
+            const messages = json.errors.map((e) => e.message).join('; ');
+            throw new Error(`Storefront GraphQL errors: ${messages}`);
+        }
+        return json.data;
+    }
+    async function query(q, opts = {}) {
+        const cacheStrategy = opts.cache ?? CacheNone();
+        // No caching → direct call
+        if (cacheStrategy.mode === 'NONE' || !cache) {
+            return executeGraphQL(q, opts.variables);
+        }
+        const key = await cacheKeyFor(q, opts.variables);
+        const cached = await cache.match(key);
+        const now = Date.now();
+        if (cached) {
+            const ttl = Number(cached.headers.get('helium-ttl') ?? '0');
+            const cachedAt = Number(cached.headers.get('helium-cached-at') ?? '0');
+            const age = (now - cachedAt) / 1000;
+            if (age < ttl) {
+                // Fresh
+                return (await cached.json());
+            }
+            // Stale, return stale-while-revalidate if configured
+            const swr = cacheStrategy.staleWhileRevalidate ?? 0;
+            if (age < ttl + swr) {
+                // Trigger background revalidation
+                if (waitUntil) {
+                    waitUntil(refreshCache(q, opts.variables, key, cacheStrategy));
+                }
+                return (await cached.json());
+            }
+            // Expired
+        }
+        const data = await executeGraphQL(q, opts.variables);
+        // Async write to cache
+        if (waitUntil) {
+            waitUntil(writeCache(key, data, cacheStrategy));
+        }
+        else {
+            // Best-effort sync
+            await writeCache(key, data, cacheStrategy);
+        }
+        return data;
+    }
+    async function refreshCache(q, variables, key, strategy) {
+        try {
+            const data = await executeGraphQL(q, variables);
+            await writeCache(key, data, strategy);
+        }
+        catch (e) {
+            // Swallow errors during background refresh
+            console.error('[helium] cache refresh failed', e);
+        }
+    }
+    async function writeCache(key, data, strategy) {
+        if (!cache)
+            return;
+        const ttl = strategy.maxAge;
+        const swr = strategy.staleWhileRevalidate ?? 0;
+        const totalAge = ttl + swr;
+        const resp = new Response(JSON.stringify(data), {
+            headers: {
+                'Content-Type': 'application/json',
+                'Cache-Control': `public, max-age=${totalAge}`,
+                'helium-ttl': String(ttl),
+                'helium-cached-at': String(Date.now()),
+            },
+        });
+        await cache.put(key, resp);
+    }
+    async function mutate(m, opts = {}) {
+        return executeGraphQL(m, opts.variables);
+    }
+    return {
+        query,
+        mutate,
+        CacheNone,
+        CacheShort,
+        CacheLong,
+        CacheCustom,
+    };
+}
+//# sourceMappingURL=createStorefrontClient.js.map

package/dist/createStorefrontClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStorefrontClient.js","sourceRoot":"","sources":["../src/createStorefrontClient.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @shopbb/helium
+ *
+ * shopbb's storefront framework. Hydrogen-equivalent for the shopbb platform.
+ *
+ * Public API:
+ *
+ *   - createHeliumContext       Top-level factory
+ *   - createStorefrontClient    GraphQL client (used by createHeliumContext)
+ *   - createCartHandler         Cart operations (used by createHeliumContext)
+ *   - cartGetIdDefault          Default cart ID getter (reads cookie)
+ *   - cartSetIdDefault          Default cart ID setter (writes Set-Cookie)
+ *   - CacheNone / CacheShort / CacheLong / CacheCustom
+ */
+export { createHeliumContext } from './createHeliumContext';
+export { createStorefrontClient } from './createStorefrontClient';
+export { createCartHandler, DEFAULT_CART_FRAGMENT } from './createCartHandler';
+export { cartGetIdDefault, cartSetIdDefault } from './cart-id';
+export type { CartSetIdOptions } from './cart-id';
+export { CacheNone, CacheShort, CacheLong, CacheCustom } from './cache';
+export type { CacheStrategy, StorefrontClient, StorefrontClientOptions, QueryOptions, MutateOptions, CartHandler, CartHandlerOptions, CartLineInput, CartLineUpdateInput, CartUserError, CartResult, CartIdGetter, CartIdSetter, HeliumContext, HeliumContextOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map