@voyantjs/storage 0.74.1 → 0.75.0

package/README.md

@@ -29,6 +29,10 @@ const url = await storage.signedUrl({ key: "files/x.pdf", expiresIn: 300 })
 
 The S3 provider supports `forcePathStyle` and a custom `endpoint` for S3-compatible services (Wasabi, MinIO, etc.). SigV4 signing is verified against AWS canonical test vectors.
 
+The R2 binding provider cannot mint signed URLs by itself. Configure either
+`publicBaseUrl` or a custom `signer` before calling `signedUrl`; otherwise the
+provider throws instead of returning a raw storage key.
+
 ## Exports
 
 | Entry | Description |

package/dist/providers/r2.d.ts

@@ -1,4 +1,5 @@
 import type { StorageProvider } from "../types.js";
+export declare const R2_SIGNED_URL_CONFIGURATION_ERROR_MESSAGE = "R2 provider: signedUrl requires either `publicBaseUrl` or `signer` to be configured";
 /**
  * Subset of the Cloudflare Workers `R2Bucket` binding we depend on. Kept
  * as a minimal structural type so this package does not need a runtime
@@ -35,7 +36,9 @@ export interface R2ProviderOptions {
      * signed URLs directly; templates pass a custom signer that either:
      *   - returns a short-lived Worker route URL, or
      *   - calls R2's S3-compatible API with SigV4 credentials.
-     * When omitted, `signedUrl` returns `${publicBaseUrl}${key}`.
+     * When omitted, `signedUrl` returns `${publicBaseUrl}${key}`. Calling
+     * `signedUrl` without either a signer or public base URL is a
+     * configuration error because a raw R2 object key is not a URL.
      */
     signer?: (key: string, expiresIn: number) => Promise<string> | string;
     /** Provider name (defaults to `"r2"`). */

package/dist/providers/r2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"r2.d.ts","sourceRoot":"","sources":["../../src/providers/r2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,eAAe,EAAoC,MAAM,aAAa,CAAA;AAEnG;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,MAAM,GAAG,cAAc,GAAG,IAAI,EAC5E,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAAA;IACnB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,MAAM,EAAE,YAAY,CAAA;IACpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;IACrE,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,MAAM,CAAA;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,eAAe,CAuC5E"}
+{"version":3,"file":"r2.d.ts","sourceRoot":"","sources":["../../src/providers/r2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,eAAe,EAAoC,MAAM,aAAa,CAAA;AAEnG,eAAO,MAAM,yCAAyC,wFACiC,CAAA;AAEvF;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,MAAM,GAAG,cAAc,GAAG,IAAI,EAC5E,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAAA;IACnB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,MAAM,EAAE,YAAY,CAAA;IACpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;IACrE,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,MAAM,CAAA;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,eAAe,CA0C5E"}

package/dist/providers/r2.js

@@ -1,3 +1,4 @@
+export const R2_SIGNED_URL_CONFIGURATION_ERROR_MESSAGE = "R2 provider: signedUrl requires either `publicBaseUrl` or `signer` to be configured";
 /**
  * Create a Cloudflare R2 storage provider bound to an R2 bucket binding.
  * The R2 binding handles authentication transparently at the Worker
@@ -32,7 +33,10 @@ export function createR2Provider(options) {
         async signedUrl(key, expiresIn) {
             if (options.signer)
                 return options.signer(key, expiresIn);
-            return publicBaseUrl ? `${publicBaseUrl}${key}` : key;
+            if (!publicBaseUrl) {
+                throw new Error(R2_SIGNED_URL_CONFIGURATION_ERROR_MESSAGE);
+            }
+            return `${publicBaseUrl}${key}`;
         },
         async get(key) {
             const obj = await options.bucket.get(key);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/storage",
-  "version": "0.74.1",
+  "version": "0.75.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {