From a6eae657c7d66ae75147fcd3c44e558f7d886c8d Mon Sep 17 00:00:00 2001
From: KoloMl <thekolomoets@hotmail.com>
Date: Sun, 21 Jun 2026 15:36:14 +0400
Subject: [PATCH] Added comment for the storage helper instance in
 EntitiesController

---
 src/lib/extension/EntitiesController.ts | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/lib/extension/EntitiesController.ts b/src/lib/extension/EntitiesController.ts
index 8c4978c..0df9dc9 100644
--- a/src/lib/extension/EntitiesController.ts
+++ b/src/lib/extension/EntitiesController.ts
@@ -2,6 +2,12 @@ import StorageHelper, { type StorageChangeSubscriber } from "$lib/browser/Storag
 import type StorageEntity from "$lib/extension/base/StorageEntity";
 
 export default class EntitiesController {
+  /**
+   * Instance of storage helper used to store/read/subscribe to storage changes.
+   *
+   * Mainly exposed for the testing purposes. When class is loaded outside of extension context, will hold `null`
+   * instead. Any operations of entities will throw an error in this case.
+   */
   static storage: StorageHelper | null = typeof chrome !== 'undefined'
     ? new StorageHelper(chrome.storage.local)
     : null;