v0.9.51

Changed

1. replaced the primary meta.inspectItem() path for current masked/protobuf inspect links with local decoding via the official lightweight @csfloat/cs2-inspect-serializer package, while keeping legacy unmasked inspect links on the historical fallback path
2. widened account.getBuyOrdersForInspect() to match the current live /buy-orders/item contract, which now expects market_hash_name and sig alongside the inspect url
3. refreshed the live audit scripts and coverage notes so inspect buy-order probes now reuse listing.item.serialized_inspect ?? listing.item.inspect_link together with listing.item.market_hash_name plus listing.item.gs_sig, and masked inspect-link checks no longer depend on the dead api.csfloat.com host
4. updated the SDK docs and docs-site content to reflect the current split: masked inspect links decode locally, legacy inspect-companion fallback remains degraded, and inspect buy-order lookup is live again when called with the full listing-derived query contract

v0.9.5 - API surface cleanup and canonical naming pass

v0.9.5 is a cleanup release focused on reducing exact public API duplication and making the SDK surface more consistent.

This release does not add new endpoint coverage. Instead, it removes five 1:1 aliases that duplicated existing behavior and keeps one canonical name for each operation.

Changed

• standardized the canonical trade naming surface around:
  • account.acceptTrade()
  • account.cancelTrade()
• standardized the canonical offer naming surface around:
  • account.cancelOffer()
• standardized the canonical listing mutation naming surface around:
  • listings.deleteBulkListings()
  • listings.deleteListing()

Removed

The following exact alias duplicates were removed:

• account.acceptSale()
• account.cancelSale()
• account.declineOffer()
• listings.unlistBulkListings()
• listings.unlistListing()

Why this matters

These methods were 1:1 aliases over the same underlying routes and behavior.

Removing them makes the SDK easier to understand, reduces naming ambiguity, and keeps the public surface smaller and more coherent without reducing actual endpoint coverage.

Documentation

The package docs and docs site were updated to match the cleaned surface, including:

• README examples
• resource reference
• changelog
• synced docs-site content

Verification

This release passed:

• npm run release:check
• website npm run build
• git diff --check

v0.9.4 - docs site, lower-level trade/account coverage, and response-shape hardening

v0.9.4 is the cumulative public release after v0.9.3.

This release pushes csfloat-node-sdk forward in three practical areas:

1. a real public docs site on top of the repository docs
2. broader low-level coverage for browser-confirmed account and trade routes
3. a slower, wider live response-shape audit that hardened the current type surface

Added since v0.9.3

• a public docs site at:
  • https://csfloat-node-sdk.vercel.app
• low-level trade lifecycle helpers:
  • account.cannotDeliverTrade()
  • account.disputeTrade()
  • account.markTradeReceived()
  • account.rollbackTrade()
  • account.manualVerifyTrade()
  • account.verifyTradeRollback()
• low-level account verification helpers:
  • account.verifyEmail()
  • account.verifySms()

Changed since v0.9.3

• widened account.syncSteamNewOffer() and CsfloatTradeSteamStatusNewOfferRequest to support the currently observed frontend payload, including:
  • given_asset_ids
  • received_asset_ids
• reconciled stale coverage/docs claims where the SDK already supported the route or param surface:
  • filter=sticker_combos
  • filter=unique
  • PATCH /me with trade_url
• promoted browser-confirmed single-trade routes from discovered-only to implemented, while keeping them documented as low-level and state-gated
• ran a slower live response-shape audit across the safe supported surface and widened typing where real payloads justified it:
  • CsfloatNotificationsResponse.latest_notification_id
  • CsfloatInspectBuyOrder.market_hash_name
  • CsfloatKeychain.highlight_reel
• strengthened audit:shapes with:
  • slower default pacing
  • retry after 429
  • token-helper coverage
  • better inspect-link selection for checker and inspect-linked buy-order probes
• expanded and synchronized package docs plus docs-site content so runtime reference, write payloads, stability notes, and low-level helper guidance stay aligned
• refined the docs-site UI and repository README so the public-facing documentation layer is much easier to navigate

Verification

This release passed:

• npm run release:check
• website npm run build
• git diff --check

Notes

Some live shape areas remain naturally sparse because of current account state, not because the SDK is broken. Examples include:

• auto-bids
• pending deposits
• pending withdrawals
• watchlist
• active buy orders
• loadout favorites
• sampled auction bids

Those were intentionally not forced through risky live mutations just to inflate coverage claims.

v0.9.3 - final docs polish and write-flow coverage

v0.9.3 is a follow-up documentation release on top of v0.9.2.

This release focuses on making the SDK documentation much closer to a complete user-facing system instead of a surface map plus source-discoverable details.

Changed

• added a dedicated Write Flows And Payloads guide for mutation-heavy SDK usage
• documented minimal valid payloads, field meanings, and caveats for:
  • offers
  • trades and Steam sync helpers
  • buy orders
  • listings and bids
  • account preference updates
  • loadout CRUD and recommendation flows
• expanded recipes with copyable write-oriented examples instead of only read-heavy examples
• improved npm-first CLI guidance in the README and docs
• linked the new write/payload guide from the docs hub, getting started flow, and resource reference

Why this matters

The SDK surface was already strong, but some advanced users still had to fall back to .d.ts files or source to understand common mutation payloads.

v0.9.3 reduces that gap and makes the docs much closer to a nearly complete user-facing reference.

Verification

This release passed:

• npm test
• npm run check
• npm run check:node
• npm run build
• npm run cli:help
• npm pack --dry-run
• npm run release:check

Commit

• a130d61 docs: finalize docs for 0.9.3

v0.9.2 - post-0.9.0 polish, transport visibility, and full documentation overhaul

v0.9.2 is the cumulative public release after v0.9.0 from March 8, 2026, bundling all follow-up improvements shipped since that release.

This release builds on the broader workflow-first SDK surface introduced in v0.9.0 and focuses on two follow-up goals:

1. better low-level transport visibility for advanced users and bot/runtime operators
2. a much more complete documentation system for both GitHub and npm users

Added since v0.9.0

• opt-in low-level response metadata via:
  • client.getWithMetadata()
  • client.postWithMetadata()
  • client.patchWithMetadata()
  • client.putWithMetadata()
  • client.deleteWithMetadata()
• parsed rate-limit metadata on low-level responses, including:
  • limit
  • remaining
  • resetAt
  • retryAfterMs
  • suggestedWaitMs
• low-level account.acceptOffer() helper for the browser-observed POST /offers/{id}/accept route
• listing mutation convenience helpers:
  • listings.updateListingPrice()
  • listings.updateListingDescription()
  • listings.updateListingMaxOfferDiscount()
  • listings.updateListingPrivate()
• a full documentation expansion under docs/, including:
  • Documentation Hub
  • Getting Started
  • Resources, Workflows, And Surface Map
  • Resource Reference
  • Helpers, Builders, And Constants
  • Workflows And CLI
  • Transport, Errors, And Metadata
  • Examples And Recipes
  • Stability And Coverage

Improved since v0.9.0

• README navigation now sends users to the right docs faster instead of relying on one oversized landing page
• package publishing now includes docs/, so npm users get structured documentation inside the published tarball
• CLI usage is documented for both source-based and npm-installed flows
• the helper/builder/constant surface is now documented as first-class public API, not just source-discoverable exports
• direct CsfloatHttpClient usage, derive(), and the SDK error model are now documented as first-class advanced surface

Why this matters

v0.9.0 made the SDK broader and more workflow-first.

v0.9.2 makes that broader SDK easier to operate and easier to learn:

• better visibility for advanced users who need response and rate-limit context
• much better onboarding for GitHub and npm users
• less friction moving from install -> first request -> real workflows
• clearer documentation for the parts of the package that were previously only obvious from source

Verification

This release passed:

• npm test
• npm run check
• npm run check:node
• npm run build
• npm run cli:help
• npm pack --dry-run
• npm run release:check

Commits included after v0.9.0

• 13ad239 docs: highlight npm package in readme
• a5e9cca sdk: release 0.9.1 polish
• 66cce8f docs: update docs for 0.9.1.5
• a417070 docs: overhaul docs for 0.9.2

v0.9.0 - workflow-first DX, market expansion, and release-quality polish

v0.9.0 is the next major public step for csfloat-node-sdk, bundling the full range of changes since v0.7.0.

This release pushes the project beyond a broad API wrapper into a more complete, workflow-first SDK: stronger market/watchlist/stall coverage, deeper loadout companion support, expression-backed buy-order tooling, safer bot/runtime defaults, publishable examples, and a small built-in CLI.

Added in v0.9.0

• workflow-first helpers via sdk.workflows:
  • getPublicMarketFeeds()
  • getAccountWorkspace()
  • getSingleSkinBuyOrderInsights()
• built-in CLI with:
  • feeds
  • workspace
  • buy-order-similar
• expression-backed buy-order DX:
  • CsfloatBuyOrderExpressionBuilder
  • buildExpressionBuyOrderRequest()
  • buildSingleSkinBuyOrderExpression()
  • buildSingleSkinBuyOrderRequest()
• stronger market/search helper layer:
  • homepage feed presets
  • exact public /search bootstrap helper
  • collection / rarity / paint-seed / music-kit builders
  • sticker / keychain / custom-sticker helpers
  • reference-quantity helper for Exclude Rare Items
• expanded watchlist and stall ergonomics:
  • richer typed filters
  • account.iterateWatchlist()
  • stall.iterateStall()
• deeper loadout companion helpers:
  • discover helpers
  • skin-scoped search helpers
  • recommendation/generate request builders
  • single-skin recommendation convenience helpers
• additional live-confirmed account/meta helpers:
  • meta.getApp()
  • meta.getSchemaBrowse()
  • meta.getItemExampleScreenshot()
  • meta.inspectItem()
  • account.getPendingDeposits()
  • account.createGsInspectToken()
  • account.syncSteamNewOffer()
  • account.syncSteamOffers()
• bulk listing support:
  • createBulkListings()
  • updateBulkListings()
  • deleteBulkListings()
  • unlistBulkListings()
• new publishable examples, including the workflow layer end-to-end

Improved in v0.9.0

• stronger README positioning and onboarding for serious CSFloat automation users
• safer transport/runtime behavior with optional minRequestDelayMs client pacing for bots and long-running scanners
• stronger release discipline:
  • release:check
  • CLI validation in the release gate
  • better npm metadata
  • examples shipped in the package tarball
• stronger live audit coverage for market, watchlist, stall, loadout companion, app/meta, checker, and expression-backed buy-order workflows
• tighter docs around public vs auth-gated market behavior, especially homepage feeds and unauthenticated /search bootstrap semantics
• tighter, more honest coverage notes where backend behavior is accepted but still only partially mapped

Notes

• this release intentionally favors practical, live-confirmed workflows over speculative hidden-surface claims
• account/report/KYC/support/FloatDB-style excluded surfaces were not promoted into the public SDK
• the package is now substantially stronger on DX than thin wrappers: coverage breadth, examples, workflow helpers, CLI, audit discipline, and safer runtime defaults all moved forward together

v0.7.0 - loadout, auction, trade, and account workflow expansion

Seventh public release of csfloat-node-sdk.

This release bundles the full set of changes since v0.6.0, including auction helpers, expanded loadout companion support, deeper trade/account coverage, and a small set of practical payout/export utilities.

Added in v0.7.0

• listings.placeBid() for the live-confirmed auction max-price route POST /listings/{id}/bid
• account.deleteAutoBid() for the live-confirmed auto-bid removal route DELETE /me/auto-bids/{id}
• major loadout companion expansion:
  • loadout.recommend()
  • loadout.getLoadouts()
  • loadout.favoriteLoadout()
  • loadout.unfavoriteLoadout()
  • loadout.createLoadout()
  • loadout.updateLoadout()
  • loadout.deleteLoadout()
  • loadout.getFavoriteLoadouts()
  • loadout.recommendStickers()
  • loadout.generateRecommendations()
  • loadout.cloneLoadout()
• deeper trade helpers:
  • account.cancelTrades()
  • account.cancelTrade()
  • account.cancelSale()
  • account.getTrade()
  • account.getTradeBuyerDetails()
  • account.markTradesReceived()
• buy-order and notary additions:
  • account.getSimilarBuyOrders()
  • account.getBuyOrdersForInspect()
  • meta.getNotary()
  • account.createNotaryToken()
• new account utilities:
  • account.exportTransactions()
  • account.getMaxWithdrawable()
  • account.getPendingWithdrawals()
  • account.deletePendingWithdrawal()
  • account.getExtensionStatus()

Improved in v0.7.0

• expanded browser-auth and live-validated auction coverage, including bid history and auto-bid behavior
• improved trade typing and documentation around real queued/pending trade samples
• promoted real, stable trade detail routes into implemented SDK surface
• expanded loadout typings and query param coverage based on live companion API behavior
• improved buy-order insight coverage and inspect-link support
• clarified that the profile Earnings UI is derived from GET /me account statistics rather than a separate earnings endpoint
• synchronized README, changelog, public exports, tests, and coverage docs with the current SDK surface

Notes

• GET /me/transactions/export is now live-validated; full past months work, while current-month export returned 400 full month must be in the past
• browser-auth discovery continued to feed stable SDK additions, but weakly mapped or risky routes were kept documented instead of over-promoted
• KYC/support surfaces were intentionally left out of this release to keep public claims tight

v0.6.0 - practical workflow expansion and browser-auth discovery

Sixth public release of csfloat-node-sdk.

Added in v0.6.0

• practical write workflow coverage for offers, buy-now purchases, seller-side sale acceptance, and buy-order updates
• public listings.getPriceList() support for the market-wide /listings/price-list index
• normalized CsfloatSdkError taxonomy with kind, retryable, and apiMessage
• account.createRecommenderToken() for the browser-observed POST /me/recommender-token flow
• loadout.getUserLoadouts() and loadout.getLoadout() for the public loadout-api.csfloat.com companion API

Improved in v0.6.0

• richer account.getTrades() typing with support for state, role, and page
• stronger README positioning and examples reflecting the current practical SDK surface
• expanded browser-auth coverage notes for profile, offers, trades, stall, withdraw, and loadout flows
• safer and more useful live audit coverage for public and authenticated companion endpoints

Notes

• this release significantly expands the SDK beyond read-only coverage into practical market and account workflows
• browser-auth discovery is now contributing stable, implemented surface where behavior proved consistent
• stale or partially mapped routes remain documented honestly instead of being over-promoted

v0.5.0 - stronger SDK surface and live shape coverage

Fifth public release of csfloat-node-sdk.

Added in v0.5.0

• first-class market query helpers for category, wear, float, price, fade, and blue ranges
• schema lookup helpers for collections, rarities, weapons, paints, music kits, and highlight reels
• built-in retry and backoff support for safe GET requests on transient failures
• deep live response-shape audit tooling for inspecting full server payloads across supported endpoints
• direct offer helpers via account.getOffer(id) and account.getOfferHistory(id)

Improved in v0.5.0

• hardened client response parsing so plain-text server errors preserve status and details
• expanded live-confirmed typing for account data, transactions, offers, buy orders, and schema entities
• improved public documentation and examples for market helpers, schema helpers, retries, and live audits

Notes

• GET /offers/{id}/history is now confirmed live and supported
• offer coverage was finalized using live buyer-offer and seller counter-offer samples
• this release focuses on strengthening the existing SDK surface and observed response accuracy

v0.4.5 - patch release and safer live audit

Patch release for csfloat-node-sdk.

Fixed in v0.4.5

• added live-confirmed background_url and username support for PATCH /me
• exposed account.updateBackground() and account.updateUsername() helpers
• documented additional silently-ignored /listings params including sticker, page, user_id, source, and is_commodity
• documented additional hard-rejected and confirmed-dead routes discovered during the latest research pass
• made the live audit safer by pacing requests and moving the riskiest probes behind an explicit ALLOW_RISKY_PROBES=1 flag

Notes

• the default audit:live flow is now safer for repeat runs and no longer includes the most rate-limit-prone probe by default
• release 0.4.5 focuses on correctness, safer validation, and small authenticated account-surface improvements rather than a broad SDK expansion