@reactionary/hcl 0.9.8 → 0.9.11

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

@@ -8,6 +8,108 @@ export interface HclPrice {
     description: string;
     currency: string;
     value: string;
+    /** B2B contract identifier. Present on Offer-usage entries when a contract price applies. */
+    contractId?: string;
+}
+/**
+ * A single unit price entry in a /display_price response item.
+ * `value` is already a number (unlike the inline `HclPrice.value` which is a string).
+ */
+export interface HclDisplayPriceUnitPrice {
+    price?: {
+        currency?: string;
+        /** Numeric value — already a number, not a string. */
+        value?: number;
+    };
+    quantity?: {
+        value?: number;
+        uom?: string;
+    };
+}
+/**
+ * A single item in the `resultList` of a /display_price response.
+ * Returned for both `byPartNumbersAndPriceRuleId` and `byCatalogEntryIds*` query variants.
+ */
+export interface HclDisplayPriceItem {
+    partNumber: string;
+    priceRuleId?: string;
+    priceRuleName?: string;
+    catalogEntryId?: string;
+    unitPrice?: HclDisplayPriceUnitPrice[];
+    userDataField?: {
+        value?: string;
+        key: string;
+    }[];
+}
+/** Top-level response from GET /wcs/resources/store/{storeId}/display_price */
+export interface HclDisplayPriceResponse {
+    resourceId?: string;
+    resourceName?: string;
+    resultList?: HclDisplayPriceItem[];
+}
+/**
+ * A single unit price entry in a /price?q=byPartNumbers response item.
+ * Note: HCL uses `UnitPrice` (capital U) on this endpoint.
+ */
+export interface HclEntitledPriceUnitPrice {
+    price?: {
+        currency?: string;
+        /** Numeric value. */
+        value?: number;
+    };
+    quantity?: {
+        value?: number;
+        uom?: string;
+    };
+}
+/**
+ * A single item in the `EntitledPrice` array of a /price?q=byPartNumbers response.
+ */
+export interface HclEntitledPriceItem {
+    partNumber?: string;
+    productId?: string;
+    contractId?: string;
+    UnitPrice?: HclEntitledPriceUnitPrice[];
+}
+/** Top-level response from GET /wcs/resources/store/{storeId}/price?q=byPartNumbers */
+export interface HclEntitledPriceResponse {
+    resourceId?: string;
+    resourceName?: string;
+    EntitledPrice?: HclEntitledPriceItem[];
+}
+/**
+ * A single item in the `InventoryAvailability` array of the inventoryavailability response.
+ */
+export interface HclInventoryAvailabilityItem {
+    /** Internal HCL product ID (numeric string). */
+    productId?: string;
+    /** Inventory status string, e.g. 'Available'. */
+    inventoryStatus?: string;
+    /** Available quantity as a string (format: double). */
+    availableQuantity?: string;
+    unitOfMeasure?: string;
+    /** ID of the physical store, if this is a store-specific record. */
+    physicalStoreId?: string;
+    /** Name/key of the physical store, e.g. '1004/0001'. */
+    physicalStoreName?: string;
+    /** Name/key of the online store. Present on online inventory records. */
+    onlineStoreName?: string;
+    /** Online store ID. Present on online inventory records. */
+    onlineStoreId?: string;
+    availabilityDateTime?: string;
+    x_customField1?: string | null;
+    x_customField2?: string | null;
+    x_customField3?: string | null;
+    userDataField?: {
+        value?: string;
+        key: string;
+    }[];
+}
+/** Top-level response from GET /wcs/resources/store/{storeId}/inventoryavailability/byPartNumber/{partNumbers} */
+export interface HclInventoryAvailabilityResponse {
+    resourceId: string;
+    resourceName: string;
+    InventoryAvailability?: HclInventoryAvailabilityItem[];
 }
 export interface HclProductAttributeValue {
     identifier: string | string[];
@@ -310,3 +412,222 @@ export interface HclFindProductsQuery {
      */
     facets?: string[];
 }
+/**
+ * Response from POST /wcs/resources/store/{storeId}/guestidentity
+ * and POST /wcs/resources/store/{storeId}/loginidentity.
+ */
+export interface HclWcsIdentityResponse {
+    /** Opaque session token — must be forwarded as `WCToken` header on subsequent requests. */
+    WCToken: string;
+    /** Trusted token — must be forwarded as `WCTrustedToken` header. */
+    WCTrustedToken: string;
+    /** Numeric user ID string assigned by WCS. */
+    userId: string;
+    /** Personalization tracking ID. */
+    personalizationID?: string;
+    resourceName?: string;
+}
+/**
+ * Response from GET /wcs/resources/store/{storeId}/person/@self.
+ * Only the fields we use are typed; the full WCS schema has many more.
+ */
+export interface HclPersonResponse {
+    /** Numeric user ID string. */
+    userId: string;
+    /** Customer's email / logon ID. Only populated for registered users. */
+    logonId?: string;
+    email1?: string;
+    firstName?: string;
+    lastName?: string;
+    resourceName?: string;
+    /** Organization ID. `-2000` indicates the default anonymous org. */
+    orgizationId?: string;
+}
+/** A single order item embedded in a WCS cart/@self response. */
+export interface HclWcsOrderItem {
+    orderItemId: string;
+    /** Internal HCL catalog entry ID (numeric string). */
+    productId?: string;
+    /** SKU part number. Use this as the variant identifier. */
+    partNumber: string;
+    /** Quantity as a string — coerce with Number(). */
+    quantity: string;
+    /** Total line price as a string (unitPrice × quantity). */
+    orderItemPrice: string;
+    /** Price per single unit as a string. */
+    unitPrice: string;
+    /** ISO 4217 currency code. */
+    currency: string;
+    orderItemInventoryStatus?: string;
+    /** 'true' | 'false' — marks free-gift promotional items. */
+    freeGift?: string;
+    comments?: string;
+    /** Ship mode ID assigned to this item (present in shipping_info response). */
+    shipModeId?: string;
+    shipModeCode?: string;
+    shipModeDescription?: string;
+    carrier?: string;
+    shippingCharge?: string;
+}
+/** A single price adjustment on a WCS cart (discount, surcharge, tax, shipping). */
+export interface HclWcsAdjustment {
+    code: string;
+    /** Adjustment amount as a string — negative for discounts. */
+    amount: string;
+    currency: string;
+    /** 'Order' | 'OrderItem' | 'Shipping' */
+    displayLevel?: string;
+    /** 'Discount' | 'Tax' | 'Surcharge' | 'Shipping' */
+    usage?: string;
+    description?: string;
+}
+/** A promotion/coupon code applied to a WCS cart. */
+export interface HclWcsPromoCode {
+    code: string;
+    reason?: string;
+    associatedPromotion?: {
+        promotionId?: string;
+        promotionCode?: string;
+    }[];
+}
+/** Key-value pair carried in a WCS payment instruction. */
+export interface HclWcsPaymentProtocolData {
+    name: string;
+    value: string;
+}
+/** A payment instruction attached to a WCS cart. */
+export interface HclWcsPaymentInstruction {
+    piId: string;
+    payMethodId: string;
+    /** Authorized amount as a string. */
+    piAmount?: string;
+    currency?: string;
+    protocolData?: HclWcsPaymentProtocolData[];
+    piStatus?: string;
+    piDescription?: string;
+}
+/** An address embedded in a WCS cart/order response. */
+export interface HclWcsAddress {
+    addressId?: string;
+    firstName?: string;
+    lastName?: string;
+    /** Array of street address lines — index 0 is the primary line. */
+    addressLine?: string[];
+    /** Single-field street address (some WCS endpoints prefer this over addressLine). */
+    address1?: string;
+    city?: string;
+    /** State/province/region code. */
+    state?: string;
+    zipCode?: string;
+    country?: string;
+    phone1?: string;
+    email1?: string;
+    addressType?: string;
+    nickName?: string;
+}
+/** A single available ship mode returned by the WCS shipping_info endpoint. */
+export interface HclWcsShipMode {
+    shipModeId: string;
+    carrier: string;
+    shipModeCode: string;
+    shipModeDescription: string;
+    /** Store-defined extra field (varies by HCL configuration). */
+    field1?: string;
+    /** Estimated delivery time (store-defined). */
+    field2?: string;
+}
+/**
+ * Top-level response from GET /wcs/resources/store/{storeId}/cart/@self.
+ * All monetary amounts are returned as strings and must be parsed with Number().
+ */
+export interface HclWcsCartResponse {
+    orderId: string;
+    storeId?: string;
+    buyerId?: string;
+    orgUniqueID?: string;
+    grandTotal?: string;
+    grandTotalCurrency?: string;
+    totalProductPrice?: string;
+    totalProductPriceCurrency?: string;
+    totalShippingCharge?: string;
+    totalShippingChargeCurrency?: string;
+    totalAdjustment?: string;
+    totalAdjustmentCurrency?: string;
+    totalSalesTax?: string;
+    totalSalesTaxCurrency?: string;
+    totalShippingTax?: string;
+    /** Shipping address embedded in the cart (when set). */
+    x_shippingAddress?: HclWcsAddress;
+    /** Billing address embedded in the cart (when set). */
+    x_billingAddress?: HclWcsAddress;
+    orderItem?: HclWcsOrderItem[];
+    adjustment?: HclWcsAdjustment[];
+    promotionCode?: HclWcsPromoCode[];
+    paymentInstruction?: HclWcsPaymentInstruction[];
+    /** Currently selected shipping mode ID. */
+    shipModeId?: string;
+    shipModeCode?: string;
+    shipModeDescription?: string;
+    carrier?: string;
+    /** '0' | '1' — locked orders cannot be modified. */
+    x_isPurchaseLocked?: string;
+    /** WCS order status, e.g. 'P' = pending, 'C' = submitted. */
+    orderStatus?: string;
+    lastUpdateDate?: string;
+    /** Order description / name as persisted in WCS. Returned by GET /order/{orderId} and GET /order/byStatus/P. */
+    orderDescription?: string;
+}
+/**
+ * Response from GET /store/{storeId}/order/byStatus/P.
+ * Returns a list of pending orders (multi-cart B2B support).
+ */
+export interface HclWcsOrderListResponse {
+    Order: HclWcsCartResponse[];
+    recordSetTotal?: string;
+    recordSetCount?: string;
+    recordSetComplete?: string;
+    recordSetStartNumber?: string;
+}
+/** Response from the precheckout / checkout endpoints. */
+export interface HclWcsOrderIdContainer {
+    orderId: string;
+    resourceName?: string;
+}
+/** Response from GET cart/@self/shipping_info with usable shipping modes. */
+export interface HclWcsShipModesResponse {
+    /** Present in newer WCS versions when using IBM_usableShippingMode profile. */
+    usableShippingMode?: HclWcsShipMode[];
+    /** Present in older WCS versions — shipping mode embedded per orderItem. */
+    orderItem?: Array<{
+        orderItemId: string;
+        shipModeId?: string;
+        shipModeCode?: string;
+        shipModeDescription?: string;
+        carrier?: string;
+        description?: string;
+    }>;
+}
+/** A single usable payment method entry returned by WCS. */
+export interface HclWcsPaymentMethod {
+    paymentMethodName: string;
+    xucc?: string;
+    description?: string;
+}
+/** Response listing available payment methods for the store. */
+export interface HclWcsPaymentMethodsResponse {
+    usablePaymentInformation?: HclWcsPaymentMethod[];
+}
+/** Minimal response from addOrderItem / updateOrderItem operations. */
+export interface HclWcsOrderItemUpdateResponse {
+    orderId: string;
+    orderItem?: {
+        orderItemId: string;
+    }[];
+}
+/** Response from POST /store/{storeId}/cart/create_order */
+export interface HclWcsCreateOrderResponse {
+    /** The newly created order ID. */
+    outOrderId: string;
+    redirecturl?: string;
+    viewTaskName?: string;
+}

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

@@ -7,9 +7,10 @@ export declare function createHclClient(contextOverrides?: Partial<RequestContex
     price?: false | undefined;
     cart?: false | undefined;
     checkout?: false | undefined;
+    identity?: false | undefined;
     inventory?: false | undefined;
     category?: true | undefined;
-}>, "product" | "productSearch" | "price" | "cart" | "checkout" | "inventory" | "category"> & {
+}>, "product" | "productSearch" | "price" | "cart" | "checkout" | "identity" | "inventory" | "category"> & {
     product: import("../index.js").HclProductCapability<import("../index.js").HclProductFactory<import("zod").ZodObject<{
         identifier: import("zod").ZodObject<{
             key: import("zod").ZodString;