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

package/dist/index.d.ts

@@ -976,6 +976,211 @@ interface UploadListingFileParams {
     name?: string;
     rank?: number;
 }
+interface EtsyShopProcessingProfile {
+    shop_id: number;
+    readiness_state_id: number;
+    readiness_state: 'ready_to_ship' | 'made_to_order';
+    min_processing_days: number;
+    max_processing_days: number;
+    processing_days_display_label: string;
+}
+interface CreateReadinessStateParams {
+    readiness_state: 'ready_to_ship' | 'made_to_order';
+    min_processing_time: number;
+    max_processing_time: number;
+    processing_time_unit?: 'days' | 'weeks';
+}
+interface UpdateReadinessStateParams {
+    readiness_state?: 'ready_to_ship' | 'made_to_order';
+    min_processing_time?: number;
+    max_processing_time?: number;
+    processing_time_unit?: 'days' | 'weeks';
+}
+interface GetReadinessStateParams {
+    limit?: number;
+    offset?: number;
+}
+interface EtsyShopReturnPolicy {
+    return_policy_id: number;
+    shop_id: number;
+    accepts_returns: boolean;
+    accepts_exchanges: boolean;
+    return_deadline: number | null;
+}
+interface CreateReturnPolicyParams {
+    accepts_returns: boolean;
+    accepts_exchanges: boolean;
+    return_deadline?: number | null;
+}
+interface UpdateReturnPolicyParams {
+    accepts_returns: boolean;
+    accepts_exchanges: boolean;
+    return_deadline?: number | null;
+}
+interface ConsolidateReturnPoliciesParams {
+    source_return_policy_id: number;
+    destination_return_policy_id: number;
+}
+interface EtsyShopHolidayPreference {
+    shop_id: number;
+    holiday_id: number;
+    country_iso: string;
+    is_working: boolean;
+    holiday_name: string;
+}
+interface UpdateHolidayPreferencesParams {
+    is_working: boolean;
+}
+interface EtsyListingFile {
+    listing_file_id: number;
+    listing_id: number;
+    rank: number;
+    filename: string;
+    filesize: string;
+    size_bytes: number;
+    filetype: string;
+    create_timestamp: number;
+    created_timestamp: number;
+}
+interface EtsyListingVideo {
+    video_id: number;
+    height: number;
+    width: number;
+    thumbnail_url: string;
+    video_url: string;
+    video_state: 'active' | 'inactive' | 'deleted' | 'flagged';
+}
+interface EtsyListingTranslation {
+    listing_id: number;
+    language: string;
+    title: string | null;
+    description: string | null;
+    tags: string[];
+}
+interface CreateListingTranslationParams {
+    title: string;
+    description: string;
+    tags?: string[];
+}
+interface UpdateListingTranslationParams {
+    title: string;
+    description: string;
+    tags?: string[];
+}
+interface EtsyListingVariationImage {
+    property_id: number;
+    value_id: number;
+    value: string | null;
+    image_id: number;
+}
+interface UpdateVariationImagesParams {
+    variation_images: Array<{
+        property_id: number;
+        value_id: number;
+        image_id: number;
+    }>;
+}
+interface EtsyUserAddress {
+    user_address_id: number;
+    user_id: number;
+    name: string;
+    first_line: string;
+    second_line: string | null;
+    city: string;
+    state: string | null;
+    zip: string | null;
+    iso_country_code: string | null;
+    country_name: string | null;
+    is_default_shipping_address: boolean;
+}
+interface EtsyShippingCarrierMailClass {
+    mail_class_key: string;
+    name: string;
+}
+interface EtsyShippingCarrier {
+    shipping_carrier_id: number;
+    name: string;
+    domestic_classes: EtsyShippingCarrierMailClass[];
+    international_classes: EtsyShippingCarrierMailClass[];
+}
+interface FindShopsParams {
+    shop_name: string;
+    limit?: number;
+    offset?: number;
+}
+interface GetListingsByIdsParams {
+    listing_ids: number[];
+    includes?: ListingIncludes[];
+    legacy?: boolean;
+}
+interface FindActiveListingsByShopParams {
+    limit?: number;
+    offset?: number;
+    sort_on?: 'created' | 'price' | 'updated' | 'score';
+    sort_order?: 'asc' | 'ascending' | 'desc' | 'descending' | 'up' | 'down';
+    keywords?: string;
+    legacy?: boolean;
+}
+interface GetFeaturedListingsParams {
+    limit?: number;
+    offset?: number;
+    legacy?: boolean;
+}
+interface GetListingsByShopReceiptParams {
+    limit?: number;
+    offset?: number;
+    legacy?: boolean;
+}
+interface GetListingsBySectionParams {
+    shop_section_ids: number[];
+    limit?: number;
+    offset?: number;
+    sort_on?: 'created' | 'price' | 'updated' | 'score';
+    sort_order?: 'asc' | 'ascending' | 'desc' | 'descending' | 'up' | 'down';
+    legacy?: boolean;
+}
+interface GetListingsByReturnPolicyParams {
+    legacy?: boolean;
+}
+interface CreateShippingProfileUpgradeParams {
+    type: number;
+    upgrade_name: string;
+    price: number;
+    secondary_price: number;
+    shipping_carrier_id?: number;
+    mail_class?: string;
+    min_delivery_days?: number;
+    max_delivery_days?: number;
+}
+interface UpdateShippingProfileUpgradeParams {
+    upgrade_name?: string;
+    type?: number;
+    price?: number;
+    secondary_price?: number;
+    shipping_carrier_id?: number;
+    mail_class?: string;
+    min_delivery_days?: number;
+    max_delivery_days?: number;
+}
+interface GetTransactionsByListingParams {
+    limit?: number;
+    offset?: number;
+    legacy?: boolean;
+}
+interface GetTransactionsByShopParams {
+    limit?: number;
+    offset?: number;
+    legacy?: boolean;
+}
+interface GetLedgerEntryPaymentsParams {
+    ledger_entry_ids: number[];
+}
+interface TokenScopesParams {
+    token: string;
+}
+interface TokenScopesResponse {
+    scopes: string[];
+}
 
 interface BulkOperationConfig {
     concurrency?: number;
@@ -1176,6 +1381,65 @@ declare class EtsyClient {
     getListingProperties(shopId: string, listingId: string): Promise<EtsyListingProperty[]>;
     updateListingProperty(params: UpdateListingPropertyParams): Promise<EtsyListingProperty>;
     getShopProductionPartners(shopId: string): Promise<EtsyShopProductionPartner[]>;
+    createShopReadinessStateDefinition(shopId: string, params: CreateReadinessStateParams): Promise<EtsyShopProcessingProfile>;
+    getShopReadinessStateDefinitions(shopId: string, params?: GetReadinessStateParams): Promise<EtsyShopProcessingProfile[]>;
+    getShopReadinessStateDefinition(shopId: string, definitionId: string): Promise<EtsyShopProcessingProfile>;
+    updateShopReadinessStateDefinition(shopId: string, definitionId: string, params: UpdateReadinessStateParams): Promise<EtsyShopProcessingProfile>;
+    deleteShopReadinessStateDefinition(shopId: string, definitionId: string): Promise<void>;
+    createShopReturnPolicy(shopId: string, params: CreateReturnPolicyParams): Promise<EtsyShopReturnPolicy>;
+    getShopReturnPolicies(shopId: string): Promise<EtsyShopReturnPolicy[]>;
+    getShopReturnPolicy(shopId: string, returnPolicyId: string): Promise<EtsyShopReturnPolicy>;
+    updateShopReturnPolicy(shopId: string, returnPolicyId: string, params: UpdateReturnPolicyParams): Promise<EtsyShopReturnPolicy>;
+    deleteShopReturnPolicy(shopId: string, returnPolicyId: string): Promise<void>;
+    consolidateShopReturnPolicies(shopId: string, params: ConsolidateReturnPoliciesParams): Promise<EtsyShopReturnPolicy>;
+    getHolidayPreferences(shopId: string): Promise<EtsyShopHolidayPreference[]>;
+    updateHolidayPreferences(shopId: string, holidayId: string, params: UpdateHolidayPreferencesParams): Promise<EtsyShopHolidayPreference>;
+    uploadListingFile(shopId: string, listingId: string, fileData: Blob | Buffer, params?: {
+        name?: string;
+        rank?: number;
+        listing_file_id?: number;
+    }): Promise<EtsyListingFile>;
+    getAllListingFiles(shopId: string, listingId: string): Promise<EtsyListingFile[]>;
+    getListingFile(shopId: string, listingId: string, fileId: string): Promise<EtsyListingFile>;
+    deleteListingFile(shopId: string, listingId: string, fileId: string): Promise<void>;
+    uploadListingVideo(shopId: string, listingId: string, videoData: Blob | Buffer, params?: {
+        name?: string;
+        video_id?: number;
+    }): Promise<EtsyListingVideo>;
+    getListingVideos(listingId: string): Promise<EtsyListingVideo[]>;
+    getListingVideo(listingId: string, videoId: string): Promise<EtsyListingVideo>;
+    deleteListingVideo(shopId: string, listingId: string, videoId: string): Promise<void>;
+    createListingTranslation(shopId: string, listingId: string, language: string, params: CreateListingTranslationParams): Promise<EtsyListingTranslation>;
+    getListingTranslation(shopId: string, listingId: string, language: string): Promise<EtsyListingTranslation>;
+    updateListingTranslation(shopId: string, listingId: string, language: string, params: UpdateListingTranslationParams): Promise<EtsyListingTranslation>;
+    getListingVariationImages(shopId: string, listingId: string): Promise<EtsyListingVariationImage[]>;
+    updateVariationImages(shopId: string, listingId: string, params: UpdateVariationImagesParams): Promise<EtsyListingVariationImage[]>;
+    findAllActiveListingsByShop(shopId: string, params?: FindActiveListingsByShopParams): Promise<EtsyListing[]>;
+    getFeaturedListingsByShop(shopId: string, params?: GetFeaturedListingsParams): Promise<EtsyListing[]>;
+    getListingsByListingIds(params: GetListingsByIdsParams): Promise<EtsyListing[]>;
+    getListingsByShopReceipt(shopId: string, receiptId: string, params?: GetListingsByShopReceiptParams): Promise<EtsyListing[]>;
+    getListingProperty(listingId: string, propertyId: string): Promise<EtsyListingProperty>;
+    deleteListingProperty(shopId: string, listingId: string, propertyId: string): Promise<void>;
+    getListingProduct(listingId: string, productId: string): Promise<EtsyListingProduct>;
+    getListingOffering(listingId: string, productId: string, offeringId: string): Promise<EtsyListingOffering>;
+    getListingsByShopSectionId(shopId: string, params: GetListingsBySectionParams): Promise<EtsyListing[]>;
+    getListingsByShopReturnPolicy(shopId: string, returnPolicyId: string, params?: GetListingsByReturnPolicyParams): Promise<EtsyListing[]>;
+    findShops(params: FindShopsParams): Promise<EtsyShop[]>;
+    createShopShippingProfileUpgrade(shopId: string, profileId: string, params: CreateShippingProfileUpgradeParams): Promise<EtsyShippingProfileUpgrade>;
+    updateShopShippingProfileUpgrade(shopId: string, profileId: string, upgradeId: string, params: UpdateShippingProfileUpgradeParams): Promise<EtsyShippingProfileUpgrade>;
+    deleteShopShippingProfileUpgrade(shopId: string, profileId: string, upgradeId: string): Promise<void>;
+    getShippingCarriers(originCountryIso: string): Promise<EtsyShippingCarrier[]>;
+    getShopReceiptTransactionsByListing(shopId: string, listingId: string, params?: GetTransactionsByListingParams): Promise<EtsyShopReceiptTransaction[]>;
+    getShopReceiptTransactionsByShop(shopId: string, params?: GetTransactionsByShopParams): Promise<EtsyShopReceiptTransaction[]>;
+    getPaymentAccountLedgerEntryPayments(shopId: string, params: GetLedgerEntryPaymentsParams): Promise<EtsyPayment[]>;
+    getShopPaymentByReceiptId(shopId: string, receiptId: string): Promise<EtsyPayment[]>;
+    getMe(): Promise<EtsyUser>;
+    getUserAddresses(): Promise<EtsyUserAddress[]>;
+    getUserAddress(userAddressId: string): Promise<EtsyUserAddress>;
+    deleteUserAddress(userAddressId: string): Promise<void>;
+    getPropertiesByBuyerTaxonomyId(taxonomyId: number): Promise<EtsyBuyerTaxonomyProperty[]>;
+    ping(): Promise<number>;
+    tokenScopes(params: TokenScopesParams): Promise<TokenScopesResponse>;
     getRemainingRequests(): number;
     getRateLimitStatus(): RateLimitStatus;
     onApproachingRateLimit(callback: ApproachingLimitCallback, threshold?: number): void;
@@ -1815,4 +2079,4 @@ declare function getLibraryInfo(): {
 };
 
 export { AuthHelper, BatchQueryExecutor, BulkOperationManager, COMMON_SCOPE_COMBINATIONS, CacheWithInvalidation, CreateListingSchema, DEFAULT_RETRY_CONFIG, ETSY_SCOPES, EncryptedFileTokenStorage, EtsyApiError, EtsyAuthError, EtsyClient, EtsyRateLimitError, EtsyRateLimiter, EtsyWebhookHandler, FieldValidator, FileTokenStorage, GlobalRequestQueue, LFUCache, LIBRARY_NAME, LRUCache, ListingQueryBuilder, LocalStorageTokenStorage, MemoryTokenStorage, PaginatedResults, PluginManager, ReceiptQueryBuilder, RedisCacheStorage, RetryManager, SecureTokenStorage, SessionStorageTokenStorage, TokenManager, UpdateListingSchema, UpdateShopSchema, VERSION, ValidationException, Validator, WebhookSecurity, combineValidators, createAnalyticsPlugin, createAuthHelper, createBatchQuery, createBulkOperationManager, createCacheStorage, createCacheWithInvalidation, createCachingPlugin, createCodeChallenge, createDefaultTokenStorage, createEtsyClient, createListingQuery, createLoggingPlugin, createPaginatedResults, createRateLimitPlugin, createRateLimiter, createReceiptQuery, createRedisCacheStorage, createRetryPlugin, createTokenManager, createValidator, createWebhookHandler, createWebhookSecurity, decryptAES256GCM, EtsyClient as default, defaultRateLimiter, deriveKeyFromPassword, encryptAES256GCM, executeBulkOperation, field, generateCodeVerifier, generateEncryptionKey, generateRandomBase64Url, generateState, getAvailableStorage, getEnvironmentInfo, getGlobalQueue, getLibraryInfo, hasLocalStorage, hasSessionStorage, isBrowser, isNode, isSecureStorageSupported, sha256, sha256Base64Url, validate, validateEncryptionKey, validateOrThrow, withQueryBuilder, withQueue, withRetry };
-export type { AdvancedCachingConfig, AnalyticsPluginConfig, ApproachingLimitCallback, AuthHelperConfig, BulkImageUploadOperation, BulkOperationConfig, BulkOperationError, BulkOperationResult, BulkOperationSummary, BulkUpdateListingOperation, CacheEntry, CacheStats, CacheStorage, CacheStrategy, CachingPluginConfig, CreateDraftListingParams, CreateReceiptShipmentParams, CreateShippingProfileDestinationParams, CreateShippingProfileParams, CreateShopSectionParams, EncryptedData, EncryptedStorageConfig, EtsyApiResponse, EtsyBuyerTaxonomyNode, EtsyBuyerTaxonomyProperty, EtsyBuyerTaxonomyPropertyScale, EtsyBuyerTaxonomyPropertyValue, EtsyClientConfig, EtsyClientWithQueryBuilder, EtsyErrorDetails, EtsyListing, EtsyListingImage, EtsyListingInventory, EtsyListingOffering, EtsyListingProduct, EtsyListingProperty, EtsyListingPropertyScale, EtsyListingPropertyValue, EtsyPagination, EtsyPayment, EtsyPaymentAccountLedgerEntry, EtsyPaymentAdjustment, EtsyPlugin, EtsyRateLimitHeaders, EtsyReview, EtsySellerTaxonomyNode, EtsyShippingProfile, EtsyShippingProfileDestination, EtsyShippingProfileUpgrade, EtsyShop, EtsyShopProductionPartner, EtsyShopReceipt, EtsyShopReceiptShipment, EtsyShopReceiptTransaction, EtsyShopRefund, EtsyShopSection, EtsyTokenResponse, EtsyTokens, EtsyTransactionVariation, EtsyUser, EtsyWebhookEvent, EtsyWebhookEventType, GetPaymentAccountLedgerEntriesParams, GetReviewsParams, GetShopReceiptsParams, ListingParams, ListingSortOn, ListingState, LoggerInterface, LoggingPluginConfig, PageFetcher, PaginationOptions, PluginRequestConfig, PluginResponse, QueueOptions, RateLimitConfig, RateLimitErrorType, RateLimitPluginConfig, RateLimitStatus, RedisClientLike, RedisConfig, RequestPriority, RetryConfig, RetryOptions, RetryPluginConfig, SearchParams, SecureTokenStorageConfig, SortOrder, TokenRefreshCallback, TokenRotationCallback, TokenRotationConfig, TokenStorage, UpdateListingInventoryParams, UpdateListingParams, UpdateListingPropertyParams, UpdateShippingProfileDestinationParams, UpdateShippingProfileParams, UpdateShopParams, UpdateShopReceiptParams, UpdateShopSectionParams, UploadListingFileParams, UploadListingImageParams, ValidationError, ValidationOptions, ValidationResult, ValidationSchema, ValidatorFunction, WebhookConfig, WebhookEventHandler, WebhookSecurityConfig };
+export type { AdvancedCachingConfig, AnalyticsPluginConfig, ApproachingLimitCallback, AuthHelperConfig, BulkImageUploadOperation, BulkOperationConfig, BulkOperationError, BulkOperationResult, BulkOperationSummary, BulkUpdateListingOperation, CacheEntry, CacheStats, CacheStorage, CacheStrategy, CachingPluginConfig, ConsolidateReturnPoliciesParams, CreateDraftListingParams, CreateListingTranslationParams, CreateReadinessStateParams, CreateReceiptShipmentParams, CreateReturnPolicyParams, CreateShippingProfileDestinationParams, CreateShippingProfileParams, CreateShippingProfileUpgradeParams, CreateShopSectionParams, EncryptedData, EncryptedStorageConfig, EtsyApiResponse, EtsyBuyerTaxonomyNode, EtsyBuyerTaxonomyProperty, EtsyBuyerTaxonomyPropertyScale, EtsyBuyerTaxonomyPropertyValue, EtsyClientConfig, EtsyClientWithQueryBuilder, EtsyErrorDetails, EtsyListing, EtsyListingFile, EtsyListingImage, EtsyListingInventory, EtsyListingOffering, EtsyListingProduct, EtsyListingProperty, EtsyListingPropertyScale, EtsyListingPropertyValue, EtsyListingTranslation, EtsyListingVariationImage, EtsyListingVideo, EtsyPagination, EtsyPayment, EtsyPaymentAccountLedgerEntry, EtsyPaymentAdjustment, EtsyPlugin, EtsyRateLimitHeaders, EtsyReview, EtsySellerTaxonomyNode, EtsyShippingCarrier, EtsyShippingCarrierMailClass, EtsyShippingProfile, EtsyShippingProfileDestination, EtsyShippingProfileUpgrade, EtsyShop, EtsyShopHolidayPreference, EtsyShopProcessingProfile, EtsyShopProductionPartner, EtsyShopReceipt, EtsyShopReceiptShipment, EtsyShopReceiptTransaction, EtsyShopRefund, EtsyShopReturnPolicy, EtsyShopSection, EtsyTokenResponse, EtsyTokens, EtsyTransactionVariation, EtsyUser, EtsyUserAddress, EtsyWebhookEvent, EtsyWebhookEventType, FindActiveListingsByShopParams, FindShopsParams, GetFeaturedListingsParams, GetLedgerEntryPaymentsParams, GetListingsByIdsParams, GetListingsByReturnPolicyParams, GetListingsBySectionParams, GetListingsByShopReceiptParams, GetPaymentAccountLedgerEntriesParams, GetReadinessStateParams, GetReviewsParams, GetShopReceiptsParams, GetTransactionsByListingParams, GetTransactionsByShopParams, ListingParams, ListingSortOn, ListingState, LoggerInterface, LoggingPluginConfig, PageFetcher, PaginationOptions, PluginRequestConfig, PluginResponse, QueueOptions, RateLimitConfig, RateLimitErrorType, RateLimitPluginConfig, RateLimitStatus, RedisClientLike, RedisConfig, RequestPriority, RetryConfig, RetryOptions, RetryPluginConfig, SearchParams, SecureTokenStorageConfig, SortOrder, TokenRefreshCallback, TokenRotationCallback, TokenRotationConfig, TokenScopesParams, TokenScopesResponse, TokenStorage, UpdateHolidayPreferencesParams, UpdateListingInventoryParams, UpdateListingParams, UpdateListingPropertyParams, UpdateListingTranslationParams, UpdateReadinessStateParams, UpdateReturnPolicyParams, UpdateShippingProfileDestinationParams, UpdateShippingProfileParams, UpdateShippingProfileUpgradeParams, UpdateShopParams, UpdateShopReceiptParams, UpdateShopSectionParams, UpdateVariationImagesParams, UploadListingFileParams, UploadListingImageParams, ValidationError, ValidationOptions, ValidationResult, ValidationSchema, ValidatorFunction, WebhookConfig, WebhookEventHandler, WebhookSecurityConfig };

package/dist/index.esm.js

@@ -1975,6 +1975,376 @@ class EtsyClient {
         const response = await this.makeRequest(`/shops/${shopId}/production-partners`);
         return response.results;
     }
+    async createShopReadinessStateDefinition(shopId, params) {
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/readiness-state-definitions`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
+        }, false);
+    }
+    async getShopReadinessStateDefinitions(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());
+        const query = searchParams.toString();
+        const suffix = query ? `?${query}` : '';
+        const response = await this.makeRequest(`/shops/${shopId}/readiness-state-definitions${suffix}`);
+        return response.results;
+    }
+    async getShopReadinessStateDefinition(shopId, definitionId) {
+        return this.makeRequest(`/shops/${shopId}/readiness-state-definitions/${definitionId}`);
+    }
+    async updateShopReadinessStateDefinition(shopId, definitionId, params) {
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/readiness-state-definitions/${definitionId}`, {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
+        }, false);
+    }
+    async deleteShopReadinessStateDefinition(shopId, definitionId) {
+        await this.makeRequest(`/shops/${shopId}/readiness-state-definitions/${definitionId}`, { method: 'DELETE' }, false);
+    }
+    async createShopReturnPolicy(shopId, params) {
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/policies/return`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
+        }, false);
+    }
+    async getShopReturnPolicies(shopId) {
+        const response = await this.makeRequest(`/shops/${shopId}/policies/return`);
+        return response.results;
+    }
+    async getShopReturnPolicy(shopId, returnPolicyId) {
+        return this.makeRequest(`/shops/${shopId}/policies/return/${returnPolicyId}`);
+    }
+    async updateShopReturnPolicy(shopId, returnPolicyId, params) {
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/policies/return/${returnPolicyId}`, {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
+        }, false);
+    }
+    async deleteShopReturnPolicy(shopId, returnPolicyId) {
+        await this.makeRequest(`/shops/${shopId}/policies/return/${returnPolicyId}`, { method: 'DELETE' }, false);
+    }
+    async consolidateShopReturnPolicies(shopId, params) {
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/policies/return/consolidate`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
+        }, false);
+    }
+    async getHolidayPreferences(shopId) {
+        const response = await this.makeRequest(`/shops/${shopId}/holiday-preferences`);
+        return response.results;
+    }
+    async updateHolidayPreferences(shopId, holidayId, params) {
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/holiday-preferences/${holidayId}`, {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
+        }, false);
+    }
+    async uploadListingFile(shopId, listingId, fileData, params) {
+        const formData = new FormData();
+        formData.append('file', fileData);
+        if (params?.name)
+            formData.append('name', params.name);
+        if (params?.rank !== undefined)
+            formData.append('rank', params.rank.toString());
+        if (params?.listing_file_id !== undefined)
+            formData.append('listing_file_id', params.listing_file_id.toString());
+        const url = `${this.baseUrl}/shops/${shopId}/listings/${listingId}/files`;
+        await this.rateLimiter.waitForRateLimit();
+        const accessToken = await this.tokenManager.getAccessToken();
+        const response = await this.fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${accessToken}`,
+                'x-api-key': this.getApiKey(),
+            },
+            body: formData
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new EtsyApiError(`Failed to upload file: ${response.status} ${response.statusText}`, response.status, errorText);
+        }
+        return response.json();
+    }
+    async getAllListingFiles(shopId, listingId) {
+        const response = await this.makeRequest(`/shops/${shopId}/listings/${listingId}/files`);
+        return response.results;
+    }
+    async getListingFile(shopId, listingId, fileId) {
+        return this.makeRequest(`/shops/${shopId}/listings/${listingId}/files/${fileId}`);
+    }
+    async deleteListingFile(shopId, listingId, fileId) {
+        await this.makeRequest(`/shops/${shopId}/listings/${listingId}/files/${fileId}`, { method: 'DELETE' }, false);
+    }
+    async uploadListingVideo(shopId, listingId, videoData, params) {
+        const formData = new FormData();
+        formData.append('video', videoData);
+        if (params?.name)
+            formData.append('name', params.name);
+        if (params?.video_id !== undefined)
+            formData.append('video_id', params.video_id.toString());
+        const url = `${this.baseUrl}/shops/${shopId}/listings/${listingId}/videos`;
+        await this.rateLimiter.waitForRateLimit();
+        const accessToken = await this.tokenManager.getAccessToken();
+        const response = await this.fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${accessToken}`,
+                'x-api-key': this.getApiKey(),
+            },
+            body: formData
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new EtsyApiError(`Failed to upload video: ${response.status} ${response.statusText}`, response.status, errorText);
+        }
+        return response.json();
+    }
+    async getListingVideos(listingId) {
+        const response = await this.makeRequest(`/listings/${listingId}/videos`);
+        return response.results;
+    }
+    async getListingVideo(listingId, videoId) {
+        return this.makeRequest(`/listings/${listingId}/videos/${videoId}`);
+    }
+    async deleteListingVideo(shopId, listingId, videoId) {
+        await this.makeRequest(`/shops/${shopId}/listings/${listingId}/videos/${videoId}`, { method: 'DELETE' }, false);
+    }
+    async createListingTranslation(shopId, listingId, language, params) {
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/listings/${listingId}/translations/${language}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
+        }, false);
+    }
+    async getListingTranslation(shopId, listingId, language) {
+        return this.makeRequest(`/shops/${shopId}/listings/${listingId}/translations/${language}`);
+    }
+    async updateListingTranslation(shopId, listingId, language, params) {
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/listings/${listingId}/translations/${language}`, {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
+        }, false);
+    }
+    async getListingVariationImages(shopId, listingId) {
+        const response = await this.makeRequest(`/shops/${shopId}/listings/${listingId}/variation-images`);
+        return response.results;
+    }
+    async updateVariationImages(shopId, listingId, params) {
+        const response = await this.makeRequest(`/shops/${shopId}/listings/${listingId}/variation-images`, {
+            method: 'POST',
+            body: JSON.stringify(params)
+        }, false);
+        return response.results;
+    }
+    async findAllActiveListingsByShop(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.sort_on)
+            searchParams.set('sort_on', params.sort_on);
+        if (params.sort_order)
+            searchParams.set('sort_order', params.sort_order);
+        if (params.keywords)
+            searchParams.set('keywords', params.keywords);
+        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}/listings/active${suffix}`);
+        return response.results;
+    }
+    async getFeaturedListingsByShop(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.legacy !== undefined)
+            searchParams.set('legacy', params.legacy.toString());
+        const query = searchParams.toString();
+        const suffix = query ? `?${query}` : '';
+        const response = await this.makeRequest(`/shops/${shopId}/listings/featured${suffix}`);
+        return response.results;
+    }
+    async getListingsByListingIds(params) {
+        const searchParams = new URLSearchParams();
+        searchParams.set('listing_ids', params.listing_ids.join(','));
+        if (params.includes)
+            searchParams.set('includes', params.includes.join(','));
+        if (params.legacy !== undefined)
+            searchParams.set('legacy', params.legacy.toString());
+        const response = await this.makeRequest(`/listings/batch?${searchParams.toString()}`);
+        return response.results;
+    }
+    async getListingsByShopReceipt(shopId, receiptId, 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.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}/listings${suffix}`);
+        return response.results;
+    }
+    async getListingProperty(listingId, propertyId) {
+        return this.makeRequest(`/listings/${listingId}/properties/${propertyId}`);
+    }
+    async deleteListingProperty(shopId, listingId, propertyId) {
+        await this.makeRequest(`/shops/${shopId}/listings/${listingId}/properties/${propertyId}`, { method: 'DELETE' }, false);
+    }
+    async getListingProduct(listingId, productId) {
+        return this.makeRequest(`/listings/${listingId}/inventory/products/${productId}`);
+    }
+    async getListingOffering(listingId, productId, offeringId) {
+        return this.makeRequest(`/listings/${listingId}/products/${productId}/offerings/${offeringId}`);
+    }
+    async getListingsByShopSectionId(shopId, params) {
+        const searchParams = new URLSearchParams();
+        searchParams.set('shop_section_ids', params.shop_section_ids.join(','));
+        if (params.limit !== undefined)
+            searchParams.set('limit', params.limit.toString());
+        if (params.offset !== undefined)
+            searchParams.set('offset', params.offset.toString());
+        if (params.sort_on)
+            searchParams.set('sort_on', params.sort_on);
+        if (params.sort_order)
+            searchParams.set('sort_order', params.sort_order);
+        if (params.legacy !== undefined)
+            searchParams.set('legacy', params.legacy.toString());
+        const response = await this.makeRequest(`/shops/${shopId}/shop-sections/listings?${searchParams.toString()}`);
+        return response.results;
+    }
+    async getListingsByShopReturnPolicy(shopId, returnPolicyId, 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}/policies/return/${returnPolicyId}/listings${suffix}`);
+        return response.results;
+    }
+    async findShops(params) {
+        const searchParams = new URLSearchParams();
+        searchParams.set('shop_name', params.shop_name);
+        if (params.limit !== undefined)
+            searchParams.set('limit', params.limit.toString());
+        if (params.offset !== undefined)
+            searchParams.set('offset', params.offset.toString());
+        const response = await this.makeRequest(`/shops?${searchParams.toString()}`);
+        return response.results;
+    }
+    async createShopShippingProfileUpgrade(shopId, profileId, params) {
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/shipping-profiles/${profileId}/upgrades`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
+        }, false);
+    }
+    async updateShopShippingProfileUpgrade(shopId, profileId, upgradeId, params) {
+        const body = this.buildFormBody(params);
+        return this.makeRequest(`/shops/${shopId}/shipping-profiles/${profileId}/upgrades/${upgradeId}`, {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
+        }, false);
+    }
+    async deleteShopShippingProfileUpgrade(shopId, profileId, upgradeId) {
+        await this.makeRequest(`/shops/${shopId}/shipping-profiles/${profileId}/upgrades/${upgradeId}`, { method: 'DELETE' }, false);
+    }
+    async getShippingCarriers(originCountryIso) {
+        const searchParams = new URLSearchParams();
+        searchParams.set('origin_country_iso', originCountryIso);
+        const response = await this.makeRequest(`/shipping-carriers?${searchParams.toString()}`);
+        return response.results;
+    }
+    async getShopReceiptTransactionsByListing(shopId, 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.legacy !== undefined)
+            searchParams.set('legacy', params.legacy.toString());
+        const query = searchParams.toString();
+        const suffix = query ? `?${query}` : '';
+        const response = await this.makeRequest(`/shops/${shopId}/listings/${listingId}/transactions${suffix}`);
+        return response.results;
+    }
+    async getShopReceiptTransactionsByShop(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.legacy !== undefined)
+            searchParams.set('legacy', params.legacy.toString());
+        const query = searchParams.toString();
+        const suffix = query ? `?${query}` : '';
+        const response = await this.makeRequest(`/shops/${shopId}/transactions${suffix}`);
+        return response.results;
+    }
+    async getPaymentAccountLedgerEntryPayments(shopId, params) {
+        const searchParams = new URLSearchParams();
+        searchParams.set('ledger_entry_ids', params.ledger_entry_ids.join(','));
+        const response = await this.makeRequest(`/shops/${shopId}/payment-account/ledger-entries/payments?${searchParams.toString()}`);
+        return response.results;
+    }
+    async getShopPaymentByReceiptId(shopId, receiptId) {
+        const response = await this.makeRequest(`/shops/${shopId}/receipts/${receiptId}/payments`);
+        return response.results;
+    }
+    async getMe() {
+        return this.makeRequest('/users/me');
+    }
+    async getUserAddresses() {
+        const response = await this.makeRequest('/user/addresses');
+        return response.results;
+    }
+    async getUserAddress(userAddressId) {
+        return this.makeRequest(`/user/addresses/${userAddressId}`);
+    }
+    async deleteUserAddress(userAddressId) {
+        await this.makeRequest(`/user/addresses/${userAddressId}`, { method: 'DELETE' }, false);
+    }
+    async getPropertiesByBuyerTaxonomyId(taxonomyId) {
+        const response = await this.makeRequest(`/buyer-taxonomy/nodes/${taxonomyId}/properties`);
+        return response.results;
+    }
+    async ping() {
+        return this.makeRequest('/openapi-ping', {}, false);
+    }
+    async tokenScopes(params) {
+        const body = this.buildFormBody(params);
+        return this.makeRequest('/scopes', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString()
+        }, false);
+    }
     getRemainingRequests() {
         return this.rateLimiter.getRemainingRequests();
     }