Added

JavaScript SDK 2026.9.2 beta

The Nomad Media JavaScript SDK 2026.9 is available as a beta, the first release since 1.1.28
(@nomad-media/full) and 1.1.16 (@nomad-media/public). It is published under the beta tag, so a normal
npm install does not pick it up:

npm install @nomad-media/full@beta
npm install @nomad-media/public@beta

Versions now follow the API: YYYY.M.patch.

Upgrade notes (breaking)

  • Failed requests throw an Error (with .status and .cause) instead of logging and returning null.
  • Timed-out writes (POST, PUT, PATCH, DELETE) are not retried. Timed-out GETs are still retried up to 3 times.
  • uploadAsset and uploadRelatedAsset throw on failure instead of returning undefined.
  • bulkUpdateMetadata throws before sending when it has nothing to change.
  • Node.js 18 or later is required.
  • ping, updateSavedSearch and updateAssetScheduleEvent changed their arguments. See the
    CHANGELOG on GitHub.

Added

  • Faster, safer multipart uploads: maxWorkers, partConfirmation, onProgress and reportProgress options.
  • Transfers and the asset queue: addUploadsToQueue, addDownloadsToQueue, getTransfers,
    getTransfersSummary, getTransfer, updateTransfer, cancelTransfer, requeueTransfer,
    deleteTransfers, clearTransferHistory and reapStaleUploads.
  • autoClipAsset, recordLiveChannelFromHlsArtifacts and deleteContentDefinition.

Fixed

  • getAssetChildNodes threw on every call.
  • createAssetAdBreak and createAnnotation overwrote the asset's previous record instead of adding a new one.
  • getTransfers ignored its status filter.
  • Many requests the API ignored or rejected now send the right fields.

Known issues

  • copyAsset with more than one asset id fails. Copy assets one at a time.
  • updateShare fails on a share created with only SHARED_DURATION_IN_HOURS.
  • reapStaleUploads returns a count, not a summary object.
  • The API accepts createAnnotation for an asset id that does not exist. Check the asset first.
  • duplicateAsset fails on deployments that lack the duplicate route.

The full, method-by-method list is in the
CHANGELOG on GitHub.