docs: add JSDoc documentation across the project

Co-authored-by: Junie <junie@jetbrains.com>

Author: MaksymStoianov

src/controller/BootApplicationFactory.ts

@@ -1,6 +1,9 @@
 import { ApplicationConfig } from "../domain/types";
 import { BootApplication } from "../controller";
 
+/**
+ * Factory for creating BootApplication instances.
+ */
 export class BootApplicationFactory {
   /**
    * Creates an instance of BootApplication.

src/controller/decorators/appsscript/OnChange.ts

@@ -1,4 +1,7 @@
 import { AppsScriptEventType } from "../../../domain/enums";
 import { createAppsScriptDecorator } from "../../../repository";
 
+/**
+ * Decorator for handling Google Apps Script onChange events.
+ */
 export const OnChange = createAppsScriptDecorator(AppsScriptEventType.CHANGE);

src/controller/decorators/appsscript/OnEdit.ts

@@ -1,4 +1,7 @@
 import { AppsScriptEventType } from "../../../domain/enums";
 import { createAppsScriptDecorator } from "../../../repository";
 
+/**
+ * Decorator for handling Google Apps Script onEdit events.
+ */
 export const OnEdit = createAppsScriptDecorator(AppsScriptEventType.EDIT);

src/controller/decorators/appsscript/OnFormSubmit.ts

@@ -1,4 +1,7 @@
 import { AppsScriptEventType } from "../../../domain/enums";
 import { createAppsScriptDecorator } from "../../../repository";
 
+/**
+ * Decorator for handling Google Apps Script onFormSubmit events.
+ */
 export const OnFormSubmit = createAppsScriptDecorator(AppsScriptEventType.FORM_SUBMIT);

src/controller/decorators/appsscript/OnInstall.ts

@@ -1,4 +1,7 @@
 import { AppsScriptEventType } from "../../../domain/enums";
 import { createAppsScriptDecorator } from "../../../repository";
 
+/**
+ * Decorator for handling Google Apps Script onInstall events.
+ */
 export const OnInstall = createAppsScriptDecorator(AppsScriptEventType.INSTALL);

src/controller/decorators/appsscript/OnOpen.ts

@@ -1,4 +1,7 @@
 import { AppsScriptEventType } from "../../../domain/enums";
 import { createAppsScriptDecorator } from "../../../repository";
 
+/**
+ * Decorator for handling Google Apps Script onOpen events.
+ */
 export const OnOpen = createAppsScriptDecorator(AppsScriptEventType.OPEN);

src/service/RequestFactory.ts

@@ -2,6 +2,9 @@ import { isString, normalize } from "apps-script-utils";
 import { HttpHeaders, HttpRequest, ParsedUrl } from "../domain/types";
 import { RequestMethod } from "../domain/enums";
 
+/**
+ * Factory for creating structured HttpRequest objects.
+ */
 export class RequestFactory {
   /**
    * Creates a structured HttpRequest object from a raw Apps Script DoGet or DoPost event.

src/service/Resolver.ts

@@ -5,12 +5,28 @@ import { PARAMTYPES_METADATA } from "../domain/constants";
 import { getInjectionTokens } from "../repository";
 import { isController, isInjectable } from "../shared/utils";
 
+/**
+ * Dependency injection resolver.
+ */
 export class Resolver {
+  /**
+   * Creates a new instance of Resolver.
+   *
+   * @param {Map<InjectionToken, unknown>} _controllers Registered controllers.
+   * @param {Map<InjectionToken, unknown>} _providers Registered providers.
+   */
   constructor(
     private readonly _controllers: Map<InjectionToken, unknown>,
     private readonly _providers: Map<InjectionToken, unknown>
   ) {}
 
+  /**
+   * Resolves a dependency by its injection token.
+   *
+   * @param {InjectionToken<T>} token The injection token.
+   * @returns {T} The resolved instance.
+   * @throws {Error} If the dependency cannot be resolved.
+   */
   public resolve<T>(token: InjectionToken<T>): T {
     if (this._controllers.has(token)) {
       const instance = this._controllers.get(token);

src/service/ResponseBuilder.ts

@@ -1,6 +1,9 @@
 import { HeaderAcceptMimeType, HttpStatus, RequestMethod } from "../domain/enums";
 import { HttpHeaders, HttpRequest, HttpResponse } from "../domain/types";
 
+/**
+ * Service for building and wrapping HTTP responses.
+ */
 export class ResponseBuilder {
   /**
    * Creates a structured HttpResponse object.

src/service/Router.ts

@@ -14,14 +14,31 @@ import { RouteExecutionContext } from "../domain/entities";
 import { getInjectionTokens } from "../repository";
 import { PathMatcher, Resolver } from "../service";
 
+/**
+ * Router service for handling HTTP requests and dispatching them to controllers.
+ */
 export class Router {
   private readonly pathMatcher = new PathMatcher();
 
+  /**
+   * Creates a new instance of Router.
+   *
+   * @param {Resolver} _resolver The dependency resolver.
+   * @param {RouteMetadata[]} _routes The registered routes.
+   */
   constructor(
     private readonly _resolver: Resolver,
     private readonly _routes: RouteMetadata[]
   ) {}
 
+  /**
+   * Handles an incoming HTTP request.
+   *
+   * @param {HttpRequest} request The HTTP request object.
+   * @param {GoogleAppsScript.Events.DoGet | GoogleAppsScript.Events.DoPost} event The Apps Script event object.
+   * @param {Function} responseBuilder A function to build an HTTP response.
+   * @returns {Promise<HttpResponse>} A promise that resolves to the HTTP response.
+   */
   public async handle(
     request: HttpRequest,
     event: GoogleAppsScript.Events.DoGet | GoogleAppsScript.Events.DoPost,
@@ -79,6 +96,14 @@ export class Router {
     }
   }
 
+  /**
+   * Builds the parameters for a controller method based on the route execution context.
+   *
+   * @param {object} target The target object.
+   * @param {string | symbol} propertyKey The name of the property.
+   * @param {RouteExecutionContext} ctx The route execution context.
+   * @returns {unknown[]} An array of parameters for the method.
+   */
   private buildMethodParams(
     target: object,
     propertyKey: string | symbol,