ebay-mcp 1.17.0 → 1.18.2

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

@@ -0,0 +1,347 @@
+import { buildEndpointParams, marketplaceHeader, optionalStringEffect, requestGetEffect, requestPatchEffect, requestPostEffect, requireObjectEffect, requireStringEffect, } from '../../api/shared/request.js';
+import { Effect } from 'effect';
+/** Account API v2 - rate tables, payout settings, combined shipping rules, and user preferences. */
+export class AccountV2Api {
+    basePath = '/sell/account/v2';
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves one shipping rate table with its rates, so their rateIds can be updated.
+     *
+     * @param input - Rate table ID (path), from Account API v1 getRateTables.
+     * @returns An Effect that succeeds with eBay's generated RateTableDetails.
+     *
+     * @example
+     * ```ts
+     * const table = await Effect.runPromise(accountV2Api.getRateTable({ rateTableId: '5000000000' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/rate_table/methods/getRateTable
+     */
+    getRateTable = (input) => {
+        const { client, basePath } = this;
+        return Effect.gen(function* () {
+            const validInput = yield* requireObjectEffect(input, 'input');
+            const rateTableId = yield* requireStringEffect(validInput.rateTableId, 'rateTableId');
+            return yield* requestGetEffect(client, `${basePath}/rate_table/${encodeURIComponent(rateTableId)}`);
+        });
+    };
+    /**
+     * Updates the shippingCost and/or additionalCost of rates in a shipping rate table.
+     *
+     * @param input - Rate table ID (path) and the RateTableUpdate body.
+     * @returns An Effect that succeeds when eBay returns 204 No Content.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountV2Api.updateShippingCost({
+     *     rateTableId: '5000000000',
+     *     rateTableUpdate: { rates: [{ rateId: 'R1', shippingCost: { currency: 'USD', value: '4.99' } }] },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/rate_table/methods/updateShippingCost
+     */
+    updateShippingCost = (input) => {
+        const { client, basePath } = this;
+        return Effect.gen(function* () {
+            const validInput = yield* requireObjectEffect(input, 'input');
+            const rateTableId = yield* requireStringEffect(validInput.rateTableId, 'rateTableId');
+            const rateTableUpdate = yield* requireObjectEffect(validInput.rateTableUpdate, 'rateTableUpdate');
+            const path = `${basePath}/rate_table/${encodeURIComponent(rateTableId)}/update_shipping_cost`;
+            return yield* requestPostEffect(client, path, rateTableUpdate);
+        });
+    };
+    /**
+     * Retrieves the seller's payout instruments and split-payout percentages
+     * (mainland China sellers only). Requires the sell.finances scope.
+     *
+     * @param _input - Empty object accepted for tool/API shape consistency.
+     * @returns An Effect that succeeds with eBay's generated PayoutSettingsResponse.
+     *
+     * @example
+     * ```ts
+     * const settings = await Effect.runPromise(accountV2Api.getPayoutSettings({}));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/payout_settings/methods/getPayoutSettings
+     */
+    getPayoutSettings = (_input = {}) => requestGetEffect(this.client, `${this.basePath}/payout_settings`);
+    /**
+     * Sets the split-payout percentage across the seller's two payout instruments
+     * (mainland China sellers only; percentages must total 100). Requires sell.finances.
+     *
+     * @param input - UpdatePayoutPercentageRequest body under `payoutSplit`.
+     * @returns An Effect that succeeds when eBay returns 204 No Content.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountV2Api.updatePayoutPercentage({
+     *     payoutSplit: {
+     *       payoutInstruments: [
+     *         { instrumentId: 'BANK-1', payoutPercentage: '70' },
+     *         { instrumentId: 'PAYONEER-1', payoutPercentage: '30' },
+     *       ],
+     *     },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/payout_settings/methods/updatePayoutPercentage
+     */
+    updatePayoutPercentage = (input) => {
+        const { client } = this;
+        const path = `${this.basePath}/payout_settings/update_percentage`;
+        return Effect.gen(function* () {
+            const validInput = yield* requireObjectEffect(input, 'input');
+            const payoutSplit = yield* requireObjectEffect(validInput.payoutSplit, 'payoutSplit');
+            return yield* requestPostEffect(client, path, payoutSplit);
+        });
+    };
+    /**
+     * Creates calculated combined-shipping rules (and optional handling rule or
+     * combined payment window) for one marketplace.
+     *
+     * @param input - Marketplace header and the CreateCalculatedShippingRulesRequest body.
+     * @returns An Effect that succeeds when eBay returns 204 No Content.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountV2Api.createCalculatedShippingRules({
+     *     marketplaceId: MarketplaceId.EBAY_US,
+     *     shippingRules: { combinedDuration: 'DAYS_7' },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/combined_shipping_rules/methods/createCalculatedShippingRules
+     */
+    createCalculatedShippingRules = (input) => this.postCombinedShippingRules('create_calculated_shipping_rules', input, 'shippingRules');
+    /**
+     * Creates flat-rate combined-shipping rules for one marketplace.
+     *
+     * @param input - Marketplace header and the CreateFlatShippingRulesRequest body.
+     * @returns An Effect that succeeds when eBay returns 204 No Content.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountV2Api.createFlatShippingRules({
+     *     marketplaceId: MarketplaceId.EBAY_US,
+     *     shippingRules: { flatShippingRule: { combinedShippingRuleType: 'EACH_ADDITIONAL_AMOUNT' } },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/combined_shipping_rules/methods/createFlatShippingRules
+     */
+    createFlatShippingRules = (input) => this.postCombinedShippingRules('create_flat_shipping_rules', input, 'shippingRules');
+    /**
+     * Creates the promotional combined-shipping rule (discount or free shipping
+     * above an order amount or item count) for one marketplace.
+     *
+     * @param input - Marketplace header and the CreatePromotionalShippingRuleRequest body.
+     * @returns An Effect that succeeds when eBay returns 204 No Content.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountV2Api.createPromotionalShippingRule({
+     *     marketplaceId: MarketplaceId.EBAY_US,
+     *     shippingRules: { promotionalShippingRule: { itemCount: 3 } },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/combined_shipping_rules/methods/createPromotionalShippingRule
+     */
+    createPromotionalShippingRule = (input) => this.postCombinedShippingRules('create_promotional_shipping_rule', input, 'shippingRules');
+    /**
+     * Retrieves the seller's calculated, flat, and promotional combined-shipping
+     * rules and combined payment window for one marketplace.
+     *
+     * @param input - Marketplace sent as the X-EBAY-C-MARKETPLACE-ID header.
+     * @returns An Effect that succeeds with eBay's GetCombinedShippingRulesPublicApiResponse.
+     *
+     * @example
+     * ```ts
+     * const rules = await Effect.runPromise(
+     *   accountV2Api.getCombinedShippingRules({ marketplaceId: MarketplaceId.EBAY_US }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/combined_shipping_rules/methods/getCombinedShippingRules
+     */
+    getCombinedShippingRules = (input) => {
+        const { client } = this;
+        const path = `${this.basePath}/combined_shipping_rules`;
+        return Effect.gen(function* () {
+            const validInput = yield* requireObjectEffect(input, 'input');
+            const marketplaceId = yield* requireStringEffect(validInput.marketplaceId, 'marketplaceId');
+            return yield* requestGetEffect(client, path, undefined, marketplaceHeader(marketplaceId));
+        });
+    };
+    /**
+     * Updates existing calculated combined-shipping rules for one marketplace.
+     *
+     * @param input - Marketplace header and the UpdateCalculatedShippingRulesRequest body.
+     * @returns An Effect that succeeds when eBay returns 204 No Content.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountV2Api.updateCalculatedShippingRules({
+     *     marketplaceId: MarketplaceId.EBAY_US,
+     *     shippingRules: { combinedDuration: 'DAYS_14' },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/combined_shipping_rules/methods/updateCalculatedShippingRules
+     */
+    updateCalculatedShippingRules = (input) => this.postCombinedShippingRules('update_calculated_shipping_rules', input, 'shippingRules');
+    /**
+     * Changes the combined payment window for unpaid orders on one marketplace.
+     *
+     * @param input - Marketplace header and the UpdateCombinedPaymentsRequest body.
+     * @returns An Effect that succeeds when eBay returns 204 No Content.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountV2Api.updateCombinedPayments({
+     *     marketplaceId: MarketplaceId.EBAY_US,
+     *     combinedPayments: { combinedDuration: 'DAYS_30' },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/combined_shipping_rules/methods/updateCombinedPayments
+     */
+    updateCombinedPayments = (input) => this.postCombinedShippingRules('update_combined_payments', input, 'combinedPayments');
+    /**
+     * Updates existing flat-rate combined-shipping rules for one marketplace.
+     *
+     * @param input - Marketplace header and the UpdateFlatShippingRulesRequest body.
+     * @returns An Effect that succeeds when eBay returns 204 No Content.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountV2Api.updateFlatShippingRules({
+     *     marketplaceId: MarketplaceId.EBAY_US,
+     *     shippingRules: { combinedDuration: 'DAYS_5' },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/combined_shipping_rules/methods/updateFlatShippingRules
+     */
+    updateFlatShippingRules = (input) => this.postCombinedShippingRules('update_flat_shipping_rules', input, 'shippingRules');
+    /**
+     * Updates the existing promotional combined-shipping rule for one marketplace.
+     *
+     * @param input - Marketplace header and the UpdatePromotionalShippingRuleRequest body.
+     * @returns An Effect that succeeds when eBay returns 204 No Content.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountV2Api.updatePromotionalShippingRule({
+     *     marketplaceId: MarketplaceId.EBAY_US,
+     *     shippingRules: { promotionalShippingRule: { orderAmount: { currency: 'USD', value: '50.00' } } },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/combined_shipping_rules/methods/updatePromotionalShippingRule
+     */
+    updatePromotionalShippingRule = (input) => this.postCombinedShippingRules('update_promotional_shipping_rule', input, 'shippingRules');
+    /**
+     * Retrieves the seller's preferences for one marketplace, optionally limited to
+     * specific field groups.
+     *
+     * @param input - Marketplace header and optional comma-separated `fieldgroups`.
+     * @returns An Effect that succeeds with eBay's generated GetUserPreferencesResponse.
+     *
+     * @example
+     * ```ts
+     * const preferences = await Effect.runPromise(
+     *   accountV2Api.getUserPreferences({
+     *     marketplaceId: MarketplaceId.EBAY_US,
+     *     fieldgroups: 'COMBINED_PAYMENT,DISPATCH_CUTOFF_TIME',
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/user_preferences/methods/getUserPreferences
+     */
+    getUserPreferences = (input) => {
+        const { client } = this;
+        const path = `${this.basePath}/user_preferences`;
+        return Effect.gen(function* () {
+            const validInput = yield* requireObjectEffect(input, 'input');
+            const marketplaceId = yield* requireStringEffect(validInput.marketplaceId, 'marketplaceId');
+            const fieldgroups = yield* optionalStringEffect(validInput.fieldgroups, 'fieldgroups');
+            const params = buildEndpointParams({
+                fieldgroups: { wireName: 'fieldgroups', value: fieldgroups },
+            });
+            return yield* requestGetEffect(client, path, params, marketplaceHeader(marketplaceId));
+        });
+    };
+    /**
+     * Changes one or more seller preferences for one marketplace (PATCH: send only
+     * the preferences being changed).
+     *
+     * eBay's OAS3 spec references an undefined `SetUserPreferencesRequest`, so the
+     * generated body type is `unknown`. The body is typed from the tool schema,
+     * which mirrors the definition in eBay's published Account v2 spec: the
+     * `*PreferencesType` containers returned by getUserPreferences, with
+     * SetItemsAwaitingPaymentPreferencesType for unpaid-item settings.
+     *
+     * @param input - Marketplace header and the preferences PATCH body.
+     * @returns An Effect that succeeds when eBay returns 204 No Content.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   accountV2Api.setUserPreferences({
+     *     marketplaceId: MarketplaceId.EBAY_US,
+     *     preferences: { outOfStockControlPreference: true },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/account/v2/resources/user_preferences/methods/setUserPreferences
+     */
+    setUserPreferences = (input) => {
+        const { client } = this;
+        const path = `${this.basePath}/user_preferences`;
+        return Effect.gen(function* () {
+            const validInput = yield* requireObjectEffect(input, 'input');
+            const marketplaceId = yield* requireStringEffect(validInput.marketplaceId, 'marketplaceId');
+            const preferences = yield* requireObjectEffect(validInput.preferences, 'preferences');
+            return yield* requestPatchEffect(client, path, preferences, marketplaceHeader(marketplaceId));
+        });
+    };
+    /**
+     * Validates the marketplace header and body field, then POSTs one
+     * combined-shipping-rules request that eBay answers with 204 No Content.
+     */
+    postCombinedShippingRules = (operation, input, bodyField) => {
+        const { client } = this;
+        const path = `${this.basePath}/combined_shipping_rules/${operation}`;
+        return Effect.gen(function* () {
+            const validInput = yield* requireObjectEffect(input, 'input');
+            const marketplaceId = yield* requireStringEffect(validInput.marketplaceId, 'marketplaceId');
+            const rules = yield* requireObjectEffect(validInput[bodyField], bodyField);
+            return yield* requestPostEffect(client, path, rules, marketplaceHeader(marketplaceId));
+        });
+    };
+}

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

@@ -0,0 +1,289 @@
+import { buildEndpointParams, decodeEndpointInputEffect, EbayApiError, requestGetEffect, } from '../../api/shared/request.js';
+import { getIdentityBaseUrl } from '../../config/environment.js';
+import { getBillingActivitiesInputSchema, getOrderEarningsByIdInputSchema, getOrderEarningsInputSchema, getOrderEarningsSummaryInputSchema, getPayoutInputSchema, getPayoutSummaryInputSchema, getPayoutsInputSchema, getSellerFundsSummaryInputSchema, getTransactionSummaryInputSchema, getTransactionsInputSchema, getTransferInputSchema, } from '../../schemas/account-management/finances.js';
+import { Effect } from 'effect';
+const BASE_PATH = '/sell/finances/v1';
+/** Maps the shared filter/limit/offset/sort fields to their eBay query names. */
+const pageQuery = (input) => buildEndpointParams({
+    filter: { wireName: 'filter', value: input.filter },
+    limit: { wireName: 'limit', value: input.limit },
+    offset: { wireName: 'offset', value: input.offset },
+    sort: { wireName: 'sort', value: input.sort },
+});
+/** Maps the single filter field accepted by the Finances summary endpoints. */
+const filterQuery = (filter) => buildEndpointParams({ filter: { wireName: 'filter', value: filter } });
+/**
+ * Finances API - payouts, transactions, transfers, seller funds, billing activity, and order
+ * earnings. Every operation except getBillingActivities is served from the apiz host.
+ */
+export class FinancesApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Sends a GET to the apiz host (or EBAY_MCP_API_BASE_URL) with an optional marketplace
+     * header, keeping the relative eBay path in the typed error.
+     */
+    getFromApiz = (path, params, marketplaceId) => {
+        const client = this.client;
+        const config = marketplaceId === undefined
+            ? { absolute: true }
+            : { absolute: true, headers: { 'X-EBAY-C-MARKETPLACE-ID': marketplaceId } };
+        return Effect.tryPromise({
+            try: () => {
+                const { environment, apiBaseUrl } = client.getConfig();
+                const url = `${getIdentityBaseUrl(environment, apiBaseUrl)}${path}`;
+                return client.get(url, params, config);
+            },
+            catch: (cause) => new EbayApiError({ method: 'GET', path, cause }), // allow-duplicate
+        });
+    };
+    /**
+     * Retrieves order-level earnings (gross amount, expenses, refunds, net earnings) for the
+     * seller's orders. Requires the optional sell.finances.earnings.read scope.
+     *
+     * @param input - Optional orderCreationDate filter, pagination, sort, and marketplace override.
+     * @returns An Effect that succeeds with eBay's OrderEarnings page.
+     *
+     * @example
+     * ```ts
+     * const earnings = await Effect.runPromise(
+     *   financesApi.getOrderEarnings({
+     *     filter: 'orderCreationDate:[2024-10-23T00:00:01.000Z..2024-11-09T00:00:01.000Z]',
+     *     limit: 50,
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/finances/resources/order_earnings/methods/getOrderEarnings
+     */
+    getOrderEarnings = (input = {}) => {
+        const getFromApiz = this.getFromApiz;
+        return Effect.gen(function* () {
+            const validatedInput = yield* decodeEndpointInputEffect(getOrderEarningsInputSchema, input);
+            return yield* getFromApiz(`${BASE_PATH}/order_earnings`, pageQuery(validatedInput), validatedInput.marketplaceId);
+        });
+    };
+    /**
+     * Retrieves earnings for one order. Requires the optional sell.finances.earnings.read scope.
+     *
+     * @param input - eBay order ID plus optional marketplace override.
+     * @returns An Effect that succeeds with eBay's OrderEarning.
+     *
+     * @example
+     * ```ts
+     * const earning = await Effect.runPromise(
+     *   financesApi.getOrderEarningsById({ orderId: '12-12345-12345' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/finances/resources/order_earnings/methods/getOrderEarningsById
+     */
+    getOrderEarningsById = (input) => {
+        const getFromApiz = this.getFromApiz;
+        return Effect.gen(function* () {
+            const { orderId, marketplaceId } = yield* decodeEndpointInputEffect(getOrderEarningsByIdInputSchema, input);
+            return yield* getFromApiz(`${BASE_PATH}/order_earnings/${encodeURIComponent(orderId)}`, undefined, marketplaceId);
+        });
+    };
+    /**
+     * Retrieves aggregated order earnings for orders created in a date range. Requires the
+     * optional sell.finances.earnings.read scope.
+     *
+     * @param input - Optional orderCreationDate filter and marketplace override.
+     * @returns An Effect that succeeds with eBay's OrderEarningsSummary.
+     *
+     * @example
+     * ```ts
+     * const summary = await Effect.runPromise(financesApi.getOrderEarningsSummary({}));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/finances/resources/order_earnings/methods/getOrderEarningsSummary
+     */
+    getOrderEarningsSummary = (input = {}) => {
+        const getFromApiz = this.getFromApiz;
+        return Effect.gen(function* () {
+            const { filter, marketplaceId } = yield* decodeEndpointInputEffect(getOrderEarningsSummaryInputSchema, input);
+            return yield* getFromApiz(`${BASE_PATH}/order_earnings_summary`, filterQuery(filter), marketplaceId);
+        });
+    };
+    /**
+     * Retrieves one seller payout by ID.
+     *
+     * @param input - Payout ID (not a split-payout payoutReference) plus optional marketplace override.
+     * @returns An Effect that succeeds with eBay's Payout.
+     *
+     * @example
+     * ```ts
+     * const payout = await Effect.runPromise(financesApi.getPayout({ payoutId: '5000000001' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/finances/resources/payout/methods/getPayout
+     */
+    getPayout = (input) => {
+        const getFromApiz = this.getFromApiz;
+        return Effect.gen(function* () {
+            const { payoutId, marketplaceId } = yield* decodeEndpointInputEffect(getPayoutInputSchema, input);
+            return yield* getFromApiz(`${BASE_PATH}/payout/${encodeURIComponent(payoutId)}`, undefined, marketplaceId);
+        });
+    };
+    /**
+     * Retrieves seller payouts with optional date/status filtering, pagination, and sorting.
+     *
+     * @param input - Optional payout filter, pagination, sort, and marketplace override.
+     * @returns An Effect that succeeds with eBay's Payouts page, or undefined on HTTP 204.
+     *
+     * @example
+     * ```ts
+     * const payouts = await Effect.runPromise(
+     *   financesApi.getPayouts({ filter: 'payoutStatus:{SUCCEEDED}', limit: 20 }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/finances/resources/payout/methods/getPayouts
+     */
+    getPayouts = (input = {}) => {
+        const getFromApiz = this.getFromApiz;
+        return Effect.gen(function* () {
+            const validatedInput = yield* decodeEndpointInputEffect(getPayoutsInputSchema, input);
+            return yield* getFromApiz(`${BASE_PATH}/payout`, pageQuery(validatedInput), validatedInput.marketplaceId);
+        });
+    };
+    /**
+     * Retrieves cumulative payout counts and amounts, optionally filtered by date and status.
+     *
+     * @param input - Optional payoutDate/payoutStatus filter and marketplace override.
+     * @returns An Effect that succeeds with eBay's PayoutSummaryResponse.
+     *
+     * @example
+     * ```ts
+     * const summary = await Effect.runPromise(
+     *   financesApi.getPayoutSummary({ filter: 'payoutStatus:{SUCCEEDED}' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/finances/resources/payout/methods/getPayoutSummary
+     */
+    getPayoutSummary = (input = {}) => {
+        const getFromApiz = this.getFromApiz;
+        return Effect.gen(function* () {
+            const { filter, marketplaceId } = yield* decodeEndpointInputEffect(getPayoutSummaryInputSchema, input);
+            return yield* getFromApiz(`${BASE_PATH}/payout_summary`, filterQuery(filter), marketplaceId);
+        });
+    };
+    /**
+     * Retrieves funds not yet paid out: available, processing, and on-hold amounts.
+     *
+     * @param input - Optional marketplace override.
+     * @returns An Effect that succeeds with eBay's SellerFundsSummaryResponse, or undefined on
+     * HTTP 204 when no funds are pending.
+     *
+     * @example
+     * ```ts
+     * const funds = await Effect.runPromise(financesApi.getSellerFundsSummary({}));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/finances/resources/seller_funds_summary/methods/getSellerFundsSummary
+     */
+    getSellerFundsSummary = (input = {}) => {
+        const getFromApiz = this.getFromApiz;
+        return Effect.gen(function* () {
+            const { marketplaceId } = yield* decodeEndpointInputEffect(getSellerFundsSummaryInputSchema, input);
+            return yield* getFromApiz(`${BASE_PATH}/seller_funds_summary`, undefined, marketplaceId);
+        });
+    };
+    /**
+     * Retrieves monetary transactions (sales, refunds, credits, fees, transfers, and more).
+     *
+     * @param input - Optional transaction filter, pagination, sort, and marketplace override.
+     * @returns An Effect that succeeds with eBay's Transactions page, or undefined on HTTP 204.
+     *
+     * @example
+     * ```ts
+     * const sales = await Effect.runPromise(
+     *   financesApi.getTransactions({ filter: 'transactionType:{SALE}', limit: 100 }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/finances/resources/transaction/methods/getTransactions
+     */
+    getTransactions = (input = {}) => {
+        const getFromApiz = this.getFromApiz;
+        return Effect.gen(function* () {
+            const validatedInput = yield* decodeEndpointInputEffect(getTransactionsInputSchema, input);
+            return yield* getFromApiz(`${BASE_PATH}/transaction`, pageQuery(validatedInput), validatedInput.marketplaceId);
+        });
+    };
+    /**
+     * Retrieves cumulative counts and amounts for monetary transactions, including on-hold funds.
+     *
+     * @param input - Transaction filter (eBay requires a transactionStatus criterion) and optional
+     * marketplace override.
+     * @returns An Effect that succeeds with eBay's TransactionSummaryResponse.
+     *
+     * @example
+     * ```ts
+     * const summary = await Effect.runPromise(
+     *   financesApi.getTransactionSummary({ filter: 'transactionStatus:{PAYOUT}' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/finances/resources/transaction/methods/getTransactionSummary
+     */
+    getTransactionSummary = (input) => {
+        const getFromApiz = this.getFromApiz;
+        return Effect.gen(function* () {
+            const { filter, marketplaceId } = yield* decodeEndpointInputEffect(getTransactionSummaryInputSchema, input);
+            return yield* getFromApiz(`${BASE_PATH}/transaction_summary`, filterQuery(filter), marketplaceId);
+        });
+    };
+    /**
+     * Retrieves one TRANSFER transaction (a seller reimbursing eBay for charges such as refunds).
+     *
+     * @param input - TRANSFER transaction ID plus optional marketplace override.
+     * @returns An Effect that succeeds with eBay's Transfer.
+     *
+     * @example
+     * ```ts
+     * const transfer = await Effect.runPromise(
+     *   financesApi.getTransfer({ transferId: '0-00000-00000' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/finances/resources/transfer/methods/getTransfer
+     */
+    getTransfer = (input) => {
+        const getFromApiz = this.getFromApiz;
+        return Effect.gen(function* () {
+            const { transferId, marketplaceId } = yield* decodeEndpointInputEffect(getTransferInputSchema, input);
+            return yield* getFromApiz(`${BASE_PATH}/transfer/${encodeURIComponent(transferId)}`, undefined, marketplaceId);
+        });
+    };
+    /**
+     * Retrieves the seller's billing activities (fees and credits) for one activity, listing,
+     * order, or date range. Unlike the rest of the Finances API this is served from the api host.
+     *
+     * @param input - Billing filter, pagination, sort, and optional Accept-Language override.
+     * @returns An Effect that succeeds with eBay's BillingActivityResponse.
+     *
+     * @example
+     * ```ts
+     * const activities = await Effect.runPromise(
+     *   financesApi.getBillingActivities({ filter: 'orderId:{12-12345-12345}' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/finances/resources/billing_activity/methods/getBillingActivities
+     */
+    getBillingActivities = (input) => {
+        const client = this.client;
+        return Effect.gen(function* () {
+            const validatedInput = yield* decodeEndpointInputEffect(getBillingActivitiesInputSchema, input);
+            const config = validatedInput.acceptLanguage === undefined
+                ? undefined
+                : { headers: { 'Accept-Language': validatedInput.acceptLanguage } };
+            return yield* requestGetEffect(client, `${BASE_PATH}/billing_activity`, pageQuery(validatedInput), config);
+        });
+    };
+}

package/build/api/analytics-and-report/analytics.js

@@ -2,7 +2,7 @@ import { buildEndpointParams, optionalStringEffect, requestGetEffect, requireObj
 import { Effect } from 'effect';
 /**
  * Analytics API - Sales and traffic analytics
- * Based on: docs/sell-apps/analytics-and-report/sell_analytics_v1_oas3.json
+ * Based on: sell_analytics_v1_oas3.json
  */
 export class AnalyticsApi {
     basePath = '/sell/analytics/v1';