@airnauts/comments-storage-vercel-blob 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Airnauts
+
+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,24 @@
+# @airnauts/comments-storage-vercel-blob
+
+Vercel Blob attachment-storage adapter for the
+[Airnauts commenting tool](https://github.com/Airnauts/commenting-tool) server.
+
+## Install
+
+```bash
+pnpm add @airnauts/comments-storage-vercel-blob
+```
+
+## Usage
+
+```ts
+import { VercelBlobStorage } from '@airnauts/comments-storage-vercel-blob'
+
+const storage = new VercelBlobStorage() // reads BLOB_READ_WRITE_TOKEN
+```
+
+Pass `storage` to `createCommentsServer` from `@airnauts/comments-server`.
+
+## License
+
+MIT © Airnauts

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import type { PutBlob, PutResult, StorageAdapter } from '@airnauts/comments-server';
+export type VercelBlobStorageOptions = {
+    /** `BLOB_READ_WRITE_TOKEN`. If omitted, `@vercel/blob` reads it from `process.env`. */
+    token?: string;
+    /**
+     * Optional prefix (e.g. 'staging/') applied to every key. A trailing `/` is
+     * appended automatically if missing, so `'staging'` and `'staging/'` behave
+     * the same way.
+     */
+    prefix?: string;
+};
+export declare class VercelBlobStorage implements StorageAdapter {
+    private readonly opts;
+    private readonly prefix;
+    constructor(opts?: VercelBlobStorageOptions);
+    put(blob: PutBlob): Promise<PutResult>;
+}
+/** Construct a Vercel Blob `StorageAdapter` (uniform `xxxStorage(config)` shape). */
+export declare function vercelBlobStorage(opts?: VercelBlobStorageOptions): StorageAdapter;
+export declare const packageName = "@airnauts/comments-storage-vercel-blob";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAGnF,MAAM,MAAM,wBAAwB,GAAG;IACrC,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAiCD,qBAAa,iBAAkB,YAAW,cAAc;IAG1C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEF,IAAI,GAAE,wBAA6B;IAK1D,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC;CAgB7C;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,wBAA6B,GAAG,cAAc,CAErF;AAED,eAAO,MAAM,WAAW,2CAA2C,CAAA"}

package/dist/index.js

@@ -0,0 +1,66 @@
+// src/index.ts
+import { put } from "@vercel/blob";
+function sanitizeName(name) {
+  const cleaned = name.replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 200);
+  return cleaned.length > 0 ? cleaned : "file";
+}
+async function readAllBytes(data) {
+  if (data instanceof Uint8Array) return data;
+  const reader = data.getReader();
+  const chunks = [];
+  let total = 0;
+  try {
+    for (; ; ) {
+      const { value, done } = await reader.read();
+      if (done) break;
+      if (value) {
+        chunks.push(value);
+        total += value.byteLength;
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+  const out = new Uint8Array(total);
+  let offset = 0;
+  for (const c of chunks) {
+    out.set(c, offset);
+    offset += c.byteLength;
+  }
+  return out;
+}
+var VercelBlobStorage = class {
+  constructor(opts = {}) {
+    this.opts = opts;
+    const raw = opts.prefix ?? "";
+    this.prefix = raw === "" || raw.endsWith("/") ? raw : `${raw}/`;
+  }
+  opts;
+  prefix;
+  async put(blob) {
+    const bytes = await readAllBytes(blob.data);
+    const body = new Blob([bytes], { type: blob.contentType });
+    const key = `${this.prefix}${sanitizeName(blob.name)}`;
+    const result = await put(key, body, {
+      access: "public",
+      contentType: blob.contentType,
+      addRandomSuffix: true,
+      token: this.opts.token
+    });
+    return {
+      key: result.pathname,
+      url: result.url,
+      size: bytes.byteLength
+    };
+  }
+};
+function vercelBlobStorage(opts = {}) {
+  return new VercelBlobStorage(opts);
+}
+var packageName = "@airnauts/comments-storage-vercel-blob";
+export {
+  VercelBlobStorage,
+  packageName,
+  vercelBlobStorage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { PutBlob, PutResult, StorageAdapter } from '@airnauts/comments-server'\nimport { put } from '@vercel/blob'\n\nexport type VercelBlobStorageOptions = {\n  /** `BLOB_READ_WRITE_TOKEN`. If omitted, `@vercel/blob` reads it from `process.env`. */\n  token?: string\n  /**\n   * Optional prefix (e.g. 'staging/') applied to every key. A trailing `/` is\n   * appended automatically if missing, so `'staging'` and `'staging/'` behave\n   * the same way.\n   */\n  prefix?: string\n}\n\nfunction sanitizeName(name: string): string {\n  const cleaned = name.replace(/[^A-Za-z0-9._-]/g, '_').slice(0, 200)\n  return cleaned.length > 0 ? cleaned : 'file'\n}\n\nasync function readAllBytes(data: Uint8Array | ReadableStream<Uint8Array>): Promise<Uint8Array> {\n  if (data instanceof Uint8Array) return data\n  const reader = data.getReader()\n  const chunks: Uint8Array[] = []\n  let total = 0\n  try {\n    for (;;) {\n      const { value, done } = await reader.read()\n      if (done) break\n      if (value) {\n        chunks.push(value)\n        total += value.byteLength\n      }\n    }\n  } finally {\n    reader.releaseLock()\n  }\n  const out = new Uint8Array(total)\n  let offset = 0\n  for (const c of chunks) {\n    out.set(c, offset)\n    offset += c.byteLength\n  }\n  return out\n}\n\nexport class VercelBlobStorage implements StorageAdapter {\n  private readonly prefix: string\n\n  constructor(private readonly opts: VercelBlobStorageOptions = {}) {\n    const raw = opts.prefix ?? ''\n    this.prefix = raw === '' || raw.endsWith('/') ? raw : `${raw}/`\n  }\n\n  async put(blob: PutBlob): Promise<PutResult> {\n    const bytes = await readAllBytes(blob.data)\n    const body = new Blob([bytes], { type: blob.contentType })\n    const key = `${this.prefix}${sanitizeName(blob.name)}`\n    const result = await put(key, body, {\n      access: 'public',\n      contentType: blob.contentType,\n      addRandomSuffix: true,\n      token: this.opts.token,\n    })\n    return {\n      key: result.pathname,\n      url: result.url,\n      size: bytes.byteLength,\n    }\n  }\n}\n\n/** Construct a Vercel Blob `StorageAdapter` (uniform `xxxStorage(config)` shape). */\nexport function vercelBlobStorage(opts: VercelBlobStorageOptions = {}): StorageAdapter {\n  return new VercelBlobStorage(opts)\n}\n\nexport const packageName = '@airnauts/comments-storage-vercel-blob'\n"],"mappings":";AACA,SAAS,WAAW;AAapB,SAAS,aAAa,MAAsB;AAC1C,QAAM,UAAU,KAAK,QAAQ,oBAAoB,GAAG,EAAE,MAAM,GAAG,GAAG;AAClE,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;AAEA,eAAe,aAAa,MAAoE;AAC9F,MAAI,gBAAgB,WAAY,QAAO;AACvC,QAAM,SAAS,KAAK,UAAU;AAC9B,QAAM,SAAuB,CAAC;AAC9B,MAAI,QAAQ;AACZ,MAAI;AACF,eAAS;AACP,YAAM,EAAE,OAAO,KAAK,IAAI,MAAM,OAAO,KAAK;AAC1C,UAAI,KAAM;AACV,UAAI,OAAO;AACT,eAAO,KAAK,KAAK;AACjB,iBAAS,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF,UAAE;AACA,WAAO,YAAY;AAAA,EACrB;AACA,QAAM,MAAM,IAAI,WAAW,KAAK;AAChC,MAAI,SAAS;AACb,aAAW,KAAK,QAAQ;AACtB,QAAI,IAAI,GAAG,MAAM;AACjB,cAAU,EAAE;AAAA,EACd;AACA,SAAO;AACT;AAEO,IAAM,oBAAN,MAAkD;AAAA,EAGvD,YAA6B,OAAiC,CAAC,GAAG;AAArC;AAC3B,UAAM,MAAM,KAAK,UAAU;AAC3B,SAAK,SAAS,QAAQ,MAAM,IAAI,SAAS,GAAG,IAAI,MAAM,GAAG,GAAG;AAAA,EAC9D;AAAA,EAH6B;AAAA,EAFZ;AAAA,EAOjB,MAAM,IAAI,MAAmC;AAC3C,UAAM,QAAQ,MAAM,aAAa,KAAK,IAAI;AAC1C,UAAM,OAAO,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC;AACzD,UAAM,MAAM,GAAG,KAAK,MAAM,GAAG,aAAa,KAAK,IAAI,CAAC;AACpD,UAAM,SAAS,MAAM,IAAI,KAAK,MAAM;AAAA,MAClC,QAAQ;AAAA,MACR,aAAa,KAAK;AAAA,MAClB,iBAAiB;AAAA,MACjB,OAAO,KAAK,KAAK;AAAA,IACnB,CAAC;AACD,WAAO;AAAA,MACL,KAAK,OAAO;AAAA,MACZ,KAAK,OAAO;AAAA,MACZ,MAAM,MAAM;AAAA,IACd;AAAA,EACF;AACF;AAGO,SAAS,kBAAkB,OAAiC,CAAC,GAAmB;AACrF,SAAO,IAAI,kBAAkB,IAAI;AACnC;AAEO,IAAM,cAAc;","names":[]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@airnauts/comments-storage-vercel-blob",
+  "version": "0.1.0",
+  "description": "Vercel Blob attachment-storage adapter for the Airnauts commenting tool server.",
+  "keywords": [
+    "comments",
+    "commenting",
+    "annotations",
+    "feedback",
+    "airnauts",
+    "storage",
+    "vercel",
+    "blob"
+  ],
+  "license": "MIT",
+  "author": "Airnauts",
+  "homepage": "https://github.com/Airnauts/commenting-tool#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Airnauts/commenting-tool.git",
+    "directory": "packages/storage-vercel-blob"
+  },
+  "bugs": {
+    "url": "https://github.com/Airnauts/commenting-tool/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/.tsbuildinfo",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@vercel/blob": "^1.1.1",
+    "@airnauts/comments-core": "^0.1.0",
+    "@airnauts/comments-server": "^0.1.0"
+  },
+  "devDependencies": {
+    "@airnauts/comments-test-support": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup && tsc --build --force",
+    "typecheck": "tsc --build",
+    "test": "vitest run"
+  }
+}