ebay-mcp 1.13.2 → 1.14.0

package/build/api/account-management/account.js

@@ -1,306 +1,642 @@
-import { withApiError } from '../../api/shared/request.js';
-/**
- * Account API - Seller account configuration, policies, programs
- * Based on: docs/sell-apps/account-management/sell_account_v1_oas3.json
- */
+import { buildEndpointParams, requestDeleteEffect, requestGetEffect, requestPostEffect, requestPutEffect, } from '../../api/shared/request.js';
+const ACCOUNT_BASE_PATH = '/sell/account/v1';
+/** Account API client for seller account policies, programs, tax, and eligibility. */
 export class AccountApi {
     client;
-    basePath = '/sell/account/v1';
     constructor(client) {
         this.client = client;
     }
     /**
-     * Get custom policies for the seller
-     */
-    async getCustomPolicies(policyTypes) {
-        const params = policyTypes ? { policy_types: policyTypes } : undefined;
-        return await withApiError('Failed to get custom policies', () => this.client.get(`${this.basePath}/custom_policy`, params));
-    }
-    /**
-     * Get a specific custom policy
-     */
-    async getCustomPolicy(customPolicyId) {
-        return await withApiError('Failed to get custom policy', () => this.client.get(`${this.basePath}/custom_policy/${customPolicyId}`));
-    }
-    /**
-     * Get fulfillment policies
-     * @param marketplaceId - Required: The eBay marketplace ID
-     */
-    async getFulfillmentPolicies(marketplaceId) {
-        return await withApiError('Failed to get fulfillment policies', () => this.client.get(`${this.basePath}/fulfillment_policy`, {
-            marketplace_id: marketplaceId,
-        }));
-    }
-    /**
-     * Get payment policies
-     * @param marketplaceId - Required: The eBay marketplace ID
-     */
-    async getPaymentPolicies(marketplaceId) {
-        return await withApiError('Failed to get payment policies', () => this.client.get(`${this.basePath}/payment_policy`, {
-            marketplace_id: marketplaceId,
-        }));
-    }
-    /**
-     * Get return policies
-     * @param marketplaceId - Required: The eBay marketplace ID
-     */
-    async getReturnPolicies(marketplaceId) {
-        return await withApiError('Failed to get return policies', () => this.client.get(`${this.basePath}/return_policy`, {
-            marketplace_id: marketplaceId,
-        }));
-    }
-    /**
-     * Get seller account privileges
-     */
-    async getPrivileges() {
-        return await withApiError('Failed to get privileges', () => this.client.get(`${this.basePath}/privilege`));
-    }
-    // ============================================================
-    // Fulfillment Policy Methods
-    // ============================================================
-    /**
-     * Create a new fulfillment policy
-     */
-    async createFulfillmentPolicy(policy) {
-        return await withApiError('Failed to create fulfillment policy', () => this.client.post(`${this.basePath}/fulfillment_policy`, policy));
-    }
-    /**
-     * Get a specific fulfillment policy by ID
-     */
-    async getFulfillmentPolicy(fulfillmentPolicyId) {
-        return await withApiError('Failed to get fulfillment policy', () => this.client.get(`${this.basePath}/fulfillment_policy/${fulfillmentPolicyId}`));
-    }
-    /**
-     * Get a fulfillment policy by name
-     */
-    async getFulfillmentPolicyByName(marketplaceId, name) {
-        return await withApiError('Failed to get fulfillment policy by name', () => this.client.get(`${this.basePath}/fulfillment_policy_by_name`, {
-            marketplace_id: marketplaceId,
-            name,
-        }));
-    }
-    /**
-     * Update a fulfillment policy
-     */
-    async updateFulfillmentPolicy(fulfillmentPolicyId, policy) {
-        return await withApiError('Failed to update fulfillment policy', () => this.client.put(`${this.basePath}/fulfillment_policy/${fulfillmentPolicyId}`, policy));
-    }
-    /**
-     * Delete a fulfillment policy
-     */
-    async deleteFulfillmentPolicy(fulfillmentPolicyId) {
-        return await withApiError('Failed to delete fulfillment policy', () => this.client.delete(`${this.basePath}/fulfillment_policy/${fulfillmentPolicyId}`));
-    }
-    // ============================================================
-    // Payment Policy Methods
-    // ============================================================
-    /**
-     * Create a new payment policy
-     */
-    async createPaymentPolicy(policy) {
-        return await withApiError('Failed to create payment policy', () => this.client.post(`${this.basePath}/payment_policy`, policy));
-    }
-    /**
-     * Get a specific payment policy by ID
-     */
-    async getPaymentPolicy(paymentPolicyId) {
-        return await withApiError('Failed to get payment policy', () => this.client.get(`${this.basePath}/payment_policy/${paymentPolicyId}`));
-    }
-    /**
-     * Get a payment policy by name
-     */
-    async getPaymentPolicyByName(marketplaceId, name) {
-        return await withApiError('Failed to get payment policy by name', () => this.client.get(`${this.basePath}/payment_policy_by_name`, {
-            marketplace_id: marketplaceId,
-            name,
-        }));
-    }
-    /**
-     * Update a payment policy
-     */
-    async updatePaymentPolicy(paymentPolicyId, policy) {
-        return await withApiError('Failed to update payment policy', () => this.client.put(`${this.basePath}/payment_policy/${paymentPolicyId}`, policy));
-    }
-    /**
-     * Delete a payment policy
-     */
-    async deletePaymentPolicy(paymentPolicyId) {
-        return await withApiError('Failed to delete payment policy', () => this.client.delete(`${this.basePath}/payment_policy/${paymentPolicyId}`));
-    }
-    // ============================================================
-    // Return Policy Methods
-    // ============================================================
-    /**
-     * Create a new return policy
-     */
-    async createReturnPolicy(policy) {
-        return await withApiError('Failed to create return policy', () => this.client.post(`${this.basePath}/return_policy`, policy));
-    }
-    /**
-     * Get a specific return policy by ID
-     */
-    async getReturnPolicy(returnPolicyId) {
-        return await withApiError('Failed to get return policy', () => this.client.get(`${this.basePath}/return_policy/${returnPolicyId}`));
-    }
-    /**
-     * Get a return policy by name
-     */
-    async getReturnPolicyByName(marketplaceId, name) {
-        return await withApiError('Failed to get return policy by name', () => this.client.get(`${this.basePath}/return_policy_by_name`, {
-            marketplace_id: marketplaceId,
-            name,
-        }));
-    }
-    /**
-     * Update a return policy
-     */
-    async updateReturnPolicy(returnPolicyId, policy) {
-        return await withApiError('Failed to update return policy', () => this.client.put(`${this.basePath}/return_policy/${returnPolicyId}`, policy));
-    }
-    /**
-     * Delete a return policy
-     */
-    async deleteReturnPolicy(returnPolicyId) {
-        return await withApiError('Failed to delete return policy', () => this.client.delete(`${this.basePath}/return_policy/${returnPolicyId}`));
-    }
-    // ============================================================
-    // Custom Policy Methods
-    // ============================================================
-    /**
-     * Create a new custom policy
-     */
-    async createCustomPolicy(policy) {
-        return await withApiError('Failed to create custom policy', () => this.client.post(`${this.basePath}/custom_policy`, policy));
-    }
-    /**
-     * Update a custom policy
-     */
-    async updateCustomPolicy(customPolicyId, policy) {
-        return await withApiError('Failed to update custom policy', () => this.client.put(`${this.basePath}/custom_policy/${customPolicyId}`, policy));
-    }
-    /**
-     * Delete a custom policy
-     */
-    async deleteCustomPolicy(customPolicyId) {
-        return await withApiError('Failed to delete custom policy', () => this.client.delete(`${this.basePath}/custom_policy/${customPolicyId}`));
-    }
-    // ============================================================
-    // KYC, Payments Program, Rate Tables, Sales Tax, Subscription, Programs
-    // ============================================================
-    /**
-     * Get KYC status
-     */
-    async getKyc() {
-        return await withApiError('Failed to get kyc', () => this.client.get(`${this.basePath}/kyc`));
-    }
-    /**
-     * Opt-in to a payments program
-     */
-    async optInToPaymentsProgram(marketplaceId, paymentsProgramType) {
-        return await withApiError('Failed to opt in to payments program', () => this.client.post(`${this.basePath}/payments_program/${marketplaceId}/${paymentsProgramType}`, {}));
-    }
-    /**
-     * Get payments program status
-     */
-    async getPaymentsProgramStatus(marketplaceId, paymentsProgramType) {
-        return await withApiError('Failed to get payments program status', () => this.client.get(`${this.basePath}/payments_program/${marketplaceId}/${paymentsProgramType}`));
-    }
-    /**
-     * Get rate tables
-     */
-    async getRateTables() {
-        return await withApiError('Failed to get rate tables', () => this.client.get(`${this.basePath}/rate_table`));
-    }
-    /**
-     * Create or replace sales tax table
-     */
-    async createOrReplaceSalesTax(countryCode, jurisdictionId, salesTaxBase) {
-        return await withApiError('Failed to create or replace sales tax', () => this.client.put(`${this.basePath}/sales_tax/${countryCode}/${jurisdictionId}`, salesTaxBase));
-    }
-    /**
-     * Bulk create or replace sales tax tables
-     */
-    async bulkCreateOrReplaceSalesTax(requests) {
-        return await withApiError('Failed to bulk create or replace sales tax', () => this.client.post(`${this.basePath}/sales_tax/bulk_create_or_replace`, {
-            requests,
-        }));
-    }
-    /**
-     * Delete sales tax table
-     */
-    async deleteSalesTax(countryCode, jurisdictionId) {
-        return await withApiError('Failed to delete sales tax', () => this.client.delete(`${this.basePath}/sales_tax/${countryCode}/${jurisdictionId}`));
-    }
-    /**
-     * Get sales tax table
-     */
-    async getSalesTax(countryCode, jurisdictionId) {
-        return await withApiError('Failed to get sales tax', () => this.client.get(`${this.basePath}/sales_tax/${countryCode}/${jurisdictionId}`));
-    }
-    /**
-     * Get all sales tax tables
-     * @param countryCode - Required: Two-letter ISO 3166-1 country code
-     */
-    async getSalesTaxes(countryCode) {
-        return await withApiError('Failed to get sales taxes', () => this.client.get(`${this.basePath}/sales_tax`, {
-            country_code: countryCode,
-        }));
-    }
-    /**
-     * Get subscription information
-     */
-    async getSubscription(limitType) {
-        const params = limitType ? { limit: limitType } : undefined;
-        return await withApiError('Failed to get subscription', () => this.client.get(`${this.basePath}/subscription`, params));
-    }
-    /**
-     * Opt-in to a program
-     */
-    async optInToProgram(request) {
-        return await withApiError('Failed to opt in to program', () => this.client.post(`${this.basePath}/program/opt_in`, request));
-    }
-    /**
-     * Opt-out of a program
-     */
-    async optOutOfProgram(request) {
-        return await withApiError('Failed to opt out of program', () => this.client.post(`${this.basePath}/program/opt_out`, request));
-    }
-    /**
-     * Get opted-in programs
-     */
-    async getOptedInPrograms() {
-        return await withApiError('Failed to get opted in programs', () => this.client.get(`${this.basePath}/program`));
-    }
-    /**
-     * Get seller eligibility for advertising programs
-     * This method allows developers to check the seller eligibility status for eBay advertising programs.
-     * @param programTypes - Optional comma-separated list of program types to check
-     * @param marketplaceId - Required eBay marketplace ID (passed in X-EBAY-C-MARKETPLACE-ID header)
-     */
-    async getAdvertisingEligibility(marketplaceId, programTypes) {
-        const params = programTypes ? { program_types: programTypes } : undefined;
-        return await withApiError('Failed to get advertising eligibility', () => this.client.get(`${this.basePath}/advertising_eligibility`, params, {
+     * Retrieves custom policies defined for the seller account.
+     *
+     * @param input - Optional custom policy type filter.
+     * @returns An Effect that succeeds with eBay's generated CustomPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   accountApi.getCustomPolicies({ policyTypes: 'TAKE_BACK' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/custom_policy/methods/getCustomPolicies
+     */
+    getCustomPolicies = (input = {}) => {
+        const params = buildEndpointParams({
+            policyTypes: { wireName: 'policy_types', value: input.policyTypes },
+        });
+        return requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/custom_policy/`, params);
+    };
+    /**
+     * Retrieves one custom policy by ID.
+     *
+     * @param input - Custom policy identifier.
+     * @returns An Effect that succeeds with eBay's generated CustomPolicy.
+     *
+     * @example
+     * ```ts
+     * const policy = await Effect.runPromise(
+     *   accountApi.getCustomPolicy({ customPolicyId: '1234567890' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/custom_policy/methods/getCustomPolicy
+     */
+    getCustomPolicy = (input) => requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/custom_policy/${input.customPolicyId}`);
+    /**
+     * Creates a custom policy.
+     *
+     * @param input - Custom policy request body.
+     * @returns An Effect that succeeds with eBay's generated CustomPolicy.
+     *
+     * @example
+     * ```ts
+     * const policy = await Effect.runPromise(
+     *   accountApi.createCustomPolicy({ policy: { name: 'Compliance', policyType: 'PRODUCT_COMPLIANCE' } }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/custom_policy/methods/createCustomPolicy
+     */
+    createCustomPolicy = (input) => requestPostEffect(this.client, `${ACCOUNT_BASE_PATH}/custom_policy/`, input.policy);
+    /**
+     * Updates a custom policy by ID.
+     *
+     * @param input - Custom policy ID and full replacement policy payload.
+     * @returns An Effect that succeeds when eBay accepts the update.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountApi.updateCustomPolicy({ customPolicyId: '1234567890', policy }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/custom_policy/methods/updateCustomPolicy
+     */
+    updateCustomPolicy = (input) => requestPutEffect(this.client, `${ACCOUNT_BASE_PATH}/custom_policy/${input.customPolicyId}`, input.policy);
+    /**
+     * Retrieves fulfillment policies for one marketplace.
+     *
+     * @param input - Marketplace ID used as the `marketplace_id` query parameter.
+     * @returns An Effect that succeeds with eBay's generated FulfillmentPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   accountApi.getFulfillmentPolicies({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/fulfillment_policy/methods/getFulfillmentPolicies
+     */
+    getFulfillmentPolicies = (input) => {
+        const params = buildEndpointParams({
+            marketplaceId: { wireName: 'marketplace_id', value: input.marketplaceId },
+        });
+        return requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/fulfillment_policy`, params);
+    };
+    /**
+     * Creates a fulfillment policy.
+     *
+     * @param input - Fulfillment policy request body.
+     * @returns An Effect that succeeds with eBay's generated SetFulfillmentPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const created = await Effect.runPromise(
+     *   accountApi.createFulfillmentPolicy({ policy }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/fulfillment_policy/methods/createFulfillmentPolicy
+     */
+    createFulfillmentPolicy = (input) => requestPostEffect(this.client, `${ACCOUNT_BASE_PATH}/fulfillment_policy/`, input.policy);
+    /**
+     * Retrieves one fulfillment policy by ID.
+     *
+     * @param input - Fulfillment policy identifier.
+     * @returns An Effect that succeeds with eBay's generated FulfillmentPolicy.
+     *
+     * @example
+     * ```ts
+     * const policy = await Effect.runPromise(
+     *   accountApi.getFulfillmentPolicy({ fulfillmentPolicyId: 'FP123' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/fulfillment_policy/methods/getFulfillmentPolicy
+     */
+    getFulfillmentPolicy = (input) => requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/fulfillment_policy/${input.fulfillmentPolicyId}`);
+    /**
+     * Retrieves one fulfillment policy by marketplace and policy name.
+     *
+     * @param input - Marketplace ID and seller-defined policy name.
+     * @returns An Effect that succeeds with eBay's generated FulfillmentPolicy.
+     *
+     * @example
+     * ```ts
+     * const policy = await Effect.runPromise(
+     *   accountApi.getFulfillmentPolicyByName({ marketplaceId: 'EBAY_US', name: 'Standard Shipping' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/fulfillment_policy/methods/getFulfillmentPolicyByName
+     */
+    getFulfillmentPolicyByName = (input) => {
+        const params = buildEndpointParams({
+            marketplaceId: { wireName: 'marketplace_id', value: input.marketplaceId },
+            name: { wireName: 'name', value: input.name },
+        });
+        return requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/fulfillment_policy/get_by_policy_name`, params);
+    };
+    /**
+     * Updates a fulfillment policy by ID.
+     *
+     * @param input - Fulfillment policy ID and full replacement policy payload.
+     * @returns An Effect that succeeds with eBay's generated SetFulfillmentPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const updated = await Effect.runPromise(
+     *   accountApi.updateFulfillmentPolicy({ fulfillmentPolicyId: 'FP123', policy }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/fulfillment_policy/methods/updateFulfillmentPolicy
+     */
+    updateFulfillmentPolicy = (input) => requestPutEffect(this.client, `${ACCOUNT_BASE_PATH}/fulfillment_policy/${input.fulfillmentPolicyId}`, input.policy);
+    /**
+     * Deletes a fulfillment policy by ID.
+     *
+     * @param input - Fulfillment policy identifier.
+     * @returns An Effect that succeeds when eBay deletes the policy.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountApi.deleteFulfillmentPolicy({ fulfillmentPolicyId: 'FP123' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/fulfillment_policy/methods/deleteFulfillmentPolicy
+     */
+    deleteFulfillmentPolicy = (input) => requestDeleteEffect(this.client, `${ACCOUNT_BASE_PATH}/fulfillment_policy/${input.fulfillmentPolicyId}`);
+    /**
+     * Retrieves payment policies for one marketplace.
+     *
+     * @param input - Marketplace ID used as the `marketplace_id` query parameter.
+     * @returns An Effect that succeeds with eBay's generated PaymentPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   accountApi.getPaymentPolicies({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/payment_policy/methods/getPaymentPolicies
+     */
+    getPaymentPolicies = (input) => {
+        const params = buildEndpointParams({
+            marketplaceId: { wireName: 'marketplace_id', value: input.marketplaceId },
+        });
+        return requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/payment_policy`, params);
+    };
+    /**
+     * Creates a payment policy.
+     *
+     * @param input - Payment policy request body.
+     * @returns An Effect that succeeds with eBay's generated SetPaymentPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const created = await Effect.runPromise(accountApi.createPaymentPolicy({ policy }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/payment_policy/methods/createPaymentPolicy
+     */
+    createPaymentPolicy = (input) => requestPostEffect(this.client, `${ACCOUNT_BASE_PATH}/payment_policy`, input.policy);
+    /**
+     * Retrieves one payment policy by ID.
+     *
+     * @param input - Payment policy identifier.
+     * @returns An Effect that succeeds with eBay's generated PaymentPolicy.
+     *
+     * @example
+     * ```ts
+     * const policy = await Effect.runPromise(
+     *   accountApi.getPaymentPolicy({ paymentPolicyId: 'PP123' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/payment_policy/methods/getPaymentPolicy
+     */
+    getPaymentPolicy = (input) => requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/payment_policy/${input.paymentPolicyId}`);
+    /**
+     * Retrieves one payment policy by marketplace and policy name.
+     *
+     * @param input - Marketplace ID and seller-defined policy name.
+     * @returns An Effect that succeeds with eBay's generated PaymentPolicy.
+     *
+     * @example
+     * ```ts
+     * const policy = await Effect.runPromise(
+     *   accountApi.getPaymentPolicyByName({ marketplaceId: 'EBAY_US', name: 'Immediate Payment' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/payment_policy/methods/getPaymentPolicyByName
+     */
+    getPaymentPolicyByName = (input) => {
+        const params = buildEndpointParams({
+            marketplaceId: { wireName: 'marketplace_id', value: input.marketplaceId },
+            name: { wireName: 'name', value: input.name },
+        });
+        return requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/payment_policy/get_by_policy_name`, params);
+    };
+    /**
+     * Updates a payment policy by ID.
+     *
+     * @param input - Payment policy ID and full replacement policy payload.
+     * @returns An Effect that succeeds with eBay's generated SetPaymentPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const updated = await Effect.runPromise(
+     *   accountApi.updatePaymentPolicy({ paymentPolicyId: 'PP123', policy }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/payment_policy/methods/updatePaymentPolicy
+     */
+    updatePaymentPolicy = (input) => requestPutEffect(this.client, `${ACCOUNT_BASE_PATH}/payment_policy/${input.paymentPolicyId}`, input.policy);
+    /**
+     * Deletes a payment policy by ID.
+     *
+     * @param input - Payment policy identifier.
+     * @returns An Effect that succeeds when eBay deletes the policy.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(accountApi.deletePaymentPolicy({ paymentPolicyId: 'PP123' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/payment_policy/methods/deletePaymentPolicy
+     */
+    deletePaymentPolicy = (input) => requestDeleteEffect(this.client, `${ACCOUNT_BASE_PATH}/payment_policy/${input.paymentPolicyId}`);
+    /**
+     * Retrieves return policies for one marketplace.
+     *
+     * @param input - Marketplace ID used as the `marketplace_id` query parameter.
+     * @returns An Effect that succeeds with eBay's generated ReturnPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const policies = await Effect.runPromise(
+     *   accountApi.getReturnPolicies({ marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/return_policy/methods/getReturnPolicies
+     */
+    getReturnPolicies = (input) => {
+        const params = buildEndpointParams({
+            marketplaceId: { wireName: 'marketplace_id', value: input.marketplaceId },
+        });
+        return requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/return_policy`, params);
+    };
+    /**
+     * Creates a return policy.
+     *
+     * @param input - Return policy request body.
+     * @returns An Effect that succeeds with eBay's generated SetReturnPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const created = await Effect.runPromise(accountApi.createReturnPolicy({ policy }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/return_policy/methods/createReturnPolicy
+     */
+    createReturnPolicy = (input) => requestPostEffect(this.client, `${ACCOUNT_BASE_PATH}/return_policy`, input.policy);
+    /**
+     * Retrieves one return policy by ID.
+     *
+     * @param input - Return policy identifier.
+     * @returns An Effect that succeeds with eBay's generated ReturnPolicy.
+     *
+     * @example
+     * ```ts
+     * const policy = await Effect.runPromise(accountApi.getReturnPolicy({ returnPolicyId: 'RP123' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/return_policy/methods/getReturnPolicy
+     */
+    getReturnPolicy = (input) => requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/return_policy/${input.returnPolicyId}`);
+    /**
+     * Retrieves one return policy by marketplace and policy name.
+     *
+     * @param input - Marketplace ID and seller-defined policy name.
+     * @returns An Effect that succeeds with eBay's generated ReturnPolicy.
+     *
+     * @example
+     * ```ts
+     * const policy = await Effect.runPromise(
+     *   accountApi.getReturnPolicyByName({ marketplaceId: 'EBAY_US', name: '30 Day Returns' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/return_policy/methods/getReturnPolicyByName
+     */
+    getReturnPolicyByName = (input) => {
+        const params = buildEndpointParams({
+            marketplaceId: { wireName: 'marketplace_id', value: input.marketplaceId },
+            name: { wireName: 'name', value: input.name },
+        });
+        return requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/return_policy/get_by_policy_name`, params);
+    };
+    /**
+     * Updates a return policy by ID.
+     *
+     * @param input - Return policy ID and full replacement policy payload.
+     * @returns An Effect that succeeds with eBay's generated SetReturnPolicyResponse.
+     *
+     * @example
+     * ```ts
+     * const updated = await Effect.runPromise(
+     *   accountApi.updateReturnPolicy({ returnPolicyId: 'RP123', policy }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/return_policy/methods/updateReturnPolicy
+     */
+    updateReturnPolicy = (input) => requestPutEffect(this.client, `${ACCOUNT_BASE_PATH}/return_policy/${input.returnPolicyId}`, input.policy);
+    /**
+     * Deletes a return policy by ID.
+     *
+     * @param input - Return policy identifier.
+     * @returns An Effect that succeeds when eBay deletes the policy.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(accountApi.deleteReturnPolicy({ returnPolicyId: 'RP123' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/return_policy/methods/deleteReturnPolicy
+     */
+    deleteReturnPolicy = (input) => requestDeleteEffect(this.client, `${ACCOUNT_BASE_PATH}/return_policy/${input.returnPolicyId}`);
+    /**
+     * Retrieves seller payments program status.
+     *
+     * @param input - Marketplace ID and payments program type.
+     * @returns An Effect that succeeds with eBay's generated PaymentsProgramResponse.
+     *
+     * @example
+     * ```ts
+     * const status = await Effect.runPromise(
+     *   accountApi.getPaymentsProgram({ marketplaceId: 'EBAY_US', paymentsProgramType: 'EBAY_PAYMENTS' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/payments_program/methods/getPaymentsProgram
+     */
+    getPaymentsProgram = (input) => requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/payments_program/${input.marketplaceId}/${input.paymentsProgramType}`);
+    /**
+     * Retrieves seller payments program onboarding status.
+     *
+     * @param input - Marketplace ID and payments program type.
+     * @returns An Effect that succeeds with eBay's generated PaymentsProgramOnboardingResponse.
+     *
+     * @example
+     * ```ts
+     * const onboarding = await Effect.runPromise(
+     *   accountApi.getPaymentsProgramOnboarding({
+     *     marketplaceId: 'EBAY_US',
+     *     paymentsProgramType: 'EBAY_PAYMENTS',
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/program/methods/payments_program/onboarding/methods/getPaymentsProgramOnboarding
+     */
+    getPaymentsProgramOnboarding = (input) => requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/payments_program/${input.marketplaceId}/${input.paymentsProgramType}/onboarding`);
+    /**
+     * Retrieves the seller account privileges.
+     *
+     * @param _input - Empty object accepted for tool/API shape consistency.
+     * @returns An Effect that succeeds with eBay's generated SellingPrivileges.
+     *
+     * @example
+     * ```ts
+     * const privileges = await Effect.runPromise(accountApi.getPrivileges({}));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/privilege/methods/getPrivileges
+     */
+    getPrivileges = (_input = {}) => requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/privilege`);
+    /**
+     * Retrieves seller programs the account has opted into.
+     *
+     * @param _input - Empty object accepted for tool/API shape consistency.
+     * @returns An Effect that succeeds with eBay's generated Programs response.
+     *
+     * @example
+     * ```ts
+     * const programs = await Effect.runPromise(accountApi.getOptedInPrograms({}));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/program/methods/getOptedInPrograms
+     */
+    getOptedInPrograms = (_input = {}) => requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/program/get_opted_in_programs`);
+    /**
+     * Opts the seller into an Account API program.
+     *
+     * @param input - Program opt-in request body.
+     * @returns An Effect that succeeds when eBay accepts the opt-in request.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountApi.optInToProgram({ request: { programType: 'OUT_OF_STOCK_CONTROL' } }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/program/methods/optInToProgram
+     */
+    optInToProgram = (input) => requestPostEffect(this.client, `${ACCOUNT_BASE_PATH}/program/opt_in`, input.request);
+    /**
+     * Opts the seller out of an Account API program.
+     *
+     * @param input - Program opt-out request body.
+     * @returns An Effect that succeeds when eBay accepts the opt-out request.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountApi.optOutOfProgram({ request: { programType: 'OUT_OF_STOCK_CONTROL' } }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/program/methods/optOutOfProgram
+     */
+    optOutOfProgram = (input) => requestPostEffect(this.client, `${ACCOUNT_BASE_PATH}/program/opt_out`, input.request);
+    /**
+     * Retrieves seller rate tables.
+     *
+     * @param _input - Empty object accepted for tool/API shape consistency.
+     * @returns An Effect that succeeds with eBay's generated RateTableResponse.
+     *
+     * @example
+     * ```ts
+     * const rateTables = await Effect.runPromise(accountApi.getRateTables({}));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/rate_table/methods/getRateTables
+     */
+    getRateTables = (_input = {}) => requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/rate_table`);
+    /**
+     * Creates or replaces one sales tax table entry.
+     *
+     * @param input - Country, jurisdiction, and sales tax payload.
+     * @returns An Effect that succeeds when eBay accepts the sales tax table entry.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountApi.createOrReplaceSalesTax({ countryCode: 'US', jurisdictionId: 'CA', salesTaxBase }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/sales_tax/methods/createOrReplaceSalesTax
+     */
+    createOrReplaceSalesTax = (input) => requestPutEffect(this.client, `${ACCOUNT_BASE_PATH}/sales_tax/${input.countryCode}/${input.jurisdictionId}`, input.salesTaxBase);
+    /**
+     * Creates or replaces multiple sales tax table entries.
+     *
+     * @param input - Bulk sales tax request rows.
+     * @returns An Effect that succeeds when eBay accepts the bulk sales tax request.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountApi.bulkCreateOrReplaceSalesTax({ requests }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/sales_tax/methods/bulkCreateOrReplaceSalesTax
+     */
+    bulkCreateOrReplaceSalesTax = (input) => requestPostEffect(this.client, `${ACCOUNT_BASE_PATH}/bulk_create_or_replace_sales_tax`, {
+        requests: input.requests,
+    });
+    /**
+     * Deletes one sales tax table entry.
+     *
+     * @param input - Country and jurisdiction identifiers.
+     * @returns An Effect that succeeds when eBay deletes the sales tax table entry.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountApi.deleteSalesTax({ countryCode: 'US', jurisdictionId: 'CA' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/sales_tax/methods/deleteSalesTax
+     */
+    deleteSalesTax = (input) => requestDeleteEffect(this.client, `${ACCOUNT_BASE_PATH}/sales_tax/${input.countryCode}/${input.jurisdictionId}`);
+    /**
+     * Retrieves one sales tax table entry.
+     *
+     * @param input - Country and jurisdiction identifiers.
+     * @returns An Effect that succeeds with eBay's generated SalesTax.
+     *
+     * @example
+     * ```ts
+     * const tax = await Effect.runPromise(
+     *   accountApi.getSalesTax({ countryCode: 'US', jurisdictionId: 'CA' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/sales_tax/methods/getSalesTax
+     */
+    getSalesTax = (input) => requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/sales_tax/${input.countryCode}/${input.jurisdictionId}`);
+    /**
+     * Retrieves all sales tax table entries for one country.
+     *
+     * @param input - Country code used as the `country_code` query parameter.
+     * @returns An Effect that succeeds with eBay's generated SalesTaxes response.
+     *
+     * @example
+     * ```ts
+     * const taxes = await Effect.runPromise(accountApi.getSalesTaxes({ countryCode: 'US' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/sales_tax/methods/getSalesTaxes
+     */
+    getSalesTaxes = (input) => {
+        const params = buildEndpointParams({
+            countryCode: { wireName: 'country_code', value: input.countryCode },
+        });
+        return requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/sales_tax`, params);
+    };
+    /**
+     * Retrieves seller subscription information.
+     *
+     * @param input - Optional subscription limit and continuation token.
+     * @returns An Effect that succeeds with eBay's generated SubscriptionResponse.
+     *
+     * @example
+     * ```ts
+     * const subscription = await Effect.runPromise(accountApi.getSubscription({ limit: '10' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/subscription/methods/getSubscription
+     */
+    getSubscription = (input = {}) => {
+        const params = buildEndpointParams({
+            limit: { wireName: 'limit', value: input.limit },
+            continuationToken: { wireName: 'continuation_token', value: input.continuationToken },
+        });
+        return requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/subscription`, params);
+    };
+    /**
+     * Retrieves seller KYC status.
+     *
+     * @param _input - Empty object accepted for tool/API shape consistency.
+     * @returns An Effect that succeeds with eBay's generated KycResponse.
+     *
+     * @example
+     * ```ts
+     * const kyc = await Effect.runPromise(accountApi.getKyc({}));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/kyc/methods/getKYC
+     */
+    getKyc = (_input = {}) => requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/kyc`);
+    /**
+     * Retrieves seller advertising-program eligibility for one marketplace.
+     *
+     * @param input - Marketplace header and optional comma-separated program type filter.
+     * @returns An Effect that succeeds with eBay's generated SellerEligibilityMultiProgramResponse.
+     *
+     * @example
+     * ```ts
+     * const eligibility = await Effect.runPromise(
+     *   accountApi.getAdvertisingEligibility({ marketplaceId: 'EBAY_US', programTypes: 'PLA' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility
+     */
+    getAdvertisingEligibility = (input) => {
+        const params = buildEndpointParams({
+            programTypes: { wireName: 'program_types', value: input.programTypes },
+        });
+        return requestGetEffect(this.client, `${ACCOUNT_BASE_PATH}/advertising_eligibility`, params, {
             headers: {
-                'X-EBAY-C-MARKETPLACE-ID': marketplaceId,
+                'X-EBAY-C-MARKETPLACE-ID': input.marketplaceId,
             },
-        }));
-    }
-    /**
-     * Get payments program status for a marketplace
-     * Note: This method is deprecated as all seller accounts globally have been enabled for the new eBay payment and checkout flow.
-     * @param marketplaceId - The eBay marketplace ID
-     * @param paymentsProgramType - The type of payments program
-     */
-    async getPaymentsProgram(marketplaceId, paymentsProgramType) {
-        return await withApiError('Failed to get payments program', () => this.client.get(`${this.basePath}/payments_program/${marketplaceId}/${paymentsProgramType}`));
-    }
-    /**
-     * Get payments program onboarding information
-     * Note: This method is deprecated as all seller accounts globally have been enabled for the new eBay payment and checkout flow.
-     * @param marketplaceId - The eBay marketplace ID
-     * @param paymentsProgramType - The type of payments program
-     */
-    async getPaymentsProgramOnboarding(marketplaceId, paymentsProgramType) {
-        return await withApiError('Failed to get payments program onboarding', () => this.client.get(`${this.basePath}/payments_program/${marketplaceId}/${paymentsProgramType}/onboarding`));
-    }
+        });
+    };
 }