codex-commerce-platform 0.1.0

package/README.md

@@ -0,0 +1,51 @@
+# codex-commerce-platform
+
+Non-visual commerce utilities for Codex client-owned storefronts.
+
+This package is intentionally not an RR7 storefront and does not own client UI. It should expose typed data helpers for Shopify, carts, catalog/search, images, money, errors, and connector mapping.
+
+## Boundary
+
+Allowed here:
+
+- Types for products, collections, carts, money, images, and catalog results
+- Pure money formatting helpers
+- Generic image URL helpers
+- Generic route/error classification and safe logging helpers
+- Connector-specific taxonomy helpers, starting with Pinnacle
+- Explicit runtime config builders
+
+Not allowed here:
+
+- JSX, React components, CSS, routes, layouts, page composition, static pages, product cards, mega menus, brand assets, client copy, tenant navigation, or generated client configs
+
+## Imports
+
+```ts
+import { formatMoney } from "codex-commerce-platform/money";
+import { classifyRouteError } from "codex-commerce-platform/errors";
+import type { StorefrontProduct } from "codex-commerce-platform/types";
+```
+
+Root exports are also available:
+
+```ts
+import { formatMoney, classifyRouteError } from "codex-commerce-platform";
+```
+
+Client storefronts may temporarily alias this package as `@codex/commerce-platform` in `package.json`
+to avoid broad import churn while moving away from local `file:` dependencies.
+
+## Runtime Config
+
+The package should receive explicit config from the app:
+
+```ts
+createShopifyStorefrontConfig({
+  storeDomain,
+  storefrontAccessToken,
+  apiVersion,
+});
+```
+
+It must not read hidden tenant config, generated site config, or app globals.

package/dist/cart/index.d.ts

@@ -0,0 +1,41 @@
+import { StorefrontApiError, type ShopifyStorefrontClient } from "../shopify/index.js";
+import type { Cart, CartInput, CartLine, CartLineInput, CartLineUpdateInput, CartUserError } from "../types/index.js";
+export type { Cart, CartCost, CartInput, CartLine, CartLineCost, CartLineInput, CartLineMerchandise, CartLineUpdateInput, CartUserError, } from "../types/index.js";
+export interface CartServiceConfig {
+    shopify: ShopifyStorefrontClient;
+}
+export interface CartService {
+    getCart(cartId: string): Promise<Cart | null>;
+    getCartSafely(cartId: string): Promise<Cart | null>;
+    createCart(input?: CartInput): Promise<Cart>;
+    addCartLines(cartId: string, lines: CartLineInput[]): Promise<Cart>;
+    updateCartLines(cartId: string, lines: CartLineUpdateInput[]): Promise<Cart>;
+    removeCartLines(cartId: string, lineIds: string[]): Promise<Cart>;
+}
+export interface Connection<TNode> {
+    nodes?: TNode[] | null;
+    edges?: Array<{
+        node: TNode;
+    }> | null;
+}
+export interface CartResponse extends Omit<Cart, "lines"> {
+    lines?: Connection<CartLine> | null;
+}
+export interface CartMutationPayload {
+    cart: CartResponse | null;
+    userErrors: CartUserError[];
+}
+export declare function createCartService(config: CartServiceConfig): CartService;
+export declare function getCart(shopify: ShopifyStorefrontClient, cartId: string): Promise<Cart | null>;
+export declare function getCartSafely(shopify: ShopifyStorefrontClient, cartId: string): Promise<Cart | null>;
+export declare function createCart(shopify: ShopifyStorefrontClient, input?: CartInput): Promise<Cart>;
+export declare function addCartLines(shopify: ShopifyStorefrontClient, cartId: string, lines: CartLineInput[]): Promise<Cart>;
+export declare function updateCartLines(shopify: ShopifyStorefrontClient, cartId: string, lines: CartLineUpdateInput[]): Promise<Cart>;
+export declare function removeCartLines(shopify: ShopifyStorefrontClient, cartId: string, lineIds: string[]): Promise<Cart>;
+export declare function requireCart(payload: CartMutationPayload, operation: string): Cart;
+export declare function cartUserErrorsToMessage(errors: readonly CartUserError[]): string;
+export declare function isRecoverableCartError(error: unknown): error is StorefrontApiError;
+export declare function getCartCheckoutUrl(cart: Cart | null | undefined): string | null;
+export declare function normalizeCart(cart: CartResponse): Cart;
+export declare function connectionNodes<TNode>(connection: Connection<TNode> | null | undefined): TNode[];
+//# sourceMappingURL=index.d.ts.map

package/dist/cart/index.d.ts.map

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

package/dist/cart/index.js

@@ -0,0 +1,278 @@
+import { StorefrontApiError } from "../shopify/index.js";
+export function createCartService(config) {
+    return {
+        getCart(cartId) {
+            return getCart(config.shopify, cartId);
+        },
+        getCartSafely(cartId) {
+            return getCartSafely(config.shopify, cartId);
+        },
+        createCart(input) {
+            return createCart(config.shopify, input);
+        },
+        addCartLines(cartId, lines) {
+            return addCartLines(config.shopify, cartId, lines);
+        },
+        updateCartLines(cartId, lines) {
+            return updateCartLines(config.shopify, cartId, lines);
+        },
+        removeCartLines(cartId, lineIds) {
+            return removeCartLines(config.shopify, cartId, lineIds);
+        },
+    };
+}
+export async function getCart(shopify, cartId) {
+    const data = await shopify.request(CART_QUERY, { cartId });
+    return data.cart ? normalizeCart(data.cart) : null;
+}
+export async function getCartSafely(shopify, cartId) {
+    try {
+        return await getCart(shopify, cartId);
+    }
+    catch (error) {
+        if (isRecoverableCartError(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function createCart(shopify, input) {
+    const data = await shopify.request(CART_CREATE_MUTATION, {
+        input: input ?? {},
+    });
+    return requireCart(data.cartCreate, "cartCreate");
+}
+export async function addCartLines(shopify, cartId, lines) {
+    if (lines.length === 0) {
+        throw new Error("addCartLines requires at least one line");
+    }
+    const data = await shopify.request(CART_LINES_ADD_MUTATION, {
+        cartId,
+        lines,
+    });
+    return requireCart(data.cartLinesAdd, "cartLinesAdd");
+}
+export async function updateCartLines(shopify, cartId, lines) {
+    if (lines.length === 0) {
+        throw new Error("updateCartLines requires at least one line");
+    }
+    const data = await shopify.request(CART_LINES_UPDATE_MUTATION, {
+        cartId,
+        lines,
+    });
+    return requireCart(data.cartLinesUpdate, "cartLinesUpdate");
+}
+export async function removeCartLines(shopify, cartId, lineIds) {
+    if (lineIds.length === 0) {
+        throw new Error("removeCartLines requires at least one line id");
+    }
+    const data = await shopify.request(CART_LINES_REMOVE_MUTATION, {
+        cartId,
+        lineIds,
+    });
+    return requireCart(data.cartLinesRemove, "cartLinesRemove");
+}
+export function requireCart(payload, operation) {
+    if (payload.userErrors.length) {
+        throw new StorefrontApiError(`${operation} failed: ${cartUserErrorsToMessage(payload.userErrors)}`);
+    }
+    if (!payload.cart) {
+        throw new StorefrontApiError(`${operation} did not return a cart`);
+    }
+    return normalizeCart(payload.cart);
+}
+export function cartUserErrorsToMessage(errors) {
+    return errors.map((error) => error.message).join("; ");
+}
+export function isRecoverableCartError(error) {
+    if (!(error instanceof StorefrontApiError))
+        return false;
+    const message = error.message.toLowerCase();
+    return message.includes("cart") || message.includes("checkout") || message.includes("verification") || message.includes("invalid");
+}
+export function getCartCheckoutUrl(cart) {
+    return cart?.checkoutUrl || null;
+}
+export function normalizeCart(cart) {
+    return {
+        ...cart,
+        lines: connectionNodes(cart.lines),
+    };
+}
+export function connectionNodes(connection) {
+    if (!connection) {
+        return [];
+    }
+    if (connection.nodes) {
+        return connection.nodes.filter((node) => node !== null && node !== undefined);
+    }
+    return (connection.edges ?? [])
+        .map((edge) => edge.node)
+        .filter((node) => node !== null && node !== undefined);
+}
+const MONEY_FRAGMENT = `#graphql
+	fragment MoneyFields on MoneyV2 {
+		amount
+		currencyCode
+	}
+`;
+const IMAGE_FRAGMENT = `#graphql
+	fragment ImageFields on Image {
+		url
+		smallUrl: url(transform: {maxWidth: 480})
+		thumbnailUrl: url(transform: {maxWidth: 240})
+		altText
+		width
+		height
+	}
+`;
+const CART_VARIANT_FRAGMENT = `#graphql
+	fragment CartVariantFields on ProductVariant {
+		id
+		title
+		availableForSale
+		sku
+		selectedOptions {
+			name
+			value
+		}
+		price {
+			...MoneyFields
+		}
+		compareAtPrice {
+			...MoneyFields
+		}
+		image {
+			...ImageFields
+		}
+		product {
+			id
+			handle
+			title
+			featuredImage {
+				...ImageFields
+			}
+		}
+	}
+`;
+const CART_FRAGMENT = `#graphql
+	fragment CartFields on Cart {
+		id
+		checkoutUrl
+		totalQuantity
+		cost {
+			subtotalAmount {
+				...MoneyFields
+			}
+			totalAmount {
+				...MoneyFields
+			}
+			totalTaxAmount {
+				...MoneyFields
+			}
+			totalDutyAmount {
+				...MoneyFields
+			}
+		}
+		lines(first: 100) {
+			nodes {
+				id
+				quantity
+				cost {
+					amountPerQuantity {
+						...MoneyFields
+					}
+					compareAtAmountPerQuantity {
+						...MoneyFields
+					}
+					subtotalAmount {
+						...MoneyFields
+					}
+					totalAmount {
+						...MoneyFields
+					}
+				}
+				merchandise {
+					... on ProductVariant {
+						...CartVariantFields
+					}
+				}
+			}
+		}
+	}
+`;
+const CART_FRAGMENTS = [MONEY_FRAGMENT, IMAGE_FRAGMENT, CART_VARIANT_FRAGMENT, CART_FRAGMENT].join("\n");
+const CART_QUERY = `#graphql
+	${CART_FRAGMENTS}
+
+	query Cart($cartId: ID!) {
+		cart(id: $cartId) {
+			...CartFields
+		}
+	}
+`;
+const CART_CREATE_MUTATION = `#graphql
+	${CART_FRAGMENTS}
+
+	mutation CartCreate($input: CartInput) {
+		cartCreate(input: $input) {
+			cart {
+				...CartFields
+			}
+			userErrors {
+				field
+				message
+				code
+			}
+		}
+	}
+`;
+const CART_LINES_ADD_MUTATION = `#graphql
+	${CART_FRAGMENTS}
+
+	mutation CartLinesAdd($cartId: ID!, $lines: [CartLineInput!]!) {
+		cartLinesAdd(cartId: $cartId, lines: $lines) {
+			cart {
+				...CartFields
+			}
+			userErrors {
+				field
+				message
+				code
+			}
+		}
+	}
+`;
+const CART_LINES_UPDATE_MUTATION = `#graphql
+	${CART_FRAGMENTS}
+
+	mutation CartLinesUpdate($cartId: ID!, $lines: [CartLineUpdateInput!]!) {
+		cartLinesUpdate(cartId: $cartId, lines: $lines) {
+			cart {
+				...CartFields
+			}
+			userErrors {
+				field
+				message
+				code
+			}
+		}
+	}
+`;
+const CART_LINES_REMOVE_MUTATION = `#graphql
+	${CART_FRAGMENTS}
+
+	mutation CartLinesRemove($cartId: ID!, $lineIds: [ID!]!) {
+		cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {
+			cart {
+				...CartFields
+			}
+			userErrors {
+				field
+				message
+				code
+			}
+		}
+	}
+`;
+//# sourceMappingURL=index.js.map

package/dist/cart/index.js.map

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

package/dist/catalog/index.d.ts

@@ -0,0 +1,4 @@
+export type { CatalogFacetOption, PinnacleCatalogFacets, PinnacleCatalogState, ProductSearchInput } from "../connectors/pinnacle/catalog.js";
+export { buildPinnacleCatalogFacets, buildPinnacleCatalogHref, buildPinnaclePaginationHrefs, categoryParamFromLabel, parsePinnacleCatalogState, pinnacleSearchInputFromState, PINNACLE_CATALOG_PAGE_SIZE, } from "../connectors/pinnacle/catalog.js";
+export type { CatalogFilter, CatalogFilterValue, PageInfo, ProductCatalogResult } from "../types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/catalog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC7I,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC5B,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/catalog/index.js

@@ -0,0 +1,2 @@
+export { buildPinnacleCatalogFacets, buildPinnacleCatalogHref, buildPinnaclePaginationHrefs, categoryParamFromLabel, parsePinnacleCatalogState, pinnacleSearchInputFromState, PINNACLE_CATALOG_PAGE_SIZE, } from "../connectors/pinnacle/catalog.js";
+//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC5B,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC"}

package/dist/connectors/pinnacle/catalog.d.ts

@@ -0,0 +1,63 @@
+import type { PageInfo, ProductCatalogResult } from "../../types/index.js";
+import { categoryLabelFromSlug, categorySlugFromLabel, slugifyCatalogValue, type PinnacleProductLike } from "./taxonomy.js";
+export declare const PINNACLE_CATALOG_PAGE_SIZE = 24;
+export interface CatalogFacetOption {
+    value: string;
+    label: string;
+    count: number;
+}
+export interface PinnacleCatalogFacets {
+    makeOptions: CatalogFacetOption[];
+    modelOptions: CatalogFacetOption[];
+    yearOptions: CatalogFacetOption[];
+    priceBounds: {
+        min: number;
+        max: number;
+    };
+}
+export interface PinnacleCatalogState {
+    categorySlug: string | null;
+    categoryLabel: string;
+    q: string;
+    sort: string;
+    makes: string[];
+    models: string[];
+    years: string[];
+    minPrice: string | null;
+    maxPrice: string | null;
+    available: boolean;
+    after: string | null;
+    before: string | null;
+    pageSize: number;
+}
+export interface ProductSearchInput {
+    query?: string | null;
+    rawQueryParts?: readonly string[];
+    minPrice?: string | null;
+    maxPrice?: string | null;
+    available?: boolean | null;
+    first?: number | null;
+    last?: number | null;
+    after?: string | null;
+    before?: string | null;
+    sortMode?: string | null;
+}
+export interface PinnacleFacetedProductLike extends PinnacleProductLike {
+    priceRange: {
+        minVariantPrice: {
+            amount: string;
+        };
+    };
+}
+type CatalogHrefValue = string | number | boolean | readonly string[] | null | undefined;
+export declare function parsePinnacleCatalogState(searchParams: URLSearchParams, routeCategorySlug?: string | null): PinnacleCatalogState;
+export declare function pinnacleSearchInputFromState(state: PinnacleCatalogState): ProductSearchInput;
+export declare function buildPinnacleCatalogFacets<TProduct extends PinnacleFacetedProductLike>(products: readonly TProduct[], state: PinnacleCatalogState, shopifyFilters?: ProductCatalogResult<TProduct>["filters"]): PinnacleCatalogFacets;
+export declare function buildPinnacleCatalogHref(requestUrl: string, updates: Record<string, CatalogHrefValue>): string;
+export declare function buildPinnaclePaginationHrefs(requestUrl: string, pageInfo: PageInfo): {
+    previousHref: string | null;
+    nextHref: string | null;
+};
+export declare function categoryParamFromLabel(category: string): string | null;
+export { categoryLabelFromSlug, categorySlugFromLabel, slugifyCatalogValue };
+//# sourceMappingURL=catalog.d.ts.map

package/dist/connectors/pinnacle/catalog.d.ts.map

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