@omnixhq/ucp-client 2.5.0 → 3.0.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AccountInfoSchema, AdapterOptions, AdjustmentSchema, AdjustmentStatusEnumSchema, AgentTool, Ap2MandateAp2WithCheckoutMandateSchema, Ap2MandateAp2WithMerchantAuthorizationSchema, Ap2MandateCheckoutMandateSchema, Ap2MandateErrorCodeSchema, Ap2MandateMerchantAuthorizationSchema, AuthorizationParams, BindingSchema, BusinessFulfillmentConfigSchema, BuyerConsent, BuyerConsentBuyerSchema, BuyerConsentConsentSchema, BuyerSchema, CapabilityBaseSchema, CapabilityBusinessSchema, CapabilityPlatformSchema, CapabilityResponseSchema, CardCredential, CardCredentialCardNumberTypeEnumSchema, CardCredentialSchema, CardPaymentInstrumentSchema, CheckoutCapability, CheckoutCompleteRequestSchema, CheckoutCreateRequestSchema, CheckoutExtensions, CheckoutResponseSchema, CheckoutResponseStatusSchema, CheckoutSchema, CheckoutSession, CheckoutSessionSchema, CheckoutSessionStatus, CheckoutStatusEnumSchema, CheckoutUpdateRequestSchema, CompleteCheckoutPayload, CompleteCheckoutRequestSchema, ConnectedClient, ContextSchema, CreateCheckoutPayload, CreateCheckoutRequestSchema, DEFAULT_UCP_VERSION, DiscountAllocationSchema, DiscountAppliedDiscountMethodEnumSchema, DiscountAppliedDiscountSchema, DiscountDiscountsObjectSchema, EmbeddedConfigSchema, ExpectationMethodTypeEnumSchema, ExpectationSchema, FulfillmentAvailableMethodSchema, FulfillmentAvailableMethodTypeEnumSchema, FulfillmentDestinationSchema, FulfillmentEventSchema, FulfillmentExtensionFulfillmentAvailableMethodSchema, FulfillmentExtensionFulfillmentGroupSchema, FulfillmentExtensionFulfillmentMethodSchema, FulfillmentExtensionFulfillmentOptionSchema, FulfillmentExtensionFulfillmentSchema, FulfillmentGroupSchema, FulfillmentGroupUpdatePayload, FulfillmentGroupUpdateRequestSchema, FulfillmentMethodCreatePayload, FulfillmentMethodCreateRequestSchema, FulfillmentMethodResponseSchema, FulfillmentMethodSchema, FulfillmentMethodTypeEnumSchema, FulfillmentMethodUpdatePayload, FulfillmentMethodUpdateRequestSchema, FulfillmentOptionSchema, FulfillmentResponseSchema, FulfillmentSchema, IdentityLinkingCapability, ItemResponseSchema, ItemSchema, JWK, JsonSchema, LineItemResponseSchema, LineItemSchema, LineItemUpdatePayload, LineItemUpdateRequestSchema, LinkSchema, LocalizationContext, MerchantFulfillmentConfigSchema, MessageErrorContentTypeEnumSchema, MessageErrorSchema, MessageErrorSeverityEnumSchema, MessageInfoContentTypeEnumSchema, MessageInfoSchema, MessageSchema, MessageWarningContentTypeEnumSchema, MessageWarningSchema, OAuthServerMetadata, OrderCapability, OrderConfirmationSchema, OrderLineItemSchema, OrderLineItemStatusEnumSchema, OrderSchema, OrderUpdate, OrderUpdatePayload, OrderUpdateSchema, PaymentCredential, PaymentCredentialSchema, PaymentHandlerBaseSchema, PaymentHandlerBusinessSchema, PaymentHandlerInstance, PaymentHandlerMap, PaymentHandlerPlatformSchema, PaymentHandlerResponseSchema, PaymentIdentitySchema, PaymentInstrument, PaymentInstrumentResponseSchema, PaymentInstrumentSchema, PaymentResponseSchema, PaymentSchema, PlatformFulfillmentConfigSchema, PostalAddress, PostalAddressSchema, ProfileSchemaBaseSchema, ProfileSchemaBusinessProfileSchema, ProfileSchemaPlatformProfileSchema, ProfileSchemaSigningKeySchema, ProfileSchemaSigningKeyUseEnumSchema, RetailLocationSchema, ServiceBaseSchema, ServiceBaseTransportEnumSchema, ServiceBusinessSchema, ServicePlatformSchema, ServiceResponseSchema, ShippingDestinationSchema, TokenCredential, TokenCredentialSchema, TokenExchangeParams, TokenRefreshParams, TokenResponse, TokenRevokeParams, ToolDescriptor, ToolErrorResult, TotalResponseSchema, TotalSchema, TotalTypeEnumSchema, UCPClient, UCPClientConfig, UCPProfile, UCPProfileSchema, UCPSpecOrder, UCP_CAPABILITIES, UcpBaseSchema, UcpBusinessSchema, UcpDiscoveryBusinessProfileSchema, UcpDiscoveryPlatformProfileSchema, UcpEntitySchema, UcpPlatformSchema, UcpResponseCheckoutSchema, UcpResponseOrderSchema, UcpReverseDomainNameSchema, UcpSigningKeySchema, UcpVersionSchema, UpdateCheckoutPayload, UpdateCheckoutRequestSchema, WebhookEvent, WebhookEventSchema, connect, getAgentTools } from "./catch-errors-DkF9AMDo.js";
+import { AccountInfoSchema, AdapterOptions, AdjustmentSchema, AdjustmentStatusEnumSchema, AgentTool, AmountSchema, Ap2MandateAp2WithCheckoutMandateSchema, Ap2MandateAp2WithMerchantAuthorizationSchema, Ap2MandateCheckoutMandateSchema, Ap2MandateErrorCodeSchema, Ap2MandateMerchantAuthorizationSchema, AuthorizationParams, AvailablePaymentInstrumentSchema, BindingSchema, BusinessFulfillmentConfigSchema, BuyerConsent, BuyerConsentBuyerSchema, BuyerConsentConsentSchema, BuyerSchema, CapabilityBaseSchema, CapabilityBusinessSchema, CapabilityPlatformSchema, CapabilityResponseSchema, CardCredential, CardCredentialCardNumberTypeEnumSchema, CardCredentialSchema, CardPaymentInstrumentAvailableCardPaymentInstrumentSchema, Cart, CartCapability, CartCreatePayload, CartCreateRequestSchema, CartResponseSchema, CartSchema, CartUpdatePayload, CartUpdateRequestSchema, CatalogCapability, CatalogExtensions, CatalogLookupResponse, CatalogLookupSchema, CatalogSearchResponse, CatalogSearchSchema, CategorySchema, CheckoutCapability, CheckoutCompleteRequestSchema, CheckoutCreateRequestSchema, CheckoutExtensions, CheckoutResponseSchema, CheckoutResponseStatusSchema, CheckoutSchema, CheckoutSession, CheckoutSessionSchema, CheckoutSessionStatus, CheckoutStatusEnumSchema, CheckoutUpdateRequestSchema, CompleteCheckoutPayload, CompleteCheckoutRequestSchema, ConnectedClient, ContextSchema, CreateCheckoutPayload, CreateCheckoutRequestSchema, DEFAULT_UCP_VERSION, DescriptionSchema, DetailOptionValue, DetailOptionValueSchema, DiscountAllocationSchema, DiscountAppliedDiscountMethodEnumSchema, DiscountAppliedDiscountSchema, DiscountDiscountsObjectSchema, EmbeddedConfigSchema, ErrorCodeSchema, ErrorResponseSchema, ExpectationMethodTypeEnumSchema, ExpectationSchema, FulfillmentAvailableMethodSchema, FulfillmentAvailableMethodTypeEnumSchema, FulfillmentDestinationSchema, FulfillmentEventSchema, FulfillmentExtensionFulfillmentAvailableMethodSchema, FulfillmentExtensionFulfillmentGroupSchema, FulfillmentExtensionFulfillmentMethodSchema, FulfillmentExtensionFulfillmentOptionSchema, FulfillmentExtensionFulfillmentSchema, FulfillmentGroupSchema, FulfillmentGroupUpdatePayload, FulfillmentGroupUpdateRequestSchema, FulfillmentMethodCreatePayload, FulfillmentMethodCreateRequestSchema, FulfillmentMethodResponseSchema, FulfillmentMethodSchema, FulfillmentMethodTypeEnumSchema, FulfillmentMethodUpdatePayload, FulfillmentMethodUpdateRequestSchema, FulfillmentOptionSchema, FulfillmentResponseSchema, FulfillmentSchema, IdentityLinkingCapability, InputCorrelationSchema, ItemResponseSchema, ItemSchema, JWK, JsonSchema, LineItemResponseSchema, LineItemSchema, LineItemUpdatePayload, LineItemUpdateRequestSchema, LinkSchema, LocalizationContext, MediaSchema, MerchantFulfillmentConfigSchema, MessageErrorContentTypeEnumSchema, MessageErrorSchema, MessageErrorSeverityEnumSchema, MessageInfoContentTypeEnumSchema, MessageInfoSchema, MessageSchema, MessageWarningContentTypeEnumSchema, MessageWarningSchema, OAuthServerMetadata, OptionValueSchema, OrderCapability, OrderConfirmationSchema, OrderLineItemSchema, OrderLineItemStatusEnumSchema, OrderUpdate, OrderUpdatePayload, OrderUpdateSchema, Pagination, PaginationSchema, PaymentCredential, PaymentCredentialSchema, PaymentHandlerBaseSchema, PaymentHandlerBusinessSchema, PaymentHandlerInstance, PaymentHandlerMap, PaymentHandlerPlatformSchema, PaymentHandlerResponseSchema, PaymentIdentitySchema, PaymentInstrument, PaymentInstrumentResponseSchema, PaymentInstrumentSchema, PaymentResponseSchema, PaymentSchema, PlatformFulfillmentConfigSchema, PostalAddress, PostalAddressSchema, PriceFilterSchema, PriceRangeSchema, PriceSchema, Product, ProductOptionSchema, ProductSchema, ProfileSchemaBaseSchema, ProfileSchemaBusinessProfileSchema, ProfileSchemaPlatformProfileSchema, ProfileSchemaSigningKeySchema, ProfileSchemaSigningKeyUseEnumSchema, RatingSchema, RetailLocationSchema, ReverseDomainNameSchema, SearchFilters, SearchFiltersSchema, SelectedOptionSchema, ServiceBaseSchema, ServiceBaseTransportEnumSchema, ServiceBusinessSchema, ServicePlatformSchema, ServiceResponseSchema, ShippingDestinationSchema, SignalsSchema, SignedAmountSchema, TokenCredential, TokenCredentialSchema, TokenExchangeParams, TokenRefreshParams, TokenResponse, TokenRevokeParams, ToolDescriptor, ToolErrorResult, TotalResponseSchema, TotalSchema, TotalsSchema, UCPClient, UCPClientConfig, UCPProfile, UCPProfileSchema, UCPSpecOrder, UCPSpecOrderSchema, UCP_CAPABILITIES, UcpBaseSchema, UcpBaseStatusEnumSchema, UcpBusinessSchema, UcpDiscoveryBusinessProfileSchema, UcpDiscoveryPlatformProfileSchema, UcpEntitySchema, UcpErrorSchema, UcpPlatformSchema, UcpRequiresSchema, UcpResponseCartSchema, UcpResponseCatalogSchema, UcpResponseCheckoutSchema, UcpResponseOrderSchema, UcpSigningKeySchema, UcpSigningKeySchema$1, UcpSuccessSchema, UcpVersionConstraintSchema, UcpVersionSchema, UpdateCheckoutPayload, UpdateCheckoutRequestSchema, Variant, VariantSchema, WebhookEvent, WebhookEventSchema, connect, getAgentTools } from "./catch-errors-CM_1SIc1.js";
 
 //#region src/verify-signature.d.ts
 /**
@@ -49,9 +49,9 @@ interface WebhookVerifier {
  * if (!valid) return res.status(401).send('Invalid signature');
  * ```
  */
-declare function createWebhookVerifier(gatewayUrl: string): WebhookVerifier;
-
-//#endregion
+declare function createWebhookVerifier(gatewayUrl: string, options?: {
+  readonly refetchCooldownMs?: number;
+}): WebhookVerifier; //#endregion
 //#region src/parse-webhook-event.d.ts
 //# sourceMappingURL=verify-signature.d.ts.map
 /**
@@ -130,5 +130,5 @@ declare class UCPOAuthError extends Error {
 //#endregion
 //# sourceMappingURL=errors.d.ts.map
 
-export { AccountInfoSchema, AdapterOptions, AdjustmentSchema, AdjustmentStatusEnumSchema, AgentTool, Ap2MandateAp2WithCheckoutMandateSchema, Ap2MandateAp2WithMerchantAuthorizationSchema, Ap2MandateCheckoutMandateSchema, Ap2MandateErrorCodeSchema, Ap2MandateMerchantAuthorizationSchema, AuthorizationParams, BindingSchema, BusinessFulfillmentConfigSchema, BuyerConsent, BuyerConsentBuyerSchema, BuyerConsentConsentSchema, BuyerSchema, CapabilityBaseSchema, CapabilityBusinessSchema, CapabilityPlatformSchema, CapabilityResponseSchema, CardCredential, CardCredentialCardNumberTypeEnumSchema, CardCredentialSchema, CardPaymentInstrumentSchema, CheckoutCapability, CheckoutCompleteRequestSchema, CheckoutCreateRequestSchema, CheckoutExtensions, CheckoutResponseSchema, CheckoutResponseStatusSchema, CheckoutSchema, CheckoutSession, CheckoutSessionSchema, CheckoutSessionStatus, CheckoutStatusEnumSchema, CheckoutUpdateRequestSchema, CompleteCheckoutPayload, CompleteCheckoutRequestSchema, ConnectedClient, ContentType, ContextSchema, CreateCheckoutPayload, CreateCheckoutRequestSchema, DEFAULT_UCP_VERSION, DiscountAllocationSchema, DiscountAppliedDiscountMethodEnumSchema, DiscountAppliedDiscountSchema, DiscountDiscountsObjectSchema, EmbeddedConfigSchema, ExpectationMethodTypeEnumSchema, ExpectationSchema, FulfillmentAvailableMethodSchema, FulfillmentAvailableMethodTypeEnumSchema, FulfillmentDestinationSchema, FulfillmentEventSchema, FulfillmentExtensionFulfillmentAvailableMethodSchema, FulfillmentExtensionFulfillmentGroupSchema, FulfillmentExtensionFulfillmentMethodSchema, FulfillmentExtensionFulfillmentOptionSchema, FulfillmentExtensionFulfillmentSchema, FulfillmentGroupSchema, FulfillmentGroupUpdatePayload, FulfillmentGroupUpdateRequestSchema, FulfillmentMethodCreatePayload, FulfillmentMethodCreateRequestSchema, FulfillmentMethodResponseSchema, FulfillmentMethodSchema, FulfillmentMethodTypeEnumSchema, FulfillmentMethodUpdatePayload, FulfillmentMethodUpdateRequestSchema, FulfillmentOptionSchema, FulfillmentResponseSchema, FulfillmentSchema, IdentityLinkingCapability, ItemResponseSchema, ItemSchema, JWK, UcpSigningKeySchema as JWKSchema, JsonSchema, LineItemResponseSchema, LineItemSchema, LineItemUpdatePayload, LineItemUpdateRequestSchema, LinkSchema, LocalizationContext, MerchantFulfillmentConfigSchema, MessageErrorContentTypeEnumSchema, MessageErrorSchema, MessageErrorSeverityEnumSchema, MessageInfoContentTypeEnumSchema, MessageInfoSchema, MessageSchema, MessageSeverity, MessageType, MessageWarningContentTypeEnumSchema, MessageWarningSchema, OAuthServerMetadata, OrderCapability, OrderConfirmationSchema, OrderLineItemSchema, OrderLineItemStatusEnumSchema, OrderUpdate, OrderUpdatePayload, OrderUpdateSchema, PaymentCredential, PaymentCredentialSchema, PaymentHandlerBaseSchema, PaymentHandlerBusinessSchema, PaymentHandlerInstance, PaymentHandlerMap, PaymentHandlerPlatformSchema, PaymentHandlerResponseSchema, PaymentIdentitySchema, PaymentInstrument, PaymentInstrumentResponseSchema, PaymentInstrumentSchema, PaymentResponseSchema, PaymentSchema, PlatformFulfillmentConfigSchema, PostalAddress, PostalAddressSchema, ProfileSchemaBaseSchema, ProfileSchemaBusinessProfileSchema, ProfileSchemaPlatformProfileSchema, ProfileSchemaSigningKeySchema, ProfileSchemaSigningKeyUseEnumSchema, RetailLocationSchema, ServiceBaseSchema, ServiceBaseTransportEnumSchema, ServiceBusinessSchema, ServicePlatformSchema, ServiceResponseSchema, ShippingDestinationSchema, TokenCredential, TokenCredentialSchema, TokenExchangeParams, TokenRefreshParams, TokenResponse, TokenRevokeParams, ToolDescriptor, ToolErrorResult, TotalResponseSchema, TotalSchema, TotalTypeEnumSchema, UCPClient, UCPClientConfig, UCPError, UCPEscalationError, UCPIdempotencyConflictError, UCPMessage, UCPOAuthError, UCPProfile, UCPProfileSchema, UCPSpecOrder, OrderSchema as UCPSpecOrderSchema, UCP_CAPABILITIES, UcpBaseSchema, UcpBusinessSchema, UcpDiscoveryBusinessProfileSchema, UcpDiscoveryPlatformProfileSchema, UcpEntitySchema, UcpPlatformSchema, UcpResponseCheckoutSchema, UcpResponseOrderSchema, UcpReverseDomainNameSchema, UcpVersionSchema, UpdateCheckoutPayload, UpdateCheckoutRequestSchema, WebhookEvent, WebhookEventSchema, WebhookVerifier, connect, createWebhookVerifier, getAgentTools, parseWebhookEvent, verifyRequestSignature };
+export { AccountInfoSchema, AdapterOptions, AdjustmentSchema, AdjustmentStatusEnumSchema, AgentTool, AmountSchema, Ap2MandateAp2WithCheckoutMandateSchema, Ap2MandateAp2WithMerchantAuthorizationSchema, Ap2MandateCheckoutMandateSchema, Ap2MandateErrorCodeSchema, Ap2MandateMerchantAuthorizationSchema, AuthorizationParams, AvailablePaymentInstrumentSchema, BindingSchema, BusinessFulfillmentConfigSchema, BuyerConsent, BuyerConsentBuyerSchema, BuyerConsentConsentSchema, BuyerSchema, CapabilityBaseSchema, CapabilityBusinessSchema, CapabilityPlatformSchema, CapabilityResponseSchema, CardCredential, CardCredentialCardNumberTypeEnumSchema, CardCredentialSchema, CardPaymentInstrumentAvailableCardPaymentInstrumentSchema, Cart, CartCapability, CartCreatePayload, CartCreateRequestSchema, CartResponseSchema, CartSchema, CartUpdatePayload, CartUpdateRequestSchema, CatalogCapability, CatalogExtensions, CatalogLookupResponse, CatalogLookupSchema, CatalogSearchResponse, CatalogSearchSchema, CategorySchema, CheckoutCapability, CheckoutCompleteRequestSchema, CheckoutCreateRequestSchema, CheckoutExtensions, CheckoutResponseSchema, CheckoutResponseStatusSchema, CheckoutSchema, CheckoutSession, CheckoutSessionSchema, CheckoutSessionStatus, CheckoutStatusEnumSchema, CheckoutUpdateRequestSchema, CompleteCheckoutPayload, CompleteCheckoutRequestSchema, ConnectedClient, ContentType, ContextSchema, CreateCheckoutPayload, CreateCheckoutRequestSchema, DEFAULT_UCP_VERSION, DescriptionSchema, DetailOptionValue, DetailOptionValueSchema, DiscountAllocationSchema, DiscountAppliedDiscountMethodEnumSchema, DiscountAppliedDiscountSchema, DiscountDiscountsObjectSchema, EmbeddedConfigSchema, ErrorCodeSchema, ErrorResponseSchema, ExpectationMethodTypeEnumSchema, ExpectationSchema, FulfillmentAvailableMethodSchema, FulfillmentAvailableMethodTypeEnumSchema, FulfillmentDestinationSchema, FulfillmentEventSchema, FulfillmentExtensionFulfillmentAvailableMethodSchema, FulfillmentExtensionFulfillmentGroupSchema, FulfillmentExtensionFulfillmentMethodSchema, FulfillmentExtensionFulfillmentOptionSchema, FulfillmentExtensionFulfillmentSchema, FulfillmentGroupSchema, FulfillmentGroupUpdatePayload, FulfillmentGroupUpdateRequestSchema, FulfillmentMethodCreatePayload, FulfillmentMethodCreateRequestSchema, FulfillmentMethodResponseSchema, FulfillmentMethodSchema, FulfillmentMethodTypeEnumSchema, FulfillmentMethodUpdatePayload, FulfillmentMethodUpdateRequestSchema, FulfillmentOptionSchema, FulfillmentResponseSchema, FulfillmentSchema, IdentityLinkingCapability, InputCorrelationSchema, ItemResponseSchema, ItemSchema, JWK, UcpSigningKeySchema$1 as JWKSchema, JsonSchema, LineItemResponseSchema, LineItemSchema, LineItemUpdatePayload, LineItemUpdateRequestSchema, LinkSchema, LocalizationContext, MediaSchema, MerchantFulfillmentConfigSchema, MessageErrorContentTypeEnumSchema, MessageErrorSchema, MessageErrorSeverityEnumSchema, MessageInfoContentTypeEnumSchema, MessageInfoSchema, MessageSchema, MessageSeverity, MessageType, MessageWarningContentTypeEnumSchema, MessageWarningSchema, OAuthServerMetadata, OptionValueSchema, OrderCapability, OrderConfirmationSchema, OrderLineItemSchema, OrderLineItemStatusEnumSchema, OrderUpdate, OrderUpdatePayload, OrderUpdateSchema, Pagination, PaginationSchema, PaymentCredential, PaymentCredentialSchema, PaymentHandlerBaseSchema, PaymentHandlerBusinessSchema, PaymentHandlerInstance, PaymentHandlerMap, PaymentHandlerPlatformSchema, PaymentHandlerResponseSchema, PaymentIdentitySchema, PaymentInstrument, PaymentInstrumentResponseSchema, PaymentInstrumentSchema, PaymentResponseSchema, PaymentSchema, PlatformFulfillmentConfigSchema, PostalAddress, PostalAddressSchema, PriceFilterSchema, PriceRangeSchema, PriceSchema, Product, ProductOptionSchema, ProductSchema, ProfileSchemaBaseSchema, ProfileSchemaBusinessProfileSchema, ProfileSchemaPlatformProfileSchema, ProfileSchemaSigningKeySchema, ProfileSchemaSigningKeyUseEnumSchema, RatingSchema, RetailLocationSchema, ReverseDomainNameSchema, SearchFilters, SearchFiltersSchema, SelectedOptionSchema, ServiceBaseSchema, ServiceBaseTransportEnumSchema, ServiceBusinessSchema, ServicePlatformSchema, ServiceResponseSchema, ShippingDestinationSchema, SignalsSchema, SignedAmountSchema, TokenCredential, TokenCredentialSchema, TokenExchangeParams, TokenRefreshParams, TokenResponse, TokenRevokeParams, ToolDescriptor, ToolErrorResult, TotalResponseSchema, TotalSchema, TotalsSchema, UCPClient, UCPClientConfig, UCPError, UCPEscalationError, UCPIdempotencyConflictError, UCPMessage, UCPOAuthError, UCPProfile, UCPProfileSchema, UCPSpecOrder, UCPSpecOrderSchema, UCP_CAPABILITIES, UcpBaseSchema, UcpBaseStatusEnumSchema, UcpBusinessSchema, UcpDiscoveryBusinessProfileSchema, UcpDiscoveryPlatformProfileSchema, UcpEntitySchema, UcpErrorSchema, UcpPlatformSchema, UcpRequiresSchema, UcpResponseCartSchema, UcpResponseCatalogSchema, UcpResponseCheckoutSchema, UcpResponseOrderSchema, UcpSigningKeySchema, UcpSuccessSchema, UcpVersionConstraintSchema, UcpVersionSchema, UpdateCheckoutPayload, UpdateCheckoutRequestSchema, Variant, VariantSchema, WebhookEvent, WebhookEventSchema, WebhookVerifier, connect, createWebhookVerifier, getAgentTools, parseWebhookEvent, verifyRequestSignature };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/verify-signature.ts","../src/parse-webhook-event.ts","../src/errors.ts"],"sourcesContent":null,"mappings":";;;;;;;;;;;;;;;;;;;iBAWsB,sBAAA,wDAGE,QACrB;;AAJH;;;;AAIU;;UAsEO,eAAA;;;;;wDAKuC;AALxD;;;;;;;;;;;;;;;;;;AAyBgB,iBAAA,qBAAA,CAA2C,UAAe,EAAA,MAAA,CAAA,EAAf,eAAe;;;;;;;;;;;;;;;AAnG1E;;;;AAIU;;;;;;;;AAsEV;iBC1DgB,iBAAA,gBAAiC;;;;;KC3BrC,WAAA;KACA,eAAA;KAKA,WAAA;;UAGK,UAAA;iBACA;;;sBAGK;;;EFFA,SAAA,YAAA,CAAA,EEKI,WFLkB;;;AAIzC,cEKU,QAAA,SAAiB,KAAA,CFL3B;EAAO,SAAA,IAAA,EAAA,MAAA;iBEOO;;;;wBAIO;;8BAEM;EFyDb,WAAA,CAAA,IAAA,EAAe,MAAA,EAAA,OAKwB,EAAA,MAAO,EAAA,IAAA,CAAA,EEzDrD,WFyDqD,EAAA,UAAA,CAAA,EAAA,MAAA,EAAA,QAAA,EAAA;;2BErDlC;iCACM;;;;cAetB,2BAAA,SAAoC,QAAQ;;;;cAQ5C,kBAAA,SAA2B,KAAK;;;;;;cAYhC,aAAA,SAAsB,KAAK;EFqCxB,SAAA,UAAA,EAAA,MAAqB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/verify-signature.ts","../src/parse-webhook-event.ts","../src/errors.ts"],"sourcesContent":null,"mappings":";;;;;;;;;;;;;;;;;;;iBAWsB,sBAAA,wDAGE,QACrB;;AAJH;;;;AAIU;;UAsEO,eAAA;;;;;wDAKuC;AALxD;;;;;;;;;;;;;;;;;;AAyBgB,iBAAA,qBAAA,CAGb,UAAe,EAAA,MAAA,EAAA,QAAA,EAAA;;IAAf;;;;;;;;;;;;;AAtGH;;;;AAIU;;;;;;;;AAsEV;iBC1DgB,iBAAA,gBAAiC;;;;;KC3BrC,WAAA;KACA,eAAA;KAKA,WAAA;;UAGK,UAAA;iBACA;;;sBAGK;;;EFFA,SAAA,YAAA,CAAA,EEKI,WFLkB;;;AAIzC,cEKU,QAAA,SAAiB,KAAA,CFL3B;EAAO,SAAA,IAAA,EAAA,MAAA;iBEOO;;;;wBAIO;;8BAEM;EFyDb,WAAA,CAAA,IAAA,EAAe,MAAA,EAAA,OAKwB,EAAA,MAAO,EAAA,IAAA,CAAA,EEzDrD,WFyDqD,EAAA,UAAA,CAAA,EAAA,MAAA,EAAA,QAAA,EAAA;;2BErDlC;iCACM;;;;cAetB,2BAAA,SAAoC,QAAQ;;;;cAQ5C,kBAAA,SAA2B,KAAK;;;;;;cAYhC,aAAA,SAAsB,KAAK;EFqCxB,SAAA,UAAA,EAAA,MAAqB"}

package/dist/index.js

@@ -1,14 +1,15 @@
 import { UCPError, UCPEscalationError, UCPIdempotencyConflictError, UCPOAuthError } from "./errors-DX7yw6Gl.js";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
-import { AccountInfoSchema, AdjustmentSchema, AdjustmentStatusEnumSchema, Ap2MandateAp2WithCheckoutMandateSchema, Ap2MandateAp2WithMerchantAuthorizationSchema, Ap2MandateCheckoutMandateSchema, Ap2MandateErrorCodeSchema, Ap2MandateMerchantAuthorizationSchema, BindingSchema, BusinessFulfillmentConfigSchema, BuyerConsentBuyerSchema, BuyerConsentConsentSchema, BuyerSchema, CapabilityBaseSchema, CapabilityBusinessSchema, CapabilityPlatformSchema, CapabilityResponseSchema, CardCredentialCardNumberTypeEnumSchema, CardCredentialSchema, CardPaymentInstrumentSchema, CheckoutCompleteRequestSchema, CheckoutCreateRequestSchema, CheckoutResponseSchema, CheckoutResponseStatusSchema, CheckoutSchema, CheckoutStatusEnumSchema, CheckoutUpdateRequestSchema, ContextSchema, DiscountAllocationSchema, DiscountAppliedDiscountMethodEnumSchema, DiscountAppliedDiscountSchema, DiscountDiscountsObjectSchema, EmbeddedConfigSchema, ExpectationMethodTypeEnumSchema, ExpectationSchema, FulfillmentAvailableMethodSchema, FulfillmentAvailableMethodTypeEnumSchema, FulfillmentDestinationSchema, FulfillmentEventSchema, FulfillmentExtensionFulfillmentAvailableMethodSchema, FulfillmentExtensionFulfillmentGroupSchema, FulfillmentExtensionFulfillmentMethodSchema, FulfillmentExtensionFulfillmentOptionSchema, FulfillmentExtensionFulfillmentSchema, FulfillmentGroupSchema, FulfillmentGroupUpdateRequestSchema, FulfillmentMethodCreateRequestSchema, FulfillmentMethodResponseSchema, FulfillmentMethodSchema, FulfillmentMethodTypeEnumSchema, FulfillmentMethodUpdateRequestSchema, FulfillmentOptionSchema, FulfillmentResponseSchema, FulfillmentSchema, ItemResponseSchema, ItemSchema, LineItemResponseSchema, LineItemSchema, LineItemUpdateRequestSchema, LinkSchema, MerchantFulfillmentConfigSchema, MessageErrorContentTypeEnumSchema, MessageErrorSchema, MessageErrorSeverityEnumSchema, MessageInfoContentTypeEnumSchema, MessageInfoSchema, MessageSchema, MessageWarningContentTypeEnumSchema, MessageWarningSchema, OrderConfirmationSchema, OrderLineItemSchema, OrderLineItemStatusEnumSchema, OrderSchema, OrderUpdateSchema, PaymentCredentialSchema, PaymentHandlerBaseSchema, PaymentHandlerBusinessSchema, PaymentHandlerPlatformSchema, PaymentHandlerResponseSchema, PaymentIdentitySchema, PaymentInstrumentResponseSchema, PaymentInstrumentSchema, PaymentResponseSchema, PaymentSchema, PlatformFulfillmentConfigSchema, PostalAddressSchema, ProfileSchemaBaseSchema, ProfileSchemaBusinessProfileSchema, ProfileSchemaPlatformProfileSchema, ProfileSchemaSigningKeySchema, ProfileSchemaSigningKeyUseEnumSchema, RetailLocationSchema, ServiceBaseSchema, ServiceBaseTransportEnumSchema, ServiceBusinessSchema, ServicePlatformSchema, ServiceResponseSchema, ShippingDestinationSchema, TokenCredentialSchema, TotalResponseSchema, TotalSchema, TotalTypeEnumSchema, UcpBaseSchema, UcpBusinessSchema, UcpDiscoveryBusinessProfileSchema, UcpDiscoveryPlatformProfileSchema, UcpDiscoveryProfileSchema, UcpEntitySchema, UcpPlatformSchema, UcpResponseCheckoutSchema, UcpResponseOrderSchema, UcpReverseDomainNameSchema, UcpSigningKeySchema, UcpVersionSchema } from "@omnixhq/ucp-js-sdk";
+import { AccountInfoSchema, AdjustmentSchema, AdjustmentStatusEnumSchema, AmountSchema, Ap2MandateAp2WithCheckoutMandateSchema, Ap2MandateAp2WithMerchantAuthorizationSchema, Ap2MandateCheckoutMandateSchema, Ap2MandateErrorCodeSchema, Ap2MandateMerchantAuthorizationSchema, AvailablePaymentInstrumentSchema, BindingSchema, BusinessFulfillmentConfigSchema, BuyerConsentBuyerSchema, BuyerConsentConsentSchema, BuyerSchema, CapabilityBaseSchema, CapabilityBusinessSchema, CapabilityPlatformSchema, CapabilityResponseSchema, CardCredentialCardNumberTypeEnumSchema, CardCredentialSchema, CardPaymentInstrumentAvailableCardPaymentInstrumentSchema, CartCreateRequestSchema, CartSchema, CartSchema as CartSchema$1, CartUpdateRequestSchema, CatalogLookupSchema, CatalogSearchSchema, CategorySchema, CheckoutCompleteRequestSchema, CheckoutCompleteRequestSchema as CheckoutCompleteRequestSchema$1, CheckoutCreateRequestSchema, CheckoutCreateRequestSchema as CheckoutCreateRequestSchema$1, CheckoutResponseSchema, CheckoutResponseSchema as CheckoutResponseSchema$1, CheckoutResponseStatusSchema, CheckoutSchema, CheckoutStatusEnumSchema, CheckoutUpdateRequestSchema, CheckoutUpdateRequestSchema as CheckoutUpdateRequestSchema$1, ContextSchema, DescriptionSchema, DetailOptionValueSchema, DiscountAllocationSchema, DiscountAppliedDiscountMethodEnumSchema, DiscountAppliedDiscountSchema, DiscountDiscountsObjectSchema, EmbeddedConfigSchema, ErrorCodeSchema, ErrorResponseSchema, ExpectationMethodTypeEnumSchema, ExpectationSchema, FulfillmentAvailableMethodSchema, FulfillmentAvailableMethodTypeEnumSchema, FulfillmentDestinationSchema, FulfillmentEventSchema, FulfillmentExtensionFulfillmentAvailableMethodSchema, FulfillmentExtensionFulfillmentGroupSchema, FulfillmentExtensionFulfillmentMethodSchema, FulfillmentExtensionFulfillmentOptionSchema, FulfillmentExtensionFulfillmentSchema, FulfillmentGroupSchema, FulfillmentGroupUpdateRequestSchema, FulfillmentMethodCreateRequestSchema, FulfillmentMethodResponseSchema, FulfillmentMethodSchema, FulfillmentMethodTypeEnumSchema, FulfillmentMethodUpdateRequestSchema, FulfillmentOptionSchema, FulfillmentResponseSchema, FulfillmentSchema, InputCorrelationSchema, ItemResponseSchema, ItemSchema, LineItemResponseSchema, LineItemSchema, LineItemUpdateRequestSchema, LinkSchema, MediaSchema, MerchantFulfillmentConfigSchema, MessageErrorContentTypeEnumSchema, MessageErrorSchema, MessageErrorSeverityEnumSchema, MessageInfoContentTypeEnumSchema, MessageInfoSchema, MessageSchema, MessageWarningContentTypeEnumSchema, MessageWarningSchema, OptionValueSchema, OrderConfirmationSchema, OrderLineItemSchema, OrderLineItemStatusEnumSchema, OrderSchema, OrderSchema as UCPSpecOrderSchema, OrderUpdateSchema, PaginationSchema, PaymentCredentialSchema, PaymentHandlerBaseSchema, PaymentHandlerBusinessSchema, PaymentHandlerPlatformSchema, PaymentHandlerResponseSchema, PaymentIdentitySchema, PaymentInstrumentResponseSchema, PaymentInstrumentSchema, PaymentResponseSchema, PaymentSchema, PlatformFulfillmentConfigSchema, PostalAddressSchema, PriceFilterSchema, PriceRangeSchema, PriceSchema, ProductOptionSchema, ProductSchema, ProfileSchemaBaseSchema, ProfileSchemaBusinessProfileSchema, ProfileSchemaPlatformProfileSchema, ProfileSchemaSigningKeySchema, ProfileSchemaSigningKeyUseEnumSchema, RatingSchema, RetailLocationSchema, ReverseDomainNameSchema, SearchFiltersSchema, SelectedOptionSchema, ServiceBaseSchema, ServiceBaseTransportEnumSchema, ServiceBusinessSchema, ServicePlatformSchema, ServiceResponseSchema, ShippingDestinationSchema, SignalsSchema, SignedAmountSchema, TokenCredentialSchema, TotalResponseSchema, TotalSchema, TotalsSchema, UcpBaseSchema, UcpBaseStatusEnumSchema, UcpBusinessSchema, UcpDiscoveryBusinessProfileSchema, UcpDiscoveryPlatformProfileSchema, UcpDiscoveryProfileSchema, UcpEntitySchema, UcpErrorSchema, UcpPlatformSchema, UcpRequiresSchema, UcpResponseCartSchema, UcpResponseCatalogSchema, UcpResponseCheckoutSchema, UcpResponseOrderSchema, UcpSigningKeySchema, UcpSigningKeySchema as UcpSigningKeySchema$1, UcpSuccessSchema, UcpVersionConstraintSchema, UcpVersionSchema, VariantSchema } from "@omnixhq/ucp-js-sdk";
 
 //#region src/schemas.ts
-const CheckoutSessionSchema = CheckoutResponseSchema;
+const CheckoutSessionSchema = CheckoutResponseSchema$1;
 const UCPProfileSchema = UcpDiscoveryProfileSchema;
-const CreateCheckoutRequestSchema = CheckoutCreateRequestSchema;
-const UpdateCheckoutRequestSchema = CheckoutUpdateRequestSchema;
-const CompleteCheckoutRequestSchema = CheckoutCompleteRequestSchema;
+const CartResponseSchema = CartSchema$1;
+const CreateCheckoutRequestSchema = CheckoutCreateRequestSchema$1;
+const UpdateCheckoutRequestSchema = CheckoutUpdateRequestSchema$1;
+const CompleteCheckoutRequestSchema = CheckoutCompleteRequestSchema$1;
 const WebhookEventSchema = z.object({
 	event_id: z.string(),
 	created_time: z.string(),
@@ -58,7 +59,7 @@ var HttpClient = class HttpClient {
 			headers,
 			...body !== void 0 ? { body: JSON.stringify(body) } : {}
 		});
-		const data = await res.json().catch(() => ({}));
+		const data = await this.parseResponseBody(res);
 		if (!res.ok) this.throwFromResponse(data, res.status);
 		return data;
 	}
@@ -70,6 +71,18 @@ var HttpClient = class HttpClient {
 		}
 		return result.data;
 	}
+	async parseResponseBody(res) {
+		if (typeof res.text === "function") {
+			const text = await res.text();
+			try {
+				return JSON.parse(text);
+			} catch {
+				if (!res.ok) throw new UCPError("HTTP_ERROR", `Gateway returned ${res.status} with non-JSON body: ${text.slice(0, 200)}`, "error", res.status);
+				return {};
+			}
+		}
+		return await res.json().catch(() => ({}));
+	}
 	throwFromResponse(data, statusCode) {
 		if (typeof data === "object" && data !== null && Array.isArray(data["messages"])) {
 			const rawMessages = data["messages"];
@@ -131,7 +144,7 @@ function parseMessages(rawMessages) {
 		const type = validTypes.includes(rawType) ? rawType : "error";
 		return {
 			type,
-			content: String(record["content"] ?? "Unknown error"),
+			content: String(record["content"] ?? record["text"] ?? record["message"] ?? "Unknown error"),
 			...record["code"] !== void 0 ? { code: String(record["code"]) } : {}
 		};
 	});
@@ -232,7 +245,7 @@ var OrderCapability = class {
 	/** Retrieve an order by ID. Returns the UCP spec-compliant Order object. */
 	async get(id) {
 		const data = await this.http.request("GET", `/orders/${encodeURIComponent(id)}`);
-		return this.http.validate(data, OrderSchema);
+		return this.http.validate(data, UCPSpecOrderSchema);
 	}
 	/** Update an order with fulfillment events, adjustments, or status changes. */
 	async update(id, payload) {
@@ -246,6 +259,58 @@ var OrderCapability = class {
 	}
 };
 
+//#endregion
+//#region src/capabilities/catalog.ts
+/**
+* Catalog operations. Available when the server declares
+* `dev.ucp.shopping.catalog.search` and/or `dev.ucp.shopping.catalog.lookup`.
+*/
+var CatalogCapability = class {
+	extensions;
+	constructor(http, extensions) {
+		this.http = http;
+		this.extensions = extensions;
+	}
+	async search(query, filters, pagination) {
+		const payload = {
+			query,
+			...filters !== void 0 ? { filters } : {},
+			...pagination !== void 0 ? { pagination } : {}
+		};
+		const data = await this.http.request("POST", "/catalog/search", payload);
+		return this.http.validate(data, CatalogSearchSchema);
+	}
+	async getProduct(productId) {
+		const data = await this.http.request("POST", "/catalog/product", { id: productId });
+		return this.http.validate(data, CatalogLookupSchema);
+	}
+};
+
+//#endregion
+//#region src/capabilities/cart.ts
+/** Cart operations. Available when the server declares `dev.ucp.shopping.cart`. */
+var CartCapability = class {
+	constructor(http) {
+		this.http = http;
+	}
+	async create(payload) {
+		const data = await this.http.request("POST", "/carts", payload);
+		return this.http.validate(data, CartResponseSchema);
+	}
+	async get(id) {
+		const data = await this.http.request("GET", `/carts/${encodeURIComponent(id)}`);
+		return this.http.validate(data, CartResponseSchema);
+	}
+	async update(id, payload) {
+		const data = await this.http.request("PUT", `/carts/${encodeURIComponent(id)}`, payload);
+		return this.http.validate(data, CartResponseSchema);
+	}
+	async cancel(id) {
+		const data = await this.http.request("POST", `/carts/${encodeURIComponent(id)}/cancel`);
+		return this.http.validate(data, CartResponseSchema);
+	}
+};
+
 //#endregion
 //#region src/capabilities/identity-linking.ts
 const TokenResponseSchema = z.object({
@@ -313,8 +378,16 @@ var IdentityLinkingCapability = class {
 			},
 			body: body.toString()
 		});
-		if (!res.ok) throw new UCPOAuthError(`Token exchange failed with status ${res.status}`, res.status);
-		const raw = await res.json();
+		if (!res.ok) {
+			const errorBody = await res.text().catch(() => "");
+			throw new UCPOAuthError(`Token exchange failed with status ${res.status}${errorBody ? `: ${errorBody.slice(0, 200)}` : ""}`, res.status);
+		}
+		let raw;
+		try {
+			raw = await res.json();
+		} catch {
+			throw new UCPOAuthError("Token endpoint returned non-JSON response", res.status);
+		}
 		const parsed = TokenResponseSchema.safeParse(raw);
 		if (!parsed.success) throw new UCPOAuthError(`Invalid token response: ${parsed.error.message}`, res.status);
 		return parsed.data;
@@ -333,6 +406,9 @@ const UCP_CAPABILITIES = {
 	DISCOUNT: "dev.ucp.shopping.discount",
 	BUYER_CONSENT: "dev.ucp.shopping.buyer_consent",
 	ORDER: "dev.ucp.shopping.order",
+	CATALOG_SEARCH: "dev.ucp.shopping.catalog.search",
+	CATALOG_LOOKUP: "dev.ucp.shopping.catalog.lookup",
+	CART: "dev.ucp.shopping.cart",
 	IDENTITY_LINKING: "dev.ucp.common.identity_linking",
 	AP2_MANDATE: "dev.ucp.shopping.ap2_mandate"
 };
@@ -381,6 +457,11 @@ function getAgentTools(client) {
 		if (client.checkout.extensions.discount) tools.push(...discountTools(client));
 	}
 	if (client.order) tools.push(...orderTools(client));
+	if (client.catalog) {
+		if (client.catalog.extensions.search) tools.push(...catalogSearchTools(client));
+		if (client.catalog.extensions.lookup) tools.push(...catalogLookupTools(client));
+	}
+	if (client.cart) tools.push(...cartTools(client));
 	if (client.identityLinking) tools.push(...identityLinkingTools(client));
 	return tools;
 }
@@ -815,6 +896,180 @@ function orderTools(client) {
 		}
 	];
 }
+function catalogSearchTools(client) {
+	return [{
+		name: "search_catalog",
+		description: "Search the product catalog by query. Returns matching products with pagination.",
+		parameters: {
+			type: "object",
+			properties: {
+				query: {
+					type: "string",
+					description: "Search query string"
+				},
+				filters: {
+					type: "object",
+					description: "Optional search filters",
+					properties: {
+						categories: {
+							type: "array",
+							items: {
+								type: "object",
+								properties: {
+									value: { type: "string" },
+									taxonomy: { type: "string" }
+								}
+							},
+							description: "Category filters"
+						},
+						price: {
+							type: "object",
+							description: "Price range filter",
+							properties: {
+								min: { type: "number" },
+								max: { type: "number" }
+							}
+						}
+					}
+				},
+				pagination: {
+					type: "object",
+					description: "Pagination parameters"
+				}
+			},
+			required: ["query"]
+		},
+		execute: async (params) => client.catalog.search(params["query"], params["filters"], params["pagination"])
+	}];
+}
+function catalogLookupTools(client) {
+	return [{
+		name: "get_product",
+		description: "Get full product details by ID, including variants, pricing, and media.",
+		parameters: {
+			type: "object",
+			properties: { product_id: {
+				type: "string",
+				description: "Product ID"
+			} },
+			required: ["product_id"]
+		},
+		execute: async (params) => client.catalog.getProduct(params["product_id"])
+	}];
+}
+function cartTools(client) {
+	return [
+		{
+			name: "create_cart",
+			description: "Create a new cart with line items. Returns the cart with an ID for subsequent operations.",
+			parameters: {
+				type: "object",
+				properties: {
+					line_items: {
+						type: "array",
+						description: "Items to add to the cart",
+						items: {
+							type: "object",
+							properties: {
+								item: {
+									type: "object",
+									properties: { id: {
+										type: "string",
+										description: "Product or variant ID"
+									} },
+									required: ["id"]
+								},
+								quantity: {
+									type: "number",
+									description: "Quantity"
+								}
+							},
+							required: ["item", "quantity"]
+						}
+					},
+					context: {
+						type: "object",
+						description: "Localization context"
+					},
+					buyer: {
+						type: "object",
+						description: "Buyer information"
+					}
+				},
+				required: ["line_items"]
+			},
+			execute: async (params) => client.cart.create(params)
+		},
+		{
+			name: "get_cart",
+			description: "Get the current state of a cart by ID, including line items, totals, and messages.",
+			parameters: {
+				type: "object",
+				properties: { id: {
+					type: "string",
+					description: "Cart ID"
+				} },
+				required: ["id"]
+			},
+			execute: async (params) => client.cart.get(params["id"])
+		},
+		{
+			name: "update_cart",
+			description: "Update an existing cart with changed line items, context, or buyer information.",
+			parameters: {
+				type: "object",
+				properties: {
+					id: {
+						type: "string",
+						description: "Cart ID"
+					},
+					line_items: {
+						type: "array",
+						description: "Updated line items",
+						items: {
+							type: "object",
+							properties: {
+								item: {
+									type: "object",
+									properties: { id: { type: "string" } },
+									required: ["id"]
+								},
+								quantity: { type: "number" }
+							},
+							required: ["item", "quantity"]
+						}
+					},
+					context: {
+						type: "object",
+						description: "Updated localization context"
+					},
+					buyer: {
+						type: "object",
+						description: "Updated buyer information"
+					}
+				},
+				required: ["id"]
+			},
+			execute: async (params) => {
+				const { id,...payload } = params;
+				return client.cart.update(id, payload);
+			}
+		},
+		{
+			name: "cancel_cart",
+			description: "Cancel a cart by ID. Returns the final cart state before cleanup.",
+			parameters: {
+				type: "object",
+				properties: { id: {
+					type: "string",
+					description: "Cart ID"
+				} },
+				required: ["id"]
+			},
+			execute: async (params) => client.cart.cancel(params["id"])
+		}
+	];
+}
 function identityLinkingTools(client) {
 	return [
 		{
@@ -954,6 +1209,8 @@ async function connect(config, options) {
 	const capabilityNames = extractCapabilityNames(profile);
 	const checkout = buildCheckoutCapability(http, capabilityNames);
 	const order = capabilityNames.has(UCP_CAPABILITIES.ORDER) ? new OrderCapability(http) : null;
+	const catalog = buildCatalogCapability(http, capabilityNames);
+	const cart = capabilityNames.has(UCP_CAPABILITIES.CART) ? new CartCapability(http) : null;
 	const identityLinking = await buildIdentityLinking(config, capabilityNames);
 	const paymentHandlers = extractPaymentHandlers(profile);
 	const signingKeys = extractSigningKeys(profile);
@@ -962,9 +1219,11 @@ async function connect(config, options) {
 		signingKeys,
 		checkout,
 		order,
+		catalog,
+		cart,
 		identityLinking,
 		paymentHandlers,
-		describeTools: () => buildToolDescriptors(checkout, order, identityLinking),
+		describeTools: () => buildToolDescriptors(checkout, order, catalog, cart, identityLinking),
 		getAgentTools: () => getAgentTools(client)
 	};
 	return Object.freeze(client);
@@ -1019,6 +1278,14 @@ function buildCheckoutCapability(http, capabilityNames) {
 	};
 	return new CheckoutCapability(http, extensions);
 }
+function buildCatalogCapability(http, capabilityNames) {
+	const extensions = {
+		search: capabilityNames.has(UCP_CAPABILITIES.CATALOG_SEARCH),
+		lookup: capabilityNames.has(UCP_CAPABILITIES.CATALOG_LOOKUP)
+	};
+	if (!extensions.search && !extensions.lookup) return null;
+	return new CatalogCapability(http, extensions);
+}
 const OAuthServerMetadataSchema = z.object({
 	issuer: z.string(),
 	authorization_endpoint: z.string().url(),
@@ -1036,12 +1303,17 @@ async function buildIdentityLinking(config, capabilityNames) {
 	const metadataUrl = `${gatewayUrl}/.well-known/oauth-authorization-server`;
 	const res = await fetch(metadataUrl);
 	if (!res.ok) throw new Error(`Identity linking capability declared but OAuth metadata fetch failed: ${res.status} from ${metadataUrl}`);
-	const raw = await res.json();
+	let raw;
+	try {
+		raw = await res.json();
+	} catch {
+		throw new Error(`Identity linking OAuth metadata endpoint returned non-JSON response from ${metadataUrl}`);
+	}
 	const parsed = OAuthServerMetadataSchema.safeParse(raw);
 	if (!parsed.success) throw new Error(`Identity linking OAuth metadata validation failed: ${parsed.error.message}`);
 	return new IdentityLinkingCapability(parsed.data);
 }
-function buildToolDescriptors(checkout, order, identityLinking) {
+function buildToolDescriptors(checkout, order, catalog, cart, identityLinking) {
 	const tools = [];
 	if (checkout) {
 		tools.push({
@@ -1109,6 +1381,35 @@ function buildToolDescriptors(checkout, order, identityLinking) {
 		capability: "order",
 		description: "Update a line item within an order"
 	});
+	if (catalog) {
+		if (catalog.extensions.search) tools.push({
+			name: "search_catalog",
+			capability: "catalog",
+			description: "Search the product catalog"
+		});
+		if (catalog.extensions.lookup) tools.push({
+			name: "get_product",
+			capability: "catalog",
+			description: "Get product details by ID"
+		});
+	}
+	if (cart) tools.push({
+		name: "create_cart",
+		capability: "cart",
+		description: "Create a new cart"
+	}, {
+		name: "get_cart",
+		capability: "cart",
+		description: "Get cart by ID"
+	}, {
+		name: "update_cart",
+		capability: "cart",
+		description: "Update an existing cart"
+	}, {
+		name: "cancel_cart",
+		capability: "cart",
+		description: "Cancel a cart"
+	});
 	if (identityLinking) tools.push({
 		name: "get_authorization_url",
 		capability: "identity_linking",
@@ -1196,10 +1497,12 @@ async function verifyRequestSignature(body, signature, signingKeys) {
 * if (!valid) return res.status(401).send('Invalid signature');
 * ```
 */
-function createWebhookVerifier(gatewayUrl) {
+function createWebhookVerifier(gatewayUrl, options) {
 	const baseUrl = gatewayUrl.replace(/\/+$/, "");
+	const refetchCooldownMs = options?.refetchCooldownMs ?? 6e4;
 	const keyCache = new Map();
 	let fetched = false;
+	let lastRefetchTime = 0;
 	let loadingPromise = null;
 	async function loadKeys() {
 		const res = await fetch(`${baseUrl}/.well-known/ucp`);
@@ -1236,7 +1539,13 @@ function createWebhookVerifier(gatewayUrl) {
 		const kid = extractKid(signature);
 		if (kid === null) return false;
 		if (!fetched) await ensureKeys();
-		if (!keyCache.has(kid)) await ensureKeys();
+		if (!keyCache.has(kid)) {
+			const now = Date.now();
+			if (now - lastRefetchTime >= refetchCooldownMs) {
+				lastRefetchTime = now;
+				await ensureKeys();
+			}
+		}
 		const key = keyCache.get(kid);
 		if (!key) return false;
 		return verifyRequestSignature(body, signature, [key]);
@@ -1300,5 +1609,5 @@ function parseWebhookEvent(body) {
 }
 
 //#endregion
-export { AccountInfoSchema, AdjustmentSchema, AdjustmentStatusEnumSchema, Ap2MandateAp2WithCheckoutMandateSchema, Ap2MandateAp2WithMerchantAuthorizationSchema, Ap2MandateCheckoutMandateSchema, Ap2MandateErrorCodeSchema, Ap2MandateMerchantAuthorizationSchema, BindingSchema, BusinessFulfillmentConfigSchema, BuyerConsentBuyerSchema, BuyerConsentConsentSchema, BuyerSchema, CapabilityBaseSchema, CapabilityBusinessSchema, CapabilityPlatformSchema, CapabilityResponseSchema, CardCredentialCardNumberTypeEnumSchema, CardCredentialSchema, CardPaymentInstrumentSchema, CheckoutCapability, CheckoutCompleteRequestSchema, CheckoutCreateRequestSchema, CheckoutResponseSchema, CheckoutResponseStatusSchema, CheckoutSchema, CheckoutSessionSchema, CheckoutStatusEnumSchema, CheckoutUpdateRequestSchema, CompleteCheckoutRequestSchema, ContextSchema, CreateCheckoutRequestSchema, DEFAULT_UCP_VERSION, DiscountAllocationSchema, DiscountAppliedDiscountMethodEnumSchema, DiscountAppliedDiscountSchema, DiscountDiscountsObjectSchema, EmbeddedConfigSchema, ExpectationMethodTypeEnumSchema, ExpectationSchema, FulfillmentAvailableMethodSchema, FulfillmentAvailableMethodTypeEnumSchema, FulfillmentDestinationSchema, FulfillmentEventSchema, FulfillmentExtensionFulfillmentAvailableMethodSchema, FulfillmentExtensionFulfillmentGroupSchema, FulfillmentExtensionFulfillmentMethodSchema, FulfillmentExtensionFulfillmentOptionSchema, FulfillmentExtensionFulfillmentSchema, FulfillmentGroupSchema, FulfillmentGroupUpdateRequestSchema, FulfillmentMethodCreateRequestSchema, FulfillmentMethodResponseSchema, FulfillmentMethodSchema, FulfillmentMethodTypeEnumSchema, FulfillmentMethodUpdateRequestSchema, FulfillmentOptionSchema, FulfillmentResponseSchema, FulfillmentSchema, IdentityLinkingCapability, ItemResponseSchema, ItemSchema, UcpSigningKeySchema as JWKSchema, LineItemResponseSchema, LineItemSchema, LineItemUpdateRequestSchema, LinkSchema, MerchantFulfillmentConfigSchema, MessageErrorContentTypeEnumSchema, MessageErrorSchema, MessageErrorSeverityEnumSchema, MessageInfoContentTypeEnumSchema, MessageInfoSchema, MessageSchema, MessageWarningContentTypeEnumSchema, MessageWarningSchema, OrderCapability, OrderConfirmationSchema, OrderLineItemSchema, OrderLineItemStatusEnumSchema, OrderUpdateSchema, PaymentCredentialSchema, PaymentHandlerBaseSchema, PaymentHandlerBusinessSchema, PaymentHandlerPlatformSchema, PaymentHandlerResponseSchema, PaymentIdentitySchema, PaymentInstrumentResponseSchema, PaymentInstrumentSchema, PaymentResponseSchema, PaymentSchema, PlatformFulfillmentConfigSchema, PostalAddressSchema, ProfileSchemaBaseSchema, ProfileSchemaBusinessProfileSchema, ProfileSchemaPlatformProfileSchema, ProfileSchemaSigningKeySchema, ProfileSchemaSigningKeyUseEnumSchema, RetailLocationSchema, ServiceBaseSchema, ServiceBaseTransportEnumSchema, ServiceBusinessSchema, ServicePlatformSchema, ServiceResponseSchema, ShippingDestinationSchema, TokenCredentialSchema, TotalResponseSchema, TotalSchema, TotalTypeEnumSchema, UCPClient, UCPError, UCPEscalationError, UCPIdempotencyConflictError, UCPOAuthError, UCPProfileSchema, OrderSchema as UCPSpecOrderSchema, UCP_CAPABILITIES, UcpBaseSchema, UcpBusinessSchema, UcpDiscoveryBusinessProfileSchema, UcpDiscoveryPlatformProfileSchema, UcpEntitySchema, UcpPlatformSchema, UcpResponseCheckoutSchema, UcpResponseOrderSchema, UcpReverseDomainNameSchema, UcpVersionSchema, UpdateCheckoutRequestSchema, WebhookEventSchema, connect, createWebhookVerifier, getAgentTools, parseWebhookEvent, verifyRequestSignature };
+export { AccountInfoSchema, AdjustmentSchema, AdjustmentStatusEnumSchema, AmountSchema, Ap2MandateAp2WithCheckoutMandateSchema, Ap2MandateAp2WithMerchantAuthorizationSchema, Ap2MandateCheckoutMandateSchema, Ap2MandateErrorCodeSchema, Ap2MandateMerchantAuthorizationSchema, AvailablePaymentInstrumentSchema, BindingSchema, BusinessFulfillmentConfigSchema, BuyerConsentBuyerSchema, BuyerConsentConsentSchema, BuyerSchema, CapabilityBaseSchema, CapabilityBusinessSchema, CapabilityPlatformSchema, CapabilityResponseSchema, CardCredentialCardNumberTypeEnumSchema, CardCredentialSchema, CardPaymentInstrumentAvailableCardPaymentInstrumentSchema, CartCapability, CartCreateRequestSchema, CartResponseSchema, CartSchema, CartUpdateRequestSchema, CatalogCapability, CatalogLookupSchema, CatalogSearchSchema, CategorySchema, CheckoutCapability, CheckoutCompleteRequestSchema, CheckoutCreateRequestSchema, CheckoutResponseSchema, CheckoutResponseStatusSchema, CheckoutSchema, CheckoutSessionSchema, CheckoutStatusEnumSchema, CheckoutUpdateRequestSchema, CompleteCheckoutRequestSchema, ContextSchema, CreateCheckoutRequestSchema, DEFAULT_UCP_VERSION, DescriptionSchema, DetailOptionValueSchema, DiscountAllocationSchema, DiscountAppliedDiscountMethodEnumSchema, DiscountAppliedDiscountSchema, DiscountDiscountsObjectSchema, EmbeddedConfigSchema, ErrorCodeSchema, ErrorResponseSchema, ExpectationMethodTypeEnumSchema, ExpectationSchema, FulfillmentAvailableMethodSchema, FulfillmentAvailableMethodTypeEnumSchema, FulfillmentDestinationSchema, FulfillmentEventSchema, FulfillmentExtensionFulfillmentAvailableMethodSchema, FulfillmentExtensionFulfillmentGroupSchema, FulfillmentExtensionFulfillmentMethodSchema, FulfillmentExtensionFulfillmentOptionSchema, FulfillmentExtensionFulfillmentSchema, FulfillmentGroupSchema, FulfillmentGroupUpdateRequestSchema, FulfillmentMethodCreateRequestSchema, FulfillmentMethodResponseSchema, FulfillmentMethodSchema, FulfillmentMethodTypeEnumSchema, FulfillmentMethodUpdateRequestSchema, FulfillmentOptionSchema, FulfillmentResponseSchema, FulfillmentSchema, IdentityLinkingCapability, InputCorrelationSchema, ItemResponseSchema, ItemSchema, UcpSigningKeySchema as JWKSchema, LineItemResponseSchema, LineItemSchema, LineItemUpdateRequestSchema, LinkSchema, MediaSchema, MerchantFulfillmentConfigSchema, MessageErrorContentTypeEnumSchema, MessageErrorSchema, MessageErrorSeverityEnumSchema, MessageInfoContentTypeEnumSchema, MessageInfoSchema, MessageSchema, MessageWarningContentTypeEnumSchema, MessageWarningSchema, OptionValueSchema, OrderCapability, OrderConfirmationSchema, OrderLineItemSchema, OrderLineItemStatusEnumSchema, OrderUpdateSchema, PaginationSchema, PaymentCredentialSchema, PaymentHandlerBaseSchema, PaymentHandlerBusinessSchema, PaymentHandlerPlatformSchema, PaymentHandlerResponseSchema, PaymentIdentitySchema, PaymentInstrumentResponseSchema, PaymentInstrumentSchema, PaymentResponseSchema, PaymentSchema, PlatformFulfillmentConfigSchema, PostalAddressSchema, PriceFilterSchema, PriceRangeSchema, PriceSchema, ProductOptionSchema, ProductSchema, ProfileSchemaBaseSchema, ProfileSchemaBusinessProfileSchema, ProfileSchemaPlatformProfileSchema, ProfileSchemaSigningKeySchema, ProfileSchemaSigningKeyUseEnumSchema, RatingSchema, RetailLocationSchema, ReverseDomainNameSchema, SearchFiltersSchema, SelectedOptionSchema, ServiceBaseSchema, ServiceBaseTransportEnumSchema, ServiceBusinessSchema, ServicePlatformSchema, ServiceResponseSchema, ShippingDestinationSchema, SignalsSchema, SignedAmountSchema, TokenCredentialSchema, TotalResponseSchema, TotalSchema, TotalsSchema, UCPClient, UCPError, UCPEscalationError, UCPIdempotencyConflictError, UCPOAuthError, UCPProfileSchema, UCPSpecOrderSchema, UCP_CAPABILITIES, UcpBaseSchema, UcpBaseStatusEnumSchema, UcpBusinessSchema, UcpDiscoveryBusinessProfileSchema, UcpDiscoveryPlatformProfileSchema, UcpEntitySchema, UcpErrorSchema, UcpPlatformSchema, UcpRequiresSchema, UcpResponseCartSchema, UcpResponseCatalogSchema, UcpResponseCheckoutSchema, UcpResponseOrderSchema, UcpSigningKeySchema$1 as UcpSigningKeySchema, UcpSuccessSchema, UcpVersionConstraintSchema, UcpVersionSchema, UpdateCheckoutRequestSchema, VariantSchema, WebhookEventSchema, connect, createWebhookVerifier, getAgentTools, parseWebhookEvent, verifyRequestSignature };
 //# sourceMappingURL=index.js.map