sdk: release 0.10.0

Author: Krablante

CHANGELOG.md

@@ -6,6 +6,16 @@ The format is based on Keep a Changelog.
 
 ## [Unreleased]
 
+## [0.10.0] - 2026-03-12
+
+### Removed
+
+1. removed five exact public alias duplicates from the SDK surface: `account.acceptSale()`, `account.cancelSale()`, `account.declineOffer()`, `listings.unlistBulkListings()`, and `listings.unlistListing()`
+
+### Changed
+
+1. standardized the canonical trade/offer/listing naming surface around `acceptTrade()`, `cancelTrade()`, `cancelOffer()`, `deleteBulkListings()`, and `deleteListing()`
+
 ## [0.9.4] - 2026-03-11
 
 ### Added

README.md

@@ -36,7 +36,7 @@ The project is intentionally conservative about claims. Anything called `impleme
 
 > The goal is simple: be the SDK you reach for first if you want serious CSFloat automation instead of a thin wrapper.
 >
-> Install from npm: [`csfloat-node-sdk@0.9.4`](https://www.npmjs.com/package/csfloat-node-sdk)
+> Install from npm: [`csfloat-node-sdk@0.10.0`](https://www.npmjs.com/package/csfloat-node-sdk)
 
 ## Documentation
 
@@ -104,17 +104,17 @@ This SDK is optimized for:
 
 ## What’s In The Current Generation
 
-- live-confirmed offer flows: create, counter, cancel, decline, history, plus a low-level `acceptOffer()` helper for the browser-observed accept route
-- live-confirmed purchase flows: direct `buyNow`, buy-order create/update/delete, seller-side `acceptSale`
-- state-gated trade lifecycle helpers, including seller-side `acceptSale()`, buyer-side `markTradesReceived()`, and low-level single-trade helpers such as `markTradeReceived()`, `cannotDeliverTrade()`, and `rollbackTrade()`
+- live-confirmed offer flows: create, counter, cancel, history, plus a low-level `acceptOffer()` helper for the browser-observed accept route
+- live-confirmed purchase flows: direct `buyNow`, buy-order create/update/delete, seller-side `acceptTrade`
+- state-gated trade lifecycle helpers, including seller-side `acceptTrade()`, buyer-side `markTradesReceived()`, and low-level single-trade helpers such as `markTradeReceived()`, `cannotDeliverTrade()`, and `rollbackTrade()`
 - low-level trade sync helpers for the browser-observed Steam status routes: `syncSteamNewOffer()` and `syncSteamOffers()`, with optional asset-annotation payloads on the new-offer route
 - low-level account verification helpers for `verifyEmail()` and `verifySms()`
 - live-confirmed buy-order insight flows: inspect-based lookup and similar-order discovery
 - live-confirmed buy-order expression workflows via `account.createBuyOrder({ expression, ... })`, `account.getSimilarBuyOrders({ expression }, ...)`, and composable builder helpers
 - workflow-first helpers via `sdk.workflows` for public feed snapshots, account workspace snapshots, and single-skin buy-order insights
 - live-confirmed support helpers around adjacent account/insight flows such as `meta.getNotary()`, `account.createNotaryToken()`, `account.createGsInspectToken()`, and `account.getSimilarBuyOrders()`
 - live-confirmed auction flow pieces: bid history, max-price `placeBid()`, `deleteAutoBid()` cancellation on cheap auctions, and stable item-route bootstrap reads for `getBuyOrders()` / `getSimilar()` around active auction listings
-- live-confirmed bulk listing controls: `createBulkListings()`, `updateBulkListings()`, and `deleteBulkListings()` / `unlistBulkListings()`
+- live-confirmed bulk listing controls: `createBulkListings()`, `updateBulkListings()`, and `deleteBulkListings()`
 - live-confirmed public/account helpers around app bootstrap, schema media, checker lookup, and payments, including `meta.getApp()`, `meta.getSchemaBrowse()`, `meta.getItemExampleScreenshot()`, `meta.inspectItem()`, and `account.getPendingDeposits()`
 - public market helpers: `price-list`, wear presets, range builders, category helpers
 - browser-auth discoveries promoted into SDK surface where they proved stable, including `createRecommenderToken()`
@@ -149,12 +149,12 @@ See [API_COVERAGE.md](./API_COVERAGE.md) for the endpoint-by-endpoint support ma
 | Area | Status | Methods |
 |---|---|---|
 | Meta | implemented | `meta.getSchema()`, `meta.getSchemaBrowse()`, `meta.getItemExampleScreenshot()`, `meta.inspectItem()`, `meta.getExchangeRates()`, `meta.getApp()`, `meta.getLocation()`, `meta.getNotary()` |
-| Account | implemented | `account.getMe()`, `account.getTrades()`, `account.getTrade()`, `account.getTradeBuyerDetails()`, `account.cannotDeliverTrade()`, `account.disputeTrade()`, `account.syncSteamNewOffer()`, `account.syncSteamOffers()`, `account.acceptTrades()`, `account.markTradesReceived()`, `account.markTradeReceived()`, `account.acceptTrade()`, `account.acceptSale()`, `account.cancelTrades()`, `account.cancelTrade()`, `account.cancelSale()`, `account.rollbackTrade()`, `account.manualVerifyTrade()`, `account.verifyTradeRollback()`, `account.getOffers()`, `account.createOffer()`, `account.getOffer()`, `account.acceptOffer()`, `account.getOfferHistory()`, `account.counterOffer()`, `account.cancelOffer()`, `account.declineOffer()`, `account.getWatchlist()`, `account.iterateWatchlist()`, `account.getOffersTimeline()`, `account.getNotifications()`, `account.getTransactions()`, `account.exportTransactions()`, `account.getAccountStanding()`, `account.getBuyOrders()`, `account.getBuyOrdersForInspect()`, `account.getSimilarBuyOrders()`, `account.createBuyOrder()`, `account.updateBuyOrder()`, `account.deleteBuyOrder()`, `account.getAutoBids()`, `account.deleteAutoBid()`, `account.createRecommenderToken()`, `account.createNotaryToken()`, `account.createGsInspectToken()`, `account.getMaxWithdrawable()`, `account.getPendingDeposits()`, `account.getPendingWithdrawals()`, `account.deletePendingWithdrawal()`, `account.getExtensionStatus()`, `account.getMobileStatus()`, `account.verifyEmail()`, `account.verifySms()`, `account.updateMe()`, `account.setOffersEnabled()`, `account.setStallPublic()`, `account.setAway()`, `account.setMaxOfferDiscount()`, `account.updateTradeUrl()`, `account.updateBackground()`, `account.updateUsername()`, `account.markNotificationsRead()`, `account.setMobileStatus()` |
+| Account | implemented | `account.getMe()`, `account.getTrades()`, `account.getTrade()`, `account.getTradeBuyerDetails()`, `account.cannotDeliverTrade()`, `account.disputeTrade()`, `account.syncSteamNewOffer()`, `account.syncSteamOffers()`, `account.acceptTrades()`, `account.markTradesReceived()`, `account.markTradeReceived()`, `account.acceptTrade()`, `account.cancelTrades()`, `account.cancelTrade()`, `account.rollbackTrade()`, `account.manualVerifyTrade()`, `account.verifyTradeRollback()`, `account.getOffers()`, `account.createOffer()`, `account.getOffer()`, `account.acceptOffer()`, `account.getOfferHistory()`, `account.counterOffer()`, `account.cancelOffer()`, `account.getWatchlist()`, `account.iterateWatchlist()`, `account.getOffersTimeline()`, `account.getNotifications()`, `account.getTransactions()`, `account.exportTransactions()`, `account.getAccountStanding()`, `account.getBuyOrders()`, `account.getBuyOrdersForInspect()`, `account.getSimilarBuyOrders()`, `account.createBuyOrder()`, `account.updateBuyOrder()`, `account.deleteBuyOrder()`, `account.getAutoBids()`, `account.deleteAutoBid()`, `account.createRecommenderToken()`, `account.createNotaryToken()`, `account.createGsInspectToken()`, `account.getMaxWithdrawable()`, `account.getPendingDeposits()`, `account.getPendingWithdrawals()`, `account.deletePendingWithdrawal()`, `account.getExtensionStatus()`, `account.getMobileStatus()`, `account.verifyEmail()`, `account.verifySms()`, `account.updateMe()`, `account.setOffersEnabled()`, `account.setStallPublic()`, `account.setAway()`, `account.setMaxOfferDiscount()`, `account.updateTradeUrl()`, `account.updateBackground()`, `account.updateUsername()`, `account.markNotificationsRead()`, `account.setMobileStatus()` |
 | Inventory | implemented | `inventory.getInventory()` |
 | Public users | implemented | `users.getUser()` |
 | User stall | implemented | `stall.getStall()`, `stall.iterateStall()` |
 | Listings | implemented | `listings.getListings()`, `listings.getPriceList()`, `listings.iterateListings()`, `listings.getListingById()`, `listings.getBids()`, `listings.placeBid()`, `listings.getBuyOrders()`, `listings.getSimilar()`, `listings.buyNow()`, `listings.buyListing()`, `listings.addToWatchlist()`, `listings.removeFromWatchlist()` |
-| Listing mutations | implemented | `listings.createListing()`, `listings.createBuyNowListing()`, `listings.createAuctionListing()`, `listings.createBulkListings()`, `listings.updateBulkListings()`, `listings.deleteBulkListings()`, `listings.unlistBulkListings()`, `listings.updateListing()`, `listings.updateListingPrice()`, `listings.updateListingDescription()`, `listings.updateListingMaxOfferDiscount()`, `listings.updateListingPrivate()`, `listings.deleteListing()`, `listings.unlistListing()`, `listings.addToWatchlist()`, `listings.removeFromWatchlist()`, `listings.buyNow()`, `listings.buyListing()` |
+| Listing mutations | implemented | `listings.createListing()`, `listings.createBuyNowListing()`, `listings.createAuctionListing()`, `listings.createBulkListings()`, `listings.updateBulkListings()`, `listings.deleteBulkListings()`, `listings.updateListing()`, `listings.updateListingPrice()`, `listings.updateListingDescription()`, `listings.updateListingMaxOfferDiscount()`, `listings.updateListingPrivate()`, `listings.deleteListing()`, `listings.addToWatchlist()`, `listings.removeFromWatchlist()`, `listings.buyNow()`, `listings.buyListing()` |
 | Loadout API | implemented | `loadout.getLoadouts()`, `loadout.getDiscoverLoadouts()`, `loadout.getSkinLoadouts()`, `loadout.getUserLoadouts()`, `loadout.getLoadout()`, `loadout.getFavoriteLoadouts()`, `loadout.createLoadout()`, `loadout.cloneLoadout()`, `loadout.updateLoadout()`, `loadout.deleteLoadout()`, `loadout.recommend()`, `loadout.recommendForSkin()`, `loadout.recommendStickers()`, `loadout.recommendStickersForSkin()`, `loadout.generateRecommendations()`, `loadout.favoriteLoadout()`, `loadout.unfavoriteLoadout()` |
 | History | implemented | `history.getSales()`, `history.getGraph()` |
 | Workflows | implemented | `workflows.getPublicMarketFeeds()`, `workflows.getAccountWorkspace()`, `workflows.getSingleSkinBuyOrderInsights()` |
@@ -759,9 +759,9 @@ const counter = await sdk.account.counterOffer(offer.id!, {
 
 await sdk.account.cancelOffer(counter.id!);
 
-await sdk.account.declineOffer(offer.id!);
+await sdk.account.cancelOffer(offer.id!);
 
-await sdk.account.acceptSale("950524496987687389");
+await sdk.account.acceptTrade("950524496987687389");
 
 await sdk.listings.buyListing("807440137469430127", 3);
 ```

docs/resource-reference.md

@@ -66,10 +66,8 @@ Key types:
 | `markTradesReceived(tradeIdsOrRequest)` | `Promise<CsfloatTrade[]>` | bulk buyer receipt flow | state-gated by actual Steam offer lifecycle |
 | `markTradeReceived(tradeId)` | `Promise<CsfloatTradeActionResponse>` | single buyer receipt flow | low-level single-trade route |
 | `acceptTrade(tradeId)` | `Promise<CsfloatTrade>` | accept one queued trade | seller-side single trade flow |
-| `acceptSale(tradeId)` | `Promise<CsfloatTrade>` | seller-oriented alias for `acceptTrade()` | convenience alias |
 | `cancelTrades(tradeIdsOrRequest)` | `Promise<CsfloatTradeBatchResponse>` | bulk seller cancel flow | bundle-backed route |
 | `cancelTrade(tradeId)` | `Promise<CsfloatMessageResponse>` | cancel one trade | seller-side single cancel flow |
-| `cancelSale(tradeId)` | `Promise<CsfloatMessageResponse>` | seller-oriented alias for `cancelTrade()` | convenience alias |
 | `cannotDeliverTrade(tradeId)` | `Promise<CsfloatTradeActionResponse>` | seller-side cannot-deliver flow | low-level failure path |
 | `disputeTrade(tradeId)` | `Promise<CsfloatTradeActionResponse>` | open the browser-confirmed dispute route | low-level recovery path |
 | `rollbackTrade(tradeId)` | `Promise<CsfloatTradeActionResponse>` | request rollback handling | low-level recovery path |
@@ -93,7 +91,6 @@ Write payload guide:
 | `getOfferHistory(offerId)` | `Promise<CsfloatOffer[]>` | load the offer thread history | historical offer chain |
 | `counterOffer(offerId, request)` | `Promise<CsfloatOffer>` | seller-side counter offer | request type is `CounterOfferRequest` |
 | `cancelOffer(offerId)` | `Promise<CsfloatMessageResponse>` | cancel an offer thread | close/cancel flow |
-| `declineOffer(offerId)` | `Promise<CsfloatMessageResponse>` | ergonomic alias for cancel/decline close | same route as `cancelOffer()` |
 | `getOffersTimeline(params?)` | `Promise<CsfloatOffersResponse>` | profile timeline-style offer feed | limit-focused snapshot helper |
 
 Key types:
@@ -218,14 +215,12 @@ Listing note:
 | `createBulkListings(requests)` | `Promise<CsfloatListing[]>` | bulk list multiple contracts | requires at least one item |
 | `updateBulkListings(modifications)` | `Promise<CsfloatListing[]>` | bulk edit multiple listings | currently centered on validated bulk modification semantics |
 | `deleteBulkListings(contractIds)` | `Promise<CsfloatMessageResponse>` | bulk delist multiple contracts | requires at least one contract id |
-| `unlistBulkListings(contractIds)` | `Promise<CsfloatMessageResponse>` | alias for bulk delist | convenience alias |
 | `updateListing(listingId, request)` | `Promise<CsfloatListing>` | patch one listing | low-level generic listing patch |
 | `updateListingPrice(listingId, price)` | `Promise<CsfloatListing>` | change listing price | convenience wrapper |
 | `updateListingDescription(listingId, description)` | `Promise<CsfloatListing>` | change listing description | convenience wrapper |
 | `updateListingMaxOfferDiscount(listingId, maxOfferDiscount)` | `Promise<CsfloatListing>` | change max-offer discount on a listing | convenience wrapper |
 | `updateListingPrivate(listingId, isPrivate)` | `Promise<CsfloatListing>` | toggle listing privacy | convenience wrapper |
 | `deleteListing(listingId)` | `Promise<CsfloatListing \| null>` | delist one listing | delete/unlist lifecycle step |
-| `unlistListing(listingId)` | `Promise<CsfloatListing \| null>` | alias for `deleteListing()` | convenience alias |
 
 Important validation notes:
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "csfloat-node-sdk",
-  "version": "0.9.4",
+  "version": "0.10.0",
   "description": "Live-validated Node.js / TypeScript SDK for the CSFloat API and public companion surfaces.",
   "homepage": "https://github.com/Krablante/csfloat-node-sdk",
   "repository": {

src/client.ts

@@ -2,7 +2,7 @@ import { CsfloatSdkError, type CsfloatErrorKind } from "./errors.js";
 import type { QueryParams } from "./types.js";
 import { cleanParams } from "./utils.js";
 
-const DEFAULT_USER_AGENT = "csfloat-node-sdk/0.9.4";
+const DEFAULT_USER_AGENT = "csfloat-node-sdk/0.10.0";
 const DEFAULT_MAX_RETRIES = 2;
 const DEFAULT_RETRY_DELAY_MS = 250;
 const DEFAULT_MAX_RETRY_DELAY_MS = 2_000;

src/resources/account.ts

@@ -141,10 +141,6 @@ export class AccountResource {
     return this.client.post<CsfloatTrade>(`trades/${tradeId}/accept`, {});
   }
 
-  acceptSale(tradeId: string): Promise<CsfloatTrade> {
-    return this.acceptTrade(tradeId);
-  }
-
   cancelTrades(tradeIds: string[] | AcceptTradesRequest): Promise<CsfloatTradeBatchResponse> {
     const body = Array.isArray(tradeIds)
       ? { trade_ids: tradeIds }
@@ -157,10 +153,6 @@ export class AccountResource {
     return this.client.delete<CsfloatMessageResponse>(`trades/${tradeId}`);
   }
 
-  cancelSale(tradeId: string): Promise<CsfloatMessageResponse> {
-    return this.cancelTrade(tradeId);
-  }
-
   /**
    * Low-level rollback helper for bundle-confirmed seller/buyer recovery flows.
    * Keep this conservative: route shape is stable, outcome semantics are still trade-state-specific.
@@ -216,10 +208,6 @@ export class AccountResource {
     return this.client.delete<CsfloatMessageResponse>(`offers/${offerId}`);
   }
 
-  declineOffer(offerId: string): Promise<CsfloatMessageResponse> {
-    return this.cancelOffer(offerId);
-  }
-
   getWatchlist(
     params: CsfloatWatchlistParams = {},
   ): Promise<CsfloatListingsResponse> {

src/resources/listings.ts

@@ -145,10 +145,6 @@ export class ListingsResource {
     });
   }
 
-  unlistBulkListings(contractIds: string[]): Promise<CsfloatMessageResponse> {
-    return this.deleteBulkListings(contractIds);
-  }
-
   updateListing(listingId: string, request: UpdateListingRequest): Promise<CsfloatListing> {
     return this.client.patch<CsfloatListing>(`listings/${listingId}`, request);
   }
@@ -176,10 +172,6 @@ export class ListingsResource {
     return this.client.delete<CsfloatListing | null>(`listings/${listingId}`);
   }
 
-  unlistListing(listingId: string): Promise<CsfloatListing | null> {
-    return this.deleteListing(listingId);
-  }
-
   private validateCreateListingRequest(request: CreateListingRequest): void {
     if (request.description && request.description.length > 32) {
       throw new CsfloatSdkError("description cannot be longer than 32 characters");

test/account.test.ts

@@ -177,15 +177,6 @@ describe("AccountResource", () => {
     expect(post).toHaveBeenCalledWith("trades/950524496987687389/received", {});
   });
 
-  it("accepts a sale through the single-trade alias", async () => {
-    const post = vi.fn(async (_path: string, _body: unknown) => null);
-    const resource = new AccountResource({ post } as never);
-
-    await resource.acceptSale("950524496987687389");
-
-    expect(post).toHaveBeenCalledWith("trades/950524496987687389/accept", {});
-  });
-
   it("cancels trades in bulk", async () => {
     const post = vi.fn(async (_path: string, _body: unknown) => null);
     const resource = new AccountResource({ post } as never);
@@ -206,15 +197,6 @@ describe("AccountResource", () => {
     expect(del).toHaveBeenCalledWith("trades/950524496987687389");
   });
 
-  it("cancels a sale through the single-trade alias", async () => {
-    const del = vi.fn(async (_path: string) => null);
-    const resource = new AccountResource({ delete: del } as never);
-
-    await resource.cancelSale("950524496987687389");
-
-    expect(del).toHaveBeenCalledWith("trades/950524496987687389");
-  });
-
   it("hits the low-level rollback trade route", async () => {
     const post = vi.fn(async (_path: string, _body: unknown) => null);
     const resource = new AccountResource({ post } as never);
@@ -304,15 +286,6 @@ describe("AccountResource", () => {
     expect(del).toHaveBeenCalledWith("offers/950527619626041456");
   });
 
-  it("declines an offer through the same delete route", async () => {
-    const del = vi.fn(async (_path: string) => null);
-    const resource = new AccountResource({ delete: del } as never);
-
-    await resource.declineOffer("950531563567843184");
-
-    expect(del).toHaveBeenCalledWith("offers/950531563567843184");
-  });
-
   it("requests authenticated watchlist with params", async () => {
     const get = vi.fn(async (_path: string, _params?: unknown) => null);
     const resource = new AccountResource({ get } as never);

test/client.test.ts

@@ -28,7 +28,7 @@ describe("CsfloatHttpClient", () => {
       method: "GET",
       headers: expect.objectContaining({
         Authorization: "secret",
-        "User-Agent": "csfloat-node-sdk/0.9.4",
+        "User-Agent": "csfloat-node-sdk/0.10.0",
       }),
     });
   });

test/listings.test.ts

@@ -202,20 +202,6 @@ describe("ListingsResource", () => {
     });
   });
 
-  it("aliases unlistBulkListings to the same bulk-delist route", async () => {
-    const patch = vi.fn(async (_path: string, _body?: unknown) => ({ message: "contracts delisted" }));
-    const resource = new ListingsResource({
-      ...client,
-      patch,
-    } as never);
-
-    await resource.unlistBulkListings(["a"]);
-
-    expect(patch).toHaveBeenCalledWith("listings/bulk-delist", {
-      contract_ids: ["a"],
-    });
-  });
-
   it("rejects empty bulk delist payloads", async () => {
     const resource = new ListingsResource(client);
 
@@ -411,4 +397,16 @@ describe("ListingsResource", () => {
       max_price: 9,
     });
   });
+
+  it("deletes a single listing", async () => {
+    const del = vi.fn(async (_path: string) => null);
+    const resource = new ListingsResource({
+      ...client,
+      delete: del,
+    } as never);
+
+    await resource.deleteListing("950170960026273280");
+
+    expect(del).toHaveBeenCalledWith("listings/950170960026273280");
+  });
 });