@nwire/storage-s3 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Gefter / 200apps Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# @nwire/storage-s3
+
+> S3-compatible adapter for `@nwire/storage` — AWS S3, MinIO, R2, B2, Spaces, Wasabi.
+
+## What it does
+
+A thin shim over `@aws-sdk/client-s3` that satisfies the `@nwire/storage` `Storage` contract. Translates calls to S3 commands, maps NotFound to `StorageObjectNotFoundError`, uses `@aws-sdk/s3-request-presigner` for `url()`, and ships a `healthCheck` that calls `HeadBucket` (fast, cheap, exact).
+
+## Install
+
+```bash
+pnpm add @nwire/storage-s3 @nwire/storage @aws-sdk/client-s3 @aws-sdk/s3-request-presigner
+```
+
+## Quick start
+
+```ts
+import { s3Storage } from "@nwire/storage-s3";
+import { storagePlugin } from "@nwire/storage";
+import { defineApp } from "@nwire/forge";
+
+const storage = s3Storage({
+  bucket: "uploads",
+  region: "us-east-1",
+  // For MinIO:
+  // endpoint: "http://localhost:9000",
+  // forcePathStyle: true,
+  // credentials: { accessKeyId: "minioadmin", secretAccessKey: "minioadmin" },
+});
+
+defineApp("my-app", { plugins: [storagePlugin({ storage })] });
+```
+
+## API surface
+
+- `s3Storage({ bucket, region, endpoint?, forcePathStyle?, credentials? })` — implements `Storage`.
+
+## When to use
+
+Anything multi-node or production. `nwire infra up` boots MinIO locally at `:9000` so the same adapter covers dev + prod. Fits L3 and up.
+
+## Standalone use
+
+For developers using `@nwire/storage-s3` **without the rest of Nwire** — pair it with any TypeScript project, any container, any HTTP framework.
+
+```ts
+// See the package's main entry (src/) for the standalone surface.
+// The exports below work without @nwire/app or @nwire/forge.
+import {} from /* ...standalone exports... */ "@nwire/storage-s3";
+```
+
+## Within nwire-app
+
+For developers using this package as part of the Nwire stack — register it via `app.use(...)` or it auto-wires when you compose `createApp({ modules })`.
+
+```ts
+import { createApp } from "@nwire/forge";
+
+const app = createApp({
+  /* ...config... */
+});
+// Adapter/plugin wiring happens here when applicable.
+```
+
+## See also
+
+- [Architecture sketch §05 — Adapters tier](../../architecture-sketch.html#packages)
+- Sibling packages: [@nwire/storage](../nwire-storage), [@nwire/storage-fs](../nwire-storage-fs)

package/dist/__tests__/storage-s3.integration.test.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Integration test — exercises `@nwire/storage-s3` against real MinIO.
+ *
+ * MinIO + the `nwire-dev` bucket come from the workspace docker-compose
+ * (`nwire infra up` or `docker compose up -d minio minio-bootstrap`).
+ * When MinIO isn't reachable on `127.0.0.1:9000`, the whole suite skips
+ * cleanly — the default `pnpm vitest run` stays fast and self-contained,
+ * and CI gets a deterministic skip rather than a flaky failure.
+ *
+ * Why exercise MinIO instead of trusting the unit tests:
+ *
+ *   - Presigned URLs (`url()`) can only be verified against a server
+ *     that signs the URL the same way it later validates it. A stub
+ *     can't catch sig-version mismatches, path-style bugs, or auth
+ *     header drift across SDK upgrades.
+ *   - `forcePathStyle` + `endpoint` interactions are MinIO-specific and
+ *     break silently if the SDK changes how it composes URLs.
+ *   - Real round-trips through the S3 protocol catch encoding bugs
+ *     (binary bodies, metadata header casing, etag quoting) that pure
+ *     command-construction stubs miss.
+ */
+export {};
+//# sourceMappingURL=storage-s3.integration.test.d.ts.map

package/dist/__tests__/storage-s3.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-s3.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/storage-s3.integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/__tests__/storage-s3.integration.test.js

@@ -0,0 +1,150 @@
+/**
+ * Integration test — exercises `@nwire/storage-s3` against real MinIO.
+ *
+ * MinIO + the `nwire-dev` bucket come from the workspace docker-compose
+ * (`nwire infra up` or `docker compose up -d minio minio-bootstrap`).
+ * When MinIO isn't reachable on `127.0.0.1:9000`, the whole suite skips
+ * cleanly — the default `pnpm vitest run` stays fast and self-contained,
+ * and CI gets a deterministic skip rather than a flaky failure.
+ *
+ * Why exercise MinIO instead of trusting the unit tests:
+ *
+ *   - Presigned URLs (`url()`) can only be verified against a server
+ *     that signs the URL the same way it later validates it. A stub
+ *     can't catch sig-version mismatches, path-style bugs, or auth
+ *     header drift across SDK upgrades.
+ *   - `forcePathStyle` + `endpoint` interactions are MinIO-specific and
+ *     break silently if the SDK changes how it composes URLs.
+ *   - Real round-trips through the S3 protocol catch encoding bugs
+ *     (binary bodies, metadata header casing, etag quoting) that pure
+ *     command-construction stubs miss.
+ */
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import { randomUUID } from "node:crypto";
+import { isReachable } from "@nwire/test-kit";
+import { s3Storage } from "../storage-s3";
+import { StorageObjectNotFoundError } from "@nwire/storage";
+const MINIO_HOST = "127.0.0.1";
+const MINIO_PORT = 9000;
+const BUCKET = "nwire-dev";
+const reachable = await isReachable(MINIO_HOST, MINIO_PORT, 800);
+describe.skipIf(!reachable)("storage-s3 ↔ real MinIO", () => {
+    let storage;
+    // Namespace every run so concurrent CI workers and rerun-after-fail
+    // don't trip over each other's keys.
+    const ns = `tests/${randomUUID().slice(0, 8)}/`;
+    beforeAll(() => {
+        storage = s3Storage({
+            bucket: BUCKET,
+            region: "us-east-1",
+            endpoint: `http://${MINIO_HOST}:${MINIO_PORT}`,
+            forcePathStyle: true,
+            credentials: { accessKeyId: "minioadmin", secretAccessKey: "minioadmin" },
+            keyPrefix: ns,
+        });
+    });
+    afterAll(async () => {
+        // Best-effort cleanup — list and delete anything our prefix wrote.
+        try {
+            const page = await storage.list();
+            for (const e of page.entries)
+                await storage.delete(e.key);
+        }
+        catch { /* ignore — test isolation should keep these uncontended */ }
+        await storage.shutdown?.();
+    });
+    it("HeadBucket succeeds — healthCheck passes against MinIO", async () => {
+        await expect(storage.healthCheck()).resolves.toBeUndefined();
+    });
+    it("put → get round-trips a UTF-8 string body with the right content type", async () => {
+        const result = await storage.put("hello.txt", "Hello, MinIO!", {
+            contentType: "text/plain",
+            metadata: { sender: "phase-77" },
+        });
+        expect(result.size).toBe(13);
+        expect(result.etag).toMatch(/^"?[a-f0-9]{32}/i);
+        const back = await storage.get("hello.txt");
+        expect(back.body.toString("utf-8")).toBe("Hello, MinIO!");
+        expect(back.contentType).toBe("text/plain");
+        expect(back.size).toBe(13);
+        // MinIO + S3 normalize metadata to lowercase keys.
+        expect(back.metadata?.sender).toBe("phase-77");
+    });
+    it("put accepts a binary Buffer and preserves bytes exactly", async () => {
+        const bytes = Buffer.from([0xde, 0xad, 0xbe, 0xef, 0x00, 0xff, 0x7f]);
+        await storage.put("binary.bin", bytes);
+        const back = await storage.get("binary.bin");
+        expect(Buffer.compare(back.body, bytes)).toBe(0);
+    });
+    it("get on a missing key throws StorageObjectNotFoundError", async () => {
+        await expect(storage.get("missing/" + randomUUID())).rejects.toBeInstanceOf(StorageObjectNotFoundError);
+    });
+    it("exists() flips false → true → false across put + delete", async () => {
+        const key = "lifecycle.txt";
+        expect(await storage.exists(key)).toBe(false);
+        await storage.put(key, "x");
+        expect(await storage.exists(key)).toBe(true);
+        await storage.delete(key);
+        expect(await storage.exists(key)).toBe(false);
+    });
+    it("list() returns the entries we wrote, with our prefix stripped", async () => {
+        // Fresh sub-namespace to keep the assertion simple.
+        const inner = s3Storage({
+            bucket: BUCKET,
+            region: "us-east-1",
+            endpoint: `http://${MINIO_HOST}:${MINIO_PORT}`,
+            forcePathStyle: true,
+            credentials: { accessKeyId: "minioadmin", secretAccessKey: "minioadmin" },
+            keyPrefix: `${ns}list-test/`,
+        });
+        try {
+            await inner.put("a.txt", "1");
+            await inner.put("b.txt", "22");
+            await inner.put("c/d.txt", "333");
+            const page = await inner.list();
+            const keys = page.entries.map((e) => e.key).sort();
+            expect(keys).toEqual(["a.txt", "b.txt", "c/d.txt"]);
+            const a = page.entries.find((e) => e.key === "a.txt");
+            expect(a.size).toBe(1);
+        }
+        finally {
+            await inner.shutdown?.();
+        }
+    });
+    it("presigned GET url roundtrips via plain fetch", async () => {
+        const key = "presigned.txt";
+        await storage.put(key, "via signed url", { contentType: "text/plain" });
+        const url = await storage.url(key, { expiresInSeconds: 60 });
+        expect(url).toMatch(/X-Amz-Signature=/);
+        const res = await fetch(url);
+        expect(res.status).toBe(200);
+        expect(await res.text()).toBe("via signed url");
+    });
+    it("presigned PUT url accepts a fetch-driven upload", async () => {
+        const key = "uploaded-via-signed.txt";
+        const url = await storage.url(key, {
+            method: "put",
+            contentType: "text/plain",
+            expiresInSeconds: 60,
+        });
+        const res = await fetch(url, {
+            method: "PUT",
+            headers: { "content-type": "text/plain" },
+            body: "uploaded through a presigned URL",
+        });
+        expect(res.ok).toBe(true);
+        const back = await storage.get(key);
+        expect(back.body.toString("utf-8")).toBe("uploaded through a presigned URL");
+    });
+    it("getStream() yields the same bytes as get()", async () => {
+        const key = "stream.txt";
+        await storage.put(key, "stream me");
+        const stream = await storage.getStream(key);
+        const chunks = [];
+        for await (const c of stream) {
+            chunks.push(Buffer.isBuffer(c) ? c : Buffer.from(c));
+        }
+        expect(Buffer.concat(chunks).toString("utf-8")).toBe("stream me");
+    });
+});
+//# sourceMappingURL=storage-s3.integration.test.js.map

package/dist/__tests__/storage-s3.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-s3.integration.test.js","sourceRoot":"","sources":["../../src/__tests__/storage-s3.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/storage-s3.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `@nwire/storage-s3` — unit tests with a hand-rolled `S3Client.send`
+ * stub. We're verifying:
+ *
+ *   - the right command + parameters reach the SDK
+ *   - GetObject NotFound is translated to StorageObjectNotFoundError
+ *   - body assembly works for an async-iterable response (the Node case)
+ *
+ * Integration tests against real MinIO live elsewhere — the docker-
+ * compose has the bucket ready when those run.
+ */
+export {};
+//# sourceMappingURL=storage-s3.test.d.ts.map

package/dist/__tests__/storage-s3.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-s3.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/storage-s3.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/__tests__/storage-s3.test.js

@@ -0,0 +1,125 @@
+/**
+ * `@nwire/storage-s3` — unit tests with a hand-rolled `S3Client.send`
+ * stub. We're verifying:
+ *
+ *   - the right command + parameters reach the SDK
+ *   - GetObject NotFound is translated to StorageObjectNotFoundError
+ *   - body assembly works for an async-iterable response (the Node case)
+ *
+ * Integration tests against real MinIO live elsewhere — the docker-
+ * compose has the bucket ready when those run.
+ */
+import { describe, it, expect, vi } from "vitest";
+import { Readable } from "node:stream";
+import { s3Storage } from "../storage-s3";
+import { StorageObjectNotFoundError } from "@nwire/storage";
+function makeClientStub(responses) {
+    const calls = [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const send = vi.fn(async (cmd) => {
+        const name = cmd.constructor.name;
+        calls.push({ name, input: cmd.input });
+        const reply = responses[name];
+        if (reply instanceof Error)
+            throw reply;
+        return reply ?? {};
+    });
+    const stub = { send, destroy: vi.fn() };
+    return { stub, send, calls };
+}
+describe("s3Storage — command translation", () => {
+    it("put sends a PutObjectCommand with the right Bucket + Key + Body", async () => {
+        const { stub, calls } = makeClientStub({
+            PutObjectCommand: { ETag: '"abc"' },
+        });
+        const storage = s3Storage({ bucket: "uploads", client: stub });
+        const result = await storage.put("a/b.txt", "hello", {
+            contentType: "text/plain",
+            metadata: { user: "alice" },
+        });
+        expect(result.etag).toBe('"abc"');
+        expect(result.size).toBe(5);
+        expect(calls).toEqual([{
+                name: "PutObjectCommand",
+                input: {
+                    Bucket: "uploads",
+                    Key: "a/b.txt",
+                    Body: "hello",
+                    ContentType: "text/plain",
+                    CacheControl: undefined,
+                    Metadata: { user: "alice" },
+                },
+            }]);
+    });
+    it("get assembles the body from a Node Readable stream", async () => {
+        const { stub } = makeClientStub({
+            GetObjectCommand: {
+                Body: Readable.from(["hel", "lo"]),
+                ContentType: "text/plain",
+                ContentLength: 5,
+                ETag: '"abc"',
+            },
+        });
+        const storage = s3Storage({ bucket: "uploads", client: stub });
+        const obj = await storage.get("a/b.txt");
+        expect(obj.body.toString("utf-8")).toBe("hello");
+        expect(obj.contentType).toBe("text/plain");
+        expect(obj.size).toBe(5);
+    });
+    it("get translates NoSuchKey into StorageObjectNotFoundError", async () => {
+        const err = Object.assign(new Error("not found"), { name: "NoSuchKey" });
+        const { stub } = makeClientStub({ GetObjectCommand: err });
+        const storage = s3Storage({ bucket: "uploads", client: stub });
+        await expect(storage.get("missing.txt")).rejects.toBeInstanceOf(StorageObjectNotFoundError);
+    });
+    it("exists returns false on 404, true on success", async () => {
+        const { stub: ok } = makeClientStub({
+            HeadObjectCommand: { ContentLength: 1 },
+        });
+        expect(await s3Storage({ bucket: "u", client: ok }).exists("a")).toBe(true);
+        const err = Object.assign(new Error(""), {
+            name: "NotFound",
+            $metadata: { httpStatusCode: 404 },
+        });
+        const { stub: missing } = makeClientStub({ HeadObjectCommand: err });
+        expect(await s3Storage({ bucket: "u", client: missing }).exists("a")).toBe(false);
+    });
+    it("list maps Contents into StorageEntry array", async () => {
+        const { stub } = makeClientStub({
+            ListObjectsV2Command: {
+                Contents: [
+                    { Key: "a", Size: 1, LastModified: new Date(0), ETag: '"x"' },
+                    { Key: "b", Size: 2, LastModified: new Date(1), ETag: '"y"' },
+                ],
+                IsTruncated: false,
+            },
+        });
+        const page = await s3Storage({ bucket: "u", client: stub }).list();
+        expect(page.entries.map((e) => e.key)).toEqual(["a", "b"]);
+        expect(page.nextCursor).toBeUndefined();
+    });
+    it("keyPrefix is applied to every operation and stripped on list", async () => {
+        const { stub, calls } = makeClientStub({
+            PutObjectCommand: {},
+            ListObjectsV2Command: {
+                Contents: [{ Key: "tenants/acme/a", Size: 1 }],
+            },
+        });
+        const storage = s3Storage({ bucket: "u", client: stub, keyPrefix: "tenants/acme/" });
+        await storage.put("a", "x");
+        const page = await storage.list();
+        expect(calls[0].input).toMatchObject({ Key: "tenants/acme/a" });
+        expect(page.entries[0].key).toBe("a");
+    });
+    it("healthCheck calls HeadBucket", async () => {
+        const { stub, calls } = makeClientStub({ HeadBucketCommand: {} });
+        await s3Storage({ bucket: "u", client: stub }).healthCheck();
+        expect(calls[0].name).toBe("HeadBucketCommand");
+    });
+    it("shutdown destroys the SDK client", async () => {
+        const { stub } = makeClientStub({});
+        await s3Storage({ bucket: "u", client: stub }).shutdown();
+        expect(stub.destroy).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=storage-s3.test.js.map

package/dist/__tests__/storage-s3.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-s3.test.js","sourceRoot":"","sources":["../../src/__tests__/storage-s3.test.ts"],"names":[],"mappings":"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"}

package/dist/storage-s3.d.ts

@@ -0,0 +1,68 @@
+/**
+ * `@nwire/storage-s3` — S3-compatible adapter.
+ *
+ * Works with anything that speaks the S3 API:
+ *   - AWS S3 (default)
+ *   - MinIO (set `endpoint` + `forcePathStyle: true`)
+ *   - Cloudflare R2
+ *   - Backblaze B2
+ *   - DigitalOcean Spaces, Wasabi, Linode Object Storage, etc.
+ *
+ * The adapter is a thin shim over `@aws-sdk/client-s3`:
+ *   - Translates the Nwire Storage contract to S3 commands.
+ *   - Maps NotFound errors to `StorageObjectNotFoundError`.
+ *   - Uses `@aws-sdk/s3-request-presigner` for `url()` (presigned URLs).
+ *   - Provides a `healthCheck` that calls `HeadBucket` — fast, cheap, exact.
+ *
+ *   import { s3Storage }     from "@nwire/storage-s3";
+ *   import { storagePlugin } from "@nwire/storage";
+ *
+ *   const storage = s3Storage({
+ *     bucket: "uploads",
+ *     region: "us-east-1",
+ *     // MinIO:
+ *     // endpoint: "http://localhost:9000",
+ *     // forcePathStyle: true,
+ *     // credentials: { accessKeyId: "minioadmin", secretAccessKey: "minioadmin" },
+ *   });
+ *
+ *   defineApp("my-app", { plugins: [storagePlugin({ storage })] });
+ */
+import { S3Client } from "@aws-sdk/client-s3";
+import { type Storage } from "@nwire/storage";
+export interface S3StorageOptions {
+    /** Bucket name. Required. */
+    readonly bucket: string;
+    /** AWS region (or any value MinIO/R2 expects). */
+    readonly region?: string;
+    /**
+     * Custom endpoint URL — set for MinIO / R2 / B2 / etc.
+     * E.g. `"http://localhost:9000"` for local MinIO.
+     */
+    readonly endpoint?: string;
+    /**
+     * MinIO + most non-AWS providers require path-style addressing
+     * (`endpoint/bucket/key` rather than `bucket.endpoint/key`).
+     * Default: `false` (AWS native).
+     */
+    readonly forcePathStyle?: boolean;
+    /**
+     * Static credentials. Omit to use the SDK's default credential chain
+     * (env vars, IAM role, ~/.aws/credentials). Recommended for AWS.
+     */
+    readonly credentials?: {
+        readonly accessKeyId: string;
+        readonly secretAccessKey: string;
+        readonly sessionToken?: string;
+    };
+    /**
+     * Reuse an existing `S3Client` instead of constructing one. Useful when
+     * the app already has a configured client (multi-bucket scenarios).
+     */
+    readonly client?: S3Client;
+    /** Optional prefix applied to every key — for namespacing inside a bucket. */
+    readonly keyPrefix?: string;
+}
+/** Build an S3-backed Storage adapter. */
+export declare function s3Storage(options: S3StorageOptions): Storage;
+//# sourceMappingURL=storage-s3.d.ts.map

package/dist/storage-s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-s3.d.ts","sourceRoot":"","sources":["../src/storage-s3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EACL,QAAQ,EAQT,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAEL,KAAK,OAAO,EASb,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,WAAW,EAAM,MAAM,CAAC;QACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,YAAY,CAAC,EAAI,MAAM,CAAC;KAClC,CAAC;IACF;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAO5D"}

package/dist/storage-s3.js

@@ -0,0 +1,224 @@
+/**
+ * `@nwire/storage-s3` — S3-compatible adapter.
+ *
+ * Works with anything that speaks the S3 API:
+ *   - AWS S3 (default)
+ *   - MinIO (set `endpoint` + `forcePathStyle: true`)
+ *   - Cloudflare R2
+ *   - Backblaze B2
+ *   - DigitalOcean Spaces, Wasabi, Linode Object Storage, etc.
+ *
+ * The adapter is a thin shim over `@aws-sdk/client-s3`:
+ *   - Translates the Nwire Storage contract to S3 commands.
+ *   - Maps NotFound errors to `StorageObjectNotFoundError`.
+ *   - Uses `@aws-sdk/s3-request-presigner` for `url()` (presigned URLs).
+ *   - Provides a `healthCheck` that calls `HeadBucket` — fast, cheap, exact.
+ *
+ *   import { s3Storage }     from "@nwire/storage-s3";
+ *   import { storagePlugin } from "@nwire/storage";
+ *
+ *   const storage = s3Storage({
+ *     bucket: "uploads",
+ *     region: "us-east-1",
+ *     // MinIO:
+ *     // endpoint: "http://localhost:9000",
+ *     // forcePathStyle: true,
+ *     // credentials: { accessKeyId: "minioadmin", secretAccessKey: "minioadmin" },
+ *   });
+ *
+ *   defineApp("my-app", { plugins: [storagePlugin({ storage })] });
+ */
+import { S3Client, PutObjectCommand, GetObjectCommand, DeleteObjectCommand, HeadObjectCommand, HeadBucketCommand, ListObjectsV2Command, } from "@aws-sdk/client-s3";
+import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
+import { StorageObjectNotFoundError, } from "@nwire/storage";
+/** Build an S3-backed Storage adapter. */
+export function s3Storage(options) {
+    const client = options.client ?? buildClient(options);
+    const bucket = options.bucket;
+    const prefix = options.keyPrefix ?? "";
+    const k = (key) => `${prefix}${key}`;
+    return new S3Storage(client, bucket, prefix, k);
+}
+function buildClient(options) {
+    const config = {};
+    if (options.region)
+        config.region = options.region;
+    if (options.endpoint)
+        config.endpoint = options.endpoint;
+    if (options.forcePathStyle)
+        config.forcePathStyle = options.forcePathStyle;
+    if (options.credentials) {
+        config.credentials = {
+            accessKeyId: options.credentials.accessKeyId,
+            secretAccessKey: options.credentials.secretAccessKey,
+            sessionToken: options.credentials.sessionToken,
+        };
+    }
+    return new S3Client(config);
+}
+/**
+ * Storage implementation backed by S3. Implementation as a class so the
+ * shape is easy to extend (`S3Storage` could grab telemetry hooks, custom
+ * retry policies, etc. in future).
+ */
+class S3Storage {
+    client;
+    bucket;
+    prefix;
+    k;
+    constructor(client, bucket, prefix, k) {
+        this.client = client;
+        this.bucket = bucket;
+        this.prefix = prefix;
+        this.k = k;
+    }
+    async put(key, body, opts) {
+        const Body = toS3Body(body);
+        const response = await this.client.send(new PutObjectCommand({
+            Bucket: this.bucket,
+            Key: this.k(key),
+            Body,
+            ContentType: opts?.contentType,
+            CacheControl: opts?.cacheControl,
+            Metadata: opts?.metadata ? { ...opts.metadata } : undefined,
+        }));
+        return {
+            key,
+            etag: response.ETag,
+            size: typeof Body === "string" ? Buffer.byteLength(Body) : Body.byteLength,
+        };
+    }
+    async get(key) {
+        try {
+            const response = await this.client.send(new GetObjectCommand({ Bucket: this.bucket, Key: this.k(key) }));
+            const body = await streamToBuffer(response.Body);
+            return {
+                key,
+                body,
+                contentType: response.ContentType,
+                size: response.ContentLength,
+                etag: response.ETag,
+                metadata: response.Metadata,
+            };
+        }
+        catch (err) {
+            throw translateError(err, key);
+        }
+    }
+    async getStream(key) {
+        try {
+            const response = await this.client.send(new GetObjectCommand({ Bucket: this.bucket, Key: this.k(key) }));
+            // The SDK's Body is web Readable | Node Readable | Blob depending on
+            // runtime — we narrow to a Node stream via the AWS SDK helper shape.
+            const body = response.Body;
+            if (!body)
+                throw new StorageObjectNotFoundError(key);
+            // Node 22+ — the SDK's Body is a Node Readable in our target runtime.
+            // The other shapes only show up in the browser/Workers builds we
+            // don't support.
+            return body;
+        }
+        catch (err) {
+            throw translateError(err, key);
+        }
+    }
+    async delete(key) {
+        await this.client.send(new DeleteObjectCommand({ Bucket: this.bucket, Key: this.k(key) }));
+    }
+    async exists(key) {
+        try {
+            await this.client.send(new HeadObjectCommand({ Bucket: this.bucket, Key: this.k(key) }));
+            return true;
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return false;
+            throw err;
+        }
+    }
+    async list(prefix, opts) {
+        const response = await this.client.send(new ListObjectsV2Command({
+            Bucket: this.bucket,
+            Prefix: prefix ? this.k(prefix) : this.prefix || undefined,
+            MaxKeys: opts?.limit,
+            ContinuationToken: opts?.cursor,
+        }));
+        const stripPrefix = this.prefix
+            ? (s) => (s.startsWith(this.prefix) ? s.slice(this.prefix.length) : s)
+            : (s) => s;
+        const entries = (response.Contents ?? []).map((obj) => ({
+            key: stripPrefix(obj.Key ?? ""),
+            size: obj.Size,
+            modifiedAt: obj.LastModified,
+            etag: obj.ETag,
+        }));
+        return {
+            entries,
+            nextCursor: response.IsTruncated ? response.NextContinuationToken : undefined,
+        };
+    }
+    async url(key, opts) {
+        const expiresIn = opts?.expiresInSeconds ?? 900;
+        const method = opts?.method ?? "get";
+        const command = method === "put"
+            ? new PutObjectCommand({
+                Bucket: this.bucket,
+                Key: this.k(key),
+                ContentType: opts?.contentType,
+            })
+            : new GetObjectCommand({ Bucket: this.bucket, Key: this.k(key) });
+        return getSignedUrl(this.client, command, { expiresIn });
+    }
+    async healthCheck() {
+        await this.client.send(new HeadBucketCommand({ Bucket: this.bucket }));
+    }
+    async shutdown() {
+        this.client.destroy();
+    }
+}
+// ─── Helpers ────────────────────────────────────────────────────────
+function toS3Body(body) {
+    if (Buffer.isBuffer(body))
+        return body;
+    if (typeof body === "string")
+        return body;
+    return body;
+}
+async function streamToBuffer(body) {
+    if (!body)
+        return Buffer.alloc(0);
+    // Node Readable produced by the SDK in Node runtimes.
+    if (typeof body[Symbol.asyncIterator] === "function") {
+        const chunks = [];
+        for await (const c of body) {
+            chunks.push(Buffer.isBuffer(c) ? c : Buffer.from(c));
+        }
+        return Buffer.concat(chunks);
+    }
+    // Web ReadableStream fallback.
+    if (typeof body.getReader === "function") {
+        const reader = body.getReader();
+        const chunks = [];
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            if (value)
+                chunks.push(value);
+        }
+        return Buffer.concat(chunks.map((c) => Buffer.from(c)));
+    }
+    throw new Error("S3 response body shape not recognized");
+}
+function isNotFound(err) {
+    if (!err || typeof err !== "object")
+        return false;
+    const e = err;
+    return e.name === "NoSuchKey" || e.name === "NotFound" || e.$metadata?.httpStatusCode === 404;
+}
+function translateError(err, key) {
+    if (isNotFound(err))
+        return new StorageObjectNotFoundError(key);
+    return err;
+}
+//# sourceMappingURL=storage-s3.js.map

package/dist/storage-s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-s3.js","sourceRoot":"","sources":["../src/storage-s3.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@nwire/storage-s3",
+  "version": "0.7.0",
+  "description": "Nwire — S3 storage adapter. Works with AWS S3, MinIO, Cloudflare R2, Backblaze B2, and anything else speaking the S3 API. Wraps @aws-sdk/client-s3 + @aws-sdk/s3-request-presigner.",
+  "keywords": [
+    "adapter",
+    "b2",
+    "minio",
+    "nwire",
+    "r2",
+    "s3",
+    "storage"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/storage-s3.js",
+  "types": "./dist/storage-s3.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/storage-s3.js",
+      "types": "./dist/storage-s3.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.700.0",
+    "@aws-sdk/s3-request-presigner": "^3.700.0",
+    "@nwire/storage": "0.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.9",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.6",
+    "@nwire/test-kit": "0.7.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}