@reactionary/hcl 0.9.2

package/src/schema/category.schema.d.ts

@@ -0,0 +1,27 @@
+import * as z from 'zod';
+/**
+ * HCL-specific extension of the core Category schema.
+ * Adds `uniqueId` — the internal HCL uniqueID required by the product search
+ * API's `categoryId` parameter. Stored here so `createCategoryNavigationFilter`
+ * can return it without an extra API call.
+ */
+export declare const HclCategorySchema: z.ZodObject<{
+    identifier: z.ZodDefault<z.ZodObject<{
+        key: z.ZodString;
+    }, z.core.$loose>>;
+    name: z.ZodDefault<z.ZodString>;
+    slug: z.ZodDefault<z.ZodString>;
+    text: z.ZodDefault<z.ZodString>;
+    images: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        sourceUrl: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+        altText: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+        width: z.ZodNonOptional<z.ZodOptional<z.ZodNumber>>;
+        height: z.ZodNonOptional<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$loose>>>;
+    parentCategory: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+    }, z.core.$loose>>;
+    uniqueId: z.ZodOptional<z.ZodString>;
+    parentUniqueId: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type HclCategory = z.output<typeof HclCategorySchema>;

package/src/schema/configuration.schema.d.ts

@@ -0,0 +1,18 @@
+import * as z from 'zod';
+export declare const HclConfigurationSchema: z.ZodObject<{
+    apiUrl: z.ZodString;
+    storeId: z.ZodString;
+    catalogId: z.ZodOptional<z.ZodString>;
+    /**
+     * Maps BCP 47 locale strings (from RequestContext) to HCL Commerce langId values.
+     * HCL uses numeric language identifiers (e.g. -1 for English, -11 for Finnish).
+     * Add an entry for each locale your store supports.
+     */
+    localeMap: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    profiles: z.ZodDefault<z.ZodObject<{
+        product: z.ZodDefault<z.ZodString>;
+        productSearch: z.ZodDefault<z.ZodString>;
+        categoryBrowse: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type HclConfiguration = z.infer<typeof HclConfigurationSchema>;

package/src/schema/hcl.schema.d.ts

@@ -0,0 +1,312 @@
+/**
+ * HCL Commerce Query Service response types.
+ * Shaped from the actual API response, which is richer than the generated OpenAPI contracts.
+ * Reference: karkkainen-commerce-storefront/integration/data/core/types/Product.ts
+ */
+export interface HclPrice {
+    usage: string;
+    description: string;
+    currency: string;
+    value: string;
+}
+export interface HclProductAttributeValue {
+    identifier: string | string[];
+    sequence: string | string[];
+    unitOfMeasure: string | string[];
+    unitID: string | string[];
+    image1: string | string[];
+    image1path: string | string[];
+    value: string | string[];
+    id: string | string[];
+    attributeIdentifier?: string;
+}
+export interface HclProductAttribute {
+    id: string;
+    identifier: string;
+    name: string;
+    usage: string;
+    displayable: string;
+    storeDisplay: string;
+    facetable: string;
+    comparable: string;
+    searchable: string;
+    swatchable: string;
+    merchandisable: string;
+    sequence: string;
+    associatedKeyword: string;
+    values: HclProductAttributeValue[];
+}
+export interface HclAttachment {
+    mimeType: string;
+    attachmentAssetPath: string;
+    name: string;
+    attachmentAssetID: string;
+}
+export interface HclSeo {
+    href: string;
+    tokenValue?: string;
+}
+export interface HclGroupingProperties {
+    groupCount: number;
+    groupHero: string;
+    groupListPriceRange: [string, string];
+    groupOfferPriceRange: [string, string];
+    groupMinPriceValue: string;
+    groupMaxPriceValue: string;
+}
+export interface HclImage {
+    name: string;
+    sequence: string;
+    fullImage: string;
+    thumbnail: string;
+    /** Raw (pre-CDN-transform) full image path. Present in standard HCL_V2 detail profiles. */
+    fullImageRaw?: string;
+    /** Raw (pre-CDN-transform) thumbnail path. Present in standard HCL_V2 detail profiles. */
+    thumbnailRaw?: string;
+}
+/**
+ * A product item as returned by HCL search profiles
+ * (e.g. HCL_V2_findProductsBySearchTermWithPrice, HCL_V2_findProductsByCategoryWithPriceRange).
+ *
+ * Search profile responses contain aggregated entries without nested SKU items[].
+ * Attribute values may be arrays (aggregated across all variants of the group).
+ * Use this type in product-search factories.
+ */
+export interface HclProductSearchItem {
+    id: string;
+    partNumber: string;
+    name: string;
+    shortDescription: string;
+    /** Absent in search profiles — only populated in detail profiles. */
+    longDescription?: string;
+    thumbnail: string;
+    /** Raw (pre-CDN-transform) thumbnail path. Standard HCL_V2 field. */
+    thumbnailRaw?: string;
+    /**
+     * Full-size image URL. Absent in search profiles (HCL_V2_findProductsBySearchTerm*).
+     * Present in detail profiles (HCL_V2_findProductByPartNumber_Details).
+     */
+    fullImage?: string;
+    /** 'product' | 'item' | 'variant' | 'package' | 'bundle' */
+    type: string;
+    catalogEntryTypeCode?: string;
+    hasSingleSKU: boolean;
+    /** 'true' | 'false' */
+    buyable: string;
+    sellerId: string;
+    /** Absent in search profiles. */
+    seller?: string;
+    manufacturer: string;
+    /** Absent in search profiles. */
+    numberOfSKUs?: number;
+    /** Absent in search profiles. */
+    sequence?: string;
+    /** Internal HCL store ID. Standard HCL_V2 field. */
+    storeID?: string;
+    seo?: HclSeo;
+    parentCatalogGroupID: string | string[];
+    parentCatalogEntryID?: string;
+    price: HclPrice[];
+    /**
+     * Descriptive/Defining attributes. Present in detail profiles and some
+     * search profiles (server-dependent). Always treat as optional.
+     */
+    attributes?: HclProductAttribute[];
+    /** Aggregated variant pricing/grouping data — present only in search profile responses */
+    groupingProperties?: HclGroupingProperties;
+}
+/**
+ * A full product entry as returned by HCL detail profiles
+ * (e.g. HCL_V2_findProductByPartNumber_Details).
+ *
+ * Extends HclProductSearchItem with detail-only fields: nested SKU items[],
+ * attachments, images, and merchandising associations.
+ * Use this type in product detail factories.
+ */
+export interface HclProductResponse extends HclProductSearchItem {
+    /** Variant SKUs with full detail data — only present in detail profile responses */
+    items: HclProductResponse[];
+    /** Kit/bundle SKU list */
+    sKUs?: HclProductResponse[];
+    /** Kit/bundle component list */
+    components?: HclProductResponse[];
+    /** Quantity — only present on components array elements */
+    quantity?: string;
+    merchandisingAssociations?: HclProductResponse[];
+    attachments?: HclAttachment[];
+    images?: HclImage[];
+    /**
+     * Raw (pre-CDN-transform) full image path. Standard HCL_V2 field in detail profiles.
+     * For SKU items, also present as a sibling of `fullImage`.
+     */
+    fullImageRaw?: string;
+    /**
+     * Link to parent category API endpoint. Standard HCL_V2 field on SKU-level items.
+     * e.g. `/search/resources/api/v2/categories?storeId=41&id=10507`
+     */
+    parent?: string;
+}
+export interface HclFacetEntry {
+    /** The API returns count as number or string depending on facet type. */
+    count: number | string;
+    /** Display label shown to the user */
+    label: string;
+    name: string;
+    /** The filterable value, e.g. an attribute value or category ID */
+    value: string;
+    term: string;
+    frequency: string;
+    fullPath: string;
+    fullPathCategoryIds: string;
+    image: string;
+    shortDescription: string;
+}
+/**
+ * A single facet group as returned in HCL product search responses.
+ * Reference: karkkainen-commerce-storefront/integration/data/core/types/Product.ts
+ */
+export interface HclFacet {
+    /** The facet key/identifier, e.g. "manufacturer" */
+    value: string;
+    name: string;
+    entry: HclFacetEntry[];
+}
+export interface HclProductQueryResponse {
+    recordSetCount?: number;
+    recordSetTotal?: number;
+    recordSetStartNumber?: number;
+    recordSetComplete?: boolean;
+    /** v2 query service total count field */
+    total?: number;
+    /** Standard v2/products response array */
+    contents?: HclProductResponse[];
+    /** Used by some profiles (e.g. productview) */
+    catalogEntryView?: HclProductResponse[];
+    facets?: HclFacet[];
+}
+/**
+ * Response from /api/v2/urls — resolves a URL slug to a token/identifier.
+ * Reference: karkkainen-commerce-storefront/integration/data/core/types/IncomingContent.ts
+ */
+export interface HclUrlResponse {
+    /** The URL slug that was looked up */
+    identifier: string;
+    /** The type of the resolved entity, e.g. 'ProductToken' | 'CategoryToken' */
+    tokenName: string;
+    /** The partNumber (product) or id (category) of the resolved entity */
+    tokenExternalValue: string;
+    /** Internal HCL token value */
+    tokenValue: string;
+    /** Internal token record ID */
+    id?: string;
+    /** Store ID for this token */
+    storeId?: string;
+    /** Token status code (1 = active) */
+    status?: number;
+    /** Locale string, e.g. 'en_US' */
+    language?: string;
+    /** Store type, e.g. 'CPS' */
+    'store.type'?: string;
+    redirect?: string;
+    page?: {
+        /** Page template name, e.g. 'PRODUCT_PAGE' or 'CATEGORY_PAGE' */
+        name?: string;
+        type: string;
+        title: string;
+        metaDescription: string;
+        metaKeyword: string;
+        imageAlternateDescription?: string;
+        redirect?: string;
+    };
+}
+export interface HclUrlQueryResponse {
+    contents?: HclUrlResponse[];
+}
+/**
+ * SEO data for a category as returned by /api/v2/categories.
+ * Reference: karkkainen-commerce-storefront/integration/data/core/types/Category.ts
+ */
+export interface HclCategorySeo {
+    /** Not present in actual API responses — kept optional for forward-compatibility */
+    id?: string;
+    /** Full SEO URL path, e.g. "/Electronics/c/Electronics" */
+    href: string;
+}
+/**
+ * Navigation links returned alongside each category entry.
+ * Note: `children` links are plain strings in format "href: <url>", not objects.
+ */
+export interface HclCategoryLinks {
+    parent?: {
+        href: string;
+    };
+    children?: string[];
+    self?: {
+        href: string;
+    };
+}
+/**
+ * A single category entry as returned by the HCL Commerce Query Service.
+ */
+export interface HclCategoryResponse {
+    uniqueID: string;
+    /** Alias for uniqueID — both fields are returned by the API */
+    id?: string;
+    /** Human-readable URL slug / identifier, e.g. "Electronics" */
+    identifier: string;
+    name: string;
+    shortDescription?: string;
+    longDescription?: string;
+    description?: string;
+    thumbnail?: string;
+    fullImage?: string;
+    sequence: string;
+    /** Internal HCL store ID. Standard HCL_V2 field. */
+    storeID?: string;
+    seo: HclCategorySeo;
+    /** Parent category uniqueID — may be a root marker value like "-1" or "0" */
+    parentCatalogGroupID: string;
+    children?: HclCategoryResponse[];
+    links?: HclCategoryLinks;
+}
+export interface HclCategoryQueryResponse {
+    contents?: HclCategoryResponse[];
+}
+export interface HclFindCategoriesQuery {
+    storeId?: string;
+    catalogId?: string;
+    langId?: string;
+    /** Filter by category uniqueID */
+    id?: string[];
+    /** Filter by category identifier (slug) */
+    identifier?: string[];
+    /** Limit child categories to those under this parent uniqueID */
+    parentCategoryId?: string;
+    /** Controls depth and breadth: "depth,limit" e.g. "1,0" means 1 level deep, no count limit */
+    depthAndLimit?: string;
+    profileName?: string;
+}
+export interface HclFindProductsQuery {
+    storeId?: string;
+    catalogId?: string;
+    langId?: string;
+    currency?: string;
+    /** Filter by HCL product IDs */
+    id?: string[];
+    /** Filter by part numbers (product or SKU level) */
+    partNumber?: string[];
+    categoryId?: string;
+    searchTerm?: string;
+    contractId?: string;
+    /** Profile name controlling the subset of data returned */
+    profileName?: string;
+    limit?: number;
+    offset?: number;
+    checkEntitlement?: boolean;
+    /**
+     * Active facet filter values to apply (repeated param).
+     * Each entry is the URL-encoded value from HclFacetEntry.value,
+     * e.g. 'manufacturer.raw%3A%22Home+Design%22'.
+     */
+    facets?: string[];
+}

package/src/test/test-utils.d.ts

@@ -0,0 +1,241 @@
+import { type RequestContext } from '@reactionary/core';
+import { type HclConfiguration } from '../schema/configuration.schema.js';
+export declare function getHclTestConfiguration(): HclConfiguration;
+export declare function createHclClient(contextOverrides?: Partial<RequestContext>): Omit<import("@reactionary/core").Client, "product" | "productSearch" | "category"> & Omit<import("@reactionary/core").ClientFromCapabilities<{
+    product?: true | undefined;
+    productSearch?: true | undefined;
+    price?: false | undefined;
+    cart?: false | undefined;
+    checkout?: false | undefined;
+    inventory?: false | undefined;
+    category?: true | undefined;
+}>, "product" | "productSearch" | "price" | "cart" | "checkout" | "inventory" | "category"> & {
+    product: import("../index.js").HclProductCapability<import("../index.js").HclProductFactory<import("zod").ZodObject<{
+        identifier: import("zod").ZodObject<{
+            key: import("zod").ZodString;
+        }, import("zod/v4/core").$loose>;
+        name: import("zod").ZodString;
+        slug: import("zod").ZodString;
+        description: import("zod").ZodString;
+        longDescription: import("zod").ZodString;
+        brand: import("zod").ZodString;
+        manufacturer: import("zod").ZodString;
+        parentCategories: import("zod").ZodArray<import("zod").ZodObject<{
+            key: import("zod").ZodString;
+        }, import("zod/v4/core").$loose>>;
+        published: import("zod").ZodBoolean;
+        sharedAttributes: import("zod").ZodArray<import("zod").ZodObject<{
+            identifier: import("zod").ZodObject<{
+                key: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>;
+            group: import("zod").ZodString;
+            name: import("zod").ZodString;
+            values: import("zod").ZodArray<import("zod").ZodObject<{
+                identifier: import("zod").ZodObject<{
+                    key: import("zod").ZodString;
+                }, import("zod/v4/core").$loose>;
+                value: import("zod").ZodString;
+                label: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>>;
+        }, import("zod/v4/core").$loose>>;
+        options: import("zod").ZodArray<import("zod").ZodObject<{
+            identifier: import("zod").ZodObject<{
+                key: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>;
+            name: import("zod").ZodString;
+            values: import("zod").ZodArray<import("zod").ZodObject<{
+                identifier: import("zod").ZodObject<{
+                    option: import("zod").ZodObject<{
+                        key: import("zod").ZodString;
+                    }, import("zod/v4/core").$loose>;
+                    key: import("zod").ZodString;
+                }, import("zod/v4/core").$loose>;
+                label: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>>;
+        }, import("zod/v4/core").$loose>>;
+        mainVariant: import("zod").ZodObject<{
+            identifier: import("zod").ZodObject<{
+                sku: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>;
+            name: import("zod").ZodString;
+            images: import("zod").ZodArray<import("zod").ZodObject<{
+                sourceUrl: import("zod").ZodDefault<import("zod").ZodString>;
+                altText: import("zod").ZodDefault<import("zod").ZodString>;
+                width: import("zod").ZodOptional<import("zod").ZodNumber>;
+                height: import("zod").ZodOptional<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$loose>>;
+            ean: import("zod").ZodString;
+            gtin: import("zod").ZodString;
+            upc: import("zod").ZodString;
+            barcode: import("zod").ZodString;
+            options: import("zod").ZodArray<import("zod").ZodObject<{
+                identifier: import("zod").ZodObject<{
+                    key: import("zod").ZodString;
+                }, import("zod/v4/core").$loose>;
+                name: import("zod").ZodString;
+                value: import("zod").ZodObject<{
+                    identifier: import("zod").ZodObject<{
+                        option: import("zod").ZodObject<{
+                            key: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>;
+                        key: import("zod").ZodString;
+                    }, import("zod/v4/core").$loose>;
+                    label: import("zod").ZodString;
+                }, import("zod/v4/core").$loose>;
+            }, import("zod/v4/core").$loose>>;
+        }, import("zod/v4/core").$loose>;
+        variants: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+            identifier: import("zod").ZodObject<{
+                sku: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>;
+            name: import("zod").ZodString;
+            images: import("zod").ZodArray<import("zod").ZodObject<{
+                sourceUrl: import("zod").ZodDefault<import("zod").ZodString>;
+                altText: import("zod").ZodDefault<import("zod").ZodString>;
+                width: import("zod").ZodOptional<import("zod").ZodNumber>;
+                height: import("zod").ZodOptional<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$loose>>;
+            ean: import("zod").ZodString;
+            gtin: import("zod").ZodString;
+            upc: import("zod").ZodString;
+            barcode: import("zod").ZodString;
+            options: import("zod").ZodArray<import("zod").ZodObject<{
+                identifier: import("zod").ZodObject<{
+                    key: import("zod").ZodString;
+                }, import("zod/v4/core").$loose>;
+                name: import("zod").ZodString;
+                value: import("zod").ZodObject<{
+                    identifier: import("zod").ZodObject<{
+                        option: import("zod").ZodObject<{
+                            key: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>;
+                        key: import("zod").ZodString;
+                    }, import("zod/v4/core").$loose>;
+                    label: import("zod").ZodString;
+                }, import("zod/v4/core").$loose>;
+            }, import("zod/v4/core").$loose>>;
+        }, import("zod/v4/core").$loose>>>;
+    }, import("zod/v4/core").$loose>>>;
+    productSearch: import("../index.js").HclProductSearchCapability<import("../index.js").HclProductSearchFactory<import("zod").ZodObject<{
+        pageNumber: import("zod").ZodNumber;
+        pageSize: import("zod").ZodNumber;
+        totalCount: import("zod").ZodNumber;
+        totalPages: import("zod").ZodNumber;
+        items: import("zod").ZodArray<import("zod").ZodObject<{
+            identifier: import("zod").ZodObject<{
+                key: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>;
+            name: import("zod").ZodString;
+            slug: import("zod").ZodString;
+            variants: import("zod").ZodArray<import("zod").ZodObject<{
+                variant: import("zod").ZodObject<{
+                    sku: import("zod").ZodString;
+                }, import("zod/v4/core").$loose>;
+                image: import("zod").ZodObject<{
+                    sourceUrl: import("zod").ZodDefault<import("zod").ZodString>;
+                    altText: import("zod").ZodDefault<import("zod").ZodString>;
+                    width: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    height: import("zod").ZodOptional<import("zod").ZodNumber>;
+                }, import("zod/v4/core").$loose>;
+                options: import("zod").ZodOptional<import("zod").ZodObject<{
+                    identifier: import("zod").ZodObject<{
+                        key: import("zod").ZodString;
+                    }, import("zod/v4/core").$loose>;
+                    name: import("zod").ZodString;
+                    value: import("zod").ZodObject<{
+                        identifier: import("zod").ZodObject<{
+                            option: import("zod").ZodObject<{
+                                key: import("zod").ZodString;
+                            }, import("zod/v4/core").$loose>;
+                            key: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>;
+                        label: import("zod").ZodString;
+                    }, import("zod/v4/core").$loose>;
+                }, import("zod/v4/core").$loose>>;
+            }, import("zod/v4/core").$loose>>;
+        }, import("zod/v4/core").$loose>>;
+        identifier: import("zod").ZodObject<{
+            term: import("zod").ZodString;
+            facets: import("zod").ZodArray<import("zod").ZodObject<{
+                facet: import("zod").ZodObject<{
+                    key: import("zod").ZodString;
+                }, import("zod/v4/core").$loose>;
+                key: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>>;
+            filters: import("zod").ZodArray<import("zod").ZodString>;
+            paginationOptions: import("zod").ZodObject<{
+                pageNumber: import("zod").ZodDefault<import("zod").ZodNumber>;
+                pageSize: import("zod").ZodDefault<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$loose>;
+            categoryFilter: import("zod").ZodOptional<import("zod").ZodObject<{
+                facet: import("zod").ZodObject<{
+                    key: import("zod").ZodString;
+                }, import("zod/v4/core").$loose>;
+                key: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>>;
+            company: import("zod").ZodOptional<import("zod").ZodObject<{
+                taxIdentifier: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>>;
+        }, import("zod/v4/core").$loose>;
+        facets: import("zod").ZodArray<import("zod").ZodObject<{
+            identifier: import("zod").ZodObject<{
+                key: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>;
+            name: import("zod").ZodString;
+            values: import("zod").ZodArray<import("zod").ZodObject<{
+                identifier: import("zod").ZodObject<{
+                    facet: import("zod").ZodObject<{
+                        key: import("zod").ZodString;
+                    }, import("zod/v4/core").$loose>;
+                    key: import("zod").ZodString;
+                }, import("zod/v4/core").$strip>;
+                name: import("zod").ZodString;
+                count: import("zod").ZodNumber;
+                active: import("zod").ZodBoolean;
+            }, import("zod/v4/core").$loose>>;
+        }, import("zod/v4/core").$loose>>;
+    }, import("zod/v4/core").$strip>>>;
+    category: import("../index.js").HclCategoryCapability<import("../index.js").HclCategoryFactory<import("zod").ZodObject<{
+        identifier: import("zod").ZodDefault<import("zod").ZodObject<{
+            key: import("zod").ZodString;
+        }, import("zod/v4/core").$loose>>;
+        name: import("zod").ZodDefault<import("zod").ZodString>;
+        slug: import("zod").ZodDefault<import("zod").ZodString>;
+        text: import("zod").ZodDefault<import("zod").ZodString>;
+        images: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+            sourceUrl: import("zod").ZodNonOptional<import("zod").ZodDefault<import("zod").ZodString>>;
+            altText: import("zod").ZodNonOptional<import("zod").ZodDefault<import("zod").ZodString>>;
+            width: import("zod").ZodNonOptional<import("zod").ZodOptional<import("zod").ZodNumber>>;
+            height: import("zod").ZodNonOptional<import("zod").ZodOptional<import("zod").ZodNumber>>;
+        }, import("zod/v4/core").$loose>>>;
+        parentCategory: import("zod").ZodOptional<import("zod").ZodObject<{
+            key: import("zod").ZodString;
+        }, import("zod/v4/core").$loose>>;
+        uniqueId: import("zod").ZodOptional<import("zod").ZodString>;
+        parentUniqueId: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$loose>, import("zod").ZodObject<{
+        pageNumber: import("zod").ZodNumber;
+        pageSize: import("zod").ZodNumber;
+        totalCount: import("zod").ZodNumber;
+        totalPages: import("zod").ZodNumber;
+        items: import("zod").ZodArray<import("zod").ZodObject<{
+            identifier: import("zod").ZodDefault<import("zod").ZodObject<{
+                key: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>>;
+            name: import("zod").ZodDefault<import("zod").ZodString>;
+            slug: import("zod").ZodDefault<import("zod").ZodString>;
+            text: import("zod").ZodDefault<import("zod").ZodString>;
+            images: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+                sourceUrl: import("zod").ZodNonOptional<import("zod").ZodDefault<import("zod").ZodString>>;
+                altText: import("zod").ZodNonOptional<import("zod").ZodDefault<import("zod").ZodString>>;
+                width: import("zod").ZodNonOptional<import("zod").ZodOptional<import("zod").ZodNumber>>;
+                height: import("zod").ZodNonOptional<import("zod").ZodOptional<import("zod").ZodNumber>>;
+            }, import("zod/v4/core").$loose>>>;
+            parentCategory: import("zod").ZodOptional<import("zod").ZodObject<{
+                key: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>>;
+        }, import("zod/v4/core").$loose>>;
+    }, import("zod/v4/core").$strip>>>;
+} & {
+    cache: import("@reactionary/core").Cache;
+};

package/test/test-utils.js

@@ -0,0 +1,30 @@
+import {
+  ClientBuilder,
+  NoOpCache,
+  createInitialRequestContext
+} from "@reactionary/core";
+import { withHclCapabilities } from "../core/initialize.js";
+import {
+  HclConfigurationSchema
+} from "../schema/configuration.schema.js";
+function getHclTestConfiguration() {
+  return HclConfigurationSchema.parse({
+    apiUrl: process.env["HCL_API_URL"],
+    storeId: process.env["HCL_STORE_ID"],
+    catalogId: process.env["HCL_CATALOG_ID"] || void 0
+  });
+}
+function createHclClient(contextOverrides = {}) {
+  const context = { ...createInitialRequestContext(), ...contextOverrides };
+  return new ClientBuilder(context).withCache(new NoOpCache()).withCapability(
+    withHclCapabilities(getHclTestConfiguration(), {
+      product: { enabled: true },
+      category: { enabled: true },
+      productSearch: { enabled: true }
+    })
+  ).build();
+}
+export {
+  createHclClient,
+  getHclTestConfiguration
+};