ebay-mcp 1.13.2 → 1.14.0

package/build/api/listing-metadata/metadata.js

@@ -1,221 +1,467 @@
-import { buildOptionalStringParams, requireObject, requireString, withApiError, } from '../shared/request.js';
-/**
- * Metadata API - Marketplace policies and configurations
- * Based on: docs/sell-apps/listing-metadata/sell_metadata_v1_oas3.json
- */
+import { buildEndpointParams, requestGetEffect, requestPostEffect, requireObjectEffect, requireStringEffect, optionalStringEffect, } from '../../api/shared/request.js';
+import { Effect } from 'effect';
+/** Metadata API - marketplace policies, compatibility metadata, and tax jurisdictions. */
 export class MetadataApi {
     client;
     basePath = '/sell/metadata/v1';
     constructor(client) {
         this.client = client;
     }
-    async getMarketplacePolicy(endpoint, marketplaceId, failureMessage) {
-        requireString(marketplaceId, 'marketplaceId');
-        const path = `${this.basePath}/marketplace/${marketplaceId}/${endpoint}`;
-        return await withApiError(failureMessage, () => this.client.get(path));
-    }
-    async getFilteredMarketplacePolicy(endpoint, marketplaceId, failureMessage, filter) {
-        requireString(marketplaceId, 'marketplaceId');
-        const params = buildOptionalStringParams({ filter });
-        const path = `${this.basePath}/marketplace/${marketplaceId}/${endpoint}`;
-        return await withApiError(failureMessage, () => this.client.get(path, params));
-    }
     /**
-     * Get automotive parts compatibility policies for a marketplace
-     * Endpoint: GET /marketplace/{marketplace_id}/get_automotive_parts_compatibility_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves automotive parts compatibility policies for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's AutomotivePartsCompatibilityPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getAutomotivePartsCompatibilityPolicies({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getAutomotivePartsCompatibilityPolicies
      */
-    async getAutomotivePartsCompatibilityPolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_automotive_parts_compatibility_policies', marketplaceId, 'Failed to get automotive parts compatibility policies', filter);
-    }
+    getAutomotivePartsCompatibilityPolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_automotive_parts_compatibility_policies', 'getAutomotivePartsCompatibilityPolicies');
     /**
-     * Get category policies for a marketplace
-     * Endpoint: GET /marketplace/{marketplace_id}/get_category_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves category policies for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's CategoryPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getCategoryPolicies({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getCategoryPolicies
      */
-    async getCategoryPolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_category_policies', marketplaceId, 'Failed to get category policies', filter);
-    }
+    getCategoryPolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_category_policies', 'getCategoryPolicies');
     /**
-     * Get extended producer responsibility policies
-     * Endpoint: GET /marketplace/{marketplace_id}/get_extended_producer_responsibility_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves extended producer responsibility policies for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's ExtendedProducerResponsibilityPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getExtendedProducerResponsibilityPolicies({ marketplaceId: 'EBAY_DE' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getExtendedProducerResponsibilityPolicies
      */
-    async getExtendedProducerResponsibilityPolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_extended_producer_responsibility_policies', marketplaceId, 'Failed to get extended producer responsibility policies', filter);
-    }
+    getExtendedProducerResponsibilityPolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_extended_producer_responsibility_policies', 'getExtendedProducerResponsibilityPolicies');
     /**
-     * Get hazardous materials labels
-     * Endpoint: GET /marketplace/{marketplace_id}/get_hazardous_materials_labels
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves hazardous materials labels for a marketplace.
+     *
+     * @param input - Marketplace identifier.
+     * @returns An Effect that succeeds with eBay's HazardousMaterialDetailsResponse.
+     *
+     * @example
+     * ```ts
+     * const labels = await Effect.runPromise(
+     *   metadataApi.getHazardousMaterialsLabels({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getHazardousMaterialsLabels
      */
-    async getHazardousMaterialsLabels(marketplaceId) {
-        return await this.getMarketplacePolicy('get_hazardous_materials_labels', marketplaceId, 'Failed to get hazardous materials labels');
-    }
+    getHazardousMaterialsLabels = (input) => this.getMarketplaceResource(input, 'get_hazardous_materials_labels', 'getHazardousMaterialsLabels');
     /**
-     * Get item condition policies for a marketplace
-     * Endpoint: GET /marketplace/{marketplace_id}/get_item_condition_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves item condition policies for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's ItemConditionPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getItemConditionPolicies({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getItemConditionPolicies
      */
-    async getItemConditionPolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_item_condition_policies', marketplaceId, 'Failed to get item condition policies', filter);
-    }
+    getItemConditionPolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_item_condition_policies', 'getItemConditionPolicies');
     /**
-     * Get listing structure policies
-     * Endpoint: GET /marketplace/{marketplace_id}/get_listing_structure_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves listing structure policies for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's ListingStructurePolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getListingStructurePolicies({ marketplaceId: 'EBAY_GB' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getListingStructurePolicies
      */
-    async getListingStructurePolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_listing_structure_policies', marketplaceId, 'Failed to get listing structure policies', filter);
-    }
-    /**
-     * Get negotiated price policies
-     * Endpoint: GET /marketplace/{marketplace_id}/get_negotiated_price_policies
-     * @throws Error if marketplaceId is missing or invalid
-     */
-    async getNegotiatedPricePolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_negotiated_price_policies', marketplaceId, 'Failed to get negotiated price policies', filter);
-    }
+    getListingStructurePolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_listing_structure_policies', 'getListingStructurePolicies');
     /**
-     * Get product safety labels
-     * Endpoint: GET /marketplace/{marketplace_id}/get_product_safety_labels
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves negotiated price policies for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's NegotiatedPricePolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getNegotiatedPricePolicies({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getNegotiatedPricePolicies
      */
-    async getProductSafetyLabels(marketplaceId) {
-        return await this.getMarketplacePolicy('get_product_safety_labels', marketplaceId, 'Failed to get product safety labels');
-    }
-    /**
-     * Get regulatory policies
-     * Endpoint: GET /marketplace/{marketplace_id}/get_regulatory_policies
-     * @throws Error if marketplaceId is missing or invalid
-     */
-    async getRegulatoryPolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_regulatory_policies', marketplaceId, 'Failed to get regulatory policies', filter);
-    }
+    getNegotiatedPricePolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_negotiated_price_policies', 'getNegotiatedPricePolicies');
     /**
-     * Get return policies for a marketplace
-     * Endpoint: GET /marketplace/{marketplace_id}/get_return_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves product safety labels for a marketplace.
+     *
+     * @param input - Marketplace identifier.
+     * @returns An Effect that succeeds with eBay's ProductSafetyLabelsResponse.
+     *
+     * @example
+     * ```ts
+     * const labels = await Effect.runPromise(
+     *   metadataApi.getProductSafetyLabels({ marketplaceId: 'EBAY_DE' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getProductSafetyLabels
      */
-    async getReturnPolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_return_policies', marketplaceId, 'Failed to get return policies', filter);
-    }
+    getProductSafetyLabels = (input) => this.getMarketplaceResource(input, 'get_product_safety_labels', 'getProductSafetyLabels');
     /**
-     * Get shipping cost type policies
-     * Endpoint: GET /marketplace/{marketplace_id}/get_shipping_cost_type_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves regulatory policies for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's RegulatoryPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getRegulatoryPolicies({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getRegulatoryPolicies
      */
-    async getShippingCostTypePolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_shipping_cost_type_policies', marketplaceId, 'Failed to get shipping cost type policies', filter);
-    }
+    getRegulatoryPolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_regulatory_policies', 'getRegulatoryPolicies');
     /**
-     * Get classified ad policies for a marketplace
-     * Endpoint: GET /marketplace/{marketplace_id}/get_classified_ad_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves return policy metadata for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's ReturnPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getReturnPolicies({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getReturnPolicies
      */
-    async getClassifiedAdPolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_classified_ad_policies', marketplaceId, 'Failed to get classified ad policies', filter);
-    }
+    getReturnPolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_return_policies', 'getReturnPolicies');
     /**
-     * Get currencies for a marketplace
-     * Endpoint: GET /marketplace/{marketplace_id}/get_currencies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves classified ad policies for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's ClassifiedAdPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getClassifiedAdPolicies({ marketplaceId: 'EBAY_MOTORS_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getClassifiedAdPolicies
      */
-    async getCurrencies(marketplaceId) {
-        return await this.getMarketplacePolicy('get_currencies', marketplaceId, 'Failed to get currencies');
-    }
+    getClassifiedAdPolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_classified_ad_policies', 'getClassifiedAdPolicies');
     /**
-     * Get listing type policies for a marketplace
-     * Endpoint: GET /marketplace/{marketplace_id}/get_listing_type_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves currency metadata for a marketplace.
+     *
+     * @param input - Marketplace identifier.
+     * @returns An Effect that succeeds with eBay's GetCurrenciesResponse.
+     *
+     * @example
+     * ```ts
+     * const currencies = await Effect.runPromise(metadataApi.getCurrencies({ marketplaceId: 'EBAY_US' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getCurrencies
      */
-    async getListingTypePolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_listing_type_policies', marketplaceId, 'Failed to get listing type policies', filter);
-    }
+    getCurrencies = (input) => this.getMarketplaceResource(input, 'get_currencies', 'getCurrencies');
     /**
-     * Get motors listing policies for a marketplace
-     * Endpoint: GET /marketplace/{marketplace_id}/get_motors_listing_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves listing type policies for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's ListingTypePoliciesResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getListingTypePolicies({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getListingTypePolicies
      */
-    async getMotorsListingPolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_motors_listing_policies', marketplaceId, 'Failed to get motors listing policies', filter);
-    }
+    getListingTypePolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_listing_type_policies', 'getListingTypePolicies');
     /**
-     * Get shipping policies for a marketplace
-     * Endpoint: GET /marketplace/{marketplace_id}/get_shipping_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves Motors listing policies for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's MotorsListingPoliciesResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getMotorsListingPolicies({ marketplaceId: 'EBAY_MOTORS_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getMotorsListingPolicies
      */
-    async getShippingPolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_shipping_policies', marketplaceId, 'Failed to get shipping policies', filter);
-    }
+    getMotorsListingPolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_motors_listing_policies', 'getMotorsListingPolicies');
     /**
-     * Get site visibility policies for a marketplace
-     * Endpoint: GET /marketplace/{marketplace_id}/get_site_visibility_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves shipping policies for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's ShippingPoliciesResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getShippingPolicies({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getShippingPolicies
      */
-    async getSiteVisibilityPolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_site_visibility_policies', marketplaceId, 'Failed to get site visibility policies', filter);
-    }
+    getShippingPolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_shipping_policies', 'getShippingPolicies');
     /**
-     * Get compatibilities by specification
-     * Endpoint: POST /compatibilities/get_compatibilities_by_specification
-     * @throws Error if specification is missing or invalid
+     * Retrieves site visibility policies for a marketplace.
+     *
+     * @param input - Marketplace and optional category filter.
+     * @returns An Effect that succeeds with eBay's SiteVisibilityPoliciesResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   metadataApi.getSiteVisibilityPolicies({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getSiteVisibilityPolicies
      */
-    async getCompatibilitiesBySpecification(specification) {
-        requireObject(specification, 'specification');
-        return await withApiError('Failed to get compatibilities by specification', () => this.client.post(`${this.basePath}/compatibilities/get_compatibilities_by_specification`, specification));
-    }
+    getSiteVisibilityPolicies = (input) => this.getFilteredMarketplaceResource(input, 'get_site_visibility_policies', 'getSiteVisibilityPolicies');
     /**
-     * Get compatibility property names
-     * Endpoint: POST /compatibilities/get_compatibility_property_names
-     * @throws Error if request data is missing or invalid
+     * Retrieves compatibility records matching part specifications.
+     *
+     * @param input - Marketplace header and generated SpecificationRequest body.
+     * @returns An Effect that succeeds with eBay's SpecificationResponse.
+     *
+     * @example
+     * ```ts
+     * const compatibilities = await Effect.runPromise(
+     *   metadataApi.getCompatibilitiesBySpecification({
+     *     marketplaceId: 'EBAY_US',
+     *     specification: { categoryId: '6016' },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/compatibilities/methods/getCompatibilitiesBySpecification
      */
-    async getCompatibilityPropertyNames(data) {
-        requireObject(data, 'data');
-        return await withApiError('Failed to get compatibility property names', () => this.client.post(`${this.basePath}/compatibilities/get_compatibility_property_names`, data));
-    }
+    getCompatibilitiesBySpecification = (input) => {
+        const client = this.client;
+        const path = `${this.basePath}/compatibilities/get_compatibilities_by_specification`;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const marketplaceId = yield* requireStringEffect(validatedInput.marketplaceId, 'marketplaceId');
+            const body = yield* requireObjectEffect(validatedInput.specification, 'specification');
+            return yield* requestPostEffect(client, path, body, compatibilityHeaders(marketplaceId));
+        });
+    };
     /**
-     * Get compatibility property values
-     * Endpoint: POST /compatibilities/get_compatibility_property_values
-     * @throws Error if request data is missing or invalid
+     * Retrieves compatibility property names for a compatibility-enabled category.
+     *
+     * @param input - Marketplace header and generated PropertyNamesRequest body.
+     * @returns An Effect that succeeds with eBay's PropertyNamesResponse.
+     *
+     * @example
+     * ```ts
+     * const names = await Effect.runPromise(
+     *   metadataApi.getCompatibilityPropertyNames({
+     *     marketplaceId: 'EBAY_US',
+     *     data: { categoryId: '6016' },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/compatibilities/methods/getCompatibilityPropertyNames
      */
-    async getCompatibilityPropertyValues(data) {
-        requireObject(data, 'data');
-        return await withApiError('Failed to get compatibility property values', () => this.client.post(`${this.basePath}/compatibilities/get_compatibility_property_values`, data));
-    }
+    getCompatibilityPropertyNames = (input) => {
+        const client = this.client;
+        const path = `${this.basePath}/compatibilities/get_compatibility_property_names`;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const marketplaceId = yield* requireStringEffect(validatedInput.marketplaceId, 'marketplaceId');
+            const body = yield* requireObjectEffect(validatedInput.data, 'data');
+            return yield* requestPostEffect(client, path, body, compatibilityHeaders(marketplaceId));
+        });
+    };
     /**
-     * Get multi compatibility property values
-     * Endpoint: POST /compatibilities/get_multi_compatibility_property_values
-     * @throws Error if request data is missing or invalid
+     * Retrieves compatibility property values for one property.
+     *
+     * @param input - Marketplace header and generated PropertyValuesRequest body.
+     * @returns An Effect that succeeds with eBay's PropertyValuesResponse.
+     *
+     * @example
+     * ```ts
+     * const values = await Effect.runPromise(
+     *   metadataApi.getCompatibilityPropertyValues({
+     *     marketplaceId: 'EBAY_US',
+     *     data: { categoryId: '6016', propertyName: 'Make' },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/compatibilities/methods/getCompatibilityPropertyValues
      */
-    async getMultiCompatibilityPropertyValues(data) {
-        requireObject(data, 'data');
-        return await withApiError('Failed to get multi compatibility property values', () => this.client.post(`${this.basePath}/compatibilities/get_multi_compatibility_property_values`, data));
-    }
+    getCompatibilityPropertyValues = (input) => {
+        const client = this.client;
+        const path = `${this.basePath}/compatibilities/get_compatibility_property_values`;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const marketplaceId = yield* requireStringEffect(validatedInput.marketplaceId, 'marketplaceId');
+            const body = yield* requireObjectEffect(validatedInput.data, 'data');
+            return yield* requestPostEffect(client, path, body, compatibilityHeaders(marketplaceId));
+        });
+    };
     /**
-     * Get product compatibilities
-     * Endpoint: POST /compatibilities/get_product_compatibilities
-     * @throws Error if request data is missing or invalid
+     * Retrieves values for multiple compatibility properties.
+     *
+     * @param input - Marketplace header and generated MultiCompatibilityPropertyValuesRequest body.
+     * @returns An Effect that succeeds with eBay's MultiCompatibilityPropertyValuesResponse.
+     *
+     * @example
+     * ```ts
+     * const values = await Effect.runPromise(
+     *   metadataApi.getMultiCompatibilityPropertyValues({
+     *     marketplaceId: 'EBAY_US',
+     *     data: { categoryId: '6016', propertyNames: ['Make', 'Model'] },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/compatibilities/methods/getMultiCompatibilityPropertyValues
      */
-    async getProductCompatibilities(data) {
-        requireObject(data, 'data');
-        return await withApiError('Failed to get product compatibilities', () => this.client.post(`${this.basePath}/compatibilities/get_product_compatibilities`, data));
-    }
+    getMultiCompatibilityPropertyValues = (input) => {
+        const client = this.client;
+        const path = `${this.basePath}/compatibilities/get_multi_compatibility_property_values`;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const marketplaceId = yield* requireStringEffect(validatedInput.marketplaceId, 'marketplaceId');
+            const body = yield* requireObjectEffect(validatedInput.data, 'data');
+            return yield* requestPostEffect(client, path, body, compatibilityHeaders(marketplaceId));
+        });
+    };
     /**
-     * Get sales tax jurisdictions for a country
-     * Endpoint: GET /country/{countryCode}/sales_tax_jurisdiction
-     * @throws Error if countryCode is missing or invalid
+     * Retrieves product compatibility metadata.
+     *
+     * @param input - Marketplace header and generated ProductRequest body.
+     * @returns An Effect that succeeds with eBay's ProductResponse.
+     *
+     * @example
+     * ```ts
+     * const products = await Effect.runPromise(
+     *   metadataApi.getProductCompatibilities({
+     *     marketplaceId: 'EBAY_US',
+     *     data: { categoryId: '6016' },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/compatibilities/methods/getProductCompatibilities
      */
-    async getSalesTaxJurisdictions(countryCode) {
-        requireString(countryCode, 'countryCode');
-        return await withApiError('Failed to get sales tax jurisdictions', () => this.client.get(`${this.basePath}/country/${countryCode}/sales_tax_jurisdiction`));
-    }
+    getProductCompatibilities = (input) => {
+        const client = this.client;
+        const path = `${this.basePath}/compatibilities/get_product_compatibilities`;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const marketplaceId = yield* requireStringEffect(validatedInput.marketplaceId, 'marketplaceId');
+            const body = yield* requireObjectEffect(validatedInput.data, 'data');
+            return yield* requestPostEffect(client, path, body, compatibilityHeaders(marketplaceId));
+        });
+    };
     /**
-     * Get product compliance policies
-     * Endpoint: GET /marketplace/{marketplace_id}/get_product_compliance_policies
-     * @throws Error if marketplaceId is missing or invalid
+     * Retrieves sales-tax jurisdictions for a country.
+     *
+     * @param input - Country code whose sales-tax jurisdictions should be returned.
+     * @returns An Effect that succeeds with eBay's SalesTaxJurisdictions response.
+     *
+     * @example
+     * ```ts
+     * const jurisdictions = await Effect.runPromise(
+     *   metadataApi.getSalesTaxJurisdictions({ countryCode: 'US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/country/methods/getSalesTaxJurisdictions
      */
-    async getProductCompliancePolicies(marketplaceId, filter) {
-        return await this.getFilteredMarketplacePolicy('get_product_compliance_policies', marketplaceId, 'Failed to get product compliance policies', filter);
-    }
+    getSalesTaxJurisdictions = (input) => {
+        const client = this.client;
+        const basePath = this.basePath;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const countryCode = yield* requireStringEffect(validatedInput.countryCode, 'countryCode');
+            return yield* requestGetEffect(client, `${basePath}/country/${countryCode}/sales_tax_jurisdiction`);
+        });
+    };
+    getMarketplaceResource = (input, endpoint, parameterName) => {
+        const client = this.client;
+        const basePath = this.basePath;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const marketplaceId = yield* requireStringEffect(validatedInput.marketplaceId, 'marketplaceId');
+            return yield* requestGetEffect(client, `${basePath}/marketplace/${marketplaceId}/${endpoint}`);
+        }).pipe(Effect.withSpan(`metadata.${parameterName}`));
+    };
+    getFilteredMarketplaceResource = (input, endpoint, parameterName) => {
+        const client = this.client;
+        const basePath = this.basePath;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const marketplaceId = yield* requireStringEffect(validatedInput.marketplaceId, 'marketplaceId');
+            const filter = yield* optionalStringEffect(validatedInput.filter, 'filter');
+            const params = buildEndpointParams({
+                filter: { wireName: 'filter', value: filter },
+            });
+            return yield* requestGetEffect(client, `${basePath}/marketplace/${marketplaceId}/${endpoint}`, params);
+        }).pipe(Effect.withSpan(`metadata.${parameterName}`));
+    };
 }
+/**
+ * Builds required headers for Metadata compatibility POST endpoints.
+ *
+ * @param marketplaceId - eBay marketplace identifier sent as X-EBAY-C-MARKETPLACE-ID.
+ * @returns Request config with the compatibility headers required by the OpenAPI spec.
+ *
+ * @example
+ * ```ts
+ * const config = compatibilityHeaders('EBAY_US');
+ * ```
+ */
+export const compatibilityHeaders = (marketplaceId) => ({
+    headers: {
+        'Content-Type': 'application/json',
+        'X-EBAY-C-MARKETPLACE-ID': marketplaceId,
+    },
+});