@stowage/adapter-memory 0.1.0 → 0.2.0

package/README.md

@@ -26,21 +26,21 @@ console.log(object.stat.contentType, object.stat.userMetadata, await object.text
 
 ## Runtimes
 
-Node 24 and later, Bun, Deno and `workerd` at the compatibility date `2026-09-01`. CI last ran green on Bun 1.4.2 and Deno 2.9.6.
+Node 24 and later, Bun, Deno and `workerd` at the compatibility date `2026-09-01` without Node APIs. CI last ran green on Bun 1.4.2 and Deno 2.9.6.
 
-The bundle measures 3.3 kB minified and gzipped, `@stowage/core` included.
+The bundle measures 3.6 kB minified and gzipped, `@stowage/core` included.
 
 ## Limits
 
 - `presignedUrls` is not declared: `MemoryStorage` has neither `presignGet` nor `presignPut`
-  ([spec 4.9](https://github.com/stowage-js/stowage/blob/@stowage/adapter-memory@0.1.0/docs/spec.md#49-capabilities)).
+  ([spec 4.9](https://github.com/stowage-js/stowage/blob/@stowage/adapter-memory@0.2.0/docs/spec.md#49-capabilities)).
 - Every object is held whole in memory, with no size limit of its own, so memory grows with what
-  the storage holds ([spec 5](https://github.com/stowage-js/stowage/blob/@stowage/adapter-memory@0.1.0/docs/spec.md#5-stowageadapter-memory)).
+  the storage holds ([spec 5](https://github.com/stowage-js/stowage/blob/@stowage/adapter-memory@0.2.0/docs/spec.md#5-stowageadapter-memory)).
 
 ## Notes
 
 `put` takes no `Blob`. A caller holding one passes its stream
-([spec 4.2](https://github.com/stowage-js/stowage/blob/@stowage/adapter-memory@0.1.0/docs/spec.md#42-bodies)):
+([spec 4.2](https://github.com/stowage-js/stowage/blob/@stowage/adapter-memory@0.2.0/docs/spec.md#42-bodies)):
 
 ```ts
 import { memoryStorage } from "@stowage/adapter-memory";
@@ -52,7 +52,7 @@ await storage.put("report.csv", blob.stream(), { contentType: blob.type });
 ```
 
 stowage reports no progress
-([spec 11](https://github.com/stowage-js/stowage/blob/@stowage/adapter-memory@0.1.0/docs/spec.md#11-non-goals)).
+([spec 12](https://github.com/stowage-js/stowage/blob/@stowage/adapter-memory@0.2.0/docs/spec.md#12-non-goals)).
 A caller who wants it counts the bytes on their way into `put`:
 
 ```ts
@@ -81,10 +81,10 @@ await storage.put("fixture.json", response.body.pipeThrough(countBytes(console.l
 
 ## Specification
 
-[`docs/spec.md` at `@stowage/adapter-memory@0.1.0`](https://github.com/stowage-js/stowage/blob/@stowage/adapter-memory@0.1.0/docs/spec.md#5-stowageadapter-memory)
+[`docs/spec.md` at `@stowage/adapter-memory@0.2.0`](https://github.com/stowage-js/stowage/blob/@stowage/adapter-memory@0.2.0/docs/spec.md#5-stowageadapter-memory)
 is the contract: a caller may rely on what it states and on nothing else this package happens to
-export. The [terms it uses](https://github.com/stowage-js/stowage/blob/@stowage/adapter-memory@0.1.0/CONTEXT.md)
-and the [decisions behind it](https://github.com/stowage-js/stowage/tree/@stowage/adapter-memory@0.1.0/docs/adr)
+export. The [terms it uses](https://github.com/stowage-js/stowage/blob/@stowage/adapter-memory@0.2.0/CONTEXT.md)
+and the [decisions behind it](https://github.com/stowage-js/stowage/tree/@stowage/adapter-memory@0.2.0/docs/adr)
 are at the same tag.
 
 ## License

package/dist/index.js

@@ -1,4 +1,4 @@
-import { StorageError, invalidKeyReason } from "@stowage/core";
+import { StorageError, checkUserMetadata, invalidKeyReason, lastByteOf, rangeBoundsRefusal, rangeStartRefusal } from "@stowage/core";
 //#region src/bytes.ts
 async function readBody(body, signal) {
 	if (isStream(body)) return await readStream(body, signal);
@@ -210,25 +210,24 @@ function pseudoDirectoryOf(key, { prefix, delimiter }) {
 //#region src/range.ts
 /** Refuses bounds the spec does not allow, before the key is looked up (spec 4.3). */
 function requireRange(range) {
-	if (range === void 0) return;
-	const { start, end } = range;
-	if (!isOffset(start) || end !== void 0 && (!isOffset(end) || end < start)) throw optionError("range", "takes two whole numbers from zero up, `start` at most `end`", "get");
+	const refusal = rangeBoundsRefusal(range);
+	if (refusal !== void 0) throw memoryError({
+		...refusal,
+		operation: "get",
+		attempts: 0
+	});
 }
 /** The bytes the range names, both ends inclusive, clipped to what the object holds. */
 function sliceRange(bytes, range, key) {
 	if (range === void 0) return bytes;
-	if (range.start >= bytes.byteLength) throw memoryError({
-		code: "InvalidRequest",
-		message: `The range starts beyond the ${bytes.byteLength} bytes under the key ${JSON.stringify(key)}`,
+	const refusal = rangeStartRefusal(range, bytes.byteLength, key);
+	if (refusal !== void 0) throw memoryError({
+		...refusal,
 		operation: "get",
 		key,
 		attempts: 1
 	});
-	const end = Math.min(range.end ?? bytes.byteLength - 1, bytes.byteLength - 1);
-	return bytes.subarray(range.start, end + 1);
-}
-function isOffset(value) {
-	return Number.isInteger(value) && value >= 0;
+	return bytes.subarray(range.start, lastByteOf(range, bytes.byteLength) + 1);
 }
 //#endregion
 //#region src/stored-object.ts
@@ -275,44 +274,20 @@ function createStoredObject(stat, bytes) {
 }
 //#endregion
 //#region src/user-metadata.ts
-/** Spec 4.3 bounds the set at 2 KB of the header bytes it costs once it is encoded. */
-const headerByteLimit = 2048;
-/** The characters RFC 9110 allows in a field name, which is what a metadata key is. */
-const httpToken = /^[!#$%&'*+.^_`|~\dA-Za-z-]+$/;
-/** What travels in a header field as it stands, so it costs one byte per character. */
-const printableAscii = /^[\x20-\x7e]*$/;
-/** `=?UTF-8?B?` and the `?=` that closes it. */
-const encodedWordOverhead = 12;
-const utf8 = new TextEncoder();
 /**
 * The metadata as it is held: keys folded to lower case, as a header field name is.
-* Rejects with `InvalidRequest` before anything is written (spec 4.3).
+* Rejects before anything is written, in the order of spec 4.3, which reads the refusals
+* off what the storage declares.
 */
-function readUserMetadata(userMetadata, key) {
-	const held = Object.create(null);
-	let headerBytes = 0;
-	for (const [name, value] of Object.entries(userMetadata ?? {})) {
-		if (!httpToken.test(name)) throw refusal(`The user metadata key ${JSON.stringify(name)} is no ASCII HTTP token`, key);
-		const folded = name.toLowerCase();
-		if (folded in held) throw refusal(`The user metadata key ${JSON.stringify(folded)} is given more than once`, key);
-		held[folded] = value;
-		headerBytes += folded.length + encodedValueBytes(value);
-	}
-	if (headerBytes > headerByteLimit) throw refusal(`The user metadata is ${headerBytes} encoded header bytes, above the limit of ${headerByteLimit}`, key);
-	return Object.freeze(held);
-}
-function encodedValueBytes(value) {
-	if (printableAscii.test(value)) return value.length;
-	return encodedWordOverhead + 4 * Math.ceil(utf8.encode(value).length / 3);
-}
-function refusal(message, key) {
-	return memoryError({
-		code: "InvalidRequest",
-		message,
+function readUserMetadata(userMetadata, key, capabilities) {
+	const check = checkUserMetadata(userMetadata, capabilities);
+	if ("refusal" in check) throw memoryError({
+		...check.refusal,
 		operation: "put",
 		key,
 		attempts: 0
 	});
+	return check.held;
 }
 //#endregion
 //#region src/index.ts
@@ -323,7 +298,8 @@ const defaultContentType = "application/octet-stream";
 const memoryCapabilities = Object.freeze([
 	"keyBytesPreserved",
 	"rangeReads",
-	"userMetadata"
+	"userMetadata",
+	"userMetadataTokenKeys"
 ]);
 var InMemoryStorage = class {
 	provider = "memory";
@@ -353,7 +329,7 @@ var InMemoryStorage = class {
 		try {
 			requireKey(key, "writable", "put");
 			requireKnownOptions(options, putOptionKeys, "put");
-			return readUserMetadata(options?.userMetadata, key);
+			return readUserMetadata(options?.userMetadata, key, this.capabilities);
 		} catch (refusal) {
 			try {
 				await cancelBody(body, refusal);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stowage/adapter-memory",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "stowage adapter holding a storage in process memory, and the implementation a third-party adapter is read against.",
   "keywords": [
     "adapter",
@@ -33,7 +33,7 @@
     "provenance": true
   },
   "dependencies": {
-    "@stowage/core": "^0.1.0"
+    "@stowage/core": "^0.2.0"
   },
   "engines": {
     "node": ">=24"