zerobucket 0.8.1 → 0.9.0

package/README.md

@@ -123,6 +123,14 @@ await images.get(id, { context: { userId } }); // throws AccessDeniedError if th
 **A hook that throws fails closed**: the original exception propagates; it is never treated as
 "allow". Denied calls never reach the database. `exists()` is deliberately not gated.
 
+**Your hook only ever sees a well-formed UUID.** A malformed id (such as one taken straight from a URL) can never
+exist, so it is "not found" (`ImageNotFoundError`, or `error: "not found"` for that item in `getMany`) and your hook is
+never called with it. You can use the id in SQL (`WHERE id = $1` on a `uuid` column) without validating it first. _(Before
+0.9.0 the hook received the raw string, so on 0.8.x guard against a malformed id yourself: a request for
+`/images/garbage` otherwise became a database error and a `500`.)_ The
+[example app](https://github.com/KedarGhadyalji/ZeroBucket/tree/main/examples/node-integration) shows a working hook, plus
+transactional uploads and serving.
+
 ## Streaming and ranges
 
 ```ts
@@ -452,6 +460,7 @@ differ).
 | -------------------------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
 | API                                          | sync + async clients                                                  | one async client                                                                                                                   |
 | Malformed id (`"abc"`)                       | `StorageError` from Postgres                                          | treated as not found (`ImageNotFoundError`, no DB round trip), friendlier for `/images/:id` routes                                 |
+| Malformed id and the `beforeGet` hook        | the hook **is** called with the raw string (validate it yourself)     | never reaches the hook: not found, so the hook only sees well-formed UUIDs (0.9.0+)                                                |
 | `optimize`                                   | Pillow; EXIF stripped, not applied                                    | sharp; EXIF **applied then stripped**; transparency → **white** for JPEG                                                           |
 | `putMany` inserts                            | pipelined                                                             | one transaction, statements run sequentially                                                                                       |
 | Formats                                      | JPEG, PNG, WebP, HEIC (`[heic]` extra)                                | JPEG, PNG, WebP, HEIC (optional `libheif-js`)                                                                                      |

package/dist/{client-l4jPIFJI.d.cts → client-7ZNu3xMJ.d.cts}

@@ -392,7 +392,9 @@ interface ZeroBucketOptions<C = unknown> {
      * Authorization hook for get / getMany (per id) / getStream / streamTo / metadata.
      * Return false to deny. A hook that THROWS fails closed: the exception
      * propagates (or is captured per item in getMany) and is never treated as allow.
-     * NOT called for exists().
+     * NOT called for exists(). Only ever called with a well-formed UUID: a malformed id is
+     * "not found" (ImageNotFoundError, or `error: "not found"` per item in getMany) and never
+     * reaches the hook.
      */
     beforeGet?: BeforeGetHook<C>;
     /** Authorization hook for put / putMany (evaluated once per call). Same fail-closed rule. */

package/dist/{client-l4jPIFJI.d.ts → client-7ZNu3xMJ.d.ts}

@@ -392,7 +392,9 @@ interface ZeroBucketOptions<C = unknown> {
      * Authorization hook for get / getMany (per id) / getStream / streamTo / metadata.
      * Return false to deny. A hook that THROWS fails closed: the exception
      * propagates (or is captured per item in getMany) and is never treated as allow.
-     * NOT called for exists().
+     * NOT called for exists(). Only ever called with a well-formed UUID: a malformed id is
+     * "not found" (ImageNotFoundError, or `error: "not found"` per item in getMany) and never
+     * reaches the hook.
      */
     beforeGet?: BeforeGetHook<C>;
     /** Authorization hook for put / putMany (evaluated once per call). Same fail-closed rule. */

package/dist/http.d.cts

@@ -1,5 +1,5 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
-import { Z as ZeroBucket } from './client-l4jPIFJI.cjs';
+import { Z as ZeroBucket } from './client-7ZNu3xMJ.cjs';
 import 'pg';
 
 /**

package/dist/http.d.ts

@@ -1,5 +1,5 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
-import { Z as ZeroBucket } from './client-l4jPIFJI.js';
+import { Z as ZeroBucket } from './client-7ZNu3xMJ.js';
 import 'pg';
 
 /**

package/dist/index.cjs

@@ -3407,6 +3407,7 @@ var ZeroBucket = class _ZeroBucket {
   }
   // ---- hooks -----------------------------------------------------------
   async checkBeforeGet(imageId, context) {
+    if (!isValidId(imageId)) throw new ImageNotFoundError(imageId);
     if (!this.beforeGet) return;
     if (!await this.beforeGet(imageId, context))
       throw new AccessDeniedError("get", imageId);
@@ -3570,6 +3571,10 @@ var ZeroBucket = class _ZeroBucket {
     const allowedIdx = [];
     for (let i = 0; i < imageIds.length; i++) {
       const imageId = imageIds[i];
+      if (!isValidId(imageId)) {
+        results[i] = { imageId, image: null, error: "not found", success: false };
+        continue;
+      }
       if (this.beforeGet) {
         try {
           if (!await this.beforeGet(imageId, options.context)) {