eBay Utility

A TypeScript utility library for syncing ITrack inventory, images, offers, and policies to the eBay API.

Installation

pnpm install @isoftdata/ebay-utility

Beta: the current major is published under the beta dist-tag. A bare install resolves to the latest 1.x; pull the new Media API line explicitly with @isoftdata/ebay-utility@beta. See the Changelog for the breaking changes.

Quick Start

import { EbayAdapter, TokenManager, syncInventoryToEbay } from '@isoftdata/ebay-utility'

const tokenManager = new TokenManager(/* your config */)
const ebayAdapter = new EbayAdapter(tokenManager)

const result = await syncInventoryToEbay({
	ebayAdapter,
	tokenManager,
	sku: 'your-sku',
	inventoryItem: {
		/* your inventory item data */
	},
})

if (!result.success) {
	console.error(result.errors)
}

Every operation returns a result object ({ success, data?, errors? }) instead of throwing.

Main entry points

The package is fully typed — your editor's autocomplete lists everything exported. The pieces you'll reach for first:

• EbayAdapter / ItrackAdapter — the adapters that talk to eBay and ITrack.
• TokenManager — eBay OAuth token handling.
• syncInventoryToEbay, syncImageToEbay, syncEbayInventoryAndOffer — the top-level sync flows.

Requirements

• Node.js 22+
• TypeScript 5+

Documentation

• Image Upload Flow — how ITrack images reach eBay Picture Services via the Media API.
• Changelog — notable changes, including the breaking 2.0 Media API migration.

License

ISC