From b092619596a79f74197e7b8f2483bed6407174f6 Mon Sep 17 00:00:00 2001
From: Darren Ackers <ackers86@hotmail.com>
Date: Wed, 4 Mar 2026 10:58:26 +0000
Subject: [PATCH] docs(storage): add Storage triggers to README table and
 samples

---
 README.md | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/README.md b/README.md
index daece5e..b302d36 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,7 @@ This package provides a complete Dart implementation of Firebase Cloud Functions
 | **Pub/Sub** | ✅ Complete | `onMessagePublished` |
 | **Firestore** | ✅ Complete | `onDocumentCreated`, `onDocumentUpdated`, `onDocumentDeleted`, `onDocumentWritten`, `onDocumentCreatedWithAuthContext`, `onDocumentUpdatedWithAuthContext`, `onDocumentDeletedWithAuthContext`, `onDocumentWrittenWithAuthContext` |
 | **Realtime Database** | ✅ Complete | `onValueCreated`, `onValueUpdated`, `onValueDeleted`, `onValueWritten` |
+| **Storage** | ✅ Complete | `onObjectFinalized`, `onObjectArchived`, `onObjectDeleted`, `onObjectMetadataUpdated` |
 | **Firebase Alerts** | ✅ Complete | Crashlytics, Billing, Performance alerts |
 | **Identity Platform** | ✅ Complete | `beforeUserCreated`, `beforeUserSignedIn` (+ `beforeEmailSent`, `beforeSmsSent`*) |
 
@@ -308,6 +309,50 @@ firebase.database.onValueWritten(
 );
 ```
 
+## Storage Triggers
+
+```dart
+// Object finalized (created or overwritten)
+firebase.storage.onObjectFinalized(
+  bucket: 'my-bucket',
+  (event) async {
+    final data = event.data;
+    print('Object finalized: ${data?.name}');
+    print('Content type: ${data?.contentType}');
+    print('Size: ${data?.size}');
+  },
+);
+
+// Object archived
+firebase.storage.onObjectArchived(
+  bucket: 'my-bucket',
+  (event) async {
+    final data = event.data;
+    print('Object archived: ${data?.name}');
+    print('Storage class: ${data?.storageClass}');
+  },
+);
+
+// Object deleted
+firebase.storage.onObjectDeleted(
+  bucket: 'my-bucket',
+  (event) async {
+    final data = event.data;
+    print('Object deleted: ${data?.name}');
+  },
+);
+
+// Object metadata updated
+firebase.storage.onObjectMetadataUpdated(
+  bucket: 'my-bucket',
+  (event) async {
+    final data = event.data;
+    print('Metadata updated: ${data?.name}');
+    print('Metadata: ${data?.metadata}');
+  },
+);
+```
+
 ## Firebase Alerts
 
 ```dart