ebay-mcp 1.13.2 → 1.14.0

package/build/api/communication/notification.js

@@ -1,216 +1,510 @@
-import { buildContinuationParams, deleteWithApiError, getWithApiError, postWithApiError, putWithApiError, requireObject, requireString, } from '../shared/request.js';
+import { buildEndpointParams, optionalPositiveNumberEffect, optionalStringEffect, requestDeleteEffect, requestGetEffect, requestPostEffect, requestPutEffect, requireObjectEffect, requireStringEffect, } from '../../api/shared/request.js';
+import { Effect } from 'effect';
 /**
  * Notification API - Event notifications and subscriptions
  * Based on: docs/sell-apps/communication/commerce_notification_v1_oas3.json
  */
 export class NotificationApi {
-    client;
     basePath = '/commerce/notification/v1';
+    client;
     constructor(client) {
         this.client = client;
     }
-    path(endpoint) {
-        return `${this.basePath}${endpoint}`;
-    }
-    async get(endpoint, failureMessage, params) {
-        return await getWithApiError(this.client, this.path(endpoint), failureMessage, params);
-    }
-    async post(endpoint, failureMessage, body) {
-        return await postWithApiError(this.client, this.path(endpoint), failureMessage, body);
-    }
-    async put(endpoint, failureMessage, body) {
-        return await putWithApiError(this.client, this.path(endpoint), failureMessage, body);
-    }
-    async delete(endpoint, failureMessage) {
-        return await deleteWithApiError(this.client, this.path(endpoint), failureMessage);
-    }
-    async getContinuation(endpoint, failureMessage, limit, continuationToken) {
-        return await this.get(endpoint, failureMessage, buildContinuationParams(limit, continuationToken));
-    }
     /**
-     * Get public key for validating notifications
-     * @param publicKeyId Public key identifier.
-     * @throws Error if required parameters are missing or invalid
+     * Retrieves a public key used to validate notification signatures.
+     *
+     * @param input - Public key identifier from the notification signature header.
+     * @returns An Effect that succeeds with eBay's generated PublicKey response.
+     *
+     * @example
+     * ```ts
+     * const key = await Effect.runPromise(notificationApi.getPublicKey({ publicKeyId: 'key-123' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/public_key/methods/getPublicKey
      */
-    async getPublicKey(publicKeyId) {
-        requireString(publicKeyId, 'publicKeyId');
-        return await this.get(`/public_key/${publicKeyId}`, 'Failed to get public key');
-    }
+    getPublicKey = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const validatedPublicKeyId = yield* requireStringEffect(request.publicKeyId, 'publicKeyId');
+            return yield* requestGetEffect(apiClient, `${apiBasePath}/public_key/${validatedPublicKeyId}`);
+        });
+    };
     /**
-     * Get notification config
-     * @throws Error if the request fails
+     * Retrieves the Notification API alert configuration.
+     *
+     * @param input - Empty endpoint input object.
+     * @returns An Effect that succeeds with eBay's generated Config response.
+     *
+     * @example
+     * ```ts
+     * const config = await Effect.runPromise(notificationApi.getConfig({}));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/config/methods/getConfig
      */
-    async getConfig() {
-        return await this.get('/config', 'Failed to get config');
-    }
+    getConfig = (input = {}) => {
+        void input;
+        return requestGetEffect(this.client, `${this.basePath}/config`);
+    };
     /**
-     * Update notification config
-     * @throws Error if required parameters are missing or invalid
+     * Updates the Notification API alert configuration.
+     *
+     * @param input - Notification alert configuration body.
+     * @returns An Effect that succeeds when eBay accepts the update.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(notificationApi.updateConfig({ alertEmail: 'ops@example.com' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/config/methods/updateConfig
      */
-    async updateConfig(config) {
-        requireObject(config, 'config');
-        return await this.put('/config', 'Failed to update config', config);
-    }
+    updateConfig = (input) => {
+        const apiClient = this.client;
+        const path = `${this.basePath}/config`;
+        return Effect.gen(function* () {
+            const body = yield* requireObjectEffect(input, 'input');
+            return yield* requestPutEffect(apiClient, path, body);
+        });
+    };
     /**
-     * Get all destinations (paginated)
-     * @throws Error if the request fails
+     * Retrieves configured notification destinations.
+     *
+     * @param input - Optional page size and continuation token.
+     * @returns An Effect that succeeds with eBay's generated DestinationSearchResponse.
+     *
+     * @example
+     * ```ts
+     * const destinations = await Effect.runPromise(notificationApi.getDestinations({ limit: 20 }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/destination/methods/getDestinations
      */
-    async getDestinations(limit, continuationToken) {
-        return await this.getContinuation('/destination', 'Failed to get destinations', limit, continuationToken);
-    }
+    getDestinations = (input = {}) => {
+        const apiClient = this.client;
+        const path = `${this.basePath}/destination`;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const limit = yield* optionalPositiveNumberEffect(request.limit, 'limit');
+            const continuationToken = yield* optionalStringEffect(request.continuationToken, 'continuationToken');
+            const params = buildEndpointParams({
+                limit: { wireName: 'limit', value: limit },
+                continuationToken: { wireName: 'continuation_token', value: continuationToken },
+            });
+            return yield* requestGetEffect(apiClient, path, params);
+        });
+    };
     /**
-     * Get destination
-     * @param destinationId Destination identifier.
-     * @throws Error if required parameters are missing or invalid
+     * Retrieves one notification destination.
+     *
+     * @param input - Destination identifier.
+     * @returns An Effect that succeeds with eBay's generated Destination response.
+     *
+     * @example
+     * ```ts
+     * const destination = await Effect.runPromise(
+     *   notificationApi.getDestination({ destinationId: 'dest-1' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/destination/methods/getDestination
      */
-    async getDestination(destinationId) {
-        requireString(destinationId, 'destinationId');
-        return await this.get(`/destination/${destinationId}`, 'Failed to get destination');
-    }
+    getDestination = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const validatedDestinationId = yield* requireStringEffect(request.destinationId, 'destinationId');
+            return yield* requestGetEffect(apiClient, `${apiBasePath}/destination/${validatedDestinationId}`);
+        });
+    };
     /**
-     * Create destination
-     * @throws Error if required parameters are missing or invalid
+     * Creates a notification destination.
+     *
+     * @param input - Destination request body.
+     * @returns An Effect that succeeds when eBay accepts the destination.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(notificationApi.createDestination({ name: 'webhook' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/destination/methods/createDestination
      */
-    async createDestination(destination) {
-        requireObject(destination, 'destination');
-        return await this.post('/destination', 'Failed to create destination', destination);
-    }
+    createDestination = (input) => {
+        const apiClient = this.client;
+        const path = `${this.basePath}/destination`;
+        return Effect.gen(function* () {
+            const body = yield* requireObjectEffect(input, 'input');
+            return yield* requestPostEffect(apiClient, path, body);
+        });
+    };
     /**
-     * Update destination
-     * @throws Error if required parameters are missing or invalid
+     * Updates a notification destination.
+     *
+     * @param input - Destination identifier plus destination update body fields.
+     * @returns An Effect that succeeds when eBay accepts the update.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   notificationApi.updateDestination({ destinationId: 'dest-1', name: 'webhook' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/destination/methods/updateDestination
      */
-    async updateDestination(destinationId, destination) {
-        requireString(destinationId, 'destinationId');
-        requireObject(destination, 'destination');
-        return await this.put(`/destination/${destinationId}`, 'Failed to update destination', destination);
-    }
+    updateDestination = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const { destinationId, ...destination } = request;
+            const validatedDestinationId = yield* requireStringEffect(destinationId, 'destinationId');
+            const body = yield* requireObjectEffect(destination, 'destination');
+            return yield* requestPutEffect(apiClient, `${apiBasePath}/destination/${validatedDestinationId}`, body);
+        });
+    };
     /**
-     * Delete destination
-     * @throws Error if required parameters are missing or invalid
+     * Deletes a notification destination.
+     *
+     * @param input - Destination identifier.
+     * @returns An Effect that succeeds when eBay deletes the destination.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(notificationApi.deleteDestination({ destinationId: 'dest-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/destination/methods/deleteDestination
      */
-    async deleteDestination(destinationId) {
-        requireString(destinationId, 'destinationId');
-        return await this.delete(`/destination/${destinationId}`, 'Failed to delete destination');
-    }
+    deleteDestination = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const validatedDestinationId = yield* requireStringEffect(request.destinationId, 'destinationId');
+            return yield* requestDeleteEffect(apiClient, `${apiBasePath}/destination/${validatedDestinationId}`);
+        });
+    };
     /**
-     * Get all subscriptions
-     * Endpoint: GET /subscription
-     * @throws Error if the request fails
+     * Retrieves configured notification subscriptions.
+     *
+     * @param input - Optional page size and continuation token.
+     * @returns An Effect that succeeds with eBay's generated SubscriptionSearchResponse.
+     *
+     * @example
+     * ```ts
+     * const subscriptions = await Effect.runPromise(notificationApi.getSubscriptions({ limit: 20 }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/subscription/methods/getSubscriptions
      */
-    async getSubscriptions(limit, continuationToken) {
-        return await this.getContinuation('/subscription', 'Failed to get subscriptions', limit, continuationToken);
-    }
+    getSubscriptions = (input = {}) => {
+        const apiClient = this.client;
+        const path = `${this.basePath}/subscription`;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const limit = yield* optionalPositiveNumberEffect(request.limit, 'limit');
+            const continuationToken = yield* optionalStringEffect(request.continuationToken, 'continuationToken');
+            const params = buildEndpointParams({
+                limit: { wireName: 'limit', value: limit },
+                continuationToken: { wireName: 'continuation_token', value: continuationToken },
+            });
+            return yield* requestGetEffect(apiClient, path, params);
+        });
+    };
     /**
-     * Create a subscription
-     * Endpoint: POST /subscription
-     * @throws Error if required parameters are missing or invalid
+     * Creates a notification subscription.
+     *
+     * @param input - Subscription creation request body.
+     * @returns An Effect that succeeds when eBay accepts the subscription.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(notificationApi.createSubscription({ topicId: 'MARKETPLACE' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/subscription/methods/createSubscription
      */
-    async createSubscription(subscription) {
-        requireObject(subscription, 'subscription');
-        return await this.post('/subscription', 'Failed to create subscription', subscription);
-    }
+    createSubscription = (input) => {
+        const apiClient = this.client;
+        const path = `${this.basePath}/subscription`;
+        return Effect.gen(function* () {
+            const body = yield* requireObjectEffect(input, 'input');
+            return yield* requestPostEffect(apiClient, path, body);
+        });
+    };
     /**
-     * Get a subscription
-     * Endpoint: GET /subscription/{subscription_id}
-     * @param subscriptionId Subscription identifier.
-     * @throws Error if required parameters are missing or invalid
+     * Retrieves one notification subscription.
+     *
+     * @param input - Subscription identifier.
+     * @returns An Effect that succeeds with eBay's generated Subscription response.
+     *
+     * @example
+     * ```ts
+     * const subscription = await Effect.runPromise(
+     *   notificationApi.getSubscription({ subscriptionId: 'sub-1' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/subscription/methods/getSubscription
      */
-    async getSubscription(subscriptionId) {
-        requireString(subscriptionId, 'subscriptionId');
-        return await this.get(`/subscription/${subscriptionId}`, 'Failed to get subscription');
-    }
+    getSubscription = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const validatedSubscriptionId = yield* requireStringEffect(request.subscriptionId, 'subscriptionId');
+            return yield* requestGetEffect(apiClient, `${apiBasePath}/subscription/${validatedSubscriptionId}`);
+        });
+    };
     /**
-     * Update a subscription
-     * Endpoint: PUT /subscription/{subscription_id}
-     * @throws Error if required parameters are missing or invalid
+     * Updates a notification subscription.
+     *
+     * @param input - Subscription identifier plus subscription update body fields.
+     * @returns An Effect that succeeds when eBay accepts the update.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   notificationApi.updateSubscription({ subscriptionId: 'sub-1', status: 'DISABLED' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/subscription/methods/updateSubscription
      */
-    async updateSubscription(subscriptionId, subscription) {
-        requireString(subscriptionId, 'subscriptionId');
-        requireObject(subscription, 'subscription');
-        return await this.put(`/subscription/${subscriptionId}`, 'Failed to update subscription', subscription);
-    }
+    updateSubscription = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const { subscriptionId, ...subscription } = request;
+            const validatedSubscriptionId = yield* requireStringEffect(subscriptionId, 'subscriptionId');
+            const body = yield* requireObjectEffect(subscription, 'subscription');
+            return yield* requestPutEffect(apiClient, `${apiBasePath}/subscription/${validatedSubscriptionId}`, body);
+        });
+    };
     /**
-     * Delete a subscription
-     * Endpoint: DELETE /subscription/{subscription_id}
-     * @throws Error if required parameters are missing or invalid
+     * Deletes a notification subscription.
+     *
+     * @param input - Subscription identifier.
+     * @returns An Effect that succeeds when eBay deletes the subscription.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(notificationApi.deleteSubscription({ subscriptionId: 'sub-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/subscription/methods/deleteSubscription
      */
-    async deleteSubscription(subscriptionId) {
-        requireString(subscriptionId, 'subscriptionId');
-        return await this.delete(`/subscription/${subscriptionId}`, 'Failed to delete subscription');
-    }
+    deleteSubscription = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const validatedSubscriptionId = yield* requireStringEffect(request.subscriptionId, 'subscriptionId');
+            return yield* requestDeleteEffect(apiClient, `${apiBasePath}/subscription/${validatedSubscriptionId}`);
+        });
+    };
     /**
-     * Disable a subscription
-     * Endpoint: POST /subscription/{subscription_id}/disable
-     * @throws Error if required parameters are missing or invalid
+     * Disables an active notification subscription.
+     *
+     * @param input - Subscription identifier.
+     * @returns An Effect that succeeds when eBay disables the subscription.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(notificationApi.disableSubscription({ subscriptionId: 'sub-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/subscription/methods/disableSubscription
      */
-    async disableSubscription(subscriptionId) {
-        requireString(subscriptionId, 'subscriptionId');
-        return await this.post(`/subscription/${subscriptionId}/disable`, 'Failed to disable subscription', {});
-    }
+    disableSubscription = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const validatedSubscriptionId = yield* requireStringEffect(request.subscriptionId, 'subscriptionId');
+            return yield* requestPostEffect(apiClient, `${apiBasePath}/subscription/${validatedSubscriptionId}/disable`);
+        });
+    };
     /**
-     * Enable a subscription
-     * Endpoint: POST /subscription/{subscription_id}/enable
-     * @throws Error if required parameters are missing or invalid
+     * Enables a disabled notification subscription.
+     *
+     * @param input - Subscription identifier.
+     * @returns An Effect that succeeds when eBay enables the subscription.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(notificationApi.enableSubscription({ subscriptionId: 'sub-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/subscription/methods/enableSubscription
      */
-    async enableSubscription(subscriptionId) {
-        requireString(subscriptionId, 'subscriptionId');
-        return await this.post(`/subscription/${subscriptionId}/enable`, 'Failed to enable subscription', {});
-    }
+    enableSubscription = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const validatedSubscriptionId = yield* requireStringEffect(request.subscriptionId, 'subscriptionId');
+            return yield* requestPostEffect(apiClient, `${apiBasePath}/subscription/${validatedSubscriptionId}/enable`);
+        });
+    };
     /**
-     * Test a subscription
-     * Endpoint: POST /subscription/{subscription_id}/test
-     * @throws Error if required parameters are missing or invalid
+     * Sends a test notification for a subscription.
+     *
+     * @param input - Subscription identifier.
+     * @returns An Effect that succeeds when eBay accepts the test notification.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(notificationApi.testSubscription({ subscriptionId: 'sub-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/subscription/methods/testSubscription
      */
-    async testSubscription(subscriptionId) {
-        requireString(subscriptionId, 'subscriptionId');
-        return await this.post(`/subscription/${subscriptionId}/test`, 'Failed to test subscription', {});
-    }
+    testSubscription = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const validatedSubscriptionId = yield* requireStringEffect(request.subscriptionId, 'subscriptionId');
+            return yield* requestPostEffect(apiClient, `${apiBasePath}/subscription/${validatedSubscriptionId}/test`);
+        });
+    };
     /**
-     * Get a topic
-     * Endpoint: GET /topic/{topic_id}
-     * @param topicId Topic identifier.
-     * @throws Error if required parameters are missing or invalid
+     * Retrieves one notification topic.
+     *
+     * @param input - Topic identifier.
+     * @returns An Effect that succeeds with eBay's generated Topic response.
+     *
+     * @example
+     * ```ts
+     * const topic = await Effect.runPromise(notificationApi.getTopic({ topicId: 'topic-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/topic/methods/getTopic
      */
-    async getTopic(topicId) {
-        requireString(topicId, 'topicId');
-        return await this.get(`/topic/${topicId}`, 'Failed to get topic');
-    }
+    getTopic = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const validatedTopicId = yield* requireStringEffect(request.topicId, 'topicId');
+            return yield* requestGetEffect(apiClient, `${apiBasePath}/topic/${validatedTopicId}`);
+        });
+    };
     /**
-     * Get all topics
-     * Endpoint: GET /topic
-     * @throws Error if the request fails
+     * Retrieves available notification topics.
+     *
+     * @param input - Optional page size and continuation token.
+     * @returns An Effect that succeeds with eBay's generated TopicSearchResponse.
+     *
+     * @example
+     * ```ts
+     * const topics = await Effect.runPromise(notificationApi.getTopics({ limit: 20 }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/topic/methods/getTopics
      */
-    async getTopics(limit, continuationToken) {
-        return await this.getContinuation('/topic', 'Failed to get topics', limit, continuationToken);
-    }
+    getTopics = (input = {}) => {
+        const apiClient = this.client;
+        const path = `${this.basePath}/topic`;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const limit = yield* optionalPositiveNumberEffect(request.limit, 'limit');
+            const continuationToken = yield* optionalStringEffect(request.continuationToken, 'continuationToken');
+            const params = buildEndpointParams({
+                limit: { wireName: 'limit', value: limit },
+                continuationToken: { wireName: 'continuation_token', value: continuationToken },
+            });
+            return yield* requestGetEffect(apiClient, path, params);
+        });
+    };
     /**
-     * Create a subscription filter
-     * Endpoint: POST /subscription/{subscription_id}/filter
-     * @throws Error if required parameters are missing or invalid
+     * Creates a filter for a notification subscription.
+     *
+     * @param input - Subscription identifier plus JSON Schema filter body accepted by eBay.
+     * @returns An Effect that succeeds with eBay's generated empty response body.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   notificationApi.createSubscriptionFilter({
+     *     subscriptionId: 'sub-1',
+     *     filterSchema: { type: 'object' },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/subscription/methods/createSubscriptionFilter
      */
-    async createSubscriptionFilter(subscriptionId, filter) {
-        requireString(subscriptionId, 'subscriptionId');
-        requireObject(filter, 'filter');
-        return await this.post(`/subscription/${subscriptionId}/filter`, 'Failed to create subscription filter', filter);
-    }
+    createSubscriptionFilter = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const { subscriptionId, ...filter } = request;
+            const validatedSubscriptionId = yield* requireStringEffect(subscriptionId, 'subscriptionId');
+            const body = yield* requireObjectEffect(filter, 'filter');
+            return yield* requestPostEffect(apiClient, `${apiBasePath}/subscription/${validatedSubscriptionId}/filter`, body);
+        });
+    };
     /**
-     * Get a subscription filter
-     * Endpoint: GET /subscription/{subscription_id}/filter/{filter_id}
-     * @throws Error if required parameters are missing or invalid
+     * Retrieves one subscription filter.
+     *
+     * @param input - Subscription identifier and subscription filter identifier.
+     * @returns An Effect that succeeds with eBay's generated SubscriptionFilter response.
+     *
+     * @example
+     * ```ts
+     * const filter = await Effect.runPromise(
+     *   notificationApi.getSubscriptionFilter({ subscriptionId: 'sub-1', filterId: 'filter-1' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/subscription/methods/getSubscriptionFilter
      */
-    async getSubscriptionFilter(subscriptionId, filterId) {
-        requireString(subscriptionId, 'subscriptionId');
-        requireString(filterId, 'filterId');
-        return await this.get(`/subscription/${subscriptionId}/filter/${filterId}`, 'Failed to get subscription filter');
-    }
+    getSubscriptionFilter = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const validatedSubscriptionId = yield* requireStringEffect(request.subscriptionId, 'subscriptionId');
+            const validatedFilterId = yield* requireStringEffect(request.filterId, 'filterId');
+            return yield* requestGetEffect(apiClient, `${apiBasePath}/subscription/${validatedSubscriptionId}/filter/${validatedFilterId}`);
+        });
+    };
     /**
-     * Delete a subscription filter
-     * Endpoint: DELETE /subscription/{subscription_id}/filter/{filter_id}
-     * @throws Error if required parameters are missing or invalid
+     * Deletes a subscription filter.
+     *
+     * @param input - Subscription identifier and subscription filter identifier.
+     * @returns An Effect that succeeds when eBay deletes the filter.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   notificationApi.deleteSubscriptionFilter({
+     *     subscriptionId: 'sub-1',
+     *     filterId: 'filter-1',
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/notification/resources/subscription/methods/deleteSubscriptionFilter
      */
-    async deleteSubscriptionFilter(subscriptionId, filterId) {
-        requireString(subscriptionId, 'subscriptionId');
-        requireString(filterId, 'filterId');
-        return await this.delete(`/subscription/${subscriptionId}/filter/${filterId}`, 'Failed to delete subscription filter');
-    }
+    deleteSubscriptionFilter = (input) => {
+        const apiClient = this.client;
+        const apiBasePath = this.basePath;
+        return Effect.gen(function* () {
+            const request = yield* requireObjectEffect(input, 'input');
+            const validatedSubscriptionId = yield* requireStringEffect(request.subscriptionId, 'subscriptionId');
+            const validatedFilterId = yield* requireStringEffect(request.filterId, 'filterId');
+            return yield* requestDeleteEffect(apiClient, `${apiBasePath}/subscription/${validatedSubscriptionId}/filter/${validatedFilterId}`);
+        });
+    };
 }