@easy-cms/storage-netlify-blobs 0.36.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kanawoot K.
+
+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,32 @@
+# @easy-cms/storage-netlify-blobs
+
+Netlify Blobs storage for Easy CMS uploads, for sites on Netlify (whose disk doesn't keep files). Part of [Easy CMS](https://github.com/maritonx/easy-cms), the embedded, code-first headless CMS for Nuxt and Next.js.
+
+## Install
+
+```bash
+npm install @easy-cms/storage-netlify-blobs
+```
+
+Or `pnpm add`, `yarn add` or `bun add`.
+
+## Usage
+
+On Netlify, Blobs need no setup: the store is created on first use.
+
+```ts
+import { netlifyBlobsStorage } from '@easy-cms/storage-netlify-blobs'
+
+export default defineConfig({
+  // …
+  upload: { storage: netlifyBlobsStorage() }, // files are served through /api/cms/media/file/…
+})
+```
+
+Outside Netlify's runtime (a script, another host), pass `siteID` and a personal access `token`.
+
+## Links
+
+[Uploads](https://maritonx.github.io/easy-cms/guide/uploads) · [One-click deploy](https://maritonx.github.io/easy-cms/guide/one-click-deploy) · [Documentation](https://maritonx.github.io/easy-cms/) ([ภาษาไทย](https://maritonx.github.io/easy-cms/th/)) · [GitHub](https://github.com/maritonx/easy-cms)
+
+MIT License

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { StorageAdapter } from '@easy-cms/core';
+
+interface NetlifyBlobsStorageOptions {
+    /** The blob store's name. Default `easy-cms-uploads`. */
+    readonly name?: string;
+    /**
+     * Outside Netlify's runtime (scripts, other hosts): the site and a personal access token.
+     * On Netlify they come from the environment.
+     */
+    readonly siteID?: string;
+    readonly token?: string;
+    /** For tests: a local blobs server. */
+    readonly edgeURL?: string;
+    readonly uncachedEdgeURL?: string;
+    readonly apiURL?: string;
+}
+/**
+ * Stores uploaded files in Netlify Blobs, for sites on Netlify (whose disk doesn't keep files).
+ * Files are served through the REST API (`<api>/media/file/<key>`).
+ */
+declare function netlifyBlobsStorage(options?: NetlifyBlobsStorageOptions): StorageAdapter;
+
+export { type NetlifyBlobsStorageOptions, netlifyBlobsStorage };

package/dist/index.js

@@ -0,0 +1,33 @@
+// src/index.ts
+import { getStore } from "@netlify/blobs";
+function netlifyBlobsStorage(options = {}) {
+  const open = () => getStore({
+    name: options.name ?? "easy-cms-uploads",
+    // Uploads are read right after they are written: strong consistency.
+    consistency: "strong",
+    ...options.siteID ? { siteID: options.siteID } : {},
+    ...options.token ? { token: options.token } : {},
+    ...options.edgeURL ? { edgeURL: options.edgeURL } : {},
+    ...options.uncachedEdgeURL ? { uncachedEdgeURL: options.uncachedEdgeURL } : {},
+    ...options.apiURL ? { apiURL: options.apiURL } : {}
+  });
+  return {
+    name: "netlify-blobs",
+    async put(key, data, { contentType }) {
+      const bytes = new Uint8Array(data);
+      await open().set(key, bytes.buffer, { metadata: { contentType } });
+    },
+    async get(key) {
+      const found = await open().get(key, { type: "arrayBuffer" });
+      if (found === null) return null;
+      const body = new Uint8Array(found);
+      return { body, size: body.byteLength };
+    },
+    async delete(key) {
+      await open().delete(key);
+    }
+  };
+}
+export {
+  netlifyBlobsStorage
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@easy-cms/storage-netlify-blobs",
+  "version": "0.36.0",
+  "description": "Netlify Blobs upload storage for Easy CMS",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@netlify/blobs": "^11.1.3"
+  },
+  "peerDependencies": {
+    "@easy-cms/core": "^0.36.1"
+  },
+  "devDependencies": {
+    "@easy-cms/core": "^0.36.1"
+  },
+  "engines": {
+    "node": ">=22.12"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maritonx/easy-cms.git",
+    "directory": "packages/storage-netlify-blobs"
+  },
+  "keywords": [
+    "easy-cms",
+    "storage",
+    "uploads",
+    "netlify",
+    "blobs"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}