@ultimat3/storage 20.2.0 → 21.0.0

package/CLAUDE.md

@@ -273,5 +273,16 @@ Gotchas:
   `sweepOrphans` cannot be tested against it with a frozen clock — `attachment.test.ts` uses a
   stub driver with authored timestamps, and `driver-local.test.ts` proves the disk half.
 - `upload-client.ts` defaults to `XMLHttpRequest`, not `fetch`: `fetch` reports no upload
-  progress in any shipping browser, and a bar that jumps 0 → 100 is a bar that is lying.
+  progress in any shipping browser, and a bar that jumps 0 → 100 is a bar that is lying. It is
+  **the declared XHR seam** of plan 101 (decision 13): the one `XMLHttpRequest` the framework
+  ships, and the one file slice 15's `browser-transport` guard exempts for it — the header says so.
+- **`fetchSignedPut` goes through `@ultimat3/core`'s `clientTransport`** (`As of 2026-09-22`,
+  plan 101 slice 05): `rawBody` sends the `Blob` verbatim under the grant's content type with no
+  default header, and `decodeError` keeps a refusal `X_STORAGE_UPLOAD_FAILED` with the disk's
+  status. A request with no response at all is the transport's `X_CLIENT_TRANSPORT_FAILED` — it was a
+  bare `TypeError` before. This file calls no `fetch`; the XHR above is the one exemption.
+- **Bundle, `bun build --target=browser --minify`, `import { uploadFile } from '@ultimat3/storage'`**
+  (`As of 2026-09-22`): **11,822 B** at 20.2.1, **17,767 B** on `clientTransport`. The +5.9 kB is
+  core's transport graph, paid only where the chunk did not already carry it — an island that
+  also calls an action or a query already does.
 - `exactOptionalPropertyTypes` is on — declare optional fields as `x?: T | undefined`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/storage",
-  "version": "20.2.0",
+  "version": "21.0.0",
   "description": "Named disks over Bun.file and Bun.s3: safe keys, signed URLs, sniffed uploads",
   "license": "MIT",
   "type": "module",
@@ -31,6 +31,6 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "20.2.0"
+    "@ultimat3/core": "21.0.0"
   }
 }

package/src/upload-client.ts

@@ -2,10 +2,14 @@
 // bytes at it, hand back the storage key. Browser-safe by construction: no `Bun.*`, no `node:`,
 // no driver import, so this file bundles into the client the way `@ultimat3/action`'s does.
 //
-// The default transport is `XMLHttpRequest`, not `fetch`, for exactly one reason: `fetch` reports
-// no upload progress in any shipping browser, and a progress bar that jumps 0 -> 100 is a
-// progress bar that is lying. `fetch` is the fallback where XHR does not exist.
-
+// THE DECLARED XHR SEAM (plan 101, decision 13): every other browser request goes through
+// `@ultimat3/core`'s `clientTransport`, and `xhrSignedPut` below is the one `XMLHttpRequest` the
+// framework ships, for exactly one reason — `fetch` reports no upload progress in any shipping
+// browser, and a progress bar that jumps 0 -> 100 is a progress bar that is lying. This file is
+// the one path the `browser-transport` guard exempts for it. Where XHR does not exist the
+// fallback is `clientTransport` with a raw body — never a `fetch` call of this file's own.
+
+import { clientTransport } from '@ultimat3/core';
 import { tooLarge, uploadFailed } from './errors';
 import type { UploadGrant, UploadRequest } from './grant';
 
@@ -109,18 +113,23 @@ export const xhrSignedPut: SignedPut = (input) =>
     request.send(input.body);
   });
 
-/** No upload progress — `onProgress` fires once at 0 and once at 1, and says so by doing that. */
+/**
+ * No upload progress — `onProgress` fires once at 0 and once at 1, and says so by doing that.
+ * Through `clientTransport`, the one browser HTTP function: `rawBody` sends the bytes verbatim
+ * under the grant's content type and adds no header of its own (a signed request may cover them),
+ * and `decodeError` keeps a refusal this package's `X_STORAGE_UPLOAD_FAILED`, with the disk's
+ * status. A request that got no response at all is the transport's `X_CLIENT_TRANSPORT_FAILED`.
+ */
 export const fetchSignedPut: SignedPut = async (input) => {
   input.onProgress?.(progressOf(0, input.body.size));
-  const response = await fetch(input.url, {
+  await clientTransport({
     method: 'PUT',
+    url: input.url,
+    rawBody: input.body,
     headers: { 'content-type': input.contentType },
-    body: input.body,
+    decodeError: (status, text) => uploadFailed(pathOf(input.url), status, text),
     ...(input.signal === undefined ? {} : { signal: input.signal }),
   });
-  if (!response.ok) {
-    throw uploadFailed(pathOf(input.url), response.status, await response.text());
-  }
   input.onProgress?.(progressOf(input.body.size, input.body.size));
 };