@velajs/storage 0.2.0

package/dist/storagesdk/index.js

@@ -0,0 +1,136 @@
+import { byteLengthOf } from "../internal/body.js";
+import { createStoredFile } from "../internal/stored-file.js";
+import { StorageError } from "../storage.error.js";
+function toMillis(d) {
+    if (d == null) return undefined;
+    return d instanceof Date ? d.getTime() : d;
+}
+function metaOf(item) {
+    return {
+        key: item.path,
+        size: item.size,
+        type: item.contentType || 'application/octet-stream',
+        etag: item.etag,
+        lastModified: toMillis(item.lastModified),
+        metadata: item.metadata
+    };
+}
+/**
+ * Adapt a `@storagesdk/adapters` adapter to a {@link StorageDriver}.
+ *
+ * storagesdk's shape differs from ours (path-based; `download` returns buffered
+ * bytes rather than a stream; no first-class multipart or capability flags),
+ * so this is an explicit mapping. Multipart / presigned-multipart are not
+ * exposed (the facade will gate them as `Unsupported`).
+ */ export function storageSdkDriver(adapter, options) {
+    const hasUploadUrl = typeof adapter.signedUploadUrl === 'function';
+    const driver = {
+        name: `storagesdk:${adapter.name ?? 'adapter'}`,
+        raw: adapter.raw,
+        supportsRange: options?.supportsRange ?? false,
+        supportsDelimiter: options?.supportsDelimiter ?? false,
+        supportsMetadata: options?.supportsMetadata ?? true,
+        supportsCacheControl: options?.supportsCacheControl ?? false,
+        supportsServerSideCopy: true,
+        reportsUploadProgress: false,
+        signedUrl: {
+            supported: typeof adapter.url === 'function',
+            upload: hasUploadUrl
+        },
+        async upload (key, body, opts) {
+            const r = await adapter.upload(key, body, {
+                contentType: opts?.contentType,
+                metadata: opts?.metadata,
+                signal: opts?.signal
+            });
+            return {
+                key,
+                size: r?.size ?? byteLengthOf(body) ?? 0,
+                contentType: opts?.contentType ?? r?.contentType ?? 'application/octet-stream',
+                etag: r?.etag,
+                lastModified: toMillis(r?.lastModified)
+            };
+        },
+        async download (key, opts) {
+            const item = await adapter.download(key, {
+                signal: opts?.signal
+            });
+            return createStoredFile(metaOf(item), {
+                kind: 'bytes',
+                bytes: item.body
+            });
+        },
+        async head (key, opts) {
+            const item = await adapter.head(key, {
+                signal: opts?.signal
+            });
+            return createStoredFile(metaOf(item), {
+                kind: 'lazy',
+                fetch: async ()=>new Response((await adapter.download(key)).body)
+            });
+        },
+        async exists (key, opts) {
+            if (adapter.exists) return adapter.exists(key, {
+                signal: opts?.signal
+            });
+            try {
+                await adapter.head(key, {
+                    signal: opts?.signal
+                });
+                return true;
+            } catch (e) {
+                if (e instanceof StorageError && e.code === 'NotFound') return false;
+                if (e && typeof e === 'object' && e.code === 'NotFound') return false;
+                throw e;
+            }
+        },
+        async delete (key, opts) {
+            await adapter.delete(key, {
+                signal: opts?.signal
+            });
+        },
+        async copy (from, to, opts) {
+            await adapter.copy(from, to, {
+                signal: opts?.signal
+            });
+        },
+        async list (opts) {
+            const r = await adapter.list({
+                prefix: opts?.prefix,
+                cursor: opts?.cursor,
+                limit: opts?.limit,
+                delimiter: opts?.delimiter,
+                signal: opts?.signal
+            });
+            return {
+                items: r.items.map((item)=>createStoredFile(metaOf(item), {
+                        kind: 'lazy',
+                        fetch: async ()=>new Response((await adapter.download(item.path)).body)
+                    })),
+                prefixes: r.prefixes,
+                cursor: r.cursor
+            };
+        },
+        async url (key, opts) {
+            return adapter.url(key, {
+                expiresIn: opts?.expiresIn,
+                signal: opts?.signal
+            });
+        },
+        async signedUploadUrl (key, opts) {
+            if (!adapter.signedUploadUrl) {
+                throw new StorageError('Unsupported', 'storagesdk adapter cannot presign uploads');
+            }
+            return adapter.signedUploadUrl(key, {
+                expiresIn: opts.expiresIn,
+                contentType: opts.contentType
+            });
+        }
+    };
+    if (adapter.move) {
+        driver.move = (from, to, opts)=>adapter.move(from, to, {
+                signal: opts?.signal
+            });
+    }
+    return driver;
+}

package/package.json

@@ -0,0 +1,116 @@
+{
+  "name": "@velajs/storage",
+  "version": "0.2.0",
+  "description": "Edge-first, driver-based object/file storage for the Vela framework",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./drivers/memory": {
+      "types": "./dist/drivers/memory/index.d.ts",
+      "import": "./dist/drivers/memory/index.js"
+    },
+    "./drivers/s3": {
+      "types": "./dist/drivers/s3/index.d.ts",
+      "import": "./dist/drivers/s3/index.js"
+    },
+    "./drivers/r2": {
+      "types": "./dist/drivers/r2/index.d.ts",
+      "import": "./dist/drivers/r2/index.js"
+    },
+    "./drivers/r2-http": {
+      "types": "./dist/drivers/r2-http/index.d.ts",
+      "import": "./dist/drivers/r2-http/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware/index.d.ts",
+      "import": "./dist/middleware/index.js"
+    },
+    "./storagesdk": {
+      "types": "./dist/storagesdk/index.d.ts",
+      "import": "./dist/storagesdk/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && swc src -d dist --strip-leading-paths && tsc --emitDeclarationOnly",
+    "test": "vitest run",
+    "test:workers": "vitest run --config vitest.config.workers.ts",
+    "typecheck": "tsc --noEmit",
+    "prepare": "swc src -d dist --strip-leading-paths && tsc --emitDeclarationOnly",
+    "prepublishOnly": "pnpm run typecheck && pnpm test"
+  },
+  "sideEffects": false,
+  "keywords": [
+    "vela",
+    "storage",
+    "object-storage",
+    "s3",
+    "r2",
+    "presigned-url",
+    "multipart",
+    "edge",
+    "cloudflare-workers",
+    "framework"
+  ],
+  "author": "ksh",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/velajs/storage.git"
+  },
+  "homepage": "https://github.com/velajs/storage#readme",
+  "bugs": {
+    "url": "https://github.com/velajs/storage/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "aws4fetch": "^1.0.20"
+  },
+  "peerDependencies": {
+    "@velajs/vela": ">=1.11.0",
+    "hono": ">=4",
+    "@cloudflare/workers-types": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "@cloudflare/workers-types": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@cloudflare/vitest-pool-workers": "^0.16.18",
+    "@cloudflare/workers-types": "^4.20260624.1",
+    "@swc/cli": "^0.8.1",
+    "@swc/core": "^1.15.43",
+    "@velajs/testing": "^0.4.0",
+    "@velajs/vela": "^1.12.0",
+    "aws4fetch": "^1.0.20",
+    "hono": "^4.12.27",
+    "typescript": "^6.0.3",
+    "unplugin-swc": "^1.5.9",
+    "vitest": "^4.1.9"
+  },
+  "packageManager": "pnpm@10.20.0",
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "@swc/core",
+      "esbuild",
+      "workerd"
+    ]
+  }
+}