Add extra comments

Author: hansott

library/helpers/safeDecodeURIComponent.ts

@@ -61,6 +61,8 @@ const HEX = {
  * Decodes a URI component, returning undefined if the URI is invalid.
  * This function is a safe alternative to `decodeURIComponent`, which throws
  * an error if the URI is malformed.
+ *
+ * We use this for performance reasons (throwing errors is very slow).
  */
 export function safeDecodeURIComponent(uri: string): string | undefined {
   let percentPosition = uri.indexOf("%");

library/sources/http-server/checkIfRequestIsBlocked.ts

@@ -14,6 +14,9 @@ const checkedBlocks = Symbol("__zen_checked_blocks__");
  * - Whether the user agent is blocked by a user agent blocklist
  */
 export function checkIfRequestIsBlocked(
+  // We use a Symbol to store a boolean on the response object
+  // So that we are the only ones who can access it
+  // This boolean flag is used to determine whether the request has already been checked
   res: ServerResponse & { [checkedBlocks]?: boolean },
   agent: Agent
 ): boolean {