@profplum700/etsy-v3-api-client 2.4.1 → 2.4.3

package/dist/index.cjs

@@ -1435,6 +1435,24 @@ class EtsyClient {
     sleep(ms) {
         return new Promise(resolve => setTimeout(resolve, ms));
     }
+    buildFormBody(params) {
+        const body = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === null)
+                continue;
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    if (item === undefined || item === null)
+                        continue;
+                    body.append(key, String(item));
+                }
+            }
+            else {
+                body.append(key, String(value));
+            }
+        }
+        return body;
+    }
     getApiKey() {
         if (this.sharedSecret) {
             return `${this.keystring}:${this.sharedSecret}`;
@@ -1494,19 +1512,37 @@ class EtsyClient {
             searchParams.set('sort_order', params.sort_order);
         if (params.includes)
             searchParams.set('includes', params.includes.join(','));
+        if (params.legacy !== undefined) {
+            searchParams.set('legacy', params.legacy.toString());
+        }
         const response = await this.makeRequest(`/shops/${targetShopId}/listings?${searchParams.toString()}`);
         return response.results;
     }
-    async getListing(listingId, includes) {
-        const params = includes ? `?includes=${includes.join(',')}` : '';
-        return this.makeRequest(`/listings/${listingId}${params}`);
+    async getListing(listingId, params) {
+        const resolvedParams = Array.isArray(params)
+            ? { includes: params }
+            : params;
+        const searchParams = new URLSearchParams();
+        if (resolvedParams?.includes) {
+            searchParams.set('includes', resolvedParams.includes.join(','));
+        }
+        if (resolvedParams?.language) {
+            searchParams.set('language', resolvedParams.language);
+        }
+        if (resolvedParams?.legacy !== undefined) {
+            searchParams.set('legacy', resolvedParams.legacy.toString());
+        }
+        if (resolvedParams?.allow_suggested_title !== undefined) {
+            searchParams.set('allow_suggested_title', resolvedParams.allow_suggested_title.toString());
+        }
+        const query = searchParams.toString();
+        const suffix = query ? `?${query}` : '';
+        return this.makeRequest(`/listings/${listingId}${suffix}`);
     }
     async findAllListingsActive(params = {}) {
         const searchParams = new URLSearchParams();
         if (params.keywords)
             searchParams.set('keywords', params.keywords);
-        if (params.category)
-            searchParams.set('category', params.category);
         if (params.limit !== undefined)
             searchParams.set('limit', params.limit.toString());
         if (params.offset !== undefined)
@@ -1519,12 +1555,14 @@ class EtsyClient {
             searchParams.set('min_price', params.min_price.toString());
         if (params.max_price !== undefined)
             searchParams.set('max_price', params.max_price.toString());
-        if (params.tags)
-            searchParams.set('tags', params.tags.join(','));
-        if (params.location)
-            searchParams.set('location', params.location);
+        if (params.taxonomy_id !== undefined) {
+            searchParams.set('taxonomy_id', params.taxonomy_id.toString());
+        }
         if (params.shop_location)
             searchParams.set('shop_location', params.shop_location);
+        if (params.legacy !== undefined) {
+            searchParams.set('legacy', params.legacy.toString());
+        }
         const response = await this.makeRequest(`/listings/active?${searchParams.toString()}`);
         return response.results;
     }
@@ -1532,15 +1570,58 @@ class EtsyClient {
         const response = await this.makeRequest(`/listings/${listingId}/images`);
         return response.results;
     }
-    async getListingInventory(listingId) {
-        return this.makeRequest(`/listings/${listingId}/inventory`);
+    async getListingInventory(listingId, params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.show_deleted !== undefined) {
+            searchParams.set('show_deleted', params.show_deleted.toString());
+        }
+        if (params.includes) {
+            searchParams.set('includes', params.includes);
+        }
+        if (params.legacy !== undefined) {
+            searchParams.set('legacy', params.legacy.toString());
+        }
+        const query = searchParams.toString();
+        const suffix = query ? `?${query}` : '';
+        return this.makeRequest(`/listings/${listingId}/inventory${suffix}`);
+    }
+    async getReviewsByListing(listingId, params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.limit !== undefined)
+            searchParams.set('limit', params.limit.toString());
+        if (params.offset !== undefined)
+            searchParams.set('offset', params.offset.toString());
+        if (params.min_created !== undefined) {
+            searchParams.set('min_created', params.min_created.toString());
+        }
+        if (params.max_created !== undefined) {
+            searchParams.set('max_created', params.max_created.toString());
+        }
+        const response = await this.makeRequest(`/listings/${listingId}/reviews?${searchParams.toString()}`);
+        return response.results;
+    }
+    async getReviewsByShop(shopId, params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.limit !== undefined)
+            searchParams.set('limit', params.limit.toString());
+        if (params.offset !== undefined)
+            searchParams.set('offset', params.offset.toString());
+        if (params.min_created !== undefined) {
+            searchParams.set('min_created', params.min_created.toString());
+        }
+        if (params.max_created !== undefined) {
+            searchParams.set('max_created', params.max_created.toString());
+        }
+        const response = await this.makeRequest(`/shops/${shopId}/reviews?${searchParams.toString()}`);
+        return response.results;
     }
     async getSellerTaxonomyNodes() {
         const response = await this.makeRequest('/seller-taxonomy/nodes');
         return response.results;
     }
     async getUserShops() {
-        const response = await this.makeRequest('/users/me/shops');
+        const user = await this.getUser();
+        const response = await this.makeRequest(`/users/${user.user_id}/shops`);
         return response.results || [];
     }
     async updateShop(shopId, params, options) {
@@ -1557,21 +1638,27 @@ class EtsyClient {
                 }
             }
         }
+        const body = this.buildFormBody(params);
         return this.makeRequest(`/shops/${shopId}`, {
             method: 'PUT',
-            body: JSON.stringify(params)
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
         }, false);
     }
     async createShopSection(shopId, params) {
+        const body = this.buildFormBody(params);
         return this.makeRequest(`/shops/${shopId}/sections`, {
             method: 'POST',
-            body: JSON.stringify(params)
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
         }, false);
     }
     async updateShopSection(shopId, sectionId, params) {
+        const body = this.buildFormBody(params);
         return this.makeRequest(`/shops/${shopId}/sections/${sectionId}`, {
             method: 'PUT',
-            body: JSON.stringify(params)
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
         }, false);
     }
     async deleteShopSection(shopId, sectionId) {
@@ -1591,9 +1678,13 @@ class EtsyClient {
                 }
             }
         }
-        return this.makeRequest(`/shops/${shopId}/listings`, {
+        const legacy = options?.legacy;
+        const query = legacy !== undefined ? `?legacy=${legacy}` : '';
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/listings${query}`, {
             method: 'POST',
-            body: JSON.stringify(params)
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
         }, false);
     }
     async updateListing(shopId, listingId, params, options) {
@@ -1610,16 +1701,22 @@ class EtsyClient {
                 }
             }
         }
-        return this.makeRequest(`/shops/${shopId}/listings/${listingId}`, {
+        const legacy = options?.legacy;
+        const query = legacy !== undefined ? `?legacy=${legacy}` : '';
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/listings/${listingId}${query}`, {
             method: 'PATCH',
-            body: JSON.stringify(params)
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
         }, false);
     }
     async deleteListing(listingId) {
         await this.makeRequest(`/listings/${listingId}`, { method: 'DELETE' }, false);
     }
-    async updateListingInventory(listingId, params) {
-        return this.makeRequest(`/listings/${listingId}/inventory`, {
+    async updateListingInventory(listingId, params, options) {
+        const legacy = options?.legacy;
+        const query = legacy !== undefined ? `?legacy=${legacy}` : '';
+        return this.makeRequest(`/listings/${listingId}/inventory${query}`, {
             method: 'PUT',
             body: JSON.stringify(params)
         }, false);
@@ -1652,8 +1749,8 @@ class EtsyClient {
         }
         return response.json();
     }
-    async getListingImage(shopId, listingId, imageId) {
-        return this.makeRequest(`/shops/${shopId}/listings/${listingId}/images/${imageId}`);
+    async getListingImage(listingId, imageId) {
+        return this.makeRequest(`/listings/${listingId}/images/${imageId}`);
     }
     async deleteListingImage(shopId, listingId, imageId) {
         await this.makeRequest(`/shops/${shopId}/listings/${listingId}/images/${imageId}`, { method: 'DELETE' }, false);
@@ -1700,20 +1797,40 @@ class EtsyClient {
             searchParams.set('was_shipped', params.was_shipped.toString());
         if (params?.was_delivered !== undefined)
             searchParams.set('was_delivered', params.was_delivered.toString());
+        if (params?.was_canceled !== undefined)
+            searchParams.set('was_canceled', params.was_canceled.toString());
+        if (params?.legacy !== undefined)
+            searchParams.set('legacy', params.legacy.toString());
         const response = await this.makeRequest(`/shops/${shopId}/receipts?${searchParams.toString()}`);
         return response.results;
     }
-    async getShopReceipt(shopId, receiptId) {
-        return this.makeRequest(`/shops/${shopId}/receipts/${receiptId}`);
-    }
-    async updateShopReceipt(shopId, receiptId, params) {
-        return this.makeRequest(`/shops/${shopId}/receipts/${receiptId}`, {
+    async getShopReceipt(shopId, receiptId, params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.legacy !== undefined) {
+            searchParams.set('legacy', params.legacy.toString());
+        }
+        const query = searchParams.toString();
+        const suffix = query ? `?${query}` : '';
+        return this.makeRequest(`/shops/${shopId}/receipts/${receiptId}${suffix}`);
+    }
+    async updateShopReceipt(shopId, receiptId, params, options) {
+        const legacy = options?.legacy;
+        const query = legacy !== undefined ? `?legacy=${legacy}` : '';
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/receipts/${receiptId}${query}`, {
             method: 'PUT',
-            body: JSON.stringify(params)
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
         }, false);
     }
-    async getShopReceiptTransactions(shopId, receiptId) {
-        const response = await this.makeRequest(`/shops/${shopId}/receipts/${receiptId}/transactions`);
+    async getShopReceiptTransactions(shopId, receiptId, params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.legacy !== undefined) {
+            searchParams.set('legacy', params.legacy.toString());
+        }
+        const query = searchParams.toString();
+        const suffix = query ? `?${query}` : '';
+        const response = await this.makeRequest(`/shops/${shopId}/receipts/${receiptId}/transactions${suffix}`);
         return response.results;
     }
     async getShopTransaction(shopId, transactionId) {
@@ -1724,37 +1841,54 @@ class EtsyClient {
         return response.results;
     }
     async createShopShippingProfile(shopId, params) {
+        const body = this.buildFormBody(params);
         return this.makeRequest(`/shops/${shopId}/shipping-profiles`, {
             method: 'POST',
-            body: JSON.stringify(params)
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
         }, false);
     }
     async getShopShippingProfile(shopId, profileId) {
         return this.makeRequest(`/shops/${shopId}/shipping-profiles/${profileId}`);
     }
     async updateShopShippingProfile(shopId, profileId, params) {
+        const body = this.buildFormBody(params);
         return this.makeRequest(`/shops/${shopId}/shipping-profiles/${profileId}`, {
             method: 'PUT',
-            body: JSON.stringify(params)
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
         }, false);
     }
     async deleteShopShippingProfile(shopId, profileId) {
         await this.makeRequest(`/shops/${shopId}/shipping-profiles/${profileId}`, { method: 'DELETE' }, false);
     }
-    async getShopShippingProfileDestinations(shopId, profileId) {
-        const response = await this.makeRequest(`/shops/${shopId}/shipping-profiles/${profileId}/destinations`);
+    async getShopShippingProfileDestinations(shopId, profileId, params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.limit !== undefined) {
+            searchParams.set('limit', params.limit.toString());
+        }
+        if (params.offset !== undefined) {
+            searchParams.set('offset', params.offset.toString());
+        }
+        const query = searchParams.toString();
+        const suffix = query ? `?${query}` : '';
+        const response = await this.makeRequest(`/shops/${shopId}/shipping-profiles/${profileId}/destinations${suffix}`);
         return response.results;
     }
     async createShopShippingProfileDestination(shopId, profileId, params) {
+        const body = this.buildFormBody(params);
         return this.makeRequest(`/shops/${shopId}/shipping-profiles/${profileId}/destinations`, {
             method: 'POST',
-            body: JSON.stringify(params)
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
         }, false);
     }
     async updateShopShippingProfileDestination(shopId, profileId, destinationId, params) {
+        const body = this.buildFormBody(params);
         return this.makeRequest(`/shops/${shopId}/shipping-profiles/${profileId}/destinations/${destinationId}`, {
             method: 'PUT',
-            body: JSON.stringify(params)
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
         }, false);
     }
     async deleteShopShippingProfileDestination(shopId, profileId, destinationId) {
@@ -1764,16 +1898,16 @@ class EtsyClient {
         const response = await this.makeRequest(`/shops/${shopId}/shipping-profiles/${profileId}/upgrades`);
         return response.results;
     }
-    async createReceiptShipment(shopId, receiptId, params) {
-        return this.makeRequest(`/shops/${shopId}/receipts/${receiptId}/tracking`, {
+    async createReceiptShipment(shopId, receiptId, params, options) {
+        const legacy = options?.legacy;
+        const query = legacy !== undefined ? `?legacy=${legacy}` : '';
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/receipts/${receiptId}/tracking${query}`, {
             method: 'POST',
-            body: JSON.stringify(params)
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
         }, false);
     }
-    async getShopReceiptShipments(shopId, receiptId) {
-        const response = await this.makeRequest(`/shops/${shopId}/receipts/${receiptId}/shipments`);
-        return response.results;
-    }
     async getShopPaymentAccountLedgerEntries(shopId, params) {
         const searchParams = new URLSearchParams();
         searchParams.set('min_created', params.min_created.toString());
@@ -1788,8 +1922,18 @@ class EtsyClient {
     async getShopPaymentAccountLedgerEntry(shopId, entryId) {
         return this.makeRequest(`/shops/${shopId}/payment-account/ledger-entries/${entryId}`);
     }
+    async getPayments(shopId, paymentIds) {
+        const searchParams = new URLSearchParams();
+        searchParams.set('payment_ids', paymentIds.join(','));
+        const response = await this.makeRequest(`/shops/${shopId}/payments?${searchParams.toString()}`);
+        return response.results;
+    }
     async getShopPayment(shopId, paymentId) {
-        return this.makeRequest(`/shops/${shopId}/payment-account/payments/${paymentId}`);
+        const payments = await this.getPayments(shopId, [Number(paymentId)]);
+        if (payments.length === 0) {
+            throw new EtsyApiError('Payment not found', 404);
+        }
+        return payments[0];
     }
     async getBuyerTaxonomyNodes() {
         const response = await this.makeRequest('/buyer-taxonomy/nodes');
@@ -1806,8 +1950,8 @@ class EtsyClient {
     async updateListingProperty(params) {
         const { shopId, listingId, propertyId, valueIds, values, scaleId } = params;
         const body = new URLSearchParams();
-        valueIds.forEach(id => body.append('value_ids[]', id.toString()));
-        values.forEach(val => body.append('values[]', val));
+        valueIds.forEach(id => body.append('value_ids', id.toString()));
+        values.forEach(val => body.append('values', val));
         if (scaleId !== undefined) {
             body.append('scale_id', scaleId.toString());
         }
@@ -2184,12 +2328,23 @@ class GlobalRequestQueue {
                     let result;
                     if (item.timeout) {
                         const remainingTimeout = item.timeout - elapsed;
+                        let timeoutId;
                         const timeoutPromise = new Promise((_, reject) => {
-                            setTimeout(() => {
+                            timeoutId = setTimeout(() => {
                                 reject(new Error(`Request timeout after ${item.timeout}ms (exceeded during execution)`));
                             }, remainingTimeout);
+                            if (timeoutId && typeof timeoutId.unref === 'function') {
+                                timeoutId.unref();
+                            }
                         });
-                        result = await Promise.race([item.request(), timeoutPromise]);
+                        try {
+                            result = await Promise.race([item.request(), timeoutPromise]);
+                        }
+                        finally {
+                            if (timeoutId) {
+                                clearTimeout(timeoutId);
+                            }
+                        }
                     }
                     else {
                         result = await item.request();