@decocms/apps-wake 8.1.0-next.0 → 8.1.0-next.1

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@decocms/apps-wake",
-  "version": "8.1.0-next.0",
+  "version": "8.1.0-next.1",
   "type": "module",
-  "description": "Deco commerce app: Wake Commerce integration",
+  "description": "Thin Wake Commerce Storefront API client for Deco sites",
   "repository": {
     "type": "git",
     "url": "https://github.com/decocms/blocks.git",
@@ -10,47 +10,24 @@
   },
   "files": [
     "src",
-    "tsconfig.json"
+    "!src/**/*.test.ts",
+    "!src/**/__tests__"
   ],
   "main": "./src/index.ts",
   "exports": {
     ".": "./src/index.ts",
-    "./mod": "./src/mod.ts",
-    "./client": "./src/client.ts",
     "./storefront": "./src/storefront.ts",
-    "./storefront/types": "./src/storefrontTypes.ts",
-    "./commerceLoaders": "./src/commerceLoaders.ts",
-    "./loaders/*": "./src/loaders/*.ts",
-    "./actions/*": "./src/actions/*.ts",
-    "./actions/cart/*": "./src/actions/cart/*.ts",
-    "./actions/newsletter/*": "./src/actions/newsletter/*.ts",
-    "./actions/review/*": "./src/actions/review/*.ts",
-    "./actions/wishlist/*": "./src/actions/wishlist/*.ts",
-    "./handlers/*": "./src/handlers/*.ts",
-    "./hooks": "./src/hooks/index.ts",
-    "./hooks/*": "./src/hooks/*.ts",
-    "./utils/*": "./src/utils/*.ts",
-    "./registry": "./src/registry.ts"
+    "./storefront/types": "./src/storefrontTypes.ts"
   },
   "scripts": {
     "build": "tsc",
     "test": "vitest run --root ../.. packages/apps-wake/",
-    "typecheck": "tsc --noEmit",
-    "lint:unused": "knip"
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@decocms/blocks": "8.1.0-next.0",
-    "@decocms/apps-commerce": "8.1.0-next.0",
-    "@decocms/tanstack": "8.1.0-next.0"
-  },
-  "peerDependencies": {
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "@decocms/blocks": "8.1.0-next.1"
   },
   "devDependencies": {
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "knip": "^5.86.0",
     "typescript": "^5.9.0"
   },
   "publishConfig": {

package/src/index.ts

@@ -1,4 +1,4 @@
-// v8: the thin Wake client (see /next/upstream-clients). Operations are in
+// The thin Wake client (see /next/upstream-clients). Operations are in
 // `@decocms/apps-wake/storefront`, their types in `.../storefront/types`.
 
 export type { UserAuthenticate } from "./utils/client";
@@ -9,63 +9,3 @@ export {
   type WakeClientOptions,
   WakeError,
 } from "./wakeClient";
-
-// v7 (kept for v7 consumers until the v7 modules are dropped)
-// App contract
-
-// Cart actions
-export { default as addItem } from "./actions/cart/addItem";
-export { type CartItem, default as addItems } from "./actions/cart/addItems";
-export { default as updateItemQuantity } from "./actions/cart/updateItemQuantity";
-// Client & Config
-export type { WakeConfig } from "./client";
-export {
-  configureWake,
-  getBaseUrl,
-  getCheckoutUrl,
-  getWakeClient,
-  getWakeConfig,
-  initWakeFromBlocks,
-  setWakeFetch,
-} from "./client";
-// Commerce loaders factory (cached, CMS-registerable map)
-export {
-  type CommerceLoaderFn,
-  createWakeCommerceLoaders,
-  type WakeCommerceLoadersOptions,
-} from "./commerceLoaders";
-// Cart / user / wishlist
-export { default as cartLoader } from "./loaders/cart";
-// Shop / partners
-export { default as partnersLoader } from "./loaders/partners";
-// Product loaders
-export { default as productDetailsPageLoader } from "./loaders/productDetailsPage";
-export { default as productListLoader } from "./loaders/productList";
-export { default as productListingPageLoader } from "./loaders/productListingPage";
-export type { WakeProxyRoute } from "./loaders/proxy";
-export { default as proxyLoader } from "./loaders/proxy";
-export { default as recommendationsLoader } from "./loaders/recommendations";
-export { default as shopLoader } from "./loaders/shop";
-export { default as suggestionLoader } from "./loaders/suggestion";
-export { default as userLoader } from "./loaders/user";
-export { default as wishlistLoader } from "./loaders/wishlist";
-export { configure, type Props, type WakeState } from "./mod";
-// Registry
-export { WAKE_REGISTRY_ENTRY } from "./registry";
-
-// Cookie utils
-export { getCartCookie, setCartCookie, setClientCookie } from "./utils/cart";
-export { getCookies, setCookie } from "./utils/cookies";
-// GraphQL client + fetch instrumentation
-export { extractGraphqlOperationName } from "./utils/graphqlOperationName";
-export { type CreateWakeFetchOptions, createWakeFetch } from "./utils/instrumentedFetch";
-export { wakeOperationRouter } from "./utils/operationRouter";
-export { getPartnerCookie } from "./utils/partner";
-// Transform helpers
-export {
-  parseSlug,
-  toBreadcrumbList,
-  toFilters,
-  toProduct,
-} from "./utils/transform";
-export { getUserCookie } from "./utils/user";

package/src/utils/gql.ts

@@ -1,6 +1,5 @@
 /**
- * GraphQL document helpers shared by the v8 client (`../wakeClient.ts`) and
- * the v7 GraphQL client (`./graphql.ts`). Pure: no I/O, no framework imports.
+ * GraphQL document helpers used by the client (`../wakeClient.ts`). Pure: no I/O, no framework imports.
  */
 
 /**

package/src/__tests__/wakeClient.test.ts

@@ -1,136 +0,0 @@
-// @vitest-environment node
-/**
- * The v8 Wake client (/next/upstream-clients): every request goes through the
- * instrumented fetch as provider "wake", named by its operation, and errors
- * never carry bodies or tokens.
- */
-import { beforeEach, describe, expect, it, vi } from "vitest";
-
-const instrumented = vi.hoisted(() => ({
-  providers: [] as string[],
-  operations: [] as (string | undefined)[],
-}));
-
-vi.mock("@decocms/blocks/fetch", async (importOriginal) => {
-  const real = await importOriginal<typeof import("@decocms/blocks/fetch")>();
-  return {
-    createInstrumentedFetch: (options: Parameters<typeof real.createInstrumentedFetch>[0]) => {
-      instrumented.providers.push(options.provider);
-      const request = real.createInstrumentedFetch(options);
-      return (input: string | URL | Request, init?: RequestInit & { operation?: string }) => {
-        instrumented.operations.push(init?.operation);
-        return request(input, init);
-      };
-    },
-  };
-});
-
-import { GetProduct } from "../storefront";
-import { createWakeClient, WakeError } from "../wakeClient";
-
-/** The error a call rejects with (fails the test if it resolves). */
-const failure = (call: Promise<unknown>): Promise<Error> =>
-  call.then(
-    () => {
-      throw new Error("expected the call to fail");
-    },
-    (error: Error) => error,
-  );
-
-function upstream(body: unknown, status = 200) {
-  return vi.fn(
-    async (_input: string | URL | Request, _init?: RequestInit) =>
-      new Response(JSON.stringify(body), { status }),
-  );
-}
-
-beforeEach(() => {
-  instrumented.providers.length = 0;
-  instrumented.operations.length = 0;
-});
-
-describe("createWakeClient", () => {
-  it("runs a storefront operation through the instrumented fetch, labeled by its name", async () => {
-    const fetch = upstream({ data: { product: { productId: 1 } } });
-    const wake = createWakeClient({ storefrontToken: "tok" }, { fetch });
-
-    const data = await wake.graphql<{ product: { productId: number } }>(
-      GetProduct,
-      { productId: 1 },
-      {
-        headers: {
-          "x-forwarded-for": "203.0.113.7",
-          "TCS-Access-Token": "spoofed",
-          "Content-Type": "text/plain",
-        },
-      },
-    );
-
-    expect(data).toEqual({ product: { productId: 1 } });
-    expect(instrumented.providers).toEqual(["wake"]);
-    expect(instrumented.operations).toEqual(["GetProduct"]);
-    const [url, init] = fetch.mock.calls[0]!;
-    expect(String(url)).toBe("https://storefront-api.fbits.net/graphql");
-    const headers = new Headers(init?.headers);
-    // Per-call headers can't override the token or the content type, whatever their case.
-    expect(headers.get("tcs-access-token")).toBe("tok");
-    expect(headers.get("content-type")).toBe("application/json");
-    expect(headers.get("x-forwarded-for")).toBe("203.0.113.7");
-    const body = JSON.parse(String(init?.body));
-    expect(body.variables).toEqual({ productId: 1 });
-    expect(body.query).toContain("fragment"); // fragments are sent with the document
-  });
-
-  it("throws a WakeError without the body on HTTP and GraphQL failures", async () => {
-    const failing = createWakeClient(
-      { storefrontToken: "tok" },
-      { fetch: upstream({ secret: "x" }, 502) },
-    );
-    const httpError = await failure(failing.graphql("query Shop { shop { name } }"));
-    expect(httpError).toBeInstanceOf(WakeError);
-    expect(httpError.message).toBe("wake Shop failed with HTTP 502");
-
-    const erroring = createWakeClient(
-      { storefrontToken: "tok" },
-      { fetch: upstream({ errors: [{ message: "customer jane@example.com not found" }] }) },
-    );
-    const gqlError = await failure(erroring.graphql("query Shop { shop { name } }"));
-    expect(gqlError.message).toBe("wake Shop returned 1 GraphQL error(s)");
-    expect(gqlError.message).not.toContain("jane");
-    expect(gqlError.message).not.toContain("tok");
-  });
-
-  it("reads the signed-in shopper from the checkout, or null when signed out", async () => {
-    const fetch = upstream({ CustomerAccessToken: "cat", Email: "a@example.com" });
-    const wake = createWakeClient(
-      { storefrontToken: "tok", checkoutUrl: "https://checkout.example.com" },
-      { fetch },
-    );
-    expect(await wake.getLogin("fbits-login=abc")).toMatchObject({ CustomerAccessToken: "cat" });
-    const [url, init] = fetch.mock.calls[0]!;
-    expect(String(url)).toBe("https://checkout.example.com/api/Login/Get");
-    expect(new Headers(init?.headers).get("cookie")).toBe("fbits-login=abc");
-    expect(instrumented.operations).toEqual(["getLogin"]);
-
-    const signedOut = createWakeClient(
-      { storefrontToken: "tok", checkoutUrl: "https://checkout.example.com" },
-      { fetch: upstream({}, 401) },
-    );
-    expect(await signedOut.getLogin("")).toBeNull();
-  });
-
-  it("throws on a rate limit instead of reporting the shopper as signed out", async () => {
-    const limited = createWakeClient(
-      { storefrontToken: "tok", checkoutUrl: "https://checkout.example.com" },
-      { fetch: upstream({}, 429) },
-    );
-    const error = await failure(limited.getLogin("fbits-login=abc"));
-    expect(error).toBeInstanceOf(WakeError);
-    expect(error.message).toBe("wake getLogin failed with HTTP 429");
-  });
-
-  it("requires checkoutUrl for getLogin", async () => {
-    const wake = createWakeClient({ storefrontToken: "tok" }, { fetch: upstream({}) });
-    await expect(wake.getLogin("")).rejects.toThrow(/set checkoutUrl/);
-  });
-});

package/src/actions/cart/addCoupon.ts

@@ -1,43 +0,0 @@
-import { getWakeClient } from "../../client";
-import { getCartCookie, setCartCookie } from "../../utils/cart";
-import { AddCoupon } from "../../utils/graphql/queries";
-import type {
-  AddCouponMutation,
-  CheckoutFragment,
-} from "../../utils/graphql/storefront.graphql.gen";
-import { HttpError } from "../../utils/httpError";
-import {
-  currentRequestHeaders,
-  currentResponseHeaders,
-  forwardedHeaders,
-} from "../../utils/requestCtx";
-
-export interface Props {
-  coupon: string;
-}
-
-const action = async (props: Props): Promise<Partial<CheckoutFragment>> => {
-  const storefront = getWakeClient();
-  const cartId = getCartCookie(currentRequestHeaders());
-  const headers = forwardedHeaders();
-
-  if (!cartId) {
-    throw new HttpError(400, "Missing cart cookie");
-  }
-
-  const data = await storefront.query<AddCouponMutation>(
-    AddCoupon,
-    { checkoutId: cartId, ...props },
-    headers,
-  );
-
-  const checkoutId = data.checkout?.checkoutId;
-
-  if (checkoutId && cartId !== checkoutId) {
-    setCartCookie(currentResponseHeaders(), checkoutId);
-  }
-
-  return data.checkout ?? {};
-};
-
-export default action;

package/src/actions/cart/addItem.ts

@@ -1,10 +0,0 @@
-import type { CheckoutFragment } from "../../utils/graphql/storefront.graphql.gen";
-import addItems, { type CartItem as Props } from "./addItems";
-
-export type { CartItem as Props } from "./addItems";
-
-const action = async (props: Props): Promise<Partial<CheckoutFragment>> => {
-  return await addItems({ products: [props] });
-};
-
-export default action;

package/src/actions/cart/addItems.ts

@@ -1,50 +0,0 @@
-import { getWakeClient } from "../../client";
-import { getCartCookie, setCartCookie } from "../../utils/cart";
-import { AddItemToCart } from "../../utils/graphql/queries";
-import type {
-  AddItemToCartMutation,
-  CheckoutFragment,
-} from "../../utils/graphql/storefront.graphql.gen";
-import { HttpError } from "../../utils/httpError";
-import {
-  currentRequestHeaders,
-  currentResponseHeaders,
-  forwardedHeaders,
-} from "../../utils/requestCtx";
-
-export interface CartItem {
-  productVariantId: number;
-  quantity: number;
-  customization?: { customizationId: number; value: string }[];
-  subscription?: { subscriptionGroupId: number; recurringTypeId: number };
-}
-
-export interface Props {
-  products: CartItem[];
-}
-
-const action = async (props: Props): Promise<Partial<CheckoutFragment>> => {
-  const storefront = getWakeClient();
-  const cartId = getCartCookie(currentRequestHeaders());
-  const headers = forwardedHeaders();
-
-  if (!cartId) {
-    throw new HttpError(400, "Missing cart cookie");
-  }
-
-  const data = await storefront.query<AddItemToCartMutation>(
-    AddItemToCart,
-    { input: { id: cartId, products: props.products } },
-    headers,
-  );
-
-  const checkoutId = data.checkout?.checkoutId;
-
-  if (checkoutId && cartId !== checkoutId) {
-    setCartCookie(currentResponseHeaders(), checkoutId);
-  }
-
-  return data.checkout ?? {};
-};
-
-export default action;

package/src/actions/cart/addKit.ts

@@ -1,53 +0,0 @@
-import { getWakeClient } from "../../client";
-import { getCartCookie, setCartCookie } from "../../utils/cart";
-import { AddKit } from "../../utils/graphql/queries";
-import type { AddKitMutation, CheckoutFragment } from "../../utils/graphql/storefront.graphql.gen";
-import { HttpError } from "../../utils/httpError";
-import {
-  currentRequestHeaders,
-  currentResponseHeaders,
-  forwardedHeaders,
-} from "../../utils/requestCtx";
-
-export interface KitItemVariant {
-  productVariantId: number;
-  quantity: number;
-}
-
-export interface KitItem {
-  productId: number;
-  variants: KitItemVariant[];
-}
-
-export interface Props {
-  products: KitItem[];
-  quantity: number;
-  kitId: number;
-}
-
-const action = async (props: Props): Promise<Partial<CheckoutFragment>> => {
-  const storefront = getWakeClient();
-  const cartId = getCartCookie(currentRequestHeaders());
-  const headers = forwardedHeaders();
-  const { quantity, kitId, products } = props;
-
-  if (!cartId) {
-    throw new HttpError(400, "Missing cart cookie");
-  }
-
-  const data = await storefront.query<AddKitMutation>(
-    AddKit,
-    { input: { id: cartId, quantity, kitId, products } },
-    headers,
-  );
-
-  const checkoutId = data.checkout?.checkoutId;
-
-  if (checkoutId && cartId !== checkoutId) {
-    setCartCookie(currentResponseHeaders(), checkoutId);
-  }
-
-  return data.checkout ?? {};
-};
-
-export default action;

package/src/actions/cart/partnerAssociate.ts

@@ -1,48 +0,0 @@
-import { getWakeClient } from "../../client";
-import { getCartCookie, setCartCookie } from "../../utils/cart";
-import { CheckoutPartnerAssociate } from "../../utils/graphql/queries";
-import type {
-  CheckoutFragment,
-  CheckoutPartnerAssociateMutation,
-} from "../../utils/graphql/storefront.graphql.gen";
-import { HttpError } from "../../utils/httpError";
-import { setPartnerCookie } from "../../utils/partner";
-import {
-  currentRequestHeaders,
-  currentResponseHeaders,
-  forwardedHeaders,
-} from "../../utils/requestCtx";
-
-export interface Props {
-  partnerAccessToken: string;
-}
-
-const action = async (props: Props): Promise<Partial<CheckoutFragment>> => {
-  const storefront = getWakeClient();
-  const cartId = getCartCookie(currentRequestHeaders());
-  const headers = forwardedHeaders();
-  const { partnerAccessToken } = props;
-
-  if (!cartId) {
-    throw new HttpError(400, "Missing cart cookie");
-  }
-
-  const data = await storefront.query<CheckoutPartnerAssociateMutation>(
-    CheckoutPartnerAssociate,
-    { checkoutId: cartId, partnerAccessToken },
-    headers,
-  );
-
-  const checkoutId = data.checkout?.checkoutId;
-  const responseHeaders = currentResponseHeaders();
-
-  if (checkoutId && cartId !== checkoutId) {
-    setCartCookie(responseHeaders, checkoutId);
-  }
-
-  setPartnerCookie(responseHeaders, partnerAccessToken);
-
-  return data.checkout ?? {};
-};
-
-export default action;

package/src/actions/cart/partnerDisassociate.ts

@@ -1,43 +0,0 @@
-import { getWakeClient } from "../../client";
-import { getCartCookie, setCartCookie } from "../../utils/cart";
-import { CheckoutPartnerDisassociate } from "../../utils/graphql/queries";
-import type {
-  CheckoutFragment,
-  CheckoutPartnerDisassociateMutation,
-} from "../../utils/graphql/storefront.graphql.gen";
-import { HttpError } from "../../utils/httpError";
-import { deletePartnerCookie } from "../../utils/partner";
-import {
-  currentRequestHeaders,
-  currentResponseHeaders,
-  forwardedHeaders,
-} from "../../utils/requestCtx";
-
-const action = async (): Promise<Partial<CheckoutFragment>> => {
-  const storefront = getWakeClient();
-  const cartId = getCartCookie(currentRequestHeaders());
-  const headers = forwardedHeaders();
-
-  if (!cartId) {
-    throw new HttpError(400, "Missing cart cookie");
-  }
-
-  const data = await storefront.query<CheckoutPartnerDisassociateMutation>(
-    CheckoutPartnerDisassociate,
-    { checkoutId: cartId },
-    headers,
-  );
-
-  const checkoutId = data.checkout?.checkoutId;
-  const responseHeaders = currentResponseHeaders();
-
-  if (checkoutId && cartId !== checkoutId) {
-    setCartCookie(responseHeaders, checkoutId);
-  }
-
-  deletePartnerCookie(responseHeaders);
-
-  return data.checkout ?? {};
-};
-
-export default action;

package/src/actions/cart/removeCoupon.ts

@@ -1,39 +0,0 @@
-import { getWakeClient } from "../../client";
-import { getCartCookie, setCartCookie } from "../../utils/cart";
-import { RemoveCoupon } from "../../utils/graphql/queries";
-import type {
-  CheckoutFragment,
-  RemoveCouponMutation,
-} from "../../utils/graphql/storefront.graphql.gen";
-import { HttpError } from "../../utils/httpError";
-import {
-  currentRequestHeaders,
-  currentResponseHeaders,
-  forwardedHeaders,
-} from "../../utils/requestCtx";
-
-const action = async (): Promise<Partial<CheckoutFragment>> => {
-  const storefront = getWakeClient();
-  const cartId = getCartCookie(currentRequestHeaders());
-  const headers = forwardedHeaders();
-
-  if (!cartId) {
-    throw new HttpError(400, "Missing cart cookie");
-  }
-
-  const data = await storefront.query<RemoveCouponMutation>(
-    RemoveCoupon,
-    { checkoutId: cartId },
-    headers,
-  );
-
-  const checkoutId = data.checkout?.checkoutId;
-
-  if (checkoutId && cartId !== checkoutId) {
-    setCartCookie(currentResponseHeaders(), checkoutId);
-  }
-
-  return data.checkout ?? {};
-};
-
-export default action;

package/src/actions/cart/removeKit.ts

@@ -1,56 +0,0 @@
-import { getWakeClient } from "../../client";
-import { getCartCookie, setCartCookie } from "../../utils/cart";
-import { RemoveKit } from "../../utils/graphql/queries";
-import type {
-  CheckoutFragment,
-  RemoveKitMutation,
-} from "../../utils/graphql/storefront.graphql.gen";
-import { HttpError } from "../../utils/httpError";
-import {
-  currentRequestHeaders,
-  currentResponseHeaders,
-  forwardedHeaders,
-} from "../../utils/requestCtx";
-
-export interface KitItemVariant {
-  productVariantId: number;
-  quantity: number;
-}
-
-export interface KitItem {
-  productId: number;
-  variants: KitItemVariant[];
-}
-
-export interface Props {
-  products: KitItem[];
-  quantity: number;
-  kitId: number;
-}
-
-const action = async (props: Props): Promise<Partial<CheckoutFragment>> => {
-  const storefront = getWakeClient();
-  const cartId = getCartCookie(currentRequestHeaders());
-  const headers = forwardedHeaders();
-  const { quantity, kitId, products } = props;
-
-  if (!cartId) {
-    throw new HttpError(400, "Missing cart cookie");
-  }
-
-  const data = await storefront.query<RemoveKitMutation>(
-    RemoveKit,
-    { input: { id: cartId, quantity, kitId, products } },
-    headers,
-  );
-
-  const checkoutId = data.checkout?.checkoutId;
-
-  if (checkoutId && cartId !== checkoutId) {
-    setCartCookie(currentResponseHeaders(), checkoutId);
-  }
-
-  return data.checkout ?? {};
-};
-
-export default action;