@nwire/storage 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,71 @@
+# @nwire/storage
+
+> Object-storage contract — narrow `Storage` interface (`put`/`get`/`stream`/`url`/`list`/`delete`).
+
+## What it does
+
+Defines the `Storage` interface every adapter implements and ships `storagePlugin({ storage })` that registers it on the container with lifecycle hooks. The contract is intentionally narrow — what 95% of apps actually need. Adapters that can't honor a method (e.g. `fs` has no presigned URLs) throw `StorageUnsupportedError` so callers can branch on capability.
+
+## Install
+
+```bash
+pnpm add @nwire/storage
+```
+
+## Quick start
+
+```ts
+import { storagePlugin, InMemoryStorage } from "@nwire/storage";
+import { defineApp, defineAction } from "@nwire/forge";
+
+const storage = new InMemoryStorage();
+defineApp("my-app", { plugins: [storagePlugin({ storage })] });
+
+defineAction({
+  name: "uploads.create",
+  handler: async ({ input }, ctx) => {
+    const s = ctx.resolve<typeof storage>("storage");
+    await s.put(input.key, input.bytes, { contentType: input.contentType });
+    return { url: await s.url(input.key) };
+  },
+});
+```
+
+## API surface
+
+- `Storage` — `put` / `get` / `getStream` / `delete` / `exists` / `list` / `url`.
+- `storagePlugin({ storage })` — register on container; lifecycle-managed.
+- `InMemoryStorage` — captures bytes in a Map; useful in tests.
+- `StorageObjectNotFoundError` / `StorageUnsupportedError`.
+
+## When to use
+
+Any app that handles files (uploads, exports, generated reports). Fits L3 and up.
+
+## Standalone use
+
+For developers using `@nwire/storage` **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";
+```
+
+## 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-s3](../nwire-storage-s3), [@nwire/storage-fs](../nwire-storage-fs)

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

@@ -0,0 +1,8 @@
+/**
+ * `@nwire/storage` — contract verification via InMemoryStorage.
+ *
+ * The same test set should run against every adapter (S3/MinIO/fs)
+ * with minimal changes — verifies the contract is uniform.
+ */
+export {};
+//# sourceMappingURL=storage.test.d.ts.map

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

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

package/dist/__tests__/storage.test.js

@@ -0,0 +1,97 @@
+/**
+ * `@nwire/storage` — contract verification via InMemoryStorage.
+ *
+ * The same test set should run against every adapter (S3/MinIO/fs)
+ * with minimal changes — verifies the contract is uniform.
+ */
+import { describe, it, expect } from "vitest";
+import { InMemoryStorage, StorageObjectNotFoundError, storagePlugin, } from "../storage";
+import { createApp } from "@nwire/forge";
+describe("InMemoryStorage", () => {
+    it("put + get round-trips bytes with metadata", async () => {
+        const s = new InMemoryStorage();
+        const result = await s.put("a/b.txt", "hello", {
+            contentType: "text/plain",
+            metadata: { uploader: "alice" },
+        });
+        expect(result.key).toBe("a/b.txt");
+        expect(result.size).toBe(5);
+        const obj = await s.get("a/b.txt");
+        expect(obj.body.toString("utf-8")).toBe("hello");
+        expect(obj.contentType).toBe("text/plain");
+        expect(obj.metadata?.uploader).toBe("alice");
+    });
+    it("get throws StorageObjectNotFoundError for unknown keys", async () => {
+        const s = new InMemoryStorage();
+        await expect(s.get("nope.txt")).rejects.toBeInstanceOf(StorageObjectNotFoundError);
+    });
+    it("exists reflects put + delete", async () => {
+        const s = new InMemoryStorage();
+        expect(await s.exists("x")).toBe(false);
+        await s.put("x", "");
+        expect(await s.exists("x")).toBe(true);
+        await s.delete("x");
+        expect(await s.exists("x")).toBe(false);
+    });
+    it("getStream produces a readable for the same body", async () => {
+        const s = new InMemoryStorage();
+        await s.put("stream.txt", "abc");
+        const stream = await s.getStream("stream.txt");
+        const chunks = [];
+        for await (const c of stream)
+            chunks.push(c);
+        expect(Buffer.concat(chunks).toString("utf-8")).toBe("abc");
+    });
+    it("list filters by prefix and is paginated", async () => {
+        const s = new InMemoryStorage();
+        for (const k of ["users/a", "users/b", "users/c", "posts/x"]) {
+            await s.put(k, k);
+        }
+        const page1 = await s.list("users/", { limit: 2 });
+        expect(page1.entries.map((e) => e.key)).toEqual(["users/a", "users/b"]);
+        expect(page1.nextCursor).toBe("users/b");
+        const page2 = await s.list("users/", { limit: 2, cursor: page1.nextCursor });
+        expect(page2.entries.map((e) => e.key)).toEqual(["users/c"]);
+        expect(page2.nextCursor).toBeUndefined();
+    });
+    it("url returns a memory:// URL for the test adapter", async () => {
+        const s = new InMemoryStorage();
+        await s.put("avatar.png", "x");
+        const url = await s.url("avatar.png");
+        expect(url).toMatch(/^memory:\/\/avatar/);
+    });
+});
+describe("storagePlugin", () => {
+    it("boots + stops cleanly with the default InMemory adapter", async () => {
+        const app = createApp({ modules: [], plugins: [storagePlugin()] });
+        await app.start();
+        await app.stop();
+    });
+    it("calls adapter.shutdown on app.stop when defined", async () => {
+        let stopped = false;
+        const adapter = {
+            put: async () => ({ key: "x" }),
+            get: async () => {
+                throw new Error("not used");
+            },
+            getStream: async () => {
+                throw new Error("not used");
+            },
+            delete: async () => { },
+            exists: async () => false,
+            list: async () => ({ entries: [] }),
+            url: async () => "x://",
+            shutdown: async () => {
+                stopped = true;
+            },
+        };
+        const app = createApp({
+            modules: [],
+            plugins: [storagePlugin({ storage: adapter, name: "files" })],
+        });
+        await app.start();
+        await app.stop();
+        expect(stopped).toBe(true);
+    });
+});
+//# sourceMappingURL=storage.test.js.map

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

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

package/dist/storage.d.ts

@@ -0,0 +1,165 @@
+/**
+ * `@nwire/storage` — object-storage contract.
+ *
+ * One interface every adapter implements; the framework "owns" the
+ * lifecycle (boot, health check, shutdown) via `storagePlugin`. Domain
+ * code calls `ctx.resolve<Storage>("storage")` (or whatever name the
+ * plugin was given) and gets the real adapter back.
+ *
+ *   - `@nwire/storage-s3` — S3 + MinIO + R2 + B2 (anything S3-API)
+ *   - `@nwire/storage-fs` — local filesystem (dev / single-node)
+ *
+ * The contract is intentionally narrow — what 95% of apps actually need:
+ *   - put(key, bytes, opts?)        store an object
+ *   - get(key)                      retrieve as a buffer
+ *   - getStream(key)                retrieve as a Node stream (large files)
+ *   - delete(key)                   remove
+ *   - exists(key)                   existence check
+ *   - list(prefix?, opts?)          paginated listing
+ *   - url(key, opts?)               presigned URL for client uploads/downloads
+ *
+ * Adapters that can't honor a method (e.g., fs has no presigned URLs in
+ * the same sense) MAY throw `StorageUnsupportedError` from it; callers
+ * branch on capability when this matters.
+ */
+import { type PluginDefinition } from "@nwire/forge";
+/** Bytes you can write — Buffer, Uint8Array, or string (utf-8 encoded). */
+export type StorageBody = Buffer | Uint8Array | string;
+/** Options accepted by `put`. */
+export interface StoragePutOptions {
+    /** MIME type. Defaults to `"application/octet-stream"`. */
+    readonly contentType?: string;
+    /**
+     * Cache-Control header value the adapter should set on the object.
+     * Adapters that don't model HTTP headers (fs) ignore this.
+     */
+    readonly cacheControl?: string;
+    /** User-defined metadata key/value pairs. Adapters preserve as best they can. */
+    readonly metadata?: Readonly<Record<string, string>>;
+}
+/** Result of a successful `put`. */
+export interface StoragePutResult {
+    readonly key: string;
+    readonly etag?: string;
+    readonly size?: number;
+}
+/** Result of `get` — bytes + the metadata the adapter knows about. */
+export interface StorageObject {
+    readonly key: string;
+    readonly body: Buffer;
+    readonly contentType?: string;
+    readonly size?: number;
+    readonly etag?: string;
+    readonly metadata?: Readonly<Record<string, string>>;
+}
+/** A single entry returned by `list`. */
+export interface StorageEntry {
+    readonly key: string;
+    readonly size?: number;
+    readonly modifiedAt?: Date;
+    readonly etag?: string;
+}
+/** Options accepted by `list`. */
+export interface StorageListOptions {
+    /** Max items per page. Adapter-default if omitted. */
+    readonly limit?: number;
+    /** Continuation token from a previous page. */
+    readonly cursor?: string;
+}
+/** Result page of `list`. */
+export interface StorageListPage {
+    readonly entries: readonly StorageEntry[];
+    /** Present when more pages exist; pass back as `cursor`. */
+    readonly nextCursor?: string;
+}
+/** Options for `url`. */
+export interface StorageUrlOptions {
+    /** GET (download) or PUT (upload). Default: `"get"`. */
+    readonly method?: "get" | "put";
+    /** Expiry in seconds. Default: 900 (15 min). */
+    readonly expiresInSeconds?: number;
+    /** For `method:"put"` — required content-type. */
+    readonly contentType?: string;
+}
+/**
+ * The contract every adapter implements. Stable across S3/MinIO/fs/etc.
+ */
+export interface Storage {
+    put(key: string, body: StorageBody, opts?: StoragePutOptions): Promise<StoragePutResult>;
+    get(key: string): Promise<StorageObject>;
+    getStream(key: string): Promise<NodeJS.ReadableStream>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list(prefix?: string, opts?: StorageListOptions): Promise<StorageListPage>;
+    url(key: string, opts?: StorageUrlOptions): Promise<string>;
+    /** Optional readiness probe — adapter checks its backend is reachable. */
+    healthCheck?(): Promise<void>;
+    /** Optional shutdown — close clients, flush pending uploads, etc. */
+    shutdown?(): Promise<void>;
+}
+/**
+ * Thrown when an object key isn't present. Adapters MUST translate
+ * backend "not found" into this — never expose raw S3 / fs errors.
+ */
+export declare class StorageObjectNotFoundError extends Error {
+    readonly $kind: "storage.object-not-found";
+    readonly status: 404;
+    readonly key: string;
+    constructor(key: string);
+}
+/** Thrown when a method isn't supported by the adapter (rare). */
+export declare class StorageUnsupportedError extends Error {
+    readonly $kind: "storage.unsupported";
+    readonly status: 501;
+    constructor(message?: string);
+}
+/**
+ * The default — keeps every put in a Map. Test-grade only. Resets when
+ * the process restarts; not suitable for anything other than tests.
+ *
+ *   const storage = new InMemoryStorage()
+ *   await storage.put("avatar.png", Buffer.from([...]))
+ *   const obj = await storage.get("avatar.png")
+ */
+export declare class InMemoryStorage implements Storage {
+    private readonly store;
+    put(key: string, body: StorageBody, opts?: StoragePutOptions): Promise<StoragePutResult>;
+    get(key: string): Promise<StorageObject>;
+    getStream(key: string): Promise<NodeJS.ReadableStream>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list(prefix?: string, opts?: StorageListOptions): Promise<StorageListPage>;
+    /** Returns a memory:// URL — for tests only; not actually fetchable. */
+    url(key: string, _opts?: StorageUrlOptions): Promise<string>;
+    /** Diagnostic — peek at what's stored. Not in the contract. */
+    size(): number;
+    /** Diagnostic — clear everything (tests). Not in the contract. */
+    clear(): void;
+}
+export interface StoragePluginOptions {
+    /**
+     * The Storage adapter to register. Default: `new InMemoryStorage()` —
+     * test-grade only; configure a real adapter in production.
+     */
+    readonly storage?: Storage;
+    /**
+     * Name the storage is registered under in the container. Default:
+     * `"storage"`. Use a distinct name when serving multiple stores
+     * (e.g. `"avatars"`, `"invoices"`).
+     */
+    readonly name?: string;
+}
+/**
+ * Build a Nwire plugin that registers a `Storage` adapter, wires its
+ * health check into readiness, and shuts it down cleanly. Use whichever
+ * adapter package fits the deployment:
+ *
+ *   import { storagePlugin } from "@nwire/storage"
+ *   import { s3Storage }     from "@nwire/storage-s3"
+ *
+ *   defineApp("my-app", {
+ *     plugins: [storagePlugin({ storage: s3Storage({...}) })],
+ *   })
+ */
+export declare function storagePlugin(options?: StoragePluginOptions): PluginDefinition;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

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

package/dist/storage.js

@@ -0,0 +1,167 @@
+/**
+ * `@nwire/storage` — object-storage contract.
+ *
+ * One interface every adapter implements; the framework "owns" the
+ * lifecycle (boot, health check, shutdown) via `storagePlugin`. Domain
+ * code calls `ctx.resolve<Storage>("storage")` (or whatever name the
+ * plugin was given) and gets the real adapter back.
+ *
+ *   - `@nwire/storage-s3` — S3 + MinIO + R2 + B2 (anything S3-API)
+ *   - `@nwire/storage-fs` — local filesystem (dev / single-node)
+ *
+ * The contract is intentionally narrow — what 95% of apps actually need:
+ *   - put(key, bytes, opts?)        store an object
+ *   - get(key)                      retrieve as a buffer
+ *   - getStream(key)                retrieve as a Node stream (large files)
+ *   - delete(key)                   remove
+ *   - exists(key)                   existence check
+ *   - list(prefix?, opts?)          paginated listing
+ *   - url(key, opts?)               presigned URL for client uploads/downloads
+ *
+ * Adapters that can't honor a method (e.g., fs has no presigned URLs in
+ * the same sense) MAY throw `StorageUnsupportedError` from it; callers
+ * branch on capability when this matters.
+ */
+import { definePlugin } from "@nwire/forge";
+// ─── Errors ────────────────────────────────────────────────────────
+/**
+ * Thrown when an object key isn't present. Adapters MUST translate
+ * backend "not found" into this — never expose raw S3 / fs errors.
+ */
+export class StorageObjectNotFoundError extends Error {
+    $kind = "storage.object-not-found";
+    status = 404;
+    key;
+    constructor(key) {
+        super(`No object at "${key}"`);
+        this.name = "StorageObjectNotFoundError";
+        this.key = key;
+    }
+}
+/** Thrown when a method isn't supported by the adapter (rare). */
+export class StorageUnsupportedError extends Error {
+    $kind = "storage.unsupported";
+    status = 501;
+    constructor(message = "storage method not supported by this adapter") {
+        super(message);
+        this.name = "StorageUnsupportedError";
+    }
+}
+/**
+ * The default — keeps every put in a Map. Test-grade only. Resets when
+ * the process restarts; not suitable for anything other than tests.
+ *
+ *   const storage = new InMemoryStorage()
+ *   await storage.put("avatar.png", Buffer.from([...]))
+ *   const obj = await storage.get("avatar.png")
+ */
+export class InMemoryStorage {
+    store = new Map();
+    async put(key, body, opts) {
+        const buf = toBuffer(body);
+        const rec = {
+            body: buf,
+            contentType: opts?.contentType ?? "application/octet-stream",
+            cacheControl: opts?.cacheControl,
+            metadata: opts?.metadata,
+            modifiedAt: new Date(),
+            etag: simpleEtag(buf),
+        };
+        this.store.set(key, rec);
+        return { key, etag: rec.etag, size: buf.byteLength };
+    }
+    async get(key) {
+        const rec = this.store.get(key);
+        if (!rec)
+            throw new StorageObjectNotFoundError(key);
+        return {
+            key,
+            body: rec.body,
+            contentType: rec.contentType,
+            size: rec.body.byteLength,
+            etag: rec.etag,
+            metadata: rec.metadata,
+        };
+    }
+    async getStream(key) {
+        const obj = await this.get(key);
+        const { Readable } = await import("node:stream");
+        return Readable.from(obj.body);
+    }
+    async delete(key) {
+        this.store.delete(key);
+    }
+    async exists(key) {
+        return this.store.has(key);
+    }
+    async list(prefix, opts) {
+        const limit = opts?.limit ?? 1000;
+        const cursor = opts?.cursor;
+        const all = Array.from(this.store.entries())
+            .filter(([k]) => !prefix || k.startsWith(prefix))
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+        const startAt = cursor ? all.findIndex(([k]) => k > cursor) : 0;
+        const slice = all.slice(Math.max(0, startAt), Math.max(0, startAt) + limit);
+        const entries = slice.map(([key, rec]) => ({
+            key,
+            size: rec.body.byteLength,
+            modifiedAt: rec.modifiedAt,
+            etag: rec.etag,
+        }));
+        const last = entries.at(-1)?.key;
+        const more = last && all.findIndex(([k]) => k === last) < all.length - 1;
+        return { entries, nextCursor: more ? last : undefined };
+    }
+    /** Returns a memory:// URL — for tests only; not actually fetchable. */
+    async url(key, _opts) {
+        return `memory://${encodeURIComponent(key)}`;
+    }
+    /** Diagnostic — peek at what's stored. Not in the contract. */
+    size() {
+        return this.store.size;
+    }
+    /** Diagnostic — clear everything (tests). Not in the contract. */
+    clear() {
+        this.store.clear();
+    }
+}
+function toBuffer(body) {
+    if (Buffer.isBuffer(body))
+        return body;
+    if (typeof body === "string")
+        return Buffer.from(body, "utf-8");
+    return Buffer.from(body);
+}
+/** djb2 hash + length — cheap, deterministic, good enough for tests. */
+function simpleEtag(buf) {
+    let h = 5381;
+    for (let i = 0; i < buf.length; i++)
+        h = ((h << 5) + h) ^ buf[i];
+    return `"${(h >>> 0).toString(16)}-${buf.length}"`;
+}
+/**
+ * Build a Nwire plugin that registers a `Storage` adapter, wires its
+ * health check into readiness, and shuts it down cleanly. Use whichever
+ * adapter package fits the deployment:
+ *
+ *   import { storagePlugin } from "@nwire/storage"
+ *   import { s3Storage }     from "@nwire/storage-s3"
+ *
+ *   defineApp("my-app", {
+ *     plugins: [storagePlugin({ storage: s3Storage({...}) })],
+ *   })
+ */
+export function storagePlugin(options = {}) {
+    const storage = options.storage ?? new InMemoryStorage();
+    const name = options.name ?? "storage";
+    return definePlugin(`storage:${name}`, ({ bind, shutdown }) => {
+        bind(name, () => storage);
+        const stop = storage.shutdown;
+        if (stop) {
+            shutdown(async () => {
+                await stop.call(storage);
+            });
+        }
+    });
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@nwire/storage",
+  "version": "0.7.0",
+  "description": "Nwire — object-storage contract + InMemoryStorage default + storagePlugin. Adapters (S3, filesystem) live in separate packages (@nwire/storage-s3, @nwire/storage-fs).",
+  "keywords": [
+    "adapter",
+    "blob",
+    "nwire",
+    "object-storage",
+    "s3",
+    "storage"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/storage.js",
+  "types": "./dist/storage.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/storage.js",
+      "types": "./dist/storage.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@nwire/forge": "0.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.9",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.6"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}