@@ -1,5 +1,21 @@
 # @opensea/cli
 
+## 2.10.0
+
+### Minor Changes
+
+- 07d0bdc: Add `opensea drops upload-items <slug> <dir> [--manifest <path>] [--concurrency <n>]`, which uploads a folder of item media and saves it as the drop's items in one upload batch: it generates one batch id, requests upload contexts 50 files at a time with it, uploads each chunk, then saves the batch by filename. Without a manifest, items are numbered in natural filename order (`2.png` before `10.png`); hidden files, subfolders and `.csv` files are skipped, and a symlink in the folder is refused rather than followed. Add `opensea drops save-item-media-batch <slug>` (`--body <path>`, or `--upload-batch-id <uuid> --dir <path>` to re-save a folder that is already uploaded) and `create-item-media-upload --upload-batch-id <uuid>`. `save-item-media`, which saves by media token, is deprecated.
+
+  The programmatic `DropsAPI` gains `createItemMediaUpload`, `saveItemMediaBatch` and `uploadItemMedia(slug, files, options)`, the helper behind `upload-items`. Each file's `data` can be a function so a large drop is read one file at a time.
+
+### Patch Changes
+
+- Updated dependencies [bab8feb]
+- Updated dependencies [07d0bdc]
+- Updated dependencies [07d0bdc]
+  - @opensea/api-types@0.15.0
+  - @opensea/sdk@12.11.0
+
 ## 2.9.1
 
 ### Patch Changes
 
@@ -208,6 +208,10 @@ opensea drops upload-metadata-ipfs <slug> [--wait] [--interval <seconds>] [--wai
 opensea drops metadata-ipfs-status <slug> <workflow-execution-id>
 opensea drops create-manifest-upload <slug>
 opensea drops upload-file --context <path|-> --file <path> [--index <n>]
+opensea drops upload-items <slug> <dir> [--manifest <path>] [--concurrency <n>]
+opensea drops create-item-media-upload <slug> --body <path> [--upload-batch-id <uuid>]
+opensea drops save-item-media-batch <slug> (--body <path> | --upload-batch-id <uuid> --dir <path>)
+opensea drops save-item-media <slug> --body <path>
 ```
 
 `publish` and `unpublish` print a ready-to-sign transaction. With `--send`
@@ -236,6 +240,35 @@ The upload URL and fields are short-lived credentials, so avoid saving the
 context to a shared location. `upload-file` refuses a context whose `url` is
 not HTTPS.
 
+`upload-items` saves a folder of item media as the drop's items, replacing any
+it already has. It generates one upload batch id, requests upload contexts 50
+files at a time with that id, uploads each chunk (`--concurrency` files at
+once, default 4), then saves the whole batch by filename. With `--manifest`, it
+uploads the manifest CSV first and the save takes token ids and metadata from
+it. Without one, items are numbered 1 to n in natural filename order, so
+`2.png` comes before `10.png`. Hidden files, subfolders and `.csv` files in the
+folder are skipped, and a symlink fails the command before anything is sent,
+since item media is published on a public CDN. Progress goes to stderr, and the result is
+`{"upload_batch_id": ..., "item_count": ..., "success": true}`:
+
+```bash
+opensea drops upload-items my-drop ./media --manifest manifest.csv
+```
+
+If every file uploads but the save fails, for example because the manifest
+names a file that is not in the folder, fix the cause and save the same batch
+again without re-uploading:
+
+```bash
+opensea drops save-item-media-batch my-drop --upload-batch-id <uuid> --dir ./media
+```
+
+To run the steps yourself, pass one `--upload-batch-id` (a UUID you generate
+per set of files) to every `create-item-media-upload` request, upload each
+context with `upload-file`, then run `save-item-media-batch` with a body of
+`{"upload_batch_id": "<uuid>", "filenames": [...]}` (up to 15,000 filenames).
+`save-item-media`, which saves by media token, is deprecated.
+
 ## Transactions
 
 ```bash
 
@@ -132,6 +132,36 @@ await uploadToContext(context, new Blob([csvBytes]), {
 })
 ```
 
+`uploadItemMedia` saves a set of item media files as the drop's items, replacing
+any it already has. It puts every file in one upload batch (a new UUID unless
+you pass `uploadBatchId`), requests upload contexts 50 files at a time and
+uploads each chunk before requesting the next, then saves the batch by filename
+with `saveItemMediaBatch`. Without a manifest, items are numbered 1 to n in the
+order of `files`. A file's `data` can be a function, so a large drop is read one
+file at a time:
+
+```typescript
+import { readFile } from "node:fs/promises"
+
+const result = await creator.drops.uploadItemMedia(
+  "my-drop",
+  ["1.png", "2.png"].map(filename => ({
+    filename,
+    data: async () =>
+      new Blob([new Uint8Array(await readFile(`media/${filename}`))]),
+  })),
+  {
+    manifest: { filename: "manifest.csv", data: new Blob([csvBytes]) },
+    onProgress: ({ uploaded, total }) => console.error(`${uploaded}/${total}`),
+  },
+)
+// { upload_batch_id: "...", item_count: 2, success: true }
+```
+
+For the steps one at a time, pass one `upload_batch_id` to every
+`createItemMediaUpload` call, upload each context with `uploadToContext`, then
+call `saveItemMediaBatch("my-drop", { upload_batch_id, filenames })`.
+
 ## Events
 
 ```typescript
 
@@ -1,6 +1,6 @@
 {
   "name": "@opensea/cli",
-  "version": "2.9.1",
+  "version": "2.10.0",
   "type": "module",
   "description": "OpenSea CLI - Query the OpenSea API from the command line or programmatically",
   "main": "dist/index.js",
@@ -23,8 +23,8 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@opensea/api-types": "^0.14.2",
-    "@opensea/sdk": "^12.10.2",
+    "@opensea/api-types": "^0.15.0",
+    "@opensea/sdk": "^12.11.0",
     "@opensea/wallet-adapters": "^1.2.1",
     "commander": "^14.0.3",
     "zod": "^4.3.6"